@edge-base/server 0.2.5 → 0.2.7

package/src/__tests__/cloudflare-realtime.test.ts

@@ -1,113 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import {
-  CloudflareRealtimeClient,
-  assertCloudflareRealtimeConfig,
-  createCloudflareRealtimeClient,
-  hasCloudflareRealtimeConfig,
-} from '../lib/cloudflare-realtime.js';
-
-describe('cloudflare realtime helpers', () => {
-  afterEach(() => {
-    vi.restoreAllMocks();
-    vi.unstubAllGlobals();
-  });
-
-  it('detects whether the required realtime config is present', () => {
-    expect(hasCloudflareRealtimeConfig({})).toBe(false);
-    expect(hasCloudflareRealtimeConfig({
-      CF_REALTIME_APP_ID: ' app-123 ',
-      CF_REALTIME_APP_SECRET: ' secret-456 ',
-    })).toBe(true);
-  });
-
-  it('normalizes realtime config and defaults the base URL', () => {
-    expect(assertCloudflareRealtimeConfig({
-      CF_REALTIME_APP_ID: ' app-123 ',
-      CF_REALTIME_APP_SECRET: ' secret-456 ',
-      CF_REALTIME_TURN_KEY_ID: ' key-1 ',
-      CF_REALTIME_TURN_API_TOKEN: ' token-1 ',
-    })).toEqual({
-      appId: 'app-123',
-      appSecret: 'secret-456',
-      baseUrl: 'https://rtc.live.cloudflare.com/v1',
-      turnKeyId: 'key-1',
-      turnApiToken: 'token-1',
-    });
-
-    expect(() => assertCloudflareRealtimeConfig({
-      CF_REALTIME_APP_ID: 'missing-secret',
-    })).toThrow('Cloudflare Realtime is not configured');
-  });
-
-  it('creates a realtime client and sends authenticated session requests', async () => {
-    const fetchMock = vi.fn(async (_input: RequestInfo | URL, _init?: RequestInit) =>
-      new Response(JSON.stringify({ sessionId: 'sess-1' }), {
-        status: 200,
-        headers: { 'Content-Type': 'application/json' },
-      }));
-    vi.stubGlobal('fetch', fetchMock);
-
-    const client = createCloudflareRealtimeClient({
-      CF_REALTIME_APP_ID: 'app-123',
-      CF_REALTIME_APP_SECRET: 'secret-456',
-    } as never);
-
-    expect(client).toBeInstanceOf(CloudflareRealtimeClient);
-    await expect(client.createSession({
-      sessionDescription: {
-        sdp: 'offer-sdp',
-        type: 'offer',
-      },
-    }, {
-      thirdparty: true,
-      correlationId: 'corr-1',
-    })).resolves.toEqual({ sessionId: 'sess-1' });
-
-    expect(fetchMock).toHaveBeenCalledTimes(1);
-    expect(fetchMock.mock.calls[0]?.[0]).toBe(
-      'https://rtc.live.cloudflare.com/v1/apps/app-123/sessions/new?thirdparty=true&correlationId=corr-1',
-    );
-    expect(fetchMock.mock.calls[0]?.[1]).toMatchObject({
-      method: 'POST',
-      headers: {
-        Authorization: 'Bearer secret-456',
-        'Content-Type': 'application/json',
-      },
-    });
-  });
-
-  it('uses TURN credentials when generating ICE servers', async () => {
-    const fetchMock = vi.fn(async () =>
-      new Response(JSON.stringify({
-        iceServers: [{ urls: 'turn:global.example.com', username: 'user', credential: 'pass' }],
-      }), {
-        status: 200,
-        headers: { 'Content-Type': 'application/json' },
-      }));
-    vi.stubGlobal('fetch', fetchMock);
-
-    const client = new CloudflareRealtimeClient({
-      CF_REALTIME_APP_ID: 'app-123',
-      CF_REALTIME_APP_SECRET: 'secret-456',
-      CF_REALTIME_BASE_URL: 'https://rtc.example.com/base/',
-      CF_REALTIME_TURN_KEY_ID: 'turn-key',
-      CF_REALTIME_TURN_API_TOKEN: 'turn-token',
-    });
-
-    await expect(client.generateIceServers(120)).resolves.toEqual({
-      iceServers: [{ urls: 'turn:global.example.com', username: 'user', credential: 'pass' }],
-    });
-
-    expect(fetchMock).toHaveBeenCalledWith(
-      'https://rtc.example.com/base/turn/keys/turn-key/credentials/generate-ice-servers',
-      {
-        method: 'POST',
-        headers: {
-          Authorization: 'Bearer turn-token',
-          'Content-Type': 'application/json',
-        },
-        body: JSON.stringify({ ttl: 120 }),
-      },
-    );
-  });
-});

package/src/lib/cloudflare-realtime.ts

@@ -1,251 +0,0 @@
-import type { Env } from '../types.js';
-
-const DEFAULT_CLOUDFLARE_REALTIME_BASE_URL = 'https://rtc.live.cloudflare.com/v1';
-
-export interface CloudflareRealtimeSessionDescription {
-  sdp: string;
-  type: 'offer' | 'answer';
-}
-
-export interface CloudflareRealtimeTrackObject {
-  location: 'local' | 'remote';
-  mid?: string;
-  sessionId?: string;
-  trackName?: string;
-  bidirectionalMediaStream?: boolean;
-  kind?: string;
-  simulcast?: {
-    preferredRid?: string;
-    priorityOrdering?: 'none' | 'asciibetical';
-    ridNotAvailable?: 'none' | 'asciibetical';
-  };
-}
-
-export interface CloudflareRealtimeNewSessionRequest {
-  sessionDescription?: CloudflareRealtimeSessionDescription;
-}
-
-export interface CloudflareRealtimeNewSessionResponse {
-  errorCode?: string;
-  errorDescription?: string;
-  sessionDescription?: CloudflareRealtimeSessionDescription;
-  sessionId: string;
-}
-
-export interface CloudflareRealtimeTracksRequest {
-  sessionDescription?: CloudflareRealtimeSessionDescription;
-  tracks: CloudflareRealtimeTrackObject[];
-  autoDiscover?: boolean;
-}
-
-export interface CloudflareRealtimeTracksResponse {
-  errorCode?: string;
-  errorDescription?: string;
-  requiresImmediateRenegotiation?: boolean;
-  sessionDescription?: CloudflareRealtimeSessionDescription;
-  tracks?: Array<CloudflareRealtimeTrackObject & {
-    errorCode?: string;
-    errorDescription?: string;
-  }>;
-}
-
-export interface CloudflareRealtimeRenegotiateRequest {
-  sessionDescription: CloudflareRealtimeSessionDescription;
-}
-
-export interface CloudflareRealtimeCloseTracksRequest {
-  sessionDescription?: CloudflareRealtimeSessionDescription;
-  tracks: Array<{ mid: string }>;
-  force?: boolean;
-}
-
-export interface CloudflareRealtimeIceServer {
-  urls: string[] | string;
-  username?: string;
-  credential?: string;
-}
-
-export interface CloudflareRealtimeIceServersResponse {
-  iceServers: CloudflareRealtimeIceServer[];
-}
-
-export interface CloudflareRealtimeEnv {
-  CF_REALTIME_APP_ID?: string;
-  CF_REALTIME_APP_SECRET?: string;
-  CF_REALTIME_BASE_URL?: string;
-  CF_REALTIME_TURN_KEY_ID?: string;
-  CF_REALTIME_TURN_API_TOKEN?: string;
-}
-
-function trimString(value: unknown): string | undefined {
-  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-
-async function parseRealtimeResponse<T>(response: Response): Promise<T> {
-  const data = (await response.json().catch(() => ({}))) as Record<string, unknown>;
-  if (!response.ok) {
-    const message =
-      (typeof data.errorDescription === 'string' && data.errorDescription)
-      || (typeof data.message === 'string' && data.message)
-      || `Cloudflare Realtime request failed (${response.status})`;
-    throw new Error(message);
-  }
-  return data as T;
-}
-
-export function hasCloudflareRealtimeConfig(env: CloudflareRealtimeEnv): boolean {
-  return !!trimString(env.CF_REALTIME_APP_ID) && !!trimString(env.CF_REALTIME_APP_SECRET);
-}
-
-export function assertCloudflareRealtimeConfig(env: CloudflareRealtimeEnv): {
-  appId: string;
-  appSecret: string;
-  baseUrl: string;
-  turnKeyId?: string;
-  turnApiToken?: string;
-} {
-  const appId = trimString(env.CF_REALTIME_APP_ID);
-  const appSecret = trimString(env.CF_REALTIME_APP_SECRET);
-  if (!appId || !appSecret) {
-    throw new Error('Cloudflare Realtime is not configured. Set CF_REALTIME_APP_ID and CF_REALTIME_APP_SECRET.');
-  }
-
-  return {
-    appId,
-    appSecret,
-    baseUrl: trimString(env.CF_REALTIME_BASE_URL) ?? DEFAULT_CLOUDFLARE_REALTIME_BASE_URL,
-    turnKeyId: trimString(env.CF_REALTIME_TURN_KEY_ID),
-    turnApiToken: trimString(env.CF_REALTIME_TURN_API_TOKEN),
-  };
-}
-
-export class CloudflareRealtimeClient {
-  private readonly appId: string;
-  private readonly appSecret: string;
-  private readonly baseUrl: string;
-  private readonly turnKeyId?: string;
-  private readonly turnApiToken?: string;
-
-  constructor(env: CloudflareRealtimeEnv) {
-    const config = assertCloudflareRealtimeConfig(env);
-    this.appId = config.appId;
-    this.appSecret = config.appSecret;
-    this.baseUrl = config.baseUrl;
-    this.turnKeyId = config.turnKeyId;
-    this.turnApiToken = config.turnApiToken;
-  }
-
-  async createSession(
-    body: CloudflareRealtimeNewSessionRequest = {},
-    query?: { thirdparty?: boolean; correlationId?: string },
-  ): Promise<CloudflareRealtimeNewSessionResponse> {
-    const url = this.buildSessionUrl('/sessions/new', query);
-    const response = await fetch(url, {
-      method: 'POST',
-      headers: this.buildAuthHeaders(),
-      body: JSON.stringify(body),
-    });
-    return parseRealtimeResponse<CloudflareRealtimeNewSessionResponse>(response);
-  }
-
-  async addTracks(
-    sessionId: string,
-    body: CloudflareRealtimeTracksRequest,
-  ): Promise<CloudflareRealtimeTracksResponse> {
-    const response = await fetch(
-      this.buildSessionUrl(`/sessions/${encodeURIComponent(sessionId)}/tracks/new`),
-      {
-        method: 'POST',
-        headers: this.buildAuthHeaders(),
-        body: JSON.stringify(body),
-      },
-    );
-    return parseRealtimeResponse<CloudflareRealtimeTracksResponse>(response);
-  }
-
-  async renegotiate(
-    sessionId: string,
-    body: CloudflareRealtimeRenegotiateRequest,
-  ): Promise<CloudflareRealtimeTracksResponse> {
-    const response = await fetch(
-      this.buildSessionUrl(`/sessions/${encodeURIComponent(sessionId)}/renegotiate`),
-      {
-        method: 'PUT',
-        headers: this.buildAuthHeaders(),
-        body: JSON.stringify(body),
-      },
-    );
-    return parseRealtimeResponse<CloudflareRealtimeTracksResponse>(response);
-  }
-
-  async closeTracks(
-    sessionId: string,
-    body: CloudflareRealtimeCloseTracksRequest,
-  ): Promise<CloudflareRealtimeTracksResponse> {
-    const response = await fetch(
-      this.buildSessionUrl(`/sessions/${encodeURIComponent(sessionId)}/tracks/close`),
-      {
-        method: 'PUT',
-        headers: this.buildAuthHeaders(),
-        body: JSON.stringify(body),
-      },
-    );
-    return parseRealtimeResponse<CloudflareRealtimeTracksResponse>(response);
-  }
-
-  async getSession(sessionId: string): Promise<{
-    tracks?: Array<CloudflareRealtimeTrackObject & { status?: string }>;
-  }> {
-    const response = await fetch(
-      this.buildSessionUrl(`/sessions/${encodeURIComponent(sessionId)}`),
-      {
-        method: 'GET',
-        headers: this.buildAuthHeaders(),
-      },
-    );
-    return parseRealtimeResponse<{ tracks?: Array<CloudflareRealtimeTrackObject & { status?: string }> }>(response);
-  }
-
-  async generateIceServers(ttl = 3600): Promise<CloudflareRealtimeIceServersResponse> {
-    if (!this.turnKeyId || !this.turnApiToken) {
-      throw new Error('Cloudflare TURN is not configured. Set CF_REALTIME_TURN_KEY_ID and CF_REALTIME_TURN_API_TOKEN.');
-    }
-
-    const response = await fetch(
-      `${this.baseUrl.replace(/\/$/, '')}/turn/keys/${encodeURIComponent(this.turnKeyId)}/credentials/generate-ice-servers`,
-      {
-        method: 'POST',
-        headers: {
-          Authorization: `Bearer ${this.turnApiToken}`,
-          'Content-Type': 'application/json',
-        },
-        body: JSON.stringify({ ttl }),
-      },
-    );
-    return parseRealtimeResponse<CloudflareRealtimeIceServersResponse>(response);
-  }
-
-  private buildSessionUrl(pathname: string, query?: { thirdparty?: boolean; correlationId?: string }): string {
-    const url = new URL(
-      `${this.baseUrl.replace(/\/$/, '')}/apps/${encodeURIComponent(this.appId)}${pathname}`,
-    );
-    if (query?.thirdparty !== undefined) {
-      url.searchParams.set('thirdparty', String(query.thirdparty));
-    }
-    if (query?.correlationId) {
-      url.searchParams.set('correlationId', query.correlationId);
-    }
-    return url.toString();
-  }
-
-  private buildAuthHeaders(): HeadersInit {
-    return {
-      Authorization: `Bearer ${this.appSecret}`,
-      'Content-Type': 'application/json',
-    };
-  }
-}
-
-export function createCloudflareRealtimeClient(env: Env): CloudflareRealtimeClient {
-  return new CloudflareRealtimeClient(env);
-}