hikoutei 0.3.4 → 0.3.6

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

@@ -0,0 +1,144 @@
+/**
+ * Shared provider contract for the SQLite-authoritative sync runtime.
+ *
+ * The contract deliberately contains normalized values and stable anchors,
+ * never Google SDK objects or physical row numbers. Both the fake provider and
+ * the Google Sheets API provider implement this boundary so fault tests
+ * exercise the same compare-and-set semantics as a deployed provider.
+ */
+import { stableHash, } from "../../../domain/index.js";
+import { JAVASCRIPT_TYPE_NAMES } from "../../../shared/encoding/constants.js";
+import { isJavaScriptType, isNormalizedCell, isRecord, } from "../../../shared/encoding/index.js";
+import { APPLICABILITY_KINDS } from "../../../shared/state/constants.js";
+import { applicableValue, notApplicableValue, } from "../../../shared/state/index.js";
+import { EMPTY_ARRAY_LENGTH_ZERO, EMPTY_STRING_LENGTH_ZERO, } from "../../../shared/constants.js";
+import { SYNC_SHEETS_ERROR_CODES, SyncSheetsContractError, } from "./errors.js";
+import { requireSyncSheetsPositiveSafeInteger, requireSyncSheetsText, } from "./validation.js";
+/** Returns whether a provider supports the one-request observation path. */
+export function isSyncSheetsObservationBatchProvider(provider) {
+    return "observeSnapshot" in provider &&
+        typeof provider.observeSnapshot === "function" &&
+        "observeSnapshots" in provider &&
+        typeof provider.observeSnapshots === "function";
+}
+/** Reads one snapshot with one combined request when the provider supports it. */
+export async function observeSyncSnapshot(provider, request) {
+    if (isSyncSheetsObservationBatchProvider(provider)) {
+        return provider.observeSnapshot(request);
+    }
+    const anchors = await provider.ensureRowAnchors(request);
+    const snapshot = await provider.readSnapshot(request);
+    return { anchors, snapshot };
+}
+/** Reads several snapshots through one remote operation when available. */
+export async function observeSyncSnapshots(provider, requests) {
+    if (isSyncSheetsObservationBatchProvider(provider)) {
+        return provider.observeSnapshots(requests);
+    }
+    const results = [];
+    for (const request of requests) {
+        results.push(await observeSyncSnapshot(provider, request));
+    }
+    return results;
+}
+/** Returns whether a full observation provider also exposes the values-only reader. */
+export function isSyncSheetsTableReader(provider) {
+    return "readRows" in provider &&
+        typeof provider.readRows === "function" &&
+        "readRowsBatch" in provider &&
+        typeof provider.readRowsBatch === "function";
+}
+/** Computes the stable visible-state hash shared by fake and real providers. */
+export function computeSyncVisibleHash(fields) {
+    const entries = Object.entries(fields)
+        // Apps Script's operation sources use the same UTF-16 code-unit order.
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([fieldName, value]) => ({ fieldName, value }));
+    return stableHash({ fields: entries });
+}
+/** Validates and decodes the projection payload stored in a durable outbox row. */
+export function parseSyncProjectionEffectPayload(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload is not valid JSON");
+    }
+    if (!isRecord(parsed)) {
+        throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload must be an object");
+    }
+    const sheetName = requireSyncSheetsText(parsed.sheetName, "effect payload sheetName", SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const registeredRange = requireSyncSheetsText(parsed.registeredRange, "effect payload registeredRange", SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const targetAnchor = requireSyncSheetsText(parsed.targetAnchor, "effect payload targetAnchor", SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const targetVisibleHash = requireSyncSheetsText(parsed.targetVisibleHash, "effect payload targetVisibleHash", SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const schemaVersion = requireSyncSheetsPositiveSafeInteger(parsed.schemaVersion, "effect payload schemaVersion", SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    if (!isJavaScriptType(parsed.createIfMissing, JAVASCRIPT_TYPE_NAMES.BOOLEAN)) {
+        throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload createIfMissing must be boolean");
+    }
+    const expectedCandidateHash = parseNullableCandidateHash(parsed.expectedCandidateHash);
+    if (!isRecord(parsed.fields)) {
+        throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload fields must be an object");
+    }
+    const fields = {};
+    for (const [fieldName, cell] of Object.entries(parsed.fields)) {
+        if (fieldName.length === EMPTY_STRING_LENGTH_ZERO ||
+            !isNormalizedCell(cell)) {
+            throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload contains an invalid normalized field");
+        }
+        fields[fieldName] = cell;
+    }
+    if (Object.keys(fields).length === EMPTY_ARRAY_LENGTH_ZERO) {
+        throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload must contain a field");
+    }
+    if (computeSyncVisibleHash(fields) !== targetVisibleHash) {
+        throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload targetVisibleHash does not match its fields");
+    }
+    return {
+        sheetName,
+        registeredRange,
+        schemaVersion,
+        targetAnchor,
+        fields,
+        targetVisibleHash,
+        createIfMissing: parsed.createIfMissing,
+        expectedCandidateHash,
+    };
+}
+/** Serializes a checked projection payload in a stable key order for outbox use. */
+export function serializeSyncProjectionEffectPayload(payload) {
+    // Validate before serialization so worker and provider fail at the same boundary.
+    const checked = parseSyncProjectionEffectPayload(JSON.stringify(toWireProjectionEffectPayload(payload)));
+    return JSON.stringify({
+        sheetName: checked.sheetName,
+        registeredRange: checked.registeredRange,
+        schemaVersion: checked.schemaVersion,
+        targetAnchor: checked.targetAnchor,
+        fields: Object.fromEntries(Object.entries(checked.fields).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))),
+        targetVisibleHash: checked.targetVisibleHash,
+        createIfMissing: checked.createIfMissing,
+        expectedCandidateHash: toNullableCandidateHash(checked.expectedCandidateHash),
+    });
+}
+function parseNullableCandidateHash(value) {
+    if (value === null) {
+        return notApplicableValue();
+    }
+    return applicableValue(requireSyncSheetsText(value, "effect payload expectedCandidateHash", SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD));
+}
+function toWireProjectionEffectPayload(payload) {
+    return {
+        sheetName: payload.sheetName,
+        registeredRange: payload.registeredRange,
+        schemaVersion: payload.schemaVersion,
+        targetAnchor: payload.targetAnchor,
+        fields: payload.fields,
+        targetVisibleHash: payload.targetVisibleHash,
+        createIfMissing: payload.createIfMissing,
+        expectedCandidateHash: toNullableCandidateHash(payload.expectedCandidateHash),
+    };
+}
+function toNullableCandidateHash(value) {
+    return value.kind === APPLICABILITY_KINDS.APPLICABLE ? value.value : null;
+}
+//# sourceMappingURL=syncSheets.js.map

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

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

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

@@ -1,22 +1,20 @@
 /**
- * Structured classification of a Gateway transport outcome.
+ * Structured classification of a provider transport outcome.
  *
- * The Apps Script transport can fail for three very different reasons that the
- * effect worker must not treat the same way:
+ * The direct Sheets transport can fail for three very different reasons that
+ * the effect worker must not treat the same way:
  *
  * - `success`: a decoded, valid envelope was returned.
  * - `explicit_remote_failure`: the remote returned a structured rejection that
- *   proves no operation ran (e.g. a signed-envelope validation failure). The
- *   remote state is known, so the effect can transition to a terminal failure
- *   state.
+ *   proves no operation ran (e.g. a 4xx API validation failure). The remote
+ *   state is known, so the effect can transition to a terminal failure state.
  * - `delivery_uncertain`: the transport gave no usable answer (timeout,
- *   network error, non-JSON/404 response, lost connection), or the Gateway
- *   failed during/after operation execution (`operation_failed`,
- *   `internal_error`). The remote may or may not have committed the write, so
- *   the effect must be recovered through a postcondition probe rather than
- *   immediately redriven. Per-effect guard/schema/identity rejections are not
- *   transport errors at all: they arrive as per-effect result statuses in a
- *   successful envelope and keep their existing terminal handling.
+ *   network error, non-JSON/404 response, lost connection). The remote may or
+ *   may not have committed the write, so the effect must be recovered through
+ *   a postcondition probe rather than immediately redriven. Per-effect
+ *   guard/schema/identity rejections are not transport errors at all: they
+ *   arrive as per-effect result statuses in a successful envelope and keep
+ *   their existing terminal handling.
  *
  * This boundary lets future durable `delivery_uncertain` state and recovery
  * barriers classify a thrown transport error without re-deriving the rules at
@@ -24,7 +22,7 @@
  * promoted to `success`, and a proven pre-mutation rejection is never
  * reclassified as a retryable transport error.
  */
-import { AppsScriptSyncGatewayError } from "../../../adapter/sheets/providers/apps-script-gateway/errors.js";
+import { GoogleSheetsApiTransportError } from "../../../adapter/sheets/providers/google-sheets-api/errors.js";
 import type { Presence } from "../../../shared/state/types.js";
 export declare const TRANSPORT_OUTCOME_KINDS: {
     readonly SUCCESS: "success";
@@ -41,7 +39,7 @@ export interface TransportOutcome {
     readonly message: string;
 }
 /**
- * Classifies a value thrown by the Gateway transport.
+ * Classifies a value thrown by the provider transport.
  *
  * `undefined`/`null` means no error was observed and is classified as success;
  * callers should normally pass a caught error. Any non-transport error is left
@@ -52,11 +50,14 @@ export declare function classifyTransportOutcome(error: unknown): TransportOutco
 /** Returns true when the remote state cannot be proven either way. */
 export declare function isDeliveryUncertainOutcome(outcome: TransportOutcome): boolean;
 /**
- * Returns true when the Apps Script transport error implies an ambiguous
- * delivery. Non-success HTTP responses are not proof that a mutating batch did
- * not begin: Apps Script/proxy failures can be emitted after a partial remote
- * write. Only a structured 2xx operation result can provide per-effect
- * rejection evidence to the worker.
+ * Returns true when the direct Sheets transport error implies an ambiguous
+ * delivery.
+ *
+ * Google API non-2xx responses prove the batch did not execute only for the
+ * pre-mutation rejection statuses below; timeouts, network failures, and
+ * proxy-emitted 408/429/5xx responses can follow a committed write, and a
+ * malformed 2xx reply cannot prove what was applied. Those are recovered
+ * through the postcondition probe path, never closed as success.
  */
-export declare function isDeliveryUncertain(error: AppsScriptSyncGatewayError): boolean;
-//# sourceMappingURL=transportClassification.d.ts.map
+export declare function isGoogleSheetsApiDeliveryUncertain(error: GoogleSheetsApiTransportError): boolean;
+//# sourceMappingURL=transportOutcome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transportOutcome.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/sheets/transportOutcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,6BAA6B,EAA2C,MAAM,+DAA+D,CAAC;AAEvJ,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,eAAO,MAAM,uBAAuB;;;;CAI1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAEzE,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA2BzE;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAeT"}

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

@@ -0,0 +1,97 @@
+/**
+ * Structured classification of a provider transport outcome.
+ *
+ * The direct Sheets transport can fail for three very different reasons that
+ * the effect worker must not treat the same way:
+ *
+ * - `success`: a decoded, valid envelope was returned.
+ * - `explicit_remote_failure`: the remote returned a structured rejection that
+ *   proves no operation ran (e.g. a 4xx API validation failure). The remote
+ *   state is known, so the effect can transition to a terminal failure state.
+ * - `delivery_uncertain`: the transport gave no usable answer (timeout,
+ *   network error, non-JSON/404 response, lost connection). The remote may or
+ *   may not have committed the write, so the effect must be recovered through
+ *   a postcondition probe rather than immediately redriven. Per-effect
+ *   guard/schema/identity rejections are not transport errors at all: they
+ *   arrive as per-effect result statuses in a successful envelope and keep
+ *   their existing terminal handling.
+ *
+ * This boundary lets future durable `delivery_uncertain` state and recovery
+ * barriers classify a thrown transport error without re-deriving the rules at
+ * every call site. It never weakens correctness: an uncertain outcome is never
+ * promoted to `success`, and a proven pre-mutation rejection is never
+ * reclassified as a retryable transport error.
+ */
+import { GoogleSheetsApiTransportError, GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES } from "../../../adapter/sheets/providers/google-sheets-api/errors.js";
+import { PRESENCE_KINDS } from "../../../shared/state/index.js";
+export const TRANSPORT_OUTCOME_KINDS = {
+    SUCCESS: "success",
+    EXPLICIT_REMOTE_FAILURE: "explicit_remote_failure",
+    DELIVERY_UNCERTAIN: "delivery_uncertain",
+};
+/**
+ * Classifies a value thrown by the provider transport.
+ *
+ * `undefined`/`null` means no error was observed and is classified as success;
+ * callers should normally pass a caught error. Any non-transport error is left
+ * as `delivery_uncertain` rather than `success` because the caller cannot prove
+ * the remote state either way.
+ */
+export function classifyTransportOutcome(error) {
+    if (error === undefined || error === null) {
+        return {
+            kind: TRANSPORT_OUTCOME_KINDS.SUCCESS,
+            httpStatus: { kind: PRESENCE_KINDS.ABSENT },
+            code: { kind: PRESENCE_KINDS.ABSENT },
+            message: "",
+        };
+    }
+    if (error instanceof GoogleSheetsApiTransportError) {
+        const kind = isGoogleSheetsApiDeliveryUncertain(error)
+            ? TRANSPORT_OUTCOME_KINDS.DELIVERY_UNCERTAIN
+            : TRANSPORT_OUTCOME_KINDS.EXPLICIT_REMOTE_FAILURE;
+        return {
+            kind,
+            httpStatus: error.status,
+            code: error.remoteCode,
+            message: error.message,
+        };
+    }
+    // Unknown transport/Node error: assume the remote state is unverifiable.
+    return {
+        kind: TRANSPORT_OUTCOME_KINDS.DELIVERY_UNCERTAIN,
+        httpStatus: { kind: PRESENCE_KINDS.ABSENT },
+        code: { kind: PRESENCE_KINDS.ABSENT },
+        message: error instanceof Error ? error.message : "Unexpected transport failure",
+    };
+}
+/** Returns true when the remote state cannot be proven either way. */
+export function isDeliveryUncertainOutcome(outcome) {
+    return outcome.kind === TRANSPORT_OUTCOME_KINDS.DELIVERY_UNCERTAIN;
+}
+/**
+ * Returns true when the direct Sheets transport error implies an ambiguous
+ * delivery.
+ *
+ * Google API non-2xx responses prove the batch did not execute only for the
+ * pre-mutation rejection statuses below; timeouts, network failures, and
+ * proxy-emitted 408/429/5xx responses can follow a committed write, and a
+ * malformed 2xx reply cannot prove what was applied. Those are recovered
+ * through the postcondition probe path, never closed as success.
+ */
+export function isGoogleSheetsApiDeliveryUncertain(error) {
+    if (error.code === GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.TIMEOUT ||
+        error.code === GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.NETWORK_ERROR ||
+        error.code === GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.INVALID_RESPONSE) {
+        return true;
+    }
+    if (error.status.kind !== PRESENCE_KINDS.PRESENT)
+        return true;
+    const status = error.status.value;
+    if (status === 400 || status === 401 || status === 403 || status === 404) {
+        // The API rejected the request before executing any part of the batch.
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=transportOutcome.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transportOutcome.js","sourceRoot":"","sources":["../../../../src/application/sync/sheets/transportOutcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,6BAA6B,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AACvJ,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO,EAAE,SAAS;IAClB,uBAAuB,EAAE,yBAAyB;IAClD,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAcX;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,uBAAuB,CAAC,OAAO;YACrC,UAAU,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE;YAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,6BAA6B,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,kCAAkC,CAAC,KAAK,CAAC;YACpD,CAAC,CAAC,uBAAuB,CAAC,kBAAkB;YAC5C,CAAC,CAAC,uBAAuB,CAAC,uBAAuB,CAAC;QACpD,OAAO;YACL,IAAI;YACJ,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,IAAI,EAAE,KAAK,CAAC,UAAU;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IACD,yEAAyE;IACzE,OAAO;QACL,IAAI,EAAE,uBAAuB,CAAC,kBAAkB;QAChD,UAAU,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE;QAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B;KACjF,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,0BAA0B,CAAC,OAAyB;IAClE,OAAO,OAAO,CAAC,IAAI,KAAK,uBAAuB,CAAC,kBAAkB,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAAoC;IAEpC,IACE,KAAK,CAAC,IAAI,KAAK,uCAAuC,CAAC,OAAO;QAC9D,KAAK,CAAC,IAAI,KAAK,uCAAuC,CAAC,aAAa;QACpE,KAAK,CAAC,IAAI,KAAK,uCAAuC,CAAC,gBAAgB,EACvE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;IAClC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACzE,uEAAuE;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { Presence } from "../../../shared/state/types.js";
+import { type SyncProjectionKind, type SyncProtocolVersion, type SyncSnapshotReadMode } from "./constants.js";
+import { type SyncSheetsErrorCode } from "./errors.js";
+/** Requires a non-empty string at a provider contract boundary. */
+export declare function requireSyncSheetsText(value: unknown, label: string, errorCode: SyncSheetsErrorCode): string;
+/** Requires a positive safe integer at a provider contract boundary. */
+export declare function requireSyncSheetsPositiveSafeInteger(value: unknown, label: string, errorCode: SyncSheetsErrorCode): number;
+/** Requires a non-negative safe integer at a provider contract boundary. */
+export declare function requireSyncSheetsNonNegativeSafeInteger(value: unknown, label: string, errorCode: SyncSheetsErrorCode): number;
+/** Decodes an optional text value returned by the runtime provider. */
+export declare function decodeSyncSheetsPresenceString(value: unknown, label: string, errorCode?: SyncSheetsErrorCode): Presence<string>;
+/** Decodes an optional non-negative revision returned by the runtime provider. */
+export declare function decodeSyncSheetsPresenceNonNegativeSafeInteger(value: unknown, label: string, errorCode?: SyncSheetsErrorCode): Presence<number>;
+/** Requires a protocol version returned by the runtime provider. */
+export declare function requireSyncProtocolVersion(value: unknown, label: string, errorCode: SyncSheetsErrorCode): SyncProtocolVersion;
+/** Requires a projection label returned by the runtime provider. */
+export declare function requireSyncProjectionKind(value: unknown, label: string, errorCode: SyncSheetsErrorCode): SyncProjectionKind;
+/** Requires a supported snapshot detail level at a provider boundary. */
+export declare function requireSyncSnapshotReadMode(value: unknown, label: string, errorCode: SyncSheetsErrorCode): SyncSnapshotReadMode;
+/** Requires a non-empty list at a provider contract boundary. */
+export declare function requireSyncSheetsNonEmptyList<T>(values: readonly T[], label: string, errorCode: SyncSheetsErrorCode): void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/sheets/validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAQ/D,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAErB,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAKR;AAED,wEAAwE;AACxE,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAQR;AAED,4EAA4E;AAC5E,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAQR;AAED,uEAAuE;AACvE,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,mBAAuE,GACjF,QAAQ,CAAC,MAAM,CAAC,CAGlB;AAED,kFAAkF;AAClF,wBAAgB,8CAA8C,CAC5D,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,mBAAuE,GACjF,QAAQ,CAAC,MAAM,CAAC,CAGlB;AAED,oEAAoE;AACpE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,GAC7B,mBAAmB,CAWrB;AAED,oEAAoE;AACpE,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,GAC7B,kBAAkB,CAWpB;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,GAC7B,oBAAoB,CAWtB;AAED,iEAAiE;AACjE,wBAAgB,6BAA6B,CAAC,CAAC,EAC7C,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,GAC7B,IAAI,CAIN"}

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

@@ -0,0 +1,79 @@
+import { JAVASCRIPT_TYPE_NAMES } from "../../../shared/encoding/constants.js";
+import { absentValue, presentValue, } from "../../../shared/state/index.js";
+import { isJavaScriptType } from "../../../shared/encoding/typeGuards.js";
+import { isNonEmptyList, isNonEmptyString, isNonNegativeSafeInteger, isPositiveSafeInteger, } from "../../../shared/validation.js";
+import { SYNC_PROJECTIONS, SYNC_PROTOCOL_VERSIONS, SYNC_SNAPSHOT_READ_MODES, } from "./constants.js";
+import { SYNC_SHEETS_ERROR_CODES, SyncSheetsContractError, } from "./errors.js";
+/** Requires a non-empty string at a provider contract boundary. */
+export function requireSyncSheetsText(value, label, errorCode) {
+    if (!isNonEmptyString(value)) {
+        throw new SyncSheetsContractError(errorCode, `${label} is required`);
+    }
+    return value;
+}
+/** Requires a positive safe integer at a provider contract boundary. */
+export function requireSyncSheetsPositiveSafeInteger(value, label, errorCode) {
+    if (!isPositiveSafeInteger(value)) {
+        throw new SyncSheetsContractError(errorCode, `${label} must be a positive safe integer`);
+    }
+    return value;
+}
+/** Requires a non-negative safe integer at a provider contract boundary. */
+export function requireSyncSheetsNonNegativeSafeInteger(value, label, errorCode) {
+    if (!isNonNegativeSafeInteger(value)) {
+        throw new SyncSheetsContractError(errorCode, `${label} must be a non-negative safe integer`);
+    }
+    return value;
+}
+/** Decodes an optional text value returned by the runtime provider. */
+export function decodeSyncSheetsPresenceString(value, label, errorCode = SYNC_SHEETS_ERROR_CODES.INVALID_PROVIDER_RESPONSE) {
+    if (value === null)
+        return absentValue();
+    return presentValue(requireSyncSheetsText(value, label, errorCode));
+}
+/** Decodes an optional non-negative revision returned by the runtime provider. */
+export function decodeSyncSheetsPresenceNonNegativeSafeInteger(value, label, errorCode = SYNC_SHEETS_ERROR_CODES.INVALID_PROVIDER_RESPONSE) {
+    if (value === null)
+        return absentValue();
+    return presentValue(requireSyncSheetsNonNegativeSafeInteger(value, label, errorCode));
+}
+/** Requires a protocol version returned by the runtime provider. */
+export function requireSyncProtocolVersion(value, label, errorCode) {
+    if (!isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.STRING) ||
+        value !== SYNC_PROTOCOL_VERSIONS.V1) {
+        throw new SyncSheetsContractError(errorCode, `${label} is not supported`);
+    }
+    return value;
+}
+/** Requires a projection label returned by the runtime provider. */
+export function requireSyncProjectionKind(value, label, errorCode) {
+    if (!isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.STRING) ||
+        !isSyncProjectionKind(value)) {
+        throw new SyncSheetsContractError(errorCode, `${label} is not supported`);
+    }
+    return value;
+}
+/** Requires a supported snapshot detail level at a provider boundary. */
+export function requireSyncSnapshotReadMode(value, label, errorCode) {
+    if (!isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.STRING) ||
+        !isSyncSnapshotReadMode(value)) {
+        throw new SyncSheetsContractError(errorCode, `${label} is not supported`);
+    }
+    return value;
+}
+/** Requires a non-empty list at a provider contract boundary. */
+export function requireSyncSheetsNonEmptyList(values, label, errorCode) {
+    if (!isNonEmptyList(values)) {
+        throw new SyncSheetsContractError(errorCode, `${label} requires at least one item`);
+    }
+}
+function isSyncProjectionKind(value) {
+    return value === SYNC_PROJECTIONS.USER_INPUT ||
+        value === SYNC_PROJECTIONS.SYSTEM_STATE ||
+        value === SYNC_PROJECTIONS.SYNC_CONFLICTS;
+}
+function isSyncSnapshotReadMode(value) {
+    return value === SYNC_SNAPSHOT_READ_MODES.FULL ||
+        value === SYNC_SNAPSHOT_READ_MODES.USER_INPUT;
+}
+//# sourceMappingURL=validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/application/sync/sheets/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,WAAW,EACX,YAAY,GACb,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,GAIzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,aAAa,CAAC;AAErB,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,KAAa,EACb,SAA8B;IAE9B,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,GAAG,KAAK,cAAc,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oCAAoC,CAClD,KAAc,EACd,KAAa,EACb,SAA8B;IAE9B,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,GAAG,KAAK,kCAAkC,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,uCAAuC,CACrD,KAAc,EACd,KAAa,EACb,SAA8B;IAE9B,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,GAAG,KAAK,sCAAsC,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,8BAA8B,CAC5C,KAAc,EACd,KAAa,EACb,YAAiC,uBAAuB,CAAC,yBAAyB;IAElF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,WAAW,EAAE,CAAC;IACzC,OAAO,YAAY,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,8CAA8C,CAC5D,KAAc,EACd,KAAa,EACb,YAAiC,uBAAuB,CAAC,yBAAyB;IAElF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,WAAW,EAAE,CAAC;IACzC,OAAO,YAAY,CAAC,uCAAuC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CACxC,KAAc,EACd,KAAa,EACb,SAA8B;IAE9B,IACE,CAAC,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACtD,KAAK,KAAK,sBAAsB,CAAC,EAAE,EACnC,CAAC;QACD,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,GAAG,KAAK,mBAAmB,CAC5B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,KAAa,EACb,SAA8B;IAE9B,IACE,CAAC,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACtD,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,GAAG,KAAK,mBAAmB,CAC5B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,KAAa,EACb,SAA8B;IAE9B,IACE,CAAC,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACtD,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAC9B,CAAC;QACD,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,GAAG,KAAK,mBAAmB,CAC5B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,6BAA6B,CAC3C,MAAoB,EACpB,KAAa,EACb,SAA8B;IAE9B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,KAAK,KAAK,gBAAgB,CAAC,UAAU;QAC1C,KAAK,KAAK,gBAAgB,CAAC,YAAY;QACvC,KAAK,KAAK,gBAAgB,CAAC,cAAc,CAAC;AAC9C,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,KAAK,KAAK,wBAAwB,CAAC,IAAI;QAC5C,KAAK,KAAK,wBAAwB,CAAC,UAAU,CAAC;AAClD,CAAC"}

package/dist/application/sync/telemetry/syncTiming.d.ts

@@ -2,13 +2,13 @@
  * Shared timing(소요 시간) contracts for the SQLite-to-Sheets write pipeline.
  *
  * Timing is diagnostic only: a sink failure must never change persistence or
- * gateway behavior. The operation kinds describe the public lifecycle while
+ * provider behavior. The operation kinds describe the public lifecycle while
  * phases describe implementation boundaries that can be compared in a trace.
  */
 export declare const SYNC_TIMING_SCOPES: {
     readonly ORM_FLUSH: "orm_flush";
     readonly WORKER: "worker";
-    readonly GATEWAY: "gateway";
+    readonly PROVIDER: "provider";
     /** Inbound User_Input polling phases; diagnostic only and never root-facing. */
     readonly POLLING: "polling";
 };
@@ -25,17 +25,17 @@ export interface SyncTimingOperationCounts {
     readonly update: number;
     readonly delete: number;
 }
-/** One measured implementation phase inside a remote gateway operation. */
-export interface SyncGatewayTimingPhase {
+/** One measured implementation phase inside a remote provider operation. */
+export interface SyncSheetsTimingPhase {
     readonly phase: string;
     readonly durationMs: number;
 }
-/** Timing returned by one dynamically evaluated Apps Script operation. */
-export interface SyncGatewayTiming {
+/** Timing returned by one remote provider operation. */
+export interface SyncSheetsTiming {
     readonly operationKinds: readonly SyncTimingOperationKind[];
     readonly operationCounts: SyncTimingOperationCounts;
     readonly durationMs: number;
-    readonly phases: readonly SyncGatewayTimingPhase[];
+    readonly phases: readonly SyncSheetsTimingPhase[];
 }
 /** One local or remote phase sent to the application's diagnostics sink. */
 export interface SyncTimingEvent {

package/dist/application/sync/telemetry/syncTiming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncTiming.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/telemetry/syncTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB;;;;IAI7B,gFAAgF;;CAExE,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,qEAAqE;AACrE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACpD;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAE9D,sEAAsE;AACtE,wBAAgB,8BAA8B,IAAI,yBAAyB,CAE1E"}
+{"version":3,"file":"syncTiming.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/telemetry/syncTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB;;;;IAI7B,gFAAgF;;CAExE,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,qEAAqE;AACrE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAE9D,sEAAsE;AACtE,wBAAgB,8BAA8B,IAAI,yBAAyB,CAE1E"}

package/dist/application/sync/telemetry/syncTiming.js

@@ -2,13 +2,13 @@
  * Shared timing(소요 시간) contracts for the SQLite-to-Sheets write pipeline.
  *
  * Timing is diagnostic only: a sink failure must never change persistence or
- * gateway behavior. The operation kinds describe the public lifecycle while
+ * provider behavior. The operation kinds describe the public lifecycle while
  * phases describe implementation boundaries that can be compared in a trace.
  */
 export const SYNC_TIMING_SCOPES = {
     ORM_FLUSH: "orm_flush",
     WORKER: "worker",
-    GATEWAY: "gateway",
+    PROVIDER: "provider",
     /** Inbound User_Input polling phases; diagnostic only and never root-facing. */
     POLLING: "polling",
 };

package/dist/application/sync/telemetry/syncTiming.js.map

@@ -1 +1 @@
-{"version":3,"file":"syncTiming.js","sourceRoot":"","sources":["../../../../src/application/sync/telemetry/syncTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,gFAAgF;IAChF,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AA0CX,sEAAsE;AACtE,MAAM,UAAU,8BAA8B;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"syncTiming.js","sourceRoot":"","sources":["../../../../src/application/sync/telemetry/syncTiming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,gFAAgF;IAChF,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AA0CX,sEAAsE;AACtE,MAAM,UAAU,8BAA8B;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/domain/evaluate/contracts.d.ts

@@ -2,7 +2,7 @@
  * Shared contracts for pure batch evaluation.
  *
  * These types keep evaluator inputs and outcomes independent from SQLite,
- * gateway transport, and any repository implementation.
+ * provider transport, and any repository implementation.
  */
 import type { NormalizedCell } from "../../shared/encoding/types.js";
 import type { CanonicalResolution, OwnershipManifest, ObservedRowChange, Projection, QuarantinePlan, QuarantineReason, RepairPlan, RowBindingContext, RowOperation, SyncConflict } from "../model/types.js";

package/dist/domain/evaluate/contracts.js

@@ -2,7 +2,7 @@
  * Shared contracts for pure batch evaluation.
  *
  * These types keep evaluator inputs and outcomes independent from SQLite,
- * gateway transport, and any repository implementation.
+ * provider transport, and any repository implementation.
  */
 export {};
 //# sourceMappingURL=contracts.js.map

package/dist/domain/model/constants.d.ts

@@ -84,7 +84,7 @@ export declare const REGISTERED_PROJECTION_KINDS: {
     readonly SYSTEM_STATE: "system_state";
     readonly SYNC_CONFLICTS: "sync_conflicts";
 };
-/** Projection values accepted by registry and gateway routing. */
+/** Projection values accepted by registry and provider routing. */
 export type RegisteredProjectionKind = (typeof REGISTERED_PROJECTION_KINDS)[keyof typeof REGISTERED_PROJECTION_KINDS];
 /** Runtime values for durable outbox effect operations. */
 export declare const EFFECT_KINDS: {

package/dist/domain/model/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/domain/model/constants.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEhF,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,yEAAyE;AACzE,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,uEAAuE;AACvE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD,sEAAsE;AACtE,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,6BAA6B;;;CAGhC,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAErF,kEAAkE;AAClE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAerB,CAAC;AAEX,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE7D,oFAAoF;AACpF,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEtF,yEAAyE;AACzE,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,kEAAkE;AAClE,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,2DAA2D;AAC3D,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,0DAA0D;AAC1D,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/domain/model/constants.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEhF,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,yEAAyE;AACzE,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,uEAAuE;AACvE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD,sEAAsE;AACtE,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,6BAA6B;;;CAGhC,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAErF,kEAAkE;AAClE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAerB,CAAC;AAEX,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE7D,oFAAoF;AACpF,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEtF,yEAAyE;AACzE,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,2DAA2D;AAC3D,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,0DAA0D;AAC1D,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/dist/domain/model/types.d.ts

@@ -154,7 +154,7 @@ export interface ObservedEditBatch {
     readonly baseSnapshotHash: string;
     /** Authenticated service principal; audit metadata, never a merge input. */
     readonly ingressActorId: string;
-    /** Verified editor identity when the gateway can provide one. */
+    /** Verified editor identity when the provider can provide one. */
     readonly editorActorId: Presence<string>;
     readonly editorActorSource: EditorActorSource;
     readonly rows: readonly ObservedRowChange[];