@automate.ax/integration-contracts 0.76.0 → 0.77.1

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

@@ -0,0 +1,173 @@
+import { type meet_v2 } from "@googleapis/meet";
+import type { z as zod } from "zod";
+import { GOOGLE_MEET_SPACE_CONFIG_SCHEMA } from "./schemas.js";
+/**
+ * Creates the official Meet client from a resolved Google integration secret.
+ *
+ * @param secret - Refreshed Google integration secret.
+ */
+export declare function getGoogleMeetApi(secret: Record<string, unknown>): meet_v2.Meet;
+/**
+ * Accepts a space resource name, meeting code, opaque space ID, or Meet URL.
+ *
+ * @param space - Meeting-space reference to normalize.
+ * @throws When a URL does not point to Google Meet.
+ */
+export declare function normalizeGoogleMeetSpaceName(space: string): string;
+/**
+ * Accepts a conference-record resource name or raw record ID.
+ *
+ * @param record - Conference-record reference to normalize.
+ */
+export declare function normalizeGoogleMeetConferenceRecordName(record: string): string;
+/**
+ * Converts a code-first space configuration into Google's request shape.
+ *
+ * @param config - Public meeting-space configuration.
+ */
+export declare function toGoogleMeetSpaceConfig(config: zod.infer<typeof GOOGLE_MEET_SPACE_CONFIG_SCHEMA>): meet_v2.Schema$SpaceConfig;
+/**
+ * Builds an exact field mask for a partial code-first space configuration.
+ *
+ * @param config - Public settings included in a partial update.
+ */
+export declare function getGoogleMeetSpaceConfigUpdateMask(config: zod.infer<typeof GOOGLE_MEET_SPACE_CONFIG_SCHEMA>): string;
+/**
+ * Normalizes a Google Meet space without leaking provider nulls or enums.
+ *
+ * @param value - Provider meeting-space resource.
+ */
+export declare function normalizeGoogleMeetSpace(value: meet_v2.Schema$Space): {
+    gatewaySipAccess: {
+        uri: string;
+        sipAccessCode?: string | undefined;
+    }[];
+    meetingCode: string;
+    meetingUri: string;
+    name: string;
+    phoneAccess: {
+        phoneNumber: string;
+        pin: string;
+        languageCode?: string | undefined;
+        regionCode?: string | undefined;
+    }[];
+    activeConference?: string | undefined;
+    config?: {
+        accessType?: "open" | "trusted" | "restricted" | undefined;
+        artifacts?: {
+            recording?: boolean | undefined;
+            smartNotes?: boolean | undefined;
+            transcription?: boolean | undefined;
+        } | undefined;
+        attendanceReport?: boolean | undefined;
+        entryPointAccess?: "all" | "creatorAppOnly" | undefined;
+        moderation?: boolean | undefined;
+        moderationRestrictions?: {
+            chat?: "hostsOnly" | "noRestriction" | undefined;
+            defaultJoinAsViewer?: boolean | undefined;
+            present?: "hostsOnly" | "noRestriction" | undefined;
+            reactions?: "hostsOnly" | "noRestriction" | undefined;
+        } | undefined;
+    } | undefined;
+};
+/**
+ * Normalizes one conference record.
+ *
+ * @param value - Provider conference-record resource.
+ */
+export declare function normalizeGoogleMeetConferenceRecord(value: meet_v2.Schema$ConferenceRecord): {
+    name: string;
+    space: string;
+    startTime: string;
+    endTime?: string | undefined;
+    expireTime?: string | undefined;
+};
+/**
+ * Normalizes one conference participant and its identity variant.
+ *
+ * @param value - Provider participant resource.
+ */
+export declare function normalizeGoogleMeetParticipant(value: meet_v2.Schema$Participant): {
+    name: string;
+    user: {
+        displayName: string;
+        type: "anonymous";
+    } | {
+        displayName: string;
+        type: "phone";
+    } | {
+        displayName: string;
+        type: "signedIn";
+        user?: string | undefined;
+    };
+    earliestStartTime?: string | undefined;
+    latestEndTime?: string | undefined;
+};
+/**
+ * Normalizes one participant-device session.
+ *
+ * @param value - Provider participant-session resource.
+ */
+export declare function normalizeGoogleMeetParticipantSession(value: meet_v2.Schema$ParticipantSession): {
+    name: string;
+    startTime: string;
+    endTime?: string | undefined;
+};
+/**
+ * Normalizes one recording artifact.
+ *
+ * @param value - Provider recording resource.
+ */
+export declare function normalizeGoogleMeetRecording(value: meet_v2.Schema$Recording): {
+    name: string;
+    state: "started" | "ended" | "fileGenerated";
+    driveDestination?: {
+        exportUri?: string | undefined;
+        fileId?: string | undefined;
+    } | undefined;
+    endTime?: string | undefined;
+    startTime?: string | undefined;
+};
+/**
+ * Normalizes one transcript artifact.
+ *
+ * @param value - Provider transcript resource.
+ */
+export declare function normalizeGoogleMeetTranscript(value: meet_v2.Schema$Transcript): {
+    name: string;
+    state: "started" | "ended" | "fileGenerated";
+    docsDestination?: {
+        documentId?: string | undefined;
+        exportUri?: string | undefined;
+    } | undefined;
+    endTime?: string | undefined;
+    startTime?: string | undefined;
+};
+/**
+ * Normalizes one structured transcript segment.
+ *
+ * @param value - Provider transcript-entry resource.
+ */
+export declare function normalizeGoogleMeetTranscriptEntry(value: meet_v2.Schema$TranscriptEntry): {
+    endTime: string;
+    languageCode: string;
+    name: string;
+    participant: string;
+    startTime: string;
+    text: string;
+};
+/**
+ * Normalizes one Meet smart-note artifact.
+ *
+ * @param value - Provider smart-note resource.
+ */
+export declare function normalizeGoogleMeetSmartNote(value: meet_v2.Schema$SmartNote): {
+    name: string;
+    state: "started" | "ended" | "fileGenerated";
+    docsDestination?: {
+        documentId?: string | undefined;
+        exportUri?: string | undefined;
+    } | undefined;
+    endTime?: string | undefined;
+    startTime?: string | undefined;
+};

package/dist/google-meet/google-meet.js

@@ -0,0 +1,371 @@
+import { auth, meet } from "@googleapis/meet";
+import { z } from "zod";
+import { GOOGLE_MEET_CONFERENCE_RECORD_SCHEMA, GOOGLE_MEET_PARTICIPANT_SCHEMA, GOOGLE_MEET_PARTICIPANT_SESSION_SCHEMA, GOOGLE_MEET_RECORDING_SCHEMA, GOOGLE_MEET_SMART_NOTE_SCHEMA, GOOGLE_MEET_SPACE_CONFIG_SCHEMA, GOOGLE_MEET_SPACE_SCHEMA, GOOGLE_MEET_TRANSCRIPT_ENTRY_SCHEMA, GOOGLE_MEET_TRANSCRIPT_SCHEMA, } from "./schemas.js";
+const GOOGLE_MEET_SECRET_SCHEMA = z.object({
+    accessToken: z.string().min(1),
+});
+const GOOGLE_MEET_HOSTS = new Set(["meet.google.com", "meet.google"]);
+/**
+ * Creates the official Meet client from a resolved Google integration secret.
+ *
+ * @param secret - Refreshed Google integration secret.
+ */
+export function getGoogleMeetApi(secret) {
+    const { accessToken } = GOOGLE_MEET_SECRET_SCHEMA.parse(secret);
+    return meet({
+        auth: new auth.OAuth2({ credentials: { access_token: accessToken } }),
+        version: "v2",
+    });
+}
+/**
+ * Accepts a space resource name, meeting code, opaque space ID, or Meet URL.
+ *
+ * @param space - Meeting-space reference to normalize.
+ * @throws When a URL does not point to Google Meet.
+ */
+export function normalizeGoogleMeetSpaceName(space) {
+    const value = space.trim();
+    if (value.startsWith("spaces/"))
+        return value;
+    if (!URL.canParse(value))
+        return `spaces/${value}`;
+    const url = new URL(value);
+    if (!GOOGLE_MEET_HOSTS.has(url.hostname)) {
+        throw new Error(`Expected a Google Meet URL, received "${value}".`);
+    }
+    const meetingCode = url.pathname.split("/").find(Boolean);
+    if (!meetingCode) {
+        throw new Error(`Expected a Google Meet meeting URL, received "${value}".`);
+    }
+    return `spaces/${meetingCode}`;
+}
+/**
+ * Accepts a conference-record resource name or raw record ID.
+ *
+ * @param record - Conference-record reference to normalize.
+ */
+export function normalizeGoogleMeetConferenceRecordName(record) {
+    const value = record.trim();
+    return value.startsWith("conferenceRecords/")
+        ? value
+        : `conferenceRecords/${value}`;
+}
+/**
+ * Converts a code-first space configuration into Google's request shape.
+ *
+ * @param config - Public meeting-space configuration.
+ */
+export function toGoogleMeetSpaceConfig(config) {
+    return {
+        accessType: config.accessType?.toUpperCase(),
+        artifactConfig: config.artifacts
+            ? {
+                recordingConfig: {
+                    autoRecordingGeneration: toAutoGeneration(config.artifacts.recording),
+                },
+                smartNotesConfig: {
+                    autoSmartNotesGeneration: toAutoGeneration(config.artifacts.smartNotes),
+                },
+                transcriptionConfig: {
+                    autoTranscriptionGeneration: toAutoGeneration(config.artifacts.transcription),
+                },
+            }
+            : undefined,
+        attendanceReportGenerationType: config.attendanceReport === undefined
+            ? undefined
+            : config.attendanceReport
+                ? "GENERATE_REPORT"
+                : "DO_NOT_GENERATE",
+        entryPointAccess: config.entryPointAccess === "creatorAppOnly"
+            ? "CREATOR_APP_ONLY"
+            : config.entryPointAccess?.toUpperCase(),
+        moderation: config.moderation === undefined
+            ? undefined
+            : config.moderation
+                ? "ON"
+                : "OFF",
+        moderationRestrictions: config.moderationRestrictions
+            ? {
+                chatRestriction: toRestriction(config.moderationRestrictions.chat),
+                defaultJoinAsViewerType: config.moderationRestrictions.defaultJoinAsViewer === undefined
+                    ? undefined
+                    : config.moderationRestrictions.defaultJoinAsViewer
+                        ? "ON"
+                        : "OFF",
+                presentRestriction: toRestriction(config.moderationRestrictions.present),
+                reactionRestriction: toRestriction(config.moderationRestrictions.reactions),
+            }
+            : undefined,
+    };
+}
+/**
+ * Builds an exact field mask for a partial code-first space configuration.
+ *
+ * @param config - Public settings included in a partial update.
+ */
+export function getGoogleMeetSpaceConfigUpdateMask(config) {
+    return [
+        config.accessType !== undefined && "config.accessType",
+        config.attendanceReport !== undefined &&
+            "config.attendanceReportGenerationType",
+        config.entryPointAccess !== undefined && "config.entryPointAccess",
+        config.moderation !== undefined && "config.moderation",
+        config.moderationRestrictions?.chat !== undefined &&
+            "config.moderationRestrictions.chatRestriction",
+        config.moderationRestrictions?.defaultJoinAsViewer !== undefined &&
+            "config.moderationRestrictions.defaultJoinAsViewerType",
+        config.moderationRestrictions?.present !== undefined &&
+            "config.moderationRestrictions.presentRestriction",
+        config.moderationRestrictions?.reactions !== undefined &&
+            "config.moderationRestrictions.reactionRestriction",
+        config.artifacts?.recording !== undefined &&
+            "config.artifactConfig.recordingConfig.autoRecordingGeneration",
+        config.artifacts?.smartNotes !== undefined &&
+            "config.artifactConfig.smartNotesConfig.autoSmartNotesGeneration",
+        config.artifacts?.transcription !== undefined &&
+            "config.artifactConfig.transcriptionConfig.autoTranscriptionGeneration",
+    ]
+        .filter((value) => Boolean(value))
+        .join(",");
+}
+/**
+ * Normalizes a Google Meet space without leaking provider nulls or enums.
+ *
+ * @param value - Provider meeting-space resource.
+ */
+export function normalizeGoogleMeetSpace(value) {
+    return GOOGLE_MEET_SPACE_SCHEMA.parse({
+        activeConference: value.activeConference?.conferenceRecord ?? undefined,
+        config: value.config ? normalizeSpaceConfig(value.config) : undefined,
+        gatewaySipAccess: (value.gatewaySipAccess ?? []).map((access) => ({
+            sipAccessCode: access.sipAccessCode ?? undefined,
+            uri: access.uri,
+        })),
+        meetingCode: value.meetingCode,
+        meetingUri: value.meetingUri,
+        name: value.name,
+        phoneAccess: (value.phoneAccess ?? []).map((access) => ({
+            languageCode: access.languageCode ?? undefined,
+            phoneNumber: access.phoneNumber,
+            pin: access.pin,
+            regionCode: access.regionCode ?? undefined,
+        })),
+    });
+}
+/**
+ * Normalizes one conference record.
+ *
+ * @param value - Provider conference-record resource.
+ */
+export function normalizeGoogleMeetConferenceRecord(value) {
+    return GOOGLE_MEET_CONFERENCE_RECORD_SCHEMA.parse({
+        endTime: value.endTime ?? undefined,
+        expireTime: value.expireTime ?? undefined,
+        name: value.name,
+        space: value.space,
+        startTime: value.startTime,
+    });
+}
+/**
+ * Normalizes one conference participant and its identity variant.
+ *
+ * @param value - Provider participant resource.
+ */
+export function normalizeGoogleMeetParticipant(value) {
+    return GOOGLE_MEET_PARTICIPANT_SCHEMA.parse({
+        earliestStartTime: value.earliestStartTime ?? undefined,
+        latestEndTime: value.latestEndTime ?? undefined,
+        name: value.name,
+        user: value.signedinUser
+            ? {
+                displayName: value.signedinUser.displayName,
+                type: "signedIn",
+                user: value.signedinUser.user ?? undefined,
+            }
+            : value.anonymousUser
+                ? { displayName: value.anonymousUser.displayName, type: "anonymous" }
+                : { displayName: value.phoneUser?.displayName, type: "phone" },
+    });
+}
+/**
+ * Normalizes one participant-device session.
+ *
+ * @param value - Provider participant-session resource.
+ */
+export function normalizeGoogleMeetParticipantSession(value) {
+    return GOOGLE_MEET_PARTICIPANT_SESSION_SCHEMA.parse({
+        endTime: value.endTime ?? undefined,
+        name: value.name,
+        startTime: value.startTime,
+    });
+}
+/**
+ * Normalizes one recording artifact.
+ *
+ * @param value - Provider recording resource.
+ */
+export function normalizeGoogleMeetRecording(value) {
+    return GOOGLE_MEET_RECORDING_SCHEMA.parse({
+        driveDestination: value.driveDestination
+            ? {
+                exportUri: value.driveDestination.exportUri ?? undefined,
+                fileId: value.driveDestination.file ?? undefined,
+            }
+            : undefined,
+        endTime: value.endTime ?? undefined,
+        name: value.name,
+        startTime: value.startTime ?? undefined,
+        state: normalizeArtifactState(value.state),
+    });
+}
+/**
+ * Normalizes one transcript artifact.
+ *
+ * @param value - Provider transcript resource.
+ */
+export function normalizeGoogleMeetTranscript(value) {
+    return GOOGLE_MEET_TRANSCRIPT_SCHEMA.parse({
+        docsDestination: normalizeDocsDestination(value.docsDestination),
+        endTime: value.endTime ?? undefined,
+        name: value.name,
+        startTime: value.startTime ?? undefined,
+        state: normalizeArtifactState(value.state),
+    });
+}
+/**
+ * Normalizes one structured transcript segment.
+ *
+ * @param value - Provider transcript-entry resource.
+ */
+export function normalizeGoogleMeetTranscriptEntry(value) {
+    return GOOGLE_MEET_TRANSCRIPT_ENTRY_SCHEMA.parse({
+        endTime: value.endTime,
+        languageCode: value.languageCode,
+        name: value.name,
+        participant: value.participant,
+        startTime: value.startTime,
+        text: value.text,
+    });
+}
+/**
+ * Normalizes one Meet smart-note artifact.
+ *
+ * @param value - Provider smart-note resource.
+ */
+export function normalizeGoogleMeetSmartNote(value) {
+    return GOOGLE_MEET_SMART_NOTE_SCHEMA.parse({
+        docsDestination: normalizeDocsDestination(value.docsDestination),
+        endTime: value.endTime ?? undefined,
+        name: value.name,
+        startTime: value.startTime ?? undefined,
+        state: normalizeArtifactState(value.state),
+    });
+}
+/**
+ * Normalizes provider meeting-space settings.
+ *
+ * @param value - Provider settings to normalize.
+ */
+function normalizeSpaceConfig(value) {
+    return GOOGLE_MEET_SPACE_CONFIG_SCHEMA.parse({
+        accessType: value.accessType?.toLowerCase(),
+        artifacts: value.artifactConfig
+            ? {
+                recording: fromAutoGeneration(value.artifactConfig.recordingConfig?.autoRecordingGeneration),
+                smartNotes: fromAutoGeneration(value.artifactConfig.smartNotesConfig?.autoSmartNotesGeneration),
+                transcription: fromAutoGeneration(value.artifactConfig.transcriptionConfig
+                    ?.autoTranscriptionGeneration),
+            }
+            : undefined,
+        attendanceReport: value.attendanceReportGenerationType === undefined ||
+            value.attendanceReportGenerationType === null
+            ? undefined
+            : value.attendanceReportGenerationType === "GENERATE_REPORT",
+        entryPointAccess: value.entryPointAccess === "CREATOR_APP_ONLY"
+            ? "creatorAppOnly"
+            : value.entryPointAccess?.toLowerCase(),
+        moderation: value.moderation === undefined || value.moderation === null
+            ? undefined
+            : value.moderation === "ON",
+        moderationRestrictions: value.moderationRestrictions
+            ? {
+                chat: fromRestriction(value.moderationRestrictions.chatRestriction),
+                defaultJoinAsViewer: value.moderationRestrictions.defaultJoinAsViewerType ===
+                    undefined ||
+                    value.moderationRestrictions.defaultJoinAsViewerType === null
+                    ? undefined
+                    : value.moderationRestrictions.defaultJoinAsViewerType === "ON",
+                present: fromRestriction(value.moderationRestrictions.presentRestriction),
+                reactions: fromRestriction(value.moderationRestrictions.reactionRestriction),
+            }
+            : undefined,
+    });
+}
+/**
+ * Maps a public boolean to Google's auto-generation enum.
+ *
+ * @param value - Public automatic-generation setting.
+ */
+function toAutoGeneration(value) {
+    return value === undefined ? undefined : value ? "ON" : "OFF";
+}
+/**
+ * Maps Google's auto-generation enum to a public boolean.
+ *
+ * @param value - Provider automatic-generation enum.
+ */
+function fromAutoGeneration(value) {
+    return value === undefined || value === null ? undefined : value === "ON";
+}
+/**
+ * Maps a public moderation restriction to Google's enum.
+ *
+ * @param value - Public moderation restriction.
+ */
+function toRestriction(value) {
+    return value === "hostsOnly"
+        ? "HOSTS_ONLY"
+        : value === "noRestriction"
+            ? "NO_RESTRICTION"
+            : undefined;
+}
+/**
+ * Maps Google's moderation restriction to a public enum.
+ *
+ * @param value - Provider moderation restriction.
+ */
+function fromRestriction(value) {
+    return value === "HOSTS_ONLY"
+        ? "hostsOnly"
+        : value === "NO_RESTRICTION"
+            ? "noRestriction"
+            : undefined;
+}
+/**
+ * Normalizes Google's artifact lifecycle state.
+ *
+ * @param value - Provider artifact state.
+ */
+function normalizeArtifactState(value) {
+    switch (z.enum(["STARTED", "ENDED", "FILE_GENERATED"]).parse(value)) {
+        case "STARTED":
+            return "started";
+        case "ENDED":
+            return "ended";
+        case "FILE_GENERATED":
+            return "fileGenerated";
+    }
+}
+/**
+ * Normalizes a generated Google Docs destination.
+ *
+ * @param value - Provider document destination.
+ */
+function normalizeDocsDestination(value) {
+    return value
+        ? {
+            documentId: value.document ?? undefined,
+            exportUri: value.exportUri ?? undefined,
+        }
+        : undefined;
+}