@abloatai/transaction 0.56.0 → 0.58.0

package/dist/transport/{httpClient.js → http/client.js}

@@ -17,14 +17,15 @@
  * routing private; application code gets the same `client.<model>` surface the
  * stateful client offers.
  */
-import { createHttpTransport, } from './httpTransport.js';
-import { modelWireNames } from '../auth/capability.js';
-import { modelList } from '../resources/httpResources.js';
-import { omittedModelError } from '../schema/select.js';
-import { reconcileFunctionalUpdate, } from '../resources/functionalUpdate.js';
-import { AbloConnectionError, AbloValidationError } from '../errors.js';
-import { abortReadSetCommit, capturePointRead, createReadSetContext, consumeReadSet, kReadEvidence, prepareReadSet, } from '../readSetContext.js';
-import { recordHttpCommitReceipt } from '../commitRecordRuntime.js';
+import { createHttpTransport, } from './transport.js';
+import { modelWireNames } from '../../auth/capability.js';
+import { collectModelList, modelList } from '../../client/resources/httpResources.js';
+import { resolveCreateId } from '../../client/resources/modelCreate.js';
+import { omittedModelError } from '../../schema/select.js';
+import { reconcileFunctionalUpdate, } from '../../client/resources/functionalUpdate.js';
+import { AbloConnectionError, AbloValidationError } from '../../errors.js';
+import { capturePointRead, createReadSetContext, kReadEvidence, prepareReadSet, } from '../../commit/readSetContext.js';
+import { recordHttpCommitReceipt } from '../../commit/recordRuntime.js';
 /**
  * Private transport members that pass straight through the facade. Everything
  * else must be a declared schema model; there is no dynamic fallback namespace.
@@ -52,7 +53,7 @@ function isProtocolMember(prop) {
  */
 function createHttpModelClient(protocol, modelName, clientIdentity, readSetContext) {
     async function readRow(id) {
-        const read = await protocol.get({ id });
+        const read = await protocol.read({ id });
         capturePointRead(readSetContext, clientIdentity, modelName, id, read.data, read.stamp);
         return read.data;
     }
@@ -75,19 +76,14 @@ function createHttpModelClient(protocol, modelName, clientIdentity, readSetConte
         };
     }
     function preparedMutation(params) {
-        const prepared = prepareReadSet(readSetContext, clientIdentity, params.readAt, params.onStale, params.idempotencyKey, params.reads);
+        const prepared = prepareReadSet(readSetContext, clientIdentity, params.readAt, params.idempotencyKey, params.reads);
         return {
-            options: {
-                ...mutationOptions(params),
-                ...(prepared.readAt !== undefined ? { readAt: prepared.readAt } : {}),
-                ...(prepared.onStale !== undefined ? { onStale: prepared.onStale } : {}),
-                ...(prepared.reads !== undefined ? { reads: prepared.reads } : {}),
-                ...(prepared.idempotencyKey !== undefined
-                    ? { idempotencyKey: prepared.idempotencyKey }
-                    : {}),
-            },
-            consumed: prepared.consumed,
-            automaticCommit: prepared.automaticCommit,
+            ...mutationOptions(params),
+            ...(prepared.readAt !== undefined ? { readAt: prepared.readAt } : {}),
+            ...(prepared.reads !== undefined ? { reads: prepared.reads } : {}),
+            ...(prepared.idempotencyKey !== undefined
+                ? { idempotencyKey: prepared.idempotencyKey }
+                : {}),
         };
     }
     async function update(arg, updater, options) {
@@ -99,83 +95,80 @@ function createHttpModelClient(protocol, modelName, clientIdentity, readSetConte
                 model: modelName,
                 id: arg,
                 readFresh: async () => {
-                    const read = await protocol.get({ id: arg });
+                    const read = await protocol.read({ id: arg });
                     capturePointRead(readSetContext, clientIdentity, modelName, arg, read.data, read.stamp);
                     return { data: read.data, stamp: read.stamp };
                 },
                 writeNext: async (patch, readAt) => {
-                    const prepared = preparedMutation({
+                    const opts = preparedMutation({
                         readAt,
-                        onStale: 'reject',
                         reads: options?.reads,
                     });
-                    try {
-                        const result = await protocol.update({
-                            ...prepared.options,
-                            id: arg,
-                            data: patch,
-                        });
-                        consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
-                        return result;
-                    }
-                    catch (error) {
-                        abortReadSetCommit(readSetContext, prepared.automaticCommit);
-                        throw error;
-                    }
+                    return await protocol.update({
+                        ...opts,
+                        id: arg,
+                        data: patch,
+                    });
                 },
             });
             return receipt === undefined ? undefined : requireUpdatedRow(arg);
         }
-        const prepared = preparedMutation(arg);
-        try {
-            await protocol.update({
-                ...prepared.options,
-                id: arg.id,
-                data: arg.data,
-            });
-        }
-        catch (error) {
-            abortReadSetCommit(readSetContext, prepared.automaticCommit);
-            throw error;
-        }
-        consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
+        await protocol.update({
+            ...preparedMutation(arg),
+            id: arg.id,
+            data: arg.data,
+        });
         return requireUpdatedRow(arg.id);
     }
     const get = async (params) => {
-        const read = await protocol.get(params);
-        capturePointRead(readSetContext, clientIdentity, modelName, params.id, read.data, read.stamp);
-        return read.data;
+        const result = await protocol.read(params);
+        return result.data;
     };
+    const read = async (params) => {
+        const result = await protocol.read(params);
+        capturePointRead(readSetContext, clientIdentity, modelName, params.id, result.data, result.stamp);
+        return result.data;
+    };
+    async function createModel(params) {
+        const opts = preparedMutation(params);
+        // The list form is one atomic commit through the protocol's batch door.
+        // Same verb because it is the same act; the argument says how many.
+        if (Array.isArray(params.data)) {
+            const rows = await protocol.createMany({
+                data: params.data,
+                ...(opts.idempotencyKey ? { idempotencyKey: opts.idempotencyKey } : {}),
+                ...(opts.reads ? { reads: [...opts.reads] } : {}),
+            });
+            return rows;
+        }
+        const single = params;
+        const resolvedId = resolveCreateId(single.id, single.data);
+        const row = await protocol.create({
+            ...opts,
+            ...(resolvedId !== undefined ? { id: resolvedId } : {}),
+            data: single.data,
+        });
+        return row;
+    }
     const list = async (options) => {
         const snapshot = await protocol.list(options);
-        const page = modelList(snapshot.data, snapshot);
-        const registry = readSetContext?.getStore();
-        if (!registry)
-            return page;
-        if (!snapshot.evidence) {
-            throw new AbloConnectionError(`${modelName}.list did not return row evidence. Upgrade the Ablo server or use get({ id }).`, { code: 'commit_no_result' });
-        }
-        const byId = new Map(snapshot.evidence.map((entry) => [entry.id, entry.stamp]));
-        for (const row of snapshot.data) {
-            const id = typeof row === 'object' && row !== null
-                ? Reflect.get(row, 'id')
-                : undefined;
-            const stamp = typeof id === 'string' ? byId.get(id) : undefined;
-            if (typeof id !== 'string' || stamp === undefined) {
-                throw new AbloConnectionError(`${modelName}.list returned a row without matching evidence.`, { code: 'commit_no_result' });
-            }
-            capturePointRead(readSetContext, clientIdentity, modelName, id, row, stamp);
-        }
-        return page;
+        return modelList(snapshot.data, snapshot, (cursor) => list({ ...options, cursor }));
+    };
+    const listAll = async (options = {}) => {
+        const { maxPages, signal, ...readOptions } = options;
+        signal?.throwIfAborted();
+        const first = await list(readOptions);
+        return collectModelList(first, { maxPages, signal });
     };
     // Claim acquisition performs its authoritative read only after the grant.
     // Preserve that exact post-grant watermark while retaining the callable
-    // namespace and all of its state/queue/release members through the proxy.
+    // namespace and all of its state/list/queue/release/reorder members through the proxy.
     const claim = new Proxy(protocol.claim, {
         apply(target, thisArg, argArray) {
             const result = Reflect.apply(target, thisArg, argArray);
             return result.then((held) => {
-                if (held && held.readAt !== undefined) {
+                // A row-free lease (`claim(id)`) carries no snapshot: nothing to capture.
+                if (held && 'data' in held && held.readAt !== undefined) {
                     capturePointRead(readSetContext, clientIdentity, modelName, held.target.id, held.data, held.readAt);
                 }
                 return held;
@@ -184,40 +177,15 @@ function createHttpModelClient(protocol, modelName, clientIdentity, readSetConte
     });
     return {
         get,
-        retrieve: get,
+        read,
         list,
-        async create(params) {
-            const id = params.id ?? '';
-            const prepared = preparedMutation(params);
-            let row;
-            try {
-                row = await protocol.create({
-                    ...prepared.options,
-                    ...(params.id !== undefined ? { id: params.id } : {}),
-                    data: params.data,
-                });
-            }
-            catch (error) {
-                abortReadSetCommit(readSetContext, prepared.automaticCommit);
-                throw error;
-            }
-            consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
-            return row;
-        },
+        listAll,
+        create: createModel,
         update,
         async delete(params) {
-            const prepared = preparedMutation(params);
-            try {
-                await protocol.delete({ ...prepared.options, id: params.id });
-            }
-            catch (error) {
-                abortReadSetCommit(readSetContext, prepared.automaticCommit);
-                throw error;
-            }
-            consumeReadSet(readSetContext, clientIdentity, prepared.consumed, prepared.automaticCommit);
+            await protocol.delete({ ...preparedMutation(params), id: params.id });
         },
         claim,
-        track: (params) => protocol.track(params),
     };
 }
 /**
@@ -252,13 +220,36 @@ export function createAbloHttpClient(options) {
         models.set(name, created);
         return created;
     };
+    const commits = {
+        async create(commitOptions) {
+            const prepared = prepareReadSet(readSetContext, clientIdentity, commitOptions.readAt, commitOptions.idempotencyKey, commitOptions.reads);
+            return transport.commits.create({
+                operations: commitOptions.operations,
+                ...(commitOptions.claim !== undefined ? { claim: commitOptions.claim } : {}),
+                ...(commitOptions.wait !== undefined ? { wait: commitOptions.wait } : {}),
+                ...(prepared.readAt !== undefined ? { readAt: prepared.readAt } : {}),
+                ...(prepared.reads !== undefined ? { reads: prepared.reads } : {}),
+                ...(prepared.idempotencyKey !== undefined
+                    ? { idempotencyKey: prepared.idempotencyKey }
+                    : {}),
+            });
+        },
+        get: (options) => transport.commits.get(options),
+        list: (options) => transport.commits.list(options),
+    };
     const facade = new Proxy({}, {
         get(_target, prop) {
             if (prop === kReadEvidence) {
-                return { context: readSetContext, client: clientIdentity };
+                return {
+                    context: readSetContext,
+                    client: clientIdentity,
+                    onChange: transport.onChange,
+                };
             }
             if (typeof prop !== 'string')
                 return undefined;
+            if (prop === 'commits')
+                return commits;
             // Real protocol members pass through unchanged.
             if (isProtocolMember(prop)) {
                 return transport[prop];
@@ -280,4 +271,4 @@ export function createAbloHttpClient(options) {
     // method on this type is missing at runtime.
     return facade;
 }
-//# sourceMappingURL=httpClient.js.map
+//# sourceMappingURL=client.js.map

package/dist/transport/http/client.js.map

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

package/dist/transport/http/helpers.d.ts

@@ -0,0 +1,10 @@
+import { type CommitReceiptWire } from '../../commit/contract.js';
+import type { ClaimHeartbeatReply } from '../../claims/contract.js';
+import type { ModelClaim } from '../../client/resources/httpResources.js';
+import type { Claim, ClaimHeartbeat } from '../../types/streams.js';
+/** Interpret a heartbeat reply for a lease this handle currently holds. */
+export declare function heldHeartbeatReply(reply: ClaimHeartbeatReply, label: string): ClaimHeartbeat;
+export declare function parseSuccessfulCommitResponse(value: unknown, idempotencyKey: string): CommitReceiptWire;
+/** Decode the HTTP claim DTO into the public Claim shape. */
+export declare function claimFromModelClaim(claim: ModelClaim): Claim;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/transport/http/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/transport/http/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAG1E,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEpE,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,MAAM,GACZ,cAAc,CAWhB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,MAAM,GACrB,iBAAiB,CAcnB;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAiB5D"}

package/dist/transport/http/helpers.js

@@ -0,0 +1,46 @@
+import { AbloClaimedError, AbloConnectionError } from '../../errors.js';
+import { commitReceiptSchema } from '../../commit/contract.js';
+import { subTarget, streamTarget } from '../../claims/locator.js';
+import { declaredMeta } from '../../claims/meta.js';
+/** Interpret a heartbeat reply for a lease this handle currently holds. */
+export function heldHeartbeatReply(reply, label) {
+    if (reply.status === 'held' && typeof reply.expiresAt === 'number') {
+        return {
+            expiresAt: reply.expiresAt,
+            ...(reply.queueDepth !== undefined ? { queueDepth: reply.queueDepth } : {}),
+        };
+    }
+    throw new AbloClaimedError(`The lease behind ${label} is no longer held — it expired or was granted onward. Re-acquire the claim and retry; a write attempted under the old lease is rejected by its \`readAt\` guard.`, { code: 'claim_lost' });
+}
+export function parseSuccessfulCommitResponse(value, idempotencyKey) {
+    const parsed = commitReceiptSchema.safeParse(value);
+    if (!parsed.success || parsed.data.clientTxId !== idempotencyKey) {
+        throw new AbloConnectionError('The commit endpoint returned an invalid success receipt; its outcome remains pending and is safe to retry.', {
+            code: 'commit_no_result',
+            cause: parsed.success
+                ? new Error('Commit receipt clientTxId did not match its idempotency key')
+                : parsed.error,
+        });
+    }
+    return parsed.data;
+}
+/** Decode the HTTP claim DTO into the public Claim shape. */
+export function claimFromModelClaim(claim) {
+    const { meta, ...details } = subTarget(claim.target);
+    return {
+        object: 'claim',
+        id: claim.id,
+        ...(claim.status ? { status: claim.status } : {}),
+        description: claim.description ?? 'editing',
+        heldBy: claim.actor,
+        participantKind: claim.participantKind,
+        expiresAt: claim.expiresAt,
+        ...(claim.position !== undefined ? { position: claim.position } : {}),
+        target: {
+            ...streamTarget(claim.target),
+            ...details,
+            ...(meta !== undefined ? { meta: declaredMeta(meta) } : {}),
+        },
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/transport/http/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/transport/http/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAA0B,MAAM,0BAA0B,CAAC;AAGvF,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAChC,KAA0B,EAC1B,KAAa;IAEb,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACnE,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,gBAAgB,CACxB,oBAAoB,KAAK,mKAAmK,EAC5L,EAAE,IAAI,EAAE,YAAY,EAAE,CACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,cAAsB;IAEtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;QACjE,MAAM,IAAI,mBAAmB,CAC3B,4GAA4G,EAC5G;YACE,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,MAAM,CAAC,OAAO;gBACnB,CAAC,CAAC,IAAI,KAAK,CAAC,6DAA6D,CAAC;gBAC1E,CAAC,CAAC,MAAM,CAAC,KAAK;SACjB,CACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO;QACL,MAAM,EAAE,OAAO;QACf,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS;QAC3C,MAAM,EAAE,KAAK,CAAC,KAAK;QACnB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,EAAE;YACN,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;YAC7B,GAAG,OAAO;YACV,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D;KACF,CAAC;AACJ,CAAC"}

package/dist/transport/http/index.d.ts

@@ -0,0 +1,6 @@
+/** Stateless HTTP transport boundary. */
+export * from './options.js';
+export * from './client.js';
+export * from './transport.js';
+export * from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/http/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/http/index.js

@@ -0,0 +1,6 @@
+/** Stateless HTTP transport boundary. */
+export * from './options.js';
+export * from './client.js';
+export * from './transport.js';
+export * from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/http/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/{httpOptions.d.ts → http/options.d.ts}

@@ -9,12 +9,12 @@
  * TypeScript is structural, so a consumer's full options object satisfies this
  * without declaring `extends`; the composition root keeps owning its own type.
  */
-import type { Schema, SchemaRecord } from '../schema/schema.js';
-import type { AuthClientOptions } from '../auth/apiKey.js';
-import type { CoordinationObservability } from '../observability.js';
-import type { CommitOutboxScope } from '../transactions/confirmation/commitEnvelope.js';
-import type { CommitReceiptWire } from '../wire/commit.js';
-import type { DurableWriteStore, DurableWritesConfig } from '../durableWrites.js';
+import type { Schema, SchemaRecord } from '../../schema/schema.js';
+import type { AuthClientOptions } from '../../auth/apiKey.js';
+import type { CoordinationObservability } from '../../observability.js';
+import type { CommitOutboxScope } from '../../commit/confirmation/commitEnvelope.js';
+import type { CommitReceiptWire } from '../../commit/contract.js';
+import type { DurableWriteStore, DurableWritesConfig } from '../../commit/durableWrites.js';
 export interface HttpClientConfig<S extends SchemaRecord = SchemaRecord> extends AuthClientOptions {
     schema: Schema<S>;
     /** Overrides where credential exchange and bootstrap are reached. */
@@ -39,4 +39,4 @@ export interface HttpClientConfig<S extends SchemaRecord = SchemaRecord> extends
         readonly body: unknown;
     }) => void;
 }
-//# sourceMappingURL=httpOptions.d.ts.map
+//# sourceMappingURL=options.d.ts.map

package/dist/transport/{httpOptions.d.ts.map → http/options.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"httpOptions.d.ts","sourceRoot":"","sources":["../../src/transport/httpOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAGrE,SAAQ,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC9D,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,iFAAiF;IACjF,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,qDAAqD;IACrD,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE;QAC9B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,KAAK,IAAI,CAAC;CACZ"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/transport/http/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAGrE,SAAQ,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC9D,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,iFAAiF;IACjF,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,qDAAqD;IACrD,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE;QAC9B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,KAAK,IAAI,CAAC;CACZ"}

package/dist/transport/{httpOptions.js → http/options.js}

@@ -10,4 +10,4 @@
  * without declaring `extends`; the composition root keeps owning its own type.
  */
 export {};
-//# sourceMappingURL=httpOptions.js.map
+//# sourceMappingURL=options.js.map

package/dist/transport/http/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/transport/http/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/transport/http/subscription.d.ts

@@ -0,0 +1,16 @@
+import type { ReadDependency } from '../../coordination/schema.js';
+import { AbloStaleContextError } from '../../errors.js';
+export interface HttpReadOnChangeDeps {
+    readonly fetch: typeof fetch;
+    readonly endpoint: () => string;
+    readonly authHeaders: () => Promise<Record<string, string>>;
+    readonly prepare: () => Promise<void>;
+    readonly register: (controller: AbortController) => void;
+    readonly unregister: (controller: AbortController) => void;
+}
+export type HttpReadOnChange = (reads: readonly ReadDependency[], listener: (error: AbloStaleContextError) => void) => () => void;
+/** POST the existing reads and consume one `stale_context` SSE event. */
+export declare function createHttpReadOnChange(deps: HttpReadOnChangeDeps): HttpReadOnChange;
+/** Full-jitter reconnect delay; exported only for transport unit tests. */
+export declare function reconnectDelayMs(failures: number, random?: () => number): number;
+//# sourceMappingURL=subscription.d.ts.map

package/dist/transport/http/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/transport/http/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EACL,qBAAqB,EAEtB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,KAC7C,MAAM,IAAI,CAAC;AAKhB,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CA4DnF;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAc,GAAG,MAAM,CAM/E"}

package/dist/transport/http/subscription.js

@@ -0,0 +1,146 @@
+import { AbloStaleContextError, translateHttpError, } from '../../errors.js';
+const INITIAL_RECONNECT_CAP_MS = 5_000;
+const MAX_RECONNECT_DELAY_MS = 30_000;
+/** POST the existing reads and consume one `stale_context` SSE event. */
+export function createHttpReadOnChange(deps) {
+    return (reads, listener) => {
+        if (reads.length === 0)
+            return () => undefined;
+        const controller = new AbortController();
+        deps.register(controller);
+        let stopped = false;
+        const stop = () => {
+            if (stopped)
+                return;
+            stopped = true;
+            controller.abort();
+            deps.unregister(controller);
+        };
+        void (async () => {
+            let failures = 0;
+            while (!stopped) {
+                try {
+                    await deps.prepare();
+                    const response = await deps.fetch(deps.endpoint(), {
+                        method: 'POST',
+                        headers: {
+                            ...(await deps.authHeaders()),
+                            Accept: 'text/event-stream',
+                            'Cache-Control': 'no-cache',
+                            'Content-Type': 'application/json',
+                        },
+                        body: JSON.stringify({ reads }),
+                        signal: controller.signal,
+                    });
+                    if (!response.ok) {
+                        const body = await parseResponseBody(response);
+                        throw translateHttpError(response.status, body, response.headers.get('x-request-id') ?? undefined);
+                    }
+                    failures = 0;
+                    const stale = await readStaleContextEvent(response);
+                    if (stale) {
+                        stop();
+                        listener(stale);
+                        return;
+                    }
+                }
+                catch (error) {
+                    if (stopped || controller.signal.aborted)
+                        return;
+                    void error;
+                }
+                failures += 1;
+                await abortableDelay(reconnectDelayMs(failures), controller.signal);
+            }
+        })().finally(() => deps.unregister(controller));
+        return stop;
+    };
+}
+/** Full-jitter reconnect delay; exported only for transport unit tests. */
+export function reconnectDelayMs(failures, random = Math.random) {
+    const cap = Math.min(MAX_RECONNECT_DELAY_MS, INITIAL_RECONNECT_CAP_MS * 2 ** Math.max(0, failures - 1));
+    return random() * cap;
+}
+async function parseResponseBody(response) {
+    const text = await response.text();
+    if (text === '')
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+async function readStaleContextEvent(response) {
+    if (!response.body)
+        return undefined;
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    while (true) {
+        const { value, done } = await reader.read();
+        buffer += decoder.decode(value, { stream: !done });
+        let boundary = eventBoundary(buffer);
+        while (boundary) {
+            const block = buffer.slice(0, boundary.index);
+            buffer = buffer.slice(boundary.index + boundary.length);
+            const parsed = parseEventBlock(block);
+            if (parsed?.event === 'stale_context') {
+                let body;
+                try {
+                    body = JSON.parse(parsed.data);
+                }
+                catch {
+                    body = parsed.data;
+                }
+                const error = translateHttpError(409, body);
+                return error instanceof AbloStaleContextError
+                    ? error
+                    : new AbloStaleContextError(error.message, {
+                        code: 'stale_context',
+                        cause: error,
+                    });
+            }
+            boundary = eventBoundary(buffer);
+        }
+        if (done)
+            return undefined;
+    }
+}
+function eventBoundary(value) {
+    const match = /\r?\n\r?\n/.exec(value);
+    return match ? { index: match.index, length: match[0].length } : undefined;
+}
+function parseEventBlock(block) {
+    let event = 'message';
+    const data = [];
+    for (const line of block.split(/\r?\n/)) {
+        if (line.startsWith(':'))
+            continue;
+        const separator = line.indexOf(':');
+        const field = separator < 0 ? line : line.slice(0, separator);
+        let value = separator < 0 ? '' : line.slice(separator + 1);
+        if (value.startsWith(' '))
+            value = value.slice(1);
+        if (field === 'event')
+            event = value;
+        if (field === 'data')
+            data.push(value);
+    }
+    return data.length > 0 ? { event, data: data.join('\n') } : undefined;
+}
+async function abortableDelay(ms, signal) {
+    if (signal.aborted)
+        return;
+    await new Promise((resolve) => {
+        const timer = setTimeout(done, ms);
+        signal.addEventListener('abort', done, { once: true });
+        function done() {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', done);
+            resolve();
+        }
+    });
+}
+//# sourceMappingURL=subscription.js.map

package/dist/transport/http/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../../src/transport/http/subscription.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAgBzB,MAAM,wBAAwB,GAAG,KAAK,CAAC;AACvC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,yEAAyE;AACzE,MAAM,UAAU,sBAAsB,CAAC,IAA0B;IAC/D,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QAE/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC,CAAC;QAEF,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,OAAO,CAAC,OAAO,EAAE,CAAC;gBAChB,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;oBACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE;wBACjD,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE;4BACP,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;4BAC7B,MAAM,EAAE,mBAAmB;4BAC3B,eAAe,EAAE,UAAU;4BAC3B,cAAc,EAAE,kBAAkB;yBACnC;wBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;wBAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B,CAAC,CAAC;oBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;wBACjB,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;wBAC/C,MAAM,kBAAkB,CACtB,QAAQ,CAAC,MAAM,EACf,IAAI,EACJ,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS,CAClD,CAAC;oBACJ,CAAC;oBAED,QAAQ,GAAG,CAAC,CAAC;oBACb,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;oBACpD,IAAI,KAAK,EAAE,CAAC;wBACV,IAAI,EAAE,CAAC;wBACP,QAAQ,CAAC,KAAK,CAAC,CAAC;wBAChB,OAAO;oBACT,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;wBAAE,OAAO;oBACjD,KAAK,KAAK,CAAC;gBACb,CAAC;gBAED,QAAQ,IAAI,CAAC,CAAC;gBACd,MAAM,cAAc,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YACtE,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QAEhD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAClB,sBAAsB,EACtB,wBAAwB,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAC1D,CAAC;IACF,OAAO,MAAM,EAAE,GAAG,GAAG,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,QAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,QAAQ,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,MAAM,EAAE,KAAK,KAAK,eAAe,EAAE,CAAC;gBACtC,IAAI,IAAa,CAAC;gBAClB,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAY,CAAC;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACrB,CAAC;gBACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC5C,OAAO,KAAK,YAAY,qBAAqB;oBAC3C,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,IAAI,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE;wBACvC,IAAI,EAAE,eAAe;wBACrB,KAAK,EAAE,KAAK;qBACb,CAAC,CAAC;YACT,CAAC;YACD,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,IAAI;YAAE,OAAO,SAAS,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAK,GAAG,SAAS,CAAC;IACtB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,OAAO;YAAE,KAAK,GAAG,KAAK,CAAC;QACrC,IAAI,KAAK,KAAK,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,EAAU,EAAE,MAAmB;IAC3D,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO;IAC3B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,SAAS,IAAI;YACX,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}