[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_616":617,"_618":619},"routes/_app.x.$handle.$name",{"_101":100,"_32":46,"_109":87,"_27":110,"_13":14,"_111":-5,"_11":112,"_113":114,"_115":116,"_117":118,"_119":120,"_20":-5,"_121":122,"_123":124,"_125":25,"_126":127,"_128":59,"_129":-5,"_130":-5,"_131":132},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":57,"_58":59,"_60":59,"_61":-5,"_62":63,"_64":65,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":80,"_81":82,"_83":84,"_85":25},"version",155,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","backend/services/fakeKrogerAuth.ts","latestPath","fileId","bc4a479c-3e53-11f0-8b3d-76b3cceeab13","name","fakeKrogerAuth.ts","fileType","script","content","import { IKrogerAuthService } from \"../../shared/types/krogerAuth.ts\";\nimport {\n KrogerLocationResponse,\n KrogerLocationsResponse,\n KrogerProfileResponse,\n KrogerTokenResponse,\n} from \"../../shared/types/kroger.ts\";\n\nexport class MockKrogerAuthService implements IKrogerAuthService {\n private redirectUri: string;\n\n constructor() {\n this.redirectUri = Deno.env.get(\"KROGER_REDIRECT_URI\") || \"\";\n\n if (!this.redirectUri) {\n console.warn(\n \"Missing Kroger OAuth environment variables. OAuth features will be disabled.\"\n );\n console.warn(\"Required variables: KROGER_REDIRECT_URI\");\n }\n }\n\n private mockLocations: KrogerLocationResponse[] = [\n {\n locationId: \"123\",\n chain: \"KROGER\",\n name: \"Mock Kroger Store\",\n address: {\n addressLine1: \"123 Main St\",\n city: \"Cincinnati\",\n state: \"OH\",\n zipCode: \"45202\",\n },\n phone: \"555-0123\",\n hours: {\n monday: { open: \"06:00\", close: \"23:00\" },\n tuesday: { open: \"06:00\", close: \"23:00\" },\n wednesday: { open: \"06:00\", close: \"23:00\" },\n thursday: { open: \"06:00\", close: \"23:00\" },\n friday: { open: \"06:00\", close: \"23:00\" },\n saturday: { open: \"06:00\", close: \"23:00\" },\n sunday: { open: \"06:00\", close: \"23:00\" },\n },\n },\n ];\n\n isConfigured(): boolean {\n return true;\n }\n\n getAuthorizationUrl(state?: string): string {\n return this.redirectUri + \"?state=\" + state;\n }\n\n async exchangeCodeForToken(code: string): Promise {\n return {\n access_token: \"mock-access-token\",\n refresh_token: \"mock-refresh-token\",\n expires_in: 3600,\n token_type: \"Bearer\",\n };\n }\n\n async refreshToken(refreshToken: string): Promise {\n return {\n access_token: \"mock-refreshed-access-token\",\n refresh_token: \"mock-refreshed-refresh-token\",\n expires_in: 3600,\n token_type: \"Bearer\",\n };\n }\n\n async getUserProfile(accessToken: string): Promise {\n return {\n data: {\n id: \"mock-user-id\",\n email: \"mock@example.com\",\n firstName: \"Mock\",\n lastName: \"User\",\n },\n };\n }\n\n isTokenExpired(expiresAt: number): boolean {\n return Date.now() >= expiresAt;\n }\n\n async getValidAccessToken(\n currentToken: string,\n refreshToken: string,\n expiresAt: number\n ): Promise<{\n accessToken: string;\n refreshToken: string;\n expiresIn: number;\n } | null> {\n if (!this.isTokenExpired(expiresAt)) {\n return {\n accessToken: currentToken,\n refreshToken,\n expiresIn: Math.floor((expiresAt - Date.now()) / 1000),\n };\n }\n\n const tokenResponse = await this.refreshToken(refreshToken);\n return {\n accessToken: tokenResponse.access_token,\n refreshToken: tokenResponse.refresh_token,\n expiresIn: tokenResponse.expires_in,\n };\n }\n\n async searchLocationsByZipCode(\n accessToken: string,\n zipCode: string,\n radiusInMiles: number = 10,\n limit: number = 20\n ): Promise {\n return {\n data: this.mockLocations,\n meta: {\n pagination: {\n start: 0,\n limit,\n total: this.mockLocations.length,\n },\n },\n };\n }\n\n async getLocationById(\n accessToken: string,\n locationId: string\n ): Promise {\n const location = this.mockLocations.find(\n (loc) => loc.locationId === locationId\n );\n if (!location) {\n throw new Error(`Location not found: ${locationId}`);\n }\n return location;\n }\n}\n","import { IKrogerAuthService } from \"../../shared/types.ts\";\nimport {\n KrogerLocation,\n KrogerLocationResponse,\n KrogerLocationsResponse,\n KrogerProfileResponse,\n KrogerTokenResponse,\n} from \"../../shared/types.ts\";\n\nexport class MockKrogerAuthService implements IKrogerAuthService {\n private redirectUri: string;\n\n constructor() {\n this.redirectUri = Deno.env.get(\"KROGER_REDIRECT_URI\") || \"\";\n\n if (!this.redirectUri) {\n console.warn(\n \"Missing Kroger OAuth environment variables. OAuth features will be disabled.\"\n );\n console.warn(\"Required variables: KROGER_REDIRECT_URI\");\n }\n }\n\n private mockLocations: KrogerLocation[] = [\n {\n storeNumber: \"123\",\n divisionNumber: \"001\",\n geolocation: {\n latLng: \"39.1031,-84.5120\",\n latitude: 39.1031,\n longitude: -84.512,\n },\n departments: [],\n locationId: \"123\",\n chain: \"KROGER\",\n name: \"Mock Kroger Store\",\n address: {\n addressLine1: \"123 Main St\",\n county: \"HAMILTON\",\n city: \"Cincinnati\",\n state: \"OH\",\n zipCode: \"45202\",\n },\n phone: \"555-0123\",\n hours: {\n Open24: false,\n gmtOffset: \"UTC-05:00\",\n timezone: \"America/New_York\",\n monday: { open: \"06:00\", close: \"23:00\", open24: false },\n tuesday: { open: \"06:00\", close: \"23:00\", open24: false },\n wednesday: { open: \"06:00\", close: \"23:00\", open24: false },\n thursday: { open: \"06:00\", close: \"23:00\", open24: false },\n friday: { open: \"06:00\", close: \"23:00\", open24: false },\n saturday: { open: \"06:00\", close: \"23:00\", open24: false },\n sunday: { open: \"06:00\", close: \"23:00\", open24: false },\n },\n },\n ];\n\n isConfigured(): boolean {\n return true;\n }\n\n getAuthorizationUrl(state?: string): string {\n return this.redirectUri + \"?state=\" + state;\n }\n\n async exchangeCodeForToken(_code: string): Promise {\n return {\n access_token: \"mock_access_token\",\n refresh_token: \"mock_refresh_token\",\n expires_in: 3600,\n token_type: \"Bearer\",\n };\n }\n\n async refreshToken(_refreshToken: string): Promise {\n return {\n access_token: \"mock_access_token\",\n refresh_token: \"mock_refresh_token\",\n expires_in: 3600,\n token_type: \"Bearer\",\n };\n }\n\n async getUserProfile(_accessToken: string): Promise {\n return {\n data: {\n id: \"mock_user_id\",\n },\n meta: {\n warnings: [],\n pagination: {\n start: 0,\n limit: 1,\n total: 1,\n },\n },\n };\n }\n\n isTokenExpired(expiresAt: number): boolean {\n return Date.now() >= expiresAt;\n }\n\n async getValidAccessToken(\n currentToken: string,\n refreshToken: string,\n expiresAt: number\n ): Promise<{\n accessToken: string;\n refreshToken: string;\n expiresIn: number;\n } | null> {\n if (!this.isTokenExpired(expiresAt)) {\n return {\n accessToken: currentToken,\n refreshToken,\n expiresIn: Math.floor((expiresAt - Date.now()) / 1000),\n };\n }\n\n try {\n const tokenResponse = await this.refreshToken(refreshToken);\n return {\n accessToken: tokenResponse.access_token,\n refreshToken: tokenResponse.refresh_token,\n expiresIn: tokenResponse.expires_in,\n };\n } catch (error) {\n console.error(\"Failed to refresh token:\", error);\n return null;\n }\n }\n\n async searchLocationsByZipCode(\n _accessToken: string,\n _zipCode: string,\n _radiusInMiles: number = 10,\n limit: number = 20\n ): Promise {\n return {\n data: this.mockLocations,\n meta: {\n warnings: [],\n pagination: {\n start: 0,\n limit,\n total: this.mockLocations.length,\n },\n },\n };\n }\n\n async getLocationById(\n accessToken: string,\n locationId: string\n ): Promise {\n const location = this.mockLocations.find(\n (loc) => loc.locationId === locationId\n );\n if (!location) {\n throw new Error(`Location not found: ${locationId}`);\n }\n return { data: location };\n }\n}\n","createdAt",["D",1749441030790],"branchVersion","branchId","a523f804-3c43-11f0-baed-9e149126039e","id","a5228f14-3c43-11f0-baed-9e149126039e","personalShopper",["D",1748492167939],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","70d1fa10-3c43-11f0-8f77-839c97346035","pinnedFileId","7bbe5560-3c46-11f0-bcc1-9e149126039e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",1,"orgId","5448abbb-bf1c-494f-95e1-0b9bc21d0698","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_101":100,"_108":104},"org",{"_101":100,"_102":-5,"_103":104,"_18":55,"_105":106,"_107":25},"branch",{"_13":86,"_32":87,"_44":43,"_88":45,"_89":90,"_91":92,"_93":51,"_94":95,"_96":97,"_98":46,"_99":100},"isOwned",218,"main","projectId","forkedBranchId","f2b37196-17c5-11f0-8a41-569c3dd06744","forkedBranchVersion",9,"forkedProjectPrivacy","forkedProjectId","f2b0e6b0-17c5-11f0-8a41-569c3dd06744","forkedProjectOrgId","69d201b4-10ca-4770-a6d6-a8839b626fda","projectName","userHandle","bgschiller","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yeGtwbDJtR1BUTXlCMWc5R1Qwb2ZzTlFYQzgifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_44":45,"_32":46,"_39":612,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":57,"_58":59,"_60":59,"_61":-5,"_62":63,"_64":65,"_66":-5,"_67":-5,"_68":-5,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":613,"_81":614,"_83":615,"_85":25},"tree",[242,246,256,263,279,284,285,286,287,288,289],"files",[242,243,244,245,246,247,248,249,250,251,252,253,254,255,256,257,258,259,260,261,262,263,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289],"counts",{"_231":162,"_232":63,"_233":63,"_234":235,"_236":237},"contents",[144,145,146,147,148,149,150,151,152,153,154],"upstreamProject",{"_44":95,"_32":141,"_53":-5,"_54":-5,"_50":51,"_79":142},"upstreamBranch",{"_44":90,"_39":133,"_134":135,"_32":87,"_88":95,"_13":92,"_89":136,"_91":137,"_138":139,"_48":-5,"_85":25,"_50":51,"_99":140,"_64":97,"_98":141},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1744479939609],"updatedAt",["D",1744990353681],"419a43c8-147b-11f0-96a2-569c3dd06744",228,"lockfileKey","1767112378995-esm.town_v_geoffreylitt_stevensDemo@9-main","geoffreylitt","stevensDemo",{"_101":140,"_108":143},"https://secure.gravatar.com/avatar/94262cddd28e127e29dacba5f09c8125.jpg?s=200&d=identicon",{"_44":225,"_32":226,"_30":227,"_158":-5,"_42":43,"_41":228,"_160":59,"_39":229,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_27":230},{"_44":219,"_32":220,"_30":221,"_158":-5,"_42":43,"_41":222,"_160":59,"_39":223,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_27":224},{"_44":213,"_32":214,"_30":215,"_158":-5,"_42":43,"_41":216,"_160":59,"_39":217,"_13":63,"_34":205,"_36":-5,"_24":25,"_164":-5,"_27":218},{"_44":207,"_32":208,"_30":209,"_158":-5,"_42":43,"_41":210,"_160":59,"_39":211,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_27":212},{"_44":201,"_32":202,"_30":203,"_158":-5,"_42":43,"_41":63,"_160":59,"_39":204,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_27":206},{"_44":195,"_32":196,"_30":197,"_158":-5,"_42":43,"_41":63,"_160":59,"_39":198,"_13":162,"_34":20,"_36":199,"_24":25,"_164":-5,"_27":200},{"_44":188,"_32":189,"_30":190,"_158":-5,"_42":43,"_41":191,"_160":59,"_39":192,"_13":63,"_34":20,"_36":193,"_24":25,"_164":-5,"_27":194},{"_44":181,"_32":182,"_30":183,"_158":-5,"_42":43,"_41":184,"_160":59,"_39":185,"_13":178,"_34":20,"_36":186,"_24":25,"_164":-5,"_27":187},{"_44":173,"_32":174,"_30":175,"_158":-5,"_42":43,"_41":176,"_160":59,"_39":177,"_13":178,"_34":20,"_36":179,"_24":25,"_164":-5,"_27":180},{"_44":166,"_32":167,"_30":168,"_158":-5,"_42":43,"_41":169,"_160":25,"_39":170,"_13":162,"_34":20,"_36":171,"_24":25,"_164":-5,"_27":172},{"_44":155,"_32":156,"_30":157,"_158":-5,"_42":43,"_41":159,"_160":25,"_39":161,"_13":162,"_34":35,"_36":163,"_24":25,"_164":-5,"_27":165},"0693ac74-3e51-11f0-9e80-76b3cceeab13","vite.config.ts","0693ad28-3e51-11f0-9e80-76b3cceeab13","parentId",97,"latest",["D",1748717817126],0,"import { defineConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\nexport default defineConfig({\n plugins: [react()],\n server: {\n proxy: {\n \"/api\": \"http://localhost:3000\",\n \"/auth\": \"http://localhost:3000\",\n },\n },\n});\n","label",[156],"e352a7fc-44e4-11f0-b4ed-76b3cceeab13","package.json","e352a8c4-44e4-11f0-b4ed-76b3cceeab13",150,["D",1749441030551],"{\n \"name\": \"personal-shopper\",\n \"version\": \"1.0.0\",\n \"description\": \"AI-powered grocery shopping with Kroger\",\n \"scripts\": {\n \"storybook\": \"storybook dev -p 6006\",\n \"build-storybook\": \"storybook build\"\n },\n \"dependencies\": {\n \"react\": \"^18.2.0\",\n \"react-dom\": \"^18.2.0\"\n },\n \"devDependencies\": {\n \"@storybook/addon-essentials\": \"^7.6.17\",\n \"@storybook/addon-interactions\": \"^7.6.17\",\n \"@storybook/addon-links\": \"^7.6.17\",\n \"@storybook/blocks\": \"^7.6.17\",\n \"@storybook/react\": \"^7.6.17\",\n \"@storybook/react-vite\": \"^7.6.17\",\n \"@storybook/testing-library\": \"^0.2.2\",\n \"storybook\": \"^7.6.17\",\n \"typescript\": \"^5.3.3\",\n \"vite\": \"^5.1.4\"\n },\n \"packageManager\": \"pnpm@8.15.4+sha512.0bd3a9be9eb0e9a692676deec00a303ba218ba279d99241475616b398dbaeedd11146f92c2843458f557b1d127e09d4c171e105bdcd6b61002b39685a8016b9e\"\n}\n",[167],"e365355c-44e4-11f0-937c-76b3cceeab13","deno.json","f544c966-3dd4-11f0-ae70-76b3cceeab13",152,["D",1749441030650],2,"{\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\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ],\n \"jsx\": \"react-jsx\",\n \"jsxImportSource\": \"https://esm.sh/react@18.2.0\"\n },\n \"lint\": {\n \"files\": {\n \"include\": [\"deno:/https/esm.town/**/*\"]\n },\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"nodeModulesDir\": \"auto\",\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}\n",[174],"b5d9b24e-3c46-11f0-bde3-9e149126039e","README.md","80b611a2-c042-4094-a22c-81cb2ded5934",29,["D",1748493484473],"# Personal Shopper\n\n## Description\n\nThis is an AI-powered Grocery Shopping assistant that turns an imprecise list of items like \"milk, bread, eggs\" into a Kroger cart full of groceries. It relies on the Kroger API to search each item, then uses an LLM to decide which specific UPC to add to the cart (again, using the Kroger API). Once an item is selected, we store the UPC in the database so we can avoid consulting the LLM for that item again.\n\nHouseholds have preferences for which items to buy, and what priorities they have for each item. For example, we prefer to buy free range eggs and poultry, but don't particularly care whether they are organic or not. These details are stored in a database, which should also be consulted to add context to the LLM's decisions.\n\n## Kroger OAuth Implementation\n\nThe application now includes a complete OAuth2 flow for Kroger authentication:\n\n### Environment Variables Required\n\nSet these in your Val Town environment:\n\n- `KROGER_CLIENT_ID` - Your Kroger API client ID\n- `KROGER_CLIENT_SECRET` - Your Kroger API client secret \n- `KROGER_REDIRECT_URI` - Your registered redirect URI (e.g., `https://your-val.web.val.run/auth/callback`)\n\n### OAuth Flow\n\n1. **Login**: User clicks \"Connect with Kroger\" → redirected to `/auth/login`\n2. **Authorization**: App redirects to Kroger's OAuth endpoint with proper parameters\n3. **Callback**: Kroger redirects back to `/auth/callback` with authorization code\n4. **Token Exchange**: App exchanges code for access/refresh tokens\n5. **Profile Fetch**: App gets user's Kroger profile ID\n6. **Session**: User is logged in with session cookie\n\n### Authentication Features\n\n- **Secure Sessions**: HTTP-only cookies with proper security settings\n- **Token Refresh**: Automatic refresh of expired access tokens\n- **State Validation**: CSRF protection using state parameter\n- **User Management**: Create/update users based on Kroger profile ID\n\n## Database Schema\n\nThe database consists of the following tables:\n\n### kroger_users_1\n- `id` - Unique user ID (primary key)\n- `krogerProfileId` - Kroger's unique user identifier\n- `accessToken` - Current OAuth access token\n- `refreshToken` - OAuth refresh token\n- `tokenExpiresAt` - Token expiration timestamp\n- `preferredLocationId` - User's preferred Kroger store location\n- `createdAt` / `updatedAt` - Timestamps\n\n### guidance_1\n- `id` - Unique guidance ID (primary key)\n- `userId` - Foreign key to kroger_users_1\n- `itemName` - Name of the item (e.g., \"milk\", \"bread\")\n- `guidance` - Textual preferences (e.g., \"prefer free range eggs\")\n- `createdAt` / `updatedAt` - Timestamps\n\n### selections_1\n- `id` - Unique selection ID (primary key)\n- `userId` - Foreign key to kroger_users_1\n- `itemName` - User's free text item name\n- `upc` - Selected product UPC code\n- `productName` - Full product name from Kroger\n- `createdAt` / `updatedAt` - Timestamps\n- Unique constraint on (userId, itemName)\n\n## API Endpoints\n\n### Authentication\n- `GET /auth/login` - Start OAuth flow\n- `GET /auth/callback` - OAuth callback handler\n- `POST /auth/logout` - Logout user\n- `GET /api/user` - Get current user info\n- `PUT /api/user/location` - Update preferred store location\n\n### Guidance Management\n- `GET /api/guidance` - Get all guidance for current user\n- `GET /api/guidance/search?q=item` - Search guidance by item name\n- `POST /api/guidance` - Create new guidance\n- `PUT /api/guidance/:id` - Update guidance\n- `DELETE /api/guidance/:id` - Delete guidance\n\n### Selection Management\n- `GET /api/selections` - Get all selections for current user\n- `GET /api/selections/item/:itemName` - Get selection for specific item\n- `POST /api/selections` - Create/update selection\n- `PUT /api/selections/:id` - Update selection\n- `DELETE /api/selections/:id` - Delete selection\n\n## Shopping Process\n\n1. The user supplies a list of items they want to buy.\n2. We search the Kroger API, getting a list of products that match the free text name.\n3. For each item, we:\n 1. Try to find it in selections. If we can't find it there,\n 2. Use full-text search to find the most relevant guidance. Then ask the LLM to decide which specific UPC to add to the cart. Store this in the selections table for next time.\n4. We use the Kroger API to add the item to the cart.\n5. Repeat for each item.\n\nThere is no need to check out the cart, as the user will review the cart in the app and make any necessary changes.\n\n### Secondary flows\n\n- The user can add new items to the guidance table.\n- The user can CRUD their selections.\n- The user can change their Kroger location ID.\n- The user can log out.\n\n## Tech Stack\n\n- TypeScript\n- Val.Town with SQLite integration\n- Hono for the API\n- TailwindCSS for styling\n- Kroger API for product data and cart management\n\n## File Structure\n\n```\n├── backend/\n│ ├── index.ts # Main HTTP handler with OAuth routes\n│ ├── database/\n│ │ ├── migrations.ts # Database schema setup\n│ │ └── krogerQueries.ts # Database query functions\n│ └── services/\n│ └── krogerAuth.ts # Kroger OAuth service\n├── frontend/\n│ └── index.html # Single-page application\n├── shared/\n│ └── types.ts # Shared TypeScript interfaces\n└── docs/ # Kroger API documentation\n```\n\nSee .cursorrules for more details.",[182],"eaec26d2-3ddc-11f0-b9b0-76b3cceeab13",".vtignore","f53a2524-3dd4-11f0-831a-76b3cceeab13",88,["D",1748667949184],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\n.envrc\n",[189],"a527b8e0-3c43-11f0-baed-9e149126039e",".cursorrules","5b776fdb-b581-4e9e-a17f-0d15b7a21e1b",["D",1748492167939],"# Val Town Project Rules and Guidelines\n\nYou are an advanced assistant specialized in generating Val Town code.\n\n\n## Types of Vals\n\n### 1. Script Vals\n\n- Basic JavaScript/TypeScript functions\n- Can be imported by other vals\n- Example structure:\n\n```typescript\nexport function myFunction() {\n // Your code here\n}\n```\n\n### 2. HTTP Vals\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```typescript\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\n### 3. Cron Vals\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```typescript\nexport default async function () {\n // Scheduled task code\n}\n```\n\n### 4. Email Vals\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```typescript\nexport default async function (email: Email) {\n // Process email\n}\n```\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = 'todo_app_users_2';\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create a fresh table.\n\n### OpenAI\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({\n subject: \"Hi\",\n text: \"Hi\",\n html: \"

Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\nAlways import utilities with version pins to avoid breaking changes:\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n1. **parseProject** - Extract information about the current project from import.meta.url:\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\n2. **readFile** - Read files from within the project:\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n3. **serveFile** - Serve project files with proper content types:\n```ts\n// Serve a file from the project with proper Content-Type header\napp.get(\"/public/style.css\", c => serveFile(\"/frontend/style.css\", import.meta.url));\n```\n\n4. **listFiles** - List all files in the project:\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n5. **fetchTranspiledJavaScript** - Fetch and transpile TypeScript to JavaScript:\n```ts\nconst jsCode = await fetchTranspiledJavaScript(\"https://esm.town/v/username/project/path/to/file.ts\");\n```\n\n6. **testServer** - Create a test server for running test suites:\n```ts\nexport default testServer([\n {\n name: \"Feature Tests\",\n tests: [\n {\n name: \"should add numbers correctly\",\n function: () => {\n expect(1 + 1).toBe(2);\n },\n }\n ],\n }\n]);\n```\n\n## Val Town Platform Specifics\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- For AI-generated images, use: `https://maxm-imggenurl.web.val.run/the-description-of-your-image`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link with `import.meta.url.replace(\"esm.town\", \"val.town\")` and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; avoid catches that merely log or return 500s - let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` and minimize their use - prefer APIs without keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- For persistence, use Val Town SQLite or Blob storage with `import.meta.url` for keys/table names\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and include the `@jsxImportSource` pragma\n- When facing client-side render issues, check if all React dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n- Hono is the recommended API framework (similar to Express, Flask, or Sinatra)\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n // Use the serveFile utility to handle content types automatically\n app.get(\"/public/*\", c => serveFile(c.req.path.replace(\"/public\", \"/frontend\"), import.meta.url));\n\n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Be careful with error handling as Hono tends to swallow errors\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Frontend Best Practices\n- Structure as a standard client-side React app\n- Use SVG for favicons (Val Town only supports text files)\n- Separate components into individual files\n- Access bootstrapped data from `window.__INITIAL_DATA__`\n- Use React 18.2.0 consistently in all imports and the `@jsxImportSource` pragma\n- Follow the React component pattern from the example project\n- Handle API calls properly with proper error catching\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n- Follow the queries and migrations pattern from the example\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:**\n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n - Properly handle CORS if needed for external access",[196],"a527b656-3c43-11f0-baed-9e149126039e","shared","f51258e7-ba5a-41ab-9356-127b9178fe98",["D",1748492167939],"directory",[202],"9dba5c4a-3c46-11f0-b3a3-9e149126039e","frontend","2c2592a9-213d-42d8-b3c8-e300bf3eaa04",28,["D",1748493443987],[208],"397162ac-3c45-11f0-9e6e-9e149126039e","docs","3679b36a-3c45-11f0-9e6e-9e149126039e",5,["D",1748492846253],[214],"018e8d82-3c46-11f0-b1b1-9e149126039e","backend","b913e97a-f723-4624-98c5-8a0153655046",23,["D",1748493181993],[220],"e2b98a54-44e4-11f0-b4e2-76b3cceeab13",".storybook","e2b98b30-44e4-11f0-b4e2-76b3cceeab13",131,["D",1749441029546],[226],"pulls","branches","forks","envVars",{"_238":240,"_241":162},"connections",{"_238":162,"_239":162},"count","unfilledCount",4,"emptyCount",{"_44":225,"_32":226,"_30":227,"_158":-5,"_42":43,"_41":228,"_160":59,"_39":609,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":610,"_27":611},{"_44":601,"_32":602,"_30":603,"_158":227,"_42":43,"_41":604,"_160":59,"_39":605,"_13":162,"_34":35,"_36":606,"_24":25,"_164":-5,"_291":607,"_27":608},{"_44":593,"_32":594,"_30":595,"_158":227,"_42":43,"_41":596,"_160":59,"_39":597,"_13":162,"_34":20,"_36":598,"_24":25,"_164":-5,"_291":599,"_27":600},{"_44":585,"_32":586,"_30":587,"_158":227,"_42":43,"_41":588,"_160":59,"_39":589,"_13":162,"_34":35,"_36":590,"_24":25,"_164":-5,"_291":591,"_27":592},{"_44":219,"_32":220,"_30":221,"_158":-5,"_42":43,"_41":222,"_160":59,"_39":582,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":583,"_27":584},{"_44":578,"_32":561,"_30":556,"_158":221,"_42":43,"_41":222,"_160":59,"_39":579,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":580,"_27":581},{"_44":570,"_32":571,"_30":572,"_158":556,"_42":43,"_41":573,"_160":25,"_39":574,"_13":162,"_34":35,"_36":575,"_24":25,"_164":-5,"_291":576,"_27":577},{"_44":562,"_32":563,"_30":564,"_158":556,"_42":43,"_41":565,"_160":59,"_39":566,"_13":63,"_34":35,"_36":567,"_24":25,"_164":-5,"_291":568,"_27":569},{"_44":553,"_32":554,"_30":555,"_158":556,"_42":43,"_41":222,"_160":25,"_39":557,"_13":162,"_34":35,"_36":558,"_24":25,"_164":-5,"_291":559,"_27":560},{"_44":548,"_32":543,"_30":537,"_158":221,"_42":43,"_41":549,"_160":59,"_39":550,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":551,"_27":552},{"_44":544,"_32":33,"_30":31,"_158":537,"_42":43,"_41":14,"_160":59,"_39":545,"_13":63,"_34":35,"_36":38,"_24":25,"_164":-5,"_291":546,"_27":547},{"_44":535,"_32":318,"_30":536,"_158":537,"_42":43,"_41":538,"_160":25,"_39":539,"_13":216,"_34":35,"_36":540,"_24":25,"_164":-5,"_291":541,"_27":542},{"_44":527,"_32":528,"_30":529,"_158":221,"_42":43,"_41":530,"_160":25,"_39":531,"_13":162,"_34":35,"_36":532,"_24":25,"_164":-5,"_291":533,"_27":534},{"_44":517,"_32":518,"_30":57,"_158":221,"_42":43,"_41":519,"_160":25,"_39":520,"_13":521,"_34":522,"_36":523,"_24":25,"_164":524,"_291":525,"_27":526},{"_44":213,"_32":214,"_30":215,"_158":-5,"_42":43,"_41":216,"_160":59,"_39":514,"_13":63,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":515,"_27":516},{"_44":507,"_32":508,"_30":509,"_158":215,"_42":43,"_41":92,"_160":59,"_39":510,"_13":479,"_34":20,"_36":511,"_24":25,"_164":-5,"_291":512,"_27":513},{"_44":499,"_32":500,"_30":501,"_158":215,"_42":43,"_41":502,"_160":59,"_39":503,"_13":479,"_34":20,"_36":504,"_24":25,"_164":-5,"_291":505,"_27":506},{"_44":491,"_32":492,"_30":493,"_158":215,"_42":43,"_41":494,"_160":59,"_39":495,"_13":479,"_34":20,"_36":496,"_24":25,"_164":-5,"_291":497,"_27":498},{"_44":483,"_32":484,"_30":485,"_158":215,"_42":43,"_41":486,"_160":59,"_39":487,"_13":63,"_34":20,"_36":488,"_24":25,"_164":-5,"_291":489,"_27":490},{"_44":474,"_32":475,"_30":476,"_158":215,"_42":43,"_41":477,"_160":59,"_39":478,"_13":479,"_34":20,"_36":480,"_24":25,"_164":-5,"_291":481,"_27":482},{"_44":466,"_32":467,"_30":468,"_158":215,"_42":43,"_41":469,"_160":59,"_39":470,"_13":162,"_34":20,"_36":471,"_24":25,"_164":-5,"_291":472,"_27":473},{"_44":207,"_32":208,"_30":209,"_158":-5,"_42":43,"_41":210,"_160":59,"_39":463,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":464,"_27":465},{"_44":458,"_32":377,"_30":371,"_158":209,"_42":43,"_41":459,"_160":25,"_39":460,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":461,"_27":462},{"_44":450,"_32":451,"_30":452,"_158":371,"_42":43,"_41":453,"_160":25,"_39":454,"_13":162,"_34":35,"_36":455,"_24":25,"_164":-5,"_291":456,"_27":457},{"_44":442,"_32":443,"_30":444,"_158":371,"_42":43,"_41":445,"_160":25,"_39":446,"_13":162,"_34":35,"_36":447,"_24":25,"_164":-5,"_291":448,"_27":449},{"_44":434,"_32":435,"_30":436,"_158":371,"_42":43,"_41":437,"_160":25,"_39":438,"_13":162,"_34":35,"_36":439,"_24":25,"_164":-5,"_291":440,"_27":441},{"_44":426,"_32":427,"_30":428,"_158":371,"_42":43,"_41":429,"_160":25,"_39":430,"_13":162,"_34":35,"_36":431,"_24":25,"_164":-5,"_291":432,"_27":433},{"_44":418,"_32":419,"_30":420,"_158":371,"_42":43,"_41":421,"_160":25,"_39":422,"_13":162,"_34":35,"_36":423,"_24":25,"_164":-5,"_291":424,"_27":425},{"_44":410,"_32":411,"_30":412,"_158":371,"_42":43,"_41":413,"_160":25,"_39":414,"_13":162,"_34":35,"_36":415,"_24":25,"_164":-5,"_291":416,"_27":417},{"_44":402,"_32":403,"_30":404,"_158":371,"_42":43,"_41":405,"_160":25,"_39":406,"_13":162,"_34":35,"_36":407,"_24":25,"_164":-5,"_291":408,"_27":409},{"_44":394,"_32":395,"_30":396,"_158":371,"_42":43,"_41":397,"_160":25,"_39":398,"_13":162,"_34":35,"_36":399,"_24":25,"_164":-5,"_291":400,"_27":401},{"_44":386,"_32":387,"_30":388,"_158":371,"_42":43,"_41":389,"_160":25,"_39":390,"_13":162,"_34":35,"_36":391,"_24":25,"_164":-5,"_291":392,"_27":393},{"_44":378,"_32":379,"_30":380,"_158":371,"_42":43,"_41":381,"_160":25,"_39":382,"_13":162,"_34":35,"_36":383,"_24":25,"_164":-5,"_291":384,"_27":385},{"_44":369,"_32":310,"_30":370,"_158":371,"_42":43,"_41":372,"_160":25,"_39":373,"_13":162,"_34":35,"_36":374,"_24":25,"_164":-5,"_291":375,"_27":376},{"_44":360,"_32":361,"_30":362,"_158":209,"_42":43,"_41":363,"_160":59,"_39":364,"_13":365,"_34":20,"_36":366,"_24":25,"_164":-5,"_291":367,"_27":368},{"_44":351,"_32":352,"_30":353,"_158":209,"_42":43,"_41":354,"_160":25,"_39":355,"_13":356,"_34":35,"_36":357,"_24":25,"_164":-5,"_291":358,"_27":359},{"_44":343,"_32":344,"_30":345,"_158":209,"_42":43,"_41":346,"_160":59,"_39":347,"_13":162,"_34":20,"_36":348,"_24":25,"_164":-5,"_291":349,"_27":350},{"_44":201,"_32":202,"_30":203,"_158":-5,"_42":43,"_41":63,"_160":59,"_39":340,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":341,"_27":342},{"_44":335,"_32":326,"_30":320,"_158":203,"_42":43,"_41":336,"_160":25,"_39":337,"_13":162,"_34":205,"_36":-5,"_24":25,"_164":-5,"_291":338,"_27":339},{"_44":327,"_32":328,"_30":329,"_158":320,"_42":43,"_41":330,"_160":25,"_39":331,"_13":162,"_34":35,"_36":332,"_24":25,"_164":-5,"_291":333,"_27":334},{"_44":317,"_32":318,"_30":319,"_158":320,"_42":43,"_41":321,"_160":25,"_39":322,"_13":63,"_34":35,"_36":323,"_24":25,"_164":-5,"_291":324,"_27":325},{"_44":309,"_32":310,"_30":311,"_158":203,"_42":43,"_41":312,"_160":25,"_39":313,"_13":240,"_34":35,"_36":314,"_24":25,"_164":-5,"_291":315,"_27":316},{"_44":195,"_32":196,"_30":197,"_158":-5,"_42":43,"_41":63,"_160":59,"_39":306,"_13":162,"_34":20,"_36":199,"_24":25,"_164":-5,"_291":307,"_27":308},{"_44":188,"_32":189,"_30":190,"_158":-5,"_42":43,"_41":191,"_160":59,"_39":303,"_13":63,"_34":20,"_36":193,"_24":25,"_164":-5,"_291":304,"_27":305},{"_44":181,"_32":182,"_30":183,"_158":-5,"_42":43,"_41":184,"_160":59,"_39":300,"_13":178,"_34":20,"_36":186,"_24":25,"_164":-5,"_291":301,"_27":302},{"_44":173,"_32":174,"_30":175,"_158":-5,"_42":43,"_41":176,"_160":59,"_39":297,"_13":178,"_34":20,"_36":179,"_24":25,"_164":-5,"_291":298,"_27":299},{"_44":166,"_32":167,"_30":168,"_158":-5,"_42":43,"_41":169,"_160":25,"_39":294,"_13":162,"_34":20,"_36":171,"_24":25,"_164":-5,"_291":295,"_27":296},{"_44":155,"_32":156,"_30":157,"_158":-5,"_42":43,"_41":159,"_160":25,"_39":290,"_13":162,"_34":35,"_36":163,"_24":25,"_164":-5,"_291":292,"_27":293},["D",1748717817126],"children",[],[156],["D",1749441030551],[],[167],["D",1749441030650],[],[174],["D",1748493484473],[],[182],["D",1748667949184],[],[189],["D",1748492167939],[],[196],"610dc48a-3e53-11f0-b113-76b3cceeab13","types.ts","1a5b951a-c8ee-4136-bd84-5ec6d4f79ce1",116,["D",1748718827956],"export interface Memory {\n id: string;\n date: string;\n text: string;\n tags: string | null;\n\n // New fields from schema\n createdBy?: string;\n createdDate?: number;\n}\n\n// Kroger OAuth and User types\nexport interface KrogerUser {\n id: string;\n krogerProfileId: string;\n accessToken: string;\n refreshToken: string;\n tokenExpiresAt: number;\n preferredLocationId?: string;\n createdAt: number;\n updatedAt: number;\n}\n\nexport interface Location {\n locationId: string;\n name: string;\n storeNumber: string;\n phone: string;\n address: {\n addressLine1: string;\n addressLine2?: string;\n city: string;\n state: string;\n zipCode: string;\n };\n}\n\nexport interface UserData {\n id: string;\n createdAt: number;\n krogerProfileId: string;\n preferredLocationId?: string;\n preferredLocation?: Location;\n}\n\nexport interface KrogerTokenResponse {\n access_token: string;\n token_type: string;\n expires_in: number;\n refresh_token: string;\n}\n\nexport interface KrogerProfileResponse {\n data: {\n id: string;\n };\n meta: {\n pagination: {\n total: number;\n start: number;\n limit: number;\n };\n warnings: string[];\n };\n}\n\nexport interface Guidance {\n id: string;\n userId: string;\n itemName: string;\n guidance: string;\n createdAt: number;\n updatedAt: number;\n}\n\nexport interface Selection {\n id: string;\n userId: string;\n itemName: string;\n upc: string;\n productName: string;\n createdAt: number;\n updatedAt: number;\n}\n\n// Kroger Location types\nexport interface KrogerLocation {\n locationId: string;\n name: string;\n chain: string;\n storeNumber: string;\n divisionNumber: string;\n address: {\n addressLine1: string;\n addressLine2?: string;\n city: string;\n county: string;\n state: string;\n zipCode: string;\n };\n phone: string;\n geolocation: {\n latLng: string;\n latitude: number;\n longitude: number;\n };\n hours: {\n Open24: boolean;\n gmtOffset: string;\n timezone: string;\n monday?: DayHours;\n tuesday?: DayHours;\n wednesday?: DayHours;\n thursday?: DayHours;\n friday?: DayHours;\n saturday?: DayHours;\n sunday?: DayHours;\n };\n departments: Department[];\n}\n\nexport interface DayHours {\n open: string;\n close: string;\n open24: boolean;\n}\n\nexport interface Department {\n departmentId: string;\n name: string;\n phone: string;\n hours: {\n Open24: boolean;\n monday?: DayHours;\n tuesday?: DayHours;\n wednesday?: DayHours;\n thursday?: DayHours;\n friday?: DayHours;\n saturday?: DayHours;\n sunday?: DayHours;\n };\n}\n\nexport interface KrogerLocationsResponse {\n data: KrogerLocation[];\n meta: {\n pagination: {\n total: number;\n start: number;\n limit: number;\n };\n warnings: string[];\n };\n}\n\nexport interface KrogerLocationResponse {\n data: KrogerLocation;\n}\n",[],[202,310],"bc567b5c-3e53-11f0-91c8-76b3cceeab13","krogerAuth.ts","920830da-3e52-11f0-b740-76b3cceeab13","91edb5d4-3e52-11f0-bd74-76b3cceeab13",120,["D",1748718981100],"import {\n KrogerTokenResponse,\n KrogerProfileResponse,\n KrogerLocationsResponse,\n KrogerLocationResponse,\n} from \"./kroger.ts\";\n\nexport interface IKrogerAuthService {\n isConfigured(): boolean;\n getAuthorizationUrl(state?: string): string;\n exchangeCodeForToken(code: string): Promise;\n refreshToken(refreshToken: string): Promise;\n getUserProfile(accessToken: string): Promise;\n isTokenExpired(expiresAt: number): boolean;\n getValidAccessToken(\n currentToken: string,\n refreshToken: string,\n expiresAt: number\n ): Promise<{\n accessToken: string;\n refreshToken: string;\n expiresIn: number;\n } | null>;\n searchLocationsByZipCode(\n accessToken: string,\n zipCode: string,\n radiusInMiles?: number,\n limit?: number\n ): Promise;\n getLocationById(\n accessToken: string,\n locationId: string\n ): Promise;\n}\n",[],[202,326,318],"types","920d7e32-3e52-11f0-8b96-76b3cceeab13","kroger.ts","920d7f36-3e52-11f0-8b96-76b3cceeab13",112,["D",1748718480667],"export interface KrogerTokenResponse {\n access_token: string;\n refresh_token: string;\n expires_in: number;\n token_type: string;\n}\n\nexport interface KrogerProfileResponse {\n data: {\n id: string;\n email: string;\n firstName: string;\n lastName: string;\n };\n}\n\nexport interface KrogerLocationResponse {\n locationId: string;\n chain: string;\n name: string;\n address: {\n addressLine1: string;\n city: string;\n state: string;\n zipCode: string;\n };\n phone: string;\n hours: {\n monday: { open: string; close: string };\n tuesday: { open: string; close: string };\n wednesday: { open: string; close: string };\n thursday: { open: string; close: string };\n friday: { open: string; close: string };\n saturday: { open: string; close: string };\n sunday: { open: string; close: string };\n };\n}\n\nexport interface KrogerLocationsResponse {\n data: KrogerLocationResponse[];\n meta: {\n pagination: {\n start: number;\n limit: number;\n total: number;\n };\n };\n}\n",[],[202,326,328],"91edb502-3e52-11f0-bd74-76b3cceeab13",110,["D",1748718480492],[281,282],[202,326],["D",1748492167939],[280,283],[202],"e32b79b6-44e4-11f0-826e-76b3cceeab13","style.css","e32b7a7e-44e4-11f0-826e-76b3cceeab13",143,["D",1749441030294],"/* Base styles */\n:root {\n --primary-color: #3b82f6;\n --secondary-color: #1e40af;\n --background-color: #f3f4f6;\n --text-color: #1f2937;\n --border-color: #e5e7eb;\n}\n\nbody {\n margin: 0;\n padding: 0;\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen,\n Ubuntu, Cantarell, \"Open Sans\", \"Helvetica Neue\", sans-serif;\n background-color: var(--background-color);\n color: var(--text-color);\n}\n\n/* Button styles */\n.btn {\n display: inline-block;\n padding: 0.5rem 1rem;\n border-radius: 0.375rem;\n font-weight: 500;\n text-align: center;\n cursor: pointer;\n transition: all 0.2s;\n}\n\n.btn-primary {\n background-color: var(--primary-color);\n color: white;\n border: none;\n}\n\n.btn-primary:hover {\n background-color: var(--secondary-color);\n}\n\n/* Card styles */\n.card {\n background-color: white;\n border-radius: 0.5rem;\n box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);\n padding: 1rem;\n margin: 1rem 0;\n}\n\n/* Form styles */\n.form-input {\n width: 100%;\n padding: 0.5rem;\n border: 1px solid var(--border-color);\n border-radius: 0.375rem;\n margin-bottom: 1rem;\n}\n\n/* Layout styles */\n.container {\n max-width: 1200px;\n margin: 0 auto;\n padding: 1rem;\n}\n\n.flex {\n display: flex;\n}\n\n.flex-col {\n flex-direction: column;\n}\n\n.items-center {\n align-items: center;\n}\n\n.justify-between {\n justify-content: space-between;\n}\n\n.gap-4 {\n gap: 1rem;\n}\n\n/* Text styles */\n.text-center {\n text-align: center;\n}\n\n.text-lg {\n font-size: 1.125rem;\n}\n\n.font-bold {\n font-weight: 700;\n}\n\n/* Margin and padding utilities */\n.m-4 {\n margin: 1rem;\n}\n\n.p-4 {\n padding: 1rem;\n}\n\n.mt-4 {\n margin-top: 1rem;\n}\n\n.mb-4 {\n margin-bottom: 1rem;\n}\n\n/* Grid styles */\n.grid {\n display: grid;\n gap: 1rem;\n}\n\n.grid-cols-2 {\n grid-template-columns: repeat(2, 1fr);\n}\n\n@media (max-width: 768px) {\n .grid-cols-2 {\n grid-template-columns: 1fr;\n }\n}\n",[],[208,344],"e35f534e-44e4-11f0-afb0-76b3cceeab13","index.tsx","0689c556-3e51-11f0-9b71-76b3cceeab13",151,["D",1749441030568],12,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client?deps=react@18.2.0\";\nimport { LoginPage } from \"./components/LoginPage.tsx\";\nimport { Dashboard } from \"./components/Dashboard.tsx\";\n\nfunction App(): JSX.Element {\n const userData = (window as any).__USER_DATA__;\n return userData ? : ;\n}\n\n// Initialize the app\nconst root = createRoot(document.getElementById(\"app\")!);\nroot.render();\n",[],[208,352],"425ee2e6-3e51-11f0-9b68-76b3cceeab13","index.html","9dba240a-3c46-11f0-b3a3-9e149126039e",100,["D",1748717917515],16,"\n\n \n \n \n Personal Shopper - Kroger Integration\n \n \n\n \n \n

\n \n \n\n",[],[208,361],"e312bade-44e4-11f0-bb93-76b3cceeab13","e312bb92-44e4-11f0-bb93-76b3cceeab13","e2d14b4e-44e4-11f0-8fe0-76b3cceeab13",139,["D",1749441030130],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { ReactNode } from \"https://esm.sh/react@18.2.0\";\nimport { UserData, Location } from \"../../shared/types.ts\";\n\nexport interface DashboardCardProps {\n title: string;\n count: string | number;\n icon: ReactNode;\n actionText: string;\n onAction: () => void;\n}\n\nexport interface NavbarProps {\n userData: UserData;\n}\n\nexport interface DashboardProps {\n userData: UserData;\n}\n\nexport interface LocationSearchProps {\n onLocationSelected?: () => void;\n}\n\nexport interface CurrentLocationIndicatorProps {\n location: Location | null;\n onClick: () => void;\n}\n",[],[208,377,310],"components","e31edd32-44e4-11f0-be29-76b3cceeab13","ShoppingListCreator.tsx","e31ede04-44e4-11f0-be29-76b3cceeab13",141,["D",1749441030212],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useState } from \"https://esm.sh/react@18.2.0\";\n\nexport function ShoppingListCreator(): JSX.Element {\n const [currentItem, setCurrentItem] = useState(\"\");\n const [items, setItems] = useState([]);\n\n const handleInputChange = (e: React.ChangeEvent) => {\n setCurrentItem(e.target.value);\n };\n\n const addItem = () => {\n const trimmedItem = currentItem.trim();\n if (trimmedItem && !items.includes(trimmedItem)) {\n setItems([...items, trimmedItem]);\n setCurrentItem(\"\");\n }\n };\n\n const handleKeyPress = (e: React.KeyboardEvent) => {\n if (e.key === \"Enter\") {\n e.preventDefault();\n addItem();\n }\n };\n\n const removeItem = (indexToRemove: number) => {\n setItems(items.filter((_, index) => index !== indexToRemove));\n };\n\n const clearAll = () => {\n setItems([]);\n };\n\n return (\n

\n Create Shopping List\n

\n\n {/* Add Item Input */}\n

\n \n \n Add\n \n

\n\n {/* Shopping List */}\n {items.length > 0 && (\n

\n Shopping List ({items.length} items)\n

\n \n Clear all\n \n

\n\n

\n {item}\n removeItem(index)}\n className=\"text-red-600 hover:text-red-800 text-sm font-medium\"\n aria-label={`Remove ${item}`}\n >\n ✕\n \n \n ))}\n

\n )}\n\n {/* Empty State */}\n {items.length === 0 && (\n

No items added yet.

\n Type an item above and press Enter or click Add.\n

\n )}\n\n {/* Process Button */}\n {items.length > 0 && (\n

\n alert(\"Shopping list processing coming soon!\")}\n className=\"inline-flex items-center px-4 py-2 border border-transparent text-sm font-medium rounded-md shadow-sm text-white bg-green-600 hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500\"\n >\n Process List ({items.length} items)\n \n

\n )}\n

\n );\n}\n",[],[208,377,379],"e3270aac-44e4-11f0-afb0-76b3cceeab13","Navbar.stories.tsx","e3270b88-44e4-11f0-afb0-76b3cceeab13",142,["D",1749441029826],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport type { Meta, StoryObj } from \"@storybook/react\";\nimport { Navbar } from \"./Navbar.tsx\";\n\nconst meta = {\n title: \"Components/Navbar\",\n component: Navbar,\n parameters: {\n layout: \"fullscreen\",\n },\n tags: [\"autodocs\"],\n} satisfies Meta;\n\nexport default meta;\ntype Story = StoryObj;\n\nexport const Default: Story = {\n args: {\n userData: {\n krogerProfileId: \"12345\",\n preferredLocationId: \"67890\",\n preferredLocation: {\n locationId: \"67890\",\n name: \"Kroger Marketplace\",\n storeNumber: \"123\",\n phone: \"555-0123\",\n address: {\n addressLine1: \"123 Main St\",\n addressLine2: \"Suite 100\",\n city: \"Cincinnati\",\n state: \"OH\",\n zipCode: \"45202\",\n },\n },\n },\n },\n};\n",[],[208,377,387],"e2fb36ac-44e4-11f0-819e-76b3cceeab13","LoginPage.tsx","e2fb376a-44e4-11f0-819e-76b3cceeab13",136,["D",1749441029816],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nexport function LoginPage(): JSX.Element {\n return (\n

\n Personal Shopper\n

\n AI-powered grocery shopping with Kroger\n

\n Sign in with Kroger\n

\n Connect your Kroger account to start building your personalized\n shopping experience.\n

\n (window.location.href = \"/auth/login\")}\n className=\"group relative w-full flex justify-center py-2 px-4 border border-transparent text-sm font-medium rounded-md text-white bg-blue-600 hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500\"\n >\n \n \n \n Connect with Kroger\n \n

\n );\n}\n",[],[208,377,395],"e2e5de56-44e4-11f0-937c-76b3cceeab13","LoginPage.stories.tsx","e2e5deec-44e4-11f0-937c-76b3cceeab13",134,["D",1749441029826],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport type { Meta, StoryObj } from \"@storybook/react\";\nimport { LoginPage } from \"./LoginPage.tsx\";\n\nconst meta = {\n title: \"Components/LoginPage\",\n component: LoginPage,\n parameters: {\n layout: \"fullscreen\",\n },\n tags: [\"autodocs\"],\n} satisfies Meta;\n\nexport default meta;\ntype Story = StoryObj;\n\nexport const Default: Story = {\n args: {},\n};\n",[],[208,377,403],"e32edcfa-44e4-11f0-91f2-76b3cceeab13","LocationSearch.tsx","e32edf16-44e4-11f0-91f2-76b3cceeab13",144,["D",1749441030281],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState } from \"https://esm.sh/react@18.2.0\";\nimport { LocationSearchProps } from \"./types.ts\";\nimport { Location } from \"../../shared/types.ts\";\n\nexport function LocationSearch({\n onLocationSelected,\n}: LocationSearchProps): JSX.Element {\n const [zipCode, setZipCode] = useState(\"\");\n const [locations, setLocations] = useState([]);\n const [isLoading, setIsLoading] = useState(false);\n const [showResults, setShowResults] = useState(false);\n\n const handleSearch = async (): Promise => {\n if (!zipCode.trim()) {\n alert(\"Please enter a zip code\");\n return;\n }\n\n setIsLoading(true);\n setShowResults(false);\n\n try {\n const response = await fetch(\n `/api/locations/search?zipCode=${encodeURIComponent(\n zipCode\n )}&radius=25&limit=10`\n );\n const data = await response.json();\n\n if (!response.ok) {\n throw new Error(data.error || \"Failed to search locations\");\n }\n\n setLocations(data.data);\n setShowResults(true);\n } catch (error) {\n console.error(\"Error searching locations:\", error);\n alert(\"Error searching for locations: \" + (error as Error).message);\n } finally {\n setIsLoading(false);\n }\n };\n\n const handleSelectLocation = async (location: Location): Promise => {\n try {\n const response = await fetch(\"/api/user/location\", {\n method: \"PUT\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({ locationId: location.locationId }),\n });\n\n if (response.ok) {\n setZipCode(\"\");\n setShowResults(false);\n alert(\"Store location updated successfully!\");\n if (onLocationSelected) {\n onLocationSelected();\n }\n window.location.reload(); // Refresh to update the current location display\n } else {\n const data = await response.json();\n alert(\"Failed to update location: \" + (data.error || \"Unknown error\"));\n }\n } catch (error) {\n console.error(\"Error updating location:\", error);\n alert(\"Error updating location: \" + (error as Error).message);\n }\n };\n\n return (\n

\n Store Location\n

Search for your preferred Kroger store location by zip code.

\n\n

\n \n Search by Zip Code\n \n

\n ) =>\n setZipCode(e.target.value)\n }\n placeholder=\"Enter zip code (e.g., 45044)\"\n className=\"flex-1 block border-gray-300 rounded-md shadow-sm focus:ring-blue-500 focus:border-blue-500 sm:text-sm\"\n />\n \n \n \n \n Search\n \n

\n\n {isLoading && (\n

\n \n \n \n \n \n Searching for locations...\n \n

\n )}\n\n {showResults && (\n

\n Search Results\n

\n {locations.length === 0 ? (\n

\n \n \n \n \n

No locations found for this zip code

\n ) : (\n locations.map((location) => (\n handleSelectLocation(location)}\n >\n

\n {location.name}\n

\n {location.address.addressLine1}\n {location.address.addressLine2\n ? `, ${location.address.addressLine2}`\n : \"\"}\n

\n {location.address.city}, {location.address.state}{\" \"}\n {location.address.zipCode}\n

\n Store #{location.storeNumber} • {location.phone}\n

\n \n

\n ))\n )}\n

\n )}\n

\n \n );\n}\n",[],[208,377,411],"e3093bc6-44e4-11f0-8fe0-76b3cceeab13","DashboardCard.tsx","e3093d88-44e4-11f0-8fe0-76b3cceeab13",137,["D",1749441030063],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { DashboardCardProps } from \"./types.ts\";\n\nexport function DashboardCard({\n title,\n count,\n icon,\n actionText,\n onAction,\n}: DashboardCardProps): JSX.Element {\n return (\n

{icon}

\n {title}\n: {count}

\n \n {actionText} →\n \n

\n );\n}\n",[],[208,377,419],"e30ee530-44e4-11f0-9f8f-76b3cceeab13","DashboardCard.stories.tsx","e30ee620-44e4-11f0-9f8f-76b3cceeab13",138,["D",1749441030065],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport type { Meta, StoryObj } from \"@storybook/react\";\nimport { DashboardCard } from \"./DashboardCard.tsx\";\n\nconst meta = {\n title: \"Components/DashboardCard\",\n component: DashboardCard,\n parameters: {\n layout: \"centered\",\n },\n tags: [\"autodocs\"],\n} satisfies Meta;\n\nexport default meta;\ntype Story = StoryObj;\n\nexport const Default: Story = {\n args: {\n title: \"Preferences\",\n count: \"5 items\",\n icon: (\n \n \n \n \n ),\n actionText: \"Manage preferences\",\n onAction: () => alert(\"Action clicked!\"),\n },\n};\n\nexport const WithZeroCount: Story = {\n args: {\n ...Default.args,\n count: \"0 items\",\n },\n};\n\nexport const WithLargeCount: Story = {\n args: {\n ...Default.args,\n count: \"1,234 items\",\n },\n};\n",[],[208,377,427],"e2f7eb3c-44e4-11f0-b4e2-76b3cceeab13","Dashboard.tsx","e2f7ebfa-44e4-11f0-b4e2-76b3cceeab13",135,["D",1749441029921],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState, useEffect } from \"https://esm.sh/react@18.2.0\";\nimport { DashboardProps } from \"./types.ts\";\nimport { Location } from \"../../shared/types.ts\";\nimport { Navbar } from \"./Navbar.tsx\";\nimport { DashboardCard } from \"./DashboardCard.tsx\";\nimport { LocationSearch } from \"./LocationSearch.tsx\";\nimport { CurrentLocationIndicator } from \"./CurrentLocationIndicator.tsx\";\nimport { ShoppingListCreator } from \"./ShoppingListCreator.tsx\";\n\nexport function Dashboard({ userData }: DashboardProps): JSX.Element {\n const [guidanceCount, setGuidanceCount] = useState(\"Loading...\");\n const [selectionsCount, setSelectionsCount] = useState(\"Loading...\");\n const [currentLocation, setCurrentLocation] = useState(\n userData.preferredLocation || null\n );\n const [showLocationPicker, setShowLocationPicker] = useState(\n !userData.preferredLocation\n );\n\n useEffect(() => {\n const loadCounts = async (): Promise => {\n try {\n const [guidanceResponse, selectionsResponse] = await Promise.all([\n fetch(\"/api/guidance\"),\n fetch(\"/api/selections\"),\n ]);\n\n const guidance = await guidanceResponse.json();\n const selections = await selectionsResponse.json();\n\n setGuidanceCount(guidance.length.toString());\n setSelectionsCount(selections.length.toString());\n } catch (error) {\n console.error(\"Error loading counts:\", error);\n setGuidanceCount(\"Error\");\n setSelectionsCount(\"Error\");\n }\n };\n\n const loadCurrentLocation = async (): Promise => {\n if (\n userData.preferredLocationId !== userData.preferredLocation?.locationId\n ) {\n try {\n const response = await fetch(\n `/api/locations/${userData.preferredLocationId}`\n );\n if (response.ok) {\n const data = await response.json();\n setCurrentLocation(data.data);\n }\n } catch (error) {\n console.error(\"Error loading current location details:\", error);\n }\n }\n };\n\n loadCounts();\n loadCurrentLocation();\n }, [userData.preferredLocationId]);\n\n const handleLocationIndicatorClick = (): void => {\n setShowLocationPicker(!showLocationPicker);\n };\n\n const handleLocationSelected = (): void => {\n setShowLocationPicker(false);\n };\n\n return (\n

\n \n

\n {/* Location indicator - always visible */}\n

\n \n

\n\n {/* Location picker - only show when no location selected OR when clicked */}\n {showLocationPicker && (\n

\n \n

\n )}\n\n {/* Shopping List Creator - Full Width */}\n

\n \n

\n\n {/* Dashboard Cards */}\n

\n \n \n \n \n }\n actionText=\"Manage preferences\"\n onAction={() => alert(\"Guidance management coming soon!\")}\n />\n \n \n \n }\n actionText=\"View selections\"\n onAction={() => alert(\"Selections management coming soon!\")}\n />\n

\n );\n}\n",[],[208,377,435],"e31b2390-44e4-11f0-b4ed-76b3cceeab13","CurrentLocationIndicator.tsx","e31b244e-44e4-11f0-b4ed-76b3cceeab13",140,["D",1749441030187],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { CurrentLocationIndicatorProps } from \"./types.ts\";\n\nexport function CurrentLocationIndicator({\n location,\n onClick,\n}: CurrentLocationIndicatorProps): JSX.Element {\n if (!location) {\n return (\n \n

\n \n \n \n

\n No store location selected\n

Click to select a store

\n \n );\n }\n\n const address = `${location.address.addressLine1}, ${location.address.city}, ${location.address.state} ${location.address.zipCode}`;\n\n return (\n \n

\n \n \n \n

{location.name}

{address}

\n \n \n \n

\n \n );\n}\n",[],[208,377,443],"e2e228ba-44e4-11f0-b914-76b3cceeab13","CurrentLocationIndicator.stories.tsx","e2e22996-44e4-11f0-b914-76b3cceeab13",133,["D",1749441029813],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport type { Meta, StoryObj } from \"@storybook/react\";\nimport { CurrentLocationIndicator } from \"./CurrentLocationIndicator.tsx\";\n\nconst meta = {\n title: \"Components/CurrentLocationIndicator\",\n component: CurrentLocationIndicator,\n parameters: {\n layout: \"centered\",\n },\n tags: [\"autodocs\"],\n} satisfies Meta;\n\nexport default meta;\ntype Story = StoryObj;\n\nexport const NoLocation: Story = {\n args: {\n location: null,\n onClick: () => alert(\"Location indicator clicked!\"),\n },\n};\n\nexport const WithLocation: Story = {\n args: {\n location: {\n locationId: \"123\",\n name: \"Kroger Marketplace\",\n storeNumber: \"123\",\n phone: \"555-0123\",\n address: {\n addressLine1: \"123 Main St\",\n addressLine2: \"Suite 100\",\n city: \"Cincinnati\",\n state: \"OH\",\n zipCode: \"45202\",\n },\n },\n onClick: () => alert(\"Location indicator clicked!\"),\n },\n};\n",[],[208,377,451],"e2d14a4a-44e4-11f0-8fe0-76b3cceeab13",132,["D",1749441029702],[265,266,267,268,269,270,271,272,273,274,275],[208,377],["D",1748493443987],[264,276,277,278],[208],"f60d64be-3c46-11f0-b3c0-9e149126039e","oauth-setup.md","f60d65a4-3c46-11f0-b3c0-9e149126039e",36,["D",1748493592189],"# Kroger OAuth Setup Guide\n\nThis guide walks you through setting up Kroger OAuth authentication for the Personal Shopper application.\n\n## Prerequisites\n\n1. **Kroger Developer Account**: You need to register as a developer with Kroger\n2. **Val Town Account**: Your application should be deployed on Val Town\n\n## Step 1: Register with Kroger Developer Portal\n\n1. Visit the [Kroger Developer Portal](https://developer.kroger.com/)\n2. Create an account or sign in\n3. Create a new application\n4. Note down your `Client ID` and `Client Secret`\n\n## Step 2: Configure Redirect URI\n\nIn your Kroger application settings, set the redirect URI to:\n```\nhttps://your-val-name.web.val.run/auth/callback\n```\n\nReplace `your-val-name` with your actual Val Town username and val name.\n\n## Step 3: Set Environment Variables\n\nIn your Val Town environment, set these variables:\n\n### Required Variables\n\n- **KROGER_CLIENT_ID**: Your Kroger application's client ID\n- **KROGER_CLIENT_SECRET**: Your Kroger application's client secret \n- **KROGER_REDIRECT_URI**: The redirect URI you registered (e.g., `https://your-val-name.web.val.run/auth/callback`)\n\n### How to Set Environment Variables in Val Town\n\n1. Go to your Val Town dashboard\n2. Click on your val\n3. Go to the \"Environment\" tab\n4. Add the three variables listed above\n\n## Step 4: Test the OAuth Flow\n\n1. Visit your application URL\n2. Click \"Connect with Kroger\"\n3. You should be redirected to Kroger's login page\n4. After logging in and authorizing, you'll be redirected back to your app\n\n## OAuth Flow Details\n\n### 1. Authorization Request\nWhen a user clicks \"Connect with Kroger\", they're redirected to:\n```\nhttps://api.kroger.com/v1/connect/oauth2/authorize?\n client_id=YOUR_CLIENT_ID&\n redirect_uri=YOUR_REDIRECT_URI&\n response_type=code&\n scope=profile.compact cart.basic:write product.compact&\n state=RANDOM_STATE_STRING\n```\n\n### 2. Authorization Callback\nKroger redirects back to your callback URL with:\n- `code`: Authorization code to exchange for tokens\n- `state`: The same state value you sent (for security)\n\n### 3. Token Exchange\nYour app exchanges the authorization code for:\n- `access_token`: Used to make API calls on behalf of the user\n- `refresh_token`: Used to get new access tokens when they expire\n- `expires_in`: How long the access token is valid (in seconds)\n\n### 4. Profile Retrieval\nYour app uses the access token to get the user's Kroger profile ID from:\n```\nGET https://api.kroger.com/v1/identity/profile\nAuthorization: Bearer ACCESS_TOKEN\n```\n\n### 5. User Session\nThe app creates a local user record and sets a session cookie for future requests.\n\n## Scopes Requested\n\nThe application requests these OAuth scopes:\n\n- **profile.compact**: Access to user's basic profile information\n- **cart.basic:write**: Ability to add items to the user's cart\n- **product.compact**: Access to search products in the catalog\n\n## Security Features\n\n- **State Parameter**: Prevents CSRF attacks during OAuth flow\n- **HTTP-Only Cookies**: Session cookies are not accessible via JavaScript\n- **Token Refresh**: Automatic refresh of expired access tokens\n- **Secure Storage**: Tokens are stored securely in the database\n\n## Troubleshooting\n\n### \"OAuth not configured\" Error\n- Ensure all three environment variables are set correctly\n- Check that there are no extra spaces in the variable values\n\n### \"Invalid redirect URI\" Error\n- Verify the redirect URI in Kroger's developer portal matches exactly\n- Ensure you're using HTTPS (required by Kroger)\n\n### \"Invalid client\" Error\n- Double-check your client ID and secret\n- Ensure your Kroger application is active\n\n### Token Refresh Issues\n- The app automatically handles token refresh\n- If refresh fails, users will need to re-authenticate\n\n## API Endpoints\n\nOnce OAuth is configured, these endpoints become available:\n\n### Authentication\n- `GET /auth/login` - Start OAuth flow\n- `GET /auth/callback` - Handle OAuth callback\n- `POST /auth/logout` - End user session\n\n### User Management\n- `GET /api/user` - Get current user info\n- `PUT /api/user/location` - Update preferred store location\n\n### Data Management\n- `GET /api/guidance` - Get user's shopping preferences\n- `POST /api/guidance` - Add new preference\n- `GET /api/selections` - Get user's saved product selections\n- `POST /api/selections` - Save new product selection\n\n## Next Steps\n\nAfter OAuth is working:\n\n1. **Test the full flow** with a real Kroger account\n2. **Implement product search** using the Kroger Products API\n3. **Add cart management** using the Kroger Cart API\n4. **Integrate AI/LLM** for intelligent product selection\n5. **Build the shopping list interface**\n\n## Support\n\nFor Kroger API issues:\n- [Kroger Developer Documentation](https://developer.kroger.com/documentation)\n- [Kroger Developer Support](https://developer.kroger.com/support)\n\nFor Val Town issues:\n- [Val Town Documentation](https://docs.val.town/)\n- [Val Town Discord](https://discord.gg/dHv45uN5RY)",[],[214,467],"52278bf0-3c45-11f0-9e79-9e149126039e","kroger-products.md","4bd7b4aa-3c45-11f0-8122-9e149126039e",13,["D",1748492887714],3,"## Products API (1.2.4)\n\nThe Products API allows you to search the Kroger product catalog.\n\n### Rate Limit\n\nThe Public Products API has a 10,000 call per day rate limit.\n\nFor all Public APIs, we enforce the rate limit by the number of calls the client makes to the endpoint, not individual API operations. This means you can distribute the 10,000 calls across all API operations using the /products endpoint as you see fit.\n\n### Pagination\n\nThe Product Search operation supports pagination with a default value of 10 results per page. Using the following parameters, you can extend and skip results in the response:\n\n- `filter.limit` - Sets a limit on the number of products returned.\n- `filter.start` - Sets a number of results to skip in the response.\n\nNote: Since searching by a term acts as a fuzzy search, the order of the results can change with each new request.\n\n### API Operations\n\nThe Products API supports the following operations:\n\n| Name | Method | Description |\n| --------------- | ------ | ----------------------------------------------------------------------------- |\n| Product search | GET | Allows you to find products by passing in either a search term or product Id. |\n| Product details | GET | Returns product details for a specific product. |\n\n### Additional Response Data\n\nTo return the following data from the /products endpoint, you must include a locationId in the request. All operations for the products endpoint accept the filter.locationId query parameter.\n\n### Price\n\nReturns the following price objects:\n\nprice - Includes both the regular price of the item and the promo price of the item.\nnationalPrice - Includes both the regular national price of the item and the national promo price of the item.\n\nNote: Seasonal products only return a price when available. Some items may not have a national prices available.\n\n### Fulfillment Type\n\nReturns the following boolean objects to indicate an item's fulfillment availability:\n\ninstore - The item is sold in store at the given location.\nshiptohome - The item is available to be shipped to home.\ndelivery - The item is available for delivery from the given location.\ncurbside - The item is available for curbside pickup from the given location.\n\nNote: The instore fulfillment type only indicated that the item is sold by the given location, not that it is in stock.\n\n### Aisle Locations\n\nReturns the aisle locations of the item for the given location.\n\n### Inventory\n\nReturns the stockLevel of the item. This property is omitted when unavailable:\n\nHIGH - The stock level is high.\nLOW - The stock level is low.\nTEMPORARILY_OUT_OF_STOCK - The item is temporarily out of stock.\n\n## Example\n\n### /v1/products\n\n```sh\ncurl -X GET \\\n 'https://api.kroger.com/v1/products?filter.brand={{BRAND}}&filter.term={{TERM}}&filter.locationId={{LOCATION_ID}}' \\\n -H 'Accept: application/json' \\\n -H 'Authorization: Bearer {{TOKEN}}'\n```\n\n```json\n{\n \"data\": [\n {\n \"productId\": \"0001111041700\",\n \"productPageURI\": \"/p/kroger-2-reduced-fat-milk/0001111041700?cid=dis.api.tpi_products-api_20240521_b:all_c:p_t:\",\n \"aisleLocations\": [\n {\n \"bayNumber\": \"13\",\n \"description\": \"Aisle 35\",\n \"number\": \"35\",\n \"numberOfFacings\": \"5\",\n \"sequenceNumber\": \"3\",\n \"side\": \"L\",\n \"shelfNumber\": \"2\",\n \"shelfPositionInBay\": \"1\"\n }\n ],\n \"brand\": \"Kroger\",\n \"categories\": [\"Dairy\"],\n \"countryOrigin\": \"United States\",\n \"description\": \"Kroger 2% Reduced Fat Milk\",\n \"items\": [\n {\n \"itemId\": \"0001111041700\",\n \"inventory\": {\n \"stockLevel\": \"HIGH\"\n },\n \"favorite\": true,\n \"fulfillment\": {\n \"curbside\": true,\n \"delivery\": true,\n \"instore\": true,\n \"shiptohome\": true\n },\n \"price\": {\n \"regular\": 1.99,\n \"promo\": 1.59,\n \"regularPerUnitEstimate\": 1.99,\n \"promoPerUnitEstimate\": 1.59\n },\n \"nationalPrice\": {\n \"regular\": 1.99,\n \"promo\": 1.59,\n \"regularPerUnitEstimate\": 1.99,\n \"promoPerUnitEstimate\": 1.59\n },\n \"size\": \"1 gal\",\n \"soldBy\": \"unit\"\n }\n ],\n \"itemInformation\": {\n \"depth\": \"3.5\",\n \"height\": \"2.0\",\n \"width\": \"4.75\"\n },\n \"temperature\": {\n \"indicator\": \"Refrigerated\",\n \"heatSensitive\": true\n },\n \"images\": [\n {\n \"id\": \"string\",\n \"perspective\": \"front\",\n \"default\": true,\n \"sizes\": [\n {\n \"id\": \"7df2d0a3-8349-44d4-9512-1dab89e675a9\",\n \"size\": \"medium\",\n \"url\": \"https://www.kroger.com/product/images/medium/front/0001111041700\"\n }\n ]\n }\n ],\n \"upc\": \"0001111041700\"\n }\n ],\n \"meta\": {}\n}\n```\n\n### /v1/products/{productId}\n\n```sh\ncurl -X GET \\\n 'https://api.kroger.com/v1/products/{{ID}}?filter.locationId={{LOCATION_ID}}' \\\n -H 'Accept: application/json' \\\n -H 'Authorization: Bearer {{TOKEN}}'\n```\n\n```json\n{\n \"data\": {\n \"productId\": \"0001111041700\",\n \"productPageURI\": \"/p/kroger-2-reduced-fat-milk/0001111041700?cid=dis.api.tpi_products-api_20240521_b:all_c:p_t:\",\n \"aisleLocations\": [\n {\n \"bayNumber\": \"13\",\n \"description\": \"Aisle 35\",\n \"number\": \"35\",\n \"numberOfFacings\": \"5\",\n \"sequenceNumber\": \"3\",\n \"side\": \"L\",\n \"shelfNumber\": \"2\",\n \"shelfPositionInBay\": \"1\"\n }\n ],\n \"brand\": \"Kroger\",\n \"categories\": [\"Dairy\"],\n \"countryOrigin\": \"United States\",\n \"description\": \"Kroger 2% Reduced Fat Milk\",\n \"items\": [\n {\n \"itemId\": \"0001111041700\",\n \"inventory\": {\n \"stockLevel\": \"HIGH\"\n },\n \"favorite\": true,\n \"fulfillment\": {\n \"curbside\": true,\n \"delivery\": true,\n \"instore\": true,\n \"shiptohome\": true\n },\n \"price\": {\n \"regular\": 1.99,\n \"promo\": 1.59,\n \"regularPerUnitEstimate\": 1.99,\n \"promoPerUnitEstimate\": 1.59\n },\n \"nationalPrice\": {\n \"regular\": 1.99,\n \"promo\": 1.59,\n \"regularPerUnitEstimate\": 1.99,\n \"promoPerUnitEstimate\": 1.59\n },\n \"size\": \"1 gal\",\n \"soldBy\": \"unit\"\n }\n ],\n \"itemInformation\": {\n \"depth\": \"3.5\",\n \"height\": \"2.0\",\n \"width\": \"4.75\"\n },\n \"temperature\": {\n \"indicator\": \"Refrigerated\",\n \"heatSensitive\": true\n },\n \"images\": [\n {\n \"id\": \"string\",\n \"perspective\": \"front\",\n \"default\": true,\n \"sizes\": [\n {\n \"id\": \"7df2d0a3-8349-44d4-9512-1dab89e675a9\",\n \"size\": \"medium\",\n \"url\": \"https://www.kroger.com/product/images/medium/front/0001111041700\"\n }\n ]\n }\n ],\n \"upc\": \"0001111041700\"\n },\n \"meta\": {}\n}\n```",[],[214,475],"eada0650-3ddc-11f0-8008-76b3cceeab13","kroger-location.md","895a3096-3dda-11f0-9c21-76b3cceeab13",85,["D",1748667949063],"# Kroger Locations\n\n## Locations\n\n### GET /v1/locations\n\n#### Request\n\nProvides access to a list of locations. If the parameter filter.chain is not provided, the results include all locations and chains owned by The Kroger Co.\nYou may include one of the following parameters to narrow search results within a geographic area:\n\n- `filter.zipCode.near`\n- `filter.latLong.near`\n- `filter.lat.near` and `filter.lon.near`\n\n#### Parameters\n\n- `filter.zipCode.near`\n\n - Description: The zip code to use as a starting point for results.\n - Example: `45044`\n - Type: `string`\n - Required: `false`\n - Query: `filter.zipCode.near`\n\n- `filter.latLong.near`\n\n - Description: The latitude and longitude to use as a starting point for results.\n - Example: `filter.latLong.near=39.306346,-84.278902`\n - Type: `string`\n - Required: `false`\n - Query: `filter.latLong.near`\n\n- `filter.lat.near` and `filter.lon.near`\n\n - Description: The latitude and longitude to use as a starting point for results.\n - Example: `filter.lat.near=39.306346&filter.lon.near=-84.278902`\n - Type: `string`\n - Required: `false`\n - Query: `filter.lat.near` and `filter.lon.near`\n\n- `filter.radiusInMiles`\n\n - Description: The mile radius of results. This will be ignored if you do not use one of the 3 starting point filters (zipCode, latLong, or lat and lon).\n - Example: `10`\n - Type: `integer`\n - Required: `false`\n - Query: `filter.radiusInMiles`\n\n- `filter.limit`\n - Description: The number of results to return.\n - Example: `10`\n - Type: `integer`\n - Required: `false`\n - Query: `filter.limit`\n\n10\n\n- `filter.chain`\n - Description: The chain name of the chain. When using this filter, only stores matching the provided chain name are returned.\n - Example: `Kroger`\n - Type: `string`\n - Required: `false`\n - Query: `filter.chain`\n\nExample : Kroger\n\n- `filter.department`\n\n - Description: The departmentId of the department. Lists must be comma-separated. When using this filter, only stores that have all of the departments provided are returned.\n - Example: `13`\n - Type: `string`\n - Required: `false`\n - Query: `filter.department`\n\n- `filter.locationId`\n - Description: Comma-separated list of locationIds.\n - Example: `01400390`\n - Type: `string`\n - Required: `false`\n - Query: `filter.locationId`\n\n#### Responses\n\n- `200`\n - Description: OK\n - Links: None\n\nOK\n\n#### Media type\n\n- `application/json`\n - Controls Accept header.\n\n#### Example Value\n\n```json\n{\n \"data\": [\n {\n \"address\": {\n \"addressLine1\": \"2900 W. St. Rt. 22 & 3\",\n \"addressLine2\": \"\",\n \"city\": \"Maineville\",\n \"county\": \"WARREN COUNTY\",\n \"state\": \"OH\",\n \"zipCode\": \"45039\"\n },\n \"chain\": \"KROGER\",\n \"phone\": \"5551234567\",\n \"departments\": [\n {\n \"departmentId\": \"01\",\n \"name\": \"Drug & General Merchandise\",\n \"phone\": \"5551234567\",\n \"hours\": {\n \"Open24\": false,\n \"monday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"tuesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"wednesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"thursday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"friday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"saturday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"sunday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n }\n }\n }\n ],\n \"geolocation\": {\n \"latLng\": \"39.3110881,-84.2751167\",\n \"latitude\": 39.3110881,\n \"longitude\": -84.2751167\n },\n \"hours\": {\n \"Open24\": true,\n \"gmtOffset\": \"(UTC-05:00) Eastern Time (US Canada)\",\n \"timezone\": \"America/New_York\",\n \"friday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"monday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"saturday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"sunday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"thursday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"tuesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"wednesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n }\n },\n \"locationId\": \"01400376\",\n \"storeNumber\": \"00376\",\n \"divisionNumber\": \"014\",\n \"name\": \"Kroger Landen\"\n }\n ],\n \"meta\": {\n \"pagination\": {\n \"total\": 0,\n \"start\": 0,\n \"limit\": 0\n },\n \"warnings\": [\"string\"]\n }\n}\n```\n\n### GET /v1/locations/{locationId}\n\n#### Request\n\nProvides access to the details of a specific location by using the locationId.\n\n#### Parameters\n\n- `locationId`\n - Description: The locationId of the store.\n - Example: `01400943`\n - Type: `string`\n - Required: `true`\n - Query: `locationId`\n\n#### Responses\n\n- `200`\n - Description: OK\n - Links: None\n\n01400943\n\n#### Media type\n\n- `application/json`\n - Controls Accept header.\n\n#### Example Value\n\n```json\n{\n \"data\": {\n \"address\": {\n \"addressLine1\": \"2900 W. St. Rt. 22 & 3\",\n \"addressLine2\": \"\",\n \"city\": \"Maineville\",\n \"county\": \"WARREN COUNTY\",\n \"state\": \"OH\",\n \"zipCode\": \"45039\"\n },\n \"chain\": \"KROGER\",\n \"phone\": \"5551234567\",\n \"departments\": [\n {\n \"departmentId\": \"01\",\n \"name\": \"Drug & General Merchandise\",\n \"phone\": \"5551234567\",\n \"hours\": {\n \"Open24\": false,\n \"monday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"tuesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"wednesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"thursday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"friday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"saturday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"sunday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n }\n }\n }\n ],\n \"geolocation\": {\n \"latLng\": \"39.3110881,-84.2751167\",\n \"latitude\": 39.3110881,\n \"longitude\": -84.2751167\n },\n \"hours\": {\n \"Open24\": true,\n \"gmtOffset\": \"(UTC-05:00) Eastern Time (US Canada)\",\n \"timezone\": \"America/New_York\",\n \"friday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"monday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"saturday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"sunday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"thursday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"tuesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n },\n \"wednesday\": {\n \"open\": \"05:00\",\n \"close\": \"1380\",\n \"open24\": false\n }\n },\n \"locationId\": \"01400376\",\n \"storeNumber\": \"00376\",\n \"divisionNumber\": \"014\",\n \"name\": \"Kroger Landen\"\n },\n \"meta\": {\n \"pagination\": {\n \"total\": 0,\n \"start\": 0,\n \"limit\": 0\n },\n \"warnings\": [\"string\"]\n }\n}\n```\n",[],[214,484],"7bf8f82e-3c45-11f0-8b75-9e149126039e","kroger-identity.md","68511d74-3c45-11f0-8d55-9e149126039e",17,["D",1748492957873],"# Kroger Identity\n\n## GET `/v1/identity/profile`\n\nUser profile information\n\nProvides access to the profile id of an authenticated customer.\n\nNote: the customer must be authenticated using the OAuth2 Authorization Code grant type.\n\n### Parameters\n\n- None\n\n### Responses\n\n#### 200 OK\n\n#### Media type\n\napplication/json\n\n#### Example Value\n\n```json\n{\n \"data\": {\n \"id\": \"53990804-cfd1-43f3-8256-bdc9817a4fd0\"\n },\n \"meta\": {\n \"pagination\": {\n \"total\": 0,\n \"start\": 0,\n \"limit\": 0\n },\n \"warnings\": [\"string\"]\n }\n}\n```",[],[214,492],"9cf0f8e2-3c45-11f0-9fec-9e149126039e","kroger-cart.md","9889b4ce-3c45-11f0-85e2-9e149126039e",21,["D",1748493013184],"# Kroger Cart API\n\n## PUT `/v1/cart/add`\n\n### Add to cart\n\nProvides access to add items to an authenticated customer's cart.\n\nNote: the customer must be authenticated using the OAuth2 Authorization Code grant type.\n\n### Parameters\n\n- None\n\n### Request body\n\n- application/json\n- A list of items that you are adding to the cart.\n\n### Example Value\n\n```json\n{\n \"items\": [\n {\n \"quantity\": 1,\n \"upc\": \"0001111060903\",\n \"modality\": \"PICKUP\"\n }\n ]\n}\n```",[],[214,500],"4a2512ec-3c45-11f0-b917-9e149126039e","kroger-authorize.md","3d95585c-3c45-11f0-b917-9e149126039e",["D",1748492874278],"# Kroger Authorize\n\n## Authorization Code\n\nGET `/v1/connect/oauth2/authorize`\n\nThis endpoint is used when the end user must approve access to a protected resource (such as a cart) before a service can act on the user's behalf. Here's how it works:\n\nYour service or application calls this endpoint and includes the redirect URL (what the end user should see after this service executes) and scopes (defines the actions your application or service can take on behalf of the user).\nThis endpoint displays a login screen, where the end user enters their email address and password.\nThe end user is then asked to give the application permission to access the resource on their behalf.\nWhen the user agrees, this service returns the redirect URL with an authorization code as a parameter.\nAfter this endpoint returns, your service or application must call the /token endpoint with the authorization_code grant type and code value to get an access token. The access token is then sent to the endpoint being called to prove that your service or application is authorized to act on a user's behalf.\n\n### Parameters\n\n- `scope` \\*\n\n - string\n - (query)\n The level of access your application is requesting.\n\n- `client_id` \\*\n\n - string\n - (query)\n Your application's client ID.\n\n- `redirect_uri` \\*\n\n - string\n - (query)\n Your registered redirect URL. The redirect URL tells this endpoint which URL to display after the user approves access to the protected resource.\n\n- `response_type` \\*\n\n - string\n - (query)\n Is always `code`.\n\n- `state`\n\n - string\n - (query)\n A random string to verify that the response belongs to the initiated request. The server should always return the same state value as the one specified in the request to protect against forgery attacks.\n\n- `banner`\n\n - string\n - (query)\n - Sets the chain specific branding displayed on the authorization consent screen presented to the end user for shopper logins. When this parameter is not supplied the default chain branding (Kroger) will be used. Only one option may be used at a time and the available options are the following:\n\n- `bakers` - Bakers' Plus\n- `citymarket` - City Market\n- `dillons` - Dillons\n- `fredmeyer` - Fred Meyer\n- `frys` - Fry's Food\n- `gerbes` - Gerbes\n- `kingsoopers` - King Soopers\n- `kroger` - Kroger (default if no banner provided)\n- `metromarket` - Metro Market\n- `picknsave` - Pick 'n Save\n- `qfc` - QFC\n- `ralphs` - Ralphs\n- `smiths` - Smiths Food and Drug\n- `food4less` - Food 4 Less\n- `foodsco` - Foods Co.\n- `harristeeter` - Harris Teeter\n- `vons` - Vons\n- `fredmeyerjewelers` - Fred Meyer\n- `jaycfoods` - Jay C\n- `marianos` - Marianos\n- `payless` - Pay Less\n- `ppsrx` - Postal Prescription Services (PPSRX)\n- `rulerfoods` - Ruler Foods\n- `copps` - Copps\n\n## Access Token\n\nPOST `/v1/connect/oauth2/token`\n\nAll Oauth2 applications are issued \"client credentials\" in the form of a unique client_id and client_secret after registration. The credentials are used to authorize the application.\n\nThere are 3 grant type flows that the token endpoint offers:\n\nauthorization_code - Uses the code returned from the /authorize endpoint to get a token, allowing your service or application to make API requests on an end user's behalf, including accessing personal data. The service is only able to perform the actions specified in the approved scopes.\nclient_credentials - Uses the client credentials to provide a token that allows your service or application to call endpoints that do not require user approval.\nrefresh_token - Allows the application to \"refresh\" an access token that has expired. Refresh tokens are only granted when using the Authorization Code grant type. Using the refresh token eliminates the need to re-authenticate the customer when the access token expires.\nThe access_token received from this step is sent to the endpoint being called to prove that your service or application is authorized to call the API. The token_type field indicates what type of token it is so that you can correctly pass it to the API.\n\n### Parameters\n\n- `Authorization` \\*\n\n - string\n - (header)\n Your client_id:client_secret base64 encoded.\n\n- `Request body`\n - application/x-www-form-urlencoded\n\n### Example Request Body\n\n```json\n{\n \"grant_type\": \"code\",\n \"code\": \"zWrT1GkdshSadIowJW0Rm4w2kKhOzv1W\",\n \"redirect_uri\": \"https://example.com/callback\"\n}\n```\n\n### Example Response\n\n```json\n{\n \"expires_in\": 1800,\n \"access_token\": \"eyJh5GciOiJSUzI1NiGsImtpZCI6Ilo0RnQzbXNrSUj4OGlydDdMQjVjNmc2PSIsInR5cCI6IkpXVmJ9.eqJzY29wZSI6InByb2T1Y3QuY29tcGFjdCBjb3Vwb24uYmFzaWMiLCJhdXRoQXQiOjE1NjUwOTk0OTUzMzIzOTIxMTIsImF1ZCI6InBlcmsvcm1hbmNlLWFnZW50LXB1YmxpYyIsImV4cCI6MTU2NTEwMTI5NSwiaWF0IjoxNTY1MDk5BDkwLCJpc3MiOiJhcGkua3JvZ2VyLmNvbSIsInN1YiI6IjBmZjdkMGIwLWVkOGItNDJmOS1hNTExLWEzMGQyYTAyZDljNSJ9.ej0mov6SGV4n4HiAvduTdYCceMlSo3T06M4Nfh3MfpIjSKzKaLWgd5S0W1EKDXrWz8IE7NTg8EIrL-WKhwdZPt-TWaS7LLjRXLJ0w5rKc44DStgBdvDiCcnKeMsnimjhBlHOiiKUV5y3GbVqJzaDVZwg0j8lP9qtwZP9EIIQ7k409nkskY1pz7l1lZrGotYRJKmnteN5vVQeZ3R8jywIwOOSEbKSgQALVA3Oj02964P7lI6h1GsZ66V5FLA9KU8QXm4ejrFHf1beAIA2zi_fQI3dmW7yj57pWoCECZIjq7Sfo3nGR5rkjEwfyXEK7aTn8oj4_14YHgKRTY-28L96cw\",\n \"token_type\": \"bearer\",\n \"refresh_token\": \"FN20LbaF2EWC6MPMWdemBwwnP4ZmX8\"\n}\n```",[],[214,508],["D",1748492846253],[257,258,259,260,261,262],[214],"e3729468-44e4-11f0-97d6-76b3cceeab13","index.ts",154,["D",1749441030751],42,"http","import { nanoid } from \"https://esm.sh/nanoid@5.0.5\";\nimport { Hono } from \"npm:hono\";\nimport {\n deleteCookie,\n getCookie,\n getSignedCookie,\n setCookie,\n setSignedCookie,\n} from \"npm:hono/cookie\";\n\nimport {\n createGuidance,\n createSelection,\n createUser,\n deleteGuidance,\n deleteSelection,\n getGuidanceByUserId,\n getSelectionByUserAndItem,\n getSelectionsByUserId,\n getUserById,\n getUserByKrogerProfileId,\n searchGuidance,\n updateGuidance,\n updateSelection,\n updateUserLocation,\n updateUserTokens,\n} from \"./database/krogerQueries.ts\";\nimport { runMigrations } from \"./database/migrations.ts\";\n// import { KrogerAuthService } from \"./services/krogerAuth.ts\";\nimport { MockKrogerAuthService } from \"./services/fakeKrogerAuth.ts\";\nimport { UserData } from \"../shared/types.ts\";\nimport { files } from \"./files.ts\";\n\nconst app = new Hono();\n\n// Initialize database on startup\nawait runMigrations();\n\n// Initialize Kroger Auth Service\n// const krogerAuth = new KrogerAuthService();\nconst krogerAuth = new MockKrogerAuthService();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n console.error(\"Error in Hono route:\", err);\n return c.json({ error: \"Internal Server Error\", details: err.message }, 500);\n});\n\n// Middleware to get current user from session\nasync function getCurrentUser(c: any) {\n const sessionId = await getSignedCookie(\n c,\n Deno.env.get(\"SESSION_SECRET\"),\n \"session_id\"\n );\n if (!sessionId) return null;\n\n try {\n return await getUserById(sessionId);\n } catch (error) {\n console.error(\"Error getting current user:\", error);\n return null;\n }\n}\n\n// --- OAuth Routes ---\n\n// Start OAuth flow\napp.get(\"/auth/login\", (c) => {\n if (!krogerAuth.isConfigured()) {\n return c.json(\n {\n error: \"OAuth not configured\",\n message:\n \"Please set KROGER_CLIENT_ID, KROGER_CLIENT_SECRET, and KROGER_REDIRECT_URI environment variables\",\n },\n 500\n );\n }\n\n const state = nanoid(16);\n setCookie(c, \"oauth_state\", state, {\n httpOnly: true,\n secure: true,\n sameSite: \"Lax\",\n maxAge: 600, // 10 minutes\n });\n\n const authUrl = krogerAuth.getAuthorizationUrl(state);\n return c.redirect(authUrl);\n});\n\n// OAuth callback\napp.get(\"/auth/callback\", async (c) => {\n const code = c.req.query(\"code\");\n const state = c.req.query(\"state\");\n const storedState = getCookie(c, \"oauth_state\");\n\n if (!code) {\n return c.json({ error: \"Authorization code not provided\" }, 400);\n }\n\n if (!state || state !== storedState) {\n return c.json({ error: \"Invalid state parameter\" }, 400);\n }\n\n try {\n // Exchange code for token\n const tokenResponse = await krogerAuth.exchangeCodeForToken(code);\n\n // Get user profile\n const profileResponse = await krogerAuth.getUserProfile(\n tokenResponse.access_token\n );\n const krogerProfileId = profileResponse.data.id;\n\n // Check if user exists\n let user = await getUserByKrogerProfileId(krogerProfileId);\n\n if (user) {\n // Update existing user's tokens\n await updateUserTokens(\n user.id,\n tokenResponse.access_token,\n tokenResponse.refresh_token,\n tokenResponse.expires_in\n );\n user = await getUserById(user.id);\n } else {\n // Create new user\n user = await createUser({\n krogerProfileId,\n accessToken: tokenResponse.access_token,\n refreshToken: tokenResponse.refresh_token,\n tokenExpiresAt: Date.now() + tokenResponse.expires_in * 1000,\n });\n }\n\n // Set session cookie\n await setSignedCookie(\n c,\n \"session_id\",\n user!.id,\n Deno.env.get(\"SESSION_SECRET\"),\n {\n httpOnly: true,\n secure: true,\n sameSite: \"Lax\",\n maxAge: 30 * 24 * 60 * 60, // 30 days\n }\n );\n\n // Clear OAuth state\n deleteCookie(c, \"oauth_state\");\n\n return c.redirect(\"/\");\n } catch (error) {\n console.error(\"OAuth callback error:\", error);\n return c.json(\n { error: \"Authentication failed\", details: error.message },\n 500\n );\n }\n});\n\n// Logout\napp.post(\"/auth/logout\", (c) => {\n deleteCookie(c, \"session_id\");\n return c.json({ success: true });\n});\n\n// Get current user info\napp.get(\"/api/user\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n // Don't return sensitive token information\n return c.json({\n id: user.id,\n krogerProfileId: user.krogerProfileId,\n preferredLocationId: user.preferredLocationId,\n createdAt: user.createdAt,\n });\n});\n\n// Update user location\napp.put(\"/api/user/location\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const { locationId } = await c.req.json();\n if (!locationId) {\n return c.json({ error: \"Location ID is required\" }, 400);\n }\n\n await updateUserLocation(user.id, locationId);\n return c.json({ success: true });\n});\n\n// Search locations by zip code\napp.get(\"/api/locations/search\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const zipCode = c.req.query(\"zipCode\");\n const radiusInMiles = parseInt(c.req.query(\"radius\") || \"10\");\n const limit = parseInt(c.req.query(\"limit\") || \"20\");\n\n if (!zipCode) {\n return c.json({ error: \"Zip code is required\" }, 400);\n }\n\n try {\n // Get a valid access token\n const tokenInfo = await krogerAuth.getValidAccessToken(\n user.accessToken,\n user.refreshToken,\n user.tokenExpiresAt\n );\n\n if (!tokenInfo) {\n return c.json({ error: \"Failed to get valid access token\" }, 401);\n }\n\n // Update user tokens if they were refreshed\n if (tokenInfo.accessToken !== user.accessToken) {\n await updateUserTokens(\n user.id,\n tokenInfo.accessToken,\n tokenInfo.refreshToken,\n tokenInfo.expiresIn\n );\n }\n\n // Search for locations\n const locations = await krogerAuth.searchLocationsByZipCode(\n tokenInfo.accessToken,\n zipCode,\n radiusInMiles,\n limit\n );\n\n return c.json(locations);\n } catch (error) {\n console.error(\"Location search error:\", error);\n return c.json(\n { error: \"Failed to search locations\", details: error.message },\n 500\n );\n }\n});\n\n// Get location details by ID\napp.get(\"/api/locations/:locationId\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const locationId = c.req.param(\"locationId\");\n\n try {\n // Get a valid access token\n const tokenInfo = await krogerAuth.getValidAccessToken(\n user.accessToken,\n user.refreshToken,\n user.tokenExpiresAt\n );\n\n if (!tokenInfo) {\n return c.json({ error: \"Failed to get valid access token\" }, 401);\n }\n\n // Update user tokens if they were refreshed\n if (tokenInfo.accessToken !== user.accessToken) {\n await updateUserTokens(\n user.id,\n tokenInfo.accessToken,\n tokenInfo.refreshToken,\n tokenInfo.expiresIn\n );\n }\n\n // Get location details\n const location = await krogerAuth.getLocationById(\n tokenInfo.accessToken,\n locationId\n );\n\n return c.json(location);\n } catch (error) {\n console.error(\"Location fetch error:\", error);\n return c.json(\n { error: \"Failed to fetch location\", details: error.message },\n 500\n );\n }\n});\n\n// --- Guidance Routes ---\n\n// Get all guidance for current user\napp.get(\"/api/guidance\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const guidance = await getGuidanceByUserId(user.id);\n return c.json(guidance);\n});\n\n// Search guidance\napp.get(\"/api/guidance/search\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const itemName = c.req.query(\"q\");\n if (!itemName) {\n return c.json({ error: \"Search query is required\" }, 400);\n }\n\n const guidance = await searchGuidance(user.id, itemName);\n return c.json(guidance);\n});\n\n// Create guidance\napp.post(\"/api/guidance\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const { itemName, guidance } = await c.req.json();\n if (!itemName || !guidance) {\n return c.json({ error: \"Item name and guidance are required\" }, 400);\n }\n\n const newGuidance = await createGuidance({\n userId: user.id,\n itemName,\n guidance,\n });\n\n return c.json(newGuidance, 201);\n});\n\n// Update guidance\napp.put(\"/api/guidance/:id\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const id = c.req.param(\"id\");\n const updates = await c.req.json();\n\n await updateGuidance(id, updates);\n return c.json({ success: true });\n});\n\n// Delete guidance\napp.delete(\"/api/guidance/:id\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const id = c.req.param(\"id\");\n await deleteGuidance(id);\n return c.json({ success: true });\n});\n\n// --- Selection Routes ---\n\n// Get all selections for current user\napp.get(\"/api/selections\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const selections = await getSelectionsByUserId(user.id);\n return c.json(selections);\n});\n\n// Get selection by item name\napp.get(\"/api/selections/item/:itemName\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const itemName = decodeURIComponent(c.req.param(\"itemName\"));\n const selection = await getSelectionByUserAndItem(user.id, itemName);\n\n if (!selection) {\n return c.json({ error: \"Selection not found\" }, 404);\n }\n\n return c.json(selection);\n});\n\n// Create or update selection\napp.post(\"/api/selections\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const { itemName, upc, productName } = await c.req.json();\n if (!itemName || !upc || !productName) {\n return c.json(\n { error: \"Item name, UPC, and product name are required\" },\n 400\n );\n }\n\n const selection = await createSelection({\n userId: user.id,\n itemName,\n upc,\n productName,\n });\n\n return c.json(selection, 201);\n});\n\n// Update selection\napp.put(\"/api/selections/:id\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const id = c.req.param(\"id\");\n const updates = await c.req.json();\n\n await updateSelection(id, updates);\n return c.json({ success: true });\n});\n\n// Delete selection\napp.delete(\"/api/selections/:id\", async (c) => {\n const user = await getCurrentUser(c);\n if (!user) {\n return c.json({ error: \"Not authenticated\" }, 401);\n }\n\n const id = c.req.param(\"id\");\n await deleteSelection(id);\n return c.json({ success: true });\n});\n\n// --- Static File Serving ---\n\n// Serve index.html at the root\napp.get(\"/\", async (c) => {\n let html = await files.readFile(\"/frontend/index.html\", import.meta.url);\n\n // Check if user is authenticated and inject user data\n const user = await getCurrentUser(c);\n if (user) {\n const userData = {\n id: user.id,\n krogerProfileId: user.krogerProfileId,\n preferredLocationId: user.preferredLocationId,\n createdAt: user.createdAt,\n preferredLocation: null,\n } satisfies UserData;\n if (user.preferredLocationId) {\n try {\n // Get a valid access token\n const tokenInfo = await krogerAuth.getValidAccessToken(\n user.accessToken,\n user.refreshToken,\n user.tokenExpiresAt\n );\n\n if (tokenInfo) {\n const location = await krogerAuth.getLocationById(\n tokenInfo.accessToken,\n user.preferredLocationId\n );\n // Map KrogerLocation to Location type\n userData.preferredLocation = {\n locationId: location.data.locationId,\n name: location.data.name,\n storeNumber: location.data.storeNumber,\n phone: location.data.phone,\n address: {\n addressLine1: location.data.address.addressLine1,\n addressLine2: location.data.address.addressLine2,\n city: location.data.address.city,\n state: location.data.address.state,\n zipCode: location.data.address.zipCode,\n },\n };\n }\n } catch (error) {\n console.error(\"Error fetching preferred location:\", error);\n // Continue without location data\n }\n }\n\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n }\n\n return c.html(html);\n});\n\n// Serve frontend files\napp.get(\"/frontend/*\", (c) => files.serveFile(c, c.req.path, import.meta.url));\napp.get(\"/shared/*\", (c) => files.serveFile(c, c.req.path, import.meta.url));\n\nexport default app.fetch;\n\nif (import.meta.main) {\n const port = parseInt(Deno.env.get(\"PORT\") || \"8080\");\n console.log(`Server running on http://localhost:${port}`);\n Deno.serve({ port }, app.fetch);\n}\n","bgschiller-personal-shopper",[],[220,518],"e33acc0e-44e4-11f0-97d6-76b3cceeab13","files.ts","e33accae-44e4-11f0-97d6-76b3cceeab13",146,["D",1749441030381],"import {\n readFile as valTownReadFile,\n serveFile as valTownServeFile,\n} from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { serveStatic } from \"npm:hono/deno\";\nimport { Context } from \"npm:hono\";\n\nexport interface FileClient {\n readFile(path: string, metaUrl: string): Promise;\n serveFile(c: Context, path: string, metaUrl: string): Promise;\n}\n\nclass ValTownFileClient implements FileClient {\n async readFile(path: string, metaUrl: string): Promise {\n return await valTownReadFile(path, metaUrl);\n }\n\n async serveFile(\n c: Context,\n path: string,\n metaUrl: string\n ): Promise {\n return await valTownServeFile(path, metaUrl);\n }\n}\n\nclass LocalFileClient implements FileClient {\n async readFile(path: string, metaUrl: string): Promise {\n const filePath = new URL(path, metaUrl).pathname;\n return await Deno.readTextFile(filePath);\n }\n\n async serveFile(\n c: Context,\n path: string,\n metaUrl: string\n ): Promise {\n try {\n const filePath = new URL(path, metaUrl).pathname;\n const file = await Deno.readFile(filePath);\n const contentType = getContentType(filePath);\n return new Response(file, {\n headers: {\n \"Content-Type\": contentType,\n },\n });\n } catch (error) {\n if (error instanceof Deno.errors.NotFound) {\n return new Response(\"File not found\", { status: 404 });\n }\n throw error;\n }\n }\n}\n\nfunction getContentType(path: string): string {\n const ext = path.split(\".\").pop()?.toLowerCase();\n switch (ext) {\n case \"html\":\n return \"text/html\";\n case \"css\":\n return \"text/css\";\n case \"js\":\n return \"application/javascript\";\n case \"json\":\n return \"application/json\";\n case \"svg\":\n return \"image/svg+xml\";\n default:\n return \"text/plain\";\n }\n}\n\n// Factory function to create the appropriate file client\nexport function createFileClient(): FileClient {\n // Check if we're running in Val Town\n const isValTown = Deno.env.get(\"VAL_TOWN\") === \"true\";\n\n if (isValTown) {\n return new ValTownFileClient();\n } else {\n return new LocalFileClient();\n }\n}\n\n// Export a singleton instance\nexport const files = createFileClient();\n",[],[220,528],"921c1e9c-3e52-11f0-ba82-76b3cceeab13","1fdd8df6-3c46-11f0-8692-9e149126039e","b2cee33c-39af-4edf-b69f-34009317b6d6",114,["D",1748718480729],"import {\n KrogerTokenResponse,\n KrogerProfileResponse,\n KrogerLocationsResponse,\n KrogerLocationResponse,\n} from \"../../shared/types/kroger.ts\";\nimport { IKrogerAuthService } from \"../../shared/types/krogerAuth.ts\";\n\nconst KROGER_BASE_URL = \"https://api.kroger.com\";\n\nexport class KrogerAuthService implements IKrogerAuthService {\n private clientId: string;\n private clientSecret: string;\n private redirectUri: string;\n\n constructor() {\n this.clientId = Deno.env.get(\"KROGER_CLIENT_ID\") || \"\";\n this.clientSecret = Deno.env.get(\"KROGER_CLIENT_SECRET\") || \"\";\n this.redirectUri = Deno.env.get(\"KROGER_REDIRECT_URI\") || \"\";\n\n if (!this.clientId || !this.clientSecret || !this.redirectUri) {\n console.warn(\n \"Missing Kroger OAuth environment variables. OAuth features will be disabled.\"\n );\n console.warn(\n \"Required variables: KROGER_CLIENT_ID, KROGER_CLIENT_SECRET, KROGER_REDIRECT_URI\"\n );\n }\n }\n\n /**\n * Check if OAuth is properly configured\n */\n isConfigured(): boolean {\n return !!(this.clientId && this.clientSecret && this.redirectUri);\n }\n\n /**\n * Generate the authorization URL for the OAuth flow\n */\n getAuthorizationUrl(state?: string): string {\n const params = new URLSearchParams({\n client_id: this.clientId,\n redirect_uri: this.redirectUri,\n response_type: \"code\",\n scope: \"profile.compact cart.basic:write product.compact\",\n ...(state && { state }),\n });\n\n return `${KROGER_BASE_URL}/v1/connect/oauth2/authorize?${params.toString()}`;\n }\n\n /**\n * Exchange authorization code for access token\n */\n async exchangeCodeForToken(code: string): Promise {\n const credentials = btoa(`${this.clientId}:${this.clientSecret}`);\n\n const response = await fetch(`${KROGER_BASE_URL}/v1/connect/oauth2/token`, {\n method: \"POST\",\n headers: {\n Authorization: `Basic ${credentials}`,\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n },\n body: new URLSearchParams({\n grant_type: \"authorization_code\",\n code,\n redirect_uri: this.redirectUri,\n }),\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(`Token exchange failed: ${response.status} ${errorText}`);\n }\n\n return (await response.json()) as KrogerTokenResponse;\n }\n\n /**\n * Refresh an expired access token\n */\n async refreshToken(refreshToken: string): Promise {\n const credentials = btoa(`${this.clientId}:${this.clientSecret}`);\n\n const response = await fetch(`${KROGER_BASE_URL}/v1/connect/oauth2/token`, {\n method: \"POST\",\n headers: {\n Authorization: `Basic ${credentials}`,\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n },\n body: new URLSearchParams({\n grant_type: \"refresh_token\",\n refresh_token: refreshToken,\n }),\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(`Token refresh failed: ${response.status} ${errorText}`);\n }\n\n return (await response.json()) as KrogerTokenResponse;\n }\n\n /**\n * Get user profile information\n */\n async getUserProfile(accessToken: string): Promise {\n const response = await fetch(`${KROGER_BASE_URL}/v1/identity/profile`, {\n headers: {\n Authorization: `Bearer ${accessToken}`,\n Accept: \"application/json\",\n },\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(`Profile fetch failed: ${response.status} ${errorText}`);\n }\n\n return (await response.json()) as KrogerProfileResponse;\n }\n\n /**\n * Check if a token is expired (with 5 minute buffer)\n */\n isTokenExpired(expiresAt: number): boolean {\n const bufferMs = 5 * 60 * 1000; // 5 minutes\n return Date.now() >= expiresAt - bufferMs;\n }\n\n /**\n * Get a valid access token, refreshing if necessary\n */\n async getValidAccessToken(\n currentToken: string,\n refreshToken: string,\n expiresAt: number\n ): Promise<{\n accessToken: string;\n refreshToken: string;\n expiresIn: number;\n } | null> {\n if (!this.isTokenExpired(expiresAt)) {\n return {\n accessToken: currentToken,\n refreshToken,\n expiresIn: Math.floor((expiresAt - Date.now()) / 1000),\n };\n }\n\n try {\n const tokenResponse = await this.refreshToken(refreshToken);\n return {\n accessToken: tokenResponse.access_token,\n refreshToken: tokenResponse.refresh_token,\n expiresIn: tokenResponse.expires_in,\n };\n } catch (error) {\n console.error(\"Failed to refresh token:\", error);\n return null;\n }\n }\n\n /**\n * Search for Kroger locations by zip code\n */\n async searchLocationsByZipCode(\n accessToken: string,\n zipCode: string,\n radiusInMiles: number = 10,\n limit: number = 20\n ): Promise {\n const params = new URLSearchParams({\n \"filter.zipCode.near\": zipCode,\n \"filter.radiusInMiles\": radiusInMiles.toString(),\n \"filter.limit\": limit.toString(),\n });\n\n const response = await fetch(\n `${KROGER_BASE_URL}/v1/locations?${params.toString()}`,\n {\n headers: {\n Authorization: `Bearer ${accessToken}`,\n Accept: \"application/json\",\n },\n }\n );\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(\n `Location search failed: ${response.status} ${errorText}`\n );\n }\n\n return (await response.json()) as KrogerLocationsResponse;\n }\n\n /**\n * Get location details by location ID\n */\n async getLocationById(\n accessToken: string,\n locationId: string\n ): Promise {\n const response = await fetch(\n `${KROGER_BASE_URL}/v1/locations/${locationId}`,\n {\n headers: {\n Authorization: `Bearer ${accessToken}`,\n Accept: \"application/json\",\n },\n }\n );\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(`Location fetch failed: ${response.status} ${errorText}`);\n }\n\n return (await response.json()) as KrogerLocationResponse;\n }\n}\n",[],[220,543,318],"services","e378c95a-44e4-11f0-b49c-76b3cceeab13",["D",1749441030790],[],[220,543,33],"1fddabba-3c46-11f0-8692-9e149126039e",25,["D",1748493232842],[252,253],[220,543],"018e6ce4-3c46-11f0-b1b1-9e149126039e","migrations.ts","018e6da2-3c46-11f0-b1b1-9e149126039e","535efc0c-e0d1-40a5-835e-46a55d512690",["D",1748493181993],"import { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\n\n// Table names - change these when modifying schemas\nconst USERS_TABLE = \"kroger_users_1\";\nconst GUIDANCE_TABLE = \"guidance_1\";\nconst SELECTIONS_TABLE = \"selections_1\";\n\nexport async function runMigrations() {\n // Create users table\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${USERS_TABLE} (\n id TEXT PRIMARY KEY,\n krogerProfileId TEXT UNIQUE NOT NULL,\n accessToken TEXT NOT NULL,\n refreshToken TEXT NOT NULL,\n tokenExpiresAt INTEGER NOT NULL,\n preferredLocationId TEXT,\n createdAt INTEGER NOT NULL,\n updatedAt INTEGER NOT NULL\n )\n `);\n\n // Create guidance table\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${GUIDANCE_TABLE} (\n id TEXT PRIMARY KEY,\n userId TEXT NOT NULL,\n itemName TEXT NOT NULL,\n guidance TEXT NOT NULL,\n createdAt INTEGER NOT NULL,\n updatedAt INTEGER NOT NULL,\n FOREIGN KEY (userId) REFERENCES ${USERS_TABLE}(id) ON DELETE CASCADE\n )\n `);\n\n // Create selections table\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${SELECTIONS_TABLE} (\n id TEXT PRIMARY KEY,\n userId TEXT NOT NULL,\n itemName TEXT NOT NULL,\n upc TEXT NOT NULL,\n productName TEXT NOT NULL,\n createdAt INTEGER NOT NULL,\n updatedAt INTEGER NOT NULL,\n FOREIGN KEY (userId) REFERENCES ${USERS_TABLE}(id) ON DELETE CASCADE,\n UNIQUE(userId, itemName)\n )\n `);\n\n // Create indexes for better performance\n await sqlite.execute(`\n CREATE INDEX IF NOT EXISTS idx_guidance_user_item \n ON ${GUIDANCE_TABLE}(userId, itemName)\n `);\n\n await sqlite.execute(`\n CREATE INDEX IF NOT EXISTS idx_selections_user_item \n ON ${SELECTIONS_TABLE}(userId, itemName)\n `);\n}\n\nexport { USERS_TABLE, GUIDANCE_TABLE, SELECTIONS_TABLE };",[],[220,561,554],"database","e36b2660-44e4-11f0-97d6-76b3cceeab13","krogerQueries.ts","13ca9f2c-3c46-11f0-8b7c-9e149126039e",153,["D",1749441030707],"import { nanoid } from \"https://esm.sh/nanoid@5.0.5\";\nimport { KrogerUser, Guidance, Selection } from \"../../shared/types.ts\";\nimport { USERS_TABLE, GUIDANCE_TABLE, SELECTIONS_TABLE } from \"./migrations.ts\";\nimport { db } from \"./db.ts\";\n\n// User queries\nexport async function createUser(\n userData: Omit\n): Promise {\n const id = nanoid(10);\n const now = Date.now();\n\n const user: KrogerUser = {\n ...userData,\n id,\n createdAt: now,\n updatedAt: now,\n };\n\n await db.execute(\n `\n INSERT INTO ${USERS_TABLE}\n (id, krogerProfileId, accessToken, refreshToken, tokenExpiresAt, preferredLocationId, createdAt, updatedAt)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?)\n `,\n [\n user.id,\n user.krogerProfileId,\n user.accessToken,\n user.refreshToken,\n user.tokenExpiresAt,\n user.preferredLocationId || null,\n user.createdAt,\n user.updatedAt,\n ]\n );\n\n return user;\n}\n\nexport async function getUserByKrogerProfileId(\n krogerProfileId: string\n): Promise {\n const result = await db.execute(\n `\n SELECT * FROM ${USERS_TABLE} WHERE krogerProfileId = ?\n `,\n [krogerProfileId]\n );\n\n if (result.rows.length === 0) return null;\n\n const row = result.rows[0];\n return {\n id: row.id as string,\n krogerProfileId: row.krogerProfileId as string,\n accessToken: row.accessToken as string,\n refreshToken: row.refreshToken as string,\n tokenExpiresAt: row.tokenExpiresAt as number,\n preferredLocationId: row.preferredLocationId as string | undefined,\n createdAt: row.createdAt as number,\n updatedAt: row.updatedAt as number,\n };\n}\n\nexport async function getUserById(id: string): Promise {\n const result = await db.execute(\n `\n SELECT * FROM ${USERS_TABLE} WHERE id = ?\n `,\n [id]\n );\n\n if (result.rows.length === 0) return null;\n\n const row = result.rows[0];\n return {\n id: row.id as string,\n krogerProfileId: row.krogerProfileId as string,\n accessToken: row.accessToken as string,\n refreshToken: row.refreshToken as string,\n tokenExpiresAt: row.tokenExpiresAt as number,\n preferredLocationId: row.preferredLocationId as string | undefined,\n createdAt: row.createdAt as number,\n updatedAt: row.updatedAt as number,\n };\n}\n\nexport async function updateUserTokens(\n userId: string,\n accessToken: string,\n refreshToken: string,\n expiresIn: number\n): Promise {\n const tokenExpiresAt = Date.now() + expiresIn * 1000;\n const updatedAt = Date.now();\n\n await db.execute(\n `\n UPDATE ${USERS_TABLE}\n SET accessToken = ?, refreshToken = ?, tokenExpiresAt = ?, updatedAt = ?\n WHERE id = ?\n `,\n [accessToken, refreshToken, tokenExpiresAt, updatedAt, userId]\n );\n}\n\nexport async function updateUserLocation(\n userId: string,\n locationId: string\n): Promise {\n const updatedAt = Date.now();\n\n await db.execute(\n `\n UPDATE ${USERS_TABLE}\n SET preferredLocationId = ?, updatedAt = ?\n WHERE id = ?\n `,\n [locationId, updatedAt, userId]\n );\n}\n\n// Guidance queries\nexport async function createGuidance(\n guidanceData: Omit\n): Promise {\n const id = nanoid(10);\n const now = Date.now();\n\n const guidance: Guidance = {\n ...guidanceData,\n id,\n createdAt: now,\n updatedAt: now,\n };\n\n await db.execute(\n `\n INSERT INTO ${GUIDANCE_TABLE}\n (id, userId, itemName, guidance, createdAt, updatedAt)\n VALUES (?, ?, ?, ?, ?, ?)\n `,\n [\n guidance.id,\n guidance.userId,\n guidance.itemName,\n guidance.guidance,\n guidance.createdAt,\n guidance.updatedAt,\n ]\n );\n\n return guidance;\n}\n\nexport async function getGuidanceByUserId(userId: string): Promise {\n const result = await db.execute(\n `\n SELECT * FROM ${GUIDANCE_TABLE} WHERE userId = ? ORDER BY updatedAt DESC\n `,\n [userId]\n );\n\n return result.rows.map((row) => ({\n id: row.id as string,\n userId: row.userId as string,\n itemName: row.itemName as string,\n guidance: row.guidance as string,\n createdAt: row.createdAt as number,\n updatedAt: row.updatedAt as number,\n }));\n}\n\nexport async function searchGuidance(\n userId: string,\n itemName: string\n): Promise {\n const result = await db.execute(\n `\n SELECT * FROM ${GUIDANCE_TABLE}\n WHERE userId = ? AND (itemName LIKE ? OR guidance LIKE ?)\n ORDER BY\n CASE WHEN itemName LIKE ? THEN 1 ELSE 2 END,\n updatedAt DESC\n `,\n [userId, `%${itemName}%`, `%${itemName}%`, `%${itemName}%`]\n );\n\n return result.rows.map((row) => ({\n id: row.id as string,\n userId: row.userId as string,\n itemName: row.itemName as string,\n guidance: row.guidance as string,\n createdAt: row.createdAt as number,\n updatedAt: row.updatedAt as number,\n }));\n}\n\nexport async function updateGuidance(\n id: string,\n updates: Partial>\n): Promise {\n const fields = Object.keys(updates);\n const values = Object.values(updates);\n\n if (fields.length === 0) return;\n\n const setClause = fields.map((field) => `${field} = ?`).join(\", \");\n const updatedAt = Date.now();\n\n await db.execute(\n `\n UPDATE ${GUIDANCE_TABLE}\n SET ${setClause}, updatedAt = ?\n WHERE id = ?\n `,\n [...values, updatedAt, id]\n );\n}\n\nexport async function deleteGuidance(id: string): Promise {\n await db.execute(`DELETE FROM ${GUIDANCE_TABLE} WHERE id = ?`, [id]);\n}\n\n// Selection queries\nexport async function createSelection(\n selectionData: Omit\n): Promise {\n const id = nanoid(10);\n const now = Date.now();\n\n const selection: Selection = {\n ...selectionData,\n id,\n createdAt: now,\n updatedAt: now,\n };\n\n await db.execute(\n `\n INSERT OR REPLACE INTO ${SELECTIONS_TABLE}\n (id, userId, itemName, upc, productName, createdAt, updatedAt)\n VALUES (?, ?, ?, ?, ?, ?, ?)\n `,\n [\n selection.id,\n selection.userId,\n selection.itemName,\n selection.upc,\n selection.productName,\n selection.createdAt,\n selection.updatedAt,\n ]\n );\n\n return selection;\n}\n\nexport async function getSelectionByUserAndItem(\n userId: string,\n itemName: string\n): Promise {\n const result = await db.execute(\n `\n SELECT * FROM ${SELECTIONS_TABLE} WHERE userId = ? AND itemName = ?\n `,\n [userId, itemName]\n );\n\n if (result.rows.length === 0) return null;\n\n const row = result.rows[0];\n return {\n id: row.id as string,\n userId: row.userId as string,\n itemName: row.itemName as string,\n upc: row.upc as string,\n productName: row.productName as string,\n createdAt: row.createdAt as number,\n updatedAt: row.updatedAt as number,\n };\n}\n\nexport async function getSelectionsByUserId(\n userId: string\n): Promise {\n const result = await db.execute(\n `\n SELECT * FROM ${SELECTIONS_TABLE} WHERE userId = ? ORDER BY updatedAt DESC\n `,\n [userId]\n );\n\n return result.rows.map((row) => ({\n id: row.id as string,\n userId: row.userId as string,\n itemName: row.itemName as string,\n upc: row.upc as string,\n productName: row.productName as string,\n createdAt: row.createdAt as number,\n updatedAt: row.updatedAt as number,\n }));\n}\n\nexport async function updateSelection(\n id: string,\n updates: Partial>\n): Promise {\n const fields = Object.keys(updates);\n const values = Object.values(updates);\n\n if (fields.length === 0) return;\n\n const setClause = fields.map((field) => `${field} = ?`).join(\", \");\n const updatedAt = Date.now();\n\n await db.execute(\n `\n UPDATE ${SELECTIONS_TABLE}\n SET ${setClause}, updatedAt = ?\n WHERE id = ?\n `,\n [...values, updatedAt, id]\n );\n}\n\nexport async function deleteSelection(id: string): Promise {\n await db.execute(`DELETE FROM ${SELECTIONS_TABLE} WHERE id = ?`, [id]);\n}\n",[],[220,561,563],"e3351886-44e4-11f0-bb93-76b3cceeab13","db.ts","e335193a-44e4-11f0-bb93-76b3cceeab13",145,["D",1749441030323],"import {\n InValue,\n sqlite as valTownSqlite,\n} from \"https://esm.town/v/stevekrouse/sqlite\";\nimport { BindParameters, Database } from \"https://deno.land/x/sqlite3/mod.ts\";\n\nexport interface QueryResult {\n rows: Record[];\n rowCount?: number;\n}\n\nexport interface DatabaseClient {\n execute(query: string, params?: unknown[]): Promise;\n}\n\nclass ValTownDatabaseClient implements DatabaseClient {\n async execute(query: string, params: InValue[] = []): Promise {\n const result = await valTownSqlite.execute(query, params);\n return {\n rows: result.rows,\n rowCount: result.rows.length,\n };\n }\n}\n\nclass LocalDatabaseClient implements DatabaseClient {\n private db: Database;\n\n constructor(dbPath: string) {\n this.db = new Database(dbPath);\n }\n\n async execute(\n query: string,\n params: BindParameters[] = []\n ): Promise {\n const stmt = this.db.prepare(query);\n const rows = stmt.all(params) as Record[];\n return {\n rows,\n rowCount: rows.length,\n };\n }\n\n close() {\n this.db.close();\n }\n}\n\n// Factory function to create the appropriate database client\nexport function createDatabaseClient(): DatabaseClient {\n // Check if we're running in Val Town\n const isValTown = Deno.env.get(\"VAL_TOWN\") === \"true\";\n\n if (isValTown) {\n return new ValTownDatabaseClient();\n } else {\n // For local development, use a file-based SQLite database\n const dbPath = Deno.env.get(\"DB_PATH\") || \"./local.db\";\n return new LocalDatabaseClient(dbPath);\n }\n}\n\n// Export a singleton instance\nexport const db = createDatabaseClient();\n",[],[220,561,571],"018e900c-3c46-11f0-b1b1-9e149126039e",["D",1748493181993],[248,249,250],[220,561],["D",1748493181993],[247,251,254,255],[220],"e344817c-44e4-11f0-97d6-76b3cceeab13","preview.tsx","e344824e-44e4-11f0-97d6-76b3cceeab13",148,["D",1749441030458],"import type { Preview } from \"@storybook/react\";\nimport \"../frontend/style.css\";\n\nconst preview: Preview = {\n parameters: {\n actions: { argTypesRegex: \"^on[A-Z].*\" },\n controls: {\n matchers: {\n color: /(background|color)$/i,\n date: /Date$/i,\n },\n },\n layout: \"centered\",\n },\n};\n\nexport default preview;\n",[],[226,586],"e34a663c-44e4-11f0-b4ed-76b3cceeab13","preview-head.html","e34a670e-44e4-11f0-b4ed-76b3cceeab13",149,["D",1749441030497],"\n",[],[226,594],"e34040c6-44e4-11f0-bff1-76b3cceeab13","main.ts","e34041c0-44e4-11f0-bff1-76b3cceeab13",147,["D",1749441030429],"import type { StorybookConfig } from \"@storybook/react-vite\";\n\nconst config: StorybookConfig = {\n stories: [\"../frontend/components/**/*.stories.tsx\"],\n addons: [\n \"@storybook/addon-links\",\n \"@storybook/addon-essentials\",\n \"@storybook/addon-interactions\",\n ],\n framework: {\n name: \"@storybook/react-vite\",\n options: {},\n },\n docs: {\n autodocs: \"tag\",\n },\n viteFinal: async (config) => {\n return {\n ...config,\n resolve: {\n ...config.resolve,\n alias: {\n ...config.resolve?.alias,\n \"@\": \"/frontend\",\n },\n },\n };\n },\n};\n\nexport default config;\n",[],[226,602],["D",1749441029546],[243,244,245],[226],["D",1748492167939],{"_101":100,"_108":104},{"_101":100,"_102":-5,"_103":104,"_18":55,"_105":106,"_107":25},{"_13":86,"_32":87,"_44":43,"_88":45,"_89":90,"_91":92,"_93":51,"_94":95,"_96":97,"_98":46,"_99":100},"ctx",{"_79":-5,"_130":649,"_650":651,"_652":653,"_654":25,"_655":25,"_656":25,"_657":59,"_658":-5,"_659":-7,"_660":-7,"_661":162,"_662":25,"_663":25,"_664":-5,"_665":25,"_666":25,"_667":25,"_668":-5},"ENV",{"_620":621,"_622":623,"_624":87,"_625":626,"_627":628,"_629":630,"_631":632,"_633":634,"_635":636,"_637":638,"_639":640,"_641":642,"_643":644,"_645":646,"_647":648},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","71c1b20804b3232a7e513be260cfffc1932a9e97","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v155