@camstack/core 0.1.18 → 0.1.19

package/dist/builtins/turn-orchestrator/turn-orchestrator.addon.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"turn-orchestrator.addon.mjs","names":[],"sources":["../../../src/builtins/turn-orchestrator/turn-orchestrator.addon.ts"],"sourcesContent":["/**\n * TURN orchestrator — singleton facade over the `turn-provider`\n * collection (Cloudflare TURN, coturn, Twilio, …). Mirrors the\n * auth-orchestrator / remote-access-orchestrator patterns.\n *\n * Provides:\n *   - listProviders() — admin UI inventory\n *   - getAllServers() — combined ICE server list across enabled\n *     providers, consumed by the WebRTC layer at session creation\n */\nimport {\n  BaseAddon,\n  turnOrchestratorCapability,\n  type ITurnOrchestratorProvider,\n  type TurnProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface TurnProviderLike {\n  getTurnServers?: () => Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]>\n  readonly displayName?: string\n  readonly kind?: TurnProviderInfo['kind']\n}\n\nexport class TurnOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: ITurnOrchestratorProvider = {\n      listProviders: async () => this.listProviders(),\n      getAllServers: async () => this.getAllServers(),\n      setProviderEnabled: async () => {\n        // Persistence per-addon for now — see auth-orchestrator\n        // rationale.\n        return { success: true as const }\n      },\n    }\n    this.ctx.logger.info('TURN orchestrator initialized')\n    return [{ capability: turnOrchestratorCapability, provider }]\n  }\n\n  private getEntries(): readonly (readonly [string, TurnProviderLike])[] {\n    return this.capabilities?.getCollectionEntries<TurnProviderLike>('turn-provider') ?? []\n  }\n\n  private async listProviders(): Promise<readonly TurnProviderInfo[]> {\n    const out: TurnProviderInfo[] = []\n    for (const [addonId, impl] of this.getEntries()) {\n      let serverCount = 0\n      let error: string | undefined\n      if (impl.getTurnServers) {\n        try {\n          const servers = await impl.getTurnServers()\n          serverCount = servers.length\n        } catch (err) {\n          error = err instanceof Error ? err.message : String(err)\n        }\n      }\n      out.push({\n        addonId,\n        displayName: impl.displayName ?? addonId,\n        kind: impl.kind ?? (addonId.includes('cloudflare') ? 'cloudflare' as const : addonId.includes('coturn') ? 'coturn' as const : 'other' as const),\n        enabled: true,\n        serverCount,\n        ...(error !== undefined ? { error } : {}),\n      })\n    }\n    return out\n  }\n\n  private async getAllServers(): Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]> {\n    const out: { urls: string | string[]; username?: string; credential?: string }[] = []\n    for (const [, impl] of this.getEntries()) {\n      if (!impl.getTurnServers) continue\n      try {\n        const servers = await impl.getTurnServers()\n        out.push(...servers)\n      } catch (err) {\n        this.ctx.logger.warn('TURN provider failed to enumerate servers', {\n          meta: { error: err instanceof Error ? err.message : String(err) },\n        })\n      }\n    }\n    return out\n  }\n}\n\nexport default TurnOrchestratorAddon\n"],"mappings":";;;;;;;;;;;;AAwBA,IAAa,wBAAb,cAA2C,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAAsC;GAC1C,eAAe,YAAY,KAAK,eAAe;GAC/C,eAAe,YAAY,KAAK,eAAe;GAC/C,oBAAoB,YAAY;IAG9B,OAAO,EAAE,SAAS,MAAe;;GAEpC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY;GAA4B;GAAU,CAAC;;CAG/D,aAAuE;EACrE,OAAO,KAAK,cAAc,qBAAuC,gBAAgB,IAAI,EAAE;;CAGzF,MAAc,gBAAsD;EAClE,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,KAAK,YAAY,EAAE;GAC/C,IAAI,cAAc;GAClB,IAAI;GACJ,IAAI,KAAK,gBACP,IAAI;IAEF,eAAc,MADQ,KAAK,gBAAgB,EACrB;YACf,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC,MAAM,KAAK,SAAS,QAAQ,SAAS,aAAa,GAAG,eAAwB,QAAQ,SAAS,SAAS,GAAG,WAAoB;IAC9H,SAAS;IACT;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACzC,CAAC;;EAEJ,OAAO;;CAGT,MAAc,gBAAyG;EACrH,MAAM,MAA6E,EAAE;EACrF,KAAK,MAAM,GAAG,SAAS,KAAK,YAAY,EAAE;GACxC,IAAI,CAAC,KAAK,gBAAgB;GAC1B,IAAI;IACF,MAAM,UAAU,MAAM,KAAK,gBAAgB;IAC3C,IAAI,KAAK,GAAG,QAAQ;YACb,KAAK;IACZ,KAAK,IAAI,OAAO,KAAK,6CAA6C,EAChE,MAAM,EAAE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,EAAE,EAClE,CAAC;;;EAGN,OAAO"}
+{"version":3,"file":"turn-orchestrator.addon.mjs","names":[],"sources":["../../../src/builtins/turn-orchestrator/turn-orchestrator.addon.ts"],"sourcesContent":["/**\n * TURN orchestrator — singleton facade over the `turn-provider`\n * collection (Cloudflare TURN, coturn, Twilio, …). Mirrors the\n * remote-access-orchestrator persistence + autostart contract:\n *   - `enabledProviders: string[]` in addon-store is the operator's\n *     intent. Boot reads it back; the Enable/Disable toggle in the\n *     admin UI writes it.\n *   - `getAllServers()` (consumed by the WebRTC layer) aggregates ICE\n *     servers ONLY from enabled providers.\n *   - `listProviders()` surfaces the persisted `enabled` flag so the\n *     UI can render the correct toggle state on first paint.\n *\n * Provides:\n *   - listProviders() — admin UI inventory\n *   - getAllServers() — combined ICE server list across enabled providers\n *   - setProviderEnabled() — toggle a provider on/off (persisted)\n */\nimport {\n  BaseAddon,\n  turnOrchestratorCapability,\n  type ITurnOrchestratorProvider,\n  type TurnProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface TurnProviderLike {\n  getTurnServers?: () => Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]>\n  readonly displayName?: string\n  readonly kind?: TurnProviderInfo['kind']\n}\n\ninterface TurnOrchestratorConfig {\n  /**\n   * addonIds the operator has explicitly enabled. Persisted in the\n   * addon-store; first-launch defaults to \"every provider enabled\" so\n   * a freshly-installed TURN addon participates immediately (the\n   * operator can disable from the UI). See `effectivelyEnabled`.\n   */\n  readonly enabledProviders: readonly string[]\n  /**\n   * Sentinel: true after `enabledProviders` has been written at least\n   * once. Distinguishes \"operator hasn't touched the toggles yet —\n   * default-enable all\" from \"operator cleared the list — keep it\n   * empty\". Same shape as local-network's bootSeeded.\n   */\n  readonly enabledProvidersSeeded: boolean\n}\n\nexport class TurnOrchestratorAddon extends BaseAddon<TurnOrchestratorConfig> {\n  constructor() {\n    super({ enabledProviders: [], enabledProvidersSeeded: false })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: ITurnOrchestratorProvider = {\n      listProviders: async () => this.listProviders(),\n      getAllServers: async () => this.getAllServers(),\n      setProviderEnabled: async ({ addonId, enabled }) => {\n        await this.markEnabled(addonId, enabled)\n        return { success: true as const }\n      },\n    }\n    this.ctx.logger.info('TURN orchestrator initialized', {\n      meta: {\n        enabledCount: this.config.enabledProviders.length,\n        seeded: this.config.enabledProvidersSeeded,\n      },\n    })\n    return [{ capability: turnOrchestratorCapability, provider }]\n  }\n\n  private getEntries(): readonly (readonly [string, TurnProviderLike])[] {\n    return this.capabilities?.getCollectionEntries<TurnProviderLike>('turn-provider') ?? []\n  }\n\n  /**\n   * Operator-effective enabled set. Before the first toggle, default\n   * to \"every registered provider is enabled\" so a fresh install of a\n   * TURN addon participates without manual intervention. After the\n   * operator clicks anything, the persisted list is authoritative.\n   */\n  private effectivelyEnabled(): Set<string> {\n    if (this.config.enabledProvidersSeeded) {\n      return new Set(this.config.enabledProviders)\n    }\n    return new Set(this.getEntries().map(([id]) => id))\n  }\n\n  private async markEnabled(addonId: string, enabled: boolean): Promise<void> {\n    const current = this.effectivelyEnabled()\n    const wasEnabled = current.has(addonId)\n    if (enabled) current.add(addonId); else current.delete(addonId)\n    // Always persist with seeded=true so the operator's choice locks in.\n    if (wasEnabled === enabled && this.config.enabledProvidersSeeded) return\n    await this.updateGlobalSettings({\n      enabledProviders: [...current],\n      enabledProvidersSeeded: true,\n    })\n  }\n\n  private async listProviders(): Promise<readonly TurnProviderInfo[]> {\n    const enabled = this.effectivelyEnabled()\n    const out: TurnProviderInfo[] = []\n    for (const [addonId, impl] of this.getEntries()) {\n      let serverCount = 0\n      let urls: readonly string[] = []\n      let error: string | undefined\n      const isEnabled = enabled.has(addonId)\n      // Only fetch live server count for enabled providers — disabled\n      // providers shouldn't be making outbound API calls just to render\n      // an admin row.\n      if (isEnabled && impl.getTurnServers) {\n        try {\n          const servers = await impl.getTurnServers()\n          serverCount = servers.length\n          // Flatten the urls field of every ICE-server entry into one\n          // list — `{ urls: ['stun:a', 'stun:b'] }` becomes `['stun:a',\n          // 'stun:b']`; `{ urls: 'turn:x' }` becomes `['turn:x']`. The\n          // admin UI's compact per-provider chip list iterates this.\n          const flat: string[] = []\n          for (const s of servers) {\n            if (Array.isArray(s.urls)) flat.push(...s.urls)\n            else if (typeof s.urls === 'string') flat.push(s.urls)\n          }\n          urls = flat\n        } catch (err) {\n          error = err instanceof Error ? err.message : String(err)\n        }\n      }\n      out.push({\n        addonId,\n        displayName: impl.displayName ?? addonId,\n        kind: impl.kind ?? (addonId.includes('cloudflare') ? 'cloudflare' as const : addonId.includes('coturn') ? 'coturn' as const : 'other' as const),\n        enabled: isEnabled,\n        serverCount,\n        urls,\n        ...(error !== undefined ? { error } : {}),\n      })\n    }\n    return out\n  }\n\n  private async getAllServers(): Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]> {\n    const enabled = this.effectivelyEnabled()\n    const out: { urls: string | string[]; username?: string; credential?: string }[] = []\n    for (const [addonId, impl] of this.getEntries()) {\n      if (!enabled.has(addonId)) continue\n      if (!impl.getTurnServers) continue\n      try {\n        const servers = await impl.getTurnServers()\n        out.push(...servers)\n      } catch (err) {\n        this.ctx.logger.warn('TURN provider failed to enumerate servers', {\n          meta: { addonId, error: err instanceof Error ? err.message : String(err) },\n        })\n      }\n    }\n    return out\n  }\n}\n\nexport default TurnOrchestratorAddon\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgDA,IAAa,wBAAb,cAA2C,UAAkC;CAC3E,cAAc;EACZ,MAAM;GAAE,kBAAkB,EAAE;GAAE,wBAAwB;GAAO,CAAC;;CAGhE,MAAgB,eAAgD;EAC9D,MAAM,WAAsC;GAC1C,eAAe,YAAY,KAAK,eAAe;GAC/C,eAAe,YAAY,KAAK,eAAe;GAC/C,oBAAoB,OAAO,EAAE,SAAS,cAAc;IAClD,MAAM,KAAK,YAAY,SAAS,QAAQ;IACxC,OAAO,EAAE,SAAS,MAAe;;GAEpC;EACD,KAAK,IAAI,OAAO,KAAK,iCAAiC,EACpD,MAAM;GACJ,cAAc,KAAK,OAAO,iBAAiB;GAC3C,QAAQ,KAAK,OAAO;GACrB,EACF,CAAC;EACF,OAAO,CAAC;GAAE,YAAY;GAA4B;GAAU,CAAC;;CAG/D,aAAuE;EACrE,OAAO,KAAK,cAAc,qBAAuC,gBAAgB,IAAI,EAAE;;;;;;;;CASzF,qBAA0C;EACxC,IAAI,KAAK,OAAO,wBACd,OAAO,IAAI,IAAI,KAAK,OAAO,iBAAiB;EAE9C,OAAO,IAAI,IAAI,KAAK,YAAY,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC;;CAGrD,MAAc,YAAY,SAAiB,SAAiC;EAC1E,MAAM,UAAU,KAAK,oBAAoB;EACzC,MAAM,aAAa,QAAQ,IAAI,QAAQ;EACvC,IAAI,SAAS,QAAQ,IAAI,QAAQ;OAAO,QAAQ,OAAO,QAAQ;EAE/D,IAAI,eAAe,WAAW,KAAK,OAAO,wBAAwB;EAClE,MAAM,KAAK,qBAAqB;GAC9B,kBAAkB,CAAC,GAAG,QAAQ;GAC9B,wBAAwB;GACzB,CAAC;;CAGJ,MAAc,gBAAsD;EAClE,MAAM,UAAU,KAAK,oBAAoB;EACzC,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,KAAK,YAAY,EAAE;GAC/C,IAAI,cAAc;GAClB,IAAI,OAA0B,EAAE;GAChC,IAAI;GACJ,MAAM,YAAY,QAAQ,IAAI,QAAQ;GAItC,IAAI,aAAa,KAAK,gBACpB,IAAI;IACF,MAAM,UAAU,MAAM,KAAK,gBAAgB;IAC3C,cAAc,QAAQ;IAKtB,MAAM,OAAiB,EAAE;IACzB,KAAK,MAAM,KAAK,SACd,IAAI,MAAM,QAAQ,EAAE,KAAK,EAAE,KAAK,KAAK,GAAG,EAAE,KAAK;SAC1C,IAAI,OAAO,EAAE,SAAS,UAAU,KAAK,KAAK,EAAE,KAAK;IAExD,OAAO;YACA,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC,MAAM,KAAK,SAAS,QAAQ,SAAS,aAAa,GAAG,eAAwB,QAAQ,SAAS,SAAS,GAAG,WAAoB;IAC9H,SAAS;IACT;IACA;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACzC,CAAC;;EAEJ,OAAO;;CAGT,MAAc,gBAAyG;EACrH,MAAM,UAAU,KAAK,oBAAoB;EACzC,MAAM,MAA6E,EAAE;EACrF,KAAK,MAAM,CAAC,SAAS,SAAS,KAAK,YAAY,EAAE;GAC/C,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE;GAC3B,IAAI,CAAC,KAAK,gBAAgB;GAC1B,IAAI;IACF,MAAM,UAAU,MAAM,KAAK,gBAAgB;IAC3C,IAAI,KAAK,GAAG,QAAQ;YACb,KAAK;IACZ,KAAK,IAAI,OAAO,KAAK,6CAA6C,EAChE,MAAM;KAAE;KAAS,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;KAAE,EAC3E,CAAC;;;EAGN,OAAO"}

package/dist/index.js

@@ -37,7 +37,7 @@ let node_vm = require("node:vm");
 node_vm = require_chunk.__toESM(node_vm);
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
-//#region ../types/dist/auth-records-BDg37fy9.mjs
+//#region ../types/dist/auth-records-BpjTmlhM.mjs
 var MODEL_FORMATS = [
 	"onnx",
 	"coreml",
@@ -3425,6 +3425,14 @@ var TurnProviderInfoSchema = zod.z.object({
 	enabled: zod.z.boolean(),
 	/** Number of servers this provider is currently exposing. */
 	serverCount: zod.z.number(),
+	/**
+	* Flat list of every TURN/STUN URL this provider currently exposes.
+	* One row per URL (multi-URL ICE server entries are flattened). The
+	* admin UI shows this in a compact per-provider list so operators
+	* can verify what's actually being negotiated without having to dig
+	* into the combined `getAllServers` output.
+	*/
+	urls: zod.z.array(zod.z.string()).readonly(),
 	/** Last fetch error (when serverCount=0 due to API failure), if any. */
 	error: zod.z.string().optional()
 });