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

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, ButtonHTMLAttributes } from 'react';
-import { V as VariableValue, a as VariableConfig, A as Acquisition, P as Product, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as ProductInput, f as PageMeta, g as PageContext } from './manifest-DQThneiG.cjs';
-export { B as BrowserContext, h as BuildContextOptions, C as ClickIdContext, i as CompileInput, j as Condition, k as ConditionOp, l as DeviceContext, E as EdgeCondition, m as ExperimentIssue, n as ExperimentResolution, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, r as FunnelLocales, s as FunnelManifest, G as Gate, I as IdentityContext, t as Interval, L as LocaleContext, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, O as OsContext, x as PageType, y as Predicate, z as ResolvedProduct, H as Route, S as SessionContext, J as SystemContext, U as UtmContext, K as assignVariant, N as bucketingSeed, Q as buildAcquisition, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, Z as definePage, _ as entryGuard, $ as evaluateCondition, a0 as evaluateGate, a1 as expectedPathLength, a2 as fnv1a, a3 as formatMoney, a4 as formatProduct, a5 as hashToUnit, a6 as isRtl, a7 as isVariantKey, a8 as nextPage, a9 as outgoingKeys, aa as pageMeta, ab as parseSlotKey, ac as pickByWeight, ad as resolveExperiments, ae as resolveLocale, af as resolveProduct, ag as resolveRoute, ah as validateExperiments } from './manifest-DQThneiG.cjs';
-import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-CZmEvWfC.cjs';
-export { b as Checkout, c as CheckoutCallbacks, d as CheckoutHandle, e as CheckoutProps, f as CheckoutRequest, g as CheckoutResult, h as CheckoutResume, i as CheckoutStatus, F as FailureModalProps, j as FailureRoute, M as MockDriverOptions, O as OnFailedMap, U as Upsell, k as UpsellProps, l as UseCheckoutOptions, m as createMockDriver, n as driverWithEmail, u as useCheckout } from './checkout-CZmEvWfC.cjs';
+import { V as VariableValue, a as VariableConfig, A as Acquisition, P as Product, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as ProductInput, f as PageMeta, g as PageContext } from './manifest-Cr2y1op6.cjs';
+export { B as BrowserContext, h as BuildContextOptions, C as ClickIdContext, i as CompileInput, j as Condition, k as ConditionOp, l as DeviceContext, E as EdgeCondition, m as ExperimentIssue, n as ExperimentResolution, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, r as FunnelLocales, s as FunnelManifest, G as Gate, I as IdentityContext, t as Interval, L as LocaleContext, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, O as OsContext, x as PageType, y as Predicate, z as ResolvedProduct, H as Route, S as SessionContext, J as SystemContext, U as UtmContext, K as assignVariant, N as bucketingSeed, Q as buildAcquisition, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, Z as definePage, _ as entryGuard, $ as evaluateCondition, a0 as evaluateGate, a1 as expectedPathLength, a2 as fnv1a, a3 as formatMoney, a4 as formatProduct, a5 as hashToUnit, a6 as isRtl, a7 as isVariantKey, a8 as nextPage, a9 as outgoingKeys, aa as pageMeta, ab as parseSlotKey, ac as pickByWeight, ad as resolveExperiments, ae as resolveLocale, af as resolveProduct, ag as resolveRoute, ah as validateExperiments } from './manifest-Cr2y1op6.cjs';
+import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-Dz8cGkB_.cjs';
+export { b as Checkout, c as CheckoutCallbacks, d as CheckoutHandle, e as CheckoutProps, f as CheckoutRequest, g as CheckoutResult, h as CheckoutResume, i as CheckoutStatus, F as FailureModalProps, j as FailureRoute, M as MockDriverOptions, O as OnFailedMap, U as Upsell, k as UpsellProps, l as UseCheckoutOptions, m as createMockDriver, n as driverWithEmail, u as useCheckout } from './checkout-Dz8cGkB_.cjs';
 import { ToasterProps } from 'sonner';
 export { ToasterProps, toast } from 'sonner';
 export { C as CheckoutError, a as CheckoutErrorCategory, b as CheckoutIntent, c as CheckoutProvider, d as CheckoutSurface, I as INLINE_SURFACES, O as OffSessionReliability, P as PROVIDER_PROFILES, e as ProviderProfile, S as SurfaceCapability, U as UpsellKind, 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';
@@ -113,8 +113,16 @@ interface FunnelEventDataMap {
         priceId?: string;
         productName?: string;
         surface?: string;
+        amount?: number;
+        currency?: string;
+        eventId?: string;
+    };
+    'checkout.payment_added': {
+        productId?: string;
+        amount?: number;
+        currency?: string;
+        eventId?: string;
     };
-    'checkout.payment_added': Record<string, never>;
     'checkout.failed': {
         category: string;
         declineCode?: string;
@@ -126,6 +134,13 @@ interface FunnelEventDataMap {
         currency?: string;
         email?: string;
         eventId?: string;
+        productId?: string;
+    };
+    'subscription.created': {
+        amount?: number;
+        currency?: string;
+        productId?: string;
+        eventId?: string;
     };
     'experiment.exposure': {
         experimentId: string;
@@ -518,6 +533,8 @@ interface MountOpts {
     initialKey?: string;
     /** Asset map: logical name → content-addressed CDN URL. */
     assets?: Record<string, string>;
+    /** Per-locale message catalogs (`messages/<locale>.json`) — overrides the mount's baked-in ones. */
+    messages?: MessageCatalog;
     /** The SIGNED anonymous visitor id (bare id, verified server-side; phase-1 §1.2) — the
      *  renderer mints/reads the `af_vid` cookie and injects the value here. Feeds
      *  `context.identity.visitorId` (experiment bucketing fallback seed, session continuity). */
@@ -581,6 +598,12 @@ interface CreateFunnelTreeInput {
      * resolves the provider's TEST store from it (that's the quarantine, not the client).
      */
     checkoutDriver?: (ctx: CheckoutDriverContext) => CheckoutDriver;
+    /**
+     * The funnel's message catalogs (`messages/<locale>.json`), keyed by locale. The generated
+     * `mount.tsx` imports the catalogs and passes them here so `t()` resolves at render (SSR + client);
+     * `MountOpts.messages` can still override per-request. Omit for funnels with no translations.
+     */
+    messages?: MessageCatalog;
 }
 /**
  * Build a funnel's `tree(opts)` — the standard provider stack over your pages.
@@ -590,7 +613,7 @@ interface CreateFunnelTreeInput {
  * export const tree = createFunnelTree({ config, pages, layout: Layout })
  * ```
  */
-declare function createFunnelTree({ config, pages, layout, checkoutDriver, }: CreateFunnelTreeInput): (opts: MountOpts) => ReactNode;
+declare function createFunnelTree({ config, pages, layout, checkoutDriver, messages, }: CreateFunnelTreeInput): (opts: MountOpts) => ReactNode;
 
 /**
  * The two-tier component model (doc 07 §"magic ≠ black box"): the magic lives in

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, ButtonHTMLAttributes } from 'react';
-import { V as VariableValue, a as VariableConfig, A as Acquisition, P as Product, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as ProductInput, f as PageMeta, g as PageContext } from './manifest-DQThneiG.js';
-export { B as BrowserContext, h as BuildContextOptions, C as ClickIdContext, i as CompileInput, j as Condition, k as ConditionOp, l as DeviceContext, E as EdgeCondition, m as ExperimentIssue, n as ExperimentResolution, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, r as FunnelLocales, s as FunnelManifest, G as Gate, I as IdentityContext, t as Interval, L as LocaleContext, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, O as OsContext, x as PageType, y as Predicate, z as ResolvedProduct, H as Route, S as SessionContext, J as SystemContext, U as UtmContext, K as assignVariant, N as bucketingSeed, Q as buildAcquisition, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, Z as definePage, _ as entryGuard, $ as evaluateCondition, a0 as evaluateGate, a1 as expectedPathLength, a2 as fnv1a, a3 as formatMoney, a4 as formatProduct, a5 as hashToUnit, a6 as isRtl, a7 as isVariantKey, a8 as nextPage, a9 as outgoingKeys, aa as pageMeta, ab as parseSlotKey, ac as pickByWeight, ad as resolveExperiments, ae as resolveLocale, af as resolveProduct, ag as resolveRoute, ah as validateExperiments } from './manifest-DQThneiG.js';
-import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-DiQvRT5q.js';
-export { b as Checkout, c as CheckoutCallbacks, d as CheckoutHandle, e as CheckoutProps, f as CheckoutRequest, g as CheckoutResult, h as CheckoutResume, i as CheckoutStatus, F as FailureModalProps, j as FailureRoute, M as MockDriverOptions, O as OnFailedMap, U as Upsell, k as UpsellProps, l as UseCheckoutOptions, m as createMockDriver, n as driverWithEmail, u as useCheckout } from './checkout-DiQvRT5q.js';
+import { V as VariableValue, a as VariableConfig, A as Acquisition, P as Product, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as ProductInput, f as PageMeta, g as PageContext } from './manifest-Cr2y1op6.js';
+export { B as BrowserContext, h as BuildContextOptions, C as ClickIdContext, i as CompileInput, j as Condition, k as ConditionOp, l as DeviceContext, E as EdgeCondition, m as ExperimentIssue, n as ExperimentResolution, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, r as FunnelLocales, s as FunnelManifest, G as Gate, I as IdentityContext, t as Interval, L as LocaleContext, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, O as OsContext, x as PageType, y as Predicate, z as ResolvedProduct, H as Route, S as SessionContext, J as SystemContext, U as UtmContext, K as assignVariant, N as bucketingSeed, Q as buildAcquisition, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, Z as definePage, _ as entryGuard, $ as evaluateCondition, a0 as evaluateGate, a1 as expectedPathLength, a2 as fnv1a, a3 as formatMoney, a4 as formatProduct, a5 as hashToUnit, a6 as isRtl, a7 as isVariantKey, a8 as nextPage, a9 as outgoingKeys, aa as pageMeta, ab as parseSlotKey, ac as pickByWeight, ad as resolveExperiments, ae as resolveLocale, af as resolveProduct, ag as resolveRoute, ah as validateExperiments } from './manifest-Cr2y1op6.js';
+import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-7Dy6IedP.js';
+export { b as Checkout, c as CheckoutCallbacks, d as CheckoutHandle, e as CheckoutProps, f as CheckoutRequest, g as CheckoutResult, h as CheckoutResume, i as CheckoutStatus, F as FailureModalProps, j as FailureRoute, M as MockDriverOptions, O as OnFailedMap, U as Upsell, k as UpsellProps, l as UseCheckoutOptions, m as createMockDriver, n as driverWithEmail, u as useCheckout } from './checkout-7Dy6IedP.js';
 import { ToasterProps } from 'sonner';
 export { ToasterProps, toast } from 'sonner';
 export { C as CheckoutError, a as CheckoutErrorCategory, b as CheckoutIntent, c as CheckoutProvider, d as CheckoutSurface, I as INLINE_SURFACES, O as OffSessionReliability, P as PROVIDER_PROFILES, e as ProviderProfile, S as SurfaceCapability, U as UpsellKind, 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';
@@ -113,8 +113,16 @@ interface FunnelEventDataMap {
         priceId?: string;
         productName?: string;
         surface?: string;
+        amount?: number;
+        currency?: string;
+        eventId?: string;
+    };
+    'checkout.payment_added': {
+        productId?: string;
+        amount?: number;
+        currency?: string;
+        eventId?: string;
     };
-    'checkout.payment_added': Record<string, never>;
     'checkout.failed': {
         category: string;
         declineCode?: string;
@@ -126,6 +134,13 @@ interface FunnelEventDataMap {
         currency?: string;
         email?: string;
         eventId?: string;
+        productId?: string;
+    };
+    'subscription.created': {
+        amount?: number;
+        currency?: string;
+        productId?: string;
+        eventId?: string;
     };
     'experiment.exposure': {
         experimentId: string;
@@ -518,6 +533,8 @@ interface MountOpts {
     initialKey?: string;
     /** Asset map: logical name → content-addressed CDN URL. */
     assets?: Record<string, string>;
+    /** Per-locale message catalogs (`messages/<locale>.json`) — overrides the mount's baked-in ones. */
+    messages?: MessageCatalog;
     /** The SIGNED anonymous visitor id (bare id, verified server-side; phase-1 §1.2) — the
      *  renderer mints/reads the `af_vid` cookie and injects the value here. Feeds
      *  `context.identity.visitorId` (experiment bucketing fallback seed, session continuity). */
@@ -581,6 +598,12 @@ interface CreateFunnelTreeInput {
      * resolves the provider's TEST store from it (that's the quarantine, not the client).
      */
     checkoutDriver?: (ctx: CheckoutDriverContext) => CheckoutDriver;
+    /**
+     * The funnel's message catalogs (`messages/<locale>.json`), keyed by locale. The generated
+     * `mount.tsx` imports the catalogs and passes them here so `t()` resolves at render (SSR + client);
+     * `MountOpts.messages` can still override per-request. Omit for funnels with no translations.
+     */
+    messages?: MessageCatalog;
 }
 /**
  * Build a funnel's `tree(opts)` — the standard provider stack over your pages.
@@ -590,7 +613,7 @@ interface CreateFunnelTreeInput {
  * export const tree = createFunnelTree({ config, pages, layout: Layout })
  * ```
  */
-declare function createFunnelTree({ config, pages, layout, checkoutDriver, }: CreateFunnelTreeInput): (opts: MountOpts) => ReactNode;
+declare function createFunnelTree({ config, pages, layout, checkoutDriver, messages, }: CreateFunnelTreeInput): (opts: MountOpts) => ReactNode;
 
 /**
  * The two-tier component model (doc 07 §"magic ≠ black box"): the magic lives in

package/dist/index.js

@@ -1,5 +1,5 @@
-import { isRtl, formatProduct, bucketingSeed, resolveExperiments, entryGuard, evaluateGate, expectedPathLength, nextPage, outgoingKeys, buildCatalog, resolveLocale } from './chunk-7UC5VXOR.js';
-export { assignVariant, bucketingSeed, buildCatalog, compileManifest, currencyExponent, defineFunnel, definePage, entryGuard, evaluateCondition, evaluateGate, expectedPathLength, fnv1a, formatMoney, formatProduct, hashToUnit, isRtl, isVariantKey, nextPage, outgoingKeys, pageMeta, parseSlotKey, pickByWeight, resolveExperiments, resolveLocale, resolveProduct, resolveRoute, validateExperiments } from './chunk-7UC5VXOR.js';
+import { isRtl, formatProduct, bucketingSeed, resolveExperiments, entryGuard, evaluateGate, expectedPathLength, nextPage, outgoingKeys, buildCatalog, resolveLocale } from './chunk-AKO6XKXP.js';
+export { assignVariant, bucketingSeed, buildCatalog, compileManifest, currencyExponent, defineFunnel, definePage, entryGuard, evaluateCondition, evaluateGate, expectedPathLength, fnv1a, formatMoney, formatProduct, hashToUnit, isRtl, isVariantKey, nextPage, outgoingKeys, pageMeta, parseSlotKey, pickByWeight, resolveExperiments, resolveLocale, resolveProduct, resolveRoute, validateExperiments } from './chunk-AKO6XKXP.js';
 import { checkoutError, isInlineSurface, PROVIDER_PROFILES } from './chunk-YY375F2B.js';
 export { INLINE_SURFACES, PROVIDER_PROFILES, checkoutError, isInlineSurface, isMerchantOfRecord, isOrchestrator, surfacesFor, validateCheckout, validateUpsell } from './chunk-YY375F2B.js';
 import React, { createContext, createElement, useCallback, useContext, useMemo, lazy, useRef, useState, useEffect, useTransition, Suspense, Fragment, isValidElement, cloneElement, useReducer, useSyncExternalStore } from 'react';
@@ -1098,6 +1098,14 @@ function driverWithEmail(driver, getEmail) {
     renderInline: driver.renderInline ? (req, cb) => driver.renderInline(enrich(req), cb) : void 0
   };
 }
+function driverWithCatalog(driver, catalog) {
+  const enrich = (req) => req.catalogKey !== void 0 ? req : { ...req, catalogKey: catalog.get(req.product)?.catalogKey };
+  return {
+    ...driver,
+    start: (req) => driver.start(enrich(req)),
+    renderInline: driver.renderInline ? (req, cb) => driver.renderInline(enrich(req), cb) : void 0
+  };
+}
 var DriverContext = createContext(null);
 function CheckoutDriverProvider({
   driver,
@@ -1112,12 +1120,25 @@ var FALLBACK_DRIVER = createMockDriver();
 function useCheckout(opts = {}) {
   const driver = useDriver();
   const tracker = useTrackerRef();
+  const catalog = useCatalog();
   const nav = useNavigation();
   const [status, setStatus] = useState("idle");
   const [error, setError] = useState(null);
   const intent = opts.intent ?? "purchase";
   const kind = opts.kind;
   const advance = opts.advanceOnSuccess ?? true;
+  const productFacts = useCallback(
+    (product) => {
+      const resolved = product ? catalog.get(product) : void 0;
+      return {
+        productId: resolved?.catalogKey ?? product,
+        amount: resolved ? resolved.priceMinor / 100 : void 0,
+        currency: resolved?.currency,
+        isSubscription: resolved ? resolved.period !== "one-time" : kind === "subscription" || kind === "upgrade"
+      };
+    },
+    [catalog, kind]
+  );
   const recovering = useRef(false);
   const failRef = useRef(() => {
   });
@@ -1125,18 +1146,24 @@ function useCheckout(opts = {}) {
     async () => ({ ok: false })
   );
   const succeed = useCallback(
-    (result) => {
+    (result, product) => {
       setStatus("success");
+      const { productId, isSubscription } = productFacts(product);
+      const amount = result.amountMinor != null ? result.amountMinor / 100 : void 0;
       tracker.track("purchase.complete", {
-        amount: result.amountMinor != null ? result.amountMinor / 100 : void 0,
+        amount,
         currency: result.currency,
+        productId,
         eventId: result.eventId
         // server-minted (browser↔CAPI dedup); undefined if none
       });
+      if (isSubscription) {
+        tracker.track("subscription.created", { amount, currency: result.currency, productId, eventId: result.eventId });
+      }
       opts.onSuccess?.(result);
       if (advance) nav.next();
     },
-    [tracker, nav, advance, opts]
+    [tracker, nav, advance, opts, productFacts]
   );
   const succeedRef = useRef(succeed);
   succeedRef.current = succeed;
@@ -1144,11 +1171,18 @@ function useCheckout(opts = {}) {
     (product, surface) => {
       setStatus("loading");
       setError(null);
-      tracker.track("checkout.start", { productId: product, surface });
+      const { productId, amount, currency } = productFacts(product);
+      tracker.track("checkout.start", { productId, amount, currency, surface, eventId: newEventId() });
     },
-    [tracker]
+    [tracker, productFacts]
+  );
+  const paymentAdded = useCallback(
+    (product) => {
+      const { productId, amount, currency } = productFacts(product);
+      tracker.track("checkout.payment_added", { productId, amount, currency, eventId: newEventId() });
+    },
+    [tracker, productFacts]
   );
-  const paymentAdded = useCallback(() => tracker.track("checkout.payment_added", {}), [tracker]);
   const hostInSheet = (surface) => surface === "sheet" || isInlineSurface(surface) && !!PROVIDER_PROFILES[driver.provider]?.surfaces.sheet;
   const startRecovery = (product, surface) => {
     recovering.current = true;
@@ -1159,9 +1193,9 @@ function useCheckout(opts = {}) {
         surface: "sheet",
         intent,
         kind,
-        onSuccess: (r) => succeedRef.current(r),
+        onSuccess: (r) => succeedRef.current(r, product),
         onError: (e) => failRef.current(e, product),
-        onPaymentAdded: () => paymentAdded()
+        onPaymentAdded: () => paymentAdded(product)
       });
     } else {
       void attemptRef.current(product, surface);
@@ -1215,7 +1249,7 @@ function useCheckout(opts = {}) {
     begin(product, surface);
     try {
       const result = await driver.start({ product, intent, surface, kind });
-      if (result.ok) succeedRef.current(result);
+      if (result.ok) succeedRef.current(result, product);
       else failRef.current(result.error ?? checkoutError("unknown", "Checkout failed"), product);
       return result;
     } catch (e) {
@@ -1234,9 +1268,9 @@ function useCheckout(opts = {}) {
         recovering.current = false;
         begin(product, surface);
       },
-      onSuccess: (result) => succeedRef.current(result),
+      onSuccess: (result) => succeedRef.current(result, product),
       onError: (err) => failRef.current(err, product),
-      onPaymentAdded: () => paymentAdded()
+      onPaymentAdded: () => paymentAdded(product)
     }),
     [begin, paymentAdded]
   );
@@ -2567,12 +2601,15 @@ function FunnelProvider({
       const value2 = s.get("user.email");
       return typeof value2 === "string" && /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(value2) ? value2 : void 0;
     };
+    const catalog = buildCatalog(products ?? []);
     return {
       funnel: createFunnel(s, ctx, busTracker, experiments ?? []),
       store: s,
       context: ctx,
-      catalog: buildCatalog(products ?? []),
-      driver: driverWithEmail(checkout ?? createMockDriver(), emailForCheckout),
+      catalog,
+      // Slot → catalog-key resolution wraps the email-enriching driver, so the wire charges the real
+      // catalog key while pages + analytics keep the durable SLOT identity (req.product).
+      driver: driverWithCatalog(driverWithEmail(checkout ?? createMockDriver(), emailForCheckout), catalog),
       tracker: busTracker,
       bus
     };
@@ -2844,7 +2881,8 @@ function createFunnelTree({
   config,
   pages,
   layout,
-  checkoutDriver
+  checkoutDriver,
+  messages
 }) {
   return function tree(opts) {
     const mode = opts.mode ?? "live";
@@ -2877,6 +2915,7 @@ function createFunnelTree({
       children: createElement(FunnelProvider, {
         config,
         products: opts.products ?? [],
+        messages: opts.messages ?? messages,
         locale: opts.locale,
         tracker,
         checkout,