@twentyhq/call-recorder 1.0.0

package/src/logic-functions/types/meeting-recording.type.ts

@@ -0,0 +1,7 @@
+import { type CalendarEventRecord } from 'src/logic-functions/types/calendar-event-record.type';
+import { type CallRecordingRecord } from 'src/logic-functions/types/call-recording-record.type';
+
+export type MeetingRecording = {
+  callRecording: CallRecordingRecord;
+  calendarEvent: CalendarEventRecord;
+};

package/src/logic-functions/types/recall-bot-operation-result.type.ts

@@ -0,0 +1,19 @@
+export type RecallBotOperationFailure = {
+  ok: false;
+  // null = no HTTP response (network failure), distinct from any status code.
+  status: number | null;
+  errorMessage: string;
+};
+
+export type RecallBotScheduleResult =
+  | {
+      ok: true;
+      externalBotId: string;
+    }
+  | RecallBotOperationFailure;
+
+export type RecallBotRemovalResult =
+  | {
+      ok: true;
+    }
+  | RecallBotOperationFailure;

package/src/logic-functions/types/recall-routing-metadata.type.ts

@@ -0,0 +1,4 @@
+export type RecallRoutingMetadata = {
+  twentyWorkspaceId: string;
+  twentyCallRecordingId: string;
+};

package/src/logic-functions/types/removed-call-recorder-occurrence.type.ts

@@ -0,0 +1,6 @@
+// An occurrence whose event was deleted/moved; key + start re-checks siblings.
+export type RemovedCallRecorderOccurrence = {
+  calendarEventId: string;
+  realMeetingKey: string;
+  startsAt: string | undefined;
+};

package/src/logic-functions/types/transcript-marker.type.ts

@@ -0,0 +1,6 @@
+export type TranscriptMarker = {
+  recallTranscriptId: string | null;
+  status: 'PENDING' | 'FAILED';
+  requestedAt?: string;
+  subCode?: string | null;
+};

package/src/logic-functions/utils/as-record.util.ts

@@ -0,0 +1,6 @@
+import { isArray, isObject } from '@sniptt/guards';
+
+export const asRecord = (value: unknown): Record<string, unknown> | undefined =>
+  isObject(value) && !isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;

package/src/logic-functions/utils/get-application-variable-value.util.ts

@@ -0,0 +1,3 @@
+// Application and server variables are injected into process.env on every execution.
+export const getApplicationVariableValue = (key: string): string | undefined =>
+  process.env[key];

package/src/logic-functions/utils/get-record-at-path.util.ts

@@ -0,0 +1,10 @@
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+
+export const getRecordAtPath = (
+  record: Record<string, unknown> | undefined,
+  path: string[],
+): unknown =>
+  path.reduce<unknown>(
+    (currentValue, pathPart) => asRecord(currentValue)?.[pathPart],
+    record,
+  );

package/src/logic-functions/utils/get-string.util.ts

@@ -0,0 +1,4 @@
+import { isNonEmptyString } from 'src/logic-functions/utils/is-non-empty-string.util';
+
+export const getString = (value: unknown): string | undefined =>
+  isNonEmptyString(value) ? value : undefined;

package/src/logic-functions/utils/get-unique-sorted-ids.util.ts

@@ -0,0 +1,8 @@
+import { isString } from '@sniptt/guards';
+
+export const getUniqueSortedIds = (
+  ids: Array<string | null | undefined>,
+): string[] =>
+  [...new Set(ids.filter(isString))].sort((firstId, secondId) =>
+    firstId.localeCompare(secondId),
+  );

package/src/logic-functions/utils/is-non-empty-string.util.ts

@@ -0,0 +1,5 @@
+import { isString } from '@sniptt/guards';
+
+// Trimming variant of @sniptt/guards isNonEmptyString, for normalizing at read boundaries.
+export const isNonEmptyString = (value: unknown): value is string =>
+  isString(value) && value.trim() !== '';

package/src/page-layouts/calendar-event-recording-tab.ts

@@ -0,0 +1,33 @@
+import {
+  definePageLayoutTab,
+  PageLayoutTabLayoutMode,
+} from 'twenty-sdk/define';
+
+import { CALENDAR_EVENT_RECORD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIER } from 'src/constants/calendar-event-record-page-layout-universal-identifier';
+import { CALENDAR_EVENT_RECORDING_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from 'src/constants/calendar-event-recording-front-component-universal-identifier';
+import { CALENDAR_EVENT_RECORDING_PAGE_LAYOUT_TAB_UNIVERSAL_IDENTIFIER } from 'src/constants/calendar-event-recording-page-layout-tab-universal-identifier';
+import { CALENDAR_EVENT_RECORDING_PAGE_LAYOUT_WIDGET_UNIVERSAL_IDENTIFIER } from 'src/constants/calendar-event-recording-page-layout-widget-universal-identifier';
+
+export default definePageLayoutTab({
+  universalIdentifier:
+    CALENDAR_EVENT_RECORDING_PAGE_LAYOUT_TAB_UNIVERSAL_IDENTIFIER,
+  title: 'Call Recording',
+  position: 15,
+  icon: 'IconVideo',
+  layoutMode: PageLayoutTabLayoutMode.CANVAS,
+  pageLayoutUniversalIdentifier:
+    CALENDAR_EVENT_RECORD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIER,
+  widgets: [
+    {
+      universalIdentifier:
+        CALENDAR_EVENT_RECORDING_PAGE_LAYOUT_WIDGET_UNIVERSAL_IDENTIFIER,
+      title: 'Transcript',
+      type: 'FRONT_COMPONENT',
+      configuration: {
+        configurationType: 'FRONT_COMPONENT',
+        frontComponentUniversalIdentifier:
+          CALENDAR_EVENT_RECORDING_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+      },
+    },
+  ],
+});

package/src/view-fields/call-recorder-preference-on-calendar-event.view-field.ts

@@ -0,0 +1,27 @@
+import { defineViewField } from 'twenty-sdk/define';
+
+import { CALL_RECORDER_PREFERENCE_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER } from 'src/constants/call-recorder-preference-on-calendar-event-field-universal-identifier';
+import { CALL_RECORDER_PREFERENCE_ON_CALENDAR_EVENT_VIEW_FIELD_UNIVERSAL_IDENTIFIER } from 'src/constants/call-recorder-preference-on-calendar-event-view-field-universal-identifier';
+
+// TODO: hardcoded because the published twenty-sdk (2.14.0) predates the
+// calendarEventRecordPageFields view. Replace both with
+// STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.calendarEvent.views.calendarEventRecordPageFields
+// once the SDK is republished with this view.
+const CALENDAR_EVENT_RECORD_PAGE_FIELDS_VIEW_UNIVERSAL_IDENTIFIER =
+  'c73668d1-022d-4eaf-b825-4e2548180db6';
+const CALENDAR_EVENT_RECORD_PAGE_FIELDS_GENERAL_GROUP_UNIVERSAL_IDENTIFIER =
+  'aeadeb9e-3673-4c0c-8845-f59cb1e6ca42';
+
+export default defineViewField({
+  universalIdentifier:
+    CALL_RECORDER_PREFERENCE_ON_CALENDAR_EVENT_VIEW_FIELD_UNIVERSAL_IDENTIFIER,
+  viewUniversalIdentifier:
+    CALENDAR_EVENT_RECORD_PAGE_FIELDS_VIEW_UNIVERSAL_IDENTIFIER,
+  viewFieldGroupUniversalIdentifier:
+    CALENDAR_EVENT_RECORD_PAGE_FIELDS_GENERAL_GROUP_UNIVERSAL_IDENTIFIER,
+  fieldMetadataUniversalIdentifier:
+    CALL_RECORDER_PREFERENCE_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER,
+  position: 8,
+  isVisible: true,
+  size: 150,
+});

package/tsconfig.json

@@ -0,0 +1,42 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "sourceMap": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "jsx": "react-jsx",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "importHelpers": true,
+    "allowUnreachableCode": false,
+    "strict": true,
+    "alwaysStrict": true,
+    "noImplicitAny": true,
+    "strictBindCallApply": false,
+    "target": "es2018",
+    "module": "esnext",
+    "lib": ["es2020", "dom"],
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "resolveJsonModule": true,
+    "paths": {
+      "src/*": ["./src/*"],
+      "~/*": ["./*"]
+    }
+  },
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "**/*.integration-test.ts"
+  ],
+  "references": [
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/tsconfig.spec.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "types": ["vitest/globals", "node"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,31 @@
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TWENTY_API_KEY =
+  process.env.TWENTY_API_KEY ??
+  'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC0xYzI1LTRkMDItYmYyNS02YWVjY2Y3ZWE0MTkiLCJ0eXBlIjoiQVBJX0tFWSIsIndvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWMyNS00ZDAyLWJmMjUtNmFlY2NmN2VhNDE5IiwiaWF0IjoxNzM1Njg5NjAwLCJleHAiOjQ4OTE0NDk2MDAsImp0aSI6IjIwMjAyMDIwLWY0MDEtNGQ4YS1hNzMxLTY0ZDAwN2MyN2JhZCJ9.bfQjfyN0NEtTCLE_xPyNcwonDzlSXFoP8kdCQTdnuDc';
+
+// Make env vars available to globalSetup (test.env only applies to workers)
+process.env.TWENTY_API_URL = TWENTY_API_URL;
+process.env.TWENTY_API_KEY = TWENTY_API_KEY;
+
+export default defineConfig({
+  plugins: [
+    tsconfigPaths({
+      projects: ['tsconfig.spec.json'],
+      ignoreConfigErrors: true,
+    }),
+  ],
+  test: {
+    testTimeout: 120_000,
+    hookTimeout: 120_000,
+    fileParallelism: false,
+    include: ['src/**/*.integration-test.ts'],
+    globalSetup: ['src/__tests__/global-setup.ts'],
+    env: {
+      TWENTY_API_URL,
+      TWENTY_API_KEY,
+    },
+  },
+});

package/vitest.unit.config.ts

@@ -0,0 +1,14 @@
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  plugins: [
+    tsconfigPaths({
+      projects: ['tsconfig.spec.json'],
+      ignoreConfigErrors: true,
+    }),
+  ],
+  test: {
+    include: ['src/**/*.test.ts'],
+  },
+});