[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_255":256,"_257":258},"routes/_app.x.$handle.$name",{"_107":106,"_38":52,"_115":93,"_33":109,"_13":14,"_116":-5,"_11":117,"_118":119,"_120":121,"_122":123,"_124":125,"_26":-5,"_126":127,"_128":129,"_130":31,"_131":132,"_133":65,"_134":-5,"_135":-5,"_136":137},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_50":51,"_38":52,"_45":53,"_54":-5,"_55":31,"_56":57,"_58":57,"_59":60,"_61":-5,"_19":62,"_63":37,"_64":65,"_66":-5,"_67":-5,"_68":69,"_70":71,"_72":-5,"_73":-5,"_74":-5,"_75":-5,"_76":77,"_78":77,"_79":80,"_81":80,"_82":80,"_83":77,"_84":77,"_85":86,"_87":88,"_89":90,"_91":31},"version",6,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","643f9e7f-6db3-4687-a3ef-5dd63dcd5212","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":39,"_40":41,"_42":44,"_45":46,"_47":14,"_48":49,"_30":31},"previous",{"_36":37,"_38":39,"_40":41,"_42":43},"deleted",false,"deletedHere","path","backend/index.ts","latestPath","fileId","019e7c96-9fd0-77c8-93fb-01c422d7249b","name","index.ts","fileType","http","content","import { Hono } from \"npm:hono\";\nimport { readFile, parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { getLeads, getStock } from \"./hc.ts\";\nimport { api } from \"./api.ts\";\n\nconst app = new Hono();\napp.onError((err) => Promise.reject(err));\n\n// --- Frontend ---\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\napp.get(\"/frontend/*\", (c) => serveFile(new URL(c.req.url).pathname, import.meta.url));\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// --- Human-readable API docs ---\napp.get(\"/docs\", async (c) => {\n const md = await readFile(\"/API.md\", import.meta.url);\n return c.text(md, 200, { \"content-type\": \"text/markdown; charset=utf-8\" });\n});\n\n// --- New structured API (Discord-bot friendly) mounted under /api ---\napp.route(\"/api\", api);\n\nexport default app.fetch;\n","import { Hono } from \"npm:hono\";\nimport { readFile, parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { api } from \"./api.ts\";\n\nconst app = new Hono();\napp.onError((err) => Promise.reject(err));\n\n// --- Frontend ---\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\napp.get(\"/frontend/*\", (c) => serveFile(new URL(c.req.url).pathname, import.meta.url));\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// --- Human-readable API docs ---\napp.get(\"/docs\", async (c) => {\n const md = await readFile(\"/API.md\", import.meta.url);\n return c.text(md, 200, { \"content-type\": \"text/markdown; charset=utf-8\" });\n});\n\n// --- New structured API (Discord-bot friendly) mounted under /api ---\napp.route(\"/api\", api);\n\nexport default app.fetch;\n","createdAt",["D",1780206857265],"branchVersion","branchId","cf41cd0e-5cb4-11f1-ae2b-1607ee4eb77e","id","cf38a468-5cb4-11f1-ae2b-1607ee4eb77e","hidden-clearances-api",["D",1780206706547],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Hidden Clearances browser — deals feed + per-store stock lookup","imageUrl","8ccd678b-d6cf-4093-809d-37e652b56f5a","pinnedFileId","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019e7c95-53d9-7765-be1b-372777b6fe5f","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_107":106,"_114":109},"org",{"_107":106,"_108":109,"_110":109,"_19":62,"_111":112,"_113":31},"branch",{"_13":92,"_38":93,"_50":49,"_94":51,"_95":96,"_97":98,"_99":57,"_100":101,"_102":103,"_104":52,"_105":106},"isOwned",13,"main","projectId","forkedBranchId","cc99243c-5cb2-11f1-b5a8-1607ee4eb77e","forkedBranchVersion",15,"forkedProjectPrivacy","forkedProjectId","cc98120e-5cb2-11f1-b5a8-1607ee4eb77e","forkedProjectOrgId","019e7c89-3d62-74d5-810c-c0c87a78f26f","projectName","userHandle","xn5n7y11","handle","displayName","","avatar","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_50":51,"_38":52,"_45":251,"_54":-5,"_55":31,"_56":57,"_58":57,"_59":60,"_61":-5,"_19":62,"_63":37,"_64":65,"_66":-5,"_67":-5,"_68":69,"_70":71,"_72":-5,"_73":-5,"_74":-5,"_75":-5,"_76":77,"_78":77,"_79":80,"_81":80,"_82":80,"_83":77,"_84":77,"_85":252,"_87":253,"_89":254,"_91":31},"tree",[182,186,191],"files",[182,183,184,185,186,187,188,189,190,191],"counts",{"_172":69,"_173":155,"_174":69,"_175":176,"_177":178},"contents",[148,149,150],"upstreamProject",{"_50":101,"_38":145,"_59":60,"_61":-5,"_56":57,"_85":146},"upstreamBranch",{"_50":96,"_45":138,"_139":140,"_38":93,"_94":101,"_13":141,"_95":-5,"_97":-5,"_142":143,"_54":-5,"_91":31,"_56":57,"_105":144,"_70":103,"_104":145},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1780205843171],"updatedAt",["D",1780207481423],36,"lockfileKey","1780207522848-esm.town_v_pre1_hi@36-main","pre1","hi",{"_107":144,"_114":147},"https://lh3.googleusercontent.com/a/ACg8ocJubKqnf6LcCHjbjbyg1QcKZydw4_Ni7P97uQ61Oa5pcazlmQ=s96-c",{"_50":167,"_38":168,"_36":169,"_154":-5,"_48":49,"_47":155,"_156":65,"_45":170,"_13":69,"_40":165,"_42":-5,"_30":31,"_159":-5,"_33":171},{"_50":161,"_38":162,"_36":163,"_154":-5,"_48":49,"_47":155,"_156":65,"_45":164,"_13":69,"_40":165,"_42":-5,"_30":31,"_159":-5,"_33":166},{"_50":151,"_38":152,"_36":153,"_154":-5,"_48":49,"_47":155,"_156":31,"_45":157,"_13":69,"_40":26,"_42":158,"_30":31,"_159":-5,"_33":160},"cf48053e-5cb4-11f1-ae2b-1607ee4eb77e","README.md","019e7c96-9fd0-77c8-93fb-1ca4fb092182","parentId",1,"latest",["D",1780206706547],"# 🏷️ Hidden Clearances browser\n\nA UI + JSON API that proxies [hiddenclearances.com](https://www.hiddenclearances.com).\nBrowse the clearance deal feed and check live per-store stock for any SKU.\n\n## What it does\n\n- **Deals feed** — paginated grid of clearance leads (24/page, sort by newest/discount/price).\n- **Stock lookup** — click \"Check stock\" on any deal (or hit the API) to see which\n nearby stores have it in stock for a given ZIP, with quantity, price, and aisle location.\n\n## API\n\n| Route | Description |\n| --- | --- |\n| `GET /api/leads?limit=24&page=1&sort=newest` | Clearance deal feed (proxies `/api/v1/leads`). |\n| `GET /api/stock?retailer=home_depot&sku=336764660&zip=80019` | Per-store stock (proxies `/api/v1/{retailer}/stock`). |\n\n`retailer` accepts `home_depot` / `lowes` / `walmart` (underscores are stripped before\nhitting the upstream path, e.g. `homedepot`).\n\n### Example\n\n```\nGET /api/stock?retailer=home_depot&sku=336764660&zip=80019\n```\n\n→ 32 stores, 4 in stock (Aurora, Thornton, Greenwood Village ×4, Boulder).\n\n## Auth — important\n\nThe upstream API requires a **Supabase JWT Bearer token** that expires (~1 hour).\nIt's stored in the `HC_TOKEN` env var. When deals stop loading (502 / auth error),\ngrab a fresh token from a logged-in request on hiddenclearances.com (the\n`authorization:` header value) and update the env var.\n\n👉 Refresh HC_TOKEN here: https://www.val.town/x/pre1/hi/environment-variables?key=HC_TOKEN\n\n## Structure\n\n```mermaid\ngraph TD\n B[\"frontend/App.tsx + StockModal.tsx\"] -->|/api/leads, /api/stock| S[\"backend/index.ts (Hono)\"]\n S -->|Bearer HC_TOKEN| H[\"backend/hc.ts\"]\n H -->|fetch| API[\"api.hiddenclearances.com\"]\n```\n","label",[152],"cf4803f4-5cb4-11f1-ae2b-1607ee4eb77e","frontend","019e7c96-9fd0-77c8-93fb-19a743a007f9",["D",1780206706547],"directory",[162],"cf477678-5cb4-11f1-ae2b-1607ee4eb77e","backend","019e7c96-9fd0-77c8-93fb-0672408dacfa",["D",1780206706547],[168],"pulls","branches","forks","envVars",{"_179":155,"_181":155},"connections",{"_179":69,"_180":69},"count","unfilledCount","emptyCount",{"_50":167,"_38":168,"_36":169,"_154":-5,"_48":49,"_47":155,"_156":65,"_45":248,"_13":69,"_40":165,"_42":-5,"_30":31,"_159":-5,"_193":249,"_33":250},{"_50":241,"_38":242,"_36":243,"_154":169,"_48":49,"_47":230,"_156":65,"_45":244,"_13":69,"_40":200,"_42":245,"_30":31,"_159":-5,"_193":246,"_33":247},{"_50":233,"_38":234,"_36":235,"_154":169,"_48":49,"_47":236,"_156":65,"_45":237,"_13":155,"_40":200,"_42":238,"_30":31,"_159":-5,"_193":239,"_33":240},{"_50":228,"_38":39,"_36":37,"_154":169,"_48":49,"_47":14,"_156":65,"_45":229,"_13":230,"_40":41,"_42":44,"_30":31,"_159":-5,"_193":231,"_33":232},{"_50":161,"_38":162,"_36":163,"_154":-5,"_48":49,"_47":155,"_156":65,"_45":225,"_13":69,"_40":165,"_42":-5,"_30":31,"_159":-5,"_193":226,"_33":227},{"_50":218,"_38":219,"_36":220,"_154":163,"_48":49,"_47":155,"_156":31,"_45":221,"_13":69,"_40":200,"_42":222,"_30":31,"_159":-5,"_193":223,"_33":224},{"_50":211,"_38":212,"_36":213,"_154":163,"_48":49,"_47":155,"_156":31,"_45":214,"_13":69,"_40":200,"_42":215,"_30":31,"_159":-5,"_193":216,"_33":217},{"_50":204,"_38":205,"_36":206,"_154":163,"_48":49,"_47":155,"_156":65,"_45":207,"_13":69,"_40":26,"_42":208,"_30":31,"_159":-5,"_193":209,"_33":210},{"_50":196,"_38":197,"_36":198,"_154":163,"_48":49,"_47":155,"_156":65,"_45":199,"_13":69,"_40":200,"_42":201,"_30":31,"_159":-5,"_193":202,"_33":203},{"_50":151,"_38":152,"_36":153,"_154":-5,"_48":49,"_47":155,"_156":31,"_45":192,"_13":69,"_40":26,"_42":158,"_30":31,"_159":-5,"_193":194,"_33":195},["D",1780206706547],"children",[],[152],"cf480034-5cb4-11f1-ae2b-1607ee4eb77e","main.tsx","019e7c96-9fd0-77c8-93fb-177a3cebda86",["D",1780206706547],"script","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"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 { App } from \"./App.tsx\";\n\ncreateRoot(document.getElementById(\"root\")!).render();\n",[],[162,197],"cf47b692-5cb4-11f1-ae2b-1607ee4eb77e","index.html","019e7c96-9fd0-77c8-93fb-10c26482ddbe",["D",1780206706547],"\n\n \n \n \n Hidden Clearances 🔎\n 🏷️\" />\n \n \n \n \n

\n \n \n\n",[],[162,205],"cf479bd0-5cb4-11f1-ae2b-1607ee4eb77e","StockModal.tsx","019e7c96-9fd0-77c8-93fb-0c20bc0ac4ac",["D",1780206706547],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useEffect, useState } from \"https://esm.sh/react@18.2.0\";\n\ninterface Store {\n storeId: string;\n storeName: string;\n address: string;\n city: string;\n state: string;\n zip: string;\n quantity: number;\n inStock: boolean;\n price: number;\n itemLocation: string;\n distance: number;\n}\n\nexport function StockModal(\n { sku, retailer, title, onClose }: {\n sku: string;\n retailer: string;\n title: string;\n onClose: () => void;\n },\n) {\n const [zip, setZip] = useState(localStorage.getItem(\"hc_zip\") || \"80019\");\n const [loading, setLoading] = useState(false);\n const [error, setError] = useState(null);\n const [item, setItem] = useState(null);\n const [stores, setStores] = useState([]);\n const [onlyInStock, setOnlyInStock] = useState(false);\n\n async function check(e?: React.FormEvent) {\n e?.preventDefault();\n setLoading(true);\n setError(null);\n localStorage.setItem(\"hc_zip\", zip);\n try {\n const r = await fetch(\n `/api/stock?retailer=${encodeURIComponent(retailer)}&sku=${encodeURIComponent(sku)}&zip=${encodeURIComponent(zip)}`,\n );\n const data = await r.json();\n if (!data.success) throw new Error(data.error || \"Lookup failed\");\n setItem(data.item);\n setStores(data.stores || []);\n } catch (err) {\n setError(String(err));\n setStores([]);\n } finally {\n setLoading(false);\n }\n }\n\n useEffect(() => {\n check();\n // eslint-disable-next-line\n }, []);\n\n const shown = (onlyInStock ? stores.filter((s) => s.inStock) : stores)\n .slice()\n .sort((a, b) => Number(b.inStock) - Number(a.inStock) || a.distance - b.distance);\n const inStockCount = stores.filter((s) => s.inStock).length;\n\n return (\n \n e.stopPropagation()}\n >\n

{title}

SKU {sku} · {retailer.replace(/_/g, \" \")}

\n \n ×\n \n

\n\n

\n ZIP\n setZip(e.target.value)}\n className=\"border border-gray-300 rounded-lg px-3 py-1.5 w-28 text-sm\"\n placeholder=\"80019\"\n />\n \n {loading ? \"Checking…\" : \"Check stock\"}\n \n {stores.length > 0 && (\n \n setOnlyInStock(e.target.checked)}\n />\n In stock only\n \n )}\n \n\n

\n {error && (\n

{error}

\n )}\n\n {!error && item && (\n

\n {inStockCount} of{\" \"}\n {stores.length} stores in stock · retail ${item.retailPrice}\n

\n )}\n\n

\n {shown.map((s) => (\n

\n \n

\n {s.storeName}{\" \"}\n · {s.distance.toFixed(1)} mi\n

\n {s.address}, {s.city} {s.zip}\n {s.itemLocation && · {s.itemLocation}}\n

\n {s.inStock\n ? (\n <>\n

{s.quantity} in stock

${s.price}

\n \n )\n :

Out

}\n

\n ))}\n {!loading && shown.length === 0 && !error && (\n

No stores to show.

\n )}\n

\n \n \n );\n}\n",[],[162,212],"cf4777e0-5cb4-11f1-ae2b-1607ee4eb77e","App.tsx","019e7c96-9fd0-77c8-93fb-0b152394eb92",["D",1780206706547],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useEffect, useState } from \"https://esm.sh/react@18.2.0\";\nimport { StockModal } from \"./StockModal.tsx\";\n\ninterface Lead {\n id: string;\n retailer: string;\n sku: string;\n title: string;\n imageUrl: string | null;\n originalPrice: string;\n clearancePrice: string;\n discountPercent: number;\n productUrl: string | null;\n createdAt: string;\n}\n\nconst RETAILER_BADGE: Record = {\n home_depot: \"bg-orange-100 text-orange-700\",\n lowes: \"bg-blue-100 text-blue-700\",\n walmart: \"bg-sky-100 text-sky-700\",\n};\n\nfunction DealCard({ lead, onCheck }: { lead: Lead; onCheck: (l: Lead) => void }) {\n return (\n

\n {lead.imageUrl\n ? {lead.title}

\n : 📦}\n \n -{lead.discountPercent}%\n \n

\n \n {lead.retailer.replace(/_/g, \" \")}\n \n

{lead.title}

\n ${lead.clearancePrice}\n ${lead.originalPrice}\n

\n onCheck(lead)}\n className=\"flex-1 bg-emerald-600 hover:bg-emerald-700 text-white text-xs font-semibold py-1.5 rounded-lg\"\n >\n 📍 Check stock\n \n {lead.productUrl && (\n \n ↗\n \n )}\n

SKU {lead.sku}

\n );\n}\n\nexport function App() {\n const [leads, setLeads] = useState([]);\n const [loading, setLoading] = useState(true);\n const [error, setError] = useState(null);\n const [page, setPage] = useState(1);\n const [sort, setSort] = useState(\"newest\");\n const [total, setTotal] = useState(0);\n const [totalPages, setTotalPages] = useState(1);\n const [query, setQuery] = useState(\"\");\n const [active, setActive] = useState(null);\n\n const limit = 24;\n\n async function load() {\n setLoading(true);\n setError(null);\n try {\n const r = await fetch(`/api/leads?limit=${limit}&page=${page}&sort=${sort}`);\n const data = await r.json();\n if (!data.success) throw new Error(data.error || \"Failed to load\");\n setLeads(data.data);\n setTotal(data.pagination.total);\n setTotalPages(data.pagination.totalPages);\n } catch (err) {\n setError(String(err));\n } finally {\n setLoading(false);\n }\n }\n\n useEffect(() => {\n load();\n // eslint-disable-next-line\n }, [page, sort]);\n\n const filtered = query.trim()\n ? leads.filter((l) =>\n (l.title + \" \" + l.sku).toLowerCase().includes(query.toLowerCase())\n )\n : leads;\n\n return (\n

🏷️ Hidden Clearances

\n setQuery(e.target.value)}\n placeholder=\"Filter this page…\"\n className=\"border border-gray-300 rounded-lg px-3 py-1.5 text-sm w-44\"\n />\n { setPage(1); setSort(e.target.value); }}\n className=\"border border-gray-300 rounded-lg px-3 py-1.5 text-sm bg-white\"\n >\n \n \n \n \n \n

\n\n {error && (\n

\n {error}\n

\n If this is an auth error, the HC_TOKEN env var likely expired — refresh it.\n

\n )}\n\n {loading\n ?

Loading deals…

\n : (\n

\n {filtered.map((l) => )}\n

\n )}\n\n {!loading && (\n

\n setPage((p) => p - 1)}\n className=\"px-4 py-1.5 border rounded-lg text-sm disabled:opacity-40 bg-white\"\n >\n ← Prev\n \n \n Page {page} / {totalPages} · {total.toLocaleString()} deals\n \n = totalPages}\n onClick={() => setPage((p) => p + 1)}\n className=\"px-4 py-1.5 border rounded-lg text-sm disabled:opacity-40 bg-white\"\n >\n Next →\n \n

\n )}\n\n \n\n {active && (\n setActive(null)}\n />\n )}\n

\n );\n}\n",[],[162,219],["D",1780206706547],[187,188,189,190],[162],"290f4b40-5cb5-11f1-87b7-1607ee4eb77e",["D",1780206857265],3,[],[168,39],"00d8a8a6-5cb5-11f1-ae2b-1607ee4eb77e","hc.ts","019e7c96-9fd0-77c8-93fa-ff1490d26874",2,["D",1780206789802],"// Thin typed client for the HiddenClearances upstream API.\n//\n// AUTH: the upstream requires a Supabase JWT Bearer token that EXPIRES (~1hr).\n// It lives in the HC_TOKEN env var. When requests start returning 401/403 (or the\n// feed stops loading), refresh HC_TOKEN with a fresh `authorization` Bearer value\n// copied from a logged-in request on https://www.hiddenclearances.com.\n\nconst BASE = \"https://api.hiddenclearances.com/api/v1\";\n\n/** Retailer slugs as exposed by our API (human-friendly, underscored). */\nexport type Retailer = \"home_depot\" | \"lowes\" | \"walmart\";\n\n/** Map our friendly slug -> the slug the upstream path expects. */\nconst RETAILER_PATH: Record = {\n home_depot: \"homedepot\",\n homedepot: \"homedepot\",\n lowes: \"lowes\",\n walmart: \"walmart\",\n};\n\nexport function normalizeRetailer(input?: string | null): string {\n if (!input) return \"homedepot\";\n const key = input.toLowerCase().trim();\n return RETAILER_PATH[key] ?? key.replace(/[_\\s]/g, \"\");\n}\n\nfunction token(): string {\n const t = Deno.env.get(\"HC_TOKEN\");\n if (!t) throw new HcError(\"Missing HC_TOKEN env var\", 500, \"config_error\");\n return t.replace(/^Bearer\\s+/i, \"\").trim();\n}\n\n/** Structured error so the HTTP layer can map upstream failures to clean codes. */\nexport class HcError extends Error {\n constructor(\n message: string,\n public status: number,\n public code: string,\n public upstream?: string,\n ) {\n super(message);\n this.name = \"HcError\";\n }\n}\n\nasync function hcFetch(path: string): Promise {\n let r: Response;\n try {\n r = await fetch(`${BASE}${path}`, {\n headers: {\n \"authorization\": `Bearer ${token()}`,\n \"accept\": \"*/*\",\n \"origin\": \"https://www.hiddenclearances.com\",\n \"referer\": \"https://www.hiddenclearances.com/\",\n \"user-agent\":\n \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36\",\n },\n });\n } catch (e) {\n throw new HcError(`Network error reaching upstream: ${e}`, 502, \"upstream_unreachable\");\n }\n\n if (r.status === 401 || r.status === 403) {\n const body = await r.text().catch(() => \"\");\n throw new HcError(\n \"Upstream rejected the token — HC_TOKEN has likely expired, refresh it.\",\n 503,\n \"token_expired\",\n body.slice(0, 300),\n );\n }\n if (!r.ok) {\n const body = await r.text().catch(() => \"\");\n throw new HcError(`Upstream ${r.status}`, 502, \"upstream_error\", body.slice(0, 300));\n }\n return r;\n}\n\n// ---- Shapes returned by the upstream (subset we rely on) ----\n\nexport interface Lead {\n id: string;\n retailer: string;\n sku: string;\n title: string;\n imageUrl: string | null;\n originalPrice: string;\n clearancePrice: string;\n discountPercent: number;\n productUrl: string | null;\n createdAt: string;\n expiresAt?: string;\n}\n\nexport interface LeadsResult {\n success: boolean;\n data: Lead[];\n pagination: { total: number; page: number; limit: number; totalPages: number };\n}\n\nexport interface Store {\n storeId: string;\n storeName: string;\n address: string;\n city: string;\n state: string;\n zip: string;\n quantity: number;\n inStock: boolean;\n price: number;\n itemLocation: string;\n distance: number;\n}\n\nexport interface StockResult {\n success: boolean;\n item?: { retailPrice?: number; [k: string]: unknown };\n stores: Store[];\n}\n\n// ---- Calls ----\n\nexport async function getLeads(\n { limit = 24, page = 1, sort = \"newest\" }: { limit?: number; page?: number; sort?: string },\n): Promise {\n const qs = new URLSearchParams({ limit: String(limit), page: String(page), sort });\n const r = await hcFetch(`/leads?${qs}`);\n return r.json();\n}\n\nexport async function getStock(retailer: string, sku: string, zip: string): Promise {\n const slug = normalizeRetailer(retailer);\n const qs = new URLSearchParams({ sku, zip });\n const r = await hcFetch(`/${slug}/stock?${qs}`);\n return r.json();\n}\n",[],[168,234],"19d99248-5cb5-11f1-a344-1607ee4eb77e","api.ts","19d99324-5cb5-11f1-a344-1607ee4eb77e",["D",1780206831752],"// Public JSON API for the Hidden Clearances proxy — designed for Discord bots\n// and other automated clients. All responses share a consistent envelope:\n//\n// success: true -> { success: true, ...payload }\n// success: false -> { success: false, error: { code, message } }\n//\n// Optional auth: set the API_KEY env var to require callers to send the key via\n// ?key=... query param OR the x-api-key header OR Authorization: Bearer .\n// If API_KEY is unset, the API is open (handy while wiring up your bot).\n\nimport { Hono } from \"npm:hono\";\nimport { cors } from \"npm:hono/cors\";\nimport { getLeads, getStock, HcError, normalizeRetailer, type Lead } from \"./hc.ts\";\n\nexport const api = new Hono();\n\napi.use(\"/*\", cors());\n\n// ---- helpers ----\n\nconst RETAILER_LABEL: Record = {\n homedepot: \"Home Depot\",\n home_depot: \"Home Depot\",\n lowes: \"Lowe's\",\n walmart: \"Walmart\",\n};\n\nfunction clampInt(v: string | undefined, def: number, min: number, max: number): number {\n const n = Number(v);\n if (!Number.isFinite(n)) return def;\n return Math.min(max, Math.max(min, Math.trunc(n)));\n}\n\nfunction fail(c: any, status: number, code: string, message: string) {\n return c.json({ success: false, error: { code, message } }, status);\n}\n\n/** Map an HcError (or anything) to a clean JSON error response. */\nfunction handleError(c: any, e: unknown) {\n if (e instanceof HcError) {\n return c.json(\n { success: false, error: { code: e.code, message: e.message, upstream: e.upstream } },\n e.status,\n );\n }\n return c.json({ success: false, error: { code: \"internal_error\", message: String(e) } }, 500);\n}\n\n/** Optional API-key gate. No-op when API_KEY env var is not set. */\nfunction requireKey(c: any): Response | null {\n const required = Deno.env.get(\"API_KEY\");\n if (!required) return null;\n const provided = c.req.query(\"key\") ||\n c.req.header(\"x-api-key\") ||\n (c.req.header(\"authorization\") || \"\").replace(/^Bearer\\s+/i, \"\").trim();\n if (provided !== required) {\n return fail(c, 401, \"unauthorized\", \"Missing or invalid API key. Pass ?key=, x-api-key, or Authorization: Bearer.\");\n }\n return null;\n}\n\napi.use(\"/*\", async (c, next) => {\n const blocked = requireKey(c);\n if (blocked) return blocked;\n await next();\n});\n\n/** Shape a raw upstream lead into a flatter, bot-friendly deal object. */\nfunction shapeDeal(l: Lead) {\n const original = Number(l.originalPrice);\n const clearance = Number(l.clearancePrice);\n return {\n id: l.id,\n sku: l.sku,\n title: l.title,\n retailer: l.retailer,\n retailerName: RETAILER_LABEL[l.retailer] ?? l.retailer.replace(/_/g, \" \"),\n image: l.imageUrl,\n originalPrice: Number.isFinite(original) ? original : l.originalPrice,\n clearancePrice: Number.isFinite(clearance) ? clearance : l.clearancePrice,\n discountPercent: l.discountPercent,\n savings: Number.isFinite(original) && Number.isFinite(clearance)\n ? Math.round((original - clearance) * 100) / 100\n : null,\n url: l.productUrl,\n createdAt: l.createdAt,\n expiresAt: l.expiresAt ?? null,\n };\n}\n\n// =====================================================================\n// GET /api — self-describing index so a bot dev can discover endpoints\n// =====================================================================\napi.get(\"/\", (c) => {\n const base = new URL(c.req.url).origin;\n return c.json({\n success: true,\n name: \"Hidden Clearances API\",\n description: \"Clearance deal feed + per-store live stock lookup.\",\n docs: `${base}/docs`,\n authRequired: Boolean(Deno.env.get(\"API_KEY\")),\n endpoints: {\n deals: `${base}/api/deals?limit=24&page=1&sort=newest`,\n search: `${base}/api/search?q=dewalt&limit=20`,\n random: `${base}/api/random`,\n stock: `${base}/api/stock?retailer=home_depot&sku=336764660&zip=80019`,\n retailers: `${base}/api/retailers`,\n health: `${base}/api/health`,\n },\n retailers: [\"home_depot\", \"lowes\", \"walmart\"],\n sorts: [\"newest\", \"oldest\", \"discount\", \"price\"],\n });\n});\n\n// =====================================================================\n// GET /api/health — quick liveness + token sanity check\n// =====================================================================\napi.get(\"/health\", async (c) => {\n try {\n const r = await getLeads({ limit: 1, page: 1, sort: \"newest\" });\n return c.json({ success: true, status: \"ok\", upstream: \"reachable\", totalDeals: r.pagination?.total ?? null });\n } catch (e) {\n if (e instanceof HcError && e.code === \"token_expired\") {\n return c.json({ success: false, status: \"token_expired\", error: { code: e.code, message: e.message } }, 503);\n }\n return handleError(c, e);\n }\n});\n\n// =====================================================================\n// GET /api/retailers\n// =====================================================================\napi.get(\"/retailers\", (c) =>\n c.json({\n success: true,\n retailers: [\n { slug: \"home_depot\", name: \"Home Depot\" },\n { slug: \"lowes\", name: \"Lowe's\" },\n { slug: \"walmart\", name: \"Walmart\" },\n ],\n }));\n\n// =====================================================================\n// GET /api/deals — paginated clearance feed\n// ?limit (1-100, def 24) ?page (def 1) ?sort (newest|oldest|discount|price)\n// ?retailer (optional client-side filter on the returned page)\n// =====================================================================\napi.get(\"/deals\", async (c) => {\n try {\n const limit = clampInt(c.req.query(\"limit\"), 24, 1, 100);\n const page = clampInt(c.req.query(\"page\"), 1, 1, 100000);\n const sort = c.req.query(\"sort\") ?? \"newest\";\n const retailerFilter = c.req.query(\"retailer\");\n\n const r = await getLeads({ limit, page, sort });\n let deals = (r.data ?? []).map(shapeDeal);\n if (retailerFilter) {\n const slug = retailerFilter.toLowerCase();\n deals = deals.filter((d) =>\n d.retailer.toLowerCase() === slug || d.retailer.replace(/_/g, \"\") === normalizeRetailer(slug)\n );\n }\n\n return c.json({\n success: true,\n deals,\n count: deals.length,\n pagination: r.pagination,\n });\n } catch (e) {\n return handleError(c, e);\n }\n});\n\n// =====================================================================\n// GET /api/deals/:id — single deal by id (scans recent pages)\n// =====================================================================\napi.get(\"/deals/:id\", async (c) => {\n try {\n const id = c.req.param(\"id\");\n for (let page = 1; page <= 5; page++) {\n const r = await getLeads({ limit: 100, page, sort: \"newest\" });\n const found = (r.data ?? []).find((l) => l.id === id || l.sku === id);\n if (found) return c.json({ success: true, deal: shapeDeal(found) });\n if (page >= (r.pagination?.totalPages ?? 1)) break;\n }\n return fail(c, 404, \"not_found\", `No deal found with id/sku \"${id}\" in recent pages.`);\n } catch (e) {\n return handleError(c, e);\n }\n});\n\n// =====================================================================\n// GET /api/search?q=... — keyword search across the feed\n// ?q (required) ?limit (1-50, def 20) ?pages (how many upstream pages to scan, 1-10 def 3)\n// =====================================================================\napi.get(\"/search\", async (c) => {\n try {\n const q = (c.req.query(\"q\") ?? \"\").trim().toLowerCase();\n if (!q) return fail(c, 400, \"bad_request\", \"Query param 'q' is required.\");\n const limit = clampInt(c.req.query(\"limit\"), 20, 1, 50);\n const pages = clampInt(c.req.query(\"pages\"), 3, 1, 10);\n\n const matches: Lead[] = [];\n for (let page = 1; page <= pages; page++) {\n const r = await getLeads({ limit: 100, page, sort: \"newest\" });\n for (const l of r.data ?? []) {\n if ((l.title + \" \" + l.sku).toLowerCase().includes(q)) matches.push(l);\n }\n if (matches.length >= limit || page >= (r.pagination?.totalPages ?? 1)) break;\n }\n\n return c.json({\n success: true,\n query: q,\n deals: matches.slice(0, limit).map(shapeDeal),\n count: Math.min(matches.length, limit),\n });\n } catch (e) {\n return handleError(c, e);\n }\n});\n\n// =====================================================================\n// GET /api/random — one random recent deal (great for a !deal command)\n// ?sort (def discount) ?retailer (optional)\n// =====================================================================\napi.get(\"/random\", async (c) => {\n try {\n const sort = c.req.query(\"sort\") ?? \"discount\";\n const retailerFilter = c.req.query(\"retailer\");\n const r = await getLeads({ limit: 100, page: 1, sort });\n let pool = r.data ?? [];\n if (retailerFilter) {\n const slug = retailerFilter.toLowerCase();\n pool = pool.filter((l) => l.retailer.toLowerCase() === slug);\n }\n if (pool.length === 0) return fail(c, 404, \"not_found\", \"No deals available for that filter.\");\n const pick = pool[Math.floor(Math.random() * pool.length)];\n return c.json({ success: true, deal: shapeDeal(pick) });\n } catch (e) {\n return handleError(c, e);\n }\n});\n\n// =====================================================================\n// GET /api/stock — per-store live stock for a SKU near a ZIP\n// ?retailer (def home_depot) ?sku (required) ?zip (required)\n// ?inStockOnly=true ?limit (cap stores returned)\n// =====================================================================\napi.get(\"/stock\", async (c) => {\n try {\n const sku = c.req.query(\"sku\");\n const zip = c.req.query(\"zip\");\n if (!sku || !zip) return fail(c, 400, \"bad_request\", \"Both 'sku' and 'zip' query params are required.\");\n\n const retailer = c.req.query(\"retailer\") ?? \"home_depot\";\n const inStockOnly = c.req.query(\"inStockOnly\") === \"true\";\n const limit = clampInt(c.req.query(\"limit\"), 100, 1, 200);\n\n const r = await getStock(retailer, sku, zip);\n let stores = (r.stores ?? []).slice();\n if (inStockOnly) stores = stores.filter((s) => s.inStock);\n stores.sort((a, b) => Number(b.inStock) - Number(a.inStock) || a.distance - b.distance);\n stores = stores.slice(0, limit);\n\n const inStockCount = (r.stores ?? []).filter((s) => s.inStock).length;\n return c.json({\n success: true,\n sku,\n zip,\n retailer: normalizeRetailer(retailer),\n retailerName: RETAILER_LABEL[normalizeRetailer(retailer)] ?? retailer,\n retailPrice: r.item?.retailPrice ?? null,\n summary: { totalStores: (r.stores ?? []).length, inStock: inStockCount },\n stores,\n });\n } catch (e) {\n return handleError(c, e);\n }\n});\n",[],[168,242],["D",1780206706547],[183,184,185],[168],["D",1780206706547],{"_107":106,"_114":109},{"_107":106,"_108":109,"_110":109,"_19":62,"_111":112,"_113":31},{"_13":92,"_38":93,"_50":49,"_94":51,"_95":96,"_97":98,"_99":57,"_100":101,"_102":103,"_104":52,"_105":106},"ctx",{"_85":-5,"_135":288,"_289":290,"_291":292,"_293":31,"_294":31,"_295":31,"_296":65,"_297":-5,"_298":-7,"_299":-7,"_300":69,"_301":31,"_302":31,"_303":-5,"_304":31,"_305":31,"_306":31,"_307":-5},"ENV",{"_259":260,"_261":262,"_263":93,"_264":265,"_266":267,"_268":269,"_270":271,"_272":273,"_274":275,"_276":277,"_278":279,"_280":281,"_282":283,"_284":285,"_286":287},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v6