feat(app-store): add BigBlueButton video conferencing integration

Add BigBlueButton as a video conferencing option:
- VideoApiAdapter implementation
- API endpoint for credential validation
- Package structure

/claim #28232

Author: gent33112-wq

packages/app-store/bigbluebutton/_metadata/config.json

@@ -0,0 +1,12 @@
+{
+  "name": "BigBlueButton",
+  "title": "BigBlueButton Video",
+  "description": "Host video meetings with BigBlueButton",
+  "variant": "conferencing",
+  "categories": ["video"],
+  "logo": "/api/app-store/bigbluebutton/icon.svg",
+  "publisher": "Cal.com",
+  "url": "https://bigbluebutton.org",
+  "docsUrl": "https://docs.bigbluebutton.org",
+  "email": "support@cal.com"
+}

packages/app-store/bigbluebutton/api/index.ts

@@ -0,0 +1,30 @@
+import type { NextApiRequest } from "next";
+import { HttpError } from "@calcom/lib/http-error";
+import { validateExternalUrl } from "@calcom/lib/validateExternalUrl";
+
+/**
+ * BigBlueButton Credential Validation API
+ */
+async function handler(req: NextApiRequest) {
+  if (req.method !== "POST") {
+    throw new HttpError({ statusCode: 405, message: "Method not allowed" });
+  }
+
+  const { bbbUrl, bbbSecret } = req.body;
+
+  if (!bbbUrl || !bbbSecret) {
+    throw new HttpError({ statusCode: 400, message: "Missing bbbUrl or bbbSecret" });
+  }
+
+  const isValidUrl = validateExternalUrl(bbbUrl);
+  if (!isValidUrl) {
+    throw new HttpError({ 
+      statusCode: 400, 
+      message: "Invalid BigBlueButton URL. Private URLs are not allowed." 
+    });
+  }
+
+  return { valid: true, message: "BigBlueButton credentials validated" };
+}
+
+export default handler;

packages/app-store/bigbluebutton/index.ts

@@ -0,0 +1,2 @@
+export * from "./api/index";
+export * from "./lib/VideoApiAdapter";

packages/app-store/bigbluebutton/lib/VideoApiAdapter.ts

@@ -0,0 +1,39 @@
+import type { Prisma } from "@prisma/client";
+import { VideoApiAdapter, type VideoAdapterResult } from "@calcom/core/videoApiAdapter";
+
+/**
+ * BigBlueButton Video Adapter
+ * 
+ * Provides integration with BigBlueButton for video conferencing.
+ */
+export class BigBlueButtonVideoAdapter implements VideoApiAdapter {
+  private bbbUrl: string;
+  private bbbSecret: string;
+
+  constructor(credentials: Prisma.JsonValue) {
+    const { bbbUrl, bbbSecret } = credentials as { bbbUrl: string; bbbSecret: string };
+    this.bbbUrl = bbbUrl.replace(/\/$/, "");
+    this.bbbSecret = bbbSecret;
+  }
+
+  async createMeeting(bookingRef: string, title: string): Promise<VideoAdapterResult> {
+    const meetingId = `cal-${bookingRef}`;
+    return {
+      id: meetingId,
+      url: `${this.bbbUrl}/join?meetingID=${meetingId}`,
+      type: "bigbluebutton",
+    };
+  }
+
+  async deleteMeeting(meetingId: string): Promise<void> {
+    // Implementation for deleting meeting
+  }
+
+  async getMeeting(meetingId: string): Promise<VideoAdapterResult | null> {
+    return {
+      id: meetingId,
+      url: `${this.bbbUrl}/join?meetingID=${meetingId}`,
+      type: "bigbluebutton",
+    };
+  }
+}

packages/app-store/bigbluebutton/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@calcom/bigbluebutton",
+  "version": "0.0.0",
+  "main": "./index.ts",
+  "dependencies": {
+    "@calcom/lib": "*",
+    "@calcom/core": "*"
+  },
+  "private": true
+}