@userflow-tech/react-native 0.1.1 → 0.3.0

package/vendor/core/dist/engine/PairingEngine.d.ts

@@ -1,4 +1,4 @@
-import type { ClientMessage, ServerMessage } from '@userflow-tech/protocol';
+import type { ClientMessage, PairingRelayEvent, ServerMessage } from '@userflow-tech/protocol';
 import { PairingConnection, type PairingConnectionOptions } from '../transport/pairing.js';
 export type PairingEngineStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'token_expired' | 'device_already_paired' | 'error';
 export interface PairingEngineState {
@@ -16,8 +16,45 @@ export interface PairingEngineState {
      * condition that never fires.
      */
     awaitingStartCondition: boolean;
+    /**
+     * True when a delivered `startFlowWithToken` can be replayed from the top bar.
+     * Requires a cached payload and `status === 'connected'`.
+     */
+    canRestartPreview: boolean;
+    /**
+     * Bumped at the start of each {@link PairingEngine.restartPreview} attempt so
+     * the RN overlay can re-bootstrap tooltip targeting when the server reuses
+     * the same draft session id.
+     */
+    previewRestartGeneration: number;
+    /**
+     * Identifies one {@link PairingEngine.start} call. The preview banner uses it
+     * to replay its intro on a new scan, including a warm re-scan that never
+     * drops the chrome. `0` means no session has started.
+     * The counter is process-wide, so replacing the engine cannot reuse a key.
+     */
+    pairingSessionGeneration: number;
+    /**
+     * Bumped once each time a Builder-initiated `startFlowWithToken` is delivered
+     * on the end-user channel. The preview bar uses the increase to come back
+     * after element selection. {@link PairingEngine.restartPreview} does not bump
+     * it. Monotonic for the life of this engine, including stop and a new scan.
+     */
+    previewStartGeneration: number;
+    /**
+     * What the Builder dialog that produced the pairing link wants. Set by
+     * {@link PairingEngine.start} together with `pairingSessionGeneration`.
+     * Absent when the link did not say (older Builders).
+     */
+    pairingPurpose?: PairingPurpose;
+}
+/** The `purpose` a Builder pairing link can carry. */
+export type PairingPurpose = 'preview' | 'select_element';
+export interface PairingStartOptions {
+    purpose?: PairingPurpose;
 }
 export type PairingEngineListener = (state: PairingEngineState) => void;
+export type PairingRelayHandler = (event: PairingRelayEvent, payload: unknown) => void;
 export interface PairingEngineDeps {
     /** Send a client message on the end-user channel (after identify). */
     sendClientMessage: (message: ClientMessage) => Promise<void>;
@@ -30,15 +67,33 @@ export interface PairingEngineDeps {
     onServerMessage?: (handler: (message: ServerMessage) => void) => () => void;
     /** Whether an end-user identity is currently active. */
     isIdentified: () => boolean;
-    /** Optional device metadata included on pairing join. */
+    /**
+     * Optional device metadata included on pairing join. Pass `device_id` to
+     * rejoin as the same device; a fresh id is rejected while the previous
+     * presence is still on the pairing topic.
+     */
     deviceMeta?: () => {
         model?: string;
         os?: string;
         app_version?: string;
+        device_id?: string;
     };
+    /**
+     * Runs immediately before a Builder-initiated preview start is sent on the
+     * end-user channel, so the host can drop a draft the server restored.
+     * Not called for {@link PairingEngine.restartPreview}.
+     */
+    onBeforePreviewStart?: () => void;
     pairingOptions?: PairingConnectionOptions;
     createConnection?: (options: PairingConnectionOptions) => PairingConnection;
 }
+/**
+ * True when a pairing `push` reached the socket but the server ack timed out.
+ * Relayed events are delivered via broadcast; a missing ack is not a lost send.
+ * {@link PairingEngine.sendRelay} rejects with this for `UserflowAuthError`
+ * messages containing `reply timed out`. Connection failures do not match.
+ */
+export declare function isPairingPushAckTimeout(error: unknown): boolean;
 /**
  * Orchestrates a pairing session: connect/join the pairing socket, bridge
  * `startFlowWithToken` onto the end-user channel, and expose preview-mode state.
@@ -48,7 +103,10 @@ export declare class PairingEngine {
     private unsubscribe;
     private state;
     private readonly listeners;
+    private readonly relayListeners;
     private pendingStartTokens;
+    /** Last successfully delivered preview start; replayed by {@link restartPreview}. */
+    private lastStartPayload;
     /** True while the server is waiting on a start condition (see TestStartCondition). */
     private testingStartCondition;
     private startConditionUnsub;
@@ -57,11 +115,30 @@ export declare class PairingEngine {
     getState(): PairingEngineState;
     isPreviewActive(): boolean;
     onStateChange(listener: PairingEngineListener): () => void;
+    /**
+     * Subscribe to inbound pairing-channel relay events (`selectElement`,
+     * `screenshot`, …). `startFlowWithToken` is still handled internally; it is
+     * also forwarded here so consumers can ignore it.
+     */
+    onRelay(handler: PairingRelayHandler): () => void;
+    /**
+     * Push a relay event to the builder (e.g. `selectElementResult`).
+     * Rejects when there is no connection (`Not connected to a pairing channel`)
+     * or the websocket is closed. A `reply timed out` rejection means the frame
+     * was sent; use {@link isPairingPushAckTimeout} to ignore those acks.
+     */
+    sendRelay(event: PairingRelayEvent, payload: unknown): Promise<unknown>;
     /**
      * Begin (or replace) a pairing session with a JWT from a deep link.
      * Closes any existing pairing websocket first (warm re-scan).
      */
-    start(pairingToken: string): Promise<void>;
+    start(pairingToken: string, startOptions?: PairingStartOptions): Promise<void>;
+    /**
+     * Re-deliver the last successful `startFlowWithToken` payload on the end-user
+     * channel. Does not ack the builder — that listener is keyed to the original
+     * Preview-dialog `idempotency_key`.
+     */
+    restartPreview(): Promise<boolean>;
     /** Exit preview: disconnect pairing and clear queued preview tokens. */
     stop(): void;
     /**
@@ -85,8 +162,10 @@ export declare class PairingEngine {
     private handleStartFlowWithToken;
     private flushPendingStartTokens;
     private deliverStartFlowWithToken;
+    private clearStartCache;
     private pushStartResult;
     private teardownConnection;
+    private emitRelay;
     private setState;
 }
 //# sourceMappingURL=PairingEngine.d.ts.map

package/vendor/core/dist/engine/PairingEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PairingEngine.d.ts","sourceRoot":"","sources":["../../src/engine/PairingEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EAEjB,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,eAAe,GACf,uBAAuB,GACvB,OAAO,CAAC;AAEZ,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,iBAAiB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC5E,wDAAwD;IACxD,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,iBAAiB,CAAC;CAC7E;AAYD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,kBAAkB,CAAwC;IAClE,sFAAsF;IACtF,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;gBAE7B,IAAI,EAAE,iBAAiB;IAInC,QAAQ,IAAI,kBAAkB;IAI9B,eAAe,IAAI,OAAO;IAI1B,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAO1D;;;OAGG;IACG,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0ChD,wEAAwE;IACxE,IAAI,IAAI,IAAI;IAgBZ;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,qBAAqB;IAK7B;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAOnC;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB,WAAW,IAAI,IAAI;IAInB,OAAO,CAAC,qBAAqB;YAqEf,wBAAwB;YA0BxB,uBAAuB;YASvB,yBAAyB;YA+BzB,eAAe;IAiB7B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,QAAQ;CAUjB"}
+{"version":3,"file":"PairingEngine.d.ts","sourceRoot":"","sources":["../../src/engine/PairingEngine.ts"],"names":[],"mappings":"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"}

package/vendor/core/dist/engine/PairingEngine.js

@@ -7,7 +7,22 @@ const IDLE_STATE = {
     lastError: null,
     needsRescan: false,
     awaitingStartCondition: false,
+    canRestartPreview: false,
+    previewRestartGeneration: 0,
+    pairingSessionGeneration: 0,
+    previewStartGeneration: 0,
 };
+/** Process-wide so a replacement engine cannot reuse a session key. */
+let pairingSessionGenerationCounter = 0;
+/**
+ * True when a pairing `push` reached the socket but the server ack timed out.
+ * Relayed events are delivered via broadcast; a missing ack is not a lost send.
+ * {@link PairingEngine.sendRelay} rejects with this for `UserflowAuthError`
+ * messages containing `reply timed out`. Connection failures do not match.
+ */
+export function isPairingPushAckTimeout(error) {
+    return error instanceof Error && error.message.includes('reply timed out');
+}
 /**
  * Orchestrates a pairing session: connect/join the pairing socket, bridge
  * `startFlowWithToken` onto the end-user channel, and expose preview-mode state.
@@ -18,7 +33,10 @@ export class PairingEngine {
         this.unsubscribe = null;
         this.state = { ...IDLE_STATE };
         this.listeners = new Set();
+        this.relayListeners = new Set();
         this.pendingStartTokens = [];
+        /** Last successfully delivered preview start; replayed by {@link restartPreview}. */
+        this.lastStartPayload = null;
         /** True while the server is waiting on a start condition (see TestStartCondition). */
         this.testingStartCondition = false;
         this.startConditionUnsub = null;
@@ -36,13 +54,36 @@ export class PairingEngine {
             this.listeners.delete(listener);
         };
     }
+    /**
+     * Subscribe to inbound pairing-channel relay events (`selectElement`,
+     * `screenshot`, …). `startFlowWithToken` is still handled internally; it is
+     * also forwarded here so consumers can ignore it.
+     */
+    onRelay(handler) {
+        this.relayListeners.add(handler);
+        return () => {
+            this.relayListeners.delete(handler);
+        };
+    }
+    /**
+     * Push a relay event to the builder (e.g. `selectElementResult`).
+     * Rejects when there is no connection (`Not connected to a pairing channel`)
+     * or the websocket is closed. A `reply timed out` rejection means the frame
+     * was sent; use {@link isPairingPushAckTimeout} to ignore those acks.
+     */
+    sendRelay(event, payload) {
+        if (!this.connection) {
+            return Promise.reject(new Error('Not connected to a pairing channel'));
+        }
+        return this.connection.push(event, payload);
+    }
     /**
      * Begin (or replace) a pairing session with a JWT from a deep link.
      * Closes any existing pairing websocket first (warm re-scan).
      */
-    async start(pairingToken) {
+    async start(pairingToken, startOptions = {}) {
         this.teardownConnection();
-        this.pendingStartTokens = [];
+        this.clearStartCache();
         // A re-scan is a new session: stop tracking the previous one's condition.
         this.testingStartCondition = false;
         this.unwatchStartCondition();
@@ -54,6 +95,9 @@ export class PairingEngine {
             lastError: null,
             needsRescan: false,
             awaitingStartCondition: false,
+            previewRestartGeneration: 0,
+            pairingSessionGeneration: ++pairingSessionGenerationCounter,
+            ...(startOptions.purpose ? { pairingPurpose: startOptions.purpose } : {}),
         });
         const options = this.deps.pairingOptions ?? {};
         const connection = (this.deps.createConnection ?? ((opts) => new PairingConnection(opts)))(options);
@@ -78,9 +122,37 @@ export class PairingEngine {
             throw error;
         }
     }
+    /**
+     * Re-deliver the last successful `startFlowWithToken` payload on the end-user
+     * channel. Does not ack the builder — that listener is keyed to the original
+     * Preview-dialog `idempotency_key`.
+     */
+    async restartPreview() {
+        const payload = this.lastStartPayload;
+        if (!payload || !this.connection || this.state.status !== 'connected')
+            return false;
+        if (!this.deps.isIdentified())
+            return false;
+        // Bump before the send so RN can disarm tooltip resolve while the Restart
+        // dialog tears down. Roll back if the send fails so a dead channel does not
+        // leave targeting in a reset that never gets a new start.
+        const nextGeneration = this.state.previewRestartGeneration + 1;
+        this.setState({
+            ...this.state,
+            previewRestartGeneration: nextGeneration,
+        });
+        const delivered = await this.deliverStartFlowWithToken(payload, { ackBuilder: false });
+        if (!delivered && this.state.previewRestartGeneration === nextGeneration) {
+            this.setState({
+                ...this.state,
+                previewRestartGeneration: nextGeneration - 1,
+            });
+        }
+        return delivered;
+    }
     /** Exit preview: disconnect pairing and clear queued preview tokens. */
     stop() {
-        this.pendingStartTokens = [];
+        this.clearStartCache();
         // Web sends TestStartConditionCancel when leaving start-condition testing so
         // the server stops waiting on the draft flow. Best-effort: the channel may
         // already be gone, and teardown must not reject.
@@ -92,7 +164,11 @@ export class PairingEngine {
         }
         this.unwatchStartCondition();
         this.teardownConnection();
-        this.setState({ ...IDLE_STATE });
+        this.setState({
+            ...IDLE_STATE,
+            pairingSessionGeneration: this.state.pairingSessionGeneration,
+            previewStartGeneration: this.state.previewStartGeneration,
+        });
     }
     /**
      * Listen for the server confirming the tested start condition matched. Called
@@ -168,7 +244,7 @@ export class PairingEngine {
                 });
                 break;
             case 'token_expired':
-                this.pendingStartTokens = [];
+                this.clearStartCache();
                 this.setState({
                     ...this.state,
                     status: 'token_expired',
@@ -179,6 +255,7 @@ export class PairingEngine {
                 this.teardownConnection();
                 break;
             case 'device_already_paired':
+                this.clearStartCache();
                 this.setState({
                     ...this.state,
                     status: 'device_already_paired',
@@ -189,6 +266,7 @@ export class PairingEngine {
                 this.teardownConnection();
                 break;
             case 'join_error':
+                this.clearStartCache();
                 this.setState({
                     ...this.state,
                     status: 'error',
@@ -201,7 +279,7 @@ export class PairingEngine {
                 void this.handleStartFlowWithToken(event.payload);
                 break;
             case 'relay':
-                // Phase 2: selectElement / screenshot / etc.
+                this.emitRelay(event.event, event.payload);
                 break;
             default:
                 break;
@@ -236,13 +314,16 @@ export class PairingEngine {
             await this.deliverStartFlowWithToken(payload);
         }
     }
-    async deliverStartFlowWithToken(payload) {
+    async deliverStartFlowWithToken(payload, options = {}) {
         // Mirrors web `userflow-client.ts`: testing a start condition is handled
         // differently from starting the draft flow immediately. `StartFlowWithToken`
         // force-starts server-side (no condition check), so honoring this flag is
         // what makes "when auto start conditions are triggered" actually wait.
         const testStartCondition = payload.testStartCondition === true;
+        const ackBuilder = options.ackBuilder !== false;
         try {
+            if (ackBuilder)
+                this.deps.onBeforePreviewStart?.();
             await this.deps.sendClientMessage(testStartCondition
                 ? { kind: 'TestStartCondition', token: payload.token }
                 : { kind: 'StartFlowWithToken', token: payload.token });
@@ -251,22 +332,36 @@ export class PairingEngine {
                 this.watchStartCondition();
             else
                 this.unwatchStartCondition();
+            this.lastStartPayload = payload;
             // Preview is live either way, but a tested condition has not fired yet.
+            // Only a Builder-acked delivery counts: restartPreview replays the same
+            // payload with ackBuilder false and must not look like a new preview.
             this.setState({
                 ...this.state,
                 previewActive: true,
                 awaitingStartCondition: testStartCondition,
+                ...(ackBuilder ? { previewStartGeneration: this.state.previewStartGeneration + 1 } : {}),
             });
-            await this.pushStartResult(true, undefined, payload.idempotency_key);
+            if (ackBuilder) {
+                await this.pushStartResult(true, undefined, payload.idempotency_key);
+            }
+            return true;
         }
         catch (error) {
             const fallback = testStartCondition
                 ? 'TestStartCondition failed'
                 : 'StartFlowWithToken failed';
             const message = error instanceof Error ? error.message : fallback;
-            await this.pushStartResult(false, message, payload.idempotency_key);
+            if (ackBuilder) {
+                await this.pushStartResult(false, message, payload.idempotency_key);
+            }
+            return false;
         }
     }
+    clearStartCache() {
+        this.lastStartPayload = null;
+        this.pendingStartTokens = [];
+    }
     async pushStartResult(ok, error, idempotencyKey) {
         if (!this.connection)
             return;
@@ -287,11 +382,27 @@ export class PairingEngine {
         this.connection?.disconnect({ emitState: false });
         this.connection = null;
     }
+    emitRelay(event, payload) {
+        for (const handler of this.relayListeners) {
+            try {
+                handler(event, payload);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
     setState(next) {
-        this.state = next;
+        this.state = {
+            ...next,
+            previewRestartGeneration: next.previewRestartGeneration ?? this.state.previewRestartGeneration,
+            pairingSessionGeneration: next.pairingSessionGeneration ?? this.state.pairingSessionGeneration,
+            previewStartGeneration: next.previewStartGeneration ?? this.state.previewStartGeneration,
+            canRestartPreview: this.lastStartPayload != null && next.status === 'connected',
+        };
         for (const listener of this.listeners) {
             try {
-                listener({ ...next });
+                listener({ ...this.state });
             }
             catch {
                 // ignore

package/vendor/core/dist/engine/PairingEngine.js.map

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

package/vendor/core/dist/engine/UserflowCore.d.ts

@@ -1,6 +1,6 @@
-import type { ClientContext, ClientLocationUpdate, ClientMessage, JoinPayloadClientCondition, ServerMessage, UserflowAttributes } from '@userflow-tech/protocol';
+import type { Attributes, ClientContext, ClientLocationUpdate, ClientMessage, JoinPayloadClientCondition, ServerMessage, UserflowAttributes } from '@userflow-tech/protocol';
 import type { ServerMessageHandler } from '../transport/phoenix.js';
-import type { UserflowConfig, UserflowGroupOptions, UserflowIdentifyOptions, UserflowInitOptions, UserflowEventAttributes, UserflowTrackOptions } from '../types.js';
+import type { PublicAttributes, UserflowConfig, UserflowGroupOptions, UserflowIdentifyOptions, UserflowInitOptions, UserflowEventAttributes, UserflowTrackOptions, UserflowUpdateGroupOptions } from '../types.js';
 /** Overridable engine dependencies; production defaults use the Phoenix transport. */
 export interface UserflowCoreDeps {
     validate?: ValidateCredentialsFn;
@@ -9,19 +9,22 @@ export interface UserflowCoreDeps {
 export interface UpsertGroupPayload {
     groupExternalId: string;
     groupSignature: string | null;
-    groupAttributes: UserflowAttributes;
-    membershipAttributes: UserflowAttributes;
+    groupAttributes: Attributes;
+    membershipAttributes: Attributes;
 }
 /** The subset of the transport the engine depends on (injectable for tests). */
 export interface UserflowConnection {
     identify(userId: string, attributes: UserflowAttributes, signature?: string | null): Promise<void>;
     ensureEndUserChannel(userId: string, signature?: string | null): Promise<void>;
     group(payload: UpsertGroupPayload): Promise<void>;
+    /** Push `UpsertUser` on an already-joined channel (no re-identify). */
+    updateUser(attributes: Attributes): Promise<void>;
     send(message: ClientMessage): Promise<void>;
     updateClientContext(clientContext: ClientContext): Promise<void>;
     setClientContext(clientContext: ClientContext): void;
     onServerMessage(handler: ServerMessageHandler): () => void;
     setFlowSessionId(flowSessionId: string | null): void;
+    setBannerSessionId(bannerSessionId: string | null): void;
     setClientConditions(clientConditions: JoinPayloadClientCondition[]): void;
     disconnect(): void;
     suspend(): void;
@@ -44,6 +47,8 @@ export declare class UserflowCore {
     private connection;
     private userId;
     private identitySignature;
+    private groupId;
+    private groupSignature;
     private attributes;
     private clientContext;
     private initPromise;
@@ -53,8 +58,21 @@ export declare class UserflowCore {
     init(options: UserflowInitOptions): Promise<UserflowConfig>;
     identify(userId: string, attributes?: UserflowAttributes, options?: UserflowIdentifyOptions): Promise<void>;
     group(groupId: string | number, attributes?: UserflowAttributes, options?: UserflowGroupOptions): Promise<void>;
+    /**
+     * Upsert attributes for the current user without re-identifying.
+     * Requires a prior {@link identify}. Used by flow `SET_ATTRIBUTE` actions.
+     */
+    updateUser(attributes?: PublicAttributes): Promise<void>;
+    /**
+     * Upsert attributes for the current group / membership without re-grouping.
+     * Requires a prior {@link group}. Used by flow `SET_ATTRIBUTE` actions
+     * whose FQN is `group/…` or `group_membership/…`.
+     */
+    updateGroup(attributes?: PublicAttributes, options?: UserflowUpdateGroupOptions): Promise<void>;
     track(name: string, attributes?: UserflowEventAttributes, options?: UserflowTrackOptions): Promise<void>;
     getUserId(): string | null;
+    /** Configured end-user API host after {@link init}, or null before init. */
+    getServerEndpoint(): string | null;
     getAttributes(): UserflowAttributes;
     /** Suspend the connection (e.g. when the app backgrounds). No-op before identify. */
     suspend(): void;
@@ -98,6 +116,11 @@ export declare class UserflowCore {
      * No-op before identify / connection creation.
      */
     setFlowSessionId(flowSessionId: string | null): void;
+    /**
+     * Tell the transport which banner session to resume on (re)join.
+     * No-op before identify / connection creation.
+     */
+    setBannerSessionId(bannerSessionId: string | null): void;
     /**
      * Tell the transport which client-condition snapshot to include on (re)join.
      * No-op before identify / connection creation.
@@ -109,7 +132,8 @@ export declare class UserflowCore {
      * next channel join.
      *
      * Expo Router should pass `{ path }`; React Navigation / manual callers pass
-     * `{ screen }`. Those map to wire fields `screenPath` / `screenName`.
+     * `{ screen }`. Both map to the wire field `screenName` — the backend has no
+     * separate path field.
      * `pageUrl` stays `""` on mobile (required by the backend, web-only otherwise).
      */
     updateScreen(location: ClientLocationUpdate): Promise<void>;
@@ -121,6 +145,10 @@ export declare class UserflowCore {
     private requireIdentified;
     private doIdentify;
     private doGroup;
+    private requireIdentifiedFor;
+    private requireGroup;
+    private doUpdateUser;
+    private doUpdateGroup;
     private doTrack;
 }
 //# sourceMappingURL=UserflowCore.d.ts.map

package/vendor/core/dist/engine/UserflowCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserflowCore.d.ts","sourceRoot":"","sources":["../../src/engine/UserflowCore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,0BAA0B,EAC1B,aAAa,EACb,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAQrB,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,kBAAkB,CAAC;IACpC,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C;AAED,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,kBAAkB,EAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,mBAAmB,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACrD,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IAC3D,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACrD,mBAAmB,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAAC;IAC1E,UAAU,IAAI,IAAI,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,IAAI,CAAC;IACf,2FAA2F;IAC3F,YAAY,IAAI,IAAI,CAAC;IACrB,6EAA6E;IAC7E,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnG,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,CAC/B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,KACnB,kBAAkB,CAAC;AAQxB;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;gBAE1C,IAAI,GAAE,gBAAqB;IASvC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAS3D,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,kBAAuB,EACnC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC;IAIhB,KAAK,CACH,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,UAAU,GAAE,kBAAuB,EACnC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC;IAIhB,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,uBAA4B,EACxC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC;IAIhB,SAAS,IAAI,MAAM,GAAG,IAAI;IAI1B,aAAa,IAAI,kBAAkB;IAInC,qFAAqF;IACrF,OAAO,IAAI,IAAI;IAIf,oFAAoF;IACpF,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,YAAY,IAAI,IAAI;IAIpB;;;;;OAKG;IACH,WAAW,IAAI,IAAI;IAInB;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtC;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD;;;OAGG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAOtE;;;OAGG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIpD;;;OAGG;IACH,mBAAmB,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,GAAG,IAAI;IAIzE;;;;;;;;OAQG;IACG,YAAY,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjE,sEAAsE;IACtE,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,mBAAmB;YAOb,MAAM;IAepB,OAAO,CAAC,iBAAiB;YAMX,UAAU;YA4BV,OAAO;YA2BP,OAAO;CAsBtB"}
+{"version":3,"file":"UserflowCore.d.ts","sourceRoot":"","sources":["../../src/engine/UserflowCore.ts"],"names":[],"mappings":"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"}