@corsair-dev/googlecalendar 0.1.0

package/dist/schema/index.d.ts

@@ -0,0 +1,335 @@
+export declare const GoogleCalendarSchema: {
+    readonly version: "1.0.0";
+    readonly entities: {
+        readonly events: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            status: import("zod").ZodOptional<import("zod").ZodEnum<["confirmed", "tentative", "cancelled"]>>;
+            htmlLink: import("zod").ZodOptional<import("zod").ZodString>;
+            created: import("zod").ZodOptional<import("zod").ZodString>;
+            updated: import("zod").ZodOptional<import("zod").ZodString>;
+            summary: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            location: import("zod").ZodOptional<import("zod").ZodString>;
+            colorId: import("zod").ZodOptional<import("zod").ZodString>;
+            creator: import("zod").ZodOptional<import("zod").ZodObject<{
+                id: import("zod").ZodOptional<import("zod").ZodString>;
+                email: import("zod").ZodOptional<import("zod").ZodString>;
+                displayName: import("zod").ZodOptional<import("zod").ZodString>;
+                self: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            }, "strip", import("zod").ZodTypeAny, {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            }, {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            }>>;
+            organizer: import("zod").ZodOptional<import("zod").ZodObject<{
+                id: import("zod").ZodOptional<import("zod").ZodString>;
+                email: import("zod").ZodOptional<import("zod").ZodString>;
+                displayName: import("zod").ZodOptional<import("zod").ZodString>;
+                self: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            }, "strip", import("zod").ZodTypeAny, {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            }, {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            }>>;
+            start: import("zod").ZodOptional<import("zod").ZodObject<{
+                date: import("zod").ZodOptional<import("zod").ZodString>;
+                dateTime: import("zod").ZodOptional<import("zod").ZodString>;
+                timeZone: import("zod").ZodOptional<import("zod").ZodString>;
+            }, "strip", import("zod").ZodTypeAny, {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            }, {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            }>>;
+            end: import("zod").ZodOptional<import("zod").ZodObject<{
+                date: import("zod").ZodOptional<import("zod").ZodString>;
+                dateTime: import("zod").ZodOptional<import("zod").ZodString>;
+                timeZone: import("zod").ZodOptional<import("zod").ZodString>;
+            }, "strip", import("zod").ZodTypeAny, {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            }, {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            }>>;
+            endTimeUnspecified: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            recurrence: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+            recurringEventId: import("zod").ZodOptional<import("zod").ZodString>;
+            originalStartTime: import("zod").ZodOptional<import("zod").ZodObject<{
+                date: import("zod").ZodOptional<import("zod").ZodString>;
+                dateTime: import("zod").ZodOptional<import("zod").ZodString>;
+                timeZone: import("zod").ZodOptional<import("zod").ZodString>;
+            }, "strip", import("zod").ZodTypeAny, {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            }, {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            }>>;
+            transparency: import("zod").ZodOptional<import("zod").ZodEnum<["opaque", "transparent"]>>;
+            visibility: import("zod").ZodOptional<import("zod").ZodEnum<["default", "public", "private", "confidential"]>>;
+            iCalUID: import("zod").ZodOptional<import("zod").ZodString>;
+            sequence: import("zod").ZodOptional<import("zod").ZodNumber>;
+            attendees: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodOptional<import("zod").ZodString>;
+                email: import("zod").ZodOptional<import("zod").ZodString>;
+                displayName: import("zod").ZodOptional<import("zod").ZodString>;
+                organizer: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                self: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                resource: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                optional: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                responseStatus: import("zod").ZodOptional<import("zod").ZodEnum<["needsAction", "declined", "tentative", "accepted"]>>;
+                comment: import("zod").ZodOptional<import("zod").ZodString>;
+                additionalGuests: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, "strip", import("zod").ZodTypeAny, {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                organizer?: boolean | undefined;
+                self?: boolean | undefined;
+                resource?: boolean | undefined;
+                optional?: boolean | undefined;
+                responseStatus?: "needsAction" | "declined" | "tentative" | "accepted" | undefined;
+                comment?: string | undefined;
+                additionalGuests?: number | undefined;
+            }, {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                organizer?: boolean | undefined;
+                self?: boolean | undefined;
+                resource?: boolean | undefined;
+                optional?: boolean | undefined;
+                responseStatus?: "needsAction" | "declined" | "tentative" | "accepted" | undefined;
+                comment?: string | undefined;
+                additionalGuests?: number | undefined;
+            }>, "many">>;
+            attendeesOmitted: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            hangoutLink: import("zod").ZodOptional<import("zod").ZodString>;
+            reminders: import("zod").ZodOptional<import("zod").ZodObject<{
+                useDefault: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                overrides: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    method: import("zod").ZodOptional<import("zod").ZodEnum<["email", "popup"]>>;
+                    minutes: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, "strip", import("zod").ZodTypeAny, {
+                    method?: "email" | "popup" | undefined;
+                    minutes?: number | undefined;
+                }, {
+                    method?: "email" | "popup" | undefined;
+                    minutes?: number | undefined;
+                }>, "many">>;
+            }, "strip", import("zod").ZodTypeAny, {
+                useDefault?: boolean | undefined;
+                overrides?: {
+                    method?: "email" | "popup" | undefined;
+                    minutes?: number | undefined;
+                }[] | undefined;
+            }, {
+                useDefault?: boolean | undefined;
+                overrides?: {
+                    method?: "email" | "popup" | undefined;
+                    minutes?: number | undefined;
+                }[] | undefined;
+            }>>;
+            anyoneCanAddSelf: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            guestsCanInviteOthers: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            guestsCanModify: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            guestsCanSeeOtherGuests: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            privateCopy: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            locked: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            eventType: import("zod").ZodOptional<import("zod").ZodEnum<["default", "outOfOffice", "focusTime", "workingLocation"]>>;
+            calendarId: import("zod").ZodOptional<import("zod").ZodString>;
+            createdAt: import("zod").ZodOptional<import("zod").ZodDate>;
+        }, "strip", import("zod").ZodTypeAny, {
+            id: string;
+            location?: string | undefined;
+            status?: "tentative" | "confirmed" | "cancelled" | undefined;
+            start?: {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            } | undefined;
+            end?: {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            } | undefined;
+            description?: string | undefined;
+            organizer?: {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            } | undefined;
+            summary?: string | undefined;
+            attendees?: {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                organizer?: boolean | undefined;
+                self?: boolean | undefined;
+                resource?: boolean | undefined;
+                optional?: boolean | undefined;
+                responseStatus?: "needsAction" | "declined" | "tentative" | "accepted" | undefined;
+                comment?: string | undefined;
+                additionalGuests?: number | undefined;
+            }[] | undefined;
+            recurrence?: string[] | undefined;
+            colorId?: string | undefined;
+            transparency?: "opaque" | "transparent" | undefined;
+            visibility?: "default" | "public" | "private" | "confidential" | undefined;
+            eventType?: "default" | "outOfOffice" | "focusTime" | "workingLocation" | undefined;
+            reminders?: {
+                useDefault?: boolean | undefined;
+                overrides?: {
+                    method?: "email" | "popup" | undefined;
+                    minutes?: number | undefined;
+                }[] | undefined;
+            } | undefined;
+            guestsCanModify?: boolean | undefined;
+            guestsCanInviteOthers?: boolean | undefined;
+            guestsCanSeeOtherGuests?: boolean | undefined;
+            anyoneCanAddSelf?: boolean | undefined;
+            sequence?: number | undefined;
+            originalStartTime?: {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            } | undefined;
+            recurringEventId?: string | undefined;
+            calendarId?: string | undefined;
+            updated?: string | undefined;
+            iCalUID?: string | undefined;
+            htmlLink?: string | undefined;
+            created?: string | undefined;
+            creator?: {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            } | undefined;
+            endTimeUnspecified?: boolean | undefined;
+            attendeesOmitted?: boolean | undefined;
+            hangoutLink?: string | undefined;
+            privateCopy?: boolean | undefined;
+            locked?: boolean | undefined;
+            createdAt?: Date | undefined;
+        }, {
+            id: string;
+            location?: string | undefined;
+            status?: "tentative" | "confirmed" | "cancelled" | undefined;
+            start?: {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            } | undefined;
+            end?: {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            } | undefined;
+            description?: string | undefined;
+            organizer?: {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            } | undefined;
+            summary?: string | undefined;
+            attendees?: {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                organizer?: boolean | undefined;
+                self?: boolean | undefined;
+                resource?: boolean | undefined;
+                optional?: boolean | undefined;
+                responseStatus?: "needsAction" | "declined" | "tentative" | "accepted" | undefined;
+                comment?: string | undefined;
+                additionalGuests?: number | undefined;
+            }[] | undefined;
+            recurrence?: string[] | undefined;
+            colorId?: string | undefined;
+            transparency?: "opaque" | "transparent" | undefined;
+            visibility?: "default" | "public" | "private" | "confidential" | undefined;
+            eventType?: "default" | "outOfOffice" | "focusTime" | "workingLocation" | undefined;
+            reminders?: {
+                useDefault?: boolean | undefined;
+                overrides?: {
+                    method?: "email" | "popup" | undefined;
+                    minutes?: number | undefined;
+                }[] | undefined;
+            } | undefined;
+            guestsCanModify?: boolean | undefined;
+            guestsCanInviteOthers?: boolean | undefined;
+            guestsCanSeeOtherGuests?: boolean | undefined;
+            anyoneCanAddSelf?: boolean | undefined;
+            sequence?: number | undefined;
+            originalStartTime?: {
+                date?: string | undefined;
+                dateTime?: string | undefined;
+                timeZone?: string | undefined;
+            } | undefined;
+            recurringEventId?: string | undefined;
+            calendarId?: string | undefined;
+            updated?: string | undefined;
+            iCalUID?: string | undefined;
+            htmlLink?: string | undefined;
+            created?: string | undefined;
+            creator?: {
+                id?: string | undefined;
+                email?: string | undefined;
+                displayName?: string | undefined;
+                self?: boolean | undefined;
+            } | undefined;
+            endTimeUnspecified?: boolean | undefined;
+            attendeesOmitted?: boolean | undefined;
+            hangoutLink?: string | undefined;
+            privateCopy?: boolean | undefined;
+            locked?: boolean | undefined;
+            createdAt?: Date | undefined;
+        }>;
+        readonly calendars: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            summary: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            location: import("zod").ZodOptional<import("zod").ZodString>;
+            timeZone: import("zod").ZodOptional<import("zod").ZodString>;
+            createdAt: import("zod").ZodOptional<import("zod").ZodDate>;
+        }, "strip", import("zod").ZodTypeAny, {
+            id: string;
+            location?: string | undefined;
+            description?: string | undefined;
+            timeZone?: string | undefined;
+            summary?: string | undefined;
+            createdAt?: Date | undefined;
+        }, {
+            id: string;
+            location?: string | undefined;
+            description?: string | undefined;
+            timeZone?: string | undefined;
+            summary?: string | undefined;
+            createdAt?: Date | undefined;
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../schema/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMvB,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Setup guide for the Google Calendar plugin.
+ *
+ * This string is read by the Corsair setup agent at runtime to walk a developer
+ * through configuring the integration. It is NOT intended for human readers —
+ * the agent interprets the instructions and asks the user one step at a time.
+ */
+export declare const GoogleCalendarSetup = "\n## Google Calendar OAuth2 Setup\n\nGoogle Calendar uses OAuth2 and requires 4 credentials:\n- **client_id** + **client_secret** (integration-level, shared) \u2014 from your GCP OAuth app\n- **access_token** + **refresh_token** (account-level) \u2014 from the OAuth flow\n\nWalk the user through these steps exactly, one at a time:\n\n---\n\n### Step 1: Check for an existing GCP project\n\nask_human: \"Do you already have a Google Cloud Platform project you'd like to use, or should we create a new one?\"\n\n- If yes \u2192 go to Step 2.\n- If no \u2192 tell them:\n  1. Go to https://console.cloud.google.com\n  2. Click the project dropdown at the top \u2192 \"New Project\"\n  3. Name it (e.g., \"Corsair\") and click \"Create\"\n  ask_human: \"Let me know once your GCP project is ready!\"\n\n---\n\n### Step 2: Enable the Google Calendar API\n\nTell them:\n- In GCP Console, go to \"APIs & Services\" \u2192 \"Library\" (left sidebar)\n- Search for \"Google Calendar API\" \u2192 click it \u2192 click \"Enable\"\n\nask_human: \"Done enabling the Google Calendar API? Let me know!\"\n\n---\n\n### Step 3: Configure the OAuth Consent Screen\n\nAsk first: \"Have you already set up an OAuth consent screen for this GCP project?\"\n\nIf not, tell them:\n- Go to \"APIs & Services\" \u2192 \"OAuth consent screen\"\n- Choose \"External\" \u2192 click \"Create\"\n- Fill in:\n  - App name: anything (e.g., \"Corsair\")\n  - User support email: their Google email\n  - Developer contact: their email\n- Click \"Save and Continue\"\n- On Scopes \u2192 click \"Add or Remove Scopes\" \u2192 search \"calendar\" \u2192 select: https://www.googleapis.com/auth/calendar \u2192 click \"Update\" \u2192 \"Save and Continue\"\n- On Test Users \u2192 click \"Add Users\" \u2192 add their Google email \u2192 \"Save and Continue\"\n\nask_human: \"Done with the OAuth consent screen? Let me know!\"\n\n---\n\n### Step 4: Create OAuth 2.0 Credentials\n\nTell them:\n- Go to \"APIs & Services\" \u2192 \"Credentials\"\n- Click \"+ Create Credentials\" \u2192 \"OAuth client ID\"\n- Application type: **Web application**\n- Name: anything (e.g., \"Corsair Calendar\")\n- Under \"Authorized redirect URIs\" \u2192 click \"+ Add URI\" \u2192 add:\n  `https://developers.google.com/oauthplayground`\n- Click \"Create\"\n- A popup shows the **Client ID** and **Client Secret** \u2014 copy both\n\nask_human: \"Have you got your Client ID and Client Secret? Let me know!\"\n\n---\n\n### Step 5: Enter Client ID and Client Secret\n\nCall get_setup_url for plugin=\"googlecalendar\" (no field \u2014 shows all fields).\nSend the message: \"Enter your Client ID and Client Secret at this URL: {URL}. Look for the 'OAuth2 Client ID' and 'OAuth2 Client Secret' fields.\"\n\nask_human: \"Let me know when you've saved the Client ID and Client Secret!\"\n\nThen call verify_setup. If client_id and client_secret are both set, move on. If not, send the URL again with a note to double-check.\n\n---\n\n### Step 6: Get Access Token and Refresh Token (OAuth Playground)\n\nTell them:\n1. Go to https://developers.google.com/oauthplayground/\n2. Click the **gear icon (\u2699\uFE0F)** top right \u2192 check \"Use your own OAuth credentials\"\n3. Enter your Client ID and Client Secret \u2192 close the settings panel\n4. In the left panel, scroll to \"Google Calendar API v3\"\n5. Check the scope: `https://www.googleapis.com/auth/calendar`\n6. Click \"Authorize APIs\" \u2192 sign in with Google \u2192 click \"Allow\"\n7. On Step 2: click the blue \"Exchange authorization code for tokens\" button\n8. In the JSON response on the right, copy:\n   - `access_token`\n   - `refresh_token`\n\nask_human: \"Let me know when you have both tokens!\"\n\n---\n\n### Step 7: Enter Access Token and Refresh Token\n\nCall get_setup_url for plugin=\"googlecalendar\".\nSend: \"Enter your Access Token and Refresh Token at this URL: {URL}\"\n\nask_human: \"Let me know when you've saved both tokens!\"\n\nThen call verify_setup. If all 4 fields (client_id, client_secret, access_token, refresh_token) are set, the plugin is ready!\n\n---\n\n### Step 8: Webhook Setup (Optional)\n\nTell them: \"Google Calendar is now connected! Would you like to set up webhooks so Corsair can trigger automations when your calendar events change? This requires a public HTTPS URL for your Corsair server, which we'll help you set up.\"\n\nask_human: \"Do you want to set up webhooks? Reply 'yes' or 'no'.\"\n\nIf no \u2192 call finish_setup with \"Google Calendar is all set! You can now create, read, update, and delete calendar events from Corsair.\"\n\nIf yes \u2192 proceed to Step 9.\n\n---\n\n### Step 9: Get a Public Webhook URL\n\nask_human: \"Do you already have a public HTTPS URL for this Corsair server (e.g. from Railway, Render, Vercel, or a VPS)? If so, reply with the base URL. If not, reply 'no' and I'll help you set up ngrok.\"\n\nIf they provide a URL: the webhook endpoint is `{their-url}/api/webhook`. Go to Step 11.\n\nIf 'no' \u2192 Step 10: ngrok setup.\n\n---\n\n### Step 10: Set Up ngrok\n\nTell them: \"We'll use ngrok to create a temporary public URL that tunnels to your local Corsair server. It takes about 2 minutes to set up.\"\n\n**Install ngrok** (if not already):\n- Mac: `brew install ngrok`\n- Or download from https://ngrok.com/download\n- Or: `npm install -g ngrok`\n\nask_human: \"Do you have ngrok installed? Run `which ngrok` to check. Reply 'yes' or 'no'.\"\n\nIf no: give them the install command for their OS. ask_human: \"Let me know once ngrok is installed!\"\n\n**Authenticate ngrok:**\nTell them:\n1. Sign up (free) at https://ngrok.com\n2. Go to https://dashboard.ngrok.com/get-started/your-authtoken\n3. Copy your auth token\n4. Run: `ngrok config add-authtoken YOUR_TOKEN_HERE`\n\nask_human: \"Done adding your ngrok auth token? Let me know!\"\n\n**Start the tunnel:**\nTell them: \"Now run this in a separate terminal (keep it open while using webhooks):\"\n```\nngrok http 3001\n```\n\"Copy the Forwarding URL that looks like `https://abc123.ngrok-free.app`\"\n\nask_human: \"What's the HTTPS forwarding URL from ngrok? (e.g. https://abc123.ngrok-free.app)\"\n\nThe webhook URL will be: `{their-ngrok-url}/api/webhook`\n\n---\n\n### Step 11: Create the Calendar Watch Channel\n\nNow run the watch setup script. The webhook URL is `{url-from-step-9-or-10}/api/webhook`.\n\nRun this from alongside their package.json to ensure imports will be correctly linked.\n\nUse run_script with this TypeScript code (fill in the actual webhook URL and calendar ID):\n\n```typescript\nimport * as crypto from 'node:crypto';\n\nimport * as crypto from 'node:crypto';\nimport { corsair } from './server/corsair';\n\nconst main = async () => {\n\tconst getClientId = corsair.keys.googlecalendar.get_client_id;\n\tconst getClientSecret = corsair.keys.googlecalendar.get_client_secret;\n\tconst getRefreshToken = corsair.googlecalendar.keys.get_refresh_token;\n\n\tconst [clientId, clientSecret, refreshToken] = await Promise.all([\n\t\tgetClientId(),\n\t\tgetClientSecret(),\n\t\tgetRefreshToken(),\n\t]);\n\n\tif (!clientId || !clientSecret || !refreshToken) {\n\t\tconsole.error(\n\t\t\t'Missing credentials \u2014 please complete credential setup first.',\n\t\t);\n\t\tprocess.exit(1);\n\t}\n\n\t// Refresh access token\n\tconst tokenRes = await fetch('https://oauth2.googleapis.com/token', {\n\t\tmethod: 'POST',\n\t\theaders: { 'Content-Type': 'application/x-www-form-urlencoded' },\n\t\tbody: new URLSearchParams({\n\t\t\tclient_id: clientId,\n\t\t\tclient_secret: clientSecret,\n\t\t\trefresh_token: refreshToken,\n\t\t\tgrant_type: 'refresh_token',\n\t\t}),\n\t});\n\n\tif (!tokenRes.ok) {\n\t\tconst err = await tokenRes.text();\n\t\tconsole.error('Token refresh failed:', err);\n\t\tprocess.exit(1);\n\t}\n\n\tconst { access_token } = (await tokenRes.json()) as { access_token: string };\n\n\t// Create the watch channel\n\tconst channelId = crypto.randomUUID();\n\tconst WEBHOOK_URL = 'REPLACE_WITH_WEBHOOK_URL'; // e.g. https://abc123.ngrok-free.app/api/webhook\n\tconst CALENDAR_ID = 'primary'; // or specific calendar ID\n\n\tconst watchRes = await fetch(\n\t\t'https://www.googleapis.com/calendar/v3/calendars/' +\n\t\t\tencodeURIComponent(CALENDAR_ID) +\n\t\t\t'/events/watch',\n\t\t{\n\t\t\tmethod: 'POST',\n\t\t\theaders: {\n\t\t\t\tAuthorization: 'Bearer ' + access_token,\n\t\t\t\t'Content-Type': 'application/json',\n\t\t\t},\n\t\t\tbody: JSON.stringify({\n\t\t\t\tid: channelId,\n\t\t\t\ttype: 'web_hook',\n\t\t\t\taddress: WEBHOOK_URL,\n\t\t\t}),\n\t\t},\n\t);\n\n\tif (!watchRes.ok) {\n\t\tconst err = await watchRes.text();\n\t\tconsole.error('Calendar watch failed:', err);\n\t\tprocess.exit(1);\n\t}\n\n\tconst data = (await watchRes.json()) as {\n\t\tid: string;\n\t\tresourceId: string;\n\t\texpiration: string;\n\t};\n\n\tconst expiration = new Date(Number(data.expiration)).toISOString();\n\tconsole.log('Watch channel created!');\n\tconsole.log('Channel ID:', channelId);\n\tconsole.log('Resource ID:', data.resourceId);\n\tconsole.log('Expiration:', expiration);\n\tconsole.log('');\n\tconsole.log('IMPORTANT: This watch channel expires on', expiration);\n\tconsole.log('To renew it, re-run this setup step before it expires.');\n};\n\nmain().catch((e: Error) => {\n  console.error(e.message);\n  process.exit(1);\n});\n```\n\nReplace REPLACE_WITH_WEBHOOK_URL with the actual URL and run_script it. Report the output (Channel ID, Resource ID, Expiration) to the user.\n\nThen call finish_setup with a message like: \"Google Calendar is fully set up with webhooks! Channel expires on {date} \u2014 you can re-run this setup step to renew it when needed.\"\n";
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,68SAgR/B,CAAC"}

package/dist/tsup.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("tsup").Options | import("tsup").Options[] | ((overrideOptions: import("tsup").Options) => import("tsup").Options | import("tsup").Options[] | Promise<import("tsup").Options | import("tsup").Options[]>);
+export default _default;
+//# sourceMappingURL=tsup.config.d.ts.map

package/dist/tsup.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsup.config.d.ts","sourceRoot":"","sources":["../tsup.config.ts"],"names":[],"mappings":";AAEA,wBAYG"}

package/dist/types.d.ts

@@ -0,0 +1,182 @@
+export type EventDateTime = {
+    date?: string;
+    dateTime?: string;
+    timeZone?: string;
+};
+export type Attendee = {
+    id?: string;
+    email?: string;
+    displayName?: string;
+    organizer?: boolean;
+    self?: boolean;
+    resource?: boolean;
+    optional?: boolean;
+    responseStatus?: 'needsAction' | 'declined' | 'tentative' | 'accepted';
+    comment?: string;
+    additionalGuests?: number;
+};
+export type Organizer = {
+    id?: string;
+    email?: string;
+    displayName?: string;
+    self?: boolean;
+};
+export type Reminder = {
+    method?: 'email' | 'popup';
+    minutes?: number;
+};
+export type EventReminders = {
+    useDefault?: boolean;
+    overrides?: Reminder[];
+};
+export type ConferenceData = {
+    createRequest?: {
+        requestId?: string;
+        conferenceSolutionKey?: {
+            type?: string;
+        };
+        status?: {
+            statusCode?: string;
+        };
+    };
+    entryPoints?: Array<{
+        entryPointType?: string;
+        uri?: string;
+        label?: string;
+        pin?: string;
+        accessCode?: string;
+        meetingCode?: string;
+        passcode?: string;
+        password?: string;
+    }>;
+    conferenceSolution?: {
+        key?: {
+            type?: string;
+        };
+        name?: string;
+        iconUri?: string;
+    };
+    conferenceId?: string;
+    signature?: string;
+    notes?: string;
+};
+export type Event = {
+    id?: string;
+    status?: 'confirmed' | 'tentative' | 'cancelled';
+    htmlLink?: string;
+    created?: string;
+    updated?: string;
+    summary?: string;
+    description?: string;
+    location?: string;
+    colorId?: string;
+    creator?: Organizer;
+    organizer?: Organizer;
+    start?: EventDateTime;
+    end?: EventDateTime;
+    endTimeUnspecified?: boolean;
+    recurrence?: string[];
+    recurringEventId?: string;
+    originalStartTime?: EventDateTime;
+    transparency?: 'opaque' | 'transparent';
+    visibility?: 'default' | 'public' | 'private' | 'confidential';
+    iCalUID?: string;
+    sequence?: number;
+    attendees?: Attendee[];
+    attendeesOmitted?: boolean;
+    hangoutLink?: string;
+    conferenceData?: ConferenceData;
+    gadget?: {
+        type?: string;
+        title?: string;
+        link?: string;
+        iconLink?: string;
+        width?: number;
+        height?: number;
+        display?: string;
+        preferences?: Record<string, string>;
+    };
+    anyoneCanAddSelf?: boolean;
+    guestsCanInviteOthers?: boolean;
+    guestsCanModify?: boolean;
+    guestsCanSeeOtherGuests?: boolean;
+    privateCopy?: boolean;
+    locked?: boolean;
+    reminders?: EventReminders;
+    source?: {
+        url?: string;
+        title?: string;
+    };
+    attachments?: Array<{
+        fileUrl?: string;
+        title?: string;
+        mimeType?: string;
+        iconLink?: string;
+        fileId?: string;
+    }>;
+    eventType?: 'default' | 'outOfOffice' | 'focusTime' | 'workingLocation';
+};
+export type EventListResponse = {
+    kind?: string;
+    etag?: string;
+    summary?: string;
+    description?: string;
+    updated?: string;
+    timeZone?: string;
+    accessRole?: string;
+    defaultReminders?: Reminder[];
+    nextPageToken?: string;
+    nextSyncToken?: string;
+    items?: Event[];
+};
+export type FreeBusyRequest = {
+    timeMin: string;
+    timeMax: string;
+    timeZone?: string;
+    groupExpansionMax?: number;
+    calendarExpansionMax?: number;
+    items?: Array<{
+        id: string;
+    }>;
+};
+export type FreeBusyCalendar = {
+    busy?: Array<{
+        start?: string;
+        end?: string;
+    }>;
+    errors?: Array<{
+        domain?: string;
+        reason?: string;
+    }>;
+};
+export type FreeBusyResponse = {
+    kind?: string;
+    calendars?: Record<string, FreeBusyCalendar>;
+    groups?: Record<string, {
+        calendars?: string[];
+        errors?: Array<{
+            domain?: string;
+            reason?: string;
+        }>;
+    }>;
+    timeMin?: string;
+    timeMax?: string;
+};
+export type Calendar = {
+    id?: string;
+    summary?: string;
+    description?: string;
+    location?: string;
+    timeZone?: string;
+    conferenceProperties?: {
+        allowedConferenceSolutionTypes?: string[];
+    };
+};
+export type CalendarListResponse = {
+    kind?: string;
+    etag?: string;
+    nextPageToken?: string;
+    nextSyncToken?: string;
+    items?: Calendar[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/webhooks/events.d.ts

@@ -0,0 +1,3 @@
+import type { GoogleCalendarWebhooks } from '..';
+export declare const onEventChanged: GoogleCalendarWebhooks['onEventChanged'];
+//# sourceMappingURL=events.d.ts.map

package/dist/webhooks/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../webhooks/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,IAAI,CAAC;AA2HjD,eAAO,MAAM,cAAc,EAAE,sBAAsB,CAAC,gBAAgB,CAiHnE,CAAC"}

package/dist/webhooks/index.d.ts

@@ -0,0 +1,38 @@
+export declare const EventWebhooks: {
+    onEventChanged: {
+        match: import("corsair/core").CorsairWebhookMatcher;
+        handler: import("corsair/core").CorsairWebhookHandler<import("..").GoogleCalendarContext, import("./types").GoogleCalendarWebhookPayload<{
+            type: "eventCreated";
+            calendarId: string;
+            event: import("..").Event;
+            timestamp: string;
+        } | {
+            type: "eventUpdated";
+            calendarId: string;
+            event: import("..").Event;
+            timestamp: string;
+        } | {
+            type: "eventDeleted";
+            calendarId: string;
+            timestamp: string;
+            eventId: string;
+        }>, {
+            type: "eventCreated";
+            calendarId: string;
+            event: import("..").Event;
+            timestamp: string;
+        } | {
+            type: "eventUpdated";
+            calendarId: string;
+            event: import("..").Event;
+            timestamp: string;
+        } | {
+            type: "eventDeleted";
+            calendarId: string;
+            timestamp: string;
+            eventId: string;
+        }>;
+    };
+};
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../webhooks/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAEzB,CAAC;AAEF,cAAc,SAAS,CAAC"}