@particle-academy/google-sheets-js 0.3.4 → 0.4.0

package/CHANGELOG.md

@@ -8,6 +8,18 @@ The four packages share one version, because they are generated from one
 `provider/` definition and a version that meant something different in each
 would be a version nobody could reason about.
 
+## [0.4.0] — 2026-10-01
+
+### Added
+
+- **`values_get`** and **`values_update`** — read a range, and overwrite
+  one. No scope change: this connector already holds the full
+  `spreadsheets` scope `row_append` needed. `values_update` OVERWRITES
+  the cells inside the given range; it does not push existing rows down
+  or search for the next empty row the way `row_append` (`values.append`)
+  does — the two sound alike and behave differently on data already
+  there, said plainly in both actions' own descriptions.
+
 ## [0.3.4] — 2026-09-12
 
 ### Changed

package/README.md

@@ -1,5 +1,7 @@
 # Google Sheets
 
+[![Fancified](art/fancified.svg)](https://particle.academy)
+
 Google Sheets for [fancy-flow][flow] — as **four imported, versioned packages**, one
 per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
 change.
@@ -79,6 +81,32 @@ Append a row to a Google Sheet.
 | `valueInputOption` | no | USER_ENTERED parses the cells the way typing them would -- so =SUM(A1:A2) becomes a formula and 1/2/26 becomes a date. RAW stores exactly the characters given. |
 | `insertDataOption` | no | INSERT_ROWS pushes existing rows down. OVERWRITE writes into them. |
 
+#### `values_get` — Read Google Sheets values
+
+Read the cell values of a range.
+
+`GET /v4/spreadsheets/{spreadsheetId}/values/{range}` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `spreadsheetId` | yes | The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit. |
+| `range` | yes | In A1 notation, the same shape row_append accepts. |
+| `valueRenderOption` | no | How to render values |
+| `majorDimension` | no | Whether the outer array of the result is rows or columns. |
+
+#### `values_update` — Write Google Sheets values
+
+Overwrite the cell values of a range. Existing values in that range are replaced, not pushed down.
+
+`PUT /v4/spreadsheets/{spreadsheetId}/values/{range}` · idempotent — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `spreadsheetId` | yes | Spreadsheet ID |
+| `range` | yes | In A1 notation. The values written fill this range from its top-left cell -- more rows or columns than the range covers are written anyway, following Google's own documented behavior; fewer leave the rest of the range untouched. |
+| `values` | yes | The cells to write, comma separated, left to right, one row. For more than one row, call this action once per row. |
+| `valueInputOption` | yes | USER_ENTERED parses the cells the way typing them would -- so =SUM(A1:A2) becomes a formula. RAW stores exactly the characters given. |
+
 ## Run it before you have credentials
 
 Every operation ships a **faker**, whether or not Google Sheets has a sandbox. Set a

package/art/fancified.svg

@@ -0,0 +1,26 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="28" role="img" aria-label="Fancified — built with Fancy UI">
+  <title>Fancified · built with Fancy UI</title>
+  <defs>
+    <linearGradient id="fcdBg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#6d28d9"/>
+      <stop offset=".5" stop-color="#9333ea"/>
+      <stop offset="1" stop-color="#d946ef"/>
+    </linearGradient>
+    <linearGradient id="fcdGloss" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#ffffff" stop-opacity=".30"/>
+      <stop offset=".55" stop-color="#ffffff" stop-opacity="0"/>
+    </linearGradient>
+    <clipPath id="fcdClip"><rect width="128" height="28" rx="7"/></clipPath>
+  </defs>
+  <g clip-path="url(#fcdClip)">
+    <rect width="128" height="28" fill="url(#fcdBg)"/>
+    <rect width="34" height="28" fill="#3b0764" fill-opacity=".5"/>
+    <rect width="128" height="13" fill="url(#fcdGloss)"/>
+    <g fill="#fff">
+      <path transform="translate(17 14)" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
+      <path transform="translate(25.5 7.5) scale(.34)" fill-opacity=".85" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
+    </g>
+    <text x="81" y="18.5" fill="#ffffff" text-anchor="middle" font-family="'Segoe UI',Verdana,'DejaVu Sans',sans-serif" font-size="12" font-weight="700" letter-spacing=".3">Fancified</text>
+  </g>
+  <rect x=".5" y=".5" width="127" height="27" rx="6.5" fill="none" stroke="#ffffff" stroke-opacity=".22"/>
+</svg>

package/dist/chunk-L2NNYKEK.js

@@ -0,0 +1,193 @@
+import { callConnector } from '@particle-academy/fancy-connector-core';
+
+// src/faker.ts
+function fakeRowAppend({ config, fake }) {
+  const boundSpreadsheetid = config.spreadsheetId !== void 0 && config.spreadsheetId !== null && config.spreadsheetId !== "" ? String(config.spreadsheetId) : fake.id("1Sheet");
+  return {
+    "spreadsheetId": boundSpreadsheetid,
+    "tableRange": "Sheet1!A1:D4",
+    "updates": {
+      "spreadsheetId": boundSpreadsheetid,
+      "updatedRange": "Sheet1!A5:D5",
+      "updatedRows": 1,
+      "updatedColumns": 4,
+      "updatedCells": 4
+    }
+  };
+}
+function fakeValuesGet({ config, fake }) {
+  return {
+    "range": config.range !== void 0 && config.range !== null && config.range !== "" ? String(config.range) : "Sheet1!A1:C2",
+    "majorDimension": config.majorDimension !== void 0 && config.majorDimension !== null && config.majorDimension !== "" ? String(config.majorDimension) : "ROWS",
+    "values": [
+      [
+        "Name",
+        "Email",
+        "Status"
+      ],
+      [
+        "Ada Lovelace",
+        "ada@example.test",
+        "Active"
+      ]
+    ]
+  };
+}
+function fakeValuesUpdate({ config, fake }) {
+  const boundSpreadsheetid = config.spreadsheetId !== void 0 && config.spreadsheetId !== null && config.spreadsheetId !== "" ? String(config.spreadsheetId) : fake.id("1Sheet");
+  return {
+    "spreadsheetId": boundSpreadsheetid,
+    "updatedRange": config.range !== void 0 && config.range !== null && config.range !== "" ? String(config.range) : "Sheet1!A1",
+    "updatedRows": 1,
+    "updatedColumns": 3,
+    "updatedCells": 3
+  };
+}
+var googleSheetsFaker = (operation, request) => {
+  switch (operation) {
+    case "row_append":
+      return fakeRowAppend(request);
+    case "values_get":
+      return fakeValuesGet(request);
+    case "values_update":
+      return fakeValuesUpdate(request);
+    default:
+      throw new Error(
+        `google_sheets: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GOOGLE_SHEETS_BASE_URLS = {
+  "live": "https://sheets.googleapis.com"
+};
+var GOOGLE_SHEETS_REQUIRES = [
+  "accessToken",
+  "refreshToken",
+  "clientId",
+  "clientSecret"
+];
+function googleSheetsAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var GOOGLE_SHEETS = {
+  service: "google_sheets",
+  title: "Google Sheets",
+  sandbox: "none",
+  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },
+  requires: [...GOOGLE_SHEETS_REQUIRES],
+  authorize: googleSheetsAuthorize,
+  faker: googleSheetsFaker
+};
+var ROW_APPEND_OPERATION = "row_append";
+async function googleSheetsRowAppend(options) {
+  const config = options.config ?? {};
+  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
+    throw new Error(`row_append: "spreadsheetId" is required (Spreadsheet ID).`);
+  }
+  if (config.range === void 0 || config.range === null || config.range === "") {
+    throw new Error(`row_append: "range" is required (Range).`);
+  }
+  if (config.values === void 0 || config.values === null || config.values === "") {
+    throw new Error(`row_append: "values" is required (Row values).`);
+  }
+  return callConnector(GOOGLE_SHEETS, {
+    operation: ROW_APPEND_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,
+      json: {
+        "values": [valuesList(config.values)]
+      },
+      query: {
+        ...config.valueInputOption !== void 0 && config.valueInputOption !== null && config.valueInputOption !== "" ? { "valueInputOption": String(config.valueInputOption) } : {},
+        ...config.insertDataOption !== void 0 && config.insertDataOption !== null && config.insertDataOption !== "" ? { "insertDataOption": String(config.insertDataOption) } : {}
+      }
+    }
+  });
+}
+function valuesList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+var VALUES_GET_OPERATION = "values_get";
+async function googleSheetsValuesGet(options) {
+  const config = options.config ?? {};
+  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
+    throw new Error(`values_get: "spreadsheetId" is required (Spreadsheet ID).`);
+  }
+  if (config.range === void 0 || config.range === null || config.range === "") {
+    throw new Error(`values_get: "range" is required (Range).`);
+  }
+  return callConnector(GOOGLE_SHEETS, {
+    operation: VALUES_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,
+      query: {
+        ...config.valueRenderOption !== void 0 && config.valueRenderOption !== null && config.valueRenderOption !== "" ? { "valueRenderOption": String(config.valueRenderOption) } : {},
+        ...config.majorDimension !== void 0 && config.majorDimension !== null && config.majorDimension !== "" ? { "majorDimension": String(config.majorDimension) } : {}
+      }
+    }
+  });
+}
+var VALUES_UPDATE_OPERATION = "values_update";
+async function googleSheetsValuesUpdate(options) {
+  const config = options.config ?? {};
+  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
+    throw new Error(`values_update: "spreadsheetId" is required (Spreadsheet ID).`);
+  }
+  if (config.range === void 0 || config.range === null || config.range === "") {
+    throw new Error(`values_update: "range" is required (Range).`);
+  }
+  if (config.values === void 0 || config.values === null || config.values === "") {
+    throw new Error(`values_update: "values" is required (Row values).`);
+  }
+  if (config.valueInputOption === void 0 || config.valueInputOption === null || config.valueInputOption === "") {
+    throw new Error(`values_update: "valueInputOption" is required (How to interpret the values).`);
+  }
+  return callConnector(GOOGLE_SHEETS, {
+    operation: VALUES_UPDATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "PUT",
+      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,
+      json: {
+        "values": [valuesList2(config.values)]
+      },
+      query: {
+        "valueInputOption": String(config.valueInputOption)
+      }
+    }
+  });
+}
+function valuesList2(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+
+export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, VALUES_GET_OPERATION, VALUES_UPDATE_OPERATION, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend, googleSheetsValuesGet, googleSheetsValuesUpdate };
+//# sourceMappingURL=chunk-L2NNYKEK.js.map
+//# sourceMappingURL=chunk-L2NNYKEK.js.map

package/dist/chunk-L2NNYKEK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/row-append.ts","../src/actions/values-get.ts","../src/actions/values-update.ts"],"names":["callConnector","valuesList"],"mappings":"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","file":"chunk-L2NNYKEK.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * The Google Sheets faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Sheets actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeRowAppend({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"tableRange\": \"Sheet1!A1:D4\",\n    \"updates\": {\n      \"spreadsheetId\": boundSpreadsheetid,\n      \"updatedRange\": \"Sheet1!A5:D5\",\n      \"updatedRows\": 1,\n      \"updatedColumns\": 4,\n      \"updatedCells\": 4,\n    },\n  };\n}\n\nfunction fakeValuesGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"range\": (config.range !== undefined && config.range !== null && config.range !== \"\" ? String(config.range) : \"Sheet1!A1:C2\"),\n    \"majorDimension\": (config.majorDimension !== undefined && config.majorDimension !== null && config.majorDimension !== \"\" ? String(config.majorDimension) : \"ROWS\"),\n    \"values\": [\n      [\n        \"Name\",\n        \"Email\",\n        \"Status\",\n      ],\n      [\n        \"Ada Lovelace\",\n        \"ada@example.test\",\n        \"Active\",\n      ],\n    ],\n  };\n}\n\nfunction fakeValuesUpdate({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"updatedRange\": (config.range !== undefined && config.range !== null && config.range !== \"\" ? String(config.range) : \"Sheet1!A1\"),\n    \"updatedRows\": 1,\n    \"updatedColumns\": 3,\n    \"updatedCells\": 3,\n  };\n}\n\nexport const googleSheetsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"row_append\":\n      return fakeRowAppend(request);\n\n    case \"values_get\":\n      return fakeValuesGet(request);\n\n    case \"values_update\":\n      return fakeValuesUpdate(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_sheets: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets, as one service descriptor shared by every Google Sheets\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Sheets: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Sheets. A test spreadsheet is a real one in a real\n * Drive, so every append is real -- point this at a scratch sheet, not a\n * production one. The faker is the only way to develop against it without\n * touching a document.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSheetsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SHEETS_BASE_URLS = {\n  \"live\": \"https://sheets.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SHEETS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Sheets's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSheetsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Sheets service, for the TypeScript runtime. */\nexport const GOOGLE_SHEETS: ServiceDescriptor = {\n  service: \"google_sheets\",\n  title: \"Google Sheets\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },\n  requires: [...GOOGLE_SHEETS_REQUIRES],\n  authorize: googleSheetsAuthorize,\n  faker: googleSheetsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/row-append.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/row-append.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Append a row to a Google Sheet.\n *\n * POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append —\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const ROW_APPEND_OPERATION = \"row_append\";\n\nexport type RowAppendOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption, insertDataOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`row_append: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`row_append: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`row_append: \"values\" is required (Row values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: ROW_APPEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        ...(config.valueInputOption !== undefined && config.valueInputOption !== null && config.valueInputOption !== \"\" ? { \"valueInputOption\": String(config.valueInputOption) } : {}),\n        ...(config.insertDataOption !== undefined && config.insertDataOption !== null && config.insertDataOption !== \"\" ? { \"insertDataOption\": String(config.insertDataOption) } : {}),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/values-get.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/values-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Read the cell values of a range.\n *\n * GET /v4/spreadsheets/{spreadsheetId}/values/{range} —\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const VALUES_GET_OPERATION = \"values_get\";\n\nexport type ValuesGetOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, valueRenderOption, majorDimension. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsValuesGet(options: ValuesGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`values_get: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`values_get: \"range\" is required (Range).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: VALUES_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,\n      query: {\n        ...(config.valueRenderOption !== undefined && config.valueRenderOption !== null && config.valueRenderOption !== \"\" ? { \"valueRenderOption\": String(config.valueRenderOption) } : {}),\n        ...(config.majorDimension !== undefined && config.majorDimension !== null && config.majorDimension !== \"\" ? { \"majorDimension\": String(config.majorDimension) } : {}),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/values-update.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/values-update.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Overwrite the cell values of a range. Existing values in that range are\n * replaced, not pushed down.\n *\n * PUT /v4/spreadsheets/{spreadsheetId}/values/{range} —\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const VALUES_UPDATE_OPERATION = \"values_update\";\n\nexport type ValuesUpdateOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsValuesUpdate(options: ValuesUpdateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`values_update: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`values_update: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`values_update: \"values\" is required (Row values).`);\n  }\n\n  if (config.valueInputOption === undefined || config.valueInputOption === null || config.valueInputOption === \"\") {\n    throw new Error(`values_update: \"valueInputOption\" is required (How to interpret the values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: VALUES_UPDATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"PUT\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        \"valueInputOption\": String(config.valueInputOption),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n"]}

package/dist/flow.cjs

@@ -20,10 +20,42 @@ function fakeRowAppend({ config, fake }) {
     }
   };
 }
+function fakeValuesGet({ config, fake }) {
+  return {
+    "range": config.range !== void 0 && config.range !== null && config.range !== "" ? String(config.range) : "Sheet1!A1:C2",
+    "majorDimension": config.majorDimension !== void 0 && config.majorDimension !== null && config.majorDimension !== "" ? String(config.majorDimension) : "ROWS",
+    "values": [
+      [
+        "Name",
+        "Email",
+        "Status"
+      ],
+      [
+        "Ada Lovelace",
+        "ada@example.test",
+        "Active"
+      ]
+    ]
+  };
+}
+function fakeValuesUpdate({ config, fake }) {
+  const boundSpreadsheetid = config.spreadsheetId !== void 0 && config.spreadsheetId !== null && config.spreadsheetId !== "" ? String(config.spreadsheetId) : fake.id("1Sheet");
+  return {
+    "spreadsheetId": boundSpreadsheetid,
+    "updatedRange": config.range !== void 0 && config.range !== null && config.range !== "" ? String(config.range) : "Sheet1!A1",
+    "updatedRows": 1,
+    "updatedColumns": 3,
+    "updatedCells": 3
+  };
+}
 var googleSheetsFaker = (operation, request) => {
   switch (operation) {
     case "row_append":
       return fakeRowAppend(request);
+    case "values_get":
+      return fakeValuesGet(request);
+    case "values_update":
+      return fakeValuesUpdate(request);
     default:
       throw new Error(
         `google_sheets: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
@@ -91,6 +123,74 @@ function valuesList(value) {
   const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
   return items.map((item) => item.trim()).filter(Boolean);
 }
+var VALUES_GET_OPERATION = "values_get";
+async function googleSheetsValuesGet(options) {
+  const config = options.config ?? {};
+  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
+    throw new Error(`values_get: "spreadsheetId" is required (Spreadsheet ID).`);
+  }
+  if (config.range === void 0 || config.range === null || config.range === "") {
+    throw new Error(`values_get: "range" is required (Range).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_SHEETS, {
+    operation: VALUES_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,
+      query: {
+        ...config.valueRenderOption !== void 0 && config.valueRenderOption !== null && config.valueRenderOption !== "" ? { "valueRenderOption": String(config.valueRenderOption) } : {},
+        ...config.majorDimension !== void 0 && config.majorDimension !== null && config.majorDimension !== "" ? { "majorDimension": String(config.majorDimension) } : {}
+      }
+    }
+  });
+}
+var VALUES_UPDATE_OPERATION = "values_update";
+async function googleSheetsValuesUpdate(options) {
+  const config = options.config ?? {};
+  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
+    throw new Error(`values_update: "spreadsheetId" is required (Spreadsheet ID).`);
+  }
+  if (config.range === void 0 || config.range === null || config.range === "") {
+    throw new Error(`values_update: "range" is required (Range).`);
+  }
+  if (config.values === void 0 || config.values === null || config.values === "") {
+    throw new Error(`values_update: "values" is required (Row values).`);
+  }
+  if (config.valueInputOption === void 0 || config.valueInputOption === null || config.valueInputOption === "") {
+    throw new Error(`values_update: "valueInputOption" is required (How to interpret the values).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_SHEETS, {
+    operation: VALUES_UPDATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "PUT",
+      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,
+      json: {
+        "values": [valuesList2(config.values)]
+      },
+      query: {
+        "valueInputOption": String(config.valueInputOption)
+      }
+    }
+  });
+}
+function valuesList2(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
 
 // src/flow.ts
 var googleSheetsRowExecutor = async (ctx) => {
@@ -107,11 +207,43 @@ var googleSheetsRowExecutor = async (ctx) => {
   });
   return { __port: "out", value: result };
 };
+var googleSheetsValuesGetExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleSheetsValuesGet({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_sheets values_get ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var googleSheetsValuesUpdateExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleSheetsValuesUpdate({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_sheets values_update ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
 var GOOGLE_SHEETS_RUNNABLE_KINDS = [
-  { ...googleSheetsUi.googleSheetsRowKind, executor: googleSheetsRowExecutor }
+  { ...googleSheetsUi.googleSheetsRowKind, executor: googleSheetsRowExecutor },
+  { ...googleSheetsUi.googleSheetsValuesGetKind, executor: googleSheetsValuesGetExecutor },
+  { ...googleSheetsUi.googleSheetsValuesUpdateKind, executor: googleSheetsValuesUpdateExecutor }
 ];
 
 exports.GOOGLE_SHEETS_RUNNABLE_KINDS = GOOGLE_SHEETS_RUNNABLE_KINDS;
 exports.googleSheetsRowExecutor = googleSheetsRowExecutor;
+exports.googleSheetsValuesGetExecutor = googleSheetsValuesGetExecutor;
+exports.googleSheetsValuesUpdateExecutor = googleSheetsValuesUpdateExecutor;
 //# sourceMappingURL=flow.cjs.map
 //# sourceMappingURL=flow.cjs.map

package/dist/flow.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/row-append.ts","../src/flow.ts"],"names":["callConnector","googleSheetsRowKind"],"mappings":"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","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * The Google Sheets faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Sheets actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeRowAppend({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"tableRange\": \"Sheet1!A1:D4\",\n    \"updates\": {\n      \"spreadsheetId\": boundSpreadsheetid,\n      \"updatedRange\": \"Sheet1!A5:D5\",\n      \"updatedRows\": 1,\n      \"updatedColumns\": 4,\n      \"updatedCells\": 4,\n    },\n  };\n}\n\nexport const googleSheetsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"row_append\":\n      return fakeRowAppend(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_sheets: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets, as one service descriptor shared by every Google Sheets\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Sheets: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Sheets. A test spreadsheet is a real one in a real\n * Drive, so every append is real -- point this at a scratch sheet, not a\n * production one. The faker is the only way to develop against it without\n * touching a document.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSheetsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SHEETS_BASE_URLS = {\n  \"live\": \"https://sheets.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SHEETS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Sheets's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSheetsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Sheets service, for the TypeScript runtime. */\nexport const GOOGLE_SHEETS: ServiceDescriptor = {\n  service: \"google_sheets\",\n  title: \"Google Sheets\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },\n  requires: [...GOOGLE_SHEETS_REQUIRES],\n  authorize: googleSheetsAuthorize,\n  faker: googleSheetsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/row-append.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/row-append.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Append a row to a Google Sheet.\n *\n * POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append —\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const ROW_APPEND_OPERATION = \"row_append\";\n\nexport type RowAppendOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption, insertDataOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`row_append: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`row_append: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`row_append: \"values\" is required (Row values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: ROW_APPEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        ...(config.valueInputOption !== undefined && config.valueInputOption !== null && config.valueInputOption !== \"\" ? { \"valueInputOption\": String(config.valueInputOption) } : {}),\n        ...(config.insertDataOption !== undefined && config.insertDataOption !== null && config.insertDataOption !== \"\" ? { \"insertDataOption\": String(config.insertDataOption) } : {}),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-sheets-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"./service.js\";\n\nimport {\n  googleSheetsRowKind,\n} from \"@particle-academy/google-sheets-ui\";\n\nimport { googleSheetsRowAppend } from \"./actions/row-append.js\";\n\nexport const googleSheetsRowExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsRowAppend({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets row_append ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SHEETS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSheetsRowKind, executor: googleSheetsRowExecutor },\n];\n"]}
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/row-append.ts","../src/actions/values-get.ts","../src/actions/values-update.ts","../src/flow.ts"],"names":["callConnector","valuesList","googleSheetsRowKind","googleSheetsValuesGetKind","googleSheetsValuesUpdateKind"],"mappings":"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","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * The Google Sheets faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Sheets actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeRowAppend({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"tableRange\": \"Sheet1!A1:D4\",\n    \"updates\": {\n      \"spreadsheetId\": boundSpreadsheetid,\n      \"updatedRange\": \"Sheet1!A5:D5\",\n      \"updatedRows\": 1,\n      \"updatedColumns\": 4,\n      \"updatedCells\": 4,\n    },\n  };\n}\n\nfunction fakeValuesGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"range\": (config.range !== undefined && config.range !== null && config.range !== \"\" ? String(config.range) : \"Sheet1!A1:C2\"),\n    \"majorDimension\": (config.majorDimension !== undefined && config.majorDimension !== null && config.majorDimension !== \"\" ? String(config.majorDimension) : \"ROWS\"),\n    \"values\": [\n      [\n        \"Name\",\n        \"Email\",\n        \"Status\",\n      ],\n      [\n        \"Ada Lovelace\",\n        \"ada@example.test\",\n        \"Active\",\n      ],\n    ],\n  };\n}\n\nfunction fakeValuesUpdate({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"updatedRange\": (config.range !== undefined && config.range !== null && config.range !== \"\" ? String(config.range) : \"Sheet1!A1\"),\n    \"updatedRows\": 1,\n    \"updatedColumns\": 3,\n    \"updatedCells\": 3,\n  };\n}\n\nexport const googleSheetsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"row_append\":\n      return fakeRowAppend(request);\n\n    case \"values_get\":\n      return fakeValuesGet(request);\n\n    case \"values_update\":\n      return fakeValuesUpdate(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_sheets: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets, as one service descriptor shared by every Google Sheets\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Sheets: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Sheets. A test spreadsheet is a real one in a real\n * Drive, so every append is real -- point this at a scratch sheet, not a\n * production one. The faker is the only way to develop against it without\n * touching a document.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSheetsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SHEETS_BASE_URLS = {\n  \"live\": \"https://sheets.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SHEETS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Sheets's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSheetsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Sheets service, for the TypeScript runtime. */\nexport const GOOGLE_SHEETS: ServiceDescriptor = {\n  service: \"google_sheets\",\n  title: \"Google Sheets\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },\n  requires: [...GOOGLE_SHEETS_REQUIRES],\n  authorize: googleSheetsAuthorize,\n  faker: googleSheetsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/row-append.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/row-append.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Append a row to a Google Sheet.\n *\n * POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append —\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const ROW_APPEND_OPERATION = \"row_append\";\n\nexport type RowAppendOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption, insertDataOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`row_append: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`row_append: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`row_append: \"values\" is required (Row values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: ROW_APPEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        ...(config.valueInputOption !== undefined && config.valueInputOption !== null && config.valueInputOption !== \"\" ? { \"valueInputOption\": String(config.valueInputOption) } : {}),\n        ...(config.insertDataOption !== undefined && config.insertDataOption !== null && config.insertDataOption !== \"\" ? { \"insertDataOption\": String(config.insertDataOption) } : {}),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/values-get.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/values-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Read the cell values of a range.\n *\n * GET /v4/spreadsheets/{spreadsheetId}/values/{range} —\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const VALUES_GET_OPERATION = \"values_get\";\n\nexport type ValuesGetOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, valueRenderOption, majorDimension. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsValuesGet(options: ValuesGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`values_get: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`values_get: \"range\" is required (Range).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: VALUES_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,\n      query: {\n        ...(config.valueRenderOption !== undefined && config.valueRenderOption !== null && config.valueRenderOption !== \"\" ? { \"valueRenderOption\": String(config.valueRenderOption) } : {}),\n        ...(config.majorDimension !== undefined && config.majorDimension !== null && config.majorDimension !== \"\" ? { \"majorDimension\": String(config.majorDimension) } : {}),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/values-update.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/values-update.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Overwrite the cell values of a range. Existing values in that range are\n * replaced, not pushed down.\n *\n * PUT /v4/spreadsheets/{spreadsheetId}/values/{range} —\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const VALUES_UPDATE_OPERATION = \"values_update\";\n\nexport type ValuesUpdateOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsValuesUpdate(options: ValuesUpdateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`values_update: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`values_update: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`values_update: \"values\" is required (Row values).`);\n  }\n\n  if (config.valueInputOption === undefined || config.valueInputOption === null || config.valueInputOption === \"\") {\n    throw new Error(`values_update: \"valueInputOption\" is required (How to interpret the values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: VALUES_UPDATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"PUT\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        \"valueInputOption\": String(config.valueInputOption),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-sheets-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"./service.js\";\n\nimport {\n  googleSheetsRowKind,\n  googleSheetsValuesGetKind,\n  googleSheetsValuesUpdateKind,\n} from \"@particle-academy/google-sheets-ui\";\n\nimport { googleSheetsRowAppend } from \"./actions/row-append.js\";\nimport { googleSheetsValuesGet } from \"./actions/values-get.js\";\nimport { googleSheetsValuesUpdate } from \"./actions/values-update.js\";\n\nexport const googleSheetsRowExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsRowAppend({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets row_append ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleSheetsValuesGetExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsValuesGet({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets values_get ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleSheetsValuesUpdateExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsValuesUpdate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets values_update ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SHEETS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSheetsRowKind, executor: googleSheetsRowExecutor },\n  { ...googleSheetsValuesGetKind, executor: googleSheetsValuesGetExecutor },\n  { ...googleSheetsValuesUpdateKind, executor: googleSheetsValuesUpdateExecutor },\n];\n"]}

package/dist/flow.d.cts

@@ -20,7 +20,9 @@ import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/e
  */
 
 declare const googleSheetsRowExecutor: NodeExecutor;
+declare const googleSheetsValuesGetExecutor: NodeExecutor;
+declare const googleSheetsValuesUpdateExecutor: NodeExecutor;
 /** The kinds a TypeScript host registers. */
 declare const GOOGLE_SHEETS_RUNNABLE_KINDS: NodeKindDefinition[];
 
-export { GOOGLE_SHEETS_RUNNABLE_KINDS, googleSheetsRowExecutor };
+export { GOOGLE_SHEETS_RUNNABLE_KINDS, googleSheetsRowExecutor, googleSheetsValuesGetExecutor, googleSheetsValuesUpdateExecutor };

package/dist/flow.d.ts

@@ -20,7 +20,9 @@ import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/e
  */
 
 declare const googleSheetsRowExecutor: NodeExecutor;
+declare const googleSheetsValuesGetExecutor: NodeExecutor;
+declare const googleSheetsValuesUpdateExecutor: NodeExecutor;
 /** The kinds a TypeScript host registers. */
 declare const GOOGLE_SHEETS_RUNNABLE_KINDS: NodeKindDefinition[];
 
-export { GOOGLE_SHEETS_RUNNABLE_KINDS, googleSheetsRowExecutor };
+export { GOOGLE_SHEETS_RUNNABLE_KINDS, googleSheetsRowExecutor, googleSheetsValuesGetExecutor, googleSheetsValuesUpdateExecutor };

package/dist/flow.js

@@ -1,6 +1,6 @@
-import { googleSheetsRowAppend } from './chunk-7AZ3XUFX.js';
+import { googleSheetsRowAppend, googleSheetsValuesGet, googleSheetsValuesUpdate } from './chunk-L2NNYKEK.js';
 import '@particle-academy/fancy-connector-core';
-import { googleSheetsRowKind } from '@particle-academy/google-sheets-ui';
+import { googleSheetsRowKind, googleSheetsValuesGetKind, googleSheetsValuesUpdateKind } from '@particle-academy/google-sheets-ui';
 
 var googleSheetsRowExecutor = async (ctx) => {
   const config = ctx.node.data?.config ?? {};
@@ -16,10 +16,40 @@ var googleSheetsRowExecutor = async (ctx) => {
   });
   return { __port: "out", value: result };
 };
+var googleSheetsValuesGetExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleSheetsValuesGet({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_sheets values_get ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var googleSheetsValuesUpdateExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleSheetsValuesUpdate({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_sheets values_update ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
 var GOOGLE_SHEETS_RUNNABLE_KINDS = [
-  { ...googleSheetsRowKind, executor: googleSheetsRowExecutor }
+  { ...googleSheetsRowKind, executor: googleSheetsRowExecutor },
+  { ...googleSheetsValuesGetKind, executor: googleSheetsValuesGetExecutor },
+  { ...googleSheetsValuesUpdateKind, executor: googleSheetsValuesUpdateExecutor }
 ];
 
-export { GOOGLE_SHEETS_RUNNABLE_KINDS, googleSheetsRowExecutor };
+export { GOOGLE_SHEETS_RUNNABLE_KINDS, googleSheetsRowExecutor, googleSheetsValuesGetExecutor, googleSheetsValuesUpdateExecutor };
 //# sourceMappingURL=flow.js.map
 //# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAoCO,IAAM,uBAAA,GAAwC,OAAO,GAAA,KAAQ;AAClE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,qBAAA,CAAsB;AAAA,IACzC,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,yBAAA,EAA6B,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC1F,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,4BAAA,GAAqD;AAAA,EAChE,EAAE,GAAG,mBAAA,EAAqB,QAAA,EAAU,uBAAA;AACtC","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-sheets-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"./service.js\";\n\nimport {\n  googleSheetsRowKind,\n} from \"@particle-academy/google-sheets-ui\";\n\nimport { googleSheetsRowAppend } from \"./actions/row-append.js\";\n\nexport const googleSheetsRowExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsRowAppend({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets row_append ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SHEETS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSheetsRowKind, executor: googleSheetsRowExecutor },\n];\n"]}
+{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAwCO,IAAM,uBAAA,GAAwC,OAAO,GAAA,KAAQ;AAClE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,qBAAA,CAAsB;AAAA,IACzC,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,yBAAA,EAA6B,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC1F,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAEO,IAAM,6BAAA,GAA8C,OAAO,GAAA,KAAQ;AACxE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,qBAAA,CAAsB;AAAA,IACzC,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,yBAAA,EAA6B,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC1F,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAEO,IAAM,gCAAA,GAAiD,OAAO,GAAA,KAAQ;AAC3E,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,wBAAA,CAAyB;AAAA,IAC5C,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,4BAAA,EAAgC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC7F,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,4BAAA,GAAqD;AAAA,EAChE,EAAE,GAAG,mBAAA,EAAqB,QAAA,EAAU,uBAAA,EAAwB;AAAA,EAC5D,EAAE,GAAG,yBAAA,EAA2B,QAAA,EAAU,6BAAA,EAA8B;AAAA,EACxE,EAAE,GAAG,4BAAA,EAA8B,QAAA,EAAU,gCAAA;AAC/C","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-sheets-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"./service.js\";\n\nimport {\n  googleSheetsRowKind,\n  googleSheetsValuesGetKind,\n  googleSheetsValuesUpdateKind,\n} from \"@particle-academy/google-sheets-ui\";\n\nimport { googleSheetsRowAppend } from \"./actions/row-append.js\";\nimport { googleSheetsValuesGet } from \"./actions/values-get.js\";\nimport { googleSheetsValuesUpdate } from \"./actions/values-update.js\";\n\nexport const googleSheetsRowExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsRowAppend({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets row_append ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleSheetsValuesGetExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsValuesGet({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets values_get ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleSheetsValuesUpdateExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSheetsValuesUpdate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_sheets values_update ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SHEETS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSheetsRowKind, executor: googleSheetsRowExecutor },\n  { ...googleSheetsValuesGetKind, executor: googleSheetsValuesGetExecutor },\n  { ...googleSheetsValuesUpdateKind, executor: googleSheetsValuesUpdateExecutor },\n];\n"]}

package/dist/index.cjs

@@ -17,10 +17,42 @@ function fakeRowAppend({ config, fake }) {
     }
   };
 }
+function fakeValuesGet({ config, fake }) {
+  return {
+    "range": config.range !== void 0 && config.range !== null && config.range !== "" ? String(config.range) : "Sheet1!A1:C2",
+    "majorDimension": config.majorDimension !== void 0 && config.majorDimension !== null && config.majorDimension !== "" ? String(config.majorDimension) : "ROWS",
+    "values": [
+      [
+        "Name",
+        "Email",
+        "Status"
+      ],
+      [
+        "Ada Lovelace",
+        "ada@example.test",
+        "Active"
+      ]
+    ]
+  };
+}
+function fakeValuesUpdate({ config, fake }) {
+  const boundSpreadsheetid = config.spreadsheetId !== void 0 && config.spreadsheetId !== null && config.spreadsheetId !== "" ? String(config.spreadsheetId) : fake.id("1Sheet");
+  return {
+    "spreadsheetId": boundSpreadsheetid,
+    "updatedRange": config.range !== void 0 && config.range !== null && config.range !== "" ? String(config.range) : "Sheet1!A1",
+    "updatedRows": 1,
+    "updatedColumns": 3,
+    "updatedCells": 3
+  };
+}
 var googleSheetsFaker = (operation, request) => {
   switch (operation) {
     case "row_append":
       return fakeRowAppend(request);
+    case "values_get":
+      return fakeValuesGet(request);
+    case "values_update":
+      return fakeValuesUpdate(request);
     default:
       throw new Error(
         `google_sheets: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
@@ -89,14 +121,86 @@ function valuesList(value) {
   const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
   return items.map((item) => item.trim()).filter(Boolean);
 }
+var VALUES_GET_OPERATION = "values_get";
+async function googleSheetsValuesGet(options) {
+  const config = options.config ?? {};
+  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
+    throw new Error(`values_get: "spreadsheetId" is required (Spreadsheet ID).`);
+  }
+  if (config.range === void 0 || config.range === null || config.range === "") {
+    throw new Error(`values_get: "range" is required (Range).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_SHEETS, {
+    operation: VALUES_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,
+      query: {
+        ...config.valueRenderOption !== void 0 && config.valueRenderOption !== null && config.valueRenderOption !== "" ? { "valueRenderOption": String(config.valueRenderOption) } : {},
+        ...config.majorDimension !== void 0 && config.majorDimension !== null && config.majorDimension !== "" ? { "majorDimension": String(config.majorDimension) } : {}
+      }
+    }
+  });
+}
+var VALUES_UPDATE_OPERATION = "values_update";
+async function googleSheetsValuesUpdate(options) {
+  const config = options.config ?? {};
+  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
+    throw new Error(`values_update: "spreadsheetId" is required (Spreadsheet ID).`);
+  }
+  if (config.range === void 0 || config.range === null || config.range === "") {
+    throw new Error(`values_update: "range" is required (Range).`);
+  }
+  if (config.values === void 0 || config.values === null || config.values === "") {
+    throw new Error(`values_update: "values" is required (Row values).`);
+  }
+  if (config.valueInputOption === void 0 || config.valueInputOption === null || config.valueInputOption === "") {
+    throw new Error(`values_update: "valueInputOption" is required (How to interpret the values).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_SHEETS, {
+    operation: VALUES_UPDATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "PUT",
+      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,
+      json: {
+        "values": [valuesList2(config.values)]
+      },
+      query: {
+        "valueInputOption": String(config.valueInputOption)
+      }
+    }
+  });
+}
+function valuesList2(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
 
 exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
 exports.GOOGLE_SHEETS = GOOGLE_SHEETS;
 exports.GOOGLE_SHEETS_BASE_URLS = GOOGLE_SHEETS_BASE_URLS;
 exports.GOOGLE_SHEETS_REQUIRES = GOOGLE_SHEETS_REQUIRES;
 exports.ROW_APPEND_OPERATION = ROW_APPEND_OPERATION;
+exports.VALUES_GET_OPERATION = VALUES_GET_OPERATION;
+exports.VALUES_UPDATE_OPERATION = VALUES_UPDATE_OPERATION;
 exports.googleSheetsAuthorize = googleSheetsAuthorize;
 exports.googleSheetsFaker = googleSheetsFaker;
 exports.googleSheetsRowAppend = googleSheetsRowAppend;
+exports.googleSheetsValuesGet = googleSheetsValuesGet;
+exports.googleSheetsValuesUpdate = googleSheetsValuesUpdate;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/row-append.ts"],"names":["callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * The Google Sheets faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Sheets actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeRowAppend({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"tableRange\": \"Sheet1!A1:D4\",\n    \"updates\": {\n      \"spreadsheetId\": boundSpreadsheetid,\n      \"updatedRange\": \"Sheet1!A5:D5\",\n      \"updatedRows\": 1,\n      \"updatedColumns\": 4,\n      \"updatedCells\": 4,\n    },\n  };\n}\n\nexport const googleSheetsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"row_append\":\n      return fakeRowAppend(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_sheets: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets, as one service descriptor shared by every Google Sheets\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Sheets: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Sheets. A test spreadsheet is a real one in a real\n * Drive, so every append is real -- point this at a scratch sheet, not a\n * production one. The faker is the only way to develop against it without\n * touching a document.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSheetsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SHEETS_BASE_URLS = {\n  \"live\": \"https://sheets.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SHEETS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Sheets's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSheetsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Sheets service, for the TypeScript runtime. */\nexport const GOOGLE_SHEETS: ServiceDescriptor = {\n  service: \"google_sheets\",\n  title: \"Google Sheets\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },\n  requires: [...GOOGLE_SHEETS_REQUIRES],\n  authorize: googleSheetsAuthorize,\n  faker: googleSheetsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/row-append.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/row-append.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Append a row to a Google Sheet.\n *\n * POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append —\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const ROW_APPEND_OPERATION = \"row_append\";\n\nexport type RowAppendOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption, insertDataOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`row_append: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`row_append: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`row_append: \"values\" is required (Row values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: ROW_APPEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        ...(config.valueInputOption !== undefined && config.valueInputOption !== null && config.valueInputOption !== \"\" ? { \"valueInputOption\": String(config.valueInputOption) } : {}),\n        ...(config.insertDataOption !== undefined && config.insertDataOption !== null && config.insertDataOption !== \"\" ? { \"insertDataOption\": String(config.insertDataOption) } : {}),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n"]}
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/row-append.ts","../src/actions/values-get.ts","../src/actions/values-update.ts"],"names":["callConnector","valuesList"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * The Google Sheets faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Sheets actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeRowAppend({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"tableRange\": \"Sheet1!A1:D4\",\n    \"updates\": {\n      \"spreadsheetId\": boundSpreadsheetid,\n      \"updatedRange\": \"Sheet1!A5:D5\",\n      \"updatedRows\": 1,\n      \"updatedColumns\": 4,\n      \"updatedCells\": 4,\n    },\n  };\n}\n\nfunction fakeValuesGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"range\": (config.range !== undefined && config.range !== null && config.range !== \"\" ? String(config.range) : \"Sheet1!A1:C2\"),\n    \"majorDimension\": (config.majorDimension !== undefined && config.majorDimension !== null && config.majorDimension !== \"\" ? String(config.majorDimension) : \"ROWS\"),\n    \"values\": [\n      [\n        \"Name\",\n        \"Email\",\n        \"Status\",\n      ],\n      [\n        \"Ada Lovelace\",\n        \"ada@example.test\",\n        \"Active\",\n      ],\n    ],\n  };\n}\n\nfunction fakeValuesUpdate({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"updatedRange\": (config.range !== undefined && config.range !== null && config.range !== \"\" ? String(config.range) : \"Sheet1!A1\"),\n    \"updatedRows\": 1,\n    \"updatedColumns\": 3,\n    \"updatedCells\": 3,\n  };\n}\n\nexport const googleSheetsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"row_append\":\n      return fakeRowAppend(request);\n\n    case \"values_get\":\n      return fakeValuesGet(request);\n\n    case \"values_update\":\n      return fakeValuesUpdate(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_sheets: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets, as one service descriptor shared by every Google Sheets\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Sheets: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Sheets. A test spreadsheet is a real one in a real\n * Drive, so every append is real -- point this at a scratch sheet, not a\n * production one. The faker is the only way to develop against it without\n * touching a document.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSheetsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SHEETS_BASE_URLS = {\n  \"live\": \"https://sheets.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SHEETS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Sheets's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSheetsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Sheets service, for the TypeScript runtime. */\nexport const GOOGLE_SHEETS: ServiceDescriptor = {\n  service: \"google_sheets\",\n  title: \"Google Sheets\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },\n  requires: [...GOOGLE_SHEETS_REQUIRES],\n  authorize: googleSheetsAuthorize,\n  faker: googleSheetsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/row-append.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/row-append.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Append a row to a Google Sheet.\n *\n * POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append —\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const ROW_APPEND_OPERATION = \"row_append\";\n\nexport type RowAppendOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption, insertDataOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`row_append: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`row_append: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`row_append: \"values\" is required (Row values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: ROW_APPEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        ...(config.valueInputOption !== undefined && config.valueInputOption !== null && config.valueInputOption !== \"\" ? { \"valueInputOption\": String(config.valueInputOption) } : {}),\n        ...(config.insertDataOption !== undefined && config.insertDataOption !== null && config.insertDataOption !== \"\" ? { \"insertDataOption\": String(config.insertDataOption) } : {}),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/values-get.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/values-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Read the cell values of a range.\n *\n * GET /v4/spreadsheets/{spreadsheetId}/values/{range} —\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const VALUES_GET_OPERATION = \"values_get\";\n\nexport type ValuesGetOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, valueRenderOption, majorDimension. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsValuesGet(options: ValuesGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`values_get: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`values_get: \"range\" is required (Range).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: VALUES_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,\n      query: {\n        ...(config.valueRenderOption !== undefined && config.valueRenderOption !== null && config.valueRenderOption !== \"\" ? { \"valueRenderOption\": String(config.valueRenderOption) } : {}),\n        ...(config.majorDimension !== undefined && config.majorDimension !== null && config.majorDimension !== \"\" ? { \"majorDimension\": String(config.majorDimension) } : {}),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/values-update.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/values-update.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Overwrite the cell values of a range. Existing values in that range are\n * replaced, not pushed down.\n *\n * PUT /v4/spreadsheets/{spreadsheetId}/values/{range} —\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const VALUES_UPDATE_OPERATION = \"values_update\";\n\nexport type ValuesUpdateOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsValuesUpdate(options: ValuesUpdateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`values_update: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`values_update: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`values_update: \"values\" is required (Row values).`);\n  }\n\n  if (config.valueInputOption === undefined || config.valueInputOption === null || config.valueInputOption === \"\") {\n    throw new Error(`values_update: \"valueInputOption\" is required (How to interpret the values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: VALUES_UPDATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"PUT\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        \"valueInputOption\": String(config.valueInputOption),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n"]}

package/dist/index.d.cts

@@ -115,4 +115,77 @@ type RowAppendOptions = {
 };
 declare function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult>;
 
-export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, type RowAppendOptions, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend };
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/values-get.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/values-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_sheets
+ */
+/**
+ * Read the cell values of a range.
+ *
+ * GET /v4/spreadsheets/{spreadsheetId}/values/{range} —
+ * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Sheets or calls the
+ * faker.
+ */
+
+declare const VALUES_GET_OPERATION = "values_get";
+type ValuesGetOptions = {
+    /** The node's resolved config. Keys: spreadsheetId, range, valueRenderOption, majorDimension. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleSheetsValuesGet(options: ValuesGetOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/values-update.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/values-update.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_sheets
+ */
+/**
+ * Overwrite the cell values of a range. Existing values in that range are
+ * replaced, not pushed down.
+ *
+ * PUT /v4/spreadsheets/{spreadsheetId}/values/{range} —
+ * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Sheets or calls the
+ * faker.
+ */
+
+declare const VALUES_UPDATE_OPERATION = "values_update";
+type ValuesUpdateOptions = {
+    /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleSheetsValuesUpdate(options: ValuesUpdateOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, type RowAppendOptions, VALUES_GET_OPERATION, VALUES_UPDATE_OPERATION, type ValuesGetOptions, type ValuesUpdateOptions, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend, googleSheetsValuesGet, googleSheetsValuesUpdate };

package/dist/index.d.ts

@@ -115,4 +115,77 @@ type RowAppendOptions = {
 };
 declare function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult>;
 
-export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, type RowAppendOptions, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend };
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/values-get.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/values-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_sheets
+ */
+/**
+ * Read the cell values of a range.
+ *
+ * GET /v4/spreadsheets/{spreadsheetId}/values/{range} —
+ * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Sheets or calls the
+ * faker.
+ */
+
+declare const VALUES_GET_OPERATION = "values_get";
+type ValuesGetOptions = {
+    /** The node's resolved config. Keys: spreadsheetId, range, valueRenderOption, majorDimension. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleSheetsValuesGet(options: ValuesGetOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/values-update.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/values-update.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_sheets
+ */
+/**
+ * Overwrite the cell values of a range. Existing values in that range are
+ * replaced, not pushed down.
+ *
+ * PUT /v4/spreadsheets/{spreadsheetId}/values/{range} —
+ * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Sheets or calls the
+ * faker.
+ */
+
+declare const VALUES_UPDATE_OPERATION = "values_update";
+type ValuesUpdateOptions = {
+    /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleSheetsValuesUpdate(options: ValuesUpdateOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, type RowAppendOptions, VALUES_GET_OPERATION, VALUES_UPDATE_OPERATION, type ValuesGetOptions, type ValuesUpdateOptions, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend, googleSheetsValuesGet, googleSheetsValuesUpdate };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend } from './chunk-7AZ3XUFX.js';
+export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, VALUES_GET_OPERATION, VALUES_UPDATE_OPERATION, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend, googleSheetsValuesGet, googleSheetsValuesUpdate } from './chunk-L2NNYKEK.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/google-sheets-js",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "Google Sheets for Node — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP on @particle-academy/fancy-connector-core; no vendor SDK.",
   "repository": {
     "type": "git",
@@ -38,6 +38,7 @@
   },
   "files": [
     "dist",
+    "art",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -53,7 +54,7 @@
   },
   "peerDependencies": {
     "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
-    "@particle-academy/google-sheets-ui": ">=0.3.0 <0.4.0"
+    "@particle-academy/google-sheets-ui": ">=0.4.0 <0.5.0"
   },
   "peerDependenciesMeta": {
     "@particle-academy/fancy-flow": {

package/dist/chunk-7AZ3XUFX.js

@@ -1,93 +0,0 @@
-import { callConnector } from '@particle-academy/fancy-connector-core';
-
-// src/faker.ts
-function fakeRowAppend({ config, fake }) {
-  const boundSpreadsheetid = config.spreadsheetId !== void 0 && config.spreadsheetId !== null && config.spreadsheetId !== "" ? String(config.spreadsheetId) : fake.id("1Sheet");
-  return {
-    "spreadsheetId": boundSpreadsheetid,
-    "tableRange": "Sheet1!A1:D4",
-    "updates": {
-      "spreadsheetId": boundSpreadsheetid,
-      "updatedRange": "Sheet1!A5:D5",
-      "updatedRows": 1,
-      "updatedColumns": 4,
-      "updatedCells": 4
-    }
-  };
-}
-var googleSheetsFaker = (operation, request) => {
-  switch (operation) {
-    case "row_append":
-      return fakeRowAppend(request);
-    default:
-      throw new Error(
-        `google_sheets: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
-      );
-  }
-};
-
-// src/service.ts
-var CONNECTOR_API_VERSION = 1;
-var GOOGLE_SHEETS_BASE_URLS = {
-  "live": "https://sheets.googleapis.com"
-};
-var GOOGLE_SHEETS_REQUIRES = [
-  "accessToken",
-  "refreshToken",
-  "clientId",
-  "clientSecret"
-];
-function googleSheetsAuthorize(credentials, request, _mode) {
-  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
-}
-var GOOGLE_SHEETS = {
-  service: "google_sheets",
-  title: "Google Sheets",
-  sandbox: "none",
-  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },
-  requires: [...GOOGLE_SHEETS_REQUIRES],
-  authorize: googleSheetsAuthorize,
-  faker: googleSheetsFaker
-};
-var ROW_APPEND_OPERATION = "row_append";
-async function googleSheetsRowAppend(options) {
-  const config = options.config ?? {};
-  if (config.spreadsheetId === void 0 || config.spreadsheetId === null || config.spreadsheetId === "") {
-    throw new Error(`row_append: "spreadsheetId" is required (Spreadsheet ID).`);
-  }
-  if (config.range === void 0 || config.range === null || config.range === "") {
-    throw new Error(`row_append: "range" is required (Range).`);
-  }
-  if (config.values === void 0 || config.values === null || config.values === "") {
-    throw new Error(`row_append: "values" is required (Row values).`);
-  }
-  return callConnector(GOOGLE_SHEETS, {
-    operation: ROW_APPEND_OPERATION,
-    config,
-    input: options.input,
-    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
-    ...options.mode === void 0 ? {} : { mode: options.mode },
-    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
-    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
-    ...options.transport === void 0 ? {} : { transport: options.transport },
-    request: {
-      method: "POST",
-      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,
-      json: {
-        "values": [valuesList(config.values)]
-      },
-      query: {
-        ...config.valueInputOption !== void 0 && config.valueInputOption !== null && config.valueInputOption !== "" ? { "valueInputOption": String(config.valueInputOption) } : {},
-        ...config.insertDataOption !== void 0 && config.insertDataOption !== null && config.insertDataOption !== "" ? { "insertDataOption": String(config.insertDataOption) } : {}
-      }
-    }
-  });
-}
-function valuesList(value) {
-  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
-  return items.map((item) => item.trim()).filter(Boolean);
-}
-
-export { CONNECTOR_API_VERSION, GOOGLE_SHEETS, GOOGLE_SHEETS_BASE_URLS, GOOGLE_SHEETS_REQUIRES, ROW_APPEND_OPERATION, googleSheetsAuthorize, googleSheetsFaker, googleSheetsRowAppend };
-//# sourceMappingURL=chunk-7AZ3XUFX.js.map
-//# sourceMappingURL=chunk-7AZ3XUFX.js.map

package/dist/chunk-7AZ3XUFX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/row-append.ts"],"names":[],"mappings":";;;AA0BA,SAAS,aAAA,CAAc,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AAC7D,EAAA,MAAM,qBAAsB,MAAA,CAAO,aAAA,KAAkB,MAAA,IAAa,MAAA,CAAO,kBAAkB,IAAA,IAAQ,MAAA,CAAO,aAAA,KAAkB,EAAA,GAAK,OAAO,MAAA,CAAO,aAAa,CAAA,GAAI,IAAA,CAAK,GAAG,QAAQ,CAAA;AAEhL,EAAA,OAAO;AAAA,IACL,eAAA,EAAiB,kBAAA;AAAA,IACjB,YAAA,EAAc,cAAA;AAAA,IACd,SAAA,EAAW;AAAA,MACT,eAAA,EAAiB,kBAAA;AAAA,MACjB,cAAA,EAAgB,cAAA;AAAA,MAChB,aAAA,EAAe,CAAA;AAAA,MACf,gBAAA,EAAkB,CAAA;AAAA,MAClB,cAAA,EAAgB;AAAA;AAClB,GACF;AACF;AAEO,IAAM,iBAAA,GAAoC,CAAC,SAAA,EAAW,OAAA,KAAY;AACvE,EAAA,QAAQ,SAAA;AAAW,IACjB,KAAK,YAAA;AACH,MAAA,OAAO,cAAc,OAAO,CAAA;AAAA,IAE9B;AAIE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,mDAAmD,SAAS,CAAA,iJAAA;AAAA,OAG9D;AAAA;AAEN;;;ACnBO,IAAM,qBAAA,GAAwB;AAE9B,IAAM,uBAAA,GAA0B;AAAA,EACrC,MAAA,EAAQ;AACV;AAGO,IAAM,sBAAA,GAAyB;AAAA,EACpC,aAAA;AAAA,EACA,cAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAWO,SAAS,qBAAA,CACd,WAAA,EACA,OAAA,EACA,KAAA,EACM;AACN,EAAA,OAAA,CAAQ,OAAA,CAAQ,aAAA,GAAgB,CAAA,OAAA,EAAU,WAAA,CAAY,eAAe,EAAE,CAAA,CAAA;AACzE;AAGO,IAAM,aAAA,GAAmC;AAAA,EAC9C,OAAA,EAAS,eAAA;AAAA,EACT,KAAA,EAAO,eAAA;AAAA,EACP,OAAA,EAAS,MAAA;AAAA,EACT,QAAA,EAAU,EAAE,GAAG,uBAAA,EAAwB;AAAA,EACvC,QAAA,EAAU,CAAC,GAAG,sBAAsB,CAAA;AAAA,EACpC,SAAA,EAAW,qBAAA;AAAA,EACX,KAAA,EAAO;AACT;AC7CO,IAAM,oBAAA,GAAuB;AAcpC,eAAsB,sBAAsB,OAAA,EAAqD;AAC/F,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,kBAAkB,MAAA,IAAa,MAAA,CAAO,kBAAkB,IAAA,IAAQ,MAAA,CAAO,kBAAkB,EAAA,EAAI;AACtG,IAAA,MAAM,IAAI,MAAM,CAAA,yDAAA,CAA2D,CAAA;AAAA,EAC7E;AAEA,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,IAAa,MAAA,CAAO,UAAU,IAAA,IAAQ,MAAA,CAAO,UAAU,EAAA,EAAI;AAC9E,IAAA,MAAM,IAAI,MAAM,CAAA,wCAAA,CAA0C,CAAA;AAAA,EAC5D;AAEA,EAAA,IAAI,MAAA,CAAO,WAAW,MAAA,IAAa,MAAA,CAAO,WAAW,IAAA,IAAQ,MAAA,CAAO,WAAW,EAAA,EAAI;AACjF,IAAA,MAAM,IAAI,MAAM,CAAA,8CAAA,CAAgD,CAAA;AAAA,EAClE;AAEA,EAAA,OAAO,cAAc,aAAA,EAAe;AAAA,IAClC,SAAA,EAAW,oBAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,CAAA,iBAAA,EAAoB,kBAAA,CAAmB,MAAA,CAAO,OAAO,aAAa,CAAC,CAAC,CAAA,QAAA,EAAW,kBAAA,CAAmB,MAAA,CAAO,MAAA,CAAO,KAAK,CAAC,CAAC,CAAA,OAAA,CAAA;AAAA,MAC7H,IAAA,EAAM;AAAA,QACJ,QAAA,EAAU,CAAC,UAAA,CAAW,MAAA,CAAO,MAAM,CAAC;AAAA,OACtC;AAAA,MACA,KAAA,EAAO;AAAA,QACL,GAAI,MAAA,CAAO,gBAAA,KAAqB,MAAA,IAAa,MAAA,CAAO,qBAAqB,IAAA,IAAQ,MAAA,CAAO,gBAAA,KAAqB,EAAA,GAAK,EAAE,kBAAA,EAAoB,MAAA,CAAO,OAAO,gBAAgB,CAAA,KAAM,EAAC;AAAA,QAC7K,GAAI,MAAA,CAAO,gBAAA,KAAqB,MAAA,IAAa,MAAA,CAAO,qBAAqB,IAAA,IAAQ,MAAA,CAAO,gBAAA,KAAqB,EAAA,GAAK,EAAE,kBAAA,EAAoB,MAAA,CAAO,OAAO,gBAAgB,CAAA,KAAM;AAAC;AAC/K;AACF,GACD,CAAA;AACH;AAGA,SAAS,WAAW,KAAA,EAA0B;AAC5C,EAAA,MAAM,QAAQ,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAC7B,MAAM,GAAA,CAAI,MAAM,CAAA,GAChB,OAAO,UAAU,QAAA,GACf,KAAA,CAAM,KAAA,CAAM,GAAG,IACf,EAAC;AAEP,EAAA,OAAO,KAAA,CAAM,IAAI,CAAC,IAAA,KAAS,KAAK,IAAA,EAAM,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA;AACxD","file":"chunk-7AZ3XUFX.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * The Google Sheets faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Sheets actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeRowAppend({ config, fake }: FakeRequest): unknown {\n  const boundSpreadsheetid = (config.spreadsheetId !== undefined && config.spreadsheetId !== null && config.spreadsheetId !== \"\" ? String(config.spreadsheetId) : fake.id(\"1Sheet\"));\n\n  return {\n    \"spreadsheetId\": boundSpreadsheetid,\n    \"tableRange\": \"Sheet1!A1:D4\",\n    \"updates\": {\n      \"spreadsheetId\": boundSpreadsheetid,\n      \"updatedRange\": \"Sheet1!A5:D5\",\n      \"updatedRows\": 1,\n      \"updatedColumns\": 4,\n      \"updatedCells\": 4,\n    },\n  };\n}\n\nexport const googleSheetsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"row_append\":\n      return fakeRowAppend(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_sheets: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Google Sheets, as one service descriptor shared by every Google Sheets\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Sheets: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for Sheets. A test spreadsheet is a real one in a real\n * Drive, so every append is real -- point this at a scratch sheet, not a\n * production one. The faker is the only way to develop against it without\n * touching a document.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSheetsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SHEETS_BASE_URLS = {\n  \"live\": \"https://sheets.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SHEETS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Sheets's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSheetsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Sheets service, for the TypeScript runtime. */\nexport const GOOGLE_SHEETS: ServiceDescriptor = {\n  service: \"google_sheets\",\n  title: \"Google Sheets\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SHEETS_BASE_URLS },\n  requires: [...GOOGLE_SHEETS_REQUIRES],\n  authorize: googleSheetsAuthorize,\n  faker: googleSheetsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/row-append.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/row-append.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_sheets\n */\n\n/**\n * Append a row to a Google Sheet.\n *\n * POST /v4/spreadsheets/{spreadsheetId}/values/{range}:append —\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Sheets or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SHEETS } from \"../service.js\";\n\nexport const ROW_APPEND_OPERATION = \"row_append\";\n\nexport type RowAppendOptions = {\n  /** The node's resolved config. Keys: spreadsheetId, range, values, valueInputOption, insertDataOption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSheetsRowAppend(options: RowAppendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.spreadsheetId === undefined || config.spreadsheetId === null || config.spreadsheetId === \"\") {\n    throw new Error(`row_append: \"spreadsheetId\" is required (Spreadsheet ID).`);\n  }\n\n  if (config.range === undefined || config.range === null || config.range === \"\") {\n    throw new Error(`row_append: \"range\" is required (Range).`);\n  }\n\n  if (config.values === undefined || config.values === null || config.values === \"\") {\n    throw new Error(`row_append: \"values\" is required (Row values).`);\n  }\n\n  return callConnector(GOOGLE_SHEETS, {\n    operation: ROW_APPEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v4/spreadsheets/${encodeURIComponent(String(config.spreadsheetId))}/values/${encodeURIComponent(String(config.range))}:append`,\n      json: {\n        \"values\": [valuesList(config.values)],\n      },\n      query: {\n        ...(config.valueInputOption !== undefined && config.valueInputOption !== null && config.valueInputOption !== \"\" ? { \"valueInputOption\": String(config.valueInputOption) } : {}),\n        ...(config.insertDataOption !== undefined && config.insertDataOption !== null && config.insertDataOption !== \"\" ? { \"insertDataOption\": String(config.insertDataOption) } : {}),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction valuesList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n"]}