@automate.ax/integration-contracts 0.55.0

package/dist/google-calendar/event-schemas.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+export declare const GOOGLE_CALENDAR_EVENT_DELETED_SCHEMA: z.ZodObject<{
+    calendarId: z.ZodString;
+    event: z.ZodOptional<z.ZodObject<{
+        attachments: z.ZodArray<z.ZodObject<{
+            fileId: z.ZodOptional<z.ZodString>;
+            fileUrl: z.ZodURL;
+            mimeType: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            iconLink: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        attendees: z.ZodArray<z.ZodObject<{
+            additionalGuests: z.ZodOptional<z.ZodNumber>;
+            comment: z.ZodOptional<z.ZodString>;
+            email: z.ZodEmail;
+            displayName: z.ZodOptional<z.ZodString>;
+            optional: z.ZodOptional<z.ZodBoolean>;
+            resource: z.ZodOptional<z.ZodBoolean>;
+            responseStatus: z.ZodOptional<z.ZodEnum<{
+                tentative: "tentative";
+                needsAction: "needsAction";
+                declined: "declined";
+                accepted: "accepted";
+            }>>;
+            organizer: z.ZodBoolean;
+            self: z.ZodBoolean;
+        }, z.core.$strip>>;
+        calendarId: z.ZodString;
+        colorId: z.ZodOptional<z.ZodString>;
+        conference: z.ZodOptional<z.ZodObject<{
+            conferenceId: z.ZodOptional<z.ZodString>;
+            creationStatus: z.ZodOptional<z.ZodEnum<{
+                success: "success";
+                pending: "pending";
+                failure: "failure";
+            }>>;
+            entryPoints: z.ZodArray<z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                passcode: z.ZodOptional<z.ZodString>;
+                type: z.ZodString;
+                uri: z.ZodString;
+            }, z.core.$strip>>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        creator: z.ZodOptional<z.ZodObject<{
+            displayName: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            self: z.ZodBoolean;
+        }, z.core.$strip>>;
+        description: z.ZodOptional<z.ZodString>;
+        end: z.ZodOptional<z.ZodObject<{
+            date: z.ZodOptional<z.ZodISODate>;
+            dateTime: z.ZodOptional<z.ZodString>;
+            timeZone: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        extendedProperties: z.ZodObject<{
+            private: z.ZodRecord<z.ZodString, z.ZodString>;
+            shared: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>;
+        guestsCanInviteOthers: z.ZodBoolean;
+        guestsCanModify: z.ZodBoolean;
+        guestsCanSeeOtherGuests: z.ZodBoolean;
+        hangoutLink: z.ZodOptional<z.ZodString>;
+        htmlLink: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        iCalUID: z.ZodOptional<z.ZodString>;
+        location: z.ZodOptional<z.ZodString>;
+        originalStart: z.ZodOptional<z.ZodObject<{
+            date: z.ZodOptional<z.ZodISODate>;
+            dateTime: z.ZodOptional<z.ZodString>;
+            timeZone: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        organizer: z.ZodOptional<z.ZodObject<{
+            displayName: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            self: z.ZodBoolean;
+        }, z.core.$strip>>;
+        recurrence: z.ZodArray<z.ZodString>;
+        recurringEventId: z.ZodOptional<z.ZodString>;
+        reminders: z.ZodObject<{
+            overrides: z.ZodArray<z.ZodObject<{
+                minutes: z.ZodNumber;
+                method: z.ZodEnum<{
+                    email: "email";
+                    popup: "popup";
+                }>;
+            }, z.core.$strip>>;
+            useDefault: z.ZodBoolean;
+        }, z.core.$strip>;
+        sequence: z.ZodNumber;
+        start: z.ZodOptional<z.ZodObject<{
+            date: z.ZodOptional<z.ZodISODate>;
+            dateTime: z.ZodOptional<z.ZodString>;
+            timeZone: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        status: z.ZodEnum<{
+            confirmed: "confirmed";
+            tentative: "tentative";
+            cancelled: "cancelled";
+        }>;
+        summary: z.ZodString;
+        transparency: z.ZodEnum<{
+            opaque: "opaque";
+            transparent: "transparent";
+        }>;
+        type: z.ZodString;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        visibility: z.ZodEnum<{
+            default: "default";
+            public: "public";
+            private: "private";
+            confidential: "confidential";
+        }>;
+    }, z.core.$strip>>;
+    eventId: z.ZodString;
+}, z.core.$strip>;

package/dist/google-calendar/event-schemas.js

@@ -0,0 +1,13 @@
+import { CALENDAR_EVENT_SCHEMA } from "./schemas.js";
+import { z } from "zod";
+export const GOOGLE_CALENDAR_EVENT_DELETED_SCHEMA = z.object({
+    /** Calendar that previously contained the event. */
+    calendarId: z.string(),
+    /**
+     * Last normalized event representation, when the event existed in the
+     * synchronization baseline.
+     */
+    event: CALENDAR_EVENT_SCHEMA.optional(),
+    /** Immutable provider event ID. */
+    eventId: z.string(),
+});

package/dist/google-calendar/google-calendar.d.ts

@@ -0,0 +1,147 @@
+import { type calendar_v3 } from "@googleapis/calendar";
+import { z } from "zod";
+import { ACL_PAGE_SCHEMA, ACL_RULE_SCHEMA, CALENDAR_EVENT_SCHEMA, CALENDAR_PAGE_SCHEMA, CALENDAR_SCHEMA, COLOR_PALETTE_SCHEMA, EVENT_PAGE_SCHEMA, EVENT_DETAILS_INPUT_SCHEMA, EVENT_SCHEDULE_INPUT_SCHEMA, FREE_BUSY_SCHEMA } from "./schemas.js";
+/**
+ * Creates the official Calendar client from a resolved Google integration
+ * secret.
+ *
+ * @param secret - Refreshed Google integration secret.
+ */
+export declare function getGoogleCalendarApi(secret: Record<string, unknown>): calendar_v3.Calendar;
+/**
+ * Resolves an exact calendar title or ID to the provider's canonical ID.
+ *
+ * Unknown references are returned unchanged so email-address and otherwise
+ * unlisted calendar IDs remain usable.
+ *
+ * @param calendarApi - Authenticated Google Calendar client.
+ * @param reference - Calendar title or ID, defaulting to `primary`.
+ */
+export declare function resolveCalendarId(calendarApi: calendar_v3.Calendar, reference?: string): Promise<string>;
+/**
+ * Resolves multiple exact calendar titles or IDs with one paginated listing.
+ *
+ * Unknown references are returned unchanged so email-address and otherwise
+ * unlisted calendar IDs remain usable.
+ *
+ * @param calendarApi - Authenticated Google Calendar client.
+ * @param references - Calendar titles or IDs, with absent values as primary.
+ */
+export declare function resolveCalendarIds(calendarApi: calendar_v3.Calendar, references: (string | undefined)[]): Promise<string[]>;
+/**
+ * Resolves one calendar reference against an already fetched calendar list.
+ *
+ * @param calendars - Visible Google Calendar list entries.
+ * @param reference - Calendar title or ID, defaulting to primary.
+ * @throws When the calendar title matches more than one visible calendar.
+ */
+export declare function resolveCalendarReference(calendars: calendar_v3.Schema$CalendarListEntry[], reference?: string): string;
+/**
+ * Accepts a raw event ID or a standard Google Calendar event URL.
+ *
+ * @param event - Event ID or URL.
+ * @throws When a URL is not a recognizable Google Calendar event URL.
+ */
+export declare function normalizeEventId(event: string): string;
+/**
+ * Converts an ergonomic timed or all-day schedule to Calendar API date-times.
+ *
+ * @param schedule - Timed or all-day event schedule.
+ */
+export declare function toEventDateTimes(schedule: z.infer<typeof EVENT_SCHEDULE_INPUT_SCHEMA>): {
+    end: {
+        date: string;
+        dateTime?: undefined;
+        timeZone?: undefined;
+    };
+    start: {
+        date: string;
+        dateTime?: undefined;
+        timeZone?: undefined;
+    };
+} | {
+    end: {
+        dateTime: string;
+        timeZone: string | undefined;
+        date?: undefined;
+    };
+    start: {
+        dateTime: string;
+        timeZone: string | undefined;
+        date?: undefined;
+    };
+};
+/**
+ * Normalizes a provider event into the stable public Calendar event shape.
+ *
+ * @param event - Provider event.
+ * @param calendarId - Calendar from which the event was read.
+ * @throws When the provider omits the event ID.
+ */
+export declare function normalizeCalendarEvent(event: calendar_v3.Schema$Event, calendarId: string): z.infer<typeof CALENDAR_EVENT_SCHEMA>;
+/**
+ * Normalizes a provider event page while retaining pagination and sync tokens.
+ *
+ * @param events - Provider event collection.
+ * @param calendarId - Calendar from which events were read.
+ */
+export declare function normalizeEventPage(events: calendar_v3.Schema$Events, calendarId: string): z.infer<typeof EVENT_PAGE_SCHEMA>;
+/**
+ * Normalizes a calendar or calendar-list entry.
+ *
+ * @param value - Provider calendar metadata.
+ * @param id - Calendar ID when not included in the provider resource.
+ * @throws When neither the resource nor caller supplies a calendar ID.
+ */
+export declare function normalizeCalendar(value: calendar_v3.Schema$Calendar | calendar_v3.Schema$CalendarListEntry, id?: string): z.infer<typeof CALENDAR_SCHEMA>;
+/**
+ * Normalizes a provider calendar-list page.
+ *
+ * @param value - Provider calendar-list collection.
+ */
+export declare function normalizeCalendarPage(value: calendar_v3.Schema$CalendarList): z.infer<typeof CALENDAR_PAGE_SCHEMA>;
+/**
+ * Normalizes a provider free/busy response.
+ *
+ * @param value - Provider free/busy response.
+ * @throws When the provider omits the requested time range.
+ */
+export declare function normalizeFreeBusy(value: calendar_v3.Schema$FreeBusyResponse): z.infer<typeof FREE_BUSY_SCHEMA>;
+/**
+ * Normalizes Google Calendar color definitions.
+ *
+ * @param value - Provider color palette.
+ */
+export declare function normalizeColors(value: calendar_v3.Schema$Colors): z.infer<typeof COLOR_PALETTE_SCHEMA>;
+/**
+ * Normalizes one calendar ACL rule.
+ *
+ * @param value - Provider ACL rule.
+ * @throws When the provider omits the rule ID or scope.
+ */
+export declare function normalizeAclRule(value: calendar_v3.Schema$AclRule): z.infer<typeof ACL_RULE_SCHEMA>;
+/**
+ * Normalizes a page of calendar ACL rules.
+ *
+ * @param value - Provider ACL collection.
+ */
+export declare function normalizeAclPage(value: calendar_v3.Schema$Acl): z.infer<typeof ACL_PAGE_SCHEMA>;
+/**
+ * Finds common free windows of a requested duration.
+ *
+ * @param freeBusy - Normalized free/busy response.
+ * @param durationMinutes - Required duration.
+ * @param stepMinutes - Candidate-start increment.
+ * @param limit - Maximum returned slots.
+ */
+export declare function findAvailableSlots(freeBusy: z.infer<typeof FREE_BUSY_SCHEMA>, durationMinutes: number, stepMinutes: number, limit: number): {
+    durationMinutes: number;
+    end: string;
+    start: string;
+}[];
+/**
+ * Builds the provider event body shared by create, update, and import actions.
+ *
+ * @param input - Public event fields.
+ */
+export declare function toEventResource(input: z.infer<typeof EVENT_DETAILS_INPUT_SCHEMA>): calendar_v3.Schema$Event;