`, `

`, ``, etc.)\n- **Automatic styling** - Beautiful design out of the box\n- **CDN delivery** - Single `` tag, no build step\n\n### Rules\n\n❌ **NEVER use CSS class names** (no `className` attributes)\n❌ **NEVER use TailwindCSS, Bootstrap, or other class-based frameworks**\n✅ **ALWAYS use semantic HTML elements**\n✅ **Use inline styles sparingly** - Only for dynamic/conditional styling\n\n### Semantic HTML Elements\n\nUse these semantic elements - Pico styles them automatically:\n\n**Layout:**\n- `` - Main content container\n- `` - Self-contained content (cards, sections)\n- `` - Thematic grouping of content\n- ``, `` - Page/section headers and footers\n- `` - Sidebar content\n\n**Typography:**\n- `` through ` ` - Headings\n- `` - Paragraphs\n- `` - Bold/important text\n- `` - Italic/emphasized text\n- `` - Fine print\n- `` - Highlighted text\n- `` - Inline code\n- ` ` - Code blocks\n- `` - Keyboard input / tags\n\n**Lists:**\n- ``, ``, `` - Lists\n- ``, ``, ` ` - Definition lists\n\n**Forms:**\n- ``, ``, `<select>` - Form inputs\n- `<button>` - Buttons\n- `<label>` - Form labels\n- Use `aria-busy` attribute for loading states on buttons\n\n**Links & Media:**\n- `<a>` - Links\n- `<time>` - Dates and times\n- `<figure>`, `<figcaption>` - Images with captions\n\n### Example Patterns\n\n**Card layout:**\n```tsx\n<article>\n <h2>Card Title</h2>\n <p>Card content goes here.</p>\n <button>Action</button>\n</article>\n```\n\n**Form with loading state:**\n```tsx\n<div style={{ display: 'flex', gap: '1rem' }}>\n <input type=\"text\" placeholder=\"Enter value\" style={{ flex: 1 }} />\n <button disabled={loading} aria-busy={loading}>\n Submit\n </button>\n</div>\n```\n\n**Error message:**\n```tsx\n{error && <mark>{error}</mark>}\n```\n\n**Tags/badges:**\n```tsx\n<kbd>Tag 1</kbd> <kbd>Tag 2</kbd>\n```\n\n**Conditional styling:**\n```tsx\n<span style={checked ? { textDecoration: 'line-through', opacity: 0.6 } : undefined}>\n Task text\n</span>\n```\n\n### Loading Pico CSS\n\nAlready included in `frontend/index.html`:\n\n```html\n<link href=\"https://cdn.jsdelivr.net/npm/@picocss/pico@2.1.1/css/pico.classless.min.css\" rel=\"stylesheet\" />\n```\n\n## Shared Code (`shared/`)\n\n**Types** (`shared/types.ts`):\n- All TypeScript interfaces shared between frontend/backend\n- Notion data structures\n- API request/response types\n- Common data models\n\n**Utils** (`shared/utils.ts`):\n- Pure functions that work in both Deno (backend) and browser (frontend)\n- ❌ NEVER use Deno APIs (won't work in browser)\n- ✅ Only use standard JavaScript/TypeScript\n\n## Environment Variables\n\nRequired environment variables for this val:\n\n- `NOTION_API_KEY` - Notion integration token\n- `FIRECRAWLER_API_KEY` - Firecrawler service (if used)\n- Additional service API keys as needed\n\n**Access via**: `Deno.env.get('VAR_NAME')`\n\n**NEVER hardcode secrets** - always use environment variables\n\n## Data Validation\n\nValidate request data in **controllers**, not routes:\n\n```typescript\nif (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n data: null,\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n}\n```\n\n**Check:**\n- Required fields exist\n- Types are correct\n- Formats are valid\n- Values are within expected ranges\n\n**Return helpful error messages** with `details` field\n\n## Response Filtering\n\n**Filter sensitive data in controllers** before returning:\n\n- Remove button properties from Notion data\n- Don't expose internal IDs or tokens\n- Clean up API responses before sending to frontend\n- Strip unnecessary metadata\n\n**Example:**\n```typescript\n// Remove sensitive properties\nconst filtered = {\n ...notionData,\n properties: Object.entries(notionData.properties)\n .filter(([key, value]) => value.type !== 'button')\n .reduce((acc, [key, value]) => ({ ...acc, [key]: value }), {})\n};\n```\n\n## Questions to Ask User\n\nWhen the user requests a new feature, clarify:\n\n1. **Is this a webhook handler or API endpoint?**\n - Webhook → `routes/tasks/`\n - API → `routes/api/`\n\n2. **What external service needs integration?**\n - New service → create `backend/services/[name].ts`\n\n3. **What data needs to be saved back to Notion?**\n - Update Notion → use/extend `notionService.ts`\n\n4. **Does this need authentication?**\n - Protected → apply `authCheck` middleware\n\n5. **Is this frontend-facing?**\n - Yes → create React component in `frontend/components/`\n\n## Common Patterns Checklist\n\nBefore implementing, verify:\n\n- ✅ Following 3-layer architecture (Route → Controller → Service)\n- ✅ Routes only handle HTTP, no business logic\n- ✅ Controllers return standardized `{success, data, error}` structure\n- ✅ Services handle external API calls\n- ✅ Never skipping layers\n- ✅ TypeScript types defined in `shared/types.ts`\n- ✅ Environment variables used for secrets\n- ✅ Error handling at each layer\n- ✅ Validation in controllers\n- ✅ Sensitive data filtered before returning\n\n## Integration with AGENTS.md\n\n**Use AGENTS.md for:**\n- Val Town platform requirements\n- Deno-specific patterns\n- Standard library usage\n- React configuration\n- Import patterns (esm.sh)\n- Platform limitations\n\n**Use CLAUDE.md (this file) for:**\n- This val's architecture\n- MVC layer separation\n- Notion integration patterns\n- External service integration\n- File organization\n- Response formats\n\n## Entry Point\n\n`main.http.tsx` is the HTTP entry point:\n- Exports `app.fetch` for Val Town\n- Uses Hono for routing\n- Serves static frontend assets\n- Mounts API routes at `/api`\n- Includes error handler\n\n**Always mount new routes in main.http.tsx:**\n```typescript\nimport { taskRoutes } from './backend/routes/tasks/index.ts';\n\napp.route('/tasks', taskRoutes);\n```\n\n## Hono Framework Patterns\n\nThis val uses **Hono** as the web framework. Follow these patterns:\n\n### Importing Hono\n\n```typescript\nimport { Hono } from \"npm:hono@4\";\nimport { Context, Next } from \"npm:hono@4\";\n```\n\n**Note**: Use `npm:` specifier for backend-only packages (better performance, modern Deno way).\n\n### Creating Route Modules\n\nWhen creating route modules (e.g., `backend/routes/api/pages.ts`):\n\n```typescript\nimport { Hono } from \"npm:hono@4\";\nimport * as pageController from '../../controllers/pageController.ts';\n\nconst pages = new Hono();\n\n// GET /api/pages/:id\npages.get('/:id', async (c) => {\n const pageId = c.req.param('id');\n const result = await pageController.getPage(pageId);\n\n if (!result.success) {\n return c.json({ error: result.error, details: result.details }, 400);\n }\n\n return c.json(result.data);\n});\n\n// POST /api/pages/:id\npages.post('/:id', async (c) => {\n const pageId = c.req.param('id');\n const body = await c.req.json();\n\n const result = await pageController.updatePage(pageId, body.properties);\n\n if (!result.success) {\n return c.json({ error: result.error, details: result.details }, 400);\n }\n\n return c.json(result.data);\n});\n\nexport default pages;\n```\n\n### Mounting Routes\n\nCreate an index file for each route directory (e.g., `backend/routes/api/index.ts`):\n\n```typescript\nimport { Hono } from \"npm:hono@4\";\nimport pages from './pages.ts';\n\nconst api = new Hono();\n\napi.route('/pages', pages);\n// Add more routes as needed\n\nexport default api;\n```\n\nThen mount in `main.http.tsx`:\n\n```typescript\nimport api from './backend/routes/api/index.ts';\napp.route('/api', api);\n```\n\n### Accessing Request Data\n\n```typescript\n// URL params\nconst id = c.req.param('id');\n\n// Query params\nconst query = c.req.query('q');\n\n// Headers\nconst apiKey = c.req.header('x-api-key');\n\n// JSON body\nconst body = await c.req.json();\n\n// Form data\nconst formData = await c.req.formData();\n```\n\n### Returning Responses\n\n```typescript\n// JSON response\nreturn c.json({ data: 'value' });\n\n// JSON with status code\nreturn c.json({ error: 'Not found' }, 404);\n\n// HTML response\nreturn c.html('<h1>Hello</h1>');\n\n// Plain text\nreturn c.text('Hello');\n\n// Redirect (use this pattern, not Response.redirect)\nreturn new Response(null, { status: 302, headers: { Location: '/new-url' }});\n```\n\n### Middleware\n\nApply middleware to routes:\n\n```typescript\nimport { authCheck } from '../authCheck.ts';\n\n// Apply to single route\npages.post('/:id', authCheck, async (c) => {\n // Protected route logic\n});\n\n// Apply to all routes in this module\npages.use('*', authCheck);\n```\n\n### Error Handler\n\nAlready configured in `main.http.tsx`:\n\n```typescript\napp.onError((err, c) => {\n throw err; // Re-throw to see full stack trace\n});\n```\n\n### Static File Serving\n\nAlready configured in `main.http.tsx`:\n\n```typescript\nimport { serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n### Route Organization Example\n\n```\nbackend/routes/\n├── api/\n│ ├── index.ts # Mounts all API routes\n│ ├── pages.ts # /api/pages/* endpoints\n│ └── databases.ts # /api/databases/* endpoints\n├── tasks/\n│ ├── index.ts # Mounts all webhook routes\n│ └── notion.ts # /tasks/notion webhook handler\n├── views/\n│ └── dashboard.ts # /views/dashboard page\n└── authCheck.ts # Auth middleware\n```\n",[238],"1cb98422-b360-11f0-bc6f-0224a6c84d84","AGENTS.md","019a26dc-99bf-7269-a8f6-692ef14e0fe6",["D",1761588582800],"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = 'todo_app_users_2';\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create a fresh table.\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({ \n subject: \"Hi\", \n text: \"Hi\", \n html: \"<h1>Hi</h1>\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\" urls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's *extremely importing* to note that `parseProject` and other Standard Library utilities ONLY RUN ON THE SERVER.\nIf you need access to this data on the client, run it in the server and pass it to the client by splicing it into the HTML page\nor by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `<img src=\"https://maxm-imggenurl.web.val.run/the-description-of-your-image\" />`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link by importing & using `import.meta.url.replace(\"ems.sh\", \"val.town)\"` (or passing this data to the client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `<script src=\"https://esm.town/v/std/catch\"></script>` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `<script src=\"https://cdn.twind.style\" crossorigin></script>` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n \n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n \n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n \n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = `<script>\n window.__INITIAL_DATA__ = ${JSON.stringify(initialData)};\n </script>`;\n \n html = html.replace(\"</head>\", `${dataScript}</head>`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:** \n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n",[244],"1cb9830a-b360-11f0-bc6f-0224a6c84d84",".vtignore","019a26dc-99bf-7269-a8f6-6555ae856e94",["D",1761588582800],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\nvars.env",[250],"1cb981de-b360-11f0-bc6f-0224a6c84d84","shared","019a26dc-99bf-7269-a8f6-63c6fd1d84b1",["D",1761588582800],"directory",[256],"1cb9746e-b360-11f0-bc6f-0224a6c84d84","frontend","019a26dc-99bf-7269-a8f6-51875d2ac446",["D",1761588582800],[262],"1cb966d6-b360-11f0-bc6f-0224a6c84d84","backend","019a26dc-99bf-7269-a8f6-32bd7c2a6dc6",["D",1761588582800],[267],"1cb9476e-b360-11f0-bc6f-0224a6c84d84",".claude","019a26dc-99bf-7269-a8f5-f075c4855e23",["D",1761588582800],[272],"pulls","branches","forks","envVars",{"_283":285,"_286":125},"connections",{"_283":125,"_284":125},"count","unfilledCount",15,"emptyCount",{"_107":271,"_40":272,"_38":273,"_216":-5,"_50":51,"_49":229,"_218":32,"_47":646,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":647,"_35":648},{"_107":639,"_40":640,"_38":641,"_216":273,"_50":51,"_49":229,"_218":34,"_47":642,"_13":125,"_42":27,"_44":643,"_31":34,"_223":-5,"_342":644,"_35":645},{"_107":266,"_40":267,"_38":268,"_216":-5,"_50":51,"_49":229,"_218":32,"_47":636,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":637,"_35":638},{"_107":632,"_40":608,"_38":604,"_216":268,"_50":51,"_49":229,"_218":32,"_47":633,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":634,"_35":635},{"_107":624,"_40":625,"_38":626,"_216":604,"_50":51,"_49":627,"_218":32,"_47":628,"_13":220,"_42":43,"_44":629,"_31":34,"_223":-5,"_342":630,"_35":631},{"_107":617,"_40":618,"_38":619,"_216":604,"_50":51,"_49":217,"_218":34,"_47":620,"_13":229,"_42":43,"_44":621,"_31":34,"_223":-5,"_342":622,"_35":623},{"_107":613,"_40":88,"_38":87,"_216":604,"_50":51,"_49":14,"_218":34,"_47":614,"_13":235,"_42":43,"_44":90,"_31":34,"_223":-5,"_342":615,"_35":616},{"_107":609,"_40":64,"_38":63,"_216":604,"_50":51,"_49":14,"_218":34,"_47":610,"_13":229,"_42":43,"_44":66,"_31":34,"_223":-5,"_342":611,"_35":612},{"_107":603,"_40":80,"_38":79,"_216":604,"_50":51,"_49":14,"_218":34,"_47":605,"_13":229,"_42":43,"_44":82,"_31":34,"_223":-5,"_342":606,"_35":607},{"_107":599,"_40":591,"_38":585,"_216":268,"_50":51,"_49":217,"_218":32,"_47":600,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":601,"_35":602},{"_107":592,"_40":593,"_38":594,"_216":585,"_50":51,"_49":217,"_218":34,"_47":595,"_13":125,"_42":587,"_44":596,"_31":34,"_223":-5,"_342":597,"_35":598},{"_107":582,"_40":583,"_38":584,"_216":585,"_50":51,"_49":217,"_218":34,"_47":586,"_13":125,"_42":587,"_44":588,"_31":34,"_223":-5,"_342":589,"_35":590},{"_107":578,"_40":525,"_38":520,"_216":268,"_50":51,"_49":229,"_218":32,"_47":579,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":580,"_35":581},{"_107":574,"_40":567,"_38":562,"_216":520,"_50":51,"_49":229,"_218":32,"_47":575,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":576,"_35":577},{"_107":568,"_40":496,"_38":569,"_216":562,"_50":51,"_49":229,"_218":34,"_47":570,"_13":125,"_42":43,"_44":571,"_31":34,"_223":-5,"_342":572,"_35":573},{"_107":560,"_40":489,"_38":561,"_216":562,"_50":51,"_49":217,"_218":32,"_47":563,"_13":229,"_42":43,"_44":564,"_31":34,"_223":-5,"_342":565,"_35":566},{"_107":556,"_40":537,"_38":533,"_216":520,"_50":51,"_49":229,"_218":32,"_47":557,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":558,"_35":559},{"_107":549,"_40":550,"_38":551,"_216":533,"_50":51,"_49":285,"_218":32,"_47":552,"_13":235,"_42":43,"_44":553,"_31":34,"_223":-5,"_342":554,"_35":555},{"_107":542,"_40":543,"_38":544,"_216":533,"_50":51,"_49":449,"_218":32,"_47":545,"_13":125,"_42":43,"_44":546,"_31":34,"_223":-5,"_342":547,"_35":548},{"_107":538,"_40":41,"_38":39,"_216":533,"_50":51,"_49":14,"_218":34,"_47":539,"_13":229,"_42":43,"_44":46,"_31":34,"_223":-5,"_342":540,"_35":541},{"_107":532,"_40":56,"_38":55,"_216":533,"_50":51,"_49":14,"_218":34,"_47":534,"_13":229,"_42":43,"_44":58,"_31":34,"_223":-5,"_342":535,"_35":536},{"_107":526,"_40":527,"_38":528,"_216":520,"_50":51,"_49":229,"_218":32,"_47":529,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":530,"_35":531},{"_107":517,"_40":518,"_38":519,"_216":520,"_50":51,"_49":229,"_218":34,"_47":521,"_13":125,"_42":43,"_44":522,"_31":34,"_223":-5,"_342":523,"_35":524},{"_107":513,"_40":474,"_38":468,"_216":268,"_50":51,"_49":229,"_218":32,"_47":514,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":515,"_35":516},{"_107":509,"_40":487,"_38":482,"_216":468,"_50":51,"_49":229,"_218":32,"_47":510,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":511,"_35":512},{"_107":502,"_40":503,"_38":504,"_216":482,"_50":51,"_49":449,"_218":34,"_47":505,"_13":229,"_42":43,"_44":506,"_31":34,"_223":-5,"_342":507,"_35":508},{"_107":495,"_40":496,"_38":497,"_216":482,"_50":51,"_49":217,"_218":34,"_47":498,"_13":229,"_42":43,"_44":499,"_31":34,"_223":-5,"_342":500,"_35":501},{"_107":488,"_40":489,"_38":490,"_216":482,"_50":51,"_49":449,"_218":34,"_47":491,"_13":235,"_42":43,"_44":492,"_31":34,"_223":-5,"_342":493,"_35":494},{"_107":479,"_40":480,"_38":481,"_216":482,"_50":51,"_49":217,"_218":32,"_47":483,"_13":125,"_42":43,"_44":484,"_31":34,"_223":-5,"_342":485,"_35":486},{"_107":475,"_40":72,"_38":71,"_216":468,"_50":51,"_49":14,"_218":34,"_47":476,"_13":229,"_42":43,"_44":74,"_31":34,"_223":-5,"_342":477,"_35":478},{"_107":465,"_40":466,"_38":467,"_216":468,"_50":51,"_49":469,"_218":32,"_47":470,"_13":229,"_42":43,"_44":471,"_31":34,"_223":-5,"_342":472,"_35":473},{"_107":461,"_40":445,"_38":440,"_216":268,"_50":51,"_49":449,"_218":32,"_47":462,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":463,"_35":464},{"_107":454,"_40":455,"_38":456,"_216":440,"_50":51,"_49":449,"_218":32,"_47":457,"_13":125,"_42":43,"_44":458,"_31":34,"_223":-5,"_342":459,"_35":460},{"_107":446,"_40":447,"_38":448,"_216":440,"_50":51,"_49":449,"_218":32,"_47":450,"_13":125,"_42":43,"_44":451,"_31":34,"_223":-5,"_342":452,"_35":453},{"_107":437,"_40":438,"_38":439,"_216":440,"_50":51,"_49":217,"_218":34,"_47":441,"_13":229,"_42":43,"_44":442,"_31":34,"_223":-5,"_342":443,"_35":444},{"_107":431,"_40":94,"_38":432,"_216":268,"_50":51,"_49":229,"_218":32,"_47":433,"_13":125,"_42":27,"_44":434,"_31":34,"_223":-5,"_342":435,"_35":436},{"_107":261,"_40":262,"_38":263,"_216":-5,"_50":51,"_49":229,"_218":32,"_47":428,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":429,"_35":430},{"_107":424,"_40":409,"_38":404,"_216":263,"_50":51,"_49":229,"_218":32,"_47":425,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":426,"_35":427},{"_107":417,"_40":418,"_38":419,"_216":404,"_50":51,"_49":229,"_218":34,"_47":420,"_13":125,"_42":43,"_44":421,"_31":34,"_223":-5,"_342":422,"_35":423},{"_107":410,"_40":411,"_38":412,"_216":404,"_50":51,"_49":229,"_218":32,"_47":413,"_13":125,"_42":43,"_44":414,"_31":34,"_223":-5,"_342":415,"_35":416},{"_107":401,"_40":402,"_38":403,"_216":404,"_50":51,"_49":229,"_218":32,"_47":405,"_13":125,"_42":43,"_44":406,"_31":34,"_223":-5,"_342":407,"_35":408},{"_107":395,"_40":94,"_38":396,"_216":263,"_50":51,"_49":229,"_218":32,"_47":397,"_13":125,"_42":27,"_44":398,"_31":34,"_223":-5,"_342":399,"_35":400},{"_107":388,"_40":389,"_38":390,"_216":263,"_50":51,"_49":229,"_218":34,"_47":391,"_13":125,"_42":27,"_44":392,"_31":34,"_223":-5,"_342":393,"_35":394},{"_107":381,"_40":382,"_38":383,"_216":263,"_50":51,"_49":229,"_218":32,"_47":384,"_13":125,"_42":43,"_44":385,"_31":34,"_223":-5,"_342":386,"_35":387},{"_107":255,"_40":256,"_38":257,"_216":-5,"_50":51,"_49":229,"_218":32,"_47":378,"_13":125,"_42":259,"_44":-5,"_31":34,"_223":-5,"_342":379,"_35":380},{"_107":372,"_40":94,"_38":373,"_216":257,"_50":51,"_49":229,"_218":32,"_47":374,"_13":125,"_42":27,"_44":375,"_31":34,"_223":-5,"_342":376,"_35":377},{"_107":367,"_40":103,"_38":102,"_216":257,"_50":51,"_49":14,"_218":34,"_47":368,"_13":369,"_42":43,"_44":105,"_31":34,"_223":-5,"_342":370,"_35":371},{"_107":360,"_40":361,"_38":362,"_216":257,"_50":51,"_49":229,"_218":34,"_47":363,"_13":125,"_42":43,"_44":364,"_31":34,"_223":-5,"_342":365,"_35":366},{"_107":249,"_40":250,"_38":251,"_216":-5,"_50":51,"_49":229,"_218":32,"_47":357,"_13":125,"_42":27,"_44":253,"_31":34,"_223":-5,"_342":358,"_35":359},{"_107":243,"_40":244,"_38":245,"_216":-5,"_50":51,"_49":229,"_218":32,"_47":354,"_13":125,"_42":27,"_44":247,"_31":34,"_223":-5,"_342":355,"_35":356},{"_107":237,"_40":238,"_38":239,"_216":-5,"_50":51,"_49":229,"_218":34,"_47":351,"_13":125,"_42":27,"_44":241,"_31":34,"_223":-5,"_342":352,"_35":353},{"_107":233,"_40":94,"_38":95,"_216":-5,"_50":51,"_49":14,"_218":34,"_47":348,"_13":235,"_42":27,"_44":97,"_31":34,"_223":-5,"_342":349,"_35":350},{"_107":226,"_40":227,"_38":228,"_216":-5,"_50":51,"_49":229,"_218":32,"_47":345,"_13":125,"_42":27,"_44":231,"_31":34,"_223":-5,"_342":346,"_35":347},{"_107":214,"_40":215,"_38":120,"_216":-5,"_50":51,"_49":217,"_218":34,"_47":341,"_13":220,"_42":221,"_44":222,"_31":34,"_223":224,"_342":343,"_35":344},["D",1761760757953],"children",[],[215],["D",1761588582800],[],[227],["D",1761773737671],[],[94],["D",1761588582800],[],[238],["D",1761588582800],[],[244],["D",1761588582800],[],[250],"1cb97f04-b360-11f0-bc6f-0224a6c84d84","utils.ts","019a26dc-99bf-7269-a8f6-5e2af0c9fdd2",["D",1761588582800],"/**\n * Shared utility functions\n * IMPORTANT: These must work in both browser AND Deno (no Deno APIs allowed)\n */\n\n/**\n * Check if a string is a valid Notion page ID format\n */\nexport function isValidPageId(pageId: string): boolean {\n if (!pageId || typeof pageId !== 'string') {\n return false;\n }\n\n // Notion IDs are 32 characters (with or without hyphens)\n const cleanId = pageId.replace(/-/g, '');\n return cleanId.length === 32 && /^[a-f0-9]+$/i.test(cleanId);\n}\n\n/**\n * Normalize a Notion page ID (remove hyphens)\n */\nexport function normalizePageId(pageId: string): string {\n return pageId.replace(/-/g, '');\n}\n\n/**\n * Format a Notion page ID with hyphens in standard format\n * 8-4-4-4-12\n */\nexport function formatPageId(pageId: string): string {\n const clean = normalizePageId(pageId);\n return `${clean.slice(0, 8)}-${clean.slice(8, 12)}-${clean.slice(12, 16)}-${clean.slice(16, 20)}-${clean.slice(20)}`;\n}\n\n/**\n * Extract plain text from Notion rich text array\n */\nexport function getPlainText(richText: any[]): string {\n if (!Array.isArray(richText)) {\n return '';\n }\n return richText.map(text => text.plain_text || '').join('');\n}\n\n/**\n * Safely get a property value from Notion page properties\n */\nexport function getPropertyValue(properties: any, propertyName: string): any {\n const property = properties[propertyName];\n if (!property) {\n return null;\n }\n\n // Extract value based on property type\n switch (property.type) {\n case 'title':\n return getPlainText(property.title);\n case 'rich_text':\n return getPlainText(property.rich_text);\n case 'number':\n return property.number;\n case 'select':\n return property.select?.name || null;\n case 'multi_select':\n return property.multi_select?.map((s: any) => s.name) || [];\n case 'date':\n return property.date?.start || null;\n case 'checkbox':\n return property.checkbox;\n case 'url':\n return property.url;\n case 'email':\n return property.email;\n case 'phone_number':\n return property.phone_number;\n case 'status':\n return property.status?.name || null;\n default:\n return property;\n }\n}\n",[],[256,361],"359b01c2-b50f-11f0-9598-0224a6c84d84",["D",1761773737671],4,[],[256,103],"1cb975e0-b360-11f0-bc6f-0224a6c84d84","019a26dc-99bf-7269-a8f6-57913e4eabdf",["D",1761588582800],"# Shared\n\nThis directory contains code shared between frontend (browser) and backend (Deno).\n\n## Files\n\n- **types.ts** - TypeScript interfaces and types\n - Controller response format\n - Notion data structures\n - API request/response types\n\n- **utils.ts** - Utility functions\n - Must work in both browser AND Deno\n - ❌ **NEVER use Deno APIs** (won't work in browser)\n - ✅ Only use standard JavaScript/TypeScript\n\n## Guidelines\n\n### Adding Types\n- Define interfaces for data shared between layers\n- Use clear, descriptive names (PascalCase)\n- Document complex types with comments\n\n### Adding Utils\n- Test that functions work in both environments\n- Avoid platform-specific APIs (Deno, Node, browser-only)\n- Use pure functions when possible\n\n## Example\n\n```typescript\n// ✅ Good - works everywhere\nexport function formatDate(date: string): string {\n return new Date(date).toLocaleDateString();\n}\n\n// ❌ Bad - Deno-specific\nexport function readConfig() {\n return Deno.env.get('CONFIG'); // Won't work in browser!\n}\n```\n",[],[256,94],["D",1761588582800],[332,333,334],[256],"1cb97342-b360-11f0-bc6f-0224a6c84d84","index.tsx","019a26dc-99bf-7269-a8f6-4e21b80e62ce",["D",1761588582800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport ReactDOM from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { App } from \"./components/App.tsx\";\n\nconst root = ReactDOM.createRoot(document.getElementById(\"root\")!);\nroot.render(\n <React.StrictMode>\n <App />\n </React.StrictMode>\n);\n",[],[262,382],"1cb9722a-b360-11f0-bc6f-0224a6c84d84","index.html","019a26dc-99bf-7269-a8f6-489546010958",["D",1761588582800],"<!DOCTYPE html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>Notion Webhook Integration</title>\n\n \n <link\n href=\"https://cdn.jsdelivr.net/npm/@picocss/pico@2.1.1/css/pico.classless.min.css\"\n rel=\"stylesheet\"\n />\n\n \n <script src=\"https://esm.town/v/std/catch\"></script>\n </head>\n <body>\n <div id=\"root\"></div>\n\n \n <script type=\"module\" src=\"/frontend/index.tsx\"></script>\n </body>\n</html>\n",[],[262,389],"1cb97072-b360-11f0-bc6f-0224a6c84d84","019a26dc-99bf-7269-a8f6-463e83dc952c",["D",1761588582800],"# Frontend\n\nThis directory contains the React frontend for the Notion webhook integration application.\n\n## Structure\n\n- **index.html** - HTML shell that loads the React app\n- **index.tsx** - React app entry point\n- **components/** - React components\n - **App.tsx** - Main application component\n - **NotionBlock.tsx** - Renders Notion block content\n - **NotionProperty.tsx** - Displays Notion page properties\n\n## React Configuration\n\n**IMPORTANT**: All React files must:\n1. Include `/** @jsxImportSource https://esm.sh/react@18.2.0 */` at the top\n2. Pin React dependencies to version 18.2.0: `?deps=react@18.2.0`\n3. Use consistent React version across all imports\n\n## Styling\n\nUses Pico CSS (classless CSS framework loaded from CDN in index.html). Pico automatically styles semantic HTML elements without requiring CSS classes, keeping markup clean and maintainable.\n\n## API Communication\n\n- Fetch data from `/api/*` endpoints\n- Use shared types from `../shared/types.ts`\n- Handle loading and error states in components\n\n## Error Handling\n\nThe error catching script is included in index.html to capture client-side errors for better debugging.\n\n## Development\n\nSince this is a Val Town project, the frontend is served through Hono routes defined in `main.http.tsx`.\n",[],[262,94],"1cb96d48-b360-11f0-bc6f-0224a6c84d84","NotionProperty.tsx","019a26dc-99bf-7269-a8f6-3d6be1b615e8","019a26dc-99bf-7269-a8f6-40d88c93ec73",["D",1761588582800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { getPropertyValue } from \"../../shared/utils.ts\";\n\ninterface NotionPropertyProps {\n name: string;\n property: any;\n}\n\n/**\n * Component for rendering Notion page properties\n * Uses semantic HTML - Pico CSS provides automatic styling\n * Handles different property types\n */\nexport function NotionProperty({ name, property }: NotionPropertyProps) {\n if (!property) {\n return null;\n }\n\n const value = getPropertyValue({ [name]: property }, name);\n\n const renderValue = () => {\n switch (property.type) {\n case 'title':\n case 'rich_text':\n return <span>{value}</span>;\n\n case 'number':\n return <code>{value}</code>;\n\n case 'select':\n return <kbd>{value}</kbd>;\n\n case 'multi_select':\n return (\n <span>\n {Array.isArray(value) && value.map((item: string, i: number) => (\n <kbd key={i} style={{ marginRight: '0.5rem' }}>\n {item}\n </kbd>\n ))}\n </span>\n );\n\n case 'date':\n return (\n <time>\n {value ? new Date(value).toLocaleDateString() : '-'}\n </time>\n );\n\n case 'checkbox':\n return (\n <input\n type=\"checkbox\"\n checked={value}\n readOnly\n />\n );\n\n case 'url':\n return (\n <a\n href={value}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n >\n {value}\n </a>\n );\n\n case 'email':\n return (\n <a href={`mailto:${value}`}>\n {value}\n </a>\n );\n\n case 'phone_number':\n return (\n <a href={`tel:${value}`}>\n {value}\n </a>\n );\n\n case 'status':\n return <mark>{value}</mark>;\n\n default:\n return (\n <small>\n <em>Unsupported: {property.type}</em>\n </small>\n );\n }\n };\n\n return (\n <p>\n <strong>{name}:</strong> {renderValue()}\n </p>\n );\n}\n",[],[262,409,402],"components","1cb96a96-b360-11f0-bc6f-0224a6c84d84","NotionBlock.tsx","019a26dc-99bf-7269-a8f6-3ab802992fe4",["D",1761588582800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface NotionBlockProps {\n block: any;\n}\n\n/**\n * Component for rendering Notion blocks\n * Uses semantic HTML - Pico CSS provides automatic styling\n * Extend this to support different block types as needed\n */\nexport function NotionBlock({ block }: NotionBlockProps) {\n if (!block || !block.type) {\n return null;\n }\n\n const renderBlockContent = () => {\n switch (block.type) {\n case 'paragraph':\n return (\n <p>\n {block.paragraph?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </p>\n );\n\n case 'heading_1':\n return (\n <h1>\n {block.heading_1?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </h1>\n );\n\n case 'heading_2':\n return (\n <h2>\n {block.heading_2?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </h2>\n );\n\n case 'heading_3':\n return (\n <h3>\n {block.heading_3?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </h3>\n );\n\n case 'bulleted_list_item':\n return (\n <li>\n {block.bulleted_list_item?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </li>\n );\n\n case 'numbered_list_item':\n return (\n <li>\n {block.numbered_list_item?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </li>\n );\n\n case 'to_do':\n return (\n <label>\n <input\n type=\"checkbox\"\n checked={block.to_do?.checked}\n readOnly\n />\n <span style={block.to_do?.checked ? { textDecoration: 'line-through', opacity: 0.6 } : undefined}>\n {block.to_do?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </span>\n </label>\n );\n\n case 'code':\n return (\n <pre>\n <code>\n {block.code?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </code>\n </pre>\n );\n\n default:\n return (\n <small>\n <em>Unsupported block type: {block.type}</em>\n </small>\n );\n }\n };\n\n return <div>{renderBlockContent()}</div>;\n}\n",[],[262,409,411],"1cb9680c-b360-11f0-bc6f-0224a6c84d84","App.tsx","019a26dc-99bf-7269-a8f6-34ccac805b70",["D",1761588582800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n\nexport function App() {\n const [pageId, setPageId] = useState(\"\");\n const [pageData, setPageData] = useState<any>(null);\n const [loading, setLoading] = useState(false);\n const [error, setError] = useState<string | null>(null);\n\n const fetchPage = async () => {\n if (!pageId.trim()) {\n setError(\"Please enter a page ID\");\n return;\n }\n\n setLoading(true);\n setError(null);\n setPageData(null);\n\n try {\n const response = await fetch(`/api/pages/${pageId}`);\n const data = await response.json();\n\n if (!response.ok) {\n throw new Error(data.error || \"Failed to fetch page\");\n }\n\n setPageData(data);\n } catch (err: any) {\n setError(err.message || \"An error occurred\");\n } finally {\n setLoading(false);\n }\n };\n\n const handleKeyDown = (e: React.KeyboardEvent) => {\n if (e.key === \"Enter\") {\n fetchPage();\n }\n };\n\n return (\n <main>\n <h1>Notion Webhook Integration</h1>\n\n <article>\n <h2>Fetch Notion Page</h2>\n\n <div>\n <input\n type=\"text\"\n placeholder=\"Enter Notion page ID\"\n value={pageId}\n onChange={(e) => setPageId(e.target.value)}\n onKeyDown={handleKeyDown}\n style={{ flex: 1 }}\n />\n <button onClick={fetchPage} disabled={loading} aria-busy={loading}>\n {loading ? \"Loading...\" : \"Fetch\"}\n </button>\n </div>\n\n {error && <mark>{error}</mark>}\n\n {pageData && (\n <section>\n <h3>Page Data:</h3>\n <pre>{JSON.stringify(pageData, null, 2)}</pre>\n </section>\n )}\n </article>\n\n <article>\n <h2>Getting Started</h2>\n <p>\n This is a scaffold for a Notion webhook integration. To get started:\n </p>\n <ol>\n <li>Set up your environment variables (NOTION_API_KEY)</li>\n <li>\n Create routes in <code>backend/routes/</code>\n </li>\n <li>\n Add controllers in <code>backend/controllers/</code>\n </li>\n <li>\n Integrate external services in <code>backend/services/</code>\n </li>\n <li>\n Follow the architecture guidelines in <code>CLAUDE.md</code>\n </li>\n </ol>\n </article>\n </main>\n );\n}\n",[],[262,409,418],"1cb96f5a-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[325,326,327],[262,409],["D",1761588582800],[324,328,329,330],[262],"1cb96514-b360-11f0-bc6f-0224a6c84d84","019a26dc-99bf-7269-a8f6-2fbd5953f9c6",["D",1761588582800],"# Backend\n\nThis directory contains the backend logic for the Notion webhook integration application.\n\n## Structure\n\n- **controllers/** - Business logic and orchestration\n - Contains functions that validate data, orchestrate service calls, and return standardized responses\n - All controllers return `{success, data, error, details?}` format\n - Controllers are HTTP-agnostic (don't create HTTP responses)\n\n- **routes/** - HTTP request/response handling\n - **api/** - RESTful API endpoints for data operations\n - **tasks/** - Notion webhook handlers\n - **views/** - User-facing HTML/React views\n - **authCheck.ts** - Authentication middleware\n\n- **services/** - External API integrations\n - Handle calls to external APIs (Notion, Firecrawler, blob storage, etc.)\n - Return structured results with `{success, data, error}` format\n - Manage API authentication and error handling\n\n## Architecture Flow\n\n```\nRequest → Route → Controller → Service → External API\n```\n\n**Never skip layers!**\n- Routes call controllers (not services directly)\n- Controllers call services (not external APIs directly)\n- Services handle external API calls\n\n## Adding New Features\n\n1. Create route in appropriate directory (`api/`, `tasks/`, or `views/`)\n2. Create controller function with business logic\n3. Create/use service functions for external API calls\n4. Mount route in `main.http.tsx`\n\nSee `CLAUDE.md` for detailed guidelines.\n",[],[267,94],"fd17bce6-b4f0-11f0-8e48-0224a6c84d84","notionUtils.ts","1582a536-b459-11f0-a09c-0224a6c84d84","019a2d3c-4319-71ac-88e5-a0aa162b3be7",["D",1761760757953],"/**\n * Notion utility functions for block transformations and processing\n */\n\n/**\n * Format an ISO date string to human-readable format\n *\n * @param dateStr - ISO date string (e.g., \"2025-10-27\" or \"2025-10-27T09:00:00.000-04:00\")\n * @returns Formatted date string (e.g., \"October 27, 2025\" or \"October 27, 2025 at 9:00 AM EDT\")\n */\nfunction formatDateString(dateStr: string): string {\n try {\n // Check if it's date-only (no time component in original string)\n const isDateOnly = !dateStr.includes('T');\n\n if (isDateOnly) {\n // Date-only format: \"October 27, 2025\"\n const date = new Date(dateStr);\n return date.toLocaleDateString('en-US', {\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n timeZone: 'UTC' // Use UTC for date-only to avoid timezone shifts\n });\n } else {\n // Datetime format: \"October 27, 2025 at 9:00 AM EDT\"\n // Parse the ISO string to extract components without timezone conversion\n const isoMatch = dateStr.match(/^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.\\d+)?([-+]\\d{2}:\\d{2})?$/);\n\n if (!isoMatch) {\n // Fallback to original string if format doesn't match\n return dateStr;\n }\n\n const [_, year, month, day, hour24, minute, second, tzOffset] = isoMatch;\n\n // Create date object for formatting the date part only\n const date = new Date(`${year}-${month}-${day}`);\n const datePart = date.toLocaleDateString('en-US', {\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n timeZone: 'UTC'\n });\n\n // Format time part - preserve the original hour/minute\n const hourNum = parseInt(hour24, 10);\n const minuteNum = parseInt(minute, 10);\n const isPM = hourNum >= 12;\n const hour12 = hourNum === 0 ? 12 : (hourNum > 12 ? hourNum - 12 : hourNum);\n const timePart = `${hour12}:${minute} ${isPM ? 'PM' : 'AM'}`;\n\n // Extract timezone abbreviation\n let tzAbbrev = '';\n if (tzOffset) {\n // Common timezone abbreviations based on offset\n const tzMap: Record<string, string> = {\n '-04:00': 'EDT',\n '-05:00': 'EST/CDT',\n '-06:00': 'CST/MDT',\n '-07:00': 'MST/PDT',\n '-08:00': 'PST',\n '+00:00': 'UTC',\n // Add more as needed\n };\n tzAbbrev = ` ${tzMap[tzOffset] || tzOffset}`;\n }\n\n return `${datePart} at ${timePart}${tzAbbrev}`;\n }\n } catch (err) {\n // If parsing fails, return original string\n return dateStr;\n }\n}\n\n/**\n * Remove hyphens from a string (for Notion URLs)\n */\nfunction removeHyphens(str: string): string {\n return str.replace(/-/g, '');\n}\n\nexport function reduceNotionBlock(block: any) {\n const blockId = block?.id;\n const lastEdited = block?.last_edited_time;\n\n // Generate Notion block URL\n const blockUrl = blockId ? `https://www.notion.so/${removeHyphens(blockId)}` : '';\n\n const richText = block?.[block.type]?.rich_text ?? [];\n\n // Date mentions (preserve original format from Notion)\n const date_mentions = richText\n .filter((part: any) => part.type === \"mention\" && part.mention?.type === \"date\")\n .map((part: any) => {\n // Return original date string to preserve user's intent (date-only, datetime, timezone)\n const dateStr = part.mention.date.start ?? part.mention.date.end;\n return dateStr || null;\n })\n .filter((date: string | null): date is string => !!date);\n\n // Build full sentence and replace ISO dates with formatted versions\n let fullSentence = richText\n .map((part: any) => part.plain_text)\n .join(\"\")\n .replace(/\\s+/g, \" \") // collapse multiple spaces\n .trim();\n\n // Replace each date mention in the full sentence with formatted version\n for (const dateStr of date_mentions) {\n const formattedDate = formatDateString(dateStr);\n // Replace the ISO date string with formatted version\n fullSentence = fullSentence.replace(dateStr, formattedDate);\n }\n\n // People mentions\n const people_mentions = richText\n .filter((part: any) => part.type === \"mention\" && part.mention?.type === \"user\")\n .map((part: any) => {\n const user = part.mention.user;\n return {\n id: user.id,\n name: user.name,\n email: user.person?.email ?? null,\n };\n });\n\n // Link mentions (Notion pages, external links - anything with href)\n const link_mentions = richText\n .filter((part: any) => {\n // Check for href property (mentions and some links)\n // OR check for text.link.url (regular hyperlinks)\n return part.href || part.text?.link?.url;\n })\n .map((part: any) => ({\n text: part.plain_text,\n url: part.href || part.text?.link?.url\n }));\n\n return {\n full_sentence: fullSentence,\n block_id: blockId,\n block_url: blockUrl,\n last_edited_time: lastEdited,\n people_mentions,\n date_mentions,\n link_mentions,\n };\n}\n\n/**\n * Map ReducedNotionBlock to Notion database properties\n *\n * Property mappings:\n * - full_sentence → Name (title)\n * - block_id → Block ID (rich_text)\n * - block_url → Block URL (url)\n * - last_edited_time → Todo last edited time (date)\n * - people_mentions[0] → Owner (people)\n * - people_mentions[1..] → Other people (people)\n * - date_mentions[0] → Due date (date)\n * - link_mentions → Links (rich_text with embedded links)\n */\nexport function mapReducedBlockToProperties(reducedBlock: any) {\n const properties: any = {};\n\n // Name (title)\n properties[\"Name\"] = {\n title: [\n {\n type: \"text\",\n text: { content: reducedBlock.full_sentence }\n }\n ]\n };\n\n // Block ID (rich_text)\n properties[\"Block ID\"] = {\n rich_text: [\n {\n type: \"text\",\n text: { content: reducedBlock.block_id }\n }\n ]\n };\n\n // Block URL (url)\n if (reducedBlock.block_url) {\n properties[\"Block URL\"] = {\n url: reducedBlock.block_url\n };\n }\n\n // Todo last edited time (date)\n properties[\"Todo last edited time\"] = {\n date: {\n start: reducedBlock.last_edited_time\n }\n };\n\n // Owner (people) - first person\n if (reducedBlock.people_mentions && reducedBlock.people_mentions.length > 0) {\n properties[\"Owner\"] = {\n people: [{ id: reducedBlock.people_mentions[0].id }]\n };\n }\n\n // Other people (people) - remaining people\n if (reducedBlock.people_mentions && reducedBlock.people_mentions.length > 1) {\n properties[\"Other people\"] = {\n people: reducedBlock.people_mentions.slice(1).map((p: any) => ({ id: p.id }))\n };\n }\n\n // Due date (date) - first date\n if (reducedBlock.date_mentions && reducedBlock.date_mentions.length > 0) {\n properties[\"Due date\"] = {\n date: {\n start: reducedBlock.date_mentions[0]\n }\n };\n }\n\n // Links (rich_text with embedded links as bullet list)\n if (reducedBlock.link_mentions && reducedBlock.link_mentions.length > 0) {\n properties[\"Links\"] = {\n rich_text: reducedBlock.link_mentions.flatMap((link: any, index: number) => {\n const parts = [];\n\n // Add bullet before each link\n parts.push({ type: \"text\", text: { content: \"• \" } });\n\n // Add the link\n parts.push({\n type: \"text\",\n text: {\n content: link.text,\n link: { url: link.url }\n }\n });\n\n // Add newline after each link except the last\n if (index < reducedBlock.link_mentions.length - 1) {\n parts.push({ type: \"text\", text: { content: \"\\n\" } });\n }\n\n return parts;\n })\n };\n }\n\n return properties;\n}\n",[],[267,445,438],"utils","1582a266-b459-11f0-a09c-0224a6c84d84","emojiUtils.ts","1582a2fc-b459-11f0-a09c-0224a6c84d84",16,["D",1761695515418],"/**\n * Emoji utility functions for extracting and detecting emojis\n */\n\n/**\n * Extract the first emoji from a text string\n *\n * @param text - Text to search for emoji\n * @returns First emoji character or null if none found\n *\n * @example\n * extractFirstEmoji(\"📝 Write documentation\") // Returns \"📝\"\n * extractFirstEmoji(\"No emoji here\") // Returns null\n */\nexport function extractFirstEmoji(text: string): string | null {\n if (!text) return null;\n\n // Comprehensive emoji regex pattern covering most common emoji ranges\n const emojiRegex = /[\\u{1F300}-\\u{1F9FF}\\u{2600}-\\u{26FF}\\u{2700}-\\u{27BF}\\u{1F000}-\\u{1F02F}\\u{1F0A0}-\\u{1F0FF}\\u{1F100}-\\u{1F64F}\\u{1F680}-\\u{1F6FF}\\u{1F900}-\\u{1F9FF}\\u{1FA00}-\\u{1FA6F}\\u{1FA70}-\\u{1FAFF}]/u;\n\n const match = text.match(emojiRegex);\n return match ? match[0] : null;\n}\n\n/**\n * Check if text contains at least one emoji\n *\n * @param text - Text to check\n * @returns True if emoji found, false otherwise\n */\nexport function hasEmoji(text: string): boolean {\n return extractFirstEmoji(text) !== null;\n}\n",[],[267,445,447],"1582a054-b459-11f0-a09c-0224a6c84d84","blobUtils.ts","1582a0ea-b459-11f0-a09c-0224a6c84d84",["D",1761695515418],"/**\n * Blob storage utility functions\n */\n\n/**\n * Extract block ID from blob key\n * Key format: projectName--category--blockId\n *\n * @param key - Blob key string (e.g., \"demo--todo--abc-123-def-456\")\n * @returns Block ID (e.g., \"abc-123-def-456\")\n *\n * @example\n * extractBlockIdFromKey(\"demo--todo--abc-123\") // Returns \"abc-123\"\n */\nexport function extractBlockIdFromKey(key: string): string {\n const parts = key.split('--');\n return parts[parts.length - 1]; // Last part is the block ID\n}\n",[],[267,445,455],"1582acde-b459-11f0-a09c-0224a6c84d84",["D",1761695515418],[319,320,321],[267,445],"fa4ed9f6-b363-11f0-87a0-0224a6c84d84","faviconizerService.ts","b7748178-b361-11f0-b7fc-0224a6c84d84","019a26dc-99bf-7269-a8f6-2bcf04eec442",10,["D",1761590243094],"import type { FaviconizerResponse } from \"../../shared/types.ts\";\n\n/**\n * Get favicon URL for a domain using Faviconizer API\n */\nexport async function getFaviconForDomain(domain: string) {\n try {\n const response = await fetch(\"https://faviconizer.val.run/api/domain\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ domain }),\n });\n\n if (!response.ok) {\n return {\n success: false,\n data: null,\n error: `Faviconizer API returned status ${response.status}`,\n };\n }\n\n const data: FaviconizerResponse = await response.json();\n\n // Check if the API's success field is true\n if (!data.success) {\n return {\n success: false,\n data: null,\n error: \"Faviconizer API returned success: false\",\n };\n }\n\n return {\n success: true,\n data: data,\n error: null,\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || \"Failed to fetch favicon\",\n };\n }\n}\n",[],[267,474,466],"services","359afed4-b50f-11f0-9598-0224a6c84d84",["D",1761773737671],[],[267,474,72],"fd178ad2-b4f0-11f0-8e48-0224a6c84d84","search.ts","fd178b4a-b4f0-11f0-8e48-0224a6c84d84","019a26dc-99bf-7269-a8f6-24515668c88f",["D",1761760757953],"/**\n * Notion search operations\n */\n\nimport { notion } from \"./index.ts\";\n\n/**\n * Normalize Notion ID by removing hyphens for comparison\n */\nfunction normalizeNotionId(id: string): string {\n return id.replace(/-/g, '');\n}\n\n/**\n * Search for pages edited within the last X hours\n * Filters out:\n * - Archived items\n * - Database objects\n * - Pages inside TODOS_DB_ID database\n *\n * @param hoursAgo - Number of hours to look back (default: 24)\n * @returns {success, data, error} with array of simplified page objects\n */\nexport async function searchRecentPages(hoursAgo: number = 24) {\n try {\n // Get TODOS_DB_ID to filter out those pages\n const todosDbId = Deno.env.get('TODOS_DB_ID');\n\n // Calculate cutoff timestamp\n const cutoffTime = new Date();\n cutoffTime.setHours(cutoffTime.getHours() - hoursAgo);\n\n const results: any[] = [];\n let hasMore = true;\n let startCursor: string | undefined = undefined;\n\n // Paginate through all results\n while (hasMore) {\n const response = await notion.search({\n sort: {\n direction: 'descending',\n timestamp: 'last_edited_time'\n },\n page_size: 100,\n start_cursor: startCursor\n });\n\n // Add results to array\n results.push(...response.results);\n\n // Check if we've reached the cutoff time\n // Since results are sorted by last_edited_time descending,\n // once we hit a page older than cutoff, we can stop\n const lastResult = response.results[response.results.length - 1];\n if (lastResult) {\n const lastEditedTime = new Date(lastResult.last_edited_time);\n if (lastEditedTime < cutoffTime) {\n // We've gone past the cutoff, stop paginating\n hasMore = false;\n break;\n }\n }\n\n hasMore = response.has_more;\n startCursor = response.next_cursor ?? undefined;\n }\n\n // Filter results:\n // 1. Within time range\n // 2. Not archived\n // 3. Only pages (not databases)\n // 4. Not in TODOS_DB_ID database\n const filteredResults = results.filter((item: any) => {\n const lastEditedTime = new Date(item.last_edited_time);\n const isWithinTimeRange = lastEditedTime >= cutoffTime;\n const isNotArchived = !item.archived;\n const isPage = item.object === 'page';\n\n // Filter out pages in the todos database (normalize IDs for comparison)\n const isInTodosDb = todosDbId\n && item.parent?.type === 'database_id'\n && normalizeNotionId(item.parent?.database_id || '') === normalizeNotionId(todosDbId);\n const isNotInTodosDb = !isInTodosDb;\n\n return isWithinTimeRange && isNotArchived && isPage && isNotInTodosDb;\n });\n\n // Simplify the results - extract only needed fields\n const simplifiedResults = filteredResults.map((item: any) => {\n const simplified: any = {\n id: item.id,\n object: item.object, // 'page' or 'database'\n last_edited_time: item.last_edited_time,\n url: item.url\n };\n\n // Extract title from page properties\n const titleProp = Object.values(item.properties || {}).find(\n (prop: any) => prop.type === 'title'\n ) as any;\n\n if (titleProp?.title?.[0]?.plain_text) {\n simplified.title = titleProp.title[0].plain_text;\n } else {\n simplified.title = 'Untitled';\n }\n\n // Extract parent information\n if (item.parent) {\n simplified.parent = {\n type: item.parent.type\n };\n\n // Add the appropriate ID based on parent type\n if (item.parent.type === 'page_id' && item.parent.page_id) {\n simplified.parent.id = item.parent.page_id;\n } else if (item.parent.type === 'database_id' && item.parent.database_id) {\n simplified.parent.id = item.parent.database_id;\n } else if (item.parent.type === 'workspace' && item.parent.workspace) {\n // Workspace parent doesn't have an ID, it's a boolean\n simplified.parent.id = null;\n }\n }\n\n return simplified;\n });\n\n return {\n success: true,\n data: simplifiedResults,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message\n };\n }\n}\n",[],[267,474,487,480],"notion","1582b166-b459-11f0-a09c-0224a6c84d84","pages.ts","019a26dc-99bf-7269-a8f6-23db6afe7f06",["D",1761695515418],"import { notion } from \"./index.ts\";\n\n/**\n * Get a Notion page by ID\n */\nexport async function getNotionPage(pageId: string) {\n try {\n const page = await notion.pages.retrieve({ page_id: pageId });\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to fetch Notion page'\n };\n }\n}\n\n/**\n * Update a Notion page's properties\n */\nexport async function updateNotionPage(\n pageId: string,\n properties: any,\n icon?: { type: string; emoji?: string; external?: { url: string } }\n) {\n try {\n const updateData: any = {\n page_id: pageId,\n properties: properties\n };\n\n // Add icon if provided\n if (icon) {\n updateData.icon = icon;\n }\n\n const page = await notion.pages.update(updateData);\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to update Notion page'\n };\n }\n}\n\n/**\n * Create a new page in a database\n */\nexport async function createNotionPage(\n databaseId: string,\n properties: any,\n icon?: { type: string; emoji?: string; external?: { url: string } }\n) {\n try {\n const pageData: any = {\n parent: { database_id: databaseId },\n properties: properties\n };\n\n // Add icon if provided\n if (icon) {\n pageData.icon = icon;\n }\n\n const page = await notion.pages.create(pageData);\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to create Notion page'\n };\n }\n}\n\n/**\n * Get page blocks (content)\n */\nexport async function getPageBlocks(pageId: string) {\n try {\n const response = await notion.blocks.children.list({ block_id: pageId });\n\n return {\n success: true,\n data: response.results,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to fetch page blocks'\n };\n }\n}\n\n/**\n * Update a Notion page's icon with an external URL\n */\nexport async function updatePageIcon(pageId: string, iconUrl: string) {\n try {\n const page = await notion.pages.update({\n page_id: pageId,\n icon: {\n type: \"external\",\n external: {\n url: iconUrl\n }\n }\n });\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to update page icon'\n };\n }\n}\n\n/**\n * Append a paragraph block to a page (for error notes)\n */\nexport async function appendBlockToPage(pageId: string, message: string) {\n try {\n const response = await notion.blocks.children.append({\n block_id: pageId,\n children: [\n {\n object: \"block\",\n type: \"paragraph\",\n paragraph: {\n rich_text: [\n {\n type: \"text\",\n text: {\n content: message\n }\n }\n ]\n }\n }\n ]\n });\n\n return {\n success: true,\n data: response,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to append block to page'\n };\n }\n}\n\n/**\n * Recursively get all blocks from a page, including nested children\n */\nexport async function getPageBlocksRecursive(blockId: string): Promise<any[]> {\n const allBlocks: any[] = [];\n\n try {\n const response = await notion.blocks.children.list({ block_id: blockId });\n\n for (const block of response.results) {\n // Add the current block\n allBlocks.push(block);\n\n // If block has children, recursively fetch them\n if ((block as any).has_children) {\n const children = await getPageBlocksRecursive(block.id);\n allBlocks.push(...children);\n }\n }\n\n return allBlocks;\n } catch (err: any) {\n console.error(`Error fetching blocks for ${blockId}:`, err.message);\n return allBlocks; // Return what we have so far\n }\n}\n",[],[267,474,487,489],"fd17bb9c-b4f0-11f0-8e48-0224a6c84d84","index.ts","019a26dc-99bf-7269-a8f6-1efef3029063",["D",1761760757953],"import { Client } from \"npm:@notionhq/client@2\";\n\n// Initialize Notion client - shared across all Notion service modules\nexport const notion = new Client({ auth: Deno.env.get(\"NOTION_API_KEY\") });\n\n// Export all page operations\nexport * from \"./pages.ts\";\n\n// Export all database operations\nexport * from \"./databases.ts\";\n\n// Export all search operations\nexport * from \"./search.ts\";\n",[],[267,474,487,496],"1582af68-b459-11f0-a09c-0224a6c84d84","databases.ts","019a26dc-99bf-7269-a8f6-1887e096fe60",["D",1761695515418],"import { notion } from \"./index.ts\";\n\n/**\n * Query a Notion database\n */\nexport async function queryNotionDatabase(databaseId: string, filter?: any, sorts?: any) {\n try {\n const response = await notion.databases.query({\n database_id: databaseId,\n filter: filter,\n sorts: sorts\n });\n\n return {\n success: true,\n data: response.results,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to query Notion database'\n };\n }\n}\n\n/**\n * Get a database by ID\n */\nexport async function getNotionDatabase(databaseId: string) {\n try {\n const database = await notion.databases.retrieve({ database_id: databaseId });\n\n return {\n success: true,\n data: database,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to fetch Notion database'\n };\n }\n}\n\n/**\n * Query database for a page with specific Block ID\n */\nexport async function queryDatabaseByBlockId(databaseId: string, blockId: string) {\n try {\n const filter = {\n property: \"Block ID\",\n rich_text: {\n equals: blockId\n }\n };\n\n const response = await notion.databases.query({\n database_id: databaseId,\n filter: filter\n });\n\n // Return first matching page or null\n const page = response.results.length > 0 ? response.results[0] : null;\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to query database by Block ID'\n };\n }\n}\n",[],[267,474,487,503],"1cb962ee-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[312,313,314,315],[267,474,487],"1cb96406-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[311,316,317],[267,474],"1cb957c2-b360-11f0-bc6f-0224a6c84d84","authCheck.ts","019a26dc-99bf-7269-a8f6-1140d0020917","019a26dc-99bf-7269-a8f6-14fb6878e1e4",["D",1761588582800],"import { Context, Next } from \"npm:hono@4\";\n\n/**\n * Authentication middleware for Hono routes\n *\n * This middleware checks for authentication credentials in requests.\n * Customize this based on your authentication strategy:\n * - API key in header\n * - Bearer token\n * - Notion webhook signature verification\n * - etc.\n */\nexport async function authCheck(c: Context, next: Next) {\n // Example: Check for API key in header\n const apiKey = c.req.header('x-api-key');\n const expectedKey = Deno.env.get('API_KEY');\n\n // If no API_KEY is configured, skip auth (development mode)\n if (!expectedKey) {\n console.warn('Warning: API_KEY not configured, skipping authentication');\n await next();\n return;\n }\n\n // Validate API key\n if (!apiKey || apiKey !== expectedKey) {\n return c.json({ error: 'Unauthorized', details: 'Invalid or missing API key' }, 401);\n }\n\n // Authentication successful, proceed\n await next();\n}\n\n/**\n * Notion webhook signature verification\n * Use this for routes that receive Notion webhooks\n *\n * Notion signs webhooks with a secret - verify the signature to ensure\n * the request actually came from Notion.\n */\nexport async function verifyNotionWebhook(c: Context, next: Next) {\n const signature = c.req.header('notion-signature');\n const webhookSecret = Deno.env.get('NOTION_WEBHOOK_SECRET');\n\n // If no webhook secret is configured, skip verification (development mode)\n if (!webhookSecret) {\n console.warn('Warning: NOTION_WEBHOOK_SECRET not configured, skipping webhook verification');\n await next();\n return;\n }\n\n if (!signature) {\n return c.json({ error: 'Unauthorized', details: 'Missing webhook signature' }, 401);\n }\n\n // TODO: Implement actual signature verification\n // This is a placeholder - implement according to Notion's webhook signature verification spec\n // Reference: https://developers.notion.com/reference/webhooks\n\n await next();\n}\n",[],[267,525,518],"routes","1cb956be-b360-11f0-bc6f-0224a6c84d84","views","019a26dc-99bf-7269-a8f6-0e71a3295bf6",["D",1761588582800],[],[267,525,527],"359afaf6-b50f-11f0-9598-0224a6c84d84","019a26dc-99bf-7269-a8f6-0b691fa0aef1",["D",1761773737671],[],[267,525,537,56],"tasks","359af84e-b50f-11f0-9598-0224a6c84d84",["D",1761773737671],[],[267,525,537,41],"15829730-b459-11f0-a09c-0224a6c84d84","todoSave.ts","158297c6-b459-11f0-a09c-0224a6c84d84",["D",1761695515418],"import { Hono } from \"npm:hono@4\";\nimport * as todoSaveController from '../../controllers/todoSaveController.ts';\n\nconst todoSave = new Hono();\n\n// POST /tasks/todo-save - Save todos from blob storage to Notion database\ntodoSave.post('/', async (c) => {\n try {\n // Process all todo blobs and save to Notion\n // Note: This processes ALL blobs, not just one page\n const result = await todoSaveController.processTodoSave();\n\n // Always return 200 OK to webhook\n return c.json({\n success: result.success,\n totalBlobs: result.totalBlobs,\n pagesCreated: result.pagesCreated,\n pagesUpdated: result.pagesUpdated,\n pagesSkipped: result.pagesSkipped,\n pagesFailed: result.pagesFailed,\n failures: result.failures,\n message: result.success\n ? `Processed ${result.totalBlobs} blobs: ${result.pagesCreated} created, ${result.pagesUpdated} updated, ${result.pagesSkipped} skipped, ${result.pagesFailed} failed`\n : `Todo save failed: ${result.error}`\n }, 200);\n\n } catch (err: any) {\n // Even on unexpected errors, return 200 to prevent webhook retries\n console.error('Unexpected error in todo-save webhook:', err);\n return c.json({\n success: false,\n error: \"Internal server error\",\n details: err.message\n }, 200);\n }\n});\n\nexport default todoSave;\n",[],[267,525,537,543],"7a2cba30-b369-11f0-a1ff-0224a6c84d84","favicon.ts","b76fa216-b361-11f0-8f90-0224a6c84d84",["D",1761592605104],"import { Hono } from \"npm:hono@4\";\nimport * as faviconController from '../../controllers/faviconController.ts';\n\nconst favicon = new Hono();\n\n// POST /tasks/favicon - Handle Notion webhook for favicon updates\nfavicon.post('/', async (c) => {\n try {\n // Extract payload from request body\n const payload = await c.req.json();\n\n // Extract page_id from webhook payload - try multiple possible locations\n const pageId = payload?.page_id || // Direct property\n payload?.data?.id || // Notion webhook event format\n payload?.page?.id; // Alternative format\n\n if (!pageId) {\n console.error('Failed to extract page_id from payload:', JSON.stringify(payload));\n return c.json({\n error: \"Missing page_id in webhook payload\",\n receivedPayload: payload\n }, 400);\n }\n\n // Process favicon update (always return 200 to webhook)\n const result = await faviconController.processFaviconUpdate(pageId);\n\n // Always return 200 OK to Notion webhook (even on errors)\n // Errors are logged as notes in the page itself\n return c.json({\n success: result.success,\n iconUpdated: result.iconUpdated,\n errorNoteAdded: result.errorNoteAdded,\n successNoteAdded: result.successNoteAdded,\n message: result.success\n ? \"Favicon updated successfully\"\n : `Favicon update failed: ${result.error}`\n }, 200);\n\n } catch (err: any) {\n // Even on unexpected errors, return 200 to prevent webhook retries\n console.error('Unexpected error in favicon webhook:', err);\n return c.json({\n success: false,\n error: \"Internal server error\",\n details: err.message\n }, 200);\n }\n});\n\nexport default favicon;\n",[],[267,525,537,550],"1cb955b0-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[304,305,306,307],[267,525,537],"fd17b930-b4f0-11f0-8e48-0224a6c84d84","019a26dc-99bf-7269-a8f6-01b5d543f467","019a26dc-99bf-7269-a8f6-0782b134ef20",["D",1761760757953],"import { Hono } from \"npm:hono@4\";\nimport * as pageController from '../../controllers/pageController.ts';\n\nconst pages = new Hono();\n\n/**\n * GET /api/pages/recent\n * Get pages edited within the last X hours\n * Filters out:\n * - Database objects\n * - Archived pages\n * - Pages inside TODOS_DB_ID database\n *\n * Query parameters:\n * - hours (optional): Number of hours to look back (default: 24)\n *\n * Response:\n * {\n * pages: [{ id, object, title, url, last_edited_time, parent }],\n * count: number,\n * timeRange: string\n * }\n */\npages.get('/recent', async (c) => {\n // Extract hours parameter from query string\n const hoursParam = c.req.query('hours');\n let hours: number | undefined = undefined;\n\n if (hoursParam) {\n hours = parseInt(hoursParam, 10);\n\n // Validate that it's a valid number\n if (isNaN(hours)) {\n return c.json({\n error: \"Invalid hours parameter\",\n details: \"hours must be a valid number\"\n }, 400);\n }\n }\n\n // Call controller\n const result = await pageController.getRecentPages(hours);\n\n if (!result.success) {\n return c.json({\n error: result.error,\n details: result.details\n }, 500);\n }\n\n return c.json(result.data);\n});\n\n// GET /api/pages/:id - Get a Notion page\npages.get('/:id', async (c) => {\n const pageId = c.req.param('id');\n const result = await pageController.getPage(pageId);\n\n if (!result.success) {\n return c.json({ error: result.error, details: result.details }, 400);\n }\n\n return c.json(result.data);\n});\n\n// POST /api/pages/:id - Update a Notion page\npages.post('/:id', async (c) => {\n const pageId = c.req.param('id');\n const body = await c.req.json();\n\n const result = await pageController.updatePage(pageId, body.properties);\n\n if (!result.success) {\n return c.json({ error: result.error, details: result.details }, 400);\n }\n\n return c.json(result.data);\n});\n\n// GET /api/pages/:id/content - Get page blocks\npages.get('/:id/content', async (c) => {\n const pageId = c.req.param('id');\n const result = await pageController.getPageContent(pageId);\n\n if (!result.success) {\n return c.json({ error: result.error, details: result.details }, 400);\n }\n\n return c.json(result.data);\n});\n\nexport default pages;\n",[],[267,525,567,489],"api","1cb950f6-b360-11f0-bc6f-0224a6c84d84","019a26dc-99bf-7269-a8f5-fdd1422bebc3",["D",1761588582800],"import { Hono } from \"npm:hono@4\";\nimport pages from './pages.ts';\n\nconst api = new Hono();\n\n// Mount page routes at /api/pages\napi.route('/pages', pages);\n\n// Add more routes here as needed\n// Example:\n// import databases from './databases.ts';\n// api.route('/databases', databases);\n\nexport default api;\n",[],[267,525,567,496],"1cb95484-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[301,302],[267,525,567],"1cb95e2a-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[300,303,308,309],[267,525],"fd1780a0-b4f0-11f0-8e48-0224a6c84d84","todoSync.cron.ts","fd17812c-b4f0-11f0-8e48-0224a6c84d84","019a311f-c8bf-720b-97f6-3e820327a344",["D",1761760757953],"interval","import * as todoSaveController from '../controllers/todoSaveController.ts';\n\n/**\n * Cron: Sync todo blobs to Notion database\n *\n * This cron performs Step 3 of the workflow:\n * 3. Read all todo blobs and sync validated ones to Notion database\n *\n * Validation rules (only blobs meeting BOTH criteria are synced):\n * - At least one people_mention (assignee)\n * - At least one date_mention (due date)\n *\n * Blobs that don't meet validation are skipped (not deleted)\n *\n * Recommended schedule: Less frequent than search cron (e.g., every 8-12 hours)\n */\nexport default async function() {\n console.log('\\n=== Cron: Todo Sync Started ===');\n console.log('Timestamp:', new Date().toISOString());\n\n try {\n const result = await todoSaveController.processTodoSave();\n\n if (result.success) {\n console.log('\\nCron: Sync complete');\n console.log('Summary:');\n console.log(` Total blobs processed: ${result.totalBlobs}`);\n console.log(` Pages created: ${result.pagesCreated}`);\n console.log(` Pages updated: ${result.pagesUpdated}`);\n console.log(` Pages skipped: ${result.pagesSkipped}`);\n console.log(` Pages failed: ${result.pagesFailed}`);\n\n // Log failures if any\n if (result.failures && result.failures.length > 0) {\n console.error('\\nCron: Failures encountered:');\n result.failures.forEach((failure: any) => {\n console.error(` - Block ${failure.blockId}: ${failure.error}`);\n });\n }\n } else {\n console.error('Cron: Sync failed:', result.error);\n if (result.details) {\n console.error('Details:', result.details);\n }\n }\n } catch (err: any) {\n console.error('Cron: Unexpected error:', err.message);\n console.error('Stack:', err.stack);\n }\n\n console.log('=== Cron: Todo Sync Complete ===\\n');\n}\n",[],[267,591,583],"crons","fd1778b2-b4f0-11f0-8e48-0224a6c84d84","todoSearch.cron.ts","fd177934-b4f0-11f0-8e48-0224a6c84d84",["D",1761760757953],"import * as todoOrchestrationController from '../controllers/todoOrchestrationController.ts';\n\n/**\n * Cron: Search for todos in recent pages and save to blob storage\n *\n * This cron performs Steps 1-2 of the workflow:\n * 1. Get recent pages from Notion (last 6 hours)\n * 2. Search each page for \"todo\" keyword and save matches to blobs\n *\n * Does NOT sync blobs to Notion database (that's handled by todoSync.cron.ts)\n *\n * Recommended schedule: Every 4 hours (6 hour lookback provides 2 hour buffer)\n */\nexport default async function() {\n console.log('\\n=== Cron: Todo Search Started ===');\n console.log('Timestamp:', new Date().toISOString());\n\n try {\n // Hardcoded 6 hours lookback (assumes ~4 hour cron interval + 2 hour buffer)\n // Uses default \"todo\" keyword\n const result = await todoOrchestrationController.processBatchSearch(6);\n\n if (result.success) {\n console.log(`\\nCron: Search complete - Found ${result.totalTodosFound} todos in ${result.pagesSearched} pages`);\n\n // Log pages with matches\n const pagesWithMatches = result.searchResults.filter(r => r.blocksFound > 0);\n if (pagesWithMatches.length > 0) {\n console.log('Pages with matches:');\n pagesWithMatches.forEach(page => {\n console.log(` - ${page.pageTitle}: ${page.blocksFound} match(es)`);\n });\n }\n } else {\n console.error('Cron: Search failed:', result.error);\n if (result.details) {\n console.error('Details:', result.details);\n }\n }\n } catch (err: any) {\n console.error('Cron: Unexpected error:', err.message);\n console.error('Stack:', err.stack);\n }\n\n console.log('=== Cron: Todo Search Complete ===\\n');\n}\n",[],[267,591,593],"fd1792f2-b4f0-11f0-8e48-0224a6c84d84",["D",1761760757953],[297,298],[267,591],"359af2ae-b50f-11f0-9598-0224a6c84d84","019a26dc-99bf-7269-a8f5-f9aacbe46421",["D",1761773737671],[],[267,608,80],"controllers","359aeb9c-b50f-11f0-9598-0224a6c84d84",["D",1761773737671],[],[267,608,64],"359ae4b2-b50f-11f0-9598-0224a6c84d84",["D",1761773737671],[],[267,608,88],"fd17af58-b4f0-11f0-8e48-0224a6c84d84","pageController.ts","019a26dc-99bf-7269-a8f5-f4ae4994f9d7",["D",1761760757953],"import * as notionService from '../services/notion/index.ts';\n\n/**\n * Get a Notion page by ID\n * Generic controller that works with any Notion page type\n */\nexport async function getPage(pageId: string) {\n // Validate input\n if (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n data: null,\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n }\n\n // Call service\n const result = await notionService.getNotionPage(pageId);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to fetch page\",\n details: result.error\n };\n }\n\n // Filter sensitive data if needed\n // Example: Remove button properties\n const filteredData = filterSensitiveProperties(result.data);\n\n return {\n success: true,\n data: filteredData,\n error: null\n };\n}\n\n/**\n * Update a Notion page's properties\n * Generic controller that works with any Notion page type\n */\nexport async function updatePage(pageId: string, properties: any) {\n // Validate input\n if (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n data: null,\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n }\n\n if (!properties || typeof properties !== 'object') {\n return {\n success: false,\n data: null,\n error: \"Invalid properties\",\n details: \"properties must be a non-empty object\"\n };\n }\n\n // Call service\n const result = await notionService.updateNotionPage(pageId, properties);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to update page\",\n details: result.error\n };\n }\n\n // Filter sensitive data if needed\n const filteredData = filterSensitiveProperties(result.data);\n\n return {\n success: true,\n data: filteredData,\n error: null\n };\n}\n\n/**\n * Create a new page in a database\n */\nexport async function createPage(databaseId: string, properties: any) {\n // Validate input\n if (!databaseId || typeof databaseId !== 'string') {\n return {\n success: false,\n data: null,\n error: \"Invalid databaseId\",\n details: \"databaseId must be a non-empty string\"\n };\n }\n\n if (!properties || typeof properties !== 'object') {\n return {\n success: false,\n data: null,\n error: \"Invalid properties\",\n details: \"properties must be a non-empty object\"\n };\n }\n\n // Call service\n const result = await notionService.createNotionPage(databaseId, properties);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to create page\",\n details: result.error\n };\n }\n\n // Filter sensitive data if needed\n const filteredData = filterSensitiveProperties(result.data);\n\n return {\n success: true,\n data: filteredData,\n error: null\n };\n}\n\n/**\n * Get page content (blocks)\n */\nexport async function getPageContent(pageId: string) {\n // Validate input\n if (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n data: null,\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n }\n\n // Call service\n const result = await notionService.getPageBlocks(pageId);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to fetch page content\",\n details: result.error\n };\n }\n\n return {\n success: true,\n data: result.data,\n error: null\n };\n}\n\n/**\n * Get recent pages edited within the last X hours\n * Returns simplified page objects with id, title, url, last_edited_time, parent\n * Filters out:\n * - Archived pages\n * - Database objects\n * - Pages inside TODOS_DB_ID database\n *\n * @param hoursAgo - Number of hours to look back (default: 24)\n */\nexport async function getRecentPages(hoursAgo?: number) {\n // Validate input\n const hours = hoursAgo ?? 24;\n\n if (typeof hours !== 'number' || hours <= 0) {\n return {\n success: false,\n data: null,\n error: \"Invalid hours parameter\",\n details: \"hours must be a positive number\"\n };\n }\n\n // Call service\n const result = await notionService.searchRecentPages(hours);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to fetch recent pages\",\n details: result.error\n };\n }\n\n return {\n success: true,\n data: {\n pages: result.data,\n count: result.data?.length || 0,\n timeRange: `${hours} hours`\n },\n error: null\n };\n}\n\n/**\n * Filter sensitive properties from Notion data\n * Example: Remove button properties\n */\nfunction filterSensitiveProperties(data: any) {\n if (!data || !data.properties) {\n return data;\n }\n\n const filtered = {\n ...data,\n properties: Object.entries(data.properties)\n .filter(([_key, value]: [string, any]) => value.type !== 'button')\n .reduce((acc, [key, value]) => ({ ...acc, [key]: value }), {})\n };\n\n return filtered;\n}\n",[],[267,608,618],"71e9f9e6-b369-11f0-bc36-0224a6c84d84","faviconController.ts","b7798a9c-b361-11f0-9afd-0224a6c84d84",14,["D",1761592591230],"import * as notionService from '../services/notion/index.ts';\nimport * as faviconizerService from '../services/faviconizerService.ts';\nimport type { FaviconUpdateResult } from '../../shared/types.ts';\n\n/**\n * Process favicon update for a Notion page\n * Orchestrates: Get page → Extract Domain → Fetch favicon → Update icon\n * On error: Append error note to page\n */\nexport async function processFaviconUpdate(pageId: string): Promise<FaviconUpdateResult> {\n // Validate input\n if (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n }\n\n // Step 1: Get the Notion page\n const pageResult = await notionService.getNotionPage(pageId);\n\n if (!pageResult.success) {\n return {\n success: false,\n error: \"Failed to fetch Notion page\",\n details: pageResult.error\n };\n }\n\n // Step 2: Extract domain from Name property (title type)\n const domain = pageResult.data?.properties?.Name?.title?.[0]?.plain_text;\n\n if (!domain || typeof domain !== 'string' || domain.trim() === '') {\n const errorMessage = \"⚠️ Favicon update failed: Name property not found or empty\";\n\n // Append error note to page\n await notionService.appendBlockToPage(pageId, errorMessage);\n\n return {\n success: false,\n iconUpdated: false,\n errorNoteAdded: true,\n error: \"Name property not found or empty\"\n };\n }\n\n // Step 3: Fetch favicon from Faviconizer\n const faviconResult = await faviconizerService.getFaviconForDomain(domain);\n\n if (!faviconResult.success || !faviconResult.data?.faviconUrl) {\n const errorMessage = `⚠️ Favicon update failed: Could not fetch favicon for domain '${domain}'. Error: ${faviconResult.error}`;\n\n // Append error note to page\n await notionService.appendBlockToPage(pageId, errorMessage);\n\n return {\n success: false,\n iconUpdated: false,\n errorNoteAdded: true,\n error: \"Failed to fetch favicon\",\n details: faviconResult.error\n };\n }\n\n // Step 4: Update page icon\n const iconUpdateResult = await notionService.updatePageIcon(pageId, faviconResult.data.faviconUrl);\n\n if (!iconUpdateResult.success) {\n const errorMessage = `⚠️ Favicon update failed for domain '${domain}': Could not update page icon. Error: ${iconUpdateResult.error}`;\n\n // Append error note to page\n await notionService.appendBlockToPage(pageId, errorMessage);\n\n return {\n success: false,\n iconUpdated: false,\n errorNoteAdded: true,\n error: \"Failed to update page icon\",\n details: iconUpdateResult.error\n };\n }\n\n // Success! Append success note to page\n const successMessage = `✅ Favicon successfully updated for domain: ${domain}`;\n const appendResult = await notionService.appendBlockToPage(pageId, successMessage);\n\n return {\n success: true,\n iconUpdated: true,\n errorNoteAdded: false,\n successNoteAdded: appendResult.success\n };\n}\n",[],[267,608,625],"1cb94fca-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[291,292,293,294,295],[267,608],["D",1761588582800],[290,296,299,310,318,322],[267],"1cb93d82-b360-11f0-bc6f-0224a6c84d84","settings.local.json","019a26dc-99bf-7269-a8f5-ec22817c2d0b",["D",1761588582800],"{\n \"permissions\": {\n \"allow\": [\n \"Bash(cat:*)\"\n ],\n \"deny\": [],\n \"ask\": []\n }\n}\n",[],[272,640],["D",1761588582800],[288],[272],["D",1761588582800],["D",1789527031073],{"_166":165,"_173":169},{"_166":165,"_167":-5,"_168":169,"_18":118,"_170":171,"_172":34},{"_13":151,"_40":152,"_107":51,"_153":108,"_154":155,"_156":157,"_158":159,"_160":161,"_162":127,"_163":109,"_164":165},"ctx",{"_144":-5,"_194":687,"_688":689,"_690":691,"_692":34,"_693":34,"_694":34,"_695":32,"_696":-5,"_697":-7,"_698":-7,"_699":125,"_700":34,"_701":34,"_702":-5,"_703":34,"_704":34,"_705":34,"_706":-5},"ENV",{"_658":659,"_660":661,"_662":152,"_663":664,"_665":666,"_667":668,"_669":670,"_671":672,"_673":674,"_675":676,"_677":678,"_679":680,"_681":682,"_683":684,"_685":686},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"] </article></body></html>

Diff · v18