DLX Designs

Bespoke menswear enquiry

Tell us what you need. Verified inquiries are handled personally.

\n\n \n\n

DLX Designs · Lagos & Abeokuta

\n\n \n \n\n",[18,126],"c1571bc2-1eae-4a07-9531-058b3b6dd68d",["D",1788452396724],[18,100],"pulls","branches","forks","envVars",{"_96":249,"_250":26},"connections",{"_96":26,"_248":26},"unfilledCount",3,"emptyCount",{"_36":547,"_13":477,"_77":472,"_46":-5,"_38":39,"_213":249,"_222":24,"_40":548,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":549,"_17":550},{"_36":543,"_13":526,"_77":520,"_46":472,"_38":39,"_213":249,"_222":24,"_40":544,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":545,"_17":546},{"_36":535,"_13":536,"_77":537,"_46":520,"_38":39,"_213":538,"_222":24,"_40":539,"_42":43,"_80":81,"_211":540,"_82":30,"_214":-5,"_296":541,"_17":542},{"_36":527,"_13":528,"_77":529,"_46":520,"_38":39,"_213":530,"_222":24,"_40":531,"_42":348,"_80":81,"_211":532,"_82":30,"_214":-5,"_296":533,"_17":534},{"_36":517,"_13":518,"_77":519,"_46":520,"_38":39,"_213":521,"_222":24,"_40":522,"_42":249,"_80":81,"_211":523,"_82":30,"_214":-5,"_296":524,"_17":525},{"_36":509,"_13":510,"_77":511,"_46":472,"_38":39,"_213":512,"_222":24,"_40":513,"_42":26,"_80":81,"_211":514,"_82":30,"_214":-5,"_296":515,"_17":516},{"_36":502,"_13":447,"_77":503,"_46":472,"_38":39,"_213":504,"_222":24,"_40":505,"_42":43,"_80":81,"_211":506,"_82":30,"_214":-5,"_296":507,"_17":508},{"_36":494,"_13":495,"_77":496,"_46":472,"_38":39,"_213":497,"_222":24,"_40":498,"_42":26,"_80":81,"_211":499,"_82":30,"_214":-5,"_296":500,"_17":501},{"_36":486,"_13":487,"_77":488,"_46":472,"_38":39,"_213":489,"_222":24,"_40":490,"_42":249,"_80":81,"_211":491,"_82":30,"_214":-5,"_296":492,"_17":493},{"_36":478,"_13":479,"_77":480,"_46":472,"_38":39,"_213":481,"_222":24,"_40":482,"_42":26,"_80":81,"_211":483,"_82":30,"_214":-5,"_296":484,"_17":485},{"_36":469,"_13":470,"_77":471,"_46":472,"_38":39,"_213":174,"_222":24,"_40":473,"_42":26,"_80":81,"_211":474,"_82":30,"_214":-5,"_296":475,"_17":476},{"_36":465,"_13":456,"_77":449,"_46":-5,"_38":39,"_213":450,"_222":24,"_40":466,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":467,"_17":468},{"_36":457,"_13":458,"_77":459,"_46":449,"_38":39,"_213":460,"_222":24,"_40":461,"_42":43,"_80":452,"_211":462,"_82":30,"_214":-5,"_296":463,"_17":464},{"_36":446,"_13":447,"_77":448,"_46":449,"_38":39,"_213":450,"_222":24,"_40":451,"_42":26,"_80":452,"_211":453,"_82":30,"_214":-5,"_296":454,"_17":455},{"_36":441,"_13":440,"_77":434,"_46":-5,"_38":39,"_213":442,"_222":24,"_40":443,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":444,"_17":445},{"_36":431,"_13":432,"_77":433,"_46":434,"_38":39,"_213":435,"_222":24,"_40":436,"_42":43,"_80":21,"_211":437,"_82":30,"_214":-5,"_296":438,"_17":439},{"_36":427,"_13":418,"_77":412,"_46":-5,"_38":39,"_213":422,"_222":24,"_40":428,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":429,"_17":430},{"_36":419,"_13":420,"_77":421,"_46":412,"_38":39,"_213":422,"_222":24,"_40":423,"_42":26,"_80":21,"_211":424,"_82":30,"_214":-5,"_296":425,"_17":426},{"_36":409,"_13":410,"_77":411,"_46":412,"_38":39,"_213":413,"_222":24,"_40":414,"_42":26,"_80":21,"_211":415,"_82":30,"_214":-5,"_296":416,"_17":417},{"_36":405,"_13":401,"_77":398,"_46":-5,"_38":39,"_213":399,"_222":24,"_40":406,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":407,"_17":408},{"_36":395,"_13":396,"_77":397,"_46":398,"_38":39,"_213":399,"_222":24,"_40":400,"_42":26,"_80":401,"_211":402,"_82":30,"_214":-5,"_296":403,"_17":404},{"_36":210,"_13":18,"_77":135,"_46":-5,"_38":39,"_213":43,"_222":24,"_40":392,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":393,"_17":394},{"_36":238,"_13":100,"_77":99,"_46":135,"_38":39,"_213":43,"_222":24,"_40":389,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":390,"_17":391},{"_36":380,"_13":381,"_77":382,"_46":99,"_38":39,"_213":383,"_222":24,"_40":384,"_42":385,"_80":81,"_211":386,"_82":30,"_214":-5,"_296":387,"_17":388},{"_36":372,"_13":373,"_77":374,"_46":99,"_38":39,"_213":375,"_222":24,"_40":376,"_42":43,"_80":81,"_211":377,"_82":30,"_214":-5,"_296":378,"_17":379},{"_36":364,"_13":365,"_77":366,"_46":99,"_38":39,"_213":367,"_222":24,"_40":368,"_42":26,"_80":81,"_211":369,"_82":30,"_214":-5,"_296":370,"_17":371},{"_36":234,"_13":126,"_77":125,"_46":135,"_38":39,"_213":129,"_222":24,"_40":361,"_42":43,"_80":21,"_211":236,"_82":30,"_214":-5,"_296":362,"_17":363},{"_36":230,"_13":89,"_77":88,"_46":135,"_38":39,"_213":43,"_222":24,"_40":358,"_42":26,"_80":21,"_211":232,"_82":30,"_214":-5,"_296":359,"_17":360},{"_36":226,"_13":79,"_77":78,"_46":135,"_38":39,"_213":43,"_222":24,"_40":355,"_42":26,"_80":81,"_211":228,"_82":30,"_214":-5,"_296":356,"_17":357},{"_36":221,"_13":95,"_77":94,"_46":135,"_38":39,"_213":104,"_222":24,"_40":352,"_42":43,"_80":81,"_211":224,"_82":30,"_214":-5,"_296":353,"_17":354},{"_36":347,"_13":346,"_77":340,"_46":-5,"_38":39,"_213":348,"_222":24,"_40":349,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":350,"_17":351},{"_36":337,"_13":338,"_77":339,"_46":340,"_38":39,"_213":341,"_222":24,"_40":342,"_42":43,"_80":81,"_211":343,"_82":30,"_214":-5,"_296":344,"_17":345},{"_36":333,"_13":324,"_77":318,"_46":-5,"_38":39,"_213":319,"_222":24,"_40":334,"_42":26,"_80":101,"_211":-5,"_82":30,"_214":-5,"_296":335,"_17":336},{"_36":325,"_13":326,"_77":327,"_46":318,"_38":39,"_213":328,"_222":24,"_40":329,"_42":26,"_80":81,"_211":330,"_82":30,"_214":-5,"_296":331,"_17":332},{"_36":315,"_13":316,"_77":317,"_46":318,"_38":39,"_213":319,"_222":24,"_40":320,"_42":26,"_80":81,"_211":321,"_82":30,"_214":-5,"_296":322,"_17":323},{"_36":308,"_13":309,"_77":310,"_46":-5,"_38":39,"_213":43,"_222":24,"_40":311,"_42":26,"_80":21,"_211":312,"_82":30,"_214":-5,"_296":313,"_17":314},{"_36":299,"_13":300,"_77":301,"_46":-5,"_38":39,"_213":302,"_222":24,"_40":303,"_42":304,"_80":21,"_211":305,"_82":30,"_214":-5,"_296":306,"_17":307},{"_36":289,"_13":290,"_77":147,"_46":-5,"_38":39,"_213":291,"_222":24,"_40":292,"_42":104,"_80":293,"_211":294,"_82":30,"_214":295,"_296":297,"_17":298},"47858962-a30d-4978-b3f8-7982cdfc2bad","index.ts",86,["D",1788499627158],"http","import { parseVal, serveFile, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\nimport {\n listLeads,\n setLeadStatus,\n stageDistribution,\n topSources,\n topSignals,\n} from \"./lib/store.ts\";\nimport { ingestLead } from \"./backend/worker/ingest.ts\";\nimport { nextStage } from \"./backend/pipeline.ts\";\nimport {\n verifyWebhook,\n handleEvent,\n listSignals,\n promoteSignal,\n} from \"./backend/instagram.ts\";\nimport {\n addProspect,\n listProspects,\n contactProspect,\n convertProspect,\n} from \"./backend/outbound.ts\";\n\nconst app = new Hono();\n\n// Serve the (never-cached) HTML shell at the root and as the dashboard\napp.get(\"/\", (c) => c.html(Root()));\napp.get(\"/dashboard\", (c) => c.html(Root()));\n\n// Standalone, embeddable lead-capture form (Option A: website ingestion)\napp.get(\"/capture\", (c) => serveFile(\"/frontend/capture.html\"));\n\n// Serve frontend files at the version-addressed URLs Root() stamps, cached immutably\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\n\n// View source redirect\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// --- Lead API -----------------------------------------------------------\n\n// GET verified (already-qualified) leads for the dashboard\napp.get(\"/api/leads\", async (c) => {\n const leads = await listLeads(100);\n return c.json(leads);\n});\n\n// POST an inbound lead: { name, gmail, message, source }\n// Runs the strict qualification engine. Only high-intent leads are stored;\n// budget seekers and duplicates are rejected (422) and never persisted.\napp.post(\"/api/ingest\", async (c) => {\n const body = await c.req.json().catch(() => undefined);\n const outcome = await ingestLead((body as object) ?? {});\n return c.json(outcome, outcome.decision === \"reject\" ? 422 : 201);\n});\n\n// Move a lead forward in the pipeline (or set any valid stage).\n// Automatically advances when no stage body is given (\"next\").\napp.post(\"/api/leads/:id/status\", async (c) => {\n const id = c.req.param(\"id\");\n const body = (await c.req.json().catch(() => undefined)) as\n | { stage?: unknown; note?: unknown }\n | undefined;\n const lead = await listLeads(200);\n const existing = lead.find((l) => l.id === id);\n if (!existing) return c.json({ error: \"lead not found\" }, 404);\n\n let target: string;\n if (body?.stage) {\n target = String(body.stage);\n } else {\n const nxt = nextStage(existing.status as never);\n if (!nxt) return c.json({ error: \"terminal stage\", lead: existing });\n target = nxt;\n }\n\n const updated = await setLeadStatus(id, target, String(body?.note ?? \"\"));\n return c.json(updated ?? { error: \"lead not found\" }, updated ? 200 : 404);\n});\n\n// Analytics — what actually converts (learn layer).\napp.get(\"/api/analytics\", async (c) => {\n const [stages, sources, signals] = await Promise.all([\n stageDistribution(),\n topSources(8),\n topSignals(8),\n ]);\n return c.json({ stages, sources, signals });\n});\n\n// --- Instagram webhook (Meta Business app required) -----------------------\n// GET: Meta's subscription verification handshake.\napp.get(\"/api/instagram/webhook\", async (c) => {\n const challenge = await verifyWebhook(c.req.query());\n if (challenge === null) return c.text(\"verification failed\", 403);\n return c.text(challenge);\n});\n\n// POST: Meta pushes real DM/comment events here.\napp.post(\"/api/instagram/webhook\", async (c) => {\n const body = await c.req.json().catch(() => null);\n if (!body) return c.json({ error: \"invalid payload\" }, 400);\n const stored = await handleEvent(body);\n return c.json({ ok: true, captured: stored });\n});\n\n// List captured Instagram signals (real messages, no fabricated contacts).\napp.get(\"/api/signals\", async (c) => c.json(await listSignals(50)));\n\n// Promote a signal to a VERIFIED lead once the email is captured.\napp.post(\"/api/signals/:id/promote\", async (c) => {\n const id = c.req.param(\"id\");\n const body = (await c.req.json().catch(() => undefined)) as\n | { email?: unknown; phone?: unknown }\n | undefined;\n const email = String(body?.email ?? \"\").trim();\n if (!email) return c.json({ ok: false, reason: \"email required\" }, 400);\n const out = await promoteSignal(id, email, String(body?.phone ?? \"\").trim());\n return c.json(out, out.ok ? 200 : 422);\n});\n\n// --- Prospecting automaton (Refine -> Act) -------------------------------\n\n// Add a REAL public signal as a prospect (handle + message, no fabricated contact).\napp.post(\"/api/prospects\", async (c) => {\n const body = (await c.req.json().catch(() => undefined)) as\n | { handle?: unknown; name?: unknown; email?: unknown; phone?: unknown; message?: unknown; source?: unknown; source_url?: unknown }\n | undefined;\n if (!body?.handle || !body?.message) {\n return c.json({ ok: false, reason: \"handle and message are required\" }, 400);\n }\n const p = await addProspect({\n handle: String(body.handle),\n name: body.name ? String(body.name) : undefined,\n email: body.email ? String(body.email) : undefined,\n phone: body.phone ? String(body.phone) : undefined,\n message: String(body.message),\n source: body.source ? String(body.source) : undefined,\n source_url: body.source_url ? String(body.source_url) : undefined,\n });\n return c.json({ ok: true, prospect: p }, 201);\n});\n\n// List the prospect queue, strongest intent first.\napp.get(\"/api/prospects\", async (c) => c.json(await listProspects(50)));\n\n// Auto-draft + (optionally) send the first touch. Dry-run by default.\napp.post(\"/api/prospects/:id/contact\", async (c) => {\n const id = c.req.param(\"id\");\n const out = await contactProspect(id);\n return c.json(out, out.ok ? 200 : 422);\n});\n\n// Confirm the contact for a prospect -> becomes a VERIFIED pipeline lead.\napp.post(\"/api/prospects/:id/convert\", async (c) => {\n const id = c.req.param(\"id\");\n const body = (await c.req.json().catch(() => undefined)) as\n | { email?: unknown; phone?: unknown }\n | undefined;\n const email = String(body?.email ?? \"\").trim();\n if (!email) return c.json({ ok: false, reason: \"email required\" }, 400);\n const out = await convertProspect(id, email, String(body?.phone ?? \"\").trim());\n return c.json(out, out.ok ? 200 : 422);\n});\n\n// --- Google Business Profile intake ---------------------------------------\n// Real GBP-originated inquiry (review, Q&A, message a VA/owner copies in).\n// Becomes a scored prospect in the Command Center, source-tagged, ready to\n// draft + convert. Coordinates: reviewer name/handle, message, optional contact.\napp.post(\"/api/gbp\", async (c) => {\n const body = (await c.req.json().catch(() => undefined)) as\n | { reviewer?: unknown; name?: unknown; email?: unknown; phone?: unknown; message?: unknown; star?: unknown; permalink?: unknown }\n | undefined;\n const message = String(body?.message ?? \"\").trim();\n if (!message) {\n return c.json({ ok: false, reason: \"message is required (the actual review/Q&A text)\" }, 400);\n }\n const reviewer = String(body?.reviewer ?? body?.name ?? \"\").trim() || \"gbp-reviewer\";\n const p = await addProspect({\n handle: reviewer,\n name: body?.name && String(body.name) !== reviewer ? String(body.name) : reviewer,\n email: body?.email ? String(body.email) : undefined,\n phone: body?.phone ? String(body.phone) : undefined,\n message,\n source: \"google-business-profile\",\n source_url: body?.permalink ? String(body.permalink) : undefined,\n });\n return c.json({ ok: true, prospect: p }, 201);\n});\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err) => Promise.reject(err));\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;\n","dlx-leads","children",[],[290],"45371fdf-4ad7-4045-9c9f-a1f064977147","README.md","01a06811-df40-730d-85ee-161b7548ebf9",87,["D",1788499645589],24,"# DLX Designs · Verified Lead Intelligence Engine\n\nProduction-ready lead-generation and **strict qualification** engine for DLX\nDesigns — a luxury bespoke traditional menswear brand targeting high-net-worth\nclients, grooms and corporate executives in Lagos & Abeokuta, Nigeria.\n\nIt ingests real inbound traffic, filters out low-budget seekers with strict\nsemantic rules, stores only verified high-intent leads, and renders them as\nscored lead cards in a live dashboard.\n\n> **Live dashboard:** [Try the app](url:index.ts)\n> **Ingest endpoint:** `POST /api/ingest`\n\n## Architecture\n\n```mermaid\ngraph LR\n Inbound[\"Web form / corridor
(blog, IG, ads)\"] -->|\"POST /api/ingest\"| Qual[\"Qualifier
backend/worker/qualifier.ts\"]\n Qual -->|\"hard reject\"| X[\"Low budget → dropped
never stored\"]\n Qual -->|\"optional\"| LLM[\"AI refine
(free tier, optional)\"]\n Qual -->|\"pass ≥ 50\"| Store[\"SQLite store
lib/store.ts\"]\n Store -->|\"optional mirror\"| Supabase[\"Supabase
dlx_verified_leads\"]\n Store -->|\"GET /api/leads\"| UI[\"React dashboard
frontend/\"]\n```\n\n- **Dashboard:** client-side React + Hono backend (App Router-equivalent), Twind/Tailwind styling.\n- **Database:** val-scoped PostgreSQL-compatible SQLite. **Supabase mirror optional.**\n- **Qualifier:** deterministic heuristic (zero-config) + optional free-tier AI refinement.\n\n## The strict qualification engine\n\nRuns in `backend/worker/qualifier.ts` and never fabricates data.\n\n**Layer 1 — hard disqualifiers (instant reject):** `cheap`, `affordable`,\n`under 20k`/`20k`, `discount`, `thrift`, `okirika`.\n\n**Layer 2 — scoring matrix (0–100):** baseline 25, high-tier signals add points —\n`bespoke` +18, `groom`/`chieftaincy` +20, `cashmere` +15, `wedding` +14,\n`3-piece` +12, `executive` +14, `lekki`/`victoria island` +10, `lagos`/`abeokuta`\n+6, etc. **Pass threshold: ≥ 50.** Sub-threshold leads are rejected.\n\n**Layer 3 — AI refinement (optional, zero-config by default):** the engine is\n**deterministic-first** — the strict heuristic above is authoritative and needs\n**no AI key, no external call, no cost**, so no provider can ever block it. If\nyou add a free-tier key, that provider refines the score and writes a natural\nbuying signal (tried in order: `GEMINI_API_KEY`, `GROQ_API_KEY`, `OPENAI_API_KEY`).\nA provider failing just falls back to the heuristic — never an error.\n\n### Endpoints\n\n| Method | Path | Purpose |\n| --- | --- | --- |\n| `GET` | `/` | Dashboard |\n| `GET` | `/dashboard` | Dashboard (alias) |\n| `GET` | `/api/leads` | Verified leads (JSON, strongest first) |\n| `POST` | `/api/ingest` | Ingest & qualify an inbound lead — 201 on pass, 422 on reject |\n| `POST` | `/api/leads/:id/status` | Advance pipeline stage (or set one) — records history |\n| `GET` | `/api/analytics` | Pipeline / source / signal analytics (the learn layer) |\n\n`POST /api/ingest` request body:\n\n```json\n{\n \"name\": \"Oluwatosin Adeyemi\",\n \"gmail\": \"tosin@example.com\",\n \"source\": \"nigerianmenswear.com\",\n \"message\": \"I need a bespoke 3-piece groom suit for my chieftaincy ceremony in Abeokuta\"\n}\n```\n\nOnly passing leads persist. Rejected and duplicate leads are returned (422) and\nnever stored.\n\n## The growth engine loop\n\nA verified lead is more than a row — it is a story with evidence:\n\n1. **Hunt** — `cron/hunt.ts` polls a real configured source (`DLX_HUNT_URL`)\n and feeds genuinely captured inquiries through the qualifier. It never\n invents people or signals; rows without evidence are ignored.\n2. **Verify** — every lead records where it came from (`source`, `source_url`),\n exactly what was said (`evidence`), and when (`created_at`).\n3. **Qualify** — strict scoring (0–100); only ≥ 50 passes.\n4. **Prioritize** — the dashboard sorts strongest first and shows live pipeline counts.\n5. **Recommend** — each lead carries a `action`, chosen from the actual signal:\n book consultation, contact to confirm budget, or nurture.\n6. **Track** — leads move through `new → qualified → contacted → responded →\n consultation → quoted → deposit_paid → ordered → won/lost`. Every transition\n is recorded in `history`.\n7. **Learn** — `/api/analytics` reports conversion by stage and top sources and\n signals that actually produce qualified opportunities.\n\n## Capture & feed real inquiries (get it live today)\n\n**Option A — website ingestion.** A ready, branded enquiry form is hosted at\n`/capture` (or embedded by iframing it). It posts each submission to\n`/api/ingest`, which qualifies and stores it. Direct API for a custom site:\n\n```http\nPOST https://dlx-leads.val.run/api/ingest\nContent-Type: application/json\n\n{ \"name\": \"…\", \"gmail\": \"…\", \"phone\": \"…\", \"message\": \"…\", \"source\": \"…\", \"source_url\": \"…\" }\n```\n\n**Option C — JSON / Google Sheet feed (autonomous, scheduled every 15 min).**\nThe hunt poller accepts a **published Google Sheet CSV** directly, no code:\n\n1. In your sheet, make row 1 a header that includes `gmail` (plus optional\n `name`, `phone`, `message`, `source`, `source_url`).\n2. **File → Share → Publish to web →** choose the sheet → format **CSV** → copy the link.\n3. Set that link as `DLX_HUNT_URL` (and `DLX_HUNT_TOKEN` if it's private/behind auth).\n\nEach run, the engine ingests every new row, qualifies it, and skips duplicates.\nRows without an email are ignored — nothing is invented.\n\n**Option B — email intake (live inbound hunting).** Forward any organic inquiry\n(DM, WhatsApp, web message, marketplace lead) to the engine's email address and\nit is qualified, evidence-tagged, and tracked automatically:\n\n```\ndlxdesigns-e7b272d2a81611f19be51607ee4eb77e@valtown.email\n```\n\nSee [`docs/growth-corridors.md`](docs/growth-corridors.md) for the **50-verified\ngrowth corridors** (marketplaces, fashion platforms, directories, fashion-week\nhubs, forums, and press) — each mapped to an acquisition, observation, or\npartnership role the engine can consume.\n\n## Connect Instagram (real DM/comment capture)\n\nThe engine side is built and tested. To connect Meta (one-time, your login):\n\n1. Create a **Meta for Developers app** (https://developers.facebook.com).\n2. Add the **Instagram product** and connect your **Instagram Business account**.\n3. Create a token with the `instagram_business_basic`, `instagram_business_manage_messages`,\n and `pages_messaging` permissions (a **long-lived User or Page token**).\n4. Set these on the val:\n 👉 Add INSTAGRAM_VERIFY_TOKEN here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=INSTAGRAM_VERIFY_TOKEN\n 👉 Add META_APP_SECRET here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=META_APP_SECRET\n5. In **Meta → Developer App → Webhooks**, subscribe the **Instagram** object to\n the callback URL:\n `https://dlx-leads.val.run/api/instagram/webhook`\n using your **INSTAGRAM_VERIFY_TOKEN** as the verify token.\n\nReal DMs/comments then push into the engine automatically. Because Instagram\nDMs carry no email, each becomes a **signal** (`/api/signals`); reply to capture\nthe email, then promote it to a verified lead with\n`POST /api/signals/:id/promote`.\n\n## Google Business Profile (real local-channel capture)\n\nReviews, Q&A, and \"do you make…\" messages on your Google Business Profile are\nhigh-intent local signals. Capture them in one call — they become scored\nprospects source-tagged `google-business-profile` in the Command Center, ready\nto draft and convert:\n\n```http\nPOST https://dlx-leads.val.run/api/gbp\nContent-Type: application/json\n\n{ \"reviewer\": \"Adaeze Okafor\", \"message\": \"Do you make bespoke 3-piece groom suits for Lagos weddings?\", \"email\": \"…\", \"phone\": \"…\", \"permalink\": \"https://maps.google.com/…\" }\n```\n\nManual route (no credentials): a VA or owner copies each new review/Q&A/message\nand posts it to `/api/gbp` (or the dashboard capture form with\n`source: google-business-profile`), and the automaton takes it from there.\nAutomated pull of your GBP inbox requires Google OAuth on your account — that\npart is yours to connect when ready; everything after capture is handled here.\n\n## Configuration (environment variables)\n\nEverything runs out of the box with **zero environment variables**. The\nqualification engine is fully deterministic. The following optional keys unlock\nthe AI refinement layer (free tiers are preferred — none require billing) and\nthe Supabase mirror:\n\n- **`GEMINI_API_KEY`** — free tier (Google AI Studio key, no card required). Recommended.\n- **`GROQ_API_KEY`** — free tier. Ignored unless Gemini is absent or fails.\n- **`OPENAI_API_KEY`** — requires active OpenAI billing; only used as a last resort.\n- **`SUPABASE_URL`** + **`SUPABASE_SERVICE_ROLE_KEY`** — mirror verified leads to\n your Supabase `dlx_verified_leads` table (native SQLite store stays authoritative).\n- **`DLX_HUNT_URL`** — JSON **or published-CSV** feed the hunt poller watches\n for genuine inquiries (JSON: `{ \"leads\": [ { name, gmail, phone, message, source, source_url } ] }`).\n- **`DLX_HUNT_TOKEN`** — optional bearer token sent to the hunt source (`Authorization: Bearer …`).\n- **`INSTAGRAM_VERIFY_TOKEN`** — random string you invent; Meta must echo it on webhook verification.\n- **`META_APP_SECRET`** — optional; enables `X-Hub-Signature-256` verification on Instagram webhooks.\n- **`DLX_BRAND_NAME`** — whitelabel brand shown in capture copy + drafts (default: `DLX Designs`).\n- **`ENABLE_AUTOSEND`** — set to `1` to let the nurture automaton actually email first touches; OFF (dry-run) by default.\n\n👉 Add GEMINI_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=GEMINI_API_KEY\n👉 Add GROQ_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=GROQ_API_KEY\n👉 Add OPENAI_API_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=OPENAI_API_KEY\n👉 Add SUPABASE_URL here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=SUPABASE_URL\n👉 Add SUPABASE_SERVICE_ROLE_KEY here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=SUPABASE_SERVICE_ROLE_KEY\n👉 Add DLX_HUNT_URL here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=DLX_HUNT_URL\n👉 Add DLX_HUNT_TOKEN here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=DLX_HUNT_TOKEN\n👉 Add INSTAGRAM_VERIFY_TOKEN here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=INSTAGRAM_VERIFY_TOKEN\n👉 Add META_APP_SECRET here: https://www.val.town/x/dlxdesigns/dlx-lead-engine/environment-variables?key=META_APP_SECRET\n\n### Supabase setup (optional)\n\nCreate the mirror table by running [`database/schema.sql`](database/schema.sql)\nin the Supabase SQL editor. The table uses `gen_random_uuid()` ids, enforces a\n`score BETWEEN 0 AND 100` check, has a `gmail UNIQUE` constraint, and enables\nRow-Level Security (locked to service-role access by default). The val writes\nvia PostgREST with the service-role key and `resolution=merge-duplicates`.\n\n## File structure\n\n```\ndatabase/\n schema.sql ← Supabase/PostgreSQL schema (mirror table)\nbackend/\n config.ts ← whitelabel brand + runtime config\n pipeline.ts ← sales pipeline stages + next-stage logic\n hunt.ts ← autonomous ingestion from a real configured source\n outbound.ts ← prospect queue: score, auto-draft, guarded send, convert\n instagram.ts ← Meta webhook receiver for real IG DMs/comments\n worker/\n qualifier.ts ← strict qualification engine (disqualifiers + scoring)\n ingest.ts ← ingest worker (bridge inbound → store)\n llm.ts ← optional AI adapter (free tier Gemini / Groq / OpenAI)\ncron/\n hunt.ts ← scheduled hunt poller (every 15 min)\n automate.ts ← nurture automaton: nudge hot leads + auto-send (guarded)\nemail/\n lead-intake.ts ← email-triggered lead intake (forward inquiries here)\ndocs/\n growth-corridors.md ← 50 acquisition/observation/partnership corridors\n operating-model.md ← how the automaton runs + per-client deployment model\nlib/\n store.ts ← SQLite persistence + Supabase mirror + pipeline + analytics\nfrontend/\n components/App.tsx ← dashboard layout + empty state + pipeline strip\n components/LeadCard.tsx ← verified-lead card with evidence, action & stage\n components/LeadForm.tsx ← inline lead-capture form\nscripts/\n selftest.ts ← end-to-end qualifier + store self-test\nindex.ts ← Hono HTTP backend (dashboard + /api/*)\n```\n\n## Integrity guarantees\n\n- **No hardcoded, fake, or mock contacts anywhere.** Every record comes from a\n real `POST /api/ingest` submission that passed strict qualification.\n- Empty store → dashboard shows *“Awaiting live inbound high-intent signals…”*,\n never fake cards.\n- Duplicate emails are rejected (UNIQUE), budget seekers are dropped, sub-50\n intent is dropped.\n\n## Running the self-test\n\n`scripts/selftest.ts` exercises the full pipeline with synthetic example inputs\n(high-intent pass, low-budget reject, no-signal reject, duplicate reject) and is\nsafe to run repeatedly.\n",[],[300],"a130fa68-e89b-4e79-b351-ae119f51052e","CHANGELOG.md","01a06811-df40-730d-85ee-12df63d9ba38",["D",1788452396724],"# Changelog\n\n## 2026-07-30 — Immutable asset caching\n\nFrontend files are now served at version-addressed URLs\n(`/__immutable/45/frontend/index.tsx`) with\n`Cache-Control: public, max-age=31536000, immutable`, so repeat visits load the\nwhole client graph from the browser cache — roughly 3× faster (~665ms → ~157ms\nmeasured). Publishing your val bumps its version, which changes every URL, so\ncaches invalidate automatically. Old-version URLs return 404 after a publish\n(like Next.js build assets); a reload picks up the new version.\n\nWhat changed in the template:\n\n- `frontend/index.html` → [`frontend/root.tsx`](/frontend/root.tsx): the HTML\n shell is now JSX and stamps asset URLs with `immutableFileUrl()`\n- [`index.ts`](/index.ts): serves `Root()` at `/`, and one\n `app.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path))` route\n serves all frontend files\n\n### Upgrading an existing remix\n\nYour copy of this template doesn't update automatically. Two options:\n\n**Minimal (most of the benefit):** point both routes at `serveImmutableFile` —\nyour existing bare URLs redirect into versioned space, the new route serves\nthem, and the whole module graph gets cached (costs one redirect per page view):\n\n```ts\nimport { serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\n\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/frontend/**/*\", (c) => serveImmutableFile(c.req.path)); // was serveFile\n```\n\n**Full upgrade (also removes the redirect):** three self-contained steps —\nno other files needed. Adjust the ``, favicon, and body of `Root()` to\nmatch your app's existing `index.html`, and stamp anything else your shell\nreferences directly (images, css) with `immutableFileUrl()`.\n\n1. Create `frontend/root.tsx`:\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\n// The HTML shell for the app. It is never cached, so immutableFileUrl can stamp\n// the current val version into each asset URL — the browser caches those\n// immutably, and publishing the val changes the URLs, refetching exactly once.\nexport function Root() {\n return (\n <>\n {raw(\"<!DOCTYPE html>\")}\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>React Hono Val Town Starter\n

History · frontend