@userflow-tech/react-native 0.1.0 → 0.1.1

package/vendor/protocol/dist/messages.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Server/client wire messages (Phase 3, slice 1).
+ *
+ * Curated subset of the message unions from the web SDK's
+ * `end-user-protocol.ts`, limited to the flow-session lifecycle,
+ * condition-wait-timer, and client-condition messages needed to render
+ * modal/tooltip flows and gate them on device-local state. The full web
+ * unions carry many more message kinds (banner/checklist/resource-center/
+ * site sessions, assistant, trackers, etc.) that are out of scope here.
+ */
+import type { Decimal, EndFlowReasonInput, FlowConditionFragment, FlowSessionFragment } from './flows.js';
+import type { TrackEvent } from './events.js';
+export interface SetFlowSession {
+    kind: 'SetFlowSession';
+    session: FlowSessionFragment;
+}
+export interface UnsetFlowSession {
+    kind: 'UnsetFlowSession';
+    sessionId: string;
+}
+export interface ForceGoToStep {
+    kind: 'ForceGoToStep';
+    sessionId: string;
+    stepId: string;
+}
+export interface StartConditionWaitTimer {
+    kind: 'StartConditionWaitTimer';
+    conditionId: string;
+    waitTime: Decimal;
+}
+export interface CancelConditionWaitTimer {
+    kind: 'CancelConditionWaitTimer';
+    conditionId: string;
+}
+export interface TrackClientCondition {
+    kind: 'TrackClientCondition';
+    condition: FlowConditionFragment;
+    flowId: string;
+    versionId: string;
+}
+export interface UntrackClientCondition {
+    kind: 'UntrackClientCondition';
+    conditionId: string;
+}
+/**
+ * The start condition being tested via {@link TestStartCondition} finally
+ * matched, so the server started the flow. Ends the waiting period.
+ */
+export interface TestStartConditionSuccess {
+    kind: 'TestStartConditionSuccess';
+}
+export type ServerMessage = SetFlowSession | UnsetFlowSession | ForceGoToStep | StartConditionWaitTimer | CancelConditionWaitTimer | TrackClientCondition | UntrackClientCondition | TestStartConditionSuccess;
+export interface GoToStep {
+    kind: 'GoToStep';
+    sessionId: string;
+    stepId: string;
+}
+export interface EndFlow {
+    kind: 'EndFlow';
+    sessionId: string;
+    endReason: EndFlowReasonInput;
+}
+export interface ReportTooltipTargetMissing {
+    kind: 'ReportTooltipTargetMissing';
+    sessionId: string;
+    stepId: string;
+}
+export interface AnswerQuestion {
+    kind: 'AnswerQuestion';
+    sessionId: string;
+    questionCvid?: string | null;
+    questionName?: string | null;
+    textAnswer: string | null;
+    numberAnswer: Decimal | null;
+    listAnswer: null | string[];
+}
+export interface FireConditionWaitTimer {
+    kind: 'FireConditionWaitTimer';
+    conditionId: string;
+}
+export interface ToggleClientCondition {
+    kind: 'ToggleClientCondition';
+    conditionId: string;
+    isTrue: boolean;
+}
+/**
+ * Client viewport / location context sent on join and location changes.
+ *
+ * Wire contract (backend `ClientContext`):
+ * - `pageUrl` is **required**. Mobile does not use web URLs — send `""`.
+ * - Location is reported as `screenPath` (Expo Router pathname) and/or
+ *   `screenName` (React Navigation / manual route name). Do not send the
+ *   legacy `path` / `screen` keys — the schema rejects unknown properties.
+ */
+export interface ClientContext {
+    /** Required by the backend. Use `""` on mobile (web-only URL). */
+    pageUrl: string;
+    viewportWidth: number;
+    viewportHeight: number;
+    /** Expo Router pathname (e.g. `"/settings/billing"`). */
+    screenPath?: string | null;
+    /** React Navigation / manual screen name (e.g. `"BillingSettings"`). */
+    screenName?: string | null;
+    site?: boolean | null;
+    siteId?: string;
+    localeCode?: string | null;
+}
+/**
+ * Location update from a mobile navigation change.
+ *
+ * Host helpers still speak `path` (Expo Router) vs `screen` (React Navigation);
+ * {@link UserflowCore.updateScreen} maps those onto `screenPath` / `screenName`
+ * on {@link ClientContext}.
+ */
+export type ClientLocationUpdate = {
+    path: string;
+} | {
+    screen: string;
+};
+export interface UpdateClientContext {
+    kind: 'UpdateClientContext';
+    clientContext: ClientContext;
+}
+/** Start (or re-start) a flow from a short-lived builder/preview token. */
+export interface StartFlowWithToken {
+    kind: 'StartFlowWithToken';
+    token: string;
+}
+/**
+ * Ask the server to wait for the flow's start condition instead of starting it
+ * immediately. Used by the builder's "when auto start conditions are triggered"
+ * preview mode; `StartFlowWithToken` force-starts and skips condition checks.
+ */
+export interface TestStartCondition {
+    kind: 'TestStartCondition';
+    token: string;
+}
+/** Stop waiting on a start condition started by {@link TestStartCondition}. */
+export interface TestStartConditionCancel {
+    kind: 'TestStartConditionCancel';
+}
+/**
+ * Snapshot entry included in the end-user channel join payload so the server
+ * can seed `tracked` / `true` / `false` client-condition sets on (re)join.
+ * `isTrue` is three-state: `true`, `false`, or `null` (unknown).
+ */
+export interface JoinPayloadClientCondition {
+    conditionId: string;
+    isTrue: boolean | null;
+}
+/**
+ * Which SDK is joining the end-user channel. The server defaults a missing
+ * value to `WEB`, and `check_sessions` then drops flows built for the other
+ * platform — so the mobile client must send `REACT_NATIVE` or a Builder
+ * preview is started and immediately unset.
+ */
+export declare enum TargetPlatform {
+    WEB = "WEB",
+    REACT_NATIVE = "REACT_NATIVE"
+}
+export type ClientMessage = GoToStep | EndFlow | ReportTooltipTargetMissing | AnswerQuestion | FireConditionWaitTimer | UpdateClientContext | ToggleClientCondition | StartFlowWithToken | TestStartCondition | TestStartConditionCancel | TrackEvent;
+export declare const SERVER_MESSAGE_KINDS: readonly ["SetFlowSession", "UnsetFlowSession", "ForceGoToStep", "StartConditionWaitTimer", "CancelConditionWaitTimer", "TrackClientCondition", "UntrackClientCondition", "TestStartConditionSuccess"];
+export declare const CLIENT_MESSAGE_KINDS: readonly ["GoToStep", "EndFlow", "ReportTooltipTargetMissing", "AnswerQuestion", "FireConditionWaitTimer", "UpdateClientContext", "ToggleClientCondition", "StartFlowWithToken", "TestStartCondition", "TestStartConditionCancel", "TrackEvent"];
+export declare function isServerMessage(value: unknown): value is ServerMessage;
+export declare function isClientMessage(value: unknown): value is ClientMessage;
+//# sourceMappingURL=messages.d.ts.map

package/vendor/protocol/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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"}

package/vendor/protocol/dist/messages.js

@@ -0,0 +1,57 @@
+/**
+ * Server/client wire messages (Phase 3, slice 1).
+ *
+ * Curated subset of the message unions from the web SDK's
+ * `end-user-protocol.ts`, limited to the flow-session lifecycle,
+ * condition-wait-timer, and client-condition messages needed to render
+ * modal/tooltip flows and gate them on device-local state. The full web
+ * unions carry many more message kinds (banner/checklist/resource-center/
+ * site sessions, assistant, trackers, etc.) that are out of scope here.
+ */
+/**
+ * Which SDK is joining the end-user channel. The server defaults a missing
+ * value to `WEB`, and `check_sessions` then drops flows built for the other
+ * platform — so the mobile client must send `REACT_NATIVE` or a Builder
+ * preview is started and immediately unset.
+ */
+export var TargetPlatform;
+(function (TargetPlatform) {
+    TargetPlatform["WEB"] = "WEB";
+    TargetPlatform["REACT_NATIVE"] = "REACT_NATIVE";
+})(TargetPlatform || (TargetPlatform = {}));
+export const SERVER_MESSAGE_KINDS = [
+    'SetFlowSession',
+    'UnsetFlowSession',
+    'ForceGoToStep',
+    'StartConditionWaitTimer',
+    'CancelConditionWaitTimer',
+    'TrackClientCondition',
+    'UntrackClientCondition',
+    'TestStartConditionSuccess',
+];
+export const CLIENT_MESSAGE_KINDS = [
+    'GoToStep',
+    'EndFlow',
+    'ReportTooltipTargetMissing',
+    'AnswerQuestion',
+    'FireConditionWaitTimer',
+    'UpdateClientContext',
+    'ToggleClientCondition',
+    'StartFlowWithToken',
+    'TestStartCondition',
+    'TestStartConditionCancel',
+    'TrackEvent',
+];
+function hasStringKind(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'kind' in value &&
+        typeof value.kind === 'string');
+}
+export function isServerMessage(value) {
+    return hasStringKind(value) && SERVER_MESSAGE_KINDS.includes(value.kind);
+}
+export function isClientMessage(value) {
+    return hasStringKind(value) && CLIENT_MESSAGE_KINDS.includes(value.kind);
+}
+//# sourceMappingURL=messages.js.map

package/vendor/protocol/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA8KH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,+CAA6B,CAAA;AAC/B,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAeD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,gBAAgB;IAChB,kBAAkB;IAClB,eAAe;IACf,yBAAyB;IACzB,0BAA0B;IAC1B,sBAAsB;IACtB,wBAAwB;IACxB,2BAA2B;CACwB,CAAC;AAEtD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU;IACV,SAAS;IACT,4BAA4B;IAC5B,gBAAgB;IAChB,wBAAwB;IACxB,qBAAqB;IACrB,uBAAuB;IACvB,oBAAoB;IACpB,oBAAoB;IACpB,0BAA0B;IAC1B,YAAY;CACuC,CAAC;AAEtD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAQ,KAA2B,CAAC,IAAI,KAAK,QAAQ,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,aAAa,CAAC,KAAK,CAAC,IAAK,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,aAAa,CAAC,KAAK,CAAC,IAAK,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAClG,CAAC"}

package/vendor/protocol/dist/pairing.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Builder pairing wire contracts (mobile preview relay).
+ *
+ * Matches the backend `PairingChannel` allow-list and JWT claims shape.
+ * The JWT is signed, not encrypted — the SDK may decode claims client-side;
+ * the PairingSocket verifies signature + exp on connect.
+ */
+/** Claims the device reads from a pairing JWT payload (unsigned decode). */
+export interface PairingJwtClaims {
+    pairing_id: string;
+    exp: number;
+    iss?: string;
+    aud?: string;
+    iat?: number;
+}
+/** Device join payload for `pairing:<pairing_id>`. */
+export interface PairingJoinPayload {
+    device_id: string;
+    model?: string;
+    os?: string;
+    app_version?: string;
+}
+/**
+ * Events the pairing channel relays between builder and device.
+ * Names match backend `@relayed_events` (CRX camelCase).
+ */
+export declare const PAIRING_RELAY_EVENTS: readonly ["selectElement", "selectElementResult", "selectElementCancel", "startFlowWithToken", "startFlowWithTokenResult", "testTracker", "testTrackerResult", "startSmartFlow", "smartFlowStep", "smartFlowStop", "screenshot", "screenshotResult"];
+export type PairingRelayEvent = (typeof PAIRING_RELAY_EVENTS)[number];
+/** Payload for the builder → device `startFlowWithToken` relay event. */
+export interface StartFlowWithTokenRelayPayload {
+    token: string;
+    idempotency_key?: string;
+    flowId?: string;
+    /**
+     * When true the builder asked to *wait for* the flow's start condition rather
+     * than start it immediately. Mirrors web `userflow-client.ts`, which routes
+     * this to `TestStartCondition` instead of `StartFlowWithToken`.
+     */
+    testStartCondition?: boolean;
+    [key: string]: unknown;
+}
+/** Result event device → builder after handling `startFlowWithToken`. */
+export interface StartFlowWithTokenResultPayload {
+    ok: boolean;
+    error?: string;
+    idempotency_key?: string;
+}
+export declare function isPairingRelayEvent(value: string): value is PairingRelayEvent;
+/**
+ * Decode the payload segment of a JWT without verifying the signature.
+ * Returns null when the token is malformed or missing required claims.
+ */
+export declare function decodePairingJwt(jwt: string): PairingJwtClaims | null;
+/** True when `exp` (unix seconds) is at or before `nowMs`. */
+export declare function isPairingJwtExpired(claims: PairingJwtClaims, nowMs?: number): boolean;
+//# sourceMappingURL=pairing.d.ts.map

package/vendor/protocol/dist/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../src/pairing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,sPAavB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,yEAAyE;AACzE,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAwBrE;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAEjG"}

package/vendor/protocol/dist/pairing.js

@@ -0,0 +1,146 @@
+/**
+ * Builder pairing wire contracts (mobile preview relay).
+ *
+ * Matches the backend `PairingChannel` allow-list and JWT claims shape.
+ * The JWT is signed, not encrypted — the SDK may decode claims client-side;
+ * the PairingSocket verifies signature + exp on connect.
+ */
+/**
+ * Events the pairing channel relays between builder and device.
+ * Names match backend `@relayed_events` (CRX camelCase).
+ */
+export const PAIRING_RELAY_EVENTS = [
+    'selectElement',
+    'selectElementResult',
+    'selectElementCancel',
+    'startFlowWithToken',
+    'startFlowWithTokenResult',
+    'testTracker',
+    'testTrackerResult',
+    'startSmartFlow',
+    'smartFlowStep',
+    'smartFlowStop',
+    'screenshot',
+    'screenshotResult',
+];
+export function isPairingRelayEvent(value) {
+    return PAIRING_RELAY_EVENTS.includes(value);
+}
+/**
+ * Decode the payload segment of a JWT without verifying the signature.
+ * Returns null when the token is malformed or missing required claims.
+ */
+export function decodePairingJwt(jwt) {
+    if (typeof jwt !== 'string' || jwt.length === 0)
+        return null;
+    const parts = jwt.split('.');
+    if (parts.length < 2)
+        return null;
+    const payloadSeg = parts[1];
+    if (!payloadSeg)
+        return null;
+    try {
+        const json = base64UrlDecodeToString(payloadSeg);
+        const parsed = JSON.parse(json);
+        const pairingId = parsed.pairing_id;
+        const exp = parsed.exp;
+        if (typeof pairingId !== 'string' || pairingId.length === 0)
+            return null;
+        if (typeof exp !== 'number' || !Number.isFinite(exp))
+            return null;
+        return {
+            pairing_id: pairingId,
+            exp,
+            ...(typeof parsed.iss === 'string' ? { iss: parsed.iss } : {}),
+            ...(typeof parsed.aud === 'string' ? { aud: parsed.aud } : {}),
+            ...(typeof parsed.iat === 'number' ? { iat: parsed.iat } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** True when `exp` (unix seconds) is at or before `nowMs`. */
+export function isPairingJwtExpired(claims, nowMs = Date.now()) {
+    return claims.exp * 1000 <= nowMs;
+}
+function base64UrlDecodeToString(segment) {
+    const padded = segment.replace(/-/g, '+').replace(/_/g, '/');
+    const padLen = (4 - (padded.length % 4)) % 4;
+    const b64 = padded + '='.repeat(padLen);
+    return utf8BytesToString(base64ToBytes(b64));
+}
+function base64ToBytes(b64) {
+    if (typeof globalThis.atob === 'function') {
+        const binary = globalThis.atob(b64);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i += 1) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
+    // Node / test environments.
+    const buf = globalThis.Buffer;
+    if (buf)
+        return new Uint8Array(buf.from(b64, 'base64'));
+    // Hermes / React Native without atob or Buffer polyfills.
+    return decodeBase64Manual(b64);
+}
+function decodeBase64Manual(b64) {
+    const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+    const clean = b64.replace(/=+$/g, '');
+    const out = new Uint8Array(Math.floor((clean.length * 3) / 4));
+    let outIndex = 0;
+    for (let i = 0; i < clean.length; i += 4) {
+        const c0 = alphabet.indexOf(clean[i] ?? '');
+        const c1 = alphabet.indexOf(clean[i + 1] ?? '');
+        const c2 = alphabet.indexOf(clean[i + 2] ?? 'A');
+        const c3 = alphabet.indexOf(clean[i + 3] ?? 'A');
+        if (c0 < 0 || c1 < 0 || c2 < 0 || c3 < 0) {
+            throw new Error('Invalid base64');
+        }
+        const triplet = (c0 << 18) | (c1 << 12) | (c2 << 6) | c3;
+        if (outIndex < out.length)
+            out[outIndex++] = (triplet >> 16) & 0xff;
+        if (i + 2 < clean.length && outIndex < out.length) {
+            out[outIndex++] = (triplet >> 8) & 0xff;
+        }
+        if (i + 3 < clean.length && outIndex < out.length) {
+            out[outIndex++] = triplet & 0xff;
+        }
+    }
+    return outIndex === out.length ? out : out.subarray(0, outIndex);
+}
+function utf8BytesToString(bytes) {
+    if (typeof TextDecoder === 'function') {
+        return new TextDecoder('utf-8').decode(bytes);
+    }
+    // Manual UTF-8 decode for runtimes without TextDecoder (older Hermes).
+    let out = '';
+    for (let i = 0; i < bytes.length; i += 1) {
+        const b0 = bytes[i];
+        if (b0 < 0x80) {
+            out += String.fromCharCode(b0);
+            continue;
+        }
+        if (b0 < 0xe0) {
+            const b1 = bytes[++i] ?? 0;
+            out += String.fromCharCode(((b0 & 0x1f) << 6) | (b1 & 0x3f));
+            continue;
+        }
+        if (b0 < 0xf0) {
+            const b1 = bytes[++i] ?? 0;
+            const b2 = bytes[++i] ?? 0;
+            out += String.fromCharCode(((b0 & 0x0f) << 12) | ((b1 & 0x3f) << 6) | (b2 & 0x3f));
+            continue;
+        }
+        const b1 = bytes[++i] ?? 0;
+        const b2 = bytes[++i] ?? 0;
+        const b3 = bytes[++i] ?? 0;
+        let cp = ((b0 & 0x07) << 18) | ((b1 & 0x3f) << 12) | ((b2 & 0x3f) << 6) | (b3 & 0x3f);
+        cp -= 0x10000;
+        out += String.fromCharCode(0xd800 + ((cp >> 10) & 0x3ff), 0xdc00 + (cp & 0x3ff));
+    }
+    return out;
+}
+//# sourceMappingURL=pairing.js.map

package/vendor/protocol/dist/pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.js","sourceRoot":"","sources":["../src/pairing.ts"],"names":[],"mappings":"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"}

package/vendor/protocol/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@userflow-tech/protocol",
+  "version": "0.1.1",
+  "description": "Userflow React Native SDK protocol — wire contracts and shared types.",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "sideEffects": false
+}