@contractspec/integration.providers-impls 1.57.0 → 1.58.0

package/dist/node/impls/fathom-meeting-recorder.utils.js

@@ -0,0 +1,72 @@
+// src/impls/fathom-meeting-recorder.utils.ts
+function extractItems(page) {
+  if (Array.isArray(page.items))
+    return page.items;
+  if (Array.isArray(page.data)) {
+    return page.data;
+  }
+  return [];
+}
+function extractNextCursor(page) {
+  return page.nextCursor ?? page.next_cursor ?? undefined;
+}
+function mapInvitee(invitee) {
+  const email = invitee.email;
+  const name = invitee.name;
+  if (!email && !name)
+    return;
+  return {
+    email,
+    name,
+    role: "attendee",
+    isExternal: invitee.is_external
+  };
+}
+function matchRecordingId(meeting, targetId) {
+  return meeting.recordingId === targetId;
+}
+function durationSeconds(start, end) {
+  if (!start || !end)
+    return;
+  const startDate = start instanceof Date ? start : new Date(start);
+  const endDate = end instanceof Date ? end : new Date(end);
+  if (Number.isNaN(startDate.valueOf()) || Number.isNaN(endDate.valueOf())) {
+    return;
+  }
+  return Math.max(0, (endDate.valueOf() - startDate.valueOf()) / 1000);
+}
+function mapTranscriptSegment(segment, index) {
+  return {
+    index,
+    speakerName: segment.speaker?.display_name ?? undefined,
+    speakerEmail: segment.speaker?.matched_calendar_invitee_email ?? undefined,
+    text: segment.text,
+    startTimeMs: parseTimestamp(segment.timestamp)
+  };
+}
+function parseTimestamp(value) {
+  const parts = value.split(":").map((part) => Number(part));
+  if (parts.length !== 3 || parts.some((part) => Number.isNaN(part))) {
+    return;
+  }
+  const [hours = 0, minutes = 0, seconds = 0] = parts;
+  return (hours * 3600 + minutes * 60 + seconds) * 1000;
+}
+async function safeReadError(response) {
+  try {
+    const data = await response.json();
+    return data?.message ?? response.statusText;
+  } catch {
+    return response.statusText;
+  }
+}
+export {
+  safeReadError,
+  parseTimestamp,
+  matchRecordingId,
+  mapTranscriptSegment,
+  mapInvitee,
+  extractNextCursor,
+  extractItems,
+  durationSeconds
+};

package/dist/node/impls/fathom-meeting-recorder.webhooks.js

@@ -0,0 +1,29 @@
+// src/impls/fathom-meeting-recorder.webhooks.ts
+import { TriggeredFor } from "fathom-typescript/sdk/models/operations";
+function normalizeWebhookHeaders(headers) {
+  const normalized = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (value == null)
+      continue;
+    const normalizedKey = key.toLowerCase();
+    if (Array.isArray(value)) {
+      if (value.length === 0)
+        continue;
+      normalized[normalizedKey] = value.join(", ");
+    } else {
+      normalized[normalizedKey] = value;
+    }
+  }
+  return normalized;
+}
+function normalizeTriggeredFor(values) {
+  if (!values)
+    return;
+  const allowed = new Set(Object.values(TriggeredFor));
+  const normalized = values.map((value) => value.trim()).filter((value) => allowed.has(value));
+  return normalized.length ? normalized : undefined;
+}
+export {
+  normalizeWebhookHeaders,
+  normalizeTriggeredFor
+};

package/dist/node/impls/fireflies-meeting-recorder.js

@@ -0,0 +1,274 @@
+// src/impls/fireflies-meeting-recorder.queries.ts
+var TRANSCRIPTS_QUERY = `
+  query Transcripts(
+    $limit: Int
+    $skip: Int
+    $fromDate: DateTime
+    $toDate: DateTime
+    $keyword: String
+    $scope: TranscriptsQueryScope
+  ) {
+    transcripts(
+      limit: $limit
+      skip: $skip
+      fromDate: $fromDate
+      toDate: $toDate
+      keyword: $keyword
+      scope: $scope
+    ) {
+      id
+      title
+      organizer_email
+      participants
+      meeting_attendees {
+        name
+        email
+        displayName
+      }
+      dateString
+      duration
+      meeting_link
+      transcript_url
+    }
+  }
+`;
+var TRANSCRIPT_QUERY = `
+  query Transcript($transcriptId: String!) {
+    transcript(id: $transcriptId) {
+      id
+      title
+      organizer_email
+      participants
+      meeting_attendees {
+        name
+        email
+        displayName
+      }
+      dateString
+      duration
+      meeting_link
+      transcript_url
+    }
+  }
+`;
+var TRANSCRIPT_WITH_SEGMENTS_QUERY = `
+  query Transcript($transcriptId: String!) {
+    transcript(id: $transcriptId) {
+      id
+      title
+      organizer_email
+      participants
+      meeting_attendees {
+        name
+        email
+        displayName
+      }
+      dateString
+      duration
+      meeting_link
+      transcript_url
+      sentences {
+        index
+        speaker_name
+        speaker_id
+        text
+        start_time
+        end_time
+      }
+    }
+  }
+`;
+
+// src/impls/fireflies-meeting-recorder.utils.ts
+import { Buffer } from "node:buffer";
+import { timingSafeEqual } from "crypto";
+function parseSeconds(value) {
+  if (value == null)
+    return;
+  const num = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(num))
+    return;
+  return num * 1000;
+}
+function normalizeHeader(headers, key) {
+  const header = headers[key] ?? headers[key.toLowerCase()] ?? headers[key.toUpperCase()];
+  if (Array.isArray(header))
+    return header[0];
+  return header;
+}
+function safeCompareHex(a, b) {
+  try {
+    const aBuffer = Buffer.from(a, "hex");
+    const bBuffer = Buffer.from(b, "hex");
+    if (aBuffer.length !== bBuffer.length)
+      return false;
+    return timingSafeEqual(aBuffer, bBuffer);
+  } catch {
+    return false;
+  }
+}
+async function safeReadError(response) {
+  try {
+    const data = await response.json();
+    return data?.message ?? response.statusText;
+  } catch {
+    return response.statusText;
+  }
+}
+
+// src/impls/fireflies-meeting-recorder.ts
+import { createHmac } from "crypto";
+var DEFAULT_BASE_URL = "https://api.fireflies.ai/graphql";
+
+class FirefliesMeetingRecorderProvider {
+  apiKey;
+  baseUrl;
+  defaultPageSize;
+  webhookSecret;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+    this.defaultPageSize = options.pageSize;
+    this.webhookSecret = options.webhookSecret;
+  }
+  async listMeetings(params) {
+    const limit = params.pageSize ?? this.defaultPageSize ?? 25;
+    const skip = params.cursor ? Number(params.cursor) : 0;
+    const data = await this.query(TRANSCRIPTS_QUERY, {
+      limit,
+      skip: Number.isFinite(skip) ? skip : 0,
+      fromDate: params.from,
+      toDate: params.to,
+      keyword: params.query,
+      scope: params.query ? "all" : undefined
+    });
+    const meetings = data.transcripts.map((transcript) => this.mapTranscriptToMeeting(transcript, params));
+    const nextCursor = meetings.length === limit ? String(skip + limit) : undefined;
+    return {
+      meetings,
+      nextCursor,
+      hasMore: Boolean(nextCursor)
+    };
+  }
+  async getMeeting(params) {
+    const data = await this.query(TRANSCRIPT_QUERY, {
+      transcriptId: params.meetingId
+    });
+    return this.mapTranscriptToMeeting(data.transcript, params);
+  }
+  async getTranscript(params) {
+    const data = await this.query(TRANSCRIPT_WITH_SEGMENTS_QUERY, { transcriptId: params.meetingId });
+    const transcript = data.transcript;
+    const segments = (transcript.sentences ?? []).map((segment) => this.mapSentence(segment));
+    return {
+      id: transcript.id,
+      meetingId: transcript.id,
+      tenantId: params.tenantId,
+      connectionId: params.connectionId ?? "unknown",
+      externalId: transcript.id,
+      format: "segments",
+      text: segments.map((segment) => segment.text).join(`
+`),
+      segments,
+      generatedAt: transcript.dateString ?? undefined,
+      sourceUrl: transcript.transcript_url ?? undefined,
+      metadata: {
+        meetingLink: transcript.meeting_link,
+        durationMinutes: transcript.duration
+      },
+      raw: transcript
+    };
+  }
+  async parseWebhook(request) {
+    const payload = request.parsedBody ?? JSON.parse(request.rawBody);
+    const body = payload;
+    const verified = this.webhookSecret ? await this.verifyWebhook(request) : undefined;
+    return {
+      providerKey: "meeting-recorder.fireflies",
+      eventType: body.eventType,
+      meetingId: body.meetingId,
+      transcriptId: body.meetingId,
+      verified,
+      payload,
+      metadata: {
+        clientReferenceId: body.clientReferenceId
+      }
+    };
+  }
+  async verifyWebhook(request) {
+    if (!this.webhookSecret)
+      return true;
+    const signatureHeader = normalizeHeader(request.headers, "x-hub-signature");
+    if (!signatureHeader)
+      return false;
+    const signature = signatureHeader.replace(/^sha256=/, "");
+    const digest = createHmac("sha256", this.webhookSecret).update(request.rawBody).digest("hex");
+    return safeCompareHex(digest, signature);
+  }
+  mapTranscriptToMeeting(transcript, params) {
+    const connectionId = params.connectionId ?? "unknown";
+    const organizer = transcript.organizer_email ? { email: transcript.organizer_email, role: "organizer" } : undefined;
+    const attendees = transcript.meeting_attendees?.length ? transcript.meeting_attendees.map((attendee) => this.mapAttendee(attendee)) : transcript.participants?.map((email) => ({ email, role: "attendee" }));
+    return {
+      id: transcript.id,
+      tenantId: params.tenantId,
+      connectionId,
+      externalId: transcript.id,
+      title: transcript.title ?? undefined,
+      organizer,
+      invitees: attendees,
+      participants: attendees,
+      scheduledStartAt: transcript.dateString ?? undefined,
+      recordingStartAt: transcript.dateString ?? undefined,
+      durationSeconds: transcript.duration ? transcript.duration * 60 : undefined,
+      meetingUrl: transcript.meeting_link ?? transcript.transcript_url ?? undefined,
+      transcriptAvailable: Boolean(transcript.transcript_url),
+      sourcePlatform: "fireflies",
+      metadata: {
+        transcriptUrl: transcript.transcript_url
+      }
+    };
+  }
+  mapAttendee(attendee) {
+    return {
+      name: attendee.name ?? attendee.displayName ?? undefined,
+      email: attendee.email ?? undefined,
+      role: "attendee"
+    };
+  }
+  mapSentence(segment) {
+    return {
+      index: segment.index ?? undefined,
+      speakerId: segment.speaker_id ?? undefined,
+      speakerName: segment.speaker_name ?? undefined,
+      text: segment.text,
+      startTimeMs: parseSeconds(segment.start_time),
+      endTimeMs: parseSeconds(segment.end_time)
+    };
+  }
+  async query(query, variables) {
+    const response = await fetch(this.baseUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify({ query, variables })
+    });
+    if (!response.ok) {
+      const message = await safeReadError(response);
+      throw new Error(`Fireflies API error (${response.status}): ${message}`);
+    }
+    const result = await response.json();
+    if (result.errors?.length) {
+      throw new Error(result.errors.map((error) => error.message).join("; "));
+    }
+    if (!result.data) {
+      throw new Error("Fireflies API returned empty data payload.");
+    }
+    return result.data;
+  }
+}
+export {
+  FirefliesMeetingRecorderProvider
+};

package/dist/node/impls/fireflies-meeting-recorder.queries.js

@@ -0,0 +1,85 @@
+// src/impls/fireflies-meeting-recorder.queries.ts
+var TRANSCRIPTS_QUERY = `
+  query Transcripts(
+    $limit: Int
+    $skip: Int
+    $fromDate: DateTime
+    $toDate: DateTime
+    $keyword: String
+    $scope: TranscriptsQueryScope
+  ) {
+    transcripts(
+      limit: $limit
+      skip: $skip
+      fromDate: $fromDate
+      toDate: $toDate
+      keyword: $keyword
+      scope: $scope
+    ) {
+      id
+      title
+      organizer_email
+      participants
+      meeting_attendees {
+        name
+        email
+        displayName
+      }
+      dateString
+      duration
+      meeting_link
+      transcript_url
+    }
+  }
+`;
+var TRANSCRIPT_QUERY = `
+  query Transcript($transcriptId: String!) {
+    transcript(id: $transcriptId) {
+      id
+      title
+      organizer_email
+      participants
+      meeting_attendees {
+        name
+        email
+        displayName
+      }
+      dateString
+      duration
+      meeting_link
+      transcript_url
+    }
+  }
+`;
+var TRANSCRIPT_WITH_SEGMENTS_QUERY = `
+  query Transcript($transcriptId: String!) {
+    transcript(id: $transcriptId) {
+      id
+      title
+      organizer_email
+      participants
+      meeting_attendees {
+        name
+        email
+        displayName
+      }
+      dateString
+      duration
+      meeting_link
+      transcript_url
+      sentences {
+        index
+        speaker_name
+        speaker_id
+        text
+        start_time
+        end_time
+      }
+    }
+  }
+`;
+export {
+  TRANSCRIPT_WITH_SEGMENTS_QUERY,
+  TRANSCRIPT_QUERY,
+  TRANSCRIPTS_QUERY
+};

package/dist/node/impls/fireflies-meeting-recorder.utils.js

@@ -0,0 +1,42 @@
+// src/impls/fireflies-meeting-recorder.utils.ts
+import { Buffer } from "node:buffer";
+import { timingSafeEqual } from "crypto";
+function parseSeconds(value) {
+  if (value == null)
+    return;
+  const num = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(num))
+    return;
+  return num * 1000;
+}
+function normalizeHeader(headers, key) {
+  const header = headers[key] ?? headers[key.toLowerCase()] ?? headers[key.toUpperCase()];
+  if (Array.isArray(header))
+    return header[0];
+  return header;
+}
+function safeCompareHex(a, b) {
+  try {
+    const aBuffer = Buffer.from(a, "hex");
+    const bBuffer = Buffer.from(b, "hex");
+    if (aBuffer.length !== bBuffer.length)
+      return false;
+    return timingSafeEqual(aBuffer, bBuffer);
+  } catch {
+    return false;
+  }
+}
+async function safeReadError(response) {
+  try {
+    const data = await response.json();
+    return data?.message ?? response.statusText;
+  } catch {
+    return response.statusText;
+  }
+}
+export {
+  safeReadError,
+  safeCompareHex,
+  parseSeconds,
+  normalizeHeader
+};

package/dist/node/impls/gcs-storage.js

@@ -0,0 +1,97 @@
+// src/impls/gcs-storage.ts
+import { Storage } from "@google-cloud/storage";
+
+class GoogleCloudStorageProvider {
+  storage;
+  bucketName;
+  constructor(options) {
+    this.storage = options.storage ?? new Storage(options.clientOptions ?? undefined);
+    this.bucketName = options.bucket;
+  }
+  async putObject(input) {
+    const bucketName = input.bucket ?? this.bucketName;
+    const bucket = this.storage.bucket(bucketName);
+    const file = bucket.file(input.key);
+    const buffer = toBuffer(input.data);
+    await file.save(buffer, {
+      resumable: false,
+      contentType: input.contentType,
+      metadata: input.metadata
+    });
+    if (input.makePublic) {
+      await file.makePublic();
+    }
+    const [metadata] = await file.getMetadata();
+    return toMetadata(metadata);
+  }
+  async getObject(input) {
+    const bucketName = input.bucket ?? this.bucketName;
+    const bucket = this.storage.bucket(bucketName);
+    const file = bucket.file(input.key);
+    const [exists] = await file.exists();
+    if (!exists)
+      return null;
+    const [contents] = await file.download();
+    const [metadata] = await file.getMetadata();
+    return {
+      ...toMetadata(metadata),
+      data: new Uint8Array(contents)
+    };
+  }
+  async deleteObject(input) {
+    const bucketName = input.bucket ?? this.bucketName;
+    const bucket = this.storage.bucket(bucketName);
+    const file = bucket.file(input.key);
+    await file.delete({ ignoreNotFound: true });
+  }
+  async generateSignedUrl(options) {
+    const bucketName = options.bucket ?? this.bucketName;
+    const bucket = this.storage.bucket(bucketName);
+    const file = bucket.file(options.key);
+    const action = options.method === "PUT" ? "write" : "read";
+    const expires = Date.now() + options.expiresInSeconds * 1000;
+    const [url] = await file.getSignedUrl({
+      action,
+      expires,
+      contentType: options.contentType
+    });
+    return { url, expiresAt: new Date(expires) };
+  }
+  async listObjects(query) {
+    const bucketName = query.bucket ?? this.bucketName;
+    const bucket = this.storage.bucket(bucketName);
+    const [files, nextQuery, response] = await bucket.getFiles({
+      prefix: query.prefix,
+      maxResults: query.maxResults,
+      pageToken: query.pageToken
+    });
+    const nextTokenFromQuery = typeof nextQuery === "object" && nextQuery !== null && "pageToken" in nextQuery ? nextQuery.pageToken : undefined;
+    const nextTokenFromResponse = response && typeof response === "object" && "nextPageToken" in response ? response.nextPageToken : undefined;
+    return {
+      objects: files.map((file) => toMetadata(file.metadata)),
+      nextPageToken: nextTokenFromQuery ?? nextTokenFromResponse ?? undefined
+    };
+  }
+}
+function toBuffer(data) {
+  if (data instanceof Uint8Array) {
+    return Buffer.from(data);
+  }
+  return Buffer.from(data);
+}
+function toMetadata(metadata) {
+  const meta = metadata;
+  return {
+    bucket: String(meta.bucket ?? ""),
+    key: String(meta.name ?? ""),
+    sizeBytes: meta.size ? Number(meta.size) : undefined,
+    contentType: meta.contentType ? String(meta.contentType) : undefined,
+    etag: meta.etag ? String(meta.etag) : undefined,
+    checksum: meta.md5Hash ? String(meta.md5Hash) : undefined,
+    lastModified: meta.updated ? new Date(String(meta.updated)) : undefined,
+    metadata: meta.metadata
+  };
+}
+export {
+  GoogleCloudStorageProvider
+};