@contractspec/lib.contracts 1.56.1 → 1.57.0

package/dist/integrations/meeting-recorder/models.d.ts

@@ -0,0 +1,407 @@
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
+import { SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/integrations/meeting-recorder/models.d.ts
+declare const MeetingParticipantRecord: SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  externalId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  name: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  email: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  role: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  isExternal: {
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+}>;
+declare const MeetingTranscriptSegmentRecord: SchemaModel<{
+  index: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  speakerId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  speakerName: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  speakerEmail: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  text: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  startTimeMs: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  endTimeMs: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  startTime: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  endTime: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  confidence: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+}>;
+declare const MeetingRecord: SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  tenantId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  connectionId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  externalId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  title: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  summary: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  organizer: {
+    type: SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      externalId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      name: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      email: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      role: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      isExternal: {
+        type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+        isOptional: true;
+      };
+      metadata: {
+        type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: true;
+  };
+  invitees: {
+    type: SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      externalId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      name: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      email: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      role: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      isExternal: {
+        type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+        isOptional: true;
+      };
+      metadata: {
+        type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: true;
+  };
+  participants: {
+    type: SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      externalId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      name: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      email: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      role: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      isExternal: {
+        type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+        isOptional: true;
+      };
+      metadata: {
+        type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: true;
+  };
+  scheduledStartAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  scheduledEndAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  recordingStartAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  recordingEndAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  durationSeconds: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  meetingUrl: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  recordingUrl: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  shareUrl: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  sourcePlatform: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  language: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  transcriptAvailable: {
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  createdAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  updatedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+}>;
+declare const MeetingTranscriptRecord: SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  meetingId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  tenantId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  connectionId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  externalId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  format: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  text: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  segments: {
+    type: SchemaModel<{
+      index: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      speakerId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      speakerName: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      speakerEmail: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      text: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      startTimeMs: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      endTimeMs: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      startTime: {
+        type: _contractspec_lib_schema0.FieldType<Date, string>;
+        isOptional: true;
+      };
+      endTime: {
+        type: _contractspec_lib_schema0.FieldType<Date, string>;
+        isOptional: true;
+      };
+      confidence: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      metadata: {
+        type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: true;
+  };
+  language: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  sourceUrl: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  generatedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+  raw: {
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+}>;
+declare const MeetingRecorderWebhookEventRecord: SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  providerKey: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  eventType: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  meetingId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  transcriptId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  recordingId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  receivedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  verified: {
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+    isOptional: true;
+  };
+  payload: {
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { MeetingParticipantRecord, MeetingRecord, MeetingRecorderWebhookEventRecord, MeetingTranscriptRecord, MeetingTranscriptSegmentRecord };

package/dist/integrations/meeting-recorder/models.js

@@ -0,0 +1,295 @@
+import { ScalarTypeEnum, SchemaModel } from "@contractspec/lib.schema";
+
+//#region src/integrations/meeting-recorder/models.ts
+const MeetingParticipantRecord = new SchemaModel({
+	name: "MeetingParticipantRecord",
+	description: "Canonical participant entry for meetings and transcripts from recorder providers.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		externalId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		email: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		role: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		isExternal: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+const MeetingTranscriptSegmentRecord = new SchemaModel({
+	name: "MeetingTranscriptSegmentRecord",
+	description: "A single transcript segment with speaker attribution.",
+	fields: {
+		index: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		speakerId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		speakerName: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		speakerEmail: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		text: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		startTimeMs: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		endTimeMs: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		startTime: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		endTime: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		confidence: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+const MeetingRecord = new SchemaModel({
+	name: "MeetingRecord",
+	description: "Canonical meeting metadata synced from meeting recorder providers.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		externalId: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		title: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		summary: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		organizer: {
+			type: MeetingParticipantRecord,
+			isOptional: true
+		},
+		invitees: {
+			type: MeetingParticipantRecord,
+			isArray: true,
+			isOptional: true
+		},
+		participants: {
+			type: MeetingParticipantRecord,
+			isArray: true,
+			isOptional: true
+		},
+		scheduledStartAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		scheduledEndAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		recordingStartAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		recordingEndAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		durationSeconds: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		meetingUrl: {
+			type: ScalarTypeEnum.URL(),
+			isOptional: true
+		},
+		recordingUrl: {
+			type: ScalarTypeEnum.URL(),
+			isOptional: true
+		},
+		shareUrl: {
+			type: ScalarTypeEnum.URL(),
+			isOptional: true
+		},
+		sourcePlatform: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		language: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		transcriptAvailable: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+const MeetingTranscriptRecord = new SchemaModel({
+	name: "MeetingTranscriptRecord",
+	description: "Canonical transcript payload for a recorded meeting.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		meetingId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		connectionId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		externalId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		format: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		text: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		segments: {
+			type: MeetingTranscriptSegmentRecord,
+			isArray: true,
+			isOptional: true
+		},
+		language: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		sourceUrl: {
+			type: ScalarTypeEnum.URL(),
+			isOptional: true
+		},
+		generatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		},
+		raw: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		}
+	}
+});
+const MeetingRecorderWebhookEventRecord = new SchemaModel({
+	name: "MeetingRecorderWebhookEventRecord",
+	description: "Normalized webhook event from a meeting recorder provider.",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		providerKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		eventType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		meetingId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		transcriptId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		recordingId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		receivedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		verified: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		payload: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		}
+	}
+});
+
+//#endregion
+export { MeetingParticipantRecord, MeetingRecord, MeetingRecorderWebhookEventRecord, MeetingTranscriptRecord, MeetingTranscriptSegmentRecord };

package/dist/integrations/meeting-recorder/telemetry.d.ts

@@ -0,0 +1,16 @@
+//#region src/integrations/meeting-recorder/telemetry.d.ts
+declare const MEETING_RECORDER_PII_FIELDS: readonly ["email", "organizerEmail", "participantEmail", "participants", "invitees", "attendees", "speakerName", "speakerEmail", "name", "phone", "phoneNumber", "displayName"];
+declare const MEETING_RECORDER_TELEMETRY_EVENTS: {
+  readonly meetingsSynced: "meeting-recorder.meetings.synced";
+  readonly meetingsSyncFailed: "meeting-recorder.meetings.sync_failed";
+  readonly transcriptsFetched: "meeting-recorder.transcripts.fetched";
+  readonly transcriptsFetchFailed: "meeting-recorder.transcripts.fetch_failed";
+  readonly transcriptsSynced: "meeting-recorder.transcripts.synced";
+  readonly transcriptsSyncFailed: "meeting-recorder.transcripts.sync_failed";
+  readonly webhookReceived: "meeting-recorder.webhooks.received";
+  readonly webhookRejected: "meeting-recorder.webhooks.rejected";
+};
+type MeetingRecorderTelemetryEvent = (typeof MEETING_RECORDER_TELEMETRY_EVENTS)[keyof typeof MEETING_RECORDER_TELEMETRY_EVENTS];
+declare function redactMeetingRecorderTelemetryPayload<T extends Record<string, unknown>>(payload: T): T;
+//#endregion
+export { MEETING_RECORDER_PII_FIELDS, MEETING_RECORDER_TELEMETRY_EVENTS, MeetingRecorderTelemetryEvent, redactMeetingRecorderTelemetryPayload };