${user.username}

\n $\"${user.username}\"$ \n

${user.bio || \"\"}

${vals}\n

View Profile

\n `;\n }).join(\"\");\n return c.html(`\n

Glance on val.town

\n ${html}\n

\n\n \n `);\n});\n\napp.get(\"/team/showcase/json\", async (c) => {\n // get all pages from the team database\n const team = await getTeam();\n // console.log(team);\n return c.html(`\n

${JSON.stringify(team, null, 2)}

\n `);\n});\n\napp.get(\"/:username\", async (c) => {\n const username = c.req.param(\"username\");\n try {\n // in this example endpoint, we use the vt methods\n const user = await vt.alias.username.retrieve(username);\n return c.json(\n user,\n );\n } catch (error) {\n console.log(error);\n return c.json(error, 400);\n }\n});\n\napp.get(\"/:username/html\", async (c) => {\n const username = c.req.param(\"username\");\n try {\n // in this example endpoint, we use the controller that uses the vt methods\n const user = await getValTownUser(username);\n return c.html(`\n

${JSON.stringify(user, null, 2)}

\n `);\n } catch (error) {\n console.log(error);\n return c.json(error, 400);\n }\n});\n\napp.get(\"/\", async (c) => {\n return c.json({ message: \"/api is for GETs\" });\n});\n\nexport default app;",[],[189,195],{"_106":203,"_96":204,"_160":205,"_162":190,"_163":143,"_164":165,"_166":120,"_108":206,"_102":32,"_168":182,"_170":207,"_171":22,"_172":-5,"_173":208,"_100":209},"ce266510-42e3-11f0-99cd-76b3cceeab13","tasks.ts","4444eebf-efa7-45b4-939b-4bb5019b441d",["D",1749220663203],"import { Hono } from \"npm:hono\";\nimport { getNotionPage, getValTownUser, setNotionPage } from \"../controllers/controllers.ts\";\n\n// Initialize Hono\nconst app = new Hono();\n\n// get the user object and save it to Notion\n// note that this is a POST, which is the only type of request Notion sends\napp.post(\"/\", async (c) => {\n try {\n // get the Notion webhook payload\n const { data } = await c.req.json();\n // we can't be sure what data we'll get from the Notion payload\n // so we need to call Notion and get all the data from the page that sent the POST\n const page = await getNotionPage(data.id);\n // depending on what's in the Notion data, find the username\n const username = (page.properties?.URL?.url)\n ? page.properties?.URL?.url.split(\"/\").pop()\n : page.properties?.Username?.title?.[0]?.plain_text;\n // hit val.town for the the user object with that username\n const user = await getValTownUser(username);\n // fill in Notion with the data from the val.town user object\n await setNotionPage(data.id, user);\n // return a simple success message (Notion discards details anyway)\n return c.json({ ok: true });\n } catch (error: any) {\n console.log(error.body);\n return c.json(\n {\n status: \"error\",\n message: error.message,\n },\n 500,\n );\n }\n});\n\nexport default app;",[],[189,204],[189],{"_106":212,"_96":213,"_160":214,"_162":-5,"_163":143,"_164":165,"_166":120,"_108":215,"_102":32,"_168":216,"_170":217,"_171":22,"_172":-5,"_173":218,"_100":219},"ce266826-42e3-11f0-99cd-76b3cceeab13","README.md","b9b4828a-9af3-419f-8ca8-3e8c9d7f2a5f",["D",1749220663203],"file","# Team - Notion & Val Town Integration\n\nA simple integration that automatically enriches a Notion database of team members with their Val Town account information. When a new team member is added to your Notion database, this Val automatically fetches their Val Town profile data and populates the relevant fields.\n\n## Features\n\n- **Automatic Profile Enrichment**: Fetches Val Town user data when triggered by Notion webhooks\n- **Flexible Username Detection**: Supports both URL-based and direct username input\n- **RESTful API**: Provides endpoints to manually query Val Town user information\n- **Error Handling**: Graceful handling of missing users or API failures\n\n## Project Structure\n\n```\n├── main.tsx # Main Hono app with route mounting\n├── routes/\n│ ├── api.ts # API endpoints for manual user queries\n│ └── tasks.ts # Webhook handler for Notion integration\n├── controllers/\n│ └── controllers.ts # Business logic for Notion and Val Town operations\n└── README.md\n```\n\n## API Endpoints\n\n### Webhook Endpoint\n- **POST** `/tasks` - Notion webhook handler that enriches team member data\n\n### Manual API Endpoints\nNote: these are not used in this demo but are included for demonstration purposes later.\n- **GET** `/api/:username` - Returns JSON data for a Val Town user\n- **GET** `/api/:username/html` - Returns HTML-formatted user data\n- **GET** `/api` - API information endpoint\n\n## Setup Instructions\n\n### 1. Environment Variables\n\nSet the following environment variable in your Val Town settings:\n\n```\nNOTION_API_KEY=your_notion_integration_token\nGLANCE_TEAM_DB_ID=your_database_id\n```\n\n### 2. Notion Database Schema\n\nYour Notion database should have the following properties:\n\n| Property Name | Type | Description |\n|---------------|------|-------------|\n| `Username` | Title | Val Town username (auto-populated) |\n| `URL` | URL | Val Town profile URL (can be input or auto-populated) |\n| `Id` | Rich Text | Val Town user ID (auto-populated) |\n| `Bio` | Rich Text | User bio from Val Town (auto-populated) |\n\n### 3. Notion Integration Setup\n\n1. Create a new integration in your Notion workspace\n2. Add the integration to your team database\n3. Create a webhook that points to `https://your-val-url.web.val.run/tasks`\n4. Configure the webhook to trigger on database item creation/updates\n\n## How It Works\n\n1. **Trigger**: When a team member is added/updated in Notion, a webhook is sent to `/tasks`\n2. **Data Retrieval**: The system fetches the full page data from Notion to get the username\n3. **Username Extraction**: Extracts username from either:\n - The `URL` field (extracts from `https://val.town/u/username`)\n - The `Username` field directly\n4. **Profile Fetch**: Queries the Val Town API for user profile data\n5. **Database Update**: Updates the Notion page with the retrieved information\n\n## Usage Examples\n\n### Notion Workflow\n\n1. Add a new team member to your Notion database\n2. Fill in either the `Username` field or paste their Val Town profile URL in the `URL` field\n3. The webhook will automatically trigger and populate the remaining fields\n\n## Val Town Profile Data\n\nThe integration fetches and stores the following data from Val Town:\n\n- **Username**: Val Town handle\n- **ID**: Unique user identifier\n- **Bio**: User's profile bio (if available)\n- **URL**: Direct link to their Val Town profile\n- **Profile Image URL**: Link to their profile picture\n\n## Error Handling\n\n- **Missing Users**: If a Val Town user doesn't exist, the system gracefully handles the error\n- **API Failures**: Network issues or API errors are logged and return appropriate error responses\n- **Invalid Data**: Malformed webhook data is handled with proper error messages\n\n## Development\n\nThe project uses:\n- **Hono**: Fast web framework for the API\n- **Val Town SDK**: Official SDK for Val Town API interactions\n- **Notion SDK**: Official SDK for Notion API operations\n- **TypeScript**: For type safety and better development experience\n\n## Contributing\n\nWhen modifying the Notion database schema, ensure you update the `setPage` function in `controllers/controllers.ts` to match your new property structure.",[],[213],{"_106":221,"_96":101,"_160":222,"_162":-5,"_163":143,"_164":223,"_166":120,"_108":224,"_102":225,"_168":226,"_170":227,"_171":22,"_172":-5,"_173":228,"_100":229},"80e26ffa-430c-11f0-8ec9-76b3cceeab13","836dabe0-8d30-407e-934c-6a48d27720f4",123,["D",1749238142938],8,"http","/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport { Hono } from \"npm:hono\";\n\n// import routes\nimport api from \"./routes/api.ts\";\nimport views from \"./routes/api.ts\";\nimport tasks from \"./routes/tasks.ts\";\n\n// initialize Hono API\nconst app = new Hono();\n\n// Mount routes\napp.route(\"/tasks\", tasks);\napp.route(\"/api\", api);\napp.route(\"/team\", views);\n\napp.get(\"/\", (c) => {\n return c.text(\"Hello, Team!\");\n});\n\nexport default app.fetch;",[],[101],"files",[157,175,187,193,202,211,220],"counts",{"_234":32,"_235":236,"_237":165,"_238":239,"_243":244},"pulls","branches",3,"forks","envVars",{"_240":241,"_242":32},"count",2,"emptyCount","connections",{"_240":32,"_245":32},"unfilledCount","contents",[],{"_106":221,"_163":143,"_160":222,"_96":101,"_170":227,"_168":226,"_102":225,"_162":-5,"_108":249,"_164":223,"_172":-5,"_100":250},["D",1749238142938],[101],"upstreamProject","upstreamBranch",{"_106":146,"_108":254,"_255":256,"_96":44,"_144":107,"_102":257,"_145":-5,"_147":-5,"_258":259,"_110":-5,"_154":22,"_112":113,"_153":95,"_16":124,"_152":97},["D",1749151882696],"updatedAt",["D",1749734630656],280,"lockfileKey","1767195201750-esm.town_v_glance_Team@280-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_94":95,"_96":97,"_98":99,"_102":103,"_100":101,"_104":266,"_155":271,"_230":293,"_216":294,"_246":297,"_298":299,"_302":-5,"_303":32,"_304":305,"_306":307,"_238":-5},{"_106":107,"_96":97,"_108":267,"_110":-5,"_111":22,"_112":113,"_114":-5,"_115":-5,"_14":116,"_117":118,"_119":120,"_121":120,"_122":-5,"_123":32,"_16":124,"_125":126,"_127":126,"_128":129,"_130":129,"_131":129,"_132":126,"_133":126,"_23":268,"_137":269,"_140":270,"_154":22},["D",1749151882696],{"_94":95,"_135":136},{"_94":95,"_139":136,"_14":116},{"_102":142,"_96":99,"_106":143,"_144":107,"_145":146,"_147":148,"_149":113,"_150":107,"_151":124,"_152":97,"_153":95},[272,278,287,290],{"_106":158,"_96":159,"_160":161,"_162":-5,"_163":143,"_164":165,"_166":120,"_108":167,"_102":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":273,"_100":277},[274],{"_106":176,"_96":177,"_160":178,"_162":161,"_163":143,"_164":179,"_166":120,"_108":180,"_102":181,"_168":182,"_170":183,"_171":22,"_172":-5,"_173":275,"_100":276},[],[159,177],[159],{"_106":188,"_96":189,"_160":190,"_162":-5,"_163":143,"_164":165,"_166":120,"_108":191,"_102":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":279,"_100":286},[280,283],{"_106":194,"_96":195,"_160":196,"_162":190,"_163":143,"_164":103,"_166":22,"_108":197,"_102":198,"_168":182,"_170":199,"_171":22,"_172":-5,"_173":281,"_100":282},[],[189,195],{"_106":203,"_96":204,"_160":205,"_162":190,"_163":143,"_164":165,"_166":120,"_108":206,"_102":32,"_168":182,"_170":207,"_171":22,"_172":-5,"_173":284,"_100":285},[],[189,204],[189],{"_106":212,"_96":213,"_160":214,"_162":-5,"_163":143,"_164":165,"_166":120,"_108":215,"_102":32,"_168":216,"_170":217,"_171":22,"_172":-5,"_173":288,"_100":289},[],[213],{"_106":221,"_96":101,"_160":222,"_162":-5,"_163":143,"_164":223,"_166":120,"_108":224,"_102":225,"_168":226,"_170":227,"_171":22,"_172":-5,"_173":291,"_100":292},[],[101],[272,274,278,280,283,287,290],{"_106":221,"_96":101,"_160":222,"_162":-5,"_163":143,"_164":223,"_166":120,"_108":295,"_102":225,"_168":226,"_170":227,"_171":22,"_172":-5,"_100":296},["D",1749238142938],[101],[],"upstream",{"_106":146,"_108":300,"_255":301,"_96":44,"_144":107,"_102":257,"_145":-5,"_147":-5,"_258":259,"_110":-5,"_154":22,"_112":113,"_153":95,"_16":124,"_152":97},["D",1749151882696],["D",1749734630656],"pull","ahead","behind",63,"templates",[],"actionData","errors"]