@twentyhq/call-recorder 1.0.1 → 1.0.2

package/src/logic-functions/data/fetch-all-nodes.util.ts

@@ -1,44 +0,0 @@
-import { isString, isUndefined } from '@sniptt/guards';
-
-export type ConnectionPage<TNode> = {
-  pageInfo?: {
-    hasNextPage?: boolean | null;
-    endCursor?: string | null;
-  } | null;
-  edges?: Array<{ node: TNode }> | null;
-};
-
-export const fetchAllNodes = async <TNode>(
-  fetchPage: (
-    afterCursor: string | undefined,
-  ) => Promise<ConnectionPage<TNode> | undefined>,
-): Promise<TNode[]> => {
-  const nodes: TNode[] = [];
-  let hasNextPage = true;
-  let afterCursor: string | undefined;
-
-  while (hasNextPage) {
-    const connection = await fetchPage(afterCursor);
-
-    if (isUndefined(connection)) {
-      throw new Error('Pagination query returned no connection');
-    }
-
-    for (const edge of connection.edges ?? []) {
-      nodes.push(edge.node);
-    }
-
-    hasNextPage = connection.pageInfo?.hasNextPage === true;
-    const endCursor = connection.pageInfo?.endCursor;
-
-    if (hasNextPage && !isString(endCursor)) {
-      throw new Error(
-        'Inconsistent pagination state: hasNextPage is true without an endCursor',
-      );
-    }
-
-    afterCursor = isString(endCursor) ? endCursor : undefined;
-  }
-
-  return nodes;
-};

package/src/logic-functions/data/fetch-calendar-events-by-filter.util.ts

@@ -1,80 +0,0 @@
-import { isString, isUndefined } from '@sniptt/guards';
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { TWENTY_PAGE_SIZE } from 'src/logic-functions/constants/twenty-page-size';
-import { type CalendarEventRecord } from 'src/logic-functions/types/calendar-event-record.type';
-import {
-  fetchAllNodes,
-  type ConnectionPage,
-} from 'src/logic-functions/data/fetch-all-nodes.util';
-import { isNonEmptyString } from 'src/logic-functions/utils/is-non-empty-string.util';
-import { stripRestrictedFieldValue } from 'src/logic-functions/data/strip-restricted-field-value.util';
-
-type CalendarEventNode = {
-  id: string;
-  title?: string | null;
-  isCanceled?: boolean | null;
-  startsAt?: string | null;
-  endsAt?: string | null;
-  iCalUid?: string | null;
-  conferenceLink?: { primaryLinkUrl?: string | null } | null;
-  callRecorderPreference?: string | null;
-};
-
-export const fetchCalendarEventsByFilter = async (
-  client: CoreApiClient,
-  filter: Record<string, unknown>,
-): Promise<CalendarEventRecord[]> => {
-  const calendarEventNodes = await fetchAllNodes<CalendarEventNode>(
-    async (afterCursor) => {
-      const queryResult = await client.query({
-        calendarEvents: {
-          __args: {
-            filter,
-            first: TWENTY_PAGE_SIZE,
-            ...(isUndefined(afterCursor) ? {} : { after: afterCursor }),
-          },
-          pageInfo: {
-            hasNextPage: true,
-            endCursor: true,
-          },
-          edges: {
-            node: {
-              id: true,
-              title: true,
-              isCanceled: true,
-              startsAt: true,
-              endsAt: true,
-              iCalUid: true,
-              conferenceLink: {
-                primaryLinkUrl: true,
-              },
-              callRecorderPreference: true,
-            },
-          },
-        },
-      });
-
-      return queryResult.calendarEvents as
-        | ConnectionPage<CalendarEventNode>
-        | undefined;
-    },
-  );
-
-  return calendarEventNodes.map((calendarEvent) => ({
-    id: calendarEvent.id,
-    title: stripRestrictedFieldValue(calendarEvent.title ?? undefined),
-    isCanceled: calendarEvent.isCanceled ?? false,
-    startsAt: calendarEvent.startsAt ?? undefined,
-    endsAt: calendarEvent.endsAt ?? undefined,
-    iCalUid: calendarEvent.iCalUid ?? undefined,
-    conferenceLinkUrl: isNonEmptyString(
-      calendarEvent.conferenceLink?.primaryLinkUrl,
-    )
-      ? calendarEvent.conferenceLink.primaryLinkUrl
-      : undefined,
-    callRecorderPreference: isString(calendarEvent.callRecorderPreference)
-      ? calendarEvent.callRecorderPreference
-      : undefined,
-  }));
-};

package/src/logic-functions/data/fetch-calendar-events-by-ids.util.ts

@@ -1,20 +0,0 @@
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { type CalendarEventRecord } from 'src/logic-functions/types/calendar-event-record.type';
-import { fetchCalendarEventsByFilter } from 'src/logic-functions/data/fetch-calendar-events-by-filter.util';
-import { getUniqueSortedIds } from 'src/logic-functions/utils/get-unique-sorted-ids.util';
-
-export const fetchCalendarEventsByIds = async (
-  client: CoreApiClient,
-  calendarEventIds: string[],
-): Promise<CalendarEventRecord[]> => {
-  const uniqueCalendarEventIds = getUniqueSortedIds(calendarEventIds);
-
-  if (uniqueCalendarEventIds.length === 0) {
-    return [];
-  }
-
-  return fetchCalendarEventsByFilter(client, {
-    id: { in: uniqueCalendarEventIds },
-  });
-};

package/src/logic-functions/data/fetch-calendar-events-by-starts-at-values.util.ts

@@ -1,19 +0,0 @@
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { type CalendarEventRecord } from 'src/logic-functions/types/calendar-event-record.type';
-import { fetchCalendarEventsByFilter } from 'src/logic-functions/data/fetch-calendar-events-by-filter.util';
-
-export const fetchCalendarEventsByStartsAtValues = async (
-  client: CoreApiClient,
-  startsAtValues: string[],
-): Promise<CalendarEventRecord[]> => {
-  const uniqueStartsAtValues = [...new Set(startsAtValues)].sort();
-
-  if (uniqueStartsAtValues.length === 0) {
-    return [];
-  }
-
-  return fetchCalendarEventsByFilter(client, {
-    startsAt: { in: uniqueStartsAtValues },
-  });
-};

package/src/logic-functions/data/find-call-recordings-by-calendar-event-ids.util.ts

@@ -1,17 +0,0 @@
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { type CallRecordingRecord } from 'src/logic-functions/types/call-recording-record.type';
-import { findCallRecordingsByFilter } from 'src/logic-functions/data/find-call-recordings-by-filter.util';
-
-export const findCallRecordingsByCalendarEventIds = async (
-  client: CoreApiClient,
-  calendarEventIds: string[],
-): Promise<CallRecordingRecord[]> => {
-  if (calendarEventIds.length === 0) {
-    return [];
-  }
-
-  return findCallRecordingsByFilter(client, {
-    calendarEventId: { in: calendarEventIds },
-  });
-};

package/src/logic-functions/data/find-call-recordings-by-filter.util.ts

@@ -1,102 +0,0 @@
-import { isUndefined } from '@sniptt/guards';
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { CallRecordingRequestStatus } from 'src/logic-functions/constants/call-recording-request-status';
-import { TWENTY_PAGE_SIZE } from 'src/logic-functions/constants/twenty-page-size';
-import { type CallRecordingRecord } from 'src/logic-functions/types/call-recording-record.type';
-import {
-  fetchAllNodes,
-  type ConnectionPage,
-} from 'src/logic-functions/data/fetch-all-nodes.util';
-import { isNonEmptyString } from 'src/logic-functions/utils/is-non-empty-string.util';
-
-type CallRecordingNode = {
-  id: string;
-  title?: string | null;
-  status?: string | null;
-  recordingRequestStatus?: unknown;
-  startedAt?: string | null;
-  endedAt?: string | null;
-  calendarEventId?: string | null;
-  externalBotId?: string | null;
-  externalRecordingId?: string | null;
-  callRecorderFailureReason?: string | null;
-};
-
-export const findCallRecordingsByFilter = async (
-  client: CoreApiClient,
-  filter: Record<string, unknown>,
-): Promise<CallRecordingRecord[]> => {
-  const callRecordingNodes = await fetchAllNodes<CallRecordingNode>(
-    async (afterCursor) => {
-      const queryResult = await client.query({
-        callRecordings: {
-          __args: {
-            filter,
-            first: TWENTY_PAGE_SIZE,
-            ...(isUndefined(afterCursor) ? {} : { after: afterCursor }),
-          },
-          pageInfo: {
-            hasNextPage: true,
-            endCursor: true,
-          },
-          edges: {
-            node: {
-              id: true,
-              title: true,
-              status: true,
-              recordingRequestStatus: true,
-              startedAt: true,
-              endedAt: true,
-              calendarEventId: true,
-              externalBotId: true,
-              externalRecordingId: true,
-              callRecorderFailureReason: true,
-            },
-          },
-        },
-      });
-
-      return queryResult.callRecordings as
-        | ConnectionPage<CallRecordingNode>
-        | undefined;
-    },
-  );
-
-  return callRecordingNodes.map((callRecording) => ({
-    id: callRecording.id,
-    title: callRecording.title ?? undefined,
-    status: callRecording.status ?? undefined,
-    recordingRequestStatus: normalizeCallRecordingRequestStatus(
-      callRecording.recordingRequestStatus,
-    ),
-    startedAt: callRecording.startedAt ?? undefined,
-    endedAt: callRecording.endedAt ?? undefined,
-    calendarEventId: callRecording.calendarEventId ?? undefined,
-    externalBotId: normalizeOptionalString(callRecording.externalBotId),
-    externalRecordingId: normalizeOptionalString(
-      callRecording.externalRecordingId,
-    ),
-    callRecorderFailureReason: normalizeOptionalString(
-      callRecording.callRecorderFailureReason,
-    ),
-  }));
-};
-
-const normalizeOptionalString = (
-  value: string | null | undefined,
-): string | undefined => (isNonEmptyString(value) ? value : undefined);
-
-const normalizeCallRecordingRequestStatus = (
-  recordingRequestStatus: unknown,
-): CallRecordingRequestStatus | undefined => {
-  if (recordingRequestStatus === CallRecordingRequestStatus.REQUESTED) {
-    return recordingRequestStatus;
-  }
-
-  if (recordingRequestStatus === CallRecordingRequestStatus.CANCELED) {
-    return recordingRequestStatus;
-  }
-
-  return undefined;
-};

package/src/logic-functions/data/find-call-recordings-by-ids.util.ts

@@ -1,17 +0,0 @@
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { type CallRecordingRecord } from 'src/logic-functions/types/call-recording-record.type';
-import { findCallRecordingsByFilter } from 'src/logic-functions/data/find-call-recordings-by-filter.util';
-
-export const findCallRecordingsByIds = async (
-  client: CoreApiClient,
-  callRecordingIds: string[],
-): Promise<CallRecordingRecord[]> => {
-  if (callRecordingIds.length === 0) {
-    return [];
-  }
-
-  return findCallRecordingsByFilter(client, {
-    id: { in: callRecordingIds },
-  });
-};

package/src/logic-functions/data/find-open-scheduled-call-recordings.util.ts

@@ -1,14 +0,0 @@
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { CallRecordingRequestStatus } from 'src/logic-functions/constants/call-recording-request-status';
-import { CallRecordingStatus } from 'src/logic-functions/constants/call-recording-status';
-import { type CallRecordingRecord } from 'src/logic-functions/types/call-recording-record.type';
-import { findCallRecordingsByFilter } from 'src/logic-functions/data/find-call-recordings-by-filter.util';
-
-export const findOpenScheduledCallRecordings = async (
-  client: CoreApiClient,
-): Promise<CallRecordingRecord[]> =>
-  findCallRecordingsByFilter(client, {
-    recordingRequestStatus: { eq: CallRecordingRequestStatus.REQUESTED },
-    status: { eq: CallRecordingStatus.SCHEDULED },
-  });

package/src/logic-functions/data/get-current-workspace-id.util.ts

@@ -1,36 +0,0 @@
-import { isUndefined } from '@sniptt/guards';
-
-import { asRecord } from 'src/logic-functions/utils/as-record.util';
-import { getString } from 'src/logic-functions/utils/get-string.util';
-
-const APP_ACCESS_TOKEN_ENV_VAR_NAME = 'TWENTY_APP_ACCESS_TOKEN';
-
-export const getCurrentWorkspaceId = (): string | undefined => {
-  const accessToken = getString(process.env[APP_ACCESS_TOKEN_ENV_VAR_NAME]);
-
-  if (isUndefined(accessToken)) {
-    return undefined;
-  }
-
-  return getWorkspaceIdFromAccessToken(accessToken);
-};
-
-const getWorkspaceIdFromAccessToken = (
-  accessToken: string,
-): string | undefined => {
-  const encodedPayload = accessToken.split('.')[1];
-
-  if (isUndefined(encodedPayload)) {
-    return undefined;
-  }
-
-  try {
-    const payload = asRecord(
-      JSON.parse(Buffer.from(encodedPayload, 'base64url').toString('utf8')),
-    );
-
-    return getString(payload?.workspaceId);
-  } catch {
-    return undefined;
-  }
-};

package/src/logic-functions/data/strip-restricted-field-value.util.ts

@@ -1,6 +0,0 @@
-import { RESTRICTED_FIELD_PLACEHOLDER } from 'src/logic-functions/constants/restricted-field-placeholder';
-
-export const stripRestrictedFieldValue = (
-  value: string | undefined,
-): string | undefined =>
-  value === RESTRICTED_FIELD_PLACEHOLDER ? undefined : value;

package/src/logic-functions/data/update-call-recording.util.ts

@@ -1,24 +0,0 @@
-import { type CoreApiClient } from 'twenty-client-sdk/core';
-
-import { type CallRecordingUpdateFields } from 'src/logic-functions/types/call-recording-update-fields.type';
-
-export const updateCallRecording = async (
-  client: CoreApiClient,
-  {
-    id,
-    data,
-  }: {
-    id: string;
-    data: CallRecordingUpdateFields;
-  },
-): Promise<void> => {
-  await client.mutation({
-    updateCallRecording: {
-      __args: {
-        id,
-        data,
-      },
-      id: true,
-    },
-  });
-};

package/src/logic-functions/domain/__tests__/build-call-recorder-policy-result.test.ts

@@ -1,47 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { buildCallRecorderPolicyResult } from 'src/logic-functions/domain/build-call-recorder-policy-result.util';
-import { type CallRecorderPolicyCalendarEventInput } from 'src/logic-functions/types/call-recorder-policy-calendar-event-input.type';
-
-const NOW = new Date('2026-01-01T12:00:00.000Z');
-
-const buildCalendarEventInput = (
-  overrides: Partial<CallRecorderPolicyCalendarEventInput>,
-): CallRecorderPolicyCalendarEventInput => ({
-  id: 'calendar-event-1',
-  isCanceled: false,
-  startsAt: '2026-01-01T13:00:00.000Z',
-  endsAt: '2026-01-01T14:00:00.000Z',
-  iCalUid: 'ical-uid-1',
-  conferenceLinkUrl: 'https://meet.example.com/customer-sync',
-  callRecorderPreference: undefined,
-  ...overrides,
-});
-
-describe('buildCallRecorderPolicyResult', () => {
-  it('requests a bot for the ON wire value', () => {
-    const policyResult = buildCallRecorderPolicyResult(
-      buildCalendarEventInput({
-        callRecorderPreference: 'ON',
-      }),
-      NOW,
-    );
-
-    expect(policyResult.callRecorderPreference).toBe('ON');
-    expect(policyResult.shouldRequestBot).toBe(true);
-    expect(policyResult.reason).toBe('RECORDING_ENABLED');
-  });
-
-  it('does not request a bot for the OFF wire value', () => {
-    const policyResult = buildCallRecorderPolicyResult(
-      buildCalendarEventInput({
-        callRecorderPreference: 'OFF',
-      }),
-      NOW,
-    );
-
-    expect(policyResult.callRecorderPreference).toBe('OFF');
-    expect(policyResult.shouldRequestBot).toBe(false);
-    expect(policyResult.reason).toBe('PREFERENCE_OFF');
-  });
-});

package/src/logic-functions/domain/__tests__/compute-call-recording-charge.test.ts

@@ -1,71 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { computeCallRecordingCharge } from 'src/logic-functions/domain/compute-call-recording-charge.util';
-
-describe('computeCallRecordingCharge', () => {
-  it('charges one credit for a one-hour recording', () => {
-    expect(
-      computeCallRecordingCharge({
-        startedAt: '2026-06-10T09:00:00.000Z',
-        endedAt: '2026-06-10T10:00:00.000Z',
-      }),
-    ).toEqual({
-      creditsUsedMicro: 1_000_000,
-      quantityMinutes: 60,
-    });
-  });
-
-  it('prorates partial hours by duration', () => {
-    expect(
-      computeCallRecordingCharge({
-        startedAt: '2026-06-10T09:00:00.000Z',
-        endedAt: '2026-06-10T09:45:00.000Z',
-      }),
-    ).toEqual({
-      creditsUsedMicro: 750_000,
-      quantityMinutes: 45,
-    });
-  });
-
-  it('reports at least one minute for very short recordings', () => {
-    expect(
-      computeCallRecordingCharge({
-        startedAt: '2026-06-10T09:00:00.000Z',
-        endedAt: '2026-06-10T09:00:30.000Z',
-      }),
-    ).toEqual({
-      creditsUsedMicro: 8_333,
-      quantityMinutes: 1,
-    });
-  });
-
-  it('returns undefined when either timestamp is missing', () => {
-    expect(
-      computeCallRecordingCharge({
-        startedAt: undefined,
-        endedAt: '2026-06-10T10:00:00.000Z',
-      }),
-    ).toBeUndefined();
-    expect(
-      computeCallRecordingCharge({
-        startedAt: '2026-06-10T09:00:00.000Z',
-        endedAt: undefined,
-      }),
-    ).toBeUndefined();
-  });
-
-  it('returns undefined for non-positive or unparseable durations', () => {
-    expect(
-      computeCallRecordingCharge({
-        startedAt: '2026-06-10T10:00:00.000Z',
-        endedAt: '2026-06-10T09:00:00.000Z',
-      }),
-    ).toBeUndefined();
-    expect(
-      computeCallRecordingCharge({
-        startedAt: 'not-a-date',
-        endedAt: '2026-06-10T10:00:00.000Z',
-      }),
-    ).toBeUndefined();
-  });
-});

package/src/logic-functions/domain/__tests__/compute-call-recording-id-for-meeting.test.ts

@@ -1,37 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { computeCallRecordingIdForMeeting } from 'src/logic-functions/domain/compute-call-recording-id-for-meeting.util';
-
-const UUID_V4_PATTERN =
-  /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
-
-describe('computeCallRecordingIdForMeeting', () => {
-  it('returns the same id for the same real meeting key', () => {
-    const realMeetingKey =
-      'link:meet.example.com/sync:2026-01-01T13:00:00.000Z';
-
-    expect(computeCallRecordingIdForMeeting(realMeetingKey)).toBe(
-      computeCallRecordingIdForMeeting(realMeetingKey),
-    );
-  });
-
-  it('returns different ids for different real meeting keys', () => {
-    expect(
-      computeCallRecordingIdForMeeting(
-        'link:meet.example.com/sync:2026-01-01T13:00:00.000Z',
-      ),
-    ).not.toBe(
-      computeCallRecordingIdForMeeting(
-        'link:meet.example.com/sync:2026-01-02T13:00:00.000Z',
-      ),
-    );
-  });
-
-  it('returns a v4-shaped uuid', () => {
-    expect(
-      computeCallRecordingIdForMeeting(
-        'ical:some-uid:2026-01-01T13:00:00.000Z',
-      ),
-    ).toMatch(UUID_V4_PATTERN);
-  });
-});

package/src/logic-functions/domain/__tests__/compute-real-meeting-key.test.ts

@@ -1,88 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { computeRealMeetingKey } from 'src/logic-functions/domain/compute-real-meeting-key.util';
-
-const STARTS_AT = '2026-01-01T13:00:00.000Z';
-
-const buildInput = (
-  overrides: Partial<Parameters<typeof computeRealMeetingKey>[0]> = {},
-) => ({
-  calendarEventId: 'calendar-event-1',
-  conferenceLinkUrl: 'https://meet.example.com/customer-sync',
-  iCalUid: 'calendar-event-uid',
-  startsAt: STARTS_AT,
-  ...overrides,
-});
-
-describe('computeRealMeetingKey', () => {
-  it.each([
-    [
-      'strips protocol, query, and fragment',
-      'https://zoom.us/j/123?pwd=abc#section',
-      `link:zoom.us/j/123:${STARTS_AT}`,
-    ],
-    [
-      'strips www and lowercases',
-      'HTTPS://WWW.Meet.Example.com/Customer-Sync',
-      `link:meet.example.com/customer-sync:${STARTS_AT}`,
-    ],
-    [
-      'strips trailing slashes',
-      'https://meet.example.com/customer-sync///',
-      `link:meet.example.com/customer-sync:${STARTS_AT}`,
-    ],
-    [
-      'supports plain http links',
-      'http://meet.example.com/customer-sync',
-      `link:meet.example.com/customer-sync:${STARTS_AT}`,
-    ],
-  ])('%s', (_label, conferenceLinkUrl, expectedKey) => {
-    expect(computeRealMeetingKey(buildInput({ conferenceLinkUrl }))).toBe(
-      expectedKey,
-    );
-  });
-
-  it('produces the same key for the same meeting synced from two calendars', () => {
-    const fromFirstAttendee = computeRealMeetingKey(
-      buildInput({
-        calendarEventId: 'calendar-event-1',
-        conferenceLinkUrl: 'https://zoom.us/j/123?pwd=first-attendee-token',
-      }),
-    );
-    const fromSecondAttendee = computeRealMeetingKey(
-      buildInput({
-        calendarEventId: 'calendar-event-2',
-        conferenceLinkUrl:
-          'https://www.zoom.us/j/123?pwd=second-attendee-token',
-      }),
-    );
-
-    expect(fromFirstAttendee).toBe(fromSecondAttendee);
-  });
-
-  it('falls back to the iCal uid when the link is blank', () => {
-    expect(
-      computeRealMeetingKey(buildInput({ conferenceLinkUrl: '   ' })),
-    ).toBe(`ical:calendar-event-uid:${STARTS_AT}`);
-  });
-
-  it('falls back to the iCal uid when the link is not a string', () => {
-    expect(computeRealMeetingKey(buildInput({ conferenceLinkUrl: 42 }))).toBe(
-      `ical:calendar-event-uid:${STARTS_AT}`,
-    );
-  });
-
-  it('falls back to the calendar event id when link and iCal uid are missing', () => {
-    expect(
-      computeRealMeetingKey(
-        buildInput({ conferenceLinkUrl: undefined, iCalUid: '' }),
-      ),
-    ).toBe('event:calendar-event-1');
-  });
-
-  it('keeps link keys distinct across start times', () => {
-    expect(computeRealMeetingKey(buildInput({ startsAt: undefined }))).toBe(
-      'link:meet.example.com/customer-sync:',
-    );
-  });
-});