@particle-academy/google-sheets-ui 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -8,6 +8,52 @@ 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.6.0] — 2026-11-08
+
+### Added
+
+- **One Google consent grant, shared by every Google connector** (`oauth.grant:
+  "google"`), for an org-level Google connection: one OAuth client, one consent
+  and one refresh token per person, with each feature's scopes asked for when it
+  is first used. Declared in the manifest, the `-ui` package's OAuth constant,
+  the README and the registry index:
+  - `authorizeParams`: `access_type=offline` and `include_granted_scopes=true`.
+    A refresh token comes back only on the FIRST code exchange, so keep the stored
+    one when an exchange returns none.
+  - `revoke`: POST `https://oauth2.googleapis.com/revoke` with `token`, and
+    `scope: "grant"`. **Revoking removes the person's WHOLE Google grant, every
+    Google connector**, so a per-feature disconnect stops using that feature's
+    scopes locally and only a full Google disconnect revokes.
+  - `identity`: identify the account by the id_token's `sub` (request `openid`;
+    issuer `https://accounts.google.com` or `accounts.google.com`; audience is
+    the `clientId`), never by email, which Google says is neither unique nor
+    permanent.
+  `restrictedScopes` is empty: none of this connector's scopes is restricted.
+
+  Nothing a request sends has changed; this is what a host needs to run the
+  connection.
+
+## [0.5.0] — 2026-11-08
+
+### Added
+
+- **Laravel integration, in this package** (`src/Laravel/`), auto-discovered
+  through composer's `extra.laravel`. Laravel is SUGGESTED, never required:
+  outside a Laravel app none of it loads.
+  - a service provider that merges `config/google-sheets.php` under
+    `connectors.google-sheets` (credentials from the environment, or per call for a
+    multi-account app);
+  - the `GoogleSheets` facade: `GoogleSheets::call('<operation>', [...])` runs any action;
+  - `GoogleSheets::fake()`, answered from the connector's faker, with
+    `assertSent` / `assertNotSent` / `assertNothingSent` / `assertSentCount`;
+  - its own Pest test of all of it against a booted Laravel app.
+
+### Changed
+
+- **Tests: Pest `^5`**, and `laravel/framework` `^13` as a DEV-ONLY test
+  dependency (the framework this package integrates with; nothing ships in
+  `require`).
+
 ## [0.4.0] — 2026-10-01
 
 ### Added

package/README.md

@@ -55,6 +55,13 @@ Google Sheets uses OAuth2 (authorization_code). The package DECLARES the exchang
 - **Scopes** — `https://www.googleapis.com/auth/spreadsheets`
 - **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
 
+**One consent grant, shared** (`grant: "google"`). Every connector declaring the same grant can run on ONE OAuth client, with one consent and one refresh token per person.
+
+- **Authorize with** `access_type=offline`, `include_granted_scopes=true`. Ask for a feature's scopes when it is first used; the new token covers every scope granted before. A refresh token comes back only on the FIRST exchange, so keep the stored one when an exchange returns none.
+- **Revoke** — POST https://oauth2.googleapis.com/revoke with `token`. **It removes the WHOLE grant**: every connector sharing it, not only this one. A per-feature disconnect stops using that feature's scopes locally; only a full disconnect revokes.
+- **Identify the account by `sub`**: request `openid`, then verify the token response's id_token (issuer `https://accounts.google.com` or `accounts.google.com`, keys at https://www.googleapis.com/oauth2/v3/certs, audience = `clientId`). Never key a connection by email.
+- **No restricted scopes** in this connector.
+
 The refresh tokens do **not** rotate: the same one is reusable, so a refresh may safely be retried and may run concurrently. Stated rather than assumed, because the opposite — a provider that spends the token and revokes the grant on a replay — looks identical until it happens.
 
 ### The estate

package/dist/index.cjs

@@ -50,7 +50,28 @@ var GOOGLE_SHEETS_OAUTH = {
   "accessTokenCredential": "accessToken",
   "refreshTokenCredential": "refreshToken",
   "refreshTokenRotates": false,
-  "accessTokenTtlSeconds": 3600
+  "accessTokenTtlSeconds": 3600,
+  "grant": "google",
+  "authorizeParams": {
+    "access_type": "offline",
+    "include_granted_scopes": "true"
+  },
+  "revoke": {
+    "url": "https://oauth2.googleapis.com/revoke",
+    "param": "token",
+    "scope": "grant"
+  },
+  "identity": {
+    "scope": "openid",
+    "claim": "sub",
+    "issuers": [
+      "https://accounts.google.com",
+      "accounts.google.com"
+    ],
+    "jwksUrl": "https://www.googleapis.com/oauth2/v3/certs",
+    "audienceCredential": "clientId"
+  },
+  "restrictedScopes": []
 };
 function googleSheetsMeta(role, operation, docs) {
   return { ...GOOGLE_SHEETS_SERVICE, role, operation, docs };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/service.ts","../src/kinds/row-append.ts","../src/kinds/values-get.ts","../src/kinds/values-update.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\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's identity on the authoring surface, shared by every Google\n * Sheets node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\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 { ConnectorDomain, ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\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.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const GOOGLE_SHEETS_SERVICE = {\n  service: \"google_sheets\",\n  serviceTitle: \"Google Sheets\",\n  domain: \"productivity\",\n  sandbox: \"none\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/**\n * Every connector domain weaver knows, pinned against fancy-flow's union.\n *\n * A closed set copied into three codebases stays correct only while something\n * MAKES it: this line fails to compile the moment weaver carries a value\n * fancy-flow does not, including the values no provider uses yet.\n */\nconst WEAVER_DOMAINS: readonly ConnectorDomain[] = [\n  \"payments\",\n  \"commerce\",\n  \"messaging\",\n  \"email\",\n  \"crm\",\n  \"support\",\n  \"storage\",\n  \"calendar\",\n  \"productivity\",\n  \"database\",\n  \"devtools\",\n  \"analytics\",\n  \"marketing\",\n  \"ai\",\n  \"forms\",\n  \"hr\",\n  \"geo\"\n];\nvoid WEAVER_DOMAINS;\n\n/** The credentials a Google Sheets connection holds. */\nexport const GOOGLE_SHEETS_CREDENTIALS = [\n  {\n    \"key\": \"clientId\",\n    \"label\": \"OAuth client ID\",\n    \"scope\": \"provider\",\n    \"secret\": false,\n    \"help\": \"From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.\"\n  },\n  {\n    \"key\": \"clientSecret\",\n    \"label\": \"OAuth client secret\",\n    \"scope\": \"provider\",\n    \"secret\": true,\n    \"help\": \"The client secret for the same OAuth app. One value for the whole installation.\"\n  },\n  {\n    \"key\": \"accessToken\",\n    \"label\": \"Access token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.\"\n  },\n  {\n    \"key\": \"refreshToken\",\n    \"label\": \"Refresh token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour.\"\n  }\n] as const;\n\n/**\n * The OAuth2 exchange Google Sheets requires — DECLARED here, performed by the\n * host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n *\n * Its refresh tokens do NOT rotate: the same one is reusable, so a refresh may\n * safely be retried and may run concurrently. That is stated rather than\n * assumed because the opposite — a provider that spends the token and revokes\n * the grant on a replay — looks identical until it happens.\n */\nexport const GOOGLE_SHEETS_OAUTH = {\n  \"flow\": \"authorization_code\",\n  \"authorizeUrl\": \"https://accounts.google.com/o/oauth2/v2/auth\",\n  \"tokenUrl\": \"https://oauth2.googleapis.com/token\",\n  \"scopes\": [\n    \"https://www.googleapis.com/auth/spreadsheets\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Sheets node's connector metadata from the operation it performs. */\nexport function googleSheetsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SHEETS_SERVICE, role, operation, docs };\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 * Google Sheets row — Append a row to a Google Sheet.\n *\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * `unsafe-to-replay`.\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_ROW_KIND = \"@particle-academy/google_sheets_row\";\nexport const GOOGLE_SHEETS_ROW_OPERATION = \"row_append\";\n\nexport const GOOGLE_SHEETS_ROW_META = googleSheetsMeta(\"action\", \"append a row\", \"https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_ROW_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation. NOT the range that was asked for -- append finds the first empty row below it.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows were added.\"\n  },\n  {\n    \"path\": \"data.updates.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  }\n];\n\nexport const googleSheetsRowKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_ROW_META, {\n  name: GOOGLE_SHEETS_ROW_KIND,\n  aliases: [\"google_sheets_row\"],\n  label: \"Google Sheets row\",\n  description: \"Append a row to a Google Sheet.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SHEETS_ROW_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"Where to append, in A1 notation. Google finds the last row of this range and writes below it.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells of the row, comma separated. Left to right from the start of the range.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"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.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"insertDataOption\",\n      \"label\": \"When the range already has data below\",\n      \"default\": \"INSERT_ROWS\",\n      \"description\": \"INSERT_ROWS pushes existing rows down. OVERWRITE writes into them.\",\n      \"options\": [\n        {\n          \"value\": \"INSERT_ROWS\",\n          \"label\": \"Insert new rows\"\n        },\n        {\n          \"value\": \"OVERWRITE\",\n          \"label\": \"Overwrite what is there\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_ROW_META, config as Record<string, unknown>, \"append a row\"),\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 Google Sheets values — Read the cell values of a range.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_KIND = \"@particle-academy/google_sheets_values_get\";\nexport const GOOGLE_SHEETS_VALUES_GET_OPERATION = \"values_get\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_META = googleSheetsMeta(\"action\", \"read a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.range\",\n    \"type\": \"string\",\n    \"description\": \"The range actually covered -- may be smaller than what was asked for; Google excludes empty trailing rows and columns.\"\n  },\n  {\n    \"path\": \"data.majorDimension\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was asked, or ROWS by default.\"\n  },\n  {\n    \"path\": \"data.values\",\n    \"type\": \"array\",\n    \"description\": \"Rows of cells -- an array of arrays. One row is [[a, b, c]], the same shape row_append sends. Absent entirely when the range is empty.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesGetKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_GET_META, {\n  name: GOOGLE_SHEETS_VALUES_GET_KIND,\n  aliases: [\"google_sheets_values_get\"],\n  label: \"Read Google Sheets values\",\n  description: \"Read the cell values of a range.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_SHEETS_VALUES_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"In A1 notation, the same shape row_append accepts.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueRenderOption\",\n      \"label\": \"How to render values\",\n      \"default\": \"FORMATTED_VALUE\",\n      \"options\": [\n        {\n          \"value\": \"FORMATTED_VALUE\",\n          \"label\": \"Formatted, as shown in the sheet (e.g. \\\"$1.50\\\", \\\"10/1/2026\\\")\"\n        },\n        {\n          \"value\": \"UNFORMATTED_VALUE\",\n          \"label\": \"The underlying number or string, no formatting applied\"\n        },\n        {\n          \"value\": \"FORMULA\",\n          \"label\": \"The formula text itself, for a cell that has one\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"majorDimension\",\n      \"label\": \"Rows or columns\",\n      \"default\": \"ROWS\",\n      \"description\": \"Whether the outer array of the result is rows or columns.\",\n      \"options\": [\n        {\n          \"value\": \"ROWS\",\n          \"label\": \"Rows\"\n        },\n        {\n          \"value\": \"COLUMNS\",\n          \"label\": \"Columns\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_GET_META, config as Record<string, unknown>, \"read a range\"),\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 * Write Google Sheets values — Overwrite the cell values of a range. Existing\n * values in that range are replaced, not pushed down.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_KIND = \"@particle-academy/google_sheets_values_update\";\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OPERATION = \"values_update\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_META = googleSheetsMeta(\"action\", \"write a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation.\"\n  },\n  {\n    \"path\": \"data.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedColumns\",\n    \"type\": \"number\",\n    \"description\": \"How many columns had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesUpdateKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_UPDATE_META, {\n  name: GOOGLE_SHEETS_VALUES_UPDATE_KIND,\n  aliases: [\"google_sheets_values_update\"],\n  label: \"Write Google Sheets values\",\n  description: \"Overwrite the cell values of a range. Existing values in that range are replaced, not pushed down.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"idempotent\",\n  outputShape: GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A1\",\n      \"description\": \"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.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells to write, comma separated, left to right, one row. For more than one row, call this action once per row.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"required\": true,\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"USER_ENTERED parses the cells the way typing them would -- so =SUM(A1:A2) becomes a formula. RAW stores exactly the characters given.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_UPDATE_META, config as Record<string, unknown>, \"write a range\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/row-append.js\";\nexport * from \"./kinds/values-get.js\";\nexport * from \"./kinds/values-update.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSheetsRowKind } from \"./kinds/row-append.js\";\nimport { googleSheetsValuesGetKind } from \"./kinds/values-get.js\";\nimport { googleSheetsValuesUpdateKind } from \"./kinds/values-update.js\";\n\n/** Every Google Sheets kind, for a host that registers the lot. */\nexport const GOOGLE_SHEETS_KINDS: NodeKindDefinition[] = [\n  googleSheetsRowKind,\n  googleSheetsValuesGetKind,\n  googleSheetsValuesUpdateKind,\n];\n"]}
+{"version":3,"sources":["../src/service.ts","../src/kinds/row-append.ts","../src/kinds/values-get.ts","../src/kinds/values-update.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\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's identity on the authoring surface, shared by every Google\n * Sheets node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\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 { ConnectorDomain, ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\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.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const GOOGLE_SHEETS_SERVICE = {\n  service: \"google_sheets\",\n  serviceTitle: \"Google Sheets\",\n  domain: \"productivity\",\n  sandbox: \"none\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/**\n * Every connector domain weaver knows, pinned against fancy-flow's union.\n *\n * A closed set copied into three codebases stays correct only while something\n * MAKES it: this line fails to compile the moment weaver carries a value\n * fancy-flow does not, including the values no provider uses yet.\n */\nconst WEAVER_DOMAINS: readonly ConnectorDomain[] = [\n  \"payments\",\n  \"commerce\",\n  \"messaging\",\n  \"email\",\n  \"crm\",\n  \"support\",\n  \"storage\",\n  \"calendar\",\n  \"productivity\",\n  \"database\",\n  \"devtools\",\n  \"analytics\",\n  \"marketing\",\n  \"ai\",\n  \"forms\",\n  \"hr\",\n  \"geo\"\n];\nvoid WEAVER_DOMAINS;\n\n/** The credentials a Google Sheets connection holds. */\nexport const GOOGLE_SHEETS_CREDENTIALS = [\n  {\n    \"key\": \"clientId\",\n    \"label\": \"OAuth client ID\",\n    \"scope\": \"provider\",\n    \"secret\": false,\n    \"help\": \"From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.\"\n  },\n  {\n    \"key\": \"clientSecret\",\n    \"label\": \"OAuth client secret\",\n    \"scope\": \"provider\",\n    \"secret\": true,\n    \"help\": \"The client secret for the same OAuth app. One value for the whole installation.\"\n  },\n  {\n    \"key\": \"accessToken\",\n    \"label\": \"Access token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.\"\n  },\n  {\n    \"key\": \"refreshToken\",\n    \"label\": \"Refresh token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour.\"\n  }\n] as const;\n\n/**\n * The OAuth2 exchange Google Sheets requires — DECLARED here, performed by the\n * host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n *\n * Its refresh tokens do NOT rotate: the same one is reusable, so a refresh may\n * safely be retried and may run concurrently. That is stated rather than\n * assumed because the opposite — a provider that spends the token and revokes\n * the grant on a replay — looks identical until it happens.\n *\n * Its consent grant is SHARED with every connector declaring grant \"google\":\n * one OAuth client, one consent and one refresh token per person, scopes added\n * as features are first used (authorizeParams). Revoking removes the WHOLE\n * grant, so only a full disconnect revokes; a per-feature disconnect stops\n * using the scope locally. Identify the account by the id_token's sub, never\n * by email.\n */\nexport const GOOGLE_SHEETS_OAUTH = {\n  \"flow\": \"authorization_code\",\n  \"authorizeUrl\": \"https://accounts.google.com/o/oauth2/v2/auth\",\n  \"tokenUrl\": \"https://oauth2.googleapis.com/token\",\n  \"scopes\": [\n    \"https://www.googleapis.com/auth/spreadsheets\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600,\n  \"grant\": \"google\",\n  \"authorizeParams\": {\n    \"access_type\": \"offline\",\n    \"include_granted_scopes\": \"true\"\n  },\n  \"revoke\": {\n    \"url\": \"https://oauth2.googleapis.com/revoke\",\n    \"param\": \"token\",\n    \"scope\": \"grant\"\n  },\n  \"identity\": {\n    \"scope\": \"openid\",\n    \"claim\": \"sub\",\n    \"issuers\": [\n      \"https://accounts.google.com\",\n      \"accounts.google.com\"\n    ],\n    \"jwksUrl\": \"https://www.googleapis.com/oauth2/v3/certs\",\n    \"audienceCredential\": \"clientId\"\n  },\n  \"restrictedScopes\": []\n} as const;\n\n/** Build a Google Sheets node's connector metadata from the operation it performs. */\nexport function googleSheetsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SHEETS_SERVICE, role, operation, docs };\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 * Google Sheets row — Append a row to a Google Sheet.\n *\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * `unsafe-to-replay`.\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_ROW_KIND = \"@particle-academy/google_sheets_row\";\nexport const GOOGLE_SHEETS_ROW_OPERATION = \"row_append\";\n\nexport const GOOGLE_SHEETS_ROW_META = googleSheetsMeta(\"action\", \"append a row\", \"https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_ROW_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation. NOT the range that was asked for -- append finds the first empty row below it.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows were added.\"\n  },\n  {\n    \"path\": \"data.updates.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  }\n];\n\nexport const googleSheetsRowKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_ROW_META, {\n  name: GOOGLE_SHEETS_ROW_KIND,\n  aliases: [\"google_sheets_row\"],\n  label: \"Google Sheets row\",\n  description: \"Append a row to a Google Sheet.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SHEETS_ROW_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"Where to append, in A1 notation. Google finds the last row of this range and writes below it.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells of the row, comma separated. Left to right from the start of the range.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"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.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"insertDataOption\",\n      \"label\": \"When the range already has data below\",\n      \"default\": \"INSERT_ROWS\",\n      \"description\": \"INSERT_ROWS pushes existing rows down. OVERWRITE writes into them.\",\n      \"options\": [\n        {\n          \"value\": \"INSERT_ROWS\",\n          \"label\": \"Insert new rows\"\n        },\n        {\n          \"value\": \"OVERWRITE\",\n          \"label\": \"Overwrite what is there\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_ROW_META, config as Record<string, unknown>, \"append a row\"),\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 Google Sheets values — Read the cell values of a range.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_KIND = \"@particle-academy/google_sheets_values_get\";\nexport const GOOGLE_SHEETS_VALUES_GET_OPERATION = \"values_get\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_META = googleSheetsMeta(\"action\", \"read a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.range\",\n    \"type\": \"string\",\n    \"description\": \"The range actually covered -- may be smaller than what was asked for; Google excludes empty trailing rows and columns.\"\n  },\n  {\n    \"path\": \"data.majorDimension\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was asked, or ROWS by default.\"\n  },\n  {\n    \"path\": \"data.values\",\n    \"type\": \"array\",\n    \"description\": \"Rows of cells -- an array of arrays. One row is [[a, b, c]], the same shape row_append sends. Absent entirely when the range is empty.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesGetKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_GET_META, {\n  name: GOOGLE_SHEETS_VALUES_GET_KIND,\n  aliases: [\"google_sheets_values_get\"],\n  label: \"Read Google Sheets values\",\n  description: \"Read the cell values of a range.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_SHEETS_VALUES_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"In A1 notation, the same shape row_append accepts.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueRenderOption\",\n      \"label\": \"How to render values\",\n      \"default\": \"FORMATTED_VALUE\",\n      \"options\": [\n        {\n          \"value\": \"FORMATTED_VALUE\",\n          \"label\": \"Formatted, as shown in the sheet (e.g. \\\"$1.50\\\", \\\"10/1/2026\\\")\"\n        },\n        {\n          \"value\": \"UNFORMATTED_VALUE\",\n          \"label\": \"The underlying number or string, no formatting applied\"\n        },\n        {\n          \"value\": \"FORMULA\",\n          \"label\": \"The formula text itself, for a cell that has one\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"majorDimension\",\n      \"label\": \"Rows or columns\",\n      \"default\": \"ROWS\",\n      \"description\": \"Whether the outer array of the result is rows or columns.\",\n      \"options\": [\n        {\n          \"value\": \"ROWS\",\n          \"label\": \"Rows\"\n        },\n        {\n          \"value\": \"COLUMNS\",\n          \"label\": \"Columns\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_GET_META, config as Record<string, unknown>, \"read a range\"),\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 * Write Google Sheets values — Overwrite the cell values of a range. Existing\n * values in that range are replaced, not pushed down.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_KIND = \"@particle-academy/google_sheets_values_update\";\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OPERATION = \"values_update\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_META = googleSheetsMeta(\"action\", \"write a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation.\"\n  },\n  {\n    \"path\": \"data.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedColumns\",\n    \"type\": \"number\",\n    \"description\": \"How many columns had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesUpdateKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_UPDATE_META, {\n  name: GOOGLE_SHEETS_VALUES_UPDATE_KIND,\n  aliases: [\"google_sheets_values_update\"],\n  label: \"Write Google Sheets values\",\n  description: \"Overwrite the cell values of a range. Existing values in that range are replaced, not pushed down.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"idempotent\",\n  outputShape: GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A1\",\n      \"description\": \"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.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells to write, comma separated, left to right, one row. For more than one row, call this action once per row.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"required\": true,\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"USER_ENTERED parses the cells the way typing them would -- so =SUM(A1:A2) becomes a formula. RAW stores exactly the characters given.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_UPDATE_META, config as Record<string, unknown>, \"write a range\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/row-append.js\";\nexport * from \"./kinds/values-get.js\";\nexport * from \"./kinds/values-update.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSheetsRowKind } from \"./kinds/row-append.js\";\nimport { googleSheetsValuesGetKind } from \"./kinds/values-get.js\";\nimport { googleSheetsValuesUpdateKind } from \"./kinds/values-update.js\";\n\n/** Every Google Sheets kind, for a host that registers the lot. */\nexport const GOOGLE_SHEETS_KINDS: NodeKindDefinition[] = [\n  googleSheetsRowKind,\n  googleSheetsValuesGetKind,\n  googleSheetsValuesUpdateKind,\n];\n"]}

package/dist/index.d.cts

@@ -85,6 +85,13 @@ declare const GOOGLE_SHEETS_CREDENTIALS: readonly [{
  * safely be retried and may run concurrently. That is stated rather than
  * assumed because the opposite — a provider that spends the token and revokes
  * the grant on a replay — looks identical until it happens.
+ *
+ * Its consent grant is SHARED with every connector declaring grant "google":
+ * one OAuth client, one consent and one refresh token per person, scopes added
+ * as features are first used (authorizeParams). Revoking removes the WHOLE
+ * grant, so only a full disconnect revokes; a per-feature disconnect stops
+ * using the scope locally. Identify the account by the id_token's sub, never
+ * by email.
  */
 declare const GOOGLE_SHEETS_OAUTH: {
     readonly flow: "authorization_code";
@@ -95,6 +102,24 @@ declare const GOOGLE_SHEETS_OAUTH: {
     readonly refreshTokenCredential: "refreshToken";
     readonly refreshTokenRotates: false;
     readonly accessTokenTtlSeconds: 3600;
+    readonly grant: "google";
+    readonly authorizeParams: {
+        readonly access_type: "offline";
+        readonly include_granted_scopes: "true";
+    };
+    readonly revoke: {
+        readonly url: "https://oauth2.googleapis.com/revoke";
+        readonly param: "token";
+        readonly scope: "grant";
+    };
+    readonly identity: {
+        readonly scope: "openid";
+        readonly claim: "sub";
+        readonly issuers: readonly ["https://accounts.google.com", "accounts.google.com"];
+        readonly jwksUrl: "https://www.googleapis.com/oauth2/v3/certs";
+        readonly audienceCredential: "clientId";
+    };
+    readonly restrictedScopes: readonly [];
 };
 /** Build a Google Sheets node's connector metadata from the operation it performs. */
 declare function googleSheetsMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;

package/dist/index.d.ts

@@ -85,6 +85,13 @@ declare const GOOGLE_SHEETS_CREDENTIALS: readonly [{
  * safely be retried and may run concurrently. That is stated rather than
  * assumed because the opposite — a provider that spends the token and revokes
  * the grant on a replay — looks identical until it happens.
+ *
+ * Its consent grant is SHARED with every connector declaring grant "google":
+ * one OAuth client, one consent and one refresh token per person, scopes added
+ * as features are first used (authorizeParams). Revoking removes the WHOLE
+ * grant, so only a full disconnect revokes; a per-feature disconnect stops
+ * using the scope locally. Identify the account by the id_token's sub, never
+ * by email.
  */
 declare const GOOGLE_SHEETS_OAUTH: {
     readonly flow: "authorization_code";
@@ -95,6 +102,24 @@ declare const GOOGLE_SHEETS_OAUTH: {
     readonly refreshTokenCredential: "refreshToken";
     readonly refreshTokenRotates: false;
     readonly accessTokenTtlSeconds: 3600;
+    readonly grant: "google";
+    readonly authorizeParams: {
+        readonly access_type: "offline";
+        readonly include_granted_scopes: "true";
+    };
+    readonly revoke: {
+        readonly url: "https://oauth2.googleapis.com/revoke";
+        readonly param: "token";
+        readonly scope: "grant";
+    };
+    readonly identity: {
+        readonly scope: "openid";
+        readonly claim: "sub";
+        readonly issuers: readonly ["https://accounts.google.com", "accounts.google.com"];
+        readonly jwksUrl: "https://www.googleapis.com/oauth2/v3/certs";
+        readonly audienceCredential: "clientId";
+    };
+    readonly restrictedScopes: readonly [];
 };
 /** Build a Google Sheets node's connector metadata from the operation it performs. */
 declare function googleSheetsMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;

package/dist/index.js

@@ -48,7 +48,28 @@ var GOOGLE_SHEETS_OAUTH = {
   "accessTokenCredential": "accessToken",
   "refreshTokenCredential": "refreshToken",
   "refreshTokenRotates": false,
-  "accessTokenTtlSeconds": 3600
+  "accessTokenTtlSeconds": 3600,
+  "grant": "google",
+  "authorizeParams": {
+    "access_type": "offline",
+    "include_granted_scopes": "true"
+  },
+  "revoke": {
+    "url": "https://oauth2.googleapis.com/revoke",
+    "param": "token",
+    "scope": "grant"
+  },
+  "identity": {
+    "scope": "openid",
+    "claim": "sub",
+    "issuers": [
+      "https://accounts.google.com",
+      "accounts.google.com"
+    ],
+    "jwksUrl": "https://www.googleapis.com/oauth2/v3/certs",
+    "audienceCredential": "clientId"
+  },
+  "restrictedScopes": []
 };
 function googleSheetsMeta(role, operation, docs) {
   return { ...GOOGLE_SHEETS_SERVICE, role, operation, docs };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/service.ts","../src/kinds/row-append.ts","../src/kinds/values-get.ts","../src/kinds/values-update.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.js","sourcesContent":["/**\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's identity on the authoring surface, shared by every Google\n * Sheets node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\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 { ConnectorDomain, ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\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.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const GOOGLE_SHEETS_SERVICE = {\n  service: \"google_sheets\",\n  serviceTitle: \"Google Sheets\",\n  domain: \"productivity\",\n  sandbox: \"none\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/**\n * Every connector domain weaver knows, pinned against fancy-flow's union.\n *\n * A closed set copied into three codebases stays correct only while something\n * MAKES it: this line fails to compile the moment weaver carries a value\n * fancy-flow does not, including the values no provider uses yet.\n */\nconst WEAVER_DOMAINS: readonly ConnectorDomain[] = [\n  \"payments\",\n  \"commerce\",\n  \"messaging\",\n  \"email\",\n  \"crm\",\n  \"support\",\n  \"storage\",\n  \"calendar\",\n  \"productivity\",\n  \"database\",\n  \"devtools\",\n  \"analytics\",\n  \"marketing\",\n  \"ai\",\n  \"forms\",\n  \"hr\",\n  \"geo\"\n];\nvoid WEAVER_DOMAINS;\n\n/** The credentials a Google Sheets connection holds. */\nexport const GOOGLE_SHEETS_CREDENTIALS = [\n  {\n    \"key\": \"clientId\",\n    \"label\": \"OAuth client ID\",\n    \"scope\": \"provider\",\n    \"secret\": false,\n    \"help\": \"From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.\"\n  },\n  {\n    \"key\": \"clientSecret\",\n    \"label\": \"OAuth client secret\",\n    \"scope\": \"provider\",\n    \"secret\": true,\n    \"help\": \"The client secret for the same OAuth app. One value for the whole installation.\"\n  },\n  {\n    \"key\": \"accessToken\",\n    \"label\": \"Access token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.\"\n  },\n  {\n    \"key\": \"refreshToken\",\n    \"label\": \"Refresh token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour.\"\n  }\n] as const;\n\n/**\n * The OAuth2 exchange Google Sheets requires — DECLARED here, performed by the\n * host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n *\n * Its refresh tokens do NOT rotate: the same one is reusable, so a refresh may\n * safely be retried and may run concurrently. That is stated rather than\n * assumed because the opposite — a provider that spends the token and revokes\n * the grant on a replay — looks identical until it happens.\n */\nexport const GOOGLE_SHEETS_OAUTH = {\n  \"flow\": \"authorization_code\",\n  \"authorizeUrl\": \"https://accounts.google.com/o/oauth2/v2/auth\",\n  \"tokenUrl\": \"https://oauth2.googleapis.com/token\",\n  \"scopes\": [\n    \"https://www.googleapis.com/auth/spreadsheets\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Sheets node's connector metadata from the operation it performs. */\nexport function googleSheetsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SHEETS_SERVICE, role, operation, docs };\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 * Google Sheets row — Append a row to a Google Sheet.\n *\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * `unsafe-to-replay`.\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_ROW_KIND = \"@particle-academy/google_sheets_row\";\nexport const GOOGLE_SHEETS_ROW_OPERATION = \"row_append\";\n\nexport const GOOGLE_SHEETS_ROW_META = googleSheetsMeta(\"action\", \"append a row\", \"https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_ROW_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation. NOT the range that was asked for -- append finds the first empty row below it.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows were added.\"\n  },\n  {\n    \"path\": \"data.updates.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  }\n];\n\nexport const googleSheetsRowKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_ROW_META, {\n  name: GOOGLE_SHEETS_ROW_KIND,\n  aliases: [\"google_sheets_row\"],\n  label: \"Google Sheets row\",\n  description: \"Append a row to a Google Sheet.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SHEETS_ROW_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"Where to append, in A1 notation. Google finds the last row of this range and writes below it.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells of the row, comma separated. Left to right from the start of the range.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"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.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"insertDataOption\",\n      \"label\": \"When the range already has data below\",\n      \"default\": \"INSERT_ROWS\",\n      \"description\": \"INSERT_ROWS pushes existing rows down. OVERWRITE writes into them.\",\n      \"options\": [\n        {\n          \"value\": \"INSERT_ROWS\",\n          \"label\": \"Insert new rows\"\n        },\n        {\n          \"value\": \"OVERWRITE\",\n          \"label\": \"Overwrite what is there\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_ROW_META, config as Record<string, unknown>, \"append a row\"),\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 Google Sheets values — Read the cell values of a range.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_KIND = \"@particle-academy/google_sheets_values_get\";\nexport const GOOGLE_SHEETS_VALUES_GET_OPERATION = \"values_get\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_META = googleSheetsMeta(\"action\", \"read a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.range\",\n    \"type\": \"string\",\n    \"description\": \"The range actually covered -- may be smaller than what was asked for; Google excludes empty trailing rows and columns.\"\n  },\n  {\n    \"path\": \"data.majorDimension\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was asked, or ROWS by default.\"\n  },\n  {\n    \"path\": \"data.values\",\n    \"type\": \"array\",\n    \"description\": \"Rows of cells -- an array of arrays. One row is [[a, b, c]], the same shape row_append sends. Absent entirely when the range is empty.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesGetKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_GET_META, {\n  name: GOOGLE_SHEETS_VALUES_GET_KIND,\n  aliases: [\"google_sheets_values_get\"],\n  label: \"Read Google Sheets values\",\n  description: \"Read the cell values of a range.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_SHEETS_VALUES_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"In A1 notation, the same shape row_append accepts.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueRenderOption\",\n      \"label\": \"How to render values\",\n      \"default\": \"FORMATTED_VALUE\",\n      \"options\": [\n        {\n          \"value\": \"FORMATTED_VALUE\",\n          \"label\": \"Formatted, as shown in the sheet (e.g. \\\"$1.50\\\", \\\"10/1/2026\\\")\"\n        },\n        {\n          \"value\": \"UNFORMATTED_VALUE\",\n          \"label\": \"The underlying number or string, no formatting applied\"\n        },\n        {\n          \"value\": \"FORMULA\",\n          \"label\": \"The formula text itself, for a cell that has one\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"majorDimension\",\n      \"label\": \"Rows or columns\",\n      \"default\": \"ROWS\",\n      \"description\": \"Whether the outer array of the result is rows or columns.\",\n      \"options\": [\n        {\n          \"value\": \"ROWS\",\n          \"label\": \"Rows\"\n        },\n        {\n          \"value\": \"COLUMNS\",\n          \"label\": \"Columns\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_GET_META, config as Record<string, unknown>, \"read a range\"),\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 * Write Google Sheets values — Overwrite the cell values of a range. Existing\n * values in that range are replaced, not pushed down.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_KIND = \"@particle-academy/google_sheets_values_update\";\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OPERATION = \"values_update\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_META = googleSheetsMeta(\"action\", \"write a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation.\"\n  },\n  {\n    \"path\": \"data.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedColumns\",\n    \"type\": \"number\",\n    \"description\": \"How many columns had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesUpdateKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_UPDATE_META, {\n  name: GOOGLE_SHEETS_VALUES_UPDATE_KIND,\n  aliases: [\"google_sheets_values_update\"],\n  label: \"Write Google Sheets values\",\n  description: \"Overwrite the cell values of a range. Existing values in that range are replaced, not pushed down.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"idempotent\",\n  outputShape: GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A1\",\n      \"description\": \"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.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells to write, comma separated, left to right, one row. For more than one row, call this action once per row.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"required\": true,\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"USER_ENTERED parses the cells the way typing them would -- so =SUM(A1:A2) becomes a formula. RAW stores exactly the characters given.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_UPDATE_META, config as Record<string, unknown>, \"write a range\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/row-append.js\";\nexport * from \"./kinds/values-get.js\";\nexport * from \"./kinds/values-update.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSheetsRowKind } from \"./kinds/row-append.js\";\nimport { googleSheetsValuesGetKind } from \"./kinds/values-get.js\";\nimport { googleSheetsValuesUpdateKind } from \"./kinds/values-update.js\";\n\n/** Every Google Sheets kind, for a host that registers the lot. */\nexport const GOOGLE_SHEETS_KINDS: NodeKindDefinition[] = [\n  googleSheetsRowKind,\n  googleSheetsValuesGetKind,\n  googleSheetsValuesUpdateKind,\n];\n"]}
+{"version":3,"sources":["../src/service.ts","../src/kinds/row-append.ts","../src/kinds/values-get.ts","../src/kinds/values-update.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.js","sourcesContent":["/**\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's identity on the authoring surface, shared by every Google\n * Sheets node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\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 { ConnectorDomain, ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\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.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const GOOGLE_SHEETS_SERVICE = {\n  service: \"google_sheets\",\n  serviceTitle: \"Google Sheets\",\n  domain: \"productivity\",\n  sandbox: \"none\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/**\n * Every connector domain weaver knows, pinned against fancy-flow's union.\n *\n * A closed set copied into three codebases stays correct only while something\n * MAKES it: this line fails to compile the moment weaver carries a value\n * fancy-flow does not, including the values no provider uses yet.\n */\nconst WEAVER_DOMAINS: readonly ConnectorDomain[] = [\n  \"payments\",\n  \"commerce\",\n  \"messaging\",\n  \"email\",\n  \"crm\",\n  \"support\",\n  \"storage\",\n  \"calendar\",\n  \"productivity\",\n  \"database\",\n  \"devtools\",\n  \"analytics\",\n  \"marketing\",\n  \"ai\",\n  \"forms\",\n  \"hr\",\n  \"geo\"\n];\nvoid WEAVER_DOMAINS;\n\n/** The credentials a Google Sheets connection holds. */\nexport const GOOGLE_SHEETS_CREDENTIALS = [\n  {\n    \"key\": \"clientId\",\n    \"label\": \"OAuth client ID\",\n    \"scope\": \"provider\",\n    \"secret\": false,\n    \"help\": \"From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.\"\n  },\n  {\n    \"key\": \"clientSecret\",\n    \"label\": \"OAuth client secret\",\n    \"scope\": \"provider\",\n    \"secret\": true,\n    \"help\": \"The client secret for the same OAuth app. One value for the whole installation.\"\n  },\n  {\n    \"key\": \"accessToken\",\n    \"label\": \"Access token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.\"\n  },\n  {\n    \"key\": \"refreshToken\",\n    \"label\": \"Refresh token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour.\"\n  }\n] as const;\n\n/**\n * The OAuth2 exchange Google Sheets requires — DECLARED here, performed by the\n * host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n *\n * Its refresh tokens do NOT rotate: the same one is reusable, so a refresh may\n * safely be retried and may run concurrently. That is stated rather than\n * assumed because the opposite — a provider that spends the token and revokes\n * the grant on a replay — looks identical until it happens.\n *\n * Its consent grant is SHARED with every connector declaring grant \"google\":\n * one OAuth client, one consent and one refresh token per person, scopes added\n * as features are first used (authorizeParams). Revoking removes the WHOLE\n * grant, so only a full disconnect revokes; a per-feature disconnect stops\n * using the scope locally. Identify the account by the id_token's sub, never\n * by email.\n */\nexport const GOOGLE_SHEETS_OAUTH = {\n  \"flow\": \"authorization_code\",\n  \"authorizeUrl\": \"https://accounts.google.com/o/oauth2/v2/auth\",\n  \"tokenUrl\": \"https://oauth2.googleapis.com/token\",\n  \"scopes\": [\n    \"https://www.googleapis.com/auth/spreadsheets\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600,\n  \"grant\": \"google\",\n  \"authorizeParams\": {\n    \"access_type\": \"offline\",\n    \"include_granted_scopes\": \"true\"\n  },\n  \"revoke\": {\n    \"url\": \"https://oauth2.googleapis.com/revoke\",\n    \"param\": \"token\",\n    \"scope\": \"grant\"\n  },\n  \"identity\": {\n    \"scope\": \"openid\",\n    \"claim\": \"sub\",\n    \"issuers\": [\n      \"https://accounts.google.com\",\n      \"accounts.google.com\"\n    ],\n    \"jwksUrl\": \"https://www.googleapis.com/oauth2/v3/certs\",\n    \"audienceCredential\": \"clientId\"\n  },\n  \"restrictedScopes\": []\n} as const;\n\n/** Build a Google Sheets node's connector metadata from the operation it performs. */\nexport function googleSheetsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SHEETS_SERVICE, role, operation, docs };\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 * Google Sheets row — Append a row to a Google Sheet.\n *\n * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\n *\n * `unsafe-to-replay`.\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_ROW_KIND = \"@particle-academy/google_sheets_row\";\nexport const GOOGLE_SHEETS_ROW_OPERATION = \"row_append\";\n\nexport const GOOGLE_SHEETS_ROW_META = googleSheetsMeta(\"action\", \"append a row\", \"https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_ROW_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation. NOT the range that was asked for -- append finds the first empty row below it.\"\n  },\n  {\n    \"path\": \"data.updates.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows were added.\"\n  },\n  {\n    \"path\": \"data.updates.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  }\n];\n\nexport const googleSheetsRowKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_ROW_META, {\n  name: GOOGLE_SHEETS_ROW_KIND,\n  aliases: [\"google_sheets_row\"],\n  label: \"Google Sheets row\",\n  description: \"Append a row to a Google Sheet.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SHEETS_ROW_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"Where to append, in A1 notation. Google finds the last row of this range and writes below it.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells of the row, comma separated. Left to right from the start of the range.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"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.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"insertDataOption\",\n      \"label\": \"When the range already has data below\",\n      \"default\": \"INSERT_ROWS\",\n      \"description\": \"INSERT_ROWS pushes existing rows down. OVERWRITE writes into them.\",\n      \"options\": [\n        {\n          \"value\": \"INSERT_ROWS\",\n          \"label\": \"Insert new rows\"\n        },\n        {\n          \"value\": \"OVERWRITE\",\n          \"label\": \"Overwrite what is there\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_ROW_META, config as Record<string, unknown>, \"append a row\"),\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 Google Sheets values — Read the cell values of a range.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_KIND = \"@particle-academy/google_sheets_values_get\";\nexport const GOOGLE_SHEETS_VALUES_GET_OPERATION = \"values_get\";\n\nexport const GOOGLE_SHEETS_VALUES_GET_META = googleSheetsMeta(\"action\", \"read a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.range\",\n    \"type\": \"string\",\n    \"description\": \"The range actually covered -- may be smaller than what was asked for; Google excludes empty trailing rows and columns.\"\n  },\n  {\n    \"path\": \"data.majorDimension\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was asked, or ROWS by default.\"\n  },\n  {\n    \"path\": \"data.values\",\n    \"type\": \"array\",\n    \"description\": \"Rows of cells -- an array of arrays. One row is [[a, b, c]], the same shape row_append sends. Absent entirely when the range is empty.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesGetKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_GET_META, {\n  name: GOOGLE_SHEETS_VALUES_GET_KIND,\n  aliases: [\"google_sheets_values_get\"],\n  label: \"Read Google Sheets values\",\n  description: \"Read the cell values of a range.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_SHEETS_VALUES_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true,\n      \"description\": \"The long id from the sheet's URL: docs.google.com/spreadsheets/d/THIS_PART/edit.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A:Z\",\n      \"description\": \"In A1 notation, the same shape row_append accepts.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueRenderOption\",\n      \"label\": \"How to render values\",\n      \"default\": \"FORMATTED_VALUE\",\n      \"options\": [\n        {\n          \"value\": \"FORMATTED_VALUE\",\n          \"label\": \"Formatted, as shown in the sheet (e.g. \\\"$1.50\\\", \\\"10/1/2026\\\")\"\n        },\n        {\n          \"value\": \"UNFORMATTED_VALUE\",\n          \"label\": \"The underlying number or string, no formatting applied\"\n        },\n        {\n          \"value\": \"FORMULA\",\n          \"label\": \"The formula text itself, for a cell that has one\"\n        }\n      ]\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"majorDimension\",\n      \"label\": \"Rows or columns\",\n      \"default\": \"ROWS\",\n      \"description\": \"Whether the outer array of the result is rows or columns.\",\n      \"options\": [\n        {\n          \"value\": \"ROWS\",\n          \"label\": \"Rows\"\n        },\n        {\n          \"value\": \"COLUMNS\",\n          \"label\": \"Columns\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_GET_META, config as Record<string, unknown>, \"read a range\"),\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 * Write Google Sheets values — Overwrite the cell values of a range. Existing\n * values in that range are replaced, not pushed down.\n *\n * https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSheetsMeta } from \"../service.js\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_KIND = \"@particle-academy/google_sheets_values_update\";\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OPERATION = \"values_update\";\n\nexport const GOOGLE_SHEETS_VALUES_UPDATE_META = googleSheetsMeta(\"action\", \"write a range\", \"https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.spreadsheetId\",\n    \"type\": \"string\",\n    \"description\": \"The spreadsheet that was written to.\"\n  },\n  {\n    \"path\": \"data.updatedRange\",\n    \"type\": \"string\",\n    \"description\": \"The range Google actually wrote, in A1 notation.\"\n  },\n  {\n    \"path\": \"data.updatedRows\",\n    \"type\": \"number\",\n    \"description\": \"How many rows had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedColumns\",\n    \"type\": \"number\",\n    \"description\": \"How many columns had at least one cell updated.\"\n  },\n  {\n    \"path\": \"data.updatedCells\",\n    \"type\": \"number\",\n    \"description\": \"How many cells were written.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const googleSheetsValuesUpdateKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SHEETS_VALUES_UPDATE_META, {\n  name: GOOGLE_SHEETS_VALUES_UPDATE_KIND,\n  aliases: [\"google_sheets_values_update\"],\n  label: \"Write Google Sheets values\",\n  description: \"Overwrite the cell values of a range. Existing values in that range are replaced, not pushed down.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"idempotent\",\n  outputShape: GOOGLE_SHEETS_VALUES_UPDATE_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"spreadsheetId\",\n      \"label\": \"Spreadsheet ID\",\n      \"required\": true\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"range\",\n      \"label\": \"Range\",\n      \"required\": true,\n      \"default\": \"Sheet1!A1\",\n      \"description\": \"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.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"values\",\n      \"label\": \"Row values\",\n      \"required\": true,\n      \"description\": \"The cells to write, comma separated, left to right, one row. For more than one row, call this action once per row.\"\n    },\n    {\n      \"type\": \"select\",\n      \"key\": \"valueInputOption\",\n      \"label\": \"How to interpret the values\",\n      \"required\": true,\n      \"default\": \"USER_ENTERED\",\n      \"description\": \"USER_ENTERED parses the cells the way typing them would -- so =SUM(A1:A2) becomes a formula. RAW stores exactly the characters given.\",\n      \"options\": [\n        {\n          \"value\": \"USER_ENTERED\",\n          \"label\": \"As if typed (formulas and dates parsed)\"\n        },\n        {\n          \"value\": \"RAW\",\n          \"label\": \"Exactly as given\"\n        }\n      ]\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SHEETS_VALUES_UPDATE_META, config as Record<string, unknown>, \"write a range\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/row-append.js\";\nexport * from \"./kinds/values-get.js\";\nexport * from \"./kinds/values-update.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSheetsRowKind } from \"./kinds/row-append.js\";\nimport { googleSheetsValuesGetKind } from \"./kinds/values-get.js\";\nimport { googleSheetsValuesUpdateKind } from \"./kinds/values-update.js\";\n\n/** Every Google Sheets kind, for a host that registers the lot. */\nexport const GOOGLE_SHEETS_KINDS: NodeKindDefinition[] = [\n  googleSheetsRowKind,\n  googleSheetsValuesGetKind,\n  googleSheetsValuesUpdateKind,\n];\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/google-sheets-ui",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Google Sheets's authoring surface for fancy-flow — the node kinds, their config schemas and their declared output shapes. React on every host; carries no executor.",
   "repository": {
     "type": "git",