@appfunnel-dev/sdk 2.0.0 → 2.0.1

package/dist/index.d.cts

@@ -1,10 +1,10 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, ButtonHTMLAttributes, AnchorHTMLAttributes } from 'react';
-import { O as Offering, V as VariableValue, a as VariableConfig, A as Acquisition, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as OfferingInput, P as PageMeta, f as PageContext, G as GroupProgress } from './manifest-BajvtPWs.cjs';
-export { B as BrowserContext, g as BuildContextOptions, C as ClickIdContext, h as CompileInput, i as Condition, j as ConditionOp, k as DeviceContext, E as EdgeCondition, l as ExperimentArm, m as ExperimentResolution, n as FlowPage, o as FunnelLocales, p as FunnelManifest, q as Gate, I as IdentityContext, r as Interval, L as LocaleContext, M as ManifestEdge, s as ManifestPage, t as ManifestValidation, u as Money, v as OsContext, w as PageComponent, x as PageGroup, y as PageType, z as Predicate, H as ResolvedOffering, J as Route, S as SampleOffering, K as SessionContext, N as SystemContext, U as UtmContext, Q as assignVariant, T as bucketingSeed, W as buildAcquisition, X as buildCatalog, Y as compileManifest, Z as currencyExponent, _ as defineFunnel, $ as definePage, a0 as entryGuard, a1 as evaluateCondition, a2 as evaluateGate, a3 as expectedPathLength, a4 as fnv1a, a5 as formatMoney, a6 as formatOffering, a7 as formatSampleOffering, a8 as groupProgress, a9 as hashToUnit, aa as isRtl, ab as isVariantKey, ac as nextPage, ad as outgoingKeys, ae as pageMeta, af as parseSlotKey, ag as pickByWeight, ah as resolveExperiments, ai as resolveLocale, aj as resolveOffering, ak as resolveRoute } from './manifest-BajvtPWs.cjs';
+import { O as Offering, V as VariableValue, a as VariableConfig, A as Acquisition, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as OfferingInput, P as PageMeta, f as PageContext, G as GroupProgress } from './manifest-Dp1oRvqp.cjs';
+export { B as BrowserContext, g as BuildContextOptions, C as ClickIdContext, h as CompileInput, i as Condition, j as ConditionOp, k as DeviceContext, E as EdgeCondition, l as ExperimentArm, m as ExperimentResolution, n as FlowPage, o as FunnelLocales, p as FunnelManifest, q as Gate, I as IdentityContext, r as Interval, L as LocaleContext, M as ManifestEdge, s as ManifestPage, t as ManifestValidation, u as Money, v as OsContext, w as PageComponent, x as PageGroup, y as PageType, z as Predicate, H as ResolvedOffering, J as Route, S as SampleOffering, K as SessionContext, N as SystemContext, U as UtmContext, Q as assignVariant, T as bucketingSeed, W as buildAcquisition, X as buildCatalog, Y as compileManifest, Z as currencyExponent, _ as defineFunnel, $ as definePage, a0 as entryGuard, a1 as evaluateCondition, a2 as evaluateGate, a3 as expectedPathLength, a4 as fnv1a, a5 as formatMoney, a6 as formatOffering, a7 as formatSampleOffering, a8 as groupProgress, a9 as hashToUnit, aa as isRtl, ab as isVariantKey, ac as nextPage, ad as outgoingKeys, ae as pageMeta, af as parseSlotKey, ag as pickByWeight, ah as resolveExperiments, ai as resolveLocale, aj as resolveOffering, ak as resolveRoute } from './manifest-Dp1oRvqp.cjs';
 import { NavSnapshot } from './protocol.cjs';
-import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-BM1T-u6_.cjs';
-export { b as Checkout, c as CheckoutAppearance, d as CheckoutButton, e as CheckoutButtonProps, f as CheckoutCallbacks, g as CheckoutClassNames, h as CheckoutCommonProps, i as CheckoutHandle, j as CheckoutInlineProps, k as CheckoutMethods, l as CheckoutProps, m as CheckoutRequest, n as CheckoutResult, o as CheckoutResume, p as CheckoutSpinner, q as CheckoutStatus, F as FailureModalProps, r as FailureRoute, M as MockDriverOptions, O as OnFailedMap, s as OpensAxis, P as PaymentAxis, T as TriggerAxis, t as TriggerState, U as UpsellButton, u as UpsellButtonProps, v as UpsellCommonProps, w as UpsellRecovery, x as UseCheckoutOptions, y as createMockDriver, z as driverWithEmail, A as useCheckout } from './checkout-BM1T-u6_.cjs';
+import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-C4tFUEdF.cjs';
+export { b as Checkout, c as CheckoutAppearance, d as CheckoutButton, e as CheckoutButtonProps, f as CheckoutCallbacks, g as CheckoutClassNames, h as CheckoutCommonProps, i as CheckoutHandle, j as CheckoutInlineProps, k as CheckoutMethods, l as CheckoutProps, m as CheckoutRequest, n as CheckoutResult, o as CheckoutResume, p as CheckoutSpinner, q as CheckoutStatus, F as FailureModalProps, r as FailureRoute, M as MockDriverOptions, O as OnFailedMap, s as OpensAxis, P as PaymentAxis, T as TriggerAxis, t as TriggerState, U as UpsellButton, u as UpsellButtonProps, v as UpsellCommonProps, w as UpsellRecovery, x as UseCheckoutOptions, y as createMockDriver, z as driverWithEmail, A as useCheckout } from './checkout-C4tFUEdF.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, D as DeviceClass, H as HostedPaymentMode, I as INLINE_SURFACES, M as MANAGED_PROFILES, O as OffSessionReliability, e as OpensIn, P as PAYMENT_RENDERINGS, f as PROVIDER_HOSTED_SURFACES, g as PROVIDER_PROFILES, h as PaymentMode, i as PaymentRendering, j as ProviderProfile, k as ProviderVariant, S as SurfaceCapability, l as SurfacePreference, U as UpsellKind, V as ValidationResult, m as checkoutError, n as isCompleteSurface, o as isInlineSurface, p as isMerchantOfRecord, q as isOrchestrator, r as isProviderHostedSurface, s as isRenderableSurface, t as profileFor, u as renderableSurfaces, v as resolvePayment, w as resolveSurface, x as supportsManaged, y as surfacesFor, z as validateCheckout, A as validateTrialSurface, B as validateUpsell } from './capabilities-BtnJi2JD.cjs';
@@ -193,6 +193,12 @@ interface FunnelEventDataMap {
         productId?: string;
         eventId?: string;
     };
+    'subscription.trial_started': {
+        amount?: number;
+        currency?: string;
+        productId?: string;
+        eventId?: string;
+    };
     'experiment.exposure': {
         experimentId: string;
         variant: string;
@@ -352,9 +358,12 @@ declare function attachBus(bus: FunnelBus): () => void;
  * versioned + published with the funnel. The dashboard's manual translation
  * table edits exactly these catalogs.
  *
- * Lookup walks a **fallback chain** (active → fallback → default) so a missing
+ * Lookup walks a **fallback chain** (active → fallback → default), widening each
+ * step from a regional tag to its language (`en-US` → the `en` catalog) exactly
+ * as {@link ./locale}'s `resolveLocale` matches supported locales, so a missing
  * string never blanks — it falls through, and only as a last resort returns the
- * key (flagged in dev). Interpolation is simple `{{var}}`; plurals use the
+ * key (flagged in dev). See {@link lookupMessage} for why that widening is not
+ * optional. Interpolation is simple `{{var}}`; plurals use the
  * built-in `Intl.PluralRules`; numbers/dates/percent use `Intl`. No ICU, no rich
  * markup (markup stays in TSX).
  */
@@ -1401,6 +1410,16 @@ declare const EVENT_CATALOG: {
         readonly tracking: true;
         readonly integrations: true;
     };
+    readonly 'subscription.trial_started': {
+        readonly sources: ["backend"];
+        readonly tracking: true;
+        readonly integrations: true;
+    };
+    readonly 'subscription.trial_converted': {
+        readonly sources: ["backend"];
+        readonly tracking: true;
+        readonly integrations: true;
+    };
     readonly 'subscription.renewal': {
         readonly sources: ["backend"];
         readonly tracking: true;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import * as react from 'react';
 import { ReactNode, ComponentType, ButtonHTMLAttributes, AnchorHTMLAttributes } from 'react';
-import { O as Offering, V as VariableValue, a as VariableConfig, A as Acquisition, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as OfferingInput, P as PageMeta, f as PageContext, G as GroupProgress } from './manifest-BajvtPWs.js';
-export { B as BrowserContext, g as BuildContextOptions, C as ClickIdContext, h as CompileInput, i as Condition, j as ConditionOp, k as DeviceContext, E as EdgeCondition, l as ExperimentArm, m as ExperimentResolution, n as FlowPage, o as FunnelLocales, p as FunnelManifest, q as Gate, I as IdentityContext, r as Interval, L as LocaleContext, M as ManifestEdge, s as ManifestPage, t as ManifestValidation, u as Money, v as OsContext, w as PageComponent, x as PageGroup, y as PageType, z as Predicate, H as ResolvedOffering, J as Route, S as SampleOffering, K as SessionContext, N as SystemContext, U as UtmContext, Q as assignVariant, T as bucketingSeed, W as buildAcquisition, X as buildCatalog, Y as compileManifest, Z as currencyExponent, _ as defineFunnel, $ as definePage, a0 as entryGuard, a1 as evaluateCondition, a2 as evaluateGate, a3 as expectedPathLength, a4 as fnv1a, a5 as formatMoney, a6 as formatOffering, a7 as formatSampleOffering, a8 as groupProgress, a9 as hashToUnit, aa as isRtl, ab as isVariantKey, ac as nextPage, ad as outgoingKeys, ae as pageMeta, af as parseSlotKey, ag as pickByWeight, ah as resolveExperiments, ai as resolveLocale, aj as resolveOffering, ak as resolveRoute } from './manifest-BajvtPWs.js';
+import { O as Offering, V as VariableValue, a as VariableConfig, A as Acquisition, D as Direction, F as FunnelContext, R as RuntimeExperiment, b as FunnelSnapshot, c as FunnelDefinition, d as buildContext, e as OfferingInput, P as PageMeta, f as PageContext, G as GroupProgress } from './manifest-Dp1oRvqp.js';
+export { B as BrowserContext, g as BuildContextOptions, C as ClickIdContext, h as CompileInput, i as Condition, j as ConditionOp, k as DeviceContext, E as EdgeCondition, l as ExperimentArm, m as ExperimentResolution, n as FlowPage, o as FunnelLocales, p as FunnelManifest, q as Gate, I as IdentityContext, r as Interval, L as LocaleContext, M as ManifestEdge, s as ManifestPage, t as ManifestValidation, u as Money, v as OsContext, w as PageComponent, x as PageGroup, y as PageType, z as Predicate, H as ResolvedOffering, J as Route, S as SampleOffering, K as SessionContext, N as SystemContext, U as UtmContext, Q as assignVariant, T as bucketingSeed, W as buildAcquisition, X as buildCatalog, Y as compileManifest, Z as currencyExponent, _ as defineFunnel, $ as definePage, a0 as entryGuard, a1 as evaluateCondition, a2 as evaluateGate, a3 as expectedPathLength, a4 as fnv1a, a5 as formatMoney, a6 as formatOffering, a7 as formatSampleOffering, a8 as groupProgress, a9 as hashToUnit, aa as isRtl, ab as isVariantKey, ac as nextPage, ad as outgoingKeys, ae as pageMeta, af as parseSlotKey, ag as pickByWeight, ah as resolveExperiments, ai as resolveLocale, aj as resolveOffering, ak as resolveRoute } from './manifest-Dp1oRvqp.js';
 import { NavSnapshot } from './protocol.js';
-import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-BYcOfyg_.js';
-export { b as Checkout, c as CheckoutAppearance, d as CheckoutButton, e as CheckoutButtonProps, f as CheckoutCallbacks, g as CheckoutClassNames, h as CheckoutCommonProps, i as CheckoutHandle, j as CheckoutInlineProps, k as CheckoutMethods, l as CheckoutProps, m as CheckoutRequest, n as CheckoutResult, o as CheckoutResume, p as CheckoutSpinner, q as CheckoutStatus, F as FailureModalProps, r as FailureRoute, M as MockDriverOptions, O as OnFailedMap, s as OpensAxis, P as PaymentAxis, T as TriggerAxis, t as TriggerState, U as UpsellButton, u as UpsellButtonProps, v as UpsellCommonProps, w as UpsellRecovery, x as UseCheckoutOptions, y as createMockDriver, z as driverWithEmail, A as useCheckout } from './checkout-BYcOfyg_.js';
+import { a as CheckoutDriver, C as CheckoutDriverContext } from './checkout-B1K6ozwk.js';
+export { b as Checkout, c as CheckoutAppearance, d as CheckoutButton, e as CheckoutButtonProps, f as CheckoutCallbacks, g as CheckoutClassNames, h as CheckoutCommonProps, i as CheckoutHandle, j as CheckoutInlineProps, k as CheckoutMethods, l as CheckoutProps, m as CheckoutRequest, n as CheckoutResult, o as CheckoutResume, p as CheckoutSpinner, q as CheckoutStatus, F as FailureModalProps, r as FailureRoute, M as MockDriverOptions, O as OnFailedMap, s as OpensAxis, P as PaymentAxis, T as TriggerAxis, t as TriggerState, U as UpsellButton, u as UpsellButtonProps, v as UpsellCommonProps, w as UpsellRecovery, x as UseCheckoutOptions, y as createMockDriver, z as driverWithEmail, A as useCheckout } from './checkout-B1K6ozwk.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, D as DeviceClass, H as HostedPaymentMode, I as INLINE_SURFACES, M as MANAGED_PROFILES, O as OffSessionReliability, e as OpensIn, P as PAYMENT_RENDERINGS, f as PROVIDER_HOSTED_SURFACES, g as PROVIDER_PROFILES, h as PaymentMode, i as PaymentRendering, j as ProviderProfile, k as ProviderVariant, S as SurfaceCapability, l as SurfacePreference, U as UpsellKind, V as ValidationResult, m as checkoutError, n as isCompleteSurface, o as isInlineSurface, p as isMerchantOfRecord, q as isOrchestrator, r as isProviderHostedSurface, s as isRenderableSurface, t as profileFor, u as renderableSurfaces, v as resolvePayment, w as resolveSurface, x as supportsManaged, y as surfacesFor, z as validateCheckout, A as validateTrialSurface, B as validateUpsell } from './capabilities-BtnJi2JD.js';
@@ -193,6 +193,12 @@ interface FunnelEventDataMap {
         productId?: string;
         eventId?: string;
     };
+    'subscription.trial_started': {
+        amount?: number;
+        currency?: string;
+        productId?: string;
+        eventId?: string;
+    };
     'experiment.exposure': {
         experimentId: string;
         variant: string;
@@ -352,9 +358,12 @@ declare function attachBus(bus: FunnelBus): () => void;
  * versioned + published with the funnel. The dashboard's manual translation
  * table edits exactly these catalogs.
  *
- * Lookup walks a **fallback chain** (active → fallback → default) so a missing
+ * Lookup walks a **fallback chain** (active → fallback → default), widening each
+ * step from a regional tag to its language (`en-US` → the `en` catalog) exactly
+ * as {@link ./locale}'s `resolveLocale` matches supported locales, so a missing
  * string never blanks — it falls through, and only as a last resort returns the
- * key (flagged in dev). Interpolation is simple `{{var}}`; plurals use the
+ * key (flagged in dev). See {@link lookupMessage} for why that widening is not
+ * optional. Interpolation is simple `{{var}}`; plurals use the
  * built-in `Intl.PluralRules`; numbers/dates/percent use `Intl`. No ICU, no rich
  * markup (markup stays in TSX).
  */
@@ -1401,6 +1410,16 @@ declare const EVENT_CATALOG: {
         readonly tracking: true;
         readonly integrations: true;
     };
+    readonly 'subscription.trial_started': {
+        readonly sources: ["backend"];
+        readonly tracking: true;
+        readonly integrations: true;
+    };
+    readonly 'subscription.trial_converted': {
+        readonly sources: ["backend"];
+        readonly tracking: true;
+        readonly integrations: true;
+    };
     readonly 'subscription.renewal': {
         readonly sources: ["backend"];
         readonly tracking: true;

package/dist/index.js

@@ -1,6 +1,6 @@
 export { compileManifest } from './chunk-BOO6HJ4Y.js';
-import { useLocale, createConsoleTracker, exposurePayload, FunnelProvider, FunnelView, useField, useNavigation, useFunnel, CheckoutResume, EmbedBridge } from './chunk-PN7CRJAF.js';
-export { Checkout, CheckoutButton, CheckoutResume, CheckoutSpinner, FunnelProvider, FunnelToaster, FunnelView, Modal, Sheet, UpsellButton, VariableStore, attachBus, buildAcquisition, buildContext, createBus, createConsoleTracker, createFunnelStore, createMockDriver, defineModal, dismissAllModals, driverWithEmail, hideModal, isValidEmail, newEventId, registerModal, removeModal, showModal, toast, unregisterModal, useActiveLocale, useCheckout, useClickIds, useContextValue, useData, useDevice, useExperiment, useField, useFunnel, useGroupProgress, useLocale, useMarketingConsent, useModal, useNavigation, useOffering, useOfferings, usePage, useResponse, useSystem, useTracker, useTranslation, useUserAttribute, useUtm, withBus } from './chunk-PN7CRJAF.js';
+import { useLocale, createConsoleTracker, exposurePayload, FunnelProvider, FunnelView, useField, useNavigation, useFunnel, CheckoutResume, EmbedBridge } from './chunk-WCBVSZHJ.js';
+export { Checkout, CheckoutButton, CheckoutResume, CheckoutSpinner, FunnelProvider, FunnelToaster, FunnelView, Modal, Sheet, UpsellButton, VariableStore, attachBus, buildAcquisition, buildContext, createBus, createConsoleTracker, createFunnelStore, createMockDriver, defineModal, dismissAllModals, driverWithEmail, hideModal, isValidEmail, newEventId, registerModal, removeModal, showModal, toast, unregisterModal, useActiveLocale, useCheckout, useClickIds, useContextValue, useData, useDevice, useExperiment, useField, useFunnel, useGroupProgress, useLocale, useMarketingConsent, useModal, useNavigation, useOffering, useOfferings, usePage, useResponse, useSystem, useTracker, useTranslation, useUserAttribute, useUtm, withBus } from './chunk-WCBVSZHJ.js';
 export { assignVariant, bucketingSeed, buildCatalog, currencyExponent, defineFunnel, definePage, entryGuard, evaluateCondition, evaluateGate, expectedPathLength, fnv1a, formatMoney, formatOffering, formatSampleOffering, groupProgress, hashToUnit, isRtl, isVariantKey, nextPage, outgoingKeys, pageMeta, parseSlotKey, pickByWeight, resolveExperiments, resolveLocale, resolveOffering, resolveRoute } from './chunk-WIFTHXF5.js';
 import './chunk-U5R4ILJT.js';
 import './chunk-XEIWE7NY.js';
@@ -649,6 +649,17 @@ var EVENT_CATALOG = {
   "purchase.complete": { sources: ["backend"], tracking: true, integrations: true },
   "customer.first_purchase": { sources: ["backend"], tracking: true, integrations: true },
   "subscription.created": { sources: ["backend"], tracking: true, integrations: true },
+  // A trial START — free or paid. Fires INSTEAD OF purchase.complete/subscription.created for a
+  // trial settlement: one event per settlement, and a taxonomy that can distinguish a trial from
+  // an outright sale. Value is the money that moved (0 free / fee paid), never the sticker price
+  // of the subscription behind it. Ad networks map it back onto `Purchase` with every other
+  // acquisition; the distinction is kept for analytics/GTM/customer.io.
+  "subscription.trial_started": { sources: ["backend"], tracking: true, integrations: true },
+  // A recurring charge and the FIRST charge after a trial are economically different events, and
+  // neither is an initial purchase. Keeping them apart is load-bearing for ad networks: collapsing
+  // them onto the same name as `purchase.complete` double-counts one customer in the ad account's
+  // Purchase column, trains the bidder on money no click caused, and inflates reported ROAS.
+  "subscription.trial_converted": { sources: ["backend"], tracking: true, integrations: true },
   "subscription.renewal": { sources: ["backend"], tracking: true, integrations: true }
 };
 function isTrackableEvent(name) {