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",[],[154,182],{"_103":189,"_95":190,"_155":191,"_157":156,"_158":137,"_159":160,"_161":162,"_105":192,"_100":32,"_164":176,"_166":193,"_167":22,"_168":-5,"_169":194,"_98":195},"8e5ee3c0-8aa1-11f0-95bf-0224a6c84d84","02-auth.md","01991bd6-e87d-71bd-b756-f0bfad0484d7",["D",1757108693058],"# 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",[],[154,190],{"_103":197,"_95":198,"_155":199,"_157":156,"_158":137,"_159":160,"_161":162,"_105":200,"_100":32,"_164":176,"_166":201,"_167":22,"_168":-5,"_169":202,"_98":203},"8e5eeb72-8aa1-11f0-95bf-0224a6c84d84","03-webhooks.md","01991bd6-e87d-71bd-b756-f53d3ee48f9e",["D",1757108693058],"# 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",[],[154,198],{"_103":205,"_95":206,"_155":207,"_157":156,"_158":137,"_159":160,"_161":162,"_105":208,"_100":32,"_164":176,"_166":209,"_167":22,"_168":-5,"_169":210,"_98":211},"8e5efc34-8aa1-11f0-95bf-0224a6c84d84","04-view.md","01991bd6-e87d-71bd-b756-f8aabf58c3fc",["D",1757108693058],"# 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`",[],[154,206],{"_103":213,"_95":214,"_155":215,"_157":156,"_158":137,"_159":160,"_161":162,"_105":216,"_100":32,"_164":176,"_166":217,"_167":22,"_168":-5,"_169":218,"_98":219},"8e5f0724-8aa1-11f0-95bf-0224a6c84d84","05-glimpse.md","01991bd6-e87d-71bd-b756-ffc4bd632024",["D",1757108693058],"# 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",[],[154,214],{"_103":221,"_95":222,"_155":223,"_157":156,"_158":137,"_159":160,"_161":162,"_105":224,"_100":32,"_164":176,"_166":225,"_167":22,"_168":-5,"_169":226,"_98":227},"8e5f0c4c-8aa1-11f0-95bf-0224a6c84d84","06-link.md","01991bd6-e87d-71bd-b757-0047af259ce2",["D",1757108693058],"# 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",[],[154,222],{"_103":229,"_95":230,"_155":231,"_157":156,"_158":137,"_159":160,"_161":162,"_105":232,"_100":32,"_164":176,"_166":233,"_167":22,"_168":-5,"_169":234,"_98":235},"8e5f0fd0-8aa1-11f0-95bf-0224a6c84d84","07-save.md","01991bd6-e87d-71bd-b757-06383f105ab9",["D",1757108693058],"# 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`",[],[154,230],{"_103":237,"_95":238,"_155":239,"_157":156,"_158":137,"_159":160,"_161":162,"_105":240,"_100":32,"_164":176,"_166":241,"_167":22,"_168":-5,"_169":242,"_98":243},"8e5f17c8-8aa1-11f0-95bf-0224a6c84d84","08-related.md","01991bd6-e87d-71bd-b757-0818541587e9",["D",1757108693058],"# 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",[],[154,238],{"_103":245,"_95":246,"_155":247,"_157":156,"_158":137,"_159":160,"_161":162,"_105":248,"_100":32,"_164":176,"_166":249,"_167":22,"_168":-5,"_169":250,"_98":251},"8e5f26dc-8aa1-11f0-95bf-0224a6c84d84","09-cache.md","01991bd6-e87d-71bd-b757-0d1185a7b6c3",["D",1757108693058],"# 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",[],[154,246],{"_103":253,"_95":254,"_155":255,"_157":156,"_158":137,"_159":160,"_161":162,"_105":256,"_100":32,"_164":176,"_166":257,"_167":22,"_168":-5,"_169":258,"_98":259},"8e5f34d8-8aa1-11f0-95bf-0224a6c84d84","10-react.md","01991bd6-e87d-71bd-b757-13a214c449d9",["D",1757108693058],"# 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",[],[154,254],{"_103":261,"_95":262,"_155":263,"_157":156,"_158":137,"_159":160,"_161":162,"_105":264,"_100":32,"_164":176,"_166":265,"_167":22,"_168":-5,"_169":266,"_98":267},"8e5f436a-8aa1-11f0-95bf-0224a6c84d84","11-html.md","01991bd6-e87d-71bd-b757-16737941eda1",["D",1757108693058],"# 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",[],[154,262],{"_103":269,"_95":270,"_155":271,"_157":156,"_158":137,"_159":160,"_161":162,"_105":272,"_100":32,"_164":176,"_166":273,"_167":22,"_168":-5,"_169":274,"_98":275},"8e5f621e-8aa1-11f0-95bf-0224a6c84d84","12-embed.md","01991bd6-e87d-71bd-b757-1be3e2b42035",["D",1757108693058],"# 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",[],[154,270],[154],{"_103":278,"_95":279,"_155":280,"_157":-5,"_158":137,"_159":160,"_161":162,"_105":281,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":282,"_98":670},"8e5fca74-8aa1-11f0-95bf-0224a6c84d84","backend","01991bd6-e87d-71bd-b757-a7fc62cdd2f6",["D",1757108693058],[283,355,388,533,595,609,663],{"_103":284,"_95":285,"_155":286,"_157":280,"_158":137,"_159":160,"_161":162,"_105":287,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":288,"_98":354},"8e5f7c18-8aa1-11f0-95bf-0224a6c84d84","controllers","01991bd6-e87d-71bd-b757-3597d588027a",["D",1757108693058],[289,298,308,317,326,335,344],{"_103":290,"_95":291,"_155":292,"_157":286,"_158":137,"_159":293,"_161":162,"_105":294,"_100":160,"_164":176,"_166":295,"_167":22,"_168":-5,"_169":296,"_98":297},"2af47c12-8e8b-11f0-9e5d-0224a6c84d84","README.md","01991bd6-e87d-71bd-b757-20757806ed3e",9,["D",1757538882052],"# Controllers\n\nBusiness logic, workflow orchestration, and HTTP handling.\n\n## Separation of Concerns\n\nControllers are the **business logic layer** that:\n- **Implement business workflows and rules** - Complex multi-step processes\n- **Orchestrate multiple service calls** - Coordinate external operations\n- **Handle data transformation** - Prepare data for different layers\n- **Manage error handling** - Complex multi-step operation failures\n- **Use utility functions** - Pure functions for data processing\n- **Handle environment variables** - Application configuration\n- **Return structured data objects** - Consistent response formats\n\nControllers do NOT:\n- Make direct external API calls (use services instead)\n- Implement pure utility functions (use utils instead)\n- Handle HTTP routing concerns (routes handle this)\n\n## How Controllers Use Other Layers\n\n### **Controllers Orchestrate Services and Utils**\n```typescript\n// Controller coordinates services and uses utils\nexport async function processAgentAssignment(pageId: string, personId: string) {\n  // 1. SERVICE: Get external data\n  const agentsResult = await findAgentsByPersonId(databaseId, personId);\n  \n  // 2. UTIL: Transform/validate data\n  const cleanedAgents = validateAgentData(agentsResult.data);\n  \n  // 3. SERVICE: Store processed data\n  const blobResult = await setAgentBlob(pageId, cleanedAgents);\n  \n  // 4. BUSINESS LOGIC: Decide what to return\n  return {\n    success: true,\n    data: { agentsProcessed: cleanedAgents.length }\n  };\n}\n```\n\n### **Clear Layer Responsibilities**\n- **Services**: \"I need to talk to Notion API\" → `getPageById(pageId)`\n- **Utils**: \"I need to format this data\" → `formatAgentProperties(data)`\n- **Controllers**: \"I need to implement this business workflow\" → Orchestrate both\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**Example: `getDemoProperties(id: string)`**\n\n```typescript\nexport async function getDemoProperties(id: string) {\n  // 1. Validation (business rule)\n  if (!id) {\n    return { success: false, error: \"Page ID is required\", data: null };\n  }\n\n  // 2. SERVICE: Get external data\n  const result = await getPageById(id);\n  if (!result.success) {\n    return { success: false, error: result.error, data: null };\n  }\n\n  // 3. BUSINESS LOGIC: Filter sensitive data\n  const filteredProperties = Object.fromEntries(\n    Object.entries(result.data.properties).filter(\n      ([_, property]) => property.type !== \"button\"\n    )\n  );\n\n  // 4. Return processed data\n  return {\n    success: true,\n    data: { ...result.data, properties: filteredProperties },\n    error: null\n  };\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: Complex Webhook Handler**\n\nThe `/tasks/assign` webhook demonstrates sophisticated business logic orchestration:\n\n```typescript\nexport async function handleAssignWebhook(c: Context) {\n  // PHASE 1: Data Collection (No Side Effects)\n  // - Fetch all required data before making changes\n  // - Validate all data collection succeeded\n  \n  // PHASE 2: Atomic Updates (All or Nothing)  \n  // - Selective clearing based on business rules\n  // - Update Notion relations\n  \n  // PHASE 3: Non-Critical Updates (Blob Storage)\n  // - Transform data for storage\n  // - Update blob (non-blocking)\n}\n```\n\n## Business Logic Examples\n\n### **Complex Workflow Management**\nThe assignment webhook implements a sophisticated 3-phase workflow:\n\n1. **Data Collection Phase**: Fetch all agent data with no side effects\n2. **Selective Clearing Logic**: Only clear agents assigned to OTHER demos\n3. **Atomic Updates**: Coordinate multiple Notion operations\n4. **Non-Critical Storage**: Update blob storage without failing workflow\n\n### **Smart Decision Making**\n```typescript\n// Business logic: Decide whether to clear agent assignments\nif (otherDemoAssignments.length > 0) {\n  console.log(`Agent has assignments to other demos - clearing needed`);\n  shouldClear = true;\n} else if (currentDemoIds.includes(pageId)) {\n  console.log(`Agent already assigned to this demo only - no clearing needed`);\n} else {\n  console.log(`Agent has no current assignments - no clearing needed`);\n}\n```\n\n### **Data Transformation**\n```typescript\n// Transform agent data for blob storage (business requirement)\nconst cleanedAgents = agentDataCollection.map(agentData => ({\n  agentId: agentData.agentId,\n  agentName: agentData.agentName,\n  agentEmail: agentData.agentEmail,\n  agentMeetUrl: agentData.agentMeetUrl,\n  agentPhone: agentData.agentPhone\n  // Exclude agentPageData (full Notion object) from storage\n}));\n```\n\n### **Error Recovery Strategies**\n```typescript\n// Business logic: Handle partial failures gracefully\nif (!dataCollectionSuccess) {\n  console.error(\"Data collection failed, aborting to prevent inconsistent state\");\n  return c.json({\n    success: false,\n    error: \"Failed to collect complete agent data\",\n    details: dataCollectionError\n  }, 500);\n}\n```\n\n### **Property Extraction Logic**\n```typescript\n// Business logic: Extract agent properties from various Notion property types\nfunction extractAgentProperties(agentPage: any) {\n  // Handle multiple property names and types\n  // Apply business rules for property extraction\n  // Return standardized agent data structure\n}\n```\n\n## Controller Types\n\n### **Demo Controllers** (`demo.controller.ts`)\n- Page data retrieval and filtering\n- Business rule: Remove button properties\n- Data transformation for frontend consumption\n\n### **Tasks Controllers** (`tasks.controller.ts`)\n- Complex webhook processing workflows\n- Multi-phase assignment logic\n- Selective clearing based on business rules\n- Blob storage coordination\n\n### **Viewing Controllers** (`viewing.controller.ts`)\n- Real-time viewing status management\n- Session tracking and cleanup\n- Notion synchronization coordination\n\n### **Glimpse Controllers** (`glimpse.controller.ts`)\n- User authentication workflows\n- Database user management\n- URL validation and redirection logic\n- HTML response generation for user flows\n\n## Best Practices\n\n### **Workflow Orchestration**\n- Implement complex business processes as multi-phase operations\n- Validate all required data before making changes\n- Handle partial failures gracefully\n- Provide detailed logging for debugging\n\n### **Service Coordination**\n- Use services for all external operations\n- Use utils for all data transformation\n- Implement business logic in controllers\n- Return consistent response structures\n\n### **Error Handling**\n- Provide user-friendly error messages\n- Include technical details for debugging\n- Handle edge cases and partial failures\n- Log comprehensive error context\n\n### **Data Management**\n- Transform data according to business requirements\n- Filter sensitive information before returning\n- Validate data integrity and consistency\n- Handle different data formats and structures",[],[279,285,291],{"_103":299,"_95":300,"_155":301,"_157":286,"_158":137,"_159":302,"_161":162,"_105":303,"_100":32,"_164":304,"_166":305,"_167":22,"_168":-5,"_169":306,"_98":307},"b0e607d4-8e93-11f0-84d4-0224a6c84d84","agent.controller.ts","b0e60874-8e93-11f0-84d4-0224a6c84d84",10,["D",1757542542749],"script","import { getAgentBlob } from \"../services/blob.service.ts\";\n\n/**\n * Agent controller - handles agent-related operations\n */\n\nexport interface AgentControllerResponse {\n  success: boolean;\n  data?: T;\n  error?: string;\n  details?: string;\n}\n\n/**\n * Get agent data for a specific page\n */\nexport async function getAgentData(pageId: string): Promise {\n  if (!pageId) {\n    return {\n      success: false,\n      error: \"Page ID is required\"\n    };\n  }\n\n  try {\n    const result = await getAgentBlob(pageId);\n    \n    if (!result.success) {\n      return {\n        success: false,\n        error: \"Agent data not found\",\n        details: result.error\n      };\n    }\n\n    return {\n      success: true,\n      data: result.data\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: \"Failed to fetch agent data\",\n      details: error.message\n    };\n  }\n}",[],[279,285,300],{"_103":309,"_95":310,"_155":311,"_157":286,"_158":137,"_159":293,"_161":162,"_105":312,"_100":313,"_164":304,"_166":314,"_167":22,"_168":-5,"_169":315,"_98":316},"2af48388-8e8b-11f0-9e5d-0224a6c84d84","demo.controller.ts","01991bd6-e87d-71bd-b757-26434686446b",["D",1757538882052],2,"import { getPageById, getPageWithBlocks } from \"../services/notion/index.ts\";\nimport { isNotEmpty } from \"../utils/validation.helpers.ts\";\n\n// Controller function - returns plain data, no HTTP concerns\nexport async function getDemoProperties(id: string) {\n  if (!isNotEmpty(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 (!isNotEmpty(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}",[],[279,285,310],{"_103":318,"_95":319,"_155":320,"_157":286,"_158":137,"_159":321,"_161":162,"_105":322,"_100":142,"_164":304,"_166":323,"_167":22,"_168":-5,"_169":324,"_98":325},"2f46af72-9261-11f0-a315-0224a6c84d84","glimpse.controller.ts","01991bd6-e87d-71bd-b757-2988cec1f031",37,["D",1757960655094],"import { Context } from \"npm:hono@3.12.12\";\nimport {\n  createUserRecord,\n  findUserByEmail,\n} from \"../services/notion/index.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 Path from the first result\n    const userRecord = result.data.results[0];\n    const properties = userRecord.properties;\n\n    // Look for Path property only (always a formula)\n    let redirectPath = null;\n    let pathPropertyType = null;\n\n    if (properties[\"Path\"]) {\n      const prop = properties[\"Path\"];\n      pathPropertyType = prop.type;\n\n      // Extract path from formula property\n      if (prop.type === \"formula\" && prop.formula && prop.formula.string) {\n        redirectPath = prop.formula.string;\n      }\n    }\n\n    // If no Path found or Path is empty\n    if (!redirectPath || redirectPath.trim() === \"\") {\n      return c.json({\n        error: \"No valid Path found for user\",\n        details: \"User record exists but no valid Path property found\",\n        userEmail: userEmail,\n        pathPropertyType: pathPropertyType,\n        availableProperties: Object.keys(properties),\n        userRecord: userRecord,\n      }, 400);\n    }\n\n    // Validate path format - should be /glimpse/:id\n    if (!redirectPath.startsWith(\"/glimpse/\") || redirectPath === \"/glimpse/\") {\n      return c.json({\n        error: \"Invalid Path format\",\n        details: `Path \"${redirectPath}\" must be in format /glimpse/:id`,\n        userEmail: userEmail,\n        pathPropertyType: pathPropertyType,\n        redirectPath: redirectPath,\n      }, 400);\n    }\n\n    // Success - redirect to the user's path\n    return c.redirect(redirectPath);\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}",[],[279,285,319],{"_103":327,"_95":328,"_155":329,"_157":286,"_158":137,"_159":330,"_161":162,"_105":331,"_100":313,"_164":304,"_166":332,"_167":22,"_168":-5,"_169":333,"_98":334},"06721eca-8e78-11f0-a55a-0224a6c84d84","health.controller.ts","01991bd6-e87d-71bd-b757-2c9c74b492ea",8,["D",1757530660365],"import { getDatabaseById } from \"../services/notion/index.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  const agentsDbId = Deno.env.get(\"GLANCE_AGENTS_DB_ID\");\n\n  const databases = { demos: null, content: null, interactions: null, agents: 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  // Check agents database\n  if (agentsDbId) {\n    const result = await getDatabaseById(agentsDbId);\n    if (result.success) {\n      databases.agents = result.data;\n    } else {\n      errors.push(`Agents DB: ${result.error}`);\n    }\n  } else {\n    errors.push(\"GLANCE_AGENTS_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      agents: databasesResult.data.agents ? \"connected\" : \"error\"\n    }\n  };\n\n  if (databasesResult.errors) {\n    healthStatus.errors = databasesResult.errors;\n  }\n\n  return healthStatus;\n}",[],[279,285,328],{"_103":336,"_95":337,"_155":338,"_157":286,"_158":137,"_159":136,"_161":162,"_105":339,"_100":340,"_164":304,"_166":341,"_167":22,"_168":-5,"_169":342,"_98":343},"59a2b5da-94b0-11f0-a75b-0224a6c84d84","tasks.controller.ts","01991bd6-e87d-71bd-b757-32dbd347d1d2",["D",1758214558721],7,"import { Context } from \"npm:hono@3.12.12\";\nimport { updatePageUrl, getPageById, updateGlimpseAgentsProperty } from \"../services/notion/index.ts\";\nimport { setAgentBlob, getAgentBlob, listAgentBlobs, getBlobData, setBlobData } from \"../services/blob.service.ts\";\nimport { extractAgentProperties, extractTextFromNotionProperty } from \"../utils/notion.helpers.ts\";\nimport { sendVisitorDemoLink } from \"../services/email.service.ts\";\nimport type { EmailAgentInfo } from \"../../shared/types.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}\n\nexport async function handleAssignWebhook(c: Context) {\n  console.log(\"Processing task assignment 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    console.log(\"Page ID:\", pageId);\n\n    // Get the page properties to extract the Person property\n    const pageResult = await getPageById(pageId);\n    \n    if (!pageResult.success) {\n      console.error(\"Failed to fetch page data:\", pageResult.error);\n      return c.json({ \n        success: false, \n        error: \"Failed to fetch page data\", \n        details: pageResult.error \n      }, 500);\n    }\n\n    console.log(\"Proceeding with assignment for page:\", pageId);\n\n    // Extract Glimpse agents property from page properties\n    const glimpseAgentsProperty = pageResult.data?.properties?.[\"Glimpse agents\"];\n    \n    if (!glimpseAgentsProperty) {\n      console.log(\"No Glimpse agents property found on page:\", pageId);\n      return c.json({\n        success: true,\n        message: \"No Glimpse agents property found on page - no assignment needed\",\n        pageId: pageId,\n        timestamp: new Date().toISOString()\n      });\n    }\n\n    console.log(\"Glimpse agents property object:\", glimpseAgentsProperty);\n\n    // Extract agent ID from the Glimpse agents relation property\n    let agentId: string | undefined;\n    \n    if (glimpseAgentsProperty.relation && glimpseAgentsProperty.relation.length > 0) {\n      agentId = glimpseAgentsProperty.relation[0].id;\n    }\n\n    if (!agentId) {\n      console.log(\"No agent ID found in Glimpse agents property:\", glimpseAgentsProperty);\n      return c.json({\n        success: true,\n        message: \"No agent ID found in Glimpse agents property - no assignment needed\",\n        pageId: pageId,\n        timestamp: new Date().toISOString()\n      });\n    }\n\n    console.log(\"Extracted agent ID:\", agentId);\n\n    try {\n      // STEP 1: Collect agent data for the single agent\n      console.log(\"=== STEP 1: Collecting Agent Data ===\");\n      console.log(`Fetching complete agent data for agent ${agentId}...`);\n      \n      let agentDataCollection = [];\n      let dataCollectionSuccess = true;\n      let dataCollectionError = null;\n\n      try {\n        console.log(`🔍 Fetching complete page data for agent ${agentId}`);\n        \n        // Get complete page data for this agent\n        const agentPageResult = await getPageById(agentId);\n        \n        if (!agentPageResult.success) {\n          console.error(`❌ Failed to fetch page data for agent ${agentId}:`, agentPageResult.error);\n          dataCollectionSuccess = false;\n          dataCollectionError = `Failed to fetch agent ${agentId}: ${agentPageResult.error}`;\n        } else {\n          // Extract properties from the complete page data\n          const agentProperties = extractAgentProperties(agentPageResult.data);\n          console.log(`📝 Extracted properties for agent ${agentId}:`, agentProperties);\n          \n          agentDataCollection.push({\n            agentId: agentId,\n            agentPageData: agentPageResult.data,\n            ...agentProperties\n          });\n        }\n        \n      } catch (error) {\n        console.error(`❌ Error processing agent ${agentId}:`, error.message);\n        dataCollectionSuccess = false;\n        dataCollectionError = `Error processing agent ${agentId}: ${error.message}`;\n      }\n\n      // Validate data collection succeeded\n      if (!dataCollectionSuccess) {\n        console.error(\"❌ Data collection failed, aborting assignment\");\n        return c.json({\n          success: false,\n          error: \"Failed to collect complete agent data\",\n          details: dataCollectionError,\n          pageId: pageId,\n          agentId: agentId,\n          timestamp: new Date().toISOString()\n        }, 500);\n      }\n\n      console.log(`✅ Successfully collected data for agent ${agentId}`);\n\n      // STEP 2: Clear agent from all other demo blobs\n      console.log(\"=== STEP 2: Clearing Agent from Other Demo Blobs ===\");\n      console.log(\"Scanning all agent blobs to remove agent from other demos...\");\n      \n      // Get list of all agent blob keys\n      const allBlobsResult = await listAgentBlobs();\n      \n      if (!allBlobsResult.success) {\n        console.warn(`⚠️ Failed to list agent blobs: ${allBlobsResult.error}`);\n        console.log(\"Continuing with assignment - other demo blobs may not be cleared\");\n      } else {\n        const allBlobKeys = allBlobsResult.data || [];\n        const currentDemoBlobKey = `glimpse--agent--${pageId}`;\n        const otherBlobKeys = allBlobKeys.filter(key => key !== currentDemoBlobKey);\n        \n        console.log(`Found ${allBlobKeys.length} total agent blobs, ${otherBlobKeys.length} other demo blobs to check`);\n        console.log(`Agent to assign to this demo: ${agentId}`);\n        \n        let blobsChecked = 0;\n        let blobsModified = 0;\n        let agentsRemoved = 0;\n        \n        // Check each other demo blob and remove our agent from them\n        for (const blobKey of otherBlobKeys) {\n          try {\n            blobsChecked++;\n            console.log(`🔍 Checking blob: ${blobKey}`);\n            \n            const blobResult = await getBlobData(blobKey);\n            \n            if (!blobResult.success) {\n              console.warn(`⚠️ Failed to read blob ${blobKey}: ${blobResult.error}`);\n              continue;\n            }\n            \n            const blobData = blobResult.data;\n            if (!blobData?.agents || !Array.isArray(blobData.agents)) {\n              console.log(`ℹ️ Blob ${blobKey} has no agents array - skipping`);\n              continue;\n            }\n            \n            // Check if this blob contains our agent\n            const hasOurAgent = blobData.agents.some(agent => agent.agentId === agentId);\n            \n            if (hasOurAgent) {\n              // Remove our agent from this blob (should result in empty array since only one agent per demo)\n              const filteredAgents = blobData.agents.filter(agent => agent.agentId !== agentId);\n              agentsRemoved += 1;\n              blobsModified++;\n              \n              console.log(`🧹 Removing agent ${agentId} from ${blobKey}`);\n              \n              const updatedBlobData = {\n                ...blobData,\n                agents: filteredAgents,\n                lastUpdated: new Date().toISOString()\n                // Keep original assignedAt timestamp\n              };\n              \n              const updateResult = await setBlobData(blobKey, updatedBlobData);\n              \n              if (updateResult.success) {\n                console.log(`✅ Updated ${blobKey} - ${filteredAgents.length} agents remaining`);\n              } else {\n                console.warn(`⚠️ Failed to update ${blobKey}: ${updateResult.error}`);\n              }\n            } else {\n              console.log(`✅ No changes needed for ${blobKey}`);\n            }\n            \n          } catch (error) {\n            console.warn(`⚠️ Error processing blob ${blobKey}: ${error.message}`);\n          }\n        }\n        \n        console.log(`📊 Multi-blob clearing summary: ${blobsChecked} blobs checked, ${blobsModified} blobs modified, ${agentsRemoved} agents removed`);\n      }\n\n      // STEP 3: Update current demo blob with new assignment\n      console.log(\"=== STEP 3: Updating Current Demo Blob with New Assignment ===\");\n      console.log(\"Updating agent blob with assignment data...\");\n      \n      let blobResult = { success: false, error: \"No agent to process\" };\n      \n      try {\n        // Transform agent data to only include essential information\n        const cleanedAgent = {\n          agentId: agentDataCollection[0].agentId,\n          agentName: agentDataCollection[0].agentName,\n          agentEmail: agentDataCollection[0].agentEmail,\n          agentMeetUrl: agentDataCollection[0].agentMeetUrl,\n          agentPhone: agentDataCollection[0].agentPhone\n        };\n        \n        // Update blob with single agent in array\n        blobResult = await setAgentBlob(pageId, [cleanedAgent]);\n        \n        if (!blobResult.success) {\n          console.error(`❌ Failed to update blob for page ${pageId}:`, blobResult.error);\n          return c.json({\n            success: false,\n            error: \"Failed to update agent blob with new assignment\",\n            details: blobResult.error,\n            pageId: pageId,\n            agentId: agentId,\n            timestamp: new Date().toISOString()\n          }, 500);\n        } else {\n          console.log(\"✅ Successfully updated current demo blob with new assignment\");\n        }\n      } catch (error) {\n        console.error(`❌ Error updating blob for page ${pageId}:`, error.message);\n        return c.json({\n          success: false,\n          error: \"Error updating agent blob with new assignment\",\n          details: error.message,\n          pageId: pageId,\n          agentId: agentId,\n          timestamp: new Date().toISOString()\n        }, 500);\n      }\n\n      // Success response\n      console.log(\"🎉 Assignment completed successfully\");\n      console.log(\"ℹ️ Note: Agent has been removed from other demo blobs to prevent double-assignment\");\n      \n      return c.json({\n        success: true,\n        message: \"Task assignment completed successfully\",\n        pageId: pageId,\n        agentId: agentId,\n        agentsAssigned: 1,\n        agentBlobUpdated: blobResult.success,\n        note: \"Agent removed from other demo blobs to prevent double-assignment\",\n        timestamp: new Date().toISOString()\n      });\n\n    } catch (error) {\n      console.error(\"❌ Critical error during assignment process:\", error.message);\n      console.error(\"❌ Stack trace:\", error.stack);\n      \n      return c.json({\n        success: false,\n        error: \"Critical error during assignment process\",\n        details: error.message,\n        pageId: pageId,\n        agentId: agentId,\n        timestamp: new Date().toISOString()\n      }, 500);\n    }\n\n  } catch (error) {\n    console.error(\"Error processing assignment webhook:\", error);\n    return c.json({ \n      success: false, \n      error: \"Internal server error processing assignment webhook\", \n      details: error.message \n    }, 500);\n  }\n}\n\nexport async function handleVisitorEmailWebhook(c: Context) {\n  console.log(\"Processing visitor email 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    console.log(\"Page ID:\", pageId);\n\n    // Get the page properties to extract Email and URL properties\n    const pageResult = await getPageById(pageId);\n    \n    if (!pageResult.success) {\n      console.error(\"Failed to fetch page data:\", pageResult.error);\n      return c.json({ \n        success: false, \n        error: \"Failed to fetch page data\", \n        details: pageResult.error \n      }, 500);\n    }\n\n    console.log(\"Successfully fetched page data for:\", pageId);\n\n    // Extract Email property from page properties\n    const emailProperty = pageResult.data?.properties?.[\"Email\"];\n    const visitorEmail = extractTextFromNotionProperty(emailProperty, \"Email\");\n    \n    if (!visitorEmail) {\n      console.error(\"No email found in Email property:\", emailProperty);\n      return c.json({\n        success: false,\n        error: \"Email property is required but not found or empty\",\n        pageId: pageId\n      }, 400);\n    }\n\n    console.log(\"Extracted visitor email:\", visitorEmail);\n\n    // Extract URL property from page properties\n    const urlProperty = pageResult.data?.properties?.[\"URL\"];\n    const demoUrl = extractTextFromNotionProperty(urlProperty, \"URL\");\n    \n    if (!demoUrl) {\n      console.error(\"No URL found in URL property:\", urlProperty);\n      return c.json({\n        success: false,\n        error: \"URL property is required but not found or empty\",\n        pageId: pageId\n      }, 400);\n    }\n\n    console.log(\"Extracted demo URL:\", demoUrl);\n\n    // Extract Glimpse agents property to get agent info for email\n    const glimpseAgentsProperty = pageResult.data?.properties?.[\"Glimpse agents\"];\n    let agentInfo: EmailAgentInfo = {\n      name: \"Glimpse Demo Team\",\n      email: \"support@example.com\" // Default fallback email\n    };\n\n    if (glimpseAgentsProperty?.relation && glimpseAgentsProperty.relation.length > 0) {\n      const agentId = glimpseAgentsProperty.relation[0].id;\n      console.log(\"Found agent ID for email:\", agentId);\n      \n      // Fetch the agent page to get the name and email\n      const agentPageResult = await getPageById(agentId);\n      if (agentPageResult.success) {\n        const agentProperties = extractAgentProperties(agentPageResult.data);\n        agentInfo = {\n          name: agentProperties.agentName || \"Glimpse Demo Team\",\n          email: agentProperties.agentEmail || \"support@example.com\"\n        };\n        console.log(\"Extracted agent info for email:\", agentInfo);\n      } else {\n        console.warn(\"Failed to fetch agent data for email, using default info\");\n      }\n    } else {\n      console.log(\"No Glimpse agents found, using default info for email\");\n    }\n\n    // Send email to visitor with demo link\n    console.log(\"Sending demo link email to visitor...\");\n    const emailResult = await sendVisitorDemoLink(visitorEmail, demoUrl, pageId, agentInfo);\n\n    if (!emailResult.success) {\n      console.error(\"Failed to send email:\", emailResult.error);\n      return c.json({\n        success: false,\n        error: \"Failed to send email to visitor\",\n        details: emailResult.error,\n        pageId: pageId,\n        visitorEmail: visitorEmail\n      }, 500);\n    }\n\n    console.log(\"Successfully sent demo link email to visitor\");\n\n    return c.json({\n      success: true,\n      message: \"Demo link email sent successfully to visitor\",\n      pageId: pageId,\n      visitorEmail: visitorEmail,\n      demoUrl: demoUrl,\n      timestamp: new Date().toISOString()\n    });\n\n  } catch (error) {\n    console.error(\"Error processing visitor email webhook:\", error);\n    return c.json({ \n      success: false, \n      error: \"Internal server error processing visitor email webhook\", \n      details: error.message \n    }, 500);\n  }\n}",[],[279,285,337],{"_103":345,"_95":346,"_155":347,"_157":286,"_158":137,"_159":348,"_161":162,"_105":349,"_100":350,"_164":304,"_166":351,"_167":22,"_168":-5,"_169":352,"_98":353},"243cfd34-930b-11f0-8c3a-0224a6c84d84","viewing.controller.ts","3bb909ec-8e2b-11f0-bb42-0224a6c84d84",38,["D",1758033651020],5,"import { updatePageProperty } from \"../services/notion/index.ts\";\nimport { setBlobData, getBlobData, listBlobKeys } from \"../services/blob.service.ts\";\nimport { generateSessionId, generateBlobKey, generateBlobKeyPrefix } from \"../utils/id.helpers.ts\";\nimport { isNotEmpty } from \"../utils/validation.helpers.ts\";\nimport { \n  migrateOldBlobStructure,\n  deriveViewingState,\n  isDataStale,\n  VIEWING_CONSTANTS,\n  type ViewingResponse\n} from \"../utils/viewing.helpers.ts\";\n\n/**\n * Update viewing status for a page in blob storage\n */\nexport async function updateViewingStatus(\n  pageId: string, \n  viewing: boolean, \n  tabVisible: boolean, \n  userEmail?: string\n): Promise {\n  try {\n    // Validate page ID using existing helper\n    if (!isNotEmpty(pageId)) {\n      return {\n        success: false,\n        error: \"Page ID is required\",\n        data: null\n      };\n    }\n\n    const blobKey = generateBlobKey(\"viewing\", pageId);\n    \n    // Get existing data to preserve session ID if it exists\n    const existingResult = await getBlobData(blobKey);\n    const existingData = existingResult.success ? migrateOldBlobStructure(existingResult.data) : null;\n\n    // Enhanced state detection with explicit logic\n    const oldViewingState = existingData ? deriveViewingState(existingData) : false;\n    const oldSessionStart = existingData?.sessionStart || null;\n    \n    const isViewingStarting = !oldViewingState && viewing === true;\n    const isViewingEnding = oldViewingState && viewing === false;\n    \n    // Calculate new sessionStart value\n    let newSessionStart: string | null;\n    if (isViewingStarting) {\n      newSessionStart = new Date().toISOString(); // Start new session\n    } else if (isViewingEnding) {\n      newSessionStart = null; // End session\n    } else if (viewing) {\n      newSessionStart = oldSessionStart || new Date().toISOString(); // Preserve existing or create new\n    } else {\n      newSessionStart = null; // Not viewing\n    }\n    \n    const data = {\n      pageId,\n      tabVisible,\n      lastUpdate: new Date().toISOString(),\n      userEmail,\n      sessionId: existingData?.sessionId || generateSessionId(),\n      dateCreated: existingData?.dateCreated || new Date().toISOString(),\n      sessionStart: newSessionStart\n    };\n\n    const setBlobResult = await setBlobData(blobKey, data);\n    if (!setBlobResult.success) {\n      return {\n        success: false,\n        error: \"Failed to update viewing status\",\n        details: setBlobResult.error,\n        data: null\n      };\n    }\n\n    // Only sync to Notion when viewing state actually changes\n    const newViewingState = viewing;\n    \n    if (oldViewingState !== newViewingState) {\n      console.log(`✅ Viewing state changed for page ${pageId}: ${oldViewingState} → ${newViewingState}`);\n      console.log(`🚀 Syncing state change to Notion...`);\n      try {\n        await syncViewingToNotion(pageId, data, oldViewingState);\n        console.log(`✅ Notion sync completed for page ${pageId}`);\n      } catch (notionError) {\n        // Log error but don't fail the blob update\n        console.error(`❌ Failed to sync viewing status to Notion for page ${pageId}:`, notionError.message);\n        console.error(`❌ Notion error stack:`, notionError.stack);\n      }\n    } else {\n      console.log(`⏭️ Heartbeat updated for page ${pageId} (viewing state unchanged: ${viewing})`);\n    }\n\n    return {\n      success: true,\n      data,\n      error: null\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: \"Failed to update viewing status\",\n      details: error.message,\n      data: null\n    };\n  }\n}\n\n/**\n * Sync viewing data to Notion page properties\n */\nasync function syncViewingToNotion(pageId: string, viewingData: any, oldViewingState?: boolean) {\n  // Derive viewing state from sessionStart\n  const currentlyViewing = viewingData.sessionStart !== null;\n  \n  console.log(`🔄 Syncing to Notion - Page ID: ${pageId}, Session Active: ${currentlyViewing}`);\n  \n  // Primary property - \"Session start\" indicates both status and timing\n  const properties: any = {\n    \"Session start\": {\n      date: currentlyViewing ? { start: viewingData.sessionStart } : null\n    }\n  };\n\n  // If this is a new session starting, also set \"Viewing start\" to dateCreated (first-ever view)\n  const isViewingStarting = oldViewingState !== true && currentlyViewing === true;\n  \n  if (isViewingStarting && viewingData.dateCreated) {\n    console.log(`🕐 New session starting - setting \"Session start\" to: ${viewingData.sessionStart}`);\n    console.log(`📅 Setting \"Viewing start\" to first-ever view: ${viewingData.dateCreated}`);\n    properties[\"Viewing start\"] = {\n      date: {\n        start: viewingData.dateCreated\n      }\n    };\n  }\n  \n  try {\n    const result = await updatePageProperty(pageId, properties);\n    console.log(`✅ Notion sync result:`, result.success ? 'SUCCESS' : `FAILED: ${result.error}`);\n    \n    if (!result.success) {\n      console.error(`❌ Notion sync failed - Details:`, result);\n    }\n    \n    return result;\n  } catch (error) {\n    console.error(`❌ Notion sync exception:`, error.message);\n    console.error(`❌ Notion sync stack:`, error.stack);\n    throw error;\n  }\n}\n\n/**\n * Get current viewing status for a page\n */\nexport async function getViewingStatus(pageId: string): Promise {\n  try {\n    // Validate page ID using existing helper\n    if (!isNotEmpty(pageId)) {\n      return {\n        success: false,\n        error: \"Page ID is required\",\n        data: null\n      };\n    }\n\n    const blobKey = generateBlobKey(\"viewing\", pageId);\n    const getBlobResult = await getBlobData(blobKey);\n    \n    if (getBlobResult.success) {\n      const data = migrateOldBlobStructure(getBlobResult.data);\n      const viewing = deriveViewingState(data);\n      \n      // Check if data is stale using helper\n      if (isDataStale(data, VIEWING_CONSTANTS.STALE_THRESHOLD_MINUTES)) {\n        // Data is stale, consider it as not viewing\n        return {\n          success: true,\n          data: {\n            ...data,\n            viewing: false,\n            sessionStart: null, // Clear session when stale\n            stale: true\n          },\n          error: null\n        };\n      }\n\n      return {\n        success: true,\n        data: {\n          ...data,\n          viewing // Add derived viewing field for compatibility\n        },\n        error: null\n      };\n    } else {\n      // Blob doesn't exist - return default values\n      return {\n        success: true,\n        data: {\n          pageId,\n          viewing: false,\n          tabVisible: false,\n          lastUpdate: null,\n          userEmail: null,\n          sessionId: null,\n          dateCreated: null,\n          sessionStart: null\n        },\n        error: null\n      };\n    }\n  } catch (error) {\n    return {\n      success: false,\n      error: \"Failed to get viewing status\",\n      details: error.message,\n      data: null\n    };\n  }\n}\n\n/**\n * Clean up stale viewing sessions (called by cron)\n */\nexport async function cleanupStaleViewingSessions(): Promise {\n  try {\n    const blobsResult = await listBlobKeys(generateBlobKeyPrefix(\"viewing\"));\n    if (!blobsResult.success) {\n      return {\n        success: false,\n        error: \"Failed to list viewing blobs\",\n        details: blobsResult.error,\n        data: null\n      };\n    }\n    \n    const blobs = blobsResult.data || [];\n    const cleanupThresholdMs = VIEWING_CONSTANTS.CLEANUP_THRESHOLD_SECONDS * 1000;\n    const sixtySecondsAgo = new Date(Date.now() - cleanupThresholdMs);\n    let cleanedCount = 0;\n    let errorCount = 0;\n\n    console.log(`🧹 Checking ${blobs.length} viewing blobs for stale sessions (>${VIEWING_CONSTANTS.CLEANUP_THRESHOLD_SECONDS} seconds old)`);\n\n    for (const blobKey of blobs) {\n      try {\n        console.log(`🔍 Processing blob: ${blobKey}`);\n        \n        const getBlobResult = await getBlobData(blobKey);\n        if (!getBlobResult.success) {\n          console.warn(`⚠️ Failed to get blob data for ${blobKey}:`, getBlobResult.error);\n          errorCount++;\n          continue;\n        }\n        \n        const data = migrateOldBlobStructure(getBlobResult.data);\n        \n        // Check if blob data is valid\n        if (!data || typeof data !== 'object') {\n          console.warn(`⚠️ Skipping invalid blob data for ${blobKey}:`, data);\n          errorCount++;\n          continue;\n        }\n        \n        // Derive viewing state from sessionStart using helper\n        const isCurrentlyViewing = deriveViewingState(data);\n        const lastUpdateTime = new Date(data.lastUpdate);\n        const ageInSeconds = Math.floor((Date.now() - lastUpdateTime.getTime()) / 1000);\n        \n        console.log(`🔍 Blob ${data.pageId}: sessionStart=${data.sessionStart}, active=${isCurrentlyViewing}, age=${ageInSeconds}s`);\n        \n        // Check if session is stale and currently active\n        if (isCurrentlyViewing && lastUpdateTime < sixtySecondsAgo) {\n          console.log(`🕐 Found stale session: ${data.pageId} (last update: ${data.lastUpdate}, age: ${ageInSeconds}s)`);\n          \n          // Update blob to end session\n          const updatedData = {\n            ...data,\n            sessionStart: null, // End the session\n            lastUpdate: new Date().toISOString()\n          };\n          \n          const setBlobResult = await setBlobData(blobKey, updatedData);\n          if (!setBlobResult.success) {\n            console.error(`❌ Failed to update blob ${blobKey}:`, setBlobResult.error);\n            errorCount++;\n            continue;\n          }\n          \n          console.log(`✅ Blob updated to end session for page ${data.pageId}`);\n          \n          // Sync to Notion immediately\n          console.log(`🧹 Cleaning up stale session for page ${data.pageId} - syncing to Notion`);\n          try {\n            await syncViewingToNotion(data.pageId, updatedData, true); // oldViewingState was true (stale session)\n            console.log(`✅ Cron cleanup sync completed for page ${data.pageId}`);\n            cleanedCount++;\n          } catch (notionError) {\n            console.error(`❌ Failed to sync cleanup to Notion for page ${data.pageId}:`, notionError.message);\n            errorCount++;\n          }\n        } else {\n          console.log(`⏭️ Skipping blob ${data.pageId}: sessionActive=${isCurrentlyViewing}, age=${Math.floor((Date.now() - new Date(data.lastUpdate).getTime()) / 1000)}s`);\n        }\n      } catch (error) {\n        console.warn(`Failed to process blob ${blobKey}:`, error.message);\n        errorCount++;\n      }\n    }\n\n    console.log(`🏁 Cleanup completed: ${cleanedCount} sessions cleaned, ${errorCount} errors`);\n\n    return {\n      success: true,\n      data: {\n        totalBlobs: blobs.length,\n        cleanedSessions: cleanedCount,\n        errors: errorCount\n      },\n      error: null\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: \"Failed to cleanup stale viewing sessions\",\n      details: error.message,\n      data: null\n    };\n  }\n}\n\n/**\n * Get viewing statistics for a page (simplified - mostly transforms getViewingStatus)\n */\nexport async function getViewingStats(pageId: string): Promise {\n  try {\n    // Validate page ID using existing helper\n    if (!isNotEmpty(pageId)) {\n      return {\n        success: false,\n        error: \"Page ID is required\",\n        data: null\n      };\n    }\n\n    const viewingStatus = await getViewingStatus(pageId);\n    \n    if (!viewingStatus.success) {\n      return viewingStatus;\n    }\n\n    // Transform viewing status into stats format\n    const stats = {\n      currentlyViewing: viewingStatus.data.viewing && !viewingStatus.data.stale,\n      lastViewed: viewingStatus.data.lastUpdate,\n      currentUser: viewingStatus.data.userEmail,\n      tabVisible: viewingStatus.data.tabVisible,\n      sessionId: viewingStatus.data.sessionId,\n      dateCreated: viewingStatus.data.dateCreated,\n      sessionStart: viewingStatus.data.sessionStart\n    };\n\n    return {\n      success: true,\n      data: stats,\n      error: null\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: \"Failed to get viewing stats\",\n      details: error.message,\n      data: null\n    };\n  }\n}",[],[279,285,346],[279,285],{"_103":356,"_95":357,"_155":358,"_157":280,"_158":137,"_159":160,"_161":162,"_105":359,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":360,"_98":387},"8e5f7f38-8aa1-11f0-95bf-0224a6c84d84","crons","01991bd6-e87d-71bd-b757-3c76e942cd12",["D",1757108693058],[361,369,379],{"_103":362,"_95":291,"_155":363,"_157":358,"_158":137,"_159":364,"_161":162,"_105":365,"_100":350,"_164":176,"_166":366,"_167":22,"_168":-5,"_169":367,"_98":368},"536d0eee-9376-11f0-8f99-0224a6c84d84","01991bd6-e87d-71bd-b757-39b759d043c4",41,["D",1758079686339],"# Crons\n\nScheduled task handlers for automated system maintenance.\n\n## Available Crons\n\n### `cleanup-viewing.ts`\n\n- **Purpose**: Cleans up stale viewing sessions that haven't received heartbeat\n  updates\n- **Schedule**: Every minute\n- **Threshold**: Sessions older than 60 seconds without heartbeat updates\n- **Function**: Marks stale sessions as not viewing and syncs to Notion\n\n**How Viewing Sessions Work**:\n\nThe viewing system tracks user sessions through periodic heartbeat updates:\n\n1. **Active Tracking**: While users view pages, the frontend sends heartbeat\n   updates every 10 seconds\n2. **Session Detection**: Sessions are considered active when they have recent\n   heartbeat updates\n3. **Stale Session Cleanup**: This cron identifies sessions without heartbeats\n   for 60+ seconds and marks them as inactive\n\n**Processing Flow**:\n\n1. Lists all viewing blobs with prefix `glimpse--viewing--`\n2. Checks each blob's `lastUpdate` timestamp\n3. Identifies sessions where:\n   - `sessionStart` is not null (marked as actively viewing)\n   - `lastUpdate` is older than 60 seconds (no recent heartbeat)\n4. Updates blob: sets `sessionStart` to null, updates `lastUpdate`\n5. **Syncs to Notion**: Sets \"Session start\" property to null\n6. Logs cleanup statistics and any errors\n\n### `cleanup-agent.ts`\n\n- **Purpose**: Cleans up orphaned agent blobs\n- **Schedule**: Every minute\n- **Function**: Deletes agent blobs where the agent ID doesn't match the demo's\n  \"Glimpse agents\" relation in Notion\n- **Read-Only Notion**: Only reads Notion data, never modifies it\n- **Blob Cleanup**: Removes mismatched/orphaned blobs to keep storage\n  synchronized with Notion\n\n## Configuration\n\nCron schedules are managed through the Val Town web interface. Click on each\ncron file to modify its schedule as needed.",[],[279,357,291],{"_103":370,"_95":371,"_155":372,"_157":358,"_158":137,"_159":373,"_161":162,"_105":374,"_100":350,"_164":375,"_166":376,"_167":22,"_168":-5,"_169":377,"_98":378},"3db82d64-9343-11f0-9bce-0224a6c84d84","cleanup-agent.ts","b0e61936-8e93-11f0-84d4-0224a6c84d84",39,["D",1758057745591],"interval","/**\n * Agent Cleanup Cron Job\n *\n * Scans all agent blobs with key pattern `glimpse--agent--*`\n * and deletes blobs where the agent ID doesn't match the Notion demo page's\n * \"Glimpse agents\" relation property. Does not modify Notion - only cleans up\n * orphaned/mismatched blob storage.\n *\n * Runs every minute to clean up stale agent blobs.\n */\n\nimport { getPageById } from \"../services/notion/page.service.ts\";\nimport { deleteAgentBlob, getAgentBlob } from \"../services/blob.service.ts\";\nimport { generateBlobKeyPrefix } from \"../utils/id.helpers.ts\";\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nexport default async function cleanupAgentAssignments(): Promise {\n  const startTime = new Date();\n  console.log(`🧹 Starting agent cleanup at ${startTime.toISOString()}`);\n\n  try {\n    console.log(\n      `🔍 Scanning all agent blobs with pattern 'glimpse--agent--*'...`,\n    );\n\n    // Get all agent blob keys using utility function\n    const agentBlobPrefix = generateBlobKeyPrefix(\"agent\");\n    const agentBlobKeys = await blob.list(agentBlobPrefix);\n    console.log(`📋 Found ${agentBlobKeys.length} agent blobs to check`);\n\n    if (agentBlobKeys.length === 0) {\n      console.log(\"✅ No agent blobs found - cleanup complete\");\n      return new Response(\n        JSON.stringify({\n          success: true,\n          message: \"No agent blobs found\",\n          blobsProcessed: 0,\n          blobsSuccessful: 0,\n          blobsFailed: 0,\n          processingTime: `${Date.now() - startTime.getTime()}ms`,\n          timestamp: startTime.toISOString(),\n        }),\n        {\n          headers: { \"Content-Type\": \"application/json\" },\n        },\n      );\n    }\n\n    // Process each agent blob\n    const results = [];\n    let successCount = 0;\n    let failureCount = 0;\n    let skippedCount = 0;\n\n    for (const blobItem of agentBlobKeys) {\n      // Extract pageId from blob key using utility function\n      const blobKey = blobItem.key;\n      const pageId = blobKey.replace(agentBlobPrefix, \"\");\n      console.log(`🔄 Processing blob for page ${pageId}...`);\n\n      try {\n        // Get the agent blob data\n        const blobResult = await getAgentBlob(pageId);\n\n        if (!blobResult.success) {\n          console.error(\n            `❌ Failed to fetch agent blob for ${pageId}:`,\n            blobResult.error,\n          );\n          failureCount++;\n          results.push({\n            pageId: pageId,\n            success: false,\n            error: \"Failed to fetch agent blob\",\n            details: blobResult.error,\n          });\n          continue;\n        }\n\n        const agentData = blobResult.data;\n        const agents = agentData?.agents || [];\n\n        // Skip if agents array is empty (nothing to validate)\n        if (agents.length === 0) {\n          console.log(`🗑️ Page ${pageId} has empty agent array - deleting blob`);\n          \n          const deleteBlobResult = await deleteAgentBlob(pageId);\n          \n          if (!deleteBlobResult.success) {\n            console.error(`❌ Failed to delete empty agent blob for ${pageId}:`, deleteBlobResult.error);\n            failureCount++;\n            results.push({\n              pageId: pageId,\n              success: false,\n              error: \"Failed to delete empty agent blob\",\n              details: deleteBlobResult.error,\n            });\n          } else {\n            console.log(`✅ Successfully deleted empty agent blob for ${pageId}`);\n            successCount++;\n            results.push({\n              pageId: pageId,\n              success: true,\n              action: \"Deleted empty blob\",\n            });\n          }\n          continue;\n        }\n\n        // Get the agent ID from the blob (should only be one agent)\n        const blobAgentId = agents[0]?.agentId;\n        \n        if (!blobAgentId) {\n          console.log(`🗑️ Page ${pageId} has agent without ID - deleting blob`);\n          \n          const deleteBlobResult = await deleteAgentBlob(pageId);\n          \n          if (!deleteBlobResult.success) {\n            console.error(`❌ Failed to delete invalid agent blob for ${pageId}:`, deleteBlobResult.error);\n            failureCount++;\n            results.push({\n              pageId: pageId,\n              success: false,\n              error: \"Failed to delete invalid agent blob\",\n              details: deleteBlobResult.error,\n            });\n          } else {\n            console.log(`✅ Successfully deleted invalid agent blob for ${pageId}`);\n            successCount++;\n            results.push({\n              pageId: pageId,\n              success: true,\n              action: \"Deleted invalid blob\",\n            });\n          }\n          continue;\n        }\n\n        console.log(`🔍 Page ${pageId} has agent ${blobAgentId} - checking Notion relation...`);\n\n        // Get current Notion state (read-only)\n        const pageResult = await getPageById(pageId);\n\n        if (!pageResult.success) {\n          console.error(\n            `❌ Failed to retrieve page ${pageId} for verification:`,\n            pageResult.error,\n          );\n          failureCount++;\n          results.push({\n            pageId: pageId,\n            success: false,\n            error: \"Failed to retrieve page for verification\",\n            details: pageResult.error,\n          });\n          continue;\n        }\n\n        // Check if blob agent ID matches any ID in Notion's \"Glimpse agents\" relation\n        const glimpseAgentsProperty = pageResult.data?.properties?.[\"Glimpse agents\"];\n        const notionAgentIds = (glimpseAgentsProperty?.relation || []).map(rel => rel.id);\n        \n        console.log(`📋 Notion has agents: [${notionAgentIds.join(', ')}]`);\n        console.log(`🔍 Blob has agent: ${blobAgentId}`);\n        \n        const isAgentInNotion = notionAgentIds.includes(blobAgentId);\n        \n        if (isAgentInNotion) {\n          console.log(`✅ Agent ${blobAgentId} matches Notion relation - keeping blob`);\n          skippedCount++;\n          results.push({\n            pageId: pageId,\n            success: true,\n            skipped: true,\n            reason: `Agent ${blobAgentId} matches Notion relation`,\n          });\n          continue;\n        }\n\n        // Agent ID doesn't match - delete the blob\n        console.log(`🗑️ Agent ${blobAgentId} not in Notion relation - deleting blob`);\n        \n        const deleteBlobResult = await deleteAgentBlob(pageId);\n\n        if (!deleteBlobResult.success) {\n          console.error(\n            `❌ Failed to delete mismatched agent blob for ${pageId}:`,\n            deleteBlobResult.error,\n          );\n          failureCount++;\n          results.push({\n            pageId: pageId,\n            success: false,\n            error: \"Failed to delete mismatched agent blob\",\n            details: deleteBlobResult.error,\n            blobAgentId: blobAgentId,\n            notionAgentIds: notionAgentIds,\n          });\n          continue;\n        }\n\n        console.log(\n          `✅ Successfully deleted mismatched agent blob for ${pageId}`,\n        );\n        successCount++;\n\n        results.push({\n          pageId: pageId,\n          success: true,\n          action: \"Deleted mismatched blob\",\n          blobAgentId: blobAgentId,\n          notionAgentIds: notionAgentIds,\n        });\n      } catch (error) {\n        console.error(`❌ Error processing page ${pageId}:`, error.message);\n        failureCount++;\n        results.push({\n          pageId: pageId,\n          success: false,\n          error: \"Processing error\",\n          details: error.message,\n        });\n      }\n    }\n\n    const endTime = new Date();\n    const processingTime = endTime.getTime() - startTime.getTime();\n\n    console.log(`🎉 Agent cleanup completed in ${processingTime}ms`);\n    console.log(\n      `📊 Results: ${successCount} successful, ${failureCount} failed, ${skippedCount} skipped out of ${agentBlobKeys.length} total`,\n    );\n\n    return new Response(\n      JSON.stringify({\n        success: true,\n        message: \"Agent cleanup completed\",\n        blobsProcessed: agentBlobKeys.length,\n        blobsSuccessful: successCount,\n        blobsFailed: failureCount,\n        blobsSkipped: skippedCount,\n        processingTime: `${processingTime}ms`,\n        timestamp: startTime.toISOString(),\n        results: results,\n      }),\n      {\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  } catch (error) {\n    const endTime = new Date();\n    const processingTime = endTime.getTime() - startTime.getTime();\n\n    console.error(\"❌ Critical error during agent cleanup:\", error);\n\n    return new Response(\n      JSON.stringify({\n        success: false,\n        error: \"Critical error during agent cleanup\",\n        details: error.message,\n        processingTime: `${processingTime}ms`,\n        timestamp: startTime.toISOString(),\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}",[],[279,357,371],{"_103":380,"_95":381,"_155":382,"_157":358,"_158":137,"_159":350,"_161":162,"_105":383,"_100":32,"_164":375,"_166":384,"_167":22,"_168":-5,"_169":385,"_98":386},"3bb918a6-8e2b-11f0-bb42-0224a6c84d84","cleanup-viewing.ts","3bb91928-8e2b-11f0-bb42-0224a6c84d84",["D",1757497678504],"import { cleanupStaleViewingSessions } from \"../controllers/viewing.controller.ts\";\n\n/**\n * Cron job to clean up stale viewing sessions\n * Runs every minute to find sessions older than 1 minute and mark them as not viewing\n * Also syncs the cleanup to Notion immediately\n */\nexport default async function cleanupViewingCron() {\n  console.log(\"🧹 Starting viewing session cleanup...\");\n  \n  try {\n    const result = await cleanupStaleViewingSessions();\n    \n    if (result.success) {\n      const { totalBlobs, cleanedSessions, errors } = result.data;\n      console.log(`✅ Cleanup completed:`);\n      console.log(`   - Total blobs checked: ${totalBlobs}`);\n      console.log(`   - Stale sessions cleaned: ${cleanedSessions}`);\n      console.log(`   - Errors: ${errors}`);\n      \n      if (cleanedSessions > 0) {\n        console.log(`📝 Updated ${cleanedSessions} Notion pages to viewing: false`);\n      }\n    } else {\n      console.error(\"❌ Cleanup failed:\", result.error);\n      if (result.details) {\n        console.error(\"   Details:\", result.details);\n      }\n    }\n  } catch (error) {\n    console.error(\"❌ Cleanup cron error:\", error.message);\n  }\n  \n  console.log(\"🏁 Viewing session cleanup finished\\n\");\n}",[],[279,357,381],[279,357],{"_103":389,"_95":390,"_155":391,"_157":280,"_158":137,"_159":160,"_161":162,"_105":392,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":393,"_98":532},"8e5fb854-8aa1-11f0-95bf-0224a6c84d84","routes","01991bd6-e87d-71bd-b757-81dc35c48101",["D",1757108693058],[394,417,440,479,509,516,524],{"_103":395,"_95":396,"_155":397,"_157":391,"_158":137,"_159":160,"_161":162,"_105":398,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":399,"_98":416},"8e5f8672-8aa1-11f0-95bf-0224a6c84d84","api","01991bd6-e87d-71bd-b757-49833ad4a239",["D",1757108693058],[400,408],{"_103":401,"_95":291,"_155":402,"_157":397,"_158":137,"_159":403,"_161":162,"_105":404,"_100":313,"_164":176,"_166":405,"_167":22,"_168":-5,"_169":406,"_98":407},"10cba292-936e-11f0-929c-0224a6c84d84","01991bd6-e87d-71bd-b757-4375802c905b",40,["D",1758076138575],"# 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### POST /api/viewing\n\n**Purpose**: Update page viewing status in blob storage for real-time tracking with immediate Notion sync\n\n**Input Data**:\n```typescript\n{\n  pageId: string,     // Notion page UUID\n  viewing: boolean,   // true when actively viewing, false when leaving\n  tabVisible: boolean // Page Visibility API state\n}\n```\n\n**Content-Type Support**:\n- `application/json` - Standard fetch requests\n- `text/plain` - sendBeacon requests (automatically parsed as JSON)\n\n**Processing Flow**:\n1. Extract viewing data from request body (handles both JSON and text formats)\n2. Get user email from authentication context\n3. Update blob storage with key `glimpse--viewing--{pageId}`\n4. **If viewing status changed**: Immediately sync to Notion page properties\n5. Return success confirmation\n\n**Notion Integration**:\n- **Real-time sync**: When viewing status changes, immediately updates Notion page\n- **Properties updated**: \"Session start\" (date) - null when not viewing, timestamp when viewing\n- **Additional properties**: \"Viewing start\" (date) - set to first-ever view timestamp\n- **Cleanup**: Cron job runs every minute to mark stale sessions as `viewing: false` and sync to Notion\n\n**Success Response (200)**:\n```typescript\n{\n  success: true,\n  data: {\n    pageId: string,        // Notion page UUID\n    viewing: boolean,\n    tabVisible: boolean,\n    lastUpdate: string,    // ISO timestamp\n    userEmail?: string,\n    sessionId: string      // Generated session identifier\n  }\n}\n```\n\n**Error Responses**:\n```typescript\n// 400 - Invalid Request\n{\n  error: \"Page ID is required\" | \"Invalid request body\",\n  details?: string\n}\n\n// 500 - Server Error\n{\n  error: \"Failed to update viewing status\",\n  details: string\n}\n```\n\n### GET /api/viewing/:id\n\n**Purpose**: Get current viewing status for a page\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. Retrieve viewing status from blob storage\n3. Check for stale data (>30 minutes old)\n4. Return current status or default values\n\n**Success Response (200)**:\n```typescript\n{\n  pageId: string,\n  viewing: boolean,\n  tabVisible: boolean,\n  lastUpdate: string | null,\n  userEmail?: string,\n  sessionId?: string,\n  stale?: boolean        // Present if data is >30 minutes old\n}\n```\n\n**Error Responses**: Same pattern as other endpoints\n\n### GET /api/viewing/:id/stats\n\n**Purpose**: Get viewing analytics/statistics for a page\n\n**Input Data**:\n```typescript\n// URL Parameters\n{\n  id: string  // Notion page UUID\n}\n```\n\n**Success Response (200)**:\n```typescript\n{\n  currentlyViewing: boolean,    // Active viewing status (excludes stale)\n  lastViewed: string | null,    // ISO timestamp of last update\n  currentUser: string | null,   // Email of current/last viewer\n  tabVisible: boolean,          // Current tab visibility\n  sessionId: string | null      // Current/last session ID\n}\n```\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```",[],[279,390,396,291],{"_103":409,"_95":410,"_155":411,"_157":397,"_158":137,"_159":364,"_161":162,"_105":412,"_100":350,"_164":304,"_166":413,"_167":22,"_168":-5,"_169":414,"_98":415},"536d1506-9376-11f0-8f99-0224a6c84d84","_api.routes.ts","01991bd6-e87d-71bd-b757-479ab9572377",["D",1758079686339],"import { Hono } from \"npm:hono@3.12.12\";\nimport { getHealthStatus } from \"../../controllers/health.controller.ts\";\nimport { getDemoProperties, getDemoFull } from \"../../controllers/demo.controller.ts\";\nimport { updateViewingStatus, getViewingStatus, getViewingStats } from \"../../controllers/viewing.controller.ts\";\nimport { getAgentData } from \"../../controllers/agent.controller.ts\";\n\nconst app = new Hono();\n\n// Simple test endpoint\napp.get(\"/test\", async (c) => {\n  return c.json({ message: \"API routes working\", timestamp: new Date().toISOString() });\n});\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\n// Viewing endpoints - track page viewing status in blob storage\napp.post(\"/viewing\", async (c) => {\n  try {\n    const body = await c.req.json();\n    const { pageId, viewing, tabVisible } = body;\n    \n    // Get user email from authentication context if available\n    const userEmail = c.get(\"userEmail\") || null;\n    \n    const result = await updateViewingStatus(pageId, viewing, tabVisible, userEmail);\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({ success: true, data: result.data });\n  } catch (error) {\n    return c.json({ \n      error: \"Invalid request body\", \n      details: error.message \n    }, 400);\n  }\n});\n\napp.get(\"/viewing/:id\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getViewingStatus(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(\"/viewing/:id/stats\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getViewingStats(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// Agent endpoints - get agent data for a specific page\napp.get(\"/agent/:id\", async (c) => {\n  const id = c.req.param(\"id\");\n  const result = await getAgentData(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 : 404);\n  }\n  \n  return c.json(result.data);\n});\n\n// Debug endpoint to manually trigger viewing cleanup\napp.post(\"/debug/cleanup-viewing\", async (c) => {\n  const { cleanupStaleViewingSessions } = await import(\"../../controllers/viewing.controller.ts\");\n  \n  console.log(\"🔧 Manual cleanup triggered via API\");\n  const result = await cleanupStaleViewingSessions();\n  \n  if (!result.success) {\n    return c.json({ \n      error: result.error, \n      details: result.details \n    }, 500);\n  }\n  \n  return c.json({\n    message: \"Cleanup completed\",\n    ...result.data\n  });\n});\n\nexport default app;",[],[279,390,396,410],[279,390,396],{"_103":418,"_95":419,"_155":420,"_157":391,"_158":137,"_159":160,"_161":162,"_105":421,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":422,"_98":439},"8e5f8b22-8aa1-11f0-95bf-0224a6c84d84","glimpse","01991bd6-e87d-71bd-b757-5556c9aac13c",["D",1757108693058],[423,431],{"_103":424,"_95":291,"_155":425,"_157":420,"_158":137,"_159":426,"_161":162,"_105":427,"_100":160,"_164":176,"_166":428,"_167":22,"_168":-5,"_169":429,"_98":430},"e04a1ad6-8f80-11f0-872d-0224a6c84d84","01991bd6-e87d-71bd-b757-4d5484f31bfd",35,["D",1757644412986],"# 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### HTML Content Handling\nWhen serving the React frontend, initial data is injected into the HTML to avoid loading states. To prevent HTML content from Notion pages (like ``;\n    \n    html = html.replace(\"\", `${dataScript}`);\n    return c.html(html);\n  } catch (error) {\n    // If HTML template fails to load, return a simple error page\n    return c.html(`\n      \n      \n      \n        Glimpse - Error\n        \n        \n      \n      \n        \n          ⚠️ Frontend Error
\n          The glimpse frontend could not be loaded.
\n          Error: ${error.message}
\n          For JSON data, please use the API endpoint: /api/demo/${id}
\n          ← Back to Dashboard\n        
\n      \n      \n    `, 500);\n  }\n});\n\nexport default app;",[],[279,390,419,433],[279,390,419],{"_103":441,"_95":442,"_155":443,"_157":391,"_158":137,"_159":160,"_161":162,"_105":444,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":445,"_98":478},"8e5f8ef6-8aa1-11f0-95bf-0224a6c84d84","tasks","01991bd6-e87d-71bd-b757-617c9ef5e88e",["D",1757108693058],[446,453,461,469],{"_103":447,"_95":291,"_155":448,"_157":443,"_158":137,"_159":136,"_161":162,"_105":449,"_100":142,"_164":176,"_166":450,"_167":22,"_168":-5,"_169":451,"_98":452},"59a2c408-94b0-11f0-a75b-0224a6c84d84","01991bd6-e87d-71bd-b757-5a58ad131b23",["D",1758214558721],"# Task Routes\n\nWebhook handlers for Notion integrations, organized into focused modules.\n\n## File Structure\n\n```\n/backend/routes/tasks/\n├── _tasks.routes.ts          # Main router + catch-all\n├── webhook.routes.ts         # Production webhook endpoints\n├── debug.routes.ts          # Debug/test endpoints\n└── [new-feature].routes.ts  # Future endpoints (auto-mounted safely)\n```\n\n## Adding New Endpoints\n\nTo add new `/tasks` endpoints:\n\n1. **Create a new route file** (e.g., `feature.routes.ts`)\n2. **Import and mount it** in `_tasks.routes.ts` BEFORE the catch-all\n3. **Routes are automatically protected** from the catch-all footgun\n\n## Webhook Endpoints (Production)\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/assign\n\nAssigns agents to demos based on Notion page assignments. Processes the \"Assigned\" property and creates agent blob assignments.\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**Process Flow:**\n1. Extracts page ID from webhook payload\n2. Fetches Notion page data\n3. Extracts assigned person ID from \"Assigned\" property\n4. Queries agents database for matching agents\n5. Clears current demo's agent blob\n6. Removes assigned agents from other demo blobs (prevents double-assignment)\n7. Updates current demo's agent blob with new assignment\n\n**Success Response (200):**\n```json\n{\n  \"success\": true,\n  \"message\": \"Task assignment completed successfully (multi-blob clearing approach)\",\n  \"pageId\": \"page-id-here\",\n  \"personId\": \"person-id-here\",\n  \"blobCleared\": true,\n  \"agentsAssigned\": 1,\n  \"agentBlobUpdated\": true,\n  \"note\": \"Agents removed from other demo blobs and Notion database cleanup will be handled by cron jobs\",\n  \"timestamp\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n**Success Response - No Assignment Needed:**\n```json\n{\n  \"success\": true,\n  \"message\": \"No person ID found in Assigned property - no assignment needed\",\n  \"pageId\": \"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\n500 - Failed to fetch page data:\n```json\n{\n  \"success\": false,\n  \"error\": \"Failed to fetch page data\",\n  \"details\": \"Notion API error message\"\n}\n```\n\n500 - Missing agents database configuration:\n```json\n{\n  \"success\": false,\n  \"error\": \"GLANCE_AGENTS_DB_ID environment variable not configured\"\n}\n```\n\n**Testing:**\n```bash\ncurl -X POST https://your-val.web.val.run/tasks/assign \\\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/visitor/email/link\n\nSends an email to the visitor with their demo link. Extracts the visitor's email from the Email property and the demo URL from the URL property of the Notion page.\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**Process Flow:**\n1. Extracts page ID from webhook payload\n2. Fetches Notion page data\n3. Extracts visitor email from \"Email\" property\n4. Extracts demo URL from \"URL\" property\n5. Sends formatted email to visitor with demo link\n\n**Success Response (200):**\n```json\n{\n  \"success\": true,\n  \"message\": \"Demo link email sent successfully to visitor\",\n  \"pageId\": \"page-id-here\",\n  \"visitorEmail\": \"visitor@example.com\",\n  \"demoUrl\": \"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 Email property:\n```json\n{\n  \"success\": false,\n  \"error\": \"Email property is required but not found or empty\",\n  \"pageId\": \"page-id-here\"\n}\n```\n\n400 - Missing URL property:\n```json\n{\n  \"success\": false,\n  \"error\": \"URL property is required but not found or empty\",\n  \"pageId\": \"page-id-here\"\n}\n```\n\n500 - Failed to fetch page data:\n```json\n{\n  \"success\": false,\n  \"error\": \"Failed to fetch page data\",\n  \"details\": \"Notion API error message\"\n}\n```\n\n500 - Failed to send email:\n```json\n{\n  \"success\": false,\n  \"error\": \"Failed to send email to visitor\",\n  \"details\": \"Email service error message\",\n  \"pageId\": \"page-id-here\",\n  \"visitorEmail\": \"visitor@example.com\"\n}\n```\n\n**Testing:**\n```bash\ncurl -X POST https://your-val.web.val.run/tasks/visitor/email/link \\\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**Requirements:**\n- Page must have an **Email property** with visitor's email address\n- Page must have a **URL property** with the demo link\n- Both properties must contain valid, non-empty values\n\n**Email Content:**\n- Simple text format for maximum deliverability\n- Clear subject line: \"Your Demo Link\"\n- Direct demo URL without formatting\n- Demo ID for reference\n- Professional but minimal content\n\n## Debug/Test Endpoints\n\n### POST /tasks/notion-webhook\n\n**Test webhook receiver** - logs payload and returns success. Not for production use.\n\n**Authentication:** Requires `X-API-KEY` header with `NOTION_WEBHOOK_SECRET` value.\n\n**Response:**\n```json\n{ \"success\": true }\n```\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```",[],[279,390,442,291],{"_103":454,"_95":455,"_155":456,"_157":443,"_158":137,"_159":136,"_161":162,"_105":457,"_100":350,"_164":304,"_166":458,"_167":22,"_168":-5,"_169":459,"_98":460},"59a2c980-94b0-11f0-a75b-0224a6c84d84","_tasks.routes.ts","01991bd6-e87d-71bd-b757-5ca1f065da1a",["D",1758214558721],"import { Hono } from \"npm:hono@3.12.12\";\nimport webhookRoutes from \"./webhook.routes.ts\";\nimport debugRoutes from \"./debug.routes.ts\";\n\nconst app = new Hono();\n\n// Mount all specific route modules FIRST\napp.route(\"/\", webhookRoutes);\napp.route(\"/\", debugRoutes);\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      \"POST /tasks/assign\",\n      \"POST /tasks/visitor/email/link\",\n    ],\n  };\n  console.log(returnObj);\n\n  return c.json(returnObj, 404);\n});\n\nexport default app;",[],[279,390,442,455],{"_103":462,"_95":463,"_155":464,"_157":443,"_158":137,"_159":340,"_161":162,"_105":465,"_100":32,"_164":304,"_166":466,"_167":22,"_168":-5,"_169":467,"_98":468},"3f19e450-8e65-11f0-a80c-0224a6c84d84","debug.routes.ts","3f19e734-8e65-11f0-a80c-0224a6c84d84",["D",1757522594978],"import { Hono } from \"npm:hono@3.12.12\";\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// Test webhook receiver - just logs payload and returns success\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\nexport default app;",[],[279,390,442,463],{"_103":470,"_95":471,"_155":472,"_157":443,"_158":137,"_159":136,"_161":162,"_105":473,"_100":474,"_164":304,"_166":475,"_167":22,"_168":-5,"_169":476,"_98":477},"59a2cb88-94b0-11f0-a75b-0224a6c84d84","webhook.routes.ts","3f19f454-8e65-11f0-a80c-0224a6c84d84",["D",1758214558721],4,"import { Hono } from \"npm:hono@3.12.12\";\nimport { handleUrlWebhook, handleAssignWebhook, handleVisitorEmailWebhook } from \"../../controllers/tasks.controller.ts\";\n\nconst app = new Hono();\n\n// URL update webhook endpoint - real webhook processing\napp.post(\"/url\", handleUrlWebhook);\n\n// Task assignment webhook endpoint - assigns agents based on Assigned property\napp.post(\"/assign\", handleAssignWebhook);\n\n// Visitor email webhook endpoint - sends demo link to visitor via email\napp.post(\"/visitor/email/link\", handleVisitorEmailWebhook);\n\nexport default app;",[],[279,390,442,471],[279,390,442],{"_103":480,"_95":481,"_155":482,"_157":391,"_158":137,"_159":160,"_161":162,"_105":483,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":484,"_98":508},"8e5fa4fe-8aa1-11f0-95bf-0224a6c84d84","views","01991bd6-e87d-71bd-b757-73504d5f41d9",["D",1757108693058],[485,492,500],{"_103":486,"_95":291,"_155":487,"_157":482,"_158":137,"_159":160,"_161":162,"_105":488,"_100":32,"_164":176,"_166":489,"_167":22,"_168":-5,"_169":490,"_98":491},"8e5f8ff0-8aa1-11f0-95bf-0224a6c84d84","01991bd6-e87d-71bd-b757-65f6efcb91ef",["D",1757108693058],"# 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.",[],[279,390,481,291],{"_103":493,"_95":494,"_155":495,"_157":482,"_158":137,"_159":160,"_161":162,"_105":496,"_100":32,"_164":304,"_166":497,"_167":22,"_168":-5,"_169":498,"_98":499},"8e5f93e2-8aa1-11f0-95bf-0224a6c84d84","_views.routes.ts","01991bd6-e87d-71bd-b757-6afcc27f4e70",["D",1757108693058],"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;",[],[279,390,481,494],{"_103":501,"_95":502,"_155":503,"_157":482,"_158":137,"_159":340,"_161":162,"_105":504,"_100":160,"_164":304,"_166":505,"_167":22,"_168":-5,"_169":506,"_98":507},"3f1a2adc-8e65-11f0-a80c-0224a6c84d84","dashboard.tsx","01991bd6-e87d-71bd-b757-6e51a836adf6",["D",1757522594978],"import { getHealthStatus } from \"../../controllers/health.controller.ts\";\nimport { getDatabasePages } from \"../../services/notion/index.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};",[],[279,390,481,502],[279,390,481],{"_103":510,"_95":291,"_155":511,"_157":391,"_158":137,"_159":160,"_161":162,"_105":512,"_100":32,"_164":176,"_166":513,"_167":22,"_168":-5,"_169":514,"_98":515},"8e5fa68e-8aa1-11f0-95bf-0224a6c84d84","01991bd6-e87d-71bd-b757-74e4f83eb577",["D",1757108693058],"# 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",[],[279,390,291],{"_103":517,"_95":518,"_155":519,"_157":391,"_158":137,"_159":160,"_161":162,"_105":520,"_100":32,"_164":304,"_166":521,"_167":22,"_168":-5,"_169":522,"_98":523},"8e5fb0b6-8aa1-11f0-95bf-0224a6c84d84","authCheck.ts","01991bd6-e87d-71bd-b757-7bfbfdc36d5b",["D",1757108693058],"// 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};",[],[279,390,518],{"_103":525,"_95":526,"_155":527,"_157":391,"_158":137,"_159":160,"_161":162,"_105":528,"_100":32,"_164":304,"_166":529,"_167":22,"_168":-5,"_169":530,"_98":531},"8e5fb6f6-8aa1-11f0-95bf-0224a6c84d84","webhookAuthCheck.ts","01991bd6-e87d-71bd-b757-7ce78d46fa0e",["D",1757108693058],"// 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};",[],[279,390,526],[279,390],{"_103":534,"_95":535,"_155":536,"_157":280,"_158":137,"_159":160,"_161":162,"_105":537,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":538,"_98":594},"8e5fc2c2-8aa1-11f0-95bf-0224a6c84d84","services","01991bd6-e87d-71bd-b757-8ebb61ffd00a",["D",1757108693058],[539,570,577,586],{"_103":540,"_95":541,"_155":542,"_157":536,"_158":137,"_159":340,"_161":162,"_105":543,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":544,"_98":569},"3f1a0386-8e65-11f0-a80c-0224a6c84d84","notion","01993482-8ca3-741f-ab5f-b5d74d411a98",["D",1757522594978],[545,553,561],{"_103":546,"_95":547,"_155":548,"_157":542,"_158":137,"_159":373,"_161":162,"_105":549,"_100":474,"_164":304,"_166":550,"_167":22,"_168":-5,"_169":551,"_98":552},"3db84240-9343-11f0-9bce-0224a6c84d84","database.service.ts","3f19f6f2-8e65-11f0-a80c-0224a6c84d84",["D",1758057745591],"import { notion, createSuccessResponse, createErrorResponse, type NotionServiceResponse } from './index.ts';\n\nexport async function getDatabases(): Promise {\n  try {\n    const response = await notion.search({\n      filter: {\n        property: \"object\",\n        value: \"database\"\n      }\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function getDatabaseById(databaseId: string): Promise {\n  try {\n    const response = await notion.databases.retrieve({\n      database_id: databaseId,\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function getDatabasePages(databaseId: string): Promise {\n  try {\n    const response = await notion.databases.query({\n      database_id: databaseId,\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function findUserByEmail(databaseId: string, email: string): Promise {\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 createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function createUserRecord(databaseId: string, email: string): Promise {\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 createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function findAgentsAssignedToDemo(databaseId: string, demoPageId: string): Promise {\n  try {\n    const response = await notion.databases.query({\n      database_id: databaseId,\n      filter: {\n        property: \"Glimpse demos\",\n        relation: {\n          contains: demoPageId\n        }\n      }\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}",[],[279,535,541,547],{"_103":554,"_95":555,"_155":556,"_157":542,"_158":137,"_159":373,"_161":162,"_105":557,"_100":142,"_164":304,"_166":558,"_167":22,"_168":-5,"_169":559,"_98":560},"3db84772-9343-11f0-9bce-0224a6c84d84","index.ts","3f19fbf2-8e65-11f0-a80c-0224a6c84d84",["D",1758057745591],"import { Client } from \"npm:@notionhq/client\";\n\n// Initialize Notion client\nexport const notion = new Client({ auth: Deno.env.get(\"NOTION_API_KEY\") });\n\n// Standard response format for all Notion services\nexport interface NotionServiceResponse {\n  success: boolean;\n  data?: T;\n  error?: string;\n  timestamp: string;\n}\n\n// Utility function to create success response\nexport function createSuccessResponse(data: T): NotionServiceResponse {\n  return {\n    success: true,\n    data,\n    timestamp: new Date().toISOString(),\n  };\n}\n\n// Utility function to create error response\nexport function createErrorResponse(error: string): NotionServiceResponse {\n  return {\n    success: false,\n    error,\n    timestamp: new Date().toISOString(),\n  };\n}\n\n// Re-export all database services\nexport {\n  getDatabases,\n  getDatabaseById,\n  getDatabasePages,\n  findUserByEmail,\n  createUserRecord,\n  findAgentsAssignedToDemo\n} from './database.service.ts';\n\n// Re-export all page services\nexport {\n  getPageById,\n  updatePageUrl,\n  updatePageProperty,\n  updateGlimpseAgentsProperty,\n  clearGlimpseDemosProperty,\n  getPageBlocks,\n  getPageWithBlocks\n} from './page.service.ts';",[],[279,535,541,555],{"_103":562,"_95":563,"_155":564,"_157":542,"_158":137,"_159":302,"_161":162,"_105":565,"_100":313,"_164":304,"_166":566,"_167":22,"_168":-5,"_169":567,"_98":568},"b0e6534c-8e93-11f0-84d4-0224a6c84d84","page.service.ts","3f19ff12-8e65-11f0-a80c-0224a6c84d84",["D",1757542542749],"import { notion, createSuccessResponse, createErrorResponse, type NotionServiceResponse } from './index.ts';\n\nexport async function getPageById(pageId: string): Promise {\n  try {\n    const response = await notion.pages.retrieve({\n      page_id: pageId,\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function updatePageUrl(pageId: string, url: string): Promise {\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 createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function updatePageProperty(pageId: string, properties: any): Promise {\n  try {\n    const response = await notion.pages.update({\n      page_id: pageId,\n      properties: properties\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function updatePageProperties(pageId: string, properties: any): Promise {\n  try {\n    const response = await notion.pages.update({\n      page_id: pageId,\n      properties: properties\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function updateGlimpseAgentsProperty(pageId: string, agentPages: any[]): Promise {\n  try {\n    // Convert agent pages to relation format\n    const relationData = agentPages.map(page => ({ id: page.id }));\n    \n    const response = await notion.pages.update({\n      page_id: pageId,\n      properties: {\n        \"Glimpse agents\": {\n          relation: relationData\n        }\n      }\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function clearGlimpseDemosProperty(agentPageId: string): Promise {\n  try {\n    const response = await notion.pages.update({\n      page_id: agentPageId,\n      properties: {\n        \"Glimpse demos\": {\n          relation: []\n        }\n      }\n    });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\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\n  });\n\n  const blocks = response.results;\n\n  for (const block of blocks) {\n    if (block.has_children) {\n      try {\n        block.children = await getAllBlocksRecursively(block.id);\n      } catch (error) {\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): Promise {\n  try {\n    const blocks = await getAllBlocksRecursively(pageId);\n    return createSuccessResponse({\n      results: blocks\n    });\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n\nexport async function getPageWithBlocks(pageId: string): Promise {\n  try {\n    const pageResult = await getPageById(pageId);\n    if (!pageResult.success) {\n      return pageResult;\n    }\n\n    const blocksResult = await getPageBlocks(pageId);\n    if (!blocksResult.success) {\n      return blocksResult;\n    }\n\n    const combinedData = {\n      ...pageResult.data,\n      blocks: blocksResult.data.results\n    };\n\n    return createSuccessResponse(combinedData);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}",[],[279,535,541,563],[279,535,541],{"_103":571,"_95":291,"_155":572,"_157":536,"_158":137,"_159":293,"_161":162,"_105":573,"_100":313,"_164":176,"_166":574,"_167":22,"_168":-5,"_169":575,"_98":576},"2af4a7b4-8e8b-11f0-9e5d-0224a6c84d84","01991bd6-e87d-71bd-b757-86d5162382fa",["D",1757538882052],"# Services\n\nExternal integrations and data persistence operations.\n\n## Separation of Concerns\n\nServices are the **external integration layer** that:\n- Handle external system interactions (APIs, databases, storage)\n- Make direct calls to external services (Notion API, blob storage, etc.)\n- Handle transport layer concerns (network errors, response parsing)\n- Return consistent, standardized response formats\n- Are focused operations with no business logic or workflow management\n\nServices do NOT:\n- Implement business logic or workflow decisions\n- Orchestrate multiple service calls (controllers handle this)\n- Handle environment variables or configuration (controllers manage this)\n- Transform data for business purposes (controllers handle transformation)\n\n## Clear Distinction: Services vs Utils\n\n### **Services** (External Dependencies)\n- **Notion API operations** → `notion/page.service.ts`\n- **Blob storage operations** → `blob.service.ts`\n- **Database operations** → `database.service.ts`\n- **Email sending** → `email.service.ts`\n\n### **Utils** (Pure Functions)\n- **Data formatting** → `utils/date.helpers.ts`\n- **Validation logic** → `utils/validation.helpers.ts`\n- **String manipulation** → `utils/string.helpers.ts`\n- **Mathematical calculations** → `utils/math.helpers.ts`\n\n## Service Characteristics\n\n### **External Dependencies**\n- Always interact with systems outside the application\n- Handle network operations, API calls, storage operations\n- Manage external service authentication and configuration\n\n### **Stateless Operations**\n- No business logic, just external operations\n- Deterministic for the same external system state\n- No workflow management or decision-making\n\n### **Standardized Responses**\n- Consistent success/error response formats\n- Complete error context from external systems\n- Raw data from external APIs (no business filtering)\n\n### **Focused Integration**\n- Each service handles one external system or related operations\n- Single responsibility for external integration concerns\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## Service Organization\n\n### **Notion Services** (`/notion/`)\n- `index.ts` - Main entry point with client configuration\n- `database.service.ts` - Database queries and operations\n- `page.service.ts` - Page retrieval and updates\n\n### **Blob Service** (`blob.service.ts`)\n- Generic blob storage operations\n- Type-specific convenience functions\n- Key management and cleanup operations\n\n### **Future Services**\n- `email.service.ts` - Email sending operations\n- `cache.service.ts` - Caching operations\n- `file.service.ts` - File system operations\n\n## Usage Patterns\n\n### **Controller Usage**\n```typescript\n// Controllers orchestrate services\nconst pageResult = await getPageById(pageId);\nif (!pageResult.success) {\n  return { success: false, error: pageResult.error };\n}\n\nconst blobResult = await setAgentBlob(pageId, agentData);\n// Controller handles business logic based on service results\n```\n\n### **Service Implementation**\n```typescript\n// Services focus on external operations only\nexport async function getPageById(pageId: string): Promise {\n  try {\n    const response = await notion.pages.retrieve({ page_id: pageId });\n    return createSuccessResponse(response);\n  } catch (error) {\n    return createErrorResponse(error.message);\n  }\n}\n```\n\n## Blob Service Functions\n\n### **Core Operations**\n- `setBlobData(key, data)` - Generic blob storage\n- `getBlobData(key)` - Generic blob retrieval\n- `deleteBlobData(key)` - Generic blob deletion\n- `listBlobKeys(prefix)` - List blobs with optional prefix\n\n### **Type-Specific Helpers**\n- `setAgentBlob(pageId, agentData)` - Agent blob operations\n- `getAgentBlob(pageId)` - Agent blob retrieval\n- `setViewingBlob(pageId, viewingData)` - Viewing blob operations\n- `getViewingBlob(pageId)` - Viewing blob retrieval\n\n### **Utility Functions**\n- `generateBlobKey(type, id)` - Standardized key patterns\n- `parseBlobKey(key)` - Extract type and id from keys\n- `cleanupStaleBlobs(type, maxAge)` - Generic cleanup operations\n\n## Notion Service Functions\n\n### Database Operations\n- `getDatabases()` - List all accessible databases\n- `getDatabaseById(databaseId)` - Get database schema\n- `getDatabasePages(databaseId)` - Query all pages in database\n- `findUserByEmail(databaseId, email)` - Find user by email\n- `createUserRecord(databaseId, email)` - Create new user record\n- `findAgentsByPersonId(databaseId, personId)` - Find agents by person\n\n### Page Operations\n- `getPageById(pageId)` - Get complete page data\n- `updatePageUrl(pageId, url)` - Update page URL property\n- `updatePageProperty(pageId, properties)` - Update page properties\n- `updateGlimpseAgentsProperty(pageId, agents)` - Update agent relations\n- `clearGlimpseDemosProperty(agentId)` - Clear demo relations\n- `getPageBlocks(pageId)` - Get page content blocks\n- `getPageWithBlocks(pageId)` - Get page with content\n\n## Error Handling\n\nServices return detailed error information:\n```typescript\n{\n  success: false,\n  error: \"External API error message\", // Direct from external system\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 parameters, missing required fields\n- **Rate limiting**: API quota exceeded\n- **Storage errors**: Blob storage failures, quota exceeded",[],[279,535,291],{"_103":578,"_95":579,"_155":580,"_157":536,"_158":137,"_159":581,"_161":162,"_105":582,"_100":313,"_164":304,"_166":583,"_167":22,"_168":-5,"_169":584,"_98":585},"e113a5d0-8f3b-11f0-8a97-0224a6c84d84","blob.service.ts","2af44ed6-8e8b-11f0-9e5d-0224a6c84d84",16,["D",1757614779034],"import { blob } from \"https://esm.town/v/std/blob\";\nimport { generateBlobKey, generateBlobKeyPrefix, parseBlobKey } from \"../utils/id.helpers.ts\";\n\n/**\n * Generic blob storage service for centralized blob operations\n */\n\n// Standard response format for blob operations\nexport interface BlobServiceResponse {\n  success: boolean;\n  data?: T;\n  error?: string;\n}\n\n/**\n * Core blob operations\n */\nexport async function setBlobData(key: string, data: any): Promise {\n  try {\n    await blob.setJSON(key, data);\n    return {\n      success: true,\n      data: data\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message\n    };\n  }\n}\n\nexport async function getBlobData(key: string): Promise {\n  try {\n    const data = await blob.getJSON(key);\n    return {\n      success: true,\n      data: data\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message\n    };\n  }\n}\n\nexport async function deleteBlobData(key: string): Promise {\n  try {\n    await blob.delete(key);\n    return {\n      success: true\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message\n    };\n  }\n}\n\nexport async function listBlobKeys(prefix?: string): Promise> {\n  try {\n    const blobs = await blob.list(prefix);\n    const keys = blobs.map(blobItem => blobItem.key);\n    return {\n      success: true,\n      data: keys\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message\n    };\n  }\n}\n\n/**\n * Type-specific convenience functions\n */\n\n// Agent blob operations\nexport async function setAgentBlob(pageId: string, agentData: any): Promise {\n  const key = generateBlobKey(\"agent\", pageId);\n  const blobData = {\n    pageId: pageId,\n    agents: agentData,\n    lastUpdated: new Date().toISOString(),\n    assignedAt: new Date().toISOString()\n  };\n  \n  const result = await setBlobData(key, blobData);\n  if (result.success) {\n    console.log(`✅ Agent blob updated for page ${pageId} with ${agentData.length} agents (cleaned data only):`, blobData);\n  } else {\n    console.error(`❌ Failed to update agent blob for page ${pageId}:`, result.error);\n  }\n  \n  return result;\n}\n\nexport async function getAgentBlob(pageId: string): Promise {\n  const key = generateBlobKey(\"agent\", pageId);\n  return await getBlobData(key);\n}\n\nexport async function deleteAgentBlob(pageId: string): Promise {\n  const key = generateBlobKey(\"agent\", pageId);\n  return await deleteBlobData(key);\n}\n\nexport async function listAgentBlobs(): Promise> {\n  const prefix = generateBlobKeyPrefix(\"agent\");\n  return await listBlobKeys(prefix);\n}\n\n// Viewing blob operations\nexport async function setViewingBlob(pageId: string, viewingData: any): Promise {\n  const key = generateBlobKey(\"viewing\", pageId);\n  return await setBlobData(key, viewingData);\n}\n\nexport async function getViewingBlob(pageId: string): Promise {\n  const key = generateBlobKey(\"viewing\", pageId);\n  return await getBlobData(key);\n}\n\n/**\n * Cleanup operations\n */\nexport async function cleanupStaleBlobs(type: string, maxAgeMinutes: number): Promise {\n  try {\n    const prefix = `glimpse--${type}--`;\n    const blobsResult = await listBlobKeys(prefix);\n    \n    if (!blobsResult.success) {\n      return blobsResult;\n    }\n    \n    const cutoffTime = new Date(Date.now() - maxAgeMinutes * 60 * 1000);\n    let cleanedCount = 0;\n    let errorCount = 0;\n    \n    for (const key of blobsResult.data || []) {\n      try {\n        const dataResult = await getBlobData(key);\n        if (dataResult.success && dataResult.data?.lastUpdated) {\n          const lastUpdate = new Date(dataResult.data.lastUpdated);\n          if (lastUpdate < cutoffTime) {\n            const deleteResult = await deleteBlobData(key);\n            if (deleteResult.success) {\n              cleanedCount++;\n            } else {\n              errorCount++;\n            }\n          }\n        }\n      } catch (error) {\n        errorCount++;\n      }\n    }\n    \n    return {\n      success: true,\n      data: {\n        cleanedCount,\n        errorCount,\n        totalChecked: blobsResult.data?.length || 0\n      }\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error.message\n    };\n  }\n}",[],[279,535,579],{"_103":587,"_95":588,"_155":589,"_157":536,"_158":137,"_159":136,"_161":162,"_105":590,"_100":32,"_164":304,"_166":591,"_167":22,"_168":-5,"_169":592,"_98":593},"59a28808-94b0-11f0-a75b-0224a6c84d84","email.service.ts","59a288c6-94b0-11f0-a75b-0224a6c84d84",["D",1758214558721],"import { email } from \"https://esm.town/v/std/email\";\nimport { createValTownFromEmail, sanitizeEmailDisplayName } from \"../utils/email.helpers.ts\";\nimport type { EmailAgentInfo } from \"../../shared/types.ts\";\n\n/**\n * Email service for sending emails using Val Town's email utility\n */\n\n// Standard response format for email operations\nexport interface EmailServiceResponse {\n  success: boolean;\n  data?: T;\n  error?: string;\n  timestamp: string;\n}\n\n// Utility function to create success response\nfunction createSuccessResponse(data: T): EmailServiceResponse {\n  return {\n    success: true,\n    data,\n    timestamp: new Date().toISOString(),\n  };\n}\n\n// Utility function to create error response\nfunction createErrorResponse(error: string): EmailServiceResponse {\n  return {\n    success: false,\n    error,\n    timestamp: new Date().toISOString(),\n  };\n}\n\n/**\n * Send an email with a demo link to a visitor\n */\nexport async function sendVisitorDemoLink(\n  visitorEmail: string,\n  demoUrl: string,\n  pageId: string,\n  agentInfo: EmailAgentInfo,\n): Promise {\n  try {\n    // Create Val Town from email address using helper function\n    const fromEmail = createValTownFromEmail(import.meta.url);\n    \n    // Sanitize agent name for email header compatibility\n    const sanitizedAgentName = sanitizeEmailDisplayName(agentInfo.name);\n    \n    const subject = \"Your Glimpse demo Link\";\n\n    const textContent = `Hi ${visitorEmail},\n\nYour Glimpse demo is ready! Here's the link:\n${demoUrl}\n\nBest regards,\n${sanitizedAgentName}\n\nDemo ID: ${pageId}`;\n\n    await email({\n      to: visitorEmail,\n      subject: subject,\n      text: textContent,\n      from: {\n        email: fromEmail,\n        name: sanitizedAgentName,\n      },\n      replyTo: agentInfo.email,\n    });\n\n    return createSuccessResponse({\n      visitorEmail,\n      demoUrl,\n      pageId,\n      subject,\n      fromEmail,\n      agentName: sanitizedAgentName,\n      replyTo: agentInfo.email,\n    });\n  } catch (error) {\n    return createErrorResponse(`Failed to send email: ${error.message}`);\n  }\n}",[],[279,535,588],[279,535],{"_103":596,"_95":597,"_155":598,"_157":280,"_158":137,"_159":160,"_161":162,"_105":599,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":600,"_98":608},"8e5fc506-8aa1-11f0-95bf-0224a6c84d84","types","01991bd6-e87d-71bd-b757-97b207e93054",["D",1757108693058],[601],{"_103":602,"_95":291,"_155":603,"_157":598,"_158":137,"_159":160,"_161":162,"_105":604,"_100":32,"_164":176,"_166":605,"_167":22,"_168":-5,"_169":606,"_98":607},"8e5fc3ee-8aa1-11f0-95bf-0224a6c84d84","01991bd6-e87d-71bd-b757-91bde8f66da9",["D",1757108693058],"# Types\n\nShared TypeScript type definitions.",[],[279,597,291],[279,597],{"_103":610,"_95":611,"_155":612,"_157":280,"_158":137,"_159":160,"_161":162,"_105":613,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":614,"_98":662},"8e5fc722-8aa1-11f0-95bf-0224a6c84d84","utils","01991bd6-e87d-71bd-b757-9f148cc6a50f",["D",1757108693058],[615,622,630,638,646,654],{"_103":616,"_95":291,"_155":617,"_157":612,"_158":137,"_159":136,"_161":162,"_105":618,"_100":313,"_164":176,"_166":619,"_167":22,"_168":-5,"_169":620,"_98":621},"59a2cd0e-94b0-11f0-a75b-0224a6c84d84","01991bd6-e87d-71bd-b757-99c8400276a9",["D",1758214558721],"# Utils\n\nPure utility functions with no external dependencies.\n\n## Separation of Concerns\n\nUtils are **pure functions** that:\n- **No external dependencies** - Never interact with APIs, databases, or storage\n- **Deterministic** - Same input always produces same output\n- **No side effects** - Don't modify global state or external systems\n- **Reusable** - Can be used across controllers and services\n- **Testable** - Easy to unit test in isolation\n\nUtils do NOT:\n- Make external API calls (use services instead)\n- Handle business workflows (controllers handle this)\n- Manage application state or configuration\n- Interact with databases or storage systems\n\n## Clear Distinction: Utils vs Services\n\n### **Utils** (Pure Functions)\n- **Data formatting** → `utils/date.helpers.ts`\n- **Validation logic** → `utils/validation.helpers.ts`\n- **String manipulation** → `utils/string.helpers.ts`\n- **Mathematical calculations** → `utils/math.helpers.ts`\n- **Type conversions** → `utils/conversion.helpers.ts`\n\n### **Services** (External Dependencies)\n- **Notion API operations** → `services/notion/page.service.ts`\n- **Blob storage operations** → `services/blob.service.ts`\n- **Database operations** → `services/database.service.ts`\n- **Email sending** → `services/email.service.ts`\n\n## Utility Characteristics\n\n### **Pure Functions**\n```typescript\n// ✅ Good: Pure function\nexport function formatDate(date: Date): string {\n  return date.toISOString().split('T')[0];\n}\n\n// ❌ Bad: Has side effects\nexport function logAndFormatDate(date: Date): string {\n  console.log('Formatting date'); // Side effect\n  return date.toISOString().split('T')[0];\n}\n```\n\n### **No External Dependencies**\n```typescript\n// ✅ Good: No external calls\nexport function validateEmail(email: string): boolean {\n  const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n  return emailRegex.test(email);\n}\n\n// ❌ Bad: External API call\nexport async function validateEmailWithService(email: string): Promise {\n  const response = await fetch(`/api/validate-email/${email}`);\n  return response.ok;\n}\n```\n\n### **Deterministic**\n```typescript\n// ✅ Good: Always returns same output for same input\nexport function calculatePercentage(value: number, total: number): number {\n  return (value / total) * 100;\n}\n\n// ❌ Bad: Output depends on external state\nexport function calculatePercentageWithTimestamp(value: number, total: number): number {\n  const timestamp = Date.now(); // Non-deterministic\n  return ((value / total) * 100) + timestamp;\n}\n```\n\n## Usage Patterns\n\n### **Controller Usage**\n```typescript\n// Controllers use utils for data processing\nimport { validateEmail, formatDate } from '../utils/validation.helpers.ts';\nimport { getPageById } from '../services/notion/page.service.ts';\n\nexport async function processUserData(email: string, pageId: string) {\n  // 1. UTIL: Validate input data\n  if (!validateEmail(email)) {\n    return { success: false, error: \"Invalid email format\" };\n  }\n\n  // 2. SERVICE: Get external data\n  const pageResult = await getPageById(pageId);\n  \n  // 3. UTIL: Format data for response\n  const formattedDate = formatDate(new Date(pageResult.data.created_time));\n  \n  return {\n    success: true,\n    data: { ...pageResult.data, formattedDate }\n  };\n}\n```\n\n### **Service Usage**\n```typescript\n// Services can use utils for data transformation\nimport { sanitizeInput } from '../utils/string.helpers.ts';\n\nexport async function createNotionPage(title: string) {\n  // UTIL: Clean input before external API call\n  const cleanTitle = sanitizeInput(title);\n  \n  // External API call\n  const response = await notion.pages.create({\n    properties: { Title: { title: [{ text: { content: cleanTitle } }] } }\n  });\n  \n  return createSuccessResponse(response);\n}\n```\n\n## Current Utility Files\n\n### **Email Helpers** (`email.helpers.ts`)\n```typescript\nexport function sanitizeValNameForEmail(valName: string): string;\nexport function createValTownFromEmail(importMetaUrl: string, customValName?: string): string;\nexport function sanitizeEmailDisplayName(displayName: string): string;\n```\n\n### **Notion Helpers** (`notion.helpers.ts`)\n```typescript\nexport function extractTextFromNotionProperty(property: any, propertyName: string): string;\nexport function findPropertyByNames(properties: any, possibleNames: string[]): { name: string; property: any } | null;\nexport function extractAgentProperties(agentPage: any): AgentProperties;\n```\n\n### **ID Helpers** (`id.helpers.ts`)\n```typescript\nexport function generateSessionId(): string;\nexport function generateBlobKey(type: string, id: string): string;\nexport function parseBlobKey(key: string): { type: string; id: string } | null;\nexport function generateRandomId(): string;\n```\n\n### **Validation Helpers** (`validation.helpers.ts`)\n```typescript\nexport function validateEmail(email: string): boolean;\nexport function validateUrl(url: string): boolean;\nexport function validateUuid(id: string): boolean;\nexport function isNotEmpty(value: string): boolean;\nexport function validatePhoneNumber(phone: string): boolean;\n```\n\n## Recommended Utility Categories\n\n### **Data Validation** (`validation.helpers.ts`)\n```typescript\nexport function validateEmail(email: string): boolean;\nexport function validateUrl(url: string): boolean;\nexport function validatePhoneNumber(phone: string): boolean;\nexport function validateUuid(id: string): boolean;\nexport function isNotEmpty(value: string): boolean;\n```\n\n### **Date/Time Helpers** (`date.helpers.ts`)\n```typescript\nexport function formatDate(date: Date): string;\nexport function parseIsoDate(isoString: string): Date;\nexport function addDays(date: Date, days: number): Date;\nexport function isExpired(date: Date, maxAgeMinutes: number): boolean;\nexport function getTimestamp(): string;\n```\n\n### **String Manipulation** (`string.helpers.ts`)\n```typescript\nexport function sanitizeInput(input: string): string;\nexport function truncateText(text: string, maxLength: number): string;\nexport function slugify(text: string): string;\nexport function capitalizeWords(text: string): string;\nexport function extractDomain(email: string): string;\n```\n\n### **Data Transformation** (`conversion.helpers.ts`)\n```typescript\nexport function arrayToObject(array: T[], keyField: string): Record;\nexport function objectToArray(obj: Record): T[];\nexport function filterObject(obj: Record, predicate: (value: T) => boolean): Record;\nexport function mapObjectValues(obj: Record, mapper: (value: T) => U): Record;\n```\n\n### **Mathematical Helpers** (`math.helpers.ts`)\n```typescript\nexport function clamp(value: number, min: number, max: number): number;\nexport function roundToDecimals(value: number, decimals: number): number;\nexport function calculatePercentage(value: number, total: number): number;\nexport function generateRandomId(): string;\n```\n\n### **Type Guards** (`type.helpers.ts`)\n```typescript\nexport function isString(value: unknown): value is string;\nexport function isNumber(value: unknown): value is number;\nexport function isObject(value: unknown): value is Record;\nexport function isArray(value: unknown): value is unknown[];\nexport function hasProperty>(obj: T, key: string): key is keyof T;\n```\n\n## Testing Utils\n\nSince utils are pure functions, they're easy to test:\n\n```typescript\n// validation.helpers.test.ts\nimport { validateEmail } from './validation.helpers.ts';\n\ndescribe('validateEmail', () => {\n  test('returns true for valid email', () => {\n    expect(validateEmail('user@example.com')).toBe(true);\n  });\n\n  test('returns false for invalid email', () => {\n    expect(validateEmail('invalid-email')).toBe(false);\n  });\n});\n```\n\n## Best Practices\n\n### **Keep Functions Small and Focused**\n- Each function should do one thing well\n- Avoid complex multi-step operations\n- Prefer composition over large functions\n\n### **Use TypeScript Types**\n- Provide proper type annotations\n- Use generic types where appropriate\n- Export types alongside functions\n\n### **Document Complex Logic**\n- Add JSDoc comments for complex algorithms\n- Explain business rules or edge cases\n- Provide usage examples\n\n### **Avoid Dependencies**\n- Don't import services or external libraries\n- Keep functions self-contained\n- Use only built-in JavaScript/TypeScript features\n\n### **Error Handling**\n- Validate inputs and throw descriptive errors\n- Use type guards to ensure type safety\n- Handle edge cases gracefully\n\n```typescript\nexport function calculatePercentage(value: number, total: number): number {\n  if (typeof value !== 'number' || typeof total !== 'number') {\n    throw new Error('Both value and total must be numbers');\n  }\n  \n  if (total === 0) {\n    throw new Error('Total cannot be zero');\n  }\n  \n  return (value / total) * 100;\n}\n```",[],[279,611,291],{"_103":623,"_95":624,"_155":625,"_157":612,"_158":137,"_159":136,"_161":162,"_105":626,"_100":32,"_164":304,"_166":627,"_167":22,"_168":-5,"_169":628,"_98":629},"59a29226-94b0-11f0-a75b-0224a6c84d84","email.helpers.ts","59a292a8-94b0-11f0-a75b-0224a6c84d84",["D",1758214558721],"import { parseVal } from \"https://esm.town/v/std/utils/index.ts\";\n\n/**\n * Email utility functions for Val Town email formatting and sanitization\n */\n\n/**\n * Sanitizes a val name to be compatible with Val Town email format requirements\n * Uses the actual val name up to the first problematic character\n */\nexport function sanitizeValNameForEmail(valName: string): string {\n  // Convert to lowercase first\n  const lowerName = valName.toLowerCase();\n  \n  // Find the first non-alphanumeric character\n  const firstBadCharIndex = lowerName.search(/[^a-z0-9]/);\n  \n  if (firstBadCharIndex === -1) {\n    // No problematic characters found, use the whole name (with reasonable limit)\n    return lowerName.substring(0, 20);\n  } else {\n    // Use everything up to the first problematic character\n    return lowerName.substring(0, firstBadCharIndex);\n  }\n}\n\n/**\n * Creates a Val Town from email address using the current val's information\n * Format: username.valname@valtown.email\n */\nexport function createValTownFromEmail(importMetaUrl: string, customValName?: string): string {\n  const val = parseVal(importMetaUrl);\n  \n  // Use custom val name if provided, otherwise sanitize the actual val name\n  const valName = customValName || sanitizeValNameForEmail(val.name);\n  \n  return `${val.username}.${valName}@valtown.email`;\n}\n\n/**\n * Sanitizes a display name for email headers to prevent parsing issues\n * Keeps only letters, numbers, and spaces for maximum compatibility\n */\nexport function sanitizeEmailDisplayName(displayName: string): string {\n  return displayName\n    .replace(/[^a-zA-Z0-9\\s]/g, '') // Keep only letters, numbers, and spaces\n    .replace(/\\s+/g, ' ')           // Replace multiple spaces with single space\n    .trim();                        // Remove leading/trailing whitespace\n}",[],[279,611,624],{"_103":631,"_95":632,"_155":633,"_157":612,"_158":137,"_159":581,"_161":162,"_105":634,"_100":160,"_164":304,"_166":635,"_167":22,"_168":-5,"_169":636,"_98":637},"e113a9ae-8f3b-11f0-8a97-0224a6c84d84","id.helpers.ts","2af45a2a-8e8b-11f0-9e5d-0224a6c84d84",["D",1757614779034],"/**\n * ID generation and key management utility functions\n */\n\n/**\n * Generate a simple session ID for tracking\n */\nexport function generateSessionId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n}\n\n/**\n * Generate standardized blob keys\n */\nexport function generateBlobKey(type: string, id: string): string {\n  return `glimpse--${type}--${id}`;\n}\n\n/**\n * Generate blob key prefix for listing operations\n */\nexport function generateBlobKeyPrefix(type: string): string {\n  return `glimpse--${type}--`;\n}\n\n/**\n * Parse blob keys to extract type and id\n */\nexport function parseBlobKey(key: string): { type: string; id: string } | null {\n  const match = key.match(/^glimpse--(.+)--(.+)$/);\n  if (match) {\n    return {\n      type: match[1],\n      id: match[2]\n    };\n  }\n  return null;\n}\n\n/**\n * Generate a random UUID-like string (not cryptographically secure)\n */\nexport function generateRandomId(): string {\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {\n    const r = Math.random() * 16 | 0;\n    const v = c == 'x' ? r : (r & 0x3 | 0x8);\n    return v.toString(16);\n  });\n}",[],[279,611,632],{"_103":639,"_95":640,"_155":641,"_157":612,"_158":137,"_159":136,"_161":162,"_105":642,"_100":160,"_164":304,"_166":643,"_167":22,"_168":-5,"_169":644,"_98":645},"59a2d4c0-94b0-11f0-a75b-0224a6c84d84","notion.helpers.ts","2af45c64-8e8b-11f0-9e5d-0224a6c84d84",["D",1758214558721],"/**\n * Notion-specific utility functions for property extraction and data transformation\n */\n\nexport interface AgentProperties {\n  agentName: string;\n  agentEmail: string;\n  agentMeetUrl: string;\n  agentPhone: string;\n}\n\n/**\n * Extract text from various Notion property types with detailed logging\n */\nexport function extractTextFromNotionProperty(property: any, propertyName: string): string {\n  if (!property) {\n    console.log(`❌ Property ${propertyName} is null/undefined`);\n    return \"\";\n  }\n  \n  console.log(`🔍 Processing property ${propertyName} of type: ${property.type}`, property);\n  \n  if (property.type === \"title\" && property.title && property.title.length > 0) {\n    const value = property.title[0].plain_text || \"\";\n    console.log(`✅ Extracted from title: \"${value}\"`);\n    return value;\n  } else if (property.type === \"rich_text\" && property.rich_text && property.rich_text.length > 0) {\n    const value = property.rich_text[0].plain_text || \"\";\n    console.log(`✅ Extracted from rich_text: \"${value}\"`);\n    return value;\n  } else if (property.type === \"email\" && property.email) {\n    const value = property.email;\n    console.log(`✅ Extracted from email: \"${value}\"`);\n    return value;\n  } else if (property.type === \"phone_number\" && property.phone_number) {\n    const value = property.phone_number;\n    console.log(`✅ Extracted from phone_number: \"${value}\"`);\n    return value;\n  } else if (property.type === \"url\" && property.url) {\n    const value = property.url;\n    console.log(`✅ Extracted from url: \"${value}\"`);\n    return value;\n  } else if (property.type === \"formula\" && property.formula) {\n    console.log(`🔍 Processing formula property with result type: ${property.formula.type}`, property.formula);\n    \n    if (property.formula.type === \"string\" && property.formula.string) {\n      const value = property.formula.string;\n      console.log(`✅ Extracted from formula (string): \"${value}\"`);\n      return value;\n    } else if (property.formula.type === \"number\" && property.formula.number !== null && property.formula.number !== undefined) {\n      const value = property.formula.number.toString();\n      console.log(`✅ Extracted from formula (number): \"${value}\"`);\n      return value;\n    } else if (property.formula.type === \"boolean\" && property.formula.boolean !== null && property.formula.boolean !== undefined) {\n      const value = property.formula.boolean.toString();\n      console.log(`✅ Extracted from formula (boolean): \"${value}\"`);\n      return value;\n    } else if (property.formula.type === \"date\" && property.formula.date && property.formula.date.start) {\n      const value = property.formula.date.start;\n      console.log(`✅ Extracted from formula (date): \"${value}\"`);\n      return value;\n    } else {\n      console.log(`❌ Could not extract value from formula property ${propertyName} with result type ${property.formula.type}`);\n    }\n  } else {\n    console.log(`❌ Could not extract value from property ${propertyName} of type ${property.type}`);\n  }\n  \n  return \"\";\n}\n\n/**\n * Find a property by checking multiple possible names\n */\nexport function findPropertyByNames(properties: any, possibleNames: string[]): { name: string; property: any } | null {\n  for (const propName of possibleNames) {\n    if (properties[propName]) {\n      return { name: propName, property: properties[propName] };\n    }\n  }\n  return null;\n}\n\n/**\n * Extract agent properties from a Notion page using specific property names\n */\nexport function extractAgentProperties(agentPage: any): AgentProperties {\n  const properties = agentPage.properties || {};\n  \n  // Extract agent name - check multiple possible property names\n  let agentName = \"\";\n  const nameProperties = [\"Name\", \"Title\", \"Agent Name\", \"name\", \"title\"];\n  console.log(`🔍 Looking for name in properties: ${nameProperties.join(\", \")}`);\n  \n  const nameResult = findPropertyByNames(properties, nameProperties);\n  if (nameResult) {\n    console.log(`✅ Found name property: ${nameResult.name}`);\n    agentName = extractTextFromNotionProperty(nameResult.property, nameResult.name);\n  }\n\n  // Extract agent email - look for \"Agent email\" property specifically\n  let agentEmail = \"\";\n  console.log(`🔍 Looking for email in property: \"Agent email\"`);\n  if (properties[\"Agent email\"]) {\n    console.log(`✅ Found email property: \"Agent email\"`);\n    agentEmail = extractTextFromNotionProperty(properties[\"Agent email\"], \"Agent email\");\n  } else {\n    console.log(`❌ \"Agent email\" property not found`);\n  }\n\n  // Extract agent meet URL - look for \"Google Meet URL\" property specifically\n  let agentMeetUrl = \"\";\n  console.log(`🔍 Looking for meet URL in property: \"Google Meet URL\"`);\n  if (properties[\"Google Meet URL\"]) {\n    console.log(`✅ Found meet URL property: \"Google Meet URL\"`);\n    agentMeetUrl = extractTextFromNotionProperty(properties[\"Google Meet URL\"], \"Google Meet URL\");\n  } else {\n    console.log(`❌ \"Google Meet URL\" property not found`);\n  }\n\n  // Extract agent phone - look for \"Phone\" property specifically\n  let agentPhone = \"\";\n  console.log(`🔍 Looking for phone in property: \"Phone\"`);\n  if (properties[\"Phone\"]) {\n    console.log(`✅ Found phone property: \"Phone\"`);\n    agentPhone = extractTextFromNotionProperty(properties[\"Phone\"], \"Phone\");\n  } else {\n    console.log(`❌ \"Phone\" property not found`);\n  }\n\n  const result = {\n    agentName,\n    agentEmail,\n    agentMeetUrl,\n    agentPhone\n  };\n  \n  console.log(`📊 Final extraction result:`, result);\n  return result;\n}",[],[279,611,640],{"_103":647,"_95":648,"_155":649,"_157":612,"_158":137,"_159":293,"_161":162,"_105":650,"_100":32,"_164":304,"_166":651,"_167":22,"_168":-5,"_169":652,"_98":653},"2af4604c-8e8b-11f0-9e5d-0224a6c84d84","validation.helpers.ts","2af460c4-8e8b-11f0-9e5d-0224a6c84d84",["D",1757538882052],"/**\n * Validation utility functions\n */\n\n/**\n * Validate email format\n */\nexport function validateEmail(email: string): boolean {\n  if (!email || typeof email !== 'string') {\n    return false;\n  }\n  \n  const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n  return emailRegex.test(email);\n}\n\n/**\n * Validate URL format\n */\nexport function validateUrl(url: string): boolean {\n  if (!url || typeof url !== 'string') {\n    return false;\n  }\n  \n  try {\n    new URL(url);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validate UUID format\n */\nexport function validateUuid(id: string): boolean {\n  if (!id || typeof id !== 'string') {\n    return false;\n  }\n  \n  const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n  return uuidRegex.test(id);\n}\n\n/**\n * Check if string is not empty\n */\nexport function isNotEmpty(value: string): boolean {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\n/**\n * Validate phone number format (basic validation)\n */\nexport function validatePhoneNumber(phone: string): boolean {\n  if (!phone || typeof phone !== 'string') {\n    return false;\n  }\n  \n  // Basic phone validation - digits, spaces, dashes, parentheses, plus\n  const phoneRegex = /^[\\+]?[\\d\\s\\-\\(\\)]{10,}$/;\n  return phoneRegex.test(phone);\n}",[],[279,611,648],{"_103":655,"_95":656,"_155":657,"_157":612,"_158":137,"_159":348,"_161":162,"_105":658,"_100":32,"_164":304,"_166":659,"_167":22,"_168":-5,"_169":660,"_98":661},"243cd160-930b-11f0-8c3a-0224a6c84d84","viewing.helpers.ts","243cd23c-930b-11f0-8c3a-0224a6c84d84",["D",1758033651020],"/**\n * Viewing-specific utility functions\n */\n\n/**\n * Standard response format for viewing operations\n */\nexport interface ViewingResponse {\n  success: boolean;\n  data?: T;\n  error?: string;\n  details?: string;\n}\n\n/**\n * Migrate old blob structure to new unified sessionStart format\n */\nexport function migrateOldBlobStructure(data: any): any {\n  if (!data || typeof data !== 'object') {\n    return data;\n  }\n\n  // Handle backward compatibility - migrate old data structure\n  if (data.sessionStarted && !data.sessionStart) {\n    data.sessionStart = data.viewing ? data.sessionStarted : null;\n  }\n\n  return data;\n}\n\n/**\n * Derive viewing state from sessionStart property\n */\nexport function deriveViewingState(data: any): boolean {\n  if (!data || typeof data !== 'object') {\n    return false;\n  }\n  return data.sessionStart !== null && data.sessionStart !== undefined;\n}\n\n/**\n * Check if blob data is stale based on lastUpdate timestamp\n */\nexport function isDataStale(data: any, thresholdMinutes: number): boolean {\n  if (!data?.lastUpdate) {\n    return true; // No lastUpdate means stale\n  }\n\n  try {\n    const lastUpdate = new Date(data.lastUpdate);\n    const now = new Date();\n    const thresholdTime = new Date(now.getTime() - thresholdMinutes * 60 * 1000);\n    \n    return lastUpdate < thresholdTime;\n  } catch {\n    return true; // Invalid date means stale\n  }\n}\n\n/**\n * Constants for viewing operations\n */\nexport const VIEWING_CONSTANTS = {\n  STALE_THRESHOLD_MINUTES: 30,\n  CLEANUP_THRESHOLD_SECONDS: 60,\n  BLOB_TYPE: \"viewing\"\n} as const;",[],[279,611,656],[279,611],{"_103":664,"_95":291,"_155":665,"_157":280,"_158":137,"_159":293,"_161":162,"_105":666,"_100":160,"_164":176,"_166":667,"_167":22,"_168":-5,"_169":668,"_98":669},"2af478b6-8e8b-11f0-9e5d-0224a6c84d84","01991bd6-e87d-71bd-b757-a36037d84a9f",["D",1757538882052],"# Backend\n\nThe backend follows a clean architecture with proper separation of concerns across multiple layers.\n\n## Architecture Overview\n\n### **Separation of Concerns**\n\nThe backend is organized into distinct layers, each with specific responsibilities:\n\n#### **Architecture Layers**\n- **Controllers**: Business logic, workflow orchestration, HTTP handling\n- **Services**: External integrations and data persistence operations\n- **Routes**: HTTP routing, middleware application, parameter extraction\n- **Utils**: Pure utility functions with no external dependencies\n\n#### **Data Flow Pattern**\n```\nRequest → Routes (middleware + routing) → Controllers (business logic + orchestration) → Services (external operations) + Utils (pure functions) → Response\n```\n\n#### **Key Principles**\n- Controllers orchestrate services and use utilities to implement business workflows\n- Services handle external system interactions (APIs, databases, storage)\n- Utils provide pure, reusable functions with no side effects\n- Routes focus purely on HTTP concerns and middleware\n\n### **Layer Interactions**\n\n#### **Controllers Use Both Services and Utils**\n```typescript\n// Controller orchestrates services and uses utils\nconst pageData = await getPageById(pageId); // SERVICE call\nconst cleanedData = formatAgentProperties(pageData); // UTIL function\nawait setAgentBlob(pageId, cleanedData); // SERVICE call\n```\n\n#### **Clear Distinction: Services vs Utils**\n- **Services**: \"I need to talk to Notion API\" → `notion/page.service.ts`\n- **Utils**: \"I need to format this date\" → `utils/date.helpers.ts`\n- **Services**: \"I need to store this in blob storage\" → `blob.service.ts`\n- **Utils**: \"I need to validate this email format\" → `utils/validation.helpers.ts`\n\n## Directory Structure\n\n```\nbackend/\n├── controllers/         # Business logic and workflow orchestration\n├── routes/             # HTTP routing and middleware\n├── services/           # External integrations (APIs, storage)\n├── utils/              # Pure utility functions\n├── types/              # TypeScript type definitions\n└── crons/              # Scheduled tasks\n```\n\n## Response Format Standards\n\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.",[],[279,291],[279],{"_103":672,"_95":673,"_155":674,"_157":-5,"_158":137,"_159":160,"_161":162,"_105":675,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":676,"_98":923},"8e5fce70-8aa1-11f0-95bf-0224a6c84d84","frontend","01991bd6-e87d-71bd-b757-ad8921e84f94",["D",1757108693058],[677,712,758,803,818,863,900,907,915],{"_103":678,"_95":679,"_155":680,"_157":674,"_158":137,"_159":313,"_161":162,"_105":681,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":682,"_98":711},"3a44e538-8b45-11f0-b0c3-0224a6c84d84","components","01992007-8bab-705c-8e2b-570970e9d503",["D",1757178989487],[683,693,702],{"_103":684,"_95":685,"_155":686,"_157":680,"_158":137,"_159":687,"_161":162,"_105":688,"_100":689,"_164":304,"_166":690,"_167":22,"_168":-5,"_169":691,"_98":692},"c31446a4-9240-11f0-b143-0224a6c84d84","GlimpseView.tsx","3a44b6f8-8b45-11f0-b0c3-0224a6c84d84",36,["D",1757946729670],23,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, {\n  useEffect,\n  useState,\n} from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { createPortal } from \"https://esm.sh/react-dom@18.2.0?deps=react@18.2.0,react-dom@18.2.0\";\nimport { NotionBlocks } from \"./NotionBlock.tsx\";\nimport { NotionProperty } from \"./NotionProperty.tsx\";\nimport { extractUserEmail, formatPageTitle } from \"../utils/dataExtraction.ts\";\nimport { startCobrowseSession } from \"../services/cobrowseService.ts\";\nimport { useAuth } from \"../hooks/useAuth.ts\";\nimport { useGlimpseData } from \"../hooks/useGlimpseData.ts\";\nimport { useAgentData } from \"../hooks/useAgentData.ts\";\nimport { useViewingTracking } from \"../hooks/useViewingTracking.ts\";\n\ninterface GlimpseViewProps {\n  initialData: any;\n  glimpseId: string;\n}\n\nexport function GlimpseView({ initialData, glimpseId }: GlimpseViewProps) {\n  // Use custom hooks for all stateful logic\n  const { userEmail, isAuthorized } = useAuth();\n  const { data, loading, error, refetch } = useGlimpseData(\n    glimpseId,\n    initialData,\n  );\n  const { agentData, hasAgents } = useAgentData(\n    glimpseId,\n    isAuthorized(data?.data?.properties),\n  );\n\n  // Set up viewing tracking (side effect only)\n  useViewingTracking(glimpseId, isAuthorized(data?.data?.properties));\n\n  // Waiting state for when no agent is assigned yet\n  const [waitingProgress, setWaitingProgress] = useState(0);\n  const [startTime] = useState(Date.now());\n\n  useEffect(() => {\n    if (hasAgents) return; // Don't run timer if agent is already assigned\n\n    const interval = setInterval(() => {\n      const elapsed = Date.now() - startTime;\n      const progress = Math.min((elapsed / 120000) * 100, 100); // 120 seconds = 120000ms\n      setWaitingProgress(progress);\n    }, 100); // Update every 100ms for smooth animation\n\n    return () => clearInterval(interval);\n  }, [hasAgents, startTime]);\n\n  // Populate header with dynamic content\n  const renderHeaderContent = () => {\n    const headerRight = document.getElementById(\"header-right\");\n    if (!headerRight || !data?.success) return null;\n\n    const pageData = data.data;\n    const properties = pageData?.properties || {};\n\n    // Extract email using utility function\n    const email = extractUserEmail(properties);\n\n    return createPortal(\n      <>\n        {email && {email}}\n        \n          Logout\n        \n      ,\n      headerRight,\n    );\n  };\n\n  if (loading) {\n    return (\n      \n        \n        
\n        Loading glimpse...\n      
\n    );\n  }\n\n  if (error || !data?.success) {\n    const errorInfo = error || data;\n    return (\n      \n        \n          \n            ❌
\n            \n              {errorInfo?.error || \"Error Loading Glimpse\"}\n            
\n          
\n\n          {errorInfo?.details && (\n            \n              \n                {errorInfo.details}\n              
\n            
\n          )}\n\n          \n            \n              Try Again\n            \n            \n              Back to Dashboard\n            \n          
\n        
\n      
\n    );\n  }\n\n  const pageData = data.data;\n  const properties = pageData?.properties || {};\n  const blocks = pageData?.blocks || [];\n\n  // Use utility function for page title\n  const pageTitle = formatPageTitle(properties);\n\n  return (\n    \n      {/* Render header content via portal */}\n      {renderHeaderContent()}\n\n      {/* Waiting State - show when no agents are assigned yet */}\n      {!hasAgents && (\n        \n          \n            \n              👋\n              Hi! Welcome to Glimpse.\n            
\n\n            \n              \n                \n                  \n                    A message has been sent to Glance HQ to find a Glancer to\n                    cobrowse with. Only takes a minute or two during business\n                    hours (9am - 5pm eastern).\n                  
\n                
\n              
\n\n              {/* Progress Bar */}\n              \n                \n                  Finding your Glancer...\n                  {Math.round(waitingProgress)}%\n                
\n                \n                  \n                  
\n                
\n                \n                  Expected wait time: up to 2 minutes\n                
\n              
\n              \n                Sorry to miss you this time. We'll reach out via email to\n                coordinate a time to connect and cobrowse.\n              
\n            
\n          
\n        
\n      )}\n\n      {/* Remote Support - only show if agents exist */}\n      {hasAgents && (\n        \n          \n            \n              {agentData.agents[0]?.agentName || \"A Glancer\"}{\" \"}\n              is ready to cobrowse with you\n            
\n\n            {/* Single Agent Display */}\n\n            \n              \n                Your agent:\n                \n                  {agentData.agents[0]?.agentName || \"N/A\"}{\" \"}\n                  {agentData.agents[0]?.agentEmail || \"N/A\"}\n                \n              
\n            
\n\n            {/* Two callout divs */}\n            \n              {/* Connect callout */}\n              \n                \n                  First, connect\n                
\n                \n                  {agentData.agents[0]?.agentName || \"Agent\"}{\" \"}\n                  is ready to connect with you\n                
\n                {agentData.agents[0]?.agentMeetUrl\n                  ? (\n                    \n                      Join on Google Meet\n                    \n                  )\n                  : (\n                    \n                      Join on Google Meet\n                    \n                  )}\n                \n                  Or, connect by phone {agentData.agents[0]?.agentPhone\n                    ? (\n                      \n                        {agentData.agents[0].agentPhone}\n                      \n                    )\n                    : N/A}\n                
\n              
\n\n              {/* Cobrowse callout */}\n              \n                \n                  Next, cobrowse\n                
\n                \n                  Cobrowse this page with {agentData.agents[0].agentName}\n                
\n                \n                  Start cobrowing session\n                \n              
\n            
\n          
\n        
\n      )}\n\n      {/* Page Content */}\n      \n        \n          {blocks.length > 0\n            ? (\n              \n                \n              
\n            )\n            : (\n              \n                📄
\n                This page has no content blocks.
\n              
\n            )}\n        
\n      
\n\n      {/* Page Properties */}\n      {Object.keys(properties).length > 0 && (\n        \n          \n            Properties
\n          
\n          \n            \n              {Object.entries(properties).map(([key, value]) => (\n                \n              ))}\n            
\n          
\n        
\n      )}\n\n      {/* Debug Info (only in development) */}\n      {window.location.hostname === \"localhost\" && (\n        \n          \n            \n              Debug: Raw Data\n            
\n            \n              {JSON.stringify(pageData, null, 2)}\n            
\n          
\n        
\n      )}\n    \n  );\n}",[],[673,679,685],{"_103":694,"_95":695,"_155":696,"_157":680,"_158":137,"_159":697,"_161":162,"_105":698,"_100":313,"_164":304,"_166":699,"_167":22,"_168":-5,"_169":700,"_98":701},"89c022d6-8f77-11f0-9181-0224a6c84d84","NotionBlock.tsx","3a44c8b4-8b45-11f0-b0c3-0224a6c84d84",34,["D",1757640402327],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useEffect } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n\n// TypeScript declaration for Prism global\ndeclare global {\n  interface Window {\n    Prism?: {\n      highlightAll: () => void;\n      plugins?: {\n        autoloader?: {\n          languages_path: string;\n        };\n      };\n    };\n  }\n}\n\n// Map Notion language names to Prism language identifiers\nconst mapNotionLanguageToPrism = (notionLang: string): string => {\n  const langMap: Record = {\n    'javascript': 'javascript',\n    'typescript': 'typescript',\n    'python': 'python',\n    'java': 'java',\n    'c': 'c',\n    'c++': 'cpp',\n    'c#': 'csharp',\n    'php': 'php',\n    'ruby': 'ruby',\n    'go': 'go',\n    'rust': 'rust',\n    'swift': 'swift',\n    'kotlin': 'kotlin',\n    'scala': 'scala',\n    'html': 'html',\n    'css': 'css',\n    'scss': 'scss',\n    'sass': 'sass',\n    'less': 'less',\n    'json': 'json',\n    'xml': 'xml',\n    'yaml': 'yaml',\n    'yml': 'yaml',\n    'markdown': 'markdown',\n    'sql': 'sql',\n    'bash': 'bash',\n    'shell': 'bash',\n    'sh': 'bash',\n    'powershell': 'powershell',\n    'dockerfile': 'docker',\n    'docker': 'docker',\n    'nginx': 'nginx',\n    'apache': 'apacheconf',\n    'git': 'git',\n    'diff': 'diff',\n    'plain text': 'text',\n    'text': 'text'\n  };\n  \n  const normalized = notionLang.toLowerCase().trim();\n  return langMap[normalized] || 'text';\n};\n\ninterface NotionBlockProps {\n  block: any;\n  level?: number;\n}\n\ninterface NotionBlocksProps {\n  blocks: any[];\n  level?: number;\n}\n\n// Helper component to group and render multiple blocks with list handling\nexport function NotionBlocks({ blocks, level = 0 }: NotionBlocksProps) {\n  useEffect(() => {\n    // Trigger Prism highlighting after component mounts/updates\n    const highlightCode = () => {\n      if (typeof window !== 'undefined' && window.Prism) {\n        window.Prism.highlightAll();\n      }\n    };\n\n    // Small delay to ensure DOM is fully rendered\n    const timeoutId = setTimeout(highlightCode, 10);\n    \n    return () => clearTimeout(timeoutId);\n  });\n\n  if (!blocks || blocks.length === 0) {\n    return null;\n  }\n\n  const groupedBlocks: JSX.Element[] = [];\n  let i = 0;\n\n  while (i < blocks.length) {\n    const block = blocks[i];\n    \n    // Handle bulleted list grouping\n    if (block.type === 'bulleted_list_item') {\n      const listItems: any[] = [];\n      \n      // Collect consecutive bulleted list items\n      while (i < blocks.length && blocks[i].type === 'bulleted_list_item') {\n        listItems.push(blocks[i]);\n        i++;\n      }\n      \n      groupedBlocks.push(\n        \n          {listItems.map((item, index) => (\n            \n          ))}\n        
\n      );\n      continue;\n    }\n    \n    // Handle numbered list grouping\n    if (block.type === 'numbered_list_item') {\n      const listItems: any[] = [];\n      \n      // Collect consecutive numbered list items\n      while (i < blocks.length && blocks[i].type === 'numbered_list_item') {\n        listItems.push(blocks[i]);\n        i++;\n      }\n      \n      groupedBlocks.push(\n        \n          {listItems.map((item, index) => (\n            \n          ))}\n        
\n      );\n      continue;\n    }\n    \n    // Handle regular blocks\n    groupedBlocks.push(\n      \n    );\n    i++;\n  }\n\n  return <>{groupedBlocks};\n}\n\nexport function NotionBlock({ block, level = 0 }: NotionBlockProps) {\n  if (!block || !block.type) {\n    return null;\n  }\n\n  const renderRichText = (richText: any[]) => {\n    if (!richText || !Array.isArray(richText)) {\n      return '';\n    }\n\n    return richText.map((text, index) => {\n      let content = text.plain_text || '';\n      \n      // Apply text formatting\n      if (text.annotations?.bold) {\n        content = {content};\n      }\n      if (text.annotations?.italic) {\n        content = {content};\n      }\n      if (text.annotations?.strikethrough) {\n        content = {content};\n      }\n      if (text.annotations?.underline) {\n        content = {content};\n      }\n      if (text.annotations?.code) {\n        content = {content};\n      }\n      \n      // Handle links\n      if (text.href) {\n        content = (\n          \n            {content}\n          \n        );\n      }\n      \n      return content;\n    });\n  };\n\n  const renderChildren = () => {\n    if (!block.children || block.children.length === 0) {\n      return null;\n    }\n\n    // Check if current block is a list item\n    const isListItem = block.type === 'bulleted_list_item' || block.type === 'numbered_list_item';\n    \n    if (isListItem) {\n      // For list items, separate list children from non-list children\n      const listChildren: any[] = [];\n      const nonListChildren: any[] = [];\n      \n      block.children.forEach((child: any) => {\n        if (child.type === 'bulleted_list_item' || child.type === 'numbered_list_item') {\n          listChildren.push(child);\n        } else {\n          nonListChildren.push(child);\n        }\n      });\n      \n      return (\n        <>\n          {/* Render nested lists directly (no wrapper div) */}\n          {listChildren.length > 0 && (\n            \n          )}\n          \n          {/* Render non-list content with wrapper for indentation */}\n          {nonListChildren.length > 0 && (\n            \n              \n            
\n          )}\n        \n      );\n    }\n    \n    // For non-list items, use normal wrapper with indentation\n    return (\n       0 ? \"ml-6\" : \"\"}>\n        \n      
\n    );\n  };\n\n  const blockContent = block[block.type];\n\n  switch (block.type) {\n    // Simple blocks - no wrapper needed\n    case 'paragraph':\n      const hasChildren = block.children && block.children.length > 0;\n      if (hasChildren) {\n        // If paragraph has children, we need a wrapper\n        return (\n          <>\n            {renderRichText(blockContent?.rich_text)}
\n            {renderChildren()}\n          \n        );\n      }\n      return (\n        {renderRichText(blockContent?.rich_text)}
\n      );\n\n    case 'heading_1':\n      return (\n        <>\n          {renderRichText(blockContent?.rich_text)}
\n          {renderChildren()}\n        \n      );\n\n    case 'heading_2':\n      return (\n        <>\n          {renderRichText(blockContent?.rich_text)}
\n          {renderChildren()}\n        \n      );\n\n    case 'heading_3':\n      return (\n        <>\n          {renderRichText(blockContent?.rich_text)}
\n          {renderChildren()}\n        \n      );\n\n    // List items - no wrapper, will be wrapped by ul/ol in NotionBlocks\n    case 'bulleted_list_item':\n    case 'numbered_list_item':\n      return (\n        \n          {renderRichText(blockContent?.rich_text)}\n          {renderChildren()}\n        
\n      );\n\n    case 'quote':\n      return (\n        <>\n          \n            {renderRichText(blockContent?.rich_text)}\n          
\n          {renderChildren()}\n        \n      );\n\n    case 'divider':\n      return 
;\n\n    case 'code':\n      const codeContent = blockContent?.rich_text?.map((t: any) => t.plain_text).join('') || '';\n      const language = blockContent?.language || 'text';\n      const prismLanguage = mapNotionLanguageToPrism(language);\n      \n      return (\n        <>\n          \n            \n              \n                {codeContent}\n              \n            
\n            {language && language !== 'plain text' && (\n              \n                {language}\n              
\n            )}\n          
\n          {renderChildren()}\n        \n      );\n\n    // Complex blocks - wrapper needed\n    case 'to_do':\n      return (\n        \n          \n          \n            \n              {renderRichText(blockContent?.rich_text)}\n            \n            {renderChildren()}\n          
\n        
\n      );\n\n    case 'toggle':\n      return (\n        \n          \n            \n              \n                ▶\n              \n              {renderRichText(blockContent?.rich_text)}\n            
\n            \n              {renderChildren()}\n            
\n          
\n        
\n      );\n\n    case 'callout':\n      return (\n        \n          {blockContent?.icon && (\n            \n              {blockContent.icon.emoji || blockContent.icon.external?.url || '💡'}\n            
\n          )}\n          \n            {renderRichText(blockContent?.rich_text)}\n            {renderChildren()}\n          
\n        
\n      );\n\n    // Media blocks - conditional wrapper based on caption\n    case 'image':\n      const imageUrl = blockContent?.external?.url || blockContent?.file?.url;\n      const imageCaption = blockContent?.caption ? renderRichText(blockContent.caption) : '';\n      \n      if (!imageUrl) return null;\n      \n      if (imageCaption) {\n        return (\n          \n            \n            \n              {imageCaption}\n            
\n            {renderChildren()}\n          
\n        );\n      }\n      \n      return (\n        <>\n          \n          {renderChildren()}\n        \n      );\n\n    case 'video':\n      const videoUrl = blockContent?.external?.url || blockContent?.file?.url;\n      const videoCaption = blockContent?.caption ? renderRichText(blockContent.caption) : '';\n      \n      if (!videoUrl) return null;\n      \n      if (videoCaption) {\n        return (\n          \n            \n            \n              {videoCaption}\n            
\n            {renderChildren()}\n          
\n        );\n      }\n      \n      return (\n        <>\n          \n          {renderChildren()}\n        \n      );\n\n    case 'file':\n      const fileUrl = blockContent?.external?.url || blockContent?.file?.url;\n      const fileName = blockContent?.name || 'Download file';\n      \n      return (\n        \n          {fileUrl && (\n            \n              📎\n              {fileName}\n            \n          )}\n          {renderChildren()}\n        
\n      );\n\n    case 'bookmark':\n      const bookmarkUrl = blockContent?.url;\n      \n      return (\n        \n          {bookmarkUrl && (\n            \n              🔖\n              {bookmarkUrl}\n            \n          )}\n          {renderChildren()}\n        
\n      );\n\n    case 'embed':\n      const embedUrl = blockContent?.url;\n      \n      return (\n        \n          {embedUrl && (\n            \n              🔗\n              {embedUrl}\n            \n          )}\n          {renderChildren()}\n        
\n      );\n\n    // Table blocks - semantic structure\n    case 'table':\n      return (\n        \n          \n            \n          \n        
\n      );\n\n    case 'table_row':\n      return (\n        \n          {blockContent?.cells?.map((cell: any[], index: number) => (\n            \n              {renderRichText(cell)}\n            \n          ))}\n        \n      );\n\n    case 'column_list':\n      return (\n        \n          \n        
\n      );\n\n    case 'column':\n      return (\n        \n          \n        
\n      );\n\n    default:\n      // For unsupported block types, show a placeholder\n      return (\n        \n          \n            Unsupported block type: {block.type}\n          
\n          {blockContent?.rich_text && (\n            \n              {renderRichText(blockContent.rich_text)}\n            
\n          )}\n          {renderChildren()}\n        
\n      );\n  }\n}",[],[673,679,695],{"_103":703,"_95":704,"_155":705,"_157":680,"_158":137,"_159":706,"_161":162,"_105":707,"_100":160,"_164":304,"_166":708,"_167":22,"_168":-5,"_169":709,"_98":710},"a4fd3f60-8f69-11f0-8869-0224a6c84d84","NotionProperty.tsx","3a44d5fc-8b45-11f0-b0c3-0224a6c84d84",19,["D",1757634435067],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { extractPlainText, formatNotionDate, formatMultiSelect, formatBoolean } from \"../utils/notionFormatting.ts\";\n\ninterface NotionPropertyProps {\n  name: string;\n  property: any;\n}\n\nexport function NotionProperty({ name, property }: NotionPropertyProps) {\n  if (!property || property.type === 'button') {\n    return null; // Skip button properties and invalid properties\n  }\n\n  const renderPropertyValue = () => {\n    switch (property.type) {\n      case 'title':\n        return extractPlainText(property.title);\n      \n      case 'rich_text':\n        return extractPlainText(property.rich_text);\n      \n      case 'number':\n        return property.number?.toString() || '';\n      \n      case 'select':\n        return property.select?.name || '';\n      \n      case 'multi_select':\n        return formatMultiSelect(property.multi_select);\n      \n      case 'date':\n        return property.date?.start ? formatNotionDate(property.date.start) : '';\n      \n      case 'checkbox':\n        return formatBoolean(property.checkbox);\n      \n      case 'url':\n        return property.url ? (\n          \n            {property.url}\n          \n        ) : '';\n      \n      case 'email':\n        return property.email ? (\n          \n            {property.email}\n          \n        ) : '';\n      \n      case 'phone_number':\n        return property.phone_number ? (\n          \n            {property.phone_number}\n          \n        ) : '';\n      \n      case 'formula':\n        if (property.formula?.type === 'string') {\n          return property.formula.string || '';\n        } else if (property.formula?.type === 'number') {\n          return property.formula.number?.toString() || '';\n        } else if (property.formula?.type === 'boolean') {\n          return formatBoolean(property.formula.boolean, 'True', 'False');\n        } else if (property.formula?.type === 'date') {\n          return property.formula.date?.start ? formatNotionDate(property.formula.date.start) : '';\n        }\n        return '';\n      \n      case 'relation':\n        return property.relation?.length > 0 ? `${property.relation.length} related item(s)` : '';\n      \n      case 'rollup':\n        if (property.rollup?.type === 'array') {\n          return `${property.rollup.array?.length || 0} item(s)`;\n        } else if (property.rollup?.type === 'number') {\n          return property.rollup.number?.toString() || '';\n        }\n        return '';\n      \n      case 'people':\n        return property.people?.map((person: any) => person.name || person.id).join(', ') || '';\n      \n      case 'files':\n        return property.files?.length > 0 ? `${property.files.length} file(s)` : '';\n      \n      case 'created_time':\n        return new Date(property.created_time).toLocaleString();\n      \n      case 'last_edited_time':\n        return new Date(property.last_edited_time).toLocaleString();\n      \n      case 'created_by':\n        return property.created_by?.name || property.created_by?.id || '';\n      \n      case 'last_edited_by':\n        return property.last_edited_by?.name || property.last_edited_by?.id || '';\n      \n      case 'status':\n        return property.status?.name || '';\n      \n      default:\n        return JSON.stringify(property);\n    }\n  };\n\n  const value = renderPropertyValue();\n  \n  // Don't render empty properties\n  if (!value || (typeof value === 'string' && value.trim() === '')) {\n    return null;\n  }\n\n  // Get property type icon\n  const getTypeIcon = () => {\n    switch (property.type) {\n      case 'title': return '📝';\n      case 'rich_text': return '📄';\n      case 'number': return '🔢';\n      case 'select': return '🏷️';\n      case 'multi_select': return '🏷️';\n      case 'date': return '📅';\n      case 'checkbox': return '☑️';\n      case 'url': return '🔗';\n      case 'email': return '📧';\n      case 'phone_number': return '📞';\n      case 'formula': return '🧮';\n      case 'relation': return '🔗';\n      case 'rollup': return '📊';\n      case 'people': return '👥';\n      case 'files': return '📎';\n      case 'created_time': return '⏰';\n      case 'last_edited_time': return '✏️';\n      case 'created_by': return '👤';\n      case 'last_edited_by': return '👤';\n      case 'status': return '🏃';\n      default: return '❓';\n    }\n  };\n\n  return (\n    \n      \n        {getTypeIcon()}\n        {name}\n        \n          {property.type}\n        \n      
\n      \n        {value}\n      
\n    
\n  );\n}",[],[673,679,704],[673,679],{"_103":713,"_95":714,"_155":715,"_157":674,"_158":137,"_159":706,"_161":162,"_105":716,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":717,"_98":757},"a4fd21e2-8f69-11f0-8869-0224a6c84d84","hooks","01993b2d-17fc-721e-b184-069e9c8e6036",["D",1757634435067],[718,725,733,741,749],{"_103":719,"_95":291,"_155":720,"_157":715,"_158":137,"_159":403,"_161":162,"_105":721,"_100":160,"_164":176,"_166":722,"_167":22,"_168":-5,"_169":723,"_98":724},"10cbacb0-936e-11f0-929c-0224a6c84d84","a4fcf0b4-8f69-11f0-8869-0224a6c84d84",["D",1758076138575],"# Frontend Hooks\n\nThis directory contains custom React hooks that encapsulate stateful logic and side effects.\n\n## Files\n\n### `useAuth.ts`\nHandles authentication and authorization logic.\n\n**Returns:** `UseAuthReturn`\n- `userEmail` - Current user's email from window data\n- `isAuthorized(pageProperties)` - Function to check if user can access a page\n\n**Usage:**\n```typescript\nconst { userEmail, isAuthorized } = useAuth();\nconst canView = isAuthorized(pageProperties);\n```\n\n### `useGlimpseData.ts`\nManages glimpse data fetching and state.\n\n**Parameters:**\n- `glimpseId` - ID of the glimpse to fetch\n- `initialData` - Optional initial data to avoid refetching\n\n**Returns:** `UseGlimpseDataReturn`\n- `data` - Current glimpse data\n- `loading` - Loading state\n- `error` - Error state\n- `refetch` - Function to manually refetch data\n\n**Usage:**\n```typescript\nconst { data, loading, error, refetch } = useGlimpseData(glimpseId, initialData);\n```\n\n### `useAgentData.ts`\nManages agent data fetching with automatic polling.\n\n**Parameters:**\n- `glimpseId` - ID of the glimpse\n- `isAuthorized` - Whether user is authorized (controls polling)\n\n**Returns:** `UseAgentDataReturn`\n- `agentData` - Current agent data\n- `hasAgents` - Boolean indicating if agents exist\n\n**Usage:**\n```typescript\nconst { agentData, hasAgents } = useAgentData(glimpseId, isAuthorized);\n```\n\n### `useViewingTracking.ts`\nHandles viewing status tracking with automatic updates and reliable session ending.\n\n**Parameters:**\n- `glimpseId` - ID of the glimpse being viewed\n- `isAuthorized` - Whether user is authorized (controls tracking)\n\n**Side Effects:**\n- Sends initial viewing status update on mount\n- Sends periodic viewing status updates every 10 seconds\n- Tracks page visibility changes (tab focus/blur)\n- Handles page unload events for reliable session ending\n- Cleans up all listeners and intervals on unmount\n\n**Session Tracking:**\n- Uses `sendBeacon` API for reliable session ending during page unload\n- Falls back to synchronous fetch if sendBeacon fails\n- Handles both normal component unmount and browser tab closure\n\n**Usage:**\n```typescript\nuseViewingTracking(glimpseId, isAuthorized);\n```\n\n## Benefits\n\n- **Reusable logic**: Hooks can be used across multiple components\n- **Separation of concerns**: Stateful logic separate from rendering\n- **Easier testing**: Hooks can be tested independently\n- **Better performance**: Optimized state management and cleanup\n- **Consistent patterns**: Standardized approach to common operations",[],[673,714,291],{"_103":726,"_95":727,"_155":728,"_157":715,"_158":137,"_159":706,"_161":162,"_105":729,"_100":32,"_164":304,"_166":730,"_167":22,"_168":-5,"_169":731,"_98":732},"a4fcfaa0-8f69-11f0-8869-0224a6c84d84","useAgentData.ts","a4fcfb22-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Custom hook for managing agent data fetching and polling\n */\n\nimport { useState, useEffect, useRef } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { fetchAgentData } from \"../services/agentService.ts\";\nimport type { UseAgentDataReturn } from \"../types/hooks.ts\";\nimport type { AgentData } from \"../types/agent.ts\";\n\n/**\n * Hook for managing agent data with automatic polling\n */\nexport function useAgentData(\n  glimpseId: string,\n  isAuthorized: boolean\n): UseAgentDataReturn {\n  const [agentData, setAgentData] = useState(null);\n  const intervalRef = useRef(null);\n\n  const fetchData = async () => {\n    // Only make API calls if user is authorized\n    if (!isAuthorized) {\n      return;\n    }\n\n    const result = await fetchAgentData(glimpseId);\n    setAgentData(result);\n  };\n\n  // Set up agent data polling\n  useEffect(() => {\n    if (!glimpseId) return;\n\n    // Only set up agent tracking if user is authorized\n    if (!isAuthorized) {\n      console.log(\"Skipping agent data setup - user not authorized\");\n      return;\n    }\n\n    // Initial agent data fetch\n    fetchData();\n\n    // Set up periodic updates every 5 seconds\n    intervalRef.current = setInterval(() => {\n      fetchData();\n    }, 5000);\n\n    // Cleanup function\n    return () => {\n      if (intervalRef.current) {\n        clearInterval(intervalRef.current);\n        intervalRef.current = null;\n      }\n    };\n  }, [glimpseId, isAuthorized]);\n\n  const hasAgents = agentData?.agents?.length > 0;\n\n  return {\n    agentData,\n    hasAgents,\n  };\n}",[],[673,714,727],{"_103":734,"_95":735,"_155":736,"_157":715,"_158":137,"_159":706,"_161":162,"_105":737,"_100":32,"_164":304,"_166":738,"_167":22,"_168":-5,"_169":739,"_98":740},"a4fcfcda-8f69-11f0-8869-0224a6c84d84","useAuth.ts","a4fcfd48-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Custom hook for handling authentication and authorization logic\n */\n\nimport { useMemo } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { getUserEmailFromWindow, checkAuthorization } from \"../utils/validation.ts\";\nimport type { UseAuthReturn } from \"../types/hooks.ts\";\nimport type { NotionProperties } from \"../types/notion.ts\";\n\n/**\n * Hook for managing user authentication and page authorization\n */\nexport function useAuth(): UseAuthReturn {\n  // Get user email from window (injected during page load)\n  const userEmail = useMemo(() => getUserEmailFromWindow(), []);\n\n  // Create authorization checker function\n  const isAuthorized = useMemo(() => {\n    return (pageProperties: NotionProperties | null | undefined) => {\n      return checkAuthorization(userEmail, pageProperties);\n    };\n  }, [userEmail]);\n\n  return {\n    userEmail,\n    isAuthorized,\n  };\n}",[],[673,714,735],{"_103":742,"_95":743,"_155":744,"_157":715,"_158":137,"_159":706,"_161":162,"_105":745,"_100":32,"_164":304,"_166":746,"_167":22,"_168":-5,"_169":747,"_98":748},"a4fcffb4-8f69-11f0-8869-0224a6c84d84","useGlimpseData.ts","a4fd0022-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Custom hook for managing glimpse data fetching and state\n */\n\nimport { useState, useEffect } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { fetchGlimpseData } from \"../services/glimpseService.ts\";\nimport type { UseGlimpseDataReturn } from \"../types/hooks.ts\";\nimport type { GlimpseData } from \"../types/notion.ts\";\n\n/**\n * Hook for managing glimpse data fetching and state\n */\nexport function useGlimpseData(\n  glimpseId: string,\n  initialData?: any\n): UseGlimpseDataReturn {\n  const [data, setData] = useState(initialData || null);\n  const [loading, setLoading] = useState(!initialData?.success);\n  const [error, setError] = useState(\n    initialData?.success === false ? initialData : null\n  );\n\n  const fetchData = async () => {\n    try {\n      setLoading(true);\n      const result = await fetchGlimpseData(glimpseId);\n      \n      if (result.success) {\n        setData(result);\n        setError(null);\n      } else {\n        setError(result);\n        setData(null);\n      }\n    } catch (err: any) {\n      const errorData: GlimpseData = {\n        success: false,\n        error: \"Failed to fetch glimpse data\",\n        details: err.message,\n      };\n      setError(errorData);\n      setData(null);\n    } finally {\n      setLoading(false);\n    }\n  };\n\n  // Fetch data if no initial data or initial data failed\n  useEffect(() => {\n    if (!initialData?.success) {\n      fetchData();\n    }\n  }, [glimpseId]);\n\n  return {\n    data,\n    loading,\n    error,\n    refetch: fetchData,\n  };\n}",[],[673,714,743],{"_103":750,"_95":751,"_155":752,"_157":715,"_158":137,"_159":364,"_161":162,"_105":753,"_100":313,"_164":304,"_166":754,"_167":22,"_168":-5,"_169":755,"_98":756},"536d1eb6-9376-11f0-8f99-0224a6c84d84","useViewingTracking.ts","a4fd0284-8f69-11f0-8869-0224a6c84d84",["D",1758079686339],"/**\n * Custom hook for managing viewing status tracking\n */\n\nimport { useEffect, useRef } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { updateViewingStatus } from \"../services/viewingService.ts\";\n\n/**\n * Hook for tracking user viewing status with automatic updates\n */\nexport function useViewingTracking(\n  glimpseId: string,\n  isAuthorized: boolean\n): void {\n  const intervalRef = useRef(null);\n\n  const updateStatus = async (viewing: boolean, tabVisible: boolean) => {\n    // Only make API calls if user is authorized\n    if (!isAuthorized) {\n      console.log(\"User not authorized for viewing analytics on this page\");\n      return;\n    }\n\n    await updateViewingStatus({\n      pageId: glimpseId,\n      viewing,\n      tabVisible,\n    });\n  };\n\n  // Handle page visibility changes\n  const handleVisibilityChange = () => {\n    // Only update if user is authorized\n    if (!isAuthorized) {\n      return;\n    }\n\n    const isVisible = !document.hidden;\n    updateStatus(true, isVisible);\n  };\n\n  // Set up viewing tracking\n  useEffect(() => {\n    if (!glimpseId) return;\n\n    // Only set up viewing tracking if user is authorized\n    if (!isAuthorized) {\n      console.log(\"Skipping viewing analytics setup - user not authorized\");\n      return;\n    }\n\n    // Initial viewing status update\n    updateStatus(true, !document.hidden);\n\n    // Set up periodic updates every 10 seconds\n    intervalRef.current = setInterval(() => {\n      updateStatus(true, !document.hidden);\n    }, 10000);\n\n    // Listen for visibility changes\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n\n\n    // Cleanup function\n    return () => {\n      if (intervalRef.current) {\n        clearInterval(intervalRef.current);\n        intervalRef.current = null;\n      }\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n\n      // Final update on unmount (only if authorized)\n      if (isAuthorized) {\n        updateStatus(false, false);\n      }\n    };\n  }, [glimpseId, isAuthorized]);\n}",[],[673,714,751],[673,714],{"_103":759,"_95":535,"_155":760,"_157":674,"_158":137,"_159":706,"_161":162,"_105":761,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":762,"_98":802},"a4fd234a-8f69-11f0-8869-0224a6c84d84","01993b2d-17fc-721e-b184-0aed2bcda00b",["D",1757634435067],[763,770,778,786,794],{"_103":764,"_95":291,"_155":765,"_157":760,"_158":137,"_159":706,"_161":162,"_105":766,"_100":32,"_164":176,"_166":767,"_167":22,"_168":-5,"_169":768,"_98":769},"a4fd0afe-8f69-11f0-8869-0224a6c84d84","a4fd0b62-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"# Frontend Services\n\nThis directory contains service functions that handle API calls and external integrations.\n\n## Files\n\n### `glimpseService.ts`\nHandles glimpse data API calls.\n\n**Functions:**\n- `fetchGlimpseData(glimpseId)` - Fetch glimpse data from `/glimpse/{id}` endpoint\n\n### `agentService.ts`\nHandles agent data API calls.\n\n**Functions:**\n- `fetchAgentData(glimpseId)` - Fetch agent data from `/api/agent/{id}` endpoint\n- Returns `null` for missing agents (expected behavior)\n\n### `viewingService.ts`\nHandles viewing status tracking.\n\n**Functions:**\n- `updateViewingStatus(payload)` - Send viewing status updates to `/api/viewing`\n- Silently fails to avoid disrupting user experience\n\n**Note:** Uses `ViewingStatusPayload` type from `/frontend/types/viewing.ts`\n\n### `cobrowseService.ts`\nHandles cobrowse session management.\n\n**Functions:**\n- `startCobrowseSession()` - Initialize cobrowse session using GLANCE library\n- Includes error handling and user feedback\n\n## Usage\n\n```typescript\nimport { fetchGlimpseData } from \"../services/glimpseService.ts\";\nimport { fetchAgentData } from \"../services/agentService.ts\";\nimport { updateViewingStatus } from \"../services/viewingService.ts\";\nimport { startCobrowseSession } from \"../services/cobrowseService.ts\";\n\n// Fetch data\nconst glimpseData = await fetchGlimpseData(glimpseId);\nconst agentData = await fetchAgentData(glimpseId);\n\n// Update status\nawait updateViewingStatus({ pageId: glimpseId, viewing: true, tabVisible: true });\n\n// Start cobrowse\nstartCobrowseSession();\n```\n\n## Benefits\n\n- **Centralized API logic**: All external calls in one place\n- **Consistent error handling**: Standardized error responses\n- **Reusable**: Can be used across components and hooks\n- **Testable**: Easy to mock for unit tests\n- **Type-safe**: Full TypeScript support",[],[673,535,291],{"_103":771,"_95":772,"_155":773,"_157":760,"_158":137,"_159":706,"_161":162,"_105":774,"_100":32,"_164":304,"_166":775,"_167":22,"_168":-5,"_169":776,"_98":777},"a4fd050e-8f69-11f0-8869-0224a6c84d84","agentService.ts","a4fd0586-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Service for handling agent data API calls\n */\n\nimport type { AgentData } from \"../types/agent.ts\";\n\n/**\n * Fetch agent data from the API\n * Returns null if no agent data is found (this is expected behavior)\n */\nexport async function fetchAgentData(glimpseId: string): Promise {\n  try {\n    const response = await fetch(`/api/agent/${glimpseId}`);\n\n    if (!response.ok) {\n      // Log to console for missing agent data (expected behavior)\n      console.log(`no agent for page id: ${glimpseId}`);\n      return null;\n    }\n\n    const result = await response.json();\n    return result;\n  } catch (err) {\n    // Silently fail - don't disrupt user experience\n    console.log(`no agent for page id: ${glimpseId}`);\n    return null;\n  }\n}",[],[673,535,772],{"_103":779,"_95":780,"_155":781,"_157":760,"_158":137,"_159":706,"_161":162,"_105":782,"_100":32,"_164":304,"_166":783,"_167":22,"_168":-5,"_169":784,"_98":785},"a4fd072a-8f69-11f0-8869-0224a6c84d84","cobrowseService.ts","a4fd0798-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Service for handling cobrowse session management\n */\n\n/**\n * Start a cobrowse session using the GLANCE library\n * Handles error cases gracefully with user feedback\n */\nexport function startCobrowseSession(): void {\n  try {\n    // Check if GLANCE library is loaded\n    if (\n      typeof (window as any).GLANCE !== \"undefined\" &&\n      (window as any).GLANCE.Cobrowse\n    ) {\n      (window as any).GLANCE.Cobrowse.Visitor.startSession(\n        \"GLANCE_KEYTYPE_RANDOM\",\n      );\n    } else {\n      console.error(\"GLANCE library not loaded\");\n      alert(\n        \"Cobrowse library not available. Please refresh the page and try again.\",\n      );\n    }\n  } catch (err) {\n    console.error(\"Error starting cobrowse session:\", err);\n    alert(\"Failed to start cobrowse session. Please try again.\");\n  }\n}",[],[673,535,780],{"_103":787,"_95":788,"_155":789,"_157":760,"_158":137,"_159":706,"_161":162,"_105":790,"_100":32,"_164":304,"_166":791,"_167":22,"_168":-5,"_169":792,"_98":793},"a4fd0964-8f69-11f0-8869-0224a6c84d84","glimpseService.ts","a4fd09d2-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Service for handling glimpse data API calls\n */\n\nimport type { GlimpseData } from \"../types/notion.ts\";\n\n/**\n * Fetch glimpse data from the API\n */\nexport async function fetchGlimpseData(glimpseId: string): Promise {\n  try {\n    const response = await fetch(`/glimpse/${glimpseId}`, {\n      headers: {\n        \"Accept\": \"application/json\",\n      },\n    });\n\n    if (!response.ok) {\n      const errorData = await response.json();\n      return {\n        success: false,\n        error: errorData.error || \"Failed to fetch glimpse data\",\n        details: errorData.details,\n      };\n    }\n\n    const result = await response.json();\n    return { success: true, data: result };\n  } catch (err: any) {\n    return {\n      success: false,\n      error: \"Failed to fetch glimpse data\",\n      details: err.message,\n    };\n  }\n}",[],[673,535,788],{"_103":795,"_95":796,"_155":797,"_157":760,"_158":137,"_159":706,"_161":162,"_105":798,"_100":32,"_164":304,"_166":799,"_167":22,"_168":-5,"_169":800,"_98":801},"a4fd0d1a-8f69-11f0-8869-0224a6c84d84","viewingService.ts","a4fd0d88-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Service for handling viewing status tracking API calls\n */\n\nimport type { ViewingStatusPayload } from \"../types/viewing.ts\";\n\n/**\n * Update viewing status on the server\n * Silently fails to avoid disrupting user experience\n */\nexport async function updateViewingStatus(payload: ViewingStatusPayload): Promise {\n  try {\n    await fetch(\"/api/viewing\", {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(payload),\n    });\n  } catch (err) {\n    // Silently fail - don't disrupt user experience\n    console.warn(\"Viewing status update failed:\", err);\n  }\n}",[],[673,535,796],[673,535],{"_103":804,"_95":805,"_155":806,"_157":674,"_158":137,"_159":142,"_161":162,"_105":807,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":808,"_98":817},"3023c2c2-8bfe-11f0-8d61-0224a6c84d84","styles","019924c3-b3ca-765c-900b-51280f7238b6",["D",1757258429391],[809],{"_103":810,"_95":811,"_155":812,"_157":806,"_158":137,"_159":697,"_161":162,"_105":813,"_100":160,"_164":176,"_166":814,"_167":22,"_168":-5,"_169":815,"_98":816},"89c031ea-8f77-11f0-9181-0224a6c84d84","notion-content.css","3023b8b8-8bfe-11f0-8d61-0224a6c84d84",["D",1757640402327],"/* Notion content styling using pure CSS that mimics @tailwindcss/typography */\n.notion-content {\n  color: #374151;\n  max-width: none;\n}\n.notion-content h1 {\n  color: #111827;\n  font-weight: 800;\n  font-size: 2.25rem;\n  margin-top: 0;\n  margin-bottom: 0.8888889em;\n  line-height: 1.1111111;\n}\n.notion-content h2 {\n  color: #111827;\n  font-weight: 700;\n  font-size: 1.5rem;\n  margin-top: 2em;\n  margin-bottom: 1em;\n  line-height: 1.3333333;\n}\n.notion-content h3 {\n  color: #111827;\n  font-weight: 600;\n  font-size: 1.25rem;\n  margin-top: 1.6em;\n  margin-bottom: 0.6em;\n  line-height: 1.6;\n}\n.notion-content p {\n  margin-top: 1.25em;\n  margin-bottom: 1.25em;\n}\n.notion-content ul, .notion-content ol {\n  margin-top: 1.25em;\n  margin-bottom: 1.25em;\n  padding-left: 1.625em;\n}\n.notion-content ul {\n  list-style-type: disc;\n}\n.notion-content ol {\n  list-style-type: decimal;\n}\n.notion-content li {\n  margin-top: 0.5em;\n  margin-bottom: 0.5em;\n}\n.notion-content blockquote {\n  font-weight: 500;\n  font-style: italic;\n  color: #111827;\n  border-left-width: 0.25rem;\n  border-left-color: #e5e7eb;\n  quotes: \"\\201C\"\"\\201D\"\"\\2018\"\"\\2019\";\n  margin-top: 1.6em;\n  margin-bottom: 1.6em;\n  padding-left: 1em;\n}\n.notion-content code {\n  color: #111827;\n  font-weight: 600;\n  font-size: 0.875em;\n  background-color: #f3f4f6;\n  padding: 0.125rem 0.25rem;\n  border-radius: 0.25rem;\n}\n.notion-content pre {\n  color: #e5e7eb;\n  background-color: #1f2937;\n  overflow-x: auto;\n  font-weight: 400;\n  font-size: 0.875em;\n  line-height: 1.7142857;\n  margin-top: 1.7142857em;\n  margin-bottom: 1.7142857em;\n  border-radius: 0.375rem;\n  padding: 0.8571429em 1.1428571em;\n  position: relative;\n}\n\n/* Prism.js overrides for better integration */\n.notion-content pre[class*=\"language-\"] {\n  background-color: #2d3748;\n  border-radius: 0.5rem;\n  margin: 1.5em 0;\n  padding: 1rem;\n  overflow: auto;\n  font-size: 0.875rem;\n  line-height: 1.6;\n}\n\n.notion-content pre[class*=\"language-\"].line-numbers {\n  padding-left: 3.8em;\n}\n\n.notion-content code[class*=\"language-\"] {\n  background: transparent;\n  color: inherit;\n  font-size: inherit;\n  line-height: inherit;\n  padding: 0;\n  border-radius: 0;\n  font-weight: inherit;\n}\n\n/* Language badge styling */\n.notion-content pre .language-badge {\n  position: absolute;\n  top: 0.5rem;\n  right: 0.5rem;\n  background: rgba(0, 0, 0, 0.7);\n  color: #e2e8f0;\n  font-size: 0.75rem;\n  padding: 0.25rem 0.5rem;\n  border-radius: 0.25rem;\n  font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Consolas, \"Liberation Mono\", Menlo, monospace;\n}\n.notion-content pre code {\n  background-color: transparent;\n  border-width: 0;\n  border-radius: 0;\n  padding: 0;\n  font-weight: inherit;\n  color: inherit;\n  font-size: inherit;\n  font-family: inherit;\n  line-height: inherit;\n}\n.notion-content a {\n  color: #3b82f6;\n  text-decoration: underline;\n  font-weight: 500;\n}\n.notion-content a:hover {\n  color: #1d4ed8;\n}\n.notion-content hr {\n  border-color: #e5e7eb;\n  border-top-width: 1px;\n  margin-top: 3em;\n  margin-bottom: 3em;\n}\n.notion-content table {\n  width: 100%;\n  table-layout: auto;\n  text-align: left;\n  margin-top: 2em;\n  margin-bottom: 2em;\n  font-size: 0.875em;\n  line-height: 1.7142857;\n}\n.notion-content thead {\n  border-bottom-width: 1px;\n  border-bottom-color: #d1d5db;\n}\n.notion-content thead th {\n  color: #111827;\n  font-weight: 600;\n  vertical-align: bottom;\n  padding-right: 0.5714286em;\n  padding-bottom: 0.5714286em;\n  padding-left: 0.5714286em;\n}\n.notion-content tbody tr {\n  border-bottom-width: 1px;\n  border-bottom-color: #e5e7eb;\n}\n.notion-content tbody td {\n  vertical-align: baseline;\n  padding: 0.5714286em;\n}",[],[673,805,811],[673,805],{"_103":819,"_95":597,"_155":820,"_157":674,"_158":137,"_159":706,"_161":162,"_105":821,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":822,"_98":862},"a4fd2458-8f69-11f0-8869-0224a6c84d84","01993b2d-17fc-721e-b184-0d3536434a14",["D",1757634435067],[823,830,838,846,854],{"_103":824,"_95":291,"_155":825,"_157":820,"_158":137,"_159":706,"_161":162,"_105":826,"_100":32,"_164":176,"_166":827,"_167":22,"_168":-5,"_169":828,"_98":829},"a4fd131e-8f69-11f0-8869-0224a6c84d84","a4fd138c-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"# Frontend Types\n\nThis directory contains TypeScript type definitions and interfaces used throughout the frontend application.\n\n## Files\n\n### `notion.ts`\nType definitions for Notion data structures.\n\n**Types:**\n- `NotionProperty` - Interface for individual Notion property (email, rich_text, title)\n- `NotionProperties` - Collection of Notion properties indexed by key\n- `NotionPageData` - Complete Notion page data structure\n- `GlimpseData` - API response structure for glimpse data\n\n### `agent.ts`\nType definitions for agent data structures.\n\n**Types:**\n- `Agent` - Individual agent information (name, email, meetUrl, phone)\n- `AgentData` - Collection of agents\n- `AgentResponse` - API response structure for agent data\n\n### `viewing.ts`\nType definitions for viewing status tracking.\n\n**Types:**\n- `ViewingStatusPayload` - Structure for viewing status updates (pageId, viewing, tabVisible)\n\n### `hooks.ts`\nType definitions for custom hook return types.\n\n**Types:**\n- `UseAuthReturn` - Return type for useAuth hook\n- `UseGlimpseDataReturn` - Return type for useGlimpseData hook  \n- `UseAgentDataReturn` - Return type for useAgentData hook\n\n## Usage\n\n```typescript\nimport type { NotionProperties, GlimpseData } from \"../types/notion.ts\";\nimport type { Agent, AgentData } from \"../types/agent.ts\";\n\nfunction processGlimpseData(data: GlimpseData): string {\n  const properties: NotionProperties = data.data?.properties || {};\n  // ... processing logic\n}\n```\n\n## Benefits\n\n- **Centralized types**: All type definitions in one place\n- **Reusability**: Types can be imported across components, utils, and services\n- **Consistency**: Ensures consistent data structures throughout the app\n- **IDE support**: Better autocomplete and error checking",[],[673,597,291],{"_103":831,"_95":832,"_155":833,"_157":820,"_158":137,"_159":706,"_161":162,"_105":834,"_100":32,"_164":304,"_166":835,"_167":22,"_168":-5,"_169":836,"_98":837},"a4fd0e82-8f69-11f0-8869-0224a6c84d84","agent.ts","a4fd0efa-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * TypeScript type definitions for agent data structures\n */\n\nexport interface Agent {\n  agentName?: string;\n  agentEmail?: string;\n  agentMeetUrl?: string;\n  agentPhone?: string;\n}\n\nexport interface AgentData {\n  agents: Agent[];\n}\n\nexport interface AgentResponse {\n  success?: boolean;\n  agents?: Agent[];\n}",[],[673,597,832],{"_103":839,"_95":840,"_155":841,"_157":820,"_158":137,"_159":706,"_161":162,"_105":842,"_100":32,"_164":304,"_166":843,"_167":22,"_168":-5,"_169":844,"_98":845},"a4fd0fea-8f69-11f0-8869-0224a6c84d84","hooks.ts","a4fd1058-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * TypeScript type definitions for custom hook return types\n */\n\nimport type { NotionProperties, GlimpseData } from \"./notion.ts\";\nimport type { AgentData } from \"./agent.ts\";\n\nexport interface UseAuthReturn {\n  userEmail: string | null;\n  isAuthorized: (pageProperties: NotionProperties | null | undefined) => boolean;\n}\n\nexport interface UseGlimpseDataReturn {\n  data: GlimpseData | null;\n  loading: boolean;\n  error: GlimpseData | null;\n  refetch: () => Promise;\n}\n\nexport interface UseAgentDataReturn {\n  agentData: AgentData | null;\n  hasAgents: boolean;\n}",[],[673,597,840],{"_103":847,"_95":848,"_155":849,"_157":820,"_158":137,"_159":706,"_161":162,"_105":850,"_100":32,"_164":304,"_166":851,"_167":22,"_168":-5,"_169":852,"_98":853},"a4fd11ac-8f69-11f0-8869-0224a6c84d84","notion.ts","a4fd1224-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * TypeScript type definitions for Notion data structures\n */\n\nexport interface NotionProperty {\n  email?: string;\n  rich_text?: Array<{ plain_text: string }>;\n  title?: Array<{ plain_text: string }>;\n}\n\nexport interface NotionProperties {\n  [key: string]: NotionProperty;\n}\n\nexport interface NotionPageData {\n  properties: NotionProperties;\n  blocks?: any[];\n}\n\nexport interface GlimpseData {\n  success: boolean;\n  data?: NotionPageData;\n  error?: string;\n  details?: string;\n}",[],[673,597,848],{"_103":855,"_95":856,"_155":857,"_157":820,"_158":137,"_159":348,"_161":162,"_105":858,"_100":160,"_164":304,"_166":859,"_167":22,"_168":-5,"_169":860,"_98":861},"243d0dec-930b-11f0-8c3a-0224a6c84d84","viewing.ts","a4fd158a-8f69-11f0-8869-0224a6c84d84",["D",1758033651020],"/**\n * TypeScript type definitions for viewing status tracking\n */\n\nexport interface ViewingStatusPayload {\n  pageId: string;\n  viewing: boolean;\n  tabVisible: boolean;\n}\n\nexport interface ViewingStatusData {\n  pageId: string;\n  viewing: boolean; // Derived from sessionStart for compatibility\n  tabVisible: boolean;\n  lastUpdate: string | null;\n  userEmail: string | null;\n  sessionId: string | null;\n  dateCreated: string | null;\n  sessionStart: string | null; // New unified property\n  stale?: boolean;\n}\n\nexport interface ViewingStats {\n  currentlyViewing: boolean;\n  lastViewed: string | null;\n  currentUser: string | null;\n  tabVisible: boolean;\n  sessionId: string | null;\n  dateCreated: string | null;\n  sessionStart: string | null; // New unified property\n}",[],[673,597,856],[673,597],{"_103":864,"_95":611,"_155":865,"_157":674,"_158":137,"_159":706,"_161":162,"_105":866,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":867,"_98":899},"a4fd2548-8f69-11f0-8869-0224a6c84d84","01993b2d-17fc-721e-b184-108cf0b86091",["D",1757634435067],[868,875,883,891],{"_103":869,"_95":291,"_155":870,"_157":865,"_158":137,"_159":706,"_161":162,"_105":871,"_100":32,"_164":176,"_166":872,"_167":22,"_168":-5,"_169":873,"_98":874},"a4fd1b5c-8f69-11f0-8869-0224a6c84d84","a4fd1bca-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"# Frontend Utils\n\nThis directory contains pure utility functions that handle data transformation and validation logic.\n\n## Files\n\n### `dataExtraction.ts`\nUtility functions for extracting and parsing data from Notion properties.\n\n**Functions:**\n- `extractUserEmail(properties)` - Extract email from Notion properties (handles both email-type and rich_text-type)\n- `extractUserName(properties)` - Extract name/title from Notion properties\n- `formatPageTitle(properties)` - Format page title as \"Name for Email\" with graceful fallbacks\n\n**Note:** Uses types from `/frontend/types/notion.ts`\n\n### `validation.ts`\nUtility functions for validation and authorization logic.\n\n**Functions:**\n- `checkAuthorization(userEmail, pageProperties)` - Check if user is authorized based on email matching\n- `getUserEmailFromWindow()` - Get user email from injected window data\n\n### `notionFormatting.ts`\nUtility functions for formatting Notion property values.\n\n**Functions:**\n- `formatNotionDate(dateString)` - Format date string to localized format\n- `extractPlainText(textArray)` - Extract plain text from rich text/title arrays\n- `formatMultiSelect(items)` - Format multi-select items as comma-separated string\n- `formatBoolean(value, trueText?, falseText?)` - Format boolean with emoji indicators\n\n## Usage\n\n```typescript\nimport { extractUserEmail, formatPageTitle } from \"../utils/dataExtraction.ts\";\nimport { checkAuthorization, getUserEmailFromWindow } from \"../utils/validation.ts\";\n\n// Extract data\nconst email = extractUserEmail(properties);\nconst title = formatPageTitle(properties);\n\n// Check authorization\nconst userEmail = getUserEmailFromWindow();\nconst isAuthorized = checkAuthorization(userEmail, properties);\n```\n\n## Benefits\n\n- **Pure functions**: No side effects, easy to test\n- **Reusable**: Can be used across multiple components\n- **Type-safe**: Full TypeScript support with proper interfaces\n- **Consistent**: Centralized logic for data extraction and validation",[],[673,611,291],{"_103":876,"_95":877,"_155":878,"_157":865,"_158":137,"_159":706,"_161":162,"_105":879,"_100":32,"_164":304,"_166":880,"_167":22,"_168":-5,"_169":881,"_98":882},"a4fd1684-8f69-11f0-8869-0224a6c84d84","dataExtraction.ts","a4fd171a-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Utility functions for extracting and parsing data from Notion properties\n */\n\nimport type { NotionProperties } from \"../types/notion.ts\";\n\n/**\n * Extract email from Notion properties\n * Handles both email-type and rich_text-type properties\n */\nexport function extractUserEmail(properties: NotionProperties | null | undefined): string {\n  if (!properties || typeof properties !== \"object\") {\n    return \"\";\n  }\n\n  const emailProps = [\"Email\", \"email\"];\n  \n  for (const prop of emailProps) {\n    if (properties[prop]) {\n      // Handle email-type property\n      if (properties[prop].email) {\n        return properties[prop].email!.trim();\n      }\n      // Handle rich_text-type property\n      if (properties[prop].rich_text?.[0]?.plain_text) {\n        return properties[prop].rich_text[0].plain_text.trim();\n      }\n    }\n  }\n\n  return \"\";\n}\n\n/**\n * Extract name from Notion properties\n * Looks for Name, Title, name, or title properties\n */\nexport function extractUserName(properties: NotionProperties | null | undefined): string {\n  if (!properties || typeof properties !== \"object\") {\n    return \"\";\n  }\n\n  const nameProps = [\"Name\", \"Title\", \"name\", \"title\"];\n  \n  for (const prop of nameProps) {\n    if (properties[prop]?.title?.[0]?.plain_text) {\n      return properties[prop].title![0].plain_text.trim();\n    }\n  }\n\n  return \"\";\n}\n\n/**\n * Format page title in the format \"Name for Email\"\n * Falls back gracefully if either piece is missing\n */\nexport function formatPageTitle(properties: NotionProperties | null | undefined): string {\n  const name = extractUserName(properties);\n  const email = extractUserEmail(properties);\n\n  if (name && email) {\n    return `${name} for ${email}`;\n  } else if (name) {\n    return name;\n  } else if (email) {\n    return email;\n  } else {\n    return \"Untitled Page\";\n  }\n}",[],[673,611,877],{"_103":884,"_95":885,"_155":886,"_157":865,"_158":137,"_159":706,"_161":162,"_105":887,"_100":32,"_164":304,"_166":888,"_167":22,"_168":-5,"_169":889,"_98":890},"a4fd19ae-8f69-11f0-8869-0224a6c84d84","notionFormatting.ts","a4fd1a26-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Utility functions for formatting Notion property values\n */\n\n/**\n * Format a date string to localized date format\n */\nexport function formatNotionDate(dateString: string): string {\n  try {\n    const date = new Date(dateString);\n    return date.toLocaleDateString();\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Extract plain text from Notion rich text or title arrays\n */\nexport function extractPlainText(textArray: Array<{ plain_text: string }> | undefined): string {\n  return textArray?.map((text) => text.plain_text).join('') || '';\n}\n\n/**\n * Format multi-select items as comma-separated string\n */\nexport function formatMultiSelect(items: Array<{ name: string }> | undefined): string {\n  return items?.map((item) => item.name).join(', ') || '';\n}\n\n/**\n * Format boolean value with emoji indicators\n */\nexport function formatBoolean(value: boolean, trueText = 'Yes', falseText = 'No'): string {\n  return value ? `✅ ${trueText}` : `❌ ${falseText}`;\n}",[],[673,611,885],{"_103":892,"_95":893,"_155":894,"_157":865,"_158":137,"_159":706,"_161":162,"_105":895,"_100":32,"_164":304,"_166":896,"_167":22,"_168":-5,"_169":897,"_98":898},"a4fd1fa8-8f69-11f0-8869-0224a6c84d84","validation.ts","a4fd2020-8f69-11f0-8869-0224a6c84d84",["D",1757634435067],"/**\n * Utility functions for validation and authorization logic\n */\n\nimport { extractUserEmail } from \"./dataExtraction.ts\";\nimport type { NotionProperties } from \"../types/notion.ts\";\n\n/**\n * Check if user is authorized to view a page based on email matching\n * Normalizes emails for comparison (lowercase, trimmed)\n */\nexport function checkAuthorization(\n  userEmail: string | null | undefined,\n  pageProperties: NotionProperties | null | undefined\n): boolean {\n  if (!userEmail || !pageProperties) {\n    return false;\n  }\n\n  const pageEmail = extractUserEmail(pageProperties);\n  \n  if (!pageEmail) {\n    return false;\n  }\n\n  // Normalize emails for comparison\n  const normalizedUserEmail = userEmail.toLowerCase().trim();\n  const normalizedPageEmail = pageEmail.toLowerCase().trim();\n\n  return normalizedUserEmail === normalizedPageEmail;\n}\n\n/**\n * Get user email from injected window data\n * Returns null if not available\n */\nexport function getUserEmailFromWindow(): string | null {\n  return (window as any).__USER_EMAIL__ || null;\n}",[],[673,611,893],[673,611],{"_103":901,"_95":291,"_155":902,"_157":674,"_158":137,"_159":706,"_161":162,"_105":903,"_100":313,"_164":176,"_166":904,"_167":22,"_168":-5,"_169":905,"_98":906},"a4fd2638-8f69-11f0-8869-0224a6c84d84","01991bd6-e87d-71bd-b757-a986df46b362",["D",1757634435067],"# Frontend Architecture\n\nThis directory contains the frontend application with a clean, scalable architecture following React best practices and separation of concerns.\n\n## Directory Structure\n\n```\nfrontend/\n├── components/          # React components (UI rendering only)\n│   ├── GlimpseView.tsx  # Main glimpse viewing component\n│   ├── NotionBlock.tsx  # Notion block rendering with semantic HTML\n│   └── NotionProperty.tsx # Notion property rendering with type-specific formatting\n├── hooks/               # Custom React hooks (stateful logic)\n│   ├── useAuth.ts       # Authentication and authorization\n│   ├── useGlimpseData.ts # Glimpse data fetching and state\n│   ├── useAgentData.ts  # Agent data with polling\n│   └── useViewingTracking.ts # Viewing status tracking\n├── services/            # API calls and external integrations\n│   ├── glimpseService.ts # Glimpse data API\n│   ├── agentService.ts  # Agent data API\n│   ├── viewingService.ts # Viewing status API\n│   └── cobrowseService.ts # Cobrowse session management\n├── utils/               # Pure utility functions\n│   ├── dataExtraction.ts # Notion data parsing\n│   ├── validation.ts    # Authorization logic\n│   └── notionFormatting.ts # Property value formatting\n├── types/               # TypeScript type definitions\n│   ├── notion.ts        # Notion data structures\n│   ├── agent.ts         # Agent data structures\n│   ├── viewing.ts       # Viewing status structures\n│   └── hooks.ts         # Hook return types\n├── styles/              # CSS files\n│   └── notion-content.css # Notion-specific styling\n├── pages/               # Page entry points\n│   └── glimpse.tsx      # Glimpse page React entry point\n└── *.html               # HTML templates with semantic structure\n```\n\n## Architecture Principles\n\n### **Separation of Concerns**\n- **Components**: Pure UI rendering, minimal logic, focus on JSX\n- **Hooks**: Stateful logic, side effects, data management\n- **Services**: External API interactions, error handling\n- **Utils**: Pure functions, data transformations, no side effects\n- **Types**: TypeScript definitions, shared across all layers\n\n### **Data Flow**\n```\nHTML Template → React Entry Point → Components → Hooks → Services → Utils\n                     ↓                ↓         ↓         ↓         ↓\n                 DOM Mount      UI Rendering  State    API Calls  Pure Logic\n```\n\n### **Dependency Direction**\n- Components depend on hooks, utils, types\n- Hooks depend on services, utils, types\n- Services depend on utils, types\n- Utils depend only on types\n- Types have no dependencies\n- **No circular dependencies**\n\n## How the Frontend Works\n\n### **1. Page Loading Process**\n\n#### **Initial Request**\n1. **User visits** `/glimpse/{id}` URL\n2. **Server authentication** checks user access\n3. **HTML template** served with semantic structure (header/main/footer)\n4. **Initial data injection** - glimpse data embedded in `window.__GLIMPSE_DATA__`\n5. **React entry point** (`glimpse.tsx`) mounts to `#root`\n\n#### **React Initialization**\n1. **`glimpse.tsx`** extracts initial data from window\n2. **`GlimpseView`** component renders with initial data\n3. **Custom hooks** initialize with data and start side effects\n4. **Component renders** UI based on hook states\n\n### **2. Component Architecture**\n\n#### **GlimpseView (Main Component)**\n- **Orchestrates** all data and UI logic\n- **Uses custom hooks** for all stateful operations\n- **Renders header content** via React portals to HTML header\n- **Conditionally shows** agent connection UI and page content\n- **Handles loading/error states** with user-friendly UI\n\n#### **NotionBlock & NotionProperty (Rendering Components)**\n- **Pure rendering components** for Notion content\n- **Semantic HTML output** with proper accessibility\n- **Smart list grouping** - consecutive list items become proper `/`\n- **Type-specific formatting** using utility functions\n- **Recursive rendering** for nested block structures\n\n### **3. Custom Hooks System**\n\n#### **useAuth**\n- **Extracts user email** from window data (injected by server)\n- **Provides authorization function** for page access control\n- **Memoized for performance** - doesn't re-run unnecessarily\n\n#### **useGlimpseData**\n- **Manages glimpse data state** (loading, error, success)\n- **Handles initial data** or fetches from API if needed\n- **Provides refetch function** for error recovery\n- **Centralized error handling** with consistent error structures\n\n#### **useAgentData**\n- **Polls agent data** every 5 seconds when authorized\n- **Manages agent state** and hasAgents boolean\n- **Automatic cleanup** of intervals on unmount\n- **Conditional polling** - only runs if user is authorized\n\n#### **useViewingTracking**\n- **Tracks viewing status** with periodic updates (10 seconds)\n- **Monitors page visibility** changes (tab switching)\n- **Sends viewing analytics** to server\n- **Proper cleanup** on component unmount\n\n### **4. Service Layer**\n\n#### **API Communication**\n- **Centralized API calls** with consistent error handling\n- **Type-safe responses** using TypeScript interfaces\n- **Silent failures** where appropriate (viewing tracking)\n- **User feedback** for critical errors (glimpse loading)\n\n#### **Service Functions**\n- **`fetchGlimpseData`** - Gets page content from Notion\n- **`fetchAgentData`** - Gets agent information for support\n- **`updateViewingStatus`** - Sends analytics data\n- **`startCobrowseSession`** - Initializes screen sharing\n\n### **5. Utility Functions**\n\n#### **Data Extraction** (`dataExtraction.ts`)\n- **`extractUserEmail`** - Parses email from Notion properties\n- **`extractUserName`** - Parses name/title from properties\n- **`formatPageTitle`** - Creates \"Name for Email\" format\n\n#### **Validation** (`validation.ts`)\n- **`checkAuthorization`** - Email-based access control\n- **`getUserEmailFromWindow`** - Extracts injected user data\n\n#### **Notion Formatting** (`notionFormatting.ts`)\n- **`formatNotionDate`** - Consistent date formatting\n- **`extractPlainText`** - Text from rich text arrays\n- **`formatMultiSelect`** - Comma-separated values\n- **`formatBoolean`** - Emoji-enhanced boolean display\n\n### **6. Type System**\n\n#### **Comprehensive TypeScript Coverage**\n- **Notion types** - Page data, properties, blocks\n- **Agent types** - Agent information and collections\n- **Hook types** - Return types for custom hooks\n- **Viewing types** - Analytics payload structures\n\n#### **Type Safety Benefits**\n- **Compile-time error checking**\n- **IDE autocomplete and IntelliSense**\n- **Self-documenting code**\n- **Refactoring safety**\n\n## Key Features\n\n### **Glimpse Viewing Experience**\n- **Rich Notion content** with semantic HTML rendering\n- **Real-time agent integration** with cobrowse functionality\n- **Automatic viewing analytics** for usage tracking\n- **Email-based access control** for security\n- **Responsive design** with mobile-friendly layout\n\n### **Technical Features**\n- **Server-side data injection** - eliminates loading states\n- **React portals** - dynamic header content population\n- **Automatic polling** - real-time agent data updates\n- **Smart error handling** - graceful degradation\n- **Semantic HTML structure** - accessibility and SEO friendly\n\n### **Performance Optimizations**\n- **Initial data injection** - faster first render\n- **Memoized hooks** - prevents unnecessary re-renders\n- **Conditional polling** - only when authorized\n- **Proper cleanup** - prevents memory leaks\n\n## Usage Examples\n\n### **Component with Hooks**\n```typescript\nexport function MyComponent({ glimpseId }: Props) {\n  const { userEmail, isAuthorized } = useAuth();\n  const { data, loading, error } = useGlimpseData(glimpseId);\n  const { agentData, hasAgents } = useAgentData(glimpseId, isAuthorized(data?.properties));\n  \n  if (loading) return ;\n  if (error) return ;\n  \n  return {/* Pure rendering logic */}
;\n}\n```\n\n### **Service Usage**\n```typescript\nimport { fetchGlimpseData } from \"../services/glimpseService.ts\";\n\nconst data = await fetchGlimpseData(glimpseId);\nif (data.success) {\n  // Handle success\n} else {\n  // Handle error with data.error and data.details\n}\n```\n\n### **Utility Usage**\n```typescript\nimport { extractUserEmail, formatPageTitle } from \"../utils/dataExtraction.ts\";\nimport { formatNotionDate, formatBoolean } from \"../utils/notionFormatting.ts\";\n\nconst email = extractUserEmail(properties);\nconst title = formatPageTitle(properties);\nconst date = formatNotionDate(dateString);\nconst status = formatBoolean(isActive);\n```\n\n## Development Guidelines\n\n### **Component Development**\n1. **Keep components pure** - focus on rendering, minimal logic\n2. **Use custom hooks** - extract all stateful logic\n3. **Leverage utilities** - don't duplicate formatting logic\n4. **Type everything** - use proper TypeScript interfaces\n5. **Handle loading/error states** - provide good UX\n\n### **Hook Development**\n1. **Single responsibility** - each hook has one clear purpose\n2. **Proper cleanup** - clear intervals, remove listeners\n3. **Memoization** - use useMemo/useCallback for performance\n4. **Error handling** - consistent error structures\n5. **Type return values** - use interfaces from types/\n\n### **Service Development**\n1. **Centralize API calls** - don't use fetch directly in components\n2. **Consistent error handling** - return structured error objects\n3. **Type safety** - use proper request/response types\n4. **Silent failures** - where appropriate for UX\n5. **User feedback** - for critical operations\n\n### **Utility Development**\n1. **Pure functions only** - no side effects\n2. **Single responsibility** - each function does one thing\n3. **Error handling** - graceful degradation\n4. **Type safety** - proper input/output types\n5. **Testability** - easy to unit test\n\n## Scaling and Extension\n\n### **Adding New Pages**\n1. **Create HTML template** with same header/footer structure\n2. **Create React entry point** following glimpse.tsx pattern\n3. **Reuse existing hooks** for common functionality\n4. **Add page-specific components** as needed\n\n### **Adding New Features**\n1. **Types first** - define data structures in types/\n2. **Services** - add API integration functions\n3. **Hooks** - create stateful logic hooks\n4. **Components** - build UI components\n5. **Utils** - extract reusable logic\n\n### **Testing Strategy**\n1. **Utils** - Unit test pure functions\n2. **Services** - Mock API responses\n3. **Hooks** - Test with React Testing Library\n4. **Components** - Test rendering with mocked dependencies\n\nThis architecture provides a solid foundation for building scalable, maintainable React applications with clear separation of concerns and excellent developer experience.",[],[673,291],{"_103":908,"_95":909,"_155":910,"_157":674,"_158":137,"_159":697,"_161":162,"_105":911,"_100":350,"_164":176,"_166":912,"_167":22,"_168":-5,"_169":913,"_98":914},"89c02f24-8f77-11f0-9181-0224a6c84d84","glimpse.html","3a44daca-8b45-11f0-b0c3-0224a6c84d84",["D",1757640402327],"\n\n  \n    \n    \n    Glimpse View\n    \n    \n    \n    \n    \n    \n    \n  \n  \n    \n      \n        \n          \n            Glimpse, a cobrowsing demo from Glance\n          
\n          \n            \n          
\n        
\n      
\n    
\n\n    \n      \n        \n          \n          
\n          Loading glimpse...\n        
\n      \n    
\n\n    \n      \n        © 2025 Glance Networks\n      
\n    
\n    \n    \n    \n    \n    \n    \n    \n    \n    \n  \n",[],[673,909],{"_103":916,"_95":917,"_155":918,"_157":674,"_158":137,"_159":313,"_161":162,"_105":919,"_100":32,"_164":304,"_166":920,"_167":22,"_168":-5,"_169":921,"_98":922},"3a44ddcc-8b45-11f0-b0c3-0224a6c84d84","glimpse.tsx","3a44de44-8b45-11f0-b0c3-0224a6c84d84",["D",1757178989487],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client?deps=react@18.2.0,react-dom@18.2.0\";\nimport { GlimpseView } from \"./components/GlimpseView.tsx\";\n\n// Get initial data from window (injected by server)\nconst initialData = (window as any).__GLIMPSE_DATA__;\nconst glimpseId = (window as any).__GLIMPSE_ID__;\n\nconst root = createRoot(document.getElementById(\"root\")!);\nroot.render();",[],[673,917],[673],{"_103":925,"_95":926,"_155":927,"_157":-5,"_158":137,"_159":160,"_161":162,"_105":928,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":929,"_98":953},"8e5fd168-8aa1-11f0-95bf-0224a6c84d84","shared","01991bd6-e87d-71bd-b757-b41043e1bdc6",["D",1757108693058],[930,937,945],{"_103":931,"_95":291,"_155":932,"_157":927,"_158":137,"_159":313,"_161":162,"_105":933,"_100":160,"_164":176,"_166":934,"_167":22,"_168":-5,"_169":935,"_98":936},"3a44fb2c-8b45-11f0-b0c3-0224a6c84d84","01991bd6-e87d-71bd-b757-b25e416c56d2",["D",1757178989487],"# 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.\n\n## Files\n\n- `types.ts` - TypeScript interfaces for Notion data structures\n- `utils.ts` - Utility functions for data formatting and manipulation\n\n## Types\n\n### NotionRichText\nInterface for Notion rich text objects with formatting annotations.\n\n### NotionProperty\nBase interface for Notion page properties.\n\n### NotionBlock\nInterface for Notion block objects with recursive children support.\n\n### NotionPage\nComplete interface for Notion page objects including properties and blocks.\n\n### GlimpseData\nResponse format for glimpse API endpoints.\n\n### ApiResponse\nGeneric response format for all API endpoints.\n\n## Utilities\n\n### Text Processing\n- `extractPlainText()` - Extract plain text from rich text arrays\n- `getPageTitle()` - Get page title from properties\n- `truncateText()` - Truncate text with ellipsis\n- `capitalize()` - Capitalize first letter\n\n### Formatting\n- `formatDate()` - Format date strings for display\n- `getPropertyTypeLabel()` - Convert property types to readable labels\n\n### Validation\n- `isValidUrl()` - Validate URL strings\n\nThese utilities are designed to work in both browser and server environments.",[],[926,291],{"_103":938,"_95":939,"_155":940,"_157":927,"_158":137,"_159":136,"_161":162,"_105":941,"_100":313,"_164":304,"_166":942,"_167":22,"_168":-5,"_169":943,"_98":944},"59a2d934-94b0-11f0-a75b-0224a6c84d84","types.ts","3a44dfca-8b45-11f0-b0c3-0224a6c84d84",["D",1758214558721],"// Shared types for Notion data structures\n// Note: Cannot use Deno-specific APIs in shared code\n\nexport interface NotionRichText {\n  type: 'text';\n  text: {\n    content: string;\n    link?: {\n      url: string;\n    };\n  };\n  annotations: {\n    bold: boolean;\n    italic: boolean;\n    strikethrough: boolean;\n    underline: boolean;\n    code: boolean;\n    color: string;\n  };\n  plain_text: string;\n  href?: string;\n}\n\nexport interface NotionProperty {\n  id: string;\n  type: string;\n  [key: string]: any; // Allow for type-specific properties\n}\n\nexport interface NotionBlock {\n  object: 'block';\n  id: string;\n  type: string;\n  created_time: string;\n  last_edited_time: string;\n  has_children: boolean;\n  archived: boolean;\n  children?: NotionBlock[];\n  [key: string]: any; // Allow for type-specific content\n}\n\nexport interface NotionPage {\n  object: 'page';\n  id: string;\n  created_time: string;\n  last_edited_time: string;\n  archived: boolean;\n  properties: Record;\n  parent: {\n    type: string;\n    database_id?: string;\n    page_id?: string;\n  };\n  url: string;\n  blocks?: NotionBlock[];\n}\n\nexport interface GlimpseData {\n  success: boolean;\n  data?: NotionPage;\n  error?: string;\n  details?: string;\n}\n\nexport interface ApiResponse {\n  success: boolean;\n  data: T | null;\n  error: string | null;\n  details?: string;\n  timestamp?: string;\n}\n\nexport interface ViewingStatus {\n  pageId: string;\n  viewing: boolean;\n  tabVisible: boolean;\n  lastUpdate: string;\n  userEmail?: string;\n  sessionId?: string;\n  stale?: boolean;\n}\n\nexport interface ViewingStats {\n  currentlyViewing: boolean;\n  lastViewed: string | null;\n  currentUser: string | null;\n  tabVisible: boolean;\n  sessionId: string | null;\n}\n\n// Email-specific agent information for email services\nexport interface EmailAgentInfo {\n  name: string;\n  email: string;\n}",[],[926,939],{"_103":946,"_95":947,"_155":948,"_157":927,"_158":137,"_159":313,"_161":162,"_105":949,"_100":32,"_164":304,"_166":950,"_167":22,"_168":-5,"_169":951,"_98":952},"3a44e0d8-8b45-11f0-b0c3-0224a6c84d84","utils.ts","3a44e146-8b45-11f0-b0c3-0224a6c84d84",["D",1757178989487],"// Shared utility functions\n// Note: Cannot use Deno-specific APIs in shared code\n\n/**\n * Formats a date string into a human-readable format\n */\nexport function formatDate(dateString: string): string {\n  try {\n    const date = new Date(dateString);\n    return date.toLocaleDateString('en-US', {\n      year: 'numeric',\n      month: 'long',\n      day: 'numeric',\n      hour: '2-digit',\n      minute: '2-digit'\n    });\n  } catch {\n    return dateString;\n  }\n}\n\n/**\n * Extracts plain text from Notion rich text array\n */\nexport function extractPlainText(richText: any[]): string {\n  if (!richText || !Array.isArray(richText)) {\n    return '';\n  }\n  return richText.map(text => text.plain_text || '').join('');\n}\n\n/**\n * Gets the title of a Notion page from its properties\n */\nexport function getPageTitle(properties: Record): string {\n  const titleProps = ['Name', 'Title', 'title', 'name'];\n  \n  for (const prop of titleProps) {\n    if (properties[prop]?.title?.[0]?.plain_text) {\n      return properties[prop].title[0].plain_text;\n    }\n  }\n  \n  return 'Untitled Page';\n}\n\n/**\n * Checks if a string is a valid URL\n */\nexport function isValidUrl(string: string): boolean {\n  try {\n    new URL(string);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Truncates text to a specified length with ellipsis\n */\nexport function truncateText(text: string, maxLength: number): string {\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return text.substring(0, maxLength - 3) + '...';\n}\n\n/**\n * Capitalizes the first letter of a string\n */\nexport function capitalize(str: string): string {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Converts a property type to a human-readable label\n */\nexport function getPropertyTypeLabel(type: string): string {\n  const labels: Record = {\n    'title': 'Title',\n    'rich_text': 'Text',\n    'number': 'Number',\n    'select': 'Select',\n    'multi_select': 'Multi-select',\n    'date': 'Date',\n    'checkbox': 'Checkbox',\n    'url': 'URL',\n    'email': 'Email',\n    'phone_number': 'Phone',\n    'formula': 'Formula',\n    'relation': 'Relation',\n    'rollup': 'Rollup',\n    'people': 'People',\n    'files': 'Files',\n    'created_time': 'Created',\n    'last_edited_time': 'Last Edited',\n    'created_by': 'Created By',\n    'last_edited_by': 'Last Edited By',\n    'status': 'Status'\n  };\n  \n  return labels[type] || capitalize(type.replace(/_/g, ' '));\n}",[],[926,947],[926],{"_103":955,"_95":956,"_155":957,"_157":-5,"_158":137,"_159":160,"_161":162,"_105":958,"_100":32,"_164":176,"_166":959,"_167":22,"_168":-5,"_169":960,"_98":961},"8e5fd2da-8aa1-11f0-95bf-0224a6c84d84",".vtignore","01991bd6-e87d-71bd-b757-b8ae512499b8",["D",1757108693058],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\nvars.env",[],[956],{"_103":963,"_95":291,"_155":964,"_157":-5,"_158":137,"_159":136,"_161":162,"_105":965,"_100":966,"_164":176,"_166":967,"_167":22,"_168":-5,"_169":968,"_98":969},"59a29492-94b0-11f0-a75b-0224a6c84d84","01991bd6-e87d-71bd-b757-bd6363966c39",["D",1758214558721],12,"# 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/        # Glimpse routes (enhanced with React frontend)\n│   │   ├── tasks/          # Task-related routes\n│   │   ├── views/          # User-facing views\n│   │   └── authCheck.ts    # Authentication middleware\n│   └── services/           # External service integrations\n├── frontend/               # React frontend assets\n│   ├── glimpse.html        # HTML template for glimpse views\n│   ├── glimpse.tsx         # React entry point\n│   ├── components/         # React components\n│   │   ├── GlimpseView.tsx # Main glimpse display component\n│   │   ├── NotionBlock.tsx # Notion block renderer\n│   │   └── NotionProperty.tsx # Property display component\n│   └── README.md\n├── shared/                 # Shared utilities and types\n│   ├── types.ts           # TypeScript interfaces for Notion data\n│   ├── utils.ts           # Shared utility functions\n│   └── README.md\n└── main.tsx               # Application entry point with static file serving\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 path (from Path property)\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 (JSON only)\n- `GET /glimpse/:id` - **Enhanced with React Frontend** - Content negotiation based on Accept header:\n  - **Browser requests** (`Accept: text/html`): Returns rich React frontend with interactive Notion content display\n  - **API requests** (`Accept: application/json`): Returns raw JSON data (same as before)\n  - **Fallback**: If HTML template fails to load, automatically serves JSON\n\n### React Frontend Features\n\nThe `/glimpse/:id` endpoint now includes a rich React frontend when accessed via browser:\n\n#### **Content Rendering**\n- **Rich Notion Blocks**: Supports headings, paragraphs, lists, code blocks, callouts, images, videos, tables, and more\n- **Enhanced Code Blocks**: Syntax highlighting powered by Prism.js with support for 30+ languages, line numbers, and language indicators (optimized for performance with non-blocking JavaScript loading)\n- **Property Display**: Shows all page properties with type-specific formatting and icons\n- **Responsive Design**: Mobile-friendly layout using TailwindCSS\n- **Server-Side Data Injection**: Initial data injected to eliminate loading states\n\n#### **User Experience**\n- **Error Handling**: Graceful error states with retry functionality\n- **Loading States**: Smooth loading indicators\n- **Navigation**: Easy return to dashboard\n- **Debug Mode**: Raw data view in development environments\n- **Dynamic Remote Support**: Remote support section appears only when agents are assigned to the page\n\n#### **Agent Data Integration**\n- **Real-time Agent Updates**: Fetches agent data every 5 seconds when user is authorized\n- **Conditional Display**: Remote support section only appears when agents array has at least one item\n- **Complete Agent Information**: Shows all blob contents including pageId, agents array, lastUpdated, and assignedAt timestamps\n- **Authorization-based**: Only fetches agent data for authorized users (matching email addresses)\n- **Error Handling**: Silent console logging for missing agent data without disrupting user experience\n\n#### **Technical Implementation**\n- **Content Negotiation**: Single endpoint serves both HTML and JSON\n- **Static File Serving**: Frontend assets served via `/frontend/*` route\n- **React 18.2.0**: Pinned version for consistency\n- **TypeScript Support**: Shared types for Notion data structures\n- **Prism.js Integration**: Advanced syntax highlighting with automatic language detection, line numbers, and support for 30+ programming languages including JavaScript, TypeScript, Python, Java, C++, and more (performance-optimized with non-blocking script loading)\n\n**Note:** The glimpse endpoints now provide both programmatic access (JSON) and user-friendly viewing (React frontend) from the same URL, maintaining backward compatibility while adding rich content display capabilities.\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- `GET /api/agent/:id` - Returns agent blob data for a specific page ID\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- **Path property**: Contains user's redirect path in format `/glimpse/:id` (optional for new users)\n\nSupported Path property types: `rich_text`, `title`, `url`\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 Path properties\n- Path format validation errors (must be `/glimpse/:id`)\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/assign` - Assigns agents to tasks based on Assigned property matching (requires `X-API-KEY` header)\n- `POST /tasks/visitor/email/link` - Sends demo link email to visitor based on Email and URL properties (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#### Task Assignment Webhook (`/tasks/assign`)\n\nThe assignment webhook automatically assigns agents to tasks based on Assigned property matching:\n\n**Workflow:**\n1. Receives webhook with page ID from Notion\n2. Retrieves page properties to extract Assigned and Viewing properties\n3. **Checks if Viewing property is true** - if not, skips assignment and logs result\n4. Queries `GLANCE_AGENTS_DB_ID` database for agents with matching Assigned property\n5. **STEP 1: Clear Current Demo Blob** - Immediately clears the agent blob for this demo\n6. **STEP 2: Find New Agents** - Queries agents database by Assigned property\n7. **STEP 3: Collect Agent Data** - Fetches complete agent information and validates\n8. **STEP 4: Clear Agents from Other Demo Blobs** - Removes agents from any other demo blobs to prevent double-assignment\n9. **STEP 5: Update Current Demo Blob** - Stores new agent assignments in the current demo's blob\n\n**Blob-First Architecture:**\n- **Immediate Updates**: Agent blob is updated immediately for fast frontend response\n- **Multi-Blob Clearing**: Ensures agents only appear in one demo blob at a time\n- **Eventual Consistency**: Cron jobs handle Notion database cleanup in the background\n- **No Manual Unassignment**: Assignments are cleared automatically when `Viewing = false`\n- **Reliable**: Blob operations are simpler and more reliable than complex relation management\n\n**Relation Management:**\n- **Simplified Approach**: Only updates the demo page's \"Glimpse agents\" property\n- **Automatic Bidirectional Updates**: Notion automatically updates agents' \"Glimpse demos\" properties\n- **No Manual Clearing**: Eliminates the risk of clearing relations without repopulating them\n- **Reliable Reassignment**: Works correctly even when reassigning the same agents\n\n**Error Handling & Reliability:**\n- **Transactional Approach**: Collects all required data before making any changes\n- **Early Validation**: Aborts assignment if any agent data cannot be fetched\n- **Atomic Updates**: Critical Notion updates happen together or not at all\n- **Non-Blocking Blob Operations**: Both blob updates and blob clearing are non-blocking\n- **Comprehensive Logging**: Detailed checkpoint logging at each phase for debugging\n- **Graceful Degradation**: Continues with available data when possible\n- **Synchronized Blob Clearing**: Removes agents from affected demo blobs when reassigning\n\n**Agent Blob Storage:**\n- **Key Pattern**: `glimpse--agent--{pageId}` (where pageId is from the webhook)\n- **Data Structure**:\n```json\n{\n  \"pageId\": \"page-id\",\n  \"agents\": [\n    {\n      \"agentId\": \"agent-page-id\",\n      \"agentName\": \"Agent Name\",\n      \"agentEmail\": \"agent@example.com\", \n      \"agentMeetUrl\": \"https://meet.google.com/...\",\n      \"agentPhone\": \"+1234567890\"\n    }\n  ],\n  \"lastUpdated\": \"2025-09-10T19:52:00.000Z\",\n  \"assignedAt\": \"2025-09-10T19:52:00.000Z\"\n}\n```\n\n**Requirements:**\n- Page must have a **Viewing property set to true** (assignment only occurs for actively viewed pages)\n- Page must have an Assigned property with assigned person\n- Agents database must have pages with Assigned properties matching the assigned person\n- Original page must have a \"Glimpse agents\" relation property\n- Agent pages must have a \"Glimpse demos\" relation property\n\n**Viewing Property Support:**\n- **Checkbox**: `true` value\n- **Select**: `\"true\"` option name\n- **Rich Text**: `\"true\"` or `\"yes\"` text content (case-insensitive)\n\n**Response Format (Assignment Completed):**\n```json\n{\n  \"success\": true,\n  \"message\": \"Task assignment completed successfully\",\n  \"pageId\": \"page-id\",\n  \"personId\": \"person-id\", \n  \"agentsAssigned\": 2,\n  \"agentsClearedCount\": 1,\n  \"agentsSkippedClearing\": 1,\n  \"agentBlobUpdated\": true,\n  \"blobClearsAttempted\": 2,\n  \"blobClearsSuccessful\": 2,\n  \"timestamp\": \"2025-09-10T16:51:24.733Z\"\n}\n```\n\n**Response Format (Assignment Skipped):**\n```json\n{\n  \"success\": true,\n  \"message\": \"Page is not being viewed - assignment skipped\",\n  \"pageId\": \"page-id\",\n  \"viewing\": false,\n  \"timestamp\": \"2025-09-10T16:51:24.733Z\"\n}\n```\n\n**Relation Management:**\n- **Smart Clearing**: Only clears agents when they're assigned to different demos\n- **Preserves Same-Demo Assignments**: No clearing when reassigning to the same demo\n- **Prevents Multiple Assignments**: Ensures agents are only assigned to one demo at a time\n- **Efficient**: Minimal API calls - only clears when necessary\n- **Reliable**: Handles new agents, existing agents, and reassignments correctly\n\n## Automated Agent Cleanup\n\nThe application includes automated cleanup of stale agent assignments through a dedicated cron job:\n\n### **Agent Cleanup Cron (`cleanup-agent.ts`)**\n\n**Purpose**: Automatically clears agent assignments for pages that no longer have active agents.\n\n**Schedule**: Runs every minute (configurable via Val Town cron settings)\n\n**Workflow:**\n1. **Blob-First Scanning**: Scans all agent blobs with key pattern `glimpse--agent--*`\n2. **Empty Agent Detection**: Identifies blobs where `agents: []` (empty array)\n3. **Assignment Clearing**: For each empty agent blob, clears:\n   - **Assigned property**: Removes assigned person from Notion\n   - **Agent blob**: Deletes the empty blob from storage\n4. **Comprehensive Logging**: Detailed success/failure/skip reporting for monitoring\n\n**Blob-First Architecture:**\n- **Efficient Processing**: Only processes blobs that exist, scales with actual usage\n- **Accurate Detection**: Clears assignments based on actual agent data, not viewing status\n- **Storage Cleanup**: Removes empty blobs to keep storage clean\n- **Consistent Pattern**: Matches the blob-first approach used by viewing cleanup\n\n**Performance Benefits:**\n- **Fast Execution**: Blob scanning is faster than database queries\n- **Targeted Processing**: Only processes pages with empty agent arrays\n- **Resource Efficient**: Minimal API calls to Notion\n\n**Monitoring Output:**\n```json\n{\n  \"success\": true,\n  \"message\": \"Agent cleanup completed\",\n  \"blobsProcessed\": 5,\n  \"blobsSuccessful\": 4,\n  \"blobsFailed\": 0,\n  \"blobsSkipped\": 1,\n  \"processingTime\": \"1.2s\",\n  \"timestamp\": \"2025-09-10T22:15:00.000Z\"\n}\n```\n\nThis automated cleanup ensures that agent assignments are removed when no agents are actively assigned, maintaining clean data and preventing stale assignments from appearing in the frontend.\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- `GLANCE_AGENTS_DB_ID` - Notion database ID for agents\n- `NOTION_API_KEY` - Notion API key for database access\n- `NOTION_WEBHOOK_SECRET` - Secret key for webhook authentication\n\n## Real-time Viewing Analytics\n\nThe application includes real-time viewing analytics with immediate Notion synchronization and email-based authorization:\n\n### **Authorization & Security**\n- **Email-based Access Control**: Viewing analytics are only tracked when the authenticated user's email matches the page's Email property\n- **Frontend Authorization**: Email comparison happens on the frontend before any API calls are made\n- **Zero Unauthorized Calls**: Users without matching emails generate no viewing API requests\n- **Automatic Detection**: System automatically extracts emails from Notion page properties and user authentication\n\n### **Blob Storage + Notion Sync**\n- **Fast blob updates**: Page viewing status stored in Val Town blob storage for instant response (~100ms)\n- **Immediate Notion sync**: When users start viewing pages, Notion database is updated immediately\n- **Automatic cleanup**: Cron job runs every minute to mark stale sessions (>1 minute old) as not viewing\n\n### **Viewing Blob Storage**\n- **Key Pattern**: `glimpse--viewing--{pageId}` (where pageId is the Notion page ID)\n- **Data Structure**:\n```json\n{\n  \"pageId\": \"notion-page-id\",\n  \"tabVisible\": true,\n  \"lastUpdate\": \"2025-01-XX...\",\n  \"userEmail\": \"user@example.com\",\n  \"sessionId\": \"unique-session-id\",\n  \"dateCreated\": \"2025-01-XX...\",\n  \"sessionStart\": \"2025-01-XX...\"\n}\n```\n- **sessionStart**: Single source of truth for session state and timing\n  - `null` = No active session (not viewing)\n  - `timestamp` = Active session that started at this time (currently viewing)\n- **dateCreated**: Set only when the blob is first created, never updated thereafter (first time page was ever viewed)\n- **lastUpdate**: Updated on every viewing status change or heartbeat\n- **sessionId**: Unique identifier preserved across updates for the same viewing session\n\n### **Session State Logic**\n- **Session Active**: `sessionStart !== null` (user is currently viewing)\n- **Session Inactive**: `sessionStart === null` (user is not viewing)\n- **No Contradictory States**: Impossible to have viewing without session start time\n\n### **Viewing Data Flow**\n1. **Authorization Check**: Frontend compares user email with page Email property\n2. **Authorized Users**: Frontend calls `/api/viewing` → Blob updated → **Notion synced immediately**\n   - **Session starts** (`null` → `timestamp`): Updates \"Session start\" and \"Viewing start\" (first time) properties\n   - **Session stops** (`timestamp` → `null`): Clears \"Session start\" property (preserves \"Viewing start\")\n   - **Heartbeat updates**: No Notion sync (session state unchanged)\n3. **User continues viewing**: Frontend updates blob every 4 seconds (no Notion calls)\n4. **User leaves/session stale**: Cron detects stale session → Blob updated → **Notion synced immediately**\n5. **Unauthorized Users**: No API calls made, no viewing analytics tracked\n\n### **Notion Property Behavior**\n\n#### **\"Session start\" Property**\n- **Set when**: User starts viewing a page (`sessionStart` changes from `null` to timestamp)\n- **Value**: Uses the `sessionStart` timestamp from the blob (when the current session began)\n- **Cleared when**: Session ends (`sessionStart` becomes `null`)\n- **Primary status indicator**: Has value = viewing, empty = not viewing\n\n#### **\"Viewing start\" Property**\n- **Set when**: Page is viewed for the first time ever (blob `dateCreated` is set)\n- **Value**: Uses the `dateCreated` timestamp from the blob (first-ever view)\n- **Never updated**: Immutable historical record\n- **Purpose**: Analytics on page discovery patterns\n\n### **Unified Session Model**\n- **Single Source of Truth**: `sessionStart` property determines both session existence and timing\n- **Logical Consistency**: `sessionStart !== null` ↔ user is viewing\n- **No Contradictions**: Impossible to have viewing state without session start time\n- **Simplified Logic**: One property instead of separate `viewing` boolean and `sessionStarted` timestamp\n\n### **Email Property Requirements**\nPages must include an **Email property** in Notion for viewing analytics to work:\n- **Property Name**: \"Email\" or \"email\" \n- **Property Type**: Email type or Rich Text type\n- **Content**: Must exactly match the authenticated user's email address\n\n### **Notion Database Schema**\nPages in your Notion databases should include these properties for viewing analytics:\n- **Email** (Email or Rich Text) - **Required** for authorization\n- **Session start** (Date) - **Primary viewing status**: Currently viewing + when session began\n- **Viewing start** (Date) - When page was first ever viewed (historical)\n- **Last Viewed** (Date) - Timestamp of last viewing activity  \n- **Current Viewer** (Rich Text) - Email of current viewer\n- **Tab Visible** (Checkbox) - Whether page tab is currently visible\n\n### **Property Logic**\n- **\"Session start\" has value** = User is currently viewing (session active since that timestamp)\n- **\"Session start\" is empty** = User is not viewing (no active session)\n- **\"Viewing start\"** = Historical record of when page was first discovered\n\n### **Frontend Integration**\n- **Email Authorization**: Compares authenticated user email with page Email property before tracking\n- **Page Visibility API**: Tracks when users switch tabs or minimize windows\n- **Periodic updates**: Calls viewing API every 4 seconds while page is active (authorized users only)\n- **Session management**: Automatic cleanup handles crashed browsers and network issues\n- **Performance**: Non-blocking API calls don't impact user experience, zero calls for unauthorized users",[],[291],{"_103":971,"_95":972,"_155":973,"_157":-5,"_158":137,"_159":160,"_161":162,"_105":974,"_100":32,"_164":176,"_166":975,"_167":22,"_168":-5,"_169":976,"_98":977},"8e5fdf6e-8aa1-11f0-95bf-0224a6c84d84","deno.json","01991bd6-e87d-71bd-b757-c35e5430a987",["D",1757108693058],"{\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}",[],[972],{"_103":979,"_95":980,"_155":981,"_157":-5,"_158":137,"_159":350,"_161":162,"_105":982,"_100":313,"_164":983,"_166":984,"_167":22,"_168":-5,"_169":985,"_98":986},"3bb93f2a-8e2b-11f0-bb42-0224a6c84d84","main.tsx","01991bd6-e87d-71bd-b757-c4cf2f32ff6d",["D",1757497678504],"http","import { Hono } from \"npm:hono@3.12.12\";\nimport { lastlogin } from \"https://esm.town/v/stevekrouse/lastlogin_safe\";\nimport { serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\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) => Promise.reject(err));\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// Add static file serving for frontend assets\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\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);",[],[980],"files",[152,171,180,188,196,204,212,220,228,236,244,252,260,268,277,283,289,298,308,317,326,335,344,355,361,369,379,388,394,400,408,417,423,431,440,446,453,461,469,479,485,492,500,509,516,524,533,539,545,553,561,570,577,586,595,601,609,615,622,630,638,646,654,663,671,677,683,693,702,712,718,725,733,741,749,758,763,770,778,786,794,803,809,818,823,830,838,846,854,863,868,875,883,891,900,907,915,924,930,937,945,954,962,970,978],"counts",{"_991":32,"_992":313,"_993":32,"_994":995},"pulls","branches","forks","envVars",6,"contents",[],{"_103":261,"_95":262,"_155":263,"_157":156,"_158":137,"_159":160,"_161":162,"_105":999,"_100":32,"_164":176,"_166":265,"_167":22,"_168":-5,"_98":1000},["D",1757108693058],[154,262],"upstreamProject",{"_103":145,"_95":1003,"_111":-5,"_112":-5,"_109":110,"_23":1004},"glimpse2-runbook-view-glimpse-save-login",{"_93":94,"_129":130},"upstreamBranch",{"_103":140,"_105":1007,"_1008":1009,"_95":43,"_138":145,"_100":142,"_139":1010,"_141":313,"_1011":1012,"_107":-5,"_149":22,"_109":110,"_148":94,"_16":118,"_147":1003},["D",1757010775113],"updatedAt",["D",1757101278463],"ca490e12-789d-11f0-a6af-0224a6c84d84","lockfileKey","1757181894038-esm.town_v_lightweight_glimpse2-runbook-view-glimpse-save-login@3-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.history_.$",{"_93":94,"_95":96,"_97":43,"_98":99,"_101":1019,"_176":1024,"_1027":1028,"_1031":1032,"_1035":-7,"_1036":32,"_1037":22},{"_103":104,"_95":96,"_105":1020,"_107":-5,"_108":22,"_109":110,"_111":-5,"_112":-5,"_14":113,"_114":-5,"_115":22,"_116":-5,"_117":32,"_16":118,"_119":120,"_121":120,"_122":123,"_124":123,"_125":123,"_126":120,"_127":120,"_23":1021,"_131":1022,"_134":1023,"_149":22},["D",1757108693058],{"_93":94,"_129":130},{"_93":94,"_133":130},{"_100":136,"_95":43,"_103":137,"_138":104,"_139":140,"_141":142,"_143":110,"_144":145,"_146":118,"_147":96,"_148":94},{"_103":261,"_95":262,"_155":263,"_157":156,"_158":137,"_159":160,"_161":162,"_105":1025,"_100":32,"_164":176,"_166":265,"_167":22,"_168":-5,"_98":1026},["D",1757108693058],[154,262],"history",[1029],{"_103":261,"_158":137,"_155":263,"_95":262,"_166":265,"_164":176,"_100":32,"_157":156,"_105":1030,"_159":160,"_168":-5},["D",1757108693058],"versions",[1033],{"_176":1029,"_1034":-5},"previous","versionNumber","page","hasNext","actionData","errors"]
lightweight

glimpse2-runbook-view-glimpse-save-login-react

History for 11-html.md
