hikoutei 0.2.0

package/dist/application/orm/persistence/support/timing.js

@@ -0,0 +1,55 @@
+/**
+ * Timing helpers for mapped persistence diagnostics.
+ *
+ * Timing callbacks are deliberately best-effort: observability failures must
+ * never abort the entity transaction they describe.
+ */
+import { SYNC_TIMING_OPERATION_KINDS, } from "../../../sync/telemetry/syncTiming.js";
+import { TYPED_SHEETS_ENTITY_CHANGE_KINDS, } from "../../api/contracts.js";
+/** Stable translation from entity lifecycle states to timing operation states. */
+const SYNC_TIMING_OPERATION_BY_ENTITY_CHANGE_KIND = {
+    [TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE]: SYNC_TIMING_OPERATION_KINDS.APPEND,
+    [TYPED_SHEETS_ENTITY_CHANGE_KINDS.UPDATE]: SYNC_TIMING_OPERATION_KINDS.UPDATE,
+    [TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE]: SYNC_TIMING_OPERATION_KINDS.DELETE,
+};
+/** Converts public entity lifecycle kinds into timing operation kinds. */
+export function timingOperationKind(value) {
+    return SYNC_TIMING_OPERATION_BY_ENTITY_CHANGE_KIND[value];
+}
+/** Counts one lifecycle operation for aggregate diagnostics. */
+export function countsForOperationKind(operationKind) {
+    return {
+        append: operationKind === SYNC_TIMING_OPERATION_KINDS.APPEND ? 1 : 0,
+        update: operationKind === SYNC_TIMING_OPERATION_KINDS.UPDATE ? 1 : 0,
+        delete: operationKind === SYNC_TIMING_OPERATION_KINDS.DELETE ? 1 : 0,
+    };
+}
+/** Counts all mapped lifecycle plans in one flush. */
+export function countsForPlans(plans) {
+    return plans.reduce((counts, plan) => {
+        const operationKind = timingOperationKind(plan.change.kind);
+        return {
+            append: counts.append + (operationKind === SYNC_TIMING_OPERATION_KINDS.APPEND ? 1 : 0),
+            update: counts.update + (operationKind === SYNC_TIMING_OPERATION_KINDS.UPDATE ? 1 : 0),
+            delete: counts.delete + (operationKind === SYNC_TIMING_OPERATION_KINDS.DELETE ? 1 : 0),
+        };
+    }, { append: 0, update: 0, delete: 0 });
+}
+/** Lists only operation kinds represented by the supplied aggregate counts. */
+export function operationKindsForCounts(counts) {
+    return [
+        ...(counts.append > 0 ? [SYNC_TIMING_OPERATION_KINDS.APPEND] : []),
+        ...(counts.update > 0 ? [SYNC_TIMING_OPERATION_KINDS.UPDATE] : []),
+        ...(counts.delete > 0 ? [SYNC_TIMING_OPERATION_KINDS.DELETE] : []),
+    ];
+}
+/** Emits diagnostics without allowing a faulty sink to affect persistence. */
+export function emitTiming(writer, event) {
+    try {
+        writer.onTiming?.(event);
+    }
+    catch {
+        // Diagnostics must never abort the entity transaction.
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/application/orm/persistence/support/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/timing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,2BAA2B,GAI5B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,gCAAgC,GAGjC,MAAM,wBAAwB,CAAC;AAMhC,kFAAkF;AAClF,MAAM,2CAA2C,GAAG;IAClD,CAAC,gCAAgC,CAAC,MAAM,CAAC,EAAE,2BAA2B,CAAC,MAAM;IAC7E,CAAC,gCAAgC,CAAC,MAAM,CAAC,EAAE,2BAA2B,CAAC,MAAM;IAC7E,CAAC,gCAAgC,CAAC,MAAM,CAAC,EAAE,2BAA2B,CAAC,MAAM;CACE,CAAC;AAElF,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CACjC,KAAsC;IAEtC,OAAO,2CAA2C,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,sBAAsB,CACpC,aAAsC;IAEtC,OAAO;QACL,MAAM,EAAE,aAAa,KAAK,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,EAAE,aAAa,KAAK,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,EAAE,aAAa,KAAK,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACrE,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,KAAkC;IAC/D,OAAO,KAAK,CAAC,MAAM,CAA4B,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QAC9D,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,aAAa,KAAK,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtF,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,aAAa,KAAK,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtF,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,aAAa,KAAK,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvF,CAAC;IACJ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,uBAAuB,CACrC,MAAiC;IAEjC,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CACxB,MAA6B,EAC7B,KAAoC;IAEpC,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;AACH,CAAC"}

package/dist/application/sync/gateway/SyncGatewayBootstrap.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Trusted setup bridge from SQLite's physical-sheet registry to the Apps Script
+ * control plane.
+ *
+ * Runtime data-plane calls can only use a registered route. This helper is the
+ * matching owner-side path: callers pass the route returned by SQLite plus its
+ * declared header schema, and the gateway creates or verifies that projection
+ * before atomically replacing its remote allowlist.
+ */
+import type { RegisteredProjection, RegisteredSyncSheet } from "../../../infrastructure/storage/sync/shared/syncRegistry.js";
+/** Exact projection schema that setup must materialize in the bound spreadsheet. */
+export interface RegisteredSyncProjectionDefinition {
+    readonly sheet: RegisteredSyncSheet;
+    readonly headers: readonly string[];
+    /** Optional user-editable boolean control fields for a Sync_Conflicts tab. */
+    readonly checkboxHeaders?: readonly string[];
+}
+/** Serializable route shape accepted by a remote setup/control-plane client. */
+export interface SyncGatewayProvisionRoute {
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: RegisteredProjection;
+    readonly schemaVersion: number;
+    readonly headers: readonly string[];
+    /** Business-key header used to find append-only rows without metadata. */
+    readonly identityField?: string;
+    readonly checkboxHeaders?: readonly string[];
+}
+/** Minimal control-plane boundary; the runtime remains independent of fetch or Google SDK types. */
+export interface SyncGatewayProvisioner {
+    provisionRegistry(registrations: readonly SyncGatewayProvisionRoute[]): Promise<{
+        readonly registrations: readonly Omit<SyncGatewayProvisionRoute, "headers">[];
+        readonly createdSheets: readonly string[];
+        readonly initializedHeaders: readonly string[];
+    }>;
+}
+/**
+ * Provisions the complete SQLite-declared projection set without asking an
+ * operator to copy tab names, ranges, or schema versions into Apps Script.
+ *
+ * The caller should invoke this after successful local registry writes and may
+ * retry a failed remote call: the gateway only creates missing tabs and never
+ * overwrites a nonblank, mismatched header row.
+ */
+export declare function provisionRegisteredSyncSheets(gateway: SyncGatewayProvisioner, definitions: readonly RegisteredSyncProjectionDefinition[]): Promise<Awaited<ReturnType<SyncGatewayProvisioner["provisionRegistry"]>>>;
+//# sourceMappingURL=SyncGatewayBootstrap.d.ts.map

package/dist/application/sync/gateway/SyncGatewayBootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncGatewayBootstrap.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/gateway/SyncGatewayBootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,6DAA6D,CAAC;AAWrE,oFAAoF;AACpF,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,oGAAoG;AACpG,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,aAAa,EAAE,SAAS,yBAAyB,EAAE,GAAG,OAAO,CAAC;QAC9E,QAAQ,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,EAAE,CAAC;QAC9E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;KAChD,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,sBAAsB,EAC/B,WAAW,EAAE,SAAS,kCAAkC,EAAE,GACzD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CA+F3E"}

package/dist/application/sync/gateway/SyncGatewayBootstrap.js

@@ -0,0 +1,93 @@
+/**
+ * Trusted setup bridge from SQLite's physical-sheet registry to the Apps Script
+ * control plane.
+ *
+ * Runtime data-plane calls can only use a registered route. This helper is the
+ * matching owner-side path: callers pass the route returned by SQLite plus its
+ * declared header schema, and the gateway creates or verifies that projection
+ * before atomically replacing its remote allowlist.
+ */
+import { SYNC_GATEWAY_ERROR_CODES, SyncGatewayContractError, } from "./errors.js";
+import { requireSyncGatewayNonEmptyList, requireSyncGatewayPositiveSafeInteger, requireSyncGatewayText, } from "./validation.js";
+/**
+ * Provisions the complete SQLite-declared projection set without asking an
+ * operator to copy tab names, ranges, or schema versions into Apps Script.
+ *
+ * The caller should invoke this after successful local registry writes and may
+ * retry a failed remote call: the gateway only creates missing tabs and never
+ * overwrites a nonblank, mismatched header row.
+ */
+export async function provisionRegisteredSyncSheets(gateway, definitions) {
+    requireSyncGatewayNonEmptyList(definitions, "sync gateway provisioning definitions", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+    const firstDefinition = definitions[0];
+    if (firstDefinition === undefined) {
+        throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, "sync gateway provisioning requires a first projection");
+    }
+    const spreadsheetId = requireSyncGatewayText(firstDefinition.sheet.spreadsheetId, "sync gateway provisioning spreadsheetId", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+    const physicalSheetIds = new Set();
+    const tabNames = new Set();
+    const registrations = definitions.map((definition) => {
+        const physicalSheetId = requireSyncGatewayText(definition.sheet.physicalSheetId, "sync gateway provisioning physicalSheetId", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        const sheetName = requireSyncGatewayText(definition.sheet.tabName, "sync gateway provisioning tabName", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        const registeredRange = requireSyncGatewayText(definition.sheet.registeredRange, "sync gateway provisioning registeredRange", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        const definitionSpreadsheetId = requireSyncGatewayText(definition.sheet.spreadsheetId, "sync gateway provisioning spreadsheetId", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        if (definitionSpreadsheetId !== spreadsheetId) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, "sync gateway provisioning definitions must target one spreadsheet");
+        }
+        if (physicalSheetIds.has(physicalSheetId)) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, "sync gateway provisioning cannot repeat a physical sheet ID");
+        }
+        if (tabNames.has(sheetName)) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, "sync gateway provisioning cannot repeat a tab name");
+        }
+        physicalSheetIds.add(physicalSheetId);
+        tabNames.add(sheetName);
+        validateHeaders(definition.headers, "sync gateway provisioning headers");
+        validateCheckboxHeaders(definition.headers, definition.checkboxHeaders);
+        const schemaVersion = requireSyncGatewayPositiveSafeInteger(definition.sheet.schemaVersion, "sync gateway provisioning schemaVersion", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        const identityField = definition.sheet.projection === "system_state"
+            ? requireSyncGatewayText(definition.sheet.businessKeyField, "sync gateway provisioning identityField", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS)
+            : undefined;
+        if (identityField !== undefined && !definition.headers.includes(identityField)) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, `sync gateway provisioning identityField is not declared: ${identityField}`);
+        }
+        return {
+            sheetName,
+            registeredRange,
+            projection: definition.sheet.projection,
+            schemaVersion,
+            headers: definition.headers,
+            ...(identityField === undefined ? {} : { identityField }),
+            ...(definition.checkboxHeaders === undefined ? {} : { checkboxHeaders: definition.checkboxHeaders }),
+        };
+    });
+    return gateway.provisionRegistry(registrations);
+}
+function validateHeaders(headers, label) {
+    requireSyncGatewayNonEmptyList(headers, label, SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+    const seen = new Set();
+    headers.forEach((header, index) => {
+        const normalizedHeader = requireSyncGatewayText(header, `${label}[${index}]`, SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        if (seen.has(normalizedHeader)) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, `${label} cannot contain duplicate headers: ${normalizedHeader}`);
+        }
+        seen.add(normalizedHeader);
+    });
+}
+function validateCheckboxHeaders(headers, checkboxHeaders) {
+    if (checkboxHeaders === undefined)
+        return;
+    const headerSet = new Set(headers);
+    const seen = new Set();
+    checkboxHeaders.forEach((header, index) => {
+        const normalizedHeader = requireSyncGatewayText(header, `sync gateway provisioning checkboxHeaders[${index}]`, SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        if (!headerSet.has(normalizedHeader)) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, `sync gateway provisioning checkbox header is not declared: ${normalizedHeader}`);
+        }
+        if (seen.has(normalizedHeader)) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, `sync gateway provisioning cannot repeat a checkbox header: ${normalizedHeader}`);
+        }
+        seen.add(normalizedHeader);
+    });
+}
+//# sourceMappingURL=SyncGatewayBootstrap.js.map

package/dist/application/sync/gateway/SyncGatewayBootstrap.js.map

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

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

@@ -0,0 +1,65 @@
+/** Protocol versions understood by the sync gateway contract. */
+export declare const SYNC_GATEWAY_PROTOCOL_VERSIONS: {
+    readonly V1: "typed-sheets-sync-v1";
+};
+export type SyncGatewayProtocolVersion = (typeof SYNC_GATEWAY_PROTOCOL_VERSIONS)[keyof typeof SYNC_GATEWAY_PROTOCOL_VERSIONS];
+/** Projection labels accepted by the runtime gateway contract. */
+export declare const SYNC_GATEWAY_PROJECTIONS: {
+    readonly USER_INPUT: "user_input";
+    readonly SYSTEM_STATE: "system_state";
+    readonly SYNC_CONFLICTS: "sync_conflicts";
+};
+export type SyncGatewayProjection = (typeof SYNC_GATEWAY_PROJECTIONS)[keyof typeof SYNC_GATEWAY_PROJECTIONS];
+/** Detail level used by normalized Sheet observation reads. */
+export declare const SYNC_GATEWAY_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 SyncGatewaySnapshotReadMode = (typeof SYNC_GATEWAY_SNAPSHOT_READ_MODES)[keyof typeof SYNC_GATEWAY_SNAPSHOT_READ_MODES];
+/** Effect kinds that require special handling at the Apps Script boundary. */
+export declare const SYNC_GATEWAY_EFFECT_KINDS: {
+    readonly RESOLUTION_DELETE: "resolution_delete";
+    readonly USER_INPUT_DELETE: "user_input_delete";
+};
+/** Terminal and retryable statuses returned for one gateway effect. */
+export declare const SYNC_GATEWAY_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 SyncGatewayEffectResultStatus = (typeof SYNC_GATEWAY_EFFECT_RESULT_STATUSES)[keyof typeof SYNC_GATEWAY_EFFECT_RESULT_STATUSES];
+/** Result label returned when a fast-append row was accepted for writing. */
+export declare const SYNC_GATEWAY_FAST_APPEND_STATUSES: {
+    readonly APPLIED: "applied";
+};
+export type SyncGatewayFastAppendStatus = (typeof SYNC_GATEWAY_FAST_APPEND_STATUSES)[keyof typeof SYNC_GATEWAY_FAST_APPEND_STATUSES];
+/** How much remote read-back the gateway performs before returning a write result. */
+export declare const SYNC_GATEWAY_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 SyncGatewayPostconditionMode = (typeof SYNC_GATEWAY_POSTCONDITION_MODES)[keyof typeof SYNC_GATEWAY_POSTCONDITION_MODES];
+/** Evidence level attached to a successful gateway write result. */
+export declare const SYNC_GATEWAY_POSTCONDITION_STATUSES: {
+    readonly VERIFIED: "verified";
+    readonly ACKNOWLEDGED: "acknowledged";
+    readonly UNAVAILABLE: "unavailable";
+};
+export type SyncGatewayPostconditionStatus = (typeof SYNC_GATEWAY_POSTCONDITION_STATUSES)[keyof typeof SYNC_GATEWAY_POSTCONDITION_STATUSES];
+/** Read-back classification after a lost response or expired lease. */
+export declare const SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS: {
+    readonly APPLIED: "applied";
+    readonly UNAPPLIED: "unapplied";
+    readonly CHANGED: "changed";
+    readonly UNAVAILABLE: "unavailable";
+};
+export type SyncGatewayPostconditionDisposition = (typeof SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS)[keyof typeof SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/gateway/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,8BAA8B;;CAEjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,OAAO,8BAA8B,CAAC,CAAC;AAEvF,kEAAkE;AAClE,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,+DAA+D;AAC/D,eAAO,MAAM,gCAAgC;IAC3C,gFAAgF;;IAEhF,4EAA4E;;CAEpE,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,OAAO,gCAAgC,CAAC,CAAC;AAE3F,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,mCAAmC;;;;;;;;CAQtC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,OAAO,mCAAmC,CAAC,CAAC;AAEjG,6EAA6E;AAC7E,eAAO,MAAM,iCAAiC;;CAEpC,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,OAAO,iCAAiC,CAAC,CAAC;AAE7F,sFAAsF;AACtF,eAAO,MAAM,gCAAgC;IAC3C,+EAA+E;;IAE/E,8EAA8E;;CAEtE,CAAC;AAEX,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,OAAO,gCAAgC,CAAC,CAAC;AAE3F,oEAAoE;AACpE,eAAO,MAAM,mCAAmC;;;;CAItC,CAAC;AAEX,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,OAAO,mCAAmC,CAAC,CAAC;AAEjG,uEAAuE;AACvE,eAAO,MAAM,uCAAuC;;;;;CAK1C,CAAC;AAEX,MAAM,MAAM,mCAAmC,GAC7C,CAAC,OAAO,uCAAuC,CAAC,CAAC,MAAM,OAAO,uCAAuC,CAAC,CAAC"}

package/dist/application/sync/gateway/constants.js

@@ -0,0 +1,57 @@
+/** Protocol versions understood by the sync gateway contract. */
+export const SYNC_GATEWAY_PROTOCOL_VERSIONS = {
+    V1: "typed-sheets-sync-v1",
+};
+/** Projection labels accepted by the runtime gateway contract. */
+export const SYNC_GATEWAY_PROJECTIONS = {
+    USER_INPUT: "user_input",
+    SYSTEM_STATE: "system_state",
+    SYNC_CONFLICTS: "sync_conflicts",
+};
+/** Detail level used by normalized Sheet observation reads. */
+export const SYNC_GATEWAY_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 = {
+    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 = {
+    APPLIED: "applied",
+    ALREADY_APPLIED: "already_applied",
+    SUPERSEDED: "superseded",
+    GUARD_MISMATCH: "guard_mismatch",
+    REPAIR_REOBSERVE: "repair_reobserve",
+    SCHEMA_ERROR: "schema_error",
+    RETRYABLE_ERROR: "retryable_error",
+};
+/** Result label returned when a fast-append row was accepted for writing. */
+export const SYNC_GATEWAY_FAST_APPEND_STATUSES = {
+    APPLIED: "applied",
+};
+/** How much remote read-back the gateway performs before returning a write result. */
+export const SYNC_GATEWAY_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 = {
+    VERIFIED: "verified",
+    ACKNOWLEDGED: "acknowledged",
+    UNAVAILABLE: "unavailable",
+};
+/** Read-back classification after a lost response or expired lease. */
+export const SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS = {
+    APPLIED: "applied",
+    UNAPPLIED: "unapplied",
+    CHANGED: "changed",
+    UNAVAILABLE: "unavailable",
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/application/sync/gateway/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,EAAE,EAAE,sBAAsB;CAClB,CAAC;AAKX,kEAAkE;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAKX,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,gFAAgF;IAChF,IAAI,EAAE,MAAM;IACZ,4EAA4E;IAC5E,UAAU,EAAE,YAAY;CAChB,CAAC;AAKX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAEX,uEAAuE;AACvE,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,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,iCAAiC,GAAG;IAC/C,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,sFAAsF;AACtF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,+EAA+E;IAC/E,MAAM,EAAE,QAAQ;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKX,oEAAoE;AACpE,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CAClB,CAAC;AAKX,uEAAuE;AACvE,MAAM,CAAC,MAAM,uCAAuC,GAAG;IACrD,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;CAClB,CAAC"}

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

@@ -0,0 +1,15 @@
+import { CoreErrorException } from "../../../domain/errors/index.js";
+/** Stable error categories emitted by the runtime sync gateway contract. */
+export declare const SYNC_GATEWAY_ERROR_CODES: {
+    readonly INVALID_EFFECT_PAYLOAD: "invalid_sync_effect_payload";
+    readonly INVALID_PROVISIONING_DEFINITIONS: "invalid_sync_gateway_provisioning";
+    readonly INVALID_CLIENT_OPTIONS: "invalid_sync_gateway_client_options";
+    readonly INVALID_GATEWAY_RESPONSE: "invalid_sync_gateway_response";
+    readonly INVALID_FAKE_GATEWAY_INPUT: "invalid_fake_sync_gateway_input";
+};
+export type SyncGatewayErrorCode = (typeof SYNC_GATEWAY_ERROR_CODES)[keyof typeof SYNC_GATEWAY_ERROR_CODES];
+/** Error raised when a gateway payload or provisioning contract is invalid. */
+export declare class SyncGatewayContractError extends CoreErrorException<"runtime.sync_gateway", SyncGatewayErrorCode> {
+    constructor(code: SyncGatewayErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/gateway/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB;;;;;;CAM3B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,+EAA+E;AAC/E,qBAAa,wBAAyB,SAAQ,kBAAkB,CAC9D,sBAAsB,EACtB,oBAAoB,CACrB;gBACa,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAGxD"}

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

@@ -0,0 +1,16 @@
+import { CoreErrorException } from "../../../domain/errors/index.js";
+/** Stable error categories emitted by the runtime sync gateway contract. */
+export const SYNC_GATEWAY_ERROR_CODES = {
+    INVALID_EFFECT_PAYLOAD: "invalid_sync_effect_payload",
+    INVALID_PROVISIONING_DEFINITIONS: "invalid_sync_gateway_provisioning",
+    INVALID_CLIENT_OPTIONS: "invalid_sync_gateway_client_options",
+    INVALID_GATEWAY_RESPONSE: "invalid_sync_gateway_response",
+    INVALID_FAKE_GATEWAY_INPUT: "invalid_fake_sync_gateway_input",
+};
+/** Error raised when a gateway payload or provisioning contract is invalid. */
+export class SyncGatewayContractError extends CoreErrorException {
+    constructor(code, message) {
+        super("runtime.sync_gateway", code, message);
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/application/sync/gateway/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,sBAAsB,EAAE,6BAA6B;IACrD,gCAAgC,EAAE,mCAAmC;IACrE,sBAAsB,EAAE,qCAAqC;IAC7D,wBAAwB,EAAE,+BAA+B;IACzD,0BAA0B,EAAE,iCAAiC;CACrD,CAAC;AAKX,+EAA+E;AAC/E,MAAM,OAAO,wBAAyB,SAAQ,kBAG7C;IACC,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,sBAAsB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF"}