@contractspec/lib.contracts 1.56.0 → 1.57.0

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 };

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

@@ -0,0 +1,42 @@
+//#region src/integrations/meeting-recorder/telemetry.ts
+const MEETING_RECORDER_PII_FIELDS = [
+	"email",
+	"organizerEmail",
+	"participantEmail",
+	"participants",
+	"invitees",
+	"attendees",
+	"speakerName",
+	"speakerEmail",
+	"name",
+	"phone",
+	"phoneNumber",
+	"displayName"
+];
+const MEETING_RECORDER_TELEMETRY_EVENTS = {
+	meetingsSynced: "meeting-recorder.meetings.synced",
+	meetingsSyncFailed: "meeting-recorder.meetings.sync_failed",
+	transcriptsFetched: "meeting-recorder.transcripts.fetched",
+	transcriptsFetchFailed: "meeting-recorder.transcripts.fetch_failed",
+	transcriptsSynced: "meeting-recorder.transcripts.synced",
+	transcriptsSyncFailed: "meeting-recorder.transcripts.sync_failed",
+	webhookReceived: "meeting-recorder.webhooks.received",
+	webhookRejected: "meeting-recorder.webhooks.rejected"
+};
+function redactMeetingRecorderTelemetryPayload(payload) {
+	const redacted = {};
+	for (const [key, value] of Object.entries(payload)) if (MEETING_RECORDER_PII_FIELDS.includes(key)) redacted[key] = maskValue(value);
+	else if (Array.isArray(value)) redacted[key] = value.map((item) => typeof item === "object" && item !== null ? redactMeetingRecorderTelemetryPayload(item) : item);
+	else if (typeof value === "object" && value !== null) redacted[key] = redactMeetingRecorderTelemetryPayload(value);
+	else redacted[key] = value;
+	return redacted;
+}
+function maskValue(value) {
+	if (value == null) return "";
+	const str = String(value);
+	if (str.length <= 4) return "*".repeat(str.length);
+	return `${"*".repeat(Math.max(str.length - 4, 0))}${str.slice(-4)}`;
+}
+
+//#endregion
+export { MEETING_RECORDER_PII_FIELDS, MEETING_RECORDER_TELEMETRY_EVENTS, redactMeetingRecorderTelemetryPayload };