hikoutei 0.3.3 → 0.3.5

package/README.md

@@ -8,7 +8,8 @@
 
 <a href="https://www.npmjs.com/package/hikoutei">npm package</a> ·
 <a href="https://github.com/ManddarinShop/Hikoutei/issues">Issues</a> ·
-<a href="apps-script/gateway/Code.gs">Apps Script gateway</a>
+<a href="docs/quick-start.md">Quick start</a> ·
+<a href="apps-script/gateway/Code.gs">Legacy Apps Script gateway</a>
 
 [![npm version](https://img.shields.io/npm/v/hikoutei?style=flat-square)](https://www.npmjs.com/package/hikoutei)
 [![license](https://img.shields.io/npm/l/hikoutei?style=flat-square)](LICENSE)
@@ -19,7 +20,8 @@
 Hikoutei helps TypeScript and Node.js applications use Google Sheets as a
 human-friendly part of an MVP or internal workflow. Your application works
 with typed entities and local SQLite; changes can be delivered to Google
-Sheets asynchronously through the included Apps Script gateway.
+Sheets asynchronously through a service-account Google Sheets provider (or the
+legacy Apps Script gateway when no service account is available).
 
 Hikoutei is intentionally focused. It is not a general-purpose database
 replacement, a Prisma/JPA clone, or a general Google Sheets API wrapper.
@@ -114,6 +116,42 @@ Google Sheets synchronization is a service-side concern. Applications do not
 import a gateway client, pass Sheet routes to `createTypedSheets()`, call
 `setupSheets()`, or choose an operation for each write.
 
+### Service-account direct provider (recommended)
+
+The preferred production path uses the internal `googleSheetsApi` bootstrap
+option with the Google Sheets REST API directly — no Apps Script at all. The
+provider provisions the registered tabs, writes outbound effects, reads table
+values, assigns row anchors, and observes human edits, all with one service
+account:
+
+1. Create a Google Cloud service account with the
+   `https://www.googleapis.com/auth/spreadsheets` scope and share the target
+   spreadsheet with its email as an Editor: the provider creates tabs, writes
+   effect rows and receipt records, and manages row anchors, so Viewer access
+   is not enough. Enable the Google Sheets API for the Cloud project.
+2. Keep the service-account key file path in
+   `GOOGLE_APPLICATION_CREDENTIALS` on the server, and the spreadsheet ID in
+   an untracked secret store. Never put the key in browser code or Git.
+3. Start the internal sync bootstrap with `googleSheetsApi` configured. It
+   creates and verifies headers on the registered tabs, then starts outbox
+   delivery and User_Input polling.
+
+Sheet consistency does not come from cross-request Sheet transactions; it
+comes from the hidden effect-receipt tab, effect-id/payload-hash dedupe, the
+SQLite durable outbox, fencing, field-level compare-and-set evidence, and
+postcondition recovery. The service-account path never logs credentials,
+spreadsheet IDs, URLs, or payloads; it spaces request starts at 1,100 ms per
+class (reads and writes separately) to stay inside Google's quota windows, and
+it keeps the same SQLite-authoritative model: `flush()` commits locally,
+delivery is asynchronous, and every write is receipted and recovered through
+the same effect worker.
+
+### Apps Script gateway (legacy, no service account)
+
+Deployments that cannot use a service account can keep the legacy Apps Script
+gateway. It remains fully supported but is deprecated: new setups should
+prefer the service-account direct provider.
+
 1. Copy [`apps-script/gateway/Code.gs`](apps-script/gateway/Code.gs) into a
    spreadsheet-bound Apps Script project and deploy it as a Web App. Paste the
    deployed `/exec` URL into the `TYPED_SHEETS_GATEWAY_URL` constant in
@@ -124,23 +162,58 @@ import a gateway client, pass Sheet routes to `createTypedSheets()`, call
    `TYPED_SHEETS_GATEWAY_SHARED_SECRET`, and
    `TYPED_SHEETS_GATEWAY_SHEET_ID` in an untracked server environment or secret
    store. Never put the shared secret in browser code or Git.
-3. Start the internal sync bootstrap. It validates the private route/ownership
-   configuration, provisions and verifies headers, then starts outbox delivery
-   and User_Input polling.
-
-The MVP path is a single `Code.gs` file: it requires no `appsscript.json`
-manifest, no Apps Script Advanced Sheets Service, no Google Cloud Sheets API
-activation, and no service account. Sheet consistency does not come from
+3. Start the internal sync bootstrap with `appsScript` configured. It
+   validates the private route/ownership configuration, provisions and
+   verifies headers, then starts outbox delivery and User_Input polling.
+
+**Migrating from the gateway to the service account:** share the spreadsheet
+with the service account, switch the internal bootstrap option from
+`appsScript` to `googleSheetsApi`, and remove the three `TYPED_SHEETS_GATEWAY_*`
+environment variables. The provider reads and writes the same tabs, receipt
+sheet, and anchor metadata, so existing spreadsheets keep working without
+re-provisioning.
+
+The current legacy Apps Script runtime writes append batches unconditionally
+through the Apps Script Advanced Sheets Service; there is no runtime
+enablement switch. The bundled [`appsscript.json`](apps-script/gateway/appsscript.json)
+manifest (Sheets v4 advanced service enabled) and Google Cloud Sheets API
+activation in the script's Cloud project are therefore mandatory for the
+current temporary append path. A legacy `Code.gs`-only deployment that runs
+only on built-in `SpreadsheetApp` services must first restore the commented
+rollback block in
+`src/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.ts`,
+which reverts append target writes to the built-in services path. No service
+account is required. Sheet consistency does not come from
 cross-request Sheet transactions; it comes from the Apps Script script lock,
 the hidden effect-receipt tab, effect-id/payload-hash dedupe, the SQLite
 durable outbox, fencing, and postcondition recovery.
 
-The gateway must be deployed with an access audience that can reach the
-service; an external server normally requires **Anyone**. Use the deployed
-`/exec` URL, not the editor-only `/dev` URL. When `Code.gs` changes, update the
-existing Web App deployment with a new version. Live Google calls are opt-in;
-fake gateways and SQLite fixtures are the normal verification path.
-The detailed setup and troubleshooting steps are in the [Quick start](docs/quick-start.md).
+### Full direct provider (service account)
+
+The internal sync bootstrap also supports a full direct mode: one Google
+Sheets API provider (the `googleSheetsApi` internal option) owns provisioning,
+outbound effects (fast append, guarded update/delete, receipts, response-loss
+recovery), values-only table reads, row anchors, and User_Input observation,
+all with a service account through Application Default Credentials
+(`GOOGLE_APPLICATION_CREDENTIALS` pointing at a service-account key shared on
+the spreadsheet). No Apps Script deployment is required. The provider never
+logs credentials, spreadsheet IDs, URLs, or payloads; it spaces request starts
+at 1,100 ms per class (reads and writes separately) to stay inside Google's
+quota windows, and it keeps the same SQLite-authoritative model: `flush()`
+commits locally, delivery is asynchronous, and every write is receipted and
+recovered through the same effect worker.
+
+The direct provider is the tracked live scenario's mode. The 10,000-row
+append and update/delete live evidence collected through the same REST path
+is recorded in [docs/sync-bulk-write-benchmark.md](docs/sync-bulk-write-benchmark.md);
+those raw-transport experiments under `scripts/bench/` are separate
+measurements of the unguarded API path (no receipts, no compare-and-set), so
+treat any throughput number as unverified until it is measured through the
+full worker.
+
+Live Google calls are opt-in; fake gateways and SQLite fixtures are the
+normal verification path. The detailed setup and troubleshooting steps are in
+the [Quick start](docs/quick-start.md).
 
 ## Documentation
 

package/apps-script/gateway/appsscript.json

@@ -0,0 +1,17 @@
+{
+  "timeZone": "Etc/UTC",
+  "dependencies": {
+    "enabledAdvancedServices": [
+      {
+        "userSymbol": "Sheets",
+        "serviceId": "sheets",
+        "version": "v4"
+      }
+    ]
+  },
+  "exceptionLogging": "STACKDRIVER",
+  "oauthScopes": [
+    "https://www.googleapis.com/auth/spreadsheets"
+  ],
+  "runtimeVersion": "V8"
+}

package/dist/adapter/sheets/providers/apps-script-gateway/index.d.ts

@@ -1,4 +1,12 @@
-/** Signed adapter tools for the registry-bound Apps Script sync gateway. */
+/**
+ * Signed adapter tools for the registry-bound Apps Script sync gateway.
+ *
+ * @deprecated The Apps Script gateway is the legacy no-service-account
+ * path; the preferred `googleSheetsApi` bootstrap mode uses the full
+ * service-account Google Sheets provider and needs no Apps Script. The
+ * signed protocol and these tools remain fully supported for existing
+ * deployments.
+ */
 export { APPS_SCRIPT_OPERATION_NAMES, } from "./protocol/constants.js";
 export type { AppsScriptOperationName } from "./protocol/constants.js";
 export { canonicalSyncJson, syncSha256Hex, } from "./protocol/syncProtocol.js";

package/dist/adapter/sheets/providers/apps-script-gateway/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapter/sheets/providers/apps-script-gateway/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EACL,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,aAAa,GACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,EAChC,2BAA2B,EAC3B,wCAAwC,GACzC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EACL,2BAA2B,EAC3B,sCAAsC,EACtC,uCAAuC,GACxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,YAAY,EACV,6BAA6B,EAC7B,gCAAgC,EAChC,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,iCAAiC,EACjC,oCAAoC,EACpC,6BAA6B,GAC9B,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACV,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,mCAAmC,EACnC,sCAAsC,EACtC,8CAA8C,EAC9C,+CAA+C,GAChD,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,GACpC,MAAM,kDAAkD,CAAC;AAC1D,YAAY,EACV,8BAA8B,GAC/B,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,mCAAmC,EACnC,qCAAqC,GACtC,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapter/sheets/providers/apps-script-gateway/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,aAAa,GACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,EAChC,2BAA2B,EAC3B,wCAAwC,GACzC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EACL,2BAA2B,EAC3B,sCAAsC,EACtC,uCAAuC,GACxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,YAAY,EACV,6BAA6B,EAC7B,gCAAgC,EAChC,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,iCAAiC,EACjC,oCAAoC,EACpC,6BAA6B,GAC9B,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACV,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,mCAAmC,EACnC,sCAAsC,EACtC,8CAA8C,EAC9C,+CAA+C,GAChD,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,GACpC,MAAM,kDAAkD,CAAC;AAC1D,YAAY,EACV,8BAA8B,GAC/B,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,mCAAmC,EACnC,qCAAqC,GACtC,MAAM,qCAAqC,CAAC"}

package/dist/adapter/sheets/providers/apps-script-gateway/index.js

@@ -1,4 +1,12 @@
-/** Signed adapter tools for the registry-bound Apps Script sync gateway. */
+/**
+ * Signed adapter tools for the registry-bound Apps Script sync gateway.
+ *
+ * @deprecated The Apps Script gateway is the legacy no-service-account
+ * path; the preferred `googleSheetsApi` bootstrap mode uses the full
+ * service-account Google Sheets provider and needs no Apps Script. The
+ * signed protocol and these tools remain fully supported for existing
+ * deployments.
+ */
 export { APPS_SCRIPT_OPERATION_NAMES, } from "./protocol/constants.js";
 export { canonicalSyncJson, syncSha256Hex, } from "./protocol/syncProtocol.js";
 export { AppsScriptSyncGatewayError, SYNC_GATEWAY_CLIENT_ERROR_CODES, } from "./errors.js";

package/dist/adapter/sheets/providers/apps-script-gateway/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapter/sheets/providers/apps-script-gateway/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EACL,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AAQtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EACL,2BAA2B,EAC3B,sCAAsC,EACtC,uCAAuC,GACxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapter/sheets/providers/apps-script-gateway/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,+BAA+B,EAC/B,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AAQtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EACL,2BAA2B,EAC3B,sCAAsC,EACtC,uCAAuC,GACxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperationScript.js

@@ -661,7 +661,7 @@ export const EFFECT_OPERATION_SOURCE = String.raw `function (spreadsheet, args)
       return targetLayout.headers.map(function (header) { return toSheetValue_(row.cells[header]); });
     }));
     rows.forEach(function (row) {
-      target.getRange(row.rowNumber + ":" + row.rowNumber).addDeveloperMetadata(ANCHOR_KEY, row.physicalAnchor, SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);
+      target.getRange(row.rowNumber + ":" + row.rowNumber).addDeveloperMetadata(ANCHOR_KEY, row.physicalAnchor, SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);
     });
     if (Array.isArray(checkboxHeaders)) checkboxHeaders.forEach(function (header) {
       var position = targetLayout.positions[header];

package/dist/adapter/sheets/providers/apps-script-gateway/operations/observation/observationOperation.js

@@ -307,7 +307,7 @@ const OBSERVATION_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
       if (anchors.length === 0) {
         var anchor = "sync-anchor:" + Utilities.getUuid();
         targetSheet.getRange(rowNumber + ":" + rowNumber).addDeveloperMetadata(
-          ANCHOR_KEY, anchor, SpreadsheetApp.DeveloperMetadataVisibility.PROJECT,
+          ANCHOR_KEY, anchor, SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT,
         );
         anchorsByRow[rowNumber] = [anchor];
         assigned += 1;

package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.d.ts

@@ -11,16 +11,24 @@ export interface AppsScriptBatchAppendOperationArgs {
 }
 export type AppsScriptBatchAppendOperation = AppsScriptOperationDefinition<AppsScriptBatchAppendOperationArgs, FastAppendRowsResult>;
 /**
- * Builds an idempotent append operation backed by built-in Apps Script
- * services only (SpreadsheetApp, LockService, PropertiesService, Utilities);
- * no Advanced Sheets dependency is required. The data rows and their Gateway
- * receipts are written under one script lock, but the target write and the
- * receipt write are separate flush() calls, so a crash between them can leave
- * a target row without a receipt; this is not a cross-request atomic batch.
- * A lost HTTP response is recovered by replaying the same effect ID: the
- * replay verifies the target row postcondition and returns applied without
- * adding another row, while a reused effect ID with a different payload hash
- * fails closed.
+ * Builds an idempotent append operation. The target-row write uses the
+ * temporary test-batch API: the reserved target range is written through the
+ * Apps Script Advanced Sheets service
+ * (Sheets.Spreadsheets.Values.batchUpdate with one RAW ValueRange) so a bulk
+ * pass can write up to the configured append batch in one request. Everything
+ * else stays on built-in Apps Script services (SpreadsheetApp, LockService,
+ * PropertiesService, Utilities): receipts, identity guards, visible hashing,
+ * date number formats, postcondition checks, authority fencing, replay, and
+ * recovery. The pre-test-batch built-in target write is preserved in a
+ * commented rollback block inside the operation source.
+ *
+ * The data rows and their Gateway receipts are written under one script lock,
+ * but the target write and the receipt write are separate flush() calls, so a
+ * crash between them can leave a target row without a receipt; this is not a
+ * cross-request atomic batch. A lost HTTP response is recovered by replaying
+ * the same effect ID: the replay verifies the target row postcondition and
+ * returns applied without adding another row, while a reused effect ID with a
+ * different payload hash fails closed.
  *
  * The registered identityField is required because this path never
  * materializes anchor metadata: replay and postcondition verification locate

package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batchAppendOperation.d.ts","sourceRoot":"","sources":["../../../../../../../src/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,2DAA2D,CAAC;AAEnE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAMxF,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,CACxE,kCAAkC,EAClC,oBAAoB,CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,kCAAkC,GAC1C,8BAA8B,CAOhC"}
+{"version":3,"file":"batchAppendOperation.d.ts","sourceRoot":"","sources":["../../../../../../../src/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,2DAA2D,CAAC;AAEnE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAMxF,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,CACxE,kCAAkC,EAClC,oBAAoB,CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,kCAAkC,GAC1C,8BAA8B,CAOhC"}

package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.js

@@ -5,16 +5,24 @@ import { invalidOperationRequest, invalidOperationResponse } from "../../errors.
 import { isNormalizedCell } from "../../../../../../shared/encoding/normalizedCell.js";
 import { isRecord } from "../../../../../../shared/encoding/typeGuards.js";
 /**
- * Builds an idempotent append operation backed by built-in Apps Script
- * services only (SpreadsheetApp, LockService, PropertiesService, Utilities);
- * no Advanced Sheets dependency is required. The data rows and their Gateway
- * receipts are written under one script lock, but the target write and the
- * receipt write are separate flush() calls, so a crash between them can leave
- * a target row without a receipt; this is not a cross-request atomic batch.
- * A lost HTTP response is recovered by replaying the same effect ID: the
- * replay verifies the target row postcondition and returns applied without
- * adding another row, while a reused effect ID with a different payload hash
- * fails closed.
+ * Builds an idempotent append operation. The target-row write uses the
+ * temporary test-batch API: the reserved target range is written through the
+ * Apps Script Advanced Sheets service
+ * (Sheets.Spreadsheets.Values.batchUpdate with one RAW ValueRange) so a bulk
+ * pass can write up to the configured append batch in one request. Everything
+ * else stays on built-in Apps Script services (SpreadsheetApp, LockService,
+ * PropertiesService, Utilities): receipts, identity guards, visible hashing,
+ * date number formats, postcondition checks, authority fencing, replay, and
+ * recovery. The pre-test-batch built-in target write is preserved in a
+ * commented rollback block inside the operation source.
+ *
+ * The data rows and their Gateway receipts are written under one script lock,
+ * but the target write and the receipt write are separate flush() calls, so a
+ * crash between them can leave a target row without a receipt; this is not a
+ * cross-request atomic batch. A lost HTTP response is recovered by replaying
+ * the same effect ID: the replay verifies the target row postcondition and
+ * returns applied without adding another row, while a reused effect ID with a
+ * different payload hash fails closed.
  *
  * The registered identityField is required because this path never
  * materializes anchor metadata: replay and postcondition verification locate
@@ -24,13 +32,24 @@ import { isRecord } from "../../../../../../shared/encoding/typeGuards.js";
 export function createBatchAppendRowsOperation(request) {
     validateBatchAppendRequest(request);
     return {
-        fn: BATCH_APPEND_OPERATION_SOURCE,
+        fn: APPEND_TEST_BATCH_OPERATION_SOURCE,
         args: request,
         decode: (value) => decodeBatchAppendResult(value, request.rows),
     };
 }
-/** Self-contained V8 source restored by Code.gs with eval. */
-const BATCH_APPEND_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
+/**
+ * Self-contained V8 source restored by Code.gs with eval.
+ *
+ * TEMPORARY TEST-BATCH API: the target-row write in writeAppendRows_() uses
+ * the Advanced Sheets service so a bulk Apps Script pass can write a large
+ * append batch in one RAW ValueRange. This requires the appsscript.json
+ * manifest with the Sheets v4 advanced service enabled and Google Cloud
+ * Sheets API activation for the script's Cloud project. The commented
+ * rollback block at the end of this source restores the previous
+ * built-in-services write; no other part of the operation changes between
+ * the two.
+ */
+const APPEND_TEST_BATCH_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
   var RECEIPT_SHEET_NAME = "__typed_sheets_internal_effect_receipts";
   var RECEIPT_HEADERS = ["effectId", "payloadHash", "status", "visibleHash", "visibleRevision", "updatedAt"];
   var phases = [];
@@ -396,16 +415,78 @@ const BATCH_APPEND_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
     });
   }
 
+  // TEMPORARY TEST-BATCH API: the append target write goes through the
+  // Advanced Sheets service so a bulk pass can write up to the configured
+  // append batch in one RAW ValueRange. The call follows the Apps Script
+  // Advanced Sheets signature Sheets.Spreadsheets.Values.batchUpdate(resource,
+  // spreadsheetId): the resource body carries the valueInputOption and the
+  // data array, and the spreadsheetId is the second positional path parameter.
+  // The rows are still reserved with the built-in insertRowsAfter first so a
+  // concurrent human append is shifted rather than overwritten, and the date
+  // columns still receive the canonical UTC number format afterwards. This
+  // write requires the Apps Script Advanced Sheets Service: the project needs
+  // the appsscript.json manifest with the Sheets v4 advanced service enabled
+  // and Google Cloud Sheets API activation for its Cloud project.
+  // Rollback: restore the commented writeAppendRows_()/toSheetValue_() block
+  // at the end of this source.
   function writeAppendRows_(targetSheet, range, startRow, pending) {
-    // Reserve the rows through the spreadsheet mutation API before writing
-    // values so a concurrent human append is shifted rather than overwritten.
     targetSheet.insertRowsAfter(startRow - 1, pending.length);
-    targetSheet.getRange(startRow, range.startColumn, pending.length, range.columnCount).setValues(pending.map(function (entry) {
-      return args.headers.map(function (header) { return toSheetValue_(entry.row.fields[header]); });
-    }));
+    // The reserved rows are created through the built-in SpreadsheetApp
+    // service, but the RAW ValueRange write below goes through the Advanced
+    // Sheets service. Flush explicitly so the reserved target range is
+    // visible across that service boundary before the Values API call.
+    SpreadsheetApp.flush();
+    Sheets.Spreadsheets.Values.batchUpdate({
+      valueInputOption: "RAW",
+      data: [{
+        range: a1Range_(args.sheetName, range.startColumn, startRow, range.startColumn + range.columnCount - 1, startRow + pending.length - 1),
+        majorDimension: "ROWS",
+        values: pending.map(function (entry) {
+          return args.headers.map(function (header) { return toSheetValue_(entry.row.fields[header]); });
+        }),
+      }],
+    }, spreadsheet.getId());
     setDateNumberFormats_(targetSheet, range, startRow, pending);
   }
 
+  /** Builds a fully escaped A1 range for one sheet tab. */
+  function a1Range_(sheetName, startColumn, startRow, endColumn, endRow) {
+    return quoteA1SheetName_(sheetName) + "!" + columnLetters_(startColumn) + startRow + ":" + columnLetters_(endColumn) + endRow;
+  }
+
+  /** Quotes a sheet name for A1 notation, doubling any embedded single quote. */
+  function quoteA1SheetName_(sheetName) {
+    return "'" + String(sheetName).replace(/'/g, "''") + "'";
+  }
+
+  /** Converts a 1-based column number to A1 letters (1 -> A, 27 -> AA). */
+  function columnLetters_(columnNumber) {
+    var letters = "";
+    var value = columnNumber;
+    while (value > 0) {
+      var remainder = (value - 1) % 26;
+      letters = String.fromCharCode(65 + remainder) + letters;
+      value = Math.floor((value - 1) / 26);
+    }
+    return letters;
+  }
+
+  /**
+   * Excel/Sheets 1900-system serial: whole days since 1899-12-30 UTC. Canonical
+   * dates are always after the 1900-02-29 phantom day, so the serial is exactly
+   * the UTC day offset and RAW input preserves the value for the number format
+   * applied by setDateNumberFormats_().
+   */
+  function dateSerial_(date) {
+    return (date.getTime() - Date.UTC(1899, 11, 30)) / 86400000;
+  }
+
+  function toSheetValue_(value) {
+    if (value === null || value === undefined) return "";
+    if (value.kind === "date") return dateSerial_(new Date(value.value));
+    return value.value;
+  }
+
   function writeReceipts_(target, startRow, pending) {
     target.insertRowsAfter(startRow - 1, pending.length);
     var updatedAt = new Date().toISOString();
@@ -428,12 +509,42 @@ const BATCH_APPEND_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
   }
 
   function assertAppendPostcondition_(targetSheet, range, pending) {
+    // Batch verification: read the registered target range once and locate
+    // every pending row through the identity column locally, instead of
+    // scanning the identity column and re-reading one row per effect. A
+    // 1,000-row bulk append therefore costs one remote read instead of
+    // 2,000. The fail-closed contract is unchanged: an empty, missing, or
+    // duplicated identity throws, and the visible hash must still match the
+    // written payload exactly.
+    var identityColumn = args.headers.indexOf(args.identityField);
+    var lastRow = targetSheet.getLastRow();
+    var rows = lastRow >= 2
+      ? targetSheet.getRange(2, range.startColumn, lastRow - 1, range.columnCount).getValues()
+      : [];
+    var byIdentity = Object.create(null);
+    rows.forEach(function (row, index) {
+      var identityValue = row[identityColumn];
+      if (identityValue === "" || identityValue === null) return;
+      var identity = String(identityValue);
+      if (byIdentity[identity] === undefined) byIdentity[identity] = [];
+      byIdentity[identity].push(index + 2);
+    });
     pending.forEach(function (entry) {
-      var rowNumber = findReceiptRowNumber_(targetSheet, range, entry.row);
-      if (rowNumber === null) {
+      var cell = entry.row.fields[args.identityField];
+      var identity = cell === null || cell === undefined || cell.value === undefined
+        ? ""
+        : String(cell.value);
+      if (identity.length === 0) {
+        throw new Error("append postcondition row is unavailable for effectId: " + entry.row.effectId);
+      }
+      var matches = byIdentity[identity];
+      if (matches !== undefined && matches.length > 1) {
+        throw new Error("sync identity is duplicated: " + identity + " at rows " + matches.join(", "));
+      }
+      if (matches === undefined || matches.length === 0) {
         throw new Error("append postcondition row is unavailable for effectId: " + entry.row.effectId);
       }
-      var values = targetSheet.getRange(rowNumber, range.startColumn, 1, range.columnCount).getValues()[0];
+      var values = rows[matches[0] - 2];
       var fields = Object.create(null);
       args.headers.forEach(function (header, headerIndex) {
         fields[header] = normalizedCellFromSheetValue_(values[headerIndex]);
@@ -444,12 +555,6 @@ const BATCH_APPEND_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
     });
   }
 
-  function toSheetValue_(value) {
-    if (value === null || value === undefined) return "";
-    if (value.kind === "date") return new Date(value.value);
-    return value.value;
-  }
-
   function parseRange_(value) {
     var parts = value.split(":");
     var startColumn = columnNumber_(parts[0]);
@@ -471,6 +576,31 @@ const BATCH_APPEND_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
     // double-count the elapsed time.
     result.timing.phases.push({ phase: name, durationMs: durationMs });
   }
+
+  // ---------------------------------------------------------------------------
+  // ROLLBACK BLOCK: previous built-in-services append target write. Restore
+  // these two functions (and delete the Advanced Sheets writeAppendRows_() /
+  // date-serial toSheetValue_() above, including the explicit
+  // service-boundary flush inside writeAppendRows_()) to revert the temporary
+  // test-batch API without touching any other part of the operation.
+  //
+  //   function writeAppendRows_(targetSheet, range, startRow, pending) {
+  //     // Reserve the rows through the spreadsheet mutation API before
+  //     // writing values so a concurrent human append is shifted rather
+  //     // than overwritten.
+  //     targetSheet.insertRowsAfter(startRow - 1, pending.length);
+  //     targetSheet.getRange(startRow, range.startColumn, pending.length, range.columnCount).setValues(pending.map(function (entry) {
+  //       return args.headers.map(function (header) { return toSheetValue_(entry.row.fields[header]); });
+  //     }));
+  //     setDateNumberFormats_(targetSheet, range, startRow, pending);
+  //   }
+  //
+  //   function toSheetValue_(value) {
+  //     if (value === null || value === undefined) return "";
+  //     if (value.kind === "date") return new Date(value.value);
+  //     return value.value;
+  //   }
+  // ---------------------------------------------------------------------------
 }`;
 function validateBatchAppendRequest(request) {
     if (request.authority !== undefined &&

package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.js.map

@@ -1 +1 @@
-{"version":3,"file":"batchAppendOperation.js","sourceRoot":"","sources":["../../../../../../../src/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"batchAppendOperation.js","sourceRoot":"","sources":["../../../../../../../src/adapter/sheets/providers/apps-script-gateway/operations/write/batchAppendOperation.ts"],"names":[],"mappings":"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"}

package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.d.ts

@@ -22,8 +22,10 @@ export interface AppsScriptOperationProjectionStatus {
 }
 type ProvisionedRoute = Omit<SyncGatewayProvisionRoute, "headers">;
 /**
- * Adapts the generic Apps Script operation transport to the sync worker's
- * fast and regular effect gateway boundaries.
+ * @deprecated Legacy Apps Script gateway adapter. The preferred
+ * `googleSheetsApi` bootstrap mode uses the full service-account Google
+ * Sheets provider and needs no Apps Script at all; this class remains for
+ * the deprecated `appsScript` / `googleApiWorker` modes.
  */
 export declare class AppsScriptOperationSyncGateway implements SyncSheetGateway, SyncSheetTableReaderGateway, SyncSheetObservationBatchGateway, SyncEffectWorkerFullGateway, SyncGatewayProvisioner {
     private readonly operationGateway;

package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operationSyncGateway.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kCAAkC,EAClC,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,iEAAiE,CAAC;AAYzE,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,mCAAmC,EACnC,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAgB9B,iFAAiF;AACjF,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,kCAAkC,EAAE,CAAC;CACrE;AAED,iFAAiF;AACjF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,KAAK,gBAAgB,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC;AAoBnE;;;GAGG;AACH,qBAAa,8BACX,YACE,gBAAgB,EAChB,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,sBAAsB;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgD;gBAEzD,OAAO,EAAE,qCAAqC;IAWjE;;;;;OAKG;IACU,iBAAiB,CAC5B,aAAa,EAAE,SAAS,yBAAyB,EAAE,GAClD,OAAO,CAAC;QACT,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;QACpD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;KAChD,CAAC;IAmBF,4EAA4E;IAC/D,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwB1F,gGAAgG;IACnF,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAWtF,8EAA8E;IACjE,aAAa,CACxB,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAc1C,6EAA6E;IAChE,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAU5F,0EAA0E;IAC7D,uBAAuB,CAClC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,uBAAuB,CAAC;IAkBnC,uEAAuE;IAC1D,wBAAwB,CACnC,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,SAAS,oCAAoC,EAAE,CAAC;IAU3D,qEAAqE;IACxD,gBAAgB,CAC3B,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC;IAUtC,gFAAgF;IACnE,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUzF,4EAA4E;IAC/D,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAW7F,wEAAwE;IAC3D,gBAAgB,CAC3B,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC;IAa3C;;;;;OAKG;IACU,cAAc,CACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mCAAmC,CAAC;IAY/C,OAAO,CAAC,0BAA0B;CAcnC"}
+{"version":3,"file":"operationSyncGateway.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kCAAkC,EAClC,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,iEAAiE,CAAC;AAYzE,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,mCAAmC,EACnC,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAgB9B,iFAAiF;AACjF,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,kCAAkC,EAAE,CAAC;CACrE;AAED,iFAAiF;AACjF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,KAAK,gBAAgB,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC;AAoBnE;;;;;GAKG;AACH,qBAAa,8BACX,YACE,gBAAgB,EAChB,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,sBAAsB;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgD;gBAEzD,OAAO,EAAE,qCAAqC;IAWjE;;;;;OAKG;IACU,iBAAiB,CAC5B,aAAa,EAAE,SAAS,yBAAyB,EAAE,GAClD,OAAO,CAAC;QACT,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;QACpD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;KAChD,CAAC;IAmBF,4EAA4E;IAC/D,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwB1F,gGAAgG;IACnF,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAWtF,8EAA8E;IACjE,aAAa,CACxB,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAc1C,6EAA6E;IAChE,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAU5F,0EAA0E;IAC7D,uBAAuB,CAClC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,uBAAuB,CAAC;IAkBnC,uEAAuE;IAC1D,wBAAwB,CACnC,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,SAAS,oCAAoC,EAAE,CAAC;IAU3D,qEAAqE;IACxD,gBAAgB,CAC3B,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC;IAUtC,gFAAgF;IACnE,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUzF,4EAA4E;IAC/D,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAW7F,wEAAwE;IAC3D,gBAAgB,CAC3B,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC;IAa3C;;;;;OAKG;IACU,cAAc,CACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mCAAmC,CAAC;IAY/C,OAAO,CAAC,0BAA0B;CAcnC"}

package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.js

@@ -14,8 +14,10 @@ import { createEnsureRowAnchorsOperation, createObserveSnapshotOperation, create
 import { invalidOperationResponse } from "../errors.js";
 import { requireOperationRecord } from "../validation.js";
 /**
- * Adapts the generic Apps Script operation transport to the sync worker's
- * fast and regular effect gateway boundaries.
+ * @deprecated Legacy Apps Script gateway adapter. The preferred
+ * `googleSheetsApi` bootstrap mode uses the full service-account Google
+ * Sheets provider and needs no Apps Script at all; this class remains for
+ * the deprecated `appsScript` / `googleApiWorker` modes.
  */
 export class AppsScriptOperationSyncGateway {
     operationGateway;