@funnelsgrove/runtime 0.7.1 → 0.7.3

package/README.md

@@ -20,6 +20,7 @@ documented in [`docs/product-specs/funnel-template-runtime.md`](../../docs/produ
 - funnel context, flow controller, and generic runtime UI primitives
 - funnel-scoped state/storage helpers
 - browser-safe API client helpers used by funnels
+- reactive browser query-string access through `useBrowserLocationSearch`
 - subscription handoff and subscription management screens whose copy stays funnel-local
 - test-mode developer info surfaces for funnel preview tooling
 
@@ -54,6 +55,9 @@ documented in [`docs/product-specs/funnel-template-runtime.md`](../../docs/produ
 - 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.
+- Funnel code must not copy `useSyncExternalStore`/`popstate` query-string hooks. Use
+  `useBrowserLocationSearch`; the shared controller also notifies it after
+  `history.pushState` and `history.replaceState` navigation.
 - Keep env mapping centralized in `config/env.config.ts`.
 
 ## Build, Test, Publish

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from './runtime/funnel-runtime.js';
 export type { FunnelNavigationOutcome, FunnelStepExitReason, } from './runtime/funnel-step-lifecycle.js';
 export * from './runtime/posthog-flags.js';
 export * from './runtime/use-funnel-flow-controller.js';
+export * from './runtime/use-browser-location-search.js';
 export { useStepChoices } from './runtime/use-step-choices.js';
 export type { FunnelStepChoices } from './runtime/use-step-choices.js';
 export * from './runtime/preview-bridge.js';

package/dist/index.js

@@ -20,6 +20,7 @@ export * from './runtime/funnel-step-metadata.validation.js';
 export * from './runtime/funnel-runtime.js';
 export * from './runtime/posthog-flags.js';
 export * from './runtime/use-funnel-flow-controller.js';
+export * from './runtime/use-browser-location-search.js';
 export { useStepChoices } from './runtime/use-step-choices.js';
 export * from './runtime/preview-bridge.js';
 export * from './runtime/preview-definition-overrides.js';

package/dist/runtime/browser-helpers.d.ts

@@ -1,8 +1,10 @@
 export declare const canUseDom: () => boolean;
+export declare const FUNNEL_LOCATION_CHANGE_EVENT = "funnel:location-change";
 export declare const readWindowStorageValue: (storageKey: string) => string | null;
 export declare const writeWindowStorageValue: (storageKey: string, value: string) => void;
 export declare const removeWindowStorageValue: (storageKey: string) => void;
 export declare const dispatchWindowCustomEvent: <Detail>(eventType: string, detail: Detail) => void;
+export declare const dispatchFunnelLocationChange: () => void;
 export declare const buildHostedStepLocation: (input: {
     currentHref: string;
     stepPath: string;

package/dist/runtime/browser-helpers.js

@@ -1,6 +1,7 @@
 export const canUseDom = () => {
     return typeof window !== 'undefined';
 };
+export const FUNNEL_LOCATION_CHANGE_EVENT = 'funnel:location-change';
 export const readWindowStorageValue = (storageKey) => {
     if (!canUseDom()) {
         return null;
@@ -42,6 +43,14 @@ export const dispatchWindowCustomEvent = (eventType, detail) => {
         detail,
     }));
 };
+export const dispatchFunnelLocationChange = () => {
+    if (!canUseDom()) {
+        return;
+    }
+    dispatchWindowCustomEvent(FUNNEL_LOCATION_CHANGE_EVENT, {
+        href: window.location.href,
+    });
+};
 const getHostedFunnelBaseSegments = (pathname) => {
     const pathSegments = pathname.split('/').filter(Boolean);
     if (pathSegments[0] === 'published' && pathSegments[1] === 'f' && pathSegments[2]) {

package/dist/runtime/use-browser-location-search.d.ts

@@ -0,0 +1,2 @@
+export declare const getBrowserLocationSearch: () => string;
+export declare const useBrowserLocationSearch: () => string;

package/dist/runtime/use-browser-location-search.js

@@ -0,0 +1,20 @@
+'use client';
+import { useSyncExternalStore } from 'react';
+import { FUNNEL_LOCATION_CHANGE_EVENT } from './browser-helpers.js';
+const subscribeToBrowserLocationSearch = (onStoreChange) => {
+    if (typeof window === 'undefined') {
+        return () => undefined;
+    }
+    window.addEventListener('popstate', onStoreChange);
+    window.addEventListener(FUNNEL_LOCATION_CHANGE_EVENT, onStoreChange);
+    return () => {
+        window.removeEventListener('popstate', onStoreChange);
+        window.removeEventListener(FUNNEL_LOCATION_CHANGE_EVENT, onStoreChange);
+    };
+};
+export const getBrowserLocationSearch = () => {
+    return typeof window === 'undefined' ? '' : window.location.search;
+};
+export const useBrowserLocationSearch = () => {
+    return useSyncExternalStore(subscribeToBrowserLocationSearch, getBrowserLocationSearch, () => '');
+};

package/dist/runtime/use-funnel-flow-controller.js

@@ -4,7 +4,7 @@ import { writeStepChoice } from '../sdk/userAnswers.js';
 import { apiService } from '../services/api.service.js';
 import { logger } from '../services/logger.js';
 import { FUNNEL_ID, POSTHOG_API_HOST, POSTHOG_PROJECT_API_KEY, PROJECT_ID, } from '../services/runtime-api.config.js';
-import { buildHostedStepLocation, dispatchWindowCustomEvent, } from './browser-helpers.js';
+import { buildHostedStepLocation, dispatchFunnelLocationChange, dispatchWindowCustomEvent, } from './browser-helpers.js';
 import { isPreviewStepLockRequested, resolveNextStepFromContext, shouldRunAutoAdvanceTimer, } from './funnel-flow.js';
 import { usePreviewBridge } from './preview-bridge.js';
 import { resolveExperimentAssignment, resolveForcedExperimentAssignment, } from './experiment-assignment.js';
@@ -422,6 +422,7 @@ export function useFunnelFlowController({ api = apiService, analytics, stepContr
             else {
                 window.history.pushState({ stepId: safeStepId }, '', nextLocation);
             }
+            dispatchFunnelLocationChange();
         }
         setActiveStepId(safeStepId);
     }, [getPathForStep]);

package/dist/services/funnel-runtime-config.js

@@ -40,26 +40,33 @@ const getLegacyProviderMapping = (plan, mode) => {
 const buildPlanModeConfig = (item, mode, legacyPlan = null) => {
     var _a, _b;
     const metadata = isRecord(item.metadata) ? item.metadata : {};
+    const directMappings = isRecord(item.providerMappingsByMode)
+        ? item.providerMappingsByMode
+        : {};
     const metadataMappings = isRecord(metadata.providerMappingsByMode)
         ? metadata.providerMappingsByMode
         : {};
-    const metadataMapping = isRecord(metadataMappings[mode]) ? metadataMappings[mode] : {};
+    const modeMapping = isRecord(directMappings[mode])
+        ? directMappings[mode]
+        : isRecord(metadataMappings[mode])
+            ? metadataMappings[mode]
+            : {};
     const legacyMapping = getLegacyProviderMapping(legacyPlan, mode);
     const prefix = mode === 'test' ? 'test' : 'live';
     const providerPlanId = (pickString(item, `${prefix}ProviderPlanId`, `${prefix}_provider_plan_id`)
-        || pickString(metadataMapping, 'providerPlanId')
+        || pickString(modeMapping, 'providerPlanId')
         || (legacyMapping ? pickString(legacyMapping, 'providerPlanId', 'provider_plan_id') : null));
     if (!providerPlanId) {
         return null;
     }
-    const amountMinor = (_a = pickNumber(metadataMapping, 'amountCents')) !== null && _a !== void 0 ? _a : (legacyMapping ? pickNumber(legacyMapping, 'amountMinor', 'amount_minor') : null);
-    const interval = pickString(metadataMapping, 'billingInterval')
+    const amountMinor = (_a = pickNumber(modeMapping, 'amountCents')) !== null && _a !== void 0 ? _a : (legacyMapping ? pickNumber(legacyMapping, 'amountMinor', 'amount_minor') : null);
+    const interval = pickString(modeMapping, 'billingInterval')
         || (legacyMapping ? pickString(legacyMapping, 'interval') : null);
-    const intervalCount = (_b = pickNumber(metadataMapping, 'billingIntervalCount')) !== null && _b !== void 0 ? _b : (legacyMapping ? pickNumber(legacyMapping, 'intervalCount', 'interval_count') : null);
-    const currency = pickString(metadataMapping, 'currency')
+    const intervalCount = (_b = pickNumber(modeMapping, 'billingIntervalCount')) !== null && _b !== void 0 ? _b : (legacyMapping ? pickNumber(legacyMapping, 'intervalCount', 'interval_count') : null);
+    const currency = pickString(modeMapping, 'currency')
         || (legacyMapping ? pickString(legacyMapping, 'currency') : null);
     const amountMajor = amountMinor === null ? null : amountMinor / 100;
-    const priceLabel = pickString(metadataMapping, 'priceLabel') || (amountMajor === null
+    const priceLabel = pickString(modeMapping, 'priceLabel') || (amountMajor === null
         ? null
         : new Intl.NumberFormat('en-US', {
             style: 'currency',
@@ -67,12 +74,12 @@ const buildPlanModeConfig = (item, mode, legacyPlan = null) => {
             minimumFractionDigits: 2,
             maximumFractionDigits: 2,
         }).format(amountMajor) + (interval ? `/${interval}` : ''));
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ providerPlanId }, (priceLabel ? { priceLabel } : {})), (pickString(metadataMapping, 'perDayAmount')
-        ? { perDayAmount: pickString(metadataMapping, 'perDayAmount') }
-        : {})), (pickString(metadataMapping, 'perDayLabel')
-        ? { perDayLabel: pickString(metadataMapping, 'perDayLabel') }
-        : {})), (amountMinor === null ? {} : { amountCents: amountMinor })), (pickString(metadataMapping, 'checkoutSummaryLabel')
-        ? { checkoutSummaryLabel: pickString(metadataMapping, 'checkoutSummaryLabel') }
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ providerPlanId }, (priceLabel ? { priceLabel } : {})), (pickString(modeMapping, 'perDayAmount')
+        ? { perDayAmount: pickString(modeMapping, 'perDayAmount') }
+        : {})), (pickString(modeMapping, 'perDayLabel')
+        ? { perDayLabel: pickString(modeMapping, 'perDayLabel') }
+        : {})), (amountMinor === null ? {} : { amountCents: amountMinor })), (pickString(modeMapping, 'checkoutSummaryLabel')
+        ? { checkoutSummaryLabel: pickString(modeMapping, 'checkoutSummaryLabel') }
         : amountMajor === null
             ? {}
             : { checkoutSummaryLabel: `${new Intl.NumberFormat('en-US', {

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

@@ -212,10 +212,12 @@ export type FunnelSdkCreateOneTimePaymentIntentResponse = {
 };
 export type FunnelSdkChargeOneClickPaymentInput = {
     planId: string;
+    providerPlanId?: string | null;
     amountCents: number;
     analyticsMetadata?: Record<string, unknown> | null;
     checkoutSessionId?: string | null;
     currency?: string | null;
+    description?: string | null;
     environment?: FunnelSdkRuntimeMode;
     idempotencyKey?: string | null;
     runtimeConfig?: FunnelSdkRuntimeConfigOverrides;

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

@@ -329,8 +329,10 @@ class FunnelSdkService {
             runtimeConfig: input.runtimeConfig,
             body: {
                 planId: input.planId,
+                providerPlanId: input.providerPlanId,
                 amountCents: input.amountCents,
                 currency: input.currency,
+                description: input.description,
                 analyticsMetadata: input.analyticsMetadata,
                 user_id: input.userId,
                 stripe_customer_id: input.stripeCustomerId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/runtime",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",