@particle-academy/zoom-ui 0.0.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +44 -0
- package/LICENSE +21 -0
- package/README.md +117 -2
- package/art/fancified.svg +26 -0
- package/dist/index.cjs +221 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +156 -0
- package/dist/index.d.ts +156 -0
- package/dist/index.js +204 -0
- package/dist/index.js.map +1 -0
- package/package.json +57 -6
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Changelog — Zoom
|
|
2
|
+
|
|
3
|
+
All four packages — `@particle-academy/zoom-ui`, `@particle-academy/zoom-js`,
|
|
4
|
+
`particle-academy/zoom-php` and `fancy-zoom` — are released together under one
|
|
5
|
+
version. They are generated from one `provider/` definition, so a change to it
|
|
6
|
+
changes all four, and separate version lines would only record which of the
|
|
7
|
+
four somebody remembered to bump.
|
|
8
|
+
|
|
9
|
+
**Write entries HERE**, in the weaver envelope at `providers/zoom/CHANGELOG.md`,
|
|
10
|
+
then regenerate. This file is the one thing in a release that cannot be derived
|
|
11
|
+
— somebody has to write what changed — but writing it in the provider repo
|
|
12
|
+
would be a hand-edit that `.weaver.json` flags and the next sync destroys.
|
|
13
|
+
|
|
14
|
+
## [0.2.0] — 2026-11-08
|
|
15
|
+
|
|
16
|
+
### Added
|
|
17
|
+
|
|
18
|
+
- **Laravel integration, in this package** (`src/Laravel/`), auto-discovered
|
|
19
|
+
through composer's `extra.laravel`. Laravel is SUGGESTED, never required:
|
|
20
|
+
outside a Laravel app none of it loads.
|
|
21
|
+
- a service provider that merges `config/zoom.php` under
|
|
22
|
+
`connectors.zoom` (credentials from the environment, or per call for a
|
|
23
|
+
multi-account app);
|
|
24
|
+
- the `Zoom` facade: `Zoom::call('<operation>', [...])` runs any action;
|
|
25
|
+
- `Zoom::fake()`, answered from the connector's faker, with
|
|
26
|
+
`assertSent` / `assertNotSent` / `assertNothingSent` / `assertSentCount`;
|
|
27
|
+
- its own Pest test of all of it against a booted Laravel app.
|
|
28
|
+
|
|
29
|
+
### Changed
|
|
30
|
+
|
|
31
|
+
- **Tests: Pest `^5`**, and `laravel/framework` `^13` as a DEV-ONLY test
|
|
32
|
+
dependency (the framework this package integrates with; nothing ships in
|
|
33
|
+
`require`).
|
|
34
|
+
|
|
35
|
+
## [0.1.0] — 2026-09-16
|
|
36
|
+
|
|
37
|
+
### Added
|
|
38
|
+
|
|
39
|
+
- **`meeting_get`** — read a meeting's join link and settings (`GET /meetings/{meetingId}`, scope `meeting:read:meeting`).
|
|
40
|
+
- **`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.
|
|
41
|
+
- 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.
|
|
42
|
+
- 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.
|
|
43
|
+
|
|
44
|
+
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
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Particle Academy
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,118 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Zoom
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://particle.academy)
|
|
4
|
+
|
|
5
|
+
Zoom for [fancy-flow][flow] — as **four imported, versioned packages**, one
|
|
6
|
+
per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
|
|
7
|
+
change.
|
|
8
|
+
|
|
9
|
+
[flow]: https://github.com/Particle-Academy/fancy-flow
|
|
10
|
+
|
|
11
|
+
| Runtime | Package | Install |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| Authoring surface (every host) | `@particle-academy/zoom-ui` | `npm install @particle-academy/zoom-ui` |
|
|
14
|
+
| Node | `@particle-academy/zoom-js` | `npm install @particle-academy/zoom-js` |
|
|
15
|
+
| PHP 8.4+ | `particle-academy/zoom-php` | `composer require particle-academy/zoom-php` |
|
|
16
|
+
| Python 3.11+ | `fancy-zoom` | `pip install fancy-zoom` |
|
|
17
|
+
|
|
18
|
+
The `ui` package is the editor surface and is React on every host — a PHP or
|
|
19
|
+
Python project installs it *and* its own runtime package, and never the `js` one.
|
|
20
|
+
|
|
21
|
+
## What it costs you
|
|
22
|
+
|
|
23
|
+
One dependency: `@particle-academy/fancy-connector-core` (or
|
|
24
|
+
`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
|
|
25
|
+
packages pull in themselves. The Python package has **zero** runtime
|
|
26
|
+
dependencies.
|
|
27
|
+
|
|
28
|
+
**No Zoom SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
|
|
29
|
+
subject to the kit's full approval bar, and one per provider is hundreds of
|
|
30
|
+
dependencies nobody is tracking.
|
|
31
|
+
|
|
32
|
+
## Setting it up
|
|
33
|
+
|
|
34
|
+
Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
|
|
35
|
+
|
|
36
|
+
### Credentials
|
|
37
|
+
|
|
38
|
+
A Zoom connection holds 4 values.
|
|
39
|
+
|
|
40
|
+
**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.
|
|
41
|
+
|
|
42
|
+
| Field | Scope | Secret | Where it comes from |
|
|
43
|
+
|---|---|---|---|
|
|
44
|
+
| **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. |
|
|
45
|
+
| **OAuth client secret** | per installation | **secret** | From the same app. Used to exchange the code and to refresh; never sent with an API request. |
|
|
46
|
+
| **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. |
|
|
47
|
+
| **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. |
|
|
48
|
+
|
|
49
|
+
### Authorising
|
|
50
|
+
|
|
51
|
+
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.
|
|
52
|
+
|
|
53
|
+
- **Authorize URL** — https://zoom.us/oauth/authorize
|
|
54
|
+
- **Token URL** — https://zoom.us/oauth/token
|
|
55
|
+
- **Scopes** — `meeting:read:meeting`, `user:read:token`
|
|
56
|
+
- **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
|
|
57
|
+
|
|
58
|
+
**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.
|
|
59
|
+
|
|
60
|
+
Two consequences, both of which a host gets wrong by default:
|
|
61
|
+
|
|
62
|
+
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.
|
|
63
|
+
2. **Do not refresh CONCURRENTLY.** Two workers refreshing at once means one of them replays.
|
|
64
|
+
|
|
65
|
+
Persist the returned token before using the access token it came with.
|
|
66
|
+
|
|
67
|
+
### The estate
|
|
68
|
+
|
|
69
|
+
**Nobody has checked whether Zoom has a test estate.** Treat every call as real.
|
|
70
|
+
|
|
71
|
+
> 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.
|
|
72
|
+
|
|
73
|
+
## What it can do
|
|
74
|
+
|
|
75
|
+
### Actions
|
|
76
|
+
|
|
77
|
+
#### `meeting_get` — Get meeting
|
|
78
|
+
|
|
79
|
+
Read a Zoom meeting's join details and settings.
|
|
80
|
+
|
|
81
|
+
`GET /meetings/{meetingId}` · reads only — safe to replay
|
|
82
|
+
|
|
83
|
+
| Input | Required | What it is |
|
|
84
|
+
|---|---|---|
|
|
85
|
+
| `meetingId` | yes | The meeting's numeric id, from its join URL or from Zoom's own meeting list. |
|
|
86
|
+
|
|
87
|
+
#### `obf_token_create` — Mint on-behalf-of token
|
|
88
|
+
|
|
89
|
+
Mint a short-lived token so a bot can join a Zoom meeting on the authorising user's behalf.
|
|
90
|
+
|
|
91
|
+
`GET /users/me/token` · **unsafe to replay** — a retried durable run does it TWICE
|
|
92
|
+
|
|
93
|
+
| Input | Required | What it is |
|
|
94
|
+
|---|---|---|
|
|
95
|
+
| `meetingId` | yes | The meeting the bot is about to join. The minted token works for this meeting only. |
|
|
96
|
+
|
|
97
|
+
## Run it before you have credentials
|
|
98
|
+
|
|
99
|
+
Every operation ships a **faker**, whether or not Zoom has a sandbox. Set a
|
|
100
|
+
node's mode to `fake` and it returns the shape Zoom actually publishes — the
|
|
101
|
+
same field names, deterministically — so you can wire the downstream nodes before
|
|
102
|
+
touching an account, a key, or a network.
|
|
103
|
+
|
|
104
|
+
## This repository is generated
|
|
105
|
+
|
|
106
|
+
`provider/` is the source. Everything under `packages/` is emitted from it and
|
|
107
|
+
**must not be hand-edited** — CI regenerates and diffs on every push, and the
|
|
108
|
+
next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
|
|
109
|
+
|
|
110
|
+
## Two namespaces, which do not match on purpose
|
|
111
|
+
|
|
112
|
+
The repo is `github.com/Fancy-Friends/zoom`; the packages publish under
|
|
113
|
+
`particle-academy`. Nothing derives one from the other — the names come from
|
|
114
|
+
weaver's `friends.json` and nowhere else.
|
|
115
|
+
|
|
116
|
+
## Licence
|
|
117
|
+
|
|
118
|
+
MIT.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="128" height="28" role="img" aria-label="Fancified — built with Fancy UI">
|
|
2
|
+
<title>Fancified · built with Fancy UI</title>
|
|
3
|
+
<defs>
|
|
4
|
+
<linearGradient id="fcdBg" x1="0" y1="0" x2="1" y2="1">
|
|
5
|
+
<stop offset="0" stop-color="#6d28d9"/>
|
|
6
|
+
<stop offset=".5" stop-color="#9333ea"/>
|
|
7
|
+
<stop offset="1" stop-color="#d946ef"/>
|
|
8
|
+
</linearGradient>
|
|
9
|
+
<linearGradient id="fcdGloss" x1="0" y1="0" x2="0" y2="1">
|
|
10
|
+
<stop offset="0" stop-color="#ffffff" stop-opacity=".30"/>
|
|
11
|
+
<stop offset=".55" stop-color="#ffffff" stop-opacity="0"/>
|
|
12
|
+
</linearGradient>
|
|
13
|
+
<clipPath id="fcdClip"><rect width="128" height="28" rx="7"/></clipPath>
|
|
14
|
+
</defs>
|
|
15
|
+
<g clip-path="url(#fcdClip)">
|
|
16
|
+
<rect width="128" height="28" fill="url(#fcdBg)"/>
|
|
17
|
+
<rect width="34" height="28" fill="#3b0764" fill-opacity=".5"/>
|
|
18
|
+
<rect width="128" height="13" fill="url(#fcdGloss)"/>
|
|
19
|
+
<g fill="#fff">
|
|
20
|
+
<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"/>
|
|
21
|
+
<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"/>
|
|
22
|
+
</g>
|
|
23
|
+
<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>
|
|
24
|
+
</g>
|
|
25
|
+
<rect x=".5" y=".5" width="127" height="27" rx="6.5" fill="none" stroke="#ffffff" stroke-opacity=".22"/>
|
|
26
|
+
</svg>
|
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var connectors = require('@particle-academy/fancy-flow/connectors');
|
|
4
|
+
|
|
5
|
+
// src/service.ts
|
|
6
|
+
var CONNECTOR_API_VERSION = 1;
|
|
7
|
+
var ZOOM_SERVICE = {
|
|
8
|
+
service: "zoom",
|
|
9
|
+
serviceTitle: "Zoom",
|
|
10
|
+
domain: "messaging",
|
|
11
|
+
sandbox: "unverified"
|
|
12
|
+
};
|
|
13
|
+
var ZOOM_CREDENTIALS = [
|
|
14
|
+
{
|
|
15
|
+
"key": "clientId",
|
|
16
|
+
"label": "OAuth client ID",
|
|
17
|
+
"scope": "provider",
|
|
18
|
+
"secret": false,
|
|
19
|
+
"help": "From the Zoom app you registered at marketplace.zoom.us. One value for the whole installation -- the same app serves every connected Zoom account."
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"key": "clientSecret",
|
|
23
|
+
"label": "OAuth client secret",
|
|
24
|
+
"scope": "provider",
|
|
25
|
+
"secret": true,
|
|
26
|
+
"help": "From the same app. Used to exchange the code and to refresh; never sent with an API request."
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"key": "accessToken",
|
|
30
|
+
"label": "Access token",
|
|
31
|
+
"scope": "account",
|
|
32
|
+
"secret": true,
|
|
33
|
+
"help": "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."
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"key": "refreshToken",
|
|
37
|
+
"label": "Refresh token",
|
|
38
|
+
"scope": "account",
|
|
39
|
+
"secret": true,
|
|
40
|
+
"help": "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."
|
|
41
|
+
}
|
|
42
|
+
];
|
|
43
|
+
var ZOOM_OAUTH = {
|
|
44
|
+
"flow": "authorization_code",
|
|
45
|
+
"authorizeUrl": "https://zoom.us/oauth/authorize",
|
|
46
|
+
"tokenUrl": "https://zoom.us/oauth/token",
|
|
47
|
+
"scopes": [
|
|
48
|
+
"meeting:read:meeting",
|
|
49
|
+
"user:read:token"
|
|
50
|
+
],
|
|
51
|
+
"accessTokenCredential": "accessToken",
|
|
52
|
+
"refreshTokenCredential": "refreshToken",
|
|
53
|
+
"refreshTokenRotates": true,
|
|
54
|
+
"accessTokenTtlSeconds": 3600
|
|
55
|
+
};
|
|
56
|
+
function zoomMeta(role, operation, docs) {
|
|
57
|
+
return { ...ZOOM_SERVICE, role, operation, docs };
|
|
58
|
+
}
|
|
59
|
+
var ZOOM_MEETING_GET_KIND = "@particle-academy/zoom_meeting_get";
|
|
60
|
+
var ZOOM_MEETING_GET_OPERATION = "meeting_get";
|
|
61
|
+
var ZOOM_MEETING_GET_META = zoomMeta("action", "a Zoom meeting", "https://developers.zoom.us/docs/api/meetings/");
|
|
62
|
+
var ZOOM_MEETING_GET_OUTPUT = [
|
|
63
|
+
{
|
|
64
|
+
"path": "data.id",
|
|
65
|
+
"type": "number",
|
|
66
|
+
"description": "The meeting's numeric id (also called the meeting number)."
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"path": "data.uuid",
|
|
70
|
+
"type": "string",
|
|
71
|
+
"description": "A unique id for THIS instance of a recurring meeting; the meeting id alone is shared across occurrences."
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"path": "data.host_id",
|
|
75
|
+
"type": "string",
|
|
76
|
+
"description": "The Zoom user id of the meeting's host."
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
"path": "data.topic",
|
|
80
|
+
"type": "string",
|
|
81
|
+
"description": "The meeting's title."
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"path": "data.type",
|
|
85
|
+
"type": "number",
|
|
86
|
+
"description": "Zoom's numeric meeting type: 1 instant, 2 scheduled, 3 recurring with no fixed time, 8 recurring with a fixed time."
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
"path": "data.status",
|
|
90
|
+
"type": "string",
|
|
91
|
+
"description": "waiting, started, or finished."
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
"path": "data.start_time",
|
|
95
|
+
"type": "string",
|
|
96
|
+
"description": "ISO 8601 with a Z offset, e.g. 2026-09-15T14:00:00Z."
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
"path": "data.duration",
|
|
100
|
+
"type": "number",
|
|
101
|
+
"description": "Scheduled length, in minutes."
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
"path": "data.timezone",
|
|
105
|
+
"type": "string",
|
|
106
|
+
"description": "An IANA zone Zoom uses to render start_time in its own UI, e.g. America/New_York."
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"path": "data.agenda",
|
|
110
|
+
"type": "string",
|
|
111
|
+
"description": "The meeting's description, when the host set one."
|
|
112
|
+
},
|
|
113
|
+
{
|
|
114
|
+
"path": "data.join_url",
|
|
115
|
+
"type": "string",
|
|
116
|
+
"description": "The link a participant (or a meeting bot) uses to join."
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"path": "data.password",
|
|
120
|
+
"type": "string",
|
|
121
|
+
"description": "The passcode required to join, when the meeting has one."
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
"path": "data.settings.waiting_room",
|
|
125
|
+
"type": "boolean",
|
|
126
|
+
"description": "Whether Zoom holds joiners in a waiting room before admitting them -- a bot must be admitted like any guest."
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"path": "data.settings.join_before_host",
|
|
130
|
+
"type": "boolean",
|
|
131
|
+
"description": "Whether a participant may join before the host has started the meeting."
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"path": "data.settings.approval_type",
|
|
135
|
+
"type": "number",
|
|
136
|
+
"description": "0 automatically approve, 1 manually approve, 2 no registration required."
|
|
137
|
+
}
|
|
138
|
+
];
|
|
139
|
+
var zoomMeetingGetKind = connectors.defineConnectorKind(ZOOM_MEETING_GET_META, {
|
|
140
|
+
name: ZOOM_MEETING_GET_KIND,
|
|
141
|
+
aliases: ["zoom_meeting_get"],
|
|
142
|
+
label: "Get meeting",
|
|
143
|
+
description: "Read a Zoom meeting's join details and settings.",
|
|
144
|
+
icon: "\u{1F3A5}",
|
|
145
|
+
inputs: [{ id: "in" }],
|
|
146
|
+
outputs: [{ id: "out" }],
|
|
147
|
+
sideEffects: "none",
|
|
148
|
+
outputShape: ZOOM_MEETING_GET_OUTPUT,
|
|
149
|
+
configSchema: [
|
|
150
|
+
{
|
|
151
|
+
"type": "text",
|
|
152
|
+
"key": "meetingId",
|
|
153
|
+
"label": "Meeting ID",
|
|
154
|
+
"required": true,
|
|
155
|
+
"description": "The meeting's numeric id, from its join URL or from Zoom's own meeting list."
|
|
156
|
+
}
|
|
157
|
+
],
|
|
158
|
+
defaultConfig: {
|
|
159
|
+
"mode": "auto"
|
|
160
|
+
},
|
|
161
|
+
renderBody: ({ config }) => connectors.summarize(ZOOM_MEETING_GET_META, config, "a Zoom meeting")
|
|
162
|
+
});
|
|
163
|
+
var ZOOM_OBF_TOKEN_CREATE_KIND = "@particle-academy/zoom_obf_token_create";
|
|
164
|
+
var ZOOM_OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
|
|
165
|
+
var ZOOM_OBF_TOKEN_CREATE_META = zoomMeta("action", "an on-behalf-of token", "https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/");
|
|
166
|
+
var ZOOM_OBF_TOKEN_CREATE_OUTPUT = [
|
|
167
|
+
{
|
|
168
|
+
"path": "data.token",
|
|
169
|
+
"type": "string",
|
|
170
|
+
"description": "The OBF token. Present it the way the Meeting SDK's join call expects; it is not a Bearer header value on Zoom's REST API."
|
|
171
|
+
}
|
|
172
|
+
];
|
|
173
|
+
var zoomObfTokenCreateKind = connectors.defineConnectorKind(ZOOM_OBF_TOKEN_CREATE_META, {
|
|
174
|
+
name: ZOOM_OBF_TOKEN_CREATE_KIND,
|
|
175
|
+
aliases: ["zoom_obf_token_create"],
|
|
176
|
+
label: "Mint on-behalf-of token",
|
|
177
|
+
description: "Mint a short-lived token so a bot can join a Zoom meeting on the authorising user's behalf.",
|
|
178
|
+
icon: "\u{1F511}",
|
|
179
|
+
inputs: [{ id: "in" }],
|
|
180
|
+
outputs: [{ id: "out" }],
|
|
181
|
+
sideEffects: "unsafe-to-replay",
|
|
182
|
+
outputShape: ZOOM_OBF_TOKEN_CREATE_OUTPUT,
|
|
183
|
+
configSchema: [
|
|
184
|
+
{
|
|
185
|
+
"type": "text",
|
|
186
|
+
"key": "meetingId",
|
|
187
|
+
"label": "Meeting ID",
|
|
188
|
+
"required": true,
|
|
189
|
+
"description": "The meeting the bot is about to join. The minted token works for this meeting only."
|
|
190
|
+
}
|
|
191
|
+
],
|
|
192
|
+
defaultConfig: {
|
|
193
|
+
"mode": "auto"
|
|
194
|
+
},
|
|
195
|
+
renderBody: ({ config }) => connectors.summarize(ZOOM_OBF_TOKEN_CREATE_META, config, "an on-behalf-of token")
|
|
196
|
+
});
|
|
197
|
+
|
|
198
|
+
// src/index.ts
|
|
199
|
+
var ZOOM_KINDS = [
|
|
200
|
+
zoomMeetingGetKind,
|
|
201
|
+
zoomObfTokenCreateKind
|
|
202
|
+
];
|
|
203
|
+
|
|
204
|
+
exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
|
|
205
|
+
exports.ZOOM_CREDENTIALS = ZOOM_CREDENTIALS;
|
|
206
|
+
exports.ZOOM_KINDS = ZOOM_KINDS;
|
|
207
|
+
exports.ZOOM_MEETING_GET_KIND = ZOOM_MEETING_GET_KIND;
|
|
208
|
+
exports.ZOOM_MEETING_GET_META = ZOOM_MEETING_GET_META;
|
|
209
|
+
exports.ZOOM_MEETING_GET_OPERATION = ZOOM_MEETING_GET_OPERATION;
|
|
210
|
+
exports.ZOOM_MEETING_GET_OUTPUT = ZOOM_MEETING_GET_OUTPUT;
|
|
211
|
+
exports.ZOOM_OAUTH = ZOOM_OAUTH;
|
|
212
|
+
exports.ZOOM_OBF_TOKEN_CREATE_KIND = ZOOM_OBF_TOKEN_CREATE_KIND;
|
|
213
|
+
exports.ZOOM_OBF_TOKEN_CREATE_META = ZOOM_OBF_TOKEN_CREATE_META;
|
|
214
|
+
exports.ZOOM_OBF_TOKEN_CREATE_OPERATION = ZOOM_OBF_TOKEN_CREATE_OPERATION;
|
|
215
|
+
exports.ZOOM_OBF_TOKEN_CREATE_OUTPUT = ZOOM_OBF_TOKEN_CREATE_OUTPUT;
|
|
216
|
+
exports.ZOOM_SERVICE = ZOOM_SERVICE;
|
|
217
|
+
exports.zoomMeetingGetKind = zoomMeetingGetKind;
|
|
218
|
+
exports.zoomMeta = zoomMeta;
|
|
219
|
+
exports.zoomObfTokenCreateKind = zoomObfTokenCreateKind;
|
|
220
|
+
//# sourceMappingURL=index.cjs.map
|
|
221
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/service.ts","../src/kinds/meeting-get.ts","../src/kinds/obf-token-create.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n * npm run provider -- zoom\n */\n\n/**\n * Zoom's identity on the authoring surface, shared by every Zoom node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\n *\n * 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 { ConnectorDomain, ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported — an imported constant lets an upgrade rewrite the\n * very claim it exists to detect.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const ZOOM_SERVICE = {\n service: \"zoom\",\n serviceTitle: \"Zoom\",\n domain: \"messaging\",\n sandbox: \"unverified\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/**\n * Every connector domain weaver knows, pinned against fancy-flow's union.\n *\n * A closed set copied into three codebases stays correct only while something\n * MAKES it: this line fails to compile the moment weaver carries a value\n * fancy-flow does not, including the values no provider uses yet.\n */\nconst WEAVER_DOMAINS: readonly ConnectorDomain[] = [\n \"payments\",\n \"commerce\",\n \"messaging\",\n \"email\",\n \"crm\",\n \"support\",\n \"storage\",\n \"calendar\",\n \"productivity\",\n \"database\",\n \"devtools\",\n \"analytics\",\n \"marketing\",\n \"ai\",\n \"forms\",\n \"hr\",\n \"geo\"\n];\nvoid WEAVER_DOMAINS;\n\n/** The credentials a Zoom connection holds. */\nexport const ZOOM_CREDENTIALS = [\n {\n \"key\": \"clientId\",\n \"label\": \"OAuth client ID\",\n \"scope\": \"provider\",\n \"secret\": false,\n \"help\": \"From the Zoom app you registered at marketplace.zoom.us. One value for the whole installation -- the same app serves every connected Zoom account.\"\n },\n {\n \"key\": \"clientSecret\",\n \"label\": \"OAuth client secret\",\n \"scope\": \"provider\",\n \"secret\": true,\n \"help\": \"From the same app. Used to exchange the code and to refresh; never sent with an API request.\"\n },\n {\n \"key\": \"accessToken\",\n \"label\": \"Access token\",\n \"scope\": \"account\",\n \"secret\": true,\n \"help\": \"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.\"\n },\n {\n \"key\": \"refreshToken\",\n \"label\": \"Refresh token\",\n \"scope\": \"account\",\n \"secret\": true,\n \"help\": \"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.\"\n }\n] as const;\n\n/**\n * The OAuth2 exchange Zoom requires — DECLARED here, performed by the host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n *\n * Its refresh tokens ROTATE, and they are single use. Every refresh returns a\n * new one and spends the one submitted, so REPLAYING a spent token revokes the\n * entire grant — the user is signed out, with nothing in the failure that says\n * why.\n *\n * Two consequences, both of which a host gets wrong by default. Do not RETRY a\n * failed refresh with the same token: a response that arrived but was not\n * persisted — a crash between the reply and the write — makes the retry a\n * replay. And do not refresh concurrently, because two workers refreshing at\n * once means one of them replays. Persist the returned token BEFORE using the\n * access token it came with.\n */\nexport const ZOOM_OAUTH = {\n \"flow\": \"authorization_code\",\n \"authorizeUrl\": \"https://zoom.us/oauth/authorize\",\n \"tokenUrl\": \"https://zoom.us/oauth/token\",\n \"scopes\": [\n \"meeting:read:meeting\",\n \"user:read:token\"\n ],\n \"accessTokenCredential\": \"accessToken\",\n \"refreshTokenCredential\": \"refreshToken\",\n \"refreshTokenRotates\": true,\n \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Zoom node's connector metadata from the operation it performs. */\nexport function zoomMeta(\n role: ConnectorMeta[\"role\"],\n operation: string,\n docs: string,\n): ConnectorMeta {\n return { ...ZOOM_SERVICE, role, operation, docs };\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 * Get meeting — Read a Zoom meeting's join details and settings.\n *\n * https://developers.zoom.us/docs/api/meetings/\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { zoomMeta } from \"../service.js\";\n\nexport const ZOOM_MEETING_GET_KIND = \"@particle-academy/zoom_meeting_get\";\nexport const ZOOM_MEETING_GET_OPERATION = \"meeting_get\";\n\nexport const ZOOM_MEETING_GET_META = zoomMeta(\"action\", \"a Zoom meeting\", \"https://developers.zoom.us/docs/api/meetings/\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const ZOOM_MEETING_GET_OUTPUT: OutputField[] = [\n {\n \"path\": \"data.id\",\n \"type\": \"number\",\n \"description\": \"The meeting's numeric id (also called the meeting number).\"\n },\n {\n \"path\": \"data.uuid\",\n \"type\": \"string\",\n \"description\": \"A unique id for THIS instance of a recurring meeting; the meeting id alone is shared across occurrences.\"\n },\n {\n \"path\": \"data.host_id\",\n \"type\": \"string\",\n \"description\": \"The Zoom user id of the meeting's host.\"\n },\n {\n \"path\": \"data.topic\",\n \"type\": \"string\",\n \"description\": \"The meeting's title.\"\n },\n {\n \"path\": \"data.type\",\n \"type\": \"number\",\n \"description\": \"Zoom's numeric meeting type: 1 instant, 2 scheduled, 3 recurring with no fixed time, 8 recurring with a fixed time.\"\n },\n {\n \"path\": \"data.status\",\n \"type\": \"string\",\n \"description\": \"waiting, started, or finished.\"\n },\n {\n \"path\": \"data.start_time\",\n \"type\": \"string\",\n \"description\": \"ISO 8601 with a Z offset, e.g. 2026-09-15T14:00:00Z.\"\n },\n {\n \"path\": \"data.duration\",\n \"type\": \"number\",\n \"description\": \"Scheduled length, in minutes.\"\n },\n {\n \"path\": \"data.timezone\",\n \"type\": \"string\",\n \"description\": \"An IANA zone Zoom uses to render start_time in its own UI, e.g. America/New_York.\"\n },\n {\n \"path\": \"data.agenda\",\n \"type\": \"string\",\n \"description\": \"The meeting's description, when the host set one.\"\n },\n {\n \"path\": \"data.join_url\",\n \"type\": \"string\",\n \"description\": \"The link a participant (or a meeting bot) uses to join.\"\n },\n {\n \"path\": \"data.password\",\n \"type\": \"string\",\n \"description\": \"The passcode required to join, when the meeting has one.\"\n },\n {\n \"path\": \"data.settings.waiting_room\",\n \"type\": \"boolean\",\n \"description\": \"Whether Zoom holds joiners in a waiting room before admitting them -- a bot must be admitted like any guest.\"\n },\n {\n \"path\": \"data.settings.join_before_host\",\n \"type\": \"boolean\",\n \"description\": \"Whether a participant may join before the host has started the meeting.\"\n },\n {\n \"path\": \"data.settings.approval_type\",\n \"type\": \"number\",\n \"description\": \"0 automatically approve, 1 manually approve, 2 no registration required.\"\n }\n];\n\nexport const zoomMeetingGetKind: NodeKindDefinition = defineConnectorKind(ZOOM_MEETING_GET_META, {\n name: ZOOM_MEETING_GET_KIND,\n aliases: [\"zoom_meeting_get\"],\n label: \"Get meeting\",\n description: \"Read a Zoom meeting's join details and settings.\",\n icon: \"🎥\",\n inputs: [{ id: \"in\" }],\n outputs: [{ id: \"out\" }],\n sideEffects: \"none\",\n outputShape: ZOOM_MEETING_GET_OUTPUT,\n configSchema: [\n {\n \"type\": \"text\",\n \"key\": \"meetingId\",\n \"label\": \"Meeting ID\",\n \"required\": true,\n \"description\": \"The meeting's numeric id, from its join URL or from Zoom's own meeting list.\"\n }\n ],\n defaultConfig: {\n \"mode\": \"auto\"\n },\n renderBody: ({ config }) =>\n summarize(ZOOM_MEETING_GET_META, config as Record<string, unknown>, \"a Zoom meeting\"),\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 on-behalf-of token — Mint a short-lived token so a bot can join a Zoom\n * meeting on the authorising user's behalf.\n *\n * https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/\n *\n * `unsafe-to-replay`.\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { zoomMeta } from \"../service.js\";\n\nexport const ZOOM_OBF_TOKEN_CREATE_KIND = \"@particle-academy/zoom_obf_token_create\";\nexport const ZOOM_OBF_TOKEN_CREATE_OPERATION = \"obf_token_create\";\n\nexport const ZOOM_OBF_TOKEN_CREATE_META = zoomMeta(\"action\", \"an on-behalf-of token\", \"https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const ZOOM_OBF_TOKEN_CREATE_OUTPUT: OutputField[] = [\n {\n \"path\": \"data.token\",\n \"type\": \"string\",\n \"description\": \"The OBF token. Present it the way the Meeting SDK's join call expects; it is not a Bearer header value on Zoom's REST API.\"\n }\n];\n\nexport const zoomObfTokenCreateKind: NodeKindDefinition = defineConnectorKind(ZOOM_OBF_TOKEN_CREATE_META, {\n name: ZOOM_OBF_TOKEN_CREATE_KIND,\n aliases: [\"zoom_obf_token_create\"],\n label: \"Mint on-behalf-of token\",\n description: \"Mint a short-lived token so a bot can join a Zoom meeting on the authorising user's behalf.\",\n icon: \"🔑\",\n inputs: [{ id: \"in\" }],\n outputs: [{ id: \"out\" }],\n sideEffects: \"unsafe-to-replay\",\n outputShape: ZOOM_OBF_TOKEN_CREATE_OUTPUT,\n configSchema: [\n {\n \"type\": \"text\",\n \"key\": \"meetingId\",\n \"label\": \"Meeting ID\",\n \"required\": true,\n \"description\": \"The meeting the bot is about to join. The minted token works for this meeting only.\"\n }\n ],\n defaultConfig: {\n \"mode\": \"auto\"\n },\n renderBody: ({ config }) =>\n summarize(ZOOM_OBF_TOKEN_CREATE_META, config as Record<string, unknown>, \"an on-behalf-of token\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/meeting-get.js\";\nexport * from \"./kinds/obf-token-create.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { zoomMeetingGetKind } from \"./kinds/meeting-get.js\";\nimport { zoomObfTokenCreateKind } from \"./kinds/obf-token-create.js\";\n\n/** Every Zoom kind, for a host that registers the lot. */\nexport const ZOOM_KINDS: NodeKindDefinition[] = [\n zoomMeetingGetKind,\n zoomObfTokenCreateKind,\n];\n"]}
|
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
import * as _particle_academy_fancy_flow_connectors from '@particle-academy/fancy-flow/connectors';
|
|
2
|
+
import { ConnectorMeta, OutputField } from '@particle-academy/fancy-flow/connectors';
|
|
3
|
+
import { NodeKindDefinition } from '@particle-academy/fancy-flow/engine';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* GENERATED FILE — do not edit.
|
|
7
|
+
*
|
|
8
|
+
* Emitted from provider/manifest.json by weaver's generator.
|
|
9
|
+
* A hand-edit here is destroyed by the next protocol sync, which is worse than
|
|
10
|
+
* being rejected, because it works until it silently does not. Fix
|
|
11
|
+
* provider/manifest.json (or weaver's template/) and regenerate:
|
|
12
|
+
*
|
|
13
|
+
* npm run provider -- zoom
|
|
14
|
+
*/
|
|
15
|
+
/**
|
|
16
|
+
* Zoom's identity on the authoring surface, shared by every Zoom node.
|
|
17
|
+
*
|
|
18
|
+
* This file must import nothing from the js package: a PHP or Python project
|
|
19
|
+
* installs the ui package and never that one, and the import would be a
|
|
20
|
+
* dangling module the moment it did.
|
|
21
|
+
*
|
|
22
|
+
* ## The sandbox trap
|
|
23
|
+
*
|
|
24
|
+
* Zoom has no test estate distinct from a real account, as far as this review
|
|
25
|
+
* found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call
|
|
26
|
+
* authorizes against the caller's own Zoom account and can read real meeting
|
|
27
|
+
* data. Use fake mode while building.
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* The connector API version this package was GENERATED against.
|
|
32
|
+
*
|
|
33
|
+
* A literal, never imported — an imported constant lets an upgrade rewrite the
|
|
34
|
+
* very claim it exists to detect.
|
|
35
|
+
*/
|
|
36
|
+
declare const CONNECTOR_API_VERSION = 1;
|
|
37
|
+
/** The parts of a connector's identity that belong to the SERVICE, not the node. */
|
|
38
|
+
declare const ZOOM_SERVICE: {
|
|
39
|
+
readonly service: "zoom";
|
|
40
|
+
readonly serviceTitle: "Zoom";
|
|
41
|
+
readonly domain: "messaging";
|
|
42
|
+
readonly sandbox: "unverified";
|
|
43
|
+
};
|
|
44
|
+
/** The credentials a Zoom connection holds. */
|
|
45
|
+
declare const ZOOM_CREDENTIALS: readonly [{
|
|
46
|
+
readonly key: "clientId";
|
|
47
|
+
readonly label: "OAuth client ID";
|
|
48
|
+
readonly scope: "provider";
|
|
49
|
+
readonly secret: false;
|
|
50
|
+
readonly help: "From the Zoom app you registered at marketplace.zoom.us. One value for the whole installation -- the same app serves every connected Zoom account.";
|
|
51
|
+
}, {
|
|
52
|
+
readonly key: "clientSecret";
|
|
53
|
+
readonly label: "OAuth client secret";
|
|
54
|
+
readonly scope: "provider";
|
|
55
|
+
readonly secret: true;
|
|
56
|
+
readonly help: "From the same app. Used to exchange the code and to refresh; never sent with an API request.";
|
|
57
|
+
}, {
|
|
58
|
+
readonly key: "accessToken";
|
|
59
|
+
readonly label: "Access token";
|
|
60
|
+
readonly scope: "account";
|
|
61
|
+
readonly secret: true;
|
|
62
|
+
readonly help: "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.";
|
|
63
|
+
}, {
|
|
64
|
+
readonly key: "refreshToken";
|
|
65
|
+
readonly label: "Refresh token";
|
|
66
|
+
readonly scope: "account";
|
|
67
|
+
readonly secret: true;
|
|
68
|
+
readonly help: "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.";
|
|
69
|
+
}];
|
|
70
|
+
/**
|
|
71
|
+
* The OAuth2 exchange Zoom requires — DECLARED here, performed by the host.
|
|
72
|
+
*
|
|
73
|
+
* A consent screen needs a browser, a redirect URI and somewhere to persist
|
|
74
|
+
* the result, and all three belong to the host; a package that ran the dance
|
|
75
|
+
* itself would have to own a web server. So this says precisely enough for a
|
|
76
|
+
* host to do it.
|
|
77
|
+
*
|
|
78
|
+
* The access token lasts 3600 seconds. A host that never refreshes will work
|
|
79
|
+
* all afternoon and be broken by morning, which is why the lifetime is stated
|
|
80
|
+
* rather than left to be discovered.
|
|
81
|
+
*
|
|
82
|
+
* Its refresh tokens ROTATE, and they are single use. Every refresh returns a
|
|
83
|
+
* new one and spends the one submitted, so REPLAYING a spent token revokes the
|
|
84
|
+
* entire grant — the user is signed out, with nothing in the failure that says
|
|
85
|
+
* why.
|
|
86
|
+
*
|
|
87
|
+
* Two consequences, both of which a host gets wrong by default. Do not RETRY a
|
|
88
|
+
* failed refresh with the same token: a response that arrived but was not
|
|
89
|
+
* persisted — a crash between the reply and the write — makes the retry a
|
|
90
|
+
* replay. And do not refresh concurrently, because two workers refreshing at
|
|
91
|
+
* once means one of them replays. Persist the returned token BEFORE using the
|
|
92
|
+
* access token it came with.
|
|
93
|
+
*/
|
|
94
|
+
declare const ZOOM_OAUTH: {
|
|
95
|
+
readonly flow: "authorization_code";
|
|
96
|
+
readonly authorizeUrl: "https://zoom.us/oauth/authorize";
|
|
97
|
+
readonly tokenUrl: "https://zoom.us/oauth/token";
|
|
98
|
+
readonly scopes: readonly ["meeting:read:meeting", "user:read:token"];
|
|
99
|
+
readonly accessTokenCredential: "accessToken";
|
|
100
|
+
readonly refreshTokenCredential: "refreshToken";
|
|
101
|
+
readonly refreshTokenRotates: true;
|
|
102
|
+
readonly accessTokenTtlSeconds: 3600;
|
|
103
|
+
};
|
|
104
|
+
/** Build a Zoom node's connector metadata from the operation it performs. */
|
|
105
|
+
declare function zoomMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;
|
|
106
|
+
|
|
107
|
+
declare const ZOOM_MEETING_GET_KIND = "@particle-academy/zoom_meeting_get";
|
|
108
|
+
declare const ZOOM_MEETING_GET_OPERATION = "meeting_get";
|
|
109
|
+
declare const ZOOM_MEETING_GET_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
|
|
110
|
+
/**
|
|
111
|
+
* What this node emits — the "ingredients" a downstream node can reference.
|
|
112
|
+
*
|
|
113
|
+
* fancy-flow reads `outputShape` off the kind and offers it in the variable
|
|
114
|
+
* picker, so declaring it is the whole of the work: an author configuring the
|
|
115
|
+
* next node picks `{{ $json.data.id }}` off a list instead of typing a path
|
|
116
|
+
* and hoping.
|
|
117
|
+
*/
|
|
118
|
+
declare const ZOOM_MEETING_GET_OUTPUT: OutputField[];
|
|
119
|
+
declare const zoomMeetingGetKind: NodeKindDefinition;
|
|
120
|
+
|
|
121
|
+
declare const ZOOM_OBF_TOKEN_CREATE_KIND = "@particle-academy/zoom_obf_token_create";
|
|
122
|
+
declare const ZOOM_OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
|
|
123
|
+
declare const ZOOM_OBF_TOKEN_CREATE_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
|
|
124
|
+
/**
|
|
125
|
+
* What this node emits — the "ingredients" a downstream node can reference.
|
|
126
|
+
*
|
|
127
|
+
* fancy-flow reads `outputShape` off the kind and offers it in the variable
|
|
128
|
+
* picker, so declaring it is the whole of the work: an author configuring the
|
|
129
|
+
* next node picks `{{ $json.data.id }}` off a list instead of typing a path
|
|
130
|
+
* and hoping.
|
|
131
|
+
*/
|
|
132
|
+
declare const ZOOM_OBF_TOKEN_CREATE_OUTPUT: OutputField[];
|
|
133
|
+
declare const zoomObfTokenCreateKind: NodeKindDefinition;
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* GENERATED FILE — do not edit.
|
|
137
|
+
*
|
|
138
|
+
* Emitted from provider/manifest.json by weaver's generator.
|
|
139
|
+
* A hand-edit here is destroyed by the next protocol sync, which is worse than
|
|
140
|
+
* being rejected, because it works until it silently does not. Fix
|
|
141
|
+
* provider/manifest.json (or weaver's template/) and regenerate:
|
|
142
|
+
*
|
|
143
|
+
* npm run provider -- zoom
|
|
144
|
+
*/
|
|
145
|
+
/**
|
|
146
|
+
* Zoom's node kinds for fancy-flow.
|
|
147
|
+
*
|
|
148
|
+
* Install this on every host. The TypeScript executors live in the js
|
|
149
|
+
* package's `./flow` subpath; PHP and Python hosts run their own and need only
|
|
150
|
+
* this.
|
|
151
|
+
*/
|
|
152
|
+
|
|
153
|
+
/** Every Zoom kind, for a host that registers the lot. */
|
|
154
|
+
declare const ZOOM_KINDS: NodeKindDefinition[];
|
|
155
|
+
|
|
156
|
+
export { CONNECTOR_API_VERSION, ZOOM_CREDENTIALS, ZOOM_KINDS, ZOOM_MEETING_GET_KIND, ZOOM_MEETING_GET_META, ZOOM_MEETING_GET_OPERATION, ZOOM_MEETING_GET_OUTPUT, ZOOM_OAUTH, ZOOM_OBF_TOKEN_CREATE_KIND, ZOOM_OBF_TOKEN_CREATE_META, ZOOM_OBF_TOKEN_CREATE_OPERATION, ZOOM_OBF_TOKEN_CREATE_OUTPUT, ZOOM_SERVICE, zoomMeetingGetKind, zoomMeta, zoomObfTokenCreateKind };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
import * as _particle_academy_fancy_flow_connectors from '@particle-academy/fancy-flow/connectors';
|
|
2
|
+
import { ConnectorMeta, OutputField } from '@particle-academy/fancy-flow/connectors';
|
|
3
|
+
import { NodeKindDefinition } from '@particle-academy/fancy-flow/engine';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* GENERATED FILE — do not edit.
|
|
7
|
+
*
|
|
8
|
+
* Emitted from provider/manifest.json by weaver's generator.
|
|
9
|
+
* A hand-edit here is destroyed by the next protocol sync, which is worse than
|
|
10
|
+
* being rejected, because it works until it silently does not. Fix
|
|
11
|
+
* provider/manifest.json (or weaver's template/) and regenerate:
|
|
12
|
+
*
|
|
13
|
+
* npm run provider -- zoom
|
|
14
|
+
*/
|
|
15
|
+
/**
|
|
16
|
+
* Zoom's identity on the authoring surface, shared by every Zoom node.
|
|
17
|
+
*
|
|
18
|
+
* This file must import nothing from the js package: a PHP or Python project
|
|
19
|
+
* installs the ui package and never that one, and the import would be a
|
|
20
|
+
* dangling module the moment it did.
|
|
21
|
+
*
|
|
22
|
+
* ## The sandbox trap
|
|
23
|
+
*
|
|
24
|
+
* Zoom has no test estate distinct from a real account, as far as this review
|
|
25
|
+
* found (2026-09-15) -- but it is UNVERIFIED, not confirmed. Every call
|
|
26
|
+
* authorizes against the caller's own Zoom account and can read real meeting
|
|
27
|
+
* data. Use fake mode while building.
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* The connector API version this package was GENERATED against.
|
|
32
|
+
*
|
|
33
|
+
* A literal, never imported — an imported constant lets an upgrade rewrite the
|
|
34
|
+
* very claim it exists to detect.
|
|
35
|
+
*/
|
|
36
|
+
declare const CONNECTOR_API_VERSION = 1;
|
|
37
|
+
/** The parts of a connector's identity that belong to the SERVICE, not the node. */
|
|
38
|
+
declare const ZOOM_SERVICE: {
|
|
39
|
+
readonly service: "zoom";
|
|
40
|
+
readonly serviceTitle: "Zoom";
|
|
41
|
+
readonly domain: "messaging";
|
|
42
|
+
readonly sandbox: "unverified";
|
|
43
|
+
};
|
|
44
|
+
/** The credentials a Zoom connection holds. */
|
|
45
|
+
declare const ZOOM_CREDENTIALS: readonly [{
|
|
46
|
+
readonly key: "clientId";
|
|
47
|
+
readonly label: "OAuth client ID";
|
|
48
|
+
readonly scope: "provider";
|
|
49
|
+
readonly secret: false;
|
|
50
|
+
readonly help: "From the Zoom app you registered at marketplace.zoom.us. One value for the whole installation -- the same app serves every connected Zoom account.";
|
|
51
|
+
}, {
|
|
52
|
+
readonly key: "clientSecret";
|
|
53
|
+
readonly label: "OAuth client secret";
|
|
54
|
+
readonly scope: "provider";
|
|
55
|
+
readonly secret: true;
|
|
56
|
+
readonly help: "From the same app. Used to exchange the code and to refresh; never sent with an API request.";
|
|
57
|
+
}, {
|
|
58
|
+
readonly key: "accessToken";
|
|
59
|
+
readonly label: "Access token";
|
|
60
|
+
readonly scope: "account";
|
|
61
|
+
readonly secret: true;
|
|
62
|
+
readonly help: "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.";
|
|
63
|
+
}, {
|
|
64
|
+
readonly key: "refreshToken";
|
|
65
|
+
readonly label: "Refresh token";
|
|
66
|
+
readonly scope: "account";
|
|
67
|
+
readonly secret: true;
|
|
68
|
+
readonly help: "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.";
|
|
69
|
+
}];
|
|
70
|
+
/**
|
|
71
|
+
* The OAuth2 exchange Zoom requires — DECLARED here, performed by the host.
|
|
72
|
+
*
|
|
73
|
+
* A consent screen needs a browser, a redirect URI and somewhere to persist
|
|
74
|
+
* the result, and all three belong to the host; a package that ran the dance
|
|
75
|
+
* itself would have to own a web server. So this says precisely enough for a
|
|
76
|
+
* host to do it.
|
|
77
|
+
*
|
|
78
|
+
* The access token lasts 3600 seconds. A host that never refreshes will work
|
|
79
|
+
* all afternoon and be broken by morning, which is why the lifetime is stated
|
|
80
|
+
* rather than left to be discovered.
|
|
81
|
+
*
|
|
82
|
+
* Its refresh tokens ROTATE, and they are single use. Every refresh returns a
|
|
83
|
+
* new one and spends the one submitted, so REPLAYING a spent token revokes the
|
|
84
|
+
* entire grant — the user is signed out, with nothing in the failure that says
|
|
85
|
+
* why.
|
|
86
|
+
*
|
|
87
|
+
* Two consequences, both of which a host gets wrong by default. Do not RETRY a
|
|
88
|
+
* failed refresh with the same token: a response that arrived but was not
|
|
89
|
+
* persisted — a crash between the reply and the write — makes the retry a
|
|
90
|
+
* replay. And do not refresh concurrently, because two workers refreshing at
|
|
91
|
+
* once means one of them replays. Persist the returned token BEFORE using the
|
|
92
|
+
* access token it came with.
|
|
93
|
+
*/
|
|
94
|
+
declare const ZOOM_OAUTH: {
|
|
95
|
+
readonly flow: "authorization_code";
|
|
96
|
+
readonly authorizeUrl: "https://zoom.us/oauth/authorize";
|
|
97
|
+
readonly tokenUrl: "https://zoom.us/oauth/token";
|
|
98
|
+
readonly scopes: readonly ["meeting:read:meeting", "user:read:token"];
|
|
99
|
+
readonly accessTokenCredential: "accessToken";
|
|
100
|
+
readonly refreshTokenCredential: "refreshToken";
|
|
101
|
+
readonly refreshTokenRotates: true;
|
|
102
|
+
readonly accessTokenTtlSeconds: 3600;
|
|
103
|
+
};
|
|
104
|
+
/** Build a Zoom node's connector metadata from the operation it performs. */
|
|
105
|
+
declare function zoomMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;
|
|
106
|
+
|
|
107
|
+
declare const ZOOM_MEETING_GET_KIND = "@particle-academy/zoom_meeting_get";
|
|
108
|
+
declare const ZOOM_MEETING_GET_OPERATION = "meeting_get";
|
|
109
|
+
declare const ZOOM_MEETING_GET_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
|
|
110
|
+
/**
|
|
111
|
+
* What this node emits — the "ingredients" a downstream node can reference.
|
|
112
|
+
*
|
|
113
|
+
* fancy-flow reads `outputShape` off the kind and offers it in the variable
|
|
114
|
+
* picker, so declaring it is the whole of the work: an author configuring the
|
|
115
|
+
* next node picks `{{ $json.data.id }}` off a list instead of typing a path
|
|
116
|
+
* and hoping.
|
|
117
|
+
*/
|
|
118
|
+
declare const ZOOM_MEETING_GET_OUTPUT: OutputField[];
|
|
119
|
+
declare const zoomMeetingGetKind: NodeKindDefinition;
|
|
120
|
+
|
|
121
|
+
declare const ZOOM_OBF_TOKEN_CREATE_KIND = "@particle-academy/zoom_obf_token_create";
|
|
122
|
+
declare const ZOOM_OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
|
|
123
|
+
declare const ZOOM_OBF_TOKEN_CREATE_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
|
|
124
|
+
/**
|
|
125
|
+
* What this node emits — the "ingredients" a downstream node can reference.
|
|
126
|
+
*
|
|
127
|
+
* fancy-flow reads `outputShape` off the kind and offers it in the variable
|
|
128
|
+
* picker, so declaring it is the whole of the work: an author configuring the
|
|
129
|
+
* next node picks `{{ $json.data.id }}` off a list instead of typing a path
|
|
130
|
+
* and hoping.
|
|
131
|
+
*/
|
|
132
|
+
declare const ZOOM_OBF_TOKEN_CREATE_OUTPUT: OutputField[];
|
|
133
|
+
declare const zoomObfTokenCreateKind: NodeKindDefinition;
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* GENERATED FILE — do not edit.
|
|
137
|
+
*
|
|
138
|
+
* Emitted from provider/manifest.json by weaver's generator.
|
|
139
|
+
* A hand-edit here is destroyed by the next protocol sync, which is worse than
|
|
140
|
+
* being rejected, because it works until it silently does not. Fix
|
|
141
|
+
* provider/manifest.json (or weaver's template/) and regenerate:
|
|
142
|
+
*
|
|
143
|
+
* npm run provider -- zoom
|
|
144
|
+
*/
|
|
145
|
+
/**
|
|
146
|
+
* Zoom's node kinds for fancy-flow.
|
|
147
|
+
*
|
|
148
|
+
* Install this on every host. The TypeScript executors live in the js
|
|
149
|
+
* package's `./flow` subpath; PHP and Python hosts run their own and need only
|
|
150
|
+
* this.
|
|
151
|
+
*/
|
|
152
|
+
|
|
153
|
+
/** Every Zoom kind, for a host that registers the lot. */
|
|
154
|
+
declare const ZOOM_KINDS: NodeKindDefinition[];
|
|
155
|
+
|
|
156
|
+
export { CONNECTOR_API_VERSION, ZOOM_CREDENTIALS, ZOOM_KINDS, ZOOM_MEETING_GET_KIND, ZOOM_MEETING_GET_META, ZOOM_MEETING_GET_OPERATION, ZOOM_MEETING_GET_OUTPUT, ZOOM_OAUTH, ZOOM_OBF_TOKEN_CREATE_KIND, ZOOM_OBF_TOKEN_CREATE_META, ZOOM_OBF_TOKEN_CREATE_OPERATION, ZOOM_OBF_TOKEN_CREATE_OUTPUT, ZOOM_SERVICE, zoomMeetingGetKind, zoomMeta, zoomObfTokenCreateKind };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
import { defineConnectorKind, summarize } from '@particle-academy/fancy-flow/connectors';
|
|
2
|
+
|
|
3
|
+
// src/service.ts
|
|
4
|
+
var CONNECTOR_API_VERSION = 1;
|
|
5
|
+
var ZOOM_SERVICE = {
|
|
6
|
+
service: "zoom",
|
|
7
|
+
serviceTitle: "Zoom",
|
|
8
|
+
domain: "messaging",
|
|
9
|
+
sandbox: "unverified"
|
|
10
|
+
};
|
|
11
|
+
var ZOOM_CREDENTIALS = [
|
|
12
|
+
{
|
|
13
|
+
"key": "clientId",
|
|
14
|
+
"label": "OAuth client ID",
|
|
15
|
+
"scope": "provider",
|
|
16
|
+
"secret": false,
|
|
17
|
+
"help": "From the Zoom app you registered at marketplace.zoom.us. One value for the whole installation -- the same app serves every connected Zoom account."
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"key": "clientSecret",
|
|
21
|
+
"label": "OAuth client secret",
|
|
22
|
+
"scope": "provider",
|
|
23
|
+
"secret": true,
|
|
24
|
+
"help": "From the same app. Used to exchange the code and to refresh; never sent with an API request."
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"key": "accessToken",
|
|
28
|
+
"label": "Access token",
|
|
29
|
+
"scope": "account",
|
|
30
|
+
"secret": true,
|
|
31
|
+
"help": "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."
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
"key": "refreshToken",
|
|
35
|
+
"label": "Refresh token",
|
|
36
|
+
"scope": "account",
|
|
37
|
+
"secret": true,
|
|
38
|
+
"help": "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."
|
|
39
|
+
}
|
|
40
|
+
];
|
|
41
|
+
var ZOOM_OAUTH = {
|
|
42
|
+
"flow": "authorization_code",
|
|
43
|
+
"authorizeUrl": "https://zoom.us/oauth/authorize",
|
|
44
|
+
"tokenUrl": "https://zoom.us/oauth/token",
|
|
45
|
+
"scopes": [
|
|
46
|
+
"meeting:read:meeting",
|
|
47
|
+
"user:read:token"
|
|
48
|
+
],
|
|
49
|
+
"accessTokenCredential": "accessToken",
|
|
50
|
+
"refreshTokenCredential": "refreshToken",
|
|
51
|
+
"refreshTokenRotates": true,
|
|
52
|
+
"accessTokenTtlSeconds": 3600
|
|
53
|
+
};
|
|
54
|
+
function zoomMeta(role, operation, docs) {
|
|
55
|
+
return { ...ZOOM_SERVICE, role, operation, docs };
|
|
56
|
+
}
|
|
57
|
+
var ZOOM_MEETING_GET_KIND = "@particle-academy/zoom_meeting_get";
|
|
58
|
+
var ZOOM_MEETING_GET_OPERATION = "meeting_get";
|
|
59
|
+
var ZOOM_MEETING_GET_META = zoomMeta("action", "a Zoom meeting", "https://developers.zoom.us/docs/api/meetings/");
|
|
60
|
+
var ZOOM_MEETING_GET_OUTPUT = [
|
|
61
|
+
{
|
|
62
|
+
"path": "data.id",
|
|
63
|
+
"type": "number",
|
|
64
|
+
"description": "The meeting's numeric id (also called the meeting number)."
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"path": "data.uuid",
|
|
68
|
+
"type": "string",
|
|
69
|
+
"description": "A unique id for THIS instance of a recurring meeting; the meeting id alone is shared across occurrences."
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"path": "data.host_id",
|
|
73
|
+
"type": "string",
|
|
74
|
+
"description": "The Zoom user id of the meeting's host."
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"path": "data.topic",
|
|
78
|
+
"type": "string",
|
|
79
|
+
"description": "The meeting's title."
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"path": "data.type",
|
|
83
|
+
"type": "number",
|
|
84
|
+
"description": "Zoom's numeric meeting type: 1 instant, 2 scheduled, 3 recurring with no fixed time, 8 recurring with a fixed time."
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"path": "data.status",
|
|
88
|
+
"type": "string",
|
|
89
|
+
"description": "waiting, started, or finished."
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"path": "data.start_time",
|
|
93
|
+
"type": "string",
|
|
94
|
+
"description": "ISO 8601 with a Z offset, e.g. 2026-09-15T14:00:00Z."
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"path": "data.duration",
|
|
98
|
+
"type": "number",
|
|
99
|
+
"description": "Scheduled length, in minutes."
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"path": "data.timezone",
|
|
103
|
+
"type": "string",
|
|
104
|
+
"description": "An IANA zone Zoom uses to render start_time in its own UI, e.g. America/New_York."
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"path": "data.agenda",
|
|
108
|
+
"type": "string",
|
|
109
|
+
"description": "The meeting's description, when the host set one."
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"path": "data.join_url",
|
|
113
|
+
"type": "string",
|
|
114
|
+
"description": "The link a participant (or a meeting bot) uses to join."
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"path": "data.password",
|
|
118
|
+
"type": "string",
|
|
119
|
+
"description": "The passcode required to join, when the meeting has one."
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"path": "data.settings.waiting_room",
|
|
123
|
+
"type": "boolean",
|
|
124
|
+
"description": "Whether Zoom holds joiners in a waiting room before admitting them -- a bot must be admitted like any guest."
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"path": "data.settings.join_before_host",
|
|
128
|
+
"type": "boolean",
|
|
129
|
+
"description": "Whether a participant may join before the host has started the meeting."
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"path": "data.settings.approval_type",
|
|
133
|
+
"type": "number",
|
|
134
|
+
"description": "0 automatically approve, 1 manually approve, 2 no registration required."
|
|
135
|
+
}
|
|
136
|
+
];
|
|
137
|
+
var zoomMeetingGetKind = defineConnectorKind(ZOOM_MEETING_GET_META, {
|
|
138
|
+
name: ZOOM_MEETING_GET_KIND,
|
|
139
|
+
aliases: ["zoom_meeting_get"],
|
|
140
|
+
label: "Get meeting",
|
|
141
|
+
description: "Read a Zoom meeting's join details and settings.",
|
|
142
|
+
icon: "\u{1F3A5}",
|
|
143
|
+
inputs: [{ id: "in" }],
|
|
144
|
+
outputs: [{ id: "out" }],
|
|
145
|
+
sideEffects: "none",
|
|
146
|
+
outputShape: ZOOM_MEETING_GET_OUTPUT,
|
|
147
|
+
configSchema: [
|
|
148
|
+
{
|
|
149
|
+
"type": "text",
|
|
150
|
+
"key": "meetingId",
|
|
151
|
+
"label": "Meeting ID",
|
|
152
|
+
"required": true,
|
|
153
|
+
"description": "The meeting's numeric id, from its join URL or from Zoom's own meeting list."
|
|
154
|
+
}
|
|
155
|
+
],
|
|
156
|
+
defaultConfig: {
|
|
157
|
+
"mode": "auto"
|
|
158
|
+
},
|
|
159
|
+
renderBody: ({ config }) => summarize(ZOOM_MEETING_GET_META, config, "a Zoom meeting")
|
|
160
|
+
});
|
|
161
|
+
var ZOOM_OBF_TOKEN_CREATE_KIND = "@particle-academy/zoom_obf_token_create";
|
|
162
|
+
var ZOOM_OBF_TOKEN_CREATE_OPERATION = "obf_token_create";
|
|
163
|
+
var ZOOM_OBF_TOKEN_CREATE_META = zoomMeta("action", "an on-behalf-of token", "https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/");
|
|
164
|
+
var ZOOM_OBF_TOKEN_CREATE_OUTPUT = [
|
|
165
|
+
{
|
|
166
|
+
"path": "data.token",
|
|
167
|
+
"type": "string",
|
|
168
|
+
"description": "The OBF token. Present it the way the Meeting SDK's join call expects; it is not a Bearer header value on Zoom's REST API."
|
|
169
|
+
}
|
|
170
|
+
];
|
|
171
|
+
var zoomObfTokenCreateKind = defineConnectorKind(ZOOM_OBF_TOKEN_CREATE_META, {
|
|
172
|
+
name: ZOOM_OBF_TOKEN_CREATE_KIND,
|
|
173
|
+
aliases: ["zoom_obf_token_create"],
|
|
174
|
+
label: "Mint on-behalf-of token",
|
|
175
|
+
description: "Mint a short-lived token so a bot can join a Zoom meeting on the authorising user's behalf.",
|
|
176
|
+
icon: "\u{1F511}",
|
|
177
|
+
inputs: [{ id: "in" }],
|
|
178
|
+
outputs: [{ id: "out" }],
|
|
179
|
+
sideEffects: "unsafe-to-replay",
|
|
180
|
+
outputShape: ZOOM_OBF_TOKEN_CREATE_OUTPUT,
|
|
181
|
+
configSchema: [
|
|
182
|
+
{
|
|
183
|
+
"type": "text",
|
|
184
|
+
"key": "meetingId",
|
|
185
|
+
"label": "Meeting ID",
|
|
186
|
+
"required": true,
|
|
187
|
+
"description": "The meeting the bot is about to join. The minted token works for this meeting only."
|
|
188
|
+
}
|
|
189
|
+
],
|
|
190
|
+
defaultConfig: {
|
|
191
|
+
"mode": "auto"
|
|
192
|
+
},
|
|
193
|
+
renderBody: ({ config }) => summarize(ZOOM_OBF_TOKEN_CREATE_META, config, "an on-behalf-of token")
|
|
194
|
+
});
|
|
195
|
+
|
|
196
|
+
// src/index.ts
|
|
197
|
+
var ZOOM_KINDS = [
|
|
198
|
+
zoomMeetingGetKind,
|
|
199
|
+
zoomObfTokenCreateKind
|
|
200
|
+
];
|
|
201
|
+
|
|
202
|
+
export { CONNECTOR_API_VERSION, ZOOM_CREDENTIALS, ZOOM_KINDS, ZOOM_MEETING_GET_KIND, ZOOM_MEETING_GET_META, ZOOM_MEETING_GET_OPERATION, ZOOM_MEETING_GET_OUTPUT, ZOOM_OAUTH, ZOOM_OBF_TOKEN_CREATE_KIND, ZOOM_OBF_TOKEN_CREATE_META, ZOOM_OBF_TOKEN_CREATE_OPERATION, ZOOM_OBF_TOKEN_CREATE_OUTPUT, ZOOM_SERVICE, zoomMeetingGetKind, zoomMeta, zoomObfTokenCreateKind };
|
|
203
|
+
//# sourceMappingURL=index.js.map
|
|
204
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/service.ts","../src/kinds/meeting-get.ts","../src/kinds/obf-token-create.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n * npm run provider -- zoom\n */\n\n/**\n * Zoom's identity on the authoring surface, shared by every Zoom node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\n *\n * 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 { ConnectorDomain, ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported — an imported constant lets an upgrade rewrite the\n * very claim it exists to detect.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const ZOOM_SERVICE = {\n service: \"zoom\",\n serviceTitle: \"Zoom\",\n domain: \"messaging\",\n sandbox: \"unverified\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/**\n * Every connector domain weaver knows, pinned against fancy-flow's union.\n *\n * A closed set copied into three codebases stays correct only while something\n * MAKES it: this line fails to compile the moment weaver carries a value\n * fancy-flow does not, including the values no provider uses yet.\n */\nconst WEAVER_DOMAINS: readonly ConnectorDomain[] = [\n \"payments\",\n \"commerce\",\n \"messaging\",\n \"email\",\n \"crm\",\n \"support\",\n \"storage\",\n \"calendar\",\n \"productivity\",\n \"database\",\n \"devtools\",\n \"analytics\",\n \"marketing\",\n \"ai\",\n \"forms\",\n \"hr\",\n \"geo\"\n];\nvoid WEAVER_DOMAINS;\n\n/** The credentials a Zoom connection holds. */\nexport const ZOOM_CREDENTIALS = [\n {\n \"key\": \"clientId\",\n \"label\": \"OAuth client ID\",\n \"scope\": \"provider\",\n \"secret\": false,\n \"help\": \"From the Zoom app you registered at marketplace.zoom.us. One value for the whole installation -- the same app serves every connected Zoom account.\"\n },\n {\n \"key\": \"clientSecret\",\n \"label\": \"OAuth client secret\",\n \"scope\": \"provider\",\n \"secret\": true,\n \"help\": \"From the same app. Used to exchange the code and to refresh; never sent with an API request.\"\n },\n {\n \"key\": \"accessToken\",\n \"label\": \"Access token\",\n \"scope\": \"account\",\n \"secret\": true,\n \"help\": \"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.\"\n },\n {\n \"key\": \"refreshToken\",\n \"label\": \"Refresh token\",\n \"scope\": \"account\",\n \"secret\": true,\n \"help\": \"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.\"\n }\n] as const;\n\n/**\n * The OAuth2 exchange Zoom requires — DECLARED here, performed by the host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n *\n * Its refresh tokens ROTATE, and they are single use. Every refresh returns a\n * new one and spends the one submitted, so REPLAYING a spent token revokes the\n * entire grant — the user is signed out, with nothing in the failure that says\n * why.\n *\n * Two consequences, both of which a host gets wrong by default. Do not RETRY a\n * failed refresh with the same token: a response that arrived but was not\n * persisted — a crash between the reply and the write — makes the retry a\n * replay. And do not refresh concurrently, because two workers refreshing at\n * once means one of them replays. Persist the returned token BEFORE using the\n * access token it came with.\n */\nexport const ZOOM_OAUTH = {\n \"flow\": \"authorization_code\",\n \"authorizeUrl\": \"https://zoom.us/oauth/authorize\",\n \"tokenUrl\": \"https://zoom.us/oauth/token\",\n \"scopes\": [\n \"meeting:read:meeting\",\n \"user:read:token\"\n ],\n \"accessTokenCredential\": \"accessToken\",\n \"refreshTokenCredential\": \"refreshToken\",\n \"refreshTokenRotates\": true,\n \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Zoom node's connector metadata from the operation it performs. */\nexport function zoomMeta(\n role: ConnectorMeta[\"role\"],\n operation: string,\n docs: string,\n): ConnectorMeta {\n return { ...ZOOM_SERVICE, role, operation, docs };\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 * Get meeting — Read a Zoom meeting's join details and settings.\n *\n * https://developers.zoom.us/docs/api/meetings/\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { zoomMeta } from \"../service.js\";\n\nexport const ZOOM_MEETING_GET_KIND = \"@particle-academy/zoom_meeting_get\";\nexport const ZOOM_MEETING_GET_OPERATION = \"meeting_get\";\n\nexport const ZOOM_MEETING_GET_META = zoomMeta(\"action\", \"a Zoom meeting\", \"https://developers.zoom.us/docs/api/meetings/\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const ZOOM_MEETING_GET_OUTPUT: OutputField[] = [\n {\n \"path\": \"data.id\",\n \"type\": \"number\",\n \"description\": \"The meeting's numeric id (also called the meeting number).\"\n },\n {\n \"path\": \"data.uuid\",\n \"type\": \"string\",\n \"description\": \"A unique id for THIS instance of a recurring meeting; the meeting id alone is shared across occurrences.\"\n },\n {\n \"path\": \"data.host_id\",\n \"type\": \"string\",\n \"description\": \"The Zoom user id of the meeting's host.\"\n },\n {\n \"path\": \"data.topic\",\n \"type\": \"string\",\n \"description\": \"The meeting's title.\"\n },\n {\n \"path\": \"data.type\",\n \"type\": \"number\",\n \"description\": \"Zoom's numeric meeting type: 1 instant, 2 scheduled, 3 recurring with no fixed time, 8 recurring with a fixed time.\"\n },\n {\n \"path\": \"data.status\",\n \"type\": \"string\",\n \"description\": \"waiting, started, or finished.\"\n },\n {\n \"path\": \"data.start_time\",\n \"type\": \"string\",\n \"description\": \"ISO 8601 with a Z offset, e.g. 2026-09-15T14:00:00Z.\"\n },\n {\n \"path\": \"data.duration\",\n \"type\": \"number\",\n \"description\": \"Scheduled length, in minutes.\"\n },\n {\n \"path\": \"data.timezone\",\n \"type\": \"string\",\n \"description\": \"An IANA zone Zoom uses to render start_time in its own UI, e.g. America/New_York.\"\n },\n {\n \"path\": \"data.agenda\",\n \"type\": \"string\",\n \"description\": \"The meeting's description, when the host set one.\"\n },\n {\n \"path\": \"data.join_url\",\n \"type\": \"string\",\n \"description\": \"The link a participant (or a meeting bot) uses to join.\"\n },\n {\n \"path\": \"data.password\",\n \"type\": \"string\",\n \"description\": \"The passcode required to join, when the meeting has one.\"\n },\n {\n \"path\": \"data.settings.waiting_room\",\n \"type\": \"boolean\",\n \"description\": \"Whether Zoom holds joiners in a waiting room before admitting them -- a bot must be admitted like any guest.\"\n },\n {\n \"path\": \"data.settings.join_before_host\",\n \"type\": \"boolean\",\n \"description\": \"Whether a participant may join before the host has started the meeting.\"\n },\n {\n \"path\": \"data.settings.approval_type\",\n \"type\": \"number\",\n \"description\": \"0 automatically approve, 1 manually approve, 2 no registration required.\"\n }\n];\n\nexport const zoomMeetingGetKind: NodeKindDefinition = defineConnectorKind(ZOOM_MEETING_GET_META, {\n name: ZOOM_MEETING_GET_KIND,\n aliases: [\"zoom_meeting_get\"],\n label: \"Get meeting\",\n description: \"Read a Zoom meeting's join details and settings.\",\n icon: \"🎥\",\n inputs: [{ id: \"in\" }],\n outputs: [{ id: \"out\" }],\n sideEffects: \"none\",\n outputShape: ZOOM_MEETING_GET_OUTPUT,\n configSchema: [\n {\n \"type\": \"text\",\n \"key\": \"meetingId\",\n \"label\": \"Meeting ID\",\n \"required\": true,\n \"description\": \"The meeting's numeric id, from its join URL or from Zoom's own meeting list.\"\n }\n ],\n defaultConfig: {\n \"mode\": \"auto\"\n },\n renderBody: ({ config }) =>\n summarize(ZOOM_MEETING_GET_META, config as Record<string, unknown>, \"a Zoom meeting\"),\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 on-behalf-of token — Mint a short-lived token so a bot can join a Zoom\n * meeting on the authorising user's behalf.\n *\n * https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/\n *\n * `unsafe-to-replay`.\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { zoomMeta } from \"../service.js\";\n\nexport const ZOOM_OBF_TOKEN_CREATE_KIND = \"@particle-academy/zoom_obf_token_create\";\nexport const ZOOM_OBF_TOKEN_CREATE_OPERATION = \"obf_token_create\";\n\nexport const ZOOM_OBF_TOKEN_CREATE_META = zoomMeta(\"action\", \"an on-behalf-of token\", \"https://developers.zoom.us/blog/transition-to-obf-token-meetingsdk-apps/\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const ZOOM_OBF_TOKEN_CREATE_OUTPUT: OutputField[] = [\n {\n \"path\": \"data.token\",\n \"type\": \"string\",\n \"description\": \"The OBF token. Present it the way the Meeting SDK's join call expects; it is not a Bearer header value on Zoom's REST API.\"\n }\n];\n\nexport const zoomObfTokenCreateKind: NodeKindDefinition = defineConnectorKind(ZOOM_OBF_TOKEN_CREATE_META, {\n name: ZOOM_OBF_TOKEN_CREATE_KIND,\n aliases: [\"zoom_obf_token_create\"],\n label: \"Mint on-behalf-of token\",\n description: \"Mint a short-lived token so a bot can join a Zoom meeting on the authorising user's behalf.\",\n icon: \"🔑\",\n inputs: [{ id: \"in\" }],\n outputs: [{ id: \"out\" }],\n sideEffects: \"unsafe-to-replay\",\n outputShape: ZOOM_OBF_TOKEN_CREATE_OUTPUT,\n configSchema: [\n {\n \"type\": \"text\",\n \"key\": \"meetingId\",\n \"label\": \"Meeting ID\",\n \"required\": true,\n \"description\": \"The meeting the bot is about to join. The minted token works for this meeting only.\"\n }\n ],\n defaultConfig: {\n \"mode\": \"auto\"\n },\n renderBody: ({ config }) =>\n summarize(ZOOM_OBF_TOKEN_CREATE_META, config as Record<string, unknown>, \"an on-behalf-of token\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/meeting-get.js\";\nexport * from \"./kinds/obf-token-create.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { zoomMeetingGetKind } from \"./kinds/meeting-get.js\";\nimport { zoomObfTokenCreateKind } from \"./kinds/obf-token-create.js\";\n\n/** Every Zoom kind, for a host that registers the lot. */\nexport const ZOOM_KINDS: NodeKindDefinition[] = [\n zoomMeetingGetKind,\n zoomObfTokenCreateKind,\n];\n"]}
|
package/package.json
CHANGED
|
@@ -1,18 +1,69 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@particle-academy/zoom-ui",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "
|
|
5
|
-
"license": "MIT",
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "Zoom's authoring surface for fancy-flow — the node kinds, their config schemas and their declared output shapes. React on every host; carries no executor.",
|
|
6
5
|
"repository": {
|
|
7
6
|
"type": "git",
|
|
8
7
|
"url": "git+https://github.com/Fancy-Friends/zoom.git",
|
|
9
8
|
"directory": "packages/ui"
|
|
10
9
|
},
|
|
11
10
|
"homepage": "https://github.com/Fancy-Friends/zoom#readme",
|
|
11
|
+
"bugs": "https://github.com/Fancy-Friends/zoom/issues",
|
|
12
|
+
"type": "module",
|
|
13
|
+
"main": "./dist/index.cjs",
|
|
14
|
+
"module": "./dist/index.js",
|
|
15
|
+
"types": "./dist/index.d.ts",
|
|
16
|
+
"exports": {
|
|
17
|
+
".": {
|
|
18
|
+
"import": {
|
|
19
|
+
"types": "./dist/index.d.ts",
|
|
20
|
+
"default": "./dist/index.js"
|
|
21
|
+
},
|
|
22
|
+
"require": {
|
|
23
|
+
"types": "./dist/index.d.cts",
|
|
24
|
+
"default": "./dist/index.cjs"
|
|
25
|
+
}
|
|
26
|
+
},
|
|
27
|
+
"./package.json": "./package.json"
|
|
28
|
+
},
|
|
29
|
+
"files": [
|
|
30
|
+
"dist",
|
|
31
|
+
"art",
|
|
32
|
+
"README.md",
|
|
33
|
+
"CHANGELOG.md",
|
|
34
|
+
"LICENSE"
|
|
35
|
+
],
|
|
36
|
+
"scripts": {
|
|
37
|
+
"build": "tsup",
|
|
38
|
+
"lint": "tsc --noEmit",
|
|
39
|
+
"test": "node --import tsx --test tests/*.test.ts",
|
|
40
|
+
"prepublishOnly": "tsup"
|
|
41
|
+
},
|
|
42
|
+
"dependencies": {},
|
|
43
|
+
"peerDependencies": {
|
|
44
|
+
"@particle-academy/fancy-flow": ">=0.48.0 <2.0"
|
|
45
|
+
},
|
|
46
|
+
"devDependencies": {
|
|
47
|
+
"@particle-academy/fancy-flow": ">=0.48.0 <2.0",
|
|
48
|
+
"@types/node": "^26.2.0",
|
|
49
|
+
"tsup": "^8.5.0",
|
|
50
|
+
"tsx": "^4.19.0",
|
|
51
|
+
"typescript": "^5.8.0"
|
|
52
|
+
},
|
|
12
53
|
"publishConfig": {
|
|
13
54
|
"access": "public"
|
|
14
55
|
},
|
|
15
|
-
"
|
|
16
|
-
"
|
|
17
|
-
|
|
56
|
+
"keywords": [
|
|
57
|
+
"zoom",
|
|
58
|
+
"messaging",
|
|
59
|
+
"connector",
|
|
60
|
+
"fancy-flow",
|
|
61
|
+
"fancy-ui",
|
|
62
|
+
"particle-academy"
|
|
63
|
+
],
|
|
64
|
+
"license": "MIT",
|
|
65
|
+
"sideEffects": false,
|
|
66
|
+
"engines": {
|
|
67
|
+
"node": ">=22"
|
|
68
|
+
}
|
|
18
69
|
}
|