@particle-academy/google-docs-ui 0.3.3 → 0.4.0

package/CHANGELOG.md

@@ -8,6 +8,27 @@ The four packages share one version, because they are generated from one
 `provider/` definition and a version that meant something different in each
 would be a version nobody could reason about.
 
+## [0.4.0] — 2026-10-01
+
+### Added
+
+- **`text_insert`** — insert plain text into an existing document's body
+  (`documents.batchUpdate`, a single `insertText` request). No scope
+  change. Until now `document_create` could only make a BLANK document
+  with no way to ever put content in it.
+- Deliberately NOT included: the general `batchUpdate` escape hatch (an
+  author-supplied array of Google's dozens of typed request kinds —
+  `deleteContentRange`, `replaceAllText`, `insertTable`, text styling,
+  ...). That needs an array-of-polymorphic-objects config shape nothing
+  in this estate has used before — a real second need, not a first
+  guess, same bar as everything in `vocabulary-deferred.md`.
+
+## [0.3.4] — 2026-09-12
+
+### Changed
+
+- **Requires `fancy-connector-core` ≥ 0.4.0** — `particle-academy/fancy-connector-core` for php, `@particle-academy/fancy-connector-core` for js. The flow executors now pass a provider's declared `idempotencyMaxLength` through to the core's key derivation, and a named argument an older core does not accept is a fatal rather than a no-op, so the floor moves with it. This connector declares no limit and passes nothing, so nothing else changes for it; the bump is the floor alone.
+
 ## [0.3.3] — 2026-09-11
 
 ### Added

package/README.md

@@ -1,5 +1,7 @@
 # Google Docs
 
+[![Fancified](art/fancified.svg)](https://particle.academy)
+
 Google Docs for [fancy-flow][flow] — as **four imported, versioned packages**, one
 per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
 change.
@@ -75,6 +77,18 @@ Create a blank Google Docs document.
 |---|---|---|
 | `title` | yes | The title of the new blank document. |
 
+#### `text_insert` — Insert text into a Google Doc
+
+Insert plain text at a position in an existing document's body.
+
+`POST /v1/documents/{documentId}:batchUpdate` · **unsafe to replay** — a retried durable run does it TWICE
+
+| Input | Required | What it is |
+|---|---|---|
+| `documentId` | yes | From document_create's data.documentId, or the id in the document's own URL. |
+| `text` | yes | Inserted verbatim. A newline in it starts a new paragraph, carrying the style of whatever paragraph the insertion point sits in. |
+| `index` | yes | A zero-based position in UTF-16 code units, but 0 itself is never valid -- Google's body content starts at index 1. 1 is the very beginning of a freshly created blank document. To append after existing content, read the document's own length first (not yet offered by this connector) and insert there instead. |
+
 ## Run it before you have credentials
 
 Every operation ships a **faker**, whether or not Google Docs has a sandbox. Set a

package/art/fancified.svg

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

package/dist/index.cjs

@@ -93,10 +93,70 @@ var googleDocsDocumentKind = connectors.defineConnectorKind(GOOGLE_DOCS_DOCUMENT
   },
   renderBody: ({ config }) => connectors.summarize(GOOGLE_DOCS_DOCUMENT_META, config, "create a blank document")
 });
+var GOOGLE_DOCS_TEXT_INSERT_KIND = "@particle-academy/google_docs_text_insert";
+var GOOGLE_DOCS_TEXT_INSERT_OPERATION = "text_insert";
+var GOOGLE_DOCS_TEXT_INSERT_META = googleDocsMeta("action", "insert text", "https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate");
+var GOOGLE_DOCS_TEXT_INSERT_OUTPUT = [
+  {
+    "path": "data.documentId",
+    "type": "string",
+    "description": "Echoes what was sent."
+  },
+  {
+    "path": "data.replies",
+    "type": "array",
+    "description": "One entry per request sent -- one here. insertText's own reply carries nothing; the array is present and empty-shaped rather than a usable result."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var googleDocsTextInsertKind = connectors.defineConnectorKind(GOOGLE_DOCS_TEXT_INSERT_META, {
+  name: GOOGLE_DOCS_TEXT_INSERT_KIND,
+  aliases: ["google_docs_text_insert"],
+  label: "Insert text into a Google Doc",
+  description: "Insert plain text at a position in an existing document's body.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "unsafe-to-replay",
+  outputShape: GOOGLE_DOCS_TEXT_INSERT_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "documentId",
+      "label": "Document ID",
+      "required": true,
+      "description": "From document_create's data.documentId, or the id in the document's own URL."
+    },
+    {
+      "type": "textarea",
+      "key": "text",
+      "label": "Text",
+      "required": true,
+      "description": "Inserted verbatim. A newline in it starts a new paragraph, carrying the style of whatever paragraph the insertion point sits in."
+    },
+    {
+      "type": "number",
+      "key": "index",
+      "label": "Insert at index",
+      "required": true,
+      "default": 1,
+      "min": 1,
+      "description": "A zero-based position in UTF-16 code units, but 0 itself is never valid -- Google's body content starts at index 1. 1 is the very beginning of a freshly created blank document. To append after existing content, read the document's own length first (not yet offered by this connector) and insert there instead."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GOOGLE_DOCS_TEXT_INSERT_META, config, "insert text")
+});
 
 // src/index.ts
 var GOOGLE_DOCS_KINDS = [
-  googleDocsDocumentKind
+  googleDocsDocumentKind,
+  googleDocsTextInsertKind
 ];
 
 exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
@@ -108,7 +168,12 @@ exports.GOOGLE_DOCS_DOCUMENT_OUTPUT = GOOGLE_DOCS_DOCUMENT_OUTPUT;
 exports.GOOGLE_DOCS_KINDS = GOOGLE_DOCS_KINDS;
 exports.GOOGLE_DOCS_OAUTH = GOOGLE_DOCS_OAUTH;
 exports.GOOGLE_DOCS_SERVICE = GOOGLE_DOCS_SERVICE;
+exports.GOOGLE_DOCS_TEXT_INSERT_KIND = GOOGLE_DOCS_TEXT_INSERT_KIND;
+exports.GOOGLE_DOCS_TEXT_INSERT_META = GOOGLE_DOCS_TEXT_INSERT_META;
+exports.GOOGLE_DOCS_TEXT_INSERT_OPERATION = GOOGLE_DOCS_TEXT_INSERT_OPERATION;
+exports.GOOGLE_DOCS_TEXT_INSERT_OUTPUT = GOOGLE_DOCS_TEXT_INSERT_OUTPUT;
 exports.googleDocsDocumentKind = googleDocsDocumentKind;
 exports.googleDocsMeta = googleDocsMeta;
+exports.googleDocsTextInsertKind = googleDocsTextInsertKind;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/service.ts","../src/kinds/document-create.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_docs\n */\n\n/**\n * Google Docs's identity on the authoring surface, shared by every Google Docs\n * 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 Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\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_DOCS_SERVICE = {\n  service: \"google_docs\",\n  serviceTitle: \"Google Docs\",\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 Docs connection holds. */\nexport const GOOGLE_DOCS_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 Docs 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_DOCS_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/documents\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Docs node's connector metadata from the operation it performs. */\nexport function googleDocsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_DOCS_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.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/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs document — Create a blank Google Docs document.\n *\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\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 { googleDocsMeta } from \"../service.js\";\n\nexport const GOOGLE_DOCS_DOCUMENT_KIND = \"@particle-academy/google_docs_document\";\nexport const GOOGLE_DOCS_DOCUMENT_OPERATION = \"document_create\";\n\nexport const GOOGLE_DOCS_DOCUMENT_META = googleDocsMeta(\"action\", \"create a blank document\", \"https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\");\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_DOCS_DOCUMENT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.documentId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created document.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleDocsDocumentKind: NodeKindDefinition = defineConnectorKind(GOOGLE_DOCS_DOCUMENT_META, {\n  name: GOOGLE_DOCS_DOCUMENT_KIND,\n  aliases: [\"google_docs_document\"],\n  label: \"Google Docs document\",\n  description: \"Create a blank Google Docs document.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_DOCS_DOCUMENT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank document.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_DOCS_DOCUMENT_META, config as Record<string, unknown>, \"create a blank document\"),\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_docs\n */\n\n/**\n * Google Docs'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/document-create.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleDocsDocumentKind } from \"./kinds/document-create.js\";\n\n/** Every Google Docs kind, for a host that registers the lot. */\nexport const GOOGLE_DOCS_KINDS: NodeKindDefinition[] = [\n  googleDocsDocumentKind,\n];\n"]}
+{"version":3,"sources":["../src/service.ts","../src/kinds/document-create.ts","../src/kinds/text-insert.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":";;;;;AAkCO,IAAM,qBAAA,GAAwB;AAG9B,IAAM,mBAAA,GAAsB;AAAA,EACjC,OAAA,EAAS,aAAA;AAAA,EACT,YAAA,EAAc,aAAA;AAAA,EACd,MAAA,EAAQ,cAAA;AAAA,EACR,OAAA,EAAS;AACX;AA+BO,IAAM,uBAAA,GAA0B;AAAA,EACrC;AAAA,IACE,KAAA,EAAO,UAAA;AAAA,IACP,OAAA,EAAS,iBAAA;AAAA,IACT,OAAA,EAAS,UAAA;AAAA,IACT,QAAA,EAAU,KAAA;AAAA,IACV,MAAA,EAAQ;AAAA,GACV;AAAA,EACA;AAAA,IACE,KAAA,EAAO,cAAA;AAAA,IACP,OAAA,EAAS,qBAAA;AAAA,IACT,OAAA,EAAS,UAAA;AAAA,IACT,QAAA,EAAU,IAAA;AAAA,IACV,MAAA,EAAQ;AAAA,GACV;AAAA,EACA;AAAA,IACE,KAAA,EAAO,aAAA;AAAA,IACP,OAAA,EAAS,cAAA;AAAA,IACT,OAAA,EAAS,SAAA;AAAA,IACT,QAAA,EAAU,IAAA;AAAA,IACV,MAAA,EAAQ;AAAA,GACV;AAAA,EACA;AAAA,IACE,KAAA,EAAO,cAAA;AAAA,IACP,OAAA,EAAS,eAAA;AAAA,IACT,OAAA,EAAS,SAAA;AAAA,IACT,QAAA,EAAU,IAAA;AAAA,IACV,MAAA,EAAQ;AAAA;AAEZ;AAoBO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,MAAA,EAAQ,oBAAA;AAAA,EACR,cAAA,EAAgB,8CAAA;AAAA,EAChB,UAAA,EAAY,qCAAA;AAAA,EACZ,QAAA,EAAU;AAAA,IACR;AAAA,GACF;AAAA,EACA,uBAAA,EAAyB,aAAA;AAAA,EACzB,wBAAA,EAA0B,cAAA;AAAA,EAC1B,qBAAA,EAAuB,KAAA;AAAA,EACvB,uBAAA,EAAyB;AAC3B;AAGO,SAAS,cAAA,CACd,IAAA,EACA,SAAA,EACA,IAAA,EACe;AACf,EAAA,OAAO,EAAE,GAAG,mBAAA,EAAqB,IAAA,EAAM,WAAW,IAAA,EAAK;AACzD;ACvHO,IAAM,yBAAA,GAA4B;AAClC,IAAM,8BAAA,GAAiC;AAEvC,IAAM,yBAAA,GAA4B,cAAA,CAAe,QAAA,EAAU,yBAAA,EAA2B,qFAAqF;AAU3K,IAAM,2BAAA,GAA6C;AAAA,EACxD;AAAA,IACE,MAAA,EAAQ,iBAAA;AAAA,IACR,MAAA,EAAQ,QAAA;AAAA,IACR,aAAA,EAAe;AAAA,GACjB;AAAA,EACA;AAAA,IACE,MAAA,EAAQ,YAAA;AAAA,IACR,MAAA,EAAQ,QAAA;AAAA,IACR,aAAA,EAAe;AAAA;AAEnB;AAEO,IAAM,sBAAA,GAA6CA,+BAAoB,yBAAA,EAA2B;AAAA,EACvG,IAAA,EAAM,yBAAA;AAAA,EACN,OAAA,EAAS,CAAC,sBAAsB,CAAA;AAAA,EAChC,KAAA,EAAO,sBAAA;AAAA,EACP,WAAA,EAAa,sCAAA;AAAA,EACb,MAAA,EAAQ,CAAC,EAAE,EAAA,EAAI,MAAM,CAAA;AAAA,EACrB,OAAA,EAAS,CAAC,EAAE,EAAA,EAAI,OAAO,CAAA;AAAA,EACvB,WAAA,EAAa,kBAAA;AAAA,EACb,WAAA,EAAa,2BAAA;AAAA,EACb,YAAA,EAAc;AAAA,IACZ;AAAA,MACE,MAAA,EAAQ,MAAA;AAAA,MACR,KAAA,EAAO,OAAA;AAAA,MACP,OAAA,EAAS,OAAA;AAAA,MACT,UAAA,EAAY,IAAA;AAAA,MACZ,aAAA,EAAe;AAAA;AACjB,GACF;AAAA,EACA,aAAA,EAAe;AAAA,IACb,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,UAAA,EAAY,CAAC,EAAE,MAAA,OACbC,oBAAA,CAAU,yBAAA,EAA2B,QAAmC,yBAAyB;AACrG,CAAC;AChDM,IAAM,4BAAA,GAA+B;AACrC,IAAM,iCAAA,GAAoC;AAE1C,IAAM,4BAAA,GAA+B,cAAA,CAAe,QAAA,EAAU,aAAA,EAAe,0FAA0F;AAUvK,IAAM,8BAAA,GAAgD;AAAA,EAC3D;AAAA,IACE,MAAA,EAAQ,iBAAA;AAAA,IACR,MAAA,EAAQ,QAAA;AAAA,IACR,aAAA,EAAe;AAAA,GACjB;AAAA,EACA;AAAA,IACE,MAAA,EAAQ,cAAA;AAAA,IACR,MAAA,EAAQ,OAAA;AAAA,IACR,aAAA,EAAe;AAAA,GACjB;AAAA,EACA;AAAA,IACE,MAAA,EAAQ,MAAA;AAAA,IACR,MAAA,EAAQ,QAAA;AAAA,IACR,aAAA,EAAe;AAAA;AAEnB;AAEO,IAAM,wBAAA,GAA+CD,+BAAoB,4BAAA,EAA8B;AAAA,EAC5G,IAAA,EAAM,4BAAA;AAAA,EACN,OAAA,EAAS,CAAC,yBAAyB,CAAA;AAAA,EACnC,KAAA,EAAO,+BAAA;AAAA,EACP,WAAA,EAAa,iEAAA;AAAA,EACb,MAAA,EAAQ,CAAC,EAAE,EAAA,EAAI,MAAM,CAAA;AAAA,EACrB,OAAA,EAAS,CAAC,EAAE,EAAA,EAAI,OAAO,CAAA;AAAA,EACvB,WAAA,EAAa,kBAAA;AAAA,EACb,WAAA,EAAa,8BAAA;AAAA,EACb,YAAA,EAAc;AAAA,IACZ;AAAA,MACE,MAAA,EAAQ,MAAA;AAAA,MACR,KAAA,EAAO,YAAA;AAAA,MACP,OAAA,EAAS,aAAA;AAAA,MACT,UAAA,EAAY,IAAA;AAAA,MACZ,aAAA,EAAe;AAAA,KACjB;AAAA,IACA;AAAA,MACE,MAAA,EAAQ,UAAA;AAAA,MACR,KAAA,EAAO,MAAA;AAAA,MACP,OAAA,EAAS,MAAA;AAAA,MACT,UAAA,EAAY,IAAA;AAAA,MACZ,aAAA,EAAe;AAAA,KACjB;AAAA,IACA;AAAA,MACE,MAAA,EAAQ,QAAA;AAAA,MACR,KAAA,EAAO,OAAA;AAAA,MACP,OAAA,EAAS,iBAAA;AAAA,MACT,UAAA,EAAY,IAAA;AAAA,MACZ,SAAA,EAAW,CAAA;AAAA,MACX,KAAA,EAAO,CAAA;AAAA,MACP,aAAA,EAAe;AAAA;AACjB,GACF;AAAA,EACA,aAAA,EAAe;AAAA,IACb,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,UAAA,EAAY,CAAC,EAAE,MAAA,OACbC,oBAAAA,CAAU,4BAAA,EAA8B,QAAmC,aAAa;AAC5F,CAAC;;;AClEM,IAAM,iBAAA,GAA0C;AAAA,EACrD,sBAAA;AAAA,EACA;AACF","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_docs\n */\n\n/**\n * Google Docs's identity on the authoring surface, shared by every Google Docs\n * 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 Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\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_DOCS_SERVICE = {\n  service: \"google_docs\",\n  serviceTitle: \"Google Docs\",\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 Docs connection holds. */\nexport const GOOGLE_DOCS_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 Docs 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_DOCS_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/documents\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Docs node's connector metadata from the operation it performs. */\nexport function googleDocsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_DOCS_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.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/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs document — Create a blank Google Docs document.\n *\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\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 { googleDocsMeta } from \"../service.js\";\n\nexport const GOOGLE_DOCS_DOCUMENT_KIND = \"@particle-academy/google_docs_document\";\nexport const GOOGLE_DOCS_DOCUMENT_OPERATION = \"document_create\";\n\nexport const GOOGLE_DOCS_DOCUMENT_META = googleDocsMeta(\"action\", \"create a blank document\", \"https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\");\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_DOCS_DOCUMENT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.documentId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created document.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleDocsDocumentKind: NodeKindDefinition = defineConnectorKind(GOOGLE_DOCS_DOCUMENT_META, {\n  name: GOOGLE_DOCS_DOCUMENT_KIND,\n  aliases: [\"google_docs_document\"],\n  label: \"Google Docs document\",\n  description: \"Create a blank Google Docs document.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_DOCS_DOCUMENT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank document.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_DOCS_DOCUMENT_META, config as Record<string, unknown>, \"create a blank document\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-insert.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/text-insert.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Insert text into a Google Doc — Insert plain text at a position in an\n * existing document's body.\n *\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\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 { googleDocsMeta } from \"../service.js\";\n\nexport const GOOGLE_DOCS_TEXT_INSERT_KIND = \"@particle-academy/google_docs_text_insert\";\nexport const GOOGLE_DOCS_TEXT_INSERT_OPERATION = \"text_insert\";\n\nexport const GOOGLE_DOCS_TEXT_INSERT_META = googleDocsMeta(\"action\", \"insert text\", \"https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\");\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_DOCS_TEXT_INSERT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.documentId\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was sent.\"\n  },\n  {\n    \"path\": \"data.replies\",\n    \"type\": \"array\",\n    \"description\": \"One entry per request sent -- one here. insertText's own reply carries nothing; the array is present and empty-shaped rather than a usable result.\"\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 googleDocsTextInsertKind: NodeKindDefinition = defineConnectorKind(GOOGLE_DOCS_TEXT_INSERT_META, {\n  name: GOOGLE_DOCS_TEXT_INSERT_KIND,\n  aliases: [\"google_docs_text_insert\"],\n  label: \"Insert text into a Google Doc\",\n  description: \"Insert plain text at a position in an existing document's body.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_DOCS_TEXT_INSERT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"documentId\",\n      \"label\": \"Document ID\",\n      \"required\": true,\n      \"description\": \"From document_create's data.documentId, or the id in the document's own URL.\"\n    },\n    {\n      \"type\": \"textarea\",\n      \"key\": \"text\",\n      \"label\": \"Text\",\n      \"required\": true,\n      \"description\": \"Inserted verbatim. A newline in it starts a new paragraph, carrying the style of whatever paragraph the insertion point sits in.\"\n    },\n    {\n      \"type\": \"number\",\n      \"key\": \"index\",\n      \"label\": \"Insert at index\",\n      \"required\": true,\n      \"default\": 1,\n      \"min\": 1,\n      \"description\": \"A zero-based position in UTF-16 code units, but 0 itself is never valid -- Google's body content starts at index 1. 1 is the very beginning of a freshly created blank document. To append after existing content, read the document's own length first (not yet offered by this connector) and insert there instead.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_DOCS_TEXT_INSERT_META, config as Record<string, unknown>, \"insert text\"),\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_docs\n */\n\n/**\n * Google Docs'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/document-create.js\";\nexport * from \"./kinds/text-insert.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleDocsDocumentKind } from \"./kinds/document-create.js\";\nimport { googleDocsTextInsertKind } from \"./kinds/text-insert.js\";\n\n/** Every Google Docs kind, for a host that registers the lot. */\nexport const GOOGLE_DOCS_KINDS: NodeKindDefinition[] = [\n  googleDocsDocumentKind,\n  googleDocsTextInsertKind,\n];\n"]}

package/dist/index.d.cts

@@ -112,6 +112,20 @@ declare const GOOGLE_DOCS_DOCUMENT_META: _particle_academy_fancy_flow_connectors
 declare const GOOGLE_DOCS_DOCUMENT_OUTPUT: OutputField[];
 declare const googleDocsDocumentKind: NodeKindDefinition;
 
+declare const GOOGLE_DOCS_TEXT_INSERT_KIND = "@particle-academy/google_docs_text_insert";
+declare const GOOGLE_DOCS_TEXT_INSERT_OPERATION = "text_insert";
+declare const GOOGLE_DOCS_TEXT_INSERT_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GOOGLE_DOCS_TEXT_INSERT_OUTPUT: OutputField[];
+declare const googleDocsTextInsertKind: NodeKindDefinition;
+
 /**
  * GENERATED FILE — do not edit.
  *
@@ -133,4 +147,4 @@ declare const googleDocsDocumentKind: NodeKindDefinition;
 /** Every Google Docs kind, for a host that registers the lot. */
 declare const GOOGLE_DOCS_KINDS: NodeKindDefinition[];
 
-export { CONNECTOR_API_VERSION, GOOGLE_DOCS_CREDENTIALS, GOOGLE_DOCS_DOCUMENT_KIND, GOOGLE_DOCS_DOCUMENT_META, GOOGLE_DOCS_DOCUMENT_OPERATION, GOOGLE_DOCS_DOCUMENT_OUTPUT, GOOGLE_DOCS_KINDS, GOOGLE_DOCS_OAUTH, GOOGLE_DOCS_SERVICE, googleDocsDocumentKind, googleDocsMeta };
+export { CONNECTOR_API_VERSION, GOOGLE_DOCS_CREDENTIALS, GOOGLE_DOCS_DOCUMENT_KIND, GOOGLE_DOCS_DOCUMENT_META, GOOGLE_DOCS_DOCUMENT_OPERATION, GOOGLE_DOCS_DOCUMENT_OUTPUT, GOOGLE_DOCS_KINDS, GOOGLE_DOCS_OAUTH, GOOGLE_DOCS_SERVICE, GOOGLE_DOCS_TEXT_INSERT_KIND, GOOGLE_DOCS_TEXT_INSERT_META, GOOGLE_DOCS_TEXT_INSERT_OPERATION, GOOGLE_DOCS_TEXT_INSERT_OUTPUT, googleDocsDocumentKind, googleDocsMeta, googleDocsTextInsertKind };

package/dist/index.d.ts

@@ -112,6 +112,20 @@ declare const GOOGLE_DOCS_DOCUMENT_META: _particle_academy_fancy_flow_connectors
 declare const GOOGLE_DOCS_DOCUMENT_OUTPUT: OutputField[];
 declare const googleDocsDocumentKind: NodeKindDefinition;
 
+declare const GOOGLE_DOCS_TEXT_INSERT_KIND = "@particle-academy/google_docs_text_insert";
+declare const GOOGLE_DOCS_TEXT_INSERT_OPERATION = "text_insert";
+declare const GOOGLE_DOCS_TEXT_INSERT_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GOOGLE_DOCS_TEXT_INSERT_OUTPUT: OutputField[];
+declare const googleDocsTextInsertKind: NodeKindDefinition;
+
 /**
  * GENERATED FILE — do not edit.
  *
@@ -133,4 +147,4 @@ declare const googleDocsDocumentKind: NodeKindDefinition;
 /** Every Google Docs kind, for a host that registers the lot. */
 declare const GOOGLE_DOCS_KINDS: NodeKindDefinition[];
 
-export { CONNECTOR_API_VERSION, GOOGLE_DOCS_CREDENTIALS, GOOGLE_DOCS_DOCUMENT_KIND, GOOGLE_DOCS_DOCUMENT_META, GOOGLE_DOCS_DOCUMENT_OPERATION, GOOGLE_DOCS_DOCUMENT_OUTPUT, GOOGLE_DOCS_KINDS, GOOGLE_DOCS_OAUTH, GOOGLE_DOCS_SERVICE, googleDocsDocumentKind, googleDocsMeta };
+export { CONNECTOR_API_VERSION, GOOGLE_DOCS_CREDENTIALS, GOOGLE_DOCS_DOCUMENT_KIND, GOOGLE_DOCS_DOCUMENT_META, GOOGLE_DOCS_DOCUMENT_OPERATION, GOOGLE_DOCS_DOCUMENT_OUTPUT, GOOGLE_DOCS_KINDS, GOOGLE_DOCS_OAUTH, GOOGLE_DOCS_SERVICE, GOOGLE_DOCS_TEXT_INSERT_KIND, GOOGLE_DOCS_TEXT_INSERT_META, GOOGLE_DOCS_TEXT_INSERT_OPERATION, GOOGLE_DOCS_TEXT_INSERT_OUTPUT, googleDocsDocumentKind, googleDocsMeta, googleDocsTextInsertKind };

package/dist/index.js

@@ -91,12 +91,72 @@ var googleDocsDocumentKind = defineConnectorKind(GOOGLE_DOCS_DOCUMENT_META, {
   },
   renderBody: ({ config }) => summarize(GOOGLE_DOCS_DOCUMENT_META, config, "create a blank document")
 });
+var GOOGLE_DOCS_TEXT_INSERT_KIND = "@particle-academy/google_docs_text_insert";
+var GOOGLE_DOCS_TEXT_INSERT_OPERATION = "text_insert";
+var GOOGLE_DOCS_TEXT_INSERT_META = googleDocsMeta("action", "insert text", "https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate");
+var GOOGLE_DOCS_TEXT_INSERT_OUTPUT = [
+  {
+    "path": "data.documentId",
+    "type": "string",
+    "description": "Echoes what was sent."
+  },
+  {
+    "path": "data.replies",
+    "type": "array",
+    "description": "One entry per request sent -- one here. insertText's own reply carries nothing; the array is present and empty-shaped rather than a usable result."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var googleDocsTextInsertKind = defineConnectorKind(GOOGLE_DOCS_TEXT_INSERT_META, {
+  name: GOOGLE_DOCS_TEXT_INSERT_KIND,
+  aliases: ["google_docs_text_insert"],
+  label: "Insert text into a Google Doc",
+  description: "Insert plain text at a position in an existing document's body.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "unsafe-to-replay",
+  outputShape: GOOGLE_DOCS_TEXT_INSERT_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "documentId",
+      "label": "Document ID",
+      "required": true,
+      "description": "From document_create's data.documentId, or the id in the document's own URL."
+    },
+    {
+      "type": "textarea",
+      "key": "text",
+      "label": "Text",
+      "required": true,
+      "description": "Inserted verbatim. A newline in it starts a new paragraph, carrying the style of whatever paragraph the insertion point sits in."
+    },
+    {
+      "type": "number",
+      "key": "index",
+      "label": "Insert at index",
+      "required": true,
+      "default": 1,
+      "min": 1,
+      "description": "A zero-based position in UTF-16 code units, but 0 itself is never valid -- Google's body content starts at index 1. 1 is the very beginning of a freshly created blank document. To append after existing content, read the document's own length first (not yet offered by this connector) and insert there instead."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => summarize(GOOGLE_DOCS_TEXT_INSERT_META, config, "insert text")
+});
 
 // src/index.ts
 var GOOGLE_DOCS_KINDS = [
-  googleDocsDocumentKind
+  googleDocsDocumentKind,
+  googleDocsTextInsertKind
 ];
 
-export { CONNECTOR_API_VERSION, GOOGLE_DOCS_CREDENTIALS, GOOGLE_DOCS_DOCUMENT_KIND, GOOGLE_DOCS_DOCUMENT_META, GOOGLE_DOCS_DOCUMENT_OPERATION, GOOGLE_DOCS_DOCUMENT_OUTPUT, GOOGLE_DOCS_KINDS, GOOGLE_DOCS_OAUTH, GOOGLE_DOCS_SERVICE, googleDocsDocumentKind, googleDocsMeta };
+export { CONNECTOR_API_VERSION, GOOGLE_DOCS_CREDENTIALS, GOOGLE_DOCS_DOCUMENT_KIND, GOOGLE_DOCS_DOCUMENT_META, GOOGLE_DOCS_DOCUMENT_OPERATION, GOOGLE_DOCS_DOCUMENT_OUTPUT, GOOGLE_DOCS_KINDS, GOOGLE_DOCS_OAUTH, GOOGLE_DOCS_SERVICE, GOOGLE_DOCS_TEXT_INSERT_KIND, GOOGLE_DOCS_TEXT_INSERT_META, GOOGLE_DOCS_TEXT_INSERT_OPERATION, GOOGLE_DOCS_TEXT_INSERT_OUTPUT, googleDocsDocumentKind, googleDocsMeta, googleDocsTextInsertKind };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/service.ts","../src/kinds/document-create.ts","../src/index.ts"],"names":[],"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_docs\n */\n\n/**\n * Google Docs's identity on the authoring surface, shared by every Google Docs\n * 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 Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\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_DOCS_SERVICE = {\n  service: \"google_docs\",\n  serviceTitle: \"Google Docs\",\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 Docs connection holds. */\nexport const GOOGLE_DOCS_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 Docs 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_DOCS_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/documents\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Docs node's connector metadata from the operation it performs. */\nexport function googleDocsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_DOCS_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.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/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs document — Create a blank Google Docs document.\n *\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\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 { googleDocsMeta } from \"../service.js\";\n\nexport const GOOGLE_DOCS_DOCUMENT_KIND = \"@particle-academy/google_docs_document\";\nexport const GOOGLE_DOCS_DOCUMENT_OPERATION = \"document_create\";\n\nexport const GOOGLE_DOCS_DOCUMENT_META = googleDocsMeta(\"action\", \"create a blank document\", \"https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\");\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_DOCS_DOCUMENT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.documentId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created document.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleDocsDocumentKind: NodeKindDefinition = defineConnectorKind(GOOGLE_DOCS_DOCUMENT_META, {\n  name: GOOGLE_DOCS_DOCUMENT_KIND,\n  aliases: [\"google_docs_document\"],\n  label: \"Google Docs document\",\n  description: \"Create a blank Google Docs document.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_DOCS_DOCUMENT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank document.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_DOCS_DOCUMENT_META, config as Record<string, unknown>, \"create a blank document\"),\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_docs\n */\n\n/**\n * Google Docs'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/document-create.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleDocsDocumentKind } from \"./kinds/document-create.js\";\n\n/** Every Google Docs kind, for a host that registers the lot. */\nexport const GOOGLE_DOCS_KINDS: NodeKindDefinition[] = [\n  googleDocsDocumentKind,\n];\n"]}
+{"version":3,"sources":["../src/service.ts","../src/kinds/document-create.ts","../src/kinds/text-insert.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_docs\n */\n\n/**\n * Google Docs's identity on the authoring surface, shared by every Google Docs\n * 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 Docs. A test document is a real one in a real\n * Drive, so every create is real -- use the faker while developing and clean\n * up any live test documents.\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_DOCS_SERVICE = {\n  service: \"google_docs\",\n  serviceTitle: \"Google Docs\",\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 Docs connection holds. */\nexport const GOOGLE_DOCS_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 Docs 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_DOCS_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/documents\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Docs node's connector metadata from the operation it performs. */\nexport function googleDocsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_DOCS_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/document-create.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/document-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Google Docs document — Create a blank Google Docs document.\n *\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\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 { googleDocsMeta } from \"../service.js\";\n\nexport const GOOGLE_DOCS_DOCUMENT_KIND = \"@particle-academy/google_docs_document\";\nexport const GOOGLE_DOCS_DOCUMENT_OPERATION = \"document_create\";\n\nexport const GOOGLE_DOCS_DOCUMENT_META = googleDocsMeta(\"action\", \"create a blank document\", \"https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/create\");\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_DOCS_DOCUMENT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.documentId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created document.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleDocsDocumentKind: NodeKindDefinition = defineConnectorKind(GOOGLE_DOCS_DOCUMENT_META, {\n  name: GOOGLE_DOCS_DOCUMENT_KIND,\n  aliases: [\"google_docs_document\"],\n  label: \"Google Docs document\",\n  description: \"Create a blank Google Docs document.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_DOCS_DOCUMENT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank document.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_DOCS_DOCUMENT_META, config as Record<string, unknown>, \"create a blank document\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/text-insert.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/text-insert.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_docs\n */\n\n/**\n * Insert text into a Google Doc — Insert plain text at a position in an\n * existing document's body.\n *\n * https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\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 { googleDocsMeta } from \"../service.js\";\n\nexport const GOOGLE_DOCS_TEXT_INSERT_KIND = \"@particle-academy/google_docs_text_insert\";\nexport const GOOGLE_DOCS_TEXT_INSERT_OPERATION = \"text_insert\";\n\nexport const GOOGLE_DOCS_TEXT_INSERT_META = googleDocsMeta(\"action\", \"insert text\", \"https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/batchUpdate\");\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_DOCS_TEXT_INSERT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.documentId\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was sent.\"\n  },\n  {\n    \"path\": \"data.replies\",\n    \"type\": \"array\",\n    \"description\": \"One entry per request sent -- one here. insertText's own reply carries nothing; the array is present and empty-shaped rather than a usable result.\"\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 googleDocsTextInsertKind: NodeKindDefinition = defineConnectorKind(GOOGLE_DOCS_TEXT_INSERT_META, {\n  name: GOOGLE_DOCS_TEXT_INSERT_KIND,\n  aliases: [\"google_docs_text_insert\"],\n  label: \"Insert text into a Google Doc\",\n  description: \"Insert plain text at a position in an existing document's body.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_DOCS_TEXT_INSERT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"documentId\",\n      \"label\": \"Document ID\",\n      \"required\": true,\n      \"description\": \"From document_create's data.documentId, or the id in the document's own URL.\"\n    },\n    {\n      \"type\": \"textarea\",\n      \"key\": \"text\",\n      \"label\": \"Text\",\n      \"required\": true,\n      \"description\": \"Inserted verbatim. A newline in it starts a new paragraph, carrying the style of whatever paragraph the insertion point sits in.\"\n    },\n    {\n      \"type\": \"number\",\n      \"key\": \"index\",\n      \"label\": \"Insert at index\",\n      \"required\": true,\n      \"default\": 1,\n      \"min\": 1,\n      \"description\": \"A zero-based position in UTF-16 code units, but 0 itself is never valid -- Google's body content starts at index 1. 1 is the very beginning of a freshly created blank document. To append after existing content, read the document's own length first (not yet offered by this connector) and insert there instead.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_DOCS_TEXT_INSERT_META, config as Record<string, unknown>, \"insert text\"),\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_docs\n */\n\n/**\n * Google Docs'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/document-create.js\";\nexport * from \"./kinds/text-insert.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleDocsDocumentKind } from \"./kinds/document-create.js\";\nimport { googleDocsTextInsertKind } from \"./kinds/text-insert.js\";\n\n/** Every Google Docs kind, for a host that registers the lot. */\nexport const GOOGLE_DOCS_KINDS: NodeKindDefinition[] = [\n  googleDocsDocumentKind,\n  googleDocsTextInsertKind,\n];\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/google-docs-ui",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Google Docs'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",
@@ -28,6 +28,7 @@
   },
   "files": [
     "dist",
+    "art",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"