@automate.ax/integration-contracts 0.148.0 → 0.150.1

package/src/krisp/schemas.ts

@@ -0,0 +1,122 @@
+import * as z from "zod"
+import type { Encodable } from "@automate.ax/codec"
+
+const DATE_TIME_SCHEMA = z.iso.datetime({ offset: true })
+
+/** Krisp profile represented by a personal API key. */
+export const KRISP_PROFILE_SCHEMA = z.object({
+  avatar: z.url().nullable().prefault(null),
+  email: z.email(),
+  firstName: z.string().nullable().prefault(null),
+  id: z.number().int().positive(),
+  lastName: z.string().nullable().prefault(null),
+  teamId: z.number().int().positive(),
+  workspaceId: z.number().int().positive(),
+})
+
+/** Calendar attendee or diarized speaker attached to a Krisp meeting. */
+export const KRISP_PARTICIPANT_SCHEMA = z.object({
+  email: z.string().nullable().prefault(null),
+  firstName: z.string().nullable().prefault(null),
+  lastName: z.string().nullable().prefault(null),
+  photo: z.url().nullable().prefault(null),
+  status: z.string().nullable().prefault(null),
+})
+
+/** Meeting metadata returned by Krisp list and detail endpoints. */
+export const KRISP_MEETING_SCHEMA = z.object({
+  duration: z.number().int().nonnegative().nullable(),
+  id: z.string().min(1),
+  ownership: z.enum(["owned", "shared"]),
+  participants: KRISP_PARTICIPANT_SCHEMA.array().optional(),
+  source: z.string().nullable(),
+  startedAt: DATE_TIME_SCHEMA.nullable(),
+  status: z.string(),
+  tags: z.string().array(),
+  title: z.string(),
+})
+
+/** One diarized transcript segment. Times are seconds from recording start. */
+export const KRISP_TRANSCRIPT_SEGMENT_SCHEMA = z.object({
+  end: z.number().nonnegative(),
+  speaker: z.number().int().nonnegative(),
+  start: z.number().nonnegative(),
+  text: z.string(),
+})
+
+const KRISP_NOTE_ASSIGNEE_SCHEMA = z.record(z.string(), z.json())
+
+export interface KrispNoteBlock {
+  [key: string]: Encodable
+  assignee?: z.output<typeof KRISP_NOTE_ASSIGNEE_SCHEMA> | null
+  children?: KrispNoteBlock[]
+  completed?: boolean | null
+  dueDate?: string | null
+  text?: string
+  type: string
+}
+
+/** Recursive block returned by Krisp's fixed and custom meeting-note sections. */
+export const KRISP_NOTE_BLOCK_SCHEMA: z.ZodType<KrispNoteBlock> = z.lazy(() =>
+  z.object({
+    assignee: KRISP_NOTE_ASSIGNEE_SCHEMA.nullable().optional(),
+    children: KRISP_NOTE_BLOCK_SCHEMA.array().optional(),
+    completed: z.boolean().nullable().optional(),
+    dueDate: z.string().nullable().optional(),
+    text: z.string().optional(),
+    type: z.string(),
+  }),
+)
+
+/** Complete Krisp meeting detail with optional heavy transcript and note data. */
+export const KRISP_MEETING_DETAIL_SCHEMA = KRISP_MEETING_SCHEMA.extend({
+  language: z.string().nullable().prefault(null),
+  meetingType: z.string().nullable().prefault(null),
+  notes: z
+    .object({ blocks: KRISP_NOTE_BLOCK_SCHEMA.array() })
+    .nullable()
+    .optional(),
+  transcript: z
+    .object({
+      language: z.string().nullable().prefault(null),
+      segments: KRISP_TRANSCRIPT_SEGMENT_SCHEMA.array().prefault([]),
+      speakers: z.record(z.string(), KRISP_PARTICIPANT_SCHEMA).prefault({}),
+    })
+    .nullable()
+    .optional(),
+})
+
+/** One action item extracted from a Krisp meeting. */
+export const KRISP_ACTION_ITEM_SCHEMA = z.object({
+  assignee: KRISP_PARTICIPANT_SCHEMA.nullable().prefault(null),
+  completed: z.boolean().nullable().prefault(null),
+  dueDate: z.string().nullable().prefault(null),
+  id: z.string().min(1),
+  meetingId: z.string().min(1),
+  meetingStartedAt: DATE_TIME_SCHEMA.nullable().prefault(null),
+  meetingTitle: z.string(),
+  title: z.string(),
+})
+
+/** Tag used to organize Krisp meetings. */
+export const KRISP_TAG_SCHEMA = z.object({
+  color: z.string().nullable(),
+  createdAt: DATE_TIME_SCHEMA,
+  id: z.string().min(1),
+  name: z.string(),
+})
+
+/** Recording-import identity returned after Krisp issues an upload URL. */
+export const KRISP_IMPORT_SCHEMA = z.object({
+  expiresAt: DATE_TIME_SCHEMA,
+  importId: z.string().min(1),
+  url: z.url(),
+})
+
+/** Current processing state for a Krisp recording import. */
+export const KRISP_IMPORT_STATUS_SCHEMA = z.object({
+  error: z.string().nullable().prefault(null),
+  importId: z.string().min(1),
+  meetingId: z.string().min(1).nullable().prefault(null),
+  status: z.enum(["uploading", "processing", "ready", "failed"]),
+})