@abloatai/transaction 0.59.1 → 0.60.0

package/dist/transport/websocket/session.js

@@ -0,0 +1,425 @@
+import { AbloClaimedError, AbloConnectionError, AbloSessionError, errorFromWire, isAccessCredentialExpiryCloseReason, } from '../../errors.js';
+import { classifyCredentialKind } from '../../auth/credentialKind.js';
+import { credentialToken, } from '../../auth/credentialResult.js';
+import { CredentialLifecycle } from '../../sessions/lifecycle.js';
+import { clientSyncDeltaSchema, } from '../../observation/contract.js';
+import { WsTransport, } from './transport.js';
+const MAX_BUFFERED_OBSERVATION_DELTAS = 1_024;
+function parsePosition(value) {
+    if (!value)
+        return { lastSyncId: 0, cursor: null };
+    try {
+        const parsed = JSON.parse(value);
+        if (Number.isSafeInteger(parsed.lastSyncId)
+            && parsed.lastSyncId >= 0
+            && (parsed.cursor === null || typeof parsed.cursor === 'string')) {
+            return {
+                lastSyncId: parsed.lastSyncId,
+                cursor: parsed.cursor,
+            };
+        }
+    }
+    catch {
+        // Pre-live stores may contain the HTTP feed cursor. It is a different
+        // protocol position, so failing closed at zero is safer than skipping.
+    }
+    return { lastSyncId: 0, cursor: null };
+}
+class AgentWebSocket extends WsTransport {
+    position;
+    constructor(options, position) {
+        super(options);
+        this.position = position;
+    }
+    resumeCursor() {
+        return this.position.cursor ?? '';
+    }
+    onOpened() {
+        this.updatePresence();
+        this.requestSync(this.position);
+    }
+    handleDelta(raw) {
+        const parsed = clientSyncDeltaSchema.safeParse(raw);
+        if (parsed.success)
+            this.emit('delta', parsed.data);
+    }
+    handleSyncResponse(raw) {
+        if (typeof raw !== 'object' || raw === null)
+            return;
+        const response = raw;
+        if (Array.isArray(response.deltas)) {
+            for (const delta of response.deltas)
+                this.handleDelta(delta);
+        }
+        this.emit('sync_response', response);
+    }
+    positionAfter(lastSyncId) {
+        return {
+            lastSyncId: Math.max(this.position.lastSyncId, lastSyncId),
+            cursor: this.position.cursor,
+        };
+    }
+    markDurable(position) {
+        this.position = position;
+    }
+    durablePosition() {
+        return this.position;
+    }
+    requestFromDurablePosition() {
+        this.requestSync(this.position);
+    }
+}
+class WebSocketSession {
+    socket;
+    options;
+    cursorKey;
+    readyPromise = null;
+    rejectReady = null;
+    closed = false;
+    currentToken;
+    acknowledgeLane = Promise.resolve();
+    terminalError = null;
+    terminalListeners = new Set();
+    credentialLifecycle;
+    pendingSessionError = null;
+    presence;
+    collaboration;
+    constructor(options, position, credential) {
+        this.options = options;
+        const token = credentialToken(credential);
+        if (!token) {
+            throw new AbloSessionError('The WebSocket transport requires an authenticated credential.');
+        }
+        this.currentToken = token;
+        this.cursorKey = options.cursorKey ?? 'websocket';
+        this.socket = new AgentWebSocket({
+            baseUrl: options.baseUrl,
+            kind: classifyCredentialKind(token) === 'ephemeral' ? 'user' : 'agent',
+            getAuthToken: () => this.currentToken,
+            syncGroups: [...(options.syncGroups ?? [])],
+            collaborationEvents: [...(options.collaborationEvents ?? [])],
+            reconnectDelay: options.reconnectDelay,
+            maxReconnectDelay: options.maxReconnectDelay,
+        }, position);
+        this.presence = {
+            update: (input = {}) => this.socket.updatePresence(input),
+        };
+        this.collaboration = {
+            send: (event, payload) => this.socket.sendCollaborationEvent(event, payload),
+        };
+        this.socket.subscribe('session_error', (error) => {
+            this.handleSessionError(error);
+        });
+        this.credentialLifecycle = options.access.renewable
+            ? new CredentialLifecycle({
+                setAuthToken: (freshToken) => {
+                    this.currentToken = freshToken;
+                },
+                nudgeReconnect: () => {
+                    if (this.closed || this.terminalError)
+                        return;
+                    this.socket.clearSessionError();
+                    this.socket.resetReconnectAttempts();
+                    this.socket.connect();
+                },
+                reportSessionExpired: () => {
+                    this.failTerminal(this.pendingSessionError ?? new AbloSessionError('The application session ended while renewing its Ablo session.'));
+                },
+            })
+            : null;
+        if (this.credentialLifecycle) {
+            this.credentialLifecycle.start(() => this.loadCredential(), { proactiveInNode: true });
+            this.credentialLifecycle.accept(credential);
+        }
+    }
+    async loadCredential() {
+        return this.options.access.credential();
+    }
+    handleSessionError(error) {
+        if (!this.credentialLifecycle
+            || !isAccessCredentialExpiryCloseReason(error.message)) {
+            this.failTerminal(error);
+            return;
+        }
+        this.pendingSessionError = error;
+        void this.credentialLifecycle.recoverFromAuthRejection('access_credential_expiry');
+    }
+    failTerminal(error) {
+        if (this.terminalError || this.closed)
+            return;
+        this.terminalError = error;
+        this.socket.setSessionErrorDetected();
+        this.socket.disconnect();
+        for (const listener of this.terminalListeners)
+            listener(error);
+    }
+    onTerminal(listener) {
+        if (this.terminalError) {
+            const error = this.terminalError;
+            queueMicrotask(() => listener(error));
+            return () => undefined;
+        }
+        this.terminalListeners.add(listener);
+        return () => this.terminalListeners.delete(listener);
+    }
+    get connected() {
+        return this.socket.isConnected();
+    }
+    ready() {
+        if (this.closed) {
+            return Promise.reject(new AbloConnectionError('The WebSocket session is closed.'));
+        }
+        if (this.terminalError)
+            return Promise.reject(this.terminalError);
+        if (this.socket.isConnected())
+            return Promise.resolve();
+        if (this.readyPromise)
+            return this.readyPromise;
+        this.readyPromise = new Promise((resolve, reject) => {
+            const rejectConnection = (error) => {
+                cleanup();
+                reject(error);
+            };
+            this.rejectReady = rejectConnection;
+            const timeout = setTimeout(() => {
+                rejectConnection(new AbloConnectionError('The WebSocket connection timed out.'));
+            }, this.options.connectTimeoutMs ?? 15_000);
+            const connected = this.socket.subscribe('connected', () => {
+                cleanup();
+                resolve();
+            });
+            const failed = this.onTerminal((error) => {
+                rejectConnection(error);
+            });
+            const mismatch = this.socket.subscribe('protocol_mismatch', () => {
+                rejectConnection(new AbloConnectionError('The server rejected this live protocol version.', {
+                    code: 'protocol_version_unsupported',
+                }));
+            });
+            const cleanup = () => {
+                clearTimeout(timeout);
+                connected();
+                failed();
+                mismatch();
+                this.readyPromise = null;
+                this.rejectReady = null;
+            };
+            this.socket.connect();
+        });
+        return this.readyPromise;
+    }
+    async commit(input) {
+        await this.ready();
+        return this.socket.sendCommitReceipt(input.operations, input.clientTxId, input.timeoutMs, input.reads);
+    }
+    async claim(input) {
+        await this.ready();
+        const timeoutMs = input.timeoutMs ?? 15_000;
+        return new Promise((resolve, reject) => {
+            const cleanups = [];
+            const finish = (outcome) => {
+                clearTimeout(timeout);
+                for (const cleanup of cleanups)
+                    cleanup();
+                outcome();
+            };
+            const matches = (event) => event.claimId === input.claimId;
+            cleanups.push(this.socket.subscribe('claim_acquired', (event) => {
+                if (matches(event))
+                    finish(() => resolve(event));
+            }));
+            cleanups.push(this.socket.subscribe('claim_granted', (event) => {
+                if (matches(event))
+                    finish(() => resolve(event));
+            }));
+            cleanups.push(this.socket.subscribe('claim_queued', (event) => {
+                if (!matches(event))
+                    return;
+                const refusal = input.onQueued?.(event);
+                if (refusal) {
+                    this.release({
+                        claimId: input.claimId,
+                        entityType: input.entityType,
+                        entityId: input.entityId,
+                    });
+                    finish(() => reject(refusal));
+                }
+            }));
+            cleanups.push(this.socket.subscribe('claim_rejected', (event) => {
+                if (!matches(event))
+                    return;
+                finish(() => reject(errorFromWire(event.message ?? `Claim ${event.claimId} was rejected.`, {
+                    code: event.reason === 'conflict' ? 'claim_conflict' : 'claim_rejected',
+                    details: {
+                        ...(event.target ? { target: event.target } : {}),
+                        ...(event.heldBy ? { heldBy: event.heldBy } : {}),
+                        ...(event.heldByClaimId ? { heldByClaimId: event.heldByClaimId } : {}),
+                    },
+                })));
+            }));
+            cleanups.push(this.socket.subscribe('disconnected', () => {
+                finish(() => reject(new AbloConnectionError(`WebSocket closed while claim ${input.claimId} was pending.`)));
+            }));
+            const abort = () => {
+                this.release({
+                    claimId: input.claimId,
+                    entityType: input.entityType,
+                    entityId: input.entityId,
+                });
+                finish(() => reject(new AbloClaimedError(`The wait for claim ${input.claimId} was aborted.`, { code: 'claim_wait_aborted' })));
+            };
+            input.signal?.addEventListener('abort', abort, { once: true });
+            cleanups.push(() => input.signal?.removeEventListener('abort', abort));
+            const timeout = setTimeout(() => {
+                this.release({
+                    claimId: input.claimId,
+                    entityType: input.entityType,
+                    entityId: input.entityId,
+                });
+                finish(() => reject(new AbloClaimedError(`claim timed out after ${timeoutMs}ms (claimId=${input.claimId})`, { code: 'grant_timeout' })));
+            }, timeoutMs);
+            if (input.signal?.aborted) {
+                abort();
+                return;
+            }
+            const { timeoutMs: _timeoutMs, signal: _signal, onQueued: _onQueued, ...payload } = input;
+            this.socket.send({ type: 'claim_begin', payload });
+        });
+    }
+    release(input) {
+        this.socket.send({ type: 'claim_abandon', payload: input });
+    }
+    subscribe(event, listener) {
+        return this.socket.subscribe(event, listener);
+    }
+    async *observe(options = {}) {
+        await this.ready();
+        const queued = [];
+        const queuedIds = new Set();
+        let wake;
+        let failure;
+        const offDelta = this.socket.subscribe('delta', (delta) => {
+            if (failure
+                || delta.id <= this.socket.durablePosition().lastSyncId
+                || queuedIds.has(delta.id))
+                return;
+            if (queued.length >= MAX_BUFFERED_OBSERVATION_DELTAS) {
+                failure = new AbloConnectionError(`WebSocket observation exceeded ${MAX_BUFFERED_OBSERVATION_DELTAS} uncheckpointed deltas; restart observation to resume from the durable cursor.`, { code: 'observation_buffer_overflow' });
+                wake?.();
+                wake = undefined;
+                return;
+            }
+            queued.push(delta);
+            queuedIds.add(delta.id);
+            wake?.();
+            wake = undefined;
+        });
+        const offError = this.onTerminal((error) => {
+            failure = error;
+            wake?.();
+            wake = undefined;
+        });
+        const abort = () => {
+            wake?.();
+            wake = undefined;
+        };
+        options.signal?.addEventListener('abort', abort, { once: true });
+        // Retain nothing while idle. Register first, then replay from the durable
+        // position so starting observation cannot miss a delta from the gap.
+        this.socket.requestFromDurablePosition();
+        try {
+            while (!this.closed && !options.signal?.aborted) {
+                if (failure)
+                    throw failure;
+                const delta = queued.shift();
+                if (!delta) {
+                    await new Promise((resolve) => { wake = resolve; });
+                    continue;
+                }
+                queuedIds.delete(delta.id);
+                if (delta.id <= this.socket.durablePosition().lastSyncId)
+                    continue;
+                let checkpointed = false;
+                let checkpointing;
+                yield {
+                    ...delta,
+                    checkpoint: async () => {
+                        if (checkpointed)
+                            return;
+                        checkpointing ??= this.acknowledge(delta.id).then(() => {
+                            checkpointed = true;
+                        }).finally(() => {
+                            checkpointing = undefined;
+                        });
+                        await checkpointing;
+                    },
+                };
+            }
+        }
+        finally {
+            offDelta();
+            offError();
+            options.signal?.removeEventListener('abort', abort);
+        }
+    }
+    async updateSubscription(syncGroups, options) {
+        await this.ready();
+        return this.socket.updateSubscription(syncGroups, options);
+    }
+    async acknowledge(lastSyncId) {
+        const attempt = this.acknowledgeLane.catch(() => undefined).then(async () => {
+            const position = this.socket.positionAfter(lastSyncId);
+            await this.options.cursorStore?.save(this.cursorKey, JSON.stringify(position));
+            this.socket.markDurable(position);
+            this.socket.acknowledge(position.lastSyncId);
+        });
+        this.acknowledgeLane = attempt.catch(() => undefined);
+        await attempt;
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.credentialLifecycle?.stop();
+        this.terminalListeners.clear();
+        this.rejectReady?.(new AbloConnectionError('The WebSocket session was disposed.'));
+        await this.acknowledgeLane;
+        this.socket.disconnect();
+    }
+    [Symbol.asyncDispose]() {
+        return this.close();
+    }
+}
+export async function createWebSocketSession(options, signal) {
+    const cursorKey = options.cursorKey ?? 'websocket';
+    const stored = await options.cursorStore?.load(cursorKey) ?? null;
+    const credential = await options.access.credential();
+    const token = credentialToken(credential);
+    if (!token) {
+        throw new AbloSessionError('The WebSocket transport requires an authenticated credential.');
+    }
+    const session = new WebSocketSession(options, parsePosition(stored), credential);
+    let rejectOpening;
+    const aborted = new Promise((_resolve, reject) => {
+        rejectOpening = reject;
+        if (signal?.aborted) {
+            reject(new AbloConnectionError('WebSocket opening was disposed.'));
+        }
+    });
+    const abort = () => {
+        rejectOpening?.(new AbloConnectionError('WebSocket opening was disposed.'));
+    };
+    signal?.addEventListener('abort', abort, { once: true });
+    try {
+        await (signal ? Promise.race([session.ready(), aborted]) : session.ready());
+        return session;
+    }
+    catch (error) {
+        await session.close();
+        throw error;
+    }
+    finally {
+        signal?.removeEventListener('abort', abort);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/transport/websocket/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/transport/websocket/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,mCAAmC,GACpC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,eAAe,GAEhB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,GAGZ,MAAM,gBAAgB,CAAC;AAkBxB,MAAM,+BAA+B,GAAG,KAAK,CAAC;AAE9C,SAAS,aAAa,CAAC,KAAoB;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA+C,CAAC;QAC/E,IACE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC;eACnC,MAAM,CAAC,UAAqB,IAAI,CAAC;eAClC,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,EAChE,CAAC;YACD,OAAO;gBACL,UAAU,EAAE,MAAM,CAAC,UAAoB;gBACvC,MAAM,EAAE,MAAM,CAAC,MAAuB;aACvC,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,uEAAuE;IACzE,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,cAEJ,SAAQ,WAAoB;IACpB,QAAQ,CAAiB;IAEjC,YACE,OAA8D,EAC9D,QAAwB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEkB,YAAY;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,CAAC;IAEkB,QAAQ;QACzB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEkB,WAAW,CAAC,GAAY;QACzC,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAEkB,kBAAkB,CAAC,GAAY;QAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO;QACpD,MAAM,QAAQ,GAAG,GAKhB,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM;gBAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;YAC1D,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;SAC7B,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,QAAwB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,0BAA0B;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;CACF;AAED,MAAM,gBAAgB;IAEH,MAAM,CAA0B;IAChC,OAAO,CAA0B;IACjC,SAAS,CAAS;IAC3B,YAAY,GAAyB,IAAI,CAAC;IAC1C,WAAW,GAAoC,IAAI,CAAC;IACpD,MAAM,GAAG,KAAK,CAAC;IACf,YAAY,CAAS;IACrB,eAAe,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACnD,aAAa,GAAiB,IAAI,CAAC;IAC1B,iBAAiB,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,mBAAmB,CAA6B;IACzD,mBAAmB,GAAiB,IAAI,CAAC;IAExC,QAAQ,CAAoB;IAC5B,aAAa,CAAkC;IAExD,YACE,OAAgC,EAChC,QAAwB,EACxB,UAAoC;QAEpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,gBAAgB,CAAC,+DAA+D,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAU;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YACtE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY;YACrC,UAAU,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC3C,mBAAmB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;YAC7D,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,EAAE,QAAQ,CAAC,CAAC;QACb,IAAI,CAAC,QAAQ,GAAG;YACd,MAAM,EAAE,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC;SAC1D,CAAC;QACF,IAAI,CAAC,aAAa,GAAG;YACnB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC;SAC1C,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;YAC/C,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS;YACjD,CAAC,CAAC,IAAI,mBAAmB,CAAC;gBACxB,YAAY,EAAE,CAAC,UAAU,EAAE,EAAE;oBAC3B,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;gBACjC,CAAC;gBACD,cAAc,EAAE,GAAG,EAAE;oBACnB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa;wBAAE,OAAO;oBAC9C,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;oBAChC,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC;oBACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxB,CAAC;gBACD,oBAAoB,EAAE,GAAG,EAAE;oBACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,mBAAmB,IAAI,IAAI,gBAAgB,CAChE,gEAAgE,CACjE,CAAC,CAAC;gBACL,CAAC;aACF,CAAC;YACF,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YACvF,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1C,CAAC;IAEO,kBAAkB,CAAC,KAAY;QACrC,IACE,CAAC,IAAI,CAAC,mBAAmB;eACtB,CAAC,mCAAmC,CAAC,KAAK,CAAC,OAAO,CAAC,EACtD,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC;QACjC,KAAK,IAAI,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,0BAA0B,CAAC,CAAC;IACrF,CAAC;IAEO,YAAY,CAAC,KAAY;QAC/B,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAC9C,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,iBAAiB;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAEO,UAAU,CAAC,QAAgC;QACjD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC;YACjC,cAAc,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YACtC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAmB,CAAC,kCAAkC,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACxD,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QAChD,IAAI,CAAC,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxD,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAAQ,EAAE;gBAC9C,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC;YACF,IAAI,CAAC,WAAW,GAAG,gBAAgB,CAAC;YACpC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,gBAAgB,CAAC,IAAI,mBAAmB,CAAC,qCAAqC,CAAC,CAAC,CAAC;YACnF,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,EAAE;gBACxD,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;gBACvC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,GAAG,EAAE;gBAC/D,gBAAgB,CAAC,IAAI,mBAAmB,CAAC,iDAAiD,EAAE;oBAC1F,IAAI,EAAE,8BAA8B;iBACrC,CAAC,CAAC,CAAC;YACN,CAAC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,GAAS,EAAE;gBACzB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,SAAS,EAAE,CAAC;gBACZ,MAAM,EAAE,CAAC;gBACT,QAAQ,EAAE,CAAC;gBACX,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YAC1B,CAAC,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA2B;QACtC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAClC,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,KAAK,CACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAA0B;QACpC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC;QAC5C,OAAO,IAAI,OAAO,CAA6G,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACjJ,MAAM,QAAQ,GAAmB,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,CAAC,OAAmB,EAAQ,EAAE;gBAC3C,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,KAAK,MAAM,OAAO,IAAI,QAAQ;oBAAE,OAAO,EAAE,CAAC;gBAC1C,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,CAAC,KAA0B,EAAW,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;YACzF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC9D,IAAI,OAAO,CAAC,KAAK,CAAC;oBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC7D,IAAI,OAAO,CAAC,KAAK,CAAC;oBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC5D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;oBAAE,OAAO;gBAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;gBACxC,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC,OAAO,CAAC;wBACX,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;qBACzB,CAAC,CAAC;oBACH,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC,CAAC,CAAC,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;oBAAE,OAAO;gBAC5B,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAC/B,KAAK,CAAC,OAAO,IAAI,SAAS,KAAK,CAAC,OAAO,gBAAgB,EACvD;oBACE,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB;oBACvE,OAAO,EAAE;wBACP,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjD,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjD,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACvE;iBACF,CACF,CAAC,CAAC,CAAC;YACN,CAAC,CAAC,CAAC,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,EAAE;gBACvD,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,mBAAmB,CACzC,gCAAgC,KAAK,CAAC,OAAO,eAAe,CAC7D,CAAC,CAAC,CAAC;YACN,CAAC,CAAC,CAAC,CAAC;YACJ,MAAM,KAAK,GAAG,GAAS,EAAE;gBACvB,IAAI,CAAC,OAAO,CAAC;oBACX,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC,CAAC;gBACH,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,gBAAgB,CACtC,sBAAsB,KAAK,CAAC,OAAO,eAAe,EAClD,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAC/B,CAAC,CAAC,CAAC;YACN,CAAC,CAAC;YACF,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,OAAO,CAAC;oBACX,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC,CAAC;gBACH,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,gBAAgB,CACtC,yBAAyB,SAAS,eAAe,KAAK,CAAC,OAAO,GAAG,EACjE,EAAE,IAAI,EAAE,eAAe,EAAE,CAC1B,CAAC,CAAC,CAAC;YACN,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC1B,KAAK,EAAE,CAAC;gBACR,OAAO;YACT,CAAC;YACD,MAAM,EACJ,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,EACnB,GAAG,OAAO,EACX,GAAG,KAAK,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,KAAkE;QACxE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,CACP,KAAQ,EACR,QAA8D;QAE9D,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CAAC,UAAmC,EAAE;QAClD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,IAAI,IAA8B,CAAC;QACnC,IAAI,OAAgB,CAAC;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACxD,IACE,OAAO;mBACJ,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,UAAU;mBACpD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;YACT,IAAI,MAAM,CAAC,MAAM,IAAI,+BAA+B,EAAE,CAAC;gBACrD,OAAO,GAAG,IAAI,mBAAmB,CAC/B,kCAAkC,+BAA+B,gFAAgF,EACjJ,EAAE,IAAI,EAAE,6BAA6B,EAAE,CACxC,CAAC;gBACF,IAAI,EAAE,EAAE,CAAC;gBACT,IAAI,GAAG,SAAS,CAAC;gBACjB,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,EAAE,CAAC;YACT,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;YACzC,OAAO,GAAG,KAAK,CAAC;YAChB,IAAI,EAAE,EAAE,CAAC;YACT,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,GAAS,EAAE;YACvB,IAAI,EAAE,EAAE,CAAC;YACT,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC,CAAC;QACF,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,0EAA0E;QAC1E,qEAAqE;QACrE,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAChD,IAAI,OAAO;oBAAE,MAAM,OAAO,CAAC;gBAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC1D,SAAS;gBACX,CAAC;gBACD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3B,IAAI,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,UAAU;oBAAE,SAAS;gBACnE,IAAI,YAAY,GAAG,KAAK,CAAC;gBACzB,IAAI,aAAwC,CAAC;gBAC7C,MAAM;oBACJ,GAAG,KAAK;oBACR,UAAU,EAAE,KAAK,IAAI,EAAE;wBACrB,IAAI,YAAY;4BAAE,OAAO;wBACzB,aAAa,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;4BACrD,YAAY,GAAG,IAAI,CAAC;wBACtB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;4BACd,aAAa,GAAG,SAAS,CAAC;wBAC5B,CAAC,CAAC,CAAC;wBACH,MAAM,aAAa,CAAC;oBACtB,CAAC;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,UAA6B,EAAE,OAAgC;QACtF,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACvD,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/E,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,OAAO,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,mBAAmB,CAAC,qCAAqC,CAAC,CAAC,CAAC;QACnF,MAAM,IAAI,CAAC,eAAe,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,CAAC,MAAM,CAAC,YAAY,CAAC;QACnB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAG1C,OAAgC,EAChC,MAAoB;IAEpB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAClE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,gBAAgB,CAAC,+DAA+D,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAClC,OAAO,EACP,aAAa,CAAC,MAAM,CAAC,EACrB,UAAU,CACX,CAAC;IACF,IAAI,aAAmD,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtD,aAAa,GAAG,MAAM,CAAC;QACvB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,aAAa,EAAE,CAAC,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC;IACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/transport/websocket/sessionContract.d.ts

@@ -0,0 +1,78 @@
+import type { CommitReceiptWire } from '../../commit/contract.js';
+import type { ReadDependency } from '../../coordination/schema.js';
+import type { ClaimAcquired, ClaimBeginPayload, ClaimGranted, ClaimQueued } from '../../coordination/schema.js';
+import type { ClientSyncDelta } from '../../observation/contract.js';
+import type { ObserveCursorStore } from '../../client/contract.js';
+import type { SessionAccess } from '../../sessions/source.js';
+import type { CommitFrameOperation } from '../websocket/commitFrames.js';
+import type { CoreSyncEventMap, EventMap, PresenceUpdate, SyncWebSocketEventMap } from '../websocket/transport.js';
+export interface WebSocketSessionOptions {
+    readonly baseUrl?: string;
+    /** Normalized once at the client boundary; transports do not infer policy. */
+    readonly access: SessionAccess;
+    readonly syncGroups?: readonly string[];
+    readonly collaborationEvents?: readonly string[];
+    readonly cursorKey?: string;
+    readonly cursorStore?: ObserveCursorStore;
+    readonly reconnectDelay?: number;
+    readonly maxReconnectDelay?: number;
+    readonly connectTimeoutMs?: number;
+}
+export interface WebSocketCommitInput {
+    readonly operations: readonly CommitFrameOperation[];
+    readonly clientTxId: string;
+    readonly reads?: readonly ReadDependency[] | null;
+    readonly timeoutMs?: number;
+}
+export interface WebSocketObservedDelta extends ClientSyncDelta {
+    /** Persist and acknowledge this delta as durably applied. */
+    checkpoint(): Promise<void>;
+}
+export interface WebSocketObserveOptions {
+    readonly signal?: AbortSignal;
+}
+/** A durable row/field claim carried over the same live protocol. */
+export type WebSocketClaimInput = ClaimBeginPayload & {
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+    readonly onQueued?: (event: ClaimQueued) => Error | undefined;
+};
+export type WebSocketClaimGrant = ClaimAcquired | ClaimGranted;
+export interface WebSocketPresence {
+    update(input?: {
+        readonly status?: 'online' | 'away' | 'offline';
+        readonly customStatus?: string;
+        readonly timezone?: string;
+        readonly activity?: Record<string, unknown>;
+    }): void;
+}
+export interface WebSocketCollaboration<TEvents extends EventMap<TEvents>> {
+    send<K extends string & keyof TEvents>(event: K, payload: TEvents[K] extends [infer P] ? Omit<P & Record<string, unknown>, 'timestamp'> : never): void;
+}
+export type OpenCollaborationEvents = Record<string, [Record<string, unknown>]>;
+export interface AbloWebSocketSession<TEvents extends EventMap<TEvents> = OpenCollaborationEvents> extends AsyncDisposable {
+    readonly presence: WebSocketPresence;
+    readonly collaboration: WebSocketCollaboration<TEvents>;
+    readonly connected: boolean;
+    ready(): Promise<void>;
+    commit(input: WebSocketCommitInput): Promise<CommitReceiptWire>;
+    claim(input: WebSocketClaimInput): Promise<WebSocketClaimGrant>;
+    release(input: {
+        readonly claimId: string;
+        readonly entityType?: string;
+        readonly entityId?: string;
+    }): void;
+    subscribe<K extends keyof SyncWebSocketEventMap<TEvents>>(event: K, listener: (...args: SyncWebSocketEventMap<TEvents>[K]) => void): () => void;
+    observe(options?: WebSocketObserveOptions): AsyncIterable<WebSocketObservedDelta>;
+    updateSubscription(syncGroups: readonly string[], options?: {
+        timeoutMs?: number;
+    }): Promise<{
+        syncGroups: string[];
+    }>;
+    acknowledge(lastSyncId: number): Promise<void>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export type WebSocketCoreEvent = keyof CoreSyncEventMap;
+export type WebSocketPresenceUpdate = PresenceUpdate;
+//# sourceMappingURL=sessionContract.d.ts.map

package/dist/transport/websocket/sessionContract.d.ts.map

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

package/dist/transport/websocket/sessionContract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sessionContract.js.map

package/dist/transport/websocket/sessionContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionContract.js","sourceRoot":"","sources":["../../../src/transport/websocket/sessionContract.ts"],"names":[],"mappings":""}

package/dist/transport/websocket/transport.d.ts

@@ -21,7 +21,7 @@ import { EventEmitter } from 'events';
 import type { ParticipantKind } from '../../types/participant.js';
 import type { BootstrapReason } from '../../wire/bootstrapReason.js';
 import type { ClientSyncDelta } from '../../observation/contract.js';
-import type { ClaimAcquired, PresenceUpdate, ClaimExpired, ClaimGranted, ClaimHeartbeatAckPayload, ClaimLost, ClaimQueue, ClaimQueued, ClaimRejection, ParticipantClaimPayload, ReadDependency } from '../../coordination/schema.js';
+import type { ClaimAcquired, PresenceUpdate, ClaimGranted, ClaimHeartbeatAckPayload, ClaimLost, ClaimQueue, ClaimQueued, ClaimRejection, ReadDependency } from '../../coordination/schema.js';
 import { type AuthTokenGetter } from '../../auth/credentialSource.js';
 import { type CommitAck, type CommitFrameOperation } from './commitFrames.js';
 import type { CommitReceiptWire } from '../../commit/contract.js';
@@ -154,6 +154,7 @@ export interface CoreSyncEventMap {
     presence_update: [PresenceUpdate];
     error: [Error];
     session_error: [Error];
+    protocol_mismatch: [CloseEvent];
     /**
      * The WebSocket `onclose` fired before `onopen` — the handshake itself
      * failed. The browser cannot expose the HTTP status (it shows as code
@@ -165,14 +166,6 @@ export interface CoreSyncEventMap {
     reconnect_failed: [{
         attempts: number;
     }];
-    /**
-     * Server-initiated notification that a previously-active claim's
-     * TTL has expired. Consumers (e.g., the participant SDK) re-mint
-     * a fresh capability and re-claim, OR accept the drop. The claim
-     * is already inactive on the server side by the time this fires —
-     * no client-side action needed unless re-claiming.
-     */
-    claim_expired: [ClaimExpired];
     /**
      * Server rejected an `claim_begin` because another participant
      * already holds an open claim on the same target (cooperative
@@ -281,6 +274,10 @@ export declare class WsTransport<TCollaboration extends EventMap<TCollaboration>
      *  server rejected the upgrade" since browsers hide the HTTP status (e.g.
      *  401) behind the opaque 1006 close code. */
     private _everOpened;
+    /** True after any socket in this logical transport has opened. Unlike
+     * `_everOpened`, this survives socket replacement so a failed reconnect
+     * handshake is retried instead of being mistaken for a failed first login. */
+    private _hasConnected;
     /**
      * Diagnostic snapshot of the last connection lifecycle. Persisted across
      * the lifetime of the transport so that any subsequent "not connected"
@@ -314,13 +311,6 @@ export declare class WsTransport<TCollaboration extends EventMap<TCollaboration>
      * sent over the same socket that streams deltas.
      */
     private pendingMutations;
-    /**
-     * In-flight `claim` requests keyed by claimId. Resolved when the matching
-     * `claim_ack` arrives, or rejected on timeout or disconnect — the same
-     * request/response pattern as `pendingMutations`, multiplexed over the one
-     * connection.
-     */
-    private pendingClaims;
     /**
      * In-flight `update_subscription` frames awaiting `subscription_ack`.
      * A FIFO queue rather than a keyed Map because the wire ack carries no
@@ -408,6 +398,27 @@ export declare class WsTransport<TCollaboration extends EventMap<TCollaboration>
      * Send message to server
      */
     send(message: any): void;
+    /**
+     * Ask the server for every durable delta after the supplied position.
+     *
+     * This is deliberately part of the carrier rather than the reactive
+     * materialiser: browser stores and headless WebSocket clients resume the same
+     * ordered protocol. The owner decides when a received position is durable
+     * enough to acknowledge.
+     */
+    requestSync(position: {
+        readonly cursor?: string | null;
+        readonly lastSyncId: number;
+    }): void;
+    /** Persist the server-side resume position after the caller durably applied it. */
+    acknowledge(lastSyncId: number): void;
+    /** Announce this participant's current presence on the shared connection. */
+    updatePresence(input?: {
+        readonly status?: 'online' | 'away' | 'offline';
+        readonly customStatus?: string;
+        readonly timezone?: string;
+        readonly activity?: Record<string, unknown>;
+    }): void;
     /**
      * Sends a `commit` mutation request over the existing WebSocket and resolves
      * when the server's `mutation_result` frame comes back with the same
@@ -431,32 +442,6 @@ export declare class WsTransport<TCollaboration extends EventMap<TCollaboration>
      * instance because no pending resolver is registered.
      */
     sendCommitQueued(operations: readonly CommitFrameOperation[], clientTxId: string, reads?: readonly ReadDependency[] | null): void;
-    /**
-     * Activates a participant claim on this connection. One connection can hold
-     * several concurrent claims at once, each scoped to a different set of sync
-     * groups, so the SDK reuses the existing connection instead of opening a
-     * separate socket per scope.
-     *
-     * Returns a promise that resolves with the server-canonicalized `syncGroups`
-     * and effective `ttlSeconds` once `claim_ack` arrives, or rejects with a typed
-     * error on a failed ack, a timeout, or a disconnect.
-     */
-    sendClaim(claimId: string, syncGroups: readonly string[], options?: Pick<ParticipantClaimPayload, 'capabilityToken' | 'ttlSeconds'> & {
-        timeoutMs?: number;
-    }): Promise<{
-        syncGroups: string[];
-        ttlSeconds?: number;
-    }>;
-    /**
-     * Drop a previously-active claim. Idempotent — `release` is
-     * fire-and-forget per the wire contract; the server accepts
-     * unknown claimIds silently so disconnect-time release storms
-     * never error. No ack is expected.
-     *
-     * If a claim's send promise is still pending (no claim_ack yet),
-     * we reject it locally — the user explicitly chose to release.
-     */
-    sendRelease(claimId: string): void;
     /**
      * Moves this connection's read interest — replaces the connection-level sync
      * groups mid-session as the user opens and closes entities. This is the