@particle-academy/google-calendar-js 0.0.0 → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to `@particle-academy/google-calendar-ui`,
+`@particle-academy/google-calendar-js`, `particle-academy/google-calendar-php`
+and `fancy-google-calendar`.
+
+The four packages share one version, because they are generated from one
+`provider/` definition and a version that meant something different in each
+would be a version nobody could reason about.
+
+## [0.1.0] — 2026-09-15
+
+### Added
+
+- **First release.** Actions `event_get`, `event_list` (full or incremental
+  with a `syncToken`; a `410` means list in full again), `channel_watch` and
+  `channel_stop`; the `events_changed` trigger, the first in the estate with
+  `delivery: "subscription"`. Google cannot renew a channel, so the trigger's
+  lease names `channel_watch` again as its renew, 86400 seconds before the
+  week-long channel expires. Deliveries carry an EMPTY body and are verified
+  by the channel token Google echoes in `X-Goog-Channel-Token`.
+- Requires `fancy-connector-core` ≥ 0.8.0 in js and php — the release that
+  carries `LeaseDeclaration` and the shared-token verification scheme.

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,156 @@
-# @particle-academy/google-calendar-js
+# Google Calendar
 
-**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/google-calendar by its `publish.yml` workflow with provenance, and this version is deprecated the moment it lands.
+[![Fancified](art/fancified.svg)](https://particle.academy)
+
+Google Calendar 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/google-calendar-ui` | `npm install @particle-academy/google-calendar-ui` |
+| Node | `@particle-academy/google-calendar-js` | `npm install @particle-academy/google-calendar-js` |
+| PHP 8.4+ | `particle-academy/google-calendar-php` | `composer require particle-academy/google-calendar-php` |
+| Python 3.11+ | `fancy-google-calendar` | `pip install fancy-google-calendar` |
+
+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 Google Calendar 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 Google Calendar connection holds 5 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 Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account. |
+| **OAuth client secret** | per installation | **secret** | The client secret for the same OAuth app. One value for the whole installation. |
+| **Access token** | per connected account | **secret** | Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token. |
+| **Refresh token** | per connected account | **secret** | Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour. |
+| **Channel token** | per connected account | **secret** | A secret the host chooses per connected account and sends as `token` on every events.watch. Google echoes it back in the X-Goog-Channel-Token header of every notification, and that echo is the ONLY thing that authenticates a delivery -- Google does not sign them. Up to 256 characters. |
+
+### Authorising
+
+Google Calendar 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://accounts.google.com/o/oauth2/v2/auth
+- **Token URL** — https://oauth2.googleapis.com/token
+- **Scopes** — `https://www.googleapis.com/auth/calendar.events`
+- **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
+
+The refresh tokens do **not** rotate: the same one is reusable, so a refresh may safely be retried and may run concurrently. Stated rather than assumed, because the opposite — a provider that spends the token and revokes the grant on a replay — looks identical until it happens.
+
+### The estate
+
+**Google Calendar has no test estate, and somebody checked.** Everything this connector does is real. Use the faker to build against it.
+
+> Google has no sandbox for Calendar. A test calendar is a real one in a real account, so every watch and every read is real -- point this at a scratch calendar, not a production one. The faker is the only way to develop against it without touching an account.
+
+## What it can do
+
+### Actions
+
+#### `channel_stop` — Google Calendar stop watching
+
+Close a push-notification channel. The host's subscription machinery calls this before re-creating a channel and when a trigger is removed.
+
+`POST /calendar/v3/channels/stop` · idempotent — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `channelId` | yes | The channel's id, as sent to channel_watch. |
+| `resourceId` | yes | The resourceId channel_watch answered with. Both are needed; Google refuses a stop with only one. |
+
+#### `channel_watch` — Google Calendar watch
+
+Open a push-notification channel on a calendar's events. The host's subscription machinery calls this; it is not a node most workflows need.
+
+`POST /calendar/v3/calendars/{calendarId}/events/watch` · **unsafe to replay** — a retried durable run does it TWICE
+
+| Input | Required | What it is |
+|---|---|---|
+| `calendarId` | yes | `primary` for the connected account's own calendar, or a calendar's id. |
+| `channelId` | yes | A UUID the host mints for THIS channel. Google requires it to be unique; it comes back in every notification as X-Goog-Channel-ID and is what channel_stop needs. |
+| `address` | yes | The HTTPS URL the host mounts for this trigger. Google POSTs notifications here with an EMPTY body and the facts in X-Goog-* headers. |
+| `token` | yes | The connection's channelToken. The host fills this from the connection -- never type a value here. Google echoes it in X-Goog-Channel-Token, and that echo is how a delivery is verified. |
+| `ttlSeconds` | yes | How long Google keeps the channel alive. Google's default is 604800 (one week), and the discovery document types it as a STRING inside `params`. |
+
+#### `event_get` — Google Calendar event
+
+Read one event from a Google Calendar.
+
+`GET /calendar/v3/calendars/{calendarId}/events/{eventId}` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `calendarId` | yes | `primary` for the connected account's own calendar, or a calendar's id (usually an email address). |
+| `eventId` | yes | The event's id, as published by another node or by a notification's follow-up list. |
+
+#### `event_list` — Google Calendar events
+
+List events from a Google Calendar, in full or incrementally with a sync token.
+
+`GET /calendar/v3/calendars/{calendarId}/events` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `calendarId` | yes | `primary` for the connected account's own calendar, or a calendar's id. |
+| `syncToken` | no | From a previous list's nextSyncToken. With one set, Google returns ONLY what changed since -- including deletions, as cancelled events. Leave blank for a full list. |
+| `timeMin` | no | RFC 3339 lower bound on an event's END time, e.g. 2026-09-15T00:00:00Z. Not allowed together with a sync token. |
+| `timeMax` | no | RFC 3339 upper bound on an event's START time. Not allowed together with a sync token. |
+| `maxResults` | no | Events per page. Google's default is 250 and its maximum 2500; a nextPageToken means there are more. |
+| `pageToken` | no | From a previous page's nextPageToken. |
+| `singleEvents` | no | Return each occurrence of a recurring event as its own item, rather than the series once. |
+
+### Triggers
+
+#### `events_changed` — Google Calendar change
+
+Start a run when something changes on a watched Google Calendar.
+
+A SUBSCRIPTION: Google Calendar delivers to your endpoint only while a subscription it issued is alive, at most 168 hours at a time. Its expiry is read from the `channel_watch` response (`expiration`); 86400 seconds before it, Google Calendar cannot renew one, so the host stops it (`channel_stop`) and creates it again (`channel_watch`). A lease that lapses is re-listed AND re-subscribed, because notifications during the gap are gone. Every delivery: the token Google Calendar echoes back is compared with the connection's `channelToken` before anything runs.
+
+**You have to set this up with the provider first:**
+
+The host mints a UUID, calls channel_watch with it, its own URL for this trigger and the connection's channelToken, and stores the returned id, resourceId and expiration. Google cannot renew a channel: 86400 seconds before it expires the host calls channel_stop and then channel_watch again. A channel that lapsed is re-listed FIRST (event_list with the stored syncToken; a 410 means list in full) and then re-created, because notifications during the gap are gone. Google delivers with an EMPTY body: the host verifies X-Goog-Channel-Token against the connection's channelToken and injects the X-Goog-* headers as the event, camel-cased as below. The first message on a new channel is `sync` and carries no change.
+
+## Run it before you have credentials
+
+Every operation ships a **faker**, whether or not Google Calendar has a sandbox. Set a
+node's mode to `fake` and it returns the shape Google Calendar 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/google-calendar`; 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-VH6QZLPP.js

@@ -0,0 +1,338 @@
+import { callConnector, verifyDelivery } from '@particle-academy/fancy-connector-core';
+
+// src/faker.ts
+function fakeChannelStop({ config, fake }) {
+  return {};
+}
+function fakeChannelWatch({ config, fake }) {
+  const boundChannelid = config.channelId !== void 0 && config.channelId !== null && config.channelId !== "" ? String(config.channelId) : `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`;
+  const boundToken = config.token !== void 0 && config.token !== null && config.token !== "" ? String(config.token) : fake.id("tok");
+  return {
+    "kind": "api#channel",
+    "id": boundChannelid,
+    "resourceId": fake.id("o3hgv1538sdjfh"),
+    "resourceUri": "https://www.googleapis.com/calendar/v3/calendars/primary/events?alt=json",
+    "token": boundToken,
+    "expiration": "1789430400000"
+  };
+}
+function fakeEventGet({ config, fake }) {
+  const boundEventid = config.eventId !== void 0 && config.eventId !== null && config.eventId !== "" ? String(config.eventId) : fake.id("evt");
+  return {
+    "kind": "calendar#event",
+    "etag": '"3456789012345678"',
+    "id": boundEventid,
+    "status": "confirmed",
+    "htmlLink": "https://www.google.com/calendar/event?eid=ZmFrZQ",
+    "created": "2026-09-01T09:00:00.000Z",
+    "updated": "2026-09-10T15:30:00.000Z",
+    "summary": "Design review",
+    "description": "Quarterly design review with the platform team.",
+    "creator": {
+      "email": "ada@example.test"
+    },
+    "organizer": {
+      "email": "ada@example.test"
+    },
+    "start": {
+      "dateTime": "2026-09-22T14:00:00+00:00",
+      "timeZone": "UTC"
+    },
+    "end": {
+      "dateTime": "2026-09-22T15:00:00+00:00",
+      "timeZone": "UTC"
+    },
+    "iCalUID": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,
+    "sequence": 0,
+    "attendees": [
+      {
+        "email": "ada@example.test",
+        "organizer": true,
+        "responseStatus": "accepted"
+      },
+      {
+        "email": "grace@example.test",
+        "responseStatus": "needsAction"
+      }
+    ],
+    "reminders": {
+      "useDefault": true
+    },
+    "eventType": "default"
+  };
+}
+function fakeEventList({ config, fake }) {
+  return {
+    "kind": "calendar#events",
+    "etag": '"p33cd9r3ab8ne20g"',
+    "summary": "ada@example.test",
+    "updated": "2026-09-10T15:30:00.000Z",
+    "timeZone": "UTC",
+    "accessRole": "owner",
+    "defaultReminders": [
+      {
+        "method": "popup",
+        "minutes": 10
+      }
+    ],
+    "nextSyncToken": fake.id("CPDSyncToken"),
+    "items": [
+      {
+        "kind": "calendar#event",
+        "etag": '"3456789012345678"',
+        "id": fake.id("evt"),
+        "status": "confirmed",
+        "htmlLink": "https://www.google.com/calendar/event?eid=ZmFrZQ",
+        "created": "2026-09-01T09:00:00.000Z",
+        "updated": "2026-09-10T15:30:00.000Z",
+        "summary": "Design review",
+        "creator": {
+          "email": "ada@example.test"
+        },
+        "organizer": {
+          "email": "ada@example.test"
+        },
+        "start": {
+          "dateTime": "2026-09-22T14:00:00+00:00",
+          "timeZone": "UTC"
+        },
+        "end": {
+          "dateTime": "2026-09-22T15:00:00+00:00",
+          "timeZone": "UTC"
+        },
+        "iCalUID": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,
+        "sequence": 0,
+        "reminders": {
+          "useDefault": true
+        },
+        "eventType": "default"
+      }
+    ]
+  };
+}
+function fakeEventsChanged({ config, fake }) {
+  const boundChannelid = `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`;
+  return {
+    "channelId": boundChannelid,
+    "messageNumber": "2",
+    "resourceId": fake.id("o3hgv1538sdjfh"),
+    "resourceState": config.sample !== void 0 && config.sample !== null && config.sample !== "" ? String(config.sample) : "exists",
+    "resourceUri": "https://www.googleapis.com/calendar/v3/calendars/primary/events?alt=json",
+    "channelExpiration": "Tue, 15 Sep 2026 00:00:00 GMT"
+  };
+}
+var googleCalendarFaker = (operation, request) => {
+  switch (operation) {
+    case "channel_stop":
+      return fakeChannelStop(request);
+    case "channel_watch":
+      return fakeChannelWatch(request);
+    case "event_get":
+      return fakeEventGet(request);
+    case "event_list":
+      return fakeEventList(request);
+    case "events_changed":
+      return fakeEventsChanged(request);
+    default:
+      throw new Error(
+        `google_calendar: 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 GOOGLE_CALENDAR_BASE_URLS = {
+  "live": "https://www.googleapis.com"
+};
+var GOOGLE_CALENDAR_REQUIRES = [
+  "accessToken",
+  "refreshToken",
+  "clientId",
+  "clientSecret"
+];
+function googleCalendarAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var GOOGLE_CALENDAR = {
+  service: "google_calendar",
+  title: "Google Calendar",
+  sandbox: "none",
+  baseUrls: { ...GOOGLE_CALENDAR_BASE_URLS },
+  requires: [...GOOGLE_CALENDAR_REQUIRES],
+  authorize: googleCalendarAuthorize,
+  faker: googleCalendarFaker
+};
+var CHANNEL_STOP_OPERATION = "channel_stop";
+async function googleCalendarChannelStop(options) {
+  const config = options.config ?? {};
+  if (config.channelId === void 0 || config.channelId === null || config.channelId === "") {
+    throw new Error(`channel_stop: "channelId" is required (Channel ID).`);
+  }
+  if (config.resourceId === void 0 || config.resourceId === null || config.resourceId === "") {
+    throw new Error(`channel_stop: "resourceId" is required (Resource ID).`);
+  }
+  return callConnector(GOOGLE_CALENDAR, {
+    operation: CHANNEL_STOP_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: "POST",
+      path: "/calendar/v3/channels/stop",
+      json: {
+        "id": String(config.channelId),
+        "resourceId": String(config.resourceId)
+      }
+    }
+  });
+}
+var CHANNEL_WATCH_OPERATION = "channel_watch";
+async function googleCalendarChannelWatch(options) {
+  const config = options.config ?? {};
+  if (config.calendarId === void 0 || config.calendarId === null || config.calendarId === "") {
+    throw new Error(`channel_watch: "calendarId" is required (Calendar ID).`);
+  }
+  if (config.channelId === void 0 || config.channelId === null || config.channelId === "") {
+    throw new Error(`channel_watch: "channelId" is required (Channel ID).`);
+  }
+  if (config.address === void 0 || config.address === null || config.address === "") {
+    throw new Error(`channel_watch: "address" is required (Notification URL).`);
+  }
+  if (config.token === void 0 || config.token === null || config.token === "") {
+    throw new Error(`channel_watch: "token" is required (Channel token).`);
+  }
+  if (config.ttlSeconds === void 0 || config.ttlSeconds === null || config.ttlSeconds === "") {
+    throw new Error(`channel_watch: "ttlSeconds" is required (Lifetime (seconds)).`);
+  }
+  return callConnector(GOOGLE_CALENDAR, {
+    operation: CHANNEL_WATCH_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: "POST",
+      path: `/calendar/v3/calendars/${encodeURIComponent(String(config.calendarId))}/events/watch`,
+      json: nestFields({
+        "id": String(config.channelId),
+        "address": String(config.address),
+        "token": String(config.token),
+        "params.ttl": String(config.ttlSeconds),
+        "type": "web_hook"
+      })
+    }
+  });
+}
+function nestFields(flat) {
+  const out = {};
+  for (const [path, value] of Object.entries(flat)) {
+    const parts = path.split(".");
+    let node = out;
+    while (parts.length > 1) {
+      const key = parts.shift();
+      const wantsArray = /^\d+$/.test(parts[0] ?? "");
+      if (typeof node[key] !== "object" || node[key] === null) node[key] = wantsArray ? [] : {};
+      node = node[key];
+    }
+    node[parts[0]] = value;
+  }
+  return out;
+}
+var EVENT_GET_OPERATION = "event_get";
+async function googleCalendarEventGet(options) {
+  const config = options.config ?? {};
+  if (config.calendarId === void 0 || config.calendarId === null || config.calendarId === "") {
+    throw new Error(`event_get: "calendarId" is required (Calendar ID).`);
+  }
+  if (config.eventId === void 0 || config.eventId === null || config.eventId === "") {
+    throw new Error(`event_get: "eventId" is required (Event ID).`);
+  }
+  return callConnector(GOOGLE_CALENDAR, {
+    operation: EVENT_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: `/calendar/v3/calendars/${encodeURIComponent(String(config.calendarId))}/events/${encodeURIComponent(String(config.eventId))}`,
+      query: {}
+    }
+  });
+}
+var EVENT_LIST_OPERATION = "event_list";
+async function googleCalendarEventList(options) {
+  const config = options.config ?? {};
+  if (config.calendarId === void 0 || config.calendarId === null || config.calendarId === "") {
+    throw new Error(`event_list: "calendarId" is required (Calendar ID).`);
+  }
+  {
+    const n = Number(config.maxResults);
+    const given = config.maxResults !== void 0 && config.maxResults !== null && config.maxResults !== "";
+    if (given && !(Number.isInteger(n) && n >= 1 && n <= 2500)) {
+      throw new Error(
+        `event_list: "maxResults" must be a integer, got ${JSON.stringify(config.maxResults)}.`
+      );
+    }
+  }
+  return callConnector(GOOGLE_CALENDAR, {
+    operation: EVENT_LIST_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: `/calendar/v3/calendars/${encodeURIComponent(String(config.calendarId))}/events`,
+      query: {
+        ...config.syncToken !== void 0 && config.syncToken !== null && config.syncToken !== "" ? { "syncToken": String(config.syncToken) } : {},
+        ...config.timeMin !== void 0 && config.timeMin !== null && config.timeMin !== "" ? { "timeMin": String(config.timeMin) } : {},
+        ...config.timeMax !== void 0 && config.timeMax !== null && config.timeMax !== "" ? { "timeMax": String(config.timeMax) } : {},
+        "maxResults": config.maxResults !== void 0 && config.maxResults !== null && config.maxResults !== "" ? Math.trunc(Number(config.maxResults)) : 250,
+        ...config.pageToken !== void 0 && config.pageToken !== null && config.pageToken !== "" ? { "pageToken": String(config.pageToken) } : {},
+        ...config.singleEvents !== void 0 && config.singleEvents !== null && config.singleEvents !== "" ? { "singleEvents": Boolean(config.singleEvents) } : {}
+      }
+    }
+  });
+}
+var GOOGLE_CALENDAR_EVENTS_CHANGED_TOKEN_SCHEME = { kind: "shared-token", in: "header", name: "X-Goog-Channel-Token" };
+var GOOGLE_CALENDAR_EVENTS_CHANGED_LEASE = {
+  expiresAtFrom: "expiration",
+  expiresAtUnit: "epoch-ms",
+  renewBeforeSeconds: 86400,
+  renewOperation: "channel_watch"
+};
+var GOOGLE_CALENDAR_EVENTS_CHANGED_SUBSCRIPTION = { create: "channel_watch", renew: null, stop: "channel_stop" };
+var GOOGLE_CALENDAR_EVENTS_CHANGED = {
+  service: "google_calendar",
+  operation: "events_changed",
+  delivery: "subscription",
+  setup: "The host mints a UUID, calls channel_watch with it, its own URL for this trigger and the connection's channelToken, and stores the returned id, resourceId and expiration. Google cannot renew a channel: 86400 seconds before it expires the host calls channel_stop and then channel_watch again. A channel that lapsed is re-listed FIRST (event_list with the stored syncToken; a 410 means list in full) and then re-created, because notifications during the gap are gone. Google delivers with an EMPTY body: the host verifies X-Goog-Channel-Token against the connection's channelToken and injects the X-Goog-* headers as the event, camel-cased as below. The first message on a new channel is `sync` and carries no change.",
+  subscriptionTtl: 604800,
+  lease: GOOGLE_CALENDAR_EVENTS_CHANGED_LEASE,
+  verification: {
+    scheme: GOOGLE_CALENDAR_EVENTS_CHANGED_TOKEN_SCHEME
+  },
+  faker: googleCalendarFaker
+};
+function verifyGoogleCalendarDelivery(delivery, channelToken, now) {
+  return verifyDelivery(GOOGLE_CALENDAR_EVENTS_CHANGED, delivery, channelToken, now);
+}
+
+export { CHANNEL_STOP_OPERATION, CHANNEL_WATCH_OPERATION, CONNECTOR_API_VERSION, EVENT_GET_OPERATION, EVENT_LIST_OPERATION, GOOGLE_CALENDAR, GOOGLE_CALENDAR_BASE_URLS, GOOGLE_CALENDAR_EVENTS_CHANGED, GOOGLE_CALENDAR_EVENTS_CHANGED_LEASE, GOOGLE_CALENDAR_EVENTS_CHANGED_SUBSCRIPTION, GOOGLE_CALENDAR_EVENTS_CHANGED_TOKEN_SCHEME, GOOGLE_CALENDAR_REQUIRES, googleCalendarAuthorize, googleCalendarChannelStop, googleCalendarChannelWatch, googleCalendarEventGet, googleCalendarEventList, googleCalendarFaker, verifyGoogleCalendarDelivery };
+//# sourceMappingURL=chunk-VH6QZLPP.js.map
+//# sourceMappingURL=chunk-VH6QZLPP.js.map