hikoutei 0.5.0 → 0.5.2

package/dist/adapter/sheets/providers/google-sheets-api/operations/applyEffects.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Apply-effects operation for the Google Sheets API sync provider.
+ *
+ * Applies regular update/delete/create effects through one atomic batch:
+ * schema-error effects sit before the included run, rejected plans
+ * (guard/schema/repair outcomes) contribute no requests, inline mode
+ * verifies written rows with a re-read, and deferred mode relies on the
+ * atomic target+receipt batch. Response-loss recovery classifies effects
+ * through a fresh target+receipt read.
+ */
+import type { ApplySyncEffectsRequest, ApplySyncEffectsResult, ReadSyncEffectPostconditionsRequest, SyncEffectPostcondition, SyncEffectPostconditionResult, SyncProjectionEffect } from "../../../../../application/sync/sheets/syncSheets.js";
+import { type GoogleSheetsApiProviderDeps } from "./shared.js";
+/** Applies regular update/delete/create effects through one atomic batch. */
+export declare function applyEffects(deps: GoogleSheetsApiProviderDeps, request: ApplySyncEffectsRequest): Promise<ApplySyncEffectsResult>;
+/** Classifies one response-loss effect through a fresh target+receipt read. */
+export declare function readEffectPostcondition(deps: GoogleSheetsApiProviderDeps, effect: SyncProjectionEffect): Promise<SyncEffectPostcondition>;
+/** Classifies a recovery batch with one shared target+receipt read. */
+export declare function readEffectPostconditions(deps: GoogleSheetsApiProviderDeps, request: ReadSyncEffectPostconditionsRequest): Promise<readonly SyncEffectPostconditionResult[]>;
+//# sourceMappingURL=applyEffects.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/applyEffects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyEffects.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/applyEffects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,mCAAmC,EACnC,uBAAuB,EACvB,6BAA6B,EAE7B,oBAAoB,EACrB,MAAM,sDAAsD,CAAC;AAqB9D,OAAO,EAML,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAGrB,6EAA6E;AAC7E,wBAAsB,YAAY,CAChC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAyHjC;AAED,+EAA+E;AAC/E,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,2BAA2B,EACjC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAalC;AAED,uEAAuE;AACvE,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,SAAS,6BAA6B,EAAE,CAAC,CAanD"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/applyEffects.js

@@ -0,0 +1,188 @@
+/**
+ * Apply-effects operation for the Google Sheets API sync provider.
+ *
+ * Applies regular update/delete/create effects through one atomic batch:
+ * schema-error effects sit before the included run, rejected plans
+ * (guard/schema/repair outcomes) contribute no requests, inline mode
+ * verifies written rows with a re-read, and deferred mode relies on the
+ * atomic target+receipt batch. Response-loss recovery classifies effects
+ * through a fresh target+receipt read.
+ */
+import { SYNC_POSTCONDITION_MODES } from "../../../../../application/sync/sheets/constants.js";
+import { presentValue, absentValue } from "../../../../../shared/state/index.js";
+import { GOOGLE_SHEETS_API_DEFAULTS, GOOGLE_SHEETS_API_EFFECT_REASONS } from "../constants.js";
+import { invalidProviderRequest, invalidProviderState } from "../errors.js";
+import { currentHash, encodeOutcomeResult, encodeSchemaErrorResult, planEffectBatch, withDeferredPostcondition, } from "../model/planner.js";
+import { buildAppendBatchRequests, buildApplyBatchRequests, resolveApplyBatchBudget, } from "../model/batchBuilder.js";
+import { classifyPostcondition } from "../model/postcondition.js";
+import { definitionForPhysicalSheet, effectRouteOptions, requireValidBatchUpdateReply, runWrite, validateRoute, } from "./shared.js";
+import { readPreflight } from "./preflightOp.js";
+/** Applies regular update/delete/create effects through one atomic batch. */
+export async function applyEffects(deps, request) {
+    const definition = definitionForPhysicalSheet(deps, request.physicalSheetId);
+    validateRoute(request, definition);
+    if (request.effects.length === 0) {
+        invalidProviderRequest("apply effects", "effects must not be empty");
+    }
+    const bounded = request.effects.slice(0, GOOGLE_SHEETS_API_DEFAULTS.MAX_EFFECTS_PER_REQUEST);
+    const postconditionMode = request.postconditionMode ?? SYNC_POSTCONDITION_MODES.INLINE;
+    if (postconditionMode !== SYNC_POSTCONDITION_MODES.INLINE &&
+        postconditionMode !== SYNC_POSTCONDITION_MODES.DEFERRED) {
+        invalidProviderRequest("apply effects", "postconditionMode must be inline or deferred");
+    }
+    const routeOptions = effectRouteOptions(definition);
+    const context = await readPreflight(deps, request, definition, routeOptions);
+    const plans = planEffectBatch({ ...request, effects: bounded }, context);
+    const includeReceipts = postconditionMode === SYNC_POSTCONDITION_MODES.DEFERRED;
+    const updatedAt = new Date(deps.now()).toISOString();
+    const resolution = resolveApplyBatchBudget(context, plans, {
+        maxBatchBytes: deps.maxBatchBytes,
+        includeReceipts,
+        updatedAt,
+    });
+    const schemaErrorIndices = new Set(resolution.schemaErrorIndices);
+    // Schema-error effects sit BEFORE the included run; the batch only carries
+    // the plans after them, up to the resolved include count. The included
+    // effects are re-planned so appended rows start at the sheet's first free
+    // row (the full-plan row numbers would leave blank gaps for excluded
+    // effects). The planner is deterministic over the unchanged context, so
+    // outcomes and receipts are identical to the budget-resolution plans.
+    const includedStart = resolution.schemaErrorIndices.length;
+    const includedEffects = bounded.slice(includedStart, resolution.includeCount);
+    const included = planEffectBatch({ ...request, effects: includedEffects }, context);
+    if (included.length > 0) {
+        const batch = buildApplyBatchRequests(context, included, { updatedAt, includeReceipts });
+        // Rejected plans (guard/schema/repair outcomes) contribute no requests;
+        // never send an empty batchUpdate for an all-rejected prefix.
+        if (batch.requests.length > 0) {
+            const response = await runWrite(deps, () => deps.transport.batchUpdate({
+                spreadsheetId: deps.spreadsheetId,
+                requests: batch.requests,
+            }));
+            requireValidBatchUpdateReply(response, batch.requests.length);
+        }
+    }
+    // Inline verification reads the written rows back and demotes any hash
+    // mismatch to retryable_error, mirroring the Apps Script inline path. The
+    // worker always uses deferred mode, where the atomic batch already carries
+    // target mutations and receipts together.
+    const verified = new Set();
+    if (postconditionMode === SYNC_POSTCONDITION_MODES.INLINE && included.length > 0) {
+        const verifyContext = await readPreflight(deps, request, definition, routeOptions);
+        included.forEach((plan, index) => {
+            if (!plan.verify || plan.mutation === undefined || plan.mutation.kind === "delete")
+                return;
+            const row = findProbeRowInContext(verifyContext, plan);
+            const current = row === undefined ? undefined : currentHash(row, plan.outcome.effect.payload.fields);
+            if (current === plan.outcome.effect.payload.targetVisibleHash) {
+                verified.add(index);
+            }
+        });
+        const verifyReceipts = [];
+        included.forEach((plan, index) => {
+            if (plan.receipt === undefined)
+                return;
+            // Replay receipts are already stored in the sheet; never rewrite them.
+            if (context.receipts.has(plan.receipt.effectId))
+                return;
+            if (plan.outcome.kind === "applied" && !plan.outcome.deletion && !verified.has(index))
+                return;
+            verifyReceipts.push(plan.receipt);
+        });
+        if (verifyReceipts.length > 0) {
+            const receiptBatch = buildAppendBatchRequests(context, [], verifyReceipts, { updatedAt });
+            const response = await runWrite(deps, () => deps.transport.batchUpdate({
+                spreadsheetId: deps.spreadsheetId,
+                requests: receiptBatch.requests,
+            }));
+            requireValidBatchUpdateReply(response, receiptBatch.requests.length);
+        }
+    }
+    const results = [];
+    let includedCursor = 0;
+    bounded.forEach((effect, index) => {
+        if (schemaErrorIndices.has(index)) {
+            results.push(encodeSchemaErrorResult(effect, GOOGLE_SHEETS_API_EFFECT_REASONS.EFFECT_PAYLOAD_TOO_LARGE));
+            return;
+        }
+        if (index >= resolution.includeCount)
+            return;
+        const planIndex = includedCursor;
+        includedCursor += 1;
+        const plan = included[planIndex];
+        if (plan === undefined)
+            return;
+        let result = encodeOutcomeResult(plan.outcome);
+        if (postconditionMode === SYNC_POSTCONDITION_MODES.INLINE &&
+            plan.outcome.kind === "applied" &&
+            !plan.outcome.deletion &&
+            !verified.has(planIndex)) {
+            result = {
+                ...result,
+                status: "retryable_error",
+                visibleRevision: absentValue(),
+                visibleHash: absentValue(),
+                reason: presentValue(GOOGLE_SHEETS_API_EFFECT_REASONS.POSTCONDITION_HASH_MISMATCH),
+                postcondition: "unavailable",
+            };
+        }
+        else if (postconditionMode === SYNC_POSTCONDITION_MODES.DEFERRED) {
+            result = withDeferredPostcondition(result);
+        }
+        results.push(result);
+    });
+    return {
+        results,
+        snapshotHash: absentValue(),
+        hasMore: bounded.length < request.effects.length || results.length < bounded.length,
+    };
+}
+/** Classifies one response-loss effect through a fresh target+receipt read. */
+export async function readEffectPostcondition(deps, effect) {
+    const [result] = await readEffectPostconditions(deps, {
+        physicalSheetId: effect.physicalSheetId,
+        sheetName: effect.payload.sheetName,
+        registeredRange: effect.payload.registeredRange,
+        projection: effect.projection,
+        schemaVersion: effect.payload.schemaVersion,
+        effects: [effect],
+    });
+    if (result === undefined) {
+        invalidProviderState("postcondition read returned no result");
+    }
+    return result.postcondition;
+}
+/** Classifies a recovery batch with one shared target+receipt read. */
+export async function readEffectPostconditions(deps, request) {
+    const definition = definitionForPhysicalSheet(deps, request.physicalSheetId);
+    validateRoute(request, definition);
+    if (request.effects.length === 0) {
+        invalidProviderRequest("postcondition reads", "effects must not be empty");
+    }
+    const routeOptions = effectRouteOptions(definition);
+    const context = await readPreflight(deps, request, definition, routeOptions);
+    return request.effects.map((effect) => ({
+        effectId: effect.effectId,
+        payloadHash: effect.payloadHash,
+        postcondition: classifyPostcondition(context, effect, context.receipts),
+    }));
+}
+/** Locates one planned write's row in a fresh verification context. */
+function findProbeRowInContext(context, plan) {
+    const mutation = plan.mutation;
+    if (mutation === undefined)
+        return undefined;
+    if (mutation.kind === "append") {
+        return context.rows.find((row) => row.rowNumber === mutation.row.rowNumber);
+    }
+    const anchor = mutation.row.anchor;
+    if (anchor.kind === "present") {
+        return context.rows.find((row) => row.physicalAnchor.kind === "present" && row.physicalAnchor.value === anchor.value);
+    }
+    const identity = mutation.row.identity;
+    if (identity.kind === "present") {
+        return context.rows.find((row) => row.identity.kind === "present" && row.identity.value === identity.value);
+    }
+    return undefined;
+}
+//# sourceMappingURL=applyEffects.js.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/applyEffects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyEffects.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/applyEffects.ts"],"names":[],"mappings":"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"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/fastAppend.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fast-append operation for the Google Sheets API sync provider.
+ *
+ * Appends rows through one idempotent, atomic target+receipt batch: replay
+ * rows are recognized through the receipt tab and verified against the
+ * visible identity, pending rows pass the identity preflight, and a
+ * byte-budget deferral commits only a prefix of the pending rows.
+ */
+import { type FastAppendRowsRequest, type FastAppendRowsResult } from "../../../../../application/sync/sheets/syncSheets.js";
+import { type GoogleSheetsApiProviderDeps } from "./shared.js";
+/** Appends rows through one idempotent, atomic target+receipt batch. */
+export declare function fastAppendRows(deps: GoogleSheetsApiProviderDeps, request: FastAppendRowsRequest): Promise<FastAppendRowsResult>;
+//# sourceMappingURL=fastAppend.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/fastAppend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastAppend.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/fastAppend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAG1B,MAAM,sDAAsD,CAAC;AAiB9D,OAAO,EAML,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAGrB,wEAAwE;AACxE,wBAAsB,cAAc,CAClC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAiI/B"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/fastAppend.js

@@ -0,0 +1,229 @@
+/**
+ * Fast-append operation for the Google Sheets API sync provider.
+ *
+ * Appends rows through one idempotent, atomic target+receipt batch: replay
+ * rows are recognized through the receipt tab and verified against the
+ * visible identity, pending rows pass the identity preflight, and a
+ * byte-budget deferral commits only a prefix of the pending rows.
+ */
+import { computeSyncVisibleHash, } from "../../../../../application/sync/sheets/syncSheets.js";
+import { SYNC_SHEETS_ERROR_CODES, SyncSheetsContractError, } from "../../../../../application/sync/sheets/errors.js";
+import { SYNC_FAST_APPEND_STATUSES } from "../../../../../application/sync/sheets/constants.js";
+import { absentValue } from "../../../../../shared/state/index.js";
+import { isNormalizedCell } from "../../../../../shared/encoding/index.js";
+import { GOOGLE_SHEETS_API_DEFAULTS } from "../constants.js";
+import { invalidProviderRequest, invalidProviderState } from "../errors.js";
+import { identityFromNormalizedCell } from "../model/valueNormalization.js";
+import { buildAppendBatchRequests, resolveAppendBudget, } from "../model/batchBuilder.js";
+import { definitionForPhysicalSheet, effectRouteOptions, requireValidBatchUpdateReply, runWrite, validateRoute, } from "./shared.js";
+import { readPreflight } from "./preflightOp.js";
+/** Appends rows through one idempotent, atomic target+receipt batch. */
+export async function fastAppendRows(deps, request) {
+    const definition = definitionForPhysicalSheet(deps, request.physicalSheetId);
+    validateRoute(request, definition);
+    const routeOptions = effectRouteOptions(definition);
+    if (routeOptions.identityField.kind !== "present") {
+        // The fast path never materializes anchor metadata, so a route without
+        // a registered identity cannot locate or guard its rows on replay.
+        throw new SyncSheetsContractError(SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "fast append requires a registered identityField for route " + request.physicalSheetId);
+    }
+    if (request.rows.length === 0) {
+        invalidProviderRequest("fast append", "rows must not be empty");
+    }
+    const bounded = request.rows.slice(0, GOOGLE_SHEETS_API_DEFAULTS.MAX_APPEND_ROWS_PER_REQUEST);
+    validateAppendRows(bounded);
+    const context = await readPreflight(deps, request, definition, routeOptions);
+    validateAppendRowsAgainstHeaders(bounded, context.headers);
+    const identityField = routeOptions.identityField.value;
+    // Replay rows are recognized through the receipt tab and verified against
+    // the visible identity; pending rows go through the identity preflight.
+    const pending = [];
+    const resultsById = new Map();
+    const pendingReceipts = [];
+    for (const row of bounded) {
+        // The worker always supplies the outbox payload hash; fail closed when
+        // it is absent instead of silently falling back to the effect ID.
+        const payloadHash = row.payloadHash;
+        if (payloadHash === undefined || payloadHash.length === 0) {
+            invalidProviderRequest("fast append", `payloadHash is required for effectId: ${row.effectId}`);
+        }
+        const existing = context.receipts.get(row.effectId);
+        if (existing !== undefined) {
+            if (existing.payloadHash !== payloadHash) {
+                invalidProviderRequest("fast append", `effect ID cannot be reused with another payload: ${row.effectId}`);
+            }
+            const identity = appendIdentity(row, identityField);
+            const existingRow = findRowByIdentity(context, identity);
+            if (existingRow === undefined) {
+                invalidProviderRequest("fast append", `receipt postcondition row is unavailable for effectId: ${row.effectId}`);
+            }
+            if (computeSyncVisibleHash(existingRow.cells) !== existing.visibleHash) {
+                invalidProviderRequest("fast append", `receipt postcondition changed for effectId: ${row.effectId}`);
+            }
+            resultsById.set(row.effectId, {
+                effectId: row.effectId,
+                status: SYNC_FAST_APPEND_STATUSES.APPLIED,
+                visibleHash: existing.visibleHash,
+                visibleRevision: existing.visibleRevision,
+            });
+            continue;
+        }
+        pending.push(row);
+        pendingReceipts.push(makeAppendReceipt(row.effectId, payloadHash, computeSyncVisibleHash(row.fields)));
+    }
+    // Mirror the built-in append identity preflight: the registered identity
+    // must exist and be unique across the sheet and the pending batch; replay
+    // entries are exempt exactly like the real provider.
+    let deferredSuffix = false;
+    if (pending.length > 0) {
+        assertAppendIdentityAvailability(context, identityField, pending);
+        const pendingRows = pending.map((row, index) => toAppendWorkingRow(row, context.nextAppendRow + index));
+        const updatedAt = new Date(deps.now()).toISOString();
+        const resolution = resolveAppendBudget(pendingRows, (count) => buildAppendBatchRequests(context, pendingRows.slice(0, count), pendingReceipts.slice(0, count), { updatedAt }), deps.maxBatchBytes);
+        deferredSuffix = resolution.includeCount < pending.length;
+        if (resolution.includeCount > 0) {
+            const batch = buildAppendBatchRequests(context, pendingRows.slice(0, resolution.includeCount), pendingReceipts.slice(0, resolution.includeCount), { updatedAt });
+            const response = await runWrite(deps, () => deps.transport.batchUpdate({
+                spreadsheetId: deps.spreadsheetId,
+                requests: batch.requests,
+            }));
+            requireValidBatchUpdateReply(response, batch.requests.length);
+            pendingReceipts.slice(0, resolution.includeCount).forEach((receipt) => {
+                resultsById.set(receipt.effectId, {
+                    effectId: receipt.effectId,
+                    status: SYNC_FAST_APPEND_STATUSES.APPLIED,
+                    visibleHash: receipt.visibleHash,
+                    visibleRevision: receipt.visibleRevision,
+                });
+            });
+        }
+    }
+    // A byte-budget deferral commits only a prefix of the pending rows, so
+    // results cover exactly the processed rows: receipt-matched replays plus
+    // the included prefix. Rows beyond the included prefix are intentionally
+    // absent from results; the worker releases them (releaseUnprocessedEffect)
+    // for the next pass when hasMore is true.
+    const results = [];
+    for (const row of bounded) {
+        const result = resultsById.get(row.effectId);
+        if (result === undefined)
+            continue;
+        results.push(result);
+    }
+    return {
+        results,
+        hasMore: bounded.length < request.rows.length || deferredSuffix,
+    };
+}
+/** Builds the fixed-shape receipt record used by the fast-append path. */
+function makeAppendReceipt(effectId, payloadHash, visibleHash) {
+    return {
+        effectId,
+        payloadHash,
+        status: "applied",
+        visibleHash,
+        visibleRevision: 1,
+    };
+}
+/** Validates the append rows before any remote read or write. */
+function validateAppendRows(rows) {
+    const seenEffectIds = new Set();
+    for (const row of rows) {
+        if (row.effectId.length === 0 || seenEffectIds.has(row.effectId)) {
+            invalidProviderRequest("fast append", "effectIds must be non-empty and unique");
+        }
+        seenEffectIds.add(row.effectId);
+        const payloadHash = row.payloadHash;
+        if (payloadHash === undefined || payloadHash.length === 0) {
+            invalidProviderRequest("fast append", "payloadHash is required");
+        }
+        if (row.anchor !== undefined && row.anchor.length === 0) {
+            invalidProviderRequest("fast append", "row anchor must be non-empty");
+        }
+        const fields = row.fields;
+        if (fields === null || typeof fields !== "object" || Array.isArray(fields)) {
+            invalidProviderRequest("fast append", "row fields must be an object");
+        }
+        if (Object.keys(fields).length === 0) {
+            invalidProviderRequest("fast append", "row fields are required");
+        }
+        for (const value of Object.values(fields)) {
+            if (!isNormalizedCell(value)) {
+                invalidProviderRequest("fast append", "row fields contain an invalid normalized cell");
+            }
+        }
+    }
+}
+/** Append rows must cover exactly the registered headers (batch append rule). */
+function validateAppendRowsAgainstHeaders(rows, headers) {
+    const expected = [...headers].sort();
+    for (const row of rows) {
+        const actual = Object.keys(row.fields).sort();
+        if (actual.length !== expected.length ||
+            actual.some((field, index) => field !== expected[index])) {
+            invalidProviderRequest("fast append", "rows must contain exactly the registered headers");
+        }
+    }
+}
+/**
+ * Derives the append identity from the row's identity field cell, using the
+ * canonical identity rule (non-empty string or finite number) shared with
+ * the append/replay paths.
+ */
+function appendIdentity(row, identityField) {
+    const cell = row.fields[identityField] ?? null;
+    const identity = identityFromNormalizedCell(cell);
+    if (identity === null) {
+        invalidProviderRequest("fast append", `sync identity is required for append: ${identityField}`);
+    }
+    return identity;
+}
+/** Finds a preflight row by its visible identity (single match or fail closed). */
+function findRowByIdentity(context, identity) {
+    const matches = context.rows.filter((row) => row.identity.kind === "present" && row.identity.value === identity);
+    if (matches.length > 1) {
+        invalidProviderState(`sync identity is duplicated: ${identity}`);
+    }
+    return matches[0];
+}
+/**
+ * Mirrors the built-in append identity preflight: every existing data row
+ * needs a unique identity, and every pending non-replay row needs a fresh,
+ * non-empty identity.
+ */
+function assertAppendIdentityAvailability(context, identityField, pending) {
+    const existing = new Map();
+    context.rows.forEach((row) => {
+        if (row.identity.kind !== "present") {
+            invalidProviderState(`sync identity is missing at row ${row.rowNumber}`);
+        }
+        const location = existing.get(row.identity.value);
+        if (location !== undefined) {
+            invalidProviderState(`sync identity is duplicated: ${row.identity.value} at rows ${location} and ${row.rowNumber}`);
+        }
+        existing.set(row.identity.value, String(row.rowNumber));
+    });
+    for (const row of pending) {
+        const identity = appendIdentity(row, identityField);
+        const location = existing.get(identity);
+        if (location !== undefined) {
+            invalidProviderState(`sync identity already exists: ${identity} at ${location}`);
+        }
+        existing.set(identity, "pending");
+    }
+}
+/** Builds a working row for one pending append at its reserved position. */
+function toAppendWorkingRow(row, rowNumber) {
+    // The fast path never materializes anchor metadata (the Apps Script batch
+    // append path ignores the advisory row anchor); the row replays by identity.
+    return {
+        rowNumber,
+        anchor: absentValue(),
+        cells: { ...row.fields },
+        identity: absentValue(),
+        appended: true,
+        deleted: false,
+        writeFields: {},
+    };
+}
+//# sourceMappingURL=fastAppend.js.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/fastAppend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastAppend.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/fastAppend.ts"],"names":[],"mappings":"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"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/preflightOp.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Preflight and observation-target operations for the Google Sheets API
+ * sync provider.
+ *
+ * `readPreflight` performs the two paced transport calls every outbound
+ * effect operation needs (range-less sheet enumeration for hidden receipt
+ * tab discovery, plus one bounded data read of the target and receipt tabs).
+ * `observationTargetFor` validates one observation request and derives its
+ * snapshot build target, failing closed on unknown read modes.
+ */
+import type { ReadSyncSnapshotRequest } from "../../../../../application/sync/sheets/syncSheets.js";
+import type { RegisteredSyncProjectionDefinition } from "../../../../../application/sync/sheets/sheetsProvisioning.js";
+import type { Presence } from "../../../../../shared/state/index.js";
+import { type PreflightContext } from "../model/preflight.js";
+import type { SnapshotBuildTarget } from "../model/observation.js";
+import { type GoogleSheetsApiProviderDeps } from "./shared.js";
+/** Reads the target and receipt tabs for one route through the read lane. */
+export declare function readPreflight(deps: GoogleSheetsApiProviderDeps, request: {
+    readonly sheetName: string;
+    readonly registeredRange: string;
+}, definition: RegisteredSyncProjectionDefinition, routeOptions: {
+    readonly identityField: Presence<string>;
+    readonly checkboxHeaders: readonly string[];
+}): Promise<PreflightContext>;
+/** Validates one observation request and derives its snapshot target. */
+export declare function observationTargetFor(deps: GoogleSheetsApiProviderDeps, request: ReadSyncSnapshotRequest): SnapshotBuildTarget;
+//# sourceMappingURL=preflightOp.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/preflightOp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflightOp.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/preflightOp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAOpG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,8DAA8D,CAAC;AACvH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,wBAAsB,aAAa,CACjC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE;IACP,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,EACD,UAAU,EAAE,kCAAkC,EAC9C,YAAY,EAAE;IACZ,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,GACA,OAAO,CAAC,gBAAgB,CAAC,CAc3B;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,CA8BrB"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/preflightOp.js

@@ -0,0 +1,54 @@
+/**
+ * Preflight and observation-target operations for the Google Sheets API
+ * sync provider.
+ *
+ * `readPreflight` performs the two paced transport calls every outbound
+ * effect operation needs (range-less sheet enumeration for hidden receipt
+ * tab discovery, plus one bounded data read of the target and receipt tabs).
+ * `observationTargetFor` validates one observation request and derives its
+ * snapshot build target, failing closed on unknown read modes.
+ */
+import { requireSyncSnapshotReadMode } from "../../../../../application/sync/sheets/validation.js";
+import { SYNC_SNAPSHOT_READ_MODES, SYNC_PROJECTIONS, } from "../../../../../application/sync/sheets/constants.js";
+import { SYNC_SHEETS_ERROR_CODES } from "../../../../../application/sync/sheets/errors.js";
+import { invalidProviderRequest } from "../errors.js";
+import { enumerateSheetProperties, readPreflightData, } from "../model/preflight.js";
+import { definitionForPhysicalSheet, runRead, validateRoute, } from "./shared.js";
+/** Reads the target and receipt tabs for one route through the read lane. */
+export async function readPreflight(deps, request, definition, routeOptions) {
+    // Each preflight performs two paced transport calls: a range-less sheet
+    // enumeration (hidden receipt tab discovery) plus one ranged data read.
+    const sheets = await runRead(deps, () => enumerateSheetProperties(deps.transport, deps.spreadsheetId, deps.readTimeoutMs));
+    return runRead(deps, () => readPreflightData(deps.transport, {
+        spreadsheetId: deps.spreadsheetId,
+        sheetName: request.sheetName,
+        registeredRange: request.registeredRange,
+        headers: definition.headers,
+        identityField: routeOptions.identityField,
+        checkboxHeaders: routeOptions.checkboxHeaders,
+    }, sheets, deps.readTimeoutMs));
+}
+/** Validates one observation request and derives its snapshot target. */
+export function observationTargetFor(deps, request) {
+    const definition = definitionForPhysicalSheet(deps, request.physicalSheetId);
+    validateRoute(request, definition);
+    // Fail closed on unknown readMode strings (same shared guard as the Apps
+    // Script observation operation) instead of silently reading in full mode.
+    const readMode = request.readMode === undefined
+        ? SYNC_SNAPSHOT_READ_MODES.FULL
+        : requireSyncSnapshotReadMode(request.readMode, "Google Sheets API observation readMode", SYNC_SHEETS_ERROR_CODES.INVALID_EFFECT_PAYLOAD);
+    if (readMode === SYNC_SNAPSHOT_READ_MODES.USER_INPUT &&
+        request.projection !== SYNC_PROJECTIONS.USER_INPUT) {
+        invalidProviderRequest("observation", "user_input readMode requires the user_input projection");
+    }
+    return {
+        sheetName: request.sheetName,
+        registeredRange: request.registeredRange,
+        projection: request.projection,
+        schemaVersion: request.schemaVersion,
+        headers: definition.headers,
+        checkboxHeaders: definition.checkboxHeaders ?? [],
+        readMode,
+    };
+}
+//# sourceMappingURL=preflightOp.js.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/preflightOp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflightOp.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/preflightOp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACnG,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,OAAO,EACP,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAiC,EACjC,OAGC,EACD,UAA8C,EAC9C,YAGC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CACtC,wBAAwB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CACxB,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,eAAe,EAAE,YAAY,CAAC,eAAe;KAC9C,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAClC,IAAiC,EACjC,OAAgC;IAEhC,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnC,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC7C,CAAC,CAAC,wBAAwB,CAAC,IAAI;QAC/B,CAAC,CAAC,2BAA2B,CAC3B,OAAO,CAAC,QAAQ,EAChB,wCAAwC,EACxC,uBAAuB,CAAC,sBAAsB,CAC/C,CAAC;IACJ,IACE,QAAQ,KAAK,wBAAwB,CAAC,UAAU;QAChD,OAAO,CAAC,UAAU,KAAK,gBAAgB,CAAC,UAAU,EAClD,CAAC;QACD,sBAAsB,CACpB,aAAa,EACb,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,eAAe,EAAE,UAAU,CAAC,eAAe,IAAI,EAAE;QACjD,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/provisioning.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Projection provisioning for the Google Sheets API sync provider.
+ *
+ * Creates missing tabs and their header rows, or verifies existing tabs, in
+ * ONE atomic batchUpdate. An existing tab with no content anywhere in its
+ * used grid gets its headers initialized; an existing tab with content must
+ * match the registered headers exactly (order, duplicates, width), otherwise
+ * provisioning fails closed BEFORE any mutation. The operation is idempotent:
+ * a retry after a lost response re-enumerates, sees the exact headers, and
+ * succeeds without rewriting anything.
+ */
+import type { SyncSheetsProvisionRoute } from "../../../../../application/sync/sheets/sheetsProvisioning.js";
+import { type GoogleSheetsApiProviderDeps } from "./shared.js";
+/**
+ * Creates missing tabs and their header rows, or verifies existing tabs,
+ * in ONE atomic batchUpdate. An existing tab with no content anywhere in
+ * its used grid gets its headers initialized; an existing tab with content
+ * must match the registered headers exactly (order, duplicates, width),
+ * otherwise provisioning fails closed BEFORE any mutation. The operation
+ * is idempotent: a retry after a lost response re-enumerates, sees the
+ * exact headers, and succeeds without rewriting anything.
+ */
+export declare function provisionRegistry(deps: GoogleSheetsApiProviderDeps, registrations: readonly SyncSheetsProvisionRoute[]): Promise<{
+    readonly registrations: readonly Omit<SyncSheetsProvisionRoute, "headers">[];
+    readonly createdSheets: readonly string[];
+    readonly initializedHeaders: readonly string[];
+}>;
+//# sourceMappingURL=provisioning.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/provisioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioning.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/provisioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8DAA8D,CAAC;AAgB7G,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,2BAA2B,EACjC,aAAa,EAAE,SAAS,wBAAwB,EAAE,GACjD,OAAO,CAAC;IACT,QAAQ,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD,CAAC,CAkHD"}