@appfunnel-dev/sdk 2.0.0-canary.0 → 2.0.0-canary.2

package/dist/manifest-entry.cjs

@@ -0,0 +1,203 @@
+'use strict';
+
+var chunkZ3TWO2PW_cjs = require('./chunk-Z3TWO2PW.cjs');
+var chunkLJYLGLFS_cjs = require('./chunk-LJYLGLFS.cjs');
+
+// src/flow/scaffold.ts
+var DRIVERS = {
+  stripe: { name: "stripeCheckoutDriver", sub: "driver-stripe" },
+  paddle: { name: "paddleCheckoutDriver", sub: "driver-paddle" }
+};
+var HEADER = "// GENERATED by AppFunnel \u2014 do not edit. Built from funnel.ts + the pages/ folder.\n";
+function generateMount(opts) {
+  const p = opts.importPrefix ?? "./";
+  const driver = opts.checkout ? DRIVERS[opts.checkout] : null;
+  const imports = [
+    `import { createFunnelTree, type MountOpts, type RuntimePage } from '@appfunnel-dev/sdk'`,
+    driver && `import { ${driver.name} } from '@appfunnel-dev/sdk/${driver.sub}'`,
+    `import { config } from '${p}funnel'`,
+    opts.hasLayout && `import Layout from '${p}layout'`
+  ].filter(Boolean).join("\n");
+  const loaders = opts.pageKeys.map(
+    (k) => `	${JSON.stringify(k)}: () => import(${JSON.stringify(`${p}pages/${k}`)}),`
+  ).join("\n");
+  const treeArgs = [
+    "config",
+    "pages",
+    opts.hasLayout && "layout: Layout",
+    driver && `checkoutDriver: ${driver.name}`
+  ].filter(Boolean).join(", ");
+  return `${HEADER}${imports}
+
+const loaders: Record<string, () => Promise<unknown>> = {
+${loaders}
+}
+
+// Flow pages come from funnel.ts (order + meta + routing). Any remaining page file is an off-flow
+// \`@variant\` page (wired by experiment records at render time), appended so it's loadable.
+const decls = config.pages ?? []
+const flowKeys = new Set(decls.map((d) => d.key))
+export const pages: RuntimePage[] = [
+	...decls.map((d) => ({ key: d.key, meta: d, load: loaders[d.key] })),
+	...Object.keys(loaders)
+		.filter((k) => !flowKeys.has(k))
+		.map((k) => ({ key: k, meta: {}, load: loaders[k] })),
+] as RuntimePage[]
+
+export const tree = createFunnelTree({ ${treeArgs} })
+
+export type { MountOpts }
+`;
+}
+function generateEntryClient(opts) {
+  const p = opts.importPrefix ?? "./";
+  const styles = opts.hasStyles ? `import '${p}styles.css'
+` : "";
+  return `${HEADER}${styles}import { hydrateRoot } from 'react-dom/client'
+import { tree, type MountOpts } from './mount'
+
+const dataEl = document.getElementById('__af_data')
+const data = (dataEl?.textContent ? JSON.parse(dataEl.textContent) : {}) as MountOpts & {
+	initialKey?: string | null
+}
+const root = document.getElementById('root')
+if (root) hydrateRoot(root, tree({ ...data, initialKey: data.initialKey ?? undefined }))
+`;
+}
+function generateEntryServer(opts) {
+  const p = opts.importPrefix ?? "./";
+  return `${HEADER}import { renderToReadableStream } from 'react-dom/server.browser'
+import { compileManifest } from '@appfunnel-dev/sdk'
+import { config } from '${p}funnel'
+import { tree, pages, type MountOpts } from './mount'
+
+export const manifest = compileManifest({
+	funnel: config,
+	pages: pages.map((pg) => ({ key: pg.key, meta: pg.meta })),
+})
+
+export async function ssr(opts: MountOpts): Promise<string> {
+	const stream = await renderToReadableStream(tree(opts))
+	await stream.allReady
+	return await new Response(stream).text()
+}
+`;
+}
+function generateDevEntry(opts) {
+  const p = opts.importPrefix ?? "./";
+  const styles = opts.hasStyles ? `import '${p}styles.css'
+` : "";
+  return `${HEADER}${styles}import { createRoot } from 'react-dom/client'
+import { tree } from './mount'
+
+const el = document.getElementById('root')
+if (el) createRoot(el).render(tree(${JSON.stringify(opts.data)}))
+`;
+}
+
+Object.defineProperty(exports, "assignVariant", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.assignVariant; }
+});
+Object.defineProperty(exports, "bucketingSeed", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.bucketingSeed; }
+});
+Object.defineProperty(exports, "buildCatalog", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.buildCatalog; }
+});
+Object.defineProperty(exports, "compileManifest", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.compileManifest; }
+});
+Object.defineProperty(exports, "currencyExponent", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.currencyExponent; }
+});
+Object.defineProperty(exports, "defineFunnel", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.defineFunnel; }
+});
+Object.defineProperty(exports, "formatMoney", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.formatMoney; }
+});
+Object.defineProperty(exports, "formatProduct", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.formatProduct; }
+});
+Object.defineProperty(exports, "isRtl", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.isRtl; }
+});
+Object.defineProperty(exports, "isVariantKey", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.isVariantKey; }
+});
+Object.defineProperty(exports, "pageMeta", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.pageMeta; }
+});
+Object.defineProperty(exports, "parseSlotKey", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.parseSlotKey; }
+});
+Object.defineProperty(exports, "resolveLocale", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.resolveLocale; }
+});
+Object.defineProperty(exports, "resolveProduct", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.resolveProduct; }
+});
+Object.defineProperty(exports, "validateExperiments", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.validateExperiments; }
+});
+Object.defineProperty(exports, "weightsOf", {
+  enumerable: true,
+  get: function () { return chunkZ3TWO2PW_cjs.weightsOf; }
+});
+Object.defineProperty(exports, "INLINE_SURFACES", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.INLINE_SURFACES; }
+});
+Object.defineProperty(exports, "PROVIDER_PROFILES", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.PROVIDER_PROFILES; }
+});
+Object.defineProperty(exports, "checkoutError", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.checkoutError; }
+});
+Object.defineProperty(exports, "isInlineSurface", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.isInlineSurface; }
+});
+Object.defineProperty(exports, "isMerchantOfRecord", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.isMerchantOfRecord; }
+});
+Object.defineProperty(exports, "isOrchestrator", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.isOrchestrator; }
+});
+Object.defineProperty(exports, "surfacesFor", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.surfacesFor; }
+});
+Object.defineProperty(exports, "validateCheckout", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.validateCheckout; }
+});
+Object.defineProperty(exports, "validateUpsell", {
+  enumerable: true,
+  get: function () { return chunkLJYLGLFS_cjs.validateUpsell; }
+});
+exports.generateDevEntry = generateDevEntry;
+exports.generateEntryClient = generateEntryClient;
+exports.generateEntryServer = generateEntryServer;
+exports.generateMount = generateMount;
+//# sourceMappingURL=manifest-entry.cjs.map
+//# sourceMappingURL=manifest-entry.cjs.map

package/dist/manifest-entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flow/scaffold.ts"],"names":[],"mappings":"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","file":"manifest-entry.cjs","sourcesContent":["/**\n * Source generators for the funnel build \"machinery\" authors no longer write. `funnel.ts` (the\n * spine: id, responses, products, checkout, and the page list + declarative routing) plus the\n * `pages/` folder are the ONLY authored source. The build (renderer/builder) and the CLI dev server\n * call these to synthesize:\n *   - `mount.tsx`         — code-split page loaders + `createFunnelTree`\n *   - `entry.client.tsx`  — hydrate the SSR'd markup from injected data\n *   - `entry.server.tsx`  — `ssr()` + the compiled `manifest`\n *\n * All string templates, zero runtime deps — this module lives in the pure `@appfunnel-dev/sdk/\n * manifest` entry so tooling imports it without the funnel runtime.\n */\n\nexport interface ScaffoldOptions {\n\t/** Page component keys = `pages/<key>.tsx` filenames (base flow pages AND `@variant` pages). */\n\tpageKeys: string[]\n\t/** Import prefix to reach the funnel root: `'./'` at the root (build), `'../../'` in a subdir (CLI dev). */\n\timportPrefix?: string\n\t/** Whether a `layout.tsx` exists to wrap the pages. */\n\thasLayout?: boolean\n\t/** Whether a `styles.css` exists (client entry imports it). */\n\thasStyles?: boolean\n\t/** Checkout provider from `config.checkout` — wires the driver; omit for none. */\n\tcheckout?: 'stripe' | 'paddle' | null\n}\n\nconst DRIVERS = {\n\tstripe: { name: 'stripeCheckoutDriver', sub: 'driver-stripe' },\n\tpaddle: { name: 'paddleCheckoutDriver', sub: 'driver-paddle' },\n} as const\n\nconst HEADER = '// GENERATED by AppFunnel — do not edit. Built from funnel.ts + the pages/ folder.\\n'\n\n/** `mount.tsx` — the code-split loaders + tree, derived from `config.pages` and the `pages/` files. */\nexport function generateMount(opts: ScaffoldOptions): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst driver = opts.checkout ? DRIVERS[opts.checkout] : null\n\n\tconst imports = [\n\t\t`import { createFunnelTree, type MountOpts, type RuntimePage } from '@appfunnel-dev/sdk'`,\n\t\tdriver && `import { ${driver.name} } from '@appfunnel-dev/sdk/${driver.sub}'`,\n\t\t`import { config } from '${p}funnel'`,\n\t\topts.hasLayout && `import Layout from '${p}layout'`,\n\t]\n\t\t.filter(Boolean)\n\t\t.join('\\n')\n\n\t// A static import() per page file so Vite emits one code-split chunk each.\n\tconst loaders = opts.pageKeys\n\t\t.map(\n\t\t\t(k) => `\\t${JSON.stringify(k)}: () => import(${JSON.stringify(`${p}pages/${k}`)}),`\n\t\t)\n\t\t.join('\\n')\n\n\tconst treeArgs = [\n\t\t'config',\n\t\t'pages',\n\t\topts.hasLayout && 'layout: Layout',\n\t\tdriver && `checkoutDriver: ${driver.name}`,\n\t]\n\t\t.filter(Boolean)\n\t\t.join(', ')\n\n\treturn `${HEADER}${imports}\n\nconst loaders: Record<string, () => Promise<unknown>> = {\n${loaders}\n}\n\n// Flow pages come from funnel.ts (order + meta + routing). Any remaining page file is an off-flow\n// \\`@variant\\` page (wired by experiment records at render time), appended so it's loadable.\nconst decls = config.pages ?? []\nconst flowKeys = new Set(decls.map((d) => d.key))\nexport const pages: RuntimePage[] = [\n\t...decls.map((d) => ({ key: d.key, meta: d, load: loaders[d.key] })),\n\t...Object.keys(loaders)\n\t\t.filter((k) => !flowKeys.has(k))\n\t\t.map((k) => ({ key: k, meta: {}, load: loaders[k] })),\n] as RuntimePage[]\n\nexport const tree = createFunnelTree({ ${treeArgs} })\n\nexport type { MountOpts }\n`\n}\n\n/** `entry.client.tsx` — hydrate the SSR'd markup from the injected `#__af_data`. */\nexport function generateEntryClient(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst styles = opts.hasStyles ? `import '${p}styles.css'\\n` : ''\n\treturn `${HEADER}${styles}import { hydrateRoot } from 'react-dom/client'\nimport { tree, type MountOpts } from './mount'\n\nconst dataEl = document.getElementById('__af_data')\nconst data = (dataEl?.textContent ? JSON.parse(dataEl.textContent) : {}) as MountOpts & {\n\tinitialKey?: string | null\n}\nconst root = document.getElementById('root')\nif (root) hydrateRoot(root, tree({ ...data, initialKey: data.initialKey ?? undefined }))\n`\n}\n\n/** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */\nexport function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix'>): string {\n\tconst p = opts.importPrefix ?? './'\n\treturn `${HEADER}import { renderToReadableStream } from 'react-dom/server.browser'\nimport { compileManifest } from '@appfunnel-dev/sdk'\nimport { config } from '${p}funnel'\nimport { tree, pages, type MountOpts } from './mount'\n\nexport const manifest = compileManifest({\n\tfunnel: config,\n\tpages: pages.map((pg) => ({ key: pg.key, meta: pg.meta })),\n})\n\nexport async function ssr(opts: MountOpts): Promise<string> {\n\tconst stream = await renderToReadableStream(tree(opts))\n\tawait stream.allReady\n\treturn await new Response(stream).text()\n}\n`\n}\n\n/** Client-only dev entry (createRoot, no SSR) — for the CLI `dev` server. */\nexport function generateDevEntry(\n\topts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'> & { data: unknown }\n): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst styles = opts.hasStyles ? `import '${p}styles.css'\\n` : ''\n\treturn `${HEADER}${styles}import { createRoot } from 'react-dom/client'\nimport { tree } from './mount'\n\nconst el = document.getElementById('root')\nif (el) createRoot(el).render(tree(${JSON.stringify(opts.data)}))\n`\n}\n"]}

package/dist/manifest-entry.d.cts

@@ -0,0 +1,184 @@
+export { i as CompileInput, j as Condition, k as ConditionOp, E as EdgeCondition, m as ExperimentIssue, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, c as FunnelDefinition, r as FunnelLocales, s as FunnelManifest, ai as FunnelPage, b as FunnelSnapshot, G as Gate, t as Interval, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, f as PageMeta, x as PageType, y as Predicate, P as Product, e as ProductInput, z as ResolvedProduct, H as Route, R as RuntimeExperiment, K as assignVariant, N as bucketingSeed, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, a3 as formatMoney, a4 as formatProduct, a6 as isRtl, a7 as isVariantKey, aa as pageMeta, ab as parseSlotKey, ae as resolveLocale, af as resolveProduct, ah as validateExperiments, aj as weightsOf } from './manifest-DQThneiG.cjs';
+import { C as CheckoutError, b as CheckoutIntent, U as UpsellKind, d as CheckoutSurface } from './capabilities-7_hy5f5G.cjs';
+export { a as CheckoutErrorCategory, c as CheckoutProvider, I as INLINE_SURFACES, O as OffSessionReliability, P as PROVIDER_PROFILES, e as ProviderProfile, S as SurfaceCapability, V as ValidationResult, f as checkoutError, i as isInlineSurface, g as isMerchantOfRecord, h as isOrchestrator, s as surfacesFor, v as validateCheckout, j as validateUpsell } from './capabilities-7_hy5f5G.cjs';
+import 'react';
+
+/**
+ * Source generators for the funnel build "machinery" authors no longer write. `funnel.ts` (the
+ * spine: id, responses, products, checkout, and the page list + declarative routing) plus the
+ * `pages/` folder are the ONLY authored source. The build (renderer/builder) and the CLI dev server
+ * call these to synthesize:
+ *   - `mount.tsx`         — code-split page loaders + `createFunnelTree`
+ *   - `entry.client.tsx`  — hydrate the SSR'd markup from injected data
+ *   - `entry.server.tsx`  — `ssr()` + the compiled `manifest`
+ *
+ * All string templates, zero runtime deps — this module lives in the pure `@appfunnel-dev/sdk/
+ * manifest` entry so tooling imports it without the funnel runtime.
+ */
+interface ScaffoldOptions {
+    /** Page component keys = `pages/<key>.tsx` filenames (base flow pages AND `@variant` pages). */
+    pageKeys: string[];
+    /** Import prefix to reach the funnel root: `'./'` at the root (build), `'../../'` in a subdir (CLI dev). */
+    importPrefix?: string;
+    /** Whether a `layout.tsx` exists to wrap the pages. */
+    hasLayout?: boolean;
+    /** Whether a `styles.css` exists (client entry imports it). */
+    hasStyles?: boolean;
+    /** Checkout provider from `config.checkout` — wires the driver; omit for none. */
+    checkout?: 'stripe' | 'paddle' | null;
+}
+/** `mount.tsx` — the code-split loaders + tree, derived from `config.pages` and the `pages/` files. */
+declare function generateMount(opts: ScaffoldOptions): string;
+/** `entry.client.tsx` — hydrate the SSR'd markup from the injected `#__af_data`. */
+declare function generateEntryClient(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>): string;
+/** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */
+declare function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix'>): string;
+/** Client-only dev entry (createRoot, no SSR) — for the CLI `dev` server. */
+declare function generateDevEntry(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'> & {
+    data: unknown;
+}): string;
+
+/**
+ * The v2 checkout WIRE CONTRACT — the request/response types shared by the server
+ * services (apps/api, fresh per-flow checkout — v1 purchase.ts is frozen) and the
+ * client drivers (driver-stripe/driver-paddle). Both sides import THESE types from
+ * the pure manifest entry, so the contract cannot drift between them.
+ *
+ * Future-proofing rules (Wave-4, Simon 2026-07-02):
+ *  - Responses discriminate on `step` (what the CLIENT must do next), NOT on the
+ *    provider — a new provider reuses an existing step (`redirect`,
+ *    `provider_checkout`) or adds one, without breaking existing drivers.
+ *  - The server NEVER returns secret credentials — publishable/client tokens only;
+ *    charges and verification happen server-side against the mode-resolved store.
+ *  - `correlationId` is the client-minted idempotency key AND the correlation id
+ *    the server writes into every provider object's metadata — one id links the
+ *    trial fee to its subscription, the webhook to the funnel session, and the
+ *    retry to the original attempt (kills v0's 5-minute-webhook-window linking).
+ *  - Money facts settle SERVER-side: the browser only ever learns the outcome
+ *    (`CheckoutSettlement`, with the server-minted `eventId` the pixel dedupes on).
+ */
+
+/** `POST {apiBase}/campaign/{campaignId}/v2/checkout` — open a checkout attempt. */
+interface CheckoutSessionRequest {
+    funnelId: string;
+    /** Render-time mode (doc 09 §2.4): resolves the product's binding + store credentials. */
+    mode: 'test' | 'live';
+    /** Logical catalog product key (`monthly`) — never a raw price id. */
+    productKey: string;
+    intent: CheckoutIntent;
+    /** For `upsell` — which off-session kind (validated against the capability matrix). */
+    kind?: UpsellKind;
+    /** The presenting surface; null/absent = off-session (upsell, no UI). */
+    surface?: CheckoutSurface | null;
+    /** Funnel session id (analytics + customer continuity), when one exists. */
+    sessionId?: string;
+    /** Signed-cookie-verified bare visitor id, when known. */
+    visitorId?: string;
+    /** Buyer email when the funnel collected it (Stripe Customer creation / receipts). */
+    email?: string;
+    /**
+     * Client-minted UUID. Idempotency key for this attempt (safe re-POST on network
+     * retry) and the correlation id stamped into provider-object metadata.
+     */
+    correlationId: string;
+}
+/** What the browser learned when the server settled the charge (or verified it). */
+interface CheckoutSettlement {
+    ok: true;
+    /** Server-minted dedup id — the SDK emits `purchase.complete` with it (browser↔CAPI dedup). */
+    eventId: string;
+    amountMinor: number;
+    currency: string;
+    productKey: string;
+}
+/** Driver confirms in the browser with the provider's JS (Stripe Elements et al.). */
+interface StepClientConfirm {
+    step: 'client_confirm';
+    provider: string;
+    publishableKey: string;
+    clientSecret: string;
+    /** Which secret this is — payment (charge now) vs setup (vault, e.g. free-trial start). */
+    secretKind: 'payment_intent' | 'setup_intent';
+}
+/** Driver mounts the provider-MANAGED inline checkout (Stripe Embedded). */
+interface StepEmbedded {
+    step: 'embedded';
+    provider: string;
+    publishableKey: string;
+    clientSecret: string;
+}
+/** Driver navigates to the provider-hosted page (any provider's `redirect`). */
+interface StepRedirect {
+    step: 'redirect';
+    provider: string;
+    url: string;
+}
+/**
+ * Driver opens the provider's own checkout UI (Paddle.js popup/inline, Whop later).
+ *
+ * WHAT the checkout opens is EXACTLY ONE of `items` | `transactionId`:
+ *  - `items` — open a NEW checkout for these provider-native prices (the purchase shape;
+ *    every response before 2026-07 carried this, so `items`-only stays valid unchanged);
+ *  - `transactionId` — open the provider's checkout for an EXISTING server-created
+ *    transaction (e.g. Paddle's payment-method-change transaction: the on-session
+ *    re-collect leg of a failed off-session upgrade — `Checkout.open({ transactionId })`).
+ * A response carrying both or neither is malformed and the driver rejects it.
+ */
+interface StepProviderCheckout {
+    step: 'provider_checkout';
+    provider: string;
+    /** Provider client token / publishable credential for its JS SDK. */
+    clientToken: string;
+    /** Provider environment the client SDK must target (Paddle sandbox vs production). */
+    providerEnvironment: 'sandbox' | 'production';
+    /** Provider-native line items (e.g. Paddle price ids), resolved from the binding. */
+    items?: {
+        priceId: string;
+        quantity: number;
+    }[];
+    /** Provider-side id of an EXISTING transaction to open (see the exactly-one rule above). */
+    transactionId?: string;
+    /**
+     * Echoed into the provider checkout's custom data (carries the correlationId) — `items`
+     * path only. A `transactionId` checkout already exists provider-side with its own custom
+     * data (Paddle: inherited from the subscription), so the driver does not send this.
+     */
+    customData: Record<string, string>;
+}
+/** The server completed the charge synchronously (off-session upsell). */
+interface StepSettled {
+    step: 'settled';
+    result: CheckoutSettlement;
+}
+/** The attempt failed — normalized taxonomy, never a raw provider error. */
+interface StepFailed {
+    step: 'failed';
+    error: CheckoutError;
+}
+/**
+ * The provider hasn't confirmed yet — the charge is in flight and will settle
+ * async (webhook). The driver polls `/complete` until `settled`/`failed`. On the
+ * OPEN response this is the Paddle off-session tail (its confirmation can outlast
+ * the request); money stays truthful either way — the attempt is PENDING
+ * server-side and the webhook/poll converge on one outcome.
+ */
+interface StepPending {
+    step: 'pending';
+}
+type CheckoutSessionResponse = StepClientConfirm | StepEmbedded | StepRedirect | StepProviderCheckout | StepSettled | StepPending | StepFailed;
+/**
+ * `POST {apiBase}/campaign/{campaignId}/v2/checkout/{correlationId}/complete` —
+ * after a client-side confirm/provider-checkout resolves, the browser asks the
+ * server to VERIFY with the provider and write the money facts. The server is the
+ * source of truth: it re-fetches the provider object; the browser's claim alone
+ * never creates a fact. Idempotent per correlationId (a re-POST returns the same
+ * settlement). MoR/async providers (Paddle) may verify via webhook before this
+ * call arrives — then it simply returns the already-written settlement.
+ */
+interface CheckoutCompleteRequest {
+    /** Provider-side handle the client got back, when it has one (e.g. Stripe intent id). */
+    providerRef?: string;
+}
+type CheckoutCompleteResponse = StepSettled | StepPending | StepFailed;
+
+export { type CheckoutCompleteRequest, type CheckoutCompleteResponse, CheckoutError, CheckoutIntent, type CheckoutSessionRequest, type CheckoutSessionResponse, type CheckoutSettlement, CheckoutSurface, type ScaffoldOptions, type StepClientConfirm, type StepEmbedded, type StepFailed, type StepPending, type StepProviderCheckout, type StepRedirect, type StepSettled, UpsellKind, generateDevEntry, generateEntryClient, generateEntryServer, generateMount };

package/dist/manifest-entry.d.ts

@@ -0,0 +1,184 @@
+export { i as CompileInput, j as Condition, k as ConditionOp, E as EdgeCondition, m as ExperimentIssue, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, c as FunnelDefinition, r as FunnelLocales, s as FunnelManifest, ai as FunnelPage, b as FunnelSnapshot, G as Gate, t as Interval, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, f as PageMeta, x as PageType, y as Predicate, P as Product, e as ProductInput, z as ResolvedProduct, H as Route, R as RuntimeExperiment, K as assignVariant, N as bucketingSeed, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, a3 as formatMoney, a4 as formatProduct, a6 as isRtl, a7 as isVariantKey, aa as pageMeta, ab as parseSlotKey, ae as resolveLocale, af as resolveProduct, ah as validateExperiments, aj as weightsOf } from './manifest-DQThneiG.js';
+import { C as CheckoutError, b as CheckoutIntent, U as UpsellKind, d as CheckoutSurface } from './capabilities-7_hy5f5G.js';
+export { a as CheckoutErrorCategory, c as CheckoutProvider, I as INLINE_SURFACES, O as OffSessionReliability, P as PROVIDER_PROFILES, e as ProviderProfile, S as SurfaceCapability, V as ValidationResult, f as checkoutError, i as isInlineSurface, g as isMerchantOfRecord, h as isOrchestrator, s as surfacesFor, v as validateCheckout, j as validateUpsell } from './capabilities-7_hy5f5G.js';
+import 'react';
+
+/**
+ * Source generators for the funnel build "machinery" authors no longer write. `funnel.ts` (the
+ * spine: id, responses, products, checkout, and the page list + declarative routing) plus the
+ * `pages/` folder are the ONLY authored source. The build (renderer/builder) and the CLI dev server
+ * call these to synthesize:
+ *   - `mount.tsx`         — code-split page loaders + `createFunnelTree`
+ *   - `entry.client.tsx`  — hydrate the SSR'd markup from injected data
+ *   - `entry.server.tsx`  — `ssr()` + the compiled `manifest`
+ *
+ * All string templates, zero runtime deps — this module lives in the pure `@appfunnel-dev/sdk/
+ * manifest` entry so tooling imports it without the funnel runtime.
+ */
+interface ScaffoldOptions {
+    /** Page component keys = `pages/<key>.tsx` filenames (base flow pages AND `@variant` pages). */
+    pageKeys: string[];
+    /** Import prefix to reach the funnel root: `'./'` at the root (build), `'../../'` in a subdir (CLI dev). */
+    importPrefix?: string;
+    /** Whether a `layout.tsx` exists to wrap the pages. */
+    hasLayout?: boolean;
+    /** Whether a `styles.css` exists (client entry imports it). */
+    hasStyles?: boolean;
+    /** Checkout provider from `config.checkout` — wires the driver; omit for none. */
+    checkout?: 'stripe' | 'paddle' | null;
+}
+/** `mount.tsx` — the code-split loaders + tree, derived from `config.pages` and the `pages/` files. */
+declare function generateMount(opts: ScaffoldOptions): string;
+/** `entry.client.tsx` — hydrate the SSR'd markup from the injected `#__af_data`. */
+declare function generateEntryClient(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>): string;
+/** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */
+declare function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix'>): string;
+/** Client-only dev entry (createRoot, no SSR) — for the CLI `dev` server. */
+declare function generateDevEntry(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'> & {
+    data: unknown;
+}): string;
+
+/**
+ * The v2 checkout WIRE CONTRACT — the request/response types shared by the server
+ * services (apps/api, fresh per-flow checkout — v1 purchase.ts is frozen) and the
+ * client drivers (driver-stripe/driver-paddle). Both sides import THESE types from
+ * the pure manifest entry, so the contract cannot drift between them.
+ *
+ * Future-proofing rules (Wave-4, Simon 2026-07-02):
+ *  - Responses discriminate on `step` (what the CLIENT must do next), NOT on the
+ *    provider — a new provider reuses an existing step (`redirect`,
+ *    `provider_checkout`) or adds one, without breaking existing drivers.
+ *  - The server NEVER returns secret credentials — publishable/client tokens only;
+ *    charges and verification happen server-side against the mode-resolved store.
+ *  - `correlationId` is the client-minted idempotency key AND the correlation id
+ *    the server writes into every provider object's metadata — one id links the
+ *    trial fee to its subscription, the webhook to the funnel session, and the
+ *    retry to the original attempt (kills v0's 5-minute-webhook-window linking).
+ *  - Money facts settle SERVER-side: the browser only ever learns the outcome
+ *    (`CheckoutSettlement`, with the server-minted `eventId` the pixel dedupes on).
+ */
+
+/** `POST {apiBase}/campaign/{campaignId}/v2/checkout` — open a checkout attempt. */
+interface CheckoutSessionRequest {
+    funnelId: string;
+    /** Render-time mode (doc 09 §2.4): resolves the product's binding + store credentials. */
+    mode: 'test' | 'live';
+    /** Logical catalog product key (`monthly`) — never a raw price id. */
+    productKey: string;
+    intent: CheckoutIntent;
+    /** For `upsell` — which off-session kind (validated against the capability matrix). */
+    kind?: UpsellKind;
+    /** The presenting surface; null/absent = off-session (upsell, no UI). */
+    surface?: CheckoutSurface | null;
+    /** Funnel session id (analytics + customer continuity), when one exists. */
+    sessionId?: string;
+    /** Signed-cookie-verified bare visitor id, when known. */
+    visitorId?: string;
+    /** Buyer email when the funnel collected it (Stripe Customer creation / receipts). */
+    email?: string;
+    /**
+     * Client-minted UUID. Idempotency key for this attempt (safe re-POST on network
+     * retry) and the correlation id stamped into provider-object metadata.
+     */
+    correlationId: string;
+}
+/** What the browser learned when the server settled the charge (or verified it). */
+interface CheckoutSettlement {
+    ok: true;
+    /** Server-minted dedup id — the SDK emits `purchase.complete` with it (browser↔CAPI dedup). */
+    eventId: string;
+    amountMinor: number;
+    currency: string;
+    productKey: string;
+}
+/** Driver confirms in the browser with the provider's JS (Stripe Elements et al.). */
+interface StepClientConfirm {
+    step: 'client_confirm';
+    provider: string;
+    publishableKey: string;
+    clientSecret: string;
+    /** Which secret this is — payment (charge now) vs setup (vault, e.g. free-trial start). */
+    secretKind: 'payment_intent' | 'setup_intent';
+}
+/** Driver mounts the provider-MANAGED inline checkout (Stripe Embedded). */
+interface StepEmbedded {
+    step: 'embedded';
+    provider: string;
+    publishableKey: string;
+    clientSecret: string;
+}
+/** Driver navigates to the provider-hosted page (any provider's `redirect`). */
+interface StepRedirect {
+    step: 'redirect';
+    provider: string;
+    url: string;
+}
+/**
+ * Driver opens the provider's own checkout UI (Paddle.js popup/inline, Whop later).
+ *
+ * WHAT the checkout opens is EXACTLY ONE of `items` | `transactionId`:
+ *  - `items` — open a NEW checkout for these provider-native prices (the purchase shape;
+ *    every response before 2026-07 carried this, so `items`-only stays valid unchanged);
+ *  - `transactionId` — open the provider's checkout for an EXISTING server-created
+ *    transaction (e.g. Paddle's payment-method-change transaction: the on-session
+ *    re-collect leg of a failed off-session upgrade — `Checkout.open({ transactionId })`).
+ * A response carrying both or neither is malformed and the driver rejects it.
+ */
+interface StepProviderCheckout {
+    step: 'provider_checkout';
+    provider: string;
+    /** Provider client token / publishable credential for its JS SDK. */
+    clientToken: string;
+    /** Provider environment the client SDK must target (Paddle sandbox vs production). */
+    providerEnvironment: 'sandbox' | 'production';
+    /** Provider-native line items (e.g. Paddle price ids), resolved from the binding. */
+    items?: {
+        priceId: string;
+        quantity: number;
+    }[];
+    /** Provider-side id of an EXISTING transaction to open (see the exactly-one rule above). */
+    transactionId?: string;
+    /**
+     * Echoed into the provider checkout's custom data (carries the correlationId) — `items`
+     * path only. A `transactionId` checkout already exists provider-side with its own custom
+     * data (Paddle: inherited from the subscription), so the driver does not send this.
+     */
+    customData: Record<string, string>;
+}
+/** The server completed the charge synchronously (off-session upsell). */
+interface StepSettled {
+    step: 'settled';
+    result: CheckoutSettlement;
+}
+/** The attempt failed — normalized taxonomy, never a raw provider error. */
+interface StepFailed {
+    step: 'failed';
+    error: CheckoutError;
+}
+/**
+ * The provider hasn't confirmed yet — the charge is in flight and will settle
+ * async (webhook). The driver polls `/complete` until `settled`/`failed`. On the
+ * OPEN response this is the Paddle off-session tail (its confirmation can outlast
+ * the request); money stays truthful either way — the attempt is PENDING
+ * server-side and the webhook/poll converge on one outcome.
+ */
+interface StepPending {
+    step: 'pending';
+}
+type CheckoutSessionResponse = StepClientConfirm | StepEmbedded | StepRedirect | StepProviderCheckout | StepSettled | StepPending | StepFailed;
+/**
+ * `POST {apiBase}/campaign/{campaignId}/v2/checkout/{correlationId}/complete` —
+ * after a client-side confirm/provider-checkout resolves, the browser asks the
+ * server to VERIFY with the provider and write the money facts. The server is the
+ * source of truth: it re-fetches the provider object; the browser's claim alone
+ * never creates a fact. Idempotent per correlationId (a re-POST returns the same
+ * settlement). MoR/async providers (Paddle) may verify via webhook before this
+ * call arrives — then it simply returns the already-written settlement.
+ */
+interface CheckoutCompleteRequest {
+    /** Provider-side handle the client got back, when it has one (e.g. Stripe intent id). */
+    providerRef?: string;
+}
+type CheckoutCompleteResponse = StepSettled | StepPending | StepFailed;
+
+export { type CheckoutCompleteRequest, type CheckoutCompleteResponse, CheckoutError, CheckoutIntent, type CheckoutSessionRequest, type CheckoutSessionResponse, type CheckoutSettlement, CheckoutSurface, type ScaffoldOptions, type StepClientConfirm, type StepEmbedded, type StepFailed, type StepPending, type StepProviderCheckout, type StepRedirect, type StepSettled, UpsellKind, generateDevEntry, generateEntryClient, generateEntryServer, generateMount };