@1kbirds/chidori-mock-google-calendar 0.1.0

package/README.md

@@ -0,0 +1,92 @@
+# @1kbirds/chidori-mock-google-calendar
+
+In-memory Google Calendar mock for agent testing. The package provides:
+
+- A deterministic in-memory service.
+- A googleapis-like SDK facade.
+- A lightweight REST-style Calendar API adapter.
+- A React UI for inspecting and editing mock calendar state.
+- Seed/reset utilities for repeatable tests.
+
+## Usage
+
+```ts
+import {
+  createGoogleCalendarClient,
+  createGoogleCalendarMock,
+  demoSeed,
+} from "@1kbirds/chidori-mock-google-calendar";
+
+const mock = createGoogleCalendarMock({
+  now: "2026-06-01T15:00:00.000Z",
+  seed: demoSeed,
+});
+
+const client = createGoogleCalendarClient(mock);
+
+await client.events.insert({
+  calendarId: "primary",
+  requestBody: {
+    summary: "Planning",
+    start: { dateTime: "2026-06-01T16:00:00.000Z" },
+    end: { dateTime: "2026-06-01T17:00:00.000Z" },
+  },
+});
+```
+
+## Supported Surface
+
+SDK-style methods:
+
+- `calendarList.list`
+- `calendarList.get`
+- `calendars.get`
+- `calendars.insert`
+- `calendars.update`
+- `calendars.delete`
+- `events.list`
+- `events.get`
+- `events.insert`
+- `events.update`
+- `events.patch`
+- `events.delete`
+- `freebusy.query`
+
+REST-style paths:
+
+- `GET /calendar/v3/users/me/calendarList`
+- `GET /calendar/v3/users/me/calendarList/:calendarId`
+- `POST /calendar/v3/calendars`
+- `GET|PUT|PATCH|DELETE /calendar/v3/calendars/:calendarId`
+- `GET|POST /calendar/v3/calendars/:calendarId/events`
+- `GET|PUT|PATCH|DELETE /calendar/v3/calendars/:calendarId/events/:eventId`
+- `POST /calendar/v3/freeBusy`
+
+## Review
+
+Run verification:
+
+```sh
+npm run build
+npm test
+```
+
+Start the React review app:
+
+```sh
+npm run dev:google-calendar
+```
+
+Then open `http://127.0.0.1:5173/`.
+
+Manual review should confirm:
+
+- Seeded calendars and events render.
+- UI-created events are visible through the service/client state.
+- API/client-created events render in the UI.
+- Event edit/delete changes affect event listing and free/busy output.
+- Reset restores deterministic seeded state.
+
+## Fidelity Notes
+
+The mock intentionally keeps state in memory only. It currently focuses on common calendar, event, list, and free/busy workflows. Complex recurrence expansion, notifications, conference data, OAuth, incremental sync, push notifications, and quota simulation are not implemented yet.

package/dist/api.d.ts

@@ -0,0 +1,14 @@
+import type { GoogleCalendarMock } from "./service";
+export interface MockApiRequest {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+}
+export interface MockApiResponse<T = unknown> {
+    status: number;
+    headers: Record<string, string>;
+    body?: T;
+}
+export declare function handleGoogleCalendarApiRequest(mock: GoogleCalendarMock, request: MockApiRequest): MockApiResponse;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,cAAc,GAAG,eAAe,CAqFjH"}

package/dist/api.js

@@ -0,0 +1,102 @@
+export function handleGoogleCalendarApiRequest(mock, request) {
+    const path = normalizePath(request.path);
+    const query = request.query ?? {};
+    if (request.method === "GET" && path === "/calendar/v3/users/me/calendarList") {
+        return json(200, mock.listCalendarList());
+    }
+    const calendarListMatch = path.match(/^\/calendar\/v3\/users\/me\/calendarList\/([^/]+)$/);
+    if (request.method === "GET" && calendarListMatch) {
+        return json(200, mock.getCalendarListEntry(decodeURIComponent(calendarListMatch[1])));
+    }
+    if (request.method === "POST" && path === "/calendar/v3/calendars") {
+        return json(200, mock.insertCalendar(request.body));
+    }
+    const calendarMatch = path.match(/^\/calendar\/v3\/calendars\/([^/]+)$/);
+    if (calendarMatch) {
+        const calendarId = decodeURIComponent(calendarMatch[1]);
+        if (request.method === "GET") {
+            return json(200, mock.getCalendar(calendarId));
+        }
+        if (request.method === "PUT" || request.method === "PATCH") {
+            return json(200, mock.updateCalendar(calendarId, request.body));
+        }
+        if (request.method === "DELETE") {
+            mock.deleteCalendar(calendarId);
+            return { status: 204, headers: {} };
+        }
+    }
+    const eventsMatch = path.match(/^\/calendar\/v3\/calendars\/([^/]+)\/events$/);
+    if (eventsMatch) {
+        const calendarId = decodeURIComponent(eventsMatch[1]);
+        if (request.method === "GET") {
+            return json(200, mock.listEvents({
+                calendarId,
+                timeMin: stringQuery(query.timeMin),
+                timeMax: stringQuery(query.timeMax),
+                q: stringQuery(query.q),
+                showDeleted: booleanQuery(query.showDeleted),
+                singleEvents: booleanQuery(query.singleEvents),
+                orderBy: query.orderBy === "updated" ? "updated" : query.orderBy === "startTime" ? "startTime" : undefined,
+                maxResults: numberQuery(query.maxResults),
+            }));
+        }
+        if (request.method === "POST") {
+            return json(200, mock.insertEvent(calendarId, request.body));
+        }
+    }
+    const eventMatch = path.match(/^\/calendar\/v3\/calendars\/([^/]+)\/events\/([^/]+)$/);
+    if (eventMatch) {
+        const calendarId = decodeURIComponent(eventMatch[1]);
+        const eventId = decodeURIComponent(eventMatch[2]);
+        if (request.method === "GET") {
+            return json(200, mock.getEvent(calendarId, eventId));
+        }
+        if (request.method === "PUT") {
+            return json(200, mock.updateEvent(calendarId, eventId, request.body));
+        }
+        if (request.method === "PATCH") {
+            return json(200, mock.patchEvent(calendarId, eventId, request.body));
+        }
+        if (request.method === "DELETE") {
+            mock.deleteEvent(calendarId, eventId);
+            return { status: 204, headers: {} };
+        }
+    }
+    if (request.method === "POST" && path === "/calendar/v3/freeBusy") {
+        return json(200, mock.queryFreeBusy(request.body));
+    }
+    return json(404, {
+        error: {
+            code: 404,
+            message: `Unsupported mock endpoint: ${request.method} ${request.path}`,
+            errors: [{ domain: "global", reason: "notFound", message: "Unsupported mock endpoint" }],
+        },
+    });
+}
+function normalizePath(path) {
+    const url = new URL(path, "https://mock.local");
+    return url.pathname.replace(/\/+$/, "");
+}
+function json(status, body) {
+    return {
+        status,
+        headers: { "content-type": "application/json" },
+        body,
+    };
+}
+function stringQuery(value) {
+    return value === undefined ? undefined : String(value);
+}
+function booleanQuery(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return value === true || value === "true";
+}
+function numberQuery(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+import type { GoogleCalendarMock } from "./service";
+import type { CalendarEvent, CalendarResource, EventsListParams, FreeBusyRequest, GoogleApiResponse } from "./types";
+export declare function createGoogleCalendarClient(mock: GoogleCalendarMock): {
+    calendarList: {
+        list: () => Promise<GoogleApiResponse<import("./types").ListResponse<import("./types").CalendarListEntry>>>;
+        get: ({ calendarId }: {
+            calendarId: string;
+        }) => Promise<GoogleApiResponse<import("./types").CalendarListEntry>>;
+    };
+    calendars: {
+        get: ({ calendarId }: {
+            calendarId: string;
+        }) => Promise<GoogleApiResponse<CalendarResource>>;
+        insert: ({ requestBody }: {
+            requestBody: Partial<CalendarResource>;
+        }) => Promise<GoogleApiResponse<CalendarResource>>;
+        update: ({ calendarId, requestBody }: {
+            calendarId: string;
+            requestBody: Partial<CalendarResource>;
+        }) => Promise<GoogleApiResponse<CalendarResource>>;
+        delete: ({ calendarId }: {
+            calendarId: string;
+        }) => Promise<GoogleApiResponse<undefined>>;
+    };
+    events: {
+        list: (params: EventsListParams) => Promise<GoogleApiResponse<import("./types").ListResponse<CalendarEvent>>>;
+        get: ({ calendarId, eventId }: {
+            calendarId: string;
+            eventId: string;
+        }) => Promise<GoogleApiResponse<CalendarEvent>>;
+        insert: ({ calendarId, requestBody }: {
+            calendarId: string;
+            requestBody: Partial<CalendarEvent>;
+        }) => Promise<GoogleApiResponse<CalendarEvent>>;
+        update: ({ calendarId, eventId, requestBody }: {
+            calendarId: string;
+            eventId: string;
+            requestBody: Partial<CalendarEvent>;
+        }) => Promise<GoogleApiResponse<CalendarEvent>>;
+        patch: ({ calendarId, eventId, requestBody }: {
+            calendarId: string;
+            eventId: string;
+            requestBody: Partial<CalendarEvent>;
+        }) => Promise<GoogleApiResponse<CalendarEvent>>;
+        delete: ({ calendarId, eventId }: {
+            calendarId: string;
+            eventId: string;
+        }) => Promise<GoogleApiResponse<undefined>>;
+    };
+    freebusy: {
+        query: ({ requestBody }: {
+            requestBody: FreeBusyRequest;
+        }) => Promise<GoogleApiResponse<import("./types").FreeBusyResponse>>;
+    };
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAWjB,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB;;;8BAIjC;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE;;;8BAGtB;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE;kCAClB;YAAE,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;SAAE;8CAC9B;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;SAAE;iCAE3E;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE;;;uBAMhC,gBAAgB;uCACA;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE;8CAChC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;SAAE;uDAElD;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;SAAE;sDAE7E;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;SAAE;0CAExF;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE;;;iCAMhD;YAAE,WAAW,EAAE,eAAe,CAAA;SAAE;;EAGpE"}

package/dist/client.js

@@ -0,0 +1,39 @@
+function response(data, status = 200, statusText = "OK") {
+    return {
+        data,
+        status,
+        statusText,
+        headers: {},
+    };
+}
+export function createGoogleCalendarClient(mock) {
+    return {
+        calendarList: {
+            list: async () => response(mock.listCalendarList()),
+            get: async ({ calendarId }) => response(mock.getCalendarListEntry(calendarId)),
+        },
+        calendars: {
+            get: async ({ calendarId }) => response(mock.getCalendar(calendarId)),
+            insert: async ({ requestBody }) => response(mock.insertCalendar(requestBody)),
+            update: async ({ calendarId, requestBody }) => response(mock.updateCalendar(calendarId, requestBody)),
+            delete: async ({ calendarId }) => {
+                mock.deleteCalendar(calendarId);
+                return response(undefined, 204, "No Content");
+            },
+        },
+        events: {
+            list: async (params) => response(mock.listEvents(params)),
+            get: async ({ calendarId, eventId }) => response(mock.getEvent(calendarId, eventId)),
+            insert: async ({ calendarId, requestBody }) => response(mock.insertEvent(calendarId, requestBody)),
+            update: async ({ calendarId, eventId, requestBody }) => response(mock.updateEvent(calendarId, eventId, requestBody)),
+            patch: async ({ calendarId, eventId, requestBody }) => response(mock.patchEvent(calendarId, eventId, requestBody)),
+            delete: async ({ calendarId, eventId }) => {
+                mock.deleteEvent(calendarId, eventId);
+                return response(undefined, 204, "No Content");
+            },
+        },
+        freebusy: {
+            query: async ({ requestBody }) => response(mock.queryFreeBusy(requestBody)),
+        },
+    };
+}

package/dist/errors.d.ts

@@ -0,0 +1,24 @@
+export declare class GoogleCalendarMockError extends Error {
+    readonly status: number;
+    readonly reason: string;
+    readonly errors: Array<{
+        domain: string;
+        reason: string;
+        message: string;
+    }>;
+    constructor(status: number, reason: string, message: string);
+    toJSON(): {
+        error: {
+            code: number;
+            message: string;
+            errors: {
+                domain: string;
+                reason: string;
+                message: string;
+            }[];
+        };
+    };
+}
+export declare function notFound(message: string): GoogleCalendarMockError;
+export declare function badRequest(message: string): GoogleCalendarMockError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAEhE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQ3D,MAAM;;;;;wBAV2B,MAAM;wBAAU,MAAM;yBAAW,MAAM;;;;CAmBzE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAEjE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAEnE"}

package/dist/errors.js

@@ -0,0 +1,27 @@
+export class GoogleCalendarMockError extends Error {
+    status;
+    reason;
+    errors;
+    constructor(status, reason, message) {
+        super(message);
+        this.name = "GoogleCalendarMockError";
+        this.status = status;
+        this.reason = reason;
+        this.errors = [{ domain: "global", reason, message }];
+    }
+    toJSON() {
+        return {
+            error: {
+                code: this.status,
+                message: this.message,
+                errors: this.errors,
+            },
+        };
+    }
+}
+export function notFound(message) {
+    return new GoogleCalendarMockError(404, "notFound", message);
+}
+export function badRequest(message) {
+    return new GoogleCalendarMockError(400, "badRequest", message);
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { handleGoogleCalendarApiRequest } from "./api";
+export type { MockApiRequest, MockApiResponse } from "./api";
+export { createGoogleCalendarClient } from "./client";
+export { GoogleCalendarMockError } from "./errors";
+export { GoogleCalendarMock } from "./service";
+import { GoogleCalendarMock } from "./service";
+export { demoCalendars, demoEvents, demoSeed, demoUser, resetGoogleCalendarMock, seedGoogleCalendarState } from "./seed";
+export type * from "./types";
+export declare function createGoogleCalendarMock(...args: ConstructorParameters<typeof GoogleCalendarMock>): GoogleCalendarMock;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,OAAO,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACzH,mBAAmB,SAAS,CAAC;AAE7B,wBAAgB,wBAAwB,CAAC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,kBAAkB,CAAC,GAAG,kBAAkB,CAEtH"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { handleGoogleCalendarApiRequest } from "./api";
+export { createGoogleCalendarClient } from "./client";
+export { GoogleCalendarMockError } from "./errors";
+export { GoogleCalendarMock } from "./service";
+import { GoogleCalendarMock } from "./service";
+export { demoCalendars, demoEvents, demoSeed, demoUser, resetGoogleCalendarMock, seedGoogleCalendarState } from "./seed";
+export function createGoogleCalendarMock(...args) {
+    return new GoogleCalendarMock(...args);
+}

package/dist/seed.d.ts

@@ -0,0 +1,9 @@
+import type { GoogleCalendarMock } from "./service";
+import type { CalendarEvent, CalendarListEntry, GoogleCalendarSeed, MockUser } from "./types";
+export declare const demoUser: MockUser;
+export declare const demoCalendars: CalendarListEntry[];
+export declare const demoEvents: Record<string, CalendarEvent[]>;
+export declare const demoSeed: GoogleCalendarSeed;
+export declare function seedGoogleCalendarState(mock: GoogleCalendarMock, seed?: GoogleCalendarSeed): void;
+export declare function resetGoogleCalendarMock(mock: GoogleCalendarMock): void;
+//# sourceMappingURL=seed.d.ts.map

package/dist/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9F,eAAO,MAAM,QAAQ,EAAE,QAKtB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,iBAAiB,EAyB5C,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CA4CtD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,kBAKtB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,GAAE,kBAA6B,GAAG,IAAI,CAO3G;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAEtE"}

package/dist/seed.js

@@ -0,0 +1,94 @@
+export const demoUser = {
+    id: "user_ada",
+    email: "ada@example.com",
+    displayName: "Ada Lovelace",
+    defaultCalendarId: "primary",
+};
+export const demoCalendars = [
+    {
+        kind: "calendar#calendarListEntry",
+        etag: "\"primary:seed\"",
+        id: "primary",
+        summary: "ada@example.com",
+        timeZone: "America/Los_Angeles",
+        primary: true,
+        selected: true,
+        backgroundColor: "#1a73e8",
+        foregroundColor: "#ffffff",
+        accessRole: "owner",
+    },
+    {
+        kind: "calendar#calendarListEntry",
+        etag: "\"team:seed\"",
+        id: "team",
+        summary: "Team Calendar",
+        description: "Shared team events",
+        timeZone: "America/Los_Angeles",
+        selected: true,
+        backgroundColor: "#0b8043",
+        foregroundColor: "#ffffff",
+        accessRole: "writer",
+    },
+];
+export const demoEvents = {
+    primary: [
+        {
+            kind: "calendar#event",
+            etag: "\"event_planning:seed\"",
+            id: "event_planning",
+            status: "confirmed",
+            htmlLink: "https://calendar.google.com/calendar/event?eid=event_planning",
+            created: "2026-06-01T15:00:00.000Z",
+            updated: "2026-06-01T15:00:00.000Z",
+            summary: "Product planning",
+            description: "Draft launch plan",
+            location: "Conference Room A",
+            creator: { email: "ada@example.com", displayName: "Ada Lovelace", self: true },
+            organizer: { email: "ada@example.com", displayName: "Ada Lovelace", self: true },
+            start: { dateTime: "2026-06-01T16:00:00.000Z", timeZone: "America/Los_Angeles" },
+            end: { dateTime: "2026-06-01T17:00:00.000Z", timeZone: "America/Los_Angeles" },
+            attendees: [{ email: "grace@example.com", displayName: "Grace Hopper", responseStatus: "accepted" }],
+            transparency: "opaque",
+            visibility: "default",
+            iCalUID: "event_planning@chidori-mock.local",
+            sequence: 0,
+        },
+    ],
+    team: [
+        {
+            kind: "calendar#event",
+            etag: "\"event_standup:seed\"",
+            id: "event_standup",
+            status: "confirmed",
+            htmlLink: "https://calendar.google.com/calendar/event?eid=event_standup",
+            created: "2026-06-01T15:00:00.000Z",
+            updated: "2026-06-01T15:00:00.000Z",
+            summary: "Team standup",
+            creator: { email: "ada@example.com", displayName: "Ada Lovelace", self: true },
+            organizer: { email: "team@example.com", displayName: "Team Calendar" },
+            start: { dateTime: "2026-06-02T16:30:00.000Z", timeZone: "America/Los_Angeles" },
+            end: { dateTime: "2026-06-02T17:00:00.000Z", timeZone: "America/Los_Angeles" },
+            transparency: "opaque",
+            visibility: "default",
+            iCalUID: "event_standup@chidori-mock.local",
+            sequence: 0,
+        },
+    ],
+};
+export const demoSeed = {
+    users: [demoUser],
+    calendars: demoCalendars,
+    events: demoEvents,
+    currentUserId: demoUser.id,
+};
+export function seedGoogleCalendarState(mock, seed = demoSeed) {
+    mock.reset({
+        users: seed.users ?? [],
+        calendars: seed.calendars ?? [],
+        events: seed.events ?? {},
+        currentUserId: seed.currentUserId ?? seed.users?.[0]?.id ?? "user_ada",
+    });
+}
+export function resetGoogleCalendarMock(mock) {
+    mock.reset();
+}

package/dist/service.d.ts

@@ -0,0 +1,28 @@
+import { type GoogleCalendarMockStore } from "./state";
+import type { CalendarEvent, CalendarListEntry, CalendarResource, EventsListParams, FreeBusyRequest, FreeBusyResponse, GoogleCalendarMockOptions, GoogleCalendarMockStateSnapshot, ListResponse, MockUser } from "./types";
+export declare class GoogleCalendarMock {
+    readonly store: GoogleCalendarMockStore;
+    private readonly initialSnapshot;
+    constructor(options?: GoogleCalendarMockOptions);
+    get currentUser(): MockUser;
+    subscribe(listener: () => void): () => void;
+    snapshot(): GoogleCalendarMockStateSnapshot;
+    reset(seed?: GoogleCalendarMockStateSnapshot): void;
+    listCalendarList(): ListResponse<CalendarListEntry>;
+    getCalendarListEntry(calendarId: string): CalendarListEntry;
+    getCalendar(calendarId: string): CalendarResource;
+    insertCalendar(input: Partial<CalendarResource>): CalendarResource;
+    updateCalendar(calendarId: string, input: Partial<CalendarResource>): CalendarResource;
+    deleteCalendar(calendarId: string): void;
+    listEvents(params: EventsListParams): ListResponse<CalendarEvent>;
+    getEvent(calendarId: string, eventId: string): CalendarEvent;
+    insertEvent(calendarId: string, input: Partial<CalendarEvent>): CalendarEvent;
+    updateEvent(calendarId: string, eventId: string, input: Partial<CalendarEvent>): CalendarEvent;
+    patchEvent(calendarId: string, eventId: string, patch: Partial<CalendarEvent>): CalendarEvent;
+    deleteEvent(calendarId: string, eventId: string): void;
+    queryFreeBusy(request: FreeBusyRequest): FreeBusyResponse;
+    private requireCalendar;
+    private requireEventMap;
+    private requireEvent;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,EAA+D,KAAK,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACpH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAEhB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,+BAA+B,EAC/B,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;gBAEtD,OAAO,GAAE,yBAA8B;IAKnD,IAAI,WAAW,IAAI,QAAQ,CAM1B;IAED,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAK3C,QAAQ,IAAI,+BAA+B;IAI3C,KAAK,CAAC,IAAI,CAAC,EAAE,+BAA+B,GAAG,IAAI;IAInD,gBAAgB,IAAI,YAAY,CAAC,iBAAiB,CAAC;IAQnD,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAI3D,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAIjD,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;IA4BlE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;IAkBtF,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAUxC,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAAC,aAAa,CAAC;IAsBjE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IAI5D,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;IA2C7E,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;IAmC9F,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa;IAgB7F,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMtD,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB;IAoCzD,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,YAAY;CAOrB"}