@abloatai/transaction 0.56.0 → 0.58.0

package/dist/{resources → client/resources}/httpResources.d.ts

@@ -4,30 +4,31 @@
  * {@link HttpClaimApi} derivation. This module holds only types and has no runtime
  * imports.
  */
-import type { ClaimHeartbeatAckPayload, OnStaleMode, ReadDependency, TrackDependency } from '../coordination/schema.js';
-import type { ClaimHeartbeatReply, ClaimState } from '../wire/claims.js';
-import type { ClientCommitReceipt, CommitWait, CommitRecord, CommitRecordList, CommitRecordListOptions } from '../wire/commit.js';
-import type { LogListResponse, LogQuery } from '../wire/feedEvent.js';
-import type { ModelListEvidence } from '../wire/modelResponses.js';
+import type { ClaimHeartbeatAckPayload, ReadDependency } from '../../coordination/schema.js';
+import type { ClaimHeartbeatReply, ClaimState } from '../../claims/contract.js';
+import type { ClientCommitReceipt, CommitWait, CommitRecord, CommitRecordList, CommitRecordListOptions, CommitOperationBody, ModelOperationAction } from '../../commit/contract.js';
+import type { LogListResponse, LogQuery } from '../../observation/feedContract.js';
+import type { ModelListEvidence } from '../../wire/modelResponses.js';
 export type { CommitWait };
-import type { ModelTarget, ModelClaim } from '../coordination/schema.js';
+import type { ModelTarget, ModelClaim } from '../../coordination/schema.js';
 export type { ModelTarget, ModelClaim };
-import type { ResolveClaimMeta } from '../types/global.js';
-import type { SchemaRecord } from '../schema/schema.js';
-import type { SyncGroupInput } from '../schema/roles.js';
-import type { CapabilityCan, CapabilityOperation, EffectiveAuthority } from '../auth/capability.js';
-import type { Claim, ClaimStream, ClaimWaitOptions, Duration, HeldClaim } from '../types/streams.js';
+import type { ResolveClaimMeta } from '../../types/global.js';
+import type { SchemaRecord } from '../../schema/schema.js';
+import type { SyncGroupInput } from '../../schema/roles.js';
+import type { CapabilityCan, CapabilityOperation, EffectiveAuthority } from '../../auth/capability.js';
+import type { Claim, ClaimStream, ClaimWaitOptions, Duration } from '../../types/streams.js';
 import type { ModelUpdater, FunctionalUpdateOptions } from './functionalUpdate.js';
-import type { ClaimOptions, ClaimAttemptEvent, ClaimParams, ClaimSkipParams, ClaimReadApi, AwaitedClaimMethod, ModelTrackParams, ModelTrackResult, ServerReadOptions } from './modelOperations.js';
+import type { ClaimOptions, ClaimAttemptEvent, ClaimCall, ClaimReadApi, AwaitedClaimMethod, ModelCreateManyParams, ServerReadOptions } from './modelOperations.js';
 /**
  * The operations available on each model in the sync engine:
- *   `get({ id })` — an async single-row server read
+ *   `get({ id })` — an observational async single-row server read
+ *   `read({ id })` — an async single-row server read that may guard a write
  *   `list({ where })` — an async collection server read
  *   `local.get(id)` / `local.list(...)` / `local.count(...)` — synchronous local reads
  *   `create({ data })` / `update({ id, data })` / `delete({ id })` — writes
  *   `claim({ id })` — a durable claim handle for coordinated writes
  */
-export type ModelOperationAction = 'create' | 'update' | 'delete' | 'archive' | 'unarchive';
+export type { ModelOperationAction };
 /** @internal Transport envelope; the public typed client returns the row. */
 export interface HttpTransportRead<T = Record<string, unknown>> {
     /**
@@ -71,12 +72,40 @@ export interface HttpTransportList<T = Record<string, unknown>> {
  * and a complete one the same value, so the caller with 500 matching rows got
  * 20 and no way to find out.
  */
-export type ModelList<T> = T[] & Pick<HttpTransportList<T>, 'hasMore' | 'nextCursor'>;
+export type ModelList<T> = T[] & Pick<HttpTransportList<T>, 'hasMore' | 'nextCursor'> & AsyncIterable<T>;
+export interface ModelListWalkOptions {
+    readonly maxPages?: number;
+    readonly signal?: AbortSignal;
+}
+/** Collect a complete list through the same guarded cursor loop as async iteration. */
+export declare function collectModelList<T>(first: ModelList<T>, options?: ModelListWalkOptions): Promise<T[]>;
 /**
- * Attach the page state to the rows. Non-enumerable so the result stays
- * indistinguishable from a plain array everywhere the properties aren't read.
+ * Attach the page state to the rows, and make the list walk its own pages.
+ *
+ * `hasMore` and `nextCursor` are non-enumerable, so the result stays
+ * indistinguishable from a plain array everywhere they are not read: it maps,
+ * filters, spreads, and `JSON.stringify`s exactly as the rows always did.
+ *
+ * The async iterator is the answer to the question that shape raises. A list
+ * read is a page — the server applies a default size and caps the largest —
+ * and a page of 20 looks precisely like a complete answer of 20, so every
+ * caller either checked `hasMore` or, far more often, reasoned about a
+ * truncated set without knowing it. Hand-rolled page walkers were the common
+ * result, and each one re-derived the same cursor loop and the same
+ * non-advancing-cursor guard.
+ *
+ * So iterate the value to get the page, and `for await` it to get the
+ * collection:
+ *
+ * ```ts
+ * const page = await ablo.issue.list({ where: { teamId } });
+ * for (const issue of page) …            // the 20 rows that came back
+ * for await (const issue of page) …      // every issue, paged as it goes
+ * ```
  */
-export declare function modelList<T>(rows: readonly T[], page: Pick<HttpTransportList<unknown>, 'hasMore' | 'nextCursor'>): ModelList<T>;
+export declare function modelList<T>(rows: readonly T[], page: Pick<HttpTransportList<unknown>, 'hasMore' | 'nextCursor'>, 
+/** Reads the page after `cursor`. Omitted where no transport can follow. */
+fetchNext?: (cursor: string) => Promise<ModelList<T>>): ModelList<T>;
 export type IfClaimedPolicy = 'return' | 'fail';
 export interface ClaimedOptions {
     /**
@@ -87,7 +116,7 @@ export interface ClaimedOptions {
      */
     readonly ifClaimed?: IfClaimedPolicy;
 }
-export type { ClaimWaitOptions } from '../types/streams.js';
+export type { ClaimWaitOptions } from '../../types/streams.js';
 export interface ModelReadOptions extends ClaimedOptions {
 }
 /**
@@ -132,34 +161,20 @@ export interface ClaimCreateOptions {
     /** Request-scoped queued / granted / skipped / failed status events. */
     readonly onStatus?: (event: ClaimAttemptEvent) => void;
 }
-export interface CommitOperationInput {
-    readonly action: ModelOperationAction;
-    /** The model name — matches `ablo.<model>` and the schema's `model()`. */
-    readonly model: string;
-    readonly id?: string | null;
-    readonly data?: Record<string, unknown> | null;
-    readonly where?: Record<string, unknown> | null;
-    readonly transactionId?: string | null;
-    /** Claim identity derived from a held claim; not an application id. */
-    readonly claimId?: string | null;
-    readonly readAt?: number | null;
-    readonly onStale?: OnStaleMode | null;
-    /** Fencing token (Option B) from the batch's claim handle; server-validated. */
-    readonly fenceToken?: number | null;
-}
-export interface CommitCreateOptions {
+/** Public commit operation inferred from the canonical request-body schema. */
+export type CommitOperationInput = CommitOperationBody;
+export type CommitClaim = Omit<Claim<unknown>, 'data'>;
+export interface CommitCreateOptions<Read = ReadDependency> {
     readonly idempotencyKey?: string | null;
     readonly readAt?: number | null;
-    readonly onStale?: OnStaleMode | null;
     /**
      * A claim handle from `ablo.<model>.claim({ id })` (or the HTTP claim
      * surface). Same vocabulary as the per-model writes: the handle's
-     * snapshot watermark becomes the batch `readAt` default and `onStale`
-     * defaults to `'reject'`, so a commit that follows a claim is guarded
+     * snapshot watermark becomes the batch `readAt` default, so a commit that follows a claim is guarded
      * against concurrent edits without re-stating the watermark by hand.
-     * Explicit `readAt`/`onStale` on the options win.
+     * An explicit `readAt` on the options wins.
      */
-    readonly claim?: Claim | null;
+    readonly claim?: CommitClaim | null;
     /** One atomic batch. Use a one-element array for a single operation. */
     readonly operations: readonly CommitOperationInput[];
     readonly wait?: CommitWait;
@@ -167,25 +182,15 @@ export interface CommitCreateOptions {
      * The batch premise — the "did anything I looked at change?" guard.
      * Declare the rows (`{ model, id, readAt, fields? }`) or sync groups
      * (`{ group, readAt }`, for example `report:abc`) this batch was premised on; the
-     * server checks that none moved since `readAt` and fires the entry's `onStale`
-     * over the batch. This is distinct from the write-target `readAt`: it guards what
+     * server rejects the batch if any moved since `readAt`. This is distinct from the write-target `readAt`: it guards what
      * you read, not what you write.
      */
-    readonly reads?: readonly ReadDependency[] | null;
-    /**
-     * Durable premises to register as part of this batch — the persisted
-     * sibling of `reads`. Where `reads` guards only this commit, a `track` entry
-     * (`{ model, id, readAt? }` for a row or `{ group, readAt? }` for a sync group)
-     * lives on past it: a later matching change rides back on a future receipt's
-     * `notifications`. A track-only batch (just `track`, an empty `operations`) is
-     * the batch form of `ablo.<model>.track()`.
-     */
-    readonly track?: readonly TrackDependency[] | null;
+    readonly reads?: readonly Read[] | null;
 }
 /** Public projection inferred from the canonical runtime schema. */
 export type CommitReceipt = ClientCommitReceipt;
-export interface CommitResource {
-    create(options: CommitCreateOptions): Promise<CommitReceipt>;
+export interface CommitResource<Read = ReadDependency> {
+    create(options: CommitCreateOptions<Read>): Promise<CommitReceipt>;
     get(options: {
         readonly id: string;
     }): Promise<CommitRecord | null>;
@@ -253,17 +258,17 @@ export interface HttpClaimsResource {
     }): Promise<void>;
 }
 export interface ModelMutationOptions extends ClaimedOptions {
-    readonly claimRef?: string | {
-        readonly id: string;
-    } | null;
     readonly idempotencyKey?: string | null;
-    readonly readAt?: number | null;
-    readonly onStale?: OnStaleMode | null;
     /** Commit-lifetime read dependencies checked before this mutation lands. */
     readonly reads?: readonly ReadDependency[] | null;
-    /** Persisted read dependencies registered by this mutation. */
-    readonly track?: readonly TrackDependency[] | null;
     readonly claim?: Claim | ClaimOptions | null;
+}
+/** Internal fields derived from a claim or functional update, never authored on a model write. */
+export interface InternalModelMutationOptions extends ModelMutationOptions {
+    readonly claimRef?: string | {
+        readonly id: string;
+    } | null;
+    readonly readAt?: number | null;
     /** Fencing token (Option B) from the claim; server-validated at commit. */
     readonly fenceToken?: number | null;
 }
@@ -273,7 +278,7 @@ export interface ModelMutationOptions extends ClaimedOptions {
  * namespace for multi-step handles and coordination screens.
  *
  * It is the same surface as the reactive claim API, but because every read is a
- * server round-trip, `state`, `queue`, and `reorder` are awaited here. The
+ * server round-trip, `state`, `list`, `queue`, and `reorder` are awaited here. The
  * WebSocket client resolves those synchronously from its local cache, which is what
  * lets it read a claim's state inside a React render; a stateless client has no
  * cache to read, so the promise is unavoidable.
@@ -281,9 +286,9 @@ export interface ModelMutationOptions extends ClaimedOptions {
  * It is derived from `ClaimReadApi` through {@link AwaitedClaimMethod} so the two
  * transports cannot drift: the only difference is the promise wrapper that
  * statelessness forces. `claim({ id })` is identical on both (already async);
- * `state`, `queue`, `reorder`, and `release` are the awaited form.
+ * `state`, `list`, `queue`, `reorder`, and `release` are the awaited form.
  */
-export type HttpClaimApi<T = Record<string, unknown>, Fields = T> = ((params: ClaimSkipParams<Fields>) => Promise<HeldClaim<T> | null>) & ((params: ClaimParams<Fields>) => Promise<HeldClaim<T>>) & {
+export type HttpClaimApi<T = Record<string, unknown>, Fields = T> = ClaimCall<T, Fields> & {
     [K in keyof ClaimReadApi<T>]: AwaitedClaimMethod<ClaimReadApi<T>[K]>;
 };
 /** @internal String-keyed model routing owned by the private HTTP transport. */
@@ -297,12 +302,7 @@ export interface HttpTransportModel<T = Record<string, unknown>, Fields = T> {
      *
      * Public callers never see this shape; `createAbloHttpClient` unwraps it.
      */
-    /** Canonical point lookup for the schema-agnostic transport. */
-    get(params: ModelReadOptions & {
-        readonly id: string;
-    }): Promise<HttpTransportRead<T>>;
-    /** @deprecated Use `get({ id })`; retained for the private transport compatibility seam. */
-    retrieve(params: ModelReadOptions & {
+    read(params: ModelReadOptions & {
         readonly id: string;
     }): Promise<HttpTransportRead<T>>;
     /**
@@ -321,6 +321,12 @@ export interface HttpTransportModel<T = Record<string, unknown>, Fields = T> {
         readonly data: Record<string, unknown>;
         readonly id?: string | null;
     }): Promise<T>;
+    /**
+     * Creates many rows as one atomic commit and returns them, in the caller's
+     * order. One rejected row declines the batch. The rows are the server's own,
+     * carried back on the commit rather than read again afterwards.
+     */
+    createMany(params: ModelCreateManyParams<Record<string, unknown>>): Promise<T[]>;
     update(params: ModelMutationOptions & {
         readonly id: string;
         readonly data: Record<string, unknown>;
@@ -345,13 +351,6 @@ export interface HttpTransportModel<T = Record<string, unknown>, Fields = T> {
      * schema-agnostic shape stays inside the HTTP transport.
      */
     claim: HttpClaimApi<T, Fields>;
-    /**
-     * Registers a durable premise on a row — request/response, no socket. A track
-     * declares what a caller is watching; it keeps no local copy of the row, so it
-     * belongs to every transport rather than to the reactive client (ADR 0013 §4).
-     * The typed public clients expose it as `ablo.<model>.track`.
-     */
-    track(params: ModelTrackParams): Promise<ModelTrackResult>;
 }
 /** A single data operation a scoped **agent** session may perform on a model.
  *  The SDK-facing name for {@link CapabilityOperation}; the vocabulary itself is
@@ -401,6 +400,15 @@ export interface CreateAgentSessionParams<S extends SchemaRecord> {
     agent: {
         id: string;
     };
+    /** The authenticated person who started this agent run. The backend holding
+     *  the secret key attests this identity, and every resulting delta records
+     *  the agent as actor plus this user as `onBehalfOf`. Persist the user id on
+     *  durable work before enqueueing it so a later worker can supply it here. */
+    onBehalfOf?: {
+        readonly user: {
+            readonly id: string;
+        };
+    };
     /** Per-model operation allowlist, typed against the schema's model names. */
     can: CapabilityCan<S>;
     /** Sync groups this session may subscribe to — typed (`'default'` or
@@ -429,6 +437,13 @@ export interface CreateAgentClientParams<S extends SchemaRecord> {
      *  Pass a stable string only when one logical agent must re-attach to its own
      *  held claims across reconnects or restarts. */
     id?: string;
+    /** The authenticated person who started this run. Preserving it on durable
+     *  work and supplying it here gives every write dual-principal attribution. */
+    onBehalfOf?: {
+        readonly user: {
+            readonly id: string;
+        };
+    };
     /** A human-readable label for logs and attribution (carried in `userMeta.name`).
      *  It is independent of `id`: two agents that share a `name` still receive
      *  distinct ids and coordinate as separate participants — `name` never derives or

package/dist/client/resources/httpResources.d.ts.map

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

package/dist/client/resources/httpResources.js

@@ -0,0 +1,94 @@
+/**
+ * Shared resource types for the typed clients and private HTTP transport.
+ * the commit and claim shapes, the session-mint params and resource, and the
+ * {@link HttpClaimApi} derivation. This module holds only types and has no runtime
+ * imports.
+ */
+import { AbloValidationError } from '../../errors.js';
+/**
+ * How far a `for await` over a list will walk before it gives up.
+ *
+ * A cursor that stops advancing would otherwise spin forever. The bound is
+ * high enough that no real collection reaches it and low enough that a broken
+ * server is a failed read rather than a hung process.
+ */
+const AUTO_PAGE_LIMIT = 10_000;
+const LIST_ALL_PAGE_LIMIT = 100;
+const nextPageFor = new WeakMap();
+async function* walkModelList(first, options = {}) {
+    const maxPages = options.maxPages ?? AUTO_PAGE_LIMIT;
+    if (!Number.isInteger(maxPages) || maxPages < 1) {
+        throw new AbloValidationError('maxPages must be a positive integer.', {
+            code: 'invalid_options',
+            param: 'maxPages',
+        });
+    }
+    let current = first;
+    for (let visited = 0; visited < maxPages; visited += 1) {
+        options.signal?.throwIfAborted();
+        for (let i = 0; i < current.length; i += 1) {
+            options.signal?.throwIfAborted();
+            yield current[i];
+        }
+        const cursor = current.nextCursor;
+        const fetchNext = nextPageFor.get(current);
+        if (!current.hasMore || cursor === null || fetchNext === undefined)
+            return;
+        const next = await fetchNext(cursor);
+        if (next.nextCursor === cursor) {
+            throw new AbloValidationError(`Walking this list received the same continuation cursor twice (${JSON.stringify(cursor)}). ` +
+                'The collection may be incomplete, so traversal stopped with an error.', { code: 'malformed_response', param: 'nextCursor' });
+        }
+        current = next;
+    }
+    throw new AbloValidationError(`Walking this list passed ${maxPages} pages without reaching the end. ` +
+        `Narrow the read with \`where\` or raise \`maxPages\` deliberately.`, { code: 'invalid_options', param: 'maxPages' });
+}
+/** Collect a complete list through the same guarded cursor loop as async iteration. */
+export async function collectModelList(first, options = {}) {
+    const rows = [];
+    for await (const row of walkModelList(first, {
+        maxPages: options.maxPages ?? LIST_ALL_PAGE_LIMIT,
+        signal: options.signal,
+    }))
+        rows.push(row);
+    return rows;
+}
+/**
+ * Attach the page state to the rows, and make the list walk its own pages.
+ *
+ * `hasMore` and `nextCursor` are non-enumerable, so the result stays
+ * indistinguishable from a plain array everywhere they are not read: it maps,
+ * filters, spreads, and `JSON.stringify`s exactly as the rows always did.
+ *
+ * The async iterator is the answer to the question that shape raises. A list
+ * read is a page — the server applies a default size and caps the largest —
+ * and a page of 20 looks precisely like a complete answer of 20, so every
+ * caller either checked `hasMore` or, far more often, reasoned about a
+ * truncated set without knowing it. Hand-rolled page walkers were the common
+ * result, and each one re-derived the same cursor loop and the same
+ * non-advancing-cursor guard.
+ *
+ * So iterate the value to get the page, and `for await` it to get the
+ * collection:
+ *
+ * ```ts
+ * const page = await ablo.issue.list({ where: { teamId } });
+ * for (const issue of page) …            // the 20 rows that came back
+ * for await (const issue of page) …      // every issue, paged as it goes
+ * ```
+ */
+export function modelList(rows, page, 
+/** Reads the page after `cursor`. Omitted where no transport can follow. */
+fetchNext) {
+    const list = Object.defineProperties([...rows], {
+        hasMore: { value: page.hasMore, enumerable: false },
+        nextCursor: { value: page.nextCursor, enumerable: false },
+        [Symbol.asyncIterator]: { value: () => walkModelList(list), enumerable: false },
+    });
+    if (fetchNext) {
+        nextPageFor.set(list, fetchNext);
+    }
+    return list;
+}
+//# sourceMappingURL=httpResources.js.map

package/dist/client/resources/httpResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpResources.js","sourceRoot":"","sources":["../../../src/client/resources/httpResources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA0GtD;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,WAAW,GAAG,IAAI,OAAO,EAA2D,CAAC;AAO3F,KAAK,SAAS,CAAC,CAAC,aAAa,CAC3B,KAAmB,EACnB,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,mBAAmB,CAAC,sCAAsC,EAAE;YACpE,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,MAAM,OAAO,CAAC,CAAC,CAAM,CAAC;QACxB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;QAClC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAE5B,CAAC;QACd,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO;QAC3E,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,mBAAmB,CAC3B,kEAAkE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK;gBAC3F,uEAAuE,EACzE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,YAAY,EAAE,CACpD,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,QAAQ,mCAAmC;QACrE,oEAAoE,EACtE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,CAC/C,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAmB,EACnB,UAAgC,EAAE;IAElC,MAAM,IAAI,GAAQ,EAAE,CAAC;IACrB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE;QAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,mBAAmB;QACjD,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,SAAS,CACvB,IAAkB,EAClB,IAAgE;AAChE,4EAA4E;AAC5E,SAAqD;IAErD,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE;QAC9C,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE;QACnD,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE;QACzD,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE;KAChF,CAAiB,CAAC;IACnB,IAAI,SAAS,EAAE,CAAC;QACd,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,SAA4D,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/client/resources/modelCreate.d.ts

@@ -0,0 +1,21 @@
+/** Canonical create identity and result correlation shared by every client. */
+import type { CommitOperationResult } from '../../commit/contract.js';
+/** Resolve the two supported single-create id spellings. The sibling wins. */
+export declare function resolveCreateId(explicitId: string | null | undefined, data: unknown): string | undefined;
+/** Stable across transports and client instances when an idempotency key is supplied. */
+export declare function createModelId(modelName: string, idempotencyKey?: string | null): string;
+/**
+ * Return server-authored create rows in input order.
+ *
+ * Fresh receipts carry operationResults. Durable idempotency replays redact
+ * row data, so that path verifies every expected id with a point read. It may
+ * fail under a write-only policy, but it can never report a partial collection
+ * as success.
+ */
+export declare function resolveCreatedRows<T>(input: {
+    readonly modelName: string;
+    readonly ids: readonly string[];
+    readonly operationResults?: readonly CommitOperationResult[];
+    readonly readRow: (id: string) => Promise<T | undefined>;
+}): Promise<T[]>;
+//# sourceMappingURL=modelCreate.d.ts.map

package/dist/client/resources/modelCreate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCreate.d.ts","sourceRoot":"","sources":["../../../src/client/resources/modelCreate.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAI/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,IAAI,EAAE,OAAO,GACZ,MAAM,GAAG,SAAS,CAOpB;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CAC1D,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAwBf"}

package/dist/client/resources/modelCreate.js

@@ -0,0 +1,49 @@
+/** Canonical create identity and result correlation shared by every client. */
+import { v5 as uuidv5 } from 'uuid';
+import { AbloConnectionError } from '../../errors.js';
+/** Resolve the two supported single-create id spellings. The sibling wins. */
+export function resolveCreateId(explicitId, data) {
+    if (typeof explicitId === 'string' && explicitId.length > 0)
+        return explicitId;
+    const inData = typeof data === 'object' && data !== null
+        ? data.id
+        : undefined;
+    return typeof inData === 'string' && inData.length > 0 ? inData : undefined;
+}
+/** Stable across transports and client instances when an idempotency key is supplied. */
+export function createModelId(modelName, idempotencyKey) {
+    if (idempotencyKey) {
+        return uuidv5(`${modelName}:${idempotencyKey}`, 'aa4ba6d4-bf0b-5b38-9c45-116f79a6e548');
+    }
+    return typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
+        ? crypto.randomUUID()
+        : `id_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+/**
+ * Return server-authored create rows in input order.
+ *
+ * Fresh receipts carry operationResults. Durable idempotency replays redact
+ * row data, so that path verifies every expected id with a point read. It may
+ * fail under a write-only policy, but it can never report a partial collection
+ * as success.
+ */
+export async function resolveCreatedRows(input) {
+    if (input.operationResults?.length === input.ids.length) {
+        const byId = new Map(input.operationResults.map((result) => [
+            result.row.id,
+            result.row,
+        ]));
+        const ordered = input.ids.map((id) => byId.get(id));
+        if (ordered.every((row) => row !== undefined)) {
+            return ordered;
+        }
+    }
+    const rows = await Promise.all(input.ids.map((id) => input.readRow(id)));
+    const missing = input.ids.filter((_id, index) => rows[index] === undefined);
+    if (missing.length > 0) {
+        throw new AbloConnectionError(`${input.modelName} create confirmed, but ${missing.length} of ${input.ids.length} ` +
+            'server rows could not be recovered from its receipt or verified by id.', { code: 'commit_no_result', details: { missingIds: missing } });
+    }
+    return rows;
+}
+//# sourceMappingURL=modelCreate.js.map

package/dist/client/resources/modelCreate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCreate.js","sourceRoot":"","sources":["../../../src/client/resources/modelCreate.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAC7B,UAAqC,EACrC,IAAa;IAEb,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/E,MAAM,MAAM,GACV,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QACvC,CAAC,CAAE,IAAkC,CAAC,EAAE;QACxC,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,cAA8B;IAE9B,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,MAAM,CACX,GAAG,SAAS,IAAI,cAAc,EAAE,EAChC,sCAAsC,CACvC,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;QAC7E,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE;QACrB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAI,KAK3C;IACC,IAAI,KAAK,CAAC,gBAAgB,EAAE,MAAM,KAAK,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,GAAiC,CAAC,EAAE;YAC5C,MAAM,CAAC,GAAG;SACX,CAAC,CACH,CAAC;QACF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAkC,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,EAAE,CAAC;YAC9E,OAAO,OAAc,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;IAC5E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,mBAAmB,CAC3B,GAAG,KAAK,CAAC,SAAS,0BAA0B,OAAO,CAAC,MAAM,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG;YAClF,wEAAwE,EAC1E,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,IAAW,CAAC;AACrB,CAAC"}