@automate.ax/integration-contracts 0.75.0 → 0.77.0

package/src/google-meet/google-meet.ts

@@ -0,0 +1,445 @@
+import { auth, meet, type meet_v2 } from "@googleapis/meet"
+import { z } from "zod"
+import type { z as zod } 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"
+
+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: Record<string, unknown>) {
+  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: string) {
+  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: string) {
+  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: zod.infer<typeof GOOGLE_MEET_SPACE_CONFIG_SCHEMA>,
+): meet_v2.Schema$SpaceConfig {
+  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: zod.infer<typeof GOOGLE_MEET_SPACE_CONFIG_SCHEMA>,
+) {
+  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): value is string => Boolean(value))
+    .join(",")
+}
+
+/**
+ * Normalizes a Google Meet space without leaking provider nulls or enums.
+ *
+ * @param value - Provider meeting-space resource.
+ */
+export function normalizeGoogleMeetSpace(value: meet_v2.Schema$Space) {
+  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: meet_v2.Schema$ConferenceRecord,
+) {
+  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: meet_v2.Schema$Participant,
+) {
+  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: meet_v2.Schema$ParticipantSession,
+) {
+  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: meet_v2.Schema$Recording) {
+  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: meet_v2.Schema$Transcript,
+) {
+  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: meet_v2.Schema$TranscriptEntry,
+) {
+  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: meet_v2.Schema$SmartNote) {
+  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: meet_v2.Schema$SpaceConfig) {
+  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?: boolean) {
+  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?: string | null) {
+  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?: "hostsOnly" | "noRestriction") {
+  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?: string | null) {
+  return value === "HOSTS_ONLY"
+    ? "hostsOnly"
+    : value === "NO_RESTRICTION"
+      ? "noRestriction"
+      : undefined
+}
+
+/**
+ * Normalizes Google's artifact lifecycle state.
+ *
+ * @param value - Provider artifact state.
+ */
+function normalizeArtifactState(value?: string | null) {
+  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?: meet_v2.Schema$DocsDestination) {
+  return value
+    ? {
+        documentId: value.document ?? undefined,
+        exportUri: value.exportUri ?? undefined,
+      }
+    : undefined
+}

package/src/google-meet/index.ts

@@ -0,0 +1,117 @@
+import { z } from "zod"
+import {
+  GOOGLE_MEET_CONFERENCE_RECORD_SCHEMA,
+  GOOGLE_MEET_PARTICIPANT_SESSION_SCHEMA,
+  GOOGLE_MEET_RECORDING_SCHEMA,
+  GOOGLE_MEET_SMART_NOTE_SCHEMA,
+  GOOGLE_MEET_TRANSCRIPT_SCHEMA,
+} from "./schemas"
+
+export * from "./google-meet"
+export * from "./schemas"
+
+/** Canonical Google Meet target selected by one subscription. */
+export const GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA = z.object({
+  /** Stable space resource name, or omitted for all owned meeting spaces. */
+  spaceName: z.string().optional(),
+})
+
+export const GOOGLE_MEET_RECORDING_STARTED_EVENT_SCHEMA =
+  GOOGLE_MEET_RECORDING_SCHEMA.extend({ state: z.literal("started") })
+export const GOOGLE_MEET_RECORDING_ENDED_EVENT_SCHEMA =
+  GOOGLE_MEET_RECORDING_SCHEMA.extend({ state: z.literal("ended") })
+export const GOOGLE_MEET_RECORDING_FILE_GENERATED_EVENT_SCHEMA =
+  GOOGLE_MEET_RECORDING_SCHEMA.extend({ state: z.literal("fileGenerated") })
+export const GOOGLE_MEET_SMART_NOTE_STARTED_EVENT_SCHEMA =
+  GOOGLE_MEET_SMART_NOTE_SCHEMA.extend({ state: z.literal("started") })
+export const GOOGLE_MEET_SMART_NOTE_ENDED_EVENT_SCHEMA =
+  GOOGLE_MEET_SMART_NOTE_SCHEMA.extend({ state: z.literal("ended") })
+export const GOOGLE_MEET_SMART_NOTE_FILE_GENERATED_EVENT_SCHEMA =
+  GOOGLE_MEET_SMART_NOTE_SCHEMA.extend({ state: z.literal("fileGenerated") })
+export const GOOGLE_MEET_TRANSCRIPT_STARTED_EVENT_SCHEMA =
+  GOOGLE_MEET_TRANSCRIPT_SCHEMA.extend({ state: z.literal("started") })
+export const GOOGLE_MEET_TRANSCRIPT_ENDED_EVENT_SCHEMA =
+  GOOGLE_MEET_TRANSCRIPT_SCHEMA.extend({ state: z.literal("ended") })
+export const GOOGLE_MEET_TRANSCRIPT_FILE_GENERATED_EVENT_SCHEMA =
+  GOOGLE_MEET_TRANSCRIPT_SCHEMA.extend({ state: z.literal("fileGenerated") })
+
+export const googleMeetTriggerContracts = {
+  "googleMeet.conference.ended": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_CONFERENCE_RECORD_SCHEMA,
+  },
+  "googleMeet.conference.started": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_CONFERENCE_RECORD_SCHEMA,
+  },
+  "googleMeet.participant.joined": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_PARTICIPANT_SESSION_SCHEMA,
+  },
+  "googleMeet.participant.left": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_PARTICIPANT_SESSION_SCHEMA,
+  },
+  "googleMeet.recording.ended": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_RECORDING_ENDED_EVENT_SCHEMA,
+  },
+  "googleMeet.recording.fileGenerated": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_RECORDING_FILE_GENERATED_EVENT_SCHEMA,
+  },
+  "googleMeet.recording.started": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_RECORDING_STARTED_EVENT_SCHEMA,
+  },
+  "googleMeet.smartNote.ended": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_SMART_NOTE_ENDED_EVENT_SCHEMA,
+  },
+  "googleMeet.smartNote.fileGenerated": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_SMART_NOTE_FILE_GENERATED_EVENT_SCHEMA,
+  },
+  "googleMeet.smartNote.started": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_SMART_NOTE_STARTED_EVENT_SCHEMA,
+  },
+  "googleMeet.transcript.ended": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_TRANSCRIPT_ENDED_EVENT_SCHEMA,
+  },
+  "googleMeet.transcript.fileGenerated": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_TRANSCRIPT_FILE_GENERATED_EVENT_SCHEMA,
+  },
+  "googleMeet.transcript.started": {
+    configSchema: GOOGLE_MEET_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GOOGLE_MEET_TRANSCRIPT_STARTED_EVENT_SCHEMA,
+  },
+} as const
+
+export const GOOGLE_MEET_PROVIDER_EVENT_TYPES = {
+  "googleMeet.conference.ended": "google.workspace.meet.conference.v2.ended",
+  "googleMeet.conference.started":
+    "google.workspace.meet.conference.v2.started",
+  "googleMeet.participant.joined":
+    "google.workspace.meet.participant.v2.joined",
+  "googleMeet.participant.left": "google.workspace.meet.participant.v2.left",
+  "googleMeet.recording.ended": "google.workspace.meet.recording.v2.ended",
+  "googleMeet.recording.fileGenerated":
+    "google.workspace.meet.recording.v2.fileGenerated",
+  "googleMeet.recording.started": "google.workspace.meet.recording.v2.started",
+  "googleMeet.smartNote.ended": "google.workspace.meet.smartNote.v2.ended",
+  "googleMeet.smartNote.fileGenerated":
+    "google.workspace.meet.smartNote.v2.fileGenerated",
+  "googleMeet.smartNote.started": "google.workspace.meet.smartNote.v2.started",
+  "googleMeet.transcript.ended": "google.workspace.meet.transcript.v2.ended",
+  "googleMeet.transcript.fileGenerated":
+    "google.workspace.meet.transcript.v2.fileGenerated",
+  "googleMeet.transcript.started":
+    "google.workspace.meet.transcript.v2.started",
+} as const satisfies Record<keyof typeof googleMeetTriggerContracts, string>
+
+export type GoogleMeetTriggerType = keyof typeof googleMeetTriggerContracts
+export type GoogleMeetProviderEventType =
+  (typeof GOOGLE_MEET_PROVIDER_EVENT_TYPES)[GoogleMeetTriggerType]