@chatlychat/react-native 0.0.0-stage → 0.1.1

package/dist/client/RestClient.spec.js

@@ -0,0 +1,267 @@
+/**
+ * Stale-session recovery for the React Native SDK.
+ *
+ * When visitor tokens became signed envelopes, the server began refusing
+ * pre-signature tokens with a 403 carrying `visitor_session_upgrade_required`
+ * (or `visitor_session_invalid`). The browser widget and `@chatlychat/sdk-js`
+ * both recover from that in place; the mobile SDKs did not, so a mid-session
+ * visitor on an IDV-enabled channel got one hard failure and then kept
+ * failing, because the dead token stayed in AsyncStorage across launches.
+ *
+ * These pin the recovery to the widget's exact semantics:
+ *   - only a 403, and only for `visitor_session_*` codes;
+ *   - exactly one retry;
+ *   - the replay re-inits with the REMEMBERED identity, so the contact — and
+ *     therefore the conversation history — comes back;
+ *   - the dead token is replaced in PERSISTENT storage, not just in memory;
+ *   - the Idempotency-Key is stable across the replay.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('react-native', () => ({ Platform: { OS: 'ios' } }));
+/**
+ * The REAL `@react-native-async-storage/async-storage` is used here, not a
+ * stub of `TokenStore`: outside a device its entry point is the web build,
+ * which is a thin shim over `window.localStorage`. Backing that with a Map
+ * exercises the whole persistence path the SDK actually runs — which is the
+ * point, since the bug being fixed is a dead token surviving on DISK.
+ *
+ * `TokenStore` loads the module with `require()`, which vite-node resolves
+ * outside the mock registry, so `vi.mock` on it would not take effect anyway.
+ */
+const store = new Map();
+vi.stubGlobal('window', {
+    localStorage: {
+        getItem: (k) => store.get(k) ?? null,
+        setItem: (k, v) => {
+            store.set(k, v);
+        },
+        removeItem: (k) => {
+            store.delete(k);
+        },
+        clear: () => {
+            store.clear();
+        },
+    },
+});
+import { RestClient } from './RestClient';
+const PUBLIC_ID = 'pub_test';
+const TOKEN_KEY = `chatly:vt:${PUBLIC_ID}`;
+const IDENTITY_KEY = `chatly:id:${PUBLIC_ID}`;
+const calls = [];
+function record(url, init) {
+    const headers = (init.headers ?? {});
+    const call = {
+        path: new URL(url).pathname,
+        body: JSON.parse(String(init.body)),
+        idempotencyKey: headers['idempotency-key'] ?? null,
+    };
+    calls.push(call);
+    return call;
+}
+function json(status, payload) {
+    return new Response(JSON.stringify(payload), {
+        status,
+        headers: { 'content-type': 'application/json' },
+    });
+}
+function initPayload(token) {
+    return {
+        session: {
+            token,
+            contactId: 'c-1',
+            workspaceId: 'w-1',
+            brandId: 'b-1',
+            channelId: 'ch-1',
+        },
+        workspace: { id: 'w-1', name: 'Acme' },
+        branding: {},
+    };
+}
+const IDENTITY = { externalId: 'u-42', userHash: 'deadbeef' };
+function newClient() {
+    return new RestClient({ publicId: PUBLIC_ID, apiHost: 'api.test' });
+}
+/** Puts a (now stale) token and a remembered identity on "disk", exactly as a
+ *  previous app launch would have left them. */
+function seedDisk() {
+    store.set(TOKEN_KEY, 'stale-token');
+    store.set(IDENTITY_KEY, JSON.stringify(IDENTITY));
+}
+beforeEach(() => {
+    calls.length = 0;
+    store.clear();
+});
+describe('RestClient stale-session recovery', () => {
+    it('replays the call once after re-initing with the remembered identity', async () => {
+        seedDisk();
+        let repliesSeen = 0;
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            const call = record(url, init);
+            if (call.path === '/v1/widget/init') {
+                return Promise.resolve(json(200, initPayload('fresh-token')));
+            }
+            repliesSeen += 1;
+            if (repliesSeen === 1) {
+                return Promise.resolve(json(403, { code: 'visitor_session_upgrade_required' }));
+            }
+            return Promise.resolve(json(200, { message: { id: 'm-1' } }));
+        }));
+        const client = newClient();
+        await expect(client.reply('conv-1', 'hello')).resolves.toEqual({ message: { id: 'm-1' } });
+        // Exactly two calls to the original endpoint, one init wedged between.
+        expect(calls.map((c) => c.path)).toEqual([
+            '/v1/widget/messages',
+            '/v1/widget/init',
+            '/v1/widget/messages',
+        ]);
+        // The re-init carried the remembered identity, so the replay lands on the
+        // same contact and the visitor's history survives.
+        expect(calls[1]?.body['identity']).toEqual(IDENTITY);
+        // ...and did NOT re-send the token the server just refused.
+        expect(calls[1]?.body['visitorToken']).toBeUndefined();
+        // The replay used the fresh token.
+        expect(calls[0]?.body['visitorToken']).toBe('stale-token');
+        expect(calls[2]?.body['visitorToken']).toBe('fresh-token');
+        // A replayed write must coalesce server-side, not double-send.
+        expect(calls[2]?.idempotencyKey).toBe(calls[0]?.idempotencyKey);
+        expect(calls[2]?.idempotencyKey).not.toBe(calls[1]?.idempotencyKey);
+        // Persisted, not just cached: the next launch must not repeat the failure.
+        expect(store.get(TOKEN_KEY)).toBe('fresh-token');
+    });
+    it('recovers `visitor_session_invalid` too, not just the upgrade code', async () => {
+        seedDisk();
+        let repliesSeen = 0;
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            const call = record(url, init);
+            if (call.path === '/v1/widget/init') {
+                return Promise.resolve(json(200, initPayload('fresh-token')));
+            }
+            repliesSeen += 1;
+            return repliesSeen === 1
+                ? Promise.resolve(json(403, { code: 'visitor_session_invalid' }))
+                : Promise.resolve(json(200, { ok: true }));
+        }));
+        const client = newClient();
+        await expect(client.reply('conv-1', 'hello')).resolves.toEqual({ ok: true });
+        expect(calls.filter((c) => c.path === '/v1/widget/messages')).toHaveLength(2);
+    });
+    it('re-boots init in place when init itself is refused', async () => {
+        seedDisk();
+        let initsSeen = 0;
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            record(url, init);
+            initsSeen += 1;
+            return initsSeen === 1
+                ? Promise.resolve(json(403, { code: 'visitor_session_invalid' }))
+                : Promise.resolve(json(200, initPayload('fresh-token')));
+        }));
+        const client = newClient();
+        await client.init();
+        expect(calls.map((c) => c.path)).toEqual(['/v1/widget/init', '/v1/widget/init']);
+        expect(calls[0]?.body['visitorToken']).toBe('stale-token');
+        expect(calls[1]?.body['visitorToken']).toBeUndefined();
+        expect(calls[1]?.body['identity']).toEqual(IDENTITY);
+        expect(store.get(TOKEN_KEY)).toBe('fresh-token');
+    });
+    it('does NOT retry a 403 with an unrelated code', async () => {
+        seedDisk();
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            record(url, init);
+            return Promise.resolve(json(403, { code: 'widget_origin_not_allowed' }));
+        }));
+        const client = newClient();
+        await expect(client.reply('conv-1', 'hello')).rejects.toThrow(/403/);
+        // One attempt, no init: retrying an origin refusal just fails again.
+        expect(calls.map((c) => c.path)).toEqual(['/v1/widget/messages']);
+        // The token was NOT thrown away — it was never the problem.
+        expect(store.get(TOKEN_KEY)).toBe('stale-token');
+    });
+    it('gives up after exactly one retry when the replay is refused too', async () => {
+        seedDisk();
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            const call = record(url, init);
+            return call.path === '/v1/widget/init'
+                ? Promise.resolve(json(200, initPayload('fresh-token')))
+                : Promise.resolve(json(403, { code: 'visitor_session_invalid' }));
+        }));
+        const client = newClient();
+        await expect(client.reply('conv-1', 'hello')).rejects.toThrow(/403/);
+        expect(calls.filter((c) => c.path === '/v1/widget/messages')).toHaveLength(2);
+    });
+    it('does not retry a non-403 failure', async () => {
+        seedDisk();
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            record(url, init);
+            return Promise.resolve(json(500, { code: 'visitor_session_invalid' }));
+        }));
+        const client = newClient();
+        await expect(client.reply('conv-1', 'hello')).rejects.toThrow(/500/);
+        expect(calls).toHaveLength(1);
+    });
+    it('persists the identity only after the server accepts it', async () => {
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            record(url, init);
+            return Promise.resolve(json(200, initPayload('fresh-token')));
+        }));
+        const client = newClient();
+        expect(store.get(IDENTITY_KEY)).toBeUndefined();
+        await client.init(IDENTITY);
+        expect(JSON.parse(store.get(IDENTITY_KEY) ?? 'null')).toEqual(IDENTITY);
+    });
+    it('forgets the remembered identity on clearToken, so logout cannot be undone by a recovery', async () => {
+        seedDisk();
+        const client = newClient();
+        await client.clearToken();
+        expect(store.get(TOKEN_KEY)).toBeUndefined();
+        expect(store.get(IDENTITY_KEY)).toBeUndefined();
+    });
+});
+/**
+ * The envelope the API really sends.
+ *
+ * Every fixture above uses `{ code }` at the top level, and the API has never
+ * sent that: `app-exception.filter.ts` ends with `send({ error: body })`. So
+ * `isStaleSession` read `undefined`, returned false every time, and the
+ * recovery this whole file is about never fired in production — the suite was
+ * green because the fixtures agreed with the bug rather than with the server.
+ *
+ * Third place with the identical defect: the browser widget, `sdk-js`, and
+ * here. Each was written by reading the previous one, which is how a bug
+ * travels between SDKs that look independent.
+ */
+describe('the real error envelope', () => {
+    it('recovers a stale session from a NESTED 403', async () => {
+        seedDisk();
+        let repliesSeen = 0;
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            const call = record(url, init);
+            if (call.path === '/v1/widget/init') {
+                return Promise.resolve(json(200, initPayload('fresh-token')));
+            }
+            repliesSeen += 1;
+            if (repliesSeen === 1) {
+                return Promise.resolve(json(403, { error: { code: 'visitor_session_upgrade_required', message: 'stale' } }));
+            }
+            return Promise.resolve(json(200, { ok: true }));
+        }));
+        await newClient().listConversations();
+        // Refused once, re-initialised with the remembered identity, replayed.
+        expect(calls.filter((c) => c.path === '/v1/widget/conversations/list')).toHaveLength(2);
+        expect(calls.some((c) => c.path === '/v1/widget/init')).toBe(true);
+    });
+    it('still does NOT retry a nested non-session 403', async () => {
+        // An origin refusal fails identically on a retry; retrying is just
+        // slower. Reading the nested code must not make every 403 recoverable.
+        seedDisk();
+        vi.stubGlobal('fetch', vi.fn((url, init) => {
+            const call = record(url, init);
+            if (call.path === '/v1/widget/init') {
+                return Promise.resolve(json(200, initPayload('fresh-token')));
+            }
+            return Promise.resolve(json(403, { error: { code: 'forbidden', message: 'nope' } }));
+        }));
+        await expect(newClient().listConversations()).rejects.toThrow();
+        expect(calls.filter((c) => c.path === '/v1/widget/conversations/list')).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=RestClient.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RestClient.spec.js","sourceRoot":"","sources":["../../src/client/RestClient.spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9D,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;IACtB,YAAY,EAAE;QACZ,OAAO,EAAE,CAAC,CAAS,EAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI;QAC3D,OAAO,EAAE,CAAC,CAAS,EAAE,CAAS,EAAQ,EAAE;YACtC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,UAAU,EAAE,CAAC,CAAS,EAAQ,EAAE;YAC9B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,EAAE,GAAS,EAAE;YAChB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF;CACF,CAAC,CAAC;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,MAAM,SAAS,GAAG,UAAU,CAAC;AAC7B,MAAM,SAAS,GAAG,aAAa,SAAS,EAAE,CAAC;AAC3C,MAAM,YAAY,GAAG,aAAa,SAAS,EAAE,CAAC;AAQ9C,MAAM,KAAK,GAAW,EAAE,CAAC;AAEzB,SAAS,MAAM,CAAC,GAAW,EAAE,IAAiB;IAC5C,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAA2B,CAAC;IAC/D,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ;QAC3B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAA4B;QAC9D,cAAc,EAAE,OAAO,CAAC,iBAAiB,CAAC,IAAI,IAAI;KACnD,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,IAAI,CAAC,MAAc,EAAE,OAAgB;IAC5C,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;QAC3C,MAAM;QACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO;QACL,OAAO,EAAE;YACP,KAAK;YACL,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,KAAK;YAClB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,MAAM;SAClB;QACD,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;QACtC,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAmB,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAE9E,SAAS,SAAS;IAChB,OAAO,IAAI,UAAU,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;gDACgD;AAChD,SAAS,QAAQ;IACf,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACpC,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACjB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,QAAQ,EAAE,CAAC;QACX,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACpC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,WAAW,IAAI,CAAC,CAAC;YACjB,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,kCAAkC,EAAE,CAAC,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAE3F,uEAAuE;QACvE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,qBAAqB;YACrB,iBAAiB;YACjB,qBAAqB;SACtB,CAAC,CAAC;QAEH,0EAA0E;QAC1E,mDAAmD;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrD,4DAA4D;QAC5D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAEvD,mCAAmC;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE3D,+DAA+D;QAC/D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAEpE,2EAA2E;QAC3E,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,QAAQ,EAAE,CAAC;QACX,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACpC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,WAAW,IAAI,CAAC,CAAC;YACjB,OAAO,WAAW,KAAK,CAAC;gBACtB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC;gBACjE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,QAAQ,EAAE,CAAC;QACX,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClB,SAAS,IAAI,CAAC,CAAC;YACf,OAAO,SAAS,KAAK,CAAC;gBACpB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC;gBACjE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACjF,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,QAAQ,EAAE,CAAC;QACX,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAErE,qEAAqE;QACrE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAClE,4DAA4D;QAC5D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,QAAQ,EAAE,CAAC;QACX,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC,IAAI,KAAK,iBAAiB;gBACpC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;gBACxD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,QAAQ,EAAE,CAAC;QACX,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAC;QACzE,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAChD,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;QACvG,QAAQ,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,QAAQ,EAAE,CAAC;QACX,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACpC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,WAAW,IAAI,CAAC,CAAC;YACjB,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,OAAO,CAAC,OAAO,CACpB,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,kCAAkC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CACrF,CAAC;YACJ,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CACH,CAAC;QACF,MAAM,SAAS,EAAE,CAAC,iBAAiB,EAAE,CAAC;QACtC,uEAAuE;QACvE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,+BAA+B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,mEAAmE;QACnE,uEAAuE;QACvE,QAAQ,EAAE,CAAC;QACX,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,IAAiB,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACpC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC,CAAC,CACH,CAAC;QACF,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,+BAA+B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Wire types shared between the REST + realtime clients and the React layer.
+ *
+ * These mirror the server-side widget contract in `apps/widget/src/client.ts`
+ * and the realtime envelope in `packages/shared/src/realtime/index.ts`. We do
+ * not import from those packages directly to keep the published SDK free of
+ * workspace-internal dependencies.
+ */
+export interface ChatlyConfig {
+    /** Public workspace identifier, e.g. `pub_abc123`. */
+    publicId: string;
+    /** API host (no scheme). Defaults to `api.chatly.com`. */
+    apiHost?: string;
+    /** Override the realtime host. Defaults to the apiHost. */
+    realtimeHost?: string;
+    /** When false, the SDK uses `http://`/`ws://` instead of TLS. Defaults to true. */
+    secure?: boolean;
+}
+export interface ChatlyIdentity {
+    externalId: string;
+    email?: string;
+    name?: string;
+    /** HMAC-SHA256 of the externalId using the workspace identity secret. */
+    userHash?: string;
+    attributes?: Record<string, unknown>;
+}
+export interface SessionState {
+    token: string;
+    contactId: string;
+    workspaceId: string;
+    brandId: string;
+    channelId: string;
+}
+export interface InitResponse {
+    session: SessionState;
+    workspace: {
+        id: string;
+        name: string;
+    };
+    branding: Record<string, unknown>;
+}
+export interface StartResponse {
+    conversation: {
+        id: string;
+    };
+    message: {
+        id: string;
+        body: string;
+        createdAt: string;
+    };
+}
+export type ConversationStatus = 'open' | 'snoozed' | 'closed' | 'pending';
+export interface ConversationSummary {
+    id: string;
+    status: ConversationStatus;
+    subject: string | null;
+    lastMessagePreview: string | null;
+    lastMessageAt: string | null;
+    unreadContactCount: number;
+    createdAt: string;
+}
+export type MessageAuthor = 'contact' | 'agent' | 'bot' | 'system';
+export type MessageKind = 'text' | 'image' | 'file' | 'attachment_only' | 'event' | 'internal_note';
+/**
+ * One file or image attached to a message. Produced by `POST /v1/widget/uploads`
+ * and echoed back on every message payload that carries the attachment.
+ *
+ * Wire format is identical across all 4 mobile SDKs — the SDK renders
+ * `image/*` mime types as inline thumbnails and anything else as a file row.
+ */
+export interface Attachment {
+    id: string;
+    url: string;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+}
+export interface MessageRow {
+    id: string;
+    authorType: MessageAuthor;
+    kind: MessageKind;
+    body: string;
+    attachments?: Attachment[];
+    createdAt: string;
+    /**
+     * Rich blocks — cards, a carousel, quick replies, a status line.
+     *
+     * `unknown` on purpose, and validated by `readBlocksEnvelope` at render
+     * time rather than typed here. The row comes off the wire: a server newer
+     * than this app sends block types it does not know, and a row written
+     * before a field was validated must produce the most of the message that
+     * CAN be drawn rather than a type error. A declared shape here would be a
+     * claim about a payload this package does not control.
+     *
+     * Absent until `blocks` was added to the message surface, so `undefined`
+     * and `null` both mean "plain text".
+     */
+    blocks?: unknown;
+    /** A Tier 2 canvas — a form inside the bubble. `unknown` for the same reason. */
+    canvas?: unknown;
+}
+export interface KbResult {
+    id: string;
+    slug: string;
+    title: string;
+    excerpt: string;
+}
+export interface KbArticle {
+    id: string;
+    slug: string;
+    title: string;
+    body: string;
+    bodyHtml: string | null;
+    updatedAt: string;
+}
+/**
+ * Realtime envelope. Keep in lockstep with
+ * `packages/shared/src/realtime/index.ts` (protocol version 1).
+ */
+export declare const REALTIME_PROTOCOL_VERSION = 1;
+export type RealtimeEventType = 'session.connected' | 'session.disconnected' | 'session.ping' | 'session.pong' | 'session.error' | 'subscribe' | 'unsubscribe' | 'replay.completed' | 'presence.online' | 'presence.offline' | 'presence.away' | 'conversation.created' | 'conversation.updated' | 'conversation.assigned' | 'conversation.closed' | 'conversation.reopened' | 'message.created' | 'message.updated' | 'message.deleted' | 'message.read' | 'message.delivered' | 'typing.start' | 'typing.stop' | 'visitor.identified' | 'visitor.page_view' | 'trigger.fired' | 'ai.copilot.suggestion' | 'ai.agent.message';
+export interface RealtimeEnvelope<P = unknown> {
+    v: typeof REALTIME_PROTOCOL_VERSION;
+    type: RealtimeEventType;
+    id: string;
+    ts: number;
+    workspace_id: string;
+    payload: P;
+}
+export interface MessageCreatedPayload {
+    id: string;
+    conversationId: string;
+    authorType: MessageAuthor;
+    authorId: string | null;
+    body: string;
+    attachments: unknown[];
+    createdAt: string;
+}
+export type PushPlatform = 'ios' | 'android' | 'expo';
+export interface PushTokenRegistration {
+    platform: PushPlatform;
+    token: string;
+    /** Bundle identifier or app id; helpful for multi-app workspaces. */
+    bundleId?: string;
+    /** Client app version (e.g. '1.4.2'); included in the registration record. */
+    appVersion?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/client/types.js

@@ -0,0 +1,14 @@
+/**
+ * Wire types shared between the REST + realtime clients and the React layer.
+ *
+ * These mirror the server-side widget contract in `apps/widget/src/client.ts`
+ * and the realtime envelope in `packages/shared/src/realtime/index.ts`. We do
+ * not import from those packages directly to keep the published SDK free of
+ * workspace-internal dependencies.
+ */
+/**
+ * Realtime envelope. Keep in lockstep with
+ * `packages/shared/src/realtime/index.ts` (protocol version 1).
+ */
+export const REALTIME_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgHH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC"}

package/dist/components/Composer.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+export interface ComposerProps {
+    conversationId: string | null;
+    /**
+     * Called after a message is successfully sent. When `conversationId` is
+     * null, the composer starts a new conversation and the returned id is
+     * delivered here.
+     */
+    onSent?: (conversationId: string) => void;
+    placeholder?: string;
+}
+/**
+ * Bottom composer with a paperclip attachment button, multi-line text input,
+ * and a send button.
+ *
+ * Attachment picking depends on a document-picker module being available at
+ * runtime. We do NOT take a hard dependency on any picker package — instead
+ * the picker is resolved lazily via `globalThis.__chatlyPicker`. Hosts that
+ * want native attachment picking install one of:
+ *   - `expo-document-picker`
+ *   - `@react-native-documents/picker`
+ *   - `react-native-document-picker`
+ * and assign a small shim that returns `{ bytes, filename, mimeType }`. When
+ * no picker is present the button degrades gracefully (still visible, but
+ * surfaces a "Pick disabled" hint).
+ */
+declare global {
+    var __chatlyPicker: (() => Promise<{
+        bytes: Uint8Array;
+        filename: string;
+        mimeType: string;
+    } | null>) | undefined;
+}
+export declare function Composer({ conversationId, onSent, placeholder, }: ComposerProps): React.JSX.Element;
+//# sourceMappingURL=Composer.d.ts.map

package/dist/components/Composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Composer.d.ts","sourceRoot":"","sources":["../../src/components/Composer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAexC,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,cAAc,EACd,CAAC,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC,GACjF,SAAS,CAAC;CACf;AAED,wBAAgB,QAAQ,CAAC,EACvB,cAAc,EACd,MAAM,EACN,WAA+B,GAChC,EAAE,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAgOnC"}