@twentyhq/call-recorder 1.0.1 → 1.0.2

package/src/front-components/utils/__tests__/get-speaker-name-match-keys.test.ts

@@ -1,22 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { getSpeakerNameMatchKeys } from 'src/front-components/utils/get-speaker-name-match-keys.util';
-
-describe('getSpeakerNameMatchKeys', () => {
-  it('matches transcript full names to compact calendar aliases', () => {
-    expect(getSpeakerNameMatchKeys('Martin Muller')).toContain('martmull');
-    expect(getSpeakerNameMatchKeys('Martmull92')).toContain('martmull');
-  });
-
-  it('keeps exact normalized full names available for regular participant names', () => {
-    expect(getSpeakerNameMatchKeys('Nitin Koche')).toEqual([
-      'nitin koche',
-      'nitinkoche',
-      'nitikoch',
-    ]);
-  });
-
-  it('folds accents before generating compact match keys', () => {
-    expect(getSpeakerNameMatchKeys('Martin Müller')).toContain('martmull');
-  });
-});

package/src/front-components/utils/__tests__/parse-transcript-entries.test.ts

@@ -1,162 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { parseTranscriptEntries } from 'src/front-components/utils/parse-transcript-entries.util';
-
-describe('parseTranscriptEntries', () => {
-  it('parses diarized entries into speaker, start time, and joined text', () => {
-    expect(
-      parseTranscriptEntries([
-        {
-          participant: { id: 100, name: 'Ada Lovelace' },
-          words: [
-            {
-              text: 'Hello',
-              start_timestamp: {
-                relative: 1.2,
-                absolute: '2026-06-12T10:00:01Z',
-              },
-              end_timestamp: {
-                relative: 1.6,
-                absolute: '2026-06-12T10:00:01Z',
-              },
-            },
-            {
-              text: 'there',
-              start_timestamp: {
-                relative: 1.7,
-                absolute: '2026-06-12T10:00:02Z',
-              },
-              end_timestamp: {
-                relative: 2.1,
-                absolute: '2026-06-12T10:00:02Z',
-              },
-            },
-          ],
-        },
-        {
-          participant: { id: 101, name: 'Grace Hopper' },
-          words: [
-            {
-              text: 'Hi',
-              start_timestamp: {
-                relative: 3.4,
-                absolute: '2026-06-12T10:00:03Z',
-              },
-            },
-          ],
-        },
-      ]),
-    ).toEqual([
-      {
-        speakerName: 'Ada Lovelace',
-        startSeconds: 1.2,
-        endSeconds: 2.1,
-        text: 'Hello there',
-        words: [
-          { text: 'Hello', startSeconds: 1.2, endSeconds: 1.6 },
-          { text: 'there', startSeconds: 1.7, endSeconds: 2.1 },
-        ],
-      },
-      {
-        speakerName: 'Grace Hopper',
-        startSeconds: 3.4,
-        endSeconds: undefined,
-        text: 'Hi',
-        words: [{ text: 'Hi', startSeconds: 3.4, endSeconds: undefined }],
-      },
-    ]);
-  });
-
-  it('falls back to an unknown speaker when the participant has no name', () => {
-    expect(
-      parseTranscriptEntries([
-        { participant: { id: 100, name: null }, words: [{ text: 'Hello' }] },
-        { words: [{ text: 'Hi' }] },
-      ]),
-    ).toEqual([
-      {
-        speakerName: 'Unknown speaker',
-        startSeconds: undefined,
-        endSeconds: undefined,
-        text: 'Hello',
-        words: [
-          { text: 'Hello', startSeconds: undefined, endSeconds: undefined },
-        ],
-      },
-      {
-        speakerName: 'Unknown speaker',
-        startSeconds: undefined,
-        endSeconds: undefined,
-        text: 'Hi',
-        words: [{ text: 'Hi', startSeconds: undefined, endSeconds: undefined }],
-      },
-    ]);
-  });
-
-  it('returns an undefined start time when the first word has no relative timestamp', () => {
-    expect(
-      parseTranscriptEntries([
-        {
-          participant: { name: 'Ada Lovelace' },
-          words: [
-            {
-              text: 'Hello',
-              start_timestamp: { absolute: '2026-06-12T10:00:01Z' },
-            },
-          ],
-        },
-      ]),
-    ).toEqual([
-      {
-        speakerName: 'Ada Lovelace',
-        startSeconds: undefined,
-        endSeconds: undefined,
-        text: 'Hello',
-        words: [
-          { text: 'Hello', startSeconds: undefined, endSeconds: undefined },
-        ],
-      },
-    ]);
-  });
-
-  it('skips entries without usable words instead of failing the whole transcript', () => {
-    expect(
-      parseTranscriptEntries([
-        { participant: { name: 'Ada Lovelace' }, words: [] },
-        { participant: { name: 'Grace Hopper' } },
-        {
-          participant: { name: 'Alan Turing' },
-          words: [{ text: '   ' }, 42, null],
-        },
-        { participant: { name: 'Joan Clarke' }, words: [{ text: 'Kept' }] },
-        'not an entry',
-      ]),
-    ).toEqual([
-      {
-        speakerName: 'Joan Clarke',
-        startSeconds: undefined,
-        endSeconds: undefined,
-        text: 'Kept',
-        words: [
-          { text: 'Kept', startSeconds: undefined, endSeconds: undefined },
-        ],
-      },
-    ]);
-  });
-
-  it('returns an empty list for an empty transcript array', () => {
-    expect(parseTranscriptEntries([])).toEqual([]);
-  });
-
-  it('returns undefined for values that are not a diarized transcript array', () => {
-    expect(parseTranscriptEntries(null)).toBeUndefined();
-    expect(parseTranscriptEntries(undefined)).toBeUndefined();
-    expect(parseTranscriptEntries('transcript text')).toBeUndefined();
-    expect(
-      parseTranscriptEntries({
-        recallTranscriptId: 'recall-transcript-1',
-        status: 'PENDING',
-      }),
-    ).toBeUndefined();
-  });
-});

package/src/front-components/utils/build-calendar-event-participant-by-speaker-name.util.ts

@@ -1,45 +0,0 @@
-import { isUndefined } from '@sniptt/guards';
-
-import { type CalendarEventParticipantBySpeakerName } from 'src/front-components/types/calendar-event-participant-by-speaker-name.type';
-import { type CalendarEventRecordingParticipant } from 'src/front-components/types/calendar-event-recording-participant.type';
-import { getSpeakerNameMatchKeys } from 'src/front-components/utils/get-speaker-name-match-keys.util';
-
-export const buildCalendarEventParticipantBySpeakerName = (
-  calendarEventParticipants: CalendarEventRecordingParticipant[],
-): CalendarEventParticipantBySpeakerName => {
-  const calendarEventParticipantBySpeakerName: CalendarEventParticipantBySpeakerName =
-    new Map();
-  const ambiguousSpeakerNameMatchKeys = new Set<string>();
-
-  for (const calendarEventParticipant of calendarEventParticipants) {
-    for (const nameCandidate of calendarEventParticipant.nameCandidates) {
-      const speakerNameMatchKeys = getSpeakerNameMatchKeys(nameCandidate);
-
-      for (const speakerNameMatchKey of speakerNameMatchKeys) {
-        const matchingCalendarEventParticipant =
-          calendarEventParticipantBySpeakerName.get(speakerNameMatchKey);
-
-        if (ambiguousSpeakerNameMatchKeys.has(speakerNameMatchKey)) {
-          continue;
-        }
-
-        if (isUndefined(matchingCalendarEventParticipant)) {
-          calendarEventParticipantBySpeakerName.set(
-            speakerNameMatchKey,
-            calendarEventParticipant,
-          );
-          continue;
-        }
-
-        if (
-          matchingCalendarEventParticipant.id !== calendarEventParticipant.id
-        ) {
-          calendarEventParticipantBySpeakerName.delete(speakerNameMatchKey);
-          ambiguousSpeakerNameMatchKeys.add(speakerNameMatchKey);
-        }
-      }
-    }
-  }
-
-  return calendarEventParticipantBySpeakerName;
-};

package/src/front-components/utils/find-active-transcript-entry-index.util.ts

@@ -1,77 +0,0 @@
-import { isUndefined } from '@sniptt/guards';
-
-import { type TranscriptEntry } from 'src/front-components/types/transcript-entry.type';
-
-export const findActiveTranscriptEntryIndex = (
-  entries: TranscriptEntry[],
-  currentTimeSeconds: number,
-): number => {
-  for (let entryIndex = entries.length - 1; entryIndex >= 0; entryIndex--) {
-    const entry = entries[entryIndex];
-
-    if (
-      isTranscriptEntryActive({
-        entries,
-        entry,
-        entryIndex,
-        currentTimeSeconds,
-      })
-    ) {
-      return entryIndex;
-    }
-  }
-
-  return -1;
-};
-
-const isTranscriptEntryActive = ({
-  entries,
-  entry,
-  entryIndex,
-  currentTimeSeconds,
-}: {
-  entries: TranscriptEntry[];
-  entry: TranscriptEntry;
-  entryIndex: number;
-  currentTimeSeconds: number;
-}): boolean => {
-  if (
-    isUndefined(entry.startSeconds) ||
-    currentTimeSeconds < entry.startSeconds
-  ) {
-    return false;
-  }
-
-  if (!isUndefined(entry.endSeconds)) {
-    return currentTimeSeconds <= entry.endSeconds;
-  }
-
-  const nextTranscriptEntryStartSeconds = findNextTranscriptEntryStartSeconds(
-    entries,
-    entryIndex,
-  );
-
-  return isUndefined(nextTranscriptEntryStartSeconds)
-    ? true
-    : currentTimeSeconds < nextTranscriptEntryStartSeconds;
-};
-
-const findNextTranscriptEntryStartSeconds = (
-  entries: TranscriptEntry[],
-  entryIndex: number,
-): number | undefined => {
-  for (
-    let nextEntryIndex = entryIndex + 1;
-    nextEntryIndex < entries.length;
-    nextEntryIndex++
-  ) {
-    const nextTranscriptEntryStartSeconds =
-      entries[nextEntryIndex].startSeconds;
-
-    if (!isUndefined(nextTranscriptEntryStartSeconds)) {
-      return nextTranscriptEntryStartSeconds;
-    }
-  }
-
-  return undefined;
-};

package/src/front-components/utils/format-transcript-timestamp.util.ts

@@ -1,16 +0,0 @@
-export const formatTranscriptTimestamp = (totalSeconds: number): string => {
-  const safeSeconds = Number.isFinite(totalSeconds)
-    ? Math.max(0, Math.floor(totalSeconds))
-    : 0;
-
-  const hours = Math.floor(safeSeconds / 3600);
-  const minutes = Math.floor((safeSeconds % 3600) / 60);
-  const seconds = safeSeconds % 60;
-  const paddedSeconds = String(seconds).padStart(2, '0');
-
-  if (hours > 0) {
-    return `${hours}:${String(minutes).padStart(2, '0')}:${paddedSeconds}`;
-  }
-
-  return `${minutes}:${paddedSeconds}`;
-};

package/src/front-components/utils/get-absolute-avatar-url.util.ts

@@ -1,48 +0,0 @@
-// Duplicates minimal front image URL logic for this app.
-// Remove once shared front utilities can be imported safely in front components.
-import { isNonEmptyString } from 'src/logic-functions/utils/is-non-empty-string.util';
-
-type GetImageAbsoluteUrlArgs = {
-  imageUrl: string;
-  baseUrl: string;
-};
-
-const getImageAbsoluteUrl = ({
-  imageUrl,
-  baseUrl,
-}: GetImageAbsoluteUrlArgs): string => {
-  const lowerCaseImageUrl = imageUrl.toLowerCase();
-  const isAlreadyAbsoluteUrl =
-    ['http:', 'https:', 'data:', 'blob:'].some((scheme) =>
-      lowerCaseImageUrl.startsWith(scheme),
-    ) || imageUrl.startsWith('//');
-
-  if (isAlreadyAbsoluteUrl) {
-    return imageUrl;
-  }
-
-  if (imageUrl.startsWith('/')) {
-    return new URL(`/files${imageUrl}`, baseUrl).toString();
-  }
-
-  return new URL(`/files/${imageUrl}`, baseUrl).toString();
-};
-
-export const getAbsoluteAvatarUrl = (
-  avatarUrl: string | null | undefined,
-): string | undefined => {
-  if (!isNonEmptyString(avatarUrl)) {
-    return undefined;
-  }
-
-  const apiBaseUrl = process.env.TWENTY_API_URL;
-
-  if (!isNonEmptyString(apiBaseUrl)) {
-    return avatarUrl.trim();
-  }
-
-  return getImageAbsoluteUrl({
-    imageUrl: avatarUrl.trim(),
-    baseUrl: apiBaseUrl,
-  });
-};

package/src/front-components/utils/get-calendar-event-participant-for-speaker-name.util.ts

@@ -1,24 +0,0 @@
-import { isUndefined } from '@sniptt/guards';
-
-import { type CalendarEventParticipantBySpeakerName } from 'src/front-components/types/calendar-event-participant-by-speaker-name.type';
-import { type CalendarEventRecordingParticipant } from 'src/front-components/types/calendar-event-recording-participant.type';
-import { getSpeakerNameMatchKeys } from 'src/front-components/utils/get-speaker-name-match-keys.util';
-
-export const getCalendarEventParticipantForSpeakerName = ({
-  speakerName,
-  calendarEventParticipantBySpeakerName,
-}: {
-  speakerName: string;
-  calendarEventParticipantBySpeakerName: CalendarEventParticipantBySpeakerName;
-}): CalendarEventRecordingParticipant | undefined => {
-  for (const speakerNameMatchKey of getSpeakerNameMatchKeys(speakerName)) {
-    const calendarEventParticipant =
-      calendarEventParticipantBySpeakerName.get(speakerNameMatchKey);
-
-    if (!isUndefined(calendarEventParticipant)) {
-      return calendarEventParticipant;
-    }
-  }
-
-  return undefined;
-};

package/src/front-components/utils/get-speaker-name-match-keys.util.ts

@@ -1,64 +0,0 @@
-import { isNonEmptyString } from 'src/logic-functions/utils/is-non-empty-string.util';
-
-const MINIMUM_FUZZY_MATCH_KEY_LENGTH = 5;
-
-export const getSpeakerNameMatchKeys = (speakerName: string): string[] => {
-  const normalizedSpeakerName = normalizeSpeakerName(speakerName);
-  const compactSpeakerName = getCompactSpeakerName(normalizedSpeakerName);
-  const compactSpeakerNameWithoutDigits = compactSpeakerName.replace(/\d/g, '');
-  const abbreviatedSpeakerNameMatchKey = getAbbreviatedSpeakerNameMatchKey(
-    normalizedSpeakerName,
-  );
-
-  return [
-    ...new Set(
-      [
-        normalizedSpeakerName,
-        compactSpeakerName,
-        compactSpeakerNameWithoutDigits,
-        abbreviatedSpeakerNameMatchKey,
-      ].filter(isSpeakerNameMatchKey),
-    ),
-  ];
-};
-
-const normalizeSpeakerName = (speakerName: string): string =>
-  speakerName
-    .trim()
-    .normalize('NFD')
-    .replace(/[\u0300-\u036f]/g, '')
-    .toLocaleLowerCase();
-
-const getCompactSpeakerName = (speakerName: string): string =>
-  normalizeSpeakerName(speakerName).replace(/[^a-z0-9]/g, '');
-
-const getAbbreviatedSpeakerNameMatchKey = (
-  speakerName: string,
-): string | undefined => {
-  const speakerNameParts = normalizeSpeakerName(speakerName)
-    .split(/\s+/)
-    .map(getCompactSpeakerName)
-    .filter(isNonEmptyString);
-
-  if (speakerNameParts.length < 2) {
-    return undefined;
-  }
-
-  const firstSpeakerNamePart = speakerNameParts[0];
-  const lastSpeakerNamePart = speakerNameParts[speakerNameParts.length - 1];
-  const abbreviatedSpeakerNameMatchKey = `${firstSpeakerNamePart.slice(
-    0,
-    4,
-  )}${lastSpeakerNamePart.slice(0, 4)}`;
-
-  return abbreviatedSpeakerNameMatchKey.length >= MINIMUM_FUZZY_MATCH_KEY_LENGTH
-    ? abbreviatedSpeakerNameMatchKey
-    : undefined;
-};
-
-const isSpeakerNameMatchKey = (
-  speakerNameMatchKey: string | undefined,
-): speakerNameMatchKey is string =>
-  isNonEmptyString(speakerNameMatchKey) &&
-  (speakerNameMatchKey.includes(' ') ||
-    speakerNameMatchKey.length >= MINIMUM_FUZZY_MATCH_KEY_LENGTH);

package/src/front-components/utils/get-video-file-extension.util.ts

@@ -1,23 +0,0 @@
-import { isUndefined } from '@sniptt/guards';
-
-import { isNonEmptyString } from 'src/logic-functions/utils/is-non-empty-string.util';
-
-export const getVideoFileExtension = ({
-  extension,
-  label,
-}: {
-  extension: string | null;
-  label: string | null;
-}): string | undefined => {
-  const labelParts = label?.split('.');
-  const videoFileExtension =
-    extension ??
-    (isUndefined(labelParts) ? undefined : labelParts[labelParts.length - 1]);
-  const normalizedVideoFileExtension = videoFileExtension
-    ?.toLowerCase()
-    .replace(/^\./, '');
-
-  return isNonEmptyString(normalizedVideoFileExtension)
-    ? normalizedVideoFileExtension
-    : undefined;
-};

package/src/front-components/utils/parse-transcript-entries.util.ts

@@ -1,85 +0,0 @@
-import { isArray, isNumber, isUndefined } from '@sniptt/guards';
-
-import {
-  type TranscriptEntry,
-  type TranscriptWord,
-} from 'src/front-components/types/transcript-entry.type';
-import { asRecord } from 'src/logic-functions/utils/as-record.util';
-import { isNonEmptyString } from 'src/logic-functions/utils/is-non-empty-string.util';
-
-type TranscriptRecord = NonNullable<ReturnType<typeof asRecord>>;
-
-const isTranscriptRecord = (
-  candidate: TranscriptRecord | undefined,
-): candidate is TranscriptRecord => !isUndefined(candidate);
-
-const readRelativeTimestamp = (
-  timestamp: TranscriptRecord | undefined,
-): number | undefined => {
-  const relativeTimestamp = timestamp?.relative;
-
-  return isNumber(relativeTimestamp) && Number.isFinite(relativeTimestamp)
-    ? relativeTimestamp
-    : undefined;
-};
-
-const readTranscriptWord = (
-  candidate: TranscriptRecord,
-): TranscriptWord | undefined => {
-  if (!isNonEmptyString(candidate.text)) {
-    return undefined;
-  }
-
-  return {
-    text: candidate.text.trim(),
-    startSeconds: readRelativeTimestamp(asRecord(candidate.start_timestamp)),
-    endSeconds: readRelativeTimestamp(asRecord(candidate.end_timestamp)),
-  };
-};
-
-const readSpeakerName = (participant: TranscriptRecord | undefined): string => {
-  const name = participant?.name;
-
-  return isNonEmptyString(name) ? name.trim() : 'Unknown speaker';
-};
-
-const readTranscriptEntry = (
-  candidate: TranscriptRecord,
-): TranscriptEntry | undefined => {
-  if (!isArray(candidate.words)) {
-    return undefined;
-  }
-
-  const words = candidate.words
-    .map(asRecord)
-    .filter(isTranscriptRecord)
-    .map(readTranscriptWord)
-    .filter((word): word is TranscriptWord => !isUndefined(word));
-
-  if (words.length === 0) {
-    return undefined;
-  }
-
-  return {
-    speakerName: readSpeakerName(asRecord(candidate.participant)),
-    startSeconds: words[0].startSeconds,
-    endSeconds: words[words.length - 1].endSeconds,
-    text: words.map((word) => word.text).join(' '),
-    words,
-  };
-};
-
-// Undefined means the value is not a diarized transcript; malformed entries are skipped, not fatal.
-export const parseTranscriptEntries = (
-  transcript: unknown,
-): TranscriptEntry[] | undefined => {
-  if (!isArray(transcript)) {
-    return undefined;
-  }
-
-  return transcript
-    .map(asRecord)
-    .filter(isTranscriptRecord)
-    .map(readTranscriptEntry)
-    .filter((entry): entry is TranscriptEntry => !isUndefined(entry));
-};

package/src/logic-functions/__tests__/process-recall-webhook.test.ts

@@ -1,62 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-
-import processRecallWebhookLogicFunction, {
-  processRecallWebhookHandler,
-} from 'src/logic-functions/process-recall-webhook';
-
-const handleRecallWebhookMock = vi.hoisted(() => vi.fn());
-const coreApiClientMock = vi.hoisted(() => vi.fn());
-
-vi.mock('src/logic-functions/flows/handle-recall-webhook.util', () => ({
-  handleRecallWebhook: handleRecallWebhookMock,
-}));
-
-vi.mock('twenty-client-sdk/core', () => ({
-  CoreApiClient: coreApiClientMock,
-}));
-
-const buildRecordingDoneWebhookBody = () => ({
-  event: 'recording.done',
-  data: {
-    bot: {
-      id: 'recall-bot-1',
-      metadata: {
-        twentyWorkspaceId: '123e4567-e89b-12d3-a456-426614174000',
-        twentyCallRecordingId: 'call-recording-1',
-      },
-    },
-    recording: { id: 'recall-recording-1' },
-  },
-});
-
-describe('process-recall-webhook', () => {
-  beforeEach(() => {
-    handleRecallWebhookMock.mockReset();
-    handleRecallWebhookMock.mockResolvedValue({ status: 'updated' });
-    coreApiClientMock.mockReset();
-  });
-
-  it('declares no external trigger so it only runs when dispatched by the resolver', () => {
-    expect(processRecallWebhookLogicFunction.success).toBe(true);
-    expect(
-      'serverRouteTriggerSettings' in processRecallWebhookLogicFunction.config,
-    ).toBe(false);
-    expect(
-      processRecallWebhookLogicFunction.config.httpRouteTriggerSettings,
-    ).toBeUndefined();
-  });
-
-  it('forwards the resolved payload to handleRecallWebhook with a workspace-scoped client', async () => {
-    const body = buildRecordingDoneWebhookBody();
-
-    const result = await processRecallWebhookHandler(body);
-
-    expect(coreApiClientMock).toHaveBeenCalledTimes(1);
-    expect(handleRecallWebhookMock).toHaveBeenCalledTimes(1);
-    expect(handleRecallWebhookMock).toHaveBeenCalledWith({
-      client: coreApiClientMock.mock.instances[0],
-      body,
-    });
-    expect(result).toEqual({ status: 'updated' });
-  });
-});