@memberjunction/telephony-adapters 0.0.0 → 6.1.0-edge.7

package/dist/telephony/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Telephony and meetings exports for @memberjunction/telephony-adapters.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+export { TwilioCallMediaRegistry } from './twilioMediaRegistry.js';
+export { TwilioTelephonyService, type TwilioTelephonyServiceDeps } from './TwilioTelephonyService.js';
+export * from './TwilioTelephonyRouter.js';
+export * from './telephony-runtime.js';
+export { VonageCallMediaRegistry } from './vonageMediaRegistry.js';
+export { VonageTelephonyService, type VonageTelephonyServiceDeps } from './VonageTelephonyService.js';
+export * from './VonageTelephonyRouter.js';
+export * from './vonage-runtime.js';
+export { RingCentralTelephonyService, type RingCentralTelephonyServiceDeps } from './RingCentralTelephonyService.js';
+export * from './ringcentral-runtime.js';
+export * from './teamsAcsMediaRegistry.js';
+export * from './TeamsMeetingsService.js';
+export * from './TeamsMeetingsRouter.js';
+export * from './teams-meetings-runtime.js';
+export * from './calendar-scheduler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/telephony/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telephony/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,2BAA2B,EAAE,KAAK,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACrH,cAAc,0BAA0B,CAAC;AAGzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,yBAAyB,CAAC"}

package/dist/telephony/index.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Telephony and meetings exports for @memberjunction/telephony-adapters.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+// ── Twilio Programmable Voice + Media Streams ──────────────────────────────────────────
+export { TwilioCallMediaRegistry } from './twilioMediaRegistry.js';
+export { TwilioTelephonyService } from './TwilioTelephonyService.js';
+export * from './TwilioTelephonyRouter.js';
+export * from './telephony-runtime.js';
+// ── Vonage Voice + WebSocket-media ─────────────────────────────────────────────────────
+export { VonageCallMediaRegistry } from './vonageMediaRegistry.js';
+export { VonageTelephonyService } from './VonageTelephonyService.js';
+export * from './VonageTelephonyRouter.js';
+export * from './vonage-runtime.js';
+// ── RingCentral SIP softphone ──────────────────────────────────────────────────────────
+export { RingCentralTelephonyService } from './RingCentralTelephonyService.js';
+export * from './ringcentral-runtime.js';
+// ── Teams meetings (Microsoft Graph cloud-communications + ACS application-hosted media) ──
+export * from './teamsAcsMediaRegistry.js';
+export * from './TeamsMeetingsService.js';
+export * from './TeamsMeetingsRouter.js';
+export * from './teams-meetings-runtime.js';
+// ── Scheduled / invite-driven meeting join loop ────────────────────────────────────────
+export * from './calendar-scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/telephony/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telephony/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0FAA0F;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAmC,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AAEvC,0FAA0F;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAmC,MAAM,6BAA6B,CAAC;AACtG,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AAEpC,0FAA0F;AAC1F,OAAO,EAAE,2BAA2B,EAAwC,MAAM,kCAAkC,CAAC;AACrH,cAAc,0BAA0B,CAAC;AAEzC,6FAA6F;AAC7F,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAE5C,0FAA0F;AAC1F,cAAc,yBAAyB,CAAC"}

package/dist/telephony/ringcentral-runtime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed RingCentral telephony service.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import type { RingCentralTelephonyService } from './RingCentralTelephonyService.js';
+/** Binds the startup-constructed RingCentral telephony service (called from server boot). */
+export declare function SetRingCentralTelephonyService(service: RingCentralTelephonyService | undefined): void;
+/** Returns the bound RingCentral telephony service, or `undefined` when telephony is not configured. */
+export declare function GetRingCentralTelephonyService(): RingCentralTelephonyService | undefined;
+//# sourceMappingURL=ringcentral-runtime.d.ts.map

package/dist/telephony/ringcentral-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ringcentral-runtime.d.ts","sourceRoot":"","sources":["../../src/telephony/ringcentral-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAIpF,6FAA6F;AAC7F,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,GAAG,IAAI,CAKrG;AAED,wGAAwG;AACxG,wBAAgB,8BAA8B,IAAI,2BAA2B,GAAG,SAAS,CAGxF"}

package/dist/telephony/ringcentral-runtime.js

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed RingCentral telephony service.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import { MJGlobal } from '@memberjunction/global';
+const RINGCENTRAL_SERVICE_KEY = '__MJ_RINGCENTRAL_TELEPHONY_SERVICE__';
+/** Binds the startup-constructed RingCentral telephony service (called from server boot). */
+export function SetRingCentralTelephonyService(service) {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    if (store) {
+        store[RINGCENTRAL_SERVICE_KEY] = service;
+    }
+}
+/** Returns the bound RingCentral telephony service, or `undefined` when telephony is not configured. */
+export function GetRingCentralTelephonyService() {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    return store ? store[RINGCENTRAL_SERVICE_KEY] : undefined;
+}
+//# sourceMappingURL=ringcentral-runtime.js.map

package/dist/telephony/ringcentral-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ringcentral-runtime.js","sourceRoot":"","sources":["../../src/telephony/ringcentral-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,uBAAuB,GAAG,sCAAsC,CAAC;AAEvE,6FAA6F;AAC7F,MAAM,UAAU,8BAA8B,CAAC,OAAgD;IAC3F,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACR,KAAK,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC;IAC7C,CAAC;AACL,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,8BAA8B;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,uBAAuB,CAA6C,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3G,CAAC"}

package/dist/telephony/teams-meetings-runtime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed Teams meetings service.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import type { TeamsMeetingsService } from './TeamsMeetingsService.js';
+/** Binds the startup-constructed Teams meetings service (called from server boot). */
+export declare function SetTeamsMeetingsService(service: TeamsMeetingsService | undefined): void;
+/** Returns the bound Teams meetings service, or `undefined` when Teams meetings are not configured. */
+export declare function GetTeamsMeetingsService(): TeamsMeetingsService | undefined;
+//# sourceMappingURL=teams-meetings-runtime.d.ts.map

package/dist/telephony/teams-meetings-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-meetings-runtime.d.ts","sourceRoot":"","sources":["../../src/telephony/teams-meetings-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItE,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,CAKvF;AAED,uGAAuG;AACvG,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAG1E"}

package/dist/telephony/teams-meetings-runtime.js

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed Teams meetings service.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import { MJGlobal } from '@memberjunction/global';
+const TEAMS_SERVICE_KEY = '__MJ_TEAMS_MEETINGS_SERVICE__';
+/** Binds the startup-constructed Teams meetings service (called from server boot). */
+export function SetTeamsMeetingsService(service) {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    if (store) {
+        store[TEAMS_SERVICE_KEY] = service;
+    }
+}
+/** Returns the bound Teams meetings service, or `undefined` when Teams meetings are not configured. */
+export function GetTeamsMeetingsService() {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    return store ? store[TEAMS_SERVICE_KEY] : undefined;
+}
+//# sourceMappingURL=teams-meetings-runtime.js.map

package/dist/telephony/teams-meetings-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-meetings-runtime.js","sourceRoot":"","sources":["../../src/telephony/teams-meetings-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAE1D,sFAAsF;AACtF,MAAM,UAAU,uBAAuB,CAAC,OAAyC;IAC7E,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACR,KAAK,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC;IACvC,CAAC;AACL,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,uBAAuB;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,iBAAiB,CAAsC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9F,CAAC"}

package/dist/telephony/teamsAcsMediaRegistry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Per-call ACS application-hosted-media pump registry for the Teams meetings ingress.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import type { AcsInboundAudioFrame, IAcsMediaPump } from '@memberjunction/ai-bridge-teams';
+/**
+ * The minimal ACS media-transport surface the registry drives.
+ */
+export interface IAcsMediaTransport {
+    /** Sends one outbound PCM16 frame on the call's application-hosted-media outbound audio socket. */
+    sendAudioFrame(pcm: ArrayBuffer): void;
+    /** Closes the call's media transport (best-effort; called on call end). */
+    close(): void;
+}
+/**
+ * Coordinates ACS application-hosted-media transports with the bridge bindings, keyed by Graph call id.
+ */
+export declare class TeamsAcsMediaRegistry implements IAcsMediaPump {
+    readonly SampleRate: number;
+    private readonly channels;
+    constructor(SampleRate?: number);
+    /** Ensures a channel exists for a call (called when a meeting bridge session for the call starts). */
+    RegisterCall(callId: string): void;
+    Send(callId: string, pcm: ArrayBuffer): void;
+    OnFrame(callId: string, handler: (frame: AcsInboundAudioFrame) => void): void;
+    OnHandRaise(callId: string, handler: (participantId: string, raised: boolean) => void): void;
+    AttachTransport(callId: string, transport: IAcsMediaTransport): void;
+    DispatchInbound(callId: string, frame: AcsInboundAudioFrame): void;
+    DispatchHandRaise(callId: string, participantId: string, raised: boolean): void;
+    EndCall(callId: string): void;
+    HasCall(callId: string): boolean;
+    private ensureChannel;
+}
+//# sourceMappingURL=teamsAcsMediaRegistry.d.ts.map

package/dist/telephony/teamsAcsMediaRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamsAcsMediaRegistry.d.ts","sourceRoot":"","sources":["../../src/telephony/teamsAcsMediaRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,mGAAmG;IACnG,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;CACjB;AAUD;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;aAG3B,UAAU;IAFtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEpC,UAAU,SAAQ;IAE9C,sGAAsG;IAC/F,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMlC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAS5C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAI7E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAM5F,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI;IASpE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAUlE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAU/E,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa7B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC,OAAO,CAAC,aAAa;CAQxB"}

package/dist/telephony/teamsAcsMediaRegistry.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Per-call ACS application-hosted-media pump registry for the Teams meetings ingress.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+/**
+ * Coordinates ACS application-hosted-media transports with the bridge bindings, keyed by Graph call id.
+ */
+export class TeamsAcsMediaRegistry {
+    constructor(SampleRate = 16000) {
+        this.SampleRate = SampleRate;
+        this.channels = new Map();
+    }
+    /** Ensures a channel exists for a call (called when a meeting bridge session for the call starts). */
+    RegisterCall(callId) {
+        this.ensureChannel(callId);
+    }
+    // ── IAcsMediaPump ─────────────────────────────────────────────────────────────
+    Send(callId, pcm) {
+        const channel = this.ensureChannel(callId);
+        if (channel.transport) {
+            channel.transport.sendAudioFrame(pcm);
+        }
+        else {
+            channel.outboundBuffer.push(pcm);
+        }
+    }
+    OnFrame(callId, handler) {
+        this.ensureChannel(callId).frameHandlers.push(handler);
+    }
+    OnHandRaise(callId, handler) {
+        this.ensureChannel(callId).handRaiseHandlers.push(handler);
+    }
+    // ── native-adapter side ─────────────────────────────────────────────────────
+    AttachTransport(callId, transport) {
+        const channel = this.ensureChannel(callId);
+        channel.transport = transport;
+        const buffered = channel.outboundBuffer.splice(0, channel.outboundBuffer.length);
+        for (const pcm of buffered) {
+            transport.sendAudioFrame(pcm);
+        }
+    }
+    DispatchInbound(callId, frame) {
+        const channel = this.channels.get(callId);
+        if (!channel) {
+            return;
+        }
+        for (const handler of channel.frameHandlers) {
+            handler(frame);
+        }
+    }
+    DispatchHandRaise(callId, participantId, raised) {
+        const channel = this.channels.get(callId);
+        if (!channel) {
+            return;
+        }
+        for (const handler of channel.handRaiseHandlers) {
+            handler(participantId, raised);
+        }
+    }
+    EndCall(callId) {
+        const channel = this.channels.get(callId);
+        if (!channel) {
+            return;
+        }
+        try {
+            channel.transport?.close();
+        }
+        catch {
+            /* best-effort */
+        }
+        this.channels.delete(callId);
+    }
+    HasCall(callId) {
+        return this.channels.has(callId);
+    }
+    ensureChannel(callId) {
+        let channel = this.channels.get(callId);
+        if (!channel) {
+            channel = { frameHandlers: [], handRaiseHandlers: [], outboundBuffer: [] };
+            this.channels.set(callId, channel);
+        }
+        return channel;
+    }
+}
+//# sourceMappingURL=teamsAcsMediaRegistry.js.map

package/dist/telephony/teamsAcsMediaRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamsAcsMediaRegistry.js","sourceRoot":"","sources":["../../src/telephony/teamsAcsMediaRegistry.ts"],"names":[],"mappings":"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"}

package/dist/telephony/telephony-runtime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed telephony service, so the
+ * outbound `PlaceTwilioCall` GraphQL resolver reaches the SAME {@link TwilioTelephonyService}
+ * (and thus the same {@link TwilioCallMediaRegistry} the Media-Streams WSS attaches sockets to)
+ * that the inbound webhook router uses.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import type { TwilioTelephonyService } from './TwilioTelephonyService.js';
+/** Binds the startup-constructed Twilio telephony service (called from server boot). */
+export declare function SetTwilioTelephonyService(service: TwilioTelephonyService | undefined): void;
+/** Returns the bound Twilio telephony service, or `undefined` when telephony is not configured. */
+export declare function GetTwilioTelephonyService(): TwilioTelephonyService | undefined;
+//# sourceMappingURL=telephony-runtime.d.ts.map

package/dist/telephony/telephony-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telephony-runtime.d.ts","sourceRoot":"","sources":["../../src/telephony/telephony-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAI1E,wFAAwF;AACxF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI,CAK3F;AAED,mGAAmG;AACnG,wBAAgB,yBAAyB,IAAI,sBAAsB,GAAG,SAAS,CAG9E"}

package/dist/telephony/telephony-runtime.js

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed telephony service, so the
+ * outbound `PlaceTwilioCall` GraphQL resolver reaches the SAME {@link TwilioTelephonyService}
+ * (and thus the same {@link TwilioCallMediaRegistry} the Media-Streams WSS attaches sockets to)
+ * that the inbound webhook router uses.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import { MJGlobal } from '@memberjunction/global';
+const TWILIO_SERVICE_KEY = '__MJ_TWILIO_TELEPHONY_SERVICE__';
+/** Binds the startup-constructed Twilio telephony service (called from server boot). */
+export function SetTwilioTelephonyService(service) {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    if (store) {
+        store[TWILIO_SERVICE_KEY] = service;
+    }
+}
+/** Returns the bound Twilio telephony service, or `undefined` when telephony is not configured. */
+export function GetTwilioTelephonyService() {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    return store ? store[TWILIO_SERVICE_KEY] : undefined;
+}
+//# sourceMappingURL=telephony-runtime.js.map

package/dist/telephony/telephony-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telephony-runtime.js","sourceRoot":"","sources":["../../src/telephony/telephony-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AAE7D,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CAAC,OAA2C;IACjF,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACR,KAAK,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC;IACxC,CAAC;AACL,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,yBAAyB;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,kBAAkB,CAAwC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjG,CAAC"}

package/dist/telephony/twilioMediaRegistry.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Per-call Media-Streams pump registry for the Twilio telephony ingress.
+ *
+ * This is the server half of the Twilio media plane: it implements the provider package's
+ * `ITwilioMediaPump` seam (which `RealTwilioBindings` drives) on top of the live Media-Streams
+ * websockets MJAPI accepts at `WSS /telephony/twilio/media`. It exists because of a lifecycle gap:
+ * when an INBOUND call's webhook fires, the bridge session starts and `RealTwilioBindings` registers
+ * its inbound-audio handler — but Twilio has not yet opened the media websocket (it does so only AFTER
+ * the webhook's `<Connect><Stream>` TwiML response). The registry bridges that gap by buffering
+ * handler registrations + outbound frames per Call SID and binding them to the socket once it connects
+ * (matched on the `start` frame's Call SID).
+ *
+ * Pure + unit-testable: the websocket is injected as the minimal {@link ITelephonyMediaSocket} surface,
+ * so the registry's buffering / dispatch / stream-SID capture logic is exercised with a fake socket and
+ * no `ws` install or network.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import type { TwilioMediaFrame } from '@memberjunction/ai-bridge-twilio';
+import type { ITwilioMediaPump } from '@memberjunction/ai-bridge-twilio';
+/**
+ * The minimal websocket surface the registry drives — a structural subset of a `ws` socket, so the
+ * registry never imports `ws` and is testable with a fake. Outbound frames are sent as JSON strings.
+ */
+export interface ITelephonyMediaSocket {
+    /** Sends a serialized outbound Media-Streams frame on the call's socket. */
+    send(data: string): void;
+    /** Closes the socket (best-effort; called on call end). */
+    close(): void;
+}
+/**
+ * Coordinates Media-Streams sockets with the bridge bindings, keyed by Call SID. One instance per
+ * server, shared between the inbound-webhook service (which binds `RealTwilioBindings` over this as the
+ * `ITwilioMediaPump`) and the WSS server (which attaches sockets + dispatches inbound frames).
+ */
+export declare class TwilioCallMediaRegistry implements ITwilioMediaPump {
+    private readonly channels;
+    /** Ensures a channel exists for a call (called when a bridge session for the call starts). */
+    RegisterCall(callSid: string): void;
+    /** @inheritdoc — buffers when the socket has not yet connected; sends immediately once it has. Flushes buffer on 'clear'. */
+    Send(callSid: string, frame: TwilioMediaFrame): void;
+    /** @inheritdoc — stores the handler so frames delivered before AND after socket connect reach it. */
+    OnFrame(callSid: string, handler: (frame: TwilioMediaFrame) => void): void;
+    /** @inheritdoc — the captured stream SID, or `''` until the `start` frame arrives. */
+    GetStreamSid(callSid: string): string;
+    /**
+     * Binds a connected Media-Streams socket (and its captured stream SID) to a call, flushing any
+     * outbound frames produced while the socket was still connecting. Called by the WSS server on the
+     * `start` frame.
+     */
+    AttachSocket(callSid: string, socket: ITelephonyMediaSocket, streamSid: string): void;
+    /** Dispatches one inbound Media-Streams frame to all registered handlers for the call. */
+    DispatchInbound(callSid: string, frame: TwilioMediaFrame): void;
+    /** Tears down a call's channel and closes its socket (called on socket close / call end). */
+    EndCall(callSid: string): void;
+    /** Whether a channel is currently tracked for the call (test/observability helper). */
+    HasCall(callSid: string): boolean;
+    private ensureChannel;
+}
+//# sourceMappingURL=twilioMediaRegistry.d.ts.map

package/dist/telephony/twilioMediaRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilioMediaRegistry.d.ts","sourceRoot":"","sources":["../../src/telephony/twilioMediaRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2DAA2D;IAC3D,KAAK,IAAI,IAAI,CAAC;CACjB;AAYD;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE,8FAA8F;IACvF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM1C,6HAA6H;IACtH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAY3D,qGAAqG;IAC9F,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAIjF,sFAAsF;IAC/E,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAM5C;;;;OAIG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAU5F,0FAA0F;IACnF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAatE,6FAA6F;IACtF,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAarC,uFAAuF;IAChF,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIxC,OAAO,CAAC,aAAa;CAQxB"}

package/dist/telephony/twilioMediaRegistry.js

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Per-call Media-Streams pump registry for the Twilio telephony ingress.
+ *
+ * This is the server half of the Twilio media plane: it implements the provider package's
+ * `ITwilioMediaPump` seam (which `RealTwilioBindings` drives) on top of the live Media-Streams
+ * websockets MJAPI accepts at `WSS /telephony/twilio/media`. It exists because of a lifecycle gap:
+ * when an INBOUND call's webhook fires, the bridge session starts and `RealTwilioBindings` registers
+ * its inbound-audio handler — but Twilio has not yet opened the media websocket (it does so only AFTER
+ * the webhook's `<Connect><Stream>` TwiML response). The registry bridges that gap by buffering
+ * handler registrations + outbound frames per Call SID and binding them to the socket once it connects
+ * (matched on the `start` frame's Call SID).
+ *
+ * Pure + unit-testable: the websocket is injected as the minimal {@link ITelephonyMediaSocket} surface,
+ * so the registry's buffering / dispatch / stream-SID capture logic is exercised with a fake socket and
+ * no `ws` install or network.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+/**
+ * Coordinates Media-Streams sockets with the bridge bindings, keyed by Call SID. One instance per
+ * server, shared between the inbound-webhook service (which binds `RealTwilioBindings` over this as the
+ * `ITwilioMediaPump`) and the WSS server (which attaches sockets + dispatches inbound frames).
+ */
+export class TwilioCallMediaRegistry {
+    constructor() {
+        this.channels = new Map();
+    }
+    /** Ensures a channel exists for a call (called when a bridge session for the call starts). */
+    RegisterCall(callSid) {
+        this.ensureChannel(callSid);
+    }
+    // ── ITwilioMediaPump ─────────────────────────────────────────────────────────
+    /** @inheritdoc — buffers when the socket has not yet connected; sends immediately once it has. Flushes buffer on 'clear'. */
+    Send(callSid, frame) {
+        const channel = this.ensureChannel(callSid);
+        if (frame.event === 'clear') {
+            channel.outboundBuffer.length = 0;
+        }
+        if (channel.socket) {
+            channel.socket.send(JSON.stringify(frame));
+        }
+        else if (frame.event !== 'clear') {
+            channel.outboundBuffer.push(frame);
+        }
+    }
+    /** @inheritdoc — stores the handler so frames delivered before AND after socket connect reach it. */
+    OnFrame(callSid, handler) {
+        this.ensureChannel(callSid).frameHandlers.push(handler);
+    }
+    /** @inheritdoc — the captured stream SID, or `''` until the `start` frame arrives. */
+    GetStreamSid(callSid) {
+        return this.channels.get(callSid)?.streamSid ?? '';
+    }
+    // ── WSS-server side ─────────────────────────────────────────────────────────
+    /**
+     * Binds a connected Media-Streams socket (and its captured stream SID) to a call, flushing any
+     * outbound frames produced while the socket was still connecting. Called by the WSS server on the
+     * `start` frame.
+     */
+    AttachSocket(callSid, socket, streamSid) {
+        const channel = this.ensureChannel(callSid);
+        channel.socket = socket;
+        channel.streamSid = streamSid;
+        const buffered = channel.outboundBuffer.splice(0, channel.outboundBuffer.length);
+        for (const frame of buffered) {
+            socket.send(JSON.stringify(frame));
+        }
+    }
+    /** Dispatches one inbound Media-Streams frame to all registered handlers for the call. */
+    DispatchInbound(callSid, frame) {
+        const channel = this.channels.get(callSid);
+        if (!channel) {
+            return;
+        }
+        if (frame.event === 'start' && frame.streamSid) {
+            channel.streamSid = frame.streamSid;
+        }
+        for (const handler of channel.frameHandlers) {
+            handler(frame);
+        }
+    }
+    /** Tears down a call's channel and closes its socket (called on socket close / call end). */
+    EndCall(callSid) {
+        const channel = this.channels.get(callSid);
+        if (!channel) {
+            return;
+        }
+        try {
+            channel.socket?.close();
+        }
+        catch {
+            /* best-effort */
+        }
+        this.channels.delete(callSid);
+    }
+    /** Whether a channel is currently tracked for the call (test/observability helper). */
+    HasCall(callSid) {
+        return this.channels.has(callSid);
+    }
+    ensureChannel(callSid) {
+        let channel = this.channels.get(callSid);
+        if (!channel) {
+            channel = { frameHandlers: [], outboundBuffer: [] };
+            this.channels.set(callSid, channel);
+        }
+        return channel;
+    }
+}
+//# sourceMappingURL=twilioMediaRegistry.js.map

package/dist/telephony/twilioMediaRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilioMediaRegistry.js","sourceRoot":"","sources":["../../src/telephony/twilioMediaRegistry.ts"],"names":[],"mappings":"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"}

package/dist/telephony/vonage-runtime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed Vonage telephony service.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import type { VonageTelephonyService } from './VonageTelephonyService.js';
+/** Binds the startup-constructed Vonage telephony service (called from server boot). */
+export declare function SetVonageTelephonyService(service: VonageTelephonyService | undefined): void;
+/** Returns the bound Vonage telephony service, or `undefined` when telephony is not configured. */
+export declare function GetVonageTelephonyService(): VonageTelephonyService | undefined;
+//# sourceMappingURL=vonage-runtime.d.ts.map

package/dist/telephony/vonage-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vonage-runtime.d.ts","sourceRoot":"","sources":["../../src/telephony/vonage-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAI1E,wFAAwF;AACxF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI,CAK3F;AAED,mGAAmG;AACnG,wBAAgB,yBAAyB,IAAI,sBAAsB,GAAG,SAAS,CAG9E"}

package/dist/telephony/vonage-runtime.js

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed Vonage telephony service.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import { MJGlobal } from '@memberjunction/global';
+const VONAGE_SERVICE_KEY = '__MJ_VONAGE_TELEPHONY_SERVICE__';
+/** Binds the startup-constructed Vonage telephony service (called from server boot). */
+export function SetVonageTelephonyService(service) {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    if (store) {
+        store[VONAGE_SERVICE_KEY] = service;
+    }
+}
+/** Returns the bound Vonage telephony service, or `undefined` when telephony is not configured. */
+export function GetVonageTelephonyService() {
+    const store = MJGlobal.Instance.GetGlobalObjectStore();
+    return store ? store[VONAGE_SERVICE_KEY] : undefined;
+}
+//# sourceMappingURL=vonage-runtime.js.map

package/dist/telephony/vonage-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vonage-runtime.js","sourceRoot":"","sources":["../../src/telephony/vonage-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AAE7D,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CAAC,OAA2C;IACjF,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACR,KAAK,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC;IACxC,CAAC;AACL,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,yBAAyB;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAE,KAAK,CAAC,kBAAkB,CAAwC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjG,CAAC"}

package/dist/telephony/vonageMediaRegistry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Per-call WebSocket-media pump registry for the Vonage telephony ingress.
+ *
+ * @module @memberjunction/telephony-adapters
+ */
+import type { VonageControlEvent, IVonageMediaPump } from '@memberjunction/ai-bridge-vonage';
+/**
+ * The minimal websocket surface the registry drives — a structural subset of a `ws` socket, so the
+ * registry never imports `ws` and is testable with a fake. Vonage audio is sent as BINARY frames (raw
+ * L16 PCM); the registry never sends text frames outbound (Vonage's media socket only accepts audio).
+ */
+export interface ITelephonyMediaSocket {
+    /** Sends one outbound BINARY audio frame (raw L16 PCM) on the call's socket. */
+    sendBinary(data: Uint8Array): void;
+    /** Sends one outbound TEXT control frame (JSON command, e.g. `{"action":"clear"}`) on the call's socket. */
+    sendText(data: string): void;
+    /** Closes the socket (best-effort; called on call end). */
+    close(): void;
+}
+/**
+ * Coordinates Vonage media websockets with the bridge bindings, keyed by call UUID.
+ */
+export declare class VonageCallMediaRegistry implements IVonageMediaPump {
+    private readonly channels;
+    /** Ensures a channel exists for a call (called when a bridge session for the call starts). */
+    RegisterCall(callUuid: string): void;
+    SendAudio(callUuid: string, pcm: ArrayBuffer): void;
+    OnAudio(callUuid: string, handler: (pcm: ArrayBuffer) => void): void;
+    OnEvent(callUuid: string, handler: (event: VonageControlEvent) => void): void;
+    Clear(callUuid: string): void;
+    AttachSocket(callUuid: string, socket: ITelephonyMediaSocket): void;
+    DispatchInboundAudio(callUuid: string, pcm: ArrayBuffer): void;
+    DispatchInboundEvent(callUuid: string, event: VonageControlEvent): void;
+    EndCall(callUuid: string): void;
+    HasCall(callUuid: string): boolean;
+    private ensureChannel;
+}
+//# sourceMappingURL=vonageMediaRegistry.d.ts.map

package/dist/telephony/vonageMediaRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vonageMediaRegistry.d.ts","sourceRoot":"","sources":["../../src/telephony/vonageMediaRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC,gFAAgF;IAChF,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2DAA2D;IAC3D,KAAK,IAAI,IAAI,CAAC;CACjB;AAiBD;;GAEG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE,8FAA8F;IACvF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMpC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAmBnD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIpE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAI7E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAY7B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI;IASnE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAU9D,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAUvE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAa/B,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC,OAAO,CAAC,aAAa;CAQxB"}