@funnelsgrove/runtime 0.11.2 → 0.11.4

package/dist/services/funnel-sdk/shared/runtimeConfig.js

@@ -0,0 +1,42 @@
+import { buildMainApiUrl, FUNNEL_ID, FUNNEL_VERSION_ID, FUNNEL_SDK_PUBLISHABLE_KEY, } from '../../runtime-api.config.js';
+import { resolvePreviewPaymentPublishableKey } from '../../public-env.js';
+const trimTrailingSlash = (value) => value.replace(/\/+$/, '');
+const toNormalizedPath = (path) => (path.startsWith('/') ? path : `/${path}`);
+export const asTrimmedStringOrNull = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed || null;
+};
+export const removeEmptyFields = (input) => {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined && value !== null && value !== ''));
+};
+export 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,
+        paymentsApiVersion: (runtimeConfig === null || runtimeConfig === void 0 ? void 0 : runtimeConfig.paymentsApiVersion) === 'v2' ? 'v2' : 'v1',
+    });
+};
+export const buildApiUrl = (path, runtimeConfig) => {
+    const { apiBaseUrl } = resolveRuntimeConfig(runtimeConfig);
+    if (!apiBaseUrl) {
+        return buildMainApiUrl(path);
+    }
+    return `${trimTrailingSlash(apiBaseUrl)}${toNormalizedPath(path)}`;
+};
+export 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 : {}));
+};
+export 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 : {})));
+};

package/dist/services/funnel-sdk/shared/types.d.ts

@@ -0,0 +1,9 @@
+export type FunnelSdkRuntimeMode = 'test' | 'live';
+export type FunnelSdkRuntimeConfigOverrides = {
+    apiBaseUrl?: string | null;
+    funnelId?: string | null;
+    funnelVersionId?: string | null;
+    funnelSdkPublishableKey?: string | null;
+    paymentsApiVersion?: 'v1' | 'v2' | null;
+};
+export type FunnelSdkJsonObject = Record<string, unknown>;

package/dist/services/funnel-sdk/shared/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/funnel-sdk/subscriptions/listSubscriptions.d.ts

@@ -0,0 +1,3 @@
+import type { FunnelSdkListSubscriptionsInput } from './types.js';
+import type { FunnelSdkJsonObject } from '../shared/types.js';
+export declare const listSubscriptions: <ResponsePayload = FunnelSdkJsonObject>(input?: FunnelSdkListSubscriptionsInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/subscriptions/listSubscriptions.js

@@ -0,0 +1,17 @@
+import { getJson } from '../shared/http.js';
+import { resolveRuntimeConfig } from '../shared/runtimeConfig.js';
+export const listSubscriptions = async (input = {}) => {
+    var _a;
+    const { funnelId, paymentsApiVersion } = resolveRuntimeConfig(input.runtimeConfig);
+    return getJson(paymentsApiVersion === 'v2'
+        ? '/sdk/public/v2/subscriptions'
+        : '/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',
+    });
+};

package/dist/services/funnel-sdk/subscriptions/types.d.ts

@@ -0,0 +1,24 @@
+import type { FunnelSdkRuntimeConfigOverrides } from '../shared/types.js';
+export type FunnelSdkSubscriptionRef = {
+    provider: 'stripe' | 'solidgate';
+    paymentProfileId: string;
+    providerSubscriptionId: string;
+    environment: 'test' | 'live';
+};
+export type FunnelSdkUpdateSubscriptionInput = {
+    subscriptionId: string;
+    subscriptionRef?: FunnelSdkSubscriptionRef | null;
+    action: 'cancel' | 'renew' | 'apply-discount';
+    couponId?: string | null;
+    cancellationMode?: 'period_end' | 'immediate';
+    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;
+};

package/dist/services/funnel-sdk/subscriptions/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/funnel-sdk/subscriptions/updateSubscription.d.ts

@@ -0,0 +1,2 @@
+import type { FunnelSdkUpdateSubscriptionInput } from './types.js';
+export declare const updateSubscription: <ResponsePayload>(input: FunnelSdkUpdateSubscriptionInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/subscriptions/updateSubscription.js

@@ -0,0 +1,33 @@
+import { postJson } from '../shared/http.js';
+import { resolveRuntimeConfig } from '../shared/runtimeConfig.js';
+import { requireSubscriptionRef } from './validator.js';
+export const updateSubscription = async (input) => {
+    if (resolveRuntimeConfig(input.runtimeConfig).paymentsApiVersion === 'v2') {
+        return postJson(`/sdk/public/v2/subscriptions/${input.action}`, {
+            runtimeConfig: input.runtimeConfig,
+            body: {
+                userId: input.userId,
+                stripeCustomerId: input.stripeCustomerId,
+                funnelId: input.funnelId,
+                subscriptionRef: requireSubscriptionRef(input.subscriptionRef),
+                cancellationMode: input.cancellationMode,
+                couponId: input.couponId,
+            },
+            includeRuntimeFields: false,
+            includePublishableKey: false,
+            errorMessage: 'Failed to update subscription',
+        });
+    }
+    return 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',
+    });
+};

package/dist/services/funnel-sdk/subscriptions/validator.d.ts

@@ -0,0 +1,2 @@
+import type { FunnelSdkSubscriptionRef } from './types.js';
+export declare const requireSubscriptionRef: (value: FunnelSdkSubscriptionRef | null | undefined) => FunnelSdkSubscriptionRef;

package/dist/services/funnel-sdk/subscriptions/validator.js

@@ -0,0 +1,15 @@
+export const requireSubscriptionRef = (value) => {
+    if (!value ||
+        (value.provider !== 'stripe' && value.provider !== 'solidgate') ||
+        !value.paymentProfileId.trim() ||
+        !value.providerSubscriptionId.trim() ||
+        (value.environment !== 'test' && value.environment !== 'live')) {
+        throw new Error('V2 subscription reference is required');
+    }
+    return {
+        provider: value.provider,
+        paymentProfileId: value.paymentProfileId.trim(),
+        providerSubscriptionId: value.providerSubscriptionId.trim(),
+        environment: value.environment,
+    };
+};

package/dist/services/funnel-sdk/uploads/preparePhotoUpload.d.ts

@@ -0,0 +1,4 @@
+import type { FunnelSdkUploadPhotoFileInput, FunnelSdkPreparedPhotoUpload } from './types.js';
+export declare const preparePhotoUpload: (input: Omit<FunnelSdkUploadPhotoFileInput, "file"> & {
+    sizeBytes: number;
+}) => Promise<FunnelSdkPreparedPhotoUpload>;

package/dist/services/funnel-sdk/uploads/preparePhotoUpload.js

@@ -0,0 +1,19 @@
+import { postJson } from '../shared/http.js';
+import { resolveRuntimeConfig } from '../shared/runtimeConfig.js';
+export const preparePhotoUpload = async (input) => {
+    const { funnelId } = resolveRuntimeConfig(input.runtimeConfig);
+    return postJson('/sdk/public/uploads/photos/prepare', {
+        runtimeConfig: input.runtimeConfig,
+        body: {
+            funnelId,
+            userId: input.userId,
+            fileName: input.fileName,
+            contentType: input.contentType,
+            sizeBytes: input.sizeBytes,
+            source: input.source,
+        },
+        includeRuntimeFields: false,
+        includePublishableKey: false,
+        errorMessage: 'Failed to prepare photo upload',
+    });
+};

package/dist/services/funnel-sdk/uploads/types.d.ts

@@ -0,0 +1,32 @@
+import type { FunnelSdkRuntimeConfigOverrides } from '../shared/types.js';
+/**
+ * @deprecated Compatibility contract for already-published funnel bundles.
+ * New runtime code must use FunnelSdkUploadPhotoFileInput and uploadPhotoFile.
+ */
+export type FunnelSdkUploadPhotoInput = {
+    fileName: string;
+    imageDataUrl: string;
+    mimeType?: string | null;
+    source?: 'camera' | 'upload' | string | null;
+    userId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkUploadPhotoFileInput = {
+    file: Blob;
+    fileName: string;
+    contentType?: string | null;
+    source?: 'camera' | 'upload' | string | null;
+    userId?: string | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkPreparedPhotoUpload = {
+    key: string;
+    publicUrl: string;
+    uploadUrl: string;
+    uploadHeaders: Record<string, string>;
+    contentType: string;
+    sizeBytes: number;
+};
+export type FunnelSdkUploadedPhoto = Omit<FunnelSdkPreparedPhotoUpload, 'uploadUrl' | 'uploadHeaders'> & {
+    uploadedAt: string;
+};

package/dist/services/funnel-sdk/uploads/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/funnel-sdk/uploads/uploadPhoto.d.ts

@@ -0,0 +1,7 @@
+import type { FunnelSdkUploadPhotoInput } from './types.js';
+import type { FunnelSdkJsonObject } from '../shared/types.js';
+/**
+ * @deprecated Compatibility transport for already-published funnel bundles.
+ * New runtime code must use uploadPhotoFile so image bytes go directly to R2.
+ */
+export declare const uploadPhoto: <ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkUploadPhotoInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/uploads/uploadPhoto.js

@@ -0,0 +1,18 @@
+import { postJson } from '../shared/http.js';
+/**
+ * @deprecated Compatibility transport for already-published funnel bundles.
+ * New runtime code must use uploadPhotoFile so image bytes go directly to R2.
+ */
+export const uploadPhoto = async (input) => {
+    return 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',
+    });
+};

package/dist/services/funnel-sdk/uploads/uploadPhotoFile.d.ts

@@ -0,0 +1,2 @@
+import type { FunnelSdkUploadPhotoFileInput, FunnelSdkUploadedPhoto } from './types.js';
+export declare const uploadPhotoFile: (input: FunnelSdkUploadPhotoFileInput) => Promise<FunnelSdkUploadedPhoto>;

package/dist/services/funnel-sdk/uploads/uploadPhotoFile.js

@@ -0,0 +1,26 @@
+import { preparePhotoUpload } from './preparePhotoUpload.js';
+export const uploadPhotoFile = async (input) => {
+    const prepared = await preparePhotoUpload({
+        fileName: input.fileName,
+        contentType: input.contentType,
+        sizeBytes: input.file.size,
+        source: input.source,
+        userId: input.userId,
+        runtimeConfig: input.runtimeConfig,
+    });
+    const response = await fetch(prepared.uploadUrl, {
+        method: 'PUT',
+        headers: prepared.uploadHeaders,
+        body: input.file,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to upload photo (${response.status})`);
+    }
+    return {
+        key: prepared.key,
+        publicUrl: prepared.publicUrl,
+        contentType: prepared.contentType,
+        sizeBytes: prepared.sizeBytes,
+        uploadedAt: new Date().toISOString(),
+    };
+};

package/dist/services/funnel-sdk/users/bootstrapUser.d.ts

@@ -0,0 +1,3 @@
+import type { FunnelSdkBootstrapUserInput } from './types.js';
+import type { FunnelSdkJsonObject } from '../shared/types.js';
+export declare const bootstrapUser: <ResponsePayload = FunnelSdkJsonObject>(input?: FunnelSdkBootstrapUserInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/users/bootstrapUser.js

@@ -0,0 +1,15 @@
+import { postJson } from '../shared/http.js';
+export const bootstrapUser = async (input = {}) => {
+    return postJson('/sdk/public/users/bootstrap', {
+        runtimeConfig: input.runtimeConfig,
+        body: {
+            user_id: input.userId,
+            idempotencyKey: input.idempotencyKey,
+            email: input.email,
+            fullName: input.fullName,
+            metadata: input.metadata,
+            attribution: input.attribution,
+        },
+        errorMessage: 'Failed to bootstrap user session',
+    });
+};

package/dist/services/funnel-sdk/users/captureEmail.d.ts

@@ -0,0 +1,2 @@
+import type { FunnelSdkCaptureEmailInput, FunnelSdkCaptureEmailResponse } from './types.js';
+export declare const captureEmail: (input: FunnelSdkCaptureEmailInput) => Promise<FunnelSdkCaptureEmailResponse>;

package/dist/services/funnel-sdk/users/captureEmail.js

@@ -0,0 +1,15 @@
+import { postJson } from '../shared/http.js';
+import { CURRENT_STEP_CONTRACT_VERSION } from '../../../steps/step-contract.js';
+export const captureEmail = async (input) => {
+    return postJson('/sdk/public/users/email-capture', {
+        runtimeConfig: input.runtimeConfig,
+        body: {
+            user_id: input.userId,
+            email: input.email,
+            environment: input.environment,
+            answers: input.answers,
+            stepContractVersion: CURRENT_STEP_CONTRACT_VERSION,
+        },
+        errorMessage: 'Failed to capture email',
+    });
+};

package/dist/services/funnel-sdk/users/claimUserSubscription.d.ts

@@ -0,0 +1,3 @@
+import type { FunnelSdkClaimUserSubscriptionInput } from './types.js';
+import type { FunnelSdkJsonObject } from '../shared/types.js';
+export declare const claimUserSubscription: <ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkClaimUserSubscriptionInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/users/claimUserSubscription.js

@@ -0,0 +1,7 @@
+import { postJson } from '../shared/http.js';
+export const claimUserSubscription = async (input) => {
+    return postJson(`/sdk/public/users/${encodeURIComponent(input.userId)}/claim_subscription`, {
+        runtimeConfig: input.runtimeConfig,
+        errorMessage: 'Failed to claim user subscription',
+    });
+};

package/dist/services/funnel-sdk/users/getCurrentUser.d.ts

@@ -0,0 +1,3 @@
+import type { FunnelSdkGetCurrentUserInput } from './types.js';
+import type { FunnelSdkJsonObject } from '../shared/types.js';
+export declare const getCurrentUser: <ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkGetCurrentUserInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/users/getCurrentUser.js

@@ -0,0 +1,13 @@
+import { getJson } from '../shared/http.js';
+import { resolveRuntimeConfig } from '../shared/runtimeConfig.js';
+export const getCurrentUser = async (input) => {
+    const { funnelId } = resolveRuntimeConfig(input.runtimeConfig);
+    return getJson('/sdk/public/users/me', {
+        runtimeConfig: input.runtimeConfig,
+        searchParams: {
+            funnelId,
+            user_id: input.userId,
+        },
+        errorMessage: 'Failed to load user',
+    });
+};

package/dist/services/funnel-sdk/users/getUserSubscriptionStatus.d.ts

@@ -0,0 +1,3 @@
+import type { FunnelSdkGetUserSubscriptionStatusInput } from './types.js';
+import type { FunnelSdkJsonObject } from '../shared/types.js';
+export declare const getUserSubscriptionStatus: <ResponsePayload = FunnelSdkJsonObject>(input?: FunnelSdkGetUserSubscriptionStatusInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/users/getUserSubscriptionStatus.js

@@ -0,0 +1,14 @@
+import { getJson } from '../shared/http.js';
+import { resolveRuntimeConfig } from '../shared/runtimeConfig.js';
+export const getUserSubscriptionStatus = async (input = {}) => {
+    const { funnelId } = resolveRuntimeConfig(input.runtimeConfig);
+    return getJson('/sdk/public/users/subscription', {
+        runtimeConfig: input.runtimeConfig,
+        searchParams: {
+            funnelId,
+            user_id: input.userId,
+            email: input.email,
+        },
+        errorMessage: 'Failed to load user subscription status',
+    });
+};

package/dist/services/funnel-sdk/users/types.d.ts

@@ -0,0 +1,57 @@
+import type { FunnelSdkRuntimeMode, FunnelSdkRuntimeConfigOverrides, FunnelSdkJsonObject } from '../shared/types.js';
+export type FunnelSdkBootstrapUserInput = {
+    userId?: string | null;
+    idempotencyKey?: string | null;
+    email?: string | null;
+    fullName?: string | null;
+    metadata?: FunnelSdkJsonObject | null;
+    attribution?: FunnelSdkJsonObject | null;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkCaptureEmailInput = {
+    userId: string;
+    email: string;
+    environment: FunnelSdkRuntimeMode;
+    answers?: FunnelSdkJsonObject;
+    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
+};
+export type FunnelSdkCaptureEmailResponse = {
+    user: {
+        user_id?: unknown;
+        fullName?: unknown;
+        email?: unknown;
+        document?: unknown;
+    };
+    canonicalUser?: {
+        user_id?: unknown;
+        email?: unknown;
+    } | null;
+    activeSubscription: boolean;
+    eventId: string;
+    eventCreated: boolean;
+};
+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;
+};

package/dist/services/funnel-sdk/users/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/funnel-sdk/users/updateFunnelUser.d.ts

@@ -0,0 +1,3 @@
+import type { FunnelSdkUpdateFunnelUserInput } from './types.js';
+import type { FunnelSdkJsonObject } from '../shared/types.js';
+export declare const updateFunnelUser: <ResponsePayload = FunnelSdkJsonObject>(input: FunnelSdkUpdateFunnelUserInput) => Promise<ResponsePayload>;

package/dist/services/funnel-sdk/users/updateFunnelUser.js

@@ -0,0 +1,18 @@
+import { postJson } from '../shared/http.js';
+export const updateFunnelUser = async (input) => {
+    return 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',
+    });
+};