@particle-academy/google-slides-js 0.3.3 → 0.4.0

package/CHANGELOG.md

@@ -8,6 +8,24 @@ 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
+
+- **`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
+
+- **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 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/{chunk-3WQSJ3XH.js → chunk-4BEANSYY.js}

@@ -7,10 +7,50 @@ function fakePresentationCreate({ config, fake }) {
     "title": config.title !== void 0 && config.title !== null && config.title !== "" ? String(config.title) : "Untitled presentation"
   };
 }
+function fakePresentationGet({ config, fake }) {
+  return {
+    "presentationId": config.presentationId !== void 0 && config.presentationId !== null && config.presentationId !== "" ? String(config.presentationId) : fake.id("1Slide"),
+    "title": "Untitled presentation",
+    "locale": "en",
+    "slides": [
+      {
+        "objectId": fake.id("slide"),
+        "pageElements": [
+          {
+            "objectId": fake.id("title"),
+            "shape": {
+              "shapeType": "TEXT_BOX",
+              "placeholder": {
+                "type": "CENTERED_TITLE"
+              },
+              "text": {
+                "textElements": []
+              }
+            }
+          },
+          {
+            "objectId": fake.id("subtitle"),
+            "shape": {
+              "shapeType": "TEXT_BOX",
+              "placeholder": {
+                "type": "SUBTITLE"
+              },
+              "text": {
+                "textElements": []
+              }
+            }
+          }
+        ]
+      }
+    ]
+  };
+}
 var googleSlidesFaker = (operation, request) => {
   switch (operation) {
     case "presentation_create":
       return fakePresentationCreate(request);
+    case "presentation_get":
+      return fakePresentationGet(request);
     default:
       throw new Error(
         `google_slides: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
@@ -65,7 +105,29 @@ async function googleSlidesPresentationCreate(options) {
     }
   });
 }
+var PRESENTATION_GET_OPERATION = "presentation_get";
+async function googleSlidesPresentationGet(options) {
+  const config = options.config ?? {};
+  if (config.presentationId === void 0 || config.presentationId === null || config.presentationId === "") {
+    throw new Error(`presentation_get: "presentationId" is required (Presentation ID).`);
+  }
+  return callConnector(GOOGLE_SLIDES, {
+    operation: PRESENTATION_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/v1/presentations/${encodeURIComponent(String(config.presentationId))}`,
+      query: {}
+    }
+  });
+}
 
-export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate };
-//# sourceMappingURL=chunk-3WQSJ3XH.js.map
-//# sourceMappingURL=chunk-3WQSJ3XH.js.map
+export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, PRESENTATION_GET_OPERATION, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate, googleSlidesPresentationGet };
+//# sourceMappingURL=chunk-4BEANSYY.js.map
+//# sourceMappingURL=chunk-4BEANSYY.js.map

package/dist/chunk-4BEANSYY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/presentation-create.ts","../src/actions/presentation-get.ts"],"names":["callConnector"],"mappings":";;;AA0BA,SAAS,sBAAA,CAAuB,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AACtE,EAAA,OAAO;AAAA,IACL,gBAAA,EAAkB,IAAA,CAAK,EAAA,CAAG,QAAQ,CAAA;AAAA,IAClC,OAAA,EAAU,MAAA,CAAO,KAAA,KAAU,MAAA,IAAa,MAAA,CAAO,KAAA,KAAU,IAAA,IAAQ,MAAA,CAAO,KAAA,KAAU,EAAA,GAAK,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA,GAAI;AAAA,GAChH;AACF;AAEA,SAAS,mBAAA,CAAoB,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AACnE,EAAA,OAAO;AAAA,IACL,kBAAmB,MAAA,CAAO,cAAA,KAAmB,MAAA,IAAa,MAAA,CAAO,mBAAmB,IAAA,IAAQ,MAAA,CAAO,cAAA,KAAmB,EAAA,GAAK,OAAO,MAAA,CAAO,cAAc,CAAA,GAAI,IAAA,CAAK,GAAG,QAAQ,CAAA;AAAA,IAC3K,OAAA,EAAS,uBAAA;AAAA,IACT,QAAA,EAAU,IAAA;AAAA,IACV,QAAA,EAAU;AAAA,MACR;AAAA,QACE,UAAA,EAAY,IAAA,CAAK,EAAA,CAAG,OAAO,CAAA;AAAA,QAC3B,cAAA,EAAgB;AAAA,UACd;AAAA,YACE,UAAA,EAAY,IAAA,CAAK,EAAA,CAAG,OAAO,CAAA;AAAA,YAC3B,OAAA,EAAS;AAAA,cACP,WAAA,EAAa,UAAA;AAAA,cACb,aAAA,EAAe;AAAA,gBACb,MAAA,EAAQ;AAAA,eACV;AAAA,cACA,MAAA,EAAQ;AAAA,gBACN,gBAAgB;AAAC;AACnB;AACF,WACF;AAAA,UACA;AAAA,YACE,UAAA,EAAY,IAAA,CAAK,EAAA,CAAG,UAAU,CAAA;AAAA,YAC9B,OAAA,EAAS;AAAA,cACP,WAAA,EAAa,UAAA;AAAA,cACb,aAAA,EAAe;AAAA,gBACb,MAAA,EAAQ;AAAA,eACV;AAAA,cACA,MAAA,EAAQ;AAAA,gBACN,gBAAgB;AAAC;AACnB;AACF;AACF;AACF;AACF;AACF,GACF;AACF;AAEO,IAAM,iBAAA,GAAoC,CAAC,SAAA,EAAW,OAAA,KAAY;AACvE,EAAA,QAAQ,SAAA;AAAW,IACjB,KAAK,qBAAA;AACH,MAAA,OAAO,uBAAuB,OAAO,CAAA;AAAA,IAEvC,KAAK,kBAAA;AACH,MAAA,OAAO,oBAAoB,OAAO,CAAA;AAAA,IAEpC;AAIE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,mDAAmD,SAAS,CAAA,iJAAA;AAAA,OAG9D;AAAA;AAEN;;;ACrDO,IAAM,qBAAA,GAAwB;AAE9B,IAAM,uBAAA,GAA0B;AAAA,EACrC,MAAA,EAAQ;AACV;AAGO,IAAM,sBAAA,GAAyB;AAAA,EACpC,aAAA;AAAA,EACA,cAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAWO,SAAS,qBAAA,CACd,WAAA,EACA,OAAA,EACA,KAAA,EACM;AACN,EAAA,OAAA,CAAQ,OAAA,CAAQ,aAAA,GAAgB,CAAA,OAAA,EAAU,WAAA,CAAY,eAAe,EAAE,CAAA,CAAA;AACzE;AAGO,IAAM,aAAA,GAAmC;AAAA,EAC9C,OAAA,EAAS,eAAA;AAAA,EACT,KAAA,EAAO,eAAA;AAAA,EACP,OAAA,EAAS,MAAA;AAAA,EACT,QAAA,EAAU,EAAE,GAAG,uBAAA,EAAwB;AAAA,EACvC,QAAA,EAAU,CAAC,GAAG,sBAAsB,CAAA;AAAA,EACpC,SAAA,EAAW,qBAAA;AAAA,EACX,KAAA,EAAO;AACT;AC5CO,IAAM,6BAAA,GAAgC;AAc7C,eAAsB,+BAA+B,OAAA,EAA8D;AACjH,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,IAAa,MAAA,CAAO,UAAU,IAAA,IAAQ,MAAA,CAAO,UAAU,EAAA,EAAI;AAC9E,IAAA,MAAM,IAAI,MAAM,CAAA,iDAAA,CAAmD,CAAA;AAAA,EACrE;AAEA,EAAA,OAAO,cAAc,aAAA,EAAe;AAAA,IAClC,SAAA,EAAW,6BAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,mBAAA;AAAA,MACN,IAAA,EAAM;AAAA,QACJ,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,KAAK;AAAA;AAC9B;AACF,GACD,CAAA;AACH;ACtCO,IAAM,0BAAA,GAA6B;AAc1C,eAAsB,4BAA4B,OAAA,EAA2D;AAC3G,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,mBAAmB,MAAA,IAAa,MAAA,CAAO,mBAAmB,IAAA,IAAQ,MAAA,CAAO,mBAAmB,EAAA,EAAI;AACzG,IAAA,MAAM,IAAI,MAAM,CAAA,iEAAA,CAAmE,CAAA;AAAA,EACrF;AAEA,EAAA,OAAOA,cAAc,aAAA,EAAe;AAAA,IAClC,SAAA,EAAW,0BAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,KAAA;AAAA,MACR,MAAM,CAAA,kBAAA,EAAqB,kBAAA,CAAmB,OAAO,MAAA,CAAO,cAAc,CAAC,CAAC,CAAA,CAAA;AAAA,MAC5E,OAAO;AAAC;AACV,GACD,CAAA;AACH","file":"chunk-4BEANSYY.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * The Google Slides faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Slides actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakePresentationCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": fake.id(\"1Slide\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled presentation\"),\n  };\n}\n\nfunction fakePresentationGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": (config.presentationId !== undefined && config.presentationId !== null && config.presentationId !== \"\" ? String(config.presentationId) : fake.id(\"1Slide\")),\n    \"title\": \"Untitled presentation\",\n    \"locale\": \"en\",\n    \"slides\": [\n      {\n        \"objectId\": fake.id(\"slide\"),\n        \"pageElements\": [\n          {\n            \"objectId\": fake.id(\"title\"),\n            \"shape\": {\n              \"shapeType\": \"TEXT_BOX\",\n              \"placeholder\": {\n                \"type\": \"CENTERED_TITLE\",\n              },\n              \"text\": {\n                \"textElements\": [],\n              },\n            },\n          },\n          {\n            \"objectId\": fake.id(\"subtitle\"),\n            \"shape\": {\n              \"shapeType\": \"TEXT_BOX\",\n              \"placeholder\": {\n                \"type\": \"SUBTITLE\",\n              },\n              \"text\": {\n                \"textElements\": [],\n              },\n            },\n          },\n        ],\n      },\n    ],\n  };\n}\n\nexport const googleSlidesFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"presentation_create\":\n      return fakePresentationCreate(request);\n\n    case \"presentation_get\":\n      return fakePresentationGet(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_slides: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides, as one service descriptor shared by every Google Slides\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Slides: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for 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 { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSlidesFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SLIDES_BASE_URLS = {\n  \"live\": \"https://slides.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SLIDES_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Slides's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSlidesAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Slides service, for the TypeScript runtime. */\nexport const GOOGLE_SLIDES: ServiceDescriptor = {\n  service: \"google_slides\",\n  title: \"Google Slides\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SLIDES_BASE_URLS },\n  requires: [...GOOGLE_SLIDES_REQUIRES],\n  authorize: googleSlidesAuthorize,\n  faker: googleSlidesFaker,\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 * Create a blank Google Slides presentation.\n *\n * POST /v1/presentations —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_CREATE_OPERATION = \"presentation_create\";\n\nexport type PresentationCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`presentation_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/presentations\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\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 * Read a presentation's slides and the objectId of every element on them --\n * the prerequisite for targeting a specific shape or placeholder with a future\n * edit.\n *\n * GET /v1/presentations/{presentationId} —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_GET_OPERATION = \"presentation_get\";\n\nexport type PresentationGetOptions = {\n  /** The node's resolved config. Keys: presentationId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationGet(options: PresentationGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.presentationId === undefined || config.presentationId === null || config.presentationId === \"\") {\n    throw new Error(`presentation_get: \"presentationId\" is required (Presentation ID).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/v1/presentations/${encodeURIComponent(String(config.presentationId))}`,\n      query: {},\n    },\n  });\n}\n"]}

package/dist/flow.cjs

@@ -12,10 +12,50 @@ function fakePresentationCreate({ config, fake }) {
     "title": config.title !== void 0 && config.title !== null && config.title !== "" ? String(config.title) : "Untitled presentation"
   };
 }
+function fakePresentationGet({ config, fake }) {
+  return {
+    "presentationId": config.presentationId !== void 0 && config.presentationId !== null && config.presentationId !== "" ? String(config.presentationId) : fake.id("1Slide"),
+    "title": "Untitled presentation",
+    "locale": "en",
+    "slides": [
+      {
+        "objectId": fake.id("slide"),
+        "pageElements": [
+          {
+            "objectId": fake.id("title"),
+            "shape": {
+              "shapeType": "TEXT_BOX",
+              "placeholder": {
+                "type": "CENTERED_TITLE"
+              },
+              "text": {
+                "textElements": []
+              }
+            }
+          },
+          {
+            "objectId": fake.id("subtitle"),
+            "shape": {
+              "shapeType": "TEXT_BOX",
+              "placeholder": {
+                "type": "SUBTITLE"
+              },
+              "text": {
+                "textElements": []
+              }
+            }
+          }
+        ]
+      }
+    ]
+  };
+}
 var googleSlidesFaker = (operation, request) => {
   switch (operation) {
     case "presentation_create":
       return fakePresentationCreate(request);
+    case "presentation_get":
+      return fakePresentationGet(request);
     default:
       throw new Error(
         `google_slides: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
@@ -69,6 +109,28 @@ async function googleSlidesPresentationCreate(options) {
     }
   });
 }
+var PRESENTATION_GET_OPERATION = "presentation_get";
+async function googleSlidesPresentationGet(options) {
+  const config = options.config ?? {};
+  if (config.presentationId === void 0 || config.presentationId === null || config.presentationId === "") {
+    throw new Error(`presentation_get: "presentationId" is required (Presentation ID).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_SLIDES, {
+    operation: PRESENTATION_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/v1/presentations/${encodeURIComponent(String(config.presentationId))}`,
+      query: {}
+    }
+  });
+}
 
 // src/flow.ts
 var googleSlidesPresentationExecutor = async (ctx) => {
@@ -85,11 +147,27 @@ var googleSlidesPresentationExecutor = async (ctx) => {
   });
   return { __port: "out", value: result };
 };
+var googleSlidesPresentationGetExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleSlidesPresentationGet({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_slides presentation_get ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
 var GOOGLE_SLIDES_RUNNABLE_KINDS = [
-  { ...googleSlidesUi.googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor }
+  { ...googleSlidesUi.googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor },
+  { ...googleSlidesUi.googleSlidesPresentationGetKind, executor: googleSlidesPresentationGetExecutor }
 ];
 
 exports.GOOGLE_SLIDES_RUNNABLE_KINDS = GOOGLE_SLIDES_RUNNABLE_KINDS;
 exports.googleSlidesPresentationExecutor = googleSlidesPresentationExecutor;
+exports.googleSlidesPresentationGetExecutor = googleSlidesPresentationGetExecutor;
 //# sourceMappingURL=flow.cjs.map
 //# sourceMappingURL=flow.cjs.map

package/dist/flow.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/presentation-create.ts","../src/flow.ts"],"names":["callConnector","googleSlidesPresentationKind"],"mappings":"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","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * The Google Slides faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Slides actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakePresentationCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": fake.id(\"1Slide\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled presentation\"),\n  };\n}\n\nexport const googleSlidesFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"presentation_create\":\n      return fakePresentationCreate(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_slides: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides, as one service descriptor shared by every Google Slides\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Slides: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for 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 { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSlidesFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SLIDES_BASE_URLS = {\n  \"live\": \"https://slides.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SLIDES_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Slides's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSlidesAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Slides service, for the TypeScript runtime. */\nexport const GOOGLE_SLIDES: ServiceDescriptor = {\n  service: \"google_slides\",\n  title: \"Google Slides\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SLIDES_BASE_URLS },\n  requires: [...GOOGLE_SLIDES_REQUIRES],\n  authorize: googleSlidesAuthorize,\n  faker: googleSlidesFaker,\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 * Create a blank Google Slides presentation.\n *\n * POST /v1/presentations —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_CREATE_OPERATION = \"presentation_create\";\n\nexport type PresentationCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`presentation_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/presentations\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-slides-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"./service.js\";\n\nimport {\n  googleSlidesPresentationKind,\n} from \"@particle-academy/google-slides-ui\";\n\nimport { googleSlidesPresentationCreate } from \"./actions/presentation-create.js\";\n\nexport const googleSlidesPresentationExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSlidesPresentationCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_slides presentation_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SLIDES_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor },\n];\n"]}
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/presentation-create.ts","../src/actions/presentation-get.ts","../src/flow.ts"],"names":["callConnector","googleSlidesPresentationKind","googleSlidesPresentationGetKind"],"mappings":"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","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * The Google Slides faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Slides actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakePresentationCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": fake.id(\"1Slide\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled presentation\"),\n  };\n}\n\nfunction fakePresentationGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": (config.presentationId !== undefined && config.presentationId !== null && config.presentationId !== \"\" ? String(config.presentationId) : fake.id(\"1Slide\")),\n    \"title\": \"Untitled presentation\",\n    \"locale\": \"en\",\n    \"slides\": [\n      {\n        \"objectId\": fake.id(\"slide\"),\n        \"pageElements\": [\n          {\n            \"objectId\": fake.id(\"title\"),\n            \"shape\": {\n              \"shapeType\": \"TEXT_BOX\",\n              \"placeholder\": {\n                \"type\": \"CENTERED_TITLE\",\n              },\n              \"text\": {\n                \"textElements\": [],\n              },\n            },\n          },\n          {\n            \"objectId\": fake.id(\"subtitle\"),\n            \"shape\": {\n              \"shapeType\": \"TEXT_BOX\",\n              \"placeholder\": {\n                \"type\": \"SUBTITLE\",\n              },\n              \"text\": {\n                \"textElements\": [],\n              },\n            },\n          },\n        ],\n      },\n    ],\n  };\n}\n\nexport const googleSlidesFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"presentation_create\":\n      return fakePresentationCreate(request);\n\n    case \"presentation_get\":\n      return fakePresentationGet(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_slides: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides, as one service descriptor shared by every Google Slides\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Slides: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for 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 { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSlidesFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SLIDES_BASE_URLS = {\n  \"live\": \"https://slides.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SLIDES_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Slides's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSlidesAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Slides service, for the TypeScript runtime. */\nexport const GOOGLE_SLIDES: ServiceDescriptor = {\n  service: \"google_slides\",\n  title: \"Google Slides\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SLIDES_BASE_URLS },\n  requires: [...GOOGLE_SLIDES_REQUIRES],\n  authorize: googleSlidesAuthorize,\n  faker: googleSlidesFaker,\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 * Create a blank Google Slides presentation.\n *\n * POST /v1/presentations —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_CREATE_OPERATION = \"presentation_create\";\n\nexport type PresentationCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`presentation_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/presentations\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\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 * Read a presentation's slides and the objectId of every element on them --\n * the prerequisite for targeting a specific shape or placeholder with a future\n * edit.\n *\n * GET /v1/presentations/{presentationId} —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_GET_OPERATION = \"presentation_get\";\n\nexport type PresentationGetOptions = {\n  /** The node's resolved config. Keys: presentationId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationGet(options: PresentationGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.presentationId === undefined || config.presentationId === null || config.presentationId === \"\") {\n    throw new Error(`presentation_get: \"presentationId\" is required (Presentation ID).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/v1/presentations/${encodeURIComponent(String(config.presentationId))}`,\n      query: {},\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-slides-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"./service.js\";\n\nimport {\n  googleSlidesPresentationKind,\n  googleSlidesPresentationGetKind,\n} from \"@particle-academy/google-slides-ui\";\n\nimport { googleSlidesPresentationCreate } from \"./actions/presentation-create.js\";\nimport { googleSlidesPresentationGet } from \"./actions/presentation-get.js\";\n\nexport const googleSlidesPresentationExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSlidesPresentationCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_slides presentation_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleSlidesPresentationGetExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSlidesPresentationGet({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_slides presentation_get ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SLIDES_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor },\n  { ...googleSlidesPresentationGetKind, executor: googleSlidesPresentationGetExecutor },\n];\n"]}

package/dist/flow.d.cts

@@ -20,7 +20,8 @@ import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/e
  */
 
 declare const googleSlidesPresentationExecutor: NodeExecutor;
+declare const googleSlidesPresentationGetExecutor: NodeExecutor;
 /** The kinds a TypeScript host registers. */
 declare const GOOGLE_SLIDES_RUNNABLE_KINDS: NodeKindDefinition[];
 
-export { GOOGLE_SLIDES_RUNNABLE_KINDS, googleSlidesPresentationExecutor };
+export { GOOGLE_SLIDES_RUNNABLE_KINDS, googleSlidesPresentationExecutor, googleSlidesPresentationGetExecutor };

package/dist/flow.d.ts

@@ -20,7 +20,8 @@ import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/e
  */
 
 declare const googleSlidesPresentationExecutor: NodeExecutor;
+declare const googleSlidesPresentationGetExecutor: NodeExecutor;
 /** The kinds a TypeScript host registers. */
 declare const GOOGLE_SLIDES_RUNNABLE_KINDS: NodeKindDefinition[];
 
-export { GOOGLE_SLIDES_RUNNABLE_KINDS, googleSlidesPresentationExecutor };
+export { GOOGLE_SLIDES_RUNNABLE_KINDS, googleSlidesPresentationExecutor, googleSlidesPresentationGetExecutor };

package/dist/flow.js

@@ -1,6 +1,6 @@
-import { googleSlidesPresentationCreate } from './chunk-3WQSJ3XH.js';
+import { googleSlidesPresentationCreate, googleSlidesPresentationGet } from './chunk-4BEANSYY.js';
 import '@particle-academy/fancy-connector-core';
-import { googleSlidesPresentationKind } from '@particle-academy/google-slides-ui';
+import { googleSlidesPresentationKind, googleSlidesPresentationGetKind } from '@particle-academy/google-slides-ui';
 
 var googleSlidesPresentationExecutor = async (ctx) => {
   const config = ctx.node.data?.config ?? {};
@@ -16,10 +16,25 @@ var googleSlidesPresentationExecutor = async (ctx) => {
   });
   return { __port: "out", value: result };
 };
+var googleSlidesPresentationGetExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleSlidesPresentationGet({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_slides presentation_get ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
 var GOOGLE_SLIDES_RUNNABLE_KINDS = [
-  { ...googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor }
+  { ...googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor },
+  { ...googleSlidesPresentationGetKind, executor: googleSlidesPresentationGetExecutor }
 ];
 
-export { GOOGLE_SLIDES_RUNNABLE_KINDS, googleSlidesPresentationExecutor };
+export { GOOGLE_SLIDES_RUNNABLE_KINDS, googleSlidesPresentationExecutor, googleSlidesPresentationGetExecutor };
 //# sourceMappingURL=flow.js.map
 //# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAoCO,IAAM,gCAAA,GAAiD,OAAO,GAAA,KAAQ;AAC3E,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,8BAAA,CAA+B;AAAA,IAClD,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,kCAAA,EAAsC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GACnG,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,4BAAA,GAAqD;AAAA,EAChE,EAAE,GAAG,4BAAA,EAA8B,QAAA,EAAU,gCAAA;AAC/C","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-slides-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"./service.js\";\n\nimport {\n  googleSlidesPresentationKind,\n} from \"@particle-academy/google-slides-ui\";\n\nimport { googleSlidesPresentationCreate } from \"./actions/presentation-create.js\";\n\nexport const googleSlidesPresentationExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSlidesPresentationCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_slides presentation_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SLIDES_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor },\n];\n"]}
+{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAsCO,IAAM,gCAAA,GAAiD,OAAO,GAAA,KAAQ;AAC3E,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,8BAAA,CAA+B;AAAA,IAClD,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,kCAAA,EAAsC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GACnG,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAEO,IAAM,mCAAA,GAAoD,OAAO,GAAA,KAAQ;AAC9E,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,2BAAA,CAA4B;AAAA,IAC/C,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,+BAAA,EAAmC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAChG,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,4BAAA,GAAqD;AAAA,EAChE,EAAE,GAAG,4BAAA,EAA8B,QAAA,EAAU,gCAAA,EAAiC;AAAA,EAC9E,EAAE,GAAG,+BAAA,EAAiC,QAAA,EAAU,mCAAA;AAClD","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-slides-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"./service.js\";\n\nimport {\n  googleSlidesPresentationKind,\n  googleSlidesPresentationGetKind,\n} from \"@particle-academy/google-slides-ui\";\n\nimport { googleSlidesPresentationCreate } from \"./actions/presentation-create.js\";\nimport { googleSlidesPresentationGet } from \"./actions/presentation-get.js\";\n\nexport const googleSlidesPresentationExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSlidesPresentationCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_slides presentation_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const googleSlidesPresentationGetExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleSlidesPresentationGet({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_slides presentation_get ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_SLIDES_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleSlidesPresentationKind, executor: googleSlidesPresentationExecutor },\n  { ...googleSlidesPresentationGetKind, executor: googleSlidesPresentationGetExecutor },\n];\n"]}

package/dist/index.cjs

@@ -9,10 +9,50 @@ function fakePresentationCreate({ config, fake }) {
     "title": config.title !== void 0 && config.title !== null && config.title !== "" ? String(config.title) : "Untitled presentation"
   };
 }
+function fakePresentationGet({ config, fake }) {
+  return {
+    "presentationId": config.presentationId !== void 0 && config.presentationId !== null && config.presentationId !== "" ? String(config.presentationId) : fake.id("1Slide"),
+    "title": "Untitled presentation",
+    "locale": "en",
+    "slides": [
+      {
+        "objectId": fake.id("slide"),
+        "pageElements": [
+          {
+            "objectId": fake.id("title"),
+            "shape": {
+              "shapeType": "TEXT_BOX",
+              "placeholder": {
+                "type": "CENTERED_TITLE"
+              },
+              "text": {
+                "textElements": []
+              }
+            }
+          },
+          {
+            "objectId": fake.id("subtitle"),
+            "shape": {
+              "shapeType": "TEXT_BOX",
+              "placeholder": {
+                "type": "SUBTITLE"
+              },
+              "text": {
+                "textElements": []
+              }
+            }
+          }
+        ]
+      }
+    ]
+  };
+}
 var googleSlidesFaker = (operation, request) => {
   switch (operation) {
     case "presentation_create":
       return fakePresentationCreate(request);
+    case "presentation_get":
+      return fakePresentationGet(request);
     default:
       throw new Error(
         `google_slides: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
@@ -67,14 +107,38 @@ async function googleSlidesPresentationCreate(options) {
     }
   });
 }
+var PRESENTATION_GET_OPERATION = "presentation_get";
+async function googleSlidesPresentationGet(options) {
+  const config = options.config ?? {};
+  if (config.presentationId === void 0 || config.presentationId === null || config.presentationId === "") {
+    throw new Error(`presentation_get: "presentationId" is required (Presentation ID).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_SLIDES, {
+    operation: PRESENTATION_GET_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: `/v1/presentations/${encodeURIComponent(String(config.presentationId))}`,
+      query: {}
+    }
+  });
+}
 
 exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
 exports.GOOGLE_SLIDES = GOOGLE_SLIDES;
 exports.GOOGLE_SLIDES_BASE_URLS = GOOGLE_SLIDES_BASE_URLS;
 exports.GOOGLE_SLIDES_REQUIRES = GOOGLE_SLIDES_REQUIRES;
 exports.PRESENTATION_CREATE_OPERATION = PRESENTATION_CREATE_OPERATION;
+exports.PRESENTATION_GET_OPERATION = PRESENTATION_GET_OPERATION;
 exports.googleSlidesAuthorize = googleSlidesAuthorize;
 exports.googleSlidesFaker = googleSlidesFaker;
 exports.googleSlidesPresentationCreate = googleSlidesPresentationCreate;
+exports.googleSlidesPresentationGet = googleSlidesPresentationGet;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/presentation-create.ts"],"names":["callConnector"],"mappings":";;;;;AA0BA,SAAS,sBAAA,CAAuB,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AACtE,EAAA,OAAO;AAAA,IACL,gBAAA,EAAkB,IAAA,CAAK,EAAA,CAAG,QAAQ,CAAA;AAAA,IAClC,OAAA,EAAU,MAAA,CAAO,KAAA,KAAU,MAAA,IAAa,MAAA,CAAO,KAAA,KAAU,IAAA,IAAQ,MAAA,CAAO,KAAA,KAAU,EAAA,GAAK,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA,GAAI;AAAA,GAChH;AACF;AAEO,IAAM,iBAAA,GAAoC,CAAC,SAAA,EAAW,OAAA,KAAY;AACvE,EAAA,QAAQ,SAAA;AAAW,IACjB,KAAK,qBAAA;AACH,MAAA,OAAO,uBAAuB,OAAO,CAAA;AAAA,IAEvC;AAIE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,mDAAmD,SAAS,CAAA,iJAAA;AAAA,OAG9D;AAAA;AAEN;;;ACXO,IAAM,qBAAA,GAAwB;AAE9B,IAAM,uBAAA,GAA0B;AAAA,EACrC,MAAA,EAAQ;AACV;AAGO,IAAM,sBAAA,GAAyB;AAAA,EACpC,aAAA;AAAA,EACA,cAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAWO,SAAS,qBAAA,CACd,WAAA,EACA,OAAA,EACA,KAAA,EACM;AACN,EAAA,OAAA,CAAQ,OAAA,CAAQ,aAAA,GAAgB,CAAA,OAAA,EAAU,WAAA,CAAY,eAAe,EAAE,CAAA,CAAA;AACzE;AAGO,IAAM,aAAA,GAAmC;AAAA,EAC9C,OAAA,EAAS,eAAA;AAAA,EACT,KAAA,EAAO,eAAA;AAAA,EACP,OAAA,EAAS,MAAA;AAAA,EACT,QAAA,EAAU,EAAE,GAAG,uBAAA,EAAwB;AAAA,EACvC,QAAA,EAAU,CAAC,GAAG,sBAAsB,CAAA;AAAA,EACpC,SAAA,EAAW,qBAAA;AAAA,EACX,KAAA,EAAO;AACT;AC5CO,IAAM,6BAAA,GAAgC;AAc7C,eAAsB,+BAA+B,OAAA,EAA8D;AACjH,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,IAAa,MAAA,CAAO,UAAU,IAAA,IAAQ,MAAA,CAAO,UAAU,EAAA,EAAI;AAC9E,IAAA,MAAM,IAAI,MAAM,CAAA,iDAAA,CAAmD,CAAA;AAAA,EACrE;AAEA,EAAA,OAAOA,iCAAc,aAAA,EAAe;AAAA,IAClC,SAAA,EAAW,6BAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,mBAAA;AAAA,MACN,IAAA,EAAM;AAAA,QACJ,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,KAAK;AAAA;AAC9B;AACF,GACD,CAAA;AACH","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * The Google Slides faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Slides actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakePresentationCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": fake.id(\"1Slide\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled presentation\"),\n  };\n}\n\nexport const googleSlidesFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"presentation_create\":\n      return fakePresentationCreate(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_slides: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides, as one service descriptor shared by every Google Slides\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Slides: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for 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 { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSlidesFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SLIDES_BASE_URLS = {\n  \"live\": \"https://slides.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SLIDES_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Slides's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSlidesAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Slides service, for the TypeScript runtime. */\nexport const GOOGLE_SLIDES: ServiceDescriptor = {\n  service: \"google_slides\",\n  title: \"Google Slides\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SLIDES_BASE_URLS },\n  requires: [...GOOGLE_SLIDES_REQUIRES],\n  authorize: googleSlidesAuthorize,\n  faker: googleSlidesFaker,\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 * Create a blank Google Slides presentation.\n *\n * POST /v1/presentations —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_CREATE_OPERATION = \"presentation_create\";\n\nexport type PresentationCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`presentation_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/presentations\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\n}\n"]}
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/presentation-create.ts","../src/actions/presentation-get.ts"],"names":["callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * The Google Slides faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Slides actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakePresentationCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": fake.id(\"1Slide\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled presentation\"),\n  };\n}\n\nfunction fakePresentationGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": (config.presentationId !== undefined && config.presentationId !== null && config.presentationId !== \"\" ? String(config.presentationId) : fake.id(\"1Slide\")),\n    \"title\": \"Untitled presentation\",\n    \"locale\": \"en\",\n    \"slides\": [\n      {\n        \"objectId\": fake.id(\"slide\"),\n        \"pageElements\": [\n          {\n            \"objectId\": fake.id(\"title\"),\n            \"shape\": {\n              \"shapeType\": \"TEXT_BOX\",\n              \"placeholder\": {\n                \"type\": \"CENTERED_TITLE\",\n              },\n              \"text\": {\n                \"textElements\": [],\n              },\n            },\n          },\n          {\n            \"objectId\": fake.id(\"subtitle\"),\n            \"shape\": {\n              \"shapeType\": \"TEXT_BOX\",\n              \"placeholder\": {\n                \"type\": \"SUBTITLE\",\n              },\n              \"text\": {\n                \"textElements\": [],\n              },\n            },\n          },\n        ],\n      },\n    ],\n  };\n}\n\nexport const googleSlidesFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"presentation_create\":\n      return fakePresentationCreate(request);\n\n    case \"presentation_get\":\n      return fakePresentationGet(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_slides: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides, as one service descriptor shared by every Google Slides\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Slides: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for 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 { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSlidesFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SLIDES_BASE_URLS = {\n  \"live\": \"https://slides.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SLIDES_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Slides's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSlidesAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Slides service, for the TypeScript runtime. */\nexport const GOOGLE_SLIDES: ServiceDescriptor = {\n  service: \"google_slides\",\n  title: \"Google Slides\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SLIDES_BASE_URLS },\n  requires: [...GOOGLE_SLIDES_REQUIRES],\n  authorize: googleSlidesAuthorize,\n  faker: googleSlidesFaker,\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 * Create a blank Google Slides presentation.\n *\n * POST /v1/presentations —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_CREATE_OPERATION = \"presentation_create\";\n\nexport type PresentationCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`presentation_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/presentations\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\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 * Read a presentation's slides and the objectId of every element on them --\n * the prerequisite for targeting a specific shape or placeholder with a future\n * edit.\n *\n * GET /v1/presentations/{presentationId} —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_GET_OPERATION = \"presentation_get\";\n\nexport type PresentationGetOptions = {\n  /** The node's resolved config. Keys: presentationId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationGet(options: PresentationGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.presentationId === undefined || config.presentationId === null || config.presentationId === \"\") {\n    throw new Error(`presentation_get: \"presentationId\" is required (Presentation ID).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_GET_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: `/v1/presentations/${encodeURIComponent(String(config.presentationId))}`,\n      query: {},\n    },\n  });\n}\n"]}

package/dist/index.d.cts

@@ -114,4 +114,42 @@ type PresentationCreateOptions = {
 };
 declare function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult>;
 
-export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, type PresentationCreateOptions, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate };
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/presentation-get.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/presentation-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_slides
+ */
+/**
+ * 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} —
+ * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Slides or calls the
+ * faker.
+ */
+
+declare const PRESENTATION_GET_OPERATION = "presentation_get";
+type PresentationGetOptions = {
+    /** The node's resolved config. Keys: presentationId. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleSlidesPresentationGet(options: PresentationGetOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, PRESENTATION_GET_OPERATION, type PresentationCreateOptions, type PresentationGetOptions, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate, googleSlidesPresentationGet };

package/dist/index.d.ts

@@ -114,4 +114,42 @@ type PresentationCreateOptions = {
 };
 declare function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult>;
 
-export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, type PresentationCreateOptions, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate };
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/presentation-get.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/presentation-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_slides
+ */
+/**
+ * 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} —
+ * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/get
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Slides or calls the
+ * faker.
+ */
+
+declare const PRESENTATION_GET_OPERATION = "presentation_get";
+type PresentationGetOptions = {
+    /** The node's resolved config. Keys: presentationId. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleSlidesPresentationGet(options: PresentationGetOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, PRESENTATION_GET_OPERATION, type PresentationCreateOptions, type PresentationGetOptions, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate, googleSlidesPresentationGet };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate } from './chunk-3WQSJ3XH.js';
+export { CONNECTOR_API_VERSION, GOOGLE_SLIDES, GOOGLE_SLIDES_BASE_URLS, GOOGLE_SLIDES_REQUIRES, PRESENTATION_CREATE_OPERATION, PRESENTATION_GET_OPERATION, googleSlidesAuthorize, googleSlidesFaker, googleSlidesPresentationCreate, googleSlidesPresentationGet } from './chunk-4BEANSYY.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

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

package/dist/chunk-3WQSJ3XH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/presentation-create.ts"],"names":[],"mappings":";;;AA0BA,SAAS,sBAAA,CAAuB,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AACtE,EAAA,OAAO;AAAA,IACL,gBAAA,EAAkB,IAAA,CAAK,EAAA,CAAG,QAAQ,CAAA;AAAA,IAClC,OAAA,EAAU,MAAA,CAAO,KAAA,KAAU,MAAA,IAAa,MAAA,CAAO,KAAA,KAAU,IAAA,IAAQ,MAAA,CAAO,KAAA,KAAU,EAAA,GAAK,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA,GAAI;AAAA,GAChH;AACF;AAEO,IAAM,iBAAA,GAAoC,CAAC,SAAA,EAAW,OAAA,KAAY;AACvE,EAAA,QAAQ,SAAA;AAAW,IACjB,KAAK,qBAAA;AACH,MAAA,OAAO,uBAAuB,OAAO,CAAA;AAAA,IAEvC;AAIE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,mDAAmD,SAAS,CAAA,iJAAA;AAAA,OAG9D;AAAA;AAEN;;;ACXO,IAAM,qBAAA,GAAwB;AAE9B,IAAM,uBAAA,GAA0B;AAAA,EACrC,MAAA,EAAQ;AACV;AAGO,IAAM,sBAAA,GAAyB;AAAA,EACpC,aAAA;AAAA,EACA,cAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAWO,SAAS,qBAAA,CACd,WAAA,EACA,OAAA,EACA,KAAA,EACM;AACN,EAAA,OAAA,CAAQ,OAAA,CAAQ,aAAA,GAAgB,CAAA,OAAA,EAAU,WAAA,CAAY,eAAe,EAAE,CAAA,CAAA;AACzE;AAGO,IAAM,aAAA,GAAmC;AAAA,EAC9C,OAAA,EAAS,eAAA;AAAA,EACT,KAAA,EAAO,eAAA;AAAA,EACP,OAAA,EAAS,MAAA;AAAA,EACT,QAAA,EAAU,EAAE,GAAG,uBAAA,EAAwB;AAAA,EACvC,QAAA,EAAU,CAAC,GAAG,sBAAsB,CAAA;AAAA,EACpC,SAAA,EAAW,qBAAA;AAAA,EACX,KAAA,EAAO;AACT;AC5CO,IAAM,6BAAA,GAAgC;AAc7C,eAAsB,+BAA+B,OAAA,EAA8D;AACjH,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,IAAa,MAAA,CAAO,UAAU,IAAA,IAAQ,MAAA,CAAO,UAAU,EAAA,EAAI;AAC9E,IAAA,MAAM,IAAI,MAAM,CAAA,iDAAA,CAAmD,CAAA;AAAA,EACrE;AAEA,EAAA,OAAO,cAAc,aAAA,EAAe;AAAA,IAClC,SAAA,EAAW,6BAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,mBAAA;AAAA,MACN,IAAA,EAAM;AAAA,QACJ,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,KAAK;AAAA;AAC9B;AACF,GACD,CAAA;AACH","file":"chunk-3WQSJ3XH.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * The Google Slides faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Slides actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakePresentationCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"presentationId\": fake.id(\"1Slide\"),\n    \"title\": (config.title !== undefined && config.title !== null && config.title !== \"\" ? String(config.title) : \"Untitled presentation\"),\n  };\n}\n\nexport const googleSlidesFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"presentation_create\":\n      return fakePresentationCreate(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_slides: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_slides\n */\n\n/**\n * Google Slides, as one service descriptor shared by every Google Slides\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Slides: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google has no sandbox for 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 { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleSlidesFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_SLIDES_BASE_URLS = {\n  \"live\": \"https://slides.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_SLIDES_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Slides's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleSlidesAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Slides service, for the TypeScript runtime. */\nexport const GOOGLE_SLIDES: ServiceDescriptor = {\n  service: \"google_slides\",\n  title: \"Google Slides\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_SLIDES_BASE_URLS },\n  requires: [...GOOGLE_SLIDES_REQUIRES],\n  authorize: googleSlidesAuthorize,\n  faker: googleSlidesFaker,\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 * Create a blank Google Slides presentation.\n *\n * POST /v1/presentations —\n * https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/create\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Slides or calls the\n * faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_SLIDES } from \"../service.js\";\n\nexport const PRESENTATION_CREATE_OPERATION = \"presentation_create\";\n\nexport type PresentationCreateOptions = {\n  /** The node's resolved config. Keys: title. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleSlidesPresentationCreate(options: PresentationCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.title === undefined || config.title === null || config.title === \"\") {\n    throw new Error(`presentation_create: \"title\" is required (Title).`);\n  }\n\n  return callConnector(GOOGLE_SLIDES, {\n    operation: PRESENTATION_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/v1/presentations\",\n      json: {\n        \"title\": String(config.title),\n      },\n    },\n  });\n}\n"]}