@elizaos/capacitor-calendar 2.0.3-beta.2

package/ElizaosCapacitorCalendar.podspec

@@ -0,0 +1,18 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'ElizaosCapacitorCalendar'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license'] || { :type => 'MIT' }
+  s.homepage = 'https://elizaos.ai'
+  s.authors = { 'elizaOS' => 'dev@elizaos.ai' }
+  s.source = { :git => 'https://github.com/elizaOS/eliza.git', :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.9'
+  s.frameworks = 'EventKit', 'UIKit'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+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

@@ -0,0 +1,77 @@
+# @elizaos/capacitor-calendar
+
+Reads and writes Apple Calendar events through EventKit, for elizaOS iOS apps and macOS desktop runtimes.
+
+## What it does
+
+This package provides a Capacitor native-bridge plugin (`AppleCalendar`) that gives elizaOS apps running on iOS (or macOS via the Electrobun desktop shell with the EventKit dylib) full read/write access to the device's calendar store. On web/browser targets every method returns a graceful `not_supported` error.
+
+## Capabilities
+
+| Operation | Method |
+|-----------|--------|
+| Check EventKit permission state | `AppleCalendar.checkPermissions()` |
+| Request calendar access from the user | `AppleCalendar.requestPermissions()` |
+| List all calendars | `AppleCalendar.listCalendars()` |
+| Fetch events in a time window | `AppleCalendar.listEvents({ timeMin, timeMax, calendarId? })` |
+| Create a new event | `AppleCalendar.createEvent(input)` |
+| Update an existing event | `AppleCalendar.updateEvent({ eventId, ...input })` |
+| Delete an event | `AppleCalendar.deleteEvent({ eventId })` |
+
+All methods return a Promise. Results include an `ok: boolean` field; failures include `error` and `message` string fields.
+
+## Limitations
+
+- **Attendees are not supported.** EventKit does not permit third-party apps to set event invitees. Passing `attendees` to `createEvent` or `updateEvent` returns `error: "unsupported_feature"`.
+- **macOS desktop** uses the Electrobun EventKit dylib, not this Capacitor plugin.
+- **Browser/web** targets receive `{ ok: false, error: "not_supported" }` from every method.
+- iOS 17+ requires full-access authorization (`requestFullAccessToEvents`). `writeOnly` authorization is treated as `restricted`.
+
+## Required platform setup
+
+### iOS
+
+Add the plugin to your Capacitor iOS project:
+
+```bash
+npm install @elizaos/capacitor-calendar
+npx cap sync ios
+```
+
+Add the `NSCalendarsFullAccessUsageDescription` key to `Info.plist` explaining why calendar access is needed. Without this key the system will deny access.
+
+The native pod (`ElizaosCapacitorCalendar`) requires iOS 15.0+ and Swift 5.9+.
+
+## Usage
+
+```typescript
+import { AppleCalendar } from "@elizaos/capacitor-calendar";
+
+// Check and request permission
+const status = await AppleCalendar.checkPermissions();
+if (status.calendar !== "granted") {
+  await AppleCalendar.requestPermissions();
+}
+
+// List events for the next 7 days
+const now = new Date();
+const nextWeek = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);
+const result = await AppleCalendar.listEvents({
+  timeMin: now.toISOString(),
+  timeMax: nextWeek.toISOString(),
+});
+if (result.ok) {
+  console.log(result.events);
+}
+
+// Create an event
+const created = await AppleCalendar.createEvent({
+  title: "Team sync",
+  startAt: "2026-06-01T10:00:00.000Z",
+  endAt: "2026-06-01T11:00:00.000Z",
+});
+```
+
+## Config / Env Vars
+
+None. This package reads no environment variables. Authorization is granted at the OS level by the user.

package/dist/esm/definitions.d.ts

@@ -0,0 +1,93 @@
+export type AppleCalendarPermissionState = "granted" | "denied" | "prompt" | "restricted";
+export interface AppleCalendarPermissionStatus {
+    calendar: AppleCalendarPermissionState;
+    canRequest: boolean;
+    reason?: string | null;
+}
+export interface AppleCalendarSummary {
+    calendarId: string;
+    summary: string;
+    description: string | null;
+    primary: boolean;
+    accessRole: string;
+    backgroundColor: string | null;
+    foregroundColor: string | null;
+    timeZone: string | null;
+    selected: boolean;
+}
+export interface AppleCalendarAttendee {
+    email: string | null;
+    displayName: string | null;
+    responseStatus: string | null;
+    self: boolean;
+    organizer: boolean;
+    optional: boolean;
+}
+export interface AppleCalendarEvent {
+    id: string;
+    externalId: string;
+    calendarId: string;
+    calendarSummary: string;
+    title: string;
+    description: string;
+    location: string;
+    status: string;
+    startAt: string;
+    endAt: string;
+    isAllDay: boolean;
+    timezone: string | null;
+    htmlLink: string | null;
+    conferenceLink: string | null;
+    organizer: Record<string, unknown> | null;
+    attendees: AppleCalendarAttendee[];
+}
+export interface AppleCalendarBaseResult {
+    ok: boolean;
+    error?: string;
+    message?: string;
+}
+export interface AppleCalendarListResult extends AppleCalendarBaseResult {
+    calendars?: AppleCalendarSummary[];
+}
+export interface AppleCalendarEventsResult extends AppleCalendarBaseResult {
+    events?: AppleCalendarEvent[];
+}
+export interface AppleCalendarEventResult extends AppleCalendarBaseResult {
+    event?: AppleCalendarEvent;
+}
+export interface AppleCalendarListEventsOptions {
+    calendarId?: string | null;
+    timeMin: string;
+    timeMax: string;
+}
+export interface AppleCalendarEventInput {
+    calendarId?: string;
+    title?: string;
+    description?: string;
+    location?: string;
+    startAt?: string;
+    endAt?: string;
+    timeZone?: string;
+    isAllDay?: boolean;
+    attendees?: Array<{
+        email: string;
+        displayName?: string;
+        optional?: boolean;
+    }>;
+}
+export interface AppleCalendarUpdateEventInput extends AppleCalendarEventInput {
+    eventId: string;
+}
+export interface AppleCalendarDeleteEventInput {
+    eventId: string;
+}
+export interface AppleCalendarPlugin {
+    checkPermissions(): Promise<AppleCalendarPermissionStatus>;
+    requestPermissions(): Promise<AppleCalendarPermissionStatus>;
+    listCalendars(): Promise<AppleCalendarListResult>;
+    listEvents(options: AppleCalendarListEventsOptions): Promise<AppleCalendarEventsResult>;
+    createEvent(input: AppleCalendarEventInput): Promise<AppleCalendarEventResult>;
+    updateEvent(input: AppleCalendarUpdateEventInput): Promise<AppleCalendarEventResult>;
+    deleteEvent(input: AppleCalendarDeleteEventInput): Promise<AppleCalendarBaseResult>;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/esm/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":""}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+import type { AppleCalendarPlugin } from "./definitions";
+export * from "./definitions";
+export * from "./macos-bridge-policy";
+export declare const AppleCalendar: AppleCalendarPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AAItC,eAAO,MAAM,aAAa,qBAKzB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+import { registerPlugin } from "@capacitor/core";
+export * from "./definitions";
+export * from "./macos-bridge-policy";
+const loadWeb = () => import("./web").then((m) => new m.AppleCalendarWeb());
+export const AppleCalendar = registerPlugin("AppleCalendar", {
+    web: loadWeb,
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AAEtC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CACzC,eAAe,EACf;IACE,GAAG,EAAE,OAAO;CACb,CACF,CAAC"}

package/dist/esm/macos-bridge-policy.d.ts

@@ -0,0 +1,9 @@
+export interface AppleCalendarMacosBridgeCandidate {
+    label: string;
+    path: string;
+}
+export declare const APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = "libMacWindowEffects.dylib";
+export declare function appleCalendarMacosBridgeCandidates(args?: {
+    envDylibPath?: string | null;
+}): AppleCalendarMacosBridgeCandidate[];
+//# sourceMappingURL=macos-bridge-policy.d.ts.map

package/dist/esm/macos-bridge-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos-bridge-policy.d.ts","sourceRoot":"","sources":["../../src/macos-bridge-policy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,0CAA0C,8BAC1B,CAAC;AAE9B,wBAAgB,kCAAkC,CAAC,IAAI,CAAC,EAAE;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,iCAAiC,EAAE,CAmBtC"}

package/dist/esm/macos-bridge-policy.js

@@ -0,0 +1,22 @@
+export const APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = "libMacWindowEffects.dylib";
+export function appleCalendarMacosBridgeCandidates(args) {
+    return [
+        {
+            label: "ELIZA_NATIVE_PERMISSIONS_DYLIB",
+            path: args?.envDylibPath ?? "",
+        },
+        {
+            label: "packaged Apple permissions bridge",
+            path: `../../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+        },
+        {
+            label: "packaged Apple permissions bridge",
+            path: `../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+        },
+        {
+            label: "local Apple permissions bridge",
+            path: `../../../../packages/app-core/platforms/electrobun/src/${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+        },
+    ].filter((candidate) => candidate.path.trim().length > 0);
+}
+//# sourceMappingURL=macos-bridge-policy.js.map

package/dist/esm/macos-bridge-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos-bridge-policy.js","sourceRoot":"","sources":["../../src/macos-bridge-policy.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,0CAA0C,GACrD,2BAA2B,CAAC;AAE9B,MAAM,UAAU,kCAAkC,CAAC,IAElD;IACC,OAAO;QACL;YACE,KAAK,EAAE,gCAAgC;YACvC,IAAI,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;SAC/B;QACD;YACE,KAAK,EAAE,mCAAmC;YAC1C,IAAI,EAAE,wBAAwB,0CAA0C,EAAE;SAC3E;QACD;YACE,KAAK,EAAE,mCAAmC;YAC1C,IAAI,EAAE,qBAAqB,0CAA0C,EAAE;SACxE;QACD;YACE,KAAK,EAAE,gCAAgC;YACvC,IAAI,EAAE,0DAA0D,0CAA0C,EAAE;SAC7G;KACF,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/esm/web.d.ts

@@ -0,0 +1,12 @@
+import { WebPlugin } from "@capacitor/core";
+import type { AppleCalendarBaseResult, AppleCalendarEventInput, AppleCalendarEventResult, AppleCalendarEventsResult, AppleCalendarListEventsOptions, AppleCalendarListResult, AppleCalendarPermissionStatus, AppleCalendarPlugin, AppleCalendarUpdateEventInput } from "./definitions";
+export declare class AppleCalendarWeb extends WebPlugin implements AppleCalendarPlugin {
+    checkPermissions(): Promise<AppleCalendarPermissionStatus>;
+    requestPermissions(): Promise<AppleCalendarPermissionStatus>;
+    listCalendars(): Promise<AppleCalendarListResult>;
+    listEvents(_options: AppleCalendarListEventsOptions): Promise<AppleCalendarEventsResult>;
+    createEvent(_input: AppleCalendarEventInput): Promise<AppleCalendarEventResult>;
+    updateEvent(_input: AppleCalendarUpdateEventInput): Promise<AppleCalendarEventResult>;
+    deleteEvent(_input: Parameters<AppleCalendarPlugin["deleteEvent"]>[0]): Promise<AppleCalendarBaseResult>;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/esm/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,uBAAuB,EACvB,6BAA6B,EAC7B,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AASvB,qBAAa,gBAAiB,SAAQ,SAAU,YAAW,mBAAmB;IACtE,gBAAgB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAQ1D,kBAAkB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAI5D,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAIjD,UAAU,CACd,QAAQ,EAAE,8BAA8B,GACvC,OAAO,CAAC,yBAAyB,CAAC;IAI/B,WAAW,CACf,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,wBAAwB,CAAC;IAI9B,WAAW,CACf,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAI9B,WAAW,CACf,MAAM,EAAE,UAAU,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GACxD,OAAO,CAAC,uBAAuB,CAAC;CAGpC"}

package/dist/esm/web.js

@@ -0,0 +1,34 @@
+import { WebPlugin } from "@capacitor/core";
+const unsupported = {
+    ok: false,
+    error: "not_supported",
+    message: "Apple Calendar is only available through the native iOS app or macOS desktop runtime.",
+};
+export class AppleCalendarWeb extends WebPlugin {
+    async checkPermissions() {
+        return {
+            calendar: "restricted",
+            canRequest: false,
+            reason: unsupported.message,
+        };
+    }
+    async requestPermissions() {
+        return this.checkPermissions();
+    }
+    async listCalendars() {
+        return { ...unsupported };
+    }
+    async listEvents(_options) {
+        return { ...unsupported };
+    }
+    async createEvent(_input) {
+        return { ...unsupported };
+    }
+    async updateEvent(_input) {
+        return { ...unsupported };
+    }
+    async deleteEvent(_input) {
+        return { ...unsupported };
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAa5C,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,eAAe;IACtB,OAAO,EACL,uFAAuF;CACjF,CAAC;AAEX,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,KAAK,CAAC,gBAAgB;QACpB,OAAO;YACL,QAAQ,EAAE,YAAY;YACtB,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,WAAW,CAAC,OAAO;SAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,UAAU,CACd,QAAwC;QAExC,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAA+B;QAE/B,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAqC;QAErC,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAyD;QAEzD,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/plugin.cjs.js

@@ -0,0 +1,73 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = "libMacWindowEffects.dylib";
+function appleCalendarMacosBridgeCandidates(args) {
+    return [
+        {
+            label: "ELIZA_NATIVE_PERMISSIONS_DYLIB",
+            path: args?.envDylibPath ?? "",
+        },
+        {
+            label: "packaged Apple permissions bridge",
+            path: `../../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+        },
+        {
+            label: "packaged Apple permissions bridge",
+            path: `../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+        },
+        {
+            label: "local Apple permissions bridge",
+            path: `../../../../packages/app-core/platforms/electrobun/src/${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+        },
+    ].filter((candidate) => candidate.path.trim().length > 0);
+}
+
+const loadWeb = () => Promise.resolve().then(function () { return web; }).then((m) => new m.AppleCalendarWeb());
+const AppleCalendar = core.registerPlugin("AppleCalendar", {
+    web: loadWeb,
+});
+
+const unsupported = {
+    ok: false,
+    error: "not_supported",
+    message: "Apple Calendar is only available through the native iOS app or macOS desktop runtime.",
+};
+class AppleCalendarWeb extends core.WebPlugin {
+    async checkPermissions() {
+        return {
+            calendar: "restricted",
+            canRequest: false,
+            reason: unsupported.message,
+        };
+    }
+    async requestPermissions() {
+        return this.checkPermissions();
+    }
+    async listCalendars() {
+        return { ...unsupported };
+    }
+    async listEvents(_options) {
+        return { ...unsupported };
+    }
+    async createEvent(_input) {
+        return { ...unsupported };
+    }
+    async updateEvent(_input) {
+        return { ...unsupported };
+    }
+    async deleteEvent(_input) {
+        return { ...unsupported };
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    AppleCalendarWeb: AppleCalendarWeb
+});
+
+exports.APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME;
+exports.AppleCalendar = AppleCalendar;
+exports.appleCalendarMacosBridgeCandidates = appleCalendarMacosBridgeCandidates;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/macos-bridge-policy.js","esm/index.js","esm/web.js"],"sourcesContent":["export const APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = \"libMacWindowEffects.dylib\";\nexport function appleCalendarMacosBridgeCandidates(args) {\n    return [\n        {\n            label: \"ELIZA_NATIVE_PERMISSIONS_DYLIB\",\n            path: args?.envDylibPath ?? \"\",\n        },\n        {\n            label: \"packaged Apple permissions bridge\",\n            path: `../../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,\n        },\n        {\n            label: \"packaged Apple permissions bridge\",\n            path: `../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,\n        },\n        {\n            label: \"local Apple permissions bridge\",\n            path: `../../../../packages/app-core/platforms/electrobun/src/${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,\n        },\n    ].filter((candidate) => candidate.path.trim().length > 0);\n}\n//# sourceMappingURL=macos-bridge-policy.js.map","import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nexport * from \"./macos-bridge-policy\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.AppleCalendarWeb());\nexport const AppleCalendar = registerPlugin(\"AppleCalendar\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nconst unsupported = {\n    ok: false,\n    error: \"not_supported\",\n    message: \"Apple Calendar is only available through the native iOS app or macOS desktop runtime.\",\n};\nexport class AppleCalendarWeb extends WebPlugin {\n    async checkPermissions() {\n        return {\n            calendar: \"restricted\",\n            canRequest: false,\n            reason: unsupported.message,\n        };\n    }\n    async requestPermissions() {\n        return this.checkPermissions();\n    }\n    async listCalendars() {\n        return { ...unsupported };\n    }\n    async listEvents(_options) {\n        return { ...unsupported };\n    }\n    async createEvent(_input) {\n        return { ...unsupported };\n    }\n    async updateEvent(_input) {\n        return { ...unsupported };\n    }\n    async deleteEvent(_input) {\n        return { ...unsupported };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AAAY,MAAC,0CAA0C,GAAG;AACnD,SAAS,kCAAkC,CAAC,IAAI,EAAE;AACzD,IAAI,OAAO;AACX,QAAQ;AACR,YAAY,KAAK,EAAE,gCAAgC;AACnD,YAAY,IAAI,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;AAC1C,SAAS;AACT,QAAQ;AACR,YAAY,KAAK,EAAE,mCAAmC;AACtD,YAAY,IAAI,EAAE,CAAC,qBAAqB,EAAE,0CAA0C,CAAC,CAAC;AACtF,SAAS;AACT,QAAQ;AACR,YAAY,KAAK,EAAE,mCAAmC;AACtD,YAAY,IAAI,EAAE,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAC;AACnF,SAAS;AACT,QAAQ;AACR,YAAY,KAAK,EAAE,gCAAgC;AACnD,YAAY,IAAI,EAAE,CAAC,uDAAuD,EAAE,0CAA0C,CAAC,CAAC;AACxH,SAAS;AACT,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7D;;ACjBA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAC/D,MAAC,aAAa,GAAGA,mBAAc,CAAC,eAAe,EAAE;AAC7D,IAAI,GAAG,EAAE,OAAO;AAChB,CAAC;;ACLD,MAAM,WAAW,GAAG;AACpB,IAAI,EAAE,EAAE,KAAK;AACb,IAAI,KAAK,EAAE,eAAe;AAC1B,IAAI,OAAO,EAAE,uFAAuF;AACpG,CAAC;AACM,MAAM,gBAAgB,SAASC,cAAS,CAAC;AAChD,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO;AACf,YAAY,QAAQ,EAAE,YAAY;AAClC,YAAY,UAAU,EAAE,KAAK;AAC7B,YAAY,MAAM,EAAE,WAAW,CAAC,OAAO;AACvC,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,kBAAkB,GAAG;AAC/B,QAAQ,OAAO,IAAI,CAAC,gBAAgB,EAAE;AACtC,IAAI;AACJ,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;AACjC,IAAI;AACJ,IAAI,MAAM,UAAU,CAAC,QAAQ,EAAE;AAC/B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;AACjC,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,MAAM,EAAE;AAC9B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;AACjC,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,MAAM,EAAE;AAC9B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;AACjC,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,MAAM,EAAE;AAC9B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;AACjC,IAAI;AACJ;;;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,76 @@
+var capacitorAppleCalendar = (function (exports, core) {
+    'use strict';
+
+    const APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = "libMacWindowEffects.dylib";
+    function appleCalendarMacosBridgeCandidates(args) {
+        return [
+            {
+                label: "ELIZA_NATIVE_PERMISSIONS_DYLIB",
+                path: args?.envDylibPath ?? "",
+            },
+            {
+                label: "packaged Apple permissions bridge",
+                path: `../../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+            },
+            {
+                label: "packaged Apple permissions bridge",
+                path: `../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+            },
+            {
+                label: "local Apple permissions bridge",
+                path: `../../../../packages/app-core/platforms/electrobun/src/${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,
+            },
+        ].filter((candidate) => candidate.path.trim().length > 0);
+    }
+
+    const loadWeb = () => Promise.resolve().then(function () { return web; }).then((m) => new m.AppleCalendarWeb());
+    const AppleCalendar = core.registerPlugin("AppleCalendar", {
+        web: loadWeb,
+    });
+
+    const unsupported = {
+        ok: false,
+        error: "not_supported",
+        message: "Apple Calendar is only available through the native iOS app or macOS desktop runtime.",
+    };
+    class AppleCalendarWeb extends core.WebPlugin {
+        async checkPermissions() {
+            return {
+                calendar: "restricted",
+                canRequest: false,
+                reason: unsupported.message,
+            };
+        }
+        async requestPermissions() {
+            return this.checkPermissions();
+        }
+        async listCalendars() {
+            return { ...unsupported };
+        }
+        async listEvents(_options) {
+            return { ...unsupported };
+        }
+        async createEvent(_input) {
+            return { ...unsupported };
+        }
+        async updateEvent(_input) {
+            return { ...unsupported };
+        }
+        async deleteEvent(_input) {
+            return { ...unsupported };
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        AppleCalendarWeb: AppleCalendarWeb
+    });
+
+    exports.APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME;
+    exports.AppleCalendar = AppleCalendar;
+    exports.appleCalendarMacosBridgeCandidates = appleCalendarMacosBridgeCandidates;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/macos-bridge-policy.js","esm/index.js","esm/web.js"],"sourcesContent":["export const APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME = \"libMacWindowEffects.dylib\";\nexport function appleCalendarMacosBridgeCandidates(args) {\n    return [\n        {\n            label: \"ELIZA_NATIVE_PERMISSIONS_DYLIB\",\n            path: args?.envDylibPath ?? \"\",\n        },\n        {\n            label: \"packaged Apple permissions bridge\",\n            path: `../../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,\n        },\n        {\n            label: \"packaged Apple permissions bridge\",\n            path: `../../../../../../${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,\n        },\n        {\n            label: \"local Apple permissions bridge\",\n            path: `../../../../packages/app-core/platforms/electrobun/src/${APPLE_CALENDAR_MACOS_BRIDGE_DYLIB_BASENAME}`,\n        },\n    ].filter((candidate) => candidate.path.trim().length > 0);\n}\n//# sourceMappingURL=macos-bridge-policy.js.map","import { registerPlugin } from \"@capacitor/core\";\nexport * from \"./definitions\";\nexport * from \"./macos-bridge-policy\";\nconst loadWeb = () => import(\"./web\").then((m) => new m.AppleCalendarWeb());\nexport const AppleCalendar = registerPlugin(\"AppleCalendar\", {\n    web: loadWeb,\n});\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nconst unsupported = {\n    ok: false,\n    error: \"not_supported\",\n    message: \"Apple Calendar is only available through the native iOS app or macOS desktop runtime.\",\n};\nexport class AppleCalendarWeb extends WebPlugin {\n    async checkPermissions() {\n        return {\n            calendar: \"restricted\",\n            canRequest: false,\n            reason: unsupported.message,\n        };\n    }\n    async requestPermissions() {\n        return this.checkPermissions();\n    }\n    async listCalendars() {\n        return { ...unsupported };\n    }\n    async listEvents(_options) {\n        return { ...unsupported };\n    }\n    async createEvent(_input) {\n        return { ...unsupported };\n    }\n    async updateEvent(_input) {\n        return { ...unsupported };\n    }\n    async deleteEvent(_input) {\n        return { ...unsupported };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AAAY,UAAC,0CAA0C,GAAG;IACnD,SAAS,kCAAkC,CAAC,IAAI,EAAE;IACzD,IAAI,OAAO;IACX,QAAQ;IACR,YAAY,KAAK,EAAE,gCAAgC;IACnD,YAAY,IAAI,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;IAC1C,SAAS;IACT,QAAQ;IACR,YAAY,KAAK,EAAE,mCAAmC;IACtD,YAAY,IAAI,EAAE,CAAC,qBAAqB,EAAE,0CAA0C,CAAC,CAAC;IACtF,SAAS;IACT,QAAQ;IACR,YAAY,KAAK,EAAE,mCAAmC;IACtD,YAAY,IAAI,EAAE,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAC;IACnF,SAAS;IACT,QAAQ;IACR,YAAY,KAAK,EAAE,gCAAgC;IACnD,YAAY,IAAI,EAAE,CAAC,uDAAuD,EAAE,0CAA0C,CAAC,CAAC;IACxH,SAAS;IACT,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7D;;ICjBA,MAAM,OAAO,GAAG,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAC/D,UAAC,aAAa,GAAGA,mBAAc,CAAC,eAAe,EAAE;IAC7D,IAAI,GAAG,EAAE,OAAO;IAChB,CAAC;;ICLD,MAAM,WAAW,GAAG;IACpB,IAAI,EAAE,EAAE,KAAK;IACb,IAAI,KAAK,EAAE,eAAe;IAC1B,IAAI,OAAO,EAAE,uFAAuF;IACpG,CAAC;IACM,MAAM,gBAAgB,SAASC,cAAS,CAAC;IAChD,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO;IACf,YAAY,QAAQ,EAAE,YAAY;IAClC,YAAY,UAAU,EAAE,KAAK;IAC7B,YAAY,MAAM,EAAE,WAAW,CAAC,OAAO;IACvC,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,OAAO,IAAI,CAAC,gBAAgB,EAAE;IACtC,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;IACjC,IAAI;IACJ,IAAI,MAAM,UAAU,CAAC,QAAQ,EAAE;IAC/B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;IACjC,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,MAAM,EAAE;IAC9B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;IACjC,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,MAAM,EAAE;IAC9B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;IACjC,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,MAAM,EAAE;IAC9B,QAAQ,OAAO,EAAE,GAAG,WAAW,EAAE;IACjC,IAAI;IACJ;;;;;;;;;;;;;;;;;"}

package/ios/Sources/CalendarPlugin/CalendarPlugin.swift

@@ -0,0 +1,560 @@
+import Foundation
+import Capacitor
+import EventKit
+import UIKit
+
+@objc(AppleCalendarPlugin)
+public class AppleCalendarPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "AppleCalendarPlugin"
+    public let jsName = "AppleCalendar"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "checkPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "listCalendars", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "listEvents", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "createEvent", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "updateEvent", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "deleteEvent", returnType: CAPPluginReturnPromise),
+    ]
+
+    private let eventStore = EKEventStore()
+    private let maxTitleLength = 512
+    private let maxDescriptionLength = 20000
+    private let maxLocationLength = 1024
+    private let unsupportedRecurrenceFields = [
+        "recurrence",
+        "recurrenceRule",
+        "recurrenceRules",
+        "rrule",
+    ]
+    private lazy var isoWithFractionalSeconds: ISO8601DateFormatter = {
+        let formatter = ISO8601DateFormatter()
+        formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+        return formatter
+    }()
+    private lazy var isoWithoutFractionalSeconds: ISO8601DateFormatter = {
+        let formatter = ISO8601DateFormatter()
+        formatter.formatOptions = [.withInternetDateTime]
+        return formatter
+    }()
+
+    @objc public override func checkPermissions(_ call: CAPPluginCall) {
+        call.resolve(permissionResult())
+    }
+
+    @objc public override func requestPermissions(_ call: CAPPluginCall) {
+        let status = EKEventStore.authorizationStatus(for: .event)
+        if isGranted(status) || isDeniedOrRestricted(status) {
+            call.resolve(permissionResult())
+            return
+        }
+
+        if #available(iOS 17.0, *) {
+            eventStore.requestFullAccessToEvents { [weak self] _, error in
+                DispatchQueue.main.async {
+                    var result = self?.permissionResult() ?? [
+                        "calendar": "restricted",
+                        "canRequest": false,
+                    ]
+                    if let error {
+                        result["reason"] = error.localizedDescription
+                    }
+                    call.resolve(result)
+                }
+            }
+        } else {
+            eventStore.requestAccess(to: .event) { [weak self] _, error in
+                DispatchQueue.main.async {
+                    var result = self?.permissionResult() ?? [
+                        "calendar": "restricted",
+                        "canRequest": false,
+                    ]
+                    if let error {
+                        result["reason"] = error.localizedDescription
+                    }
+                    call.resolve(result)
+                }
+            }
+        }
+    }
+
+    @objc func listCalendars(_ call: CAPPluginCall) {
+        guard hasFullAccess() else {
+            call.resolve(permissionError())
+            return
+        }
+        let defaultCalendar = eventStore.defaultCalendarForNewEvents
+        let calendars = eventStore.calendars(for: .event).map {
+            calendarJson($0, defaultCalendar: defaultCalendar)
+        }
+        call.resolve(["ok": true, "calendars": calendars])
+    }
+
+    @objc func listEvents(_ call: CAPPluginCall) {
+        guard hasFullAccess() else {
+            call.resolve(permissionError())
+            return
+        }
+        guard let timeMin = parseDate(call.getString("timeMin") ?? ""),
+              let timeMax = parseDate(call.getString("timeMax") ?? ""),
+              timeMax > timeMin
+        else {
+            call.resolve(nativeError("Calendar event window is invalid."))
+            return
+        }
+
+        let requestedCalendarId = (call.getString("calendarId") ?? "")
+            .trimmingCharacters(in: .whitespacesAndNewlines)
+        var calendars: [EKCalendar]? = nil
+        if !requestedCalendarId.isEmpty && requestedCalendarId != "all" {
+            guard let calendar = calendar(withIdentifier: requestedCalendarId, requireWritable: false) else {
+                call.resolve([
+                    "ok": false,
+                    "error": "not_found",
+                    "message": "Apple Calendar was not found.",
+                ])
+                return
+            }
+            calendars = [calendar]
+        }
+
+        let predicate = eventStore.predicateForEvents(
+            withStart: timeMin,
+            end: timeMax,
+            calendars: calendars
+        )
+        let events = eventStore.events(matching: predicate)
+            .sorted { $0.startDate < $1.startDate }
+            .map(eventJson)
+        call.resolve(["ok": true, "events": events])
+    }
+
+    @objc func createEvent(_ call: CAPPluginCall) {
+        guard hasFullAccess() else {
+            call.resolve(permissionError())
+            return
+        }
+        let event = EKEvent(eventStore: eventStore)
+        if let error = applyEventPayload(call, to: event, requireTitle: true) {
+            call.resolve(error)
+            return
+        }
+        do {
+            try eventStore.save(event, span: .thisEvent, commit: true)
+            call.resolve(["ok": true, "event": eventJson(event)])
+        } catch {
+            call.resolve(nativeError("Failed to create Apple Calendar event: \(error.localizedDescription)"))
+        }
+    }
+
+    @objc func updateEvent(_ call: CAPPluginCall) {
+        guard hasFullAccess() else {
+            call.resolve(permissionError())
+            return
+        }
+        guard let eventId = nonEmptyString(call.getString("eventId")) else {
+            call.resolve(nativeError("Calendar event id is required."))
+            return
+        }
+        guard let item = eventStore.calendarItem(withIdentifier: eventId) as? EKEvent else {
+            call.resolve([
+                "ok": false,
+                "error": "not_found",
+                "message": "Apple Calendar event was not found.",
+            ])
+            return
+        }
+        guard item.calendar.allowsContentModifications else {
+            call.resolve(nativeError("Apple Calendar event is not writable."))
+            return
+        }
+        if let error = applyEventPayload(call, to: item, requireTitle: false) {
+            call.resolve(error)
+            return
+        }
+        do {
+            try eventStore.save(item, span: .thisEvent, commit: true)
+            call.resolve(["ok": true, "event": eventJson(item)])
+        } catch {
+            call.resolve(nativeError("Failed to update Apple Calendar event: \(error.localizedDescription)"))
+        }
+    }
+
+    @objc func deleteEvent(_ call: CAPPluginCall) {
+        guard hasFullAccess() else {
+            call.resolve(permissionError())
+            return
+        }
+        guard let eventId = nonEmptyString(call.getString("eventId")) else {
+            call.resolve(nativeError("Calendar event id is required."))
+            return
+        }
+        guard let event = eventStore.calendarItem(withIdentifier: eventId) as? EKEvent else {
+            call.resolve([
+                "ok": false,
+                "error": "not_found",
+                "message": "Apple Calendar event was not found.",
+            ])
+            return
+        }
+        do {
+            try eventStore.remove(event, span: .thisEvent, commit: true)
+            call.resolve(["ok": true])
+        } catch {
+            call.resolve(nativeError("Failed to delete Apple Calendar event: \(error.localizedDescription)"))
+        }
+    }
+
+    private func permissionResult() -> [String: Any] {
+        let status = EKEventStore.authorizationStatus(for: .event)
+        return [
+            "calendar": permissionString(status),
+            "canRequest": permissionString(status) == "prompt",
+            "reason": NSNull(),
+        ]
+    }
+
+    private func permissionString(_ status: EKAuthorizationStatus) -> String {
+        if isGranted(status) {
+            return "granted"
+        }
+        if isDenied(status) {
+            return "denied"
+        }
+        if isRestricted(status) {
+            return "restricted"
+        }
+        return "prompt"
+    }
+
+    private func hasFullAccess() -> Bool {
+        isGranted(EKEventStore.authorizationStatus(for: .event))
+    }
+
+    private func isGranted(_ status: EKAuthorizationStatus) -> Bool {
+        if #available(iOS 17.0, *) {
+            if status == .fullAccess {
+                return true
+            }
+            if status == .writeOnly {
+                return false
+            }
+        }
+        return status == .authorized
+    }
+
+    private func isDenied(_ status: EKAuthorizationStatus) -> Bool {
+        status == .denied
+    }
+
+    private func isRestricted(_ status: EKAuthorizationStatus) -> Bool {
+        if #available(iOS 17.0, *), status == .writeOnly {
+            return true
+        }
+        return status == .restricted
+    }
+
+    private func isDeniedOrRestricted(_ status: EKAuthorizationStatus) -> Bool {
+        isDenied(status) || isRestricted(status)
+    }
+
+    private func permissionError() -> [String: Any] {
+        [
+            "ok": false,
+            "error": "permission",
+            "message": "Apple Calendar access has not been granted.",
+        ]
+    }
+
+    private func nativeError(_ message: String) -> [String: Any] {
+        [
+            "ok": false,
+            "error": "native_error",
+            "message": message,
+        ]
+    }
+
+    private func nonEmptyString(_ value: String?) -> String? {
+        guard let trimmed = value?.trimmingCharacters(in: .whitespacesAndNewlines),
+              !trimmed.isEmpty
+        else {
+            return nil
+        }
+        return trimmed
+    }
+
+    private func parseDate(_ value: String) -> Date? {
+        guard !value.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {
+            return nil
+        }
+        if let date = isoWithFractionalSeconds.date(from: value) {
+            return date
+        }
+        return isoWithoutFractionalSeconds.date(from: value)
+    }
+
+    private func textValue(
+        _ call: CAPPluginCall,
+        key: String,
+        maxLength: Int,
+        required: Bool
+    ) -> (value: String?, error: [String: Any]?) {
+        let rawValue = call.options[key]
+        if rawValue == nil || rawValue is NSNull {
+            if required {
+                return (nil, nativeError("Calendar event \(key) is required."))
+            }
+            return (nil, nil)
+        }
+        guard rawValue is String else {
+            return (nil, nativeError("Calendar event \(key) must be a string."))
+        }
+        guard let value = call.getString(key) else {
+            if required {
+                return (nil, nativeError("Calendar event \(key) is required."))
+            }
+            return (nil, nil)
+        }
+        guard value.count <= maxLength else {
+            return (nil, nativeError("Calendar event \(key) is too long."))
+        }
+        return (value, nil)
+    }
+
+    private func isoString(_ date: Date?) -> String {
+        guard let date else { return "" }
+        return isoWithFractionalSeconds.string(from: date)
+    }
+
+    private func calendar(withIdentifier identifier: String, requireWritable: Bool) -> EKCalendar? {
+        if identifier.isEmpty || identifier == "primary" {
+            if let calendar = eventStore.defaultCalendarForNewEvents,
+               !requireWritable || calendar.allowsContentModifications
+            {
+                return calendar
+            }
+            if requireWritable {
+                return eventStore.calendars(for: .event)
+                    .first(where: { $0.allowsContentModifications })
+            }
+            return eventStore.defaultCalendarForNewEvents
+        }
+        guard let calendar = eventStore.calendars(for: .event)
+            .first(where: { $0.calendarIdentifier == identifier })
+        else {
+            return nil
+        }
+        if requireWritable && !calendar.allowsContentModifications {
+            return nil
+        }
+        return calendar
+    }
+
+    private func calendarJson(_ calendar: EKCalendar, defaultCalendar: EKCalendar?) -> [String: Any] {
+        let color = UIColor(cgColor: calendar.cgColor)
+        let components = color.resolvedColor(with: UITraitCollection.current).cgColor.components ?? []
+        let red = components.indices.contains(0) ? components[0] : 0
+        let green = components.indices.contains(1) ? components[1] : red
+        let blue = components.indices.contains(2) ? components[2] : red
+        let hex = String(
+            format: "#%02X%02X%02X",
+            Int(max(0, min(1, red)) * 255),
+            Int(max(0, min(1, green)) * 255),
+            Int(max(0, min(1, blue)) * 255)
+        )
+        return [
+            "calendarId": calendar.calendarIdentifier,
+            "summary": calendar.title,
+            "description": calendar.source.title,
+            "primary": calendar.calendarIdentifier == defaultCalendar?.calendarIdentifier,
+            "accessRole": calendar.allowsContentModifications ? "writer" : "reader",
+            "backgroundColor": hex,
+            "foregroundColor": NSNull(),
+            "timeZone": TimeZone.current.identifier,
+            "selected": true,
+        ]
+    }
+
+    private func participantEmail(_ participant: EKParticipant) -> String? {
+        guard participant.url.scheme?.lowercased() == "mailto" else {
+            return nil
+        }
+        let raw = participant.url.absoluteString
+        let prefix = "mailto:"
+        guard raw.lowercased().hasPrefix(prefix) else {
+            return nil
+        }
+        let address = String(raw.dropFirst(prefix.count))
+        return address.removingPercentEncoding ?? address
+    }
+
+    private func participantStatus(_ status: EKParticipantStatus) -> String {
+        switch status {
+        case .unknown: return "unknown"
+        case .pending: return "pending"
+        case .accepted: return "accepted"
+        case .declined: return "declined"
+        case .tentative: return "tentative"
+        case .delegated: return "delegated"
+        case .completed: return "completed"
+        case .inProcess: return "in_process"
+        @unknown default: return "unknown"
+        }
+    }
+
+    private func participantJson(_ participant: EKParticipant) -> [String: Any] {
+        [
+            "email": participantEmail(participant) ?? NSNull(),
+            "displayName": participant.name ?? NSNull(),
+            "responseStatus": participantStatus(participant.participantStatus),
+            "self": participant.isCurrentUser,
+            "organizer": participant.participantRole == .chair,
+            "optional": participant.participantRole == .optional,
+        ]
+    }
+
+    private func eventStatus(_ status: EKEventStatus) -> String {
+        switch status {
+        case .none: return "none"
+        case .confirmed: return "confirmed"
+        case .tentative: return "tentative"
+        case .canceled: return "cancelled"
+        @unknown default: return "unknown"
+        }
+    }
+
+    private func eventJson(_ event: EKEvent) -> [String: Any] {
+        let identifier = event.calendarItemIdentifier
+        return [
+            "id": identifier,
+            "externalId": identifier,
+            "calendarId": event.calendar.calendarIdentifier,
+            "calendarSummary": event.calendar.title,
+            "title": event.title?.isEmpty == false ? event.title as Any : "(untitled)",
+            "description": event.notes ?? "",
+            "location": event.location ?? "",
+            "status": eventStatus(event.status),
+            "startAt": isoString(event.startDate),
+            "endAt": isoString(event.endDate),
+            "isAllDay": event.isAllDay,
+            "timezone": event.timeZone?.identifier ?? NSNull(),
+            "htmlLink": NSNull(),
+            "conferenceLink": NSNull(),
+            "organizer": event.organizer.map(participantJson) ?? NSNull(),
+            "attendees": event.attendees?.map(participantJson) ?? [],
+        ]
+    }
+
+    private func applyEventPayload(
+        _ call: CAPPluginCall,
+        to event: EKEvent,
+        requireTitle: Bool
+    ) -> [String: Any]? {
+        for key in unsupportedRecurrenceFields where call.options.keys.contains(key) {
+            return [
+                "ok": false,
+                "error": "unsupported_feature",
+                "message": "Apple Calendar recurrence editing is not supported by this bridge.",
+            ]
+        }
+
+        if call.options.keys.contains("attendees") {
+            guard let attendees = call.options["attendees"] as? [Any] else {
+                return nativeError("Calendar event attendees must be an array.")
+            }
+            if !attendees.isEmpty {
+                return [
+                    "ok": false,
+                    "error": "unsupported_feature",
+                    "message": "Apple Calendar does not allow this app to create or edit event invitees through EventKit. Remove attendees or use Google Calendar for invited meetings.",
+                ]
+            }
+        }
+
+        if call.options.keys.contains("title") || requireTitle {
+            let titleResult = textValue(
+                call,
+                key: "title",
+                maxLength: maxTitleLength,
+                required: true
+            )
+            if let error = titleResult.error {
+                return error
+            }
+            guard let title = nonEmptyString(titleResult.value) else {
+                return nativeError("Calendar event title is required.")
+            }
+            event.title = title
+        }
+        if call.options.keys.contains("description") {
+            let descriptionResult = textValue(
+                call,
+                key: "description",
+                maxLength: maxDescriptionLength,
+                required: false
+            )
+            if let error = descriptionResult.error {
+                return error
+            }
+            event.notes = descriptionResult.value
+        }
+        if call.options.keys.contains("location") {
+            let locationResult = textValue(
+                call,
+                key: "location",
+                maxLength: maxLocationLength,
+                required: false
+            )
+            if let error = locationResult.error {
+                return error
+            }
+            event.location = locationResult.value
+        }
+        if call.options.keys.contains("timeZone") {
+            guard let timeZoneName = nonEmptyString(call.getString("timeZone")) else {
+                return nativeError("Calendar event timeZone is invalid.")
+            }
+            guard let timeZone = TimeZone(identifier: timeZoneName) else {
+                return nativeError("Calendar event timeZone is invalid.")
+            }
+            event.timeZone = timeZone
+        }
+        if call.options.keys.contains("calendarId") {
+            guard let calendar = calendar(
+                withIdentifier: call.getString("calendarId") ?? "",
+                requireWritable: true
+            ) else {
+                return nativeError("The selected Apple Calendar is not writable or was not found.")
+            }
+            event.calendar = calendar
+        }
+        if call.options.keys.contains("isAllDay") {
+            event.isAllDay = call.getBool("isAllDay") ?? false
+        }
+        if call.options.keys.contains("startAt") {
+            guard let start = parseDate(call.getString("startAt") ?? "") else {
+                return nativeError("Calendar event startAt is invalid.")
+            }
+            event.startDate = start
+        }
+        if call.options.keys.contains("endAt") {
+            guard let end = parseDate(call.getString("endAt") ?? "") else {
+                return nativeError("Calendar event endAt is invalid.")
+            }
+            event.endDate = end
+        }
+        guard event.startDate != nil, event.endDate != nil else {
+            return nativeError("Calendar event startAt and endAt are required.")
+        }
+        guard event.endDate > event.startDate else {
+            return nativeError("Calendar event endAt must be later than startAt.")
+        }
+        if event.calendar == nil {
+            guard let calendar = calendar(withIdentifier: "primary", requireWritable: true) else {
+                return nativeError("No writable Apple Calendar is available.")
+            }
+            event.calendar = calendar
+        }
+        return nil
+    }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@elizaos/capacitor-calendar",
+  "version": "2.0.3-beta.2",
+  "description": "Reads and writes Apple Calendar events through EventKit.",
+  "keywords": [
+    "calendar",
+    "eventkit",
+    "ios",
+    "permissions"
+  ],
+  "main": "./dist/plugin.cjs.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "bun": "./src/index.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/plugin.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "dist/",
+    "ios/Sources/",
+    "*.podspec",
+    "dist"
+  ],
+  "author": "elizaOS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaOS/eliza.git"
+  },
+  "scripts": {
+    "build": "node ../../packages/scripts/with-package-build-lock.mjs plugins/plugin-native-calendar -- bun run build:unlocked",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
+    "test": "vitest run",
+    "prepublishOnly": "bun run build",
+    "build:unlocked": "bun run clean && tsc && bunx rollup -c rollup.config.mjs"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios",
+      "podName": "ElizaosCapacitorCalendar"
+    }
+  },
+  "devDependencies": {
+    "@capacitor/core": "^8.3.1",
+    "rollup": "^4.60.2",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^8.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "elizaos": {
+    "platforms": [
+      "browser",
+      "node"
+    ],
+    "runtime": "both",
+    "platformDetails": {
+      "browser": "Graceful unsupported fallback.",
+      "ios": true,
+      "node": "macOS uses the Electrobun EventKit dylib instead."
+    }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+}