${variant.creative.subhead}
\n \n `;\n el.querySelector('button')!.addEventListener('click', () => {\n ctx.sdk.trackConversion({ decisionId: ctx.decisionId, outcomeName: 'newsletter_signup' });\n ctx.sdk.unmount(ctx.decisionId);\n });\n ctx.target.appendChild(el);\n return { unmount: () => el.remove() };\n },\n});\n\n// Once per page. SDK does everything else.\nclient.observe([\n { name: 'newsletter', target: () => document.getElementById('newsletter-slot') },\n { name: 'cross_promo', target: () => document.getElementById('cross-promo-slot') },\n]);\n```\n\nThat's it. The operator hardcodes nothing about *when* to show — variants carry their trigger config, set by the AI generator or by the operator in the wizard. The platform's bandit (Phase 2+) learns which trigger+variant combo wins per audience.\n\n### What `observe()` does behind the scenes\n\n| Step | Detail |\n|---|---|\n| 1. Telemetry start | Fires `page-view` event (URL, referrer, locale, device class, viewport). Arms scroll-depth milestones (25/50/75/100%) and a 30s dwell pulse. |\n| 2. Decisions | Calls `/v1/decide` once per slot with the SDK-managed `anonymous_id` + your `context`. |\n| 3. Trigger install | Reads the variant's `trigger` (immediate / scroll / dwell / idle / exit-intent / custom-event) and installs the matching listener. |\n| 4. Render | When the trigger fires, the SDK looks up the slot's `target`, calls the render adapter, fires the impression event server-side (via decision-service). |\n| 5. Cleanup | `stopObserving()` tears down all listeners. Call it on SPA route change before the next `observe()`. |\n\n### Custom trigger from your code\n\nIf a variant uses `custom-event` type, dispatch the matching event from your own code at the right moment:\n\n```ts\n// Variant has trigger { type: 'custom-event', name: 'puzzle:completed' }\ndocument.dispatchEvent(new CustomEvent('puzzle:completed'));\n```\n\nThis lets you bridge app-specific moments into the platform's trigger model without hardcoding \"when\" elsewhere.\n\n## Manual mode — single decision\n\nWhen you want to control `/decide` explicitly (e.g. server-rendered slots, deferred mount):\n\n```ts\nawait client.decideAndRender({\n slot: 'newsletter',\n context: { page: { topic: 'finance' } },\n target: document.getElementById('newsletter-slot')!,\n});\n```\n\nReturns the `DecideResponse` so you can inspect or skip rendering yourself.\n\n## Anonymous ID + consent\n\n- **Anonymous ID** is generated on first call, stored in `localStorage` (1-year sliding expiry), falls back to cookie, then to per-page UUID.\n- **Consent gating** — when `consent.behavioral` is `false`, the SDK omits the persisted `anonymous_id` (sends `\"anonymous\"`) so decisions are context-only.\n- **Update at runtime** — `client.setConsent({ behavioral: true, cookies: true })`. Existing cached decisions are not invalidated.\n\n## Telemetry events fired automatically\n\n| Event | When | Payload |\n|---|---|---|\n| `engagement:page_view` | Every `observe()` call | URL, referrer, locale, device class, viewport |\n| `engagement:scroll_depth` | Crossing 25 / 50 / 75 / 100% | `depth_pct` |\n| `engagement:dwell_pulse` | Every 30s while tab is foreground | `interval_ms` |\n| `impression` | When a variant renders | Server-emitted by decision-service |\n\nManual events (call from your code):\n\n```ts\nclient.trackEngagement({ decisionId, engagementType: 'click', payload: { target: 'cta' } });\nclient.trackConversion({ decisionId, outcomeName: 'newsletter_signup', value: 1.0 });\nclient.trackDismiss({ decisionId, dismissedAfterMs: 4200 });\n```\n\n## Render adapter contract\n\n```ts\ntype RenderAdapter = (\n variant: Variant,\n ctx: { decisionId: string; target: HTMLElement; sdk: DecisioningClientApi },\n) => Promise<{ unmount: () => void } | void> | { unmount: () => void } | void;\n```\n\nReturn `{ unmount }` so `client.unmount(decisionId)` can clean up on route change.\n\n## What the SDK doesn't do\n\n- Bundle any framework. Render adapters are the framework boundary.\n- Retry failed `/v1/decide` (1000ms timeout by default, then cache fallback or no-op — retries hurt conversion more than they help). Override with `timeoutMs`.\n- Block page load. Initialize early; lazy slot targets are fine.\n\n## What a variant looks like (generic creative shape)\n\nA variant returned from `/v1/decide` carries everything needed to\nrender an end-to-end UX, not just copy:\n\n```ts\n{\n variant_id: \"v_xxx\",\n slot: \"newsletter\",\n format: \"modal\" | \"slide-in\" | \"inline\" | ...,\n placement: \"...\",\n tags: [...],\n creative: {\n headline: string,\n subhead: string,\n cta: string,\n kind?: \"newsletter\" | \"discount\" | \"upsell\" | \"lead_capture\" | \"survey\" | \"announcement\",\n fields?: Array<{ type: \"email\" | \"text\" | \"textarea\" | \"tel\", name, label?, placeholder?, required? }>,\n submit?:\n | { kind: \"mailflix\" }\n | { kind: \"external_link\", url: string }\n | { kind: \"webhook\", url: string }\n | { kind: \"none\" },\n success_message?: string,\n trigger?: { type, ... },\n }\n}\n```\n\nRender adapters can read `creative.fields` + `creative.submit` and\nbuild the form dynamically. See the host-app example in\n[examples/](examples/) for a reference adapter that handles all four\nsubmit kinds.\n\nThe full schema + examples live in\n[`decisions/docs/VARIANT_CREATIVE_SHAPE.md`](https://github.com/bakaburg24/identity/blob/main/docs/VARIANT_CREATIVE_SHAPE.md).\n\n## Changelog\n\n### 0.1.5 — Forward all form values downstream\n\nThe bundled default renderer's Mailflix POST previously dropped\nevery form field except `email` and `name`. For survey or\nlead-capture variants with a textarea, the actual response\ncontent (typed by the user) was sent to the platform's\nconversion event payload but never reached Mailflix's metadata\n— so the operator could see \"someone converted\" but not what\nthey actually said.\n\nNow: every non-email/name form value gets nested into Mailflix's\nmetadata blob alongside `decision_id` + `variant_id`, so survey\nresponses are recoverable from Mailflix's subscriber UI. (Same\ndata also lands in the platform's events warehouse via\ntrackConversion's `properties` field — that's now visible on\nthe portal's decision drawer via a new \"Response\" card.)\n\n### 0.1.4 — One-file embed\n\nThe SDK now ships a bundled vanilla-DOM renderer that handles every\nvariant format (modal, slide-in, inline, bottombar, topbar) and submit\nkind (mailflix, external_link, webhook, none) without operator code.\n`renderAdapter` is now optional on the client constructor; `observe()`\ncan be called with no arguments and auto-discovers slots from the DOM\n(elements with `data-decisioning-slot=\"