@particle-academy/zoom-js 0.0.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog — Zoom
+
+All four packages — `@particle-academy/zoom-ui`, `@particle-academy/zoom-js`,
+`particle-academy/zoom-php` and `fancy-zoom` — are released together under one
+version. They are generated from one `provider/` definition, so a change to it
+changes all four, and separate version lines would only record which of the
+four somebody remembered to bump.
+
+**Write entries HERE**, in the weaver envelope at `providers/zoom/CHANGELOG.md`,
+then regenerate. This file is the one thing in a release that cannot be derived
+— somebody has to write what changed — but writing it in the provider repo
+would be a hand-edit that `.weaver.json` flags and the next sync destroys.
+
+## [0.2.0] — 2026-11-08
+
+### Added
+
+- **Laravel integration, in this package** (`src/Laravel/`), auto-discovered
+  through composer's `extra.laravel`. Laravel is SUGGESTED, never required:
+  outside a Laravel app none of it loads.
+  - a service provider that merges `config/zoom.php` under
+    `connectors.zoom` (credentials from the environment, or per call for a
+    multi-account app);
+  - the `Zoom` facade: `Zoom::call('<operation>', [...])` runs any action;
+  - `Zoom::fake()`, answered from the connector's faker, with
+    `assertSent` / `assertNotSent` / `assertNothingSent` / `assertSentCount`;
+  - its own Pest test of all of it against a booted Laravel app.
+
+### Changed
+
+- **Tests: Pest `^5`**, and `laravel/framework` `^13` as a DEV-ONLY test
+  dependency (the framework this package integrates with; nothing ships in
+  `require`).
+
+## [0.1.0] — 2026-09-16
+
+### Added
+
+- **`meeting_get`** — read a meeting's join link and settings (`GET /meetings/{meetingId}`, scope `meeting:read:meeting`).
+- **`obf_token_create`** — mint the on-behalf-of token a Meeting SDK bot needs to join a meeting it did not create (`GET /users/me/token?type=onbehalf`, scope `user:read:token`), required since Zoom's own 2026-02-23 enforcement date. Meeting-scoped and single-use, so it is minted fresh before every join rather than cached.
+- OAuth2 authorization-code, with `refreshTokenRotates: true` — Zoom issues a new refresh token on every refresh and treats reuse of an old one as an error, the same shape this vocabulary already refuses to retry or run concurrently.
+- Sandbox is `unverified`: Zoom documents no test estate distinct from a real account, but nobody has confirmed there is truly nothing rather than simply not having found it.
+
+Tynn #10 (MOIC U15) — the OAuth flow, both endpoints and the sandbox note were checked against Zoom's own docs, its developer forum and its migration blog on 2026-09-15; `meeting_get`'s field list is the long-stable v2 shape rather than a page transcription (Zoom's detail page did not render for review) and is flagged for a live spot-check before an account depends on it.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Particle Academy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,118 @@
-# @particle-academy/zoom-js
+# Zoom
 
-**0.0.0 claims the name and ships nothing.** It exists so a Trusted Publisher can be attached to the package; the first real release is published from https://github.com/Fancy-Friends/zoom by its `publish.yml` workflow with provenance, and this version is deprecated the moment it lands.
+[![Fancified](art/fancified.svg)](https://particle.academy)
+
+Zoom 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.
+
+[flow]: https://github.com/Particle-Academy/fancy-flow
+
+| Runtime | Package | Install |
+|---|---|---|
+| Authoring surface (every host) | `@particle-academy/zoom-ui` | `npm install @particle-academy/zoom-ui` |
+| Node | `@particle-academy/zoom-js` | `npm install @particle-academy/zoom-js` |
+| PHP 8.4+ | `particle-academy/zoom-php` | `composer require particle-academy/zoom-php` |
+| Python 3.11+ | `fancy-zoom` | `pip install fancy-zoom` |
+
+The `ui` package is the editor surface and is React on every host — a PHP or
+Python project installs it *and* its own runtime package, and never the `js` one.
+
+## What it costs you
+
+One dependency: `@particle-academy/fancy-connector-core` (or
+`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
+packages pull in themselves. The Python package has **zero** runtime
+dependencies.
+
+**No Zoom SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
+subject to the kit's full approval bar, and one per provider is hundreds of
+dependencies nobody is tracking.
+
+## Setting it up
+
+Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
+
+### Credentials
+
+A Zoom connection holds 4 values.
+
+**Two kinds of value, and mixing them up matters.** A `provider` credential is ONE value for the whole installation — an OAuth app's client secret serves every connected account. An `account` credential is one per connected account. A host that stores the second where it stores the first lets one account's credentials reach another's.
+
+| Field | Scope | Secret | Where it comes from |
+|---|---|---|---|
+| **OAuth client ID** | per installation | not secret | From the Zoom app you registered at marketplace.zoom.us. One value for the whole installation -- the same app serves every connected Zoom account. |
+| **OAuth client secret** | per installation | **secret** | From the same app. Used to exchange the code and to refresh; never sent with an API request. |
+| **Access token** | per connected account | **secret** | Obtained by the host's OAuth exchange, PER CONNECTED ZOOM ACCOUNT. Expires after one hour -- a host that does not refresh will work for a while and then fail with no warning. |
+| **Refresh token** | per connected account | **secret** | Also per account. A NEW one is issued on every refresh -- persist the replacement atomically, and never retry a refresh that may have already succeeded: replaying an old refresh token is Zoom's own reported failure mode for a rotating grant. |
+
+### Authorising
+
+Zoom uses OAuth2 (authorization_code). The package DECLARES the exchange; the HOST performs it — a consent screen needs a browser, a redirect URI and somewhere to persist the result, and all three belong to the host.
+
+- **Authorize URL** — https://zoom.us/oauth/authorize
+- **Token URL** — https://zoom.us/oauth/token
+- **Scopes** — `meeting:read:meeting`, `user:read:token`
+- **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
+
+**The refresh tokens ROTATE, and they are single use.** Every refresh returns a new one and spends the one submitted, so replaying a spent token revokes the ENTIRE grant — the user is signed out, with nothing in the failure that says why.
+
+Two consequences, both of which a host gets wrong by default:
+
+1. **Do not RETRY a failed refresh with the same token.** A response that arrived but was not persisted — a crash between the reply and the write — turns the reflexive retry into a replay.
+2. **Do not refresh CONCURRENTLY.** Two workers refreshing at once means one of them replays.
+
+Persist the returned token before using the access token it came with.
+
+### The estate
+
+**Nobody has checked whether Zoom has a test estate.** Treat every call as real.
+
+> Zoom has no test estate distinct from a real account, as far as this review found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call authorizes against the caller's own Zoom account and can read real meeting data. Use fake mode while building.
+
+## What it can do
+
+### Actions
+
+#### `meeting_get` — Get meeting
+
+Read a Zoom meeting's join details and settings.
+
+`GET /meetings/{meetingId}` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `meetingId` | yes | The meeting's numeric id, from its join URL or from Zoom's own meeting list. |
+
+#### `obf_token_create` — Mint on-behalf-of token
+
+Mint a short-lived token so a bot can join a Zoom meeting on the authorising user's behalf.
+
+`GET /users/me/token` · **unsafe to replay** — a retried durable run does it TWICE
+
+| Input | Required | What it is |
+|---|---|---|
+| `meetingId` | yes | The meeting the bot is about to join. The minted token works for this meeting only. |
+
+## Run it before you have credentials
+
+Every operation ships a **faker**, whether or not Zoom has a sandbox. Set a
+node's mode to `fake` and it returns the shape Zoom actually publishes — the
+same field names, deterministically — so you can wire the downstream nodes before
+touching an account, a key, or a network.
+
+## This repository is generated
+
+`provider/` is the source. Everything under `packages/` is emitted from it and
+**must not be hand-edited** — CI regenerates and diffs on every push, and the
+next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
+
+## Two namespaces, which do not match on purpose
+
+The repo is `github.com/Fancy-Friends/zoom`; the packages publish under
+`particle-academy`. Nothing derives one from the other — the names come from
+weaver's `friends.json` and nowhere else.
+
+## Licence
+
+MIT.

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-2A3B3B5A.js

@@ -0,0 +1,113 @@
+import { callConnector } from '@particle-academy/fancy-connector-core';
+
+// src/faker.ts
+function fakeMeetingGet({ config, fake }) {
+  return {
+    "id": config.meetingId !== void 0 && config.meetingId !== null && config.meetingId !== "" ? Number.isFinite(Number(config.meetingId)) ? Math.trunc(Number(config.meetingId)) : null : Array.from({ length: 10 }, () => fake.int(0, 9)).join(""),
+    "uuid": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,
+    "host_id": fake.id("u"),
+    "topic": "Weekly sync",
+    "type": 2,
+    "status": "waiting",
+    "start_time": "2026-09-22T14:00:00Z",
+    "duration": 30,
+    "timezone": "America/New_York",
+    "agenda": "",
+    "join_url": "https://zoom.us/j/1234567890?pwd=fake",
+    "password": Array.from({ length: 6 }, () => fake.int(0, 9)).join(""),
+    "settings": {
+      "waiting_room": true,
+      "join_before_host": false,
+      "approval_type": 2
+    }
+  };
+}
+function fakeObfTokenCreate({ config, fake }) {
+  return {
+    "token": fake.id("obf")
+  };
+}
+var zoomFaker = (operation, request) => {
+  switch (operation) {
+    case "meeting_get":
+      return fakeMeetingGet(request);
+    case "obf_token_create":
+      return fakeObfTokenCreate(request);
+    default:
+      throw new Error(
+        `zoom: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var ZOOM_BASE_URLS = {
+  "live": "https://api.zoom.us/v2"
+};
+var ZOOM_REQUIRES = [
+  "accessToken"
+];
+function zoomAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var ZOOM = {
+  service: "zoom",
+  title: "Zoom",
+  sandbox: "unverified",
+  baseUrls: { ...ZOOM_BASE_URLS },
+  requires: [...ZOOM_REQUIRES],
+  authorize: zoomAuthorize,
+  faker: zoomFaker
+};
+var MEETING_GET_OPERATION = "meeting_get";
+async function zoomMeetingGet(options) {
+  const config = options.config ?? {};
+  if (config.meetingId === void 0 || config.meetingId === null || config.meetingId === "") {
+    throw new Error(`meeting_get: "meetingId" is required (Meeting ID).`);
+  }
+  return callConnector(ZOOM, {
+    operation: MEETING_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: `/meetings/${encodeURIComponent(String(config.meetingId))}`,
+      query: {}
+    }
+  });
+}
+var OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
+async function zoomObfTokenCreate(options) {
+  const config = options.config ?? {};
+  if (config.meetingId === void 0 || config.meetingId === null || config.meetingId === "") {
+    throw new Error(`obf_token_create: "meetingId" is required (Meeting ID).`);
+  }
+  return callConnector(ZOOM, {
+    operation: OBF_TOKEN_CREATE_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: "/users/me/token",
+      query: {
+        "meeting_id": String(config.meetingId),
+        "type": "onbehalf"
+      }
+    }
+  });
+}
+
+export { CONNECTOR_API_VERSION, MEETING_GET_OPERATION, OBF_TOKEN_CREATE_OPERATION, ZOOM, ZOOM_BASE_URLS, ZOOM_REQUIRES, zoomAuthorize, zoomFaker, zoomMeetingGet, zoomObfTokenCreate };
+//# sourceMappingURL=chunk-2A3B3B5A.js.map
+//# sourceMappingURL=chunk-2A3B3B5A.js.map

package/dist/chunk-2A3B3B5A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/meeting-get.ts","../src/actions/obf-token-create.ts"],"names":["callConnector"],"mappings":"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","file":"chunk-2A3B3B5A.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 -- zoom\n */\n\n/**\n * The Zoom faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Zoom actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real 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 fakeMeetingGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": (config.meetingId !== undefined && config.meetingId !== null && config.meetingId !== \"\" ? (Number.isFinite(Number(config.meetingId)) ? Math.trunc(Number(config.meetingId)) : null) : Array.from({ length: 10 }, () => fake.int(0, 9)).join(\"\")),\n    \"uuid\": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,\n    \"host_id\": fake.id(\"u\"),\n    \"topic\": \"Weekly sync\",\n    \"type\": 2,\n    \"status\": \"waiting\",\n    \"start_time\": \"2026-09-22T14:00:00Z\",\n    \"duration\": 30,\n    \"timezone\": \"America/New_York\",\n    \"agenda\": \"\",\n    \"join_url\": \"https://zoom.us/j/1234567890?pwd=fake\",\n    \"password\": Array.from({ length: 6 }, () => fake.int(0, 9)).join(\"\"),\n    \"settings\": {\n      \"waiting_room\": true,\n      \"join_before_host\": false,\n      \"approval_type\": 2,\n    },\n  };\n}\n\nfunction fakeObfTokenCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"token\": fake.id(\"obf\"),\n  };\n}\n\nexport const zoomFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"meeting_get\":\n      return fakeMeetingGet(request);\n\n    case \"obf_token_create\":\n      return fakeObfTokenCreate(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        `zoom: 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 -- zoom\n */\n\n/**\n * Zoom, as one service descriptor shared by every Zoom operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Zoom: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Zoom has no test estate distinct from a real account, as far as this review\n * found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call\n * authorizes against the caller's own Zoom account and can read real meeting\n * data. Use fake mode while building.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { zoomFaker } 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 ZOOM_BASE_URLS = {\n  \"live\": \"https://api.zoom.us/v2\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const ZOOM_REQUIRES = [\n  \"accessToken\"\n] as const;\n\n/**\n * Apply Zoom's auth scheme to an outgoing request.\n *\n * Every Zoom REST call is a Bearer token on the Authorization header, OAuth or\n * Server-to-Server alike; this provider declares the user OAuth shape so a\n * host can connect a rep's own Zoom account rather than one shared app-wide\n * identity.\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 zoomAuthorize(\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 Zoom service, for the TypeScript runtime. */\nexport const ZOOM: ServiceDescriptor = {\n  service: \"zoom\",\n  title: \"Zoom\",\n  sandbox: \"unverified\",\n  baseUrls: { ...ZOOM_BASE_URLS },\n  requires: [...ZOOM_REQUIRES],\n  authorize: zoomAuthorize,\n  faker: zoomFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/meeting-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/meeting-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- zoom\n */\n\n/**\n * Read a Zoom meeting's join details and settings.\n *\n * GET /meetings/{meetingId} — https://developers.zoom.us/docs/api/meetings/\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 Zoom or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { ZOOM } from \"../service.js\";\n\nexport const MEETING_GET_OPERATION = \"meeting_get\";\n\nexport type MeetingGetOptions = {\n  /** The node's resolved config. Keys: meetingId. */\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 zoomMeetingGet(options: MeetingGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.meetingId === undefined || config.meetingId === null || config.meetingId === \"\") {\n    throw new Error(`meeting_get: \"meetingId\" is required (Meeting ID).`);\n  }\n\n  return callConnector(ZOOM, {\n    operation: MEETING_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: `/meetings/${encodeURIComponent(String(config.meetingId))}`,\n      query: {},\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/obf-token-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/obf-token-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- zoom\n */\n\n/**\n * Mint a short-lived token so a bot can join a Zoom meeting on the authorising\n * user's behalf.\n *\n * GET /users/me/token —\n * https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/\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 Zoom or calls the 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 { ZOOM } from \"../service.js\";\n\nexport const OBF_TOKEN_CREATE_OPERATION = \"obf_token_create\";\n\nexport type ObfTokenCreateOptions = {\n  /** The node's resolved config. Keys: meetingId. */\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 zoomObfTokenCreate(options: ObfTokenCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.meetingId === undefined || config.meetingId === null || config.meetingId === \"\") {\n    throw new Error(`obf_token_create: \"meetingId\" is required (Meeting ID).`);\n  }\n\n  return callConnector(ZOOM, {\n    operation: OBF_TOKEN_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: \"GET\",\n      path: \"/users/me/token\",\n      query: {\n        \"meeting_id\": String(config.meetingId),\n        \"type\": \"onbehalf\",\n      },\n    },\n  });\n}\n"]}

package/dist/flow.cjs

@@ -0,0 +1,153 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+var zoomUi = require('@particle-academy/zoom-ui');
+
+// src/flow.ts
+
+// src/faker.ts
+function fakeMeetingGet({ config, fake }) {
+  return {
+    "id": config.meetingId !== void 0 && config.meetingId !== null && config.meetingId !== "" ? Number.isFinite(Number(config.meetingId)) ? Math.trunc(Number(config.meetingId)) : null : Array.from({ length: 10 }, () => fake.int(0, 9)).join(""),
+    "uuid": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,
+    "host_id": fake.id("u"),
+    "topic": "Weekly sync",
+    "type": 2,
+    "status": "waiting",
+    "start_time": "2026-09-22T14:00:00Z",
+    "duration": 30,
+    "timezone": "America/New_York",
+    "agenda": "",
+    "join_url": "https://zoom.us/j/1234567890?pwd=fake",
+    "password": Array.from({ length: 6 }, () => fake.int(0, 9)).join(""),
+    "settings": {
+      "waiting_room": true,
+      "join_before_host": false,
+      "approval_type": 2
+    }
+  };
+}
+function fakeObfTokenCreate({ config, fake }) {
+  return {
+    "token": fake.id("obf")
+  };
+}
+var zoomFaker = (operation, request) => {
+  switch (operation) {
+    case "meeting_get":
+      return fakeMeetingGet(request);
+    case "obf_token_create":
+      return fakeObfTokenCreate(request);
+    default:
+      throw new Error(
+        `zoom: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var ZOOM_BASE_URLS = {
+  "live": "https://api.zoom.us/v2"
+};
+var ZOOM_REQUIRES = [
+  "accessToken"
+];
+function zoomAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var ZOOM = {
+  service: "zoom",
+  title: "Zoom",
+  sandbox: "unverified",
+  baseUrls: { ...ZOOM_BASE_URLS },
+  requires: [...ZOOM_REQUIRES],
+  authorize: zoomAuthorize,
+  faker: zoomFaker
+};
+var MEETING_GET_OPERATION = "meeting_get";
+async function zoomMeetingGet(options) {
+  const config = options.config ?? {};
+  if (config.meetingId === void 0 || config.meetingId === null || config.meetingId === "") {
+    throw new Error(`meeting_get: "meetingId" is required (Meeting ID).`);
+  }
+  return fancyConnectorCore.callConnector(ZOOM, {
+    operation: MEETING_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: `/meetings/${encodeURIComponent(String(config.meetingId))}`,
+      query: {}
+    }
+  });
+}
+var OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
+async function zoomObfTokenCreate(options) {
+  const config = options.config ?? {};
+  if (config.meetingId === void 0 || config.meetingId === null || config.meetingId === "") {
+    throw new Error(`obf_token_create: "meetingId" is required (Meeting ID).`);
+  }
+  return fancyConnectorCore.callConnector(ZOOM, {
+    operation: OBF_TOKEN_CREATE_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: "/users/me/token",
+      query: {
+        "meeting_id": String(config.meetingId),
+        "type": "onbehalf"
+      }
+    }
+  });
+}
+
+// src/flow.ts
+var zoomMeetingGetExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await zoomMeetingGet({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `zoom meeting_get ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var zoomObfTokenCreateExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await zoomObfTokenCreate({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `zoom obf_token_create ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var ZOOM_RUNNABLE_KINDS = [
+  { ...zoomUi.zoomMeetingGetKind, executor: zoomMeetingGetExecutor },
+  { ...zoomUi.zoomObfTokenCreateKind, executor: zoomObfTokenCreateExecutor }
+];
+
+exports.ZOOM_RUNNABLE_KINDS = ZOOM_RUNNABLE_KINDS;
+exports.zoomMeetingGetExecutor = zoomMeetingGetExecutor;
+exports.zoomObfTokenCreateExecutor = zoomObfTokenCreateExecutor;
+//# sourceMappingURL=flow.cjs.map
+//# sourceMappingURL=flow.cjs.map

package/dist/flow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/meeting-get.ts","../src/actions/obf-token-create.ts","../src/flow.ts"],"names":["callConnector","zoomMeetingGetKind","zoomObfTokenCreateKind"],"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 -- zoom\n */\n\n/**\n * The Zoom faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Zoom actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real 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 fakeMeetingGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": (config.meetingId !== undefined && config.meetingId !== null && config.meetingId !== \"\" ? (Number.isFinite(Number(config.meetingId)) ? Math.trunc(Number(config.meetingId)) : null) : Array.from({ length: 10 }, () => fake.int(0, 9)).join(\"\")),\n    \"uuid\": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,\n    \"host_id\": fake.id(\"u\"),\n    \"topic\": \"Weekly sync\",\n    \"type\": 2,\n    \"status\": \"waiting\",\n    \"start_time\": \"2026-09-22T14:00:00Z\",\n    \"duration\": 30,\n    \"timezone\": \"America/New_York\",\n    \"agenda\": \"\",\n    \"join_url\": \"https://zoom.us/j/1234567890?pwd=fake\",\n    \"password\": Array.from({ length: 6 }, () => fake.int(0, 9)).join(\"\"),\n    \"settings\": {\n      \"waiting_room\": true,\n      \"join_before_host\": false,\n      \"approval_type\": 2,\n    },\n  };\n}\n\nfunction fakeObfTokenCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"token\": fake.id(\"obf\"),\n  };\n}\n\nexport const zoomFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"meeting_get\":\n      return fakeMeetingGet(request);\n\n    case \"obf_token_create\":\n      return fakeObfTokenCreate(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        `zoom: 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 -- zoom\n */\n\n/**\n * Zoom, as one service descriptor shared by every Zoom operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Zoom: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Zoom has no test estate distinct from a real account, as far as this review\n * found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call\n * authorizes against the caller's own Zoom account and can read real meeting\n * data. Use fake mode while building.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { zoomFaker } 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 ZOOM_BASE_URLS = {\n  \"live\": \"https://api.zoom.us/v2\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const ZOOM_REQUIRES = [\n  \"accessToken\"\n] as const;\n\n/**\n * Apply Zoom's auth scheme to an outgoing request.\n *\n * Every Zoom REST call is a Bearer token on the Authorization header, OAuth or\n * Server-to-Server alike; this provider declares the user OAuth shape so a\n * host can connect a rep's own Zoom account rather than one shared app-wide\n * identity.\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 zoomAuthorize(\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 Zoom service, for the TypeScript runtime. */\nexport const ZOOM: ServiceDescriptor = {\n  service: \"zoom\",\n  title: \"Zoom\",\n  sandbox: \"unverified\",\n  baseUrls: { ...ZOOM_BASE_URLS },\n  requires: [...ZOOM_REQUIRES],\n  authorize: zoomAuthorize,\n  faker: zoomFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/meeting-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/meeting-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- zoom\n */\n\n/**\n * Read a Zoom meeting's join details and settings.\n *\n * GET /meetings/{meetingId} — https://developers.zoom.us/docs/api/meetings/\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 Zoom or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { ZOOM } from \"../service.js\";\n\nexport const MEETING_GET_OPERATION = \"meeting_get\";\n\nexport type MeetingGetOptions = {\n  /** The node's resolved config. Keys: meetingId. */\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 zoomMeetingGet(options: MeetingGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.meetingId === undefined || config.meetingId === null || config.meetingId === \"\") {\n    throw new Error(`meeting_get: \"meetingId\" is required (Meeting ID).`);\n  }\n\n  return callConnector(ZOOM, {\n    operation: MEETING_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: `/meetings/${encodeURIComponent(String(config.meetingId))}`,\n      query: {},\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/obf-token-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/obf-token-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- zoom\n */\n\n/**\n * Mint a short-lived token so a bot can join a Zoom meeting on the authorising\n * user's behalf.\n *\n * GET /users/me/token —\n * https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/\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 Zoom or calls the 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 { ZOOM } from \"../service.js\";\n\nexport const OBF_TOKEN_CREATE_OPERATION = \"obf_token_create\";\n\nexport type ObfTokenCreateOptions = {\n  /** The node's resolved config. Keys: meetingId. */\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 zoomObfTokenCreate(options: ObfTokenCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.meetingId === undefined || config.meetingId === null || config.meetingId === \"\") {\n    throw new Error(`obf_token_create: \"meetingId\" is required (Meeting ID).`);\n  }\n\n  return callConnector(ZOOM, {\n    operation: OBF_TOKEN_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: \"GET\",\n      path: \"/users/me/token\",\n      query: {\n        \"meeting_id\": String(config.meetingId),\n        \"type\": \"onbehalf\",\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 -- zoom\n */\n\n/**\n * Zoom's node kinds with their TypeScript executors attached — for hosts that\n * EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/zoom-ui carries no executor: the\n * editor is React on every host, so a PHP or Python project installs the ui\n * 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 { ZOOM } from \"./service.js\";\n\nimport {\n  zoomMeetingGetKind,\n  zoomObfTokenCreateKind,\n} from \"@particle-academy/zoom-ui\";\n\nimport { zoomMeetingGet } from \"./actions/meeting-get.js\";\nimport { zoomObfTokenCreate } from \"./actions/obf-token-create.js\";\n\nexport const zoomMeetingGetExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await zoomMeetingGet({\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: `zoom meeting_get ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const zoomObfTokenCreateExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await zoomObfTokenCreate({\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: `zoom obf_token_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 ZOOM_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...zoomMeetingGetKind, executor: zoomMeetingGetExecutor },\n  { ...zoomObfTokenCreateKind, executor: zoomObfTokenCreateExecutor },\n];\n"]}

package/dist/flow.d.cts

@@ -0,0 +1,27 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ 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/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Zoom's node kinds with their TypeScript executors attached — for hosts that
+ * EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/zoom-ui carries no executor: the
+ * editor is React on every host, so a PHP or Python project installs the ui
+ * package and never this one.
+ */
+
+declare const zoomMeetingGetExecutor: NodeExecutor;
+declare const zoomObfTokenCreateExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const ZOOM_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { ZOOM_RUNNABLE_KINDS, zoomMeetingGetExecutor, zoomObfTokenCreateExecutor };

package/dist/flow.d.ts

@@ -0,0 +1,27 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ 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/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Zoom's node kinds with their TypeScript executors attached — for hosts that
+ * EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/zoom-ui carries no executor: the
+ * editor is React on every host, so a PHP or Python project installs the ui
+ * package and never this one.
+ */
+
+declare const zoomMeetingGetExecutor: NodeExecutor;
+declare const zoomObfTokenCreateExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const ZOOM_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { ZOOM_RUNNABLE_KINDS, zoomMeetingGetExecutor, zoomObfTokenCreateExecutor };

package/dist/flow.js

@@ -0,0 +1,40 @@
+import { zoomMeetingGet, zoomObfTokenCreate } from './chunk-2A3B3B5A.js';
+import '@particle-academy/fancy-connector-core';
+import { zoomMeetingGetKind, zoomObfTokenCreateKind } from '@particle-academy/zoom-ui';
+
+var zoomMeetingGetExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await zoomMeetingGet({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `zoom meeting_get ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var zoomObfTokenCreateExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await zoomObfTokenCreate({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `zoom obf_token_create ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var ZOOM_RUNNABLE_KINDS = [
+  { ...zoomMeetingGetKind, executor: zoomMeetingGetExecutor },
+  { ...zoomObfTokenCreateKind, executor: zoomObfTokenCreateExecutor }
+];
+
+export { ZOOM_RUNNABLE_KINDS, zoomMeetingGetExecutor, zoomObfTokenCreateExecutor };
+//# sourceMappingURL=flow.js.map
+//# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAsCO,IAAM,sBAAA,GAAuC,OAAO,GAAA,KAAQ;AACjE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,cAAA,CAAe;AAAA,IAClC,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,iBAAA,EAAqB,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAClF,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAEO,IAAM,0BAAA,GAA2C,OAAO,GAAA,KAAQ;AACrE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,kBAAA,CAAmB;AAAA,IACtC,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,sBAAA,EAA0B,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GACvF,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,mBAAA,GAA4C;AAAA,EACvD,EAAE,GAAG,kBAAA,EAAoB,QAAA,EAAU,sBAAA,EAAuB;AAAA,EAC1D,EAAE,GAAG,sBAAA,EAAwB,QAAA,EAAU,0BAAA;AACzC","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 -- zoom\n */\n\n/**\n * Zoom's node kinds with their TypeScript executors attached — for hosts that\n * EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/zoom-ui carries no executor: the\n * editor is React on every host, so a PHP or Python project installs the ui\n * 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 { ZOOM } from \"./service.js\";\n\nimport {\n  zoomMeetingGetKind,\n  zoomObfTokenCreateKind,\n} from \"@particle-academy/zoom-ui\";\n\nimport { zoomMeetingGet } from \"./actions/meeting-get.js\";\nimport { zoomObfTokenCreate } from \"./actions/obf-token-create.js\";\n\nexport const zoomMeetingGetExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await zoomMeetingGet({\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: `zoom meeting_get ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const zoomObfTokenCreateExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await zoomObfTokenCreate({\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: `zoom obf_token_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 ZOOM_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...zoomMeetingGetKind, executor: zoomMeetingGetExecutor },\n  { ...zoomObfTokenCreateKind, executor: zoomObfTokenCreateExecutor },\n];\n"]}

package/dist/index.cjs

@@ -0,0 +1,124 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+
+// src/faker.ts
+function fakeMeetingGet({ config, fake }) {
+  return {
+    "id": config.meetingId !== void 0 && config.meetingId !== null && config.meetingId !== "" ? Number.isFinite(Number(config.meetingId)) ? Math.trunc(Number(config.meetingId)) : null : Array.from({ length: 10 }, () => fake.int(0, 9)).join(""),
+    "uuid": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,
+    "host_id": fake.id("u"),
+    "topic": "Weekly sync",
+    "type": 2,
+    "status": "waiting",
+    "start_time": "2026-09-22T14:00:00Z",
+    "duration": 30,
+    "timezone": "America/New_York",
+    "agenda": "",
+    "join_url": "https://zoom.us/j/1234567890?pwd=fake",
+    "password": Array.from({ length: 6 }, () => fake.int(0, 9)).join(""),
+    "settings": {
+      "waiting_room": true,
+      "join_before_host": false,
+      "approval_type": 2
+    }
+  };
+}
+function fakeObfTokenCreate({ config, fake }) {
+  return {
+    "token": fake.id("obf")
+  };
+}
+var zoomFaker = (operation, request) => {
+  switch (operation) {
+    case "meeting_get":
+      return fakeMeetingGet(request);
+    case "obf_token_create":
+      return fakeObfTokenCreate(request);
+    default:
+      throw new Error(
+        `zoom: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var ZOOM_BASE_URLS = {
+  "live": "https://api.zoom.us/v2"
+};
+var ZOOM_REQUIRES = [
+  "accessToken"
+];
+function zoomAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var ZOOM = {
+  service: "zoom",
+  title: "Zoom",
+  sandbox: "unverified",
+  baseUrls: { ...ZOOM_BASE_URLS },
+  requires: [...ZOOM_REQUIRES],
+  authorize: zoomAuthorize,
+  faker: zoomFaker
+};
+var MEETING_GET_OPERATION = "meeting_get";
+async function zoomMeetingGet(options) {
+  const config = options.config ?? {};
+  if (config.meetingId === void 0 || config.meetingId === null || config.meetingId === "") {
+    throw new Error(`meeting_get: "meetingId" is required (Meeting ID).`);
+  }
+  return fancyConnectorCore.callConnector(ZOOM, {
+    operation: MEETING_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: `/meetings/${encodeURIComponent(String(config.meetingId))}`,
+      query: {}
+    }
+  });
+}
+var OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
+async function zoomObfTokenCreate(options) {
+  const config = options.config ?? {};
+  if (config.meetingId === void 0 || config.meetingId === null || config.meetingId === "") {
+    throw new Error(`obf_token_create: "meetingId" is required (Meeting ID).`);
+  }
+  return fancyConnectorCore.callConnector(ZOOM, {
+    operation: OBF_TOKEN_CREATE_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: "/users/me/token",
+      query: {
+        "meeting_id": String(config.meetingId),
+        "type": "onbehalf"
+      }
+    }
+  });
+}
+
+exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
+exports.MEETING_GET_OPERATION = MEETING_GET_OPERATION;
+exports.OBF_TOKEN_CREATE_OPERATION = OBF_TOKEN_CREATE_OPERATION;
+exports.ZOOM = ZOOM;
+exports.ZOOM_BASE_URLS = ZOOM_BASE_URLS;
+exports.ZOOM_REQUIRES = ZOOM_REQUIRES;
+exports.zoomAuthorize = zoomAuthorize;
+exports.zoomFaker = zoomFaker;
+exports.zoomMeetingGet = zoomMeetingGet;
+exports.zoomObfTokenCreate = zoomObfTokenCreate;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/meeting-get.ts","../src/actions/obf-token-create.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 -- zoom\n */\n\n/**\n * The Zoom faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Zoom actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real 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 fakeMeetingGet({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": (config.meetingId !== undefined && config.meetingId !== null && config.meetingId !== \"\" ? (Number.isFinite(Number(config.meetingId)) ? Math.trunc(Number(config.meetingId)) : null) : Array.from({ length: 10 }, () => fake.int(0, 9)).join(\"\")),\n    \"uuid\": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,\n    \"host_id\": fake.id(\"u\"),\n    \"topic\": \"Weekly sync\",\n    \"type\": 2,\n    \"status\": \"waiting\",\n    \"start_time\": \"2026-09-22T14:00:00Z\",\n    \"duration\": 30,\n    \"timezone\": \"America/New_York\",\n    \"agenda\": \"\",\n    \"join_url\": \"https://zoom.us/j/1234567890?pwd=fake\",\n    \"password\": Array.from({ length: 6 }, () => fake.int(0, 9)).join(\"\"),\n    \"settings\": {\n      \"waiting_room\": true,\n      \"join_before_host\": false,\n      \"approval_type\": 2,\n    },\n  };\n}\n\nfunction fakeObfTokenCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"token\": fake.id(\"obf\"),\n  };\n}\n\nexport const zoomFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"meeting_get\":\n      return fakeMeetingGet(request);\n\n    case \"obf_token_create\":\n      return fakeObfTokenCreate(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        `zoom: 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 -- zoom\n */\n\n/**\n * Zoom, as one service descriptor shared by every Zoom operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Zoom: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Zoom has no test estate distinct from a real account, as far as this review\n * found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call\n * authorizes against the caller's own Zoom account and can read real meeting\n * data. Use fake mode while building.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { zoomFaker } 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 ZOOM_BASE_URLS = {\n  \"live\": \"https://api.zoom.us/v2\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const ZOOM_REQUIRES = [\n  \"accessToken\"\n] as const;\n\n/**\n * Apply Zoom's auth scheme to an outgoing request.\n *\n * Every Zoom REST call is a Bearer token on the Authorization header, OAuth or\n * Server-to-Server alike; this provider declares the user OAuth shape so a\n * host can connect a rep's own Zoom account rather than one shared app-wide\n * identity.\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 zoomAuthorize(\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 Zoom service, for the TypeScript runtime. */\nexport const ZOOM: ServiceDescriptor = {\n  service: \"zoom\",\n  title: \"Zoom\",\n  sandbox: \"unverified\",\n  baseUrls: { ...ZOOM_BASE_URLS },\n  requires: [...ZOOM_REQUIRES],\n  authorize: zoomAuthorize,\n  faker: zoomFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/meeting-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/meeting-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- zoom\n */\n\n/**\n * Read a Zoom meeting's join details and settings.\n *\n * GET /meetings/{meetingId} — https://developers.zoom.us/docs/api/meetings/\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 Zoom or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { ZOOM } from \"../service.js\";\n\nexport const MEETING_GET_OPERATION = \"meeting_get\";\n\nexport type MeetingGetOptions = {\n  /** The node's resolved config. Keys: meetingId. */\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 zoomMeetingGet(options: MeetingGetOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.meetingId === undefined || config.meetingId === null || config.meetingId === \"\") {\n    throw new Error(`meeting_get: \"meetingId\" is required (Meeting ID).`);\n  }\n\n  return callConnector(ZOOM, {\n    operation: MEETING_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: `/meetings/${encodeURIComponent(String(config.meetingId))}`,\n      query: {},\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/obf-token-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/obf-token-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- zoom\n */\n\n/**\n * Mint a short-lived token so a bot can join a Zoom meeting on the authorising\n * user's behalf.\n *\n * GET /users/me/token —\n * https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/\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 Zoom or calls the 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 { ZOOM } from \"../service.js\";\n\nexport const OBF_TOKEN_CREATE_OPERATION = \"obf_token_create\";\n\nexport type ObfTokenCreateOptions = {\n  /** The node's resolved config. Keys: meetingId. */\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 zoomObfTokenCreate(options: ObfTokenCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.meetingId === undefined || config.meetingId === null || config.meetingId === \"\") {\n    throw new Error(`obf_token_create: \"meetingId\" is required (Meeting ID).`);\n  }\n\n  return callConnector(ZOOM, {\n    operation: OBF_TOKEN_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: \"GET\",\n      path: \"/users/me/token\",\n      query: {\n        \"meeting_id\": String(config.meetingId),\n        \"type\": \"onbehalf\",\n      },\n    },\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,153 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.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/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Zoom, as one service descriptor shared by every Zoom operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Zoom: its base URL, its auth
+ * scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Zoom has no test estate distinct from a real account, as far as this review
+ * found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call
+ * authorizes against the caller's own Zoom account and can read real meeting
+ * data. Use fake mode while building.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const ZOOM_BASE_URLS: {
+    readonly live: "https://api.zoom.us/v2";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const ZOOM_REQUIRES: readonly ["accessToken"];
+/**
+ * Apply Zoom's auth scheme to an outgoing request.
+ *
+ * Every Zoom REST call is a Bearer token on the Authorization header, OAuth or
+ * Server-to-Server alike; this provider declares the user OAuth shape so a
+ * host can connect a rep's own Zoom account rather than one shared app-wide
+ * identity.
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function zoomAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Zoom service, for the TypeScript runtime. */
+declare const ZOOM: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ 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/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * The Zoom faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Zoom actually publishes, so an author can wire {{ $json.data.id }}
+ * against a fake and have it keep working against the real thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const zoomFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/meeting-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/meeting-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Read a Zoom meeting's join details and settings.
+ *
+ * GET /meetings/{meetingId} — https://developers.zoom.us/docs/api/meetings/
+ *
+ * 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 Zoom or calls the faker.
+ */
+
+declare const MEETING_GET_OPERATION = "meeting_get";
+type MeetingGetOptions = {
+    /** The node's resolved config. Keys: meetingId. */
+    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 zoomMeetingGet(options: MeetingGetOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/obf-token-create.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/obf-token-create.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Mint a short-lived token so a bot can join a Zoom meeting on the authorising
+ * user's behalf.
+ *
+ * GET /users/me/token —
+ * https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/
+ *
+ * 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 Zoom or calls the faker.
+ *
+ * sideEffects: unsafe-to-replay.
+ */
+
+declare const OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
+type ObfTokenCreateOptions = {
+    /** The node's resolved config. Keys: meetingId. */
+    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 zoomObfTokenCreate(options: ObfTokenCreateOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, MEETING_GET_OPERATION, type MeetingGetOptions, OBF_TOKEN_CREATE_OPERATION, type ObfTokenCreateOptions, ZOOM, ZOOM_BASE_URLS, ZOOM_REQUIRES, zoomAuthorize, zoomFaker, zoomMeetingGet, zoomObfTokenCreate };

package/dist/index.d.ts

@@ -0,0 +1,153 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.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/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Zoom, as one service descriptor shared by every Zoom operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Zoom: its base URL, its auth
+ * scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Zoom has no test estate distinct from a real account, as far as this review
+ * found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call
+ * authorizes against the caller's own Zoom account and can read real meeting
+ * data. Use fake mode while building.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const ZOOM_BASE_URLS: {
+    readonly live: "https://api.zoom.us/v2";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const ZOOM_REQUIRES: readonly ["accessToken"];
+/**
+ * Apply Zoom's auth scheme to an outgoing request.
+ *
+ * Every Zoom REST call is a Bearer token on the Authorization header, OAuth or
+ * Server-to-Server alike; this provider declares the user OAuth shape so a
+ * host can connect a rep's own Zoom account rather than one shared app-wide
+ * identity.
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function zoomAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Zoom service, for the TypeScript runtime. */
+declare const ZOOM: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ 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/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * The Zoom faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Zoom actually publishes, so an author can wire {{ $json.data.id }}
+ * against a fake and have it keep working against the real thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const zoomFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/meeting-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/meeting-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Read a Zoom meeting's join details and settings.
+ *
+ * GET /meetings/{meetingId} — https://developers.zoom.us/docs/api/meetings/
+ *
+ * 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 Zoom or calls the faker.
+ */
+
+declare const MEETING_GET_OPERATION = "meeting_get";
+type MeetingGetOptions = {
+    /** The node's resolved config. Keys: meetingId. */
+    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 zoomMeetingGet(options: MeetingGetOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/obf-token-create.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/obf-token-create.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- zoom
+ */
+/**
+ * Mint a short-lived token so a bot can join a Zoom meeting on the authorising
+ * user's behalf.
+ *
+ * GET /users/me/token —
+ * https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/
+ *
+ * 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 Zoom or calls the faker.
+ *
+ * sideEffects: unsafe-to-replay.
+ */
+
+declare const OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
+type ObfTokenCreateOptions = {
+    /** The node's resolved config. Keys: meetingId. */
+    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 zoomObfTokenCreate(options: ObfTokenCreateOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, MEETING_GET_OPERATION, type MeetingGetOptions, OBF_TOKEN_CREATE_OPERATION, type ObfTokenCreateOptions, ZOOM, ZOOM_BASE_URLS, ZOOM_REQUIRES, zoomAuthorize, zoomFaker, zoomMeetingGet, zoomObfTokenCreate };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CONNECTOR_API_VERSION, MEETING_GET_OPERATION, OBF_TOKEN_CREATE_OPERATION, ZOOM, ZOOM_BASE_URLS, ZOOM_REQUIRES, zoomAuthorize, zoomFaker, zoomMeetingGet, zoomObfTokenCreate } from './chunk-2A3B3B5A.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -1,18 +1,90 @@
 {
   "name": "@particle-academy/zoom-js",
-  "version": "0.0.0",
-  "description": "A placeholder that claims the name @particle-academy/zoom-js; the real release follows through Fancy-Friends/zoom's publish.yml with provenance. Do not install this version.",
-  "license": "MIT",
+  "version": "0.2.0",
+  "description": "Zoom 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",
     "url": "git+https://github.com/Fancy-Friends/zoom.git",
     "directory": "packages/js"
   },
   "homepage": "https://github.com/Fancy-Friends/zoom#readme",
+  "bugs": "https://github.com/Fancy-Friends/zoom/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./flow": {
+      "import": {
+        "types": "./dist/flow.d.ts",
+        "default": "./dist/flow.js"
+      },
+      "require": {
+        "types": "./dist/flow.d.cts",
+        "default": "./dist/flow.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "art",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "tsc --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "prepublishOnly": "tsup"
+  },
+  "dependencies": {
+    "@particle-academy/fancy-connector-core": ">=0.4.0 <2.0"
+  },
+  "peerDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@particle-academy/zoom-ui": ">=0.2.0 <0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@particle-academy/fancy-flow": {
+      "optional": true
+    },
+    "@particle-academy/zoom-ui": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@types/node": "^26.2.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "files": [
-    "README.md"
-  ]
+  "keywords": [
+    "zoom",
+    "messaging",
+    "connector",
+    "api",
+    "fancy-ui",
+    "particle-academy"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  }
 }