@memberjunction/server 5.44.0 → 5.45.1

package/dist/telephony/calendar-scheduler.js

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Host wiring for the scheduled/invite-driven meeting join loop (program M2).
+ *
+ * Composes the offline-complete seams from `@memberjunction/ai-bridge-server` into a running
+ * background loop, mirroring the {@link SessionJanitor} startup pattern (run once at boot, then on an
+ * interval):
+ *
+ *   1. {@link CalendarWatcher} polls each agent identity's calendar (via the injected
+ *      {@link CalendarSourceResolver}, bound here to the real {@link GraphCalendarClient} /
+ *      {@link GoogleCalendarClient}) and creates a `Scheduled` `AIAgentSessionBridge` for every invite
+ *      addressed to the agent.
+ *   2. {@link ScheduledBridgeRunner} starts each bridge whose `ScheduledStartTime` is due, building the
+ *      realtime session + the provider bind-sdk via the per-provider meeting service (Teams today).
+ *
+ * Calendar credentials are PRE-RESOLVED upstream (the bot's Graph access token comes from the Teams
+ * meetings config — `botAccessToken`, resolved via MJ config, never inline). Google calendar polling
+ * binds only when a Google auth client is supplied; otherwise those identities are skipped (the watcher
+ * tolerates a `null` source per identity). Live verification requires a real tenant + the Azure app /
+ * Google service account — the same access the meeting bridges need.
+ *
+ * @module @memberjunction/server/telephony
+ */
+import { LogStatus, LogError } from '@memberjunction/core';
+import { CalendarWatcher, ScheduledBridgeRunner, GraphCalendarSource, GraphCalendarClient, } from '@memberjunction/ai-bridge-server';
+/** The Teams bridge driver class — identities/bridges on this provider poll Graph + join via the Teams service. */
+const TEAMS_PROVIDER_DRIVER = 'TeamsBridge';
+/** Default cadence (ms) for the calendar sweep + due-bridge run. 60s balances freshness vs. API quota. */
+const DEFAULT_POLL_INTERVAL_MS = 60_000;
+/**
+ * Builds the {@link CalendarSourceResolver} that binds the real calendar clients per identity. Graph
+ * (Teams/Microsoft) identities bind a {@link GraphCalendarClient} authenticated with the bot's
+ * pre-resolved Graph token; any identity without configured credentials resolves to `null` and is
+ * skipped this sweep (the watcher tolerates that). Google binding activates when a Google auth client
+ * is wired into the deployment (none configured today → Google-backed identities are skipped).
+ */
+export function buildCalendarSourceResolver(teamsConfig) {
+    return (_identity, provider) => {
+        const driver = provider?.DriverClass?.trim();
+        if (driver === TEAMS_PROVIDER_DRIVER && teamsConfig.botAccessToken) {
+            return new GraphCalendarSource(new GraphCalendarClient({ Credentials: { AccessToken: teamsConfig.botAccessToken } }));
+        }
+        // Google Calendar is a deliberate, CLOSED seam — intentionally not bound here. The
+        // GoogleCalendarClient is built + unit-tested, but binding it would be dead code today:
+        //   1. there is no Google Meet *join* path for a detected invite to trigger (the scheduled-join
+        //      factory is Teams-only), and
+        //   2. Google's Meet Media API is Developer-Preview + allowlist-gated regardless (every meeting
+        //      participant must be enrolled), so it isn't a shippable target.
+        // To activate: define a Google auth client from config AND wire a Google Meet join. Until then
+        // Google identities are skipped rather than erroring the sweep.
+        return null;
+    };
+}
+/**
+ * Builds the {@link ScheduledBridgeSessionFactory} that turns a due bridge into start params. Resolves
+ * the bridge's agent (via its `AIAgentSession`) and, for a Teams bridge, delegates to the shared
+ * {@link TeamsMeetingsService} so the scheduled join reuses the exact provider/session/bind-sdk path as
+ * an on-demand join. Returns `null` (skip) for a provider with no scheduled-join wiring yet, or when the
+ * bridge has no join address.
+ */
+export function buildScheduledSessionFactory(teamsService) {
+    return async (ctx) => {
+        const joinUrl = ctx.BridgeRow.Address?.trim();
+        if (!joinUrl) {
+            LogStatus(`[CalendarScheduler] bridge ${ctx.BridgeRow.ID} has no join address; skipping.`);
+            return null;
+        }
+        if (ctx.Provider.DriverClass?.trim() !== TEAMS_PROVIDER_DRIVER) {
+            LogStatus(`[CalendarScheduler] no scheduled-join wiring for provider '${ctx.Provider.Name}'; skipping bridge ${ctx.BridgeRow.ID}.`);
+            return null;
+        }
+        const agentID = await resolveAgentID(ctx.BridgeRow.AgentSessionID, ctx.ContextUser, ctx.MetadataProvider);
+        if (!agentID) {
+            LogStatus(`[CalendarScheduler] could not resolve agent for session ${ctx.BridgeRow.AgentSessionID}; skipping.`);
+            return null;
+        }
+        const params = await teamsService.BuildScheduledStartParams({
+            agentID,
+            joinUrl,
+            agentSessionID: ctx.BridgeRow.AgentSessionID,
+            contextUser: ctx.ContextUser,
+            provider: ctx.MetadataProvider,
+        });
+        return params;
+    };
+}
+/** Loads the `AIAgentSession` to resolve the agent the scheduled bridge belongs to. */
+async function resolveAgentID(agentSessionID, contextUser, provider) {
+    const session = await provider.GetEntityObject('MJ: AI Agent Sessions', contextUser);
+    if (!(await session.Load(agentSessionID))) {
+        return null;
+    }
+    return session.AgentID;
+}
+/**
+ * Starts the calendar/scheduled-bridge loop: sweeps calendars and runs due bridges once immediately,
+ * then on a fixed interval. Mirrors {@link SessionJanitor.Start}. A sweep/run failure is logged and the
+ * loop continues — a transient calendar/transport error never kills the scheduler.
+ */
+export function StartCalendarScheduler(options) {
+    const watcher = new CalendarWatcher({
+        SourceResolver: buildCalendarSourceResolver(options.TeamsConfig),
+        ContextUser: options.ContextUser,
+        MetadataProvider: options.Provider,
+    });
+    const runner = new ScheduledBridgeRunner({
+        SessionFactory: buildScheduledSessionFactory(options.TeamsService),
+        ContextUser: options.ContextUser,
+        MetadataProvider: options.Provider,
+    });
+    const tick = async () => {
+        try {
+            const swept = await watcher.Sweep();
+            const ran = await runner.RunDueBridges();
+            if (swept.BridgesCreated > 0 || ran.Started > 0) {
+                LogStatus(`[CalendarScheduler] swept ${swept.BridgesCreated} new bridge(s); started ${ran.Started} due bridge(s).`);
+            }
+        }
+        catch (err) {
+            LogError(`[CalendarScheduler] sweep/run pass failed (continuing): ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+    void tick(); // run-once at boot
+    const timer = setInterval(() => void tick(), options.PollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+    // Don't let the poll timer keep the process alive at shutdown (the loop is best-effort background work).
+    timer.unref?.();
+    LogStatus(`[CalendarScheduler] started (every ${(options.PollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS) / 1000}s).`);
+    return {
+        Stop() {
+            clearInterval(timer);
+        },
+    };
+}
+//# sourceMappingURL=calendar-scheduler.js.map

package/dist/telephony/calendar-scheduler.js.map

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

package/dist/telephony/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Public exports for the MJAPI telephony + meetings ingress.
+ *
+ * Each vendor ingress is a quartet: a per-call media registry, a bridge-orchestration service, an
+ * Express/WSS router (the `create*Handler` factory + mount-path consts), and a process-wide runtime
+ * holder (`Set*`/`Get*`). The routers + runtimes are star-exported; the service + registry modules are
+ * re-exported by name to avoid star-export ambiguity on their internal, per-vendor-identical helper
+ * types (`InboundCallInput`, `InboundCallResult`, `ITelephonyMediaSocket`). Those internal types are
+ * not part of the package's public surface — code that needs them imports from the source module.
+ *
+ * @module @memberjunction/server/telephony
+ */
+export * from './media-upgrade-router.js';
+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;;;;;;;;;;;GAWG;AAGH,cAAc,2BAA2B,CAAC;AAG1C,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;AAMpC,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,38 @@
+/**
+ * @fileoverview Public exports for the MJAPI telephony + meetings ingress.
+ *
+ * Each vendor ingress is a quartet: a per-call media registry, a bridge-orchestration service, an
+ * Express/WSS router (the `create*Handler` factory + mount-path consts), and a process-wide runtime
+ * holder (`Set*`/`Get*`). The routers + runtimes are star-exported; the service + registry modules are
+ * re-exported by name to avoid star-export ambiguity on their internal, per-vendor-identical helper
+ * types (`InboundCallInput`, `InboundCallResult`, `ITelephonyMediaSocket`). Those internal types are
+ * not part of the package's public surface — code that needs them imports from the source module.
+ *
+ * @module @memberjunction/server/telephony
+ */
+// ── Shared WebSocket-upgrade dispatcher (routes GraphQL + all media sockets by path) ──────
+export * from './media-upgrade-router.js';
+// ── 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 (the only RingCentral transport with bidirectional call audio) ──
+// No media registry / webhook router: the softphone is an outbound SIP registration that receives inbound
+// INVITEs directly. The service owns the registration; the runtime holder shares it with the outbound
+// PlaceRingCentralCall resolver.
+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 (M2: calendar watcher + due-bridge runner) ──
+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;;;;;;;;;;;GAWG;AAEH,6FAA6F;AAC7F,cAAc,2BAA2B,CAAC;AAE1C,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,iGAAiG;AACjG,0GAA0G;AAC1G,sGAAsG;AACtG,iCAAiC;AACjC,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,+FAA+F;AAC/F,cAAc,yBAAyB,CAAC"}

package/dist/telephony/media-upgrade-router.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Single WebSocket-upgrade dispatcher for the shared HTTP server.
+ *
+ * Why this exists: in `ws` 8.x, every `new WebSocketServer({ server })` attaches its OWN `upgrade`
+ * listener that calls `handleUpgrade` UNCONDITIONALLY, and `handleUpgrade` does `abortHandshake(400)` for
+ * any request whose path it doesn't own. So two `{server}`-bound servers on one HTTP server (e.g. the
+ * GraphQL subscriptions socket on `/` AND a telephony Media-Streams socket on `/telephony/.../media`)
+ * fight on every upgrade — the non-owning server 400s the request. That's exactly what made Twilio's
+ * `<Connect><Stream>` fail with error 31920 ("Stream WebSocket failed to connect").
+ *
+ * The fix: telephony/meetings media servers are created with `{ noServer: true }` (no auto-listener) and
+ * register their path here; at boot we strip the auto-listeners and install ONE `upgrade` listener that
+ * routes by path — GraphQL on its root path, each media socket on its own. When no media routes are
+ * registered (telephony disabled), we leave the GraphQL server's own listener untouched (zero change).
+ *
+ * @module @memberjunction/server/telephony
+ */
+import type { Server as HttpServer } from 'node:http';
+import type { WebSocketServer } from 'ws';
+/** Registers a media WebSocket route. Called by each vendor router's attach step. */
+export declare function RegisterMediaUpgradeRoute(path: string, wss: WebSocketServer): void;
+/**
+ * Installs the single path-routing `upgrade` dispatcher. No-op when no media routes are registered, so
+ * the GraphQL server keeps its own listener untouched. Otherwise it removes the auto-attached listeners
+ * (GraphQL's included) and dispatches every upgrade by pathname — GraphQL on `graphqlPath`, each media
+ * socket on its registered path; unknown paths are destroyed.
+ *
+ * @param httpServer  the shared HTTP server.
+ * @param graphqlWss  the GraphQL subscriptions WebSocketServer (kept, re-dispatched on its path).
+ * @param graphqlPath the GraphQL root path (the path GraphQL's socket listens on).
+ */
+export declare function InstallMediaUpgradeDispatcher(httpServer: HttpServer, graphqlWss: WebSocketServer, graphqlPath: string): void;
+//# sourceMappingURL=media-upgrade-router.d.ts.map

package/dist/telephony/media-upgrade-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-upgrade-router.d.ts","sourceRoot":"","sources":["../../src/telephony/media-upgrade-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAmB,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAK1C,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAElF;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAqB5H"}

package/dist/telephony/media-upgrade-router.js

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Single WebSocket-upgrade dispatcher for the shared HTTP server.
+ *
+ * Why this exists: in `ws` 8.x, every `new WebSocketServer({ server })` attaches its OWN `upgrade`
+ * listener that calls `handleUpgrade` UNCONDITIONALLY, and `handleUpgrade` does `abortHandshake(400)` for
+ * any request whose path it doesn't own. So two `{server}`-bound servers on one HTTP server (e.g. the
+ * GraphQL subscriptions socket on `/` AND a telephony Media-Streams socket on `/telephony/.../media`)
+ * fight on every upgrade — the non-owning server 400s the request. That's exactly what made Twilio's
+ * `<Connect><Stream>` fail with error 31920 ("Stream WebSocket failed to connect").
+ *
+ * The fix: telephony/meetings media servers are created with `{ noServer: true }` (no auto-listener) and
+ * register their path here; at boot we strip the auto-listeners and install ONE `upgrade` listener that
+ * routes by path — GraphQL on its root path, each media socket on its own. When no media routes are
+ * registered (telephony disabled), we leave the GraphQL server's own listener untouched (zero change).
+ *
+ * @module @memberjunction/server/telephony
+ */
+/** path → the `{ noServer:true }` WebSocketServer that owns it. */
+const mediaRoutes = new Map();
+/** Registers a media WebSocket route. Called by each vendor router's attach step. */
+export function RegisterMediaUpgradeRoute(path, wss) {
+    mediaRoutes.set(path, wss);
+}
+/**
+ * Installs the single path-routing `upgrade` dispatcher. No-op when no media routes are registered, so
+ * the GraphQL server keeps its own listener untouched. Otherwise it removes the auto-attached listeners
+ * (GraphQL's included) and dispatches every upgrade by pathname — GraphQL on `graphqlPath`, each media
+ * socket on its registered path; unknown paths are destroyed.
+ *
+ * @param httpServer  the shared HTTP server.
+ * @param graphqlWss  the GraphQL subscriptions WebSocketServer (kept, re-dispatched on its path).
+ * @param graphqlPath the GraphQL root path (the path GraphQL's socket listens on).
+ */
+export function InstallMediaUpgradeDispatcher(httpServer, graphqlWss, graphqlPath) {
+    if (mediaRoutes.size === 0) {
+        return;
+    }
+    httpServer.removeAllListeners('upgrade');
+    const dispatch = (wss, req, socket, head) => {
+        wss.handleUpgrade(req, socket, head, (ws) => wss.emit('connection', ws, req));
+    };
+    httpServer.on('upgrade', (req, socket, head) => {
+        const pathname = (req.url ?? '').split('?')[0];
+        if (pathname === graphqlPath) {
+            dispatch(graphqlWss, req, socket, head);
+            return;
+        }
+        const wss = mediaRoutes.get(pathname);
+        if (wss) {
+            dispatch(wss, req, socket, head);
+            return;
+        }
+        socket.destroy();
+    });
+}
+//# sourceMappingURL=media-upgrade-router.js.map

package/dist/telephony/media-upgrade-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-upgrade-router.js","sourceRoot":"","sources":["../../src/telephony/media-upgrade-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,mEAAmE;AACnE,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEvD,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,GAAoB;IACxE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAAsB,EAAE,UAA2B,EAAE,WAAmB;IAClH,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACX,CAAC;IACD,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,CAAC,GAAoB,EAAE,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAQ,EAAE;QAChG,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;IACF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE;QAC5E,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACxC,OAAO;QACX,CAAC;QACD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACN,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO;QACX,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed RingCentral telephony service, so the
+ * outbound `PlaceRingCentralCall` GraphQL resolver reaches the SAME {@link RingCentralTelephonyService}
+ * (and thus the same long-lived SIP-softphone registration) that the inbound INVITE coordinator uses. Set
+ * once during server boot; read by the resolver.
+ *
+ * @module @memberjunction/server/telephony
+ */
+import type { RingCentralTelephonyService } from './RingCentralTelephonyService.js';
+/** Binds the startup-constructed RingCentral telephony service (called from server boot). */
+export declare function SetRingCentralTelephonyService(service: RingCentralTelephonyService): 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;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAIpF,6FAA6F;AAC7F,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAEzF;AAED,wGAAwG;AACxG,wBAAgB,8BAA8B,IAAI,2BAA2B,GAAG,SAAS,CAExF"}

package/dist/telephony/ringcentral-runtime.js

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed RingCentral telephony service, so the
+ * outbound `PlaceRingCentralCall` GraphQL resolver reaches the SAME {@link RingCentralTelephonyService}
+ * (and thus the same long-lived SIP-softphone registration) that the inbound INVITE coordinator uses. Set
+ * once during server boot; read by the resolver.
+ *
+ * @module @memberjunction/server/telephony
+ */
+let ringCentralService;
+/** Binds the startup-constructed RingCentral telephony service (called from server boot). */
+export function SetRingCentralTelephonyService(service) {
+    ringCentralService = service;
+}
+/** Returns the bound RingCentral telephony service, or `undefined` when telephony is not configured. */
+export function GetRingCentralTelephonyService() {
+    return ringCentralService;
+}
+//# 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;;;;;;;GAOG;AAIH,IAAI,kBAA2D,CAAC;AAEhE,6FAA6F;AAC7F,MAAM,UAAU,8BAA8B,CAAC,OAAoC;IAC/E,kBAAkB,GAAG,OAAO,CAAC;AACjC,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,8BAA8B;IAC1C,OAAO,kBAAkB,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed Teams meetings service, so the
+ * `StartTeamsMeetingSession` GraphQL resolver reaches the SAME {@link TeamsMeetingsService} (and thus the
+ * same {@link TeamsAcsMediaRegistry} the ACS media adapter attaches transports to) that the Graph
+ * change-notification webhook router uses. Set once during server boot; read by the resolver + the router.
+ *
+ * Mirrors `telephony-runtime.ts` (the Twilio equivalent).
+ *
+ * @module @memberjunction/server/telephony
+ */
+import type { TeamsMeetingsService } from './TeamsMeetingsService.js';
+/** Binds the startup-constructed Teams meetings service (called from server boot). */
+export declare function SetTeamsMeetingsService(service: TeamsMeetingsService): 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;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItE,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE3E;AAED,uGAAuG;AACvG,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAE1E"}

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

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Process-wide holder for the startup-constructed Teams meetings service, so the
+ * `StartTeamsMeetingSession` GraphQL resolver reaches the SAME {@link TeamsMeetingsService} (and thus the
+ * same {@link TeamsAcsMediaRegistry} the ACS media adapter attaches transports to) that the Graph
+ * change-notification webhook router uses. Set once during server boot; read by the resolver + the router.
+ *
+ * Mirrors `telephony-runtime.ts` (the Twilio equivalent).
+ *
+ * @module @memberjunction/server/telephony
+ */
+let teamsService;
+/** Binds the startup-constructed Teams meetings service (called from server boot). */
+export function SetTeamsMeetingsService(service) {
+    teamsService = service;
+}
+/** Returns the bound Teams meetings service, or `undefined` when Teams meetings are not configured. */
+export function GetTeamsMeetingsService() {
+    return teamsService;
+}
+//# 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;;;;;;;;;GASG;AAIH,IAAI,YAA8C,CAAC;AAEnD,sFAAsF;AACtF,MAAM,UAAU,uBAAuB,CAAC,OAA6B;IACjE,YAAY,GAAG,OAAO,CAAC;AAC3B,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,uBAAuB;IACnC,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/dist/telephony/teamsAcsMediaRegistry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Per-call ACS application-hosted-media pump registry for the Teams meetings ingress.
+ *
+ * This is the server half of the Teams audio plane — the analogue of {@link TwilioCallMediaRegistry} for
+ * telephony. It implements the Teams provider package's `IAcsMediaPump` seam (which `PumpBackedAcsMedia` →
+ * `RealTeamsBindings` drive) on top of the live ACS application-hosted-media audio socket(s) the server owns.
+ *
+ * Like telephony, there is a lifecycle gap: when a meeting bridge session starts, `RealTeamsBindings`
+ * registers its inbound-audio handler before the ACS media socket has connected its inbound stream. The
+ * registry bridges that gap by buffering handler registrations + outbound PCM per call id and binding them to
+ * the media transport once it attaches (the server's native ACS media adapter calls {@link AttachTransport}
+ * when the application-hosted-media socket is up for the call).
+ *
+ * Pure + unit-testable: the media transport is injected as the minimal {@link IAcsMediaTransport} surface, so
+ * the registry's buffering / dispatch logic is exercised with a fake transport and no ACS install or network.
+ *
+ * @module @memberjunction/server/telephony
+ */
+import type { AcsInboundAudioFrame, IAcsMediaPump } from '@memberjunction/ai-bridge-teams';
+/**
+ * The minimal ACS media-transport surface the registry drives — a structural subset of the server's native
+ * application-hosted-media socket adapter, so the registry never imports the ACS SDK and is testable with a
+ * fake. Outbound frames are raw PCM16 `ArrayBuffer`s for the call.
+ */
+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. One
+ * instance per server, shared between the meetings service (which binds `PumpBackedAcsMedia` over this as the
+ * `IAcsMediaPump`) and the server's native ACS media adapter (which attaches transports + dispatches inbound
+ * audio).
+ */
+export declare class TeamsAcsMediaRegistry implements IAcsMediaPump {
+    readonly SampleRate: number;
+    private readonly channels;
+    /**
+     * @param SampleRate The ACS audio-socket sample rate in Hz (the application-hosted-media PCM rate the
+     *   server negotiates). Drives T0 resampling in `RealTeamsBindings`. Defaults to 16000.
+     */
+    constructor(SampleRate?: number);
+    /** Ensures a channel exists for a call (called when a meeting bridge session for the call starts). */
+    RegisterCall(callId: string): void;
+    /** @inheritdoc — buffers when the transport has not yet attached; sends immediately once it has. */
+    Send(callId: string, pcm: ArrayBuffer): void;
+    /** @inheritdoc — stores the handler so frames delivered before AND after transport attach reach it. */
+    OnFrame(callId: string, handler: (frame: AcsInboundAudioFrame) => void): void;
+    /** @inheritdoc — stores the hand-raise handler (Teams hand-raise is partial; tolerated if it never fires). */
+    OnHandRaise(callId: string, handler: (participantId: string, raised: boolean) => void): void;
+    /**
+     * Binds a connected ACS media transport to a call, flushing any outbound PCM produced while the transport
+     * was still connecting. Called by the server's native ACS media adapter once the application-hosted-media
+     * socket is up for the call.
+     */
+    AttachTransport(callId: string, transport: IAcsMediaTransport): void;
+    /** Dispatches one inbound per-participant audio frame to all registered handlers for the call. */
+    DispatchInbound(callId: string, frame: AcsInboundAudioFrame): void;
+    /** Dispatches one raised-hand signal to all registered hand-raise handlers for the call. */
+    DispatchHandRaise(callId: string, participantId: string, raised: boolean): void;
+    /** Tears down a call's channel and closes its transport (called on call end / meeting ended). */
+    EndCall(callId: string): void;
+    /** Whether a channel is currently tracked for the call (test/observability helper). */
+    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;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE3F;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B,mGAAmG;IACnG,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;CACjB;AAaD;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,aAAa;aAO3B,UAAU;IANtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE;;;OAGG;gBACyB,UAAU,SAAQ;IAE9C,sGAAsG;IAC/F,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMzC,oGAAoG;IAC7F,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IASnD,uGAAuG;IAChG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAIpF,8GAA8G;IACvG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAMnG;;;;OAIG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAS3E,kGAAkG;IAC3F,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAUzE,4FAA4F;IACrF,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAUtF,iGAAiG;IAC1F,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAapC,uFAAuF;IAChF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC,OAAO,CAAC,aAAa;CAQxB"}

package/dist/telephony/teamsAcsMediaRegistry.js

@@ -0,0 +1,118 @@
+/**
+ * @fileoverview Per-call ACS application-hosted-media pump registry for the Teams meetings ingress.
+ *
+ * This is the server half of the Teams audio plane — the analogue of {@link TwilioCallMediaRegistry} for
+ * telephony. It implements the Teams provider package's `IAcsMediaPump` seam (which `PumpBackedAcsMedia` →
+ * `RealTeamsBindings` drive) on top of the live ACS application-hosted-media audio socket(s) the server owns.
+ *
+ * Like telephony, there is a lifecycle gap: when a meeting bridge session starts, `RealTeamsBindings`
+ * registers its inbound-audio handler before the ACS media socket has connected its inbound stream. The
+ * registry bridges that gap by buffering handler registrations + outbound PCM per call id and binding them to
+ * the media transport once it attaches (the server's native ACS media adapter calls {@link AttachTransport}
+ * when the application-hosted-media socket is up for the call).
+ *
+ * Pure + unit-testable: the media transport is injected as the minimal {@link IAcsMediaTransport} surface, so
+ * the registry's buffering / dispatch logic is exercised with a fake transport and no ACS install or network.
+ *
+ * @module @memberjunction/server/telephony
+ */
+/**
+ * Coordinates ACS application-hosted-media transports with the bridge bindings, keyed by Graph call id. One
+ * instance per server, shared between the meetings service (which binds `PumpBackedAcsMedia` over this as the
+ * `IAcsMediaPump`) and the server's native ACS media adapter (which attaches transports + dispatches inbound
+ * audio).
+ */
+export class TeamsAcsMediaRegistry {
+    /**
+     * @param SampleRate The ACS audio-socket sample rate in Hz (the application-hosted-media PCM rate the
+     *   server negotiates). Drives T0 resampling in `RealTeamsBindings`. Defaults to 16000.
+     */
+    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 ─────────────────────────────────────────────────────────────
+    /** @inheritdoc — buffers when the transport has not yet attached; sends immediately once it has. */
+    Send(callId, pcm) {
+        const channel = this.ensureChannel(callId);
+        if (channel.transport) {
+            channel.transport.sendAudioFrame(pcm);
+        }
+        else {
+            channel.outboundBuffer.push(pcm);
+        }
+    }
+    /** @inheritdoc — stores the handler so frames delivered before AND after transport attach reach it. */
+    OnFrame(callId, handler) {
+        this.ensureChannel(callId).frameHandlers.push(handler);
+    }
+    /** @inheritdoc — stores the hand-raise handler (Teams hand-raise is partial; tolerated if it never fires). */
+    OnHandRaise(callId, handler) {
+        this.ensureChannel(callId).handRaiseHandlers.push(handler);
+    }
+    // ── native-adapter side ─────────────────────────────────────────────────────
+    /**
+     * Binds a connected ACS media transport to a call, flushing any outbound PCM produced while the transport
+     * was still connecting. Called by the server's native ACS media adapter once the application-hosted-media
+     * socket is up for the call.
+     */
+    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);
+        }
+    }
+    /** Dispatches one inbound per-participant audio frame to all registered handlers for the call. */
+    DispatchInbound(callId, frame) {
+        const channel = this.channels.get(callId);
+        if (!channel) {
+            return;
+        }
+        for (const handler of channel.frameHandlers) {
+            handler(frame);
+        }
+    }
+    /** Dispatches one raised-hand signal to all registered hand-raise handlers for the call. */
+    DispatchHandRaise(callId, participantId, raised) {
+        const channel = this.channels.get(callId);
+        if (!channel) {
+            return;
+        }
+        for (const handler of channel.handRaiseHandlers) {
+            handler(participantId, raised);
+        }
+    }
+    /** Tears down a call's channel and closes its transport (called on call end / meeting ended). */
+    EndCall(callId) {
+        const channel = this.channels.get(callId);
+        if (!channel) {
+            return;
+        }
+        try {
+            channel.transport?.close();
+        }
+        catch {
+            /* best-effort */
+        }
+        this.channels.delete(callId);
+    }
+    /** Whether a channel is currently tracked for the call (test/observability helper). */
+    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. Set once during server boot; read by the resolver.
+ *
+ * @module @memberjunction/server/telephony
+ */
+import type { TwilioTelephonyService } from './TwilioTelephonyService.js';
+/** Binds the startup-constructed Twilio telephony service (called from server boot). */
+export declare function SetTwilioTelephonyService(service: TwilioTelephonyService): 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;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAI1E,wFAAwF;AACxF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAE/E;AAED,mGAAmG;AACnG,wBAAgB,yBAAyB,IAAI,sBAAsB,GAAG,SAAS,CAE9E"}