hikoutei 0.2.0

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

@@ -0,0 +1,313 @@
+/**
+ * Shared gateway 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 gateway and
+ * the Apps Script client implement this boundary so fault tests exercise the
+ * same compare-and-set semantics as a deployed gateway.
+ */
+import { type CellObservation, type EffectKind, type EffectTargetKind, type NormalizedCell } from "../../../domain/index.js";
+import type { Applicability, Presence } from "../../../shared/state/types.js";
+import type { RegisteredProjection } from "../../../infrastructure/storage/sync/shared/syncRegistry.js";
+import { type SyncGatewayEffectResultStatus, type SyncGatewayFastAppendStatus, type SyncGatewayPostconditionMode, type SyncGatewayPostconditionDisposition, type SyncGatewayPostconditionStatus, type SyncGatewayProtocolVersion, type SyncGatewaySnapshotReadMode } from "./constants.js";
+import type { SyncGatewayTiming } from "../telemetry/syncTiming.js";
+/** Projections supported by the v1 sync gateway. */
+export type SyncProjection = RegisteredProjection;
+/** Effect classes whose compare-and-set behavior differs at the gateway. */
+export type SyncEffectKind = EffectKind;
+/** Literal/formula metadata retained by a normalized Sheet snapshot. */
+export interface SyncSnapshotCell extends CellObservation {
+    readonly stableHash: Presence<string>;
+}
+/** One physical row read from a registered projection. */
+export interface SyncSnapshotRow {
+    readonly rowNumber: number;
+    readonly physicalAnchor: Presence<string>;
+    /** Optional compatibility fields; the real gateway leaves visible state to SQLite. */
+    readonly visibleRevision: Presence<number>;
+    readonly visibleHash: Presence<string>;
+    readonly cells: Readonly<Record<string, SyncSnapshotCell>>;
+}
+/** Lock-free normalized snapshot returned by a gateway. */
+export interface SyncGatewaySnapshot {
+    readonly protocolVersion: SyncGatewayProtocolVersion;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: SyncProjection;
+    readonly schemaVersion: number;
+    readonly headers: readonly string[];
+    readonly rows: readonly SyncSnapshotRow[];
+    readonly snapshotHash: string;
+    readonly unanchoredRows: readonly number[];
+    readonly duplicateAnchors: readonly {
+        readonly anchor: string;
+        readonly rowNumbers: readonly number[];
+    }[];
+}
+/** Request used to assign missing Developer Metadata anchors before a snapshot. */
+export interface EnsureSyncRowAnchorsRequest {
+    readonly physicalSheetId: string;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: SyncProjection;
+    readonly schemaVersion: number;
+}
+/** Result of one anchor assignment pass. */
+export interface EnsureSyncRowAnchorsResult {
+    readonly assigned: number;
+    readonly existing: number;
+    readonly duplicateAnchors: readonly {
+        readonly anchor: string;
+        readonly rowNumbers: readonly number[];
+    }[];
+}
+/** Lock-free snapshot request. */
+export interface ReadSyncSnapshotRequest extends EnsureSyncRowAnchorsRequest {
+    /** Full metadata for reconciliation, or user-editable values for polling. */
+    readonly readMode?: SyncGatewaySnapshotReadMode;
+}
+/** Result of one combined anchor assignment and snapshot read. */
+export interface SyncObservedSnapshot {
+    readonly anchors: EnsureSyncRowAnchorsResult;
+    readonly snapshot: SyncGatewaySnapshot;
+    /** Optional diagnostic phases returned by newer observation gateways. */
+    readonly timing?: SyncGatewayTiming;
+}
+/** Optional batch observation capability used to share one remote request. */
+export interface SyncSheetObservationBatchGateway extends SyncSheetObservationGateway {
+    observeSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncObservedSnapshot>;
+    observeSnapshots(requests: readonly ReadSyncSnapshotRequest[]): Promise<readonly SyncObservedSnapshot[]>;
+}
+/** Returns whether a gateway supports the one-request observation path. */
+export declare function isSyncSheetObservationBatchGateway(gateway: SyncSheetObservationGateway): gateway is SyncSheetObservationBatchGateway;
+/** Reads one snapshot with one combined request when the gateway supports it. */
+export declare function observeSyncSnapshot(gateway: SyncSheetObservationGateway, request: ReadSyncSnapshotRequest): Promise<SyncObservedSnapshot>;
+/** Reads several snapshots through one remote operation when available. */
+export declare function observeSyncSnapshots(gateway: SyncSheetObservationGateway, requests: readonly ReadSyncSnapshotRequest[]): Promise<readonly SyncObservedSnapshot[]>;
+/**
+ * Serializable projection values written by one outbox effect.
+ *
+ * `targetVisibleHash` is computed over `fields` with
+ * computeSyncVisibleHash().  The anchor is projection-local: User_Input and
+ * System_State may represent the same row binding with different anchors.
+ */
+export interface SyncProjectionEffectPayload {
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly schemaVersion: number;
+    readonly targetAnchor: string;
+    readonly fields: Readonly<Record<string, NormalizedCell>>;
+    readonly targetVisibleHash: string;
+    readonly createIfMissing: boolean;
+    /** A candidate reconcile must fail rather than overwrite an active candidate. */
+    readonly expectedCandidateHash: Applicability<string>;
+}
+/** Gateway-ready view of one durable outbox row. */
+export interface SyncGatewayEffect {
+    readonly effectId: string;
+    readonly payloadHash: string;
+    readonly effectKind: SyncEffectKind;
+    readonly physicalSheetId: string;
+    readonly projection: SyncProjection;
+    readonly targetKind: EffectTargetKind;
+    readonly targetId: string;
+    readonly rowBindingId: Presence<string>;
+    readonly conflictId: Presence<string>;
+    readonly expectedVisibleRevision: number;
+    readonly expectedVisibleHash: string;
+    readonly repairGuardHash: Presence<string>;
+    readonly payload: SyncProjectionEffectPayload;
+}
+/** Per-effect terminal/non-terminal gateway result. */
+export interface SyncGatewayEffectResult {
+    readonly effectId: string;
+    readonly payloadHash: string;
+    readonly status: SyncGatewayEffectResultStatus;
+    readonly visibleRevision: Presence<number>;
+    readonly visibleHash: Presence<string>;
+    readonly snapshotHash: Presence<string>;
+    readonly reason: Presence<string>;
+    readonly postcondition: SyncGatewayPostconditionStatus;
+}
+/** Gateway batch request. All effects must target the same physical sheet. */
+export interface ApplySyncEffectsRequest {
+    readonly physicalSheetId: string;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: SyncProjection;
+    readonly schemaVersion: number;
+    readonly effects: readonly SyncGatewayEffect[];
+    /**
+     * Defaults to inline verification for compatibility. The worker explicitly
+     * selects deferred verification so recovery/reconciliation owns read-back.
+     */
+    readonly postconditionMode?: SyncGatewayPostconditionMode;
+}
+/** A batch may intentionally return only a prefix when its budget is exhausted. */
+export interface ApplySyncEffectsResult {
+    readonly results: readonly SyncGatewayEffectResult[];
+    readonly snapshotHash: Presence<string>;
+    /** True only when the gateway intentionally stopped before the supplied suffix. */
+    readonly hasMore: boolean;
+    /** Optional phase timing returned by newer Code.gs deployments. */
+    readonly timing?: SyncGatewayTiming;
+}
+/** Read-back classification used after a response is lost or a lease expires. */
+export interface SyncEffectPostcondition {
+    readonly disposition: SyncGatewayPostconditionDisposition;
+    readonly visibleRevision: Presence<number>;
+    readonly visibleHash: Presence<string>;
+    readonly snapshotHash: Presence<string>;
+}
+/** One effect identity paired with its read-back result in a recovery batch. */
+export interface SyncGatewayEffectPostconditionResult {
+    readonly effectId: string;
+    readonly payloadHash: string;
+    readonly postcondition: SyncEffectPostcondition;
+}
+/** One row written through the fast-append path.
+ *
+ * This path is deliberately append-only. It does not carry a row anchor,
+ * compare-and-set state, visible hash, receipt, or metadata instruction. A
+ * response loss may therefore cause a later retry to append the row again;
+ * reconciliation is the component that detects and repairs that drift.
+ */
+export interface FastAppendRow {
+    readonly effectId: string;
+    readonly fields: Readonly<Record<string, NormalizedCell>>;
+}
+/** Per-effect result for one fast-append row. */
+export interface FastAppendRowResult {
+    readonly effectId: string;
+    /** The row was included in the gateway's bulk write. */
+    readonly status: SyncGatewayFastAppendStatus;
+}
+/** Bounded fast-append request for one System_State projection sheet. */
+export interface FastAppendRowsRequest {
+    readonly physicalSheetId: string;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: SyncProjection;
+    readonly schemaVersion: number;
+    readonly rows: readonly FastAppendRow[];
+}
+/** Result of one bounded fast-append batch. */
+export interface FastAppendRowsResult {
+    readonly results: readonly FastAppendRowResult[];
+    /** True when the gateway intentionally stopped before the supplied suffix. */
+    readonly hasMore: boolean;
+    /** Optional phase timing returned by newer Code.gs deployments. */
+    readonly timing?: SyncGatewayTiming;
+}
+/** Request used to classify several response-loss effects with one Sheet read. */
+export interface ReadSyncEffectPostconditionsRequest {
+    readonly physicalSheetId: string;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: SyncProjection;
+    readonly schemaVersion: number;
+    readonly effects: readonly SyncGatewayEffect[];
+}
+/** Fast append capability required for new System_State rows. */
+export interface SyncEffectWorkerGateway {
+    fastAppendRows(request: FastAppendRowsRequest): Promise<FastAppendRowsResult>;
+}
+/**
+ * Full effect capability required for regular updates, deletes, and recovery.
+ *
+ * A fast-only gateway can still run the worker when its outbox contains only
+ * appendable System_State creates; regular effects are rejected explicitly.
+ */
+export interface SyncEffectWorkerFullGateway extends SyncEffectWorkerGateway {
+    applyEffects(request: ApplySyncEffectsRequest): Promise<ApplySyncEffectsResult>;
+    readEffectPostcondition(effect: SyncGatewayEffect): Promise<SyncEffectPostcondition>;
+    readEffectPostconditions(request: ReadSyncEffectPostconditionsRequest): Promise<readonly SyncGatewayEffectPostconditionResult[]>;
+}
+/** Read-only gateway capability used by polling and onEdit observation. */
+export interface SyncSheetObservationGateway {
+    ensureRowAnchors(request: EnsureSyncRowAnchorsRequest): Promise<EnsureSyncRowAnchorsResult>;
+    readSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncGatewaySnapshot>;
+}
+/** Request for a lightweight table read used by simple polling. */
+export interface ReadSyncTableRowsRequest {
+    readonly physicalSheetId: string;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly projection: SyncProjection;
+    readonly schemaVersion: number;
+    readonly headers: readonly string[];
+}
+/** One nonblank row returned by a lightweight table read. */
+export interface SyncTableRow {
+    readonly rowNumber: number;
+    readonly fields: Readonly<Record<string, NormalizedCell>>;
+}
+/** Result of a lightweight table read without Sheet metadata or CAS work. */
+export interface SyncTableRowsResult {
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly headers: readonly string[];
+    readonly rows: readonly SyncTableRow[];
+    readonly timing?: SyncGatewayTiming;
+}
+/** Gateway capability for reading literal table values without observation metadata. */
+export interface SyncSheetTableReaderGateway {
+    readRows(request: ReadSyncTableRowsRequest): Promise<SyncTableRowsResult>;
+    readRowsBatch(requests: readonly ReadSyncTableRowsRequest[]): Promise<readonly SyncTableRowsResult[]>;
+}
+/**
+ * Full gateway boundary used by observation and reconciliation.
+ *
+ * It includes the full effect-worker capabilities plus the metadata/snapshot
+ * reads required to observe user edits and repair projection drift.
+ */
+export interface SyncSheetGateway extends SyncEffectWorkerFullGateway, SyncSheetObservationGateway {
+}
+/**
+ * Dependencies for a gateway that routes append writes and full observation
+ * work to separate remote capabilities.
+ *
+ * The fast gateway may be the thin operation-based Code.gs deployment, while
+ * the full gateway may be a separately deployed observation/reconciliation
+ * endpoint. Keeping this composition explicit prevents a fast-only endpoint
+ * from being mistaken for a complete sync gateway.
+ */
+export interface SplitSyncGatewayOptions {
+    readonly fastGateway: SyncEffectWorkerGateway;
+    readonly fullGateway: SyncSheetGateway;
+}
+/**
+ * Combines the low-latency append path with the full observation path.
+ *
+ * New System_State creates use `fastGateway`. Updates, deletes, response-loss
+ * recovery, user-edit observation, and reconciliation use `fullGateway`.
+ * Neither delegate is allowed to silently handle the other capability.
+ */
+export declare class SplitSyncGateway implements SyncSheetGateway {
+    private readonly fastGateway;
+    private readonly fullGateway;
+    constructor(options: SplitSyncGatewayOptions);
+    /** Sends append-only System_State creates through the thin gateway. */
+    fastAppendRows(request: FastAppendRowsRequest): Promise<FastAppendRowsResult>;
+    /** Sends regular effect writes through the full gateway. */
+    applyEffects(request: ApplySyncEffectsRequest): Promise<ApplySyncEffectsResult>;
+    /** Reads one effect postcondition through the full gateway. */
+    readEffectPostcondition(effect: SyncGatewayEffect): Promise<SyncEffectPostcondition>;
+    /** Reads a batch of effect postconditions through the full gateway. */
+    readEffectPostconditions(request: ReadSyncEffectPostconditionsRequest): Promise<readonly SyncGatewayEffectPostconditionResult[]>;
+    /** Ensures row anchors through the full observation gateway. */
+    ensureRowAnchors(request: EnsureSyncRowAnchorsRequest): Promise<EnsureSyncRowAnchorsResult>;
+    /** Reads snapshots through the full observation gateway. */
+    readSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncGatewaySnapshot>;
+    /** Shares the full gateway's combined observation capability when present. */
+    observeSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncObservedSnapshot>;
+    /** Shares one remote observation request across the supplied projections. */
+    observeSnapshots(requests: readonly ReadSyncSnapshotRequest[]): Promise<readonly SyncObservedSnapshot[]>;
+}
+/** Computes the stable visible-state hash shared by fake and real gateways. */
+export declare function computeSyncVisibleHash(fields: Readonly<Record<string, NormalizedCell>>): string;
+/** Validates and decodes the projection payload stored in a durable outbox row. */
+export declare function parseSyncProjectionEffectPayload(value: string): SyncProjectionEffectPayload;
+/** Serializes a checked projection payload in a stable key order for outbox use. */
+export declare function serializeSyncProjectionEffectPayload(payload: SyncProjectionEffectPayload): string;
+//# sourceMappingURL=syncGateway.d.ts.map

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

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

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

@@ -0,0 +1,202 @@
+/**
+ * Shared gateway 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 gateway and
+ * the Apps Script client implement this boundary so fault tests exercise the
+ * same compare-and-set semantics as a deployed gateway.
+ */
+import { stableHash, } from "../../../domain/index.js";
+import { JAVASCRIPT_TYPE_NAMES, NORMALIZED_CELL_KINDS, } from "../../../shared/encoding/constants.js";
+import { isJavaScriptType, isRecord, } from "../../../shared/encoding/typeGuards.js";
+import { APPLICABILITY_KINDS } from "../../../shared/state/constants.js";
+import { EMPTY_ARRAY_LENGTH_ZERO, EMPTY_STRING_LENGTH_ZERO, } from "../../../shared/constants.js";
+import { SYNC_GATEWAY_ERROR_CODES, SyncGatewayContractError, } from "./errors.js";
+import { requireSyncGatewayPositiveSafeInteger, requireSyncGatewayText, } from "./validation.js";
+/** Returns whether a gateway supports the one-request observation path. */
+export function isSyncSheetObservationBatchGateway(gateway) {
+    const candidate = gateway;
+    return typeof candidate.observeSnapshot === "function" &&
+        typeof candidate.observeSnapshots === "function";
+}
+/** Reads one snapshot with one combined request when the gateway supports it. */
+export async function observeSyncSnapshot(gateway, request) {
+    if (isSyncSheetObservationBatchGateway(gateway)) {
+        return gateway.observeSnapshot(request);
+    }
+    const anchors = await gateway.ensureRowAnchors(request);
+    const snapshot = await gateway.readSnapshot(request);
+    return { anchors, snapshot };
+}
+/** Reads several snapshots through one remote operation when available. */
+export async function observeSyncSnapshots(gateway, requests) {
+    if (isSyncSheetObservationBatchGateway(gateway)) {
+        return gateway.observeSnapshots(requests);
+    }
+    const results = [];
+    for (const request of requests) {
+        results.push(await observeSyncSnapshot(gateway, request));
+    }
+    return results;
+}
+/**
+ * Combines the low-latency append path with the full observation path.
+ *
+ * New System_State creates use `fastGateway`. Updates, deletes, response-loss
+ * recovery, user-edit observation, and reconciliation use `fullGateway`.
+ * Neither delegate is allowed to silently handle the other capability.
+ */
+export class SplitSyncGateway {
+    fastGateway;
+    fullGateway;
+    constructor(options) {
+        this.fastGateway = options.fastGateway;
+        this.fullGateway = options.fullGateway;
+    }
+    /** Sends append-only System_State creates through the thin gateway. */
+    fastAppendRows(request) {
+        return this.fastGateway.fastAppendRows(request);
+    }
+    /** Sends regular effect writes through the full gateway. */
+    applyEffects(request) {
+        return this.fullGateway.applyEffects(request);
+    }
+    /** Reads one effect postcondition through the full gateway. */
+    readEffectPostcondition(effect) {
+        return this.fullGateway.readEffectPostcondition(effect);
+    }
+    /** Reads a batch of effect postconditions through the full gateway. */
+    readEffectPostconditions(request) {
+        return this.fullGateway.readEffectPostconditions(request);
+    }
+    /** Ensures row anchors through the full observation gateway. */
+    ensureRowAnchors(request) {
+        return this.fullGateway.ensureRowAnchors(request);
+    }
+    /** Reads snapshots through the full observation gateway. */
+    readSnapshot(request) {
+        return this.fullGateway.readSnapshot(request);
+    }
+    /** Shares the full gateway's combined observation capability when present. */
+    observeSnapshot(request) {
+        return observeSyncSnapshot(this.fullGateway, request);
+    }
+    /** Shares one remote observation request across the supplied projections. */
+    observeSnapshots(requests) {
+        return observeSyncSnapshots(this.fullGateway, requests);
+    }
+}
+/** Computes the stable visible-state hash shared by fake and real gateways. */
+export function computeSyncVisibleHash(fields) {
+    const entries = Object.entries(fields)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .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 SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload is not valid JSON");
+    }
+    if (!isRecord(parsed)) {
+        throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload must be an object");
+    }
+    const sheetName = requireSyncGatewayText(parsed.sheetName, "effect payload sheetName", SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const registeredRange = requireSyncGatewayText(parsed.registeredRange, "effect payload registeredRange", SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const targetAnchor = requireSyncGatewayText(parsed.targetAnchor, "effect payload targetAnchor", SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const targetVisibleHash = requireSyncGatewayText(parsed.targetVisibleHash, "effect payload targetVisibleHash", SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    const schemaVersion = requireSyncGatewayPositiveSafeInteger(parsed.schemaVersion, "effect payload schemaVersion", SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    if (!isJavaScriptType(parsed.createIfMissing, JAVASCRIPT_TYPE_NAMES.BOOLEAN)) {
+        throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload createIfMissing must be boolean");
+    }
+    const expectedCandidateHash = parseNullableCandidateHash(parsed.expectedCandidateHash);
+    if (!isRecord(parsed.fields)) {
+        throw new SyncGatewayContractError(SYNC_GATEWAY_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 SyncGatewayContractError(SYNC_GATEWAY_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 SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "effect payload must contain a field");
+    }
+    if (computeSyncVisibleHash(fields) !== targetVisibleHash) {
+        throw new SyncGatewayContractError(SYNC_GATEWAY_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 gateway 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.localeCompare(b))),
+        targetVisibleHash: checked.targetVisibleHash,
+        createIfMissing: checked.createIfMissing,
+        expectedCandidateHash: toNullableCandidateHash(checked.expectedCandidateHash),
+    });
+}
+function parseNullableCandidateHash(value) {
+    if (value === null) {
+        return { kind: APPLICABILITY_KINDS.NOT_APPLICABLE };
+    }
+    return {
+        kind: APPLICABILITY_KINDS.APPLICABLE,
+        value: requireSyncGatewayText(value, "effect payload expectedCandidateHash", SYNC_GATEWAY_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;
+}
+function isNormalizedCell(value) {
+    if (value === null)
+        return true;
+    if (!isRecord(value))
+        return false;
+    if (value.kind === NORMALIZED_CELL_KINDS.STRING) {
+        return typeof value.value === JAVASCRIPT_TYPE_NAMES.STRING;
+    }
+    if (value.kind === NORMALIZED_CELL_KINDS.NUMBER) {
+        return (typeof value.value === JAVASCRIPT_TYPE_NAMES.NUMBER &&
+            Number.isFinite(value.value));
+    }
+    if (value.kind === NORMALIZED_CELL_KINDS.BOOLEAN) {
+        return typeof value.value === JAVASCRIPT_TYPE_NAMES.BOOLEAN;
+    }
+    return (value.kind === NORMALIZED_CELL_KINDS.DATE &&
+        typeof value.value === JAVASCRIPT_TYPE_NAMES.STRING);
+}
+//# sourceMappingURL=syncGateway.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { type SyncGatewayProjection, type SyncGatewayProtocolVersion, type SyncGatewaySnapshotReadMode } from "./constants.js";
+import { type SyncGatewayErrorCode } from "./errors.js";
+/** Requires a non-empty string at a gateway contract boundary. */
+export declare function requireSyncGatewayText(value: unknown, label: string, errorCode: SyncGatewayErrorCode): string;
+/** Requires a positive safe integer at a gateway contract boundary. */
+export declare function requireSyncGatewayPositiveSafeInteger(value: unknown, label: string, errorCode: SyncGatewayErrorCode): number;
+/** Requires a non-negative safe integer at a gateway contract boundary. */
+export declare function requireSyncGatewayNonNegativeSafeInteger(value: unknown, label: string, errorCode: SyncGatewayErrorCode): number;
+/** Requires a protocol version returned by the runtime gateway. */
+export declare function requireSyncGatewayProtocolVersion(value: unknown, label: string, errorCode: SyncGatewayErrorCode): SyncGatewayProtocolVersion;
+/** Requires a projection label returned by the runtime gateway. */
+export declare function requireSyncGatewayProjection(value: unknown, label: string, errorCode: SyncGatewayErrorCode): SyncGatewayProjection;
+/** Requires a supported snapshot detail level at a gateway boundary. */
+export declare function requireSyncGatewaySnapshotReadMode(value: unknown, label: string, errorCode: SyncGatewayErrorCode): SyncGatewaySnapshotReadMode;
+/** Requires a non-empty list at a gateway contract boundary. */
+export declare function requireSyncGatewayNonEmptyList<T>(values: readonly T[], label: string, errorCode: SyncGatewayErrorCode): void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/gateway/validation.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EACjC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AAErB,kEAAkE;AAClE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAKR;AAED,uEAAuE;AACvE,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAQR;AAED,2EAA2E;AAC3E,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAQR;AAED,mEAAmE;AACnE,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,GAC9B,0BAA0B,CAW5B;AAED,mEAAmE;AACnE,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,GAC9B,qBAAqB,CAWvB;AAED,wEAAwE;AACxE,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,GAC9B,2BAA2B,CAa7B;AAED,gEAAgE;AAChE,wBAAgB,8BAA8B,CAAC,CAAC,EAC9C,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,GAC9B,IAAI,CAIN"}

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

@@ -0,0 +1,60 @@
+import { JAVASCRIPT_TYPE_NAMES } from "../../../shared/encoding/constants.js";
+import { isJavaScriptType } from "../../../shared/encoding/typeGuards.js";
+import { isNonEmptyList, isNonEmptyString, isNonNegativeSafeInteger, isPositiveSafeInteger, } from "../../../shared/validation.js";
+import { SYNC_GATEWAY_PROJECTIONS, SYNC_GATEWAY_PROTOCOL_VERSIONS, SYNC_GATEWAY_SNAPSHOT_READ_MODES, } from "./constants.js";
+import { SyncGatewayContractError, } from "./errors.js";
+/** Requires a non-empty string at a gateway contract boundary. */
+export function requireSyncGatewayText(value, label, errorCode) {
+    if (!isNonEmptyString(value)) {
+        throw new SyncGatewayContractError(errorCode, `${label} is required`);
+    }
+    return value;
+}
+/** Requires a positive safe integer at a gateway contract boundary. */
+export function requireSyncGatewayPositiveSafeInteger(value, label, errorCode) {
+    if (!isPositiveSafeInteger(value)) {
+        throw new SyncGatewayContractError(errorCode, `${label} must be a positive safe integer`);
+    }
+    return value;
+}
+/** Requires a non-negative safe integer at a gateway contract boundary. */
+export function requireSyncGatewayNonNegativeSafeInteger(value, label, errorCode) {
+    if (!isNonNegativeSafeInteger(value)) {
+        throw new SyncGatewayContractError(errorCode, `${label} must be a non-negative safe integer`);
+    }
+    return value;
+}
+/** Requires a protocol version returned by the runtime gateway. */
+export function requireSyncGatewayProtocolVersion(value, label, errorCode) {
+    if (!isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.STRING) ||
+        value !== SYNC_GATEWAY_PROTOCOL_VERSIONS.V1) {
+        throw new SyncGatewayContractError(errorCode, `${label} is not supported`);
+    }
+    return value;
+}
+/** Requires a projection label returned by the runtime gateway. */
+export function requireSyncGatewayProjection(value, label, errorCode) {
+    if (!isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.STRING) ||
+        !isSyncGatewayProjection(value)) {
+        throw new SyncGatewayContractError(errorCode, `${label} is not supported`);
+    }
+    return value;
+}
+/** Requires a supported snapshot detail level at a gateway boundary. */
+export function requireSyncGatewaySnapshotReadMode(value, label, errorCode) {
+    if (!isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.STRING) ||
+        !Object.values(SYNC_GATEWAY_SNAPSHOT_READ_MODES).includes(value)) {
+        throw new SyncGatewayContractError(errorCode, `${label} is not supported`);
+    }
+    return value;
+}
+/** Requires a non-empty list at a gateway contract boundary. */
+export function requireSyncGatewayNonEmptyList(values, label, errorCode) {
+    if (!isNonEmptyList(values)) {
+        throw new SyncGatewayContractError(errorCode, `${label} requires at least one item`);
+    }
+}
+function isSyncGatewayProjection(value) {
+    return Object.values(SYNC_GATEWAY_PROJECTIONS).includes(value);
+}
+//# sourceMappingURL=validation.js.map

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

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