hikoutei 0.2.0

package/dist/adapter/sheets/providers/apps-script-gateway/operations/read/tableReadOperation.js

@@ -0,0 +1,190 @@
+/** Lightweight table reads for polling user-visible Sheet values. */
+import { NORMALIZED_CELL_KINDS } from "../../../../../../shared/encoding/constants.js";
+import { isRecord } from "../../../../../../shared/encoding/typeGuards.js";
+import { SYNC_GATEWAY_ERROR_CODES, } from "../../../../../../application/sync/gateway/errors.js";
+import { requireSyncGatewayPositiveSafeInteger, requireSyncGatewayText, } from "../../../../../../application/sync/gateway/validation.js";
+import { decodeOptionalSyncGatewayTiming } from "../../protocol/timing.js";
+import { invalidOperationRequest, invalidOperationResponse } from "../../errors.js";
+/** Builds a read-only operation that performs one range `getValues()` call. */
+export function createReadTableRowsOperation(request) {
+    validateRequest(request);
+    return {
+        fn: READ_TABLE_ROWS_OPERATION_SOURCE,
+        args: request,
+        decode: (value) => decodeResult(value, request),
+    };
+}
+const READ_TABLE_ROWS_OPERATION_SOURCE = String.raw `function (spreadsheet, args) {
+  var startedAt = Date.now();
+  var phases = [];
+  var validationStartedAt = Date.now();
+  if (!args || typeof args.sheetName !== "string" || args.sheetName.length === 0) {
+    throw new Error("table read sheetName is required");
+  }
+  if (!Array.isArray(args.headers) || args.headers.length === 0) {
+    throw new Error("table read headers are required");
+  }
+  phase_("validate_input", validationStartedAt);
+
+  var sheetLookupStartedAt = Date.now();
+  var sheet = spreadsheet.getSheetByName(args.sheetName);
+  if (sheet === null) throw new Error("table read sheet was not found: " + args.sheetName);
+  phase_("sheet_lookup", sheetLookupStartedAt);
+
+  var rangeStartedAt = Date.now();
+  var parsed = parseRange_(args.registeredRange);
+  var lastRow = Math.max(sheet.getLastRow(), 1);
+  phase_("range_lookup", rangeStartedAt);
+
+  var valuesStartedAt = Date.now();
+  var values = lastRow > 1
+    ? sheet.getRange(2, parsed.startColumn, lastRow - 1, parsed.columnCount).getValues()
+    : [];
+  phase_("values_read", valuesStartedAt);
+
+  var rowsStartedAt = Date.now();
+  var rows = [];
+  values.forEach(function (row, offset) {
+    if (isBlankRow_(row)) return;
+    var fields = Object.create(null);
+    args.headers.forEach(function (header, columnIndex) {
+      fields[header] = toNormalizedCell_(row[columnIndex]);
+    });
+    rows.push({ rowNumber: offset + 2, fields: fields });
+  });
+  phase_("row_normalization", rowsStartedAt);
+
+  return {
+    sheetName: args.sheetName,
+    registeredRange: args.registeredRange,
+    headers: args.headers,
+    rows: rows,
+    timing: {
+      operationKinds: [],
+      operationCounts: { append: 0, update: 0, delete: 0 },
+      durationMs: Date.now() - startedAt,
+      phases: phases,
+    },
+  };
+
+  function parseRange_(value) {
+    if (typeof value !== "string" || !/^[A-Z]+:[A-Z]+$/.test(value)) {
+      throw new Error("table read registeredRange must be an uppercase whole-column range");
+    }
+    var parts = value.split(":");
+    var startColumn = columnNumber_(parts[0]);
+    var endColumn = columnNumber_(parts[1]);
+    if (endColumn < startColumn) throw new Error("table read range end precedes start");
+    return { startColumn: startColumn, columnCount: endColumn - startColumn + 1 };
+  }
+
+  function columnNumber_(letters) {
+    var value = 0;
+    for (var index = 0; index < letters.length; index += 1) {
+      value = value * 26 + letters.charCodeAt(index) - 64;
+    }
+    return value;
+  }
+
+  function isBlankRow_(row) {
+    return row.every(function (cell) { return cell === "" || cell === null; });
+  }
+
+  function toNormalizedCell_(value) {
+    if (value === "" || value === null || value === undefined) return null;
+    if (Object.prototype.toString.call(value) === "[object Date]") {
+      if (isNaN(value.getTime())) throw new Error("table read date value is invalid");
+      return { kind: "date", value: value.toISOString() };
+    }
+    if (typeof value === "string") return { kind: "string", value: value.normalize("NFC") };
+    if (typeof value === "number" && isFinite(value)) return { kind: "number", value: value };
+    if (typeof value === "boolean") return { kind: "boolean", value: value };
+    throw new Error("table read cell value is unsupported");
+  }
+
+  function phase_(name, phaseStartedAt) {
+    phases.push({ phase: name, durationMs: Date.now() - phaseStartedAt });
+  }
+}`;
+function validateRequest(request) {
+    if (request.sheetName.trim().length === 0) {
+        invalidOperationRequest("Apps Script table read", "sheetName is required");
+    }
+    if (!/^[A-Z]+:[A-Z]+$/.test(request.registeredRange)) {
+        invalidOperationRequest("Apps Script table read", "registeredRange must be an uppercase whole-column range");
+    }
+    if (request.headers.length === 0 || request.headers.some((header) => header.trim().length === 0)) {
+        invalidOperationRequest("Apps Script table read", "headers must contain non-empty names");
+    }
+    if (new Set(request.headers).size !== request.headers.length) {
+        invalidOperationRequest("Apps Script table read", "headers must not contain duplicates");
+    }
+}
+function decodeResult(value, request) {
+    const record = requireRecord(value, "table read result");
+    const headers = decodeHeaders(record.headers);
+    if (headers.length !== request.headers.length || headers.some((header, index) => header !== request.headers[index])) {
+        invalidOperationResponse("Apps Script table read", "headers do not match the registered route");
+    }
+    if (!Array.isArray(record.rows)) {
+        invalidOperationResponse("Apps Script table read", "rows must be an array");
+    }
+    const timing = decodeOptionalSyncGatewayTiming(record.timing, "table read timing");
+    const result = {
+        sheetName: requireSyncGatewayText(record.sheetName, "table read result sheetName", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        registeredRange: requireSyncGatewayText(record.registeredRange, "table read result registeredRange", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        headers,
+        rows: record.rows.map((row, index) => decodeRow(row, index, headers)),
+    };
+    return timing === undefined ? result : { ...result, timing };
+}
+function decodeRow(value, index, headers) {
+    const record = requireRecord(value, "table read row[" + index + "]");
+    const fields = requireRecord(record.fields, "table read row[" + index + "].fields");
+    const decoded = {};
+    for (const header of headers)
+        decoded[header] = decodeCell(fields[header], header, index);
+    return {
+        rowNumber: requireSyncGatewayPositiveSafeInteger(record.rowNumber, "table read row[" + index + "].rowNumber", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        fields: decoded,
+    };
+}
+function decodeCell(value, header, rowIndex) {
+    if (value === null)
+        return null;
+    const record = requireRecord(value, "table read row[" + rowIndex + "]." + header);
+    const kind = requireSyncGatewayText(record.kind, "table read cell kind", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE);
+    if (kind === NORMALIZED_CELL_KINDS.STRING || kind === NORMALIZED_CELL_KINDS.DATE) {
+        const textValue = requireSyncGatewayText(record.value, "table read cell value", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE);
+        return kind === NORMALIZED_CELL_KINDS.STRING
+            ? { kind: NORMALIZED_CELL_KINDS.STRING, value: textValue }
+            : { kind: NORMALIZED_CELL_KINDS.DATE, value: textValue };
+    }
+    if (kind === NORMALIZED_CELL_KINDS.NUMBER) {
+        const number = record.value;
+        if (typeof number !== "number" || !Number.isFinite(number)) {
+            return invalidOperationResponse("Apps Script table read", "table read number cell is invalid");
+        }
+        return { kind, value: number };
+    }
+    if (kind === NORMALIZED_CELL_KINDS.BOOLEAN) {
+        if (typeof record.value !== "boolean") {
+            return invalidOperationResponse("Apps Script table read", "table read boolean cell is invalid");
+        }
+        return { kind, value: record.value };
+    }
+    return invalidOperationResponse("Apps Script table read", "table read cell kind is unsupported");
+}
+function decodeHeaders(value) {
+    if (!Array.isArray(value)) {
+        return invalidOperationResponse("Apps Script table read", "headers must be an array");
+    }
+    return value.map((header, index) => requireSyncGatewayText(header, "table read headers[" + index + "]", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE));
+}
+function requireRecord(value, label) {
+    if (!isRecord(value)) {
+        return invalidOperationResponse("Apps Script table read", label + " must be an object");
+    }
+    return value;
+}
+//# sourceMappingURL=tableReadOperation.js.map

package/dist/adapter/sheets/providers/apps-script-gateway/operations/read/tableReadOperation.js.map

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

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

@@ -0,0 +1,23 @@
+/** Typed fast-append operation executed by the current thin `Code.gs`. */
+import { type FastAppendRowsResult, type FastAppendRow } from "../../../../../../application/sync/gateway/syncGateway.js";
+import type { AppsScriptOperationDefinition } from "../../transport/operationClient.js";
+/** Arguments sent to the self-contained fast-append function in `Code.gs`. */
+export type AppsScriptFastAppendOperationArgs = {
+    readonly sheetName: string;
+    readonly headers: readonly string[];
+    readonly rows: readonly FastAppendRow[];
+};
+/** Input required to create one thin-Gateway fast-append operation. */
+export interface AppsScriptFastAppendOperationRequest extends AppsScriptFastAppendOperationArgs {
+}
+/** A typed operation definition for one contiguous Sheet range write. */
+export type AppsScriptFastAppendOperation = AppsScriptOperationDefinition<AppsScriptFastAppendOperationArgs, FastAppendRowsResult>;
+/**
+ * Builds one operation that appends all supplied rows with one `setValues()`.
+ *
+ * The remote function intentionally does not read or write Developer Metadata,
+ * receipts, snapshots, or CAS state. `Code.gs` performs one final `flush()` for
+ * the whole request; reconciliation remains responsible for later drift repair.
+ */
+export declare function createFastAppendRowsOperation(request: AppsScriptFastAppendOperationRequest): AppsScriptFastAppendOperation;
+//# sourceMappingURL=fastAppendOperation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fastAppendOperation.d.ts","sourceRoot":"","sources":["../../../../../../../src/adapter/sheets/providers/apps-script-gateway/operations/write/fastAppendOperation.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,2DAA2D,CAAC;AAEnE,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,oCAAoC,CAAC;AAU5C,8EAA8E;AAC9E,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;CACzC,CAAC;AAEF,uEAAuE;AACvE,MAAM,WAAW,oCACf,SAAQ,iCAAiC;CAAG;AAE9C,yEAAyE;AACzE,MAAM,MAAM,6BAA6B,GAAG,6BAA6B,CACvE,iCAAiC,EACjC,oBAAoB,CACrB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,oCAAoC,GAC5C,6BAA6B,CAO/B"}

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

@@ -0,0 +1,166 @@
+/** Typed fast-append operation executed by the current thin `Code.gs`. */
+import { SYNC_GATEWAY_FAST_APPEND_STATUSES } from "../../../../../../application/sync/gateway/constants.js";
+import { decodeOptionalSyncGatewayTiming } from "../../protocol/timing.js";
+import { invalidOperationRequest, invalidOperationResponse, } from "../../errors.js";
+import { NORMALIZED_CELL_KINDS } from "../../../../../../shared/encoding/constants.js";
+import { isRecord } from "../../../../../../shared/encoding/typeGuards.js";
+/**
+ * Builds one operation that appends all supplied rows with one `setValues()`.
+ *
+ * The remote function intentionally does not read or write Developer Metadata,
+ * receipts, snapshots, or CAS state. `Code.gs` performs one final `flush()` for
+ * the whole request; reconciliation remains responsible for later drift repair.
+ */
+export function createFastAppendRowsOperation(request) {
+    validateFastAppendRequest(request);
+    return {
+        fn: FAST_APPEND_OPERATION_SOURCE,
+        args: request,
+        decode: (value) => decodeFastAppendResult(value, request.rows.length),
+    };
+}
+/** Self-contained V8 function source restored by `Code.gs` with `eval`. */
+const FAST_APPEND_OPERATION_SOURCE = `function (spreadsheet, args) {
+  var startedAt = Date.now();
+  var phases = [];
+  var validationStartedAt = Date.now();
+  if (!args || typeof args.sheetName !== "string" || args.sheetName.length === 0) {
+    throw new Error("fast append sheetName is required");
+  }
+  if (!Array.isArray(args.headers) || args.headers.length === 0) {
+    throw new Error("fast append headers are required");
+  }
+  if (!Array.isArray(args.rows)) {
+    throw new Error("fast append rows must be an array");
+  }
+  phase_("validate_input", validationStartedAt);
+
+  var sheetLookupStartedAt = Date.now();
+  var sheet = spreadsheet.getSheetByName(args.sheetName);
+  if (sheet === null) throw new Error("fast append sheet was not found: " + args.sheetName);
+  phase_("sheet_lookup", sheetLookupStartedAt);
+  if (args.rows.length === 0) return result_([], false);
+
+  var encodeStartedAt = Date.now();
+  var values = args.rows.map(function (row) {
+    if (!row || typeof row.effectId !== "string" || row.effectId.length === 0) {
+      throw new Error("fast append effectId is required");
+    }
+    if (!row.fields || typeof row.fields !== "object") {
+      throw new Error("fast append fields are required");
+    }
+    return args.headers.map(function (header) {
+      return toSheetValue_(row.fields[header]);
+    });
+  });
+  phase_("encode_values", encodeStartedAt);
+
+  var rangeStartedAt = Date.now();
+  var startRow = Math.max(sheet.getLastRow() + 1, 2);
+  phase_("append_range_lookup", rangeStartedAt);
+  var writeStartedAt = Date.now();
+  sheet.getRange(startRow, 1, values.length, args.headers.length).setValues(values);
+  phase_("set_values", writeStartedAt);
+  return result_(args.rows.map(function (row) {
+    return { effectId: row.effectId, status: "applied" };
+  }), false, startRow);
+
+  function result_(results, hasMore, startRowValue) {
+    var result = {
+      results: results,
+      hasMore: hasMore,
+      timing: {
+        operationKinds: ["append"],
+        operationCounts: { append: results.length, update: 0, delete: 0 },
+        durationMs: Date.now() - startedAt,
+        phases: phases,
+      },
+    };
+    if (startRowValue !== undefined) result.startRow = startRowValue;
+    return result;
+  }
+
+  function phase_(name, phaseStartedAt) {
+    phases.push({ phase: name, durationMs: Date.now() - phaseStartedAt });
+  }
+
+  function toSheetValue_(cell) {
+    if (cell === null || cell === undefined) return "";
+    if (typeof cell !== "object" || typeof cell.kind !== "string") {
+      throw new Error("fast append cell is invalid");
+    }
+    if (cell.kind === "string" || cell.kind === "date") {
+      if (typeof cell.value !== "string") throw new Error("fast append text cell is invalid");
+      return cell.value;
+    }
+    if (cell.kind === "number") {
+      if (typeof cell.value !== "number" || !isFinite(cell.value)) {
+        throw new Error("fast append number cell is invalid");
+      }
+      return cell.value;
+    }
+    if (cell.kind === "boolean") {
+      if (typeof cell.value !== "boolean") throw new Error("fast append boolean cell is invalid");
+      return cell.value;
+    }
+    throw new Error("fast append cell kind is unsupported");
+  }
+}`;
+function validateFastAppendRequest(request) {
+    if (request.sheetName.trim().length === 0) {
+        invalidOperationRequest("fast append operation", "sheetName is required");
+    }
+    if (request.headers.length === 0 || request.headers.some((header) => header.trim().length === 0)) {
+        invalidOperationRequest("fast append operation", "headers must contain non-empty names");
+    }
+    if (new Set(request.headers).size !== request.headers.length) {
+        invalidOperationRequest("fast append operation", "headers must not contain duplicates");
+    }
+    for (const row of request.rows) {
+        if (row.effectId.trim().length === 0) {
+            invalidOperationRequest("fast append operation", "every row needs an effectId");
+        }
+        for (const cell of Object.values(row.fields)) {
+            if (!isSupportedNormalizedCell(cell)) {
+                invalidOperationRequest("fast append operation", "rows contain an unsupported normalized cell");
+            }
+        }
+    }
+}
+function decodeFastAppendResult(value, expectedCount) {
+    if (!isRecord(value) ||
+        !Array.isArray(value.results) ||
+        value.results.length !== expectedCount ||
+        value.hasMore !== false) {
+        invalidOperationResponse("fast append operation", "result must contain results and hasMore=false");
+    }
+    const timing = decodeOptionalSyncGatewayTiming(value.timing, "fast append timing");
+    const result = {
+        results: value.results.map(decodeFastAppendRowResult),
+        hasMore: false,
+    };
+    return timing === undefined ? result : { ...result, timing };
+}
+function decodeFastAppendRowResult(value) {
+    if (!isRecord(value) ||
+        typeof value.effectId !== "string" ||
+        value.status !== SYNC_GATEWAY_FAST_APPEND_STATUSES.APPLIED) {
+        invalidOperationResponse("fast append operation", "result contains an invalid fast-append row");
+    }
+    return {
+        effectId: value.effectId,
+        status: SYNC_GATEWAY_FAST_APPEND_STATUSES.APPLIED,
+    };
+}
+function isSupportedNormalizedCell(value) {
+    if (value === null)
+        return true;
+    if (value.kind === NORMALIZED_CELL_KINDS.STRING || value.kind === NORMALIZED_CELL_KINDS.DATE) {
+        return typeof value.value === "string";
+    }
+    if (value.kind === NORMALIZED_CELL_KINDS.NUMBER) {
+        return Number.isFinite(value.value);
+    }
+    return value.kind === NORMALIZED_CELL_KINDS.BOOLEAN && typeof value.value === "boolean";
+}
+//# sourceMappingURL=fastAppendOperation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fastAppendOperation.js","sourceRoot":"","sources":["../../../../../../../src/adapter/sheets/providers/apps-script-gateway/operations/write/fastAppendOperation.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAO1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,yDAAyD,CAAC;AAI5G,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,iDAAiD,CAAC;AAmB3E;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA6C;IAE7C,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqFnC,CAAC;AAEH,SAAS,yBAAyB,CAAC,OAA6C;IAC9E,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,uBAAuB,CAAC,uBAAuB,EAAE,uBAAuB,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACjG,uBAAuB,CACrB,uBAAuB,EACvB,sCAAsC,CACvC,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC7D,uBAAuB,CAAC,uBAAuB,EAAE,qCAAqC,CAAC,CAAC;IAC1F,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,uBAAuB,CAAC,uBAAuB,EAAE,6BAA6B,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,uBAAuB,CACrB,uBAAuB,EACvB,6CAA6C,CAC9C,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc,EAAE,aAAqB;IACnE,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,aAAa;QACtC,KAAK,CAAC,OAAO,KAAK,KAAK,EACvB,CAAC;QACD,wBAAwB,CACtB,uBAAuB,EACvB,+CAA+C,CAChD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,+BAA+B,CAAC,KAAK,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACnF,MAAM,MAAM,GAAyB;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QACrD,OAAO,EAAE,KAAK;KACf,CAAC;IACF,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,KAAK,CAAC,MAAM,KAAK,iCAAiC,CAAC,OAAO,EAC1D,CAAC;QACD,wBAAwB,CACtB,uBAAuB,EACvB,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,iCAAiC,CAAC,OAAO;KAClD,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAqB;IACtD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,IAAI,EAAE,CAAC;QAC7F,OAAO,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,MAAM,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;AAC1F,CAAC"}

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

@@ -0,0 +1,50 @@
+/** Signed request protocol implemented by the current thin `Code.gs` file. */
+import { type AppsScriptOperationName } from "./constants.js";
+import type { SyncJsonValue } from "./types.js";
+/** The thin dispatcher reuses the data-plane protocol version. */
+export declare const APPS_SCRIPT_OPERATION_PROTOCOL_VERSION: "typed-sheets-sync-v1";
+/** One function call that `Code.gs` restores and invokes with `(spreadsheet, args)`. */
+export interface AppsScriptOperationWire {
+    readonly fn: string;
+    readonly args: SyncJsonValue;
+}
+/** Payload accepted by `Code.gs`'s `applyOperations` handler. */
+export interface AppsScriptOperationPayload {
+    readonly operations: readonly AppsScriptOperationWire[];
+}
+/** Fields authenticated by the current `Code.gs` implementation. */
+export interface AppsScriptOperationSigningFields {
+    readonly protocolVersion: typeof APPS_SCRIPT_OPERATION_PROTOCOL_VERSION;
+    readonly requestId: string;
+    readonly operation: AppsScriptOperationName;
+    readonly keyId: string;
+    readonly issuedAt: number;
+    readonly expiresAt: number;
+    readonly sheetId: string;
+    readonly actorId: string;
+    readonly bodyHash: string;
+}
+/** Signed envelope accepted by the current thin `Code.gs` handler. */
+export interface AppsScriptOperationEnvelope extends AppsScriptOperationSigningFields {
+    readonly signature: string;
+    readonly payload: AppsScriptOperationPayload;
+}
+/** Inputs for deterministic operation-envelope creation and protocol tests. */
+export interface CreateAppsScriptOperationEnvelopeOptions {
+    readonly operation: AppsScriptOperationName;
+    readonly payload: AppsScriptOperationPayload;
+    readonly sheetId: string;
+    readonly secret: string;
+    readonly keyId?: string;
+    readonly actorId?: string;
+    readonly requestId?: string;
+    readonly issuedAt?: number;
+    readonly expiresInMs?: number;
+}
+/** Exact signing input used by `Code.gs` (there is no registered range field). */
+export declare function appsScriptOperationSigningInput(input: AppsScriptOperationSigningFields): string;
+/** Computes the URL-safe HMAC signature verified by `Code.gs`. */
+export declare function signAppsScriptOperationEnvelope(input: AppsScriptOperationSigningFields, secret: string): string;
+/** Creates a signed request matching the current `Code.gs` wire contract. */
+export declare function createAppsScriptOperationEnvelope(options: CreateAppsScriptOperationEnvelopeOptions): AppsScriptOperationEnvelope;
+//# sourceMappingURL=codeGsProtocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codeGsProtocol.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/apps-script-gateway/protocol/codeGsProtocol.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AAYxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,kEAAkE;AAClE,eAAO,MAAM,sCAAsC,wBAAsC,CAAC;AAE1F,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,iEAAiE;AACjE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACzD;AAED,oEAAoE;AACpE,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,EAAE,OAAO,sCAAsC,CAAC;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,2BAA4B,SAAQ,gCAAgC;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;CAC9C;AAED,+EAA+E;AAC/E,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,kFAAkF;AAClF,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,gCAAgC,GACtC,MAAM,CAYR;AAED,kEAAkE;AAClE,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,gCAAgC,EACvC,MAAM,EAAE,MAAM,GACb,MAAM,CASR;AAED,6EAA6E;AAC7E,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,2BAA2B,CA+C7B"}

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

@@ -0,0 +1,60 @@
+/** Signed request protocol implemented by the current thin `Code.gs` file. */
+import { createHmac, randomUUID } from "node:crypto";
+import { APPS_SCRIPT_OPERATION_NAMES, SYNC_GATEWAY_DEFAULTS, SYNC_GATEWAY_ENCODINGS, SYNC_GATEWAY_HASH_ALGORITHMS, SYNC_GATEWAY_PROTOCOL_VERSIONS, } from "./constants.js";
+import { SYNC_GATEWAY_PROTOCOL_ERROR_CODES, SyncGatewayProtocolError, } from "../errors.js";
+import { requireSyncGatewayExpiry, requireSyncGatewayIssuedAt, requireSyncGatewayRequestId, requireSyncGatewayText, } from "./validation.js";
+import { canonicalSyncJson, syncSha256Hex } from "./syncProtocol.js";
+/** The thin dispatcher reuses the data-plane protocol version. */
+export const APPS_SCRIPT_OPERATION_PROTOCOL_VERSION = SYNC_GATEWAY_PROTOCOL_VERSIONS.DATA;
+/** Exact signing input used by `Code.gs` (there is no registered range field). */
+export function appsScriptOperationSigningInput(input) {
+    return [
+        input.protocolVersion,
+        input.requestId,
+        input.operation,
+        input.keyId,
+        String(input.issuedAt),
+        String(input.expiresAt),
+        input.sheetId,
+        input.actorId,
+        input.bodyHash,
+    ].join("\n");
+}
+/** Computes the URL-safe HMAC signature verified by `Code.gs`. */
+export function signAppsScriptOperationEnvelope(input, secret) {
+    const validSecret = requireSyncGatewayText(secret, "Apps Script operation secret", SYNC_GATEWAY_PROTOCOL_ERROR_CODES.INVALID_SECRET);
+    return createHmac(SYNC_GATEWAY_HASH_ALGORITHMS.SHA256, validSecret)
+        .update(appsScriptOperationSigningInput(input), SYNC_GATEWAY_ENCODINGS.UTF8)
+        .digest(SYNC_GATEWAY_ENCODINGS.BASE64URL);
+}
+/** Creates a signed request matching the current `Code.gs` wire contract. */
+export function createAppsScriptOperationEnvelope(options) {
+    const issuedAt = requireSyncGatewayIssuedAt(options.issuedAt ?? Date.now());
+    const expiresInMs = requireSyncGatewayExpiry(options.expiresInMs ?? SYNC_GATEWAY_DEFAULTS.EXPIRY_MS);
+    const sheetId = requireSyncGatewayText(options.sheetId, "Apps Script operation sheetId", SYNC_GATEWAY_PROTOCOL_ERROR_CODES.INVALID_SHEET_ID);
+    const actorId = requireSyncGatewayText(options.actorId ?? SYNC_GATEWAY_DEFAULTS.DATA_ACTOR_ID, "Apps Script operation actorId", SYNC_GATEWAY_PROTOCOL_ERROR_CODES.INVALID_ACTOR_ID);
+    const keyId = requireSyncGatewayText(options.keyId ?? SYNC_GATEWAY_DEFAULTS.KEY_ID, "Apps Script operation keyId", SYNC_GATEWAY_PROTOCOL_ERROR_CODES.INVALID_KEY_ID);
+    const requestId = requireSyncGatewayRequestId(options.requestId ?? randomUUID());
+    if (options.operation !== APPS_SCRIPT_OPERATION_NAMES.APPLY_OPERATIONS) {
+        throw new SyncGatewayProtocolError(SYNC_GATEWAY_PROTOCOL_ERROR_CODES.INVALID_OPERATION, "Apps Script operation is not supported by Code.gs");
+    }
+    // canonicalSyncJson validates every args value before the request is sent.
+    const bodyHash = syncSha256Hex(canonicalSyncJson(options.payload));
+    const unsigned = {
+        protocolVersion: APPS_SCRIPT_OPERATION_PROTOCOL_VERSION,
+        requestId,
+        operation: options.operation,
+        keyId,
+        issuedAt,
+        expiresAt: issuedAt + expiresInMs,
+        sheetId,
+        actorId,
+        bodyHash,
+    };
+    return {
+        ...unsigned,
+        signature: signAppsScriptOperationEnvelope(unsigned, options.secret),
+        payload: options.payload,
+    };
+}
+//# sourceMappingURL=codeGsProtocol.js.map

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

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

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

@@ -0,0 +1,44 @@
+/** Protocol version used by the thin Apps Script operation dispatcher. */
+export declare const SYNC_GATEWAY_PROTOCOL_VERSIONS: {
+    readonly DATA: "typed-sheets-sync-v1";
+};
+export type SyncGatewayProtocolVersion = (typeof SYNC_GATEWAY_PROTOCOL_VERSIONS)[keyof typeof SYNC_GATEWAY_PROTOCOL_VERSIONS];
+/** Data-plane protocol version used by signed sync requests. */
+export type SyncGatewayDataProtocolVersion = (typeof SYNC_GATEWAY_PROTOCOL_VERSIONS)["DATA"];
+/** Operation names accepted by the thin Code.gs function dispatcher. */
+export declare const APPS_SCRIPT_OPERATION_NAMES: {
+    readonly APPLY_OPERATIONS: "applyOperations";
+};
+export type AppsScriptOperationName = (typeof APPS_SCRIPT_OPERATION_NAMES)[keyof typeof APPS_SCRIPT_OPERATION_NAMES];
+/** Shared defaults for signed gateway envelopes. */
+export declare const SYNC_GATEWAY_DEFAULTS: {
+    readonly DATA_ACTOR_ID: "typed-sheets-sync-worker";
+    readonly KEY_ID: "typed-sheets-shared-secret-v1";
+    readonly EXPIRY_MS: 60000;
+    readonly MIN_EXPIRY_MS: 1000;
+    readonly MAX_EXPIRY_MS: number;
+};
+/** Request timeout bounds for the Node-side Apps Script client. */
+export declare const SYNC_GATEWAY_CLIENT_DEFAULTS: {
+    readonly REQUEST_TIMEOUT_MS: 30000;
+    readonly MIN_REQUEST_TIMEOUT_MS: 1000;
+    readonly MAX_REQUEST_TIMEOUT_MS: 120000;
+};
+/** Cryptographic algorithm used by both gateway envelope types. */
+export declare const SYNC_GATEWAY_HASH_ALGORITHMS: {
+    readonly SHA256: "sha256";
+};
+/** Encodings used by the Node crypto boundary. */
+export declare const SYNC_GATEWAY_ENCODINGS: {
+    readonly UTF8: "utf8";
+    readonly BASE64URL: "base64url";
+};
+/** Canonical JSON tokens emitted for primitive literal values. */
+export declare const SYNC_JSON_LITERAL_TOKENS: {
+    readonly NULL: "null";
+    readonly TRUE: "true";
+    readonly FALSE: "false";
+};
+/** Request IDs must remain short and safe to carry through the gateway. */
+export declare const SYNC_GATEWAY_REQUEST_ID_PATTERN: RegExp;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/apps-script-gateway/protocol/constants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,8BAA8B;;CAEjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,OAAO,8BAA8B,CAAC,CAAC;AAEvF,gEAAgE;AAChE,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,wEAAwE;AACxE,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,oDAAoD;AACpD,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAEX,kEAAkE;AAClE,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,QAA6B,CAAC"}

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

@@ -0,0 +1,40 @@
+/** Protocol version used by the thin Apps Script operation dispatcher. */
+export const SYNC_GATEWAY_PROTOCOL_VERSIONS = {
+    DATA: "typed-sheets-sync-v1",
+};
+/** Operation names accepted by the thin Code.gs function dispatcher. */
+export const APPS_SCRIPT_OPERATION_NAMES = {
+    APPLY_OPERATIONS: "applyOperations",
+};
+/** Shared defaults for signed gateway envelopes. */
+export const SYNC_GATEWAY_DEFAULTS = {
+    DATA_ACTOR_ID: "typed-sheets-sync-worker",
+    KEY_ID: "typed-sheets-shared-secret-v1",
+    EXPIRY_MS: 60_000,
+    MIN_EXPIRY_MS: 1_000,
+    MAX_EXPIRY_MS: 10 * 60_000,
+};
+/** Request timeout bounds for the Node-side Apps Script client. */
+export const SYNC_GATEWAY_CLIENT_DEFAULTS = {
+    REQUEST_TIMEOUT_MS: 30_000,
+    MIN_REQUEST_TIMEOUT_MS: 1_000,
+    MAX_REQUEST_TIMEOUT_MS: 120_000,
+};
+/** Cryptographic algorithm used by both gateway envelope types. */
+export const SYNC_GATEWAY_HASH_ALGORITHMS = {
+    SHA256: "sha256",
+};
+/** Encodings used by the Node crypto boundary. */
+export const SYNC_GATEWAY_ENCODINGS = {
+    UTF8: "utf8",
+    BASE64URL: "base64url",
+};
+/** Canonical JSON tokens emitted for primitive literal values. */
+export const SYNC_JSON_LITERAL_TOKENS = {
+    NULL: "null",
+    TRUE: "true",
+    FALSE: "false",
+};
+/** Request IDs must remain short and safe to carry through the gateway. */
+export const SYNC_GATEWAY_REQUEST_ID_PATTERN = /^[A-Za-z0-9._:-]{8,128}$/;
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/apps-script-gateway/protocol/constants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,sBAAsB;CACpB,CAAC;AASX,wEAAwE;AACxE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,iBAAiB;CAC3B,CAAC;AAKX,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,aAAa,EAAE,0BAA0B;IACzC,MAAM,EAAE,+BAA+B;IACvC,SAAS,EAAE,MAAM;IACjB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,EAAE,GAAG,MAAM;CAClB,CAAC;AAEX,mEAAmE;AACnE,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,kBAAkB,EAAE,MAAM;IAC1B,sBAAsB,EAAE,KAAK;IAC7B,sBAAsB,EAAE,OAAO;CACvB,CAAC;AAEX,mEAAmE;AACnE,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;CACd,CAAC;AAEX,kEAAkE;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACN,CAAC;AAEX,2EAA2E;AAC3E,MAAM,CAAC,MAAM,+BAA+B,GAAG,0BAA0B,CAAC"}

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

@@ -0,0 +1,7 @@
+/** Canonical JSON and hashing helpers shared by the thin operation protocol. */
+export type { SyncJsonValue } from "./types.js";
+/** Canonical JSON used for payload hashes and cross-runtime HMAC inputs. */
+export declare function canonicalSyncJson(value: unknown): string;
+/** SHA-256 helper shared by envelope and effect payload verification. */
+export declare function syncSha256Hex(value: string): string;
+//# sourceMappingURL=syncProtocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syncProtocol.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/apps-script-gateway/protocol/syncProtocol.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAchF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqBxD;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD"}