hikoutei 0.3.4 → 0.3.6

package/dist/application/sync/sheets/conflictProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflictProjection.js","sourceRoot":"","sources":["../../../../src/application/sync/sheets/conflictProjection.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAGrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,aAAa;IACb,mBAAmB;IACnB,UAAU;IACV,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,oBAAoB;IACpB,8BAA8B;IAC9B,iCAAiC;IACjC,yBAAyB;IACzB,4BAA4B;IAC5B,iBAAiB;IACjB,QAAQ;IACR,YAAY;IACZ,uBAAuB;CACf,CAAC;AAEX,uEAAuE;AACvE,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,CAAC;AAE/D,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,aAAa;CAClB,CAAC;AAEX,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAC1C,QAAsB,EACtB,UAAkD;IAElD,OAAO;QACL,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5C,iBAAiB,EAAE,QAAQ,CAAC,eAAe,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO;YACzE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC;YAC5C,CAAC,CAAC,IAAI;QACR,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QACtC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC1C,UAAU,EAAE,QAAQ,CAAC,SAAS;QAC9B,kBAAkB,EAAE,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACzD,4BAA4B,EAAE,QAAQ,CAAC,yBAAyB;QAChE,+BAA+B,EAAE,UAAU,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAClF,uBAAuB,EAAE,QAAQ,CAAC,qBAAqB;QACvD,0BAA0B,EAAE,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACzE,eAAe,EAAE,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC;QACpD,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnC,UAAU,EAAE,UAAU,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;QAC7D,qBAAqB,EAAE,QAAQ,CAAC,mBAAmB,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO;YACjF,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC;YAChD,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;AACvD,CAAC"}

package/dist/application/sync/{gateway → sheets}/conflictProjectionRegistration.d.ts

@@ -3,7 +3,7 @@ import { type RegisteredSyncSheet } from "../../../infrastructure/storage/index.
 import type { SqlStorageAdapter } from "../../../adapter/persistence/contracts/sql.js";
 import type { RegisteredTypedSheetsMappedProjection, TypedSheetsEntityWriterOptions } from "../../orm/persistence/support/contracts.js";
 import type { InternalSyncProjectionConfig } from "../service/contracts.js";
-import type { RegisteredSyncProjectionDefinition } from "./SyncGatewayBootstrap.js";
+import type { RegisteredSyncProjectionDefinition } from "./sheetsProvisioning.js";
 /** Registers all conflict routes under one writer fence for a mapped runtime. */
 export declare function registerSyncConflictProjectionRoutes(storage: SqlStorageAdapter, registrations: readonly RegisteredTypedSheetsMappedProjection[], projections: InternalSyncProjectionConfig, writerInput: TypedSheetsEntityWriterOptions): Promise<readonly RegisteredSyncProjectionDefinition[]>;
 /** Returns the registered conflict route for one logical entity sheet. */

package/dist/application/sync/sheets/conflictProjectionRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflictProjectionRegistration.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/sheets/conflictProjectionRegistration.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAGL,KAAK,mBAAmB,EAGzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAQvF,OAAO,KAAK,EACV,qCAAqC,EACrC,8BAA8B,EAC/B,MAAM,4CAA4C,CAAC;AAIpD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAO5E,OAAO,KAAK,EACV,kCAAkC,EACnC,MAAM,yBAAyB,CAAC;AAEjC,iFAAiF;AACjF,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,SAAS,qCAAqC,EAAE,EAC/D,WAAW,EAAE,4BAA4B,EACzC,WAAW,EAAE,8BAA8B,GAC1C,OAAO,CAAC,SAAS,kCAAkC,EAAE,CAAC,CA6DxD;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,SAAS,kCAAkC,EAAE,EAC1D,cAAc,EAAE,MAAM,GACrB,mBAAmB,CAYrB"}

package/dist/application/sync/{gateway → sheets}/conflictProjectionRegistration.js

@@ -3,7 +3,7 @@ import { claimWriterLeaseWithSql, registerSyncSheetWithSql, WRITER_LEASE_CLAIM_R
 import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../orm/errors.js";
 import { serializeTypedSheetsEntityOwnershipManifest, } from "../../orm/mapping/projection.js";
 import { resolveTypedSheetsEntityWriterOptions, } from "../../orm/persistence/flush/flushCoordinator.js";
-import { SYNC_GATEWAY_PROJECTIONS, } from "./constants.js";
+import { SYNC_PROJECTIONS, } from "./constants.js";
 import { SYNC_CONFLICT_PROJECTION_HEADERS, } from "./conflictProjection.js";
 /** Registers all conflict routes under one writer fence for a mapped runtime. */
 export async function registerSyncConflictProjectionRoutes(storage, registrations, projections, writerInput) {
@@ -40,7 +40,7 @@ export async function registerSyncConflictProjectionRoutes(storage, registration
                 spreadsheetId: projections.spreadsheetId,
                 tabName: config.syncConflicts.tabName,
                 registeredRange: config.syncConflicts.registeredRange,
-                projection: SYNC_GATEWAY_PROJECTIONS.SYNC_CONFLICTS,
+                projection: SYNC_PROJECTIONS.SYNC_CONFLICTS,
                 schemaVersion: registration.mapping.schemaVersion,
                 ownershipManifestJson: serializeTypedSheetsEntityOwnershipManifest(registration.mapping),
                 businessKeyField: registration.mapping.businessKey.fieldName,
@@ -61,7 +61,7 @@ export async function registerSyncConflictProjectionRoutes(storage, registration
 /** Returns the registered conflict route for one logical entity sheet. */
 export function conflictProjectionSheet(definitions, logicalSheetId) {
     const definition = definitions.find((candidate) => candidate.sheet.logicalSheetId === logicalSheetId &&
-        candidate.sheet.projection === SYNC_GATEWAY_PROJECTIONS.SYNC_CONFLICTS);
+        candidate.sheet.projection === SYNC_PROJECTIONS.SYNC_CONFLICTS);
     if (definition === undefined) {
         throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, `no Sync_Conflicts projection is registered for ${logicalSheetId}.`);
     }

package/dist/application/sync/sheets/conflictProjectionRegistration.js.map

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

package/dist/application/sync/sheets/constants.d.ts

@@ -0,0 +1,66 @@
+import type { RegisteredProjectionKind } from "../../../domain/model/constants.js";
+/** Protocol versions understood by the sync provider contract. */
+export declare const SYNC_PROTOCOL_VERSIONS: {
+    readonly V1: "typed-sheets-sync-v1";
+};
+export type SyncProtocolVersion = (typeof SYNC_PROTOCOL_VERSIONS)[keyof typeof SYNC_PROTOCOL_VERSIONS];
+/** Projection labels accepted by the runtime provider contract. */
+export declare const SYNC_PROJECTIONS: {
+    readonly USER_INPUT: "user_input";
+    readonly SYSTEM_STATE: "system_state";
+    readonly SYNC_CONFLICTS: "sync_conflicts";
+};
+export type SyncProjectionKind = RegisteredProjectionKind;
+/** Detail level used by normalized Sheet observation reads. */
+export declare const SYNC_SNAPSHOT_READ_MODES: {
+    /** Reads formula, merge, error, and stable-cell metadata for reconciliation. */
+    readonly FULL: "full";
+    /** Reads only user-editable literal values and row identity for polling. */
+    readonly USER_INPUT: "user_input";
+};
+export type SyncSnapshotReadMode = (typeof SYNC_SNAPSHOT_READ_MODES)[keyof typeof SYNC_SNAPSHOT_READ_MODES];
+/** Effect kinds that require special handling at the provider boundary. */
+export declare const SYNC_DELETE_EFFECT_KINDS: {
+    readonly RESOLUTION_DELETE: "resolution_delete";
+    readonly USER_INPUT_DELETE: "user_input_delete";
+};
+/** Terminal and retryable statuses returned for one provider effect. */
+export declare const SYNC_EFFECT_RESULT_STATUSES: {
+    readonly APPLIED: "applied";
+    readonly ALREADY_APPLIED: "already_applied";
+    readonly SUPERSEDED: "superseded";
+    readonly GUARD_MISMATCH: "guard_mismatch";
+    readonly REPAIR_REOBSERVE: "repair_reobserve";
+    readonly SCHEMA_ERROR: "schema_error";
+    readonly RETRYABLE_ERROR: "retryable_error";
+};
+export type SyncEffectResultStatus = (typeof SYNC_EFFECT_RESULT_STATUSES)[keyof typeof SYNC_EFFECT_RESULT_STATUSES];
+/** Result label returned when a fast-append row was accepted for writing. */
+export declare const SYNC_FAST_APPEND_STATUSES: {
+    readonly APPLIED: "applied";
+};
+export type SyncFastAppendStatus = (typeof SYNC_FAST_APPEND_STATUSES)[keyof typeof SYNC_FAST_APPEND_STATUSES];
+/** How much remote read-back the provider performs before returning a write result. */
+export declare const SYNC_POSTCONDITION_MODES: {
+    /** Read changed rows after the write and verify their target hashes inline. */
+    readonly INLINE: "inline";
+    /** Return after the batched write is flushed; recovery reads verify later. */
+    readonly DEFERRED: "deferred";
+};
+export type SyncPostconditionMode = (typeof SYNC_POSTCONDITION_MODES)[keyof typeof SYNC_POSTCONDITION_MODES];
+/** Evidence level attached to a successful provider write result. */
+export declare const SYNC_POSTCONDITION_STATUSES: {
+    readonly VERIFIED: "verified";
+    readonly ACKNOWLEDGED: "acknowledged";
+    readonly UNAVAILABLE: "unavailable";
+};
+export type SyncPostconditionStatus = (typeof SYNC_POSTCONDITION_STATUSES)[keyof typeof SYNC_POSTCONDITION_STATUSES];
+/** Read-back classification after a lost response or expired lease. */
+export declare const SYNC_POSTCONDITION_DISPOSITIONS: {
+    readonly APPLIED: "applied";
+    readonly UNAPPLIED: "unapplied";
+    readonly CHANGED: "changed";
+    readonly UNAVAILABLE: "unavailable";
+};
+export type SyncPostconditionDisposition = (typeof SYNC_POSTCONDITION_DISPOSITIONS)[keyof typeof SYNC_POSTCONDITION_DISPOSITIONS];
+//# sourceMappingURL=constants.d.ts.map

package/dist/application/sync/sheets/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/sheets/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAEnF,kEAAkE;AAClE,eAAO,MAAM,sBAAsB;;CAEzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAEvE,mEAAmE;AACnE,eAAO,MAAM,gBAAgB;;;;CAIgC,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE1D,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB;IACnC,gFAAgF;;IAEhF,4EAA4E;;CAEpE,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,2BAA2B;;;;;;;;CAQ9B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB;;CAE5B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC;AAE7E,uFAAuF;AACvF,eAAO,MAAM,wBAAwB;IACnC,+EAA+E;;IAE/E,8EAA8E;;CAEtE,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,qEAAqE;AACrE,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,uEAAuE;AACvE,eAAO,MAAM,+BAA+B;;;;;CAKlC,CAAC;AAEX,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/application/sync/{gateway → sheets}/constants.js

@@ -1,28 +1,28 @@
 import { REGISTERED_PROJECTION_KINDS } from "../../../domain/model/constants.js";
-/** Protocol versions understood by the sync gateway contract. */
-export const SYNC_GATEWAY_PROTOCOL_VERSIONS = {
+/** Protocol versions understood by the sync provider contract. */
+export const SYNC_PROTOCOL_VERSIONS = {
     V1: "typed-sheets-sync-v1",
 };
-/** Projection labels accepted by the runtime gateway contract. */
-export const SYNC_GATEWAY_PROJECTIONS = {
+/** Projection labels accepted by the runtime provider contract. */
+export const SYNC_PROJECTIONS = {
     USER_INPUT: REGISTERED_PROJECTION_KINDS.USER_INPUT,
     SYSTEM_STATE: REGISTERED_PROJECTION_KINDS.SYSTEM_STATE,
     SYNC_CONFLICTS: REGISTERED_PROJECTION_KINDS.SYNC_CONFLICTS,
 };
 /** Detail level used by normalized Sheet observation reads. */
-export const SYNC_GATEWAY_SNAPSHOT_READ_MODES = {
+export const SYNC_SNAPSHOT_READ_MODES = {
     /** Reads formula, merge, error, and stable-cell metadata for reconciliation. */
     FULL: "full",
     /** Reads only user-editable literal values and row identity for polling. */
     USER_INPUT: "user_input",
 };
-/** Effect kinds that require special handling at the Apps Script boundary. */
-export const SYNC_GATEWAY_EFFECT_KINDS = {
+/** Effect kinds that require special handling at the provider boundary. */
+export const SYNC_DELETE_EFFECT_KINDS = {
     RESOLUTION_DELETE: "resolution_delete",
     USER_INPUT_DELETE: "user_input_delete",
 };
-/** Terminal and retryable statuses returned for one gateway effect. */
-export const SYNC_GATEWAY_EFFECT_RESULT_STATUSES = {
+/** Terminal and retryable statuses returned for one provider effect. */
+export const SYNC_EFFECT_RESULT_STATUSES = {
     APPLIED: "applied",
     ALREADY_APPLIED: "already_applied",
     SUPERSEDED: "superseded",
@@ -32,24 +32,24 @@ export const SYNC_GATEWAY_EFFECT_RESULT_STATUSES = {
     RETRYABLE_ERROR: "retryable_error",
 };
 /** Result label returned when a fast-append row was accepted for writing. */
-export const SYNC_GATEWAY_FAST_APPEND_STATUSES = {
+export const SYNC_FAST_APPEND_STATUSES = {
     APPLIED: "applied",
 };
-/** How much remote read-back the gateway performs before returning a write result. */
-export const SYNC_GATEWAY_POSTCONDITION_MODES = {
+/** How much remote read-back the provider performs before returning a write result. */
+export const SYNC_POSTCONDITION_MODES = {
     /** Read changed rows after the write and verify their target hashes inline. */
     INLINE: "inline",
     /** Return after the batched write is flushed; recovery reads verify later. */
     DEFERRED: "deferred",
 };
-/** Evidence level attached to a successful gateway write result. */
-export const SYNC_GATEWAY_POSTCONDITION_STATUSES = {
+/** Evidence level attached to a successful provider write result. */
+export const SYNC_POSTCONDITION_STATUSES = {
     VERIFIED: "verified",
     ACKNOWLEDGED: "acknowledged",
     UNAVAILABLE: "unavailable",
 };
 /** Read-back classification after a lost response or expired lease. */
-export const SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS = {
+export const SYNC_POSTCONDITION_DISPOSITIONS = {
     APPLIED: "applied",
     UNAPPLIED: "unapplied",
     CHANGED: "changed",

package/dist/application/sync/sheets/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/application/sync/sheets/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAGjF,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,EAAE,EAAE,sBAAsB;CAClB,CAAC;AAKX,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,2BAA2B,CAAC,UAAU;IAClD,YAAY,EAAE,2BAA2B,CAAC,YAAY;IACtD,cAAc,EAAE,2BAA2B,CAAC,cAAc;CACC,CAAC;AAI9D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gFAAgF;IAChF,IAAI,EAAE,MAAM;IACZ,4EAA4E;IAC5E,UAAU,EAAE,YAAY;CAChB,CAAC;AAKX,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAEX,wEAAwE;AACxE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,iBAAiB;IAClC,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAKX,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,uFAAuF;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,+EAA+E;IAC/E,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKX,qEAAqE;AACrE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CAClB,CAAC;AAKX,uEAAuE;AACvE,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/dist/application/sync/sheets/errors.d.ts

@@ -0,0 +1,15 @@
+import { CoreErrorException } from "../../../domain/errors/index.js";
+/** Stable error categories emitted by the runtime sync provider contract. */
+export declare const SYNC_SHEETS_ERROR_CODES: {
+    readonly INVALID_EFFECT_PAYLOAD: "invalid_sync_effect_payload";
+    readonly INVALID_PROVISIONING_DEFINITIONS: "invalid_sync_provisioning";
+    readonly INVALID_CLIENT_OPTIONS: "invalid_sync_client_options";
+    readonly INVALID_PROVIDER_RESPONSE: "invalid_sync_provider_response";
+    readonly INVALID_FAKE_PROVIDER_INPUT: "invalid_fake_sync_provider_input";
+};
+export type SyncSheetsErrorCode = (typeof SYNC_SHEETS_ERROR_CODES)[keyof typeof SYNC_SHEETS_ERROR_CODES];
+/** Error raised when a provider payload or provisioning contract is invalid. */
+export declare class SyncSheetsContractError extends CoreErrorException<"runtime.sync_sheets", SyncSheetsErrorCode> {
+    constructor(code: SyncSheetsErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/application/sync/sheets/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/sheets/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB;;;;;;CAM1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAEzE,gFAAgF;AAChF,qBAAa,uBAAwB,SAAQ,kBAAkB,CAC7D,qBAAqB,EACrB,mBAAmB,CACpB;gBACa,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAGvD"}

package/dist/application/sync/sheets/errors.js

@@ -0,0 +1,16 @@
+import { CoreErrorException } from "../../../domain/errors/index.js";
+/** Stable error categories emitted by the runtime sync provider contract. */
+export const SYNC_SHEETS_ERROR_CODES = {
+    INVALID_EFFECT_PAYLOAD: "invalid_sync_effect_payload",
+    INVALID_PROVISIONING_DEFINITIONS: "invalid_sync_provisioning",
+    INVALID_CLIENT_OPTIONS: "invalid_sync_client_options",
+    INVALID_PROVIDER_RESPONSE: "invalid_sync_provider_response",
+    INVALID_FAKE_PROVIDER_INPUT: "invalid_fake_sync_provider_input",
+};
+/** Error raised when a provider payload or provisioning contract is invalid. */
+export class SyncSheetsContractError extends CoreErrorException {
+    constructor(code, message) {
+        super("runtime.sync_sheets", code, message);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/application/sync/sheets/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/application/sync/sheets/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,sBAAsB,EAAE,6BAA6B;IACrD,gCAAgC,EAAE,2BAA2B;IAC7D,sBAAsB,EAAE,6BAA6B;IACrD,yBAAyB,EAAE,gCAAgC;IAC3D,2BAA2B,EAAE,kCAAkC;CACvD,CAAC;AAKX,gFAAgF;AAChF,MAAM,OAAO,uBAAwB,SAAQ,kBAG5C;IACC,YAAY,IAAyB,EAAE,OAAe;QACpD,KAAK,CAAC,qBAAqB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/application/sync/{gateway/coordinator/CoordinatedSyncGateway.d.ts → sheets/mutationCoordinator/CoordinatedSheetsProvider.d.ts}

@@ -1,15 +1,16 @@
 /**
- * Per-spreadsheet Gateway coordinator that serializes remote mutations.
+ * Per-spreadsheet provider coordinator that serializes remote mutations.
  *
- * The deployed Apps Script Gateway guards every data-plane operation with one
- * global `LockService.getScriptLock()`. Before this coordinator, the outbound
- * effect worker, the User_Input polling supervisor, provisioning, and test
- * controls each called the Gateway directly, so several in-flight requests
- * competed for the same script lock and the same Sheet context at once. Under
- * load that produced lock-acquisition failures, duplicate-row races, and tail
- * latency dominated by lock waits.
+ * The Google Sheets API is not transactional across requests, and concurrent
+ * in-flight requests to one spreadsheet can race (duplicate-row appends,
+ * interleaved update/delete batches) and burn quota with lock-style retries.
+ * Before this coordinator, the outbound effect worker, the User_Input polling
+ * supervisor, provisioning, and test controls each called the provider
+ * directly, so several in-flight requests competed for the same Sheet context
+ * at once. Under load that produced write races and tail latency dominated by
+ * retries.
  *
- * The coordinator is a transparent decorator: it implements the same gateway
+ * The coordinator is a transparent decorator: it implements the same provider
  * boundary the worker and polling already use, so no caller changes are
  * required. It routes every mutation and recovery barrier through one
  * per-spreadsheet FIFO lane (default total concurrency 1) while leaving
@@ -18,8 +19,8 @@
  * side from issuing competing mutations.
  *
  * Invariants preserved:
- * - Total mutation concurrency is 1 per lane by default, matching the global
- *   Apps Script script lock for single-spreadsheet deployments.
+ * - Total mutation concurrency is 1 per lane by default, giving one in-flight
+ *   write per spreadsheet at a time.
  * - Lock-free reads (`readSnapshot`, `readRows`, `readRowsBatch`) never wait on
  *   the mutation lane.
  * - Recovery barriers (`readEffectPostcondition(s)`) use the mutation lane so a
@@ -29,13 +30,13 @@
  * - Provisioning uses a dedicated lane so setup never races an append/write.
  * - A failing or throwing mutation releases the lane, so it never deadlocks.
  */
-import type { ApplySyncEffectsRequest, ApplySyncEffectsResult, EnsureSyncRowAnchorsRequest, EnsureSyncRowAnchorsResult, FastAppendRowsRequest, FastAppendRowsResult, ReadSyncEffectPostconditionsRequest, ReadSyncSnapshotRequest, ReadSyncTableRowsRequest, SyncEffectPostcondition, SyncGatewayEffect, SyncGatewayEffectPostconditionResult, SyncGatewaySnapshot, SyncObservedSnapshot, SyncSheetGateway, SyncSheetObservationBatchGateway, SyncSheetTableReaderGateway, SyncTableRowsResult } from "../syncGateway.js";
+import type { ApplySyncEffectsRequest, ApplySyncEffectsResult, EnsureSyncRowAnchorsRequest, EnsureSyncRowAnchorsResult, FastAppendRowsRequest, FastAppendRowsResult, ReadSyncEffectPostconditionsRequest, ReadSyncSnapshotRequest, ReadSyncTableRowsRequest, SyncEffectPostcondition, SyncProjectionEffect, SyncEffectPostconditionResult, SyncSheetsSnapshot, SyncObservedSnapshot, SyncSheetsProvider, SyncSheetsObservationBatchProvider, SyncSheetsTableReader, SyncTableRowsResult } from "../syncSheets.js";
 import { AsyncMutex } from "./asyncMutex.js";
-import { type CoordinatorLaneEvent } from "./coordinatorTelemetry.js";
-/** Gateway boundary the coordinator wraps (effect + observation + table read). */
-export type CoordinatedGatewayInner = SyncSheetGateway & SyncSheetTableReaderGateway;
+import { type CoordinatorLaneEvent } from "./laneTelemetry.js";
+/** Provider boundary the coordinator wraps (effect + observation + table read). */
+export type CoordinatedSheetsInner = SyncSheetsProvider & SyncSheetsTableReader;
 /** Options for constructing a per-spreadsheet coordinator. */
-export interface CoordinatedSyncGatewayOptions<TInner extends CoordinatedGatewayInner> {
+export interface CoordinatedSheetsProviderOptions<TInner extends CoordinatedSheetsInner> {
     readonly inner: TInner;
     /**
      * Derives the mutation-lane key for one physical sheet. Defaults to a
@@ -50,43 +51,43 @@ export interface CoordinatedSyncGatewayOptions<TInner extends CoordinatedGateway
     readonly clock?: () => number;
 }
 /**
- * Serializes Gateway mutations per lane while keeping value reads lock-free.
+ * Serializes provider mutations per lane while keeping value reads lock-free.
  *
- * Implements the full gateway, table-reader, observation-batch, and provisioner
- * boundary, so it can wrap both the real Apps Script gateway and fakes. When
- * the inner gateway lacks the one-request observation path, observation is
+ * Implements the full provider, table-reader, observation-batch, and provisioner
+ * boundary, so it can wrap both the real Google Sheets API provider and fakes.
+ * When the inner provider lacks the one-request observation path, observation is
  * routed through `ensureRowAnchors` + `readSnapshot` inside the same held lane.
  */
-export declare class CoordinatedSyncGateway<TInner extends CoordinatedGatewayInner> implements SyncSheetGateway, SyncSheetTableReaderGateway, SyncSheetObservationBatchGateway {
+export declare class CoordinatedSheetsProvider<TInner extends CoordinatedSheetsInner> implements SyncSheetsProvider, SyncSheetsTableReader, SyncSheetsObservationBatchProvider {
     private readonly inner;
     private readonly resolveKey;
     private readonly onLaneEvent;
     private readonly now;
     private readonly lanes;
-    constructor(options: CoordinatedSyncGatewayOptions<TInner>);
+    constructor(options: CoordinatedSheetsProviderOptions<TInner>);
     /** Returns a snapshot of all known lane metrics; diagnostic only. */
     laneMetrics(): ReadonlyMap<string, ReturnType<AsyncMutex["metrics"]>>;
     /**
      * Runs an internal control-plane operation on the same mutation lane as
      * effects and anchor writes. Test/admin controls use this to avoid issuing a
-     * competing Apps Script request outside the coordinator.
+     * competing provider request outside the coordinator.
      */
     runSerializedControl<T>(physicalSheetId: string, operation: string, task: () => Promise<T>): Promise<T>;
     fastAppendRows(request: FastAppendRowsRequest): Promise<FastAppendRowsResult>;
     applyEffects(request: ApplySyncEffectsRequest): Promise<ApplySyncEffectsResult>;
-    readEffectPostcondition(effect: SyncGatewayEffect): Promise<SyncEffectPostcondition>;
-    readEffectPostconditions(request: ReadSyncEffectPostconditionsRequest): Promise<readonly SyncGatewayEffectPostconditionResult[]>;
+    readEffectPostcondition(effect: SyncProjectionEffect): Promise<SyncEffectPostcondition>;
+    readEffectPostconditions(request: ReadSyncEffectPostconditionsRequest): Promise<readonly SyncEffectPostconditionResult[]>;
     ensureRowAnchors(request: EnsureSyncRowAnchorsRequest): Promise<EnsureSyncRowAnchorsResult>;
     observeSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncObservedSnapshot>;
     observeSnapshots(requests: readonly ReadSyncSnapshotRequest[]): Promise<readonly SyncObservedSnapshot[]>;
     /** Lock-free snapshot read; never waits on the mutation lane. */
-    readSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncGatewaySnapshot>;
+    readSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncSheetsSnapshot>;
     /** Lock-free values-only read; never waits on the mutation lane. */
     readRows(request: ReadSyncTableRowsRequest): Promise<SyncTableRowsResult>;
     /** Lock-free batched values-only read; never waits on the mutation lane. */
     readRowsBatch(requests: readonly ReadSyncTableRowsRequest[]): Promise<readonly SyncTableRowsResult[]>;
     /**
-     * Observes one snapshot through the inner gateway, using its single-request
+     * Observes one snapshot through the inner provider, using its single-request
      * capability when present and falling back to ensure+read otherwise. Both
      * calls run inside the caller's already-held lane, so observation stays
      * serialized against competing mutations.
@@ -99,4 +100,4 @@ export declare class CoordinatedSyncGateway<TInner extends CoordinatedGatewayInn
     private emitFailure;
     private emit;
 }
-//# sourceMappingURL=CoordinatedSyncGateway.d.ts.map
+//# sourceMappingURL=CoordinatedSheetsProvider.d.ts.map

package/dist/application/sync/sheets/mutationCoordinator/CoordinatedSheetsProvider.d.ts.map

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

package/dist/application/sync/{gateway/coordinator/CoordinatedSyncGateway.js → sheets/mutationCoordinator/CoordinatedSheetsProvider.js}

@@ -1,15 +1,16 @@
 /**
- * Per-spreadsheet Gateway coordinator that serializes remote mutations.
+ * Per-spreadsheet provider coordinator that serializes remote mutations.
  *
- * The deployed Apps Script Gateway guards every data-plane operation with one
- * global `LockService.getScriptLock()`. Before this coordinator, the outbound
- * effect worker, the User_Input polling supervisor, provisioning, and test
- * controls each called the Gateway directly, so several in-flight requests
- * competed for the same script lock and the same Sheet context at once. Under
- * load that produced lock-acquisition failures, duplicate-row races, and tail
- * latency dominated by lock waits.
+ * The Google Sheets API is not transactional across requests, and concurrent
+ * in-flight requests to one spreadsheet can race (duplicate-row appends,
+ * interleaved update/delete batches) and burn quota with lock-style retries.
+ * Before this coordinator, the outbound effect worker, the User_Input polling
+ * supervisor, provisioning, and test controls each called the provider
+ * directly, so several in-flight requests competed for the same Sheet context
+ * at once. Under load that produced write races and tail latency dominated by
+ * retries.
  *
- * The coordinator is a transparent decorator: it implements the same gateway
+ * The coordinator is a transparent decorator: it implements the same provider
  * boundary the worker and polling already use, so no caller changes are
  * required. It routes every mutation and recovery barrier through one
  * per-spreadsheet FIFO lane (default total concurrency 1) while leaving
@@ -18,8 +19,8 @@
  * side from issuing competing mutations.
  *
  * Invariants preserved:
- * - Total mutation concurrency is 1 per lane by default, matching the global
- *   Apps Script script lock for single-spreadsheet deployments.
+ * - Total mutation concurrency is 1 per lane by default, giving one in-flight
+ *   write per spreadsheet at a time.
  * - Lock-free reads (`readSnapshot`, `readRows`, `readRowsBatch`) never wait on
  *   the mutation lane.
  * - Recovery barriers (`readEffectPostcondition(s)`) use the mutation lane so a
@@ -29,19 +30,19 @@
  * - Provisioning uses a dedicated lane so setup never races an append/write.
  * - A failing or throwing mutation releases the lane, so it never deadlocks.
  */
-import { isSyncSheetObservationBatchGateway, } from "../syncGateway.js";
+import { isSyncSheetsObservationBatchProvider, } from "../syncSheets.js";
 import { AsyncMutex } from "./asyncMutex.js";
-import { TRANSPORT_OUTCOME_KINDS, } from "./coordinatorTelemetry.js";
-import { classifyTransportOutcome } from "../transportClassification.js";
+import { TRANSPORT_OUTCOME_KINDS, } from "./laneTelemetry.js";
+import { classifyTransportOutcome } from "../transportOutcome.js";
 /**
- * Serializes Gateway mutations per lane while keeping value reads lock-free.
+ * Serializes provider mutations per lane while keeping value reads lock-free.
  *
- * Implements the full gateway, table-reader, observation-batch, and provisioner
- * boundary, so it can wrap both the real Apps Script gateway and fakes. When
- * the inner gateway lacks the one-request observation path, observation is
+ * Implements the full provider, table-reader, observation-batch, and provisioner
+ * boundary, so it can wrap both the real Google Sheets API provider and fakes.
+ * When the inner provider lacks the one-request observation path, observation is
  * routed through `ensureRowAnchors` + `readSnapshot` inside the same held lane.
  */
-export class CoordinatedSyncGateway {
+export class CoordinatedSheetsProvider {
     inner;
     resolveKey;
     onLaneEvent;
@@ -63,7 +64,7 @@ export class CoordinatedSyncGateway {
     /**
      * Runs an internal control-plane operation on the same mutation lane as
      * effects and anchor writes. Test/admin controls use this to avoid issuing a
-     * competing Apps Script request outside the coordinator.
+     * competing provider request outside the coordinator.
      */
     runSerializedControl(physicalSheetId, operation, task) {
         return this.runMutation(physicalSheetId, operation, task);
@@ -91,15 +92,15 @@ export class CoordinatedSyncGateway {
             return [];
         const keys = distinctLaneKeys(requests.map((request) => this.resolveKey(request.physicalSheetId)));
         return this.runInLanes(keys, "observeSnapshots", async () => {
-            if (isSyncSheetObservationBatchGateway(this.inner)) {
-                // Delegate the whole batch to the inner gateway so one remote request
+            if (isSyncSheetsObservationBatchProvider(this.inner)) {
+                // Delegate the whole batch to the inner provider so one remote request
                 // covers every requested projection; serializing one request at a time
                 // here would defeat that shared round trip.
                 return this.inner.observeSnapshots(requests);
             }
             const results = [];
             for (const request of requests) {
-                // Sequential fallback for inner gateways without the batch capability;
+                // Sequential fallback for inner providers without the batch capability;
                 // each request still runs under the already-held lanes.
                 // eslint-disable-next-line no-await-in-loop
                 results.push(await this.observeOneInner(request));
@@ -120,13 +121,13 @@ export class CoordinatedSyncGateway {
         return this.inner.readRowsBatch(requests);
     }
     /**
-     * Observes one snapshot through the inner gateway, using its single-request
+     * Observes one snapshot through the inner provider, using its single-request
      * capability when present and falling back to ensure+read otherwise. Both
      * calls run inside the caller's already-held lane, so observation stays
      * serialized against competing mutations.
      */
     async observeOneInner(request) {
-        if (isSyncSheetObservationBatchGateway(this.inner)) {
+        if (isSyncSheetsObservationBatchProvider(this.inner)) {
             return this.inner.observeSnapshot(request);
         }
         const anchors = await this.inner.ensureRowAnchors(request);
@@ -218,4 +219,4 @@ const DEFAULT_LANE_KEY = "default";
 function distinctLaneKeys(keys) {
     return [...new Set(keys)].sort();
 }
-//# sourceMappingURL=CoordinatedSyncGateway.js.map
+//# sourceMappingURL=CoordinatedSheetsProvider.js.map

package/dist/application/sync/sheets/mutationCoordinator/CoordinatedSheetsProvider.js.map

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

package/dist/application/sync/{gateway/coordinator → sheets/mutationCoordinator}/asyncMutex.d.ts

@@ -1,11 +1,10 @@
 /**
- * Minimal FIFO async mutex used to serialize Gateway mutations.
+ * Minimal FIFO async mutex used to serialize provider mutations.
  *
  * The coordinator owns one mutex per mutation lane. It is intentionally
  * in-process only: SQLite outbox, leases, and receipts remain the durable
  * authority. The mutex exists solely so the Node side never issues competing
- * mutations (and competing Apps Script `ScriptLock` acquisitions) for the same
- * spreadsheet within one process.
+ * mutations for the same spreadsheet within one process.
  *
  * Fairness is FIFO so an uncertain-recovery barrier cannot be starved by a
  * steady stream of new mutations.

package/dist/application/sync/sheets/mutationCoordinator/asyncMutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncMutex.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/sheets/mutationCoordinator/asyncMutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC;AAE3C;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAE3B;;;OAGG;IACU,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASvD;;;;;OAKG;IACI,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAgB5C,8DAA8D;IACvD,OAAO,IAAI,iBAAiB;IAQnC,OAAO,CAAC,OAAO;CAQhB"}

package/dist/application/sync/sheets/mutationCoordinator/asyncMutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncMutex.js","sourceRoot":"","sources":["../../../../../src/application/sync/sheets/mutationCoordinator/asyncMutex.ts"],"names":[],"mappings":"AAuBA;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACb,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACxC,MAAM,GAAG,KAAK,CAAC;IACf,UAAU,GAAG,CAAC,CAAC;IACf,cAAc,GAAG,CAAC,CAAC;IAE3B;;;OAGG;IACI,KAAK,CAAC,GAAG,CAAI,IAAsB;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,OAAO;QACZ,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,IAAI,IAAgB,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACzC,IAAI,GAAG,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,0EAA0E;QAC1E,yDAAyD;QACzD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;YACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IACvD,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,SAAS,EAAE,IAAI,CAAC,cAAc;SAC/B,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,IAAgB;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,qDAAqD;QACrD,IAAI,EAAE,CAAC;IACT,CAAC;CACF"}

package/dist/application/sync/{gateway/coordinator/coordinatorTelemetry.d.ts → sheets/mutationCoordinator/laneTelemetry.d.ts}

@@ -1,11 +1,11 @@
 /**
- * Telemetry contract for the per-spreadsheet Gateway coordinator.
+ * Telemetry contract for the per-spreadsheet provider coordinator.
  *
- * Lane events are diagnostic only: a sink failure must never change gateway
+ * Lane events are diagnostic only: a sink failure must never change provider
  * behavior. The fields are deliberately redacted — no signed payload, secret,
  * or operation arguments are recorded.
  */
-import { TRANSPORT_OUTCOME_KINDS, type TransportOutcomeKind } from "../transportClassification.js";
+import { TRANSPORT_OUTCOME_KINDS, type TransportOutcomeKind } from "../transportOutcome.js";
 export { TRANSPORT_OUTCOME_KINDS };
 export type { TransportOutcomeKind };
 /** One observed mutation lane event emitted by the coordinator. */
@@ -28,4 +28,4 @@ export interface CoordinatorLaneEvent {
 /** Convenience type alias used by call sites that only need the event shape. */
 export type CoordinatorLaneSink = (event: CoordinatorLaneEvent) => void;
 /** Marker used so callers can type an absent presence without importing state. */
-//# sourceMappingURL=coordinatorTelemetry.d.ts.map
+//# sourceMappingURL=laneTelemetry.d.ts.map

package/dist/application/sync/sheets/mutationCoordinator/laneTelemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"laneTelemetry.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/sheets/mutationCoordinator/laneTelemetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE5F,OAAO,EAAE,uBAAuB,EAAE,CAAC;AACnC,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;CACrC;AAED,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAExE,kFAAkF"}

package/dist/application/sync/{gateway/coordinator/coordinatorTelemetry.js → sheets/mutationCoordinator/laneTelemetry.js}

@@ -1,13 +1,13 @@
 /**
- * Telemetry contract for the per-spreadsheet Gateway coordinator.
+ * Telemetry contract for the per-spreadsheet provider coordinator.
  *
- * Lane events are diagnostic only: a sink failure must never change gateway
+ * Lane events are diagnostic only: a sink failure must never change provider
  * behavior. The fields are deliberately redacted — no signed payload, secret,
  * or operation arguments are recorded.
  */
-import { TRANSPORT_OUTCOME_KINDS } from "../transportClassification.js";
+import { TRANSPORT_OUTCOME_KINDS } from "../transportOutcome.js";
 export { TRANSPORT_OUTCOME_KINDS };
 /** Marker used so callers can type an absent presence without importing state. */
-// Presence is re-exported through transportClassification's redacted fields,
+// Presence is re-exported through transportOutcome's redacted fields,
 // so this file does not need to import the shared state types directly.
-//# sourceMappingURL=coordinatorTelemetry.js.map
+//# sourceMappingURL=laneTelemetry.js.map

package/dist/application/sync/sheets/mutationCoordinator/laneTelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"laneTelemetry.js","sourceRoot":"","sources":["../../../../../src/application/sync/sheets/mutationCoordinator/laneTelemetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAA6B,MAAM,wBAAwB,CAAC;AAE5F,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAwBnC,kFAAkF;AAClF,sEAAsE;AACtE,wEAAwE"}