Stay tuned...

`);\n});\n```\n\n---\n\nTownie, stop here! Ask for permission to proceed.\n\n---\n\n## Architecture Validation\n\nBefore proceeding, verify your implementation follows the architecture:\n\n- Services only make direct API calls (no environment variables, no orchestration)\n- Controllers handle business logic and coordinate services\n- Routes only handle HTTP concerns and call controllers\n- No service calls directly from routes\n- Environment variables handled in controllers, not services\n- Consistent response patterns across all layers\n\n### Expected Behavior\n\nThe health endpoint should return:\n\n```\n{\n \"status\": \"ok\",\n \"timestamp\": \"2025-07-14T18:26:28.270Z\",\n \"service\": \"glance-demos\",\n \"databases\": {\n \"configured\": true,\n \"demos\": \"connected\",\n \"content\": \"connected\",\n \"interactions\": \"connected\"\n }\n}\n```\n\nThis architecture is intended to create clear separation of concerns and should make the codebase maintainable and testable.\n\n---\n\n**Townie, stop here! Before proceeding to additional steps, confirm that this step is working correctly.**\n\n**If there was an error regarding environment variables**: remind the user to upload `vars.env` to the Environment Variables section of this Val, and to then let you know when that step is complete so you can retry.\n\n**If everything is working as intended**: conclude this step with these messages:\n\n1. Briefly summarize the scaffolding that was just completed and why it's important\n1. Provide the URL to the health endpoint so the user can see that the endpoint is live. (Tell the user that they can copy and paste that URL into a new tab to see it live.)\n\n---\n\n### Next step: web route authentication\n\nTell the user that the next step is to add authentication to the web routes of this Val, and that they should copy this line and paste it into Townie:\n\n> Add auth to this Val with what you see in `/_townie/02-auth.md`\n",[],[153,181],{"_102":188,"_95":189,"_154":190,"_156":155,"_157":136,"_158":159,"_160":161,"_104":191,"_99":32,"_163":175,"_165":192,"_166":22,"_167":-5,"_168":193,"_98":194},"92bdfc06-89bd-11f0-80ae-0224a6c84d84","02-auth.md","01991600-cca1-769d-8b8a-e4dacaa7a5fe",["D",1757010775113],"# Complete Authentication Implementation Instructions\n\n## Townie instructions (Townie should follow these)\n\nRead through all of these instructions in order to understand the architecture of this Val, and implementation details important to this Val, and then once you have it all in your memory you should get to work.\n\nIf anything is unclear, you should stop and ask me for clarification before proceeding. Do not write code if you are unsure of what is expected.\n\n**Important:** there are checkpoints in these instructions where you are directed to stop and ask permission before proceeding. Follow those instructions and do not proceed without permission.\n\n## LastLogin Built-in Features\n\n**Important:** LastLogin automatically handles certain routes and authentication flows:\n\n- **`/auth/logout`** - LastLogin intercepts this route and handles logout automatically\n- **No custom logout route needed** in your Hono app\n- **Simply link to `/auth/logout`** and LastLogin will clear the session and redirect\n- **Authentication headers** - LastLogin adds `X-LastLogin-Email` header for authenticated requests\n\n**Authentication Flow:**\n\n1. **Unauthenticated requests** → LastLogin checks for session\n2. **No session** → Returns 401 or redirects to login\n3. **Valid session** → Adds `X-LastLogin-Email` header and passes to your app\n4. **`/auth/logout` requests** → LastLogin clears session automatically (never reaches your app)\n\n## Step 1. Core Architecture Setup\n\n### Main Application (main.tsx)\n\n**Add global authentication middleware to `main.tsx`:**\n\n```typescript\nimport { lastlogin } from \"https://esm.town/v/stevekrouse/lastlogin_safe\";\n\n// Import route modules\nimport authCheck from \"./backend/routes/authCheck.ts\";\n// other route modules\n\nconst app = new Hono();\n\n// Apply global authentication middleware to ALL routes\napp.use(\"*\", authCheck);\n\n// other routes\n\n// Export with LastLogin wrapper\nasync function handler(request: Request): Promise {\n return app.fetch(request);\n}\n\n// Wrap and export the main HTTP handler with lastlogin\nexport default lastlogin(handler);\n```\n\n### Dashboard Route Organization\n\n**Best Practice: Separate the root dashboard route from main.tsx**\n\nInstead of defining the root route directly in `main.tsx`, create a dedicated dashboard route file:\n\n- **Create**: `/backend/routes/views/dashboard.tsx`\n- **Purpose**: Handle the authenticated user's main dashboard/landing page\n- `import dashboardRoute from \"./backend/routes/views/dashboard.tsx\";`\n- **Mount in main.tsx**: `app.get(\"/\", dashboardRoute)`\n- **Note**: Dashboard is placed in `/routes/views/` because it's a user-facing view, not an API endpoint\n\nThis approach:\n\n- Keeps `main.tsx` focused on app setup and middleware\n- Makes the dashboard logic easier to maintain and test\n- Follows the modular architecture pattern with views separated from API routes\n- Places user-facing interfaces in `/routes/views/` for better organization\n- Allows for easier dashboard enhancements without touching core routing\n\nThe dashboard route should:\n\n- Display user information (email from `c.get(\"userEmail\")`)\n- Display the `/api/health` endpoint results as raw JSON in a
 tag; e.g., JSON.stringify(data, null, 2)\n- Include logout functionality via `/auth/logout`\n- Show a simple and professional welcome interface with minimal styling\n\n### Create `/backend/routes/authCheck.ts`\n\n**Authentication Middleware:**\n\n- Retrieve the user's email: `const email = c.req.header(\"X-LastLogin-Email\")`\n- If email exists, the user is authenticated - store in context and continue to your app\n- If no email, show login page with LoginWithGoogleButton\n- **Note:** You don't need to handle `/auth/logout` - LastLogin does this automatically\n\n**Login Page Requirements:**\n\n- `import { LoginWithGoogleButton } from \"https://esm.town/v/stevekrouse/LoginWithGoogleButton\"`\n- Use the `` React Component, optionally supplying the `text` attribute\n- Add \"via LastLogin\" underneath LoginWithGoogleButton, centered, secondary text, linking to https://lastlogin.io/\n- Pass the email from the server to the client-side code if using React hydration or similar techniques\n\n**For authenticated users:**\n\n- Store email in context: `c.set('userEmail', email)`\n- In your authenticated views, add logout functionality: `Logout`\n\n**Public Routes Whitelist:**\n\n- Add a `PUBLIC_ROUTES` array at the top for routes that should be accessible without authentication\n- **Don't include `/auth/logout`** in the whitelist (LastLogin handles it before your middleware runs)\n- Use for truly public routes like: `/demo/:id`, `/api/health`, static assets, etc.\n\nIf you encounter problems loading the React button, try this simple approach for authCheck.ts:\n\n```typescript\n// Public routes that don't require authentication\nconst PUBLIC_ROUTES = [\n  // Add public routes here as needed\n  // '/demo/:id',  // Example: public demo viewing\n  // '/api/public', // Example: public API endpoints\n];\n\n// Helper function to check if a route is public\nfunction isPublicRoute(path: string): boolean {\n  return PUBLIC_ROUTES.some((route) => {\n    // Handle exact matches\n    if (route === path) return true;\n\n    // Handle wildcard patterns (basic implementation)\n    if (route.includes(\"*\")) {\n      const pattern = route.replace(\"*\", \".*\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    // Handle route parameters (basic implementation)\n    if (route.includes(\":\")) {\n      const pattern = route.replace(/:[^/]+/g, \"[^/]+\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    return false;\n  });\n}\n\nexport default async (c, next) => {\n  // Allow public routes to bypass authentication\n  if (isPublicRoute(c.req.path)) {\n    await next();\n    return;\n  }\n\n  const email = c.req.header(\"X-LastLogin-Email\");\n\n  if (!email) {\n    // Show login page if not authenticated\n    return c.html(`\n      \n      \n      \n        Your App - Login Required\n      \n      \n        \n          Sign in
\n          Sign in to access your app.
\n          \n            Loading login button...
\n          
\n          \n            via LastLogin\n          
\n        
\n\n        \n      \n      \n    `);\n  }\n\n  // If authenticated, store email in context for use by routes\n  c.set(\"userEmail\", email);\n\n  // Continue to the next middleware/route\n  await next();\n};\n```\n\n## Common Gotchas\n\n**Logout Route:**\n\n- ❌ Don't create a custom `/auth/logout` route in your Hono app\n- ✅ Just link to `/auth/logout` - LastLogin handles it automatically\n- The logout link will work for authenticated users without any custom code\n- LastLogin intercepts `/auth/logout` at the wrapper level before it reaches your middleware\n\n**Public Routes:**\n\n- Use the whitelist in authCheck.ts for routes that should be accessible without authentication\n- `/auth/logout` doesn't need to be whitelisted (LastLogin handles it before your middleware runs)\n- Examples of routes that should be whitelisted: public demos, health checks, static assets\n\n**Authentication Headers:**\n\n- Authenticated requests will have `X-LastLogin-Email` header\n- Unauthenticated requests will not have this header\n- LastLogin wrapper handles session validation before your code runs\n\n**Error Handling:**\n\n- If LastLogin can't validate a session, it returns 401 before reaching your app\n- Your authCheck middleware only runs for requests that pass LastLogin's validation\n- No need to handle session expiration - LastLogin manages this\n\n---\n\n**Townie, stop here! Before proceeding to additional steps, confirm that this step is working correctly.**\n\n**If everything is working as intended**: conclude this step with these messages:\n\n1. Briefly summarize the work that was just completed and why it's important\n1. Provide the URL to the dashboard endpoint so the user can see that the dashbaord is live. Tell the user that they can copy and paste that URL into a new tab to see it live.\n1. Tell the user that they can log into the dashboard using their Google email address.\n\n---\n\n### Next step: webhook authentication\n\nTell the user that the next step is to add webhook authentication to this Val. Explain what webhooks are why it's important to authenticate them.\n\nLastly, tell the user to copy this line and paste it into Townie:\n\n> Add webhook auth to this Val with what you see in `/_townie/03-webhooks.md`\n",[],[153,189],{"_102":196,"_95":197,"_154":198,"_156":155,"_157":136,"_158":159,"_160":161,"_104":199,"_99":32,"_163":175,"_165":200,"_166":22,"_167":-5,"_168":201,"_98":202},"92be08b8-89bd-11f0-80ae-0224a6c84d84","03-webhooks.md","01991600-cca1-769d-8b8a-e924104ffe01",["D",1757010775113],"# Webhook Authentication Architecture Instructions\n\n## Townie instructions (Townie should follow these)\n\n## Middleware Order\n\nPlace authentication middleware in the following order:\n\n1. **Notion webhook auth middleware** (X-API-KEY for `/tasks/*`)\n2. **Global user auth middleware** (for other protected routes)\n3. **Route handlers**\n\n## Webhook Authentication\n\n### Scope\n\n- Apply only to routes under /tasks/\\*\n- All /tasks endpoints expect POSTs from Notion webhooks\n\n### Implementation\n\n- Create `/backend/routes/webhookAuthCheck.ts`\n- Extract X-API-KEY header from incoming requests\n- Compare against NOTION_WEBHOOK_SECRET environment variable\n- Use constant-time comparison to prevent timing attacks\n- Return 401/403 for authentication failures with generic error messages\n- Log failed authentication attempts for monitoring\n\n### Route Implementation Requirements\n\n**CRITICAL:** All webhook routes MUST use POST method:\n\n```\n// ✅ CORRECT - Webhooks are POST requests\napp.post(\"/webhook-endpoint\", async (c) => {\n  // Handle webhook\n});\n\n// ❌ WRONG - This won't work with webhooks\napp.get(\"/webhook-endpoint\", async (c) => {\n  // Webhooks can't reach this\n});\n```\n\nWhy: Notion (and most webhook providers) send POST requests, never GET.\n\n### Middleware Application (EXACT CODE)\n\nApply middleware in this EXACT order in main.tsx:\n\n```\n// 1. Webhook auth - ONLY for /tasks/* routes\napp.use(\"/tasks/*\", webhookAuth);\n\n// 2. User auth - for ALL routes EXCEPT /tasks/*\napp.use(\"/api/*\", authCheck);\napp.use(\"/views/*\", authCheck);\napp.use(\"/\", authCheck);\n\n// Add root route - now serves the authenticated dashboard\napp.get(\"/\", dashboardRoute);\n\n// 3. Mount routes AFTER middleware\napp.route(\"/tasks\", taskRoutes);\n```\n\n**Important:** We've changed the global authentication from app.use(\"\\*\") to\nmore specific auth route handling.\n\n**Before:**\n\n```\napp.use(\"*\", authCheck);  // Applied to ALL routes including /tasks/*\n```\n\n**After:**\n\n```\napp.use(\"/api/*\", authCheck);   // Applied to API routes\napp.use(\"/views/*\", authCheck); // Applied to view routes\napp.use(\"/\", authCheck);        // Applied to root route\n```\n\n**This ensures:**\n\n✅ `/` (root) still requires user authentication ✅ `/api/*` routes still\nrequire user authentication ✅ `/views/*` routes still require user\nauthentication ✅ `/tasks/*` routes only use webhook authentication (no user\nauth)\n\n**Common mistake:** Using app.use(\"\\*\", webhookAuth) - this applies to all\nroutes incorrectly.\n\n### Flow Logic\n\n- Request to /tasks/\\* → Check X-API-KEY → If valid, proceed to route handler\n  (skip global auth)\n- Request to /tasks/\\* → Check X-API-KEY → If invalid, return 401 (never reaches\n  global auth)\n- Request to other routes → Skip webhook auth → Go to global auth → Then route\n  handler\n\n### Testing Webhook Authentication\n\nTest in this exact order:\n\n1. **Test without header** (should fail):\n\nPOST /tasks/test Expected: 401 \"Authentication required\"\n\n1. **Test with wrong key** (should fail):\n\nPOST /tasks/test Headers: {\"X-API-KEY\": \"wrong-key\"} Expected: 403\n\"Authentication failed\"\n\n1. Test with correct key (should succeed):\n\nPOST /tasks/test\\\nHeaders: {\"X-API-KEY\": \"your-configured-secret-value\"} Expected: 200 (reaches\nyour route handler)\n\n**If step 3 returns 404:** Your route is probably defined as GET instead of\nPOST.\n\n### Debugging Webhook Auth Issues\n\nAdd this temporary debug endpoint:\n\n```\napp.get(\"/debug-webhook\", (c) => {\n  const secret = Deno.env.get(\"NOTION_WEBHOOK_SECRET\");\n  return c.json({\n    hasSecret: !!secret,\n    secretLength: secret?.length || 0,\n  });\n});\n```\n\n**Expected response:** {\"hasSecret\":true,\"secretLength\":>0}\n\nAdd this catch all endpoint:\n\n```\n// Catch-all handler for undefined webhook endpoints\n// This must be the LAST route defined to catch unmatched paths\napp.post(\"*\", (c) => {\n  const path = c.req.path;\n  const method = c.req.method;\n  const returnObj = {\n    error: \"Endpoint not found\",\n    path: path,\n    method: method,\n    availableEndpoints: [\n      \"GET /tasks/debug-webhook\",\n      \"POST /tasks/test\",\n      \"POST /tasks/notion-webhook\",\n    ],\n  };\n  console.log(returnObj);\n\n  return c.json(returnObj, 404);\n});\n```\n\n### Complete Working Example\n\nHere's a complete working webhook endpoint:\n\n```\n// backend/routes/tasks/_tasks.routes.ts\nimport { Hono } from \"npm:hono@3.12.12\";\n\nconst app = new Hono();\n\napp.post(\"/notion-webhook\", async (c) => {\n  // At this point, webhook auth has already passed\n  const body = await c.req.json();\n  console.log(\"Notion webhook received:\", body);\n\n  // Process the webhook...\n\n  return c.json({ success: true });\n});\n\nexport default app;\n```\n\nTest with:\n\nPOST /tasks/notion-webhook Headers: {\"X-API-KEY\":\n\"your-configured-secret-value\"} Body: {\"test\": \"data\"} Expected: 200 {\"success\":\ntrue}\n\n### 4\\. Add Simplified Webhook Testing to Dashboard\n\nUpdate `/backend/routes/views/dashboard.tsx`:\n\n**Add webhook configuration variables after health data:**\n\n    // Check webhook configuration\n    const webhookSecret = Deno.env.get(\"NOTION_WEBHOOK_SECRET\");\n    const webhookConfigured = !!webhookSecret;\n    const webhookEndpoint = `${c.req.url.split('/')[0]}//${c.req.url.split('/')[2]}/tasks/notion-webhook`;\n\n**Add CSS styles for webhook section (after existing styles):**\n\n    .webhook-section {\n      background: #f8f9fa;\n      border: 1px solid #e9ecef;\n      border-radius: 6px;\n      padding: 20px;\n      margin-top: 20px;\n    }\n    .webhook-section h3 {\n      color: #333;\n      margin-top: 0;\n      margin-bottom: 15px;\n    }\n    .webhook-url {\n      margin-bottom: 20px;\n    }\n    .webhook-endpoint {\n      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;\n      font-size: 14px;\n      background: white;\n      padding: 12px;\n      border: 1px solid #dee2e6;\n      border-radius: 4px;\n      word-break: break-all;\n      user-select: all;\n    }\n    .test-section {\n      border-top: 1px solid #dee2e6;\n      padding-top: 20px;\n      margin-top: 20px;\n    }\n    .test-section p {\n      margin-bottom: 15px;\n      color: #495057;\n    }\n    .test-section code {\n      background: #f8f9fa;\n      padding: 2px 4px;\n      border-radius: 3px;\n      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;\n      font-size: 13px;\n    }\n    .test-controls {\n      display: flex;\n      gap: 10px;\n      align-items: center;\n      margin-bottom: 15px;\n    }\n    .test-btn {\n      background: #28a745;\n      color: white;\n      border: none;\n      padding: 8px 16px;\n      border-radius: 4px;\n      cursor: pointer;\n      font-size: 14px;\n      transition: background-color 0.2s;\n    }\n    .test-btn:hover {\n      background: #218838;\n    }\n    .test-btn:disabled {\n      background: #6c757d;\n      cursor: not-allowed;\n    }\n    .api-key-input {\n      padding: 6px 10px;\n      border: 1px solid #ced4da;\n      border-radius: 4px;\n      font-size: 14px;\n      width: 200px;\n    }\n    .test-result {\n      background: white;\n      border: 1px solid #dee2e6;\n      border-radius: 4px;\n      padding: 15px;\n      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;\n      font-size: 13px;\n      min-height: 60px;\n      white-space: pre-wrap;\n    }\n    .result-success {\n      border-color: #28a745;\n      background: #d4edda;\n    }\n    .result-error {\n      border-color: #dc3545;\n      background: #f8d7da;\n    }\n\n**Add simplified webhook section HTML (after health section):**\n\n    \n      Webhook Endpoint
\n\n      \n        ${webhookEndpoint}
\n      
\n\n      \n        To test: Get the NOTION_WEBHOOK_SECRET value from your vars.env file (provided by your administrator)
\n        \n          \n          \n        
\n        Ready to test webhook authentication...
\n      
\n    
\n\n**Add JavaScript for form submission (before closing body tag):**\n\n    \n\n## Testing Verification\n\n1. Test `/tasks/debug-webhook` (GET) - should show webhook configuration\n2. Test `/tasks/test` (POST) without header - should return 401\n3. Test `/tasks/test` (POST) with wrong key - should return 403\n4. Test `/tasks/test` (POST) with correct key - should return 200\n5. Verify user authentication still works for other routes\n6. Check dashboard shows simplified webhook testing interface\n7. Verify form submission works with both button click and Enter key\n\n## Expected Results\n\nMake sure these are true:\n\n- Webhook endpoints only accessible with correct X-API-KEY\n- User authentication preserved for non-webhook routes\n- Dashboard provides clean, simplified webhook testing interface\n- Form submission works via button click or Enter key\n- All authentication flows working independently\n- Webhook endpoint ready for Notion integration\n\n## Security Considerations\n\n- Webhook middleware should return early (success or failure) without calling\n  next()\n- Never pass webhook requests to the global auth middleware\n- Maintain complete separation between webhook auth and user auth mechanisms\n- Consider rate limiting on /tasks endpoints\n- Use generic error messages that don't reveal authentication mechanism details\n\n## Route Structure\n\n- /tasks/\\* → Webhook auth required (Notion POSTs)\n- /api/\\* → User auth required (if applicable)\n- /\\* → Public routes (static files, etc.)\n\n### 5\\. Update Documentation\n\nUpdate README.md to include webhook authentication section and environment\nvariables.\n\n## Final Deliverables\n\nMake sure these are true:\n\n- Webhook authentication middleware implemented\n- Middleware order correctly configured\n- Test endpoints available\n- Simplified dashboard with webhook testing form\n- Form supports both click and keyboard submission\n- Documentation updated\n- Ready for Notion webhook configuration\n\n---\n\n**Townie, stop here! Before proceeding to additional steps, confirm that this\nstep is working correctly.**\n\n**If everything is working as intended**: conclude this step with these\nmessages:\n\n1. Briefly summarize the work that was just completed and why it's important\n1. Provide the URL to the dashboard endpoint, from which the user can test the\n   new webhook endpoint with the webhook form\n1. Explain that the user will need the `NOTION_WEBHOOK_SECRET` from the\n   `vars.env` to test the webhook endpoint successfully\n1. Explain that we will implement webhooks from Notion in a step that comes\n   later\n\n---\n\n### Next step: create an endpoint to view Glimpse demo data\n\nTell the user that the next step is to add an endpoint to /routes that returns\nthe data from the Glimpse Demos database in Notion.\n\nLastly, tell the user to copy this line and paste it into Townie:\n\n> Add an endpoint at `/views/glimpse/:id` by following the instructions in\n> `/_townie/04-view.md`\n",[],[153,197],{"_102":204,"_95":205,"_154":206,"_156":155,"_157":136,"_158":159,"_160":161,"_104":207,"_99":32,"_163":175,"_165":208,"_166":22,"_167":-5,"_168":209,"_98":210},"92be19c0-89bd-11f0-80ae-0224a6c84d84","04-view.md","01991600-cca1-769d-8b8a-ec68aff1fdd4",["D",1757010775113],"# Instructions for Adding /views/glimpse/:id Endpoint\n\nHere are the step-by-step instructions that would lead directly to the correct,\nclean implementation:\n\n## 1\\. Analyze the Requirements\n\n- Endpoint: GET /views/glimpse/:id\n- Authentication: Required (existing Google OAuth)\n- Input: Notion page ID (not database ID)\n- Output: JSON response with full service response (minus UI elements)\n- Data source: Notion page properties\n\n## 2\\. Examine Current Architecture\n\n### Check existing services to understand data access patterns\n\n    cat /backend/services/notion.service.ts\n\n### Check existing routes structure\n\n    cat /backend/routes/views/\\_views.routes.ts\n\n### Understand authentication flow\n\n    cat /main.tsx # Look for auth middleware setup\n\n## 3\\. Identify Missing Service Method\n\n- Current service has getDatabaseById() for database metadata\n- Need getPageById() for individual page data\n- Service should return full Notion response for flexibility\n\n## 4\\. Add Service Method First\n\n    // Add to /backend/services/notion.service.ts\n    export async function getPageById(pageId: string) {\n      try {\n        const response = await notion.pages.retrieve({\n          page_id: pageId,\n        });\n        return {\n          success: true,\n          data: response,\n          timestamp: new Date().toISOString(),\n        };\n      } catch (error) {\n        return {\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        };\n      }\n    }\n\n## 5\\. Add Database Pages Service Method\n\n    // Add to /backend/services/notion.service.ts\n    export async function getDatabasePages(databaseId: string) {\n      try {\n        const response = await notion.databases.query({\n          database_id: databaseId,\n        });\n        return {\n          success: true,\n          data: response,\n          timestamp: new Date().toISOString(),\n        };\n      } catch (error) {\n        return {\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        };\n      }\n    }\n\n## 6\\. Create Controller with Minimal Processing\n\n    // Create /backend/controllers/glimpse.controller.ts\n    import { Context } from \"npm:hono@3.12.12\";\n    import { getPageById } from \"../services/notion.service.ts\";\n\n    export async function glimpseHandler(c: Context) {\n    const id = c.req.param(\"id\");\n\n    if (!id) {\n      return c.json({ error: \"Page ID is required\" }, 400);\n    }\n\n    const result = await getPageById(id);\n\n    if (!result.success) {\n      return c.json({ error: \"Failed to fetch page data\", details: result.error }, 500);\n    }\n\n    // Filter out button properties from the response\n    if (result.data?.properties) {\n      const filteredProperties = Object.fromEntries(\n      Object.entries(result.data.properties).filter(([key, value]) => value?.type !== \"button\")\n    );\n\n        result.data.properties = filteredProperties;\n\n      }\n\n      return c.json(result);\n    }\n\n## 7\\. Add Route\n\n    // Update /backend/routes/views/\\_views.routes.ts\n    import { Hono } from \"npm:hono@3.12.12\";\n    import { glimpseHandler } from \"../../controllers/glimpse.controller.ts\";\n\n    const app = new Hono();\n\n    app.get(\"/glimpse/:id\", glimpseHandler);\n\n    export default app;\n\n## 8\\. Update Documentation\n\n**Add to /backend/routes/views/README.md**\n\n### GET /views/glimpse/:id\n\n- **Purpose**: Returns Notion page data as JSON (filtered for data consumption)\n- **Authentication**: Required (Google OAuth)\n- **Parameters**: `id` \\- Notion page ID\n- **Response**: Service response object with Notion page data (button properties\n  removed)\n- **Filtering**: Removes UI-specific properties (type: \"button\") for cleaner\n  data consumption\n\n## 9\\. Key Design Principles\n\n✅ Controller Best Practices:\n\n- Single Responsibility: Controller handles HTTP concerns + minimal data cleanup\n- Thin Layer: Minimal processing, focused on improving data consumption\n- Useful Filtering: Remove UI elements that don't belong in data APIs\n- Consistent Error Handling: Standard error response format\n\n✅ Service Layer:\n\n- Data Access: Handle all Notion API interactions\n- Consistent Response Format: Always return {success, data/error, timestamp}\n- Raw Data: Return unfiltered data from external APIs\n\n✅ Separation of Concerns:\n\n- Controller: HTTP validation, routing, error responses, basic data cleanup\n- Service: External API calls, data retrieval\n- Client: Complex data processing, extraction, formatting\n\n## 10\\. Response Structure\n\n{ \"success\": true, \"data\": { \"object\": \"page\", \"id\": \"notion-page-id\",\n\"properties\": { \"Name\": { \"type\": \"title\", \"title\": \\[{\"plain\\_text\": \"Demo\nName\"}\\] }, \"Status\": { \"type\": \"select\", \"select\": {\"name\": \"Active\"} } //\nButton properties filtered out } }, \"timestamp\": \"2025-07-15T17:25:00.000Z\" }\n\n## 11\\. Dashboard Integration for Real Page ID Testing\n\n**Add demo page links to dashboard for user-friendly testing with real Notion\npage IDs**\n\n### 11a. Update Dashboard Route Data Fetching\n\n    // Update /backend/routes/views/dashboard.tsx imports and data fetching\n    import { getHealthStatus } from \"../../controllers/health.controller.ts\";\n    import { getDatabasePages } from \"../../services/notion.service.ts\";\n\n    export default async (c) => {\n      const userEmail = c.get(\"userEmail\");\n      \n      // Fetch health status for display\n      const healthData = await getHealthStatus();\n\n      // Fetch demo database pages for glimpse endpoints\n      const demoDatabaseId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n      let demoPages = [];\n      let demoPagesError = null;\n      \n      if (demoDatabaseId) {\n        const demoPagesResult = await getDatabasePages(demoDatabaseId);\n        if (demoPagesResult.success) {\n          demoPages = demoPagesResult.data.results || [];\n        } else {\n          demoPagesError = demoPagesResult.error;\n        }\n      }\n\n### 11b. Add Demo API Endpoints Section to Dashboard HTML\n\nAdd this section after the webhook section closes, before the main content div\ncloses:\n\n    \n      🔍 Demo API Endpoints
\n      \n      ${demoDatabaseId ? `\n        ${demoPages.length > 0 ? `\n          Test the /views/glimpse/:id endpoint with these demo pages:
\n          \n            ${demoPages.map(page => {\n              const pageTitle = page.properties?.Name?.title?.[0]?.plain_text || \n                               page.properties?.Title?.title?.[0]?.plain_text || \n                               'Untitled Page';\n              const glimpseUrl = `${c.req.url.split('/')[0]}//${c.req.url.split('/')[2]}/views/glimpse/${page.id}`;\n              return `\n                \n                  📄 ${pageTitle}\n                  ${glimpseUrl}\n                
\n              `;\n            }).join('')}\n          
\n        ` : `\n          ${demoPagesError ? `\n            ❌ Error loading demo pages: ${demoPagesError}
\n          ` : `\n            No demo pages found in the configured database.
\n          `}\n        `}\n      ` : `\n        Demo database not configured. Set GLANCE_DEMOS_DB_ID environment variable.
\n      `}\n    
\n\n## 12\\. Key Decision Points\n\n✅ Correct Approach:\n\n- Data Source: Use notion.pages.retrieve() for page data\n- Controller Logic: Keep minimal but include useful data cleanup\n- Property Filtering: Remove UI-specific elements (buttons) that don't belong in\n  data APIs\n- Error Handling: Consistent service response pattern\n\n✅ Appropriate Controller Processing:\n\n- UI Element Removal: Filter out button properties (not data)\n- Security Cleanup: Remove potentially sensitive UI configurations\n- Performance: Reduce payload size by removing unnecessary properties\n\n❌ Avoid These Mistakes:\n\n- Over-processing: Don't extract/transform business data in controller\n- Tight Coupling: Don't assume specific property names or structures\n- Inconsistent Responses: Don't create custom response formats\n- Mixed Responsibilities: Don't mix HTTP handling with complex business logic\n\n## 13\\. Benefits of This Approach\n\n- Clean Data: Removes UI clutter from data API responses\n- Maintainable: Clear separation between layers with focused responsibilities\n- Flexible: Client can still extract any business data from Notion response\n- Consistent: Follows existing service response patterns\n- Secure: Prevents exposure of UI configurations\n- Performance: Smaller payloads without unnecessary UI properties\n- Future-proof: Easy to extend filtering logic for other UI property types\n- User-Friendly Testing: Dashboard provides real page IDs for immediate testing\n\n## 14\\. When to Add Controller Processing\n\n✅ Good reasons to process in controller:\n\n- Remove UI-specific elements (buttons, formulas for display)\n- Filter sensitive configuration data\n- Remove properties that are never useful for data consumption\n- Basic security/privacy filtering\n\n❌ Avoid processing in controller:\n\n- Complex business logic transformations\n- Data extraction that depends on specific use cases\n- Heavy computational processing\n- Application-specific data formatting\n- This approach creates a clean, maintainable endpoint that provides useful data\n  filtering while maintaining architectural best practices and keeping the\n  controller focused on its core responsibilities.\n\n---\n\n**Townie, stop here! Before proceeding to additional steps, confirm that this\nstep is working correctly.**\n\n**If everything is working as intended**: conclude this step with these\nmessages:\n\n1. Briefly summarize the work that was just completed and why it's important\n2. Provide the URL to the dashboard where users can see the live demo API\n   endpoint links. Tell the user that they can copy and paste that URL into a\n   new tab to see it live.\n3. Explain that users can click on the demo page links in the dashboard to test\n   the `/views/glimpse/:id` endpoint with real Notion page data\n\n**Key Benefits Achieved:**\n\n- Users get real Notion page IDs for testing (not fake `/test-id`)\n- One-click access to live API responses from the dashboard\n- Self-documenting API with automatically updated demo links\n- Proper architectural separation maintained\n\n---\n\n### Next step: create an endpoint at /glimpse\n\nTell the user that the next step is to add the `/glimpse` endpoint, which will\ncall the same controller as the endpoint they just created at `/views/glimpse`.\n\nLastly, tell the user to copy this line and paste it into Townie:\n\n> Add a route for `/glimpse/:id` by following the instructions in\n> `/_townie/05-glimpse.md`",[],[153,205],{"_102":212,"_95":213,"_154":214,"_156":155,"_157":136,"_158":159,"_160":161,"_104":215,"_99":32,"_163":175,"_165":216,"_166":22,"_167":-5,"_168":217,"_98":218},"92be28f2-89bd-11f0-80ae-0224a6c84d84","05-glimpse.md","01991600-cca1-769d-8b8a-f05b484356b2",["D",1757010775113],"# Instructions for Adding Duplicate Route with Dashboard Table Display\n\n## Overview\n\nCreate a duplicate route that serves the same functionality as an existing\nroute, then update the dashboard to display both routes in a clean comparison\ntable format.\n\n## Step 1: Analyze Existing Route Structure\n\n1. **Check main router** (`/main.tsx`) to understand current routing setup\n2. **Identify the existing route** in `/backend/routes/views/_views.routes.ts`\n3. **Locate the controller** that handles the route functionality\n4. **Note the authentication middleware** applied to the existing route\n\n## Step 2: Create Duplicate Route Module\n\n1. **Create directory structure**: `/backend/routes/glimpse/`\n2. **Create route file**: `/backend/routes/glimpse/_glimpse.routes.ts`\n   - Import Hono and the existing controller\n   - Define route as `/:id` (not `/glimpse/:id` since mounting handles prefix)\n   - Export the Hono app as default\n3. **Create documentation**: `/backend/routes/glimpse/README.md`\n   - Document the route purpose, authentication, parameters, and response\n   - Note that it's equivalent to the original route\n\n## Step 3: Update Main Router\n\n1. **Add import** for the new route module in `/main.tsx`\n2. **Add authentication middleware** for the new route path (same as original)\n3. **Mount the route** after middleware setup\n4. **Maintain proper order**: imports → middleware → route mounting\n\n## Step 4: Update Dashboard Display\n\n1. **Locate the dashboard file** at `/backend/routes/views/dashboard.tsx`\n2. **Find the section** that displays glimpse links (look for demo pages\n   display)\n3. **Replace the existing link display** with a three-column table:\n   - Column 1: \"Name\" (30% width) - shows page title with emoji\n   - Column 2: \"Original Route\" (35% width) - shows `/views/glimpse/{:id}` as\n     clickable link\n   - Column 3: \"New Shortcut Route\" (35% width) - shows `/glimpse/{:id}` as\n     clickable link\n4. **Style the table** with:\n   - Clean borders and spacing\n   - Header row with background color\n   - Different link colors (blue for original, green for new)\n   - Monospace font for route paths\n   - Proper vertical alignment\n\n## Step 5: Implementation Details\n\n### Route File Template (`_glimpse.routes.ts`):\n\n    import { Hono } from \"npm:hono@3.12.12\";\n    import { glimpseHandler } from \"../../controllers/glimpse.controller.ts\";\n\n    const app = new Hono();\n    app.get(\"/:id\", glimpseHandler);\n    export default app;\n\n### Main Router Updates:\n\n- Import:\n  `import glimpseRoutes from \"./backend/routes/glimpse/_glimpse.routes.ts\";`\n- Auth: `app.use(\"/glimpse/*\", authCheck);`\n- Mount: `app.route(\"/glimpse\", glimpseRoutes);`\n\n### Dashboard Table Structure:\n\n- Three columns with clear headers\n- Page name in first column (no repetition)\n- Both route formats as clickable links\n- Consistent styling and spacing\n- Color coding for route types\n\n## Step 6: Testing\n\n1. **Test both routes** return identical responses (login page if not\n   authenticated)\n2. **Verify table display** shows all demo pages with both route formats\n3. **Confirm links work** and open in new tabs\n4. **Check responsive layout** and readability\n\n## Key Principles\n\n- **No code duplication** \\- reuse existing controller\n- **Consistent authentication** \\- same middleware for both routes\n- **Clean architecture** \\- maintain separation between router, routes, and\n  controllers\n- **User-friendly display** \\- clear comparison table without repetition\n- **Functional testing** \\- both routes must behave identically\n\nThis approach creates a clean duplicate route with an intuitive dashboard\ndisplay that demonstrates both URL formats side-by-side.\n\n---\n\n**Townie, stop here! Before proceeding to additional steps, confirm that this\nstep is working correctly.**\n\n**If everything is working as intended**: conclude this step with these\nmessages:\n\n1. Briefly summarize the work that was just completed and why it's important\n1. Provide the URL to the dashboard that you just updated so the user can see\n   that the new routes are live. Tell the user that they can copy and paste that\n   URL into a new tab to see the links.\n\n---\n\n### Next step: build a task endpoint that saves /glimpse/:id routes to Notion database pages\n\n> Follow the instructions in `/_townie/07-save.md` to add the `/tasks/url`\n> endpoint",[],[153,213],{"_102":220,"_95":221,"_154":222,"_156":155,"_157":136,"_158":159,"_160":161,"_104":223,"_99":32,"_163":175,"_165":224,"_166":22,"_167":-5,"_168":225,"_98":226},"92be30d6-89bd-11f0-80ae-0224a6c84d84","06-link.md","01991600-cca1-769d-8b8a-f5e9d4d02581",["D",1757010775113],"# Instructions for Getting Sample URLs with Real Notion Page IDs\n\n## Goal\n\nProvide working sample URLs for glimpse routes using actual page IDs from the GLANCE_DEMOS_DB_ID database without trial and error.\n\n## Step-by-Step Process\n\n### 1\\. Create Temporary Unauthenticated Endpoint\n\n    // In /backend/routes/api/_api.routes.ts, add:\n    app.get(\"/demo-pages\", async (c) => {\n      const databaseId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n      if (!databaseId) {\n        return c.json({ error: \"GLANCE_DEMOS_DB_ID not configured\" }, 500);\n      }\n\n      const result = await getDatabasePages(databaseId);\n      return c.json(result);\n    });\n\n### 2\\. Add Database Query Function\n\n    // In /backend/services/notion.service.ts, add:\n    export async function getDatabasePages(databaseId: string) {\n      try {\n        const response = await notion.databases.query({\n          database_id: databaseId,\n          page_size: 10, // Limit to first 10 pages\n        });\n        return {\n          success: true,\n          data: response,\n          timestamp: new Date().toISOString(),\n        };\n      } catch (error) {\n        return {\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        };\n      }\n    }\n\n### 3\\. Temporarily Bypass Authentication for Demo Endpoint\n\n    // In main.tsx, change:\n    // FROM: app.use(\"/api/*\", authCheck);\n    // TO:\n    app.use(\"/api/health\", authCheck);\n    // This allows /api/demo-pages to be accessed without auth\n\n### 4\\. Fetch Real Page IDs\n\n    # Make request to get actual page IDs\n    fetch(\"/api/demo-pages\")\n\n### 5\\. Extract Page ID from Response\n\n    // From the JSON response, extract the first page ID:\n    const pageId = response.data.results[0].id;\n    // Example: \"20789f51-c349-81e0-8b17-d2d89039c636\"\n\n### 6\\. Restore Authentication\n\n    // In main.tsx, restore:\n    app.use(\"/api/*\", authCheck);\n\n### 7\\. Provide Working URLs\n\n    Original route: /views/glimpse/{pageId}\n    New route: /glimpse/{pageId}\n\n## Complete Implementation Script\n\n    // 1. Add to notion.service.ts\n    export async function getDatabasePages(databaseId: string) {\n      try {\n        const response = await notion.databases.query({\n          database_id: databaseId,\n          page_size: 10,\n        });\n        return { success: true, data: response, timestamp: new Date().toISOString() };\n      } catch (error) {\n        return { success: false, error: error.message, timestamp: new Date().toISOString() };\n      }\n    }\n\n    // 2. Add to _api.routes.ts\n    app.get(\"/demo-pages\", async (c) => {\n      const databaseId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n      if (!databaseId) return c.json({ error: \"GLANCE_DEMOS_DB_ID not configured\" }, 500);\n      const result = await getDatabasePages(databaseId);\n      return c.json(result);\n    });\n\n    // 3. Temporarily modify main.tsx\n    app.use(\"/api/health\", authCheck); // Instead of \"/api/*\"\n\n    // 4. Fetch data\n    const response = await fetch(\"/api/demo-pages\");\n    const data = await response.json();\n    const pageId = data.data.results[0].id;\n\n    // 5. Restore main.tsx\n    app.use(\"/api/*\", authCheck);\n\n    // 6. Provide URLs\n    const originalUrl = `/views/glimpse/${pageId}`;\n    const newUrl = `/glimpse/${pageId}`;\n\n## Key Points\n\n- Always use GLANCE_DEMOS_DB_ID environment variable for database ID\n- Temporarily bypass auth only for the demo endpoint\n- Extract the first available page ID from results array\n- Restore full authentication after getting the ID\n- Both routes should work identically with the real page ID\n\nThis process eliminates guesswork and provides actual working URLs with real Notion page IDs from the configured database.\n",[],[153,221],{"_102":228,"_95":229,"_154":230,"_156":155,"_157":136,"_158":159,"_160":161,"_104":231,"_99":32,"_163":175,"_165":232,"_166":22,"_167":-5,"_168":233,"_98":234},"92be35ea-89bd-11f0-80ae-0224a6c84d84","07-save.md","01991600-cca1-769d-8b8a-f9811699d134",["D",1757010775113],"# Instructions for Implementing a New /tasks/url Webhook Endpoint\n\n## Context\n\nThis guide is for implementing webhook endpoints in the Glance Demo Platform Val\nthat follow the established architectural patterns.\n\n## Pre-Implementation Analysis\n\n1. ### Understand the Architecture Patterns\n   Before implementing, identify which pattern to use:\n\n- Data API Pattern (/api/_, /views/_): Controllers return data objects, routes\n  handle HTTP\n- Webhook Handler Pattern (/tasks/\\*): Controllers handle HTTP\n  requests/responses directly\n\nFor /tasks/\\* routes, use the Webhook Handler Pattern.\n\n2. ### Examine Existing Patterns\n   Study these files to understand the established patterns:\n\n- `/backend/controllers/glimpse.controller.ts` - Example of webhook handler\n  pattern\n- `/backend/routes/tasks/_tasks.routes.ts` - Existing webhook route structure\n- `/backend/services/notion.service.ts` - Service layer patterns\n- `/backend/routes/webhookAuthCheck.ts` - Authentication middleware\n\n3. ### Identify Required Components\n   For a new /tasks/url endpoint, you'll need:\n\n- Controller function (handles HTTP directly)\n- Service function (if new Notion API calls needed)\n- Route definition\n- Documentation updates\n\n## Implementation Steps\n\n### Step 1: Extend the Service Layer (if needed)\n\nIf new external API calls are required:\n\n1. **Location:** /backend/services/notion.service.ts\n1. **Pattern:** Add pure API functions that return {success, data/error,\n   timestamp} format\n1. **Example:** updatePageUrl(pageId, url) function\n1. **Responsibilities:** Only handle external API calls, no business logic\n\n### Step 2: Create the Controller\n\n1. **Location:** `/backend/controllers/tasks.controller.ts`\n1. **Pattern:** Webhook Handler Pattern - function takes Context, returns HTTP\n   responses\n1. **Function signature:** export async function handleNotionWebhook(c: Context)\n1. **Responsibilities:**\n\n- Parse HTTP request (c.req.json(), c.req.header())\n- Extract and validate data from webhook payload\n- Implement business logic\n- Call service functions\n- Log success/failure with detailed context\n- Return HTTP responses with appropriate status codes (c.json(data, statusCode))\n\n### Step 3: Add the Route\n\n- **Location:** `/backend/routes/tasks/_tasks.routes.ts`\n- **Pattern:** Direct controller call\n- **Implementation:** `app.post(\"/url\", handleNotionWebhook)`\n- **Update catch-all handler:** Add new endpoint to `availableEndpoints` array\n\n### Step 4: Update Documentation\n\n**Main README** `(/README.md)`:\n\n- Add endpoint to \"Webhooks (Notion Integration)\" section\n- Follow format: `POST /tasks/url` - Description (requires `X-API-KEY` header)\n\n**Route README** `(/backend/routes/tasks/README.md)`:\n\n- Add comprehensive endpoint documentation\n- Include request/response examples\n- Document error cases\n- Add testing instructions\n\n**Controller README** `(/backend/controllers/README.md)`:\n\n- Add controller function to examples\n- Note that it follows webhook handler pattern\n\n**Service README** `(/backend/services/README.md)`:\n\n- Add any new service functions to examples\n\n## Key Implementation Details\n\n### Authentication\n\n- All `/tasks/*` routes automatically use webhook authentication\n- Requires X-API-KEY header with NOTION_WEBHOOK_SECRET value\n- No additional auth setup needed in route\n\n### Webhook Payload Handling\n\nSupport multiple payload structures:\n\n```\n// Try multiple common webhook payload structures\nif (body.data?.id) {\n  pageId = body.data.id;\n} else if (body.id) {\n  pageId = body.id;\n} else if (body.page_id) {\n  pageId = body.page_id;\n}\n```\n\n### URL Construction Pattern\n\nUse this pattern for glimpse URLs:\n\n```\nconst host = c.req.header(\"host\");\nconst glimpseUrl = `https://${host}/glimpse/${pageId}`;\n```\n\n### Error Handling\n\nReturn structured errors with appropriate HTTP status codes:\n\n```\n// 400 for client errors\nreturn c.json({ success: false, error: \"Description\" }, 400);\n\n// 500 for server errors\nreturn c.json({ success: false, error: \"Description\", details: result.error }, 500);\n```\n\n### Logging Pattern\n\nInclude comprehensive logging:\n\n```\nconsole.log(\"Processing URL update webhook request\");\nconsole.log(\"Notion webhook received:\", body);\nconsole.log(`Constructed glimpse URL: ${glimpseUrl} for page ID: ${pageId}`);\nconsole.log(\"Successfully updated Notion page with glimpse URL:\", { pageId, url });\nconsole.error(\"Failed to update Notion page:\", result.error);\n```\n\n### Success Response Format\n\nReturn detailed success responses:\n\n```\nreturn c.json({\n  success: true,\n  message: \"Page URL updated successfully\",\n  pageId: pageId,\n  url: glimpseUrl,\n  timestamp: new Date().toISOString()\n});\n```\n\n## Testing Strategy\n\n### Authentication Testing\n\n1. Test without header (expect 401)\n1. Test with wrong key (expect 403)\n1. Test with correct key (expect 200 or business logic response)\n\n### Business Logic Testing\n\n1. Test with valid payload structure\n1. Test with missing page ID (expect 400)\n1. Test with missing host header (expect 400)\n1. Test with Notion API failures (expect 500)\n\n### Add Test Endpoint (optional)\n\nCreate a test endpoint that simulates the logic without calling external APIs:\n\n```\napp.post(\"/test-url\", async (c) => {\n  // Same logic but return test response instead of calling Notion API\n});\n```\n\n## Common Pitfalls to Avoid\n\n1. Don't mix patterns: /tasks/\\_ routes should use webhook handler pattern, not\n   data API pattern\n1. Don't forget authentication: All /tasks/\\_ routes are automatically protected\n1. Don't skip logging: Webhook endpoints need comprehensive logging for\n   debugging\n1. Don't forget documentation: Update all relevant README files\n1. Don't hardcode hosts: Always extract host from request headers\n1. Don't forget error cases: Handle missing data, API failures, etc.\n1. Don't skip the catch-all update: Add new endpoints to available endpoints\n   list\n\n## Validation Checklist\n\nBefore considering implementation complete:\n\n- Controller follows webhook handler pattern (takes Context, returns HTTP\n  responses)\n- Route uses direct controller call pattern\n- Service functions return consistent {success, data/error, timestamp} format\n- Comprehensive logging for success and failure cases\n- Proper HTTP status codes (400 for client errors, 500 for server errors)\n- Support for multiple webhook payload structures\n- Host extraction from request headers\n- Updated all relevant documentation\n- Added endpoint to catch-all handler's available endpoints list\n- Tested authentication (should fail with test keys)\n- Error handling for all edge cases\n\n## Final Notes\n\n- The webhook authentication middleware handles all security automatically\n- Focus on business logic and proper HTTP handling in the controller\n- Keep service functions pure (no business logic, just API calls)\n- Document the architectural decision when mixing patterns\n- Test thoroughly but remember authentication will block test requests without\n  proper keys\n\nThis pattern ensures consistency with the established architecture while\nproviding clear separation of concerns and comprehensive error handling.\n\n---\n\n**Townie, stop here! Before proceeding to additional steps, confirm that this\nstep is working correctly.**\n\n**If everything is working as intended**: conclude this step with these\nmessages:\n\n1. Briefly summarize the work that was just completed and why it's important\n1. Tell the user to go to the Glimpse Demos database in Notion.\n\n---\n\n### Next step: build a task endpoint that saves /glimpse/:id routes to Notion database pages\n\n> Add related pages to the /glimpse/:id endpoint by following the instructions\n> in `/_townie/08-related.md`",[],[153,229],{"_102":236,"_95":237,"_154":238,"_156":155,"_157":136,"_158":159,"_160":161,"_104":239,"_99":32,"_163":175,"_165":240,"_166":22,"_167":-5,"_168":241,"_98":242},"92be4706-89bd-11f0-80ae-0224a6c84d84","08-related.md","01991600-cca1-769d-8b8a-fc5afbae0e4d",["D",1757010775113],"# Complete Implementation Instructions: Enhanced /glimpse/:id Endpoint with Related Content and Nested Blocks\n\n## Overview\n\nEnhance the existing `/glimpse/:id` endpoint to fetch and attach related pages from the \"Glimpse content\" relation property, sorted by \"Order\" property, including full page blocks/content with all nested blocks recursively fetched to support callouts, code blocks, lists, tables, columns, and other rich content structures.\n\n## Understanding the Existing Patterns\n\n### Service Response Pattern\n\nServices return consistent structure:\n\n    // Success: {success: true, data: response, timestamp: string}\n    // Failure: {success: false, error: string, timestamp: string}\n\n### Controller Pattern\n\nControllers check `result.success` and handle accordingly:\n\n- If `!result.success`: Return 500 error with details\n- If `result.success`: Return full service response (includes success/data/timestamp)\n\n### Error Handling Philosophy\n\n\"All or nothing\" - operations either succeed completely or fail completely. No partial success states.\n\n## Implementation Steps\n\n### Step 1: Add Required Service Functions\n\nAdd to `/backend/services/notion.service.ts` before the `updatePageUrl` function:\n\n    async function getAllBlocksRecursively(blockId: string): Promise {\n      const response = await notion.blocks.children.list({\n        block_id: blockId,\n        page_size: 100 // Get more blocks per request\n      });\n\n      const blocks = response.results;\n\n      // For each block, check if it has children and fetch them recursively\n      for (const block of blocks) {\n        if (block.has_children) {\n          try {\n            block.children = await getAllBlocksRecursively(block.id);\n          } catch (error) {\n            // If fetching children fails, log but don't fail the entire operation\n            console.warn(`Failed to fetch children for block ${block.id}:`, error.message);\n            block.children = [];\n          }\n        }\n      }\n\n      return blocks;\n    }\n\n    export async function getPageBlocks(pageId: string) {\n      try {\n        const blocks = await getAllBlocksRecursively(pageId);\n        return {\n          success: true,\n          data: { results: blocks },\n          timestamp: new Date().toISOString(),\n        };\n      } catch (error) {\n        return {\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        };\n      }\n    }\n\n    export async function getMultiplePages(pageIds: string[]) {\n      try {\n        // Fetch all pages concurrently\n        const pagePromises = pageIds.map(async (pageId) => {\n          const [pageResult, blocksResult] = await Promise.all([\n            notion.pages.retrieve({ page_id: pageId }),\n            getAllBlocksRecursively(pageId)\n          ]);\n\n          return {\n            id: pageId,\n            page: pageResult,\n            blocks: { results: blocksResult } // Maintain same structure as before\n          };\n        });\n\n        const results = await Promise.all(pagePromises);\n\n        return {\n          success: true,\n          data: results,\n          timestamp: new Date().toISOString(),\n        };\n      } catch (error) {\n        return {\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        };\n      }\n    }\n\n### Step 2: Update Controller Import\n\nIn `/backend/controllers/glimpse.controller.ts`, update the import:\n\n    import { getPageById, getMultiplePages } from \"../services/notion.service.ts\";\n\n### Step 3: Replace Controller Function\n\nReplace the entire `glimpseHandler` function in `/backend/controllers/glimpse.controller.ts`:\n\n    export async function glimpseHandler(c: Context) {\n      const id = c.req.param(\"id\");\n\n      if (!id) {\n        return c.json({ error: \"Demo ID is required\" }, 400);\n      }\n\n      // Fetch the main page\n      const result = await getPageById(id);\n\n      if (!result.success) {\n        return c.json({ error: \"Failed to fetch demo data\", details: result.error }, 500);\n      }\n\n      // Filter out button properties from the main page\n      if (result.data?.properties) {\n        const filteredProperties = Object.fromEntries(\n          Object.entries(result.data.properties).filter(([key, value]) => value?.type !== \"button\")\n        );\n\n        result.data.properties = filteredProperties;\n      }\n\n      // Extract related page IDs from \"Glimpse content\" relation property\n      const glimpseContentProperty = result.data?.properties?.[\"Glimpse content\"];\n      let glimpseContent = [];\n\n      if (glimpseContentProperty?.type === \"relation\" && glimpseContentProperty.relation?.length > 0) {\n        const relatedPageIds = glimpseContentProperty.relation.map((rel: any) => rel.id);\n\n        // Fetch all related pages with their content\n        const relatedPagesResult = await getMultiplePages(relatedPageIds);\n\n        if (!relatedPagesResult.success) {\n          return c.json({\n            error: \"Failed to fetch related pages\",\n            details: relatedPagesResult.error\n          }, 500);\n        }\n\n        // Process and sort the related pages\n        glimpseContent = relatedPagesResult.data\n          .map((item: any) => {\n            // Filter out button properties from related pages too\n            const filteredProperties = item.page.properties ?\n              Object.fromEntries(\n                Object.entries(item.page.properties).filter(([key, value]) => (value as any)?.type !== \"button\")\n              ) : {};\n\n            return {\n              id: item.id,\n              properties: filteredProperties,\n              blocks: item.blocks.results\n            };\n          })\n          // Sort by Order property\n          .sort((a: any, b: any) => {\n            const orderA = a.properties?.Order?.number || 0;\n            const orderB = b.properties?.Order?.number || 0;\n            return orderA - orderB;\n          });\n      }\n\n      // Add the glimpse content to the response\n      result.data.glimpseContent = glimpseContent;\n\n      return c.json(result);\n    }\n\n### Step 4: Update Documentation\n\n#### Update `/backend/routes/glimpse/README.md`:\n\n    # Glimpse Routes\n\n    This directory contains routes for the glimpse functionality.\n\n    ## Routes\n\n    ### GET /:id\n\n    - **Purpose**: Returns Notion page data as JSON with related content (filtered for data consumption)\n    - **Authentication**: Required (Google OAuth)\n    - **Parameters**: `id` - Notion page ID\n    - **Response**: Service response object with Notion page data and related content\n    - **Filtering**: Removes UI-specific properties (type: \"button\") for cleaner data consumption\n\n    #### Enhanced Functionality\n\n    The endpoint now fetches and includes related pages from the \"Glimpse content\" relation property:\n\n    1. **Main Page**: Returns the requested page with filtered properties\n    2. **Related Content**: Fetches all pages referenced in the \"Glimpse content\" relation\n    3. **Content Blocks**: Includes full page blocks/content for each related page with nested blocks recursively fetched\n    4. **Nested Content**: Supports callouts, code blocks, lists, tables, columns, and other nested block structures\n    5. **Sorting**: Related pages are sorted by their \"Order\" property (ascending)\n    6. **Error Handling**: Returns failure if main page OR any related page fails to fetch\n\n    #### Response Structure\n\n    ```json\n    {\n      \"success\": true,\n      \"data\": {\n        \"id\": \"main-page-id\",\n        \"properties\": { ... }, // Main page properties (buttons filtered out)\n        \"glimpseContent\": [\n          {\n            \"id\": \"related-page-1\",\n            \"properties\": { \"Order\": { \"number\": 1 }, ... }, // Related page properties (buttons filtered out)\n            \"blocks\": [ ... ] // Full page content blocks with nested structures (callouts, lists, tables, etc.)\n          },\n          {\n            \"id\": \"related-page-2\",\n            \"properties\": { \"Order\": { \"number\": 2 }, ... },\n            \"blocks\": [ ... ] // Full page content blocks with nested structures\n          }\n        ]\n      },\n      \"timestamp\": \"2025-07-27T12:00:00.000Z\"\n    }\n\n#### Nested Block Structure\n\nBlocks with children will have a `children` property containing their nested blocks:\n\n    {\n      \"type\": \"bulleted_list_item\",\n      \"bulleted_list_item\": { ... },\n      \"has_children\": true,\n      \"children\": [\n        {\n          \"type\": \"bulleted_list_item\",\n          \"bulleted_list_item\": { ... },\n          \"has_children\": false\n        }\n      ]\n    }\n\n#### Error Cases\n\n- **Main page not found**: Returns `{success: false, error: \"...\", timestamp: \"...\"}`\n- **Related page fetch fails**: Returns `{success: false, error: \"Failed to fetch related pages\", timestamp: \"...\"}`\n- **Individual block children fail**: Logs warning, continues with empty children array\n- **No related content**: Returns successful response with empty `glimpseContent` array\n\nThis is the same functionality as `/views/glimpse/:id` but mounted at `/glimpse/:id` for convenience.\n\n    #### Update main `/README.md` Views section:\n\n    Replace:\n    ```markdown\n    ### Views\n    - `GET /views/glimpse/:id` - Get Notion page data as JSON (filtered for data consumption)\n\nWith:\n\n    ### Views\n    - `GET /views/glimpse/:id` - Get Notion page data with related content as JSON (filtered for data consumption)\n    - `GET /glimpse/:id` - Same as above, alternative endpoint\n\n#### Update `/backend/services/README.md` Examples section:\n\nReplace:\n\n    ## Examples\n\n    - `getDatabaseById(id)` - retrieve specific database from Notion\n    - `searchNotionDatabases()` - search for all databases\n    - `updatePageUrl(pageId, url)` - update a Notion page's URL property\n\nWith:\n\n    ## Examples\n\n    - `getDatabaseById(id)` - retrieve specific database from Notion\n    - `getPageById(id)` - retrieve specific page from Notion\n    - `getPageBlocks(id)` - retrieve page content blocks from Notion (with nested blocks recursively)\n    - `getMultiplePages(ids)` - batch retrieve multiple pages with their blocks from Notion (with nested blocks recursively)\n    - `searchNotionDatabases()` - search for all databases\n    - `updatePageUrl(pageId, url)` - update a Notion page's URL property\n\n## Key Implementation Details\n\n### Property Names\n\n- **Relation property**: \"Glimpse content\" (exact match required)\n- **Sort property**: \"Order\" (exact match required)\n\n### Nested Block Handling\n\n- **Recursive fetching**: Uses `getAllBlocksRecursively()` to fetch all nested blocks\n- **Error resilience**: Individual block failures don't break the entire operation\n- **Performance optimization**: Uses `page_size: 100` for fewer API calls\n- **Complete structure**: Supports all Notion block types with children (callouts, lists, tables, columns, toggles, etc.)\n\n### Error Handling Strategy\n\n- **All or nothing**: If any related page fails, entire request fails\n- **Individual block resilience**: If fetching children of a specific block fails, logs warning but continues\n- **Consistent responses**: Always use service response pattern\n- **Detailed errors**: Include specific error details in failure responses\n\n### Performance Considerations\n\n- **Concurrent fetching**: Use `Promise.all()` for parallel page fetching\n- **Recursive API calls**: More requests due to nested block fetching\n- **Batch operations**: Single service call handles multiple pages\n- **Reasonable limits**: Designed for up to 10 related pages\n- **Graceful degradation**: Individual block failures don't break entire response\n\n### Data Processing\n\n- **Button filtering**: Remove `type: \"button\"` properties from all pages\n- **Sorting**: Sort by `Order.number` property (ascending, default 0 for missing)\n- **Block extraction**: Use `blocks.results` from recursive fetch\n- **Nested structure**: Blocks with children have `children` array property\n\n### Response Structure\n\n- **Backward compatible**: Existing clients continue to work\n- **Additive**: New `glimpseContent` array added to existing response\n- **Consistent**: Maintains service response pattern with success/data/timestamp\n- **Rich content**: Full nested block structures for complete content representation\n\n### Supported Nested Block Types\n\n- **Lists**: Bulleted, numbered, to-do items with nested items\n- **Callouts**: With nested content blocks\n- **Code blocks**: With syntax highlighting\n- **Tables**: With cell content\n- **Columns**: With nested blocks in each column\n- **Toggles**: With hidden/expandable content\n- **Quotes**: With nested formatting\n- **Synced blocks**: With synchronized content\n- **Any other block type**: That supports children\n\n## Testing Strategy\n\n1.  **Test with no related content**: Should return empty `glimpseContent` array\n2.  **Test with related content**: Should return sorted pages with complete nested blocks\n3.  **Test nested structures**: Verify callouts, lists, tables render with full hierarchy\n4.  **Test error cases**: Invalid page IDs should return failure responses\n5.  **Test individual block failures**: Should continue with warnings, not fail entirely\n6.  **Test authentication**: Unauthenticated requests should show login page\n7.  **Test performance**: Monitor response times with deeply nested content\n\n## Block Structure Examples\n\n### Nested List Example\n\n    {\n      \"type\": \"bulleted_list_item\",\n      \"bulleted_list_item\": {\n        \"rich_text\": [{\"plain_text\": \"Parent item\"}]\n      },\n      \"has_children\": true,\n      \"children\": [\n        {\n          \"type\": \"bulleted_list_item\",\n          \"bulleted_list_item\": {\n            \"rich_text\": [{\"plain_text\": \"Child item\"}]\n          },\n          \"has_children\": false\n        }\n      ]\n    }\n\n### Callout with Nested Content Example\n\n    {\n      \"type\": \"callout\",\n      \"callout\": {\n        \"rich_text\": [{\"plain_text\": \"Important note\"}],\n        \"icon\": {\"emoji\": \"💡\"}\n      },\n      \"has_children\": true,\n      \"children\": [\n        {\n          \"type\": \"paragraph\",\n          \"paragraph\": {\n            \"rich_text\": [{\"plain_text\": \"Additional details inside callout\"}]\n          }\n        }\n      ]\n    }\n\nThis implementation provides complete nested block structures that will properly represent all rich content types including callouts, code blocks, lists, tables, columns, and any other nested Notion block structures.\n",[],[153,237],{"_102":244,"_95":245,"_154":246,"_156":155,"_157":136,"_158":159,"_160":161,"_104":247,"_99":32,"_163":175,"_165":248,"_166":22,"_167":-5,"_168":249,"_98":250},"92be5d68-89bd-11f0-80ae-0224a6c84d84","09-cache.md","01991600-cca1-769d-8b8b-025f215acd1f",["D",1757010775113],"# Complete Instructions for Implementing Glimpse Endpoint Caching\n\n## Overview\n\nImplement a comprehensive caching system for `/glimpse/:id` endpoints to reduce Notion API response times from 1-6 seconds to milliseconds by using blob storage with automated cache population.\n\n## Prerequisites Understanding\n\n- The `/glimpse/:id` endpoint fetches data from Notion API including nested blocks via `getAllBlocksRecursively`\n- Response times are slow (1-6 seconds) due to Notion API calls and recursive block fetching\n- The system uses Hono for routing and has existing authentication middleware\n- Database queries use `GLANCE_DEMOS_DB_ID` environment variable to identify demo pages\n- Existing architecture has controllers in `/backend/controllers/`, services in `/backend/services/`, routes in `/backend/routes/`\n\n## Implementation Steps\n\n### 1\\. Create Blob Key Utilities (`/backend/utils/blob-keys.ts`)\n\n    function getValAndFileNameFromURL(url: string): string | null {\n      try {\n        const { pathname } = new URL(url);\n        const [preAt] = pathname.split(\"@\");\n        if (!preAt) return null;\n        const valName = preAt.split(\"/\").filter(Boolean).pop();\n        return valName ?? null;\n      } catch (e) {\n        console.error(\"Invalid URL passed to getValAndFileNameFromURL:\", url, e);\n        return null;\n      }\n    }\n\n    export function blobKey(type: string, id: string, url: string = import.meta.url): string {\n      if (!id || typeof id !== \"string\") {\n        throw new Error(\"Invalid ID passed to blobKey\");\n      }\n\n      const valName = getValAndFileNameFromURL(url);\n      if (!valName) {\n        throw new Error(\"Could not extract val name from URL\");\n      }\n\n      return [valName, type, id].join(\"--\");\n    }\n\n    export const blobKeyForDemos = (id: string) => blobKey(\"demo\", id);\n\n### 2\\. Add Database Query Function to Notion Service\n\nAdd to `/backend/services/notion.service.ts`:\n\n    export async function getDemoPages() {\n      try {\n        const databaseId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n        if (!databaseId) {\n          throw new Error(\"GLANCE_DEMOS_DB_ID environment variable is not set\");\n        }\n\n        const response = await notion.databases.query({\n          database_id: databaseId,\n        });\n\n        return {\n          success: true,\n          data: response.results,\n          timestamp: new Date().toISOString(),\n        };\n      } catch (error) {\n        return {\n          success: false,\n          error: error.message,\n          timestamp: new Date().toISOString(),\n        };\n      }\n    }\n\n### 3\\. Refactor Glimpse Controller\n\nReplace `/backend/controllers/glimpse.controller.ts` entirely:\n\n    import { Context } from \"npm:hono@3.12.12\";\n    import { getPageById, getMultiplePages } from \"../services/notion.service.ts\";\n    import { blob } from \"https://esm.town/v/std/blob\";\n    import { blobKeyForDemos } from \"../utils/blob-keys.ts\";\n\n    export async function getGlimpseData(id: string) {\n      if (!id) {\n        return { success: false, error: \"Demo ID is required\", status: 400 };\n      }\n\n      // Fetch the main page\n      const result = await getPageById(id);\n\n      if (!result.success) {\n        return { success: false, error: \"Failed to fetch demo data\", details: result.error, status: 500 };\n      }\n\n      // Filter out button properties from the main page\n      if (result.data?.properties) {\n        const filteredProperties = Object.fromEntries(\n          Object.entries(result.data.properties).filter(([key, value]) => value?.type !== \"button\")\n        );\n\n        result.data.properties = filteredProperties;\n      }\n\n      // Extract related page IDs from \"Glimpse content\" relation property\n      const glimpseContentProperty = result.data?.properties?.[\"Glimpse content\"];\n      let glimpseContent = [];\n\n      if (glimpseContentProperty?.type === \"relation\" && glimpseContentProperty.relation?.length > 0) {\n        const relatedPageIds = glimpseContentProperty.relation.map((rel: any) => rel.id);\n\n        // Fetch all related pages with their content\n        const relatedPagesResult = await getMultiplePages(relatedPageIds);\n\n        if (!relatedPagesResult.success) {\n          return {\n            success: false,\n            error: \"Failed to fetch related pages\",\n            details: relatedPagesResult.error,\n            status: 500\n          };\n        }\n\n        // Process and sort the related pages\n        glimpseContent = relatedPagesResult.data\n          .map((item: any) => {\n            // Filter out button properties from related pages too\n            const filteredProperties = item.page.properties ?\n              Object.fromEntries(\n                Object.entries(item.page.properties).filter(([key, value]) => (value as any)?.type !== \"button\")\n              ) : {};\n\n            return {\n              id: item.id,\n              properties: filteredProperties,\n              blocks: item.blocks.results\n            };\n          })\n          // Sort by Order property\n          .sort((a: any, b: any) => {\n            const orderA = a.properties?.Order?.number || 0;\n            const orderB = b.properties?.Order?.number || 0;\n            return orderA - orderB;\n          });\n      }\n\n      // Add the glimpse content to the response\n      result.data.glimpseContent = glimpseContent;\n\n      return { success: true, data: result };\n    }\n\n    export async function glimpseHandler(c: Context) {\n      const id = c.req.param(\"id\");\n\n      if (!id) {\n        return c.json({ error: \"Demo ID is required\" }, 400);\n      }\n\n      // First try to get cached data\n      try {\n        const cachedData = await blob.getJSON(blobKeyForDemos(id));\n        if (cachedData) {\n          console.log(`Serving cached data for glimpse ID: ${id}`);\n          return c.json(cachedData);\n        }\n      } catch (error) {\n        console.log(`No cached data found for glimpse ID: ${id}, falling back to live data`);\n      }\n\n      // Cache miss - fall back to live Notion data\n      const result = await getGlimpseData(id);\n\n      if (!result.success) {\n        return c.json({ error: result.error, details: result.details }, result.status);\n      }\n\n      return c.json(result.data);\n    }\n\n### 4\\. Create Caching Cron Job\n\nCreate `/backend/crons/cache_glimpse_data.ts`:\n\n    import { blob } from \"https://esm.town/v/std/blob\";\n    import { getDemoPages } from \"../services/notion.service.ts\";\n    import { getGlimpseData } from \"../controllers/glimpse.controller.ts\";\n    import { blobKeyForDemos } from \"../utils/blob-keys.ts\";\n\n    export default async function cacheGlimpseData() {\n      console.log(\"Starting glimpse data caching process...\");\n\n      try {\n        // Get all demo pages from the database\n        const demosResult = await getDemoPages();\n\n        if (!demosResult.success) {\n          console.error(\"Failed to fetch demo pages:\", demosResult.error);\n          return;\n        }\n\n        const demoPages = demosResult.data;\n        console.log(`Found ${demoPages.length} demo pages to cache`);\n\n        let successCount = 0;\n        let errorCount = 0;\n\n        // Process each demo page\n        for (const page of demoPages) {\n          const pageId = page.id;\n\n          try {\n            console.log(`Caching glimpse data for page ID: ${pageId}`);\n\n            // Get the glimpse data using the same logic as the endpoint\n            const glimpseResult = await getGlimpseData(pageId);\n\n            if (glimpseResult.success) {\n              // Store in blob storage\n              await blob.setJSON(blobKeyForDemos(pageId), glimpseResult.data);\n              console.log(`Successfully cached data for page ID: ${pageId}`);\n              successCount++;\n            } else {\n              console.error(`Failed to get glimpse data for page ID ${pageId}:`, glimpseResult.error);\n              errorCount++;\n            }\n          } catch (error) {\n            console.error(`Error processing page ID ${pageId}:`, error.message);\n            errorCount++;\n          }\n        }\n\n        console.log(`Caching process completed. Success: ${successCount}, Errors: ${errorCount}`);\n      } catch (error) {\n        console.error(\"Fatal error in caching process:\", error.message);\n      }\n    }\n\n### 5\\. Set Cron Trigger\n\nUse the `change_val_type` tool:\n\n    change_val_type(\"/backend/crons/cache_glimpse_data.ts\", \"cron\")\n\n### 6\\. Configure Cron Schedule\n\n**CRITICAL**: After implementation, go to Val Town web UI and set the cron schedule to run every minute (`* * * * *`).\n\n## Validation Steps\n\n### Test 1: Verify Database Query\n\nCreate temporary test file:\n\n    import { getDemoPages } from \"./backend/services/notion.service.ts\";\n\n    export default async function testDatabaseQuery(req: Request) {\n      const result = await getDemoPages();\n      return new Response(JSON.stringify({\n        success: result.success,\n        count: result.success ? result.data.length : 0,\n        sampleIds: result.success ? result.data.slice(0, 3).map(p => p.id) : [],\n        error: result.success ? null : result.error\n      }), {\n        headers: { \"Content-Type\": \"application/json\" }\n      });\n    }\n\nExpected: `success: true`, `count: > 0`, array of page IDs\n\n### Test 2: Verify Caching Logic\n\nCreate temporary test file:\n\n    import { getGlimpseData } from \"./backend/controllers/glimpse.controller.ts\";\n    import { blob } from \"https://esm.town/v/std/blob\";\n    import { blobKeyForDemos } from \"./backend/utils/blob-keys.ts\";\n\n    export default async function testCaching(req: Request) {\n      const testPageId = \"FIRST_PAGE_ID_FROM_TEST_1\"; // Replace with actual ID\n\n      const glimpseResult = await getGlimpseData(testPageId);\n      if (!glimpseResult.success) {\n        return new Response(JSON.stringify({ error: glimpseResult.error }), { status: 500 });\n      }\n\n      const blobKey = blobKeyForDemos(testPageId);\n      await blob.setJSON(blobKey, glimpseResult.data);\n\n      const retrieved = await blob.getJSON(blobKey);\n\n      return new Response(JSON.stringify({\n        success: true,\n        blobKey,\n        dataStored: !!retrieved,\n        hasNestedBlocks: !!retrieved?.data?.glimpseContent?.some(item =>\n          item.blocks?.some(block => block.children && block.children.length > 0)\n        )\n      }));\n    }\n\nExpected: `success: true`, `dataStored: true`, nested blocks preserved\n\n### Test 3: Verify Cache-First Endpoint\n\nCreate temporary test file:\n\n    import { glimpseHandler } from \"./backend/controllers/glimpse.controller.ts\";\n\n    export default async function testCachedEndpoint(req: Request) {\n      const testPageId = \"CACHED_PAGE_ID_FROM_TEST_2\";\n\n      const mockContext = {\n        req: { param: (name: string) => name === \"id\" ? testPageId : undefined },\n        json: (data: any, status?: number) => new Response(JSON.stringify(data), {\n          status: status || 200,\n          headers: { \"Content-Type\": \"application/json\" }\n        })\n      };\n\n      const response = await glimpseHandler(mockContext as any);\n      const responseData = JSON.parse(await response.text());\n\n      return new Response(JSON.stringify({\n        success: true,\n        status: response.status,\n        servedFromCache: true, // Check logs for \"Serving cached data\" message\n        hasData: !!responseData?.data\n      }));\n    }\n\nExpected: `success: true`, `status: 200`, logs show \"Serving cached data\"\n\n## Performance Expectations\n\n### Before Implementation:\n\n- Response times: 1-6 seconds\n- Every request hits Notion API\n- Recursive block fetching on every request\n\n### After Implementation:\n\n- **Cache Hit**: 50-200ms response time\n- **Cache Miss**: 1-6 seconds (fallback to live data)\n- **Cache Population**: Automatic every minute via cron\n\n## Troubleshooting Guide\n\n### Issue: Cron not running\n\n- **Check**: Val Town web UI cron schedule is set to `* * * * *`\n- **Verify**: Check cron execution logs with `requests` tool\n\n### Issue: Cache not being used\n\n- **Check**: Look for \"Serving cached data\" or \"No cached data found\" in endpoint logs\n- **Verify**: Manually test blob key exists: `blob.getJSON(blobKeyForDemos(pageId))`\n\n### Issue: Nested blocks missing\n\n- **Check**: Compare live vs cached data structure\n- **Verify**: `getAllBlocksRecursively` function is working correctly\n- **Expected**: Blocks with `children` property containing nested arrays\n\n### Issue: Slow response times persist\n\n- **Check**: Cron has run at least once (check cron logs)\n- **Verify**: Cache keys exist in blob storage\n- **Debug**: Look for cache miss logs in endpoint requests\n\n## Architecture Principles Maintained\n\n1.  **Controllers**: Business logic stays in `/backend/controllers/`\n2.  **Services**: External API calls in `/backend/services/`\n3.  **Utilities**: Backend-only helpers in `/backend/utils/`\n4.  **Crons**: Scheduled tasks in `/backend/crons/`\n5.  **No Code Duplication**: Both endpoint and cron use same `getGlimpseData()` function\n6.  **Error Resilience**: Cron continues on individual failures, endpoint falls back to live data\n7.  **Data Integrity**: Complete preservation of nested block structure and all metadata\n\n## Success Criteria\n\n- ✅ All demo pages automatically cached every minute\n- ✅ Cache-first endpoint with live data fallback\n- ✅ Response times under 200ms for cached data\n- ✅ Complete preservation of nested block structure\n- ✅ Error logging and graceful degradation\n- ✅ No breaking changes to existing API contract\n",[],[153,245],{"_102":252,"_95":253,"_154":254,"_156":155,"_157":136,"_158":159,"_160":161,"_104":255,"_99":32,"_163":175,"_165":256,"_166":22,"_167":-5,"_168":257,"_98":258},"92be6e8e-89bd-11f0-80ae-0224a6c84d84","10-react.md","01991600-cca1-769d-8b8b-05749d3afd24",["D",1757010775113],"# Complete Implementation Instructions: React Bootstrap for Glimpse Endpoint (REVISED)\n\n\\=================================================================================\n\n## Objective\n\n---\n\nTransform an existing JSON-only `/glimpse/:id` endpoint to serve a professional HTML page with React, while maintaining JSON API compatibility.\n\n## Prerequisites\n\n---\n\n- Existing `/glimpse/:id` endpoint that returns JSON data\n- Hono-based backend with authentication middleware\n- User email available via `c.get(\"userEmail\")` from auth context\n- LastLogin authentication system with `/auth/logout` endpoint\n\n## Implementation Steps\n\n---\n\n### 1\\. Create Frontend Directory Structure\n\n    /frontend/\n    ├── glimpse.html\n    ├── glimpse.tsx\n    ├── components/\n    │   └── GlimpseView.tsx\n    └── README.md (update existing)\n\n### 2\\. Create `/frontend/glimpse.html`\n\nClean HTML shell that loads the React entry point:\n\n    \n    \n    \n        \n        \n        Glimpse\n        \n        \n    \n    \n        
\n        \n    \n    \n\n### 3\\. Create `/frontend/glimpse.tsx`\n\nReact entry point that bootstraps the application:\n\n    /** @jsxImportSource https://esm.sh/react@18.2.0 */\n    import React from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n    import { createRoot } from \"https://esm.sh/react-dom@18.2.0/client?deps=react@18.2.0,react-dom@18.2.0\";\n    import { GlimpseView } from \"./components/GlimpseView.tsx\";\n\n    // Get data injected by the server\n    const data = (window as any).__INITIAL_DATA__;\n    const userEmail = (window as any).__USER_EMAIL__;\n\n    // Render the application\n    const root = createRoot(document.getElementById('root')!);\n    root.render();\n\n### 4\\. Create `/frontend/components/GlimpseView.tsx`\n\nPure React component for displaying glimpse data:\n\n    /** @jsxImportSource https://esm.sh/react@18.2.0 */\n    import React from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n\n    interface GlimpseViewProps {\n      data: any;\n      userEmail?: string;\n    }\n\n    export function GlimpseView({ data, userEmail }: GlimpseViewProps) {\n      return (\n        \n          {/* Header */}\n          \n            Glimpse
\n            \n              {userEmail || 'user@example.com'}\n              \n                Logout\n              \n            
\n          
\n\n          {/* Main layout with sidenav and content */}\n          \n            {/* Sidenav */}\n            \n              Navigation
\n              \n                \n                  \n                    Dashboard\n                  \n                
\n                \n                  \n                    Current Glimpse\n                  \n                
\n              
\n            
\n\n            {/* Main content */}\n            \n              \n                Glimpse Data
\n                \n                  {JSON.stringify(data, null, 2)}\n                
\n              
\n            
\n          
\n\n          {/* Footer */}\n          \n            © 2024 Glimpse Platform
\n          
\n        
\n      );\n    }\n\n### 5\\. Update `/frontend/README.md`\n\nReplace existing content with:\n\n    # Frontend\n\n    Client-side files that render in the browser.\n\n    ## Structure\n\n    - `glimpse.html` - Clean HTML shell that loads React entry point\n    - `glimpse.tsx` - React bootstrap/entry point that gathers data and initializes the app\n    - `components/` - React components\n      - `GlimpseView.tsx` - Component for displaying JSON data in glimpse pages\n\n    ## Glimpse Pages\n\n    The glimpse functionality uses a 3-layer architecture:\n\n    1. **HTML Shell** (`glimpse.html`) - Minimal HTML that loads the React entry point\n    2. **React Bootstrap** (`glimpse.tsx`) - Gathers server-injected data and renders the main component\n    3. **UI Component** (`GlimpseView.tsx`) - Pure React component that receives data as props\n\n    ### Data Flow\n\n    1. Backend fetches cached or live Notion data\n    2. Data is injected into HTML template as `window.__INITIAL_DATA__`\n    3. React entry point reads the data and passes it to the component\n    4. Component renders the data in a `` tag for JSON display\n\n    ## API Compatibility\n\n    The glimpse endpoint maintains backward compatibility:\n    - Default: Serves HTML page with React\n    - `?format=json` or `Accept: application/json` header: Returns JSON data\n\n    ## Future Enhancements\n\n    When ready to format Notion data as HTML instead of JSON:\n    1. Modify the `GlimpseView` component in `components/GlimpseView.tsx`\n    2. Add proper Notion block rendering logic\n    3. The entry point (`glimpse.tsx`) handles data gathering, so UI changes only affect the component\n\n### 6\\. Modify Glimpse Controller\n\nIn `/backend/controllers/glimpse.controller.ts`:\n\n**Add imports:**\n\n    import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\n**Replace the entire `glimpseHandler` function:**\n\n    export async function glimpseHandler(c: Context) {\n      const id = c.req.param(\"id\");\n\n      if (!id) {\n        return c.json({ error: \"Demo ID is required\" }, 400);\n      }\n\n      // Get the data (cached or live)\n      let notionData;\n\n      // First try to get cached data\n      try {\n        const cachedData = await blob.getJSON(blobKeyForDemos(id));\n        if (cachedData) {\n          console.log(`Serving cached data for glimpse ID: ${id}`);\n          notionData = cachedData;\n        }\n      } catch (error) {\n        console.log(`No cached data found for glimpse ID: ${id}, falling back to live data`);\n      }\n\n      // Cache miss - fall back to live Notion data\n      if (!notionData) {\n        const result = await getGlimpseData(id);\n\n        if (!result.success) {\n          return c.json({ error: result.error, details: result.details }, result.status);\n        }\n\n        notionData = result.data;\n      }\n\n      // Check if they want JSON (for API compatibility)\n      if (c.req.header(\"accept\")?.includes(\"application/json\") || c.req.query(\"format\") === \"json\") {\n        return c.json(notionData);\n      }\n\n      // Otherwise serve the React page\n      let html = await readFile(\"/frontend/glimpse.html\", import.meta.url);\n\n      // Get user email from auth context\n      const userEmail = c.get(\"userEmail\");\n\n      const dataScript = ``;\n\n      html = html.replace(\"\", `${dataScript}`);\n      return c.html(html);\n    }\n\n### 7\\. Add Frontend File Serving\n\nIn your main Hono app (likely `/main.tsx` or similar), add frontend file serving:\n\n**Add after existing route mounts:**\n\n    // Serve frontend files\n    app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n\n## Key Features Delivered\n\n---\n\n✅ **Clean Architecture** \\- Proper separation between HTML shell, React bootstrap, and UI components  \n✅ **Professional Tailwind Layout** \\- Header, sidenav, main content, footer  \n✅ **Server-side Data Injection** \\- No extra API calls needed  \n✅ **User Context** \\- Shows authenticated user's email in header  \n✅ **Backward Compatibility** \\- JSON API still works with `?format=json`  \n✅ **Proper Authentication Integration** \\- Uses `/auth/logout` endpoint  \n✅ **Clean JSON Display** \\- Formatted in scrollable `` tag  \n✅ **Minimal Tailwind Classes** \\- Only essential styling  \n✅ **React 18.2.0** \\- Properly configured with pinned versions  \n✅ **Error Handling** \\- Includes Val Town's error capture script  \n✅ **Maintainable Code** \\- Single source of truth for UI logic\n\n## Testing\n\n---\n\n- Visit `/glimpse/:id` → Should show HTML page with layout\n- Visit `/glimpse/:id?format=json` → Should return JSON data\n- Verify user email appears in header\n- Verify logout link works\n- Verify React entry point loads correctly\n\nThis implementation provides a clean, maintainable React architecture while maintaining all existing functionality and adding a professional UI layer.\n",[],[153,253],{"_102":260,"_95":261,"_154":262,"_156":155,"_157":136,"_158":159,"_160":161,"_104":263,"_99":32,"_163":175,"_165":264,"_166":22,"_167":-5,"_168":265,"_98":266},"92be7b7c-89bd-11f0-80ae-0224a6c84d84","11-html.md","01991600-cca1-769d-8b8b-089e6f96d7d9",["D",1757010775113],"# Complete Instructions: Implementing Notion HTML Renderer for Glimpse Pages\n\n## Context\n\nThe `/glimpse/:id` endpoint currently displays Notion data as JSON in a `` tag. The goal is to render this data as properly formatted HTML while maintaining the existing architecture and caching system.\n\n## Current Architecture Understanding\n\n- Backend fetches Notion data via `getGlimpseData()` in `/backend/controllers/glimpse.controller.ts`\n- Data structure includes main page + `glimpseContent` array of related pages\n- Each glimpse content item has: `{id, properties, blocks}` where `blocks` is the direct array (not `blocks.results`)\n- Frontend uses React with server-side data injection via `window.__INITIAL_DATA__`\n- Current display: `GlimpseView.tsx` renders JSON in `` tag\n\n## Implementation Steps\n\n### 1\\. Create NotionRenderer Component\n\nCreate `/frontend/components/NotionRenderer.tsx`:\n\n    /** @jsxImportSource https://esm.sh/react@18.2.0 */\n    import React from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n    import { BlockRenderer } from \"./BlockRenderer.tsx\";\n\n    interface NotionRendererProps {\n      data: any;\n    }\n\n    export function NotionRenderer({ data }: NotionRendererProps) {\n      if (!data) {\n        return No data available
;\n      }\n\n      // Handle both direct data and wrapped service response\n      const mainPage = data.data || data;\n      const glimpseContent = mainPage.glimpseContent || [];\n\n      return (\n        \n          {/* Main Page Header */}\n          \n            \n              {getPageTitle(mainPage)}\n            
\n            {/* Only show Name property if it exists and is not already shown as title */}\n            {mainPage.properties && (\n              \n                {Object.entries(mainPage.properties)\n                  .filter(([key, value]) => key === 'Name' && (value as any)?.type !== 'title')\n                  .map(([key, value]) => (\n                    \n                  ))}\n              
\n            )}\n          
\n\n          {/* Glimpse Content */}\n          {glimpseContent.length > 0 ? (\n            \n              \n                Content ({glimpseContent.length} pages)\n              
\n              {glimpseContent.map((contentPage: any, index: number) => (\n                \n              ))}\n            
\n          ) : (\n            \n              No glimpse content available for this page.\n            
\n          )}\n        
\n      );\n    }\n\n    function getPageTitle(page: any): string {\n      // Try to extract title from properties\n      if (page.properties) {\n        const titleProp = Object.values(page.properties).find((prop: any) => prop.type === 'title');\n        if (titleProp && (titleProp as any).title?.[0]?.plain_text) {\n          return (titleProp as any).title[0].plain_text;\n        }\n      }\n\n      // Fallback to page object title if available\n      if (page.object === 'page' && page.properties?.title?.title?.[0]?.plain_text) {\n        return page.properties.title.title[0].plain_text;\n      }\n\n      return 'Untitled';\n    }\n\n    function PropertyRenderer({ name, property }: { name: string; property: any }) {\n      if (!property || property.type === 'title') return null;\n\n      const renderPropertyValue = () => {\n        switch (property.type) {\n          case 'rich_text':\n            return property.rich_text?.map((text: any, i: number) => (\n              {text.plain_text}\n            )).join('') || '';\n          case 'number':\n            return property.number?.toString() || '';\n          case 'select':\n            return property.select?.name || '';\n          case 'multi_select':\n            return property.multi_select?.map((item: any) => item.name).join(', ') || '';\n          case 'date':\n            return property.date?.start || '';\n          case 'checkbox':\n            return property.checkbox ? '✓' : '✗';\n          case 'url':\n            return property.url ? (\n              \n                {property.url}\n              \n            ) : '';\n          case 'email':\n            return property.email ? (\n              \n                {property.email}\n              \n            ) : '';\n          case 'phone_number':\n            return property.phone_number || '';\n          case 'relation':\n            return `${property.relation?.length || 0} related items`;\n          default:\n            return JSON.stringify(property);\n        }\n      };\n\n      const value = renderPropertyValue();\n      if (!value) return null;\n\n      return (\n        \n          {name}
\n          {value}
\n        
\n      );\n    }\n\n    function ContentPageRenderer({ page }: { page: any }) {\n      const title = getPageTitle(page);\n      // CRITICAL: blocks are directly on page object, not page.blocks.results\n      const blocks = page.blocks || [];\n\n      return (\n        \n          {title !== 'Untitled' && (\n            {title}
\n          )}\n\n          {/* Render blocks - NO page properties for content pages */}\n          {blocks.length > 0 ? (\n            \n              \n            
\n          ) : (\n            \n              No content blocks found for this page.\n            
\n          )}\n        
\n      );\n    }\n\n    function BlockGroupRenderer({ blocks }: { blocks: any[] }) {\n      const groupedBlocks: any[] = [];\n      let currentGroup: any = null;\n\n      for (let i = 0; i < blocks.length; i++) {\n        const block = blocks[i];\n\n        if (block.type === 'numbered_list_item') {\n          if (!currentGroup || currentGroup.type !== 'numbered_list') {\n            // Start a new numbered list group\n            currentGroup = {\n              type: 'numbered_list',\n              items: [block]\n            };\n            groupedBlocks.push(currentGroup);\n          } else {\n            // Add to existing numbered list group\n            currentGroup.items.push(block);\n          }\n        } else if (block.type === 'bulleted_list_item') {\n          if (!currentGroup || currentGroup.type !== 'bulleted_list') {\n            // Start a new bulleted list group\n            currentGroup = {\n              type: 'bulleted_list',\n              items: [block]\n            };\n            groupedBlocks.push(currentGroup);\n          } else {\n            // Add to existing bulleted list group\n            currentGroup.items.push(block);\n          }\n        } else {\n          // Non-list item, reset current group\n          currentGroup = null;\n          groupedBlocks.push(block);\n        }\n      }\n\n      return (\n        <>\n          {groupedBlocks.map((item, index) => {\n            if (item.type === 'numbered_list') {\n              return (\n                \n                  {item.items.map((block: any, itemIndex: number) => (\n                    \n                      \n                    
\n                  ))}\n                
\n              );\n            } else if (item.type === 'bulleted_list') {\n              return (\n                \n                  {item.items.map((block: any, itemIndex: number) => (\n                    \n                      \n                    
\n                  ))}\n                
\n              );\n            } else {\n              return ;\n            }\n          })}\n        \n      );\n    }\n\n### 2\\. Create BlockRenderer Component\n\nCreate `/frontend/components/BlockRenderer.tsx`:\n\n    /** @jsxImportSource https://esm.sh/react@18.2.0 */\n    import React from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n\n    interface BlockRendererProps {\n      block: any;\n      listContext?: {\n        type: 'numbered' | 'bulleted';\n        index: number;\n      };\n    }\n\n    // Helper function to group blocks for nested lists\n    function groupBlocks(blocks: any[]): any[] {\n      const groupedBlocks: any[] = [];\n      let currentGroup: any = null;\n\n      for (let i = 0; i < blocks.length; i++) {\n        const block = blocks[i];\n\n        if (block.type === 'numbered_list_item') {\n          if (!currentGroup || currentGroup.type !== 'numbered_list') {\n            currentGroup = {\n              type: 'numbered_list',\n              items: [block]\n            };\n            groupedBlocks.push(currentGroup);\n          } else {\n            currentGroup.items.push(block);\n          }\n        } else if (block.type === 'bulleted_list_item') {\n          if (!currentGroup || currentGroup.type !== 'bulleted_list') {\n            currentGroup = {\n              type: 'bulleted_list',\n              items: [block]\n            };\n            groupedBlocks.push(currentGroup);\n          } else {\n            currentGroup.items.push(block);\n          }\n        } else {\n          currentGroup = null;\n          groupedBlocks.push(block);\n        }\n      }\n\n      return groupedBlocks;\n    }\n\n    // Helper component to render grouped blocks\n    function NestedBlockRenderer({ blocks }: { blocks: any[] }) {\n      const groupedBlocks = groupBlocks(blocks);\n\n      return (\n        <>\n          {groupedBlocks.map((item, index) => {\n            if (item.type === 'numbered_list') {\n              return (\n                \n                  {item.items.map((block: any, itemIndex: number) => (\n                    \n                      \n                    
\n                  ))}\n                
\n              );\n            } else if (item.type === 'bulleted_list') {\n              return (\n                \n                  {item.items.map((block: any, itemIndex: number) => (\n                    \n                      \n                    
\n                  ))}\n                
\n              );\n            } else {\n              return ;\n            }\n          })}\n        \n      );\n    }\n\n    export function BlockRenderer({ block, listContext }: BlockRendererProps) {\n      if (!block || !block.type) {\n        return null;\n      }\n\n      const blockData = block[block.type] || {};\n      const children = block.children || [];\n\n      const renderChildren = () => {\n        if (children.length === 0) return null;\n        return (\n          \n            {children.map((child: any, index: number) => (\n              \n            ))}\n          
\n        );\n      };\n\n      switch (block.type) {\n        case 'paragraph':\n          return (\n            \n              \n              {renderChildren()}\n            
\n          );\n\n        case 'heading_1':\n          return (\n            \n              \n                \n              
\n              {renderChildren()}\n            
\n          );\n\n        case 'heading_2':\n          return (\n            \n              \n                \n              
\n              {renderChildren()}\n            
\n          );\n\n        case 'heading_3':\n          return (\n            \n              \n                \n              
\n              {renderChildren()}\n            
\n          );\n\n        case 'bulleted_list_item':\n          if (listContext?.type === 'bulleted') {\n            // When rendered inside , render content inline to avoid line breaks after bullets\n            return (\n              <>\n                \n                {children.length > 0 && (\n                  \n                )}\n              \n            );\n          }\n          // Fallback for standalone bulleted list items\n          return (\n            \n              \n                \n                \n                  \n                  {renderChildren()}\n                
\n              
\n            
\n          );\n\n        case 'numbered_list_item':\n          if (listContext?.type === 'numbered') {\n            // When rendered inside , render content inline to avoid line breaks after numbers\n            return (\n              <>\n                \n                {children.length > 0 && (\n                  \n                )}\n              \n            );\n          }\n          // Fallback for standalone numbered list items\n          return (\n            \n              \n                1.\n                \n                  \n                  {renderChildren()}\n                
\n              
\n            
\n          );\n\n        case 'to_do':\n          return (\n            \n              \n                \n                \n                  \n                  {renderChildren()}\n                
\n              
\n            
\n          );\n\n        case 'quote':\n          return (\n            \n              \n                \n              
\n              {renderChildren()}\n            
\n          );\n\n        case 'code':\n          return (\n            \n              \n                \n                  \n                \n              
\n              {renderChildren()}\n            
\n          );\n\n        case 'callout':\n          const renderCalloutIcon = () => {\n            if (!blockData?.icon) return '💡';\n\n            if (blockData.icon.type === 'emoji') {\n              return blockData.icon.emoji;\n            } else if (blockData.icon.type === 'external' && blockData.icon.external?.url) {\n              return (\n                \n              );\n            } else if (blockData.icon.type === 'file' && blockData.icon.file?.url) {\n              return (\n                \n              );\n            }\n\n            return '💡';\n          };\n\n          return (\n            \n              \n                \n                  \n                    {renderCalloutIcon()}\n                  \n                  \n                    \n                    {/* CRITICAL: Render children INSIDE callout container */}\n                    {children.length > 0 && (\n                      \n                        {children.map((child: any, index: number) => (\n                          \n                        ))}\n                      
\n                    )}\n                  
\n                
\n              
\n            
\n          );\n\n        case 'divider':\n          return (\n            \n              
\n              {renderChildren()}\n            
\n          );\n\n        case 'image':\n          const imageUrl = blockData?.file?.url || blockData?.external?.url;\n          const caption = blockData?.caption || [];\n          return (\n            \n              {imageUrl && (\n                 0 ? caption[0].plain_text : 'Image'}\n                  className=\"max-w-full h-auto rounded\"\n                />\n              )}\n              {caption.length > 0 && (\n                \n                  \n                
\n              )}\n              {renderChildren()}\n            
\n          );\n\n        case 'video':\n          const videoUrl = blockData?.file?.url || blockData?.external?.url;\n          return (\n            \n              {videoUrl && (\n                \n              )}\n              {renderChildren()}\n            
\n          );\n\n        case 'embed':\n          return (\n            \n              \n                \n                  Embedded content: {blockData?.url}\n                
\n              
\n              {renderChildren()}\n            
\n          );\n\n        case 'bookmark':\n          return (\n            \n              \n                \n                  {blockData?.caption?.[0]?.plain_text || blockData?.url}\n                
\n                {blockData?.url}
\n              \n              {renderChildren()}\n            
\n          );\n\n        case 'table':\n          return (\n            \n              \n                \n                  {children.map((row: any, rowIndex: number) => (\n                    \n                      {row.table_row?.cells?.map((cell: any, cellIndex: number) => (\n                        \n                      ))}\n                    \n                  ))}\n                \n              \n                          \n                        
\n            
\n          );\n\n        case 'table_row':\n          return null;\n\n        default:\n          return (\n            \n              \n                Unsupported block type: {block.type}\n              
\n              {blockData?.rich_text && (\n                \n                  \n                
\n              )}\n              {renderChildren()}\n            
\n          );\n      }\n    }\n\n    function RichTextRenderer({ richText }: { richText: any[] }) {\n      if (!richText || richText.length === 0) {\n        return null;\n      }\n\n      return (\n        <>\n          {richText.map((text, index) => {\n            let element = {text.plain_text};\n\n            if (text.annotations) {\n              if (text.annotations.bold) {\n                element = {element};\n              }\n              if (text.annotations.italic) {\n                element = {element};\n              }\n              if (text.annotations.strikethrough) {\n                element = {element};\n              }\n              if (text.annotations.underline) {\n                element = {element};\n              }\n              if (text.annotations.code) {\n                element = {text.plain_text};\n              }\n              if (text.annotations.color && text.annotations.color !== 'default') {\n                const colorClass = getColorClass(text.annotations.color);\n                element = {element};\n              }\n            }\n\n            if (text.href) {\n              element = (\n                \n                  {element}\n                \n              );\n            }\n\n            return element;\n          })}\n        \n      );\n    }\n\n    function getColorClass(color: string): string {\n      const colorMap: { [key: string]: string } = {\n        'gray': 'text-gray-600',\n        'brown': 'text-amber-700',\n        'orange': 'text-orange-600',\n        'yellow': 'text-yellow-600',\n        'green': 'text-green-600',\n        'blue': 'text-blue-600',\n        'purple': 'text-purple-600',\n        'pink': 'text-pink-600',\n        'red': 'text-red-600',\n        'gray_background': 'bg-gray-100',\n        'brown_background': 'bg-amber-100',\n        'orange_background': 'bg-orange-100',\n        'yellow_background': 'bg-yellow-100',\n        'green_background': 'bg-green-100',\n        'blue_background': 'bg-blue-100',\n        'purple_background': 'bg-purple-100',\n        'pink_background': 'bg-pink-100',\n        'red_background': 'bg-red-100',\n      };\n\n      return colorMap[color] || '';\n    }\n\n### 3\\. Update GlimpseView Component\n\nModify `/frontend/components/GlimpseView.tsx`:\n\n    // Add import\n    import React, { useState } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n    import { NotionRenderer } from \"./NotionRenderer.tsx\";\n\n    // Add state to component\n    export function GlimpseView({ data, userEmail }: GlimpseViewProps) {\n      const [showDebug, setShowDebug] = useState(false);\n\n    // Replace main content section\n            \n              \n                {/* Debug toggle */}\n                \n                   setShowDebug(!showDebug)}\n                    className=\"px-3 py-1 text-sm bg-gray-100 hover:bg-gray-200 rounded border\"\n                  >\n                    {showDebug ? 'Hide' : 'Show'} Raw JSON\n                  \n                
\n\n                {showDebug ? (\n                  \n                    Raw Glimpse Data
\n                    \n                      {JSON.stringify(data, null, 2)}\n                    
\n                  
\n                ) : (\n                  \n                )}\n              
\n            
\n\n### 4\\. Update Documentation\n\nUpdate `/frontend/README.md` to document the new HTML rendering functionality and supported block types.\n\n## Critical Implementation Notes\n\n1.  **Data Structure**: The service returns item.blocks.results which the controller assigns to blocks property, so the frontend receives glimpseContent[].blocks as a direct array (not nested under a results property)\"\n2.  **Callout Children**: Must render children INSIDE the callout container, not after it\n3.  **Icon Handling**: Support emoji, external, and file icon types for callouts\n4.  **Property Filtering**: Only show \"Name\" property for main page, no properties for content pages\n5.  **Rich Text**: Handle all formatting (bold, italic, colors, links) and nested structures\n6.  **Error Handling**: Provide fallbacks for missing data and unsupported block types\n7.  **List Context**: Pass `listContext` parameter to BlockRenderer for proper list item rendering\n8.  **List Formatting**: Use `listStylePosition: 'outside'` to prevent line breaks after numbers/bullets\n9.  **Nested List Rendering**: List item content must render as React Fragments (`<>`) when inside grouped lists to avoid block-level line breaks\n10. **List Grouping**: Consecutive list items must be grouped into proper `` and `` elements for correct browser numbering\n11. **Nested List Helpers**: Use `NestedBlockRenderer` component for handling nested lists within list items\n12. **Browser-Native Numbering**: Leverage browser's automatic list numbering with semantic HTML elements\n\n## Expected Result\n\n- `/glimpse/:id` renders formatted HTML instead of JSON\n- Debug toggle allows switching between HTML and JSON views\n- All major Notion block types render correctly with proper styling\n- Nested content (especially in callouts) is properly contained\n- Custom icons display correctly in callouts\n- Clean layout with minimal metadata display\n- Proper list numbering with browser-native `` and `` elements\n- No line breaks after list numbers or bullets\n- Correct nested list numbering (nested lists start from 1)\n- Proper indentation for nested lists\n",[],[153,261],{"_102":268,"_95":269,"_154":270,"_156":155,"_157":136,"_158":159,"_160":161,"_104":271,"_99":32,"_163":175,"_165":272,"_166":22,"_167":-5,"_168":273,"_98":274},"92bea1ce-89bd-11f0-80ae-0224a6c84d84","12-embed.md","01991600-cca1-769d-8b8b-0cbebe98f0a4",["D",1757010775113],"# Complete Instructions for Implementing PDF Embed Handling in BlockRenderer.tsx\n\n## Objective\n\nUpdate the `embed` case in `/frontend/components/BlockRenderer.tsx` to handle PDF embeds from `glance-pdf-embed.val.run` with special rendering while maintaining fallback for other embed types.\n\n## Exact Implementation Steps\n\n1.  **Locate the target code**: Find the `case 'embed':` block in the switch statement (around lines 333-343)\n2.  **Replace the entire case block** with this exact code:\n\n    case 'embed':\n    const url = blockData?.url || '';\n\n    // handle the special case of the PDF embed, which rewrites the placeholder embed as a PDF link\n    // note that the slug below builds a link to the PDF at /demo/:id/pdf\n    // and has the Glance className to render it in the Glance PDF viewer: a.pdf\n    if (url.includes(\"glance-pdf-embed.val.run\")) {\n    const slug = [location.pathname, \"pdf\"].join(\"/\");\n    return (\n    \n    \n    Try the PDF viewer\n    \n    
\n    );\n    }\n\n    return (\n    \n    \n    \n    Embedded content: {url}\n    
\n    
\n    {renderChildren()}\n    
\n    );\n\n## Key Requirements\n\n- **Preserve existing classes**: Must include `pdf pdf-download-btn` classes\n- **URL detection**: Check if `url.includes(\"glance-pdf-embed.val.run\")`\n- **Dynamic routing**: Build PDF link as `[location.pathname, \"pdf\"].join(\"/\")`\n- **Tailwind styling**: Use standard primary button classes with focus ring\n- **Fallback behavior**: Maintain existing generic embed rendering for non-PDF embeds\n- **Structure**: PDF case returns early, generic case handles `renderChildren()`\n\n## Expected Behavior\n\n- PDF embeds from `glance-pdf-embed.val.run` render as blue button linking to `/current-path/pdf`\n- All other embeds render with existing gray box + link display\n- Button has proper hover and focus states for accessibility\n- Existing functionality dependent on `pdf pdf-download-btn` classes preserved\n",[],[153,269],[153],{"_102":277,"_95":278,"_154":279,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":280,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":281,"_98":527},"92bf016e-89bd-11f0-80ae-0224a6c84d84","backend","01991600-cca2-73b9-852e-854f55617580",["D",1757010775113],[282,330,344,470,492,506,520],{"_102":283,"_95":284,"_154":285,"_156":279,"_157":136,"_158":159,"_160":161,"_104":286,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":287,"_98":329},"92beb268-89bd-11f0-80ae-0224a6c84d84","controllers","01991600-cca2-73b9-852e-162c9bcc606f",["D",1757010775113],[288,296,305,313,321],{"_102":289,"_95":290,"_154":291,"_156":285,"_157":136,"_158":135,"_160":161,"_104":292,"_99":141,"_163":175,"_165":293,"_166":22,"_167":-5,"_168":294,"_98":295},"4ae35e48-8a90-11f0-91d1-0224a6c84d84","README.md","01991600-cca1-769d-8b8b-178e90b2d351",["D",1757101278463],"# Controllers\n\nBusiness logic coordination between routes and services.\n\n## Separation of Concerns\n\nControllers are the **business logic layer** that:\n- Orchestrate multiple service calls and coordinate data flow\n- Handle environment variables and application configuration\n- Implement business rules, validation, and data transformation\n- Convert between external API formats and application data models\n- Return structured data objects (not HTTP responses)\n- Provide consistent success/error response structure\n\nControllers do NOT:\n- Handle HTTP request/response objects (except for specific patterns)\n- Make direct external API calls (use services instead)\n- Contain presentation logic or HTML generation (except auth flows)\n\n## Standard Response Structure\n\nAll controller functions return:\n```typescript\n{\n  success: boolean,\n  data: any | null,\n  error: string | null,\n  details?: string  // Additional error context when available\n}\n```\n\n## Controller Patterns\n\n### 1. Data Controller Pattern (Recommended)\n\n**When to use**: Most API endpoints, business logic that can be tested independently\n\n**Characteristics**:\n- Accept simple parameters (strings, numbers, objects)\n- Return structured data objects\n- Can be called from multiple contexts (HTTP, cron, etc.)\n- Easy to unit test\n\n**Data Flow**:\n```\nRoute → Controller → Service(s) → External API\nRoute ← Controller ← Service(s) ← External API\n```\n\n#### Example: `getDemoProperties(id: string)`\n\n**Input Data**:\n```typescript\nid: string  // Notion page UUID\n```\n\n**Processing**:\n1. Validates page ID is provided\n2. Calls `getPageById(id)` service\n3. Filters out button properties (business rule)\n4. Returns sanitized page data\n\n**Output Data**:\n```typescript\n{\n  success: true,\n  data: {\n    id: string,\n    properties: {\n      // All properties except type: \"button\"\n      [key: string]: NotionPropertyValue\n    },\n    parent: NotionParent,\n    // ... other page fields\n  },\n  error: null\n}\n```\n\n#### Example: `getDemoFull(id: string)`\n\n**Input Data**:\n```typescript\nid: string  // Notion page UUID\n```\n\n**Processing**:\n1. Validates page ID is provided\n2. Calls `getPageWithBlocks(id)` service (orchestrates page + blocks)\n3. Filters out button properties (business rule)\n4. Returns complete page with content\n\n**Output Data**:\n```typescript\n{\n  success: true,\n  data: {\n    // Page properties (filtered)\n    id: string,\n    properties: { [key: string]: NotionPropertyValue },\n    // Block content (hierarchical)\n    blocks: NotionBlock[],\n    // ... other page fields\n  },\n  error: null\n}\n```\n\n### 2. HTTP Handler Pattern (Use Sparingly)\n\n**When to use**: Authentication flows, webhooks, redirects, HTML responses\n\n**Characteristics**:\n- Accept Hono Context objects\n- Return HTTP Response objects directly\n- Handle HTTP-specific concerns (headers, redirects, HTML)\n- Cannot be easily unit tested or reused\n\n#### Example: `handleUrlWebhook(c: Context)`\n\n**Input Data**:\n```typescript\n// HTTP Request Body (JSON)\n{\n  data?: { id: string },\n  id?: string,\n  page_id?: string\n}\n\n// HTTP Headers\n{\n  host: string  // Used to construct glimpse URL\n}\n```\n\n**Processing**:\n1. Extracts page ID from multiple possible webhook payload structures\n2. Extracts host header to construct glimpse URL\n3. Calls `updatePageUrl(pageId, glimpseUrl)` service\n4. Returns HTTP JSON response with operation status\n\n**Output Data**:\n```typescript\n// HTTP Response (JSON)\n{\n  success: true,\n  message: \"Page URL updated successfully\",\n  pageId: string,\n  url: string,  // The constructed glimpse URL\n  timestamp: string\n}\n```\n\n#### Example: `glimpseLoginHandler(c: Context)`\n\n**Input Data**:\n```typescript\n// From Auth Middleware Context\nuserEmail: string\n\n// From Environment Variables\nGLANCE_DEMOS_DB_ID: string\n```\n\n**Processing**:\n1. Extracts user email from authentication context\n2. Queries user database using `findUserByEmail(databaseId, email)`\n3. If user not found, creates new record with `createUserRecord(databaseId, email)`\n4. If user found, extracts URL from various property types\n5. Validates URL format and redirects\n\n**Output Data**:\n- **Success**: HTTP redirect to user's personalized URL\n- **New User**: HTTP redirect to `/glimpse/thanks`\n- **Error**: HTML error page or JSON error response\n\n**User Record Data Structure**:\n```typescript\n// Expected in Notion database\n{\n  Email: {\n    type: \"email\",\n    email: string\n  },\n  URL?: {\n    type: \"url\",\n    url: string\n  } | {\n    type: \"rich_text\",\n    rich_text: [{ plain_text: string }]\n  }\n}\n```\n\n#### Example: `glimpseThanksHandler(c: Context)`\n\n**Input Data**:\n```typescript\n// From Auth Middleware Context\nuserEmail: string\n```\n\n**Processing**:\n1. Validates user is authenticated\n2. Generates welcome HTML page with user email\n3. Provides next steps and expectations\n\n**Output Data**:\n- **Success**: HTML welcome page\n- **Unauthenticated**: HTTP redirect to `/`\n\n## Error Handling Patterns\n\n### Data Controller Errors\n```typescript\n{\n  success: false,\n  error: \"User-friendly error message\",\n  details: \"Technical error details from service\",\n  data: null\n}\n```\n\n### HTTP Handler Errors\n- **User-facing errors**: HTML error pages with styling\n- **Technical errors**: JSON responses with debugging information\n- **Authentication errors**: Redirects to login pages\n\n## Business Logic Examples\n\n### Data Filtering\n- Remove sensitive properties (button types) from Notion responses\n- Transform external API formats to application models\n\n### User Management\n- Automatic user creation for new email addresses\n- Multi-property URL extraction with fallback logic\n- URL validation and format checking\n\n### Webhook Processing\n- Flexible payload parsing for different webhook formats\n- Dynamic URL construction based on request context\n- Comprehensive error logging and debugging\n\n### Environment Configuration\n- Database ID management from environment variables\n- API key handling (delegated to services)\n- Feature flag and configuration management",[],[278,284,290],{"_102":297,"_95":298,"_154":299,"_156":285,"_157":136,"_158":135,"_160":161,"_104":300,"_99":32,"_163":301,"_165":302,"_166":22,"_167":-5,"_168":303,"_98":304},"4ae342f0-8a90-11f0-91d1-0224a6c84d84","demo.controller.ts","4ae343cc-8a90-11f0-91d1-0224a6c84d84",["D",1757101278463],"script","import { getPageById, getPageWithBlocks } from \"../services/notion.service.ts\";\n\n// Controller function - returns plain data, no HTTP concerns\nexport async function getDemoProperties(id: string) {\n  if (!id) {\n    return {\n      success: false,\n      error: \"Page ID is required\",\n      data: null\n    };\n  }\n\n  const result = await getPageById(id);\n\n  if (!result.success) {\n    return {\n      success: false,\n      error: \"Failed to fetch page data\",\n      details: result.error,\n      data: null\n    };\n  }\n\n  // Filter out button properties from the response\n  if (result.data?.properties) {\n    const filteredProperties = Object.fromEntries(\n      Object.entries(result.data.properties).filter(([key, value]) => value?.type !== \"button\")\n    );\n\n    result.data.properties = filteredProperties;\n  }\n\n  return {\n    success: true,\n    data: result.data,\n    error: null\n  };\n}\n\n// Controller function - returns plain data, no HTTP concerns\nexport async function getDemoFull(id: string) {\n  if (!id) {\n    return {\n      success: false,\n      error: \"Page ID is required\",\n      data: null\n    };\n  }\n\n  const result = await getPageWithBlocks(id);\n\n  if (!result.success) {\n    return {\n      success: false,\n      error: \"Failed to fetch page data\",\n      details: result.error,\n      data: null\n    };\n  }\n\n  // Filter out button properties from the response\n  if (result.data?.properties) {\n    const filteredProperties = Object.fromEntries(\n      Object.entries(result.data.properties).filter(([key, value]) => value?.type !== \"button\")\n    );\n\n    result.data.properties = filteredProperties;\n  }\n\n  return {\n    success: true,\n    data: result.data,\n    error: null\n  };\n}",[],[278,284,298],{"_102":306,"_95":307,"_154":308,"_156":285,"_157":136,"_158":135,"_160":161,"_104":309,"_99":141,"_163":301,"_165":310,"_166":22,"_167":-5,"_168":311,"_98":312},"4ae364f6-8a90-11f0-91d1-0224a6c84d84","glimpse.controller.ts","01991600-cca1-769d-8b8b-1a6cfcc4be6c",["D",1757101278463],"import { Context } from \"npm:hono@3.12.12\";\nimport {\n  createUserRecord,\n  findUserByEmail,\n} from \"../services/notion.service.ts\";\n\nexport async function glimpseLoginHandler(c: Context) {\n  // Extract user email from context (set by authCheck middleware)\n  const userEmail = c.get(\"userEmail\");\n\n  if (!userEmail) {\n    return c.json({ error: \"User email not found in context\" }, 401);\n  }\n\n  // Get the Glance Demos database ID from environment\n  const databaseId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n\n  if (!databaseId) {\n    return c.json({\n      error: \"Database configuration missing\",\n      details: \"GLANCE_DEMOS_DB_ID environment variable not set\",\n      userEmail: userEmail,\n    }, 500);\n  }\n\n  try {\n    // Find user by email in the database\n    const result = await findUserByEmail(databaseId, userEmail);\n\n    if (!result.success) {\n      return c.json({\n        error: \"Failed to query user database\",\n        details: result.error,\n        userEmail: userEmail,\n        databaseId: databaseId,\n      }, 500);\n    }\n\n    // Check if user was found\n    if (!result.data.results || result.data.results.length === 0) {\n      // User not found - create new user record\n      console.log(`Creating new user record for: ${userEmail}`);\n\n      const createResult = await createUserRecord(databaseId, userEmail);\n\n      if (!createResult.success) {\n        // If user creation fails, fall back to access denied with debugging info\n        return c.html(`\n          \n          \n          \n            Access Denied - Glance Demos\n            \n            \n          \n          \n            \n              🚫 Access Denied
\n              Your email address is not authorized and we were unable to create your account automatically.
\n              ${userEmail}
\n              \n                Technical Details:
\n                Failed to create user record: ${createResult.error}\n              
\n              Please contact your administrator for manual account setup.
\n              ← Back to Dashboard\n            
\n          \n          \n        `);\n      }\n\n      // User creation successful - redirect to thanks page\n      console.log(`Successfully created user record for: ${userEmail}`);\n      return c.redirect(\"/glimpse/thanks\");\n    }\n\n    // User found - extract URL from the first result\n    const userRecord = result.data.results[0];\n    const properties = userRecord.properties;\n\n    // Try to find URL property - check common property names and types\n    let redirectUrl = null;\n    let urlPropertyName = null;\n    let urlPropertyType = null;\n    let debugInfo = {};\n\n    // Common URL property names to check\n    const urlPropertyNames = [\n      \"URL\",\n      \"Link\",\n      \"Redirect URL\",\n      \"Demo URL\",\n      \"url\",\n      \"link\",\n    ];\n\n    for (const propName of urlPropertyNames) {\n      if (properties[propName]) {\n        const prop = properties[propName];\n        urlPropertyName = propName;\n        urlPropertyType = prop.type;\n        debugInfo[propName] = prop;\n\n        // Extract URL based on property type\n        if (prop.type === \"url\" && prop.url) {\n          redirectUrl = prop.url;\n          break;\n        } else if (\n          prop.type === \"rich_text\" && prop.rich_text &&\n          prop.rich_text.length > 0\n        ) {\n          redirectUrl = prop.rich_text[0].plain_text;\n          break;\n        } else if (\n          prop.type === \"title\" && prop.title && prop.title.length > 0\n        ) {\n          redirectUrl = prop.title[0].plain_text;\n          break;\n        }\n      }\n    }\n\n    // If no URL found or URL is empty/invalid\n    if (!redirectUrl || redirectUrl.trim() === \"\") {\n      return c.json({\n        error: \"No valid URL found for user\",\n        details: \"User record exists but no valid URL property found\",\n        userEmail: userEmail,\n        urlPropertyName: urlPropertyName,\n        urlPropertyType: urlPropertyType,\n        availableProperties: Object.keys(properties),\n        debugInfo: debugInfo,\n        userRecord: userRecord,\n      }, 400);\n    }\n\n    // Validate URL format\n    try {\n      new URL(redirectUrl);\n    } catch (urlError) {\n      return c.json({\n        error: \"Invalid URL format\",\n        details: `URL \"${redirectUrl}\" is not a valid URL`,\n        userEmail: userEmail,\n        urlPropertyName: urlPropertyName,\n        urlPropertyType: urlPropertyType,\n        redirectUrl: redirectUrl,\n      }, 400);\n    }\n\n    // Success - redirect to the user's URL\n    return c.redirect(redirectUrl);\n  } catch (error) {\n    return c.json({\n      error: \"Unexpected error during login process\",\n      details: error.message,\n      userEmail: userEmail,\n      databaseId: databaseId,\n    }, 500);\n  }\n}\n\nexport async function glimpseThanksHandler(c: Context) {\n  // Extract user email from context (set by authCheck middleware)\n  const userEmail = c.get(\"userEmail\");\n\n  if (!userEmail) {\n    // If no email in context, redirect to login\n    return c.redirect(\"/\");\n  }\n\n  return c.html(`\n    \n    \n    \n      Welcome to Glance Demos\n      \n      \n    \n    \n      \n        🎉 Welcome to Glance Demos!
\n        Thank you for signing up! Your account has been created successfully.
\n        ${userEmail}
\n        \n        \n          What happens next?
\n          \n            Our team will review your registration
\n            You'll receive an email with your personalized demo link
\n            This usually takes 1-2 business days
\n            Once ready, you can return to this login page to access your demo
\n          
\n        
\n        \n        If you have any questions or don't receive your email within 2 business days, please contact our support team.
\n        ← Back to Dashboard\n      
\n    \n    \n  `);\n}",[],[278,284,307],{"_102":314,"_95":315,"_154":316,"_156":285,"_157":136,"_158":159,"_160":161,"_104":317,"_99":32,"_163":301,"_165":318,"_166":22,"_167":-5,"_168":319,"_98":320},"92beab42-89bd-11f0-80ae-0224a6c84d84","health.controller.ts","01991600-cca2-73b9-852e-0dc2109262b3",["D",1757010775113],"import { getDatabaseById } from \"../services/notion.service.ts\";\n\nexport async function getConfiguredDatabases() {\n  const demosDbId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n  const contentDbId = Deno.env.get(\"GLANCE_CONTENT_DB_ID\");\n  const interactionsDbId = Deno.env.get(\"GLANCE_INTERACTIONS_DB_ID\");\n\n  const databases = { demos: null, content: null, interactions: null };\n  const errors: string[] = [];\n\n  // Check demos database\n  if (demosDbId) {\n    const result = await getDatabaseById(demosDbId);\n    if (result.success) {\n      databases.demos = result.data;\n    } else {\n      errors.push(`Demos DB: ${result.error}`);\n    }\n  } else {\n    errors.push(\"GLANCE_DEMOS_DB_ID not configured\");\n  }\n\n  // Check content database\n  if (contentDbId) {\n    const result = await getDatabaseById(contentDbId);\n    if (result.success) {\n      databases.content = result.data;\n    } else {\n      errors.push(`Content DB: ${result.error}`);\n    }\n  } else {\n    errors.push(\"GLANCE_CONTENT_DB_ID not configured\");\n  }\n\n  // Check interactions database\n  if (interactionsDbId) {\n    const result = await getDatabaseById(interactionsDbId);\n    if (result.success) {\n      databases.interactions = result.data;\n    } else {\n      errors.push(`Interactions DB: ${result.error}`);\n    }\n  } else {\n    errors.push(\"GLANCE_INTERACTIONS_DB_ID not configured\");\n  }\n\n  return {\n    success: errors.length === 0,\n    data: databases,\n    errors: errors.length > 0 ? errors : undefined,\n    timestamp: new Date().toISOString(),\n  };\n}\n\nexport async function getHealthStatus() {\n  const databasesResult = await getConfiguredDatabases();\n  \n  const healthStatus = {\n    status: databasesResult.success ? \"ok\" : \"error\",\n    timestamp: new Date().toISOString(),\n    service: \"glance-demos\",\n    databases: {\n      configured: databasesResult.success,\n      demos: databasesResult.data.demos ? \"connected\" : \"error\",\n      content: databasesResult.data.content ? \"connected\" : \"error\", \n      interactions: databasesResult.data.interactions ? \"connected\" : \"error\"\n    }\n  };\n\n  if (databasesResult.errors) {\n    healthStatus.errors = databasesResult.errors;\n  }\n\n  return healthStatus;\n}",[],[278,284,315],{"_102":322,"_95":323,"_154":324,"_156":285,"_157":136,"_158":159,"_160":161,"_104":325,"_99":32,"_163":301,"_165":326,"_166":22,"_167":-5,"_168":327,"_98":328},"92beaf02-89bd-11f0-80ae-0224a6c84d84","tasks.controller.ts","01991600-cca2-73b9-852e-122bf7d74c5b",["D",1757010775113],"import { Context } from \"npm:hono@3.12.12\";\nimport { updatePageUrl } from \"../services/notion.service.ts\";\n\nexport async function handleUrlWebhook(c: Context) {\n  console.log(\"Processing URL update webhook request\");\n  \n  try {\n    const body = await c.req.json();\n    console.log(\"Notion webhook received:\", body);\n\n    // Extract page ID from multiple possible webhook payload structures\n    let pageId: string | undefined;\n    \n    if (body.data?.id) {\n      pageId = body.data.id;\n    } else if (body.id) {\n      pageId = body.id;\n    } else if (body.page_id) {\n      pageId = body.page_id;\n    }\n\n    if (!pageId) {\n      console.error(\"No page ID found in webhook payload:\", body);\n      return c.json({ \n        success: false, \n        error: \"Page ID is required in webhook payload\" \n      }, 400);\n    }\n\n    // Extract host from request headers to construct glimpse URL\n    const host = c.req.header(\"host\");\n    if (!host) {\n      console.error(\"No host header found in request\");\n      return c.json({ \n        success: false, \n        error: \"Host header is required\" \n      }, 400);\n    }\n\n    const glimpseUrl = `https://${host}/glimpse/${pageId}`;\n    console.log(`Constructed glimpse URL: ${glimpseUrl} for page ID: ${pageId}`);\n\n    // Update the Notion page with the glimpse URL\n    const result = await updatePageUrl(pageId, glimpseUrl);\n\n    if (!result.success) {\n      console.error(\"Failed to update Notion page:\", result.error);\n      return c.json({ \n        success: false, \n        error: \"Failed to update Notion page with URL\", \n        details: result.error \n      }, 500);\n    }\n\n    console.log(\"Successfully updated Notion page with glimpse URL:\", { pageId, url: glimpseUrl });\n\n    return c.json({\n      success: true,\n      message: \"Page URL updated successfully\",\n      pageId: pageId,\n      url: glimpseUrl,\n      timestamp: new Date().toISOString()\n    });\n\n  } catch (error) {\n    console.error(\"Error processing URL webhook:\", error);\n    return c.json({ \n      success: false, \n      error: \"Internal server error processing webhook\", \n      details: error.message \n    }, 500);\n  }\n}",[],[278,284,323],[278,284],{"_102":331,"_95":332,"_154":333,"_156":279,"_157":136,"_158":159,"_160":161,"_104":334,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":335,"_98":343},"92beb5c4-89bd-11f0-80ae-0224a6c84d84","crons","01991600-cca2-73b9-852e-1efbd3b5d693",["D",1757010775113],[336],{"_102":337,"_95":290,"_154":338,"_156":333,"_157":136,"_158":159,"_160":161,"_104":339,"_99":32,"_163":175,"_165":340,"_166":22,"_167":-5,"_168":341,"_98":342},"92beb43e-89bd-11f0-80ae-0224a6c84d84","01991600-cca2-73b9-852e-181113757720",["D",1757010775113],"# Crons\n\nScheduled task handlers.",[],[278,332,290],[278,332],{"_102":345,"_95":346,"_154":347,"_156":279,"_157":136,"_158":159,"_160":161,"_104":348,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":349,"_98":469},"92bef0e8-89bd-11f0-80ae-0224a6c84d84","routes","01991600-cca2-73b9-852e-61a4e0e56976",["D",1757010775113],[350,372,394,416,446,453,461],{"_102":351,"_95":352,"_154":353,"_156":347,"_157":136,"_158":159,"_160":161,"_104":354,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":355,"_98":371},"92beba9c-89bd-11f0-80ae-0224a6c84d84","api","01991600-cca2-73b9-852e-28d716da6245",["D",1757010775113],[356,363],{"_102":357,"_95":290,"_154":358,"_156":353,"_157":136,"_158":135,"_160":161,"_104":359,"_99":159,"_163":175,"_165":360,"_166":22,"_167":-5,"_168":361,"_98":362},"4ae3750e-8a90-11f0-91d1-0224a6c84d84","01991600-cca2-73b9-852e-205d05721009",["D",1757101278463],"# API Routes\n\nJSON API endpoints for frontend/backend communication.\n\n## Separation of Concerns\n\nAPI routes handle:\n- JSON request/response formatting\n- HTTP status code management\n- Parameter extraction from URLs\n- Error response standardization\n\nAPI routes delegate business logic to controllers and return clean JSON responses.\n\n## Endpoints\n\n### GET /api/health\n\n**Purpose**: System health check endpoint\n\n**Input Data**: None\n\n**Output Data**:\n```typescript\n{\n  status: \"healthy\" | \"unhealthy\",\n  timestamp: string,\n  // Additional health metrics from controller\n}\n```\n\n**HTTP Status**: Always 200\n\n### GET /api/demo/:id/properties\n\n**Purpose**: Get Notion page properties (filtered for UI consumption)\n\n**Input Data**:\n```typescript\n// URL Parameters\n{\n  id: string  // Notion page UUID\n}\n```\n\n**Processing Flow**:\n1. Extract page ID from URL parameter\n2. Call `getDemoProperties(id)` controller\n3. Return filtered page properties or error\n\n**Success Response (200)**:\n```typescript\n{\n  id: string,\n  properties: {\n    // All properties except type: \"button\"\n    [propertyName: string]: {\n      type: \"title\" | \"rich_text\" | \"number\" | \"select\" | \"multi_select\" | \"date\" | \"checkbox\" | \"url\" | \"email\" | \"phone_number\" | \"formula\" | \"relation\" | \"rollup\" | \"created_time\" | \"created_by\" | \"last_edited_time\" | \"last_edited_by\",\n      // Property-specific value structure\n    }\n  },\n  parent: {\n    type: \"database_id\" | \"page_id\",\n    database_id?: string,\n    page_id?: string\n  },\n  created_time: string,\n  last_edited_time: string,\n  // ... other Notion page fields\n}\n```\n\n**Error Responses**:\n```typescript\n// 400 - Invalid Request\n{\n  error: \"Page ID is required\",\n  details?: string\n}\n\n// 500 - Server Error\n{\n  error: \"Failed to fetch page data\",\n  details: \"Notion API error message\"\n}\n```\n\n### GET /api/demo/:id\n\n**Purpose**: Get complete Notion page with content blocks\n\n**Input Data**:\n```typescript\n// URL Parameters\n{\n  id: string  // Notion page UUID\n}\n```\n\n**Processing Flow**:\n1. Extract page ID from URL parameter\n2. Call `getDemoFull(id)` controller\n3. Return complete page with blocks or error\n\n**Success Response (200)**:\n```typescript\n{\n  // Page properties (same as /properties endpoint)\n  id: string,\n  properties: { [key: string]: NotionPropertyValue },\n  parent: NotionParent,\n  created_time: string,\n  last_edited_time: string,\n  \n  // Block content (hierarchical structure)\n  blocks: [\n    {\n      id: string,\n      type: \"paragraph\" | \"heading_1\" | \"heading_2\" | \"heading_3\" | \"bulleted_list_item\" | \"numbered_list_item\" | \"to_do\" | \"toggle\" | \"child_page\" | \"child_database\" | \"embed\" | \"image\" | \"video\" | \"file\" | \"pdf\" | \"bookmark\" | \"callout\" | \"quote\" | \"equation\" | \"divider\" | \"table_of_contents\" | \"column\" | \"column_list\" | \"link_preview\" | \"synced_block\" | \"template\" | \"link_to_page\" | \"table\" | \"table_row\" | \"unsupported\",\n      created_time: string,\n      last_edited_time: string,\n      has_children: boolean,\n      children?: NotionBlock[], // Recursive structure for nested blocks\n      // Type-specific content\n      [blockType]: {\n        // Block-specific properties\n      }\n    }\n  ]\n}\n```\n\n**Error Responses**: Same as `/properties` endpoint\n\n## Error Handling Pattern\n\nAll API routes follow consistent error handling:\n\n```typescript\n// In route handler\nconst result = await controllerFunction(params);\n\nif (!result.success) {\n  return c.json({ \n    error: result.error, \n    details: result.details \n  }, result.error === \"Page ID is required\" ? 400 : 500);\n}\n\nreturn c.json(result.data);\n```\n\n## Data Filtering\n\nAPI routes return filtered data for UI consumption:\n- **Button properties removed**: Notion button properties are filtered out to prevent UI confusion\n- **Raw Notion format**: Other properties maintain their original Notion API structure\n- **Complete hierarchy**: Block content includes full nested structure with children\n\n## Usage Examples\n\n```bash\n# Get page properties only\ncurl https://your-val.web.val.run/api/demo/abc123/properties\n\n# Get complete page with content\ncurl https://your-val.web.val.run/api/demo/abc123\n\n# Health check\ncurl https://your-val.web.val.run/api/health\n```",[],[278,346,352,290],{"_102":364,"_95":365,"_154":366,"_156":353,"_157":136,"_158":135,"_160":161,"_104":367,"_99":159,"_163":301,"_165":368,"_166":22,"_167":-5,"_168":369,"_98":370},"4ae37c7a-8a90-11f0-91d1-0224a6c84d84","_api.routes.ts","01991600-cca2-73b9-852e-27eb2223c9bc",["D",1757101278463],"import { Hono } from \"npm:hono@3.12.12\";\nimport { getHealthStatus } from \"../../controllers/health.controller.ts\";\nimport { getDemoProperties, getDemoFull } from \"../../controllers/demo.controller.ts\";\n\nconst app = new Hono();\n\napp.get(\"/health\", async (c) => {\n  const healthStatus = await getHealthStatus();\n  return c.json(healthStatus);\n});\n\n// Demo endpoints - routes handle HTTP concerns, controllers return data\napp.get(\"/demo/:id/properties\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getDemoProperties(id);\n  \n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, result.error === \"Page ID is required\" ? 400 : 500);\n  }\n  \n  return c.json(result.data);\n});\n\napp.get(\"/demo/:id\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getDemoFull(id);\n  \n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, result.error === \"Page ID is required\" ? 400 : 500);\n  }\n  \n  return c.json(result.data);\n});\n\nexport default app;",[],[278,346,352,365],[278,346,352],{"_102":373,"_95":374,"_154":375,"_156":347,"_157":136,"_158":159,"_160":161,"_104":376,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":377,"_98":393},"92bec5dc-89bd-11f0-80ae-0224a6c84d84","glimpse","01991600-cca2-73b9-852e-35fabeb7cc6a",["D",1757010775113],[378,385],{"_102":379,"_95":290,"_154":380,"_156":375,"_157":136,"_158":141,"_160":161,"_104":381,"_99":159,"_163":175,"_165":382,"_166":22,"_167":-5,"_168":383,"_98":384},"666f5232-8a56-11f0-9a0a-0224a6c84d84","01991600-cca2-73b9-852e-2e28d79597b9",["D",1757076413869],"# Glimpse Routes\n\nThis module provides shortcut routes for accessing glimpse functionality and user authentication.\n\n## Routes\n\n- **GET** `/login` - User-specific login redirect with auto-registration\n- **GET** `/thanks` - New user welcome page\n- **GET** `/:id` - Get page data by ID (equivalent to `/views/glimpse/:id`)\n\n## Authentication\n\n- Requires user authentication via `authCheck` middleware\n- Same authentication requirements as the original `/views/glimpse/:id` route\n\n## Login Route (`/login`)\n\n### Purpose\nProvides personalized redirect functionality for authenticated users with automatic user registration.\n\n### Flow\n1. User must be authenticated (Google OAuth via LastLogin)\n2. System extracts user's email from authentication context\n3. Queries `GLANCE_DEMOS_DB_ID` database for user's record\n4. **If user found**: Extracts redirect URL and redirects to personal URL\n5. **If user not found**: Creates new user record and redirects to `/thanks`\n\n### Database Requirements\nThe `GLANCE_DEMOS_DB_ID` database must contain:\n- **Email property**: User's email address (exact match with authenticated email)\n- **URL property**: User's redirect URL (optional for new users)\n\n### Supported URL Properties\n- **Property names**: `URL`, `Link`, `Redirect URL`, `Demo URL`, `url`, `link`\n- **Property types**: `url`, `rich_text`, `title`\n\n### Error Handling\n- **User creation fails**: Shows access denied HTML page with technical details\n- **Missing URL**: Returns JSON error with debugging information\n- **Invalid URL**: Returns JSON error with validation details\n- **Database errors**: Returns JSON error with technical details\n\n### Environment Variables\n- `GLANCE_DEMOS_DB_ID` - Required Notion database ID for user lookup\n\n## Thanks Route (`/thanks`)\n\n### Purpose\nWelcome page for newly registered users explaining next steps.\n\n### Features\n- Confirms successful account creation\n- Shows user's registered email address\n- Explains admin review process\n- Provides timeline expectations (1-2 business days)\n- Includes support contact information\n\n### Access\n- Requires authentication (redirects to dashboard if not authenticated)\n- Typically accessed via redirect from `/login` after user creation\n\n## Data Route (`/:id`)\n\n### Parameters\n- `id` (string, required) - The Notion page ID to retrieve\n\n### Response\nReturns JSON response with page data from Notion API, with button properties filtered out.\n\n## Usage\n\nThis module provides multiple access patterns:\n- **Auto-registration**: `/glimpse/login` - Personalized user redirect with automatic signup\n- **Welcome flow**: `/glimpse/thanks` - New user onboarding\n- **Data access**: `/glimpse/{page-id}` - Shortcut to `/views/glimpse/{page-id}`\n\nThe login route transforms the user experience from \"access denied\" to \"welcome, you're registered\" for new users.",[],[278,346,374,290],{"_102":386,"_95":387,"_154":388,"_156":375,"_157":136,"_158":135,"_160":161,"_104":389,"_99":141,"_163":301,"_165":390,"_166":22,"_167":-5,"_168":391,"_98":392},"4ae385da-8a90-11f0-91d1-0224a6c84d84","_glimpse.routes.ts","01991600-cca2-73b9-852e-31c669640734",["D",1757101278463],"import { Hono } from \"npm:hono@3.12.12\";\nimport { glimpseLoginHandler, glimpseThanksHandler } from \"../../controllers/glimpse.controller.ts\";\nimport { getDemoFull } from \"../../controllers/demo.controller.ts\";\n\nconst app = new Hono();\n\n// Static routes must come BEFORE the parameterized route\napp.get(\"/login\", glimpseLoginHandler);\napp.get(\"/thanks\", glimpseThanksHandler);\napp.get(\"/:id\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getDemoFull(id);\n  \n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, result.error === \"Page ID is required\" ? 400 : 500);\n  }\n  \n  return c.json(result.data);\n});\n\nexport default app;",[],[278,346,374,387],[278,346,374],{"_102":395,"_95":396,"_154":397,"_156":347,"_157":136,"_158":159,"_160":161,"_104":398,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":399,"_98":415},"92becc8a-89bd-11f0-80ae-0224a6c84d84","tasks","01991600-cca2-73b9-852e-40b0c0c5e091",["D",1757010775113],[400,407],{"_102":401,"_95":290,"_154":402,"_156":397,"_157":136,"_158":159,"_160":161,"_104":403,"_99":32,"_163":175,"_165":404,"_166":22,"_167":-5,"_168":405,"_98":406},"92bec79e-89bd-11f0-80ae-0224a6c84d84","01991600-cca2-73b9-852e-394afffd3da1",["D",1757010775113],"# Task Routes\n\nWebhook handlers for Notion integrations.\n\n## Endpoints\n\n### POST /tasks/url\n\nUpdates a Notion page's URL property with a glimpse URL.\n\n**Authentication:** Requires `X-API-KEY` header with `NOTION_WEBHOOK_SECRET` value.\n\n**Request Body:**\n```json\n{\n  \"data\": { \"id\": \"page-id-here\" }\n}\n```\n\nAlternative payload structures supported:\n```json\n{ \"id\": \"page-id-here\" }\n```\n```json\n{ \"page_id\": \"page-id-here\" }\n```\n\n**Success Response (200):**\n```json\n{\n  \"success\": true,\n  \"message\": \"Page URL updated successfully\",\n  \"pageId\": \"page-id-here\",\n  \"url\": \"https://your-domain.com/glimpse/page-id-here\",\n  \"timestamp\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n**Error Responses:**\n\n400 - Missing page ID:\n```json\n{\n  \"success\": false,\n  \"error\": \"Page ID is required in webhook payload\"\n}\n```\n\n400 - Missing host header:\n```json\n{\n  \"success\": false,\n  \"error\": \"Host header is required\"\n}\n```\n\n500 - Notion API error:\n```json\n{\n  \"success\": false,\n  \"error\": \"Failed to update Notion page with URL\",\n  \"details\": \"Notion API error message\"\n}\n```\n\n**Testing:**\n```bash\ncurl -X POST https://your-val.web.val.run/tasks/url \\\n  -H \"X-API-KEY: your-notion-webhook-secret\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"data\": {\"id\": \"your-page-id\"}}'\n```\n\n### POST /tasks/notion-webhook\n\nMain webhook endpoint for Notion integrations.\n\n**Authentication:** Requires `X-API-KEY` header with `NOTION_WEBHOOK_SECRET` value.\n\n### POST /tasks/test\n\nTest endpoint for webhook authentication.\n\n**Authentication:** Requires `X-API-KEY` header with `NOTION_WEBHOOK_SECRET` value.\n\n**Success Response (200):**\n```json\n{\n  \"success\": true,\n  \"message\": \"Webhook authentication successful\",\n  \"timestamp\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n### GET /tasks/debug-webhook\n\nDebug endpoint to check webhook configuration.\n\n**No authentication required.**\n\n**Response:**\n```json\n{\n  \"hasSecret\": true,\n  \"secretLength\": 32\n}\n```",[],[278,346,396,290],{"_102":408,"_95":409,"_154":410,"_156":397,"_157":136,"_158":159,"_160":161,"_104":411,"_99":32,"_163":301,"_165":412,"_166":22,"_167":-5,"_168":413,"_98":414},"92becad2-89bd-11f0-80ae-0224a6c84d84","_tasks.routes.ts","01991600-cca2-73b9-852e-3ca0c39f26a6",["D",1757010775113],"import { Hono } from \"npm:hono@3.12.12\";\nimport { handleUrlWebhook } from \"../../controllers/tasks.controller.ts\";\n\nconst app = new Hono();\n\n// Debug endpoint to check webhook configuration\napp.get(\"/debug-webhook\", (c) => {\n  const secret = Deno.env.get(\"NOTION_WEBHOOK_SECRET\");\n  return c.json({\n    hasSecret: !!secret,\n    secretLength: secret?.length || 0,\n  });\n});\n\n// Test endpoint for webhook authentication\napp.post(\"/test\", async (c) => {\n  // At this point, webhook auth has already passed\n  return c.json({ \n    success: true, \n    message: \"Webhook authentication successful\",\n    timestamp: new Date().toISOString()\n  });\n});\n\n// Main Notion webhook endpoint\napp.post(\"/notion-webhook\", async (c) => {\n  // At this point, webhook auth has already passed\n  const body = await c.req.json();\n  console.log(\"Notion webhook received:\", body);\n\n  // Process the webhook...\n  // TODO: Add actual webhook processing logic here\n\n  return c.json({ success: true });\n});\n\n// URL update webhook endpoint\napp.post(\"/url\", handleUrlWebhook);\n\n// Catch-all handler for undefined webhook endpoints\n// This must be the LAST route defined to catch unmatched paths\napp.post(\"*\", (c) => {\n  const path = c.req.path;\n  const method = c.req.method;\n  const returnObj = {\n    error: \"Endpoint not found\",\n    path: path,\n    method: method,\n    availableEndpoints: [\n      \"GET /tasks/debug-webhook\",\n      \"POST /tasks/test\",\n      \"POST /tasks/notion-webhook\",\n      \"POST /tasks/url\",\n    ],\n  };\n  console.log(returnObj);\n\n  return c.json(returnObj, 404);\n});\n\nexport default app;",[],[278,346,396,409],[278,346,396],{"_102":417,"_95":418,"_154":419,"_156":347,"_157":136,"_158":159,"_160":161,"_104":420,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":421,"_98":445},"92bee44a-89bd-11f0-80ae-0224a6c84d84","views","01991600-cca2-73b9-852e-53d666236ece",["D",1757010775113],[422,429,437],{"_102":423,"_95":290,"_154":424,"_156":419,"_157":136,"_158":135,"_160":161,"_104":425,"_99":159,"_163":175,"_165":426,"_166":22,"_167":-5,"_168":427,"_98":428},"4ae38710-8a90-11f0-91d1-0224a6c84d84","01991600-cca2-73b9-852e-464a6d93d68d",["D",1757101278463],"# View Routes\n\nServer-side rendered views and data endpoints for frontend consumption.\n\n## Separation of Concerns\n\nView routes handle:\n- Authentication-protected data access\n- JSON response formatting for authenticated users\n- Business logic delegation to controllers\n- Consistent error response formatting\n\n## Endpoints\n\n### GET /views/glimpse/:id\n\n**Purpose**: Get Notion page data for authenticated users (filtered for data consumption)\n\n**Authentication**: Required (Google OAuth via LastLogin)\n\n**Input Data**:\n```typescript\n// URL Parameters\n{\n  id: string  // Notion page UUID\n}\n\n// Authentication Context (from middleware)\n{\n  userEmail: string,\n  // Other auth context\n}\n```\n\n**Processing Flow**:\n1. Authentication middleware validates user\n2. Extract page ID from URL parameter\n3. Call `getDemoProperties(id)` controller\n4. Return filtered page data\n\n**Success Response (200)**:\n```typescript\n{\n  id: string,\n  properties: {\n    // All properties except type: \"button\" (UI filtering)\n    [propertyName: string]: {\n      type: \"title\" | \"rich_text\" | \"number\" | \"select\" | \"multi_select\" | \"date\" | \"checkbox\" | \"url\" | \"email\" | \"phone_number\" | \"formula\" | \"relation\" | \"rollup\" | \"created_time\" | \"created_by\" | \"last_edited_time\" | \"last_edited_by\",\n      // Property-specific value structure based on type\n      id: string,\n      // Type-specific content\n    }\n  },\n  parent: {\n    type: \"database_id\" | \"page_id\",\n    database_id?: string,\n    page_id?: string\n  },\n  created_time: string,\n  last_edited_time: string,\n  created_by: {\n    object: \"user\",\n    id: string\n  },\n  last_edited_by: {\n    object: \"user\",\n    id: string\n  },\n  cover: {\n    type: \"external\" | \"file\",\n    external?: { url: string },\n    file?: { url: string, expiry_time: string }\n  } | null,\n  icon: {\n    type: \"emoji\" | \"external\" | \"file\",\n    emoji?: string,\n    external?: { url: string },\n    file?: { url: string, expiry_time: string }\n  } | null,\n  archived: boolean,\n  url: string\n}\n```\n\n**Error Responses**:\n```typescript\n// 401 - Unauthorized (from auth middleware)\n{\n  error: \"Authentication required\"\n}\n\n// 400 - Invalid Request\n{\n  error: \"Page ID is required\",\n  details?: string\n}\n\n// 500 - Server Error\n{\n  error: \"Failed to fetch page data\",\n  details: \"Notion API error message\"\n}\n```\n\n## Data Filtering\n\nView routes apply business logic filtering:\n\n### Button Property Removal\n- **Purpose**: Remove UI-specific properties that shouldn't be displayed in data views\n- **Implementation**: Controller filters out all properties where `type === \"button\"`\n- **Reason**: Button properties are interactive elements in Notion, not data to be displayed\n\n### Property Type Examples\n```typescript\n// Filtered OUT (not included in response)\n{\n  \"Action Button\": {\n    \"type\": \"button\",\n    \"button\": {}\n  }\n}\n\n// Included in response\n{\n  \"Title\": {\n    \"type\": \"title\",\n    \"title\": [\n      {\n        \"type\": \"text\",\n        \"text\": { \"content\": \"Page Title\" },\n        \"plain_text\": \"Page Title\"\n      }\n    ]\n  },\n  \"Status\": {\n    \"type\": \"select\",\n    \"select\": {\n      \"id\": \"abc123\",\n      \"name\": \"Active\",\n      \"color\": \"green\"\n    }\n  },\n  \"URL\": {\n    \"type\": \"url\",\n    \"url\": \"https://example.com\"\n  }\n}\n```\n\n## Authentication Flow\n\n1. **Request arrives** at `/views/glimpse/:id`\n2. **Auth middleware** validates Google OAuth token\n3. **User context** is added to request (email, etc.)\n4. **Route handler** extracts page ID and calls controller\n5. **Controller** applies business logic and filtering\n6. **Response** returns filtered page data\n\n## Usage Examples\n\n```bash\n# Authenticated request (requires valid session)\ncurl -H \"Cookie: session=...\" https://your-val.web.val.run/views/glimpse/abc123\n\n# Response includes filtered properties\n{\n  \"id\": \"abc123\",\n  \"properties\": {\n    \"Title\": { \"type\": \"title\", \"title\": [...] },\n    \"Status\": { \"type\": \"select\", \"select\": {...} }\n    // Button properties excluded\n  }\n}\n```\n\n## Comparison with API Routes\n\n| Aspect | `/views/glimpse/:id` | `/api/demo/:id/properties` |\n|--------|---------------------|---------------------------|\n| Authentication | Required | Not required |\n| Data filtering | Button properties removed | Button properties removed |\n| Use case | Authenticated data access | Public demo access |\n| Response format | Same filtered structure | Same filtered structure |\n\nBoth endpoints use the same controller (`getDemoProperties`) but have different authentication requirements.",[],[278,346,418,290],{"_102":430,"_95":431,"_154":432,"_156":419,"_157":136,"_158":135,"_160":161,"_104":433,"_99":159,"_163":301,"_165":434,"_166":22,"_167":-5,"_168":435,"_98":436},"4ae38c38-8a90-11f0-91d1-0224a6c84d84","_views.routes.ts","01991600-cca2-73b9-852e-4b60360fb11c",["D",1757101278463],"import { Hono } from \"npm:hono@3.12.12\";\nimport { getDemoProperties, getDemoFull } from \"../../controllers/demo.controller.ts\";\n\nconst app = new Hono();\n\napp.get(\"/glimpse/:id\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getDemoFull(id);\n  \n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, result.error === \"Page ID is required\" ? 400 : 500);\n  }\n  \n  return c.json(result.data);\n});\n\n// Demo endpoints for internal use (no authentication required)\napp.get(\"/demo/:id/properties\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getDemoProperties(id);\n  \n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, result.error === \"Page ID is required\" ? 400 : 500);\n  }\n  \n  return c.json(result.data);\n});\n\napp.get(\"/demo/:id\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getDemoFull(id);\n  \n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, result.error === \"Page ID is required\" ? 400 : 500);\n  }\n  \n  return c.json(result.data);\n});\n\nexport default app;",[],[278,346,418,431],{"_102":438,"_95":439,"_154":440,"_156":419,"_157":136,"_158":135,"_160":161,"_104":441,"_99":159,"_163":301,"_165":442,"_166":22,"_167":-5,"_168":443,"_98":444},"4ae38d96-8a90-11f0-91d1-0224a6c84d84","dashboard.tsx","01991600-cca2-73b9-852e-4d40fd1ba621",["D",1757101278463],"import { getHealthStatus } from \"../../controllers/health.controller.ts\";\nimport { getDatabasePages } from \"../../services/notion.service.ts\";\n\nexport default async (c) => {\n  const userEmail = c.get(\"userEmail\");\n  \n  // Fetch health status for display\n  const healthData = await getHealthStatus();\n\n  // Fetch demo database pages for glimpse endpoints\n  const demoDatabaseId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n  let demoPages = [];\n  let demoPagesError = null;\n  \n  if (demoDatabaseId) {\n    const demoPagesResult = await getDatabasePages(demoDatabaseId);\n    if (demoPagesResult.success) {\n      demoPages = demoPagesResult.data.results || [];\n    } else {\n      demoPagesError = demoPagesResult.error;\n    }\n  }\n\n  // Check webhook configuration\n  const webhookSecret = Deno.env.get(\"NOTION_WEBHOOK_SECRET\");\n  const webhookConfigured = !!webhookSecret;\n  const webhookEndpoint = `${c.req.url.split('/')[0]}//${c.req.url.split('/')[2]}/tasks/notion-webhook`;\n\n  return c.html(`\n    \n    \n    \n      Glance Demos - Dashboard\n      \n      \n    \n    \n      \n        \n          Glance Demos Dashboard
\n          \n            Welcome, ${userEmail}\n            Logout\n          
\n        
\n        \n        \n          \n            Welcome to your dashboard!
\n            You are successfully authenticated and can access all features of the Glance Demos application.
\n          
\n          \n          \n            \n              System Health Status \n              \n                ${healthData.status}\n              \n            
\n            ${JSON.stringify(healthData, null, 2)}
\n          
\n\n          \n            🔍 Demo API Endpoints
\n            \n            ${demoDatabaseId ? `\n              ${demoPages.length > 0 ? `\n                Test the glimpse and demo endpoints with these demo pages:
\n                \n                  \n                    \n                      \n                      \n                      \n                      \n                    \n                  \n                  \n                    ${demoPages.map(page => {\n                      const pageTitle = page.properties?.Name?.title?.[0]?.plain_text || \n                                       page.properties?.Title?.title?.[0]?.plain_text || \n                                       'Untitled Page';\n                      const baseUrl = `${c.req.url.split('/')[0]}//${c.req.url.split('/')[2]}`;\n                      const glimpseUrl = `${baseUrl}/glimpse/${page.id}`;\n                      const demoPropertiesUrl = `${baseUrl}/api/demo/${page.id}/properties`;\n                      const demoFullUrl = `${baseUrl}/api/demo/${page.id}`;\n                      return `\n                        \n                          \n                          \n                          \n                          \n                        \n                      `;\n                    }).join('')}\n                  \n                Name Glimpse Demo Properties Demo Full
📄 ${pageTitle} \n                            /glimpse/${page.id}\n                          \n                            /api/demo/${page.id}/properties\n                          \n                            /api/demo/${page.id}\n                          
\n                \n                  📝 API Endpoint Notes:\n                  \n                    Glimpse: Returns complete page data with blocks (enhanced in latest update)
\n                    Demo Properties: Returns page properties only
\n                    Demo Full: Returns page properties + all blocks recursively (same as glimpse)
\n                    Authentication: Browser requests require login, internal Val requests bypass authentication
\n                    Architecture: Glimpse endpoints call demo controller methods directly for optimal performance
\n                  
\n                
\n              ` : `\n                ${demoPagesError ? `\n                  ❌ Error loading demo pages: ${demoPagesError}
\n                ` : `\n                  No demo pages found in the configured database.
\n                `}\n              `}\n            ` : `\n              Demo database not configured. Set GLANCE_DEMOS_DB_ID environment variable.
\n            `}\n          
\n\n          \n            Webhook Endpoint
\n\n            \n              ${webhookEndpoint}
\n            
\n\n            \n              To test: Get the NOTION_WEBHOOK_SECRET value from your vars.env file (provided by your administrator)
\n              \n                \n                \n              
\n              Ready to test webhook authentication...
\n            
\n          
\n        
\n      
\n\n      \n    \n    >\n  `);\n};",[],[278,346,418,439],[278,346,418],{"_102":447,"_95":290,"_154":448,"_156":347,"_157":136,"_158":135,"_160":161,"_104":449,"_99":159,"_163":175,"_165":450,"_166":22,"_167":-5,"_168":451,"_98":452},"4ae36f64-8a90-11f0-91d1-0224a6c84d84","01991600-cca2-73b9-852e-543a461dd798",["D",1757101278463],"# Routes\n\nHTTP route handlers organized by functionality.\n\n## Separation of Concerns\n\nRoutes are the **HTTP transport layer** that:\n- Handle HTTP request/response concerns only\n- Extract and validate parameters from HTTP requests\n- Call controllers with clean, typed parameters\n- Transform controller responses into appropriate HTTP responses\n- Handle HTTP status codes, headers, and content types\n- Provide consistent error response formatting\n\nRoutes do NOT:\n- Contain business logic (delegate to controllers)\n- Make direct service calls (use controllers as intermediary)\n- Handle environment variables or configuration\n- Perform data transformation beyond HTTP concerns\n\n## Architecture Pattern\n\n```\nHTTP Request → Route Handler → Controller → Service → External API\nHTTP Response ← Route Handler ← Controller ← Service ← External API\n```\n\n## Route Organization\n\nEach route subdirectory should have a `_[directory_name].routes.ts` file that mounts routes for that section.\n\n### Directory Structure\n```\nroutes/\n├── api/\n│   ├── _api.routes.ts      # Mounts all API routes\n│   └── README.md\n├── tasks/\n│   ├── _tasks.routes.ts    # Mounts webhook routes\n│   └── README.md\n├── views/\n│   ├── _views.routes.ts    # Mounts HTML view routes\n│   └── README.md\n└── glimpse/\n    ├── _glimpse.routes.ts  # Mounts authentication routes\n    └── README.md\n```\n\n## Data Flow Patterns\n\n### 1. API Route Pattern (Recommended)\n\n**Characteristics**:\n- Extract parameters from URL/body\n- Call controller functions with simple parameters\n- Return JSON responses\n- Handle HTTP status codes based on controller results\n\n#### Example: Demo API Routes (`/api/demo/:id`)\n\n**HTTP Request Data**:\n```typescript\n// URL Parameters\nparams: { id: string }\n\n// Example: GET /api/demo/abc123/properties\n```\n\n**Route Processing**:\n```typescript\napp.get(\"/demo/:id/properties\", async (c) => {\n  // 1. Extract parameters from HTTP request\n  const id = c.req.param(\"id\");\n  \n  // 2. Call controller with clean parameters\n  const result = await getDemoProperties(id);\n  \n  // 3. Transform controller response to HTTP response\n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, result.error === \"Page ID is required\" ? 400 : 500);\n  }\n  \n  // 4. Return successful data\n  return c.json(result.data);\n});\n```\n\n**HTTP Response Data**:\n```typescript\n// Success Response (200)\n{\n  id: string,\n  properties: { [key: string]: NotionPropertyValue },\n  // ... filtered page data\n}\n\n// Error Response (400/500)\n{\n  error: string,\n  details?: string\n}\n```\n\n### 2. Webhook Route Pattern\n\n**Characteristics**:\n- Parse JSON request bodies\n- Pass Hono Context to controllers (for HTTP-specific needs)\n- Return structured JSON responses\n- Handle webhook-specific error scenarios\n\n#### Example: URL Update Webhook (`POST /tasks/url`)\n\n**HTTP Request Data**:\n```typescript\n// Request Body (JSON)\n{\n  data?: { id: string },\n  id?: string,\n  page_id?: string\n}\n\n// Request Headers\n{\n  host: string,\n  \"content-type\": \"application/json\"\n}\n```\n\n**Route Processing**:\n```typescript\napp.post(\"/url\", handleUrlWebhook);\n// Controller handles full HTTP context due to webhook complexity\n```\n\n**HTTP Response Data**:\n```typescript\n// Success Response (200)\n{\n  success: true,\n  message: \"Page URL updated successfully\",\n  pageId: string,\n  url: string,\n  timestamp: string\n}\n\n// Error Response (400/500)\n{\n  success: false,\n  error: string,\n  details?: string\n}\n```\n\n### 3. Authentication Route Pattern\n\n**Characteristics**:\n- Handle authentication middleware context\n- Support both HTML and JSON responses\n- Manage redirects and session state\n- Provide user-friendly error pages\n\n#### Example: Glimpse Login (`GET /glimpse/login`)\n\n**HTTP Request Data**:\n```typescript\n// From Authentication Middleware\ncontext: {\n  userEmail: string\n}\n\n// Environment Configuration\n{\n  GLANCE_DEMOS_DB_ID: string\n}\n```\n\n**Route Processing**:\n```typescript\napp.get(\"/login\", glimpseLoginHandler);\n// Controller handles full HTTP context for redirects and HTML responses\n```\n\n**HTTP Response Data**:\n- **Success**: `302 Redirect` to user's personalized URL\n- **New User**: `302 Redirect` to `/glimpse/thanks`\n- **Error**: `200 HTML` error page or `500 JSON` error response\n\n### 4. Health Check Route Pattern\n\n**Characteristics**:\n- Simple status endpoints\n- Minimal processing\n- Consistent JSON responses\n\n#### Example: Health Check (`GET /api/health`)\n\n**HTTP Request Data**: None\n\n**Route Processing**:\n```typescript\napp.get(\"/health\", async (c) => {\n  const healthStatus = await getHealthStatus();\n  return c.json(healthStatus);\n});\n```\n\n**HTTP Response Data**:\n```typescript\n{\n  status: \"healthy\" | \"unhealthy\",\n  timestamp: string,\n  // ... additional health metrics\n}\n```\n\n## Error Handling Patterns\n\n### API Routes\n```typescript\n// Validation Errors (400)\nif (!result.success && result.error === \"Page ID is required\") {\n  return c.json({ error: result.error }, 400);\n}\n\n// Server Errors (500)\nif (!result.success) {\n  return c.json({ \n    error: result.error, \n    details: result.details \n  }, 500);\n}\n```\n\n### Webhook Routes\n```typescript\n// Bad Request (400)\nreturn c.json({ \n  success: false, \n  error: \"Page ID is required in webhook payload\" \n}, 400);\n\n// Server Error (500)\nreturn c.json({ \n  success: false, \n  error: \"Internal server error processing webhook\", \n  details: error.message \n}, 500);\n```\n\n### Authentication Routes\n- **HTML Error Pages**: For user-facing authentication errors\n- **JSON Error Responses**: For technical/debugging errors\n- **Redirects**: For successful authentication flows\n\n## Route Mounting\n\nEach route module exports a Hono app that gets mounted in the main application:\n\n```typescript\n// _api.routes.ts\nimport { Hono } from \"npm:hono@3.12.12\";\nimport { getDemoProperties, getDemoFull } from \"../../controllers/demo.controller.ts\";\n\nconst app = new Hono();\n\napp.get(\"/demo/:id/properties\", async (c) => {\n  // Route implementation\n});\n\nexport default app;\n```\n\n```typescript\n// main.tsx\nimport apiRoutes from \"./backend/routes/api/_api.routes.ts\";\nimport taskRoutes from \"./backend/routes/tasks/_tasks.routes.ts\";\n\napp.route(\"/api\", apiRoutes);\napp.route(\"/tasks\", taskRoutes);\n```\n\n## Best Practices\n\n### Parameter Extraction\n- Use `c.req.param()` for URL parameters\n- Use `await c.req.json()` for request bodies\n- Validate required parameters before calling controllers\n\n### Response Formatting\n- Return raw data for successful API calls\n- Include error context for debugging\n- Use appropriate HTTP status codes\n- Maintain consistent response structures\n\n### Error Responses\n- Provide user-friendly error messages\n- Include technical details for debugging\n- Use appropriate HTTP status codes (400 for client errors, 500 for server errors)\n- Log errors for monitoring and debugging",[],[278,346,290],{"_102":454,"_95":455,"_154":456,"_156":347,"_157":136,"_158":135,"_160":161,"_104":457,"_99":159,"_163":301,"_165":458,"_166":22,"_167":-5,"_168":459,"_98":460},"4ae37e82-8a90-11f0-91d1-0224a6c84d84","authCheck.ts","01991600-cca2-73b9-852e-5a425c389291",["D",1757101278463],"// Public routes that don't require authentication\nconst PUBLIC_ROUTES = [\n  \"/api/health\", // Health check endpoint should be publicly accessible\n  // Add other public routes here as needed\n  // '/demo/:id',  // Example: public demo viewing\n  // '/api/public', // Example: public API endpoints\n];\n\n// Internal routes that can be accessed without authentication when called from within the Val\nconst INTERNAL_ROUTES = [\n  \"/api/demo/:id/properties\",\n  \"/api/demo/:id\",\n];\n\n// Helper function to check if a route is public\nfunction isPublicRoute(path: string): boolean {\n  return PUBLIC_ROUTES.some((route) => {\n    // Handle exact matches\n    if (route === path) return true;\n\n    // Handle wildcard patterns (basic implementation)\n    if (route.includes(\"*\")) {\n      const pattern = route.replace(\"*\", \".*\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    // Handle route parameters (basic implementation)\n    if (route.includes(\":\")) {\n      const pattern = route.replace(/:[^/]+/g, \"[^/]+\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    return false;\n  });\n}\n\n// Helper function to check if a route is internal\nfunction isInternalRoute(path: string): boolean {\n  return INTERNAL_ROUTES.some((route) => {\n    // Handle exact matches\n    if (route === path) return true;\n\n    // Handle wildcard patterns (basic implementation)\n    if (route.includes(\"*\")) {\n      const pattern = route.replace(\"*\", \".*\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    // Handle route parameters (basic implementation)\n    if (route.includes(\":\")) {\n      const pattern = route.replace(/:[^/]+/g, \"[^/]+\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    return false;\n  });\n}\n\n// Helper function to check if request is from within the Val\nfunction isInternalRequest(c): boolean {\n  // Check for internal request indicators\n  const userAgent = c.req.header(\"User-Agent\");\n  const host = c.req.header(\"Host\");\n  const referer = c.req.header(\"Referer\");\n  \n  // If the request is coming from the same host (internal call)\n  if (referer && host && referer.includes(host)) {\n    return true;\n  }\n  \n  // If the request is from Deno (internal fetch calls)\n  if (userAgent && userAgent.includes(\"Deno/\")) {\n    return true;\n  }\n  \n  return false;\n}\n\nexport default async (c, next) => {\n  // Allow public routes to bypass authentication\n  if (isPublicRoute(c.req.path)) {\n    await next();\n    return;\n  }\n\n  // Allow internal routes when called from within the Val\n  if (isInternalRoute(c.req.path) && isInternalRequest(c)) {\n    await next();\n    return;\n  }\n\n  const email = c.req.header(\"X-LastLogin-Email\");\n\n  if (!email) {\n    // Show login page if not authenticated\n    return c.html(`\n      \n      \n      \n        Glance Demos - Login Required\n        \n        \n      \n      \n        \n          Sign in to Glance Demos
\n          Sign in to access your dashboard and manage your demos.
\n          \n            Loading login button...
\n          
\n          \n            via LastLogin\n          
\n        
\n\n        \n      \n      \n    `);\n  }\n\n  // If authenticated, store email in context for use by routes\n  c.set(\"userEmail\", email);\n\n  // Continue to the next middleware/route\n  await next();\n};",[],[278,346,455],{"_102":462,"_95":463,"_154":464,"_156":347,"_157":136,"_158":159,"_160":161,"_104":465,"_99":32,"_163":301,"_165":466,"_166":22,"_167":-5,"_168":467,"_98":468},"92beeeea-89bd-11f0-80ae-0224a6c84d84","webhookAuthCheck.ts","01991600-cca2-73b9-852e-5c81e19bdfb1",["D",1757010775113],"// Webhook authentication middleware for /tasks/* routes\n// Validates X-API-KEY header against NOTION_WEBHOOK_SECRET environment variable\n\n// Constant-time comparison to prevent timing attacks\nfunction constantTimeCompare(a: string, b: string): boolean {\n  if (a.length !== b.length) {\n    return false;\n  }\n  \n  let result = 0;\n  for (let i = 0; i < a.length; i++) {\n    result |= a.charCodeAt(i) ^ b.charCodeAt(i);\n  }\n  \n  return result === 0;\n}\n\nexport default async (c, next) => {\n  // Allow GET requests to pass through without webhook authentication\n  // (for debug endpoints and other non-webhook routes)\n  if (c.req.method === \"GET\") {\n    await next();\n    return;\n  }\n\n  const apiKey = c.req.header(\"X-API-KEY\");\n  const webhookSecret = Deno.env.get(\"NOTION_WEBHOOK_SECRET\");\n\n  // Log authentication attempt for monitoring\n  console.log(`Webhook auth attempt for ${c.req.path} - Key provided: ${!!apiKey}`);\n\n  // Check if webhook secret is configured\n  if (!webhookSecret) {\n    console.error(\"NOTION_WEBHOOK_SECRET environment variable not configured\");\n    return c.json({ error: \"Authentication configuration error\" }, 500);\n  }\n\n  // Check if API key is provided\n  if (!apiKey) {\n    console.log(\"Webhook authentication failed: No X-API-KEY header provided\");\n    return c.json({ error: \"Authentication required\" }, 401);\n  }\n\n  // Use constant-time comparison to prevent timing attacks\n  if (!constantTimeCompare(apiKey, webhookSecret)) {\n    console.log(\"Webhook authentication failed: Invalid X-API-KEY\");\n    return c.json({ error: \"Authentication failed\" }, 403);\n  }\n\n  console.log(\"Webhook authentication successful\");\n  \n  // Authentication successful, proceed to route handler\n  await next();\n};",[],[278,346,463],[278,346],{"_102":471,"_95":472,"_154":473,"_156":279,"_157":136,"_158":159,"_160":161,"_104":474,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":475,"_98":491},"92bef6ec-89bd-11f0-80ae-0224a6c84d84","services","01991600-cca2-73b9-852e-6cd95a80b64f",["D",1757010775113],[476,483],{"_102":477,"_95":290,"_154":478,"_156":473,"_157":136,"_158":135,"_160":161,"_104":479,"_99":141,"_163":175,"_165":480,"_166":22,"_167":-5,"_168":481,"_98":482},"4ae39af2-8a90-11f0-91d1-0224a6c84d84","01991600-cca2-73b9-852e-6628f119990c",["D",1757101278463],"# Services\n\nExternal API integrations (pure API calls only).\n\n## Separation of Concerns\n\nServices are the **data access layer** that:\n- Make direct API calls to external systems (Notion, databases, etc.)\n- Handle HTTP transport layer concerns (network errors, response parsing)\n- Return consistent, standardized response formats\n- Are pure functions with no side effects beyond the API call\n- Do NOT handle business logic, environment variables, or orchestrate multiple calls\n\n## Standard Response Format\n\nAll service functions return:\n```typescript\n{\n  success: boolean,\n  data?: any,           // Present on success\n  error?: string,       // Present on failure  \n  timestamp: string     // ISO timestamp of the operation\n}\n```\n\n## Data Structures Passed\n\n### Input Parameters\n- **Simple primitives**: `string`, `number`, `boolean` only\n- **No complex objects**: Controllers handle object extraction/validation\n- **No HTTP contexts**: Services are transport-agnostic\n\n### Output Data\n- **Raw API responses**: Unmodified data from external APIs\n- **No business logic filtering**: Controllers handle data transformation\n- **Complete error context**: Full error messages from external systems\n\n## Notion Service Functions\n\n### Database Operations\n\n#### `getDatabases()`\n- **Input**: None\n- **Output**: Raw Notion search response with all accessible databases\n- **Data Structure**: \n  ```typescript\n  {\n    success: true,\n    data: {\n      results: NotionDatabase[],\n      next_cursor: string | null,\n      has_more: boolean\n    },\n    timestamp: string\n  }\n  ```\n\n#### `getDatabaseById(databaseId: string)`\n- **Input**: Database UUID string\n- **Output**: Complete Notion database object with schema\n- **Data Structure**:\n  ```typescript\n  {\n    success: true,\n    data: {\n      id: string,\n      title: RichText[],\n      properties: { [key: string]: PropertySchema },\n      // ... full Notion database object\n    },\n    timestamp: string\n  }\n  ```\n\n#### `getDatabasePages(databaseId: string)`\n- **Input**: Database UUID string  \n- **Output**: All pages in the database with properties\n- **Data Structure**:\n  ```typescript\n  {\n    success: true,\n    data: {\n      results: NotionPage[],\n      next_cursor: string | null,\n      has_more: boolean\n    },\n    timestamp: string\n  }\n  ```\n\n### Page Operations\n\n#### `getPageById(pageId: string)`\n- **Input**: Page UUID string\n- **Output**: Complete Notion page object with properties\n- **Data Structure**:\n  ```typescript\n  {\n    success: true,\n    data: {\n      id: string,\n      properties: { [key: string]: PropertyValue },\n      parent: { database_id: string } | { page_id: string },\n      // ... full Notion page object\n    },\n    timestamp: string\n  }\n  ```\n\n#### `getPageBlocks(pageId: string)`\n- **Input**: Page UUID string\n- **Output**: Hierarchical block structure with recursive children\n- **Data Structure**:\n  ```typescript\n  {\n    success: true,\n    data: {\n      results: NotionBlock[] // Each block may have .children array\n    },\n    timestamp: string\n  }\n  ```\n\n#### `getPageWithBlocks(pageId: string)`\n- **Input**: Page UUID string\n- **Output**: Combined page properties and block content\n- **Data Structure**:\n  ```typescript\n  {\n    success: true,\n    data: {\n      // All page properties\n      id: string,\n      properties: { [key: string]: PropertyValue },\n      // Plus blocks array\n      blocks: NotionBlock[]\n    },\n    timestamp: string\n  }\n  ```\n\n#### `updatePageUrl(pageId: string, url: string)`\n- **Input**: Page UUID and URL string\n- **Output**: Updated page object\n- **Behavior**: Updates the \"URL\" property specifically\n- **Data Structure**: Same as `getPageById` response\n\n### User Management Operations\n\n#### `findUserByEmail(databaseId: string, email: string)`\n- **Input**: Database UUID and email address string\n- **Output**: Query results for pages matching email\n- **Data Structure**:\n  ```typescript\n  {\n    success: true,\n    data: {\n      results: NotionPage[], // Pages with Email property matching\n      next_cursor: string | null,\n      has_more: boolean\n    },\n    timestamp: string\n  }\n  ```\n\n#### `createUserRecord(databaseId: string, email: string)`\n- **Input**: Database UUID and email address string\n- **Output**: Newly created page object\n- **Behavior**: Creates page with \"Email\" property set\n- **Data Structure**: Same as `getPageById` response\n\n## Error Handling\n\nServices return detailed error information:\n```typescript\n{\n  success: false,\n  error: \"Notion API error message\", // Direct from external API\n  timestamp: string\n}\n```\n\nCommon error scenarios:\n- **Network failures**: Connection timeouts, DNS issues\n- **Authentication**: Invalid API keys, expired tokens  \n- **Authorization**: Insufficient permissions for resources\n- **Validation**: Invalid UUIDs, missing required fields\n- **Rate limiting**: API quota exceeded",[],[278,472,290],{"_102":484,"_95":485,"_154":486,"_156":473,"_157":136,"_158":135,"_160":161,"_104":487,"_99":141,"_163":301,"_165":488,"_166":22,"_167":-5,"_168":489,"_98":490},"4ae3a038-8a90-11f0-91d1-0224a6c84d84","notion.service.ts","01991600-cca2-73b9-852e-6aec10686a2a",["D",1757101278463],"import { Client } from \"npm:@notionhq/client\";\n\nconst notion = new Client({ auth: Deno.env.get(\"NOTION_API_KEY\") });\n\nexport async function getDatabases() {\n  try {\n    const response = await notion.search({\n      filter: {\n        property: \"object\",\n        value: \"database\"\n      }\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function getDatabaseById(databaseId: string) {\n  try {\n    const response = await notion.databases.retrieve({\n      database_id: databaseId,\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function getPageById(pageId: string) {\n  try {\n    const response = await notion.pages.retrieve({\n      page_id: pageId,\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function getDatabasePages(databaseId: string) {\n  try {\n    const response = await notion.databases.query({\n      database_id: databaseId,\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function updatePageUrl(pageId: string, url: string) {\n  try {\n    const response = await notion.pages.update({\n      page_id: pageId,\n      properties: {\n        \"URL\": {\n          url: url\n        }\n      }\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function findUserByEmail(databaseId: string, email: string) {\n  try {\n    const response = await notion.databases.query({\n      database_id: databaseId,\n      filter: {\n        property: \"Email\",\n        email: {\n          equals: email\n        }\n      }\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function createUserRecord(databaseId: string, email: string) {\n  try {\n    const response = await notion.pages.create({\n      parent: {\n        database_id: databaseId\n      },\n      properties: {\n        \"Email\": {\n          email: email\n        }\n      }\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nasync function getAllBlocksRecursively(blockId: string): Promise {\n  const response = await notion.blocks.children.list({\n    block_id: blockId,\n    page_size: 100 // Get more blocks per request\n  });\n\n  const blocks = response.results;\n\n  // For each block, check if it has children and fetch them recursively\n  for (const block of blocks) {\n    if (block.has_children) {\n      try {\n        block.children = await getAllBlocksRecursively(block.id);\n      } catch (error) {\n        // If fetching children fails, log but don't fail the entire operation\n        console.warn(`Failed to fetch children for block ${block.id}:`, error.message);\n        block.children = [];\n      }\n    }\n  }\n\n  return blocks;\n}\n\nexport async function getPageBlocks(pageId: string) {\n  try {\n    const blocks = await getAllBlocksRecursively(pageId);\n    return {\n      success: true,\n      data: {\n        results: blocks\n      },\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function getPageWithBlocks(pageId: string) {\n  try {\n    // Get page properties\n    const pageResult = await getPageById(pageId);\n    if (!pageResult.success) {\n      return pageResult;\n    }\n\n    // Get page blocks\n    const blocksResult = await getPageBlocks(pageId);\n    if (!blocksResult.success) {\n      return blocksResult;\n    }\n\n    // Combine page data with blocks\n    const combinedData = {\n      ...pageResult.data,\n      blocks: blocksResult.data.results\n    };\n\n    return {\n      success: true,\n      data: combinedData,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}",[],[278,472,485],[278,472],{"_102":493,"_95":494,"_154":495,"_156":279,"_157":136,"_158":159,"_160":161,"_104":496,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":497,"_98":505},"92befa3e-89bd-11f0-80ae-0224a6c84d84","types","01991600-cca2-73b9-852e-74af1a4094be",["D",1757010775113],[498],{"_102":499,"_95":290,"_154":500,"_156":495,"_157":136,"_158":159,"_160":161,"_104":501,"_99":32,"_163":175,"_165":502,"_166":22,"_167":-5,"_168":503,"_98":504},"92bef8a4-89bd-11f0-80ae-0224a6c84d84","01991600-cca2-73b9-852e-723bcaafa976",["D",1757010775113],"# Types\n\nShared TypeScript type definitions.",[],[278,494,290],[278,494],{"_102":507,"_95":508,"_154":509,"_156":279,"_157":136,"_158":159,"_160":161,"_104":510,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":511,"_98":519},"92befd40-89bd-11f0-80ae-0224a6c84d84","utils","01991600-cca2-73b9-852e-7fef42404573",["D",1757010775113],[512],{"_102":513,"_95":290,"_154":514,"_156":509,"_157":136,"_158":159,"_160":161,"_104":515,"_99":32,"_163":175,"_165":516,"_166":22,"_167":-5,"_168":517,"_98":518},"92befbe2-89bd-11f0-80ae-0224a6c84d84","01991600-cca2-73b9-852e-7a6dc13367bd",["D",1757010775113],"# Utils\n\nCommon utility functions.",[],[278,508,290],[278,508],{"_102":521,"_95":290,"_154":522,"_156":279,"_157":136,"_158":159,"_160":161,"_104":523,"_99":32,"_163":175,"_165":524,"_166":22,"_167":-5,"_168":525,"_98":526},"92befeee-89bd-11f0-80ae-0224a6c84d84","01991600-cca2-73b9-852e-83d921ee4a37",["D",1757010775113],"# Backend\n\nThis directory contains all server-side code organized by functionality.\n\n## Architecture\n\n- **routes/** - HTTP route handlers organized by functionality\n- **api/** - JSON API endpoints for frontend/backend communication  \n- **tasks/** - Webhook handlers for Notion integrations\n- **views/** - Server-side rendered views for frontend\n- **services/** - External API integrations (pure API calls only)\n- **controllers/** - Business logic coordination between routes and services\n- **crons/** - Scheduled task handlers\n- **types/** - Shared TypeScript type definitions\n- **utils/** - Common utility functions\n\n## Layer Responsibilities\n\n**Services**: Single-purpose functions that make direct API calls to external systems. Pure functions that handle HTTP transport layer.\n\n**Controllers**: Business logic and orchestration between services. Handle environment variables and configuration.\n\n**Routes**: HTTP request/response handling only. Call controllers, never services directly.",[],[278,290],[278],{"_102":529,"_95":530,"_154":531,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":532,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":533,"_98":541},"92bf047a-89bd-11f0-80ae-0224a6c84d84","frontend","01991600-cca2-73b9-852e-8cd3697333f7",["D",1757010775113],[534],{"_102":535,"_95":290,"_154":536,"_156":531,"_157":136,"_158":159,"_160":161,"_104":537,"_99":32,"_163":175,"_165":538,"_166":22,"_167":-5,"_168":539,"_98":540},"92bf0312-89bd-11f0-80ae-0224a6c84d84","01991600-cca2-73b9-852e-8876f3f28e1a",["D",1757010775113],"# Frontend\n\nClient-side files that render in the browser.",[],[530,290],[530],{"_102":543,"_95":544,"_154":545,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":546,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":547,"_98":555},"92bf07d6-89bd-11f0-80ae-0224a6c84d84","shared","01991600-cca2-73b9-852e-95ced0e9f4ba",["D",1757010775113],[548],{"_102":549,"_95":290,"_154":550,"_156":545,"_157":136,"_158":159,"_160":161,"_104":551,"_99":32,"_163":175,"_165":552,"_166":22,"_167":-5,"_168":553,"_98":554},"92bf0600-89bd-11f0-80ae-0224a6c84d84","01991600-cca2-73b9-852e-910331c12a44",["D",1757010775113],"# Shared\n\nFiles used by both backend and frontend.\n\nNote: Code in shared/ must work in both frontend and backend environments. Cannot use `Deno` keyword in shared code.",[],[544,290],[544],{"_102":557,"_95":558,"_154":559,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":560,"_99":32,"_163":175,"_165":561,"_166":22,"_167":-5,"_168":562,"_98":563},"92bf09b6-89bd-11f0-80ae-0224a6c84d84",".vtignore","01991600-cca2-73b9-852e-99c18e7750b4",["D",1757010775113],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\nvars.env",[],[558],{"_102":565,"_95":290,"_154":566,"_156":-5,"_157":136,"_158":135,"_160":161,"_104":567,"_99":141,"_163":175,"_165":568,"_166":22,"_167":-5,"_168":569,"_98":570},"4ae34976-8a90-11f0-91d1-0224a6c84d84","01991600-cca2-73b9-852e-9d61c352bf87",["D",1757101278463],"# Glance Demos\n\nA Val Town application for managing and viewing demos with authentication.\n\n## Features\n\n- **Authentication**: Google OAuth via LastLogin\n- **Dashboard**: User-friendly interface showing system status\n- **Health Monitoring**: Real-time system health checks\n- **Modular Architecture**: Clean separation of concerns\n\n## Authentication\n\nThis application uses [LastLogin](https://lastlogin.io/) for authentication:\n\n- **Login**: Users sign in with their Google account\n- **Protected Routes**: All routes require authentication except public endpoints\n- **Logout**: Users can logout via `/auth/logout` (handled automatically by LastLogin)\n- **Session Management**: Automatic session validation and renewal\n\n### Public Routes\n\nThe following routes are accessible without authentication:\n- `/api/health` - System health status\n\n### Protected Routes\n\nRoutes are protected by different authentication mechanisms:\n\n**User Authentication (Google OAuth via LastLogin):**\n- `/` - Main dashboard (shows user info and system status)\n- `/api/*` - API endpoints (except health)\n- `/views/*` - View routes including `/views/glimpse/:id`\n- `/glimpse/*` - Shortcut routes including `/glimpse/:id` (equivalent to `/views/glimpse/:id`)\n\n**Webhook Authentication (X-API-KEY header):**\n- `/tasks/*` - Webhook endpoints for external integrations (POST requests only)\n  - GET requests to `/tasks/*` are allowed without authentication for debug endpoints\n\n## Project Structure\n\n```\n├── backend/\n│   ├── controllers/         # Business logic controllers\n│   ├── routes/             # Route definitions and HTTP handling\n│   │   ├── api/            # API endpoints\n│   │   ├── glimpse/        # Shortcut glimpse routes\n│   │   ├── tasks/          # Task-related routes\n│   │   ├── views/          # User-facing views\n│   │   └── authCheck.ts    # Authentication middleware\n│   └── services/           # External service integrations\n├── frontend/               # Frontend assets\n├── shared/                 # Shared utilities\n└── main.tsx               # Application entry point\n```\n\n## Architecture\n\nThe application follows a clean MVC architecture with proper separation of concerns:\n\n### **Route Layer** (HTTP Handling)\n- Handles HTTP request/response formatting\n- Extracts parameters from requests\n- Applies authentication middleware\n- Calls controller functions and formats responses\n- Manages HTTP status codes and error responses\n\n### **Controller Layer** (Business Logic)\n- Contains business logic and orchestrates service calls\n- Returns plain data objects (not HTTP responses)\n- Handles data validation and transformation\n- Filters sensitive data (e.g., button properties)\n- Provides consistent success/error response structure\n\n### **Service Layer** (External Integrations)\n- Handles external API calls (Notion, databases)\n- Manages data persistence\n- Returns structured results with success/error information\n\n### Response Format\nAll controller functions return a consistent structure:\n```typescript\n{\n  success: boolean,\n  data: any | null,\n  error: string | null,\n  details?: string  // Additional error context\n}\n```\n\nRoutes then format these into appropriate HTTP responses.\n\n## Glimpse Routes\n\nThe application provides multiple routes for accessing page data and user authentication:\n\n### Authentication Routes\n- `GET /glimpse/login` - User-specific login redirect\n  - Requires user authentication (Google OAuth via LastLogin)\n  - Looks up authenticated user's email in `GLANCE_DEMOS_DB_ID` database\n  - If user found: Redirects to user's personal URL\n  - If user not found: Creates new user record and redirects to `/glimpse/thanks`\n  - Shows detailed error information for debugging database structure issues\n\n- `GET /glimpse/thanks` - New user welcome page\n  - Shows confirmation that user account was created\n  - Explains next steps (admin review, email with demo link)\n  - Provides timeline expectations (1-2 business days)\n\n### Data Access Routes\n- `GET /views/glimpse/:id` - Get complete page data with blocks by Notion page ID\n- `GET /glimpse/:id` - Same functionality as above, shorter URL\n\n**Note:** As of the latest update, glimpse endpoints now return complete page data including all blocks recursively fetched from Notion. This provides richer content compared to the previous properties-only behavior.\n\n### Demo API Endpoints\n\nAPI endpoints for accessing Notion page data with different levels of detail:\n\n- `GET /api/demo/:id/properties` - Returns page properties only\n- `GET /api/demo/:id` - Returns page properties + all blocks recursively\n\n**Architecture:**\n- **Routes**: Handle HTTP concerns (parameter extraction, response formatting, status codes)\n- **Controllers**: Contain business logic (`getDemoProperties`, `getDemoFull`)\n- **Services**: Handle Notion API integration\n\n**Authentication Behavior:**\n- **Browser requests**: Require user authentication (Google OAuth via LastLogin)\n- **Internal requests**: Bypass authentication when called from within the Val (identified by Deno user agent)\n\n**Response Format:**\nRoutes return the data directly from controllers on success:\n```json\n{\n  // Notion page object with properties\n  // For full endpoint: also includes \"blocks\" array with recursive block data\n}\n```\n\nOn error, routes return:\n```json\n{\n  \"error\": \"Error message\",\n  \"details\": \"Additional error context\"\n}\n```\n\n**Usage Examples:**\n```javascript\n// Internal call from within Val (no authentication needed)\nconst response = await fetch('/api/demo/page-id/properties');\nconst data = await response.json();\n\n// External browser request (requires authentication)\n// User must be logged in via Google OAuth\n```\n\nAll glimpse routes:\n- Require user authentication\n- Return complete page data including properties and blocks recursively\n- Filter out button properties from Notion page data\n- Return standardized JSON responses (except authentication routes which redirect or show HTML)\n- Use the same controller functions as the API endpoints for consistency\n\n### New User Registration Flow\n\n1. **Authentication**: User must be authenticated via Google OAuth (handled by LastLogin)\n2. **Database Lookup**: System queries `GLANCE_DEMOS_DB_ID` database for user's email\n3. **User Creation**: If not found, creates new user record with email address\n4. **Welcome Page**: Redirects to `/glimpse/thanks` with next steps information\n5. **Admin Process**: Admin reviews new users and adds demo URLs manually\n6. **User Return**: User can return to `/glimpse/login` once URL is configured\n\n### Database Requirements for Login\n\nThe `GLANCE_DEMOS_DB_ID` database must contain:\n- **Email property**: Contains user's email address (exact match with authenticated email)\n- **URL property**: Contains user's redirect URL (optional for new users)\n\nSupported URL property names: `URL`, `Link`, `Redirect URL`, `Demo URL`, `url`, `link`\nSupported URL property types: `url`, `rich_text`, `title`\n\n### Error Handling\n\nThe login endpoint provides detailed error information for debugging:\n- Missing environment variables\n- Database query failures  \n- User creation failures (falls back to access denied page)\n- Invalid or missing URL properties\n- URL format validation errors\n\nThe dashboard displays both routes in a comparison table for easy testing.\n\n## Development\n\nThe application is built with:\n- **Hono**: Web framework for routing and middleware\n- **LastLogin**: Authentication service\n- **TypeScript**: Type-safe development\n- **Val Town**: Hosting platform\n\n## Webhook Authentication\n\nThe application supports webhook endpoints for external integrations (like Notion webhooks):\n\n### Configuration\n\nSet the webhook secret in your environment:\n```\nNOTION_WEBHOOK_SECRET=your-secret-key-here\n```\n\n### Webhook Endpoints\n\n- `POST /tasks/notion-webhook` - Main webhook endpoint for Notion integrations (requires `X-API-KEY` header)\n- `POST /tasks/url` - Updates Notion page URL property with glimpse URL (requires `X-API-KEY` header)\n- `POST /tasks/test` - Test endpoint for webhook authentication (requires `X-API-KEY` header)\n- `GET /tasks/debug-webhook` - Debug endpoint to check webhook configuration\n\n### Authentication\n\nWebhook endpoints require the `X-API-KEY` header:\n```bash\ncurl -X POST https://your-val.web.val.run/tasks/test \\\n  -H \"X-API-KEY: your-secret-key-here\"\n```\n\n### Testing\n\nUse the webhook testing form in the dashboard:\n1. Navigate to your dashboard at `/`\n2. Find the \"Webhook Endpoint\" section\n3. Enter your `NOTION_WEBHOOK_SECRET` value\n4. Click \"Test Webhook\" to verify authentication\n\n## Environment Variables\n\nConfigure these environment variables for full functionality:\n- `GLANCE_DEMOS_DB_ID` - Notion database ID for demos\n- `GLANCE_CONTENT_DB_ID` - Notion database ID for content\n- `GLANCE_INTERACTIONS_DB_ID` - Notion database ID for interactions\n- `NOTION_API_KEY` - Notion API key for database access\n- `NOTION_WEBHOOK_SECRET` - Secret key for webhook authentication",[],[290],{"_102":572,"_95":573,"_154":574,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":575,"_99":32,"_163":175,"_165":576,"_166":22,"_167":-5,"_168":577,"_98":578},"92bf13ca-89bd-11f0-80ae-0224a6c84d84","deno.json","01991600-cca2-73b9-852e-a269628186f6",["D",1757010775113],"{\n  \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n  \"lock\": false,\n  \"compilerOptions\": {\n    \"noImplicitAny\": false,\n    \"strict\": false,\n    \"types\": [\n      \"https://www.val.town/types/valtown.d.ts\"\n    ],\n    \"lib\": [\n      \"dom\",\n      \"dom.iterable\",\n      \"dom.asynciterable\",\n      \"deno.ns\",\n      \"deno.unstable\"\n    ]\n  },\n  \"lint\": {\n    \"files\": {\n      \"include\": [\n        \"deno:/https/esm.town/**/*\"\n      ]\n    },\n    \"rules\": {\n      \"exclude\": [\n        \"no-explicit-any\"\n      ]\n    }\n  },\n  \"node_modules_dir\": false,\n  \"experimental\": {\n    \"unstable-node-globals\": true,\n    \"unstable-temporal\": true,\n    \"unstable-worker-options\": true,\n    \"unstable-sloppy-imports\": true\n  }\n}",[],[573],{"_102":580,"_95":581,"_154":582,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":583,"_99":32,"_163":584,"_165":585,"_166":22,"_167":-5,"_168":586,"_98":587},"92bf15c8-89bd-11f0-80ae-0224a6c84d84","main.tsx","01991600-cca2-73b9-852e-a77200348f0d",["D",1757010775113],"http","import { Hono } from \"npm:hono@3.12.12\";\nimport { lastlogin } from \"https://esm.town/v/stevekrouse/lastlogin_safe\";\n\n// Import route modules\nimport apiRoutes from \"./backend/routes/api/_api.routes.ts\";\nimport taskRoutes from \"./backend/routes/tasks/_tasks.routes.ts\";\nimport viewRoutes from \"./backend/routes/views/_views.routes.ts\";\nimport glimpseRoutes from \"./backend/routes/glimpse/_glimpse.routes.ts\";\nimport authCheck from \"./backend/routes/authCheck.ts\";\nimport webhookAuth from \"./backend/routes/webhookAuthCheck.ts\";\nimport dashboardRoute from \"./backend/routes/views/dashboard.tsx\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n  throw err;\n});\n\n// 1. Webhook auth - ONLY for /tasks/* routes\napp.use(\"/tasks/*\", webhookAuth);\n\n// 2. User auth - for ALL routes EXCEPT /tasks/*\napp.use(\"/api/*\", authCheck);\napp.use(\"/views/*\", authCheck);\napp.use(\"/glimpse/*\", authCheck);\napp.use(\"/\", authCheck);\n\n// Add root route - now serves the authenticated dashboard\napp.get(\"/\", dashboardRoute);\n\n// 3. Mount routes AFTER middleware\napp.route(\"/api\", apiRoutes);\napp.route(\"/tasks\", taskRoutes);\napp.route(\"/views\", viewRoutes);\napp.route(\"/glimpse\", glimpseRoutes);\n\n// Main HTTP handler\nasync function handler(request: Request): Promise {\n  return app.fetch(request);\n}\n\n// Wrap and export the main HTTP handler with lastlogin\nexport default lastlogin(handler);",[],[581],"files",[151,170,179,187,195,203,211,219,227,235,243,251,259,267,276,282,288,296,305,313,321,330,336,344,350,356,363,372,378,385,394,400,407,416,422,429,437,446,453,461,470,476,483,492,498,506,512,520,528,534,542,548,556,564,571,579],"counts",{"_592":32,"_593":159,"_594":159,"_595":596},"pulls","branches","forks","envVars",5,"contents",[599,602,605,608,611,614,617,620],{"_102":152,"_95":153,"_154":155,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":600,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_98":601},["D",1757010775113],[153],{"_102":277,"_95":278,"_154":279,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":603,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_98":604},["D",1757010775113],[278],{"_102":529,"_95":530,"_154":531,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":606,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_98":607},["D",1757010775113],[530],{"_102":543,"_95":544,"_154":545,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":609,"_99":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_98":610},["D",1757010775113],[544],{"_102":557,"_95":558,"_154":559,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":612,"_99":32,"_163":175,"_165":561,"_166":22,"_167":-5,"_98":613},["D",1757010775113],[558],{"_102":565,"_95":290,"_154":566,"_156":-5,"_157":136,"_158":135,"_160":161,"_104":615,"_99":141,"_163":175,"_165":568,"_166":22,"_167":-5,"_98":616},["D",1757101278463],[290],{"_102":572,"_95":573,"_154":574,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":618,"_99":32,"_163":175,"_165":576,"_166":22,"_167":-5,"_98":619},["D",1757010775113],[573],{"_102":580,"_95":581,"_154":582,"_156":-5,"_157":136,"_158":159,"_160":161,"_104":621,"_99":32,"_163":584,"_165":585,"_166":22,"_167":-5,"_98":622},["D",1757010775113],[581],"upstreamProject",{"_102":144,"_95":625,"_110":-5,"_111":-5,"_108":109,"_23":626},"glimpse2-runbook-view-glimpse-save",{"_93":94,"_128":129},"upstreamBranch",{"_102":139,"_104":629,"_630":631,"_95":43,"_137":144,"_99":141,"_138":632,"_140":135,"_633":634,"_106":-5,"_148":22,"_108":109,"_147":94,"_16":117,"_146":625},["D",1755127954709],"updatedAt",["D",1757008607243],"7025ba10-783f-11f0-b06f-0224a6c84d84","lockfileKey","1757008633676-esm.town_v_lightweight_glimpse2-runbook-view-glimpse-save@2-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.compare.$branch",{"_93":94,"_95":96,"_97":43,"_100":641,"_646":141,"_647":32,"_648":649,"_836":161,"_837":645,"_838":839,"_842":-5},{"_102":103,"_95":96,"_104":642,"_106":-5,"_107":22,"_108":109,"_110":-5,"_111":-5,"_14":112,"_113":-5,"_114":22,"_115":-5,"_116":32,"_16":117,"_118":119,"_120":119,"_121":122,"_123":122,"_124":122,"_125":119,"_126":119,"_23":643,"_130":644,"_133":645,"_148":22},["D",1757010775113],{"_93":94,"_128":129},{"_93":94,"_132":129},{"_99":135,"_95":43,"_102":136,"_137":103,"_138":139,"_140":141,"_142":109,"_143":144,"_145":117,"_146":96,"_147":94},"ahead","behind","diff",{"_650":651,"_166":660,"_661":662},"added",[652],{"_98":653,"_654":-7,"_655":656},"backend/controllers/demo.controller.ts","targetFile","sourceFile",{"_102":297,"_95":298,"_154":299,"_156":285,"_157":136,"_158":135,"_160":161,"_104":300,"_99":32,"_163":301,"_165":302,"_166":22,"_167":-5,"_168":-7,"_98":657,"_658":659},[278,284,298],"contentHash","3f30d59b47368dd90d7e83e634acb9a27f13dd354416534bb3298be389468597",[],"modified",[663,674,687,699,712,725,737,749,762,774,787,799,811,824],{"_98":290,"_654":664,"_655":671},{"_102":665,"_95":290,"_154":666,"_156":-5,"_157":139,"_158":141,"_160":161,"_104":667,"_99":159,"_163":175,"_165":668,"_166":22,"_167":-5,"_168":-7,"_98":669,"_658":670},"86894ca6-89b8-11f0-80ac-0224a6c84d84","0198a5c7-3d54-7604-b958-eaf7c5ca944a",["D",1757008607243],"# Glance Demos\n\nA Val Town application for managing and viewing demos with authentication.\n\n## Features\n\n- **Authentication**: Google OAuth via LastLogin\n- **Dashboard**: User-friendly interface showing system status\n- **Health Monitoring**: Real-time system health checks\n- **Modular Architecture**: Clean separation of concerns\n\n## Authentication\n\nThis application uses [LastLogin](https://lastlogin.io/) for authentication:\n\n- **Login**: Users sign in with their Google account\n- **Protected Routes**: All routes require authentication except public endpoints\n- **Logout**: Users can logout via `/auth/logout` (handled automatically by LastLogin)\n- **Session Management**: Automatic session validation and renewal\n\n### Public Routes\n\nThe following routes are accessible without authentication:\n- `/api/health` - System health status\n\n### Protected Routes\n\nRoutes are protected by different authentication mechanisms:\n\n**User Authentication (Google OAuth via LastLogin):**\n- `/` - Main dashboard (shows user info and system status)\n- `/api/*` - API endpoints (except health)\n- `/views/*` - View routes including `/views/glimpse/:id`\n- `/glimpse/*` - Shortcut routes including `/glimpse/:id` (equivalent to `/views/glimpse/:id`)\n\n**Webhook Authentication (X-API-KEY header):**\n- `/tasks/*` - Webhook endpoints for external integrations (POST requests only)\n  - GET requests to `/tasks/*` are allowed without authentication for debug endpoints\n\n## Project Structure\n\n```\n├── backend/\n│   ├── controllers/         # Business logic controllers\n│   ├── routes/             # Route definitions\n│   │   ├── api/            # API endpoints\n│   │   ├── glimpse/        # Shortcut glimpse routes\n│   │   ├── tasks/          # Task-related routes\n│   │   ├── views/          # User-facing views\n│   │   └── authCheck.ts    # Authentication middleware\n│   └── services/           # External service integrations\n├── frontend/               # Frontend assets\n├── shared/                 # Shared utilities\n└── main.tsx               # Application entry point\n```\n\n## Glimpse Routes\n\nThe application provides two equivalent routes for accessing page data:\n\n### Original Route\n- `GET /views/glimpse/:id` - Get page data by Notion page ID\n\n### Shortcut Route  \n- `GET /glimpse/:id` - Same functionality as above, shorter URL\n\nBoth routes:\n- Require user authentication\n- Use the same controller (`glimpseHandler`)\n- Return identical JSON responses\n- Filter out button properties from Notion page data\n\nThe dashboard displays both routes in a comparison table for easy testing.\n\n## Development\n\nThe application is built with:\n- **Hono**: Web framework for routing and middleware\n- **LastLogin**: Authentication service\n- **TypeScript**: Type-safe development\n- **Val Town**: Hosting platform\n\n## Webhook Authentication\n\nThe application supports webhook endpoints for external integrations (like Notion webhooks):\n\n### Configuration\n\nSet the webhook secret in your environment:\n```\nNOTION_WEBHOOK_SECRET=your-secret-key-here\n```\n\n### Webhook Endpoints\n\n- `POST /tasks/notion-webhook` - Main webhook endpoint for Notion integrations (requires `X-API-KEY` header)\n- `POST /tasks/url` - Updates Notion page URL property with glimpse URL (requires `X-API-KEY` header)\n- `POST /tasks/test` - Test endpoint for webhook authentication (requires `X-API-KEY` header)\n- `GET /tasks/debug-webhook` - Debug endpoint to check webhook configuration\n\n### Authentication\n\nWebhook endpoints require the `X-API-KEY` header:\n```bash\ncurl -X POST https://your-val.web.val.run/tasks/test \\\n  -H \"X-API-KEY: your-secret-key-here\"\n```\n\n### Testing\n\nUse the webhook testing form in the dashboard:\n1. Navigate to your dashboard at `/`\n2. Find the \"Webhook Endpoint\" section\n3. Enter your `NOTION_WEBHOOK_SECRET` value\n4. Click \"Test Webhook\" to verify authentication\n\n## Environment Variables\n\nConfigure these environment variables for full functionality:\n- `GLANCE_DEMOS_DB_ID` - Notion database ID for demos\n- `GLANCE_CONTENT_DB_ID` - Notion database ID for content\n- `GLANCE_INTERACTIONS_DB_ID` - Notion database ID for interactions\n- `NOTION_API_KEY` - Notion API key for database access\n- `NOTION_WEBHOOK_SECRET` - Secret key for webhook authentication",[290],"1b29ef46415c91d19d08b0e43d6ed1ded84f4f37f8a2146925c0a6ef48c00a27",{"_102":565,"_95":290,"_154":566,"_156":-5,"_157":136,"_158":135,"_160":161,"_104":567,"_99":141,"_163":175,"_165":568,"_166":22,"_167":-5,"_168":-7,"_98":672,"_658":673},[290],"78495da9f6ea7f39d3bb8b7d971f53e1106341aabc7273a9bb3c532ab97c6568",{"_98":675,"_654":676,"_655":684},"backend/controllers/README.md",{"_102":677,"_95":290,"_154":678,"_156":679,"_157":139,"_158":141,"_160":161,"_104":680,"_99":159,"_163":175,"_165":681,"_166":22,"_167":-5,"_168":-7,"_98":682,"_658":683},"868954ee-89b8-11f0-80ac-0224a6c84d84","0198a5c7-3d54-7604-b958-55b15bd85aa7","0198a5c7-3d54-7604-b958-635c71f8e891",["D",1757008607243],"# Controllers\n\nBusiness logic coordination between routes and services.\n\nControllers should:\n- Handle business logic and orchestration between services\n- Handle environment variables and configuration\n- Coordinate multiple service calls\n- Implement business rules and validation\n- Handle service business logic layer (result.success)\n\n## Examples\n\n### Webhook Handler Pattern (tasks.controller.ts)\n\nThe `handleUrlWebhook` function follows the webhook handler pattern:\n- Takes Hono Context as parameter\n- Returns HTTP responses directly\n- Handles webhook payload parsing and validation\n- Implements business logic for URL updates\n- Provides comprehensive logging and error handling\n\n### Data API Pattern (glimpse.controller.ts)\n\nThe `glimpseHandler` function follows the data API pattern:\n- Takes Hono Context as parameter\n- Returns JSON data responses\n- Filters and transforms service data\n- Handles error responses with appropriate status codes",[278,284,290],"3faf1893f2415b67f57fe24b8db6ae45d81d91d82e90757f9d157b7a998412c0",{"_102":289,"_95":290,"_154":291,"_156":285,"_157":136,"_158":135,"_160":161,"_104":292,"_99":141,"_163":175,"_165":293,"_166":22,"_167":-5,"_168":-7,"_98":685,"_658":686},[278,284,290],"b217b188d701e5cf5cb52ac64e0ee29276570a2fc59915769b5f1a515ff4c7fb",{"_98":688,"_654":689,"_655":696},"backend/controllers/glimpse.controller.ts",{"_102":690,"_95":307,"_154":691,"_156":679,"_157":139,"_158":159,"_160":161,"_104":692,"_99":32,"_163":301,"_165":693,"_166":22,"_167":-5,"_168":-7,"_98":694,"_658":695},"ca510054-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-5aa3d95b6f06",["D",1755127954709],"import { Context } from \"npm:hono@3.12.12\";\nimport { getPageById } from \"../services/notion.service.ts\";\n\nexport async function glimpseHandler(c: Context) {\n  const id = c.req.param(\"id\");\n\n  if (!id) {\n    return c.json({ error: \"Page ID is required\" }, 400);\n  }\n\n  const result = await getPageById(id);\n\n  if (!result.success) {\n    return c.json({ error: \"Failed to fetch page data\", details: result.error }, 500);\n  }\n\n  // Filter out button properties from the response\n  if (result.data?.properties) {\n    const filteredProperties = Object.fromEntries(\n      Object.entries(result.data.properties).filter(([key, value]) => value?.type !== \"button\")\n    );\n\n    result.data.properties = filteredProperties;\n  }\n\n  return c.json(result);\n}",[278,284,307],"1ab0a0534fbe3367f3d02d59355444d5a051698fdd336cc1f6c5b546bedaa119",{"_102":306,"_95":307,"_154":308,"_156":285,"_157":136,"_158":135,"_160":161,"_104":309,"_99":141,"_163":301,"_165":310,"_166":22,"_167":-5,"_168":-7,"_98":697,"_658":698},[278,284,307],"ee3394186a9a9d8fc3b978131d366cf74307deb79363886045fa3c1c0145edfe",{"_98":700,"_654":701,"_655":709},"backend/routes/README.md",{"_102":702,"_95":290,"_154":703,"_156":704,"_157":139,"_158":159,"_160":161,"_104":705,"_99":32,"_163":175,"_165":706,"_166":22,"_167":-5,"_168":-7,"_98":707,"_658":708},"ca513a7e-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-a2a00b1ce879","0198a5c7-3d54-7604-b958-ac58240e23a0",["D",1755127954709],"# Routes\n\nHTTP route handlers organized by functionality.\n\nEach route subdirectory should have a `_[directory_name].routes.ts` file that mounts routes for that section.\n\nRoutes should:\n- Handle HTTP request/response only\n- Call controllers, never services directly  \n- Have minimal logic - just HTTP concerns (parsing, validation, response formatting)",[278,346,290],"a00a6a2d710c50a603cd8b1323d370c3f884bd75eeae3fed9fad9d0b53538a79",{"_102":447,"_95":290,"_154":448,"_156":347,"_157":136,"_158":135,"_160":161,"_104":449,"_99":159,"_163":175,"_165":450,"_166":22,"_167":-5,"_168":-7,"_98":710,"_658":711},[278,346,290],"45e5adbc5619b9830f7a32e9d12d90bff4c547e474bdfea01e61a548de5c9265",{"_98":713,"_654":714,"_655":722},"backend/routes/api/README.md",{"_102":715,"_95":290,"_154":716,"_156":717,"_157":139,"_158":159,"_160":161,"_104":718,"_99":32,"_163":175,"_165":719,"_166":22,"_167":-5,"_168":-7,"_98":720,"_658":721},"ca510720-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-6c6744a10596","0198a5c7-3d54-7604-b958-76316ae974b1",["D",1755127954709],"# API Routes\n\nJSON API endpoints for frontend/backend communication.",[278,346,352,290],"36a22bb4083979c5789d080c72bb21d835a0771925681fbcffcb7fb3ac1edf2d",{"_102":357,"_95":290,"_154":358,"_156":353,"_157":136,"_158":135,"_160":161,"_104":359,"_99":159,"_163":175,"_165":360,"_166":22,"_167":-5,"_168":-7,"_98":723,"_658":724},[278,346,352,290],"bcc2053507ba7dd869d3f7e3e7500b8516d575d221f822659525f813b8dfdbab",{"_98":726,"_654":727,"_655":734},"backend/routes/api/_api.routes.ts",{"_102":728,"_95":365,"_154":729,"_156":717,"_157":139,"_158":159,"_160":161,"_104":730,"_99":32,"_163":301,"_165":731,"_166":22,"_167":-5,"_168":-7,"_98":732,"_658":733},"ca510806-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-718715b282c1",["D",1755127954709],"import { Hono } from \"npm:hono@3.12.12\";\nimport { getHealthStatus } from \"../../controllers/health.controller.ts\";\n\nconst app = new Hono();\n\napp.get(\"/health\", async (c) => {\n  const healthStatus = await getHealthStatus();\n  return c.json(healthStatus);\n});\n\nexport default app;",[278,346,352,365],"800bcbfd63b91db28ccd858d7648127be278dee173735cf9a6f7f8695b0e74ba",{"_102":364,"_95":365,"_154":366,"_156":353,"_157":136,"_158":135,"_160":161,"_104":367,"_99":159,"_163":301,"_165":368,"_166":22,"_167":-5,"_168":-7,"_98":735,"_658":736},[278,346,352,365],"b65af0cbdb0108e65a00edf1a52cdb5a1786e1c89baae6f097cd4fe4a7589fa9",{"_98":738,"_654":739,"_655":746},"backend/routes/authCheck.ts",{"_102":740,"_95":455,"_154":741,"_156":704,"_157":139,"_158":159,"_160":161,"_104":742,"_99":32,"_163":301,"_165":743,"_166":22,"_167":-5,"_168":-7,"_98":744,"_658":745},"ca513cea-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-a429bf0d0507",["D",1755127954709],"// Public routes that don't require authentication\nconst PUBLIC_ROUTES = [\n  \"/api/health\", // Health check endpoint should be publicly accessible\n  // Add other public routes here as needed\n  // '/demo/:id',  // Example: public demo viewing\n  // '/api/public', // Example: public API endpoints\n];\n\n// Helper function to check if a route is public\nfunction isPublicRoute(path: string): boolean {\n  return PUBLIC_ROUTES.some((route) => {\n    // Handle exact matches\n    if (route === path) return true;\n\n    // Handle wildcard patterns (basic implementation)\n    if (route.includes(\"*\")) {\n      const pattern = route.replace(\"*\", \".*\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    // Handle route parameters (basic implementation)\n    if (route.includes(\":\")) {\n      const pattern = route.replace(/:[^/]+/g, \"[^/]+\");\n      return new RegExp(`^${pattern}$`).test(path);\n    }\n\n    return false;\n  });\n}\n\nexport default async (c, next) => {\n  // Allow public routes to bypass authentication\n  if (isPublicRoute(c.req.path)) {\n    await next();\n    return;\n  }\n\n  const email = c.req.header(\"X-LastLogin-Email\");\n\n  if (!email) {\n    // Show login page if not authenticated\n    return c.html(`\n      \n      \n      \n        Glance Demos - Login Required\n        \n        \n      \n      \n        \n          Sign in to Glance Demos
\n          Sign in to access your dashboard and manage your demos.
\n          \n            Loading login button...
\n          
\n          \n            via LastLogin\n          
\n        
\n\n        \n      \n      \n    `);\n  }\n\n  // If authenticated, store email in context for use by routes\n  c.set(\"userEmail\", email);\n\n  // Continue to the next middleware/route\n  await next();\n};",[278,346,455],"80f816d2683dd86735379ef5d6857d64cb04bde21eb8a6d8af8d2afdfa92a714",{"_102":454,"_95":455,"_154":456,"_156":347,"_157":136,"_158":135,"_160":161,"_104":457,"_99":159,"_163":301,"_165":458,"_166":22,"_167":-5,"_168":-7,"_98":747,"_658":748},[278,346,455],"8c1570b2bac496fd8ea259fd5d70895712a8bbe2a13a66be21441cfc50d5fe35",{"_98":750,"_654":751,"_655":759},"backend/routes/glimpse/README.md",{"_102":752,"_95":290,"_154":753,"_156":754,"_157":139,"_158":159,"_160":161,"_104":755,"_99":32,"_163":175,"_165":756,"_166":22,"_167":-5,"_168":-7,"_98":757,"_658":758},"ca5109c8-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-7b82aa13df07","0198a5c7-3d54-7604-b958-838454795c53",["D",1755127954709],"# Glimpse Routes\n\nThis module provides a shortcut route for accessing glimpse functionality.\n\n## Route\n\n- **GET** `/:id` - Get page data by ID (equivalent to `/views/glimpse/:id`)\n\n## Authentication\n\n- Requires user authentication via `authCheck` middleware\n- Same authentication requirements as the original `/views/glimpse/:id` route\n\n## Parameters\n\n- `id` (string, required) - The Notion page ID to retrieve\n\n## Response\n\nReturns JSON response with page data from Notion API, with button properties filtered out.\n\n## Usage\n\nThis route provides the same functionality as `/views/glimpse/:id` but with a shorter URL path:\n- Original: `/views/glimpse/{page-id}`\n- Shortcut: `/glimpse/{page-id}`\n\nBoth routes use the same controller and return identical responses.",[278,346,374,290],"15e3ff40f37b52f3ff644451c560df81c875e780dfa570c076fa450fb347ff86",{"_102":379,"_95":290,"_154":380,"_156":375,"_157":136,"_158":141,"_160":161,"_104":381,"_99":159,"_163":175,"_165":382,"_166":22,"_167":-5,"_168":-7,"_98":760,"_658":761},[278,346,374,290],"62813291d38122dbabc460cc99a2cd6ee233687b91c0f218d76d3a179b3a56a3",{"_98":763,"_654":764,"_655":771},"backend/routes/glimpse/_glimpse.routes.ts",{"_102":765,"_95":387,"_154":766,"_156":754,"_157":139,"_158":159,"_160":161,"_104":767,"_99":32,"_163":301,"_165":768,"_166":22,"_167":-5,"_168":-7,"_98":769,"_658":770},"ca510bc6-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-7d434e066c27",["D",1755127954709],"import { Hono } from \"npm:hono@3.12.12\";\nimport { glimpseHandler } from \"../../controllers/glimpse.controller.ts\";\n\nconst app = new Hono();\napp.get(\"/:id\", glimpseHandler);\nexport default app;",[278,346,374,387],"6b3da79f76dfec795c7daf36bfc171b3097255749326d4ba131a35165730fb73",{"_102":386,"_95":387,"_154":388,"_156":375,"_157":136,"_158":135,"_160":161,"_104":389,"_99":141,"_163":301,"_165":390,"_166":22,"_167":-5,"_168":-7,"_98":772,"_658":773},[278,346,374,387],"08c681b009b4f73d5fa6091b161df3fe57edcaf8d7894c69eb2e41bf880982d1",{"_98":775,"_654":776,"_655":784},"backend/routes/views/README.md",{"_102":777,"_95":290,"_154":778,"_156":779,"_157":139,"_158":159,"_160":161,"_104":780,"_99":32,"_163":175,"_165":781,"_166":22,"_167":-5,"_168":-7,"_98":782,"_658":783},"ca5126f6-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-938ae8589df0","0198a5c7-3d54-7604-b958-9ecc2022c2a2",["D",1755127954709],"# View Routes\n\nServer-side rendered views for frontend.\n\n## Endpoints\n\n### GET /views/glimpse/:id\n\n- **Purpose**: Returns Notion page data as JSON (filtered for data consumption)\n- **Authentication**: Required (Google OAuth)\n- **Parameters**: `id` - Notion page ID\n- **Response**: Service response object with Notion page data (button properties removed)\n- **Filtering**: Removes UI-specific properties (type: \"button\") for cleaner data consumption",[278,346,418,290],"b27416921c2491440af29cb2a69695ba008b4944a2b110b865ecf4797ae15999",{"_102":423,"_95":290,"_154":424,"_156":419,"_157":136,"_158":135,"_160":161,"_104":425,"_99":159,"_163":175,"_165":426,"_166":22,"_167":-5,"_168":-7,"_98":785,"_658":786},[278,346,418,290],"561020ba90bffad1e7484724bfc47dd66d11490286e853399de64e14793c0fbf",{"_98":788,"_654":789,"_655":796},"backend/routes/views/_views.routes.ts",{"_102":790,"_95":431,"_154":791,"_156":779,"_157":139,"_158":159,"_160":161,"_104":792,"_99":32,"_163":301,"_165":793,"_166":22,"_167":-5,"_168":-7,"_98":794,"_658":795},"ca5128e0-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-966c72f8aea6",["D",1755127954709],"import { Hono } from \"npm:hono@3.12.12\";\nimport { glimpseHandler } from \"../../controllers/glimpse.controller.ts\";\n\nconst app = new Hono();\n\napp.get(\"/glimpse/:id\", glimpseHandler);\n\nexport default app;",[278,346,418,431],"f958fa377ba128bf6574d0231f68689570468e7e35321ea7f83ac230449cc884",{"_102":430,"_95":431,"_154":432,"_156":419,"_157":136,"_158":135,"_160":161,"_104":433,"_99":159,"_163":301,"_165":434,"_166":22,"_167":-5,"_168":-7,"_98":797,"_658":798},[278,346,418,431],"1f1203cf777a4ecf56450752a328ebe36cde7905a7bdcafdfb06a81fc0698135",{"_98":800,"_654":801,"_655":808},"backend/routes/views/dashboard.tsx",{"_102":802,"_95":439,"_154":803,"_156":779,"_157":139,"_158":159,"_160":161,"_104":804,"_99":32,"_163":301,"_165":805,"_166":22,"_167":-5,"_168":-7,"_98":806,"_658":807},"ca512b6a-789d-11f0-a6af-0224a6c84d84","0198a5c7-3d54-7604-b958-99fe77564700",["D",1755127954709],"import { getHealthStatus } from \"../../controllers/health.controller.ts\";\nimport { getDatabasePages } from \"../../services/notion.service.ts\";\n\nexport default async (c) => {\n  const userEmail = c.get(\"userEmail\");\n  \n  // Fetch health status for display\n  const healthData = await getHealthStatus();\n\n  // Fetch demo database pages for glimpse endpoints\n  const demoDatabaseId = Deno.env.get(\"GLANCE_DEMOS_DB_ID\");\n  let demoPages = [];\n  let demoPagesError = null;\n  \n  if (demoDatabaseId) {\n    const demoPagesResult = await getDatabasePages(demoDatabaseId);\n    if (demoPagesResult.success) {\n      demoPages = demoPagesResult.data.results || [];\n    } else {\n      demoPagesError = demoPagesResult.error;\n    }\n  }\n\n  // Check webhook configuration\n  const webhookSecret = Deno.env.get(\"NOTION_WEBHOOK_SECRET\");\n  const webhookConfigured = !!webhookSecret;\n  const webhookEndpoint = `${c.req.url.split('/')[0]}//${c.req.url.split('/')[2]}/tasks/notion-webhook`;\n\n  return c.html(`\n    \n    \n    \n      Glance Demos - Dashboard\n      \n      \n    \n    \n      \n        \n          Glance Demos Dashboard
\n          \n            Welcome, ${userEmail}\n            Logout\n          
\n        
\n        \n        \n          \n            Welcome to your dashboard!
\n            You are successfully authenticated and can access all features of the Glance Demos application.
\n          
\n          \n          \n            \n              System Health Status \n              \n                ${healthData.status}\n              \n            
\n            ${JSON.stringify(healthData, null, 2)}
\n          
\n\n          \n            🔍 Demo API Endpoints
\n            \n            ${demoDatabaseId ? `\n              ${demoPages.length > 0 ? `\n                Test the glimpse endpoints with these demo pages. Both routes return identical responses:
\n                \n                  \n                    \n                      \n                      \n                      \n                    \n                  \n                  \n                    ${demoPages.map(page => {\n                      const pageTitle = page.properties?.Name?.title?.[0]?.plain_text || \n                                       page.properties?.Title?.title?.[0]?.plain_text || \n                                       'Untitled Page';\n                      const baseUrl = `${c.req.url.split('/')[0]}//${c.req.url.split('/')[2]}`;\n                      const originalUrl = `${baseUrl}/views/glimpse/${page.id}`;\n                      const shortcutUrl = `${baseUrl}/glimpse/${page.id}`;\n                      return `\n                        \n                          \n                          \n                          \n                        \n                      `;\n                    }).join('')}\n                  \n                Name Original Route New Shortcut Route
📄 ${pageTitle} \n                            /views/glimpse/${page.id}\n                          \n                            /glimpse/${page.id}\n                          
\n              ` : `\n                ${demoPagesError ? `\n                  ❌ Error loading demo pages: ${demoPagesError}
\n                ` : `\n                  No demo pages found in the configured database.
\n                `}\n              `}\n            ` : `\n              Demo database not configured. Set GLANCE_DEMOS_DB_ID environment variable.
\n            `}\n          
\n\n          \n            Webhook Endpoint
\n\n            \n              ${webhookEndpoint}
\n            
\n\n            \n              To test: Get the NOTION_WEBHOOK_SECRET value from your vars.env file (provided by your administrator)
\n              \n                \n                \n              
\n              Ready to test webhook authentication...
\n            
\n          
\n        
\n      
\n\n      \n    \n    >\n  `);\n};",[278,346,418,439],"b0991104101a613767f05874dd62442078e1808c879b0fa96ef95449206f16ae",{"_102":438,"_95":439,"_154":440,"_156":419,"_157":136,"_158":135,"_160":161,"_104":441,"_99":159,"_163":301,"_165":442,"_166":22,"_167":-5,"_168":-7,"_98":809,"_658":810},[278,346,418,439],"2fde98b971b83a88e7651dd56b41aeb0417034216c0a4313ce7d3350f7217851",{"_98":812,"_654":813,"_655":821},"backend/services/README.md",{"_102":814,"_95":290,"_154":815,"_156":816,"_157":139,"_158":141,"_160":161,"_104":817,"_99":159,"_163":175,"_165":818,"_166":22,"_167":-5,"_168":-7,"_98":819,"_658":820},"86895962-89b8-11f0-80ac-0224a6c84d84","0198a5c7-3d54-7604-b958-b2157732f0eb","0198a5c7-3d54-7604-b958-bb39d23ee6fc",["D",1757008607243],"# Services\n\nExternal API integrations (pure API calls only).\n\nServices should:\n- Be single-purpose functions that make direct API calls to external systems\n- Be pure functions that handle HTTP transport layer (response.ok)\n- Return consistent `{ success: boolean, data?: any, error?: string }` format\n- NOT handle environment variables, business logic, or orchestrate multiple calls\n\n## Examples\n\n### Notion Service Functions\n\n- `updatePageUrl(pageId, url)` - Updates a Notion page's URL property\n- `getPageById(pageId)` - Retrieves a single Notion page\n- `getDatabaseById(databaseId)` - Retrieves a Notion database\n- `getDatabasePages(databaseId)` - Queries pages from a Notion database\n- `getDatabases()` - Lists all accessible Notion databases\n\nAll functions return the standard `{success, data/error, timestamp}` format.",[278,472,290],"e9b4565fecc49b3caa767290be2607c7c6277fd7838c2a067eab60202e1e5b72",{"_102":477,"_95":290,"_154":478,"_156":473,"_157":136,"_158":135,"_160":161,"_104":479,"_99":141,"_163":175,"_165":480,"_166":22,"_167":-5,"_168":-7,"_98":822,"_658":823},[278,472,290],"f46ac74bd37afc5084e6ea47aa797a59dd9fb5ae2c975d0ff8c73eed3a4f02ab",{"_98":825,"_654":826,"_655":833},"backend/services/notion.service.ts",{"_102":827,"_95":485,"_154":828,"_156":816,"_157":139,"_158":141,"_160":161,"_104":829,"_99":159,"_163":301,"_165":830,"_166":22,"_167":-5,"_168":-7,"_98":831,"_658":832},"86895a66-89b8-11f0-80ac-0224a6c84d84","0198a5c7-3d54-7604-b958-b533fff0c190",["D",1757008607243],"import { Client } from \"npm:@notionhq/client\";\n\nconst notion = new Client({ auth: Deno.env.get(\"NOTION_API_KEY\") });\n\nexport async function getDatabases() {\n  try {\n    const response = await notion.search({\n      filter: {\n        property: \"object\",\n        value: \"database\"\n      }\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function getDatabaseById(databaseId: string) {\n  try {\n    const response = await notion.databases.retrieve({\n      database_id: databaseId,\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function getPageById(pageId: string) {\n  try {\n    const response = await notion.pages.retrieve({\n      page_id: pageId,\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function getDatabasePages(databaseId: string) {\n  try {\n    const response = await notion.databases.query({\n      database_id: databaseId,\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}\n\nexport async function updatePageUrl(pageId: string, url: string) {\n  try {\n    const response = await notion.pages.update({\n      page_id: pageId,\n      properties: {\n        \"URL\": {\n          url: url\n        }\n      }\n    });\n    return {\n      success: true,\n      data: response,\n      timestamp: new Date().toISOString(),\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message,\n      timestamp: new Date().toISOString(),\n    };\n  }\n}",[278,472,485],"0a472a5a96610cea18b9e22147f21d733c358a4dc5bdd4f3bb3e5119655e4c3f",{"_102":484,"_95":485,"_154":486,"_156":473,"_157":136,"_158":135,"_160":161,"_104":487,"_99":141,"_163":301,"_165":488,"_166":22,"_167":-5,"_168":-7,"_98":834,"_658":835},[278,472,485],"1a04c8a284d44f24c377b51a64d9d58fad21981fa84f5eb169b2899e92f5e1e3","hasChanges","sourceBranch","targetBranch",{"_102":139,"_104":840,"_630":841,"_95":43,"_137":144,"_99":141,"_138":632,"_140":135,"_633":634,"_106":-5,"_148":22,"_108":109,"_147":94,"_16":117,"_146":625},["D",1755127954709],["D",1757008607243],"pull","actionData","errors"]
lightweight

glimpse2-runbook-view-glimpse-save-login

Mergeglimpse2-runbook-view-glimpse-save-login/mainintoglimpse2-runbook-view-glimpse-save/main

README.md+128-8

backend/controllers/README.md+239-20

backend/controllers/glimpse.controller.ts+316-15

backend/routes/README.md+297-4

backend/routes/api/README.md+169-1

backend/routes/api/_api.routes.ts+30-0

backend/routes/authCheck.ts+54-0

backend/routes/glimpse/README.md+58-9

backend/routes/glimpse/_glimpse.routes.ts+20-2

backend/routes/views/README.md+179-6

backend/routes/views/_views.routes.ts+43-2

backend/routes/views/dashboard.tsx+52-14

backend/services/README.md+180-13

backend/services/notion.service.ts+128-0

backend/controllers/demo.controller.ts+75-0
