@chatlychat/sdk-js 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,501 @@
+/**
+ * Browser SDK. Pairs with the widget loader to give product code a way to
+ * identify visitors, fire CDP events, and control the widget.
+ *
+ *   import { Chatly } from '@chatlychat/sdk-js';
+ *   const lc = Chatly.init({ publicId: 'acme-web', apiUrl: 'https://api.acme.com' });
+ *   await lc.identify({ email: 'a@b.com', name: 'Alice' });
+ *   await lc.track('signup_completed', { plan: 'pro' });
+ *   lc.open();
+ */
+import { createTypingTracker, newMessagesSince, typingActorOf } from './live.js';
+export { TYPING_STOP_AFTER_MS } from './live.js';
+export class Chatly {
+    opts;
+    base;
+    visitorToken;
+    /**
+     * The realtime host `/v1/widget/init` reported, remembered for `subscribe`.
+     *
+     * `/v1/widget/realtime/token` returns `{ token, expiresAt }` and NO url —
+     * the first version of `subscribe` read a `url` off it and silently fell
+     * back to the API host, which is not where the socket server is.
+     */
+    realtimeUrl = null;
+    /**
+     * This visitor's contact id, remembered for the typing event — the realtime
+     * gateway's payload requires an `actorId` and the visitor's is their contact.
+     */
+    contactId = null;
+    static init(opts) {
+        return new Chatly(opts);
+    }
+    constructor(opts) {
+        this.opts = opts;
+        /*
+         * Production, not a dev hostname.
+         *
+         * This was `https://api.livechat.local`, which resolves nowhere — so a
+         * developer who followed the published docs and omitted `apiUrl` got an
+         * SDK whose every call failed, and the docs page carried a warning
+         * telling each reader to override it. Reported by a customer who
+         * integrated from the docs alone, not caught here, because every test in
+         * this package passes an explicit `apiUrl`.
+         *
+         * A self-hosted install still overrides it; that is the only caller that
+         * ever should.
+         */
+        this.base = opts.apiUrl ?? 'https://api.chatlychat.com';
+        // Storage key deliberately left as `livechat:` — the internal scope name.
+        // Renaming it would orphan the visitor token of every browser that has
+        // one, silently signing those visitors out of their own conversation.
+        // Cosmetics are not worth that; the customer-visible strings are what
+        // matter and those say Chatly.
+        this.visitorToken = localStorage.getItem(`livechat:vt:${opts.publicId}`);
+    }
+    open() {
+        window.Chatly?.open?.();
+    }
+    close() {
+        window.Chatly?.close?.();
+    }
+    /**
+     * Attach a known identity to this visitor.
+     *
+     * Re-initialises the session with an `identity` payload rather than calling
+     * a dedicated endpoint. There has never been a `/v1/widget/identify` route —
+     * this method has 404'd since it was written, as have the Kotlin and Swift
+     * equivalents. Identity is accepted by `init`, which is also where the
+     * `userHash` check for verified identity lives, so routing through it means
+     * identification and verification cannot drift apart.
+     *
+     * `identify({ email })` with no `externalId` — the exact call this file's
+     * own header comment demonstrates — used to be rejected by the server with
+     * a 400, because `widgetInitSchema` required `externalId`. It no longer is;
+     * an email-only identity attaches a reply address to whoever this browser
+     * already is. It cannot be *verified*, though: `userHash` binds the external
+     * id and there is nothing to bind without one.
+     *
+     * No longer mints an anonymous session first. That cost a round trip, and
+     * worse, it was pointless: the token the server returns HERE is the
+     * identified one, and it is stored below. Before, the SDK kept the
+     * anonymous token it had just fetched, so every later `track` or `send`
+     * spoke for the anonymous visitor and the identification was quietly lost.
+     */
+    async identify(input) {
+        const res = await this.request('/v1/widget/init', {
+            publicId: this.opts.publicId,
+            ...(this.visitorToken === null ? {} : { visitorToken: this.visitorToken }),
+            identity: input,
+        });
+        const body = (await res.json());
+        if (typeof body.realtimeUrl === 'string' && body.realtimeUrl.length > 0) {
+            this.realtimeUrl = body.realtimeUrl;
+        }
+        // The session token is now an opaque server-issued credential rather than
+        // the external id, and `init` rotates it on every call — so it has to be
+        // taken from the response, not assumed to be unchanged.
+        const token = body.session?.token;
+        if (typeof token === 'string' && token.length > 0) {
+            this.setVisitorToken(token);
+        }
+        const contactId = body.session?.contactId ?? '';
+        if (contactId.length > 0) {
+            /*
+             * Remembered here as well as in `ensureVisitorToken`, because `identify`
+             * can be the FIRST call a session makes and `ensureVisitorToken` returns
+             * early when a token is already in localStorage. A returning browser
+             * therefore never learned its own contact id, and `setTyping` sent
+             * `actorId: 'unknown'` — which the realtime gateway now overwrites from
+             * the JWT anyway, but a field we can fill correctly should not be a
+             * placeholder.
+             */
+            this.contactId = contactId;
+        }
+        return { contactId };
+    }
+    /**
+     * Upload a file as this visitor and return the attachment record.
+     *
+     * The two-step presign + direct PUT is deliberate: the file never passes
+     * through the API, which would mean proxying it in memory only to write it
+     * to object storage anyway.
+     */
+    async uploadFile(file) {
+        await this.ensureVisitorToken();
+        const res = await this.request('/v1/widget/uploads/presign', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            filename: file.name,
+            contentType: file.type || 'application/octet-stream',
+            sizeBytes: file.size,
+        });
+        const presigned = (await res.json());
+        const put = await fetch(presigned.url, {
+            method: presigned.method,
+            headers: presigned.headers,
+            body: file,
+        });
+        if (!put.ok) {
+            throw new Error(`Upload failed (${put.status})`);
+        }
+        return {
+            id: presigned.uploadId,
+            filename: file.name,
+            mimeType: file.type || 'application/octet-stream',
+            sizeBytes: file.size,
+            url: presigned.publicUrl,
+        };
+    }
+    /** Send a message, optionally with attachments from `uploadFile`. */
+    async send(conversationId, body, attachments = []) {
+        await this.ensureVisitorToken();
+        await this.request('/v1/widget/messages', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            conversationId,
+            body,
+            attachments,
+        });
+    }
+    // ── Headless: read ────────────────────────────────────────────────────
+    //
+    // Everything below exists so a consumer can build their OWN chat UI. Before
+    // it, the SDK could `send` into a conversation but could not create one,
+    // list threads, read history or learn that a reply had arrived — so it was a
+    // companion to the widget, not a client you could render from.
+    /**
+     * This visitor's own conversations, most recent first.
+     *
+     * Scoped by the visitor token, so it is exactly the threads this browser is
+     * entitled to and never anyone else's.
+     */
+    async listConversations(limit = 20) {
+        await this.ensureVisitorToken();
+        const res = await this.request('/v1/widget/conversations/list', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            limit,
+        });
+        const body = (await res.json());
+        return body.conversations ?? [];
+    }
+    /** The messages of one conversation, oldest first. */
+    async listMessages(conversationId, limit = 50) {
+        await this.ensureVisitorToken();
+        const res = await this.request('/v1/widget/messages/list', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            conversationId,
+            limit,
+        });
+        const body = (await res.json());
+        return body.messages ?? [];
+    }
+    // ── Headless: write ───────────────────────────────────────────────────
+    /**
+     * Open a NEW conversation with a first message.
+     *
+     * `send` replies to one that exists and requires a `conversationId`; this is
+     * the other endpoint. Getting them the wrong way round is a 400 complaining
+     * about a missing `conversationId`, which is how the repo's own E2E spec was
+     * written and why it could never pass.
+     */
+    async startConversation(body, attachments = []) {
+        await this.ensureVisitorToken();
+        const res = await this.request('/v1/widget/conversations', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            body,
+            attachments,
+        });
+        const parsed = (await res.json());
+        return { conversationId: parsed.conversation?.id ?? '' };
+    }
+    // ── Headless: live ────────────────────────────────────────────────────
+    /**
+     * Call `onMessage` for every message this subscription has not already
+     * given you. Returns the unsubscribe function.
+     *
+     * **Polling by default**, because the alternative is making every consumer
+     * ship `socket.io-client` whether they want push or not. Pass your own
+     * factory for push:
+     *
+     *     import { io } from 'socket.io-client';
+     *     const stop = chatly.subscribe(id, { onMessage }, { io });
+     *
+     * Errors go to `onError`, never a rejected promise: this is long-lived, and
+     * a rejection nobody awaits is an unhandled rejection on the customer's own
+     * page.
+     */
+    subscribe(conversationId, handlers, options = {}) {
+        const seen = new Set();
+        let stopped = false;
+        /** Set once the push socket is up; null on the polling path. */
+        let live = null;
+        let warnedAboutTyping = false;
+        /*
+         * Receiving typing needs the same transport as sending it, and for the
+         * same reason: there is no HTTP route. A consumer who asked for
+         * `onTyping` on the polling path has asked for something the transport
+         * cannot carry, so say it once at subscribe time — the alternative is an
+         * agent typing visibly in the dashboard and nothing happening here, with
+         * nothing to search for.
+         */
+        if (handlers.onTyping !== undefined && options.io === undefined) {
+            console.warn('[Chatly] onTyping needs the push path — pass `io` to subscribe(). ' +
+                'Typing is a socket event and has no HTTP route, so a polling ' +
+                'subscription never receives one.');
+        }
+        const typing = createTypingTracker({
+            onChange: (signal) => handlers.onTyping?.(signal),
+        });
+        const setTyping = (isTyping) => {
+            if (live === null) {
+                if (!warnedAboutTyping) {
+                    warnedAboutTyping = true;
+                    console.warn('[Chatly] setTyping needs the push path — pass `io` to subscribe(). ' +
+                        'Typing is a socket event and has no HTTP route.');
+                }
+                return;
+            }
+            live.emit(isTyping ? 'typing.start' : 'typing.stop', {
+                conversationId,
+                actorType: 'contact',
+                // The gateway's payload requires a non-empty actorId. `unknown` rather
+                // than an empty string, which its schema rejects outright.
+                actorId: this.contactId ?? 'unknown',
+            });
+        };
+        const deliver = (batch) => {
+            for (const message of newMessagesSince(seen, batch)) {
+                handlers.onMessage?.(message);
+            }
+        };
+        const poll = async () => {
+            if (stopped) {
+                return;
+            }
+            try {
+                deliver(await this.listMessages(conversationId));
+            }
+            catch (err) {
+                handlers.onError?.(err);
+            }
+        };
+        // The first batch is the history, which is also how a consumer gets the
+        // existing thread without a separate call.
+        void poll();
+        if (options.io === undefined) {
+            // Floored: a one-second poll on a long conversation is a request every
+            // second per open tab, and the endpoint is not a stream.
+            const interval = Math.max(2_000, options.intervalMs ?? 6_000);
+            const timer = setInterval(() => void poll(), interval);
+            return Object.assign(() => {
+                stopped = true;
+                clearInterval(timer);
+                // Nothing can have started the tracker on this path — but a
+                // teardown that only cleans up the branch it remembers is how a
+                // timer outlives its subscription.
+                typing.dispose();
+            }, { setTyping });
+        }
+        let socket = null;
+        // Captured before the async gap so the narrowing holds without an
+        // assertion: `options` is readonly, but the checker cannot know that
+        // across an await.
+        const makeSocket = options.io;
+        void (async () => {
+            try {
+                await this.ensureVisitorToken();
+                const res = await this.request('/v1/widget/realtime/token', {
+                    publicId: this.opts.publicId,
+                    visitorToken: this.visitorToken,
+                    conversationId,
+                });
+                const { token } = (await res.json());
+                const host = this.opts.realtimeUrl ?? this.realtimeUrl;
+                if (stopped || typeof token !== 'string' || host === null || host === undefined) {
+                    /*
+                     * No host means no socket. Reported rather than silently falling
+                     * back, because a consumer who passed `io` asked for push and a
+                     * quiet downgrade to polling would look like push that is slow.
+                     */
+                    handlers.onError?.(new Error('chatly: no realtime host — set `realtimeUrl` in init options'));
+                    return;
+                }
+                const made = makeSocket(host, {
+                    path: '/socket.io',
+                    transports: ['websocket'],
+                    auth: { token, kind: 'visitor' },
+                });
+                socket = made;
+                live = made;
+                made.on('event', (raw) => {
+                    const envelope = raw;
+                    if (envelope?.type === 'message.created' && envelope.payload !== undefined) {
+                        deliver([envelope.payload]);
+                        /*
+                         * A reply has arrived, so whoever was typing has stopped — the
+                         * dashboard sends `typing.stop` on send, but the message and the
+                         * stop are two envelopes and the message usually wins the race.
+                         * Without this the indicator sits under the message that was
+                         * being typed, for the length of the timeout.
+                         */
+                        typing.stop();
+                        return;
+                    }
+                    if (envelope?.type === 'typing.start' || envelope?.type === 'typing.stop') {
+                        const actor = typingActorOf(envelope.payload);
+                        if (actor === null) {
+                            return;
+                        }
+                        if (envelope.type === 'typing.start') {
+                            typing.start(actor);
+                        }
+                        else {
+                            typing.stop(actor);
+                        }
+                    }
+                });
+            }
+            catch (err) {
+                /*
+                 * Push could not be set up. Fall back to polling rather than leaving
+                 * the consumer with a subscription that silently never fires — the
+                 * same choice the widget makes when its realtime chunk cannot load.
+                 */
+                handlers.onError?.(err);
+                if (!stopped) {
+                    const timer = setInterval(() => void poll(), 6_000);
+                    socket = { disconnect: () => clearInterval(timer) };
+                }
+            }
+        })();
+        return Object.assign(() => {
+            stopped = true;
+            live = null;
+            typing.dispose();
+            socket?.disconnect();
+        }, { setTyping });
+    }
+    /** Submit a post-chat satisfaction score (1-5, or 0-10 for NPS). */
+    async rate(conversationId, score, comment) {
+        await this.ensureVisitorToken();
+        await this.request('/v1/widget/csat', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            conversationId,
+            score,
+            ...(comment === undefined ? {} : { comment }),
+        });
+    }
+    /** Email this visitor a transcript of their conversation. */
+    async emailTranscript(conversationId, email) {
+        await this.ensureVisitorToken();
+        await this.request('/v1/widget/transcript', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            conversationId,
+            email,
+        });
+    }
+    async track(name, properties) {
+        await this.ensureVisitorToken();
+        await this.request('/v1/widget/events', {
+            publicId: this.opts.publicId,
+            visitorToken: this.visitorToken,
+            name,
+            properties: properties ?? {},
+        });
+    }
+    setVisitorToken(token) {
+        this.visitorToken = token;
+        localStorage.setItem(`livechat:vt:${this.opts.publicId}`, token);
+    }
+    async ensureVisitorToken() {
+        if (this.visitorToken !== null) {
+            return;
+        }
+        const res = await this.request('/v1/widget/init', { publicId: this.opts.publicId });
+        const body = (await res.json());
+        this.setVisitorToken(body.session.token);
+        if (typeof body.session.contactId === 'string' && body.session.contactId.length > 0) {
+            this.contactId = body.session.contactId;
+        }
+        /*
+         * The realtime host is reported here as well as by `identify`, and this is
+         * the path `subscribe` bootstraps through — an anonymous visitor never
+         * calls `identify`. Captured in both, because either can be the first
+         * init a session ever makes.
+         */
+        if (typeof body.realtimeUrl === 'string' && body.realtimeUrl.length > 0) {
+            this.realtimeUrl = body.realtimeUrl;
+        }
+    }
+    async request(path, body, isRetry = false) {
+        const res = await fetch(`${this.base}${path}`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                // Production API requires Idempotency-Key on every write; mint
+                // a fresh UUID per call so a stray fetch-retry never duplicates.
+                'idempotency-key': newIdempotencyKey(),
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            if (res.status === 403 && !isRetry && (await isStaleSession(res))) {
+                // The stored token predates signed visitor sessions, or expired. The
+                // integrator's code did nothing wrong and should not have to handle
+                // it: drop the dead token, get a fresh one, replay the call once.
+                this.visitorToken = null;
+                localStorage.removeItem(`livechat:vt:${this.opts.publicId}`);
+                await this.ensureVisitorToken();
+                const replayed = { ...body };
+                if (replayed['visitorToken'] !== undefined) {
+                    replayed['visitorToken'] = this.visitorToken;
+                }
+                return this.request(path, replayed, true);
+            }
+            throw new Error(`Chatly SDK request failed: ${res.status}`);
+        }
+        return res;
+    }
+}
+/**
+ * Is this 403 "your session token is no good", rather than one of the other
+ * things a widget call can be forbidden for (a disallowed origin, a missing
+ * identity hash)? Only the session codes are cured by fetching a new token.
+ */
+/**
+ * Does this 403 mean "your session token is no good"?
+ *
+ * This read `body.code` at the top level, and the API has never sent that
+ * shape: `app-exception.filter.ts` wraps every error as
+ * `{ error: { code, message, details } }`. So it was `undefined` for every
+ * real response, this returned false every time, and **the session-recovery
+ * path below never fired** — a visitor holding an expired token got failures
+ * the SDK was written to absorb.
+ *
+ * The widget had the identical bug, fixed on 2026-10-08, and nobody checked
+ * its sibling. Both shapes are read now: the nested one the API sends, and
+ * the flat one in case anything ever answers that way.
+ */
+async function isStaleSession(res) {
+    try {
+        const body = (await res.json());
+        const code = body.error?.code ?? body.code;
+        return typeof code === 'string' && code.startsWith('visitor_session_');
+    }
+    catch {
+        return false;
+    }
+}
+function newIdempotencyKey() {
+    // crypto.randomUUID is in every browser the widget supports
+    // (Chrome 92+, Safari 15.4+, Firefox 95+).
+    return globalThis.crypto.randomUUID();
+}
+export default Chatly;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/live.d.ts

@@ -0,0 +1,99 @@
+/**
+ * The live half of the headless SDK.
+ *
+ * A consumer building their own chat UI needs messages as they arrive. Two
+ * ways, and the SDK does not require the heavier one:
+ *
+ *  - **Polling**, the default. Zero dependencies, works everywhere, a few
+ *    seconds of latency.
+ *  - **Push**, by handing `subscribe()` your own socket.io-client factory.
+ *    The widget does the same thing with a deferred chunk; the SDK will not
+ *    take the dependency on a consumer's behalf, because a React Native app
+ *    or a worker may have no use for it and every byte would still ship.
+ *
+ * This file holds the part worth testing on its own: deciding what is new.
+ */
+import type { HeadlessMessage, TypingSignal } from './types.js';
+/**
+ * The messages in `batch` that `seen` has not yet been told about, oldest
+ * first, with `seen` updated.
+ *
+ * Ordered by `createdAt` rather than by the order the server returned: a list
+ * endpoint is free to answer newest-first, and a consumer appending in
+ * receive order would render the conversation upside down.
+ *
+ * Deliberately NOT the widget's `mergePolled`. That one reconciles optimistic
+ * `local-*` rows against their server copies, which only matters to a UI that
+ * renders a message before the server has one. A headless consumer owns that
+ * decision themselves; all they need from us is "what is new".
+ */
+export declare function newMessagesSince(seen: Set<string>, batch: readonly HeadlessMessage[]): HeadlessMessage[];
+/**
+ * How long a "typing" indicator survives without another `typing.start`.
+ *
+ * ── Why the SDK owns this timeout and not the consumer ──────────────────
+ *
+ * `typing.stop` is best-effort. The dashboard emits one after 5s of idle
+ * keystrokes and on send, and its hook emits one on unmount — but an agent
+ * who closes the laptop mid-sentence, loses their network, or whose tab is
+ * killed sends nothing at all. A consumer rendering the raw start/stop pair
+ * gets an indicator that says "Sarah is typing…" forever, which is the exact
+ * shape of bug this codebase keeps finding: it appears to work.
+ *
+ * Leaving it to the consumer means every consumer writes this same timer, and
+ * the ones who do not ship the stuck indicator. 3,500ms is the widget's own
+ * window (`use-conversation-realtime.tsx`), so a custom UI built on the SDK
+ * behaves like the widget rather than subtly differently.
+ */
+export declare const TYPING_STOP_AFTER_MS = 3500;
+/** What the tracker needs from a `typing.*` payload. */
+interface TypingActor {
+    readonly actorType: 'agent' | 'bot';
+    readonly actorId: string;
+    readonly displayName?: string;
+}
+/**
+ * Turn a stream of `typing.start` / `typing.stop` events into the single
+ * boolean a UI actually renders.
+ *
+ * Edge-triggered: `onChange` fires only when the answer changes, so a
+ * keystroke every 300ms does not re-render the consumer's component ten times
+ * a second. Exported for its own test — the timer behaviour is the part worth
+ * pinning, and it is invisible from the outside.
+ */
+export declare function createTypingTracker(opts: {
+    readonly onChange: (signal: TypingSignal) => void;
+    readonly stopAfterMs?: number;
+}): {
+    start: (actor: TypingActor) => void;
+    /**
+     * `actor` is optional: the caller does not always have one. A message
+     * arriving means "whoever was typing has stopped", and the envelope that
+     * carries it says nothing about typing at all.
+     */
+    stop: (actor?: TypingActor) => void;
+    dispose: () => void;
+};
+/**
+ * The actor a `typing.*` envelope is about, or null if it is not one we show.
+ *
+ * Two exclusions, both load-bearing:
+ *
+ *  - `kind: 'viewing'`. The agent dashboard publishes room presence and
+ *    collaborative-cursor frames AS `typing.start` (see `viewing.cursor` in
+ *    `apps/realtime/src/gateway.ts`), ~10 per second while an agent moves
+ *    their mouse. Rendering those as typing would make the indicator flicker
+ *    whenever an agent so much as looked at the conversation.
+ *  - anything that is not an agent or a bot. The gateway's visitor allowlist
+ *    already forwards only agent typing, so this is the second of two checks
+ *    rather than the only one — but a visitor must never be shown their OWN
+ *    typing as the agent's, and the day the allowlist widens is not the day
+ *    to discover that.
+ */
+export declare function typingActorOf(payload: unknown): {
+    actorType: 'agent' | 'bot';
+    actorId: string;
+    displayName?: string;
+} | null;
+export {};
+//# sourceMappingURL=live.d.ts.map

package/dist/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAYhE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,KAAK,EAAE,SAAS,eAAe,EAAE,GAChC,eAAe,EAAE,CA4BnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C,wDAAwD;AACxD,UAAU,WAAW;IACnB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,KAAK,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG;IACF,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACpC;;;;OAIG;IACH,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAgDA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,GACf;IAAE,SAAS,EAAE,OAAO,GAAG,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqB9E"}