@particle-academy/google-calendar-ui 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -8,6 +8,47 @@ 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.3.0] — 2026-11-08
+
+### Added
+
+- **Laravel integration, in this package** (`src/Laravel/`), auto-discovered
+  through composer's `extra.laravel`. Laravel is SUGGESTED, never required:
+  outside a Laravel app none of it loads.
+  - a service provider that merges `config/google-calendar.php` under
+    `connectors.google-calendar` (credentials from the environment, or per call for a
+    multi-account app);
+  - the `GoogleCalendar` facade: `GoogleCalendar::call('<operation>', [...])` runs any action;
+  - `GoogleCalendar::fake()`, answered from the connector's faker, with
+    `assertSent` / `assertNotSent` / `assertNothingSent` / `assertSentCount`;
+  - a webhook ROUTE per trigger (`Route::googleCalendarEventsChanged('/path')`) that VERIFIES the raw delivery with the trigger's own scheme before the app sees it, answers 401 with the reason when it does not, then dispatches an event (`Events\\…Received`);
+  - its own Pest test of all of it against a booted Laravel app.
+
+### Changed
+
+- **Tests: Pest `^5`**, and `laravel/framework` `^13` as a DEV-ONLY test
+  dependency (the framework this package integrates with; nothing ships in
+  `require`).
+
+## [0.2.0] — 2026-09-30
+
+### Added
+
+- **`event_create`**, **`event_update`** and **`event_delete`** — write
+  support, the first this connector has had. `event_update` uses PATCH
+  (`events.patch`), not PUT (`events.update`): PUT requires resending the
+  whole event or Google clears every field left out, which is a trap for
+  a caller that only wants to change one thing. No scope change —
+  `calendar.events` already covers create/update/delete.
+- Deliberately NOT included: attendees and recurrence. Both need an
+  array-of-objects (attendees) or array-of-strings (recurrence) config
+  shape nothing in this estate's vocabulary has needed before now; same
+  bar as everything in `vocabulary-deferred.md` — a second real need,
+  not a first guess. All-day (date-only) events are out of scope for the
+  same reason: they need `start.date`/`end.date` instead of
+  `start.dateTime`/`end.dateTime`, a variant this config shape cannot
+  express yet.
+
 ## [0.1.0] — 2026-09-15
 
 ### Added

package/README.md

@@ -93,6 +93,38 @@ Open a push-notification channel on a calendar's events. The host's subscription
 | `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_create` — Create Google Calendar event
+
+Create a timed event on a Google Calendar.
+
+`POST /calendar/v3/calendars/{calendarId}/events` · **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. |
+| `summary` | yes | Title |
+| `description` | no | Can contain HTML. |
+| `location` | no | Free-form text. |
+| `startDateTime` | yes | RFC 3339, e.g. 2026-10-01T14:00:00Z. Include an offset, or pair with a time zone below. |
+| `startTimeZone` | no | IANA name, e.g. America/New_York. Optional when the start time already carries an offset. |
+| `endDateTime` | yes | RFC 3339. Exclusive -- the event ends at, not through, this instant. |
+| `endTimeZone` | no | End time zone |
+| `status` | no | "cancelled" is not offered here -- that is event_delete's job, not a status this action should be able to set on create. |
+| `visibility` | no | Visibility |
+| `transparency` | no | opaque blocks time on the calendar (Busy); transparent does not (Available). |
+| `colorId` | no | An id from the colors endpoint's event section. Leave blank for the calendar's default. |
+
+#### `event_delete` — Delete Google Calendar event
+
+Remove an event from a Google Calendar.
+
+`DELETE /calendar/v3/calendars/{calendarId}/events/{eventId}` · idempotent — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `calendarId` | yes | Calendar ID |
+| `eventId` | yes | From event_create's data.id, or event_list/event_get. |
+
 #### `event_get` — Google Calendar event
 
 Read one event from a Google Calendar.
@@ -120,6 +152,28 @@ List events from a Google Calendar, in full or incrementally with a sync token.
 | `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. |
 
+#### `event_update` — Update Google Calendar event
+
+Change one or more fields of an existing event. Only the fields provided are touched.
+
+`PATCH /calendar/v3/calendars/{calendarId}/events/{eventId}` · idempotent — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `calendarId` | yes | Calendar ID |
+| `eventId` | yes | From event_create's data.id, or event_list/event_get. |
+| `summary` | no | Title |
+| `description` | no | Description |
+| `location` | no | Location |
+| `startDateTime` | no | RFC 3339. Leave blank to leave the start time unchanged. |
+| `startTimeZone` | no | Start time zone |
+| `endDateTime` | no | RFC 3339. Leave blank to leave the end time unchanged. |
+| `endTimeZone` | no | End time zone |
+| `status` | no | Setting cancelled here has the same effect as event_delete -- offered because PATCH is also Google's documented way to cancel one instance of a recurring event, which event_delete (which removes the whole resource) cannot target. |
+| `visibility` | no | Visibility |
+| `transparency` | no | Show me as |
+| `colorId` | no | Color ID |
+
 ### Triggers
 
 #### `events_changed` — Google Calendar change

package/dist/index.cjs

@@ -190,6 +190,220 @@ var googleCalendarChannelWatchKind = connectors.defineConnectorKind(GOOGLE_CALEN
   },
   renderBody: ({ config }) => connectors.summarize(GOOGLE_CALENDAR_CHANNEL_WATCH_META, config, "watch a calendar")
 });
+var GOOGLE_CALENDAR_EVENT_CREATE_KIND = "@particle-academy/google_calendar_event_create";
+var GOOGLE_CALENDAR_EVENT_CREATE_OPERATION = "event_create";
+var GOOGLE_CALENDAR_EVENT_CREATE_META = googleCalendarMeta("action", "create an event", "https://developers.google.com/workspace/calendar/api/v3/reference/events/insert");
+var GOOGLE_CALENDAR_EVENT_CREATE_OUTPUT = [
+  {
+    "path": "data.id",
+    "type": "string",
+    "description": "The new event's id."
+  },
+  {
+    "path": "data.status",
+    "type": "string",
+    "description": "confirmed or tentative, echoing what was sent (or Google's default)."
+  },
+  {
+    "path": "data.summary",
+    "type": "string",
+    "description": "Echoes what was sent."
+  },
+  {
+    "path": "data.htmlLink",
+    "type": "string",
+    "description": "The event in the Google Calendar UI."
+  },
+  {
+    "path": "data.start.dateTime",
+    "type": "string",
+    "description": "Echoes what was sent."
+  },
+  {
+    "path": "data.end.dateTime",
+    "type": "string",
+    "description": "Echoes what was sent."
+  },
+  {
+    "path": "data.created",
+    "type": "string",
+    "description": "RFC 3339 creation time."
+  },
+  {
+    "path": "data.organizer.email",
+    "type": "string",
+    "description": "The connected account, almost always."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var googleCalendarEventCreateKind = connectors.defineConnectorKind(GOOGLE_CALENDAR_EVENT_CREATE_META, {
+  name: GOOGLE_CALENDAR_EVENT_CREATE_KIND,
+  aliases: ["google_calendar_event_create"],
+  label: "Create Google Calendar event",
+  description: "Create a timed event on a Google Calendar.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "unsafe-to-replay",
+  outputShape: GOOGLE_CALENDAR_EVENT_CREATE_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "calendarId",
+      "label": "Calendar ID",
+      "required": true,
+      "default": "primary",
+      "description": "`primary` for the connected account's own calendar, or a calendar's id."
+    },
+    {
+      "type": "text",
+      "key": "summary",
+      "label": "Title",
+      "required": true
+    },
+    {
+      "type": "textarea",
+      "key": "description",
+      "label": "Description",
+      "description": "Can contain HTML."
+    },
+    {
+      "type": "text",
+      "key": "location",
+      "label": "Location",
+      "description": "Free-form text."
+    },
+    {
+      "type": "text",
+      "key": "startDateTime",
+      "label": "Start",
+      "required": true,
+      "description": "RFC 3339, e.g. 2026-10-01T14:00:00Z. Include an offset, or pair with a time zone below."
+    },
+    {
+      "type": "text",
+      "key": "startTimeZone",
+      "label": "Start time zone",
+      "description": "IANA name, e.g. America/New_York. Optional when the start time already carries an offset."
+    },
+    {
+      "type": "text",
+      "key": "endDateTime",
+      "label": "End",
+      "required": true,
+      "description": "RFC 3339. Exclusive -- the event ends at, not through, this instant."
+    },
+    {
+      "type": "text",
+      "key": "endTimeZone",
+      "label": "End time zone"
+    },
+    {
+      "type": "select",
+      "key": "status",
+      "label": "Status",
+      "options": [
+        {
+          "value": "confirmed",
+          "label": "Confirmed"
+        },
+        {
+          "value": "tentative",
+          "label": "Tentative"
+        }
+      ],
+      "description": `"cancelled" is not offered here -- that is event_delete's job, not a status this action should be able to set on create.`
+    },
+    {
+      "type": "select",
+      "key": "visibility",
+      "label": "Visibility",
+      "options": [
+        {
+          "value": "default",
+          "label": "Default"
+        },
+        {
+          "value": "public",
+          "label": "Public"
+        },
+        {
+          "value": "private",
+          "label": "Private"
+        }
+      ]
+    },
+    {
+      "type": "select",
+      "key": "transparency",
+      "label": "Show me as",
+      "options": [
+        {
+          "value": "opaque",
+          "label": "Busy"
+        },
+        {
+          "value": "transparent",
+          "label": "Available"
+        }
+      ],
+      "description": "opaque blocks time on the calendar (Busy); transparent does not (Available)."
+    },
+    {
+      "type": "text",
+      "key": "colorId",
+      "label": "Color ID",
+      "description": "An id from the colors endpoint's event section. Leave blank for the calendar's default."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GOOGLE_CALENDAR_EVENT_CREATE_META, config, "create an event")
+});
+var GOOGLE_CALENDAR_EVENT_DELETE_KIND = "@particle-academy/google_calendar_event_delete";
+var GOOGLE_CALENDAR_EVENT_DELETE_OPERATION = "event_delete";
+var GOOGLE_CALENDAR_EVENT_DELETE_META = googleCalendarMeta("action", "delete an event", "https://developers.google.com/workspace/calendar/api/v3/reference/events/delete");
+var GOOGLE_CALENDAR_EVENT_DELETE_OUTPUT = [
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google answers 204 with no body, so this is the only thing published."
+  }
+];
+var googleCalendarEventDeleteKind = connectors.defineConnectorKind(GOOGLE_CALENDAR_EVENT_DELETE_META, {
+  name: GOOGLE_CALENDAR_EVENT_DELETE_KIND,
+  aliases: ["google_calendar_event_delete"],
+  label: "Delete Google Calendar event",
+  description: "Remove an event from a Google Calendar.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "idempotent",
+  outputShape: GOOGLE_CALENDAR_EVENT_DELETE_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "calendarId",
+      "label": "Calendar ID",
+      "required": true,
+      "default": "primary"
+    },
+    {
+      "type": "text",
+      "key": "eventId",
+      "label": "Event ID",
+      "required": true,
+      "description": "From event_create's data.id, or event_list/event_get."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GOOGLE_CALENDAR_EVENT_DELETE_META, config, "delete an event")
+});
 var GOOGLE_CALENDAR_EVENT_GET_KIND = "@particle-academy/google_calendar_event_get";
 var GOOGLE_CALENDAR_EVENT_GET_OPERATION = "event_get";
 var GOOGLE_CALENDAR_EVENT_GET_META = googleCalendarMeta("action", "read an event", "https://developers.google.com/workspace/calendar/api/v3/reference/events/get");
@@ -370,6 +584,177 @@ var googleCalendarEventListKind = connectors.defineConnectorKind(GOOGLE_CALENDAR
   },
   renderBody: ({ config }) => connectors.summarize(GOOGLE_CALENDAR_EVENT_LIST_META, config, "list events")
 });
+var GOOGLE_CALENDAR_EVENT_UPDATE_KIND = "@particle-academy/google_calendar_event_update";
+var GOOGLE_CALENDAR_EVENT_UPDATE_OPERATION = "event_update";
+var GOOGLE_CALENDAR_EVENT_UPDATE_META = googleCalendarMeta("action", "update an event", "https://developers.google.com/workspace/calendar/api/v3/reference/events/patch");
+var GOOGLE_CALENDAR_EVENT_UPDATE_OUTPUT = [
+  {
+    "path": "data.id",
+    "type": "string",
+    "description": "The event's id."
+  },
+  {
+    "path": "data.status",
+    "type": "string",
+    "description": "The event's status after this update."
+  },
+  {
+    "path": "data.summary",
+    "type": "string",
+    "description": "The event's title after this update."
+  },
+  {
+    "path": "data.htmlLink",
+    "type": "string",
+    "description": "The event in the Google Calendar UI."
+  },
+  {
+    "path": "data.start.dateTime",
+    "type": "string",
+    "description": "The event's start after this update."
+  },
+  {
+    "path": "data.end.dateTime",
+    "type": "string",
+    "description": "The event's end after this update."
+  },
+  {
+    "path": "data.updated",
+    "type": "string",
+    "description": "RFC 3339 last modification -- now."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var googleCalendarEventUpdateKind = connectors.defineConnectorKind(GOOGLE_CALENDAR_EVENT_UPDATE_META, {
+  name: GOOGLE_CALENDAR_EVENT_UPDATE_KIND,
+  aliases: ["google_calendar_event_update"],
+  label: "Update Google Calendar event",
+  description: "Change one or more fields of an existing event. Only the fields provided are touched.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "idempotent",
+  outputShape: GOOGLE_CALENDAR_EVENT_UPDATE_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "calendarId",
+      "label": "Calendar ID",
+      "required": true,
+      "default": "primary"
+    },
+    {
+      "type": "text",
+      "key": "eventId",
+      "label": "Event ID",
+      "required": true,
+      "description": "From event_create's data.id, or event_list/event_get."
+    },
+    {
+      "type": "text",
+      "key": "summary",
+      "label": "Title"
+    },
+    {
+      "type": "textarea",
+      "key": "description",
+      "label": "Description"
+    },
+    {
+      "type": "text",
+      "key": "location",
+      "label": "Location"
+    },
+    {
+      "type": "text",
+      "key": "startDateTime",
+      "label": "Start",
+      "description": "RFC 3339. Leave blank to leave the start time unchanged."
+    },
+    {
+      "type": "text",
+      "key": "startTimeZone",
+      "label": "Start time zone"
+    },
+    {
+      "type": "text",
+      "key": "endDateTime",
+      "label": "End",
+      "description": "RFC 3339. Leave blank to leave the end time unchanged."
+    },
+    {
+      "type": "text",
+      "key": "endTimeZone",
+      "label": "End time zone"
+    },
+    {
+      "type": "select",
+      "key": "status",
+      "label": "Status",
+      "options": [
+        {
+          "value": "confirmed",
+          "label": "Confirmed"
+        },
+        {
+          "value": "tentative",
+          "label": "Tentative"
+        },
+        {
+          "value": "cancelled",
+          "label": "Cancelled"
+        }
+      ],
+      "description": "Setting cancelled here has the same effect as event_delete -- offered because PATCH is also Google's documented way to cancel one instance of a recurring event, which event_delete (which removes the whole resource) cannot target."
+    },
+    {
+      "type": "select",
+      "key": "visibility",
+      "label": "Visibility",
+      "options": [
+        {
+          "value": "default",
+          "label": "Default"
+        },
+        {
+          "value": "public",
+          "label": "Public"
+        },
+        {
+          "value": "private",
+          "label": "Private"
+        }
+      ]
+    },
+    {
+      "type": "select",
+      "key": "transparency",
+      "label": "Show me as",
+      "options": [
+        {
+          "value": "opaque",
+          "label": "Busy"
+        },
+        {
+          "value": "transparent",
+          "label": "Available"
+        }
+      ]
+    },
+    {
+      "type": "text",
+      "key": "colorId",
+      "label": "Color ID"
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GOOGLE_CALENDAR_EVENT_UPDATE_META, config, "update an event")
+});
 var GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_KIND = "@particle-academy/google_calendar_events_changed_trigger";
 var GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_OPERATION = "events_changed";
 var GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_META = googleCalendarMeta("trigger", "a calendar change", "https://developers.google.com/workspace/calendar/api/guides/push");
@@ -449,8 +834,11 @@ var googleCalendarEventsChangedTriggerKind = connectors.defineConnectorKind(GOOG
 var GOOGLE_CALENDAR_KINDS = [
   googleCalendarChannelStopKind,
   googleCalendarChannelWatchKind,
+  googleCalendarEventCreateKind,
+  googleCalendarEventDeleteKind,
   googleCalendarEventGetKind,
   googleCalendarEventListKind,
+  googleCalendarEventUpdateKind,
   googleCalendarEventsChangedTriggerKind
 ];
 
@@ -468,6 +856,14 @@ exports.GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_KIND = GOOGLE_CALENDAR_EVENTS_CHA
 exports.GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_META = GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_META;
 exports.GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_OPERATION = GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_OPERATION;
 exports.GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_OUTPUT = GOOGLE_CALENDAR_EVENTS_CHANGED_TRIGGER_OUTPUT;
+exports.GOOGLE_CALENDAR_EVENT_CREATE_KIND = GOOGLE_CALENDAR_EVENT_CREATE_KIND;
+exports.GOOGLE_CALENDAR_EVENT_CREATE_META = GOOGLE_CALENDAR_EVENT_CREATE_META;
+exports.GOOGLE_CALENDAR_EVENT_CREATE_OPERATION = GOOGLE_CALENDAR_EVENT_CREATE_OPERATION;
+exports.GOOGLE_CALENDAR_EVENT_CREATE_OUTPUT = GOOGLE_CALENDAR_EVENT_CREATE_OUTPUT;
+exports.GOOGLE_CALENDAR_EVENT_DELETE_KIND = GOOGLE_CALENDAR_EVENT_DELETE_KIND;
+exports.GOOGLE_CALENDAR_EVENT_DELETE_META = GOOGLE_CALENDAR_EVENT_DELETE_META;
+exports.GOOGLE_CALENDAR_EVENT_DELETE_OPERATION = GOOGLE_CALENDAR_EVENT_DELETE_OPERATION;
+exports.GOOGLE_CALENDAR_EVENT_DELETE_OUTPUT = GOOGLE_CALENDAR_EVENT_DELETE_OUTPUT;
 exports.GOOGLE_CALENDAR_EVENT_GET_KIND = GOOGLE_CALENDAR_EVENT_GET_KIND;
 exports.GOOGLE_CALENDAR_EVENT_GET_META = GOOGLE_CALENDAR_EVENT_GET_META;
 exports.GOOGLE_CALENDAR_EVENT_GET_OPERATION = GOOGLE_CALENDAR_EVENT_GET_OPERATION;
@@ -476,13 +872,20 @@ exports.GOOGLE_CALENDAR_EVENT_LIST_KIND = GOOGLE_CALENDAR_EVENT_LIST_KIND;
 exports.GOOGLE_CALENDAR_EVENT_LIST_META = GOOGLE_CALENDAR_EVENT_LIST_META;
 exports.GOOGLE_CALENDAR_EVENT_LIST_OPERATION = GOOGLE_CALENDAR_EVENT_LIST_OPERATION;
 exports.GOOGLE_CALENDAR_EVENT_LIST_OUTPUT = GOOGLE_CALENDAR_EVENT_LIST_OUTPUT;
+exports.GOOGLE_CALENDAR_EVENT_UPDATE_KIND = GOOGLE_CALENDAR_EVENT_UPDATE_KIND;
+exports.GOOGLE_CALENDAR_EVENT_UPDATE_META = GOOGLE_CALENDAR_EVENT_UPDATE_META;
+exports.GOOGLE_CALENDAR_EVENT_UPDATE_OPERATION = GOOGLE_CALENDAR_EVENT_UPDATE_OPERATION;
+exports.GOOGLE_CALENDAR_EVENT_UPDATE_OUTPUT = GOOGLE_CALENDAR_EVENT_UPDATE_OUTPUT;
 exports.GOOGLE_CALENDAR_KINDS = GOOGLE_CALENDAR_KINDS;
 exports.GOOGLE_CALENDAR_OAUTH = GOOGLE_CALENDAR_OAUTH;
 exports.GOOGLE_CALENDAR_SERVICE = GOOGLE_CALENDAR_SERVICE;
 exports.googleCalendarChannelStopKind = googleCalendarChannelStopKind;
 exports.googleCalendarChannelWatchKind = googleCalendarChannelWatchKind;
+exports.googleCalendarEventCreateKind = googleCalendarEventCreateKind;
+exports.googleCalendarEventDeleteKind = googleCalendarEventDeleteKind;
 exports.googleCalendarEventGetKind = googleCalendarEventGetKind;
 exports.googleCalendarEventListKind = googleCalendarEventListKind;
+exports.googleCalendarEventUpdateKind = googleCalendarEventUpdateKind;
 exports.googleCalendarEventsChangedTriggerKind = googleCalendarEventsChangedTriggerKind;
 exports.googleCalendarMeta = googleCalendarMeta;
 //# sourceMappingURL=index.cjs.map