hikoutei 0.3.3 → 0.3.5

package/dist/adapter/sheets/providers/google-sheets-api/transport/googleSheetsApiTransport.js

@@ -0,0 +1,247 @@
+/**
+ * Narrow transport contract for the direct Google Sheets API provider.
+ *
+ * All Google SDK types stay behind this module: the rest of the provider
+ * works with a small discriminated union of write requests and treats every
+ * response as an untrusted `unknown` value that the preflight/reply modules
+ * validate with runtime guards. Tests implement the same interface with an
+ * in-memory spreadsheet model, so the planner and batch builder are exercised
+ * without credentials or network access.
+ */
+import { GoogleAuth } from "google-auth-library";
+import { sheets } from "@googleapis/sheets";
+import { presentValue, absentValue } from "../../../../../shared/state/index.js";
+import { GOOGLE_SHEETS_API_SCOPES } from "../constants.js";
+import { GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES, GoogleSheetsApiTransportError, } from "../errors.js";
+/**
+ * Real transport over the Google Sheets REST API.
+ *
+ * gaxios auto-retry is disabled for every call: retries are the durable
+ * worker/recovery path's job, and a retried mutating request could replay an
+ * already committed batch. All errors are mapped to
+ * `GoogleSheetsApiTransportError` before leaving this module.
+ */
+export class GoogleSheetsApiHttpTransport {
+    client;
+    requestTimeoutMs;
+    constructor(options) {
+        // google-auth-library may resolve to a version nested under googleapis-common
+        // that differs from the top-level one; the boundary cast keeps the SDK
+        // version mismatch contained in this module.
+        const auth = options.auth ??
+            new GoogleAuth({ scopes: [...GOOGLE_SHEETS_API_SCOPES] });
+        // The sheets factory accepts GoogleAuth; the narrow wrapper below owns the
+        // SDK boundary so no other provider code touches the client type.
+        this.client = sheets({ version: "v4", auth });
+        this.requestTimeoutMs = options.requestTimeoutMs;
+    }
+    async getSpreadsheet(request) {
+        try {
+            const response = await this.client.spreadsheets.get({
+                spreadsheetId: request.spreadsheetId,
+                ranges: [...request.ranges],
+                fields: request.fields,
+            }, { timeout: request.timeoutMs ?? this.requestTimeoutMs, retry: false });
+            return response.data;
+        }
+        catch (error) {
+            throw classifyGoogleSheetsApiError(error);
+        }
+    }
+    async batchUpdate(request) {
+        try {
+            const response = await this.client.spreadsheets.batchUpdate({
+                spreadsheetId: request.spreadsheetId,
+                // The body comes from the same builder that
+                // `serializeBatchUpdateRequests` measures, so the batch builder's
+                // byte budget is exact for what gaxios sends on the wire.
+                requestBody: toSdkBatchUpdateBody(request.requests),
+            }, { timeout: this.requestTimeoutMs, retry: false });
+            return response.data;
+        }
+        catch (error) {
+            throw classifyGoogleSheetsApiError(error);
+        }
+    }
+}
+/**
+ * Maps a thrown SDK/gaxios/network error to the provider transport error.
+ *
+ * Exported separately so tests can exercise the mapping with shaped fixtures
+ * instead of real network failures. Any error without a proven HTTP status is
+ * classified conservatively as delivery-uncertain material (network/timeout),
+ * never as a proven pre-mutation rejection.
+ */
+export function classifyGoogleSheetsApiError(error) {
+    const shape = extractGaxiosErrorShape(error);
+    if (shape.status !== undefined) {
+        const remoteCode = typeof shape.apiErrorStatus === "string" &&
+            shape.apiErrorStatus.length > 0
+            ? shape.apiErrorStatus
+            : String(shape.status);
+        return new GoogleSheetsApiTransportError(GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.HTTP_ERROR, "Google Sheets API request failed", presentValue(shape.status), presentValue(remoteCode));
+    }
+    if (isTimeoutError(error, shape.code)) {
+        return new GoogleSheetsApiTransportError(GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.TIMEOUT, "Google Sheets API request timed out", absentValue(), shape.code === undefined
+            ? absentValue()
+            : presentValue(shape.code));
+    }
+    return new GoogleSheetsApiTransportError(GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.NETWORK_ERROR, "Google Sheets API transport failed", absentValue(), shape.code === undefined
+        ? absentValue()
+        : presentValue(shape.code));
+}
+function extractGaxiosErrorShape(error) {
+    if (error === null || typeof error !== "object") {
+        return { code: undefined, status: undefined, apiErrorStatus: undefined };
+    }
+    const record = error;
+    const code = typeof record.code === "string" ? record.code : undefined;
+    const response = record.response;
+    const responseRecord = response !== null && typeof response === "object"
+        ? response
+        : undefined;
+    const rawStatus = responseRecord?.status;
+    const status = typeof rawStatus === "number" && Number.isInteger(rawStatus)
+        ? rawStatus
+        : typeof rawStatus === "string" && /^\d{3}$/.test(rawStatus)
+            ? Number(rawStatus)
+            : undefined;
+    let apiErrorStatus;
+    const data = responseRecord?.data;
+    const dataRecord = data !== null && typeof data === "object"
+        ? data
+        : undefined;
+    const errorBody = dataRecord?.error;
+    const errorRecord = errorBody !== null && typeof errorBody === "object"
+        ? errorBody
+        : undefined;
+    const rawApiStatus = errorRecord?.status;
+    if (typeof rawApiStatus === "string" && rawApiStatus.length > 0) {
+        apiErrorStatus = rawApiStatus;
+    }
+    return { code, status, apiErrorStatus };
+}
+function isTimeoutError(error, code) {
+    if (code !== undefined && /TIMEOUT|TIMEDOUT|DEADLINE|ABORTED|ETIMEDOUT/i.test(code)) {
+        return true;
+    }
+    return error instanceof Error && /timeout|timed out|deadline exceeded/i.test(error.message);
+}
+/**
+ * Builds the SDK batchUpdate body from provider write requests. The SDK
+ * request union is wider than the provider's narrow shapes; this boundary
+ * cast is the only place both types meet.
+ */
+export function toSdkBatchUpdateBody(requests) {
+    return {
+        requests: requests.map(toSdkRequest),
+    };
+}
+/**
+ * Serializes the batchUpdate body exactly as the transport sends it, so the
+ * batch builder's byte budget measures the real wire bytes (SDK-wrapped
+ * request shapes, not the internal request union).
+ */
+export function serializeBatchUpdateRequests(requests) {
+    return JSON.stringify(toSdkBatchUpdateBody(requests));
+}
+/** Maps one provider write request to the Google SDK request shape. */
+function toSdkRequest(request) {
+    switch (request.kind) {
+        case "addSheet":
+            return { addSheet: { properties: { title: request.title, sheetId: request.sheetId } } };
+        case "updateSheetProperties":
+            return {
+                updateSheetProperties: {
+                    properties: { sheetId: request.sheetId, hidden: request.hidden },
+                    fields: "hidden",
+                },
+            };
+        case "updateCells":
+            return {
+                updateCells: {
+                    start: {
+                        sheetId: request.sheetId,
+                        rowIndex: request.startRowIndex,
+                        columnIndex: request.startColumnIndex,
+                    },
+                    rows: request.rows.map(toSdkRow),
+                    fields: request.fields,
+                },
+            };
+        case "insertDimension":
+            return {
+                insertDimension: {
+                    range: {
+                        sheetId: request.sheetId,
+                        dimension: request.dimension,
+                        startIndex: request.startIndex,
+                        endIndex: request.endIndex,
+                    },
+                    inheritFromBefore: request.inheritFromBefore,
+                },
+            };
+        case "deleteDimension":
+            return {
+                deleteDimension: {
+                    range: {
+                        sheetId: request.sheetId,
+                        dimension: request.dimension,
+                        startIndex: request.startIndex,
+                        endIndex: request.endIndex,
+                    },
+                },
+            };
+        case "setDataValidation":
+            return {
+                setDataValidation: {
+                    range: {
+                        sheetId: request.sheetId,
+                        startRowIndex: request.startRowIndex,
+                        endRowIndex: request.endRowIndex,
+                        startColumnIndex: request.startColumnIndex,
+                        endColumnIndex: request.endColumnIndex,
+                    },
+                    rule: {
+                        condition: { type: "BOOLEAN" },
+                        strict: request.strict,
+                    },
+                },
+            };
+        case "createDeveloperMetadata":
+            return {
+                createDeveloperMetadata: {
+                    developerMetadata: {
+                        metadataKey: request.key,
+                        metadataValue: request.value,
+                        location: {
+                            dimensionRange: {
+                                sheetId: request.sheetId,
+                                dimension: "ROWS",
+                                startIndex: request.rowIndex,
+                                endIndex: request.rowIndex + 1,
+                            },
+                        },
+                        // DOCUMENT-scoped metadata is visible across Cloud projects, so
+                        // anchors written by the service-account project stay findable by
+                        // the Apps Script project (and vice versa) in mixed mode.
+                        visibility: "DOCUMENT",
+                    },
+                },
+            };
+        case "deleteSheet":
+            return { deleteSheet: { sheetId: request.sheetId } };
+    }
+}
+function toSdkRow(row) {
+    return { values: row.map(toSdkCell) };
+}
+function toSdkCell(cell) {
+    if (cell === null)
+        return {};
+    return {
+        ...(cell.userEnteredValue === undefined ? {} : { userEnteredValue: cell.userEnteredValue }),
+        ...(cell.userEnteredFormat === undefined ? {} : { userEnteredFormat: cell.userEnteredFormat }),
+    };
+}
+//# sourceMappingURL=googleSheetsApiTransport.js.map

package/dist/adapter/sheets/providers/google-sheets-api/transport/googleSheetsApiTransport.js.map

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

package/dist/adapter/sheets/providers/google-sheets-api/transport/rateLimiter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Request-start interval limiter used by the direct Sheets provider.
+ *
+ * Google Sheets quota windows are per 100 seconds, so bursty request starts
+ * can exhaust a class's budget before the worker's own latency/backoff reacts.
+ * The provider keeps two independent limiters (reads, writes) that only wait
+ * the time remaining since that class's last request START; an idle class is
+ * never throttled and concurrent classes never serialize against each other.
+ */
+export interface RequestStartLimiterOptions {
+    /** Minimum interval between two request starts of this limiter class. */
+    readonly intervalMs: number;
+    /** Injectable clock for deterministic tests; defaults to Date.now. */
+    readonly now?: () => number;
+    /** Injectable sleep used while waiting for the next slot. */
+    readonly sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Waits only the remaining interval since the previous request start.
+ *
+ * Returns the number of milliseconds actually waited. A limiter with a zero
+ * interval never waits and records every start.
+ */
+export declare class RequestStartLimiter {
+    private readonly intervalMs;
+    private readonly now;
+    private readonly sleep;
+    private lastStartAt;
+    constructor(options: RequestStartLimiterOptions);
+    /** Returns the last recorded request start, when one exists. */
+    lastStart(): number | undefined;
+    /**
+     * Waits for the next request-start slot and records the start time.
+     *
+     * Returns the number of milliseconds actually waited. A limiter with a zero
+     * interval never waits and records every start.
+     *
+     * The slot reservation happens SYNCHRONOUSLY before any await: each caller
+     * reserves the NEXT slot (`nextStart = max(now, lastStartAt + intervalMs)`)
+     * and records it immediately, so two concurrent waiters can never compute
+     * the same remaining time from the same `lastStartAt`, sleep together, and
+     * start at the same instant. A caller that arrives after its reserved slot
+     * has already passed waits zero (its reservation collapses to now).
+     */
+    waitForSlot(): Promise<number>;
+}
+//# sourceMappingURL=rateLimiter.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/transport/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/transport/rateLimiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,WAAW,CAAqB;gBAErB,OAAO,EAAE,0BAA0B;IAStD,gEAAgE;IACzD,SAAS,IAAI,MAAM,GAAG,SAAS;IAItC;;;;;;;;;;;;OAYG;IACU,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;CAY5C"}

package/dist/adapter/sheets/providers/google-sheets-api/transport/rateLimiter.js

@@ -0,0 +1,60 @@
+/**
+ * Request-start interval limiter used by the direct Sheets provider.
+ *
+ * Google Sheets quota windows are per 100 seconds, so bursty request starts
+ * can exhaust a class's budget before the worker's own latency/backoff reacts.
+ * The provider keeps two independent limiters (reads, writes) that only wait
+ * the time remaining since that class's last request START; an idle class is
+ * never throttled and concurrent classes never serialize against each other.
+ */
+const DEFAULT_SLEEP = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Waits only the remaining interval since the previous request start.
+ *
+ * Returns the number of milliseconds actually waited. A limiter with a zero
+ * interval never waits and records every start.
+ */
+export class RequestStartLimiter {
+    intervalMs;
+    now;
+    sleep;
+    lastStartAt;
+    constructor(options) {
+        if (!Number.isSafeInteger(options.intervalMs) || options.intervalMs < 0) {
+            throw new RangeError("request-start interval must be a non-negative safe integer");
+        }
+        this.intervalMs = options.intervalMs;
+        this.now = options.now ?? Date.now;
+        this.sleep = options.sleep ?? DEFAULT_SLEEP;
+    }
+    /** Returns the last recorded request start, when one exists. */
+    lastStart() {
+        return this.lastStartAt;
+    }
+    /**
+     * Waits for the next request-start slot and records the start time.
+     *
+     * Returns the number of milliseconds actually waited. A limiter with a zero
+     * interval never waits and records every start.
+     *
+     * The slot reservation happens SYNCHRONOUSLY before any await: each caller
+     * reserves the NEXT slot (`nextStart = max(now, lastStartAt + intervalMs)`)
+     * and records it immediately, so two concurrent waiters can never compute
+     * the same remaining time from the same `lastStartAt`, sleep together, and
+     * start at the same instant. A caller that arrives after its reserved slot
+     * has already passed waits zero (its reservation collapses to now).
+     */
+    async waitForSlot() {
+        const now = this.now();
+        const nextStart = this.lastStartAt === undefined
+            ? now
+            : Math.max(now, this.lastStartAt + this.intervalMs);
+        this.lastStartAt = nextStart;
+        const waited = Math.max(0, nextStart - now);
+        if (waited > 0) {
+            await this.sleep(waited);
+        }
+        return waited;
+    }
+}
+//# sourceMappingURL=rateLimiter.js.map

package/dist/adapter/sheets/providers/google-sheets-api/transport/rateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/transport/rateLimiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,aAAa,GAAG,CAAC,EAAU,EAAiB,EAAE,CAClD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAW1D;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IACb,UAAU,CAAS;IACnB,GAAG,CAAe;IAClB,KAAK,CAAgC;IAC9C,WAAW,CAAqB;IAExC,YAAmB,OAAmC;QACpD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC9C,CAAC;IAED,gEAAgE;IACzD,SAAS;QACd,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,WAAW;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,KAAK,SAAS;YAC9C,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC;QAC5C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,59 @@
+/**
+ * Provider-neutral router composing a direct outbound provider with the
+ * observation/provisioning provider.
+ *
+ * The router implements the same gateway boundary the worker and polling
+ * already use, so no caller changes are required: outbound effect work
+ * (fast append, applyEffects, postcondition reads) goes to the direct Google
+ * Sheets provider, while anchor observation, snapshot/table reads, and
+ * provisioning stay on the Apps Script gateway (or an injected gateway +
+ * provisioner). The sync service bootstrap wraps the router in the
+ * per-spreadsheet mutation coordinator so direct writes and anchor
+ * observation share one in-process mutation lane.
+ */
+import type { ApplySyncEffectsRequest, ApplySyncEffectsResult, EnsureSyncRowAnchorsRequest, EnsureSyncRowAnchorsResult, FastAppendRowsRequest, FastAppendRowsResult, ReadSyncEffectPostconditionsRequest, ReadSyncSnapshotRequest, ReadSyncTableRowsRequest, SyncEffectPostcondition, SyncEffectWorkerFullGateway, SyncGatewayEffect, SyncGatewayEffectPostconditionResult, SyncGatewaySnapshot, SyncObservedSnapshot, SyncSheetGateway, SyncSheetTableReaderGateway, SyncTableRowsResult } from "./syncGateway.js";
+import type { SyncGatewayProvisioner, SyncGatewayProvisionRoute } from "./SyncGatewayBootstrap.js";
+/** Delegates for the routed gateway. */
+export interface RoutedSyncGatewayOptions {
+    /** Direct outbound provider: fast append, effects, postcondition reads. */
+    readonly outbound: SyncEffectWorkerFullGateway;
+    /** Observation provider: anchors, snapshots, table reads. */
+    readonly observation: SyncSheetGateway & SyncSheetTableReaderGateway;
+    /** Optional provisioning delegate; defaults to the observation provider. */
+    readonly provisioner?: SyncGatewayProvisioner;
+}
+/**
+ * @deprecated Legacy composition used only by the deprecated mixed
+ * `googleApiWorker` bootstrap mode. The preferred `googleSheetsApi` mode
+ * uses the full direct provider directly, so this router (and the Apps
+ * Script observation half it routes to) is no longer needed for new setups.
+ */
+export declare class RoutedSyncGateway implements SyncSheetGateway, SyncSheetTableReaderGateway, SyncGatewayProvisioner {
+    private readonly outbound;
+    private readonly observation;
+    private readonly provisioner;
+    constructor(options: RoutedSyncGatewayOptions);
+    /** Sends append-only rows through the direct outbound provider. */
+    fastAppendRows(request: FastAppendRowsRequest): Promise<FastAppendRowsResult>;
+    /** Sends regular effect writes through the direct outbound provider. */
+    applyEffects(request: ApplySyncEffectsRequest): Promise<ApplySyncEffectsResult>;
+    /** Reads one effect postcondition through the direct outbound provider. */
+    readEffectPostcondition(effect: SyncGatewayEffect): Promise<SyncEffectPostcondition>;
+    /** Reads a batch of postconditions through the direct outbound provider. */
+    readEffectPostconditions(request: ReadSyncEffectPostconditionsRequest): Promise<readonly SyncGatewayEffectPostconditionResult[]>;
+    /** Ensures row anchors through the observation provider. */
+    ensureRowAnchors(request: EnsureSyncRowAnchorsRequest): Promise<EnsureSyncRowAnchorsResult>;
+    /** Reads snapshots through the observation provider. */
+    readSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncGatewaySnapshot>;
+    /** Shares the observation provider's combined observation capability. */
+    observeSnapshot(request: ReadSyncSnapshotRequest): Promise<SyncObservedSnapshot>;
+    /** Shares one observation request across the supplied projections. */
+    observeSnapshots(requests: readonly ReadSyncSnapshotRequest[]): Promise<readonly SyncObservedSnapshot[]>;
+    /** Reads one registered table through the observation provider. */
+    readRows(request: ReadSyncTableRowsRequest): Promise<SyncTableRowsResult>;
+    /** Reads several registered tables through the observation provider. */
+    readRowsBatch(requests: readonly ReadSyncTableRowsRequest[]): Promise<readonly SyncTableRowsResult[]>;
+    /** Provisions the registered projections through the provisioning delegate. */
+    provisionRegistry(registrations: readonly SyncGatewayProvisionRoute[]): ReturnType<SyncGatewayProvisioner["provisionRegistry"]>;
+}
+//# sourceMappingURL=RoutedSyncGateway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RoutedSyncGateway.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/gateway/RoutedSyncGateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,mCAAmC,EACnC,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,EACjB,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAMnC,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,gBAAgB,GAAG,2BAA2B,CAAC;IACrE,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAC;CAC/C;AAED;;;;;GAKG;AACH,qBAAa,iBACX,YAAW,gBAAgB,EAAE,2BAA2B,EAAE,sBAAsB;IAChF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;gBAElC,OAAO,EAAE,wBAAwB;IAapD,mEAAmE;IAC5D,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIpF,wEAAwE;IACjE,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAItF,2EAA2E;IACpE,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAI3F,4EAA4E;IACrE,wBAAwB,CAC7B,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,SAAS,oCAAoC,EAAE,CAAC;IAI3D,4DAA4D;IACrD,gBAAgB,CACrB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC;IAItC,wDAAwD;IACjD,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAInF,yEAAyE;IAClE,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIvF,sEAAsE;IAC/D,gBAAgB,CACrB,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC;IAI3C,mEAAmE;IAC5D,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIhF,wEAAwE;IACjE,aAAa,CAClB,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAI1C,+EAA+E;IACxE,iBAAiB,CACtB,aAAa,EAAE,SAAS,yBAAyB,EAAE,GAClD,UAAU,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;CAG3D"}

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

@@ -0,0 +1,86 @@
+/**
+ * Provider-neutral router composing a direct outbound provider with the
+ * observation/provisioning provider.
+ *
+ * The router implements the same gateway boundary the worker and polling
+ * already use, so no caller changes are required: outbound effect work
+ * (fast append, applyEffects, postcondition reads) goes to the direct Google
+ * Sheets provider, while anchor observation, snapshot/table reads, and
+ * provisioning stay on the Apps Script gateway (or an injected gateway +
+ * provisioner). The sync service bootstrap wraps the router in the
+ * per-spreadsheet mutation coordinator so direct writes and anchor
+ * observation share one in-process mutation lane.
+ */
+import { observeSyncSnapshot, observeSyncSnapshots, } from "./syncGateway.js";
+import { SYNC_GATEWAY_ERROR_CODES, SyncGatewayContractError, } from "./errors.js";
+/**
+ * @deprecated Legacy composition used only by the deprecated mixed
+ * `googleApiWorker` bootstrap mode. The preferred `googleSheetsApi` mode
+ * uses the full direct provider directly, so this router (and the Apps
+ * Script observation half it routes to) is no longer needed for new setups.
+ */
+export class RoutedSyncGateway {
+    outbound;
+    observation;
+    provisioner;
+    constructor(options) {
+        this.outbound = options.outbound;
+        this.observation = options.observation;
+        const provisioner = options.provisioner ?? asProvisioner(options.observation);
+        if (provisioner === undefined) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, "the routed sync gateway needs a provisioning delegate");
+        }
+        this.provisioner = provisioner;
+    }
+    /** Sends append-only rows through the direct outbound provider. */
+    fastAppendRows(request) {
+        return this.outbound.fastAppendRows(request);
+    }
+    /** Sends regular effect writes through the direct outbound provider. */
+    applyEffects(request) {
+        return this.outbound.applyEffects(request);
+    }
+    /** Reads one effect postcondition through the direct outbound provider. */
+    readEffectPostcondition(effect) {
+        return this.outbound.readEffectPostcondition(effect);
+    }
+    /** Reads a batch of postconditions through the direct outbound provider. */
+    readEffectPostconditions(request) {
+        return this.outbound.readEffectPostconditions(request);
+    }
+    /** Ensures row anchors through the observation provider. */
+    ensureRowAnchors(request) {
+        return this.observation.ensureRowAnchors(request);
+    }
+    /** Reads snapshots through the observation provider. */
+    readSnapshot(request) {
+        return this.observation.readSnapshot(request);
+    }
+    /** Shares the observation provider's combined observation capability. */
+    observeSnapshot(request) {
+        return observeSyncSnapshot(this.observation, request);
+    }
+    /** Shares one observation request across the supplied projections. */
+    observeSnapshots(requests) {
+        return observeSyncSnapshots(this.observation, requests);
+    }
+    /** Reads one registered table through the observation provider. */
+    readRows(request) {
+        return this.observation.readRows(request);
+    }
+    /** Reads several registered tables through the observation provider. */
+    readRowsBatch(requests) {
+        return this.observation.readRowsBatch(requests);
+    }
+    /** Provisions the registered projections through the provisioning delegate. */
+    provisionRegistry(registrations) {
+        return this.provisioner.provisionRegistry(registrations);
+    }
+}
+/** Returns the observation provider itself when it can provision. */
+function asProvisioner(value) {
+    return "provisionRegistry" in value && typeof value.provisionRegistry === "function"
+        ? value
+        : undefined;
+}
+//# sourceMappingURL=RoutedSyncGateway.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RoutedSyncGateway.js","sourceRoot":"","sources":["../../../../src/application/sync/gateway/RoutedSyncGateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsBH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAYrB;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IAEX,QAAQ,CAA8B;IACtC,WAAW,CAAiD;IAC5D,WAAW,CAAyB;IAErD,YAAmB,OAAiC;QAClD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,wBAAwB,CAChC,wBAAwB,CAAC,gCAAgC,EACzD,uDAAuD,CACxD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,mEAAmE;IAC5D,cAAc,CAAC,OAA8B;QAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,wEAAwE;IACjE,YAAY,CAAC,OAAgC;QAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,2EAA2E;IACpE,uBAAuB,CAAC,MAAyB;QACtD,OAAO,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,4EAA4E;IACrE,wBAAwB,CAC7B,OAA4C;QAE5C,OAAO,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,4DAA4D;IACrD,gBAAgB,CACrB,OAAoC;QAEpC,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,wDAAwD;IACjD,YAAY,CAAC,OAAgC;QAClD,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,yEAAyE;IAClE,eAAe,CAAC,OAAgC;QACrD,OAAO,mBAAmB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,sEAAsE;IAC/D,gBAAgB,CACrB,QAA4C;QAE5C,OAAO,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,mEAAmE;IAC5D,QAAQ,CAAC,OAAiC;QAC/C,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACjE,aAAa,CAClB,QAA6C;QAE7C,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,+EAA+E;IACxE,iBAAiB,CACtB,aAAmD;QAEnD,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,qEAAqE;AACrE,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,mBAAmB,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,UAAU;QAClF,CAAC,CAAE,KAAgC;QACnC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

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

@@ -25,6 +25,7 @@
  * reclassified as a retryable transport error.
  */
 import { AppsScriptSyncGatewayError } from "../../../adapter/sheets/providers/apps-script-gateway/errors.js";
+import { GoogleSheetsApiTransportError } from "../../../adapter/sheets/providers/google-sheets-api/errors.js";
 import type { Presence } from "../../../shared/state/types.js";
 export declare const TRANSPORT_OUTCOME_KINDS: {
     readonly SUCCESS: "success";
@@ -59,4 +60,15 @@ export declare function isDeliveryUncertainOutcome(outcome: TransportOutcome): b
  * rejection evidence to the worker.
  */
 export declare function isDeliveryUncertain(error: AppsScriptSyncGatewayError): boolean;
+/**
+ * Returns true when the direct Sheets transport error implies an ambiguous
+ * delivery.
+ *
+ * Google API non-2xx responses prove the batch did not execute only for the
+ * pre-mutation rejection statuses below; timeouts, network failures, and
+ * proxy-emitted 408/429/5xx responses can follow a committed write, and a
+ * malformed 2xx reply cannot prove what was applied. Those are recovered
+ * through the postcondition probe path, never closed as success.
+ */
+export declare function isGoogleSheetsApiDeliveryUncertain(error: GoogleSheetsApiTransportError): boolean;
 //# sourceMappingURL=transportClassification.d.ts.map

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

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

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

@@ -25,6 +25,7 @@
  * reclassified as a retryable transport error.
  */
 import { AppsScriptSyncGatewayError, SYNC_GATEWAY_CLIENT_ERROR_CODES } from "../../../adapter/sheets/providers/apps-script-gateway/errors.js";
+import { GoogleSheetsApiTransportError, GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES } from "../../../adapter/sheets/providers/google-sheets-api/errors.js";
 import { PRESENCE_KINDS } from "../../../shared/state/index.js";
 export const TRANSPORT_OUTCOME_KINDS = {
     SUCCESS: "success",
@@ -59,6 +60,17 @@ export function classifyTransportOutcome(error) {
             message: error.message,
         };
     }
+    if (error instanceof GoogleSheetsApiTransportError) {
+        const kind = isGoogleSheetsApiDeliveryUncertain(error)
+            ? TRANSPORT_OUTCOME_KINDS.DELIVERY_UNCERTAIN
+            : TRANSPORT_OUTCOME_KINDS.EXPLICIT_REMOTE_FAILURE;
+        return {
+            kind,
+            httpStatus: error.status,
+            code: error.remoteCode,
+            message: error.message,
+        };
+    }
     // Unknown transport/Node error: assume the remote state is unverifiable.
     return {
         kind: TRANSPORT_OUTCOME_KINDS.DELIVERY_UNCERTAIN,
@@ -130,4 +142,29 @@ export function isDeliveryUncertain(error) {
     const status = error.status.value;
     return status === 404 || status === 408 || status === 429 || status >= 500;
 }
+/**
+ * Returns true when the direct Sheets transport error implies an ambiguous
+ * delivery.
+ *
+ * Google API non-2xx responses prove the batch did not execute only for the
+ * pre-mutation rejection statuses below; timeouts, network failures, and
+ * proxy-emitted 408/429/5xx responses can follow a committed write, and a
+ * malformed 2xx reply cannot prove what was applied. Those are recovered
+ * through the postcondition probe path, never closed as success.
+ */
+export function isGoogleSheetsApiDeliveryUncertain(error) {
+    if (error.code === GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.TIMEOUT ||
+        error.code === GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.NETWORK_ERROR ||
+        error.code === GOOGLE_SHEETS_API_TRANSPORT_ERROR_CODES.INVALID_RESPONSE) {
+        return true;
+    }
+    if (error.status.kind !== PRESENCE_KINDS.PRESENT)
+        return true;
+    const status = error.status.value;
+    if (status === 400 || status === 401 || status === 403 || status === 404) {
+        // The API rejected the request before executing any part of the batch.
+        return false;
+    }
+    return true;
+}
 //# sourceMappingURL=transportClassification.js.map

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

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