@funnelsgrove/runtime 0.1.44 → 0.1.46

package/README.md

@@ -2,60 +2,65 @@
 
 Shared funnel runtime contracts and helpers.
 
-## Build And Publish
+Read this file before editing shared funnel mechanics. Deeper runtime behavior is
+documented in [`docs/product-specs/funnel-template-runtime.md`](../../docs/product-specs/funnel-template-runtime.md).
 
-- Build distributable output with `npm run build --workspace @funnelsgrove/runtime`.
-- Publish from the repo root with `npm publish --workspace @funnelsgrove/runtime --access public`.
-- Local repo installs still resolve this package through npm workspaces when another workspace depends on version `0.1.1`.
-- The build normalizes generated relative ESM imports to explicit `.js` files for published package consumers.
+## Owns funnel mechanics
+
+`@funnelsgrove/runtime` owns the reusable mechanics that every generated or published funnel depends on: manifests, routing, env resolution, funnel state, preview/runtime detection, and generic runtime UI. Funnels bring their own copy, visual design, billing catalog, and step JSX.
 
 ## Use This Package For
 
 - manifest types and validation
 - route resolution and entry-point handling
+- runtime mode and public env/config resolution
 - experiment assignment helpers
 - preview-bridge parsing and preview/runtime detection
 - published theme contract and CSS variable helpers
-- funnel context, base controls, and reusable runtime UI primitives
-- subscription handoff and subscription management screens whose copy stays funnel-local
+- funnel context, flow controller, and generic runtime UI primitives
+- funnel-scoped state/storage helpers
 - browser-safe API client helpers used by funnels
-- a shared test-mode developer info box for funnel-local preview tooling
-
-## Responsibilities
-
-- keep funnel mechanics consistent across every funnel
-- expose stable contracts for routing, previews, and step identity
-- avoid funnel-specific copy, visual design, or billing plan catalogs
-
-## What Belongs Here
-
-- reusable runtime helpers that any funnel can use
-- shared browser/event/storage helpers tied to funnel behavior
-- funnel-scoped paywall state helpers that keep runtime-owned storage keys under `fg_...`
-- hosted-path navigation helpers so static previews keep their `/published/f/...` or `/catalog/...` prefix
-- generic context and base component primitives
-- safe local-only fallbacks when no real SDK publishable key is configured
-- shared preview-checkout publishable key fallback used by paywalls when only the seed placeholder is configured
-- default runtime config values for API/bootstrap wiring
-- env-backed support email rendering for shared subscription management screens
-- full-step subscription management surfaces that avoid exposing an outer page background rim
-- subscription handoff link rendering for iOS, Android, and desktop/web fallbacks from runtime env
-- subscription handoff browser-only values are resolved after mount so published success routes hydrate without text mismatches
-- public subscription summaries with provider plan and period metadata for funnel-local management screens
-- a bottom-right `RuntimeDevInfoBox` that funnels can mount in test mode to inspect public runtime config with one canonical env/config name per row, copy the current funnel user id/email, switch to live mode, and clear funnel-scoped paywall state
+- subscription handoff and subscription management screens whose copy stays funnel-local
+- test-mode developer info surfaces for funnel preview tooling
+
+## Do Not Use This Package For
+
+- funnel-specific step JSX
+- brand/theme assets
+- billing catalog data
+- analytics transport
+- Stripe checkout UI
+- funnel-specific developer widget copy
+- direct provider SDK calls
+
+## Public Surfaces
+
+- `config/*`: manifest, theme, font, env, and builder-preview contracts.
+- `runtime/*`: flow, routing, attribution, feature flags, preview bridge, URL attributes, and manifest validation.
+- `services/*`: API client, runtime mode, public env, project env, logger, and funnel state helpers.
+- `components/*`: generic runtime context, subscription handoff/management, editor panel, dev info, and base controls.
+- `content/*` and `steps/types`: shared step content and taxonomy contracts.
 
 ## Storage Conventions
 
 - runtime user ids stay funnel-scoped under `funnel:<funnelId>:user-id`
 - runtime-generated user ids use the `u_` prefix
 - paywall state is stored through runtime helpers under `fg_state:<funnelId>`
-- developer reset controls should clear paywall state through `clearPaywallStateValue`, including any funnel-provided legacy keys
+- developer reset controls should clear paywall state through `clearPaywallStateValue`, including funnel-provided compatibility keys when a live funnel still needs them
 
-## What Does Not Belong Here
+## Engineering Rules
 
-- funnel-specific step JSX
-- brand/theme assets
-- billing catalog data
-- analytics SDK transport
-- Stripe checkout UI
-- funnel-specific developer widget copy, config extras, or legacy storage keys
+- Do not import `@funnelsgrove/payments` or `@funnelsgrove/analytics` here for checkout or transport orchestration.
+- Runtime UI must be generic and copy-injectable.
+- Browser-only values must resolve after mount when SSR hydration can be affected.
+- Keep env mapping centralized in `config/env.config.ts`.
+
+## Build, Test, Publish
+
+```bash
+npm run test:run --workspace @funnelsgrove/runtime
+npm run build --workspace @funnelsgrove/runtime
+npm publish --workspace @funnelsgrove/runtime --access public
+```
+
+The build normalizes generated relative ESM imports to explicit `.js` files for published package consumers.

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export * from './runtime/subscription-handoff.js';
 export * from './runtime/url-user-attributes.js';
 export * from './runtime/use-url-user-attributes-sync.js';
 export * from './services/api.service.js';
+export * from './services/funnel-sdk.service.js';
 export * from './services/funnel-state.service.js';
 export * from './services/logger.js';
 export * from './services/preview-frame.service.js';

package/dist/index.js

@@ -1,10 +1,13 @@
+// Shared config contracts.
 export * from './config/builder-preview.protocol.js';
 export * from './config/env.config.js';
 export * from './config/funnel.manifest.types.js';
 export * from './config/funnel.experiments.types.js';
 export * from './config/funnel-theme.js';
 export * from './config/font-config.js';
+// Structured content contracts.
 export * from './content/step-content.js';
+// Runtime mechanics.
 export * from './runtime/experiment-assignment.js';
 export * from './runtime/browser-helpers.js';
 export * from './runtime/funnel-flow.js';
@@ -20,7 +23,9 @@ export * from './runtime/route-resolver.js';
 export * from './runtime/subscription-handoff.js';
 export * from './runtime/url-user-attributes.js';
 export * from './runtime/use-url-user-attributes-sync.js';
+// Browser-safe services.
 export * from './services/api.service.js';
+export * from './services/funnel-sdk.service.js';
 export * from './services/funnel-state.service.js';
 export * from './services/logger.js';
 export * from './services/preview-frame.service.js';
@@ -28,6 +33,7 @@ export * from './services/project-env.js';
 export * from './services/public-env.js';
 export * from './services/runtime-api.config.js';
 export * from './services/runtime-mode.service.js';
+// SDK and generic runtime UI.
 export * from './sdk/userAnswers.js';
 export * from './components/FunnelContext.js';
 export * from './components/FunnelEditorPanel.js';

package/dist/runtime/offer-set-runtime.d.ts

@@ -2,6 +2,7 @@ import type { RuntimeMode } from '../services/runtime-mode.service.js';
 export type GeneratedOfferSetItemKind = 'plan' | 'upsell' | 'downsell';
 export type GeneratedOfferSetPlanModeConfig = {
     readonly providerPlanId?: string | null;
+    readonly paymentMode?: string | null;
     readonly priceLabel?: string | null;
     readonly perDayAmount?: string | null;
     readonly perDayLabel?: string | null;
@@ -63,6 +64,7 @@ export type OfferSetRuntimeDiscount = {
 export type OfferSetRuntimePlanOverrides = {
     projectPlanId?: string;
     providerPlanId?: string;
+    paymentMode?: 'one_time';
     analyticsPurchaseValue?: number;
     title?: string;
     description?: string;

package/dist/runtime/offer-set-runtime.js

@@ -34,6 +34,15 @@ const readPositiveInteger = (value) => {
     const numeric = readFiniteNumber(value);
     return numeric !== null && numeric > 0 ? Math.round(numeric) : null;
 };
+const readOneTimePaymentMode = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase().replace(/[\s-]+/g, '_');
+    return normalized === 'one_time' || normalized === 'payment' || normalized === 'payment_intent'
+        ? 'one_time'
+        : null;
+};
 const getOfferSetItemKind = (item) => {
     var _a;
     const metadata = isRecord(item.metadata) ? item.metadata : {};
@@ -117,7 +126,7 @@ const readGeneratedPlanNumberValue = (item, mode, itemKeys, metadataKeys = itemK
     return ((_b = (_a = readFiniteNumberField(modeConfig, metadataKeys)) !== null && _a !== void 0 ? _a : itemValue) !== null && _b !== void 0 ? _b : readFiniteNumberField(metadata, metadataKeys));
 };
 const buildGeneratedPlanOverrides = (item, mode, isDefault) => {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
     const metadata = readOfferItemMetadata(item);
     const providerPlanId = readProviderPlanId(item, mode);
     const projectPlanId = (_a = readString(item.projectBillingPlanId)) !== null && _a !== void 0 ? _a : readStringField(metadata, ['projectBillingPlanId', 'projectPlanId', 'project_billing_plan_id']);
@@ -130,10 +139,12 @@ const buildGeneratedPlanOverrides = (item, mode, isDefault) => {
     const billingInterval = readGeneratedPlanStringValue(item, mode, ['billingInterval']);
     const billingIntervalCount = readGeneratedPlanNumberValue(item, mode, ['billingIntervalCount']);
     const amountCents = readGeneratedPlanNumberValue(item, mode, ['amountCents']);
-    const analyticsPurchaseValue = (_d = readFiniteNumber(item.analyticsPurchaseValue)) !== null && _d !== void 0 ? _d : readFiniteNumberField(metadata, ['analyticsPurchaseValue']);
-    const featuredTag = (_e = readString(item.featuredTag)) !== null && _e !== void 0 ? _e : readStringField(metadata, ['featuredTag']);
-    const oldPriceLabel = (_f = readString(item.oldPriceLabel)) !== null && _f !== void 0 ? _f : readStringField(metadata, ['oldPriceLabel']);
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (projectPlanId ? { projectPlanId } : {})), (providerPlanId ? { providerPlanId } : {})), (analyticsPurchaseValue !== null ? { analyticsPurchaseValue } : {})), (title ? { title } : {})), (description ? { description } : {})), (priceLabel ? { priceLabel } : {})), (perDayAmount ? { perDayAmount } : {})), (perDayLabel ? { perDayLabel } : {})), (amountCents !== null ? { amountCents: Math.max(0, Math.round(amountCents)) } : {})), (checkoutSummaryLabel ? { checkoutSummaryLabel } : {})), (billingInterval ? { billingInterval } : {})), (billingIntervalCount !== null ? { billingIntervalCount: Math.max(1, Math.round(billingIntervalCount)) } : {})), (featuredTag ? { featuredTag } : {})), (oldPriceLabel ? { oldPriceLabel } : {})), (isDefault ? { isDefault: true } : {}));
+    const modeConfig = readGeneratedModeConfig(item, mode);
+    const paymentMode = (_k = (_j = (_h = (_g = (_f = (_e = (_d = readOneTimePaymentMode(modeConfig.paymentMode)) !== null && _d !== void 0 ? _d : readOneTimePaymentMode(modeConfig.payment_mode)) !== null && _e !== void 0 ? _e : readOneTimePaymentMode(modeConfig.checkoutMode)) !== null && _f !== void 0 ? _f : readOneTimePaymentMode(modeConfig.checkout_mode)) !== null && _g !== void 0 ? _g : readOneTimePaymentMode(metadata.paymentMode)) !== null && _h !== void 0 ? _h : readOneTimePaymentMode(metadata.payment_mode)) !== null && _j !== void 0 ? _j : readOneTimePaymentMode(metadata.checkoutMode)) !== null && _k !== void 0 ? _k : readOneTimePaymentMode(metadata.checkout_mode);
+    const analyticsPurchaseValue = (_l = readFiniteNumber(item.analyticsPurchaseValue)) !== null && _l !== void 0 ? _l : readFiniteNumberField(metadata, ['analyticsPurchaseValue']);
+    const featuredTag = (_m = readString(item.featuredTag)) !== null && _m !== void 0 ? _m : readStringField(metadata, ['featuredTag']);
+    const oldPriceLabel = (_o = readString(item.oldPriceLabel)) !== null && _o !== void 0 ? _o : readStringField(metadata, ['oldPriceLabel']);
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (projectPlanId ? { projectPlanId } : {})), (providerPlanId ? { providerPlanId } : {})), (paymentMode ? { paymentMode } : {})), (analyticsPurchaseValue !== null ? { analyticsPurchaseValue } : {})), (title ? { title } : {})), (description ? { description } : {})), (priceLabel ? { priceLabel } : {})), (perDayAmount ? { perDayAmount } : {})), (perDayLabel ? { perDayLabel } : {})), (amountCents !== null ? { amountCents: Math.max(0, Math.round(amountCents)) } : {})), (checkoutSummaryLabel ? { checkoutSummaryLabel } : {})), (billingInterval ? { billingInterval } : {})), (billingIntervalCount !== null ? { billingIntervalCount: Math.max(1, Math.round(billingIntervalCount)) } : {})), (featuredTag ? { featuredTag } : {})), (oldPriceLabel ? { oldPriceLabel } : {})), (isDefault ? { isDefault: true } : {}));
 };
 export const applyGeneratedOfferSetToPlanCatalog = (baseCatalog, mode, offerSet) => {
     var _a, _b, _c;

package/dist/runtime/posthog-flags.d.ts

@@ -1,5 +1,6 @@
 import type { PostHog } from 'posthog-js';
 export declare const POSTHOG_FEATURE_FLAG_READY_TIMEOUT_MS = 2500;
+export declare const POSTHOG_SCOPED_FLAG_RELOAD_RETRY_MS = 300;
 type BootstrapConfig = {
     apiKey: string;
     apiHost: string;

package/dist/runtime/posthog-flags.js

@@ -3,6 +3,7 @@ import { runtimePublicConfig } from '../services/public-env.js';
 let initialized = false;
 let readyPromise = null;
 export const POSTHOG_FEATURE_FLAG_READY_TIMEOUT_MS = 2500;
+export const POSTHOG_SCOPED_FLAG_RELOAD_RETRY_MS = 300;
 const STORED_PERSON_PROPERTIES_KEY = '$stored_person_properties';
 const buildFlagScopeProperties = (config) => {
     var _a, _b;
@@ -84,7 +85,17 @@ export const bootstrapPostHog = (config) => {
             bootstrap: { distinctID: config.distinctId },
             loaded: () => {
                 let unsubscribe = null;
-                unsubscribe = posthog.onFeatureFlags(() => {
+                let scopedReloadRetried = false;
+                unsubscribe = posthog.onFeatureFlags((flags) => {
+                    if (Object.keys(scopeProperties).length > 0 &&
+                        flags.length === 0 &&
+                        !scopedReloadRetried) {
+                        scopedReloadRetried = true;
+                        setTimeout(() => {
+                            posthog.reloadFeatureFlags();
+                        }, POSTHOG_SCOPED_FLAG_RELOAD_RETRY_MS);
+                        return;
+                    }
                     unsubscribe === null || unsubscribe === void 0 ? void 0 : unsubscribe();
                     markReady();
                 });

package/dist/services/api.service.js

@@ -1,4 +1,5 @@
-import { buildMainApiUrl, buildSdkHeaders, FUNNEL_ID, FUNNEL_VERSION_ID, getFunnelSdkPublishableKey, } from './runtime-api.config.js';
+import { buildSdkHeaders, FUNNEL_ID, getFunnelSdkPublishableKey, } from './runtime-api.config.js';
+import { funnelSdkService } from './funnel-sdk.service.js';
 import { mergeFunnelUserAttribution, } from '../runtime/funnel-attribution.js';
 import { applyUrlUserAttributesToUser, hasUrlUserProfileAttributes, resolveUrlUserAttributes, } from '../runtime/url-user-attributes.js';
 const DEFAULT_USER_ID_STORAGE_KEY = 'funnel:user-id';
@@ -144,28 +145,6 @@ const toAppUser = (input) => {
         document: Object.keys(apiDocument).length > 0 ? apiDocument : ((_b = input.fallbackDocument) !== null && _b !== void 0 ? _b : {}),
     };
 };
-const parseErrorMessage = async (response, fallbackMessage) => {
-    try {
-        const payload = (await response.json());
-        const apiError = asString(payload.error);
-        if (apiError) {
-            return apiError;
-        }
-    }
-    catch (_a) {
-        // ignore JSON parsing errors
-    }
-    try {
-        const errorText = await response.text();
-        if (errorText.trim()) {
-            return errorText;
-        }
-    }
-    catch (_b) {
-        // ignore text parsing errors
-    }
-    return fallbackMessage;
-};
 class ApiService {
     readFileAsDataUrl(file) {
         return new Promise((resolve, reject) => {
@@ -209,18 +188,10 @@ class ApiService {
         if (!publishableKey || !FUNNEL_ID) {
             return null;
         }
-        const url = new URL(buildMainApiUrl('/sdk/public/users/me'));
-        url.searchParams.set('funnelId', FUNNEL_ID);
-        url.searchParams.set('user_id', userId);
         try {
-            const response = await fetch(url.toString(), {
-                method: 'GET',
-                headers: buildSdkHeaders({}),
+            return await funnelSdkService.getCurrentUser({
+                userId,
             });
-            if (!response.ok) {
-                return null;
-            }
-            return (await response.json());
         }
         catch (_a) {
             return null;
@@ -260,30 +231,16 @@ class ApiService {
                 fallbackDocument: withMergedAttributionDocument({}, input === null || input === void 0 ? void 0 : input.attribution),
             });
         }
-        const response = await fetch(buildMainApiUrl('/sdk/public/users/bootstrap'), {
-            method: 'POST',
-            headers: buildSdkHeaders({
-                'Content-Type': 'application/json',
-            }),
-            body: JSON.stringify({
-                publishableKey,
-                funnelId: FUNNEL_ID || undefined,
-                funnelVersionId: FUNNEL_VERSION_ID || undefined,
-                user_id: userId,
-                email: inputEmail,
-                fullName: inputName,
-                metadata: {
-                    source: 'funnel-session',
-                    environment: resolveRuntimeAnalyticsEnvironment(),
-                },
-                attribution: input === null || input === void 0 ? void 0 : input.attribution,
-            }),
+        const payload = await funnelSdkService.bootstrapUser({
+            userId,
+            email: inputEmail,
+            fullName: inputName,
+            metadata: {
+                source: 'funnel-session',
+                environment: resolveRuntimeAnalyticsEnvironment(),
+            },
+            attribution: input === null || input === void 0 ? void 0 : input.attribution,
         });
-        if (!response.ok) {
-            const errorMessage = await parseErrorMessage(response, 'Failed to bootstrap user session');
-            throw new Error(errorMessage);
-        }
-        const payload = (await response.json());
         const persistedUserId = persistUserId(asString((_a = payload.user) === null || _a === void 0 ? void 0 : _a.user_id) ||
             asString(payload.user_id) ||
             userId, FUNNEL_ID) || userId;
@@ -307,33 +264,19 @@ class ApiService {
                 fallbackDocument: withMergedAttributionDocument(user.document, options === null || options === void 0 ? void 0 : options.attribution),
             });
         }
-        const response = await fetch(buildMainApiUrl('/public/funnel-users/upsert'), {
-            method: 'POST',
-            headers: buildSdkHeaders({
-                'Content-Type': 'application/json',
-            }),
-            body: JSON.stringify({
-                publishableKey,
-                funnelId: FUNNEL_ID || undefined,
-                funnelVersionId: FUNNEL_VERSION_ID || undefined,
-                user_id: persistedUserId,
-                email: user.email || undefined,
-                fullName: user.name || undefined,
-                progress: {
-                    attributes: user.attributes || {},
-                },
-                metadata: {
-                    source: 'funnel',
-                    environment: resolveRuntimeAnalyticsEnvironment(),
-                },
-                attribution: options === null || options === void 0 ? void 0 : options.attribution,
-            }),
+        const payload = await funnelSdkService.updateFunnelUser({
+            userId: persistedUserId,
+            email: user.email || undefined,
+            fullName: user.name || undefined,
+            progress: {
+                attributes: user.attributes || {},
+            },
+            metadata: {
+                source: 'funnel',
+                environment: resolveRuntimeAnalyticsEnvironment(),
+            },
+            attribution: options === null || options === void 0 ? void 0 : options.attribution,
         });
-        if (!response.ok) {
-            const errorMessage = await parseErrorMessage(response, 'Failed to update user');
-            throw new Error(errorMessage);
-        }
-        const payload = (await response.json());
         return toAppUser({
             apiUser: payload.user,
             userId: persistedUserId,
@@ -407,26 +350,13 @@ class ApiService {
                 uploadedAt: new Date().toISOString(),
             };
         }
-        const response = await fetch(buildMainApiUrl('/sdk/public/uploads/photos'), {
-            method: 'POST',
-            headers: buildSdkHeaders({
-                'Content-Type': 'application/json',
-            }),
-            body: JSON.stringify({
-                publishableKey,
-                funnelId: FUNNEL_ID || undefined,
-                user_id: userId,
-                fileName: input.file.name || 'capture.jpg',
-                mimeType: input.file.type || undefined,
-                imageDataUrl,
-                source: input.source || 'upload',
-            }),
+        const payload = await funnelSdkService.uploadPhoto({
+            userId,
+            fileName: input.file.name || 'capture.jpg',
+            mimeType: input.file.type || undefined,
+            imageDataUrl,
+            source: input.source || 'upload',
         });
-        if (!response.ok) {
-            const errorMessage = await parseErrorMessage(response, 'Failed to upload photo');
-            throw new Error(errorMessage);
-        }
-        const payload = (await response.json());
         const publicUrl = asString(payload.publicUrl);
         const key = asString(payload.key);
         const contentType = asString(payload.contentType) || input.file.type || 'image/jpeg';
@@ -446,48 +376,23 @@ class ApiService {
     async getManageSubscriptions() {
         const userId = this.getSubscriptionManagementUserId();
         const stripeCustomerId = this.getSubscriptionManagementStripeCustomerId();
-        const query = new URLSearchParams();
-        if (userId) {
-            query.set('user_id', userId);
-        }
-        if (stripeCustomerId) {
-            query.set('stripe_customer_id', stripeCustomerId);
-        }
-        if (FUNNEL_ID) {
-            query.set('funnelId', FUNNEL_ID);
-        }
-        const response = await fetch(buildMainApiUrl(`/sdk/public/subscriptions?${query.toString()}`), {
-            method: 'GET',
-            cache: 'no-store',
-            headers: buildSdkHeaders(),
+        return funnelSdkService.listSubscriptions({
+            userId,
+            stripeCustomerId,
+            funnelId: FUNNEL_ID || undefined,
         });
-        if (!response.ok) {
-            const errorMessage = await parseErrorMessage(response, 'Failed to load subscriptions');
-            throw new Error(errorMessage);
-        }
-        return (await response.json());
     }
     async updateSubscription(input) {
-        var _a;
         const userId = this.getSubscriptionManagementUserId();
         const stripeCustomerId = this.getSubscriptionManagementStripeCustomerId();
-        const response = await fetch(buildMainApiUrl(`/sdk/public/subscriptions/${encodeURIComponent(input.subscriptionId)}/${input.action}`), {
-            method: 'POST',
-            headers: buildSdkHeaders({
-                'Content-Type': 'application/json',
-            }),
-            body: JSON.stringify({
-                user_id: userId || undefined,
-                stripe_customer_id: stripeCustomerId || undefined,
-                funnelId: FUNNEL_ID || undefined,
-                coupon_id: ((_a = input.couponId) === null || _a === void 0 ? void 0 : _a.trim()) || undefined,
-            }),
+        return funnelSdkService.updateSubscription({
+            subscriptionId: input.subscriptionId,
+            action: input.action,
+            couponId: input.couponId,
+            userId,
+            stripeCustomerId,
+            funnelId: FUNNEL_ID || undefined,
         });
-        if (!response.ok) {
-            const errorMessage = await parseErrorMessage(response, 'Failed to update subscription');
-            throw new Error(errorMessage);
-        }
-        return (await response.json());
     }
 }
 export const apiService = new ApiService();

package/dist/services/funnel-sdk.service.d.ts

@@ -0,0 +1,207 @@
+export type FunnelSdkRuntimeMode = 'test' | 'live';
+export type FunnelSdkRuntimeConfigOverrides = {
+    apiBaseUrl?: string | null;
+    funnelId?: string | null;
+    funnelVersionId?: string | null;
+    funnelSdkPublishableKey?: string | null;
+};
+export type FunnelSdkPaymentPlan = Record<string, unknown>;
+export type FunnelSdkJsonObject = Record<string, unknown>;
+export type FunnelSdkListPaymentPlansResponse = {
+    funnelId?: string;
+    environment?: FunnelSdkRuntimeMode;
+    plans: FunnelSdkPaymentPlan[];
+};
+export type FunnelSdkBootstrapUserInput = {
+    userId?: string | null;
+    email?: string | null;
+    fullName?: string | null;
+    metadata?: FunnelSdkJsonObject | null;
+    attribution?: FunnelSdkJsonObject | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkGetCurrentUserInput = {
+    userId: string;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkGetUserSubscriptionStatusInput = {
+    userId?: string | null;
+    email?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkClaimUserSubscriptionInput = {
+    userId: string;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkUpdateFunnelUserInput = {
+    userId: string;
+    email?: string | null;
+    fullName?: string | null;
+    document?: FunnelSdkJsonObject | null;
+    progress?: FunnelSdkJsonObject | null;
+    metadata?: FunnelSdkJsonObject | null;
+    attribution?: FunnelSdkJsonObject | null;
+    subscription?: FunnelSdkJsonObject | null;
+    subscriptionStatus?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkUploadPhotoInput = {
+    fileName: string;
+    imageDataUrl: string;
+    mimeType?: string | null;
+    source?: 'camera' | 'upload' | string | null;
+    userId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkCreateHostedCheckoutSessionInput = {
+    planId: string;
+    amountCents: number;
+    successUrl: string;
+    cancelUrl: string;
+    analyticsMetadata?: Record<string, unknown> | null;
+    billingInterval?: string | null;
+    billingIntervalCount?: number | null;
+    couponId?: string | null;
+    customerEmail?: string | null;
+    description?: string | null;
+    environment?: FunnelSdkRuntimeMode;
+    providerPlanId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    title?: string | null;
+    userId?: string | null;
+};
+export type FunnelSdkCreateHostedCheckoutSessionResponse = {
+    sessionId?: string;
+    url: string;
+    environment?: FunnelSdkRuntimeMode;
+};
+export type FunnelSdkCreateSubscriptionCheckoutInput = {
+    planId: string;
+    amountCents: number;
+    returnUrl: string;
+    analyticsMetadata?: Record<string, unknown> | null;
+    billingInterval?: string | null;
+    billingIntervalCount?: number | null;
+    couponId?: string | null;
+    customerEmail?: string | null;
+    description?: string | null;
+    environment?: FunnelSdkRuntimeMode;
+    providerPlanId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    title?: string | null;
+    userId?: string | null;
+};
+export type FunnelSdkCreateSubscriptionCheckoutResponse = {
+    clientSecret: string;
+    checkoutSessionId?: string;
+    subscriptionId?: string;
+    stripePublishableKey?: string;
+    environment?: FunnelSdkRuntimeMode;
+};
+export type FunnelSdkUpdateSubscriptionCheckoutPlanInput = {
+    checkoutSessionId: string;
+    planId: string;
+    amountCents: number;
+    analyticsMetadata?: Record<string, unknown> | null;
+    billingInterval?: string | null;
+    billingIntervalCount?: number | null;
+    couponId?: string | null;
+    customerEmail?: string | null;
+    description?: string | null;
+    environment?: FunnelSdkRuntimeMode;
+    providerPlanId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    title?: string | null;
+    userId?: string | null;
+};
+export type FunnelSdkUpdateSubscriptionCheckoutPlanResponse = {
+    checkoutSessionId: string;
+    environment?: FunnelSdkRuntimeMode;
+};
+export type FunnelSdkVerifySubscriptionCheckoutInput = {
+    checkoutSessionId: string;
+    environment?: FunnelSdkRuntimeMode;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkVerifySubscriptionCheckoutResponse = {
+    checkoutSessionId: string;
+    paid: boolean;
+    paymentStatus?: string | null;
+    status?: string | null;
+    environment?: FunnelSdkRuntimeMode;
+    analyticsMetadata?: Record<string, unknown>;
+};
+export type FunnelSdkCreateOneTimePaymentIntentInput = {
+    planId: string;
+    amountCents: number;
+    analyticsMetadata?: Record<string, unknown> | null;
+    couponId?: string | null;
+    environment?: FunnelSdkRuntimeMode;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    userId?: string | null;
+};
+export type FunnelSdkCreateOneTimePaymentIntentResponse = {
+    clientSecret: string;
+    stripePublishableKey?: string;
+    environment?: FunnelSdkRuntimeMode;
+};
+export type FunnelSdkChargeOneClickPaymentInput = {
+    planId: string;
+    amountCents: number;
+    analyticsMetadata?: Record<string, unknown> | null;
+    checkoutSessionId?: string | null;
+    currency?: string | null;
+    environment?: FunnelSdkRuntimeMode;
+    idempotencyKey?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    stripeCustomerId?: string | null;
+    userId?: string | null;
+};
+export type FunnelSdkChargeOneClickPaymentResponse = {
+    paymentIntentId: string;
+    status: string;
+    amountCents?: number;
+    clientSecret?: string;
+    currency?: string;
+    environment?: FunnelSdkRuntimeMode;
+    stripePublishableKey?: string;
+};
+export type FunnelSdkUpdateSubscriptionInput = {
+    subscriptionId: string;
+    action: 'cancel' | 'renew' | 'apply-discount';
+    couponId?: string | null;
+    funnelId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    stripeCustomerId?: string | null;
+    userId?: string | null;
+};
+export type FunnelSdkListSubscriptionsInput = {
+    funnelId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    stripeCustomerId?: string | null;
+    userId?: string | null;
+};
+declare class FunnelSdkService {
+    private getJson;
+    private postJson;
+    bootstrapUser<ResponsePayload = FunnelSdkJsonObject>(input?: FunnelSdkBootstrapUserInput): Promise<ResponsePayload>;
+    getCurrentUser<ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkGetCurrentUserInput): Promise<ResponsePayload>;
+    getUserSubscriptionStatus<ResponsePayload = FunnelSdkJsonObject>(input?: FunnelSdkGetUserSubscriptionStatusInput): Promise<ResponsePayload>;
+    claimUserSubscription<ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkClaimUserSubscriptionInput): Promise<ResponsePayload>;
+    updateFunnelUser<ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkUpdateFunnelUserInput): Promise<ResponsePayload>;
+    uploadPhoto<ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkUploadPhotoInput): Promise<ResponsePayload>;
+    listPaymentPlans(input?: {
+        environment?: FunnelSdkRuntimeMode;
+        runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+    }): Promise<FunnelSdkListPaymentPlansResponse>;
+    createHostedCheckoutSession(input: FunnelSdkCreateHostedCheckoutSessionInput): Promise<FunnelSdkCreateHostedCheckoutSessionResponse>;
+    createSubscriptionCheckout(input: FunnelSdkCreateSubscriptionCheckoutInput): Promise<FunnelSdkCreateSubscriptionCheckoutResponse>;
+    updateSubscriptionCheckoutPlan(input: FunnelSdkUpdateSubscriptionCheckoutPlanInput): Promise<FunnelSdkUpdateSubscriptionCheckoutPlanResponse>;
+    verifySubscriptionCheckout(input: FunnelSdkVerifySubscriptionCheckoutInput): Promise<FunnelSdkVerifySubscriptionCheckoutResponse>;
+    createOneTimePaymentIntent(input: FunnelSdkCreateOneTimePaymentIntentInput): Promise<FunnelSdkCreateOneTimePaymentIntentResponse>;
+    chargeOneClickPayment(input: FunnelSdkChargeOneClickPaymentInput): Promise<FunnelSdkChargeOneClickPaymentResponse>;
+    updateSubscription<ResponsePayload>(input: FunnelSdkUpdateSubscriptionInput): Promise<ResponsePayload>;
+    listSubscriptions<ResponsePayload = FunnelSdkJsonObject>(input?: FunnelSdkListSubscriptionsInput): Promise<ResponsePayload>;
+}
+export declare const funnelSdkService: FunnelSdkService;
+export {};

package/dist/services/funnel-sdk.service.js

@@ -0,0 +1,319 @@
+import { buildMainApiUrl, FUNNEL_ID, FUNNEL_SDK_PUBLISHABLE_KEY, FUNNEL_VERSION_ID, } from './runtime-api.config.js';
+import { resolvePreviewPaymentPublishableKey } from './public-env.js';
+const trimTrailingSlash = (value) => value.replace(/\/+$/, '');
+const toNormalizedPath = (path) => (path.startsWith('/') ? path : `/${path}`);
+const asTrimmedStringOrNull = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed || null;
+};
+const removeEmptyFields = (input) => {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined && value !== null && value !== ''));
+};
+const resolveRuntimeConfig = (runtimeConfig) => {
+    var _a, _b, _c;
+    return ({
+        apiBaseUrl: asTrimmedStringOrNull(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.apiBaseUrl),
+        funnelId: (_a = asTrimmedStringOrNull(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.funnelId)) !== null && _a !== void 0 ? _a : asTrimmedStringOrNull(FUNNEL_ID),
+        funnelVersionId: (_b = asTrimmedStringOrNull(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.funnelVersionId)) !== null && _b !== void 0 ? _b : asTrimmedStringOrNull(FUNNEL_VERSION_ID),
+        funnelSdkPublishableKey: resolvePreviewPaymentPublishableKey((_c = asTrimmedStringOrNull(runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.funnelSdkPublishableKey)) !== null && _c !== void 0 ? _c : asTrimmedStringOrNull(FUNNEL_SDK_PUBLISHABLE_KEY)) || null,
+    });
+};
+const buildApiUrl = (path, runtimeConfig) => {
+    const { apiBaseUrl } = resolveRuntimeConfig(runtimeConfig);
+    if (!apiBaseUrl) {
+        return buildMainApiUrl(path);
+    }
+    return `${trimTrailingSlash(apiBaseUrl)}${toNormalizedPath(path)}`;
+};
+const buildHeaders = (runtimeConfig, headers) => {
+    const { funnelSdkPublishableKey } = resolveRuntimeConfig(runtimeConfig);
+    if (!funnelSdkPublishableKey) {
+        return Object.assign({}, (headers !== null && headers !== void 0 ? headers : {}));
+    }
+    return Object.assign({ 'x-sdk-publishable-key': funnelSdkPublishableKey }, (headers !== null && headers !== void 0 ? headers : {}));
+};
+const withRuntimeFields = (runtimeConfig, body, options) => {
+    const { funnelId, funnelVersionId, funnelSdkPublishableKey } = resolveRuntimeConfig(runtimeConfig);
+    return removeEmptyFields(Object.assign({ publishableKey: (options === null || options === void 0 ? void 0 : options.includePublishableKey) === false
+            ? undefined
+            : funnelSdkPublishableKey || undefined, funnelId: funnelId || undefined, funnelVersionId: funnelVersionId || undefined }, (body !== null && body !== void 0 ? body : {})));
+};
+const parseErrorMessage = async (response, fallbackMessage) => {
+    try {
+        const payload = (await response.json());
+        const apiError = asTrimmedStringOrNull(payload.error);
+        if (apiError) {
+            return apiError;
+        }
+    }
+    catch (_a) {
+        // ignore JSON parsing errors
+    }
+    try {
+        const text = await response.text();
+        if (text.trim()) {
+            return text;
+        }
+    }
+    catch (_b) {
+        // ignore text parsing errors
+    }
+    return fallbackMessage;
+};
+class FunnelSdkService {
+    async getJson(path, input) {
+        var _a;
+        const url = new URL(buildApiUrl(path, input.runtimeConfig));
+        for (const [key, value] of Object.entries((_a = input.searchParams) !== null && _a !== void 0 ? _a : {})) {
+            const normalizedValue = asTrimmedStringOrNull(value);
+            if (normalizedValue) {
+                url.searchParams.set(key, normalizedValue);
+            }
+        }
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers: buildHeaders(input.runtimeConfig),
+        });
+        if (!response.ok) {
+            throw new Error(await parseErrorMessage(response, input.errorMessage));
+        }
+        return (await response.json());
+    }
+    async postJson(path, input) {
+        var _a;
+        const response = await fetch(buildApiUrl(path, input.runtimeConfig), {
+            method: 'POST',
+            headers: buildHeaders(input.runtimeConfig, {
+                'Content-Type': 'application/json',
+            }),
+            body: JSON.stringify(input.includeRuntimeFields === false
+                ? removeEmptyFields((_a = input.body) !== null && _a !== void 0 ? _a : {})
+                : withRuntimeFields(input.runtimeConfig, input.body, {
+                    includePublishableKey: input.includePublishableKey,
+                })),
+        });
+        if (!response.ok) {
+            throw new Error(await parseErrorMessage(response, input.errorMessage));
+        }
+        return (await response.json());
+    }
+    async bootstrapUser(input = {}) {
+        return this.postJson('/sdk/public/users/bootstrap', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                user_id: input.userId,
+                email: input.email,
+                fullName: input.fullName,
+                metadata: input.metadata,
+                attribution: input.attribution,
+            },
+            errorMessage: 'Failed to bootstrap user session',
+        });
+    }
+    async getCurrentUser(input) {
+        const { funnelId } = resolveRuntimeConfig(input.runtimeConfig);
+        return this.getJson('/sdk/public/users/me', {
+            runtimeConfig: input.runtimeConfig,
+            searchParams: {
+                funnelId,
+                user_id: input.userId,
+            },
+            errorMessage: 'Failed to load user',
+        });
+    }
+    async getUserSubscriptionStatus(input = {}) {
+        const { funnelId } = resolveRuntimeConfig(input.runtimeConfig);
+        return this.getJson('/sdk/public/users/subscription', {
+            runtimeConfig: input.runtimeConfig,
+            searchParams: {
+                funnelId,
+                user_id: input.userId,
+                email: input.email,
+            },
+            errorMessage: 'Failed to load user subscription status',
+        });
+    }
+    async claimUserSubscription(input) {
+        return this.postJson(`/sdk/public/users/${encodeURIComponent(input.userId)}/claim_subscription`, {
+            runtimeConfig: input.runtimeConfig,
+            errorMessage: 'Failed to claim user subscription',
+        });
+    }
+    async updateFunnelUser(input) {
+        return this.postJson('/public/funnel-users/upsert', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                user_id: input.userId,
+                email: input.email,
+                fullName: input.fullName,
+                document: input.document,
+                progress: input.progress,
+                metadata: input.metadata,
+                attribution: input.attribution,
+                subscription: input.subscription,
+                subscriptionStatus: input.subscriptionStatus,
+            },
+            errorMessage: 'Failed to update user',
+        });
+    }
+    async uploadPhoto(input) {
+        return this.postJson('/sdk/public/uploads/photos', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                user_id: input.userId,
+                fileName: input.fileName,
+                mimeType: input.mimeType,
+                imageDataUrl: input.imageDataUrl,
+                source: input.source,
+            },
+            errorMessage: 'Failed to upload photo',
+        });
+    }
+    async listPaymentPlans(input = {}) {
+        const { funnelId } = resolveRuntimeConfig(input.runtimeConfig);
+        return this.getJson('/sdk/public/payments/plans', {
+            runtimeConfig: input.runtimeConfig,
+            searchParams: {
+                environment: input.environment,
+                funnelId,
+            },
+            errorMessage: 'Unable to load payment plans',
+        });
+    }
+    async createHostedCheckoutSession(input) {
+        return this.postJson('/sdk/public/payments/checkout-session', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                planId: input.planId,
+                providerPlanId: input.providerPlanId,
+                title: input.title,
+                description: input.description,
+                amountCents: input.amountCents,
+                billingInterval: input.billingInterval,
+                billingIntervalCount: input.billingIntervalCount,
+                couponId: input.couponId,
+                analyticsMetadata: input.analyticsMetadata,
+                successUrl: input.successUrl,
+                cancelUrl: input.cancelUrl,
+                customerEmail: input.customerEmail,
+                user_id: input.userId,
+                environment: input.environment,
+            },
+            errorMessage: 'Unable to create checkout session',
+        });
+    }
+    async createSubscriptionCheckout(input) {
+        return this.postJson('/sdk/public/payments/subscriptions', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                planId: input.planId,
+                providerPlanId: input.providerPlanId,
+                title: input.title,
+                description: input.description,
+                amountCents: input.amountCents,
+                billingInterval: input.billingInterval,
+                billingIntervalCount: input.billingIntervalCount,
+                couponId: input.couponId,
+                analyticsMetadata: input.analyticsMetadata,
+                customerEmail: input.customerEmail,
+                returnUrl: input.returnUrl,
+                user_id: input.userId,
+                environment: input.environment,
+            },
+            errorMessage: 'Unable to create subscription checkout',
+        });
+    }
+    async updateSubscriptionCheckoutPlan(input) {
+        return this.postJson('/sdk/public/payments/subscriptions/update-plan', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                checkoutSessionId: input.checkoutSessionId,
+                planId: input.planId,
+                providerPlanId: input.providerPlanId,
+                title: input.title,
+                description: input.description,
+                amountCents: input.amountCents,
+                billingInterval: input.billingInterval,
+                billingIntervalCount: input.billingIntervalCount,
+                couponId: input.couponId,
+                analyticsMetadata: input.analyticsMetadata,
+                customerEmail: input.customerEmail,
+                user_id: input.userId,
+                environment: input.environment,
+            },
+            errorMessage: 'Unable to update subscription checkout',
+        });
+    }
+    async verifySubscriptionCheckout(input) {
+        return this.postJson('/sdk/public/payments/subscriptions/checkout-session-status', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                checkoutSessionId: input.checkoutSessionId,
+                environment: input.environment,
+            },
+            errorMessage: 'Unable to verify subscription checkout',
+        });
+    }
+    async createOneTimePaymentIntent(input) {
+        return this.postJson('/sdk/public/payments/intents', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                planId: input.planId,
+                amountCents: input.amountCents,
+                couponId: input.couponId,
+                analyticsMetadata: input.analyticsMetadata,
+                user_id: input.userId,
+                environment: input.environment,
+            },
+            errorMessage: 'Unable to create payment intent',
+        });
+    }
+    async chargeOneClickPayment(input) {
+        return this.postJson('/sdk/public/payments/one-click', {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                planId: input.planId,
+                amountCents: input.amountCents,
+                currency: input.currency,
+                analyticsMetadata: input.analyticsMetadata,
+                user_id: input.userId,
+                stripe_customer_id: input.stripeCustomerId,
+                checkoutSessionId: input.checkoutSessionId,
+                idempotencyKey: input.idempotencyKey,
+                environment: input.environment,
+            },
+            errorMessage: 'Unable to charge one-click payment',
+        });
+    }
+    async updateSubscription(input) {
+        return this.postJson(`/sdk/public/subscriptions/${encodeURIComponent(input.subscriptionId)}/${input.action}`, {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                user_id: input.userId,
+                stripe_customer_id: input.stripeCustomerId,
+                funnelId: input.funnelId,
+                coupon_id: input.couponId,
+            },
+            includeRuntimeFields: false,
+            includePublishableKey: false,
+            errorMessage: 'Failed to update subscription',
+        });
+    }
+    async listSubscriptions(input = {}) {
+        var _a;
+        const { funnelId } = resolveRuntimeConfig(input.runtimeConfig);
+        return this.getJson('/sdk/public/subscriptions', {
+            runtimeConfig: input.runtimeConfig,
+            searchParams: {
+                user_id: input.userId,
+                stripe_customer_id: input.stripeCustomerId,
+                funnelId: (_a = input.funnelId) !== null && _a !== void 0 ? _a : funnelId,
+            },
+            errorMessage: 'Failed to load subscriptions',
+        });
+    }
+}
+export const funnelSdkService = new FunnelSdkService();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/runtime",
-  "version": "0.1.44",
+  "version": "0.1.46",
   "type": "module",
   "private": false,
   "main": "./dist/index.js",