@particle-academy/google-slides-ui 0.3.4 → 0.5.0

package/CHANGELOG.md

@@ -8,6 +8,39 @@ 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.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-slides.php` under
+    `connectors.google-slides` (credentials from the environment, or per call for a
+    multi-account app);
+  - the `GoogleSlides` facade: `GoogleSlides::call('<operation>', [...])` runs any action;
+  - `GoogleSlides::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
+
+- **`presentation_get`** — read a presentation's slides and the objectId
+  of every element on them. No scope change. This is the prerequisite
+  for targeting a specific shape or placeholder with a future edit —
+  `presentations.batchUpdate` operates on objectIds, and until now there
+  was no way to discover one. `insertText`-style editing is NOT included
+  yet; it is a natural next step once this read side exists, not
+  bundled in here.
+
 ## [0.3.4] — 2026-09-12
 
 ### Changed

package/README.md

@@ -1,5 +1,7 @@
 # Google Slides
 
+[![Fancified](art/fancified.svg)](https://particle.academy)
+
 Google Slides 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,16 @@ Create a blank Google Slides presentation.
 |---|---|---|
 | `title` | yes | The title of the new blank presentation. |
 
+#### `presentation_get` — Google Slides presentation
+
+Read a presentation's slides and the objectId of every element on them -- the prerequisite for targeting a specific shape or placeholder with a future edit.
+
+`GET /v1/presentations/{presentationId}` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `presentationId` | yes | From presentation_create's data.presentationId, or the id in the presentation's own URL. |
+
 ## Run it before you have credentials
 
 Every operation ships a **faker**, whether or not Google Slides 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,22 +93,81 @@ var googleSlidesPresentationKind = connectors.defineConnectorKind(GOOGLE_SLIDES_
   },
   renderBody: ({ config }) => connectors.summarize(GOOGLE_SLIDES_PRESENTATION_META, config, "create a blank presentation")
 });
+var GOOGLE_SLIDES_PRESENTATION_GET_KIND = "@particle-academy/google_slides_presentation_get";
+var GOOGLE_SLIDES_PRESENTATION_GET_OPERATION = "presentation_get";
+var GOOGLE_SLIDES_PRESENTATION_GET_META = googleSlidesMeta("action", "read a presentation", "https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get");
+var GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT = [
+  {
+    "path": "data.presentationId",
+    "type": "string",
+    "description": "Echoes what was asked."
+  },
+  {
+    "path": "data.title",
+    "type": "string",
+    "description": "The presentation's title."
+  },
+  {
+    "path": "data.locale",
+    "type": "string",
+    "description": "BCP 47 language tag."
+  },
+  {
+    "path": "data.slides",
+    "type": "array",
+    "description": "One entry per slide, in order: objectId, and pageElements -- each with its own objectId and exactly one of shape/image/table/line/video/wordArt/sheetsChart/elementGroup/speakerSpotlight set, naming what kind of element it is. A placeholder shape's text (when it has one) lives at pageElements[].shape.text, published raw -- this connector does not flatten Slides' own rich-text run structure."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var googleSlidesPresentationGetKind = connectors.defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_GET_META, {
+  name: GOOGLE_SLIDES_PRESENTATION_GET_KIND,
+  aliases: ["google_slides_presentation_get"],
+  label: "Google Slides presentation",
+  description: "Read a presentation's slides and the objectId of every element on them -- the prerequisite for targeting a specific shape or placeholder with a future edit.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "presentationId",
+      "label": "Presentation ID",
+      "required": true,
+      "description": "From presentation_create's data.presentationId, or the id in the presentation's own URL."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GOOGLE_SLIDES_PRESENTATION_GET_META, config, "read a presentation")
+});
 
 // src/index.ts
 var GOOGLE_SLIDES_KINDS = [
-  googleSlidesPresentationKind
+  googleSlidesPresentationKind,
+  googleSlidesPresentationGetKind
 ];
 
 exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
 exports.GOOGLE_SLIDES_CREDENTIALS = GOOGLE_SLIDES_CREDENTIALS;
 exports.GOOGLE_SLIDES_KINDS = GOOGLE_SLIDES_KINDS;
 exports.GOOGLE_SLIDES_OAUTH = GOOGLE_SLIDES_OAUTH;
+exports.GOOGLE_SLIDES_PRESENTATION_GET_KIND = GOOGLE_SLIDES_PRESENTATION_GET_KIND;
+exports.GOOGLE_SLIDES_PRESENTATION_GET_META = GOOGLE_SLIDES_PRESENTATION_GET_META;
+exports.GOOGLE_SLIDES_PRESENTATION_GET_OPERATION = GOOGLE_SLIDES_PRESENTATION_GET_OPERATION;
+exports.GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT = GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT;
 exports.GOOGLE_SLIDES_PRESENTATION_KIND = GOOGLE_SLIDES_PRESENTATION_KIND;
 exports.GOOGLE_SLIDES_PRESENTATION_META = GOOGLE_SLIDES_PRESENTATION_META;
 exports.GOOGLE_SLIDES_PRESENTATION_OPERATION = GOOGLE_SLIDES_PRESENTATION_OPERATION;
 exports.GOOGLE_SLIDES_PRESENTATION_OUTPUT = GOOGLE_SLIDES_PRESENTATION_OUTPUT;
 exports.GOOGLE_SLIDES_SERVICE = GOOGLE_SLIDES_SERVICE;
 exports.googleSlidesMeta = googleSlidesMeta;
+exports.googleSlidesPresentationGetKind = googleSlidesPresentationGetKind;
 exports.googleSlidesPresentationKind = googleSlidesPresentationKind;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/service.ts","../src/kinds/presentation-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_slides\n */\n\n/**\n * Google Slides's identity on the authoring surface, shared by every Google\n * Slides 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 Slides. A test presentation is a real one in a\n * real Drive, so every create is real -- use the faker while developing and\n * clean up any live test presentations.\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_SLIDES_SERVICE = {\n  service: \"google_slides\",\n  serviceTitle: \"Google Slides\",\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 Slides connection holds. */\nexport const GOOGLE_SLIDES_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 Slides 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_SLIDES_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/presentations\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Slides node's connector metadata from the operation it performs. */\nexport function googleSlidesMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SLIDES_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/presentation-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/presentation-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides presentation — Create a blank Google Slides presentation.\n *\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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 { googleSlidesMeta } from \"../service.js\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_KIND = \"@particle-academy/google_slides_presentation\";\nexport const GOOGLE_SLIDES_PRESENTATION_OPERATION = \"presentation_create\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_META = googleSlidesMeta(\"action\", \"create a blank presentation\", \"https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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_SLIDES_PRESENTATION_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.presentationId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created presentation.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleSlidesPresentationKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_META, {\n  name: GOOGLE_SLIDES_PRESENTATION_KIND,\n  aliases: [\"google_slides_presentation\"],\n  label: \"Google Slides presentation\",\n  description: \"Create a blank Google Slides presentation.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SLIDES_PRESENTATION_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank presentation.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SLIDES_PRESENTATION_META, config as Record<string, unknown>, \"create a blank presentation\"),\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_slides\n */\n\n/**\n * Google Slides'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/presentation-create.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSlidesPresentationKind } from \"./kinds/presentation-create.js\";\n\n/** Every Google Slides kind, for a host that registers the lot. */\nexport const GOOGLE_SLIDES_KINDS: NodeKindDefinition[] = [\n  googleSlidesPresentationKind,\n];\n"]}
+{"version":3,"sources":["../src/service.ts","../src/kinds/presentation-create.ts","../src/kinds/presentation-get.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_slides\n */\n\n/**\n * Google Slides's identity on the authoring surface, shared by every Google\n * Slides 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 Slides. A test presentation is a real one in a\n * real Drive, so every create is real -- use the faker while developing and\n * clean up any live test presentations.\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_SLIDES_SERVICE = {\n  service: \"google_slides\",\n  serviceTitle: \"Google Slides\",\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 Slides connection holds. */\nexport const GOOGLE_SLIDES_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 Slides 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_SLIDES_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/presentations\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Slides node's connector metadata from the operation it performs. */\nexport function googleSlidesMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SLIDES_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/presentation-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/presentation-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides presentation — Create a blank Google Slides presentation.\n *\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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 { googleSlidesMeta } from \"../service.js\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_KIND = \"@particle-academy/google_slides_presentation\";\nexport const GOOGLE_SLIDES_PRESENTATION_OPERATION = \"presentation_create\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_META = googleSlidesMeta(\"action\", \"create a blank presentation\", \"https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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_SLIDES_PRESENTATION_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.presentationId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created presentation.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleSlidesPresentationKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_META, {\n  name: GOOGLE_SLIDES_PRESENTATION_KIND,\n  aliases: [\"google_slides_presentation\"],\n  label: \"Google Slides presentation\",\n  description: \"Create a blank Google Slides presentation.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SLIDES_PRESENTATION_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank presentation.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SLIDES_PRESENTATION_META, config as Record<string, unknown>, \"create a blank presentation\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/presentation-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/presentation-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides presentation — Read a presentation's slides and the objectId\n * of every element on them -- the prerequisite for targeting a specific shape\n * or placeholder with a future edit.\n *\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSlidesMeta } from \"../service.js\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_GET_KIND = \"@particle-academy/google_slides_presentation_get\";\nexport const GOOGLE_SLIDES_PRESENTATION_GET_OPERATION = \"presentation_get\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_GET_META = googleSlidesMeta(\"action\", \"read a presentation\", \"https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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_SLIDES_PRESENTATION_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.presentationId\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was asked.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The presentation's title.\"\n  },\n  {\n    \"path\": \"data.locale\",\n    \"type\": \"string\",\n    \"description\": \"BCP 47 language tag.\"\n  },\n  {\n    \"path\": \"data.slides\",\n    \"type\": \"array\",\n    \"description\": \"One entry per slide, in order: objectId, and pageElements -- each with its own objectId and exactly one of shape/image/table/line/video/wordArt/sheetsChart/elementGroup/speakerSpotlight set, naming what kind of element it is. A placeholder shape's text (when it has one) lives at pageElements[].shape.text, published raw -- this connector does not flatten Slides' own rich-text run structure.\"\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 googleSlidesPresentationGetKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_GET_META, {\n  name: GOOGLE_SLIDES_PRESENTATION_GET_KIND,\n  aliases: [\"google_slides_presentation_get\"],\n  label: \"Google Slides presentation\",\n  description: \"Read a presentation's slides and the objectId of every element on them -- the prerequisite for targeting a specific shape or placeholder with a future edit.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"presentationId\",\n      \"label\": \"Presentation ID\",\n      \"required\": true,\n      \"description\": \"From presentation_create's data.presentationId, or the id in the presentation's own URL.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SLIDES_PRESENTATION_GET_META, config as Record<string, unknown>, \"read a presentation\"),\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_slides\n */\n\n/**\n * Google Slides'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/presentation-create.js\";\nexport * from \"./kinds/presentation-get.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSlidesPresentationKind } from \"./kinds/presentation-create.js\";\nimport { googleSlidesPresentationGetKind } from \"./kinds/presentation-get.js\";\n\n/** Every Google Slides kind, for a host that registers the lot. */\nexport const GOOGLE_SLIDES_KINDS: NodeKindDefinition[] = [\n  googleSlidesPresentationKind,\n  googleSlidesPresentationGetKind,\n];\n"]}

package/dist/index.d.cts

@@ -112,6 +112,20 @@ declare const GOOGLE_SLIDES_PRESENTATION_META: _particle_academy_fancy_flow_conn
 declare const GOOGLE_SLIDES_PRESENTATION_OUTPUT: OutputField[];
 declare const googleSlidesPresentationKind: NodeKindDefinition;
 
+declare const GOOGLE_SLIDES_PRESENTATION_GET_KIND = "@particle-academy/google_slides_presentation_get";
+declare const GOOGLE_SLIDES_PRESENTATION_GET_OPERATION = "presentation_get";
+declare const GOOGLE_SLIDES_PRESENTATION_GET_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_SLIDES_PRESENTATION_GET_OUTPUT: OutputField[];
+declare const googleSlidesPresentationGetKind: NodeKindDefinition;
+
 /**
  * GENERATED FILE — do not edit.
  *
@@ -133,4 +147,4 @@ declare const googleSlidesPresentationKind: NodeKindDefinition;
 /** Every Google Slides kind, for a host that registers the lot. */
 declare const GOOGLE_SLIDES_KINDS: NodeKindDefinition[];
 
-export { CONNECTOR_API_VERSION, GOOGLE_SLIDES_CREDENTIALS, GOOGLE_SLIDES_KINDS, GOOGLE_SLIDES_OAUTH, GOOGLE_SLIDES_PRESENTATION_KIND, GOOGLE_SLIDES_PRESENTATION_META, GOOGLE_SLIDES_PRESENTATION_OPERATION, GOOGLE_SLIDES_PRESENTATION_OUTPUT, GOOGLE_SLIDES_SERVICE, googleSlidesMeta, googleSlidesPresentationKind };
+export { CONNECTOR_API_VERSION, GOOGLE_SLIDES_CREDENTIALS, GOOGLE_SLIDES_KINDS, GOOGLE_SLIDES_OAUTH, GOOGLE_SLIDES_PRESENTATION_GET_KIND, GOOGLE_SLIDES_PRESENTATION_GET_META, GOOGLE_SLIDES_PRESENTATION_GET_OPERATION, GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT, GOOGLE_SLIDES_PRESENTATION_KIND, GOOGLE_SLIDES_PRESENTATION_META, GOOGLE_SLIDES_PRESENTATION_OPERATION, GOOGLE_SLIDES_PRESENTATION_OUTPUT, GOOGLE_SLIDES_SERVICE, googleSlidesMeta, googleSlidesPresentationGetKind, googleSlidesPresentationKind };

package/dist/index.d.ts

@@ -112,6 +112,20 @@ declare const GOOGLE_SLIDES_PRESENTATION_META: _particle_academy_fancy_flow_conn
 declare const GOOGLE_SLIDES_PRESENTATION_OUTPUT: OutputField[];
 declare const googleSlidesPresentationKind: NodeKindDefinition;
 
+declare const GOOGLE_SLIDES_PRESENTATION_GET_KIND = "@particle-academy/google_slides_presentation_get";
+declare const GOOGLE_SLIDES_PRESENTATION_GET_OPERATION = "presentation_get";
+declare const GOOGLE_SLIDES_PRESENTATION_GET_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_SLIDES_PRESENTATION_GET_OUTPUT: OutputField[];
+declare const googleSlidesPresentationGetKind: NodeKindDefinition;
+
 /**
  * GENERATED FILE — do not edit.
  *
@@ -133,4 +147,4 @@ declare const googleSlidesPresentationKind: NodeKindDefinition;
 /** Every Google Slides kind, for a host that registers the lot. */
 declare const GOOGLE_SLIDES_KINDS: NodeKindDefinition[];
 
-export { CONNECTOR_API_VERSION, GOOGLE_SLIDES_CREDENTIALS, GOOGLE_SLIDES_KINDS, GOOGLE_SLIDES_OAUTH, GOOGLE_SLIDES_PRESENTATION_KIND, GOOGLE_SLIDES_PRESENTATION_META, GOOGLE_SLIDES_PRESENTATION_OPERATION, GOOGLE_SLIDES_PRESENTATION_OUTPUT, GOOGLE_SLIDES_SERVICE, googleSlidesMeta, googleSlidesPresentationKind };
+export { CONNECTOR_API_VERSION, GOOGLE_SLIDES_CREDENTIALS, GOOGLE_SLIDES_KINDS, GOOGLE_SLIDES_OAUTH, GOOGLE_SLIDES_PRESENTATION_GET_KIND, GOOGLE_SLIDES_PRESENTATION_GET_META, GOOGLE_SLIDES_PRESENTATION_GET_OPERATION, GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT, GOOGLE_SLIDES_PRESENTATION_KIND, GOOGLE_SLIDES_PRESENTATION_META, GOOGLE_SLIDES_PRESENTATION_OPERATION, GOOGLE_SLIDES_PRESENTATION_OUTPUT, GOOGLE_SLIDES_SERVICE, googleSlidesMeta, googleSlidesPresentationGetKind, googleSlidesPresentationKind };

package/dist/index.js

@@ -91,12 +91,66 @@ var googleSlidesPresentationKind = defineConnectorKind(GOOGLE_SLIDES_PRESENTATIO
   },
   renderBody: ({ config }) => summarize(GOOGLE_SLIDES_PRESENTATION_META, config, "create a blank presentation")
 });
+var GOOGLE_SLIDES_PRESENTATION_GET_KIND = "@particle-academy/google_slides_presentation_get";
+var GOOGLE_SLIDES_PRESENTATION_GET_OPERATION = "presentation_get";
+var GOOGLE_SLIDES_PRESENTATION_GET_META = googleSlidesMeta("action", "read a presentation", "https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get");
+var GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT = [
+  {
+    "path": "data.presentationId",
+    "type": "string",
+    "description": "Echoes what was asked."
+  },
+  {
+    "path": "data.title",
+    "type": "string",
+    "description": "The presentation's title."
+  },
+  {
+    "path": "data.locale",
+    "type": "string",
+    "description": "BCP 47 language tag."
+  },
+  {
+    "path": "data.slides",
+    "type": "array",
+    "description": "One entry per slide, in order: objectId, and pageElements -- each with its own objectId and exactly one of shape/image/table/line/video/wordArt/sheetsChart/elementGroup/speakerSpotlight set, naming what kind of element it is. A placeholder shape's text (when it has one) lives at pageElements[].shape.text, published raw -- this connector does not flatten Slides' own rich-text run structure."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var googleSlidesPresentationGetKind = defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_GET_META, {
+  name: GOOGLE_SLIDES_PRESENTATION_GET_KIND,
+  aliases: ["google_slides_presentation_get"],
+  label: "Google Slides presentation",
+  description: "Read a presentation's slides and the objectId of every element on them -- the prerequisite for targeting a specific shape or placeholder with a future edit.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "presentationId",
+      "label": "Presentation ID",
+      "required": true,
+      "description": "From presentation_create's data.presentationId, or the id in the presentation's own URL."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => summarize(GOOGLE_SLIDES_PRESENTATION_GET_META, config, "read a presentation")
+});
 
 // src/index.ts
 var GOOGLE_SLIDES_KINDS = [
-  googleSlidesPresentationKind
+  googleSlidesPresentationKind,
+  googleSlidesPresentationGetKind
 ];
 
-export { CONNECTOR_API_VERSION, GOOGLE_SLIDES_CREDENTIALS, GOOGLE_SLIDES_KINDS, GOOGLE_SLIDES_OAUTH, GOOGLE_SLIDES_PRESENTATION_KIND, GOOGLE_SLIDES_PRESENTATION_META, GOOGLE_SLIDES_PRESENTATION_OPERATION, GOOGLE_SLIDES_PRESENTATION_OUTPUT, GOOGLE_SLIDES_SERVICE, googleSlidesMeta, googleSlidesPresentationKind };
+export { CONNECTOR_API_VERSION, GOOGLE_SLIDES_CREDENTIALS, GOOGLE_SLIDES_KINDS, GOOGLE_SLIDES_OAUTH, GOOGLE_SLIDES_PRESENTATION_GET_KIND, GOOGLE_SLIDES_PRESENTATION_GET_META, GOOGLE_SLIDES_PRESENTATION_GET_OPERATION, GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT, GOOGLE_SLIDES_PRESENTATION_KIND, GOOGLE_SLIDES_PRESENTATION_META, GOOGLE_SLIDES_PRESENTATION_OPERATION, GOOGLE_SLIDES_PRESENTATION_OUTPUT, GOOGLE_SLIDES_SERVICE, googleSlidesMeta, googleSlidesPresentationGetKind, googleSlidesPresentationKind };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/service.ts","../src/kinds/presentation-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_slides\n */\n\n/**\n * Google Slides's identity on the authoring surface, shared by every Google\n * Slides 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 Slides. A test presentation is a real one in a\n * real Drive, so every create is real -- use the faker while developing and\n * clean up any live test presentations.\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_SLIDES_SERVICE = {\n  service: \"google_slides\",\n  serviceTitle: \"Google Slides\",\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 Slides connection holds. */\nexport const GOOGLE_SLIDES_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 Slides 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_SLIDES_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/presentations\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Slides node's connector metadata from the operation it performs. */\nexport function googleSlidesMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SLIDES_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/presentation-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/presentation-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides presentation — Create a blank Google Slides presentation.\n *\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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 { googleSlidesMeta } from \"../service.js\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_KIND = \"@particle-academy/google_slides_presentation\";\nexport const GOOGLE_SLIDES_PRESENTATION_OPERATION = \"presentation_create\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_META = googleSlidesMeta(\"action\", \"create a blank presentation\", \"https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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_SLIDES_PRESENTATION_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.presentationId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created presentation.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleSlidesPresentationKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_META, {\n  name: GOOGLE_SLIDES_PRESENTATION_KIND,\n  aliases: [\"google_slides_presentation\"],\n  label: \"Google Slides presentation\",\n  description: \"Create a blank Google Slides presentation.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SLIDES_PRESENTATION_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank presentation.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SLIDES_PRESENTATION_META, config as Record<string, unknown>, \"create a blank presentation\"),\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_slides\n */\n\n/**\n * Google Slides'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/presentation-create.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSlidesPresentationKind } from \"./kinds/presentation-create.js\";\n\n/** Every Google Slides kind, for a host that registers the lot. */\nexport const GOOGLE_SLIDES_KINDS: NodeKindDefinition[] = [\n  googleSlidesPresentationKind,\n];\n"]}
+{"version":3,"sources":["../src/service.ts","../src/kinds/presentation-create.ts","../src/kinds/presentation-get.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":";;;AAkCO,IAAM,qBAAA,GAAwB;AAG9B,IAAM,qBAAA,GAAwB;AAAA,EACnC,OAAA,EAAS,eAAA;AAAA,EACT,YAAA,EAAc,eAAA;AAAA,EACd,MAAA,EAAQ,cAAA;AAAA,EACR,OAAA,EAAS;AACX;AA+BO,IAAM,yBAAA,GAA4B;AAAA,EACvC;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,mBAAA,GAAsB;AAAA,EACjC,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,gBAAA,CACd,IAAA,EACA,SAAA,EACA,IAAA,EACe;AACf,EAAA,OAAO,EAAE,GAAG,qBAAA,EAAuB,IAAA,EAAM,WAAW,IAAA,EAAK;AAC3D;ACvHO,IAAM,+BAAA,GAAkC;AACxC,IAAM,oCAAA,GAAuC;AAE7C,IAAM,+BAAA,GAAkC,gBAAA,CAAiB,QAAA,EAAU,6BAAA,EAA+B,2FAA2F;AAU7L,IAAM,iCAAA,GAAmD;AAAA,EAC9D;AAAA,IACE,MAAA,EAAQ,qBAAA;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,4BAAA,GAAmD,oBAAoB,+BAAA,EAAiC;AAAA,EACnH,IAAA,EAAM,+BAAA;AAAA,EACN,OAAA,EAAS,CAAC,4BAA4B,CAAA;AAAA,EACtC,KAAA,EAAO,4BAAA;AAAA,EACP,WAAA,EAAa,4CAAA;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,iCAAA;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,OACb,SAAA,CAAU,+BAAA,EAAiC,QAAmC,6BAA6B;AAC/G,CAAC;ACjDM,IAAM,mCAAA,GAAsC;AAC5C,IAAM,wCAAA,GAA2C;AAEjD,IAAM,mCAAA,GAAsC,gBAAA,CAAiB,QAAA,EAAU,qBAAA,EAAuB,wFAAwF;AAUtL,IAAM,qCAAA,GAAuD;AAAA,EAClE;AAAA,IACE,MAAA,EAAQ,qBAAA;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,GACjB;AAAA,EACA;AAAA,IACE,MAAA,EAAQ,aAAA;AAAA,IACR,MAAA,EAAQ,QAAA;AAAA,IACR,aAAA,EAAe;AAAA,GACjB;AAAA,EACA;AAAA,IACE,MAAA,EAAQ,aAAA;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,+BAAA,GAAsDA,oBAAoB,mCAAA,EAAqC;AAAA,EAC1H,IAAA,EAAM,mCAAA;AAAA,EACN,OAAA,EAAS,CAAC,gCAAgC,CAAA;AAAA,EAC1C,KAAA,EAAO,4BAAA;AAAA,EACP,WAAA,EAAa,8JAAA;AAAA,EACb,MAAA,EAAQ,CAAC,EAAE,EAAA,EAAI,MAAM,CAAA;AAAA,EACrB,OAAA,EAAS,CAAC,EAAE,EAAA,EAAI,OAAO,CAAA;AAAA,EACvB,WAAA,EAAa,MAAA;AAAA,EACb,WAAA,EAAa,qCAAA;AAAA,EACb,YAAA,EAAc;AAAA,IACZ;AAAA,MACE,MAAA,EAAQ,MAAA;AAAA,MACR,KAAA,EAAO,gBAAA;AAAA,MACP,OAAA,EAAS,iBAAA;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,SAAAA,CAAU,mCAAA,EAAqC,QAAmC,qBAAqB;AAC3G,CAAC;;;AC3DM,IAAM,mBAAA,GAA4C;AAAA,EACvD,4BAAA;AAAA,EACA;AACF","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_slides\n */\n\n/**\n * Google Slides's identity on the authoring surface, shared by every Google\n * Slides 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 Slides. A test presentation is a real one in a\n * real Drive, so every create is real -- use the faker while developing and\n * clean up any live test presentations.\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_SLIDES_SERVICE = {\n  service: \"google_slides\",\n  serviceTitle: \"Google Slides\",\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 Slides connection holds. */\nexport const GOOGLE_SLIDES_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 Slides 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_SLIDES_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/presentations\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Slides node's connector metadata from the operation it performs. */\nexport function googleSlidesMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_SLIDES_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/presentation-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/presentation-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides presentation — Create a blank Google Slides presentation.\n *\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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 { googleSlidesMeta } from \"../service.js\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_KIND = \"@particle-academy/google_slides_presentation\";\nexport const GOOGLE_SLIDES_PRESENTATION_OPERATION = \"presentation_create\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_META = googleSlidesMeta(\"action\", \"create a blank presentation\", \"https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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_SLIDES_PRESENTATION_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.presentationId\",\n    \"type\": \"string\",\n    \"description\": \"The id of the created presentation.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The title Google stored.\"\n  }\n];\n\nexport const googleSlidesPresentationKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_META, {\n  name: GOOGLE_SLIDES_PRESENTATION_KIND,\n  aliases: [\"google_slides_presentation\"],\n  label: \"Google Slides presentation\",\n  description: \"Create a blank Google Slides presentation.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"unsafe-to-replay\",\n  outputShape: GOOGLE_SLIDES_PRESENTATION_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"title\",\n      \"label\": \"Title\",\n      \"required\": true,\n      \"description\": \"The title of the new blank presentation.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SLIDES_PRESENTATION_META, config as Record<string, unknown>, \"create a blank presentation\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/presentation-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/presentation-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides presentation — Read a presentation's slides and the objectId\n * of every element on them -- the prerequisite for targeting a specific shape\n * or placeholder with a future edit.\n *\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleSlidesMeta } from \"../service.js\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_GET_KIND = \"@particle-academy/google_slides_presentation_get\";\nexport const GOOGLE_SLIDES_PRESENTATION_GET_OPERATION = \"presentation_get\";\n\nexport const GOOGLE_SLIDES_PRESENTATION_GET_META = googleSlidesMeta(\"action\", \"read a presentation\", \"https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/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_SLIDES_PRESENTATION_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.presentationId\",\n    \"type\": \"string\",\n    \"description\": \"Echoes what was asked.\"\n  },\n  {\n    \"path\": \"data.title\",\n    \"type\": \"string\",\n    \"description\": \"The presentation's title.\"\n  },\n  {\n    \"path\": \"data.locale\",\n    \"type\": \"string\",\n    \"description\": \"BCP 47 language tag.\"\n  },\n  {\n    \"path\": \"data.slides\",\n    \"type\": \"array\",\n    \"description\": \"One entry per slide, in order: objectId, and pageElements -- each with its own objectId and exactly one of shape/image/table/line/video/wordArt/sheetsChart/elementGroup/speakerSpotlight set, naming what kind of element it is. A placeholder shape's text (when it has one) lives at pageElements[].shape.text, published raw -- this connector does not flatten Slides' own rich-text run structure.\"\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 googleSlidesPresentationGetKind: NodeKindDefinition = defineConnectorKind(GOOGLE_SLIDES_PRESENTATION_GET_META, {\n  name: GOOGLE_SLIDES_PRESENTATION_GET_KIND,\n  aliases: [\"google_slides_presentation_get\"],\n  label: \"Google Slides presentation\",\n  description: \"Read a presentation's slides and the objectId of every element on them -- the prerequisite for targeting a specific shape or placeholder with a future edit.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_SLIDES_PRESENTATION_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"presentationId\",\n      \"label\": \"Presentation ID\",\n      \"required\": true,\n      \"description\": \"From presentation_create's data.presentationId, or the id in the presentation's own URL.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_SLIDES_PRESENTATION_GET_META, config as Record<string, unknown>, \"read a presentation\"),\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_slides\n */\n\n/**\n * Google Slides'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/presentation-create.js\";\nexport * from \"./kinds/presentation-get.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleSlidesPresentationKind } from \"./kinds/presentation-create.js\";\nimport { googleSlidesPresentationGetKind } from \"./kinds/presentation-get.js\";\n\n/** Every Google Slides kind, for a host that registers the lot. */\nexport const GOOGLE_SLIDES_KINDS: NodeKindDefinition[] = [\n  googleSlidesPresentationKind,\n  googleSlidesPresentationGetKind,\n];\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/google-slides-ui",
-  "version": "0.3.4",
+  "version": "0.5.0",
   "description": "Google Slides'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"