[WIP] feat: add meeting-baas-recorder Twenty app

packages/twenty-apps/community/meeting-baas-recorder/.env.example

@@ -0,0 +1,8 @@
+# Meeting BaaS API key (get yours at https://meetingbaas.com)
+MEETING_BAAS_API_KEY=
+
+# Twenty CRM API key
+TWENTY_API_KEY=
+
+# Twenty server URL (default: http://localhost:3000)
+SERVER_URL=http://localhost:3000

packages/twenty-apps/community/meeting-baas-recorder/.gitignore

@@ -0,0 +1,2 @@
+.yarn/install-state.gz
+.env

packages/twenty-apps/community/meeting-baas-recorder/application.config.ts

@@ -0,0 +1,20 @@
+import { defineApplication } from 'twenty-sdk';
+import { DEFAULT_ROLE_ID } from './src/roles/default.role';
+
+export default defineApplication({
+  universalIdentifier: 'c522c3c7-cff8-5c08-8c87-d1481adbd4a9',
+  displayName: 'Meeting BaaS Recorder',
+  description: 'Record meetings via Meeting BaaS and sync recordings, transcripts, and participants into Twenty.',
+  icon: 'IconVideo',
+  defaultRoleUniversalIdentifier: DEFAULT_ROLE_ID,
+  settingsCustomTabFrontComponentUniversalIdentifier:
+    '7f2c17b4-2cd2-5447-b7d1-83ef12040837',
+  applicationVariables: {
+    MEETING_BAAS_API_KEY: {
+      universalIdentifier: '32cd6297-bbd3-5beb-a0f6-1f5662590f66',
+      description: 'Meeting BaaS API key for authenticating requests and verifying webhooks',
+      isSecret: true,
+      value: '',
+    },
+  },
+});

packages/twenty-apps/community/meeting-baas-recorder/jest.config.mjs

@@ -0,0 +1,23 @@
+const jestConfig = {
+  displayName: 'meeting-baas-recorder',
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  moduleFileExtensions: ['ts', 'js'],
+  transform: {
+    '^.+\\.ts$': 'ts-jest',
+  },
+  testMatch: [
+    '<rootDir>/src/**/__tests__/**/*.(test|spec).{js,ts}',
+    '<rootDir>/src/**/?(*.)(test|spec).{js,ts}',
+  ],
+  setupFilesAfterEnv: [
+    '<rootDir>/src/__tests__/setup.ts'
+  ],
+  collectCoverageFrom: [
+    'src/**/*.{ts,js}',
+    '!src/**/*.d.ts',
+  ],
+  coverageDirectory: './coverage',
+};
+
+export default jestConfig;

packages/twenty-apps/community/meeting-baas-recorder/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "meeting-baas-recorder",
+  "version": "0.2.0",
+  "license": "MIT",
+  "engines": {
+    "node": "^24.5.0",
+    "npm": "please-use-yarn",
+    "yarn": ">=4.0.2"
+  },
+  "packageManager": "yarn@4.9.2",
+  "scripts": {
+    "test": "jest"
+  },
+  "dependencies": {
+    "@meeting-baas/sdk": "^6.0.5",
+    "axios": "^1.13.1",
+    "twenty-sdk": "0.8.0"
+  },
+  "devDependencies": {
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.0",
+    "@types/jest": "^29.5.5",
+    "@types/node": "^24.9.2",
+    "@types/react": "^18.2.0",
+    "jest": "^29.7.0",
+    "react": "^18.2.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.9.3"
+  }
+}

packages/twenty-apps/community/meeting-baas-recorder/project.json

@@ -0,0 +1,46 @@
+{
+  "name": "meeting-baas-recorder",
+  "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/twenty-apps/community/meeting-baas-recorder/src",
+  "projectType": "application",
+  "tags": [
+    "scope:apps"
+  ],
+  "targets": {
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": [
+        "{workspaceRoot}/coverage/{projectRoot}"
+      ],
+      "options": {
+        "jestConfig": "packages/twenty-apps/community/meeting-baas-recorder/jest.config.mjs",
+        "passWithNoTests": true
+      },
+      "configurations": {
+        "ci": {
+          "ci": true,
+          "coverageReporters": ["text"]
+        }
+      }
+    },
+    "typecheck": {
+      "dependsOn": ["^build"]
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": [
+        "{options.outputFile}"
+      ],
+      "options": {
+        "lintFilePatterns": [
+          "packages/twenty-apps/community/meeting-baas-recorder/**/*.{ts,tsx,js,jsx}"
+        ]
+      },
+      "configurations": {
+        "fix": {
+          "fix": true
+        }
+      }
+    }
+  }
+}

packages/twenty-apps/community/meeting-baas-recorder/src/__tests__/app-install.integration-test.ts

@@ -0,0 +1,76 @@
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from '../constants/universal-identifiers';
+import {
+  ensureIntegrationTestEnvironment,
+  hasIntegrationTestEnvironment,
+} from './setup-test';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe.skipIf(!hasIntegrationTestEnvironment())('App installation', () => {
+  beforeAll(async () => {
+    await ensureIntegrationTestEnvironment();
+
+    const buildResult = await appBuild({
+      appPath: APP_PATH,
+      tarball: true,
+      onProgress: (message: string) => console.log(`[build] ${message}`),
+    });
+
+    if (!buildResult.success) {
+      throw new Error(
+        `Build failed: ${buildResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+
+    const deployResult = await appDeploy({
+      tarballPath: buildResult.data.tarballPath!,
+      onProgress: (message: string) => console.log(`[deploy] ${message}`),
+    });
+
+    if (!deployResult.success) {
+      throw new Error(
+        `Deploy failed: ${deployResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+
+    const installResult = await appInstall({ appPath: APP_PATH });
+
+    if (!installResult.success) {
+      throw new Error(
+        `Install failed: ${installResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+  });
+
+  afterAll(async () => {
+    const uninstallResult = await appUninstall({ appPath: APP_PATH });
+
+    if (!uninstallResult.success) {
+      console.warn(
+        `App uninstall failed: ${uninstallResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+  });
+
+  it('should find the installed app in the applications list', async () => {
+    const metadataClient = new MetadataApiClient();
+
+    const result = await metadataClient.query({
+      findManyApplications: {
+        id: true,
+        name: true,
+        universalIdentifier: true,
+      },
+    });
+
+    const installedApp = result.findManyApplications.find(
+      (application: { universalIdentifier: string }) =>
+        application.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+    );
+
+    expect(installedApp).toBeDefined();
+  });
+});

packages/twenty-apps/community/meeting-baas-recorder/src/__tests__/setup-test.ts

@@ -0,0 +1,55 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+
+const CONFIG_DIR = path.join(os.homedir(), '.twenty');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.test.json');
+
+export const hasIntegrationTestEnvironment = (): boolean =>
+  Boolean(process.env.TWENTY_API_URL && process.env.TWENTY_API_KEY);
+
+export const ensureIntegrationTestEnvironment = async () => {
+  const apiUrl = process.env.TWENTY_API_URL!;
+  const token = process.env.TWENTY_API_KEY!;
+
+  if (!apiUrl || !token) {
+    throw new Error(
+      'TWENTY_API_URL and TWENTY_API_KEY must be set.\n' +
+        'Start a local server: yarn twenty server start\n' +
+        'Or set them in vitest env config.',
+    );
+  }
+
+  let response: Response;
+
+  try {
+    response = await fetch(`${apiUrl}/healthz`);
+  } catch {
+    throw new Error(
+      `Twenty server is not reachable at ${apiUrl}. ` +
+        'Make sure the server is running before executing integration tests.',
+    );
+  }
+
+  if (!response.ok) {
+    throw new Error(`Server at ${apiUrl} returned ${response.status}`);
+  }
+
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+
+  fs.writeFileSync(
+    CONFIG_PATH,
+    JSON.stringify(
+      {
+        remotes: {
+          local: { apiUrl, apiKey: token },
+        },
+        defaultRemote: 'local',
+      },
+      null,
+      2,
+    ),
+  );
+
+  process.env.TWENTY_APP_ACCESS_TOKEN ??= token;
+};

packages/twenty-apps/community/meeting-baas-recorder/src/application-config.ts

@@ -0,0 +1,30 @@
+import { defineApplication } from 'twenty-sdk';
+
+import {
+  APP_DESCRIPTION,
+  APP_DISPLAY_NAME,
+  APPLICATION_UNIVERSAL_IDENTIFIER,
+  DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+} from './constants/universal-identifiers';
+
+export default defineApplication({
+  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
+  displayName: APP_DISPLAY_NAME,
+  description: APP_DESCRIPTION,
+  icon: 'IconVideo',
+  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  settingsCustomTabFrontComponentUniversalIdentifier: '4ea804f4-6c22-457b-b8a2-66673bb6fc76',
+  applicationVariables: {
+    MEETING_BAAS_API_KEY: {
+      universalIdentifier: 'c1d2e3f4-5a6b-7c8d-9e0f-a1b2c3d4e5f6',
+      description: 'Meeting BaaS API key for authenticating requests and verifying webhooks',
+      isSecret: true,
+      value: '',
+    },
+    AUTO_CREATE_CONTACTS: {
+      universalIdentifier: '9637bafd-5888-4f34-bf8f-a4c82dbc4942',
+      description: 'Whether to auto-create contacts for unknown participants (true/false)',
+      value: 'true',
+    },
+  },
+});

packages/twenty-apps/community/meeting-baas-recorder/src/constants/universal-identifiers.ts

@@ -0,0 +1,4 @@
+export const APP_DISPLAY_NAME = 'Meeting BaaS Recorder';
+export const APP_DESCRIPTION = 'Record meetings via Meeting BaaS and sync recordings, transcripts, and participants into Twenty.';
+export const APPLICATION_UNIVERSAL_IDENTIFIER = 'b7e3a1f2-8d4c-4e6a-9f2b-1c5d7e8a3b4f';
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER = '3231cf40-5b90-4c2b-ae41-fcb5606299b4';

packages/twenty-apps/community/meeting-baas-recorder/src/fields/bot-entry-message-on-workspace-member.field.ts

@@ -0,0 +1,19 @@
+import {
+  defineField,
+  FieldType,
+  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';
+
+export const BOT_ENTRY_MESSAGE_FIELD_ID = '5d9be02b-138b-5437-9184-d72276f51f3d';
+
+export default defineField({
+  universalIdentifier: BOT_ENTRY_MESSAGE_FIELD_ID,
+  objectUniversalIdentifier:
+    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.workspaceMember.universalIdentifier,
+  type: FieldType.TEXT,
+  name: 'botEntryMessage',
+  label: 'Bot Entry Message',
+  icon: 'IconMessage',
+  description: 'Message the bot posts in the meeting chat when it joins (max 500 characters)',
+  defaultValue: "''",
+});

packages/twenty-apps/community/meeting-baas-recorder/src/fields/bot-name-on-workspace-member.field.ts

@@ -0,0 +1,19 @@
+import {
+  defineField,
+  FieldType,
+  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';
+
+export const BOT_NAME_FIELD_ID = '6a37564a-25e6-5bdb-a119-1522e3817ae6';
+
+export default defineField({
+  universalIdentifier: BOT_NAME_FIELD_ID,
+  objectUniversalIdentifier:
+    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.workspaceMember.universalIdentifier,
+  type: FieldType.TEXT,
+  name: 'botName',
+  label: 'Bot Name',
+  icon: 'IconRobot',
+  description: 'Name displayed for the recording bot when it joins meetings',
+  defaultValue: "'Twenty CRM Recorder'",
+});

packages/twenty-apps/community/meeting-baas-recorder/src/fields/calendar-event-on-recording.field.ts

@@ -0,0 +1,28 @@
+import {
+  defineField,
+  FieldType,
+  RelationType,
+  OnDeleteAction,
+  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';
+import { RECORDING_UNIVERSAL_IDENTIFIER } from '../objects/recording';
+
+export const CALENDAR_EVENT_ON_RECORDING_ID = '29fe48d1-7e7d-4253-9fea-0a876c2c116d';
+export const RECORDINGS_ON_CALENDAR_EVENT_ID = '131a78b1-f3c9-4b2e-9808-f9eb64bfb832';
+
+export default defineField({
+  universalIdentifier: CALENDAR_EVENT_ON_RECORDING_ID,
+  objectUniversalIdentifier: RECORDING_UNIVERSAL_IDENTIFIER,
+  type: FieldType.RELATION,
+  name: 'calendarEvent',
+  label: 'Calendar Event',
+  icon: 'IconCalendarEvent',
+  relationTargetObjectMetadataUniversalIdentifier:
+    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.calendarEvent.universalIdentifier,
+  relationTargetFieldMetadataUniversalIdentifier: RECORDINGS_ON_CALENDAR_EVENT_ID,
+  universalSettings: {
+    relationType: RelationType.MANY_TO_ONE,
+    onDelete: OnDeleteAction.SET_NULL,
+    joinColumnName: 'calendarEventId',
+  },
+});