@chatlychat/react-native 0.0.0-stage → 0.1.0

package/dist/blocks/types.d.ts

@@ -0,0 +1,171 @@
+/**
+ * The rich-block vocabulary, restated for the published package.
+ *
+ * Mirrors `packages/shared/src/widget-blocks/schema.ts` (which is zod, and
+ * zod is not a dependency of this package) and `types.ts` beside it. The
+ * canonical definition is there; `read-envelope.parity.spec.ts` asserts this
+ * reader accepts and refuses exactly what the shared one does, and
+ * `check-block-renderer-parity.mjs` fails the build if a block type is added
+ * to the schema and not handled here.
+ *
+ * Why not import: `@livechat/shared` is `private: true` — see the note at the
+ * top of `blocks/money.ts`.
+ */
+import type { Money } from './money';
+/** Bumped only on a breaking change to the envelope itself. */
+export declare const BLOCK_PROTOCOL_VERSION = 1;
+/**
+ * What a button does.
+ *
+ * `host_event` is the one the native app exists for: it does nothing here and
+ * is handed to the app's own `onAction`, which is what runs Stripe, opens a
+ * native screen, or adds to a cart with the buyer's real session. See
+ * `ChatlyProviderProps.onAction`.
+ */
+export type WidgetAction = {
+    readonly kind: 'url';
+    readonly label: string;
+    readonly href: string;
+    readonly style?: string;
+} | {
+    readonly kind: 'postback';
+    readonly label: string;
+    readonly value: string;
+    readonly payload?: Record<string, unknown>;
+    readonly silent?: boolean;
+    readonly style?: string;
+} | {
+    readonly kind: 'host_event';
+    readonly label: string;
+    readonly event: string;
+    readonly data?: Record<string, unknown>;
+    readonly id?: string;
+    readonly style?: string;
+} | {
+    readonly kind: 'step';
+    readonly label: string;
+    readonly canvasId: string;
+    readonly params?: Record<string, unknown>;
+    readonly style?: string;
+} | {
+    readonly kind: 'copy';
+    readonly label: string;
+    readonly text: string;
+    readonly style?: string;
+};
+export interface WidgetCard {
+    readonly id?: string;
+    readonly title: string;
+    readonly subtitle?: string;
+    readonly image?: string;
+    readonly badge?: string;
+    readonly price?: Money;
+    readonly fields?: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+    }>;
+    readonly actions?: readonly WidgetAction[];
+}
+export type WidgetBlock = {
+    readonly type: 'text';
+    readonly markdown: string;
+    readonly id?: string;
+} | {
+    readonly type: 'media';
+    readonly kind: 'image' | 'video';
+    readonly url: string;
+    readonly alt: string;
+    readonly id?: string;
+} | {
+    readonly type: 'fields';
+    readonly items: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+    }>;
+    readonly id?: string;
+} | ({
+    readonly type: 'card';
+} & WidgetCard) | {
+    readonly type: 'card_grid';
+    readonly cards: readonly WidgetCard[];
+    readonly layout?: 'grid' | 'carousel';
+    readonly id?: string;
+} | {
+    readonly type: 'actions';
+    readonly actions: readonly WidgetAction[];
+    readonly id?: string;
+} | {
+    readonly type: 'quick_replies';
+    readonly options: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+    }>;
+    readonly id?: string;
+} | {
+    readonly type: 'status';
+    readonly id: string;
+    readonly text: string;
+    readonly state?: 'running' | 'done' | 'failed';
+} | {
+    readonly type: 'divider';
+    readonly id?: string;
+};
+export interface WidgetBlocksEnvelope {
+    readonly v: 1;
+    readonly blocks: readonly WidgetBlock[];
+}
+export type CanvasField = {
+    readonly type: 'text' | 'email' | 'tel' | 'number';
+    readonly name: string;
+    readonly label: string;
+    readonly required?: boolean;
+    readonly placeholder?: string;
+    readonly value?: string;
+} | {
+    readonly type: 'select';
+    readonly name: string;
+    readonly label: string;
+    readonly required?: boolean;
+    readonly options: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+    }>;
+    readonly value?: string;
+} | {
+    readonly type: 'checkbox';
+    readonly name: string;
+    readonly label: string;
+    readonly required?: boolean;
+    readonly value?: boolean;
+};
+export interface CanvasAction {
+    readonly id: string;
+    readonly kind: 'submit' | 'cancel';
+    readonly label: string;
+    readonly style?: 'primary' | 'secondary' | 'danger';
+}
+export interface WidgetCanvas {
+    readonly v: 1;
+    readonly canvasId: string;
+    readonly title?: string;
+    readonly blocks?: readonly WidgetBlock[];
+    readonly fields?: readonly CanvasField[];
+    readonly actions?: readonly CanvasAction[];
+    readonly state?: string;
+    /**
+     * Tier 3 — an integrator's own page in a sandboxed frame.
+     *
+     * Deliberately NOT rendered by this package. A WebView inside a native chat
+     * is the thing the spec asked to avoid ("without a WebView"), and a sandbox
+     * attribute is a browser concept with no React Native equivalent — so an
+     * app frame here would be an iframe's security model re-implemented by
+     * hand. The renderer shows the app's `title` and a note instead, and the
+     * integrator handles it natively if they want it.
+     */
+    readonly app?: {
+        readonly url: string;
+        readonly title?: string;
+        readonly height?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/blocks/types.d.ts.map

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

package/dist/blocks/types.js

@@ -0,0 +1,3 @@
+/** Bumped only on a breaking change to the envelope itself. */
+export const BLOCK_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/blocks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/blocks/types.ts"],"names":[],"mappings":"AAeA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC"}

package/dist/client/RealtimeClient.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Socket.IO-based realtime client. Subscribes to the contact's conversation
+ * channels and re-emits typed `RealtimeEnvelope` events.
+ *
+ * Reconnection + replay is handled by socket.io's built-in backoff; we pass
+ * `lastEventId` on subscribe so the server can replay missed envelopes
+ * (durable-then-deliver, per CLAUDE.md realtime conventions).
+ */
+import type { ChatlyConfig, MessageCreatedPayload, RealtimeEnvelope, RealtimeEventType, SessionState } from './types';
+type Listener<P = unknown> = (envelope: RealtimeEnvelope<P>) => void;
+export declare class RealtimeClient {
+    private socket;
+    private readonly url;
+    private readonly listeners;
+    private lastEventId;
+    private session;
+    private subscribedChannels;
+    constructor(config: ChatlyConfig);
+    connect(session: SessionState, token: string): void;
+    disconnect(): void;
+    subscribe(channels: string[]): void;
+    on<P = unknown>(type: RealtimeEventType, listener: Listener<P>): () => void;
+    onMessageCreated(listener: Listener<MessageCreatedPayload>): () => void;
+    private dispatch;
+    private resubscribe;
+    private sendSubscribe;
+}
+export {};
+//# sourceMappingURL=RealtimeClient.d.ts.map

package/dist/client/RealtimeClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeClient.d.ts","sourceRoot":"","sources":["../../src/client/RealtimeClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,KAAK,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAcrE,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IACzE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,kBAAkB,CAAgB;gBAEvB,MAAM,EAAE,YAAY;IAMhC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAsBnD,UAAU,IAAI,IAAI;IAQlB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAOnC,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAY3E,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM,IAAI;IAI9E,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa;CAatB"}

package/dist/client/RealtimeClient.js

@@ -0,0 +1,113 @@
+/**
+ * Socket.IO-based realtime client. Subscribes to the contact's conversation
+ * channels and re-emits typed `RealtimeEnvelope` events.
+ *
+ * Reconnection + replay is handled by socket.io's built-in backoff; we pass
+ * `lastEventId` on subscribe so the server can replay missed envelopes
+ * (durable-then-deliver, per CLAUDE.md realtime conventions).
+ */
+import { io } from 'socket.io-client';
+/**
+ * Socket.IO channel names, as the gateway actually speaks them.
+ *
+ * Both of these were `'envelope'`, which matches nothing the server does:
+ * `apps/realtime/src/gateway.ts` EMITS on `'event'` and LISTENS on
+ * `'subscribe'`. So this client received nothing and its subscribe frame was
+ * never heard — the whole realtime surface of the React Native SDK was inert,
+ * silently, for every integrator.
+ */
+const INBOUND_EVENT_CHANNEL = 'event';
+const SUBSCRIBE_CHANNEL = 'subscribe';
+export class RealtimeClient {
+    constructor(config) {
+        this.socket = null;
+        this.listeners = new Map();
+        this.lastEventId = null;
+        this.session = null;
+        this.subscribedChannels = [];
+        const host = config.realtimeHost ?? config.apiHost ?? 'api.chatly.com';
+        const scheme = config.secure === false ? 'ws' : 'wss';
+        this.url = `${scheme}://${host}`;
+    }
+    connect(session, token) {
+        if (this.socket !== null) {
+            return;
+        }
+        this.session = session;
+        this.socket = io(this.url, {
+            transports: ['websocket'],
+            auth: { token, workspaceId: session.workspaceId, contactId: session.contactId },
+            reconnection: true,
+            reconnectionDelay: 1000,
+            reconnectionDelayMax: 10000,
+        });
+        this.socket.on('connect', () => {
+            this.resubscribe();
+        });
+        this.socket.on(INBOUND_EVENT_CHANNEL, (raw) => {
+            this.dispatch(raw);
+        });
+    }
+    disconnect() {
+        if (this.socket !== null) {
+            this.socket.removeAllListeners();
+            this.socket.disconnect();
+            this.socket = null;
+        }
+    }
+    subscribe(channels) {
+        this.subscribedChannels = Array.from(new Set([...this.subscribedChannels, ...channels]));
+        if (this.socket?.connected === true) {
+            this.sendSubscribe(channels);
+        }
+    }
+    on(type, listener) {
+        let bucket = this.listeners.get(type);
+        if (bucket === undefined) {
+            bucket = new Set();
+            this.listeners.set(type, bucket);
+        }
+        bucket.add(listener);
+        return () => {
+            bucket?.delete(listener);
+        };
+    }
+    onMessageCreated(listener) {
+        return this.on('message.created', listener);
+    }
+    dispatch(envelope) {
+        if (envelope?.id !== undefined) {
+            this.lastEventId = envelope.id;
+        }
+        const bucket = this.listeners.get(envelope.type);
+        if (bucket !== undefined) {
+            for (const listener of bucket) {
+                try {
+                    listener(envelope);
+                }
+                catch {
+                    // Listener errors must not break the dispatch loop.
+                }
+            }
+        }
+    }
+    resubscribe() {
+        if (this.subscribedChannels.length > 0) {
+            this.sendSubscribe(this.subscribedChannels);
+        }
+    }
+    sendSubscribe(channels) {
+        if (this.socket === null || this.session === null) {
+            return;
+        }
+        // The gateway parses this with `subscribePayloadSchema`, which is the BARE
+        // payload — `{ channels, lastEventId? }`. It was being wrapped in a
+        // RealtimeEnvelope, so even on the right channel the parse would have
+        // failed and answered `validation_failed`.
+        this.socket.emit(SUBSCRIBE_CHANNEL, {
+            channels,
+            ...(this.lastEventId !== null ? { lastEventId: this.lastEventId } : {}),
+        });
+    }
+}
+//# sourceMappingURL=RealtimeClient.js.map

package/dist/client/RealtimeClient.js.map

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

package/dist/client/RealtimeClient.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RealtimeClient.spec.d.ts.map

package/dist/client/RealtimeClient.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeClient.spec.d.ts","sourceRoot":"","sources":["../../src/client/RealtimeClient.spec.ts"],"names":[],"mappings":""}

package/dist/client/RealtimeClient.spec.js

@@ -0,0 +1,123 @@
+/**
+ * The React Native SDK's realtime wire protocol.
+ *
+ * Every channel name here was wrong, so the whole surface was inert — for
+ * every integrator, silently:
+ *
+ *   - it LISTENED on 'envelope'; the gateway EMITS on 'event', so nothing
+ *     ever arrived;
+ *   - it EMITTED subscribe on 'envelope'; the gateway LISTENS on 'subscribe',
+ *     so no subscription was ever registered;
+ *   - it wrapped the subscribe payload in a RealtimeEnvelope; the gateway
+ *     parses the BARE `{ channels, lastEventId? }` with `subscribePayloadSchema`,
+ *     so even on the right channel it would have answered validation_failed.
+ *
+ * Nothing failed loudly. The socket connected, the SDK reported itself
+ * healthy, and no message ever appeared.
+ *
+ * These pin the protocol against the server's own definitions.
+ */
+import { describe, expect, it, vi } from 'vitest';
+const emitted = [];
+const handlers = new Map();
+vi.mock('socket.io-client', () => ({
+    io: () => ({
+        // `subscribe()` gates on `socket.connected`, exactly as socket.io-client
+        // exposes it — a mock without this silently emits nothing.
+        connected: true,
+        on: (channel, fn) => {
+            handlers.set(channel, fn);
+        },
+        emit: (channel, payload) => {
+            emitted.push({ channel, payload });
+        },
+        disconnect: vi.fn(),
+        close: vi.fn(),
+    }),
+}));
+const { RealtimeClient } = await import('./RealtimeClient.js');
+const SESSION = { workspaceId: 'ws-1', contactId: 'c-1' };
+function connected() {
+    emitted.length = 0;
+    handlers.clear();
+    const c = new RealtimeClient({ apiHost: 'api.test' });
+    c.connect(SESSION, 'tok');
+    return c;
+}
+describe('inbound channel', () => {
+    it('listens on the channel the gateway emits — "event"', () => {
+        connected();
+        expect(handlers.has('event')).toBe(true);
+    });
+    it('no longer listens on "envelope", which the server never emits', () => {
+        connected();
+        expect(handlers.has('envelope')).toBe(false);
+    });
+    it('delivers a received envelope to a subscriber', () => {
+        const c = connected();
+        const seen = [];
+        c.on('message.created', (e) => void seen.push(e));
+        handlers.get('event')?.({
+            v: 1,
+            type: 'message.created',
+            id: '01000000-0000-7000-8000-000000000001',
+            ts: Date.now(),
+            workspace_id: 'ws-1',
+            payload: { body: 'hi' },
+        });
+        expect(seen).toHaveLength(1);
+    });
+});
+describe('subscribe frame', () => {
+    it('emits on "subscribe", the channel the gateway listens on', () => {
+        const c = connected();
+        c.subscribe(['conversation:1']);
+        expect(emitted.map((e) => e.channel)).toContain('subscribe');
+    });
+    it('never emits on "envelope"', () => {
+        const c = connected();
+        c.subscribe(['conversation:1']);
+        expect(emitted.map((e) => e.channel)).not.toContain('envelope');
+    });
+    it('sends the BARE payload the server parses, not an envelope', () => {
+        const c = connected();
+        c.subscribe(['conversation:1']);
+        const frame = emitted.find((e) => e.channel === 'subscribe')?.payload;
+        expect(frame['channels']).toEqual(['conversation:1']);
+        // An envelope would carry these; the schema rejects unknown top-level keys.
+        expect(frame['v']).toBeUndefined();
+        expect(frame['type']).toBeUndefined();
+        expect(frame['workspace_id']).toBeUndefined();
+    });
+    it('omits lastEventId until something has actually been received', () => {
+        const c = connected();
+        c.subscribe(['conversation:1']);
+        const frame = emitted.find((e) => e.channel === 'subscribe')?.payload;
+        expect('lastEventId' in frame).toBe(false);
+    });
+    it('replays from the last envelope id once one has arrived', () => {
+        // The cursor must be a real server-issued uuidv7 — the client used to
+        // mint its own id, which the server cannot resolve.
+        const c = connected();
+        const id = '01000000-0000-7000-8000-0000000000ab';
+        handlers.get('event')?.({
+            v: 1,
+            type: 'message.created',
+            id,
+            ts: Date.now(),
+            workspace_id: 'ws-1',
+            payload: {},
+        });
+        c.subscribe(['conversation:1']);
+        const frame = emitted.find((e) => e.channel === 'subscribe')?.payload;
+        expect(frame['lastEventId']).toBe(id);
+    });
+    it('re-subscribes on reconnect', () => {
+        const c = connected();
+        c.subscribe(['conversation:1']);
+        emitted.length = 0;
+        handlers.get('connect')?.(undefined);
+        expect(emitted.filter((e) => e.channel === 'subscribe')).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=RealtimeClient.spec.js.map

package/dist/client/RealtimeClient.spec.js.map

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

package/dist/client/RestClient.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Thin wrapper around the widget REST surface (see `apps/widget/src/client.ts`).
+ *
+ * All write endpoints accept the `publicId` + `visitorToken` in the JSON body.
+ * The visitor token is persisted via `TokenStore` and rotated whenever
+ * `/v1/widget/init` returns a fresh one.
+ */
+import type { Attachment, ChatlyConfig, ChatlyIdentity, ConversationSummary, InitResponse, KbArticle, KbResult, MessageRow, StartResponse } from './types';
+export declare class RestClient {
+    private readonly apiUrl;
+    private readonly publicId;
+    private readonly tokenStore;
+    private readonly identityStore;
+    private tokenCache;
+    /** `undefined` = not yet read from disk; `null` = read, nothing stored. */
+    private identityCache;
+    constructor(config: ChatlyConfig);
+    get baseUrl(): string;
+    getToken(): Promise<string | null>;
+    /**
+     * Forget this device's session entirely. Backs `logout()`.
+     *
+     * Drops the remembered identity too: after a logout, a stale-session
+     * recovery must NOT quietly re-identify as the person who just signed out.
+     */
+    clearToken(): Promise<void>;
+    /** Drop only the session credential, keeping the remembered identity so a
+     *  recovery can replay it. */
+    private dropToken;
+    /**
+     * The identity to replay after the server refuses a stale session.
+     *
+     * Only offered when we hold BOTH an external id and its hash — mirroring
+     * `rememberedIdentity()` in `apps/widget/src/client.ts`. On a channel with
+     * identity verification enabled a claim without a hash is refused, and on a
+     * channel without it a legacy token is still accepted, so an unverifiable
+     * replay could only ever turn one refusal into two. Without both, the SDK
+     * re-inits anonymously and history returns as soon as the host app calls
+     * `identify()` again.
+     */
+    private rememberedIdentity;
+    init(identity?: ChatlyIdentity): Promise<InitResponse>;
+    start(body: string, attachments?: Attachment[]): Promise<StartResponse>;
+    reply(conversationId: string, body: string, attachments?: Attachment[]): Promise<unknown>;
+    /**
+     * A card's `postback` action: a reply the bot reads, optionally invisible.
+     *
+     * `silent` is what makes a filter chip work — the agent hears "under_50"
+     * and the shopper does not see their own tap echoed as a message bubble.
+     * It is a separate method rather than an option on `reply` because the two
+     * differ in whether anything renders.
+     */
+    postback(conversationId: string, input: {
+        value: string;
+        payload?: Record<string, unknown>;
+        silent?: boolean;
+    }): Promise<unknown>;
+    /**
+     * Report what the APP did about a `host_event` card action.
+     *
+     * This is the other half of the one feature a native SDK exists for. A card
+     * saying "Pay $48.20" cannot run Stripe from inside a chat library — the
+     * app does it, with the buyer's real session and a native payment sheet —
+     * and then has to say what happened, or the shopper is left looking at a
+     * card with nothing under it and the bot asks again.
+     *
+     * `text` appends a visible line under the card. `status: 'failed'` with no
+     * text is legitimate: the bot is told, and the shopper sees the card
+     * unchanged rather than an error they can do nothing about.
+     */
+    reportAction(conversationId: string, input: {
+        messageId: string;
+        actionId: string;
+        status: 'done' | 'failed';
+        text?: string;
+        data?: Record<string, unknown>;
+    }): Promise<{
+        blocks: unknown;
+        deliveredMessageId: string;
+    }>;
+    /** A `step` card action: ask for the first step of a flow and post it. */
+    requestCanvasStep(conversationId: string, canvasId: string, params?: Record<string, unknown>): Promise<{
+        messageId: string;
+        canvas: unknown;
+        hostEvent?: unknown;
+    }>;
+    /**
+     * Submit a canvas step.
+     *
+     * `errors` comes back keyed by field name when the server refuses, and the
+     * canvas comes back either way — a refused submission returns the SAME
+     * canvas with messages on it, which is why the renderer replaces what it
+     * holds rather than keeping its own copy.
+     */
+    submitCanvas(conversationId: string, input: {
+        messageId: string;
+        actionId: string;
+        values: Record<string, unknown>;
+    }): Promise<{
+        canvas: unknown;
+        errors: Record<string, string>;
+        hostEvent?: unknown;
+    }>;
+    /**
+     * Uploads raw bytes to the public widget upload endpoint and returns the
+     * persisted [Attachment] reference. The widget surface accepts only JSON,
+     * so the bytes are base64-encoded before transport. The server enforces
+     * the size cap — clients must not pre-check.
+     */
+    uploadAttachment(input: {
+        bytes: Uint8Array;
+        filename: string;
+        mimeType: string;
+    }): Promise<Attachment>;
+    listConversations(limit?: number): Promise<{
+        conversations: ConversationSummary[];
+    }>;
+    listMessages(conversationId: string, limit?: number): Promise<{
+        messages: MessageRow[];
+    }>;
+    searchKb(query: string, limit?: number): Promise<{
+        results: KbResult[];
+    }>;
+    getKbArticle(slug: string): Promise<{
+        article: KbArticle;
+    }>;
+    registerPushToken(input: {
+        platform: 'apns' | 'fcm' | 'web-push';
+        token: string;
+        appVersion?: string;
+    }): Promise<{
+        id: string;
+        created: boolean;
+    }>;
+    /**
+     * @param idempotencyKey minted once per logical call and REUSED on the
+     *   stale-session replay below, so a replayed write coalesces server-side
+     *   instead of double-sending.
+     * @param isRetry set only by `recoverSession`, to bound recovery to a
+     *   single attempt. A second refusal is a real error and is thrown.
+     */
+    private post;
+    /**
+     * The server refused the token in this device's storage. Get a new one and
+     * replay the call, once.
+     *
+     * This is what a mid-session mobile visitor hits on the deploy that closes
+     * the identity-verification bypass: the token in the token store predates
+     * signed visitor sessions, and on a channel with verification enabled it is
+     * refused rather than honoured. Without this the app surfaces one failed
+     * send and only self-heals on the NEXT launch, because the dead token stays
+     * on disk. Handled here rather than surfaced, because from the visitor's
+     * side nothing has gone wrong.
+     *
+     * The dead token is cleared from the token store, not just the in-memory
+     * cache — otherwise the next launch repeats the failure.
+     */
+    private recoverSession;
+}
+//# sourceMappingURL=RestClient.d.ts.map

package/dist/client/RestClient.d.ts.map

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