@repzo/widget-react-native 1.0.0

package/lib/typescript/module/i18n.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Translations come from the widget config (`translations[locale][key]`), with
+ * the widget's default locale as the fallback chain — same lookup as the web
+ * widget's `t()` in `client/src/widget/App.tsx`.
+ */
+import type { WidgetConfig } from './types';
+export type Translator = (key: string, fallback: string) => string;
+/**
+ * Resolution order, most specific first: what the workspace configured for the
+ * active locale, what the SDK ships for it, then the same pair for the
+ * workspace's default locale, and finally the English built-in. Dashboard
+ * copy always outranks a bundled translation.
+ */
+export declare function createTranslator(config: WidgetConfig | null, locale: string): Translator;
+export declare const DEFAULT_LABELS: {
+    readonly back: "Back";
+    readonly loading: "Loading...";
+    readonly loadEarlier: "Load earlier messages";
+    readonly emptyConversation: "Send a message to start the conversation";
+    readonly messagePlaceholder: "Type a message...";
+    readonly attachFile: "Attach file";
+    readonly failedToSend: "Failed to send";
+    readonly thinking: "Typing";
+    readonly messages: "Messages";
+    readonly noMessages: "No messages yet";
+    readonly historyHidden: "Conversation history is hidden";
+    readonly startBelow: "Start a conversation below";
+    readonly preChatTitle: "Before we chat";
+    readonly preChatSubtitle: "Let us know a bit about you so we can help you better.";
+    readonly preChatSkip: "Skip";
+    readonly preChatSubmit: "Start chat";
+    readonly viewPreviousConversations: "View previous conversations";
+    readonly homeRecentTitle: "Recent";
+    readonly homeViewAllCount: "View all ({count})";
+    readonly homeNoConversations: "Your conversations will show up here";
+    readonly homeStatusOnline: "We're online";
+    readonly homeStatusAway: "We're away";
+    readonly unreadBadge: "{count} unread";
+    readonly team: "Team";
+    readonly home: "Home";
+    readonly close: "Close";
+    readonly retry: "Retry";
+    readonly connectionError: "We could not load the chat. Please try again.";
+    readonly connecting: "Connecting you to the team";
+    readonly chatUnavailable: "Chat is not available right now.";
+    readonly identityVerificationError: "We couldn't verify your account. Please sign in again.";
+    readonly widgetCrashed: "Something went wrong.";
+    readonly timeJustNow: "Just now";
+    readonly timeMinutes: "{count}m";
+    readonly timeHours: "{count}h";
+    readonly timeDays: "{count}d";
+    readonly timeMonths: "{count}mo";
+    readonly timeYears: "{count}y";
+    readonly today: "Today";
+    readonly yesterday: "Yesterday";
+    readonly conversationUpdated: "Conversation updated";
+    readonly procedureSend: "Send details";
+    readonly procedureSent: "Sent";
+    readonly fieldRequired: "{field} is required";
+    readonly invalidEmail: "Enter a valid email address";
+    readonly working: "Working...";
+    readonly outboundTitle: "New update";
+    readonly outboundCta: "Learn more";
+    readonly dismiss: "Dismiss";
+    readonly blockService: "Service";
+    readonly blockProduct: "Product";
+    readonly blockChooseTime: "Choose a time";
+    readonly blockProfessional: "Professional";
+    readonly blockPriceOffer: "Price offer";
+};
+export type LabelKey = keyof typeof DEFAULT_LABELS;
+/**
+ * Fill `{token}` placeholders in a translated string. Interpolation belongs in
+ * the string layer so translators keep control of word order.
+ */
+export declare function formatLabel(template: string, values: Record<string, string | number>): string;
+export declare function buildLabels(translate: Translator): Record<LabelKey, string>;
+//# sourceMappingURL=i18n.d.ts.map

package/lib/typescript/module/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAYxF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8DjB,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,cAAc,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAI7F;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAM3E"}

package/lib/typescript/module/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @repzo/widget-react-native — the Repzo chat widget for React Native.
+ *
+ * Pure JavaScript: no native modules, no config plugin, no pod install. The
+ * public surface mirrors `@intercom/intercom-react-native` so swapping the two
+ * is a rename at each call site.
+ */
+import { RepzoWidgetEvents, type EventSubscription, type RepzoWidgetEvent } from './events';
+import type { BootOptions, RepzoWidgetStorageAdapter, WidgetCustomAttributes, WidgetSpaceType, WidgetUser } from './types';
+export { RepzoWidgetProvider } from './ui/WidgetProvider';
+export { Launcher as RepzoWidgetLauncher } from './ui/components/Launcher';
+export { RepzoWidgetEvents } from './events';
+export { RepzoWidgetError } from './api/client';
+export { DEFAULT_BASE_URL } from './types';
+export { useWidgetState } from './state/use-widget-state';
+export type { AgentUiAction, AgentUiBlock, BootOptions, Conversation, Message, OutboundMessage, PreChatField, RepzoWidgetErrorCode, RepzoWidgetStorageAdapter, WidgetAttachment, WidgetConfig, WidgetCustomAttributes, WidgetSpace, WidgetSpaceType, WidgetState, WidgetUser, WidgetView, } from './types';
+export type { EventSubscription, MessageDidArrivePayload, RepzoWidgetEvent, RepzoWidgetEventPayloads, } from './events';
+export type { WidgetTheme } from './ui/styles/theme';
+/** Spaces the widget can open into — the analogue of Intercom's `Space`. */
+export declare enum Space {
+    home = "home",
+    messages = "messages"
+}
+export type RepzoWidgetType = {
+    /**
+     * Start (or resume) a visitor session and connect realtime.
+     * Safe to call repeatedly — a boot for the same widget and user is a no-op,
+     * which matters because `POST /api/widget/init` is rate limited to 10/min.
+     */
+    boot(options: BootOptions): Promise<void>;
+    /**
+     * Drop any identity and start a fresh anonymous session. A previously
+     * identified user is fully signed out first (same as `logout()`).
+     */
+    loginUnidentifiedUser(): Promise<void>;
+    /**
+     * Identify the visitor. Requires `userId` or `email`; conversations started
+     * anonymously on this device move to the identified visitor. If a
+     * *different* identified user's session is stored, it is signed out first
+     * (same as `logout()`) — their conversations never carry over.
+     */
+    loginUserWithUserAttributes(user: WidgetUser): Promise<void>;
+    /**
+     * Attach custom attributes to the visitor's identity so agents see them on
+     * the conversation (max 30 keys, 64-char keys, 512-char values).
+     */
+    updateUser(attributes: WidgetCustomAttributes): Promise<void>;
+    /**
+     * Sign the visitor out — await it in your app's sign-out flow. Revokes the
+     * token server-side and removes the push registration (best-effort, 5s cap
+     * each), wipes every user-scoped key, rotates the anonymous device id,
+     * closes realtime and resets the UI. Nothing re-inits until the next
+     * `boot()` / login call.
+     */
+    logout(): Promise<void>;
+    /** Open the widget on its default space. */
+    present(): Promise<void>;
+    /** Open the widget on a specific space. */
+    presentSpace(space: Space | WidgetSpaceType): Promise<void>;
+    /** Open the widget directly on one conversation. */
+    presentConversation(conversationId: string): Promise<void>;
+    /** Dismiss the widget. */
+    hide(): Promise<void>;
+    /**
+     * Conversations with at least one unread team reply (Intercom's meaning).
+     * A thread stays unread until the visitor opens it — opening the messenger
+     * alone doesn't clear it.
+     */
+    getUnreadConversationCount(): Promise<number>;
+    /**
+     * Unread team replies across all conversations — the same number
+     * `UnreadCountDidChange` carries and the launcher badge shows.
+     */
+    getUnreadMessageCount(): Promise<number>;
+    /** Record an analytics event against the visitor. */
+    logEvent(eventName: string, metadata?: Record<string, unknown>): Promise<void>;
+    /** Switch the active translation locale. */
+    setLocale(locale: string): void;
+    /** Subscribe to `RepzoWidgetEvents.*`. Call `.remove()` on unmount. */
+    addEventListener<E extends RepzoWidgetEvent>(event: E, listener: (payload: any) => void): EventSubscription;
+    /** Key/value store for the device id, unread counts and cached theme. */
+    setStorageAdapter(adapter: RepzoWidgetStorageAdapter | null): void;
+    /**
+     * Keychain/Keystore-backed store for the visitor token and user key (e.g.
+     * `expo-secure-store`, `react-native-keychain` — see README). Without one
+     * they fall back to `setStorageAdapter`'s store. Call before `boot()`.
+     */
+    setSecureStorageAdapter(adapter: RepzoWidgetStorageAdapter | null): void;
+    /**
+     * Manually register an FCM device token for push notifications — the escape
+     * hatch for hosts without `@react-native-firebase/messaging` (with it
+     * installed, `boot({ push: { enabled: true } })` handles everything).
+     */
+    setPushToken(options: {
+        token: string;
+        platform?: 'ios' | 'android';
+        bundleId?: string;
+    }): Promise<void>;
+};
+declare const RepzoWidget: RepzoWidgetType;
+export default RepzoWidget;
+export { RepzoWidgetEvents as Events };
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/index.d.ts.map

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

package/lib/typescript/module/locales.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Translations bundled with the SDK.
+ *
+ * A workspace can still override any key from the dashboard — those win. These
+ * exist so a widget running in a supported language is usable out of the box,
+ * instead of falling back to English for every string an admin has not filled
+ * in by hand.
+ *
+ * Keys mirror `DEFAULT_LABELS` in `./i18n`; `{token}` placeholders must be kept
+ * so word order stays under the translator's control.
+ */
+import type { DEFAULT_LABELS } from './i18n';
+type LabelMap = Partial<Record<keyof typeof DEFAULT_LABELS, string>>;
+export declare const BUNDLED_TRANSLATIONS: Record<string, LabelMap>;
+/** `ar-JO`, `ar_SA` and `AR` all resolve to the `ar` bundle. */
+export declare function baseLanguage(locale?: string | null): string;
+export {};
+//# sourceMappingURL=locales.d.ts.map

package/lib/typescript/module/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/locales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,KAAK,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,OAAO,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AA4DrE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;AAErE,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE3D"}

package/lib/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/module/push/push-notifications.d.ts

@@ -0,0 +1,71 @@
+/**
+ * FCM push notifications — optional.
+ *
+ * Powered by the HOST app's `@react-native-firebase/messaging` native module,
+ * loaded via a dynamic require so the SDK itself stays pure JavaScript. Hosts
+ * without Firebase installed get a warn-once no-op; hosts that can't install
+ * it can still register a token manually through `RepzoWidget.setPushToken()`.
+ *
+ * Supports both RNFB API generations: the modular API (`getMessaging()` etc.,
+ * the only one left in v26+) and the legacy namespaced `messaging()` factory.
+ *
+ * The Workstation channel must have its push provider set to FCM — with
+ * OneSignal selected these registrations are stored but unused.
+ */
+import type { WidgetApiClient } from '../api/client';
+export interface WidgetPushOptions {
+    /** Register this device for FCM pushes after every successful session init. */
+    enabled?: boolean;
+    /**
+     * Ask for notification permission before registering (default true). Set
+     * false when the host app runs its own permission prompt.
+     */
+    requestPermission?: boolean;
+    /**
+     * The app's bundle id / package name. Lets a Workstation channel that serves
+     * several apps pick the matching Firebase key for this device's tokens.
+     * Optional for single-app channels.
+     */
+    bundleId?: string;
+}
+interface ManualToken {
+    token: string;
+    platform?: string;
+    bundleId?: string | null;
+}
+export declare class PushManager {
+    private client;
+    private openConversation;
+    private options;
+    private listenersWired;
+    private lastToken;
+    private manualToken;
+    private warnedMissingModule;
+    /** False while signed out — token refreshes must not register anywhere. */
+    private active;
+    /** Registrations still on the wire; unregister() waits for them. */
+    private inflight;
+    constructor(client: WidgetApiClient, openConversation: (conversationId: string) => void);
+    /** Remember the boot options; actual work happens in start() post-init. */
+    configure(options?: WidgetPushOptions): void;
+    /**
+     * Called after every successful session init — the widget token is valid
+     * from here. Re-running after a login switch re-registers the token under
+     * the new identity (the server upsert moves it).
+     */
+    start(): Promise<void>;
+    /** Host-supplied token for apps without the Firebase module. */
+    setManualToken(manual: ManualToken): Promise<void>;
+    /**
+     * Called by logout with the session's token captured up front: the DELETE
+     * is authenticated with it explicitly and never triggers a re-init.
+     * Waits for an in-flight registration first so its token is not missed.
+     */
+    unregister(authToken: string | null): Promise<void>;
+    private register;
+    private wireTapHandlers;
+    /** Only widget pushes are ours — host app notifications pass through. */
+    private handleTap;
+}
+export {};
+//# sourceMappingURL=push-notifications.d.ts.map

package/lib/typescript/module/push/push-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-notifications.d.ts","sourceRoot":"","sources":["../../../../src/push/push-notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAuDD,qBAAa,WAAW;IAkBpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,gBAAgB;IAlB1B,OAAO,CAAC,OAAO,CAAyB;IAExC,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,WAAW,CAA4B;IAE/C,OAAO,CAAC,mBAAmB,CAAS;IAEpC,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAS;IAEvB,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAA4B;gBAGlC,MAAM,EAAE,eAAe,EACvB,gBAAgB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI;IAG5D,2EAA2E;IAC3E,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB;IAIrC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD5B,gEAAgE;IAC1D,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,eAAe;IAevB,yEAAyE;IACzE,OAAO,CAAC,SAAS;CAQlB"}

package/lib/typescript/module/state/use-widget-state.d.ts

@@ -0,0 +1,10 @@
+/**
+ * React binding for the store. The store lives in the controller singleton, so
+ * the widget keeps its session, SSE stream and unread count even when no
+ * component is mounted; this hook only subscribes to it.
+ */
+import type { WidgetState } from '../types';
+import type { WidgetStore } from './widget-store';
+export declare function useWidgetState(): WidgetState;
+export declare function useWidgetStore(): WidgetStore;
+//# sourceMappingURL=use-widget-state.d.ts.map

package/lib/typescript/module/state/use-widget-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-widget-state.d.ts","sourceRoot":"","sources":["../../../../src/state/use-widget-state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}

package/lib/typescript/module/state/widget-store.d.ts

@@ -0,0 +1,227 @@
+/**
+ * The widget's single source of truth.
+ *
+ * Ported from the web widget's `client/src/widget/hooks/use-widget-state.ts`
+ * plus the routing/tab logic in `client/src/widget/App.tsx`. Unlike the web
+ * version this is a plain store rather than a hook, because the SSE connection
+ * and the unread count must stay alive while the UI is closed — the modal is
+ * only a subscriber.
+ */
+import { WidgetApiClient } from '../api/client';
+import { EventEmitter } from '../events';
+import { PushManager } from '../push/push-notifications';
+import type { AgentUiAction, BootOptions, WidgetAttachment, WidgetCustomAttributes, WidgetSpaceType, WidgetState, WidgetUser, WidgetView } from '../types';
+export declare class WidgetStore {
+    readonly client: WidgetApiClient;
+    readonly events: EventEmitter;
+    readonly push: PushManager;
+    private state;
+    private subscribers;
+    private realtime;
+    private typingTimer;
+    private pendingAgentByConversation;
+    private bootConfig;
+    private bootPromise;
+    /** Identity key of the in-flight boot — a boot for someone else is not deduped. */
+    private bootingUserKey;
+    private currentUser;
+    /** Who the stored token was issued to; null = anonymous. */
+    private currentUserKey;
+    /** True once `currentUserKey` mirrors storage — memory is then authoritative. */
+    private userKeyLoaded;
+    private pendingConversationId;
+    private appStateSubscription;
+    private lastTypingPingAt;
+    private visitorTypingActive;
+    private seenMessageIds;
+    /**
+     * Identity generation. Bumped whenever boot/login/logout is requested; every
+     * async path that writes session state captures it first and bails once it
+     * moved, so a slow init for user A can never land after B logged in or
+     * after logout.
+     */
+    private epoch;
+    /** Serializes identity ops (and 401 re-inits) — one init or wipe at a time. */
+    private identityQueue;
+    /** Shared by concurrent 401s: one re-init, not one per failed request. */
+    private reauthPromise;
+    /** Set by logout(); blocks 401 re-init and realtime until the next boot/login. */
+    private loggedOut;
+    /**
+     * True during wipeSession(). A 401 from a request still on the wire (a push
+     * registration it waits for) must not queue a re-init behind the wipe.
+     */
+    private wiping;
+    /** Set by a terminal 403 — stops realtime and re-init until a successful init. */
+    private terminalErrorCode;
+    private lastStreamReauthAt;
+    /** Queued/running boot, login and logout ops — Retry must not cut in. */
+    private identityOpsInFlight;
+    /**
+     * Bumped whenever a different thread (or a fresh draft) takes the screen.
+     * Message loads capture it and drop their result once it moved, so a slow
+     * response for A never paints under B.
+     */
+    private threadGeneration;
+    /**
+     * The in-flight first send of a draft, which creates its conversation.
+     * Sends from the same draft wait for its id instead of creating another.
+     */
+    private conversationCreation;
+    /** Live events for a thread that may be the one the draft is creating. */
+    private draftEvents;
+    /** False until this stream's first `connected`; later ones are reconnects. */
+    private streamConnectedOnce;
+    /** The stream errored before its first `connected` — that one is a reconnect too. */
+    private streamErrored;
+    private readTimer;
+    private readConversationId;
+    constructor();
+    subscribe: (listener: () => void) => (() => void);
+    getState: () => WidgetState;
+    private setState;
+    private serialize;
+    /** Queue a requested identity op; anything older becomes stale right away. */
+    private enqueueIdentity;
+    private isStale;
+    boot(options: BootOptions): Promise<void>;
+    private userChanged;
+    /**
+     * Init for `user` — or, when undefined, for whoever the stored token
+     * belongs to. The stored token is only resumed when it is anonymous or
+     * already belongs to `user`: resuming another identified user's token would
+     * hand their conversations to this one, so that case signs them out first.
+     */
+    private establishSession;
+    private runInit;
+    /** Every `await` is followed by an epoch check: stale results write nothing. */
+    private initSession;
+    /**
+     * The last config this device received, applied before init returns so the
+     * UI opens with the workspace's real theme instead of the built-in defaults.
+     * Skipped once a fresh config is in state — never downgrades live data.
+     */
+    private seedCachedConfig;
+    private persistConfig;
+    private storedUserKey;
+    /**
+     * Called by the API client after a 401. Single-flight: concurrent 401s share
+     * one re-init. Runs in the identity queue but does not bump the epoch, so it
+     * can't cancel a boot/login queued behind it — and it gives up if one was.
+     */
+    private reauthorize;
+    /** A terminal 403 (`messenger_api_disabled`, `identity_verification_failed`). */
+    private handleTerminalError;
+    loginUnidentifiedUser(): Promise<void>;
+    loginUserWithUserAttributes(user: WidgetUser): Promise<void>;
+    updateUser(attributes: WidgetCustomAttributes): Promise<void>;
+    /**
+     * Signs the visitor out for good — hosts should await this on sign-out.
+     * Synchronously stops realtime, re-init and the UI; then (queued behind any
+     * in-flight init) wipes the session and tells the server.
+     */
+    logout(): Promise<void>;
+    /**
+     * Full local + server sign-out of the stored session, used by logout() and
+     * by a login that switches to a different user. The local wipe runs first,
+     * so nothing of the old user stays readable even if the network hangs;
+     * then the push registration is removed and the token revoked — both
+     * authenticated with the captured token, time-boxed, and never re-initing.
+     * Only the cached channel theme survives (it carries no visitor data).
+     */
+    private wipeSession;
+    private wipeSessionUnguarded;
+    /**
+     * Re-runs the last boot after a failure — wired to the error screen's retry
+     * and to foreground resume. Never rejects: the outcome lands in state.
+     */
+    retry(): Promise<void>;
+    /** Drops every per-thread tracker — the visitor (or their session) changed. */
+    private resetThreadTracking;
+    private requireBootConfig;
+    private connectRealtime;
+    /** The stream got a 401: share the single-flight re-init, then reconnect. */
+    private reauthorizeStream;
+    private watchAppState;
+    private resumeFromBackground;
+    /**
+     * Re-read the config so availability and copy do not go stale. `isOnline` is
+     * otherwise a snapshot from boot, which a long-lived app would keep showing
+     * hours after the team went offline.
+     */
+    private refreshConfig;
+    private handleRealtimeEvent;
+    /**
+     * The thread the visitor is looking at right now — the only one live
+     * messages, typing and events may paint into. The `isOpen` guard matters on
+     * mobile: the widget spends most of its life closed, and a stale
+     * `view === 'chat'` would otherwise swallow the unread increment. A blank
+     * draft matches nothing; its thread is adopted once the first send answers.
+     */
+    private isThreadOnScreen;
+    /**
+     * While a draft's first send is in flight its conversation id is unknown,
+     * and the server may already stream the thread's first reply (or an "agent
+     * joined" event). Events for a thread this device doesn't know are held
+     * until the send answers, then replayed: into the draft if it is that
+     * thread, otherwise as ordinary unread traffic.
+     */
+    private shouldHoldForDraft;
+    private replayDraftEvents;
+    private persistUnread;
+    /** Survives a relaunch so a reply received overnight is still marked unread. */
+    private loadUnread;
+    private clearUnreadFor;
+    private isReplayedMessage;
+    private handleNewMessage;
+    /** Trailing debounce: one read call per burst of live replies. */
+    private scheduleMarkRead;
+    /** Best effort and never re-inits — a missed cursor move only costs a badge. */
+    private flushMarkRead;
+    private cancelMarkRead;
+    private handleConversationEvent;
+    private rememberConversationAgent;
+    private applyConversationAgent;
+    private hydrateConversation;
+    /**
+     * Normalizes attachments from history pages and live payloads alike. Live
+     * payloads may omit `id`/`size`, so the list still gets a stable key.
+     */
+    private hydrateAttachments;
+    private clearTypingTimer;
+    private scheduleTypingClear;
+    private resolveOpenView;
+    present(space?: WidgetSpaceType): void;
+    hide(): void;
+    toggle(space?: WidgetSpaceType): void;
+    setView(view: WidgetView): void;
+    setActiveTab(tab: WidgetSpaceType): void;
+    setLocale(locale: string): void;
+    startNewConversation(prefill?: string): void;
+    setPrefillText(prefill: string): void;
+    dismissOutboundMessage(): void;
+    refreshConversations(): Promise<void>;
+    openConversation(conversationId: string): Promise<void>;
+    loadMoreMessages(): Promise<void>;
+    /**
+     * Re-reads the newest page of the thread on screen and merges in whatever
+     * the stream missed (reconnect, foreground, re-init). Deduped by server id.
+     * Only for a thread actually on screen: the first page also advances the
+     * server read cursor, which must not happen for a thread nobody is reading.
+     */
+    private refreshOpenThread;
+    /** A history page (newest-first) as the oldest-first list the UI renders. */
+    private hydrateMessages;
+    sendMessage(body: string, attachments?: WidgetAttachment[], agentUiAction?: AgentUiAction): Promise<void>;
+    identifyVisitor(data: {
+        email?: string;
+        name?: string;
+        phone?: string;
+    }): Promise<void>;
+    /** Fire-and-forget visitor typing ping, throttled well under the 30/min cap. */
+    notifyTyping(isTyping: boolean): void;
+    track(event: string, metadata?: Record<string, unknown>): void;
+    private loadOutboundMessage;
+    destroy(): void;
+}
+//# sourceMappingURL=widget-store.d.ts.map

package/lib/typescript/module/state/widget-store.d.ts.map

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

package/lib/typescript/module/storage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Storage adapters.
+ *
+ * `Storage` (device id, unread counts, cached theme) resolves: an adapter
+ * injected via `RepzoWidget.setStorageAdapter()`, then
+ * `@react-native-async-storage/async-storage` if the host app installed it,
+ * then an in-memory map. The in-memory fallback keeps the SDK working (the
+ * session just doesn't survive a relaunch) instead of crashing.
+ *
+ * `SecureStorage` (visitor token, user key) uses the adapter injected via
+ * `RepzoWidget.setSecureStorageAdapter()` — Keychain/Keystore backed — and
+ * falls back to `Storage` when the host provided none. AsyncStorage is
+ * plaintext on disk, so the bearer token belongs in the secure one.
+ */
+import type { RepzoWidgetStorageAdapter } from './types';
+export declare const TOKEN_KEY = "repzo_widget_token";
+/** Identity key (email/userId) the stored token was issued to; absent = anonymous. */
+export declare const USER_KEY = "repzo_widget_user_key";
+export declare const DEVICE_ID_KEY = "repzo_widget_device_id";
+export declare const UNREAD_KEY = "repzo_widget_unread";
+/** Last config received — repaints the real theme instantly on relaunch. */
+/**
+ * v2 wraps the config with the channel/baseUrl/platform it came from. v1 held a
+ * bare config that a foreground refresh could overwrite with the web design,
+ * so it's ignored (and cleared) rather than painted.
+ */
+export declare const CONFIG_KEY = "repzo_widget_config_v2";
+export declare const LEGACY_CONFIG_KEY = "repzo_widget_config";
+export declare function setStorageAdapter(adapter: RepzoWidgetStorageAdapter | null): void;
+export declare const Storage: {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+};
+export declare function setSecureStorageAdapter(adapter: RepzoWidgetStorageAdapter | null): void;
+export declare const SecureStorage: {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    /** Clears both stores, so a pre-migration plaintext copy can't linger. */
+    removeItem(key: string): Promise<void>;
+};
+//# sourceMappingURL=storage.d.ts.map

package/lib/typescript/module/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAC9C,sFAAsF;AACtF,eAAO,MAAM,QAAQ,0BAA0B,CAAC;AAChD,eAAO,MAAM,aAAa,2BAA2B,CAAC;AACtD,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAChD,4EAA4E;AAC5E;;;;GAIG;AACH,eAAO,MAAM,UAAU,2BAA2B,CAAC;AACnD,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAyCvD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAEjF;AAED,eAAO,MAAM,OAAO;iBACC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;iBAS/B,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;oBAQlC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7C,CAAC;AAIF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAEvF;AAED,eAAO,MAAM,aAAa;iBACL,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;iBAkB/B,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD,0EAA0E;oBACpD,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAU7C,CAAC"}