@memberjunction/server 5.44.0 → 5.45.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/server",
-  "version": "5.44.0",
+  "version": "5.45.0",
   "description": "MemberJunction: This project provides API access via GraphQL to the common data store.",
   "main": "./dist/index.js",
   "types": "./src/index.ts",
@@ -27,88 +27,93 @@
     "@as-integrations/express5": "^1.0.0",
     "@graphql-tools/schema": "latest",
     "@graphql-tools/utils": "^11.0.0",
-    "@memberjunction/actions": "5.44.0",
-    "@memberjunction/actions-apollo": "5.44.0",
-    "@memberjunction/actions-base": "5.44.0",
-    "@memberjunction/actions-bizapps-accounting": "5.44.0",
-    "@memberjunction/actions-bizapps-crm": "5.44.0",
-    "@memberjunction/actions-bizapps-formbuilders": "5.44.0",
-    "@memberjunction/actions-bizapps-lms": "5.44.0",
-    "@memberjunction/actions-bizapps-social": "5.44.0",
-    "@memberjunction/ai": "5.44.0",
-    "@memberjunction/ai-agent-manager": "5.44.0",
-    "@memberjunction/ai-agent-manager-actions": "5.44.0",
-    "@memberjunction/ai-agents": "5.44.0",
-    "@memberjunction/ai-bridge-server": "5.44.0",
-    "@memberjunction/ai-core-plus": "5.44.0",
-    "@memberjunction/ai-engine-base": "5.44.0",
-    "@memberjunction/ai-mcp-client": "5.44.0",
-    "@memberjunction/ai-prompts": "5.44.0",
-    "@memberjunction/ai-provider-bundle": "5.44.0",
-    "@memberjunction/ai-vector-sync": "5.44.0",
-    "@memberjunction/ai-vectordb": "5.44.0",
-    "@memberjunction/ai-vectors-pinecone": "5.44.0",
-    "@memberjunction/aiengine": "5.44.0",
-    "@memberjunction/api-keys": "5.44.0",
-    "@memberjunction/auth-providers": "5.44.0",
-    "@memberjunction/clustering-engine": "5.44.0",
-    "@memberjunction/codegen-lib": "5.44.0",
-    "@memberjunction/communication-engine": "5.44.0",
-    "@memberjunction/communication-ms-graph": "5.44.0",
-    "@memberjunction/notifications": "5.44.0",
-    "@memberjunction/communication-sendgrid": "5.44.0",
-    "@memberjunction/communication-types": "5.44.0",
-    "@memberjunction/component-registry-client-sdk": "5.44.0",
-    "@memberjunction/computer-use": "5.44.0",
-    "@memberjunction/computer-use-engine": "5.44.0",
-    "@memberjunction/config": "5.44.0",
-    "@memberjunction/core": "5.44.0",
-    "@memberjunction/core-actions": "5.44.0",
-    "@memberjunction/core-entities": "5.44.0",
-    "@memberjunction/core-entities-server": "5.44.0",
-    "@memberjunction/data-context": "5.44.0",
-    "@memberjunction/data-context-server": "5.44.0",
-    "@memberjunction/doc-utils": "5.44.0",
-    "@memberjunction/encryption": "5.44.0",
-    "@memberjunction/entity-communications-base": "5.44.0",
-    "@memberjunction/entity-communications-server": "5.44.0",
-    "@memberjunction/esignature": "5.44.0",
-    "@memberjunction/external-change-detection": "5.44.0",
-    "@memberjunction/generic-database-provider": "5.44.0",
-    "@memberjunction/global": "5.44.0",
-    "@memberjunction/graphql-dataprovider": "5.44.0",
-    "@memberjunction/integration-engine": "5.44.0",
-    "@memberjunction/integration-progress-artifacts": "5.44.0",
-    "@memberjunction/integration-schema-builder": "5.44.0",
-    "@memberjunction/interactive-component-types": "5.44.0",
-    "@memberjunction/lists": "5.44.0",
-    "@memberjunction/lists-base": "5.44.0",
-    "@memberjunction/livekit-room-server": "5.44.0",
-    "@memberjunction/postgresql-dataprovider": "5.44.0",
-    "@memberjunction/queue": "5.44.0",
-    "@memberjunction/record-comparison": "5.44.0",
-    "@memberjunction/redis-provider": "5.44.0",
-    "@memberjunction/remote-browser-base": "5.44.0",
-    "@memberjunction/remote-browser-cdp": "5.44.0",
-    "@memberjunction/remote-browser-selfhost": "5.44.0",
-    "@memberjunction/remote-browser-server": "5.44.0",
-    "@memberjunction/scheduling-actions": "5.44.0",
-    "@memberjunction/scheduling-base-types": "5.44.0",
-    "@memberjunction/scheduling-engine": "5.44.0",
-    "@memberjunction/scheduling-engine-base": "5.44.0",
-    "@memberjunction/schema-engine": "5.44.0",
-    "@memberjunction/search-engine": "5.44.0",
-    "@memberjunction/server-extensions-core": "5.44.0",
-    "@memberjunction/skip-types": "5.44.0",
-    "@memberjunction/sql-dialect": "5.44.0",
-    "@memberjunction/sqlserver-dataprovider": "5.44.0",
-    "@memberjunction/storage": "5.44.0",
-    "@memberjunction/tag-engine": "5.44.0",
-    "@memberjunction/tag-engine-base": "5.44.0",
-    "@memberjunction/templates": "5.44.0",
-    "@memberjunction/testing-engine": "5.44.0",
-    "@memberjunction/testing-engine-base": "5.44.0",
-    "@memberjunction/version-history": "5.44.0",
+    "@memberjunction/actions": "5.45.0",
+    "@memberjunction/actions-apollo": "5.45.0",
+    "@memberjunction/actions-base": "5.45.0",
+    "@memberjunction/actions-bizapps-accounting": "5.45.0",
+    "@memberjunction/actions-bizapps-crm": "5.45.0",
+    "@memberjunction/actions-bizapps-formbuilders": "5.45.0",
+    "@memberjunction/actions-bizapps-lms": "5.45.0",
+    "@memberjunction/actions-bizapps-social": "5.45.0",
+    "@memberjunction/ai": "5.45.0",
+    "@memberjunction/ai-agent-manager": "5.45.0",
+    "@memberjunction/ai-agent-manager-actions": "5.45.0",
+    "@memberjunction/ai-agents": "5.45.0",
+    "@memberjunction/ai-bridge-base": "5.45.0",
+    "@memberjunction/ai-bridge-ringcentral": "5.45.0",
+    "@memberjunction/ai-bridge-server": "5.45.0",
+    "@memberjunction/ai-bridge-teams": "5.45.0",
+    "@memberjunction/ai-bridge-twilio": "5.45.0",
+    "@memberjunction/ai-bridge-vonage": "5.45.0",
+    "@memberjunction/ai-core-plus": "5.45.0",
+    "@memberjunction/ai-engine-base": "5.45.0",
+    "@memberjunction/ai-mcp-client": "5.45.0",
+    "@memberjunction/ai-prompts": "5.45.0",
+    "@memberjunction/ai-provider-bundle": "5.45.0",
+    "@memberjunction/ai-vector-sync": "5.45.0",
+    "@memberjunction/ai-vectordb": "5.45.0",
+    "@memberjunction/ai-vectors-pinecone": "5.45.0",
+    "@memberjunction/aiengine": "5.45.0",
+    "@memberjunction/api-keys": "5.45.0",
+    "@memberjunction/auth-providers": "5.45.0",
+    "@memberjunction/clustering-engine": "5.45.0",
+    "@memberjunction/codegen-lib": "5.45.0",
+    "@memberjunction/communication-engine": "5.45.0",
+    "@memberjunction/communication-ms-graph": "5.45.0",
+    "@memberjunction/notifications": "5.45.0",
+    "@memberjunction/communication-sendgrid": "5.45.0",
+    "@memberjunction/communication-types": "5.45.0",
+    "@memberjunction/component-registry-client-sdk": "5.45.0",
+    "@memberjunction/computer-use": "5.45.0",
+    "@memberjunction/computer-use-engine": "5.45.0",
+    "@memberjunction/config": "5.45.0",
+    "@memberjunction/core": "5.45.0",
+    "@memberjunction/core-actions": "5.45.0",
+    "@memberjunction/core-entities": "5.45.0",
+    "@memberjunction/core-entities-server": "5.45.0",
+    "@memberjunction/credentials": "5.45.0",
+    "@memberjunction/data-context": "5.45.0",
+    "@memberjunction/data-context-server": "5.45.0",
+    "@memberjunction/doc-utils": "5.45.0",
+    "@memberjunction/encryption": "5.45.0",
+    "@memberjunction/entity-communications-base": "5.45.0",
+    "@memberjunction/entity-communications-server": "5.45.0",
+    "@memberjunction/esignature": "5.45.0",
+    "@memberjunction/external-change-detection": "5.45.0",
+    "@memberjunction/generic-database-provider": "5.45.0",
+    "@memberjunction/global": "5.45.0",
+    "@memberjunction/graphql-dataprovider": "5.45.0",
+    "@memberjunction/integration-engine": "5.45.0",
+    "@memberjunction/integration-progress-artifacts": "5.45.0",
+    "@memberjunction/integration-schema-builder": "5.45.0",
+    "@memberjunction/interactive-component-types": "5.45.0",
+    "@memberjunction/lists": "5.45.0",
+    "@memberjunction/lists-base": "5.45.0",
+    "@memberjunction/livekit-room-server": "5.45.0",
+    "@memberjunction/postgresql-dataprovider": "5.45.0",
+    "@memberjunction/queue": "5.45.0",
+    "@memberjunction/record-comparison": "5.45.0",
+    "@memberjunction/redis-provider": "5.45.0",
+    "@memberjunction/remote-browser-base": "5.45.0",
+    "@memberjunction/remote-browser-cdp": "5.45.0",
+    "@memberjunction/remote-browser-selfhost": "5.45.0",
+    "@memberjunction/remote-browser-server": "5.45.0",
+    "@memberjunction/scheduling-actions": "5.45.0",
+    "@memberjunction/scheduling-base-types": "5.45.0",
+    "@memberjunction/scheduling-engine": "5.45.0",
+    "@memberjunction/scheduling-engine-base": "5.45.0",
+    "@memberjunction/schema-engine": "5.45.0",
+    "@memberjunction/search-engine": "5.45.0",
+    "@memberjunction/server-extensions-core": "5.45.0",
+    "@memberjunction/sql-dialect": "5.45.0",
+    "@memberjunction/sqlserver-dataprovider": "5.45.0",
+    "@memberjunction/storage": "5.45.0",
+    "@memberjunction/tag-engine": "5.45.0",
+    "@memberjunction/tag-engine-base": "5.45.0",
+    "@memberjunction/templates": "5.45.0",
+    "@memberjunction/testing-engine": "5.45.0",
+    "@memberjunction/testing-engine-base": "5.45.0",
+    "@memberjunction/version-history": "5.45.0",
     "@octokit/auth-app": "^7.1.5",
     "@octokit/rest": "^21.1.1",
     "@types/compression": "^1.8.1",

package/src/__tests__/search-knowledge-tags.test.ts

@@ -127,7 +127,7 @@ describe('SearchKnowledgeResolver', () => {
             const resolver = createResolver();
             mockSearch.mockResolvedValueOnce(createMockSearchResult());
 
-            const result = await resolver.SearchKnowledge('test query', 20, undefined, undefined, fakeContext as never);
+            const result = await resolver.SearchKnowledge('test query', 20, undefined, undefined, undefined, undefined, undefined, fakeContext as never);
 
             expect(mockSearch).toHaveBeenCalledOnce();
             expect(result.Success).toBe(true);
@@ -139,7 +139,7 @@ describe('SearchKnowledgeResolver', () => {
             const resolver = createResolver();
             mockSearch.mockResolvedValueOnce(createMockSearchResult());
 
-            await resolver.SearchKnowledge('cheese', 50, undefined, undefined, fakeContext as never);
+            await resolver.SearchKnowledge('cheese', 50, undefined, undefined, undefined, undefined, undefined, fakeContext as never);
 
             const searchParams = mockSearch.mock.calls[0][0];
             expect(searchParams.Query).toBe('cheese');
@@ -151,7 +151,7 @@ describe('SearchKnowledgeResolver', () => {
             mockSearch.mockResolvedValueOnce(createMockSearchResult());
 
             const filters = { EntityNames: ['Contacts'], SourceTypes: undefined, Tags: ['VIP'] };
-            await resolver.SearchKnowledge('test', 20, filters as never, undefined, fakeContext as never);
+            await resolver.SearchKnowledge('test', 20, filters as never, undefined, undefined, undefined, undefined, fakeContext as never);
 
             const searchParams = mockSearch.mock.calls[0][0];
             expect(searchParams.Filters).toEqual({
@@ -165,7 +165,7 @@ describe('SearchKnowledgeResolver', () => {
             const resolver = createResolver();
             mockSearch.mockResolvedValueOnce(createMockSearchResult());
 
-            await resolver.SearchKnowledge('test', 20, undefined, 0.5, fakeContext as never);
+            await resolver.SearchKnowledge('test', 20, undefined, 0.5, undefined, undefined, undefined, fakeContext as never);
 
             const searchParams = mockSearch.mock.calls[0][0];
             expect(searchParams.MinScore).toBe(0.5);
@@ -175,7 +175,7 @@ describe('SearchKnowledgeResolver', () => {
             const resolver = createResolver();
             mockSearch.mockResolvedValueOnce(createMockSearchResult());
 
-            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, fakeContext as never);
+            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, undefined, undefined, undefined, fakeContext as never);
 
             const item = result.Results[0];
             expect(item.ID).toBe('result-1');
@@ -193,7 +193,7 @@ describe('SearchKnowledgeResolver', () => {
                 SourceCounts: { Vector: 5, FullText: 3, Entity: 10, Storage: 0 }
             }));
 
-            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, fakeContext as never);
+            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, undefined, undefined, undefined, fakeContext as never);
 
             expect(result.SourceCounts.Vector).toBe(5);
             expect(result.SourceCounts.FullText).toBe(3);
@@ -204,7 +204,7 @@ describe('SearchKnowledgeResolver', () => {
             const resolver = createResolver();
             mockSearch.mockResolvedValueOnce(createMockSearchResult({ Success: false, ErrorMessage: 'Query cannot be empty' }));
 
-            const result = await resolver.SearchKnowledge('   ', 20, undefined, undefined, fakeContext as never);
+            const result = await resolver.SearchKnowledge('   ', 20, undefined, undefined, undefined, undefined, undefined, fakeContext as never);
 
             expect(mockSearch).toHaveBeenCalled();
             expect(result.Success).toBe(false);
@@ -214,7 +214,7 @@ describe('SearchKnowledgeResolver', () => {
             const resolver = new SearchKnowledgeResolver();
             (resolver as Record<string, unknown>)['GetUserFromPayload'] = vi.fn().mockReturnValue(null);
 
-            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, fakeContext as never);
+            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, undefined, undefined, undefined, fakeContext as never);
 
             expect(result.Success).toBe(false);
             expect(result.ErrorMessage).toContain('current user');
@@ -224,7 +224,7 @@ describe('SearchKnowledgeResolver', () => {
             const resolver = createResolver();
             mockSearch.mockRejectedValueOnce(new Error('Connection failed'));
 
-            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, fakeContext as never);
+            const result = await resolver.SearchKnowledge('test', 20, undefined, undefined, undefined, undefined, undefined, fakeContext as never);
 
             expect(result.Success).toBe(false);
             expect(result.ErrorMessage).toContain('Connection failed');

package/src/__tests__/teams-meetings-service.test.ts

@@ -0,0 +1,65 @@
+import { describe, it, expect, vi } from 'vitest';
+import { TeamsMeetingsService } from '../telephony/TeamsMeetingsService.js';
+import { TeamsAcsMediaRegistry } from '../telephony/teamsAcsMediaRegistry.js';
+import { RealTeamsBindings } from '@memberjunction/ai-bridge-teams';
+import type { BaseRealtimeBridge } from '@memberjunction/ai-bridge-base';
+import type { TeamsMeetingsConfig } from '../config.js';
+
+const CONFIG: TeamsMeetingsConfig = {
+    enabled: true,
+    tenantId: 'tenant-1',
+    botAccessToken: 'tok',
+    notificationClientState: 'secret',
+    acsSampleRate: 16000,
+    modelSampleRate: 16000,
+};
+
+describe('TeamsMeetingsService.buildBindSdk', () => {
+    it('binds a RealTeamsBindings factory onto the Teams driver (the live Graph + ACS wiring seam)', () => {
+        const service = new TeamsMeetingsService(CONFIG, new TeamsAcsMediaRegistry());
+        const setSdkFactory = vi.fn();
+        const fakeDriver = { SetSdkFactory: setSdkFactory } as unknown as BaseRealtimeBridge;
+        // A minimal fake Graph client (only used as a constructor arg here).
+        const graphClient = { CreateCall: vi.fn() } as unknown as Parameters<typeof service.buildBindSdk>[0];
+
+        service.buildBindSdk(graphClient)(fakeDriver);
+
+        expect(setSdkFactory).toHaveBeenCalledTimes(1);
+        const factory = setSdkFactory.mock.calls[0][0] as () => unknown;
+        expect(typeof factory).toBe('function');
+        // The factory yields a real (bound) RealTeamsBindings — proving the offline seam meets live plumbing.
+        expect(factory()).toBeInstanceOf(RealTeamsBindings);
+    });
+});
+
+describe('TeamsMeetingsService.JoinMeetingByUrl', () => {
+    it('returns accepted=false (never throws) when the agent identity is missing', async () => {
+        const provider = {
+            GetEntityObject: vi.fn().mockResolvedValue({ Load: vi.fn().mockResolvedValue(false), IsActive: false }),
+        };
+        const service = new TeamsMeetingsService(CONFIG, new TeamsAcsMediaRegistry());
+        const result = await service.JoinMeetingByUrl(
+            'identity-1',
+            'https://teams.microsoft.com/l/meetup-join/x',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- minimal UserInfo stub for a pure-branch test
+            { ID: 'u1' } as never,
+            provider as never,
+        );
+        expect(result.accepted).toBe(false);
+        expect(result.reason).toMatch(/not found or inactive/i);
+    });
+});
+
+describe('TeamsMeetingsService notification drive helpers', () => {
+    it('tears down the call + registry on call-ended (no throw when no client registered)', () => {
+        const registry = new TeamsAcsMediaRegistry();
+        registry.RegisterCall('call-1');
+        expect(registry.HasCall('call-1')).toBe(true);
+        const service = new TeamsMeetingsService(CONFIG, registry);
+
+        service.DriveCallEnded('call-1');
+        expect(registry.HasCall('call-1')).toBe(false);
+        // An unknown roster drive is a silent no-op.
+        expect(() => service.DriveParticipantsUpdated('unknown', [{ id: 'p1' }])).not.toThrow();
+    });
+});

package/src/__tests__/teamsAcsMediaRegistry.test.ts

@@ -0,0 +1,82 @@
+import { describe, it, expect } from 'vitest';
+import { TeamsAcsMediaRegistry, type IAcsMediaTransport } from '../telephony/teamsAcsMediaRegistry.js';
+import type { AcsInboundAudioFrame } from '@memberjunction/ai-bridge-teams';
+
+class FakeTransport implements IAcsMediaTransport {
+    public readonly Sent: ArrayBuffer[] = [];
+    public Closed = false;
+    public sendAudioFrame(pcm: ArrayBuffer): void {
+        this.Sent.push(pcm);
+    }
+    public close(): void {
+        this.Closed = true;
+    }
+}
+
+const frame = (bytes: number): ArrayBuffer => new ArrayBuffer(bytes);
+
+describe('TeamsAcsMediaRegistry', () => {
+    it('exposes the configured ACS sample rate', () => {
+        expect(new TeamsAcsMediaRegistry().SampleRate).toBe(16000);
+        expect(new TeamsAcsMediaRegistry(8000).SampleRate).toBe(8000);
+    });
+
+    it('buffers outbound PCM before the transport attaches, then flushes on attach', () => {
+        const registry = new TeamsAcsMediaRegistry();
+        const a = frame(4);
+        const b = frame(8);
+        registry.Send('call-1', a);
+        registry.Send('call-1', b);
+
+        const transport = new FakeTransport();
+        registry.AttachTransport('call-1', transport);
+
+        expect(transport.Sent).toEqual([a, b]);
+    });
+
+    it('sends immediately once the transport is attached', () => {
+        const registry = new TeamsAcsMediaRegistry();
+        const transport = new FakeTransport();
+        registry.AttachTransport('call-1', transport);
+        const a = frame(4);
+        registry.Send('call-1', a);
+        expect(transport.Sent).toEqual([a]);
+    });
+
+    it('dispatches inbound frames to all registered handlers for the call', () => {
+        const registry = new TeamsAcsMediaRegistry();
+        const seen: AcsInboundAudioFrame[] = [];
+        registry.OnFrame('call-1', (f) => seen.push(f));
+        registry.OnFrame('call-1', (f) => seen.push(f));
+        const f: AcsInboundAudioFrame = { Pcm: frame(2), ParticipantId: 'p1' };
+        registry.DispatchInbound('call-1', f);
+        expect(seen).toEqual([f, f]);
+    });
+
+    it('dispatches hand-raise signals to registered hand-raise handlers', () => {
+        const registry = new TeamsAcsMediaRegistry();
+        let raised: boolean | undefined;
+        registry.OnHandRaise('call-1', (_p, r) => (raised = r));
+        registry.DispatchHandRaise('call-1', 'p1', true);
+        expect(raised).toBe(true);
+    });
+
+    it('ignores inbound dispatch + hand-raise for unknown calls (no throw)', () => {
+        const registry = new TeamsAcsMediaRegistry();
+        expect(() => registry.DispatchInbound('nope', { Pcm: frame(2), ParticipantId: 'p1' })).not.toThrow();
+        expect(() => registry.DispatchHandRaise('nope', 'p1', true)).not.toThrow();
+    });
+
+    it('closes the transport and forgets the call on EndCall', () => {
+        const registry = new TeamsAcsMediaRegistry();
+        const transport = new FakeTransport();
+        registry.AttachTransport('call-1', transport);
+        expect(registry.HasCall('call-1')).toBe(true);
+
+        registry.EndCall('call-1');
+        expect(transport.Closed).toBe(true);
+        expect(registry.HasCall('call-1')).toBe(false);
+        // EndCall on an unknown call is a silent no-op.
+        expect(() => registry.EndCall('unknown')).not.toThrow();
+    });
+});

package/src/__tests__/twilio-telephony-service.test.ts

@@ -0,0 +1,23 @@
+import { describe, it, expect, vi } from 'vitest';
+import { TwilioTelephonyService } from '../telephony/TwilioTelephonyService.js';
+import { TwilioCallMediaRegistry } from '../telephony/twilioMediaRegistry.js';
+import { TwilioCallSdk } from '@memberjunction/ai-bridge-twilio';
+import type { BaseTelephonyBridge } from '@memberjunction/ai-bridge-base';
+
+const CONFIG = { accountSid: 'AC1', authToken: 'tok', streamPublicUrl: 'wss://api.test/telephony/twilio/media' };
+
+describe('TwilioTelephonyService.buildBindSdk', () => {
+    it('binds a TwilioCallSdk factory onto the telephony driver (the live REST + media wiring seam)', () => {
+        const service = new TwilioTelephonyService(CONFIG, new TwilioCallMediaRegistry());
+        const setSdkFactory = vi.fn();
+        const fakeDriver = { SetSdkFactory: setSdkFactory } as unknown as BaseTelephonyBridge;
+
+        service.buildBindSdk()(fakeDriver);
+
+        expect(setSdkFactory).toHaveBeenCalledTimes(1);
+        const factory = setSdkFactory.mock.calls[0][0] as () => unknown;
+        expect(typeof factory).toBe('function');
+        // The factory yields a real (bound) TwilioCallSdk — proving the offline seam meets live plumbing.
+        expect(factory()).toBeInstanceOf(TwilioCallSdk);
+    });
+});

package/src/__tests__/twilioMediaRegistry.test.ts

@@ -0,0 +1,103 @@
+import { describe, it, expect, vi } from 'vitest';
+import { TwilioCallMediaRegistry, type ITelephonyMediaSocket } from '../telephony/twilioMediaRegistry.js';
+import type { TwilioMediaFrame } from '@memberjunction/ai-bridge-twilio';
+
+/** A fake Media-Streams socket capturing sends + tracking close. */
+function fakeSocket(): ITelephonyMediaSocket & { sent: string[]; closed: boolean } {
+    const sent: string[] = [];
+    return {
+        sent,
+        closed: false,
+        send(data: string) {
+            sent.push(data);
+        },
+        close() {
+            (this as { closed: boolean }).closed = true;
+        },
+    };
+}
+
+const mediaFrame = (payload: string): TwilioMediaFrame => ({ event: 'media', streamSid: 'MZ1', media: { payload } });
+
+describe('TwilioCallMediaRegistry', () => {
+    describe('outbound buffering', () => {
+        it('buffers outbound frames before the socket connects, then flushes on AttachSocket in order', () => {
+            const reg = new TwilioCallMediaRegistry();
+            reg.RegisterCall('CA1');
+            reg.Send('CA1', mediaFrame('a'));
+            reg.Send('CA1', mediaFrame('b'));
+
+            const sock = fakeSocket();
+            reg.AttachSocket('CA1', sock, 'MZ1');
+
+            expect(sock.sent).toHaveLength(2);
+            expect(JSON.parse(sock.sent[0]).media.payload).toBe('a');
+            expect(JSON.parse(sock.sent[1]).media.payload).toBe('b');
+        });
+
+        it('sends immediately once the socket is attached', () => {
+            const reg = new TwilioCallMediaRegistry();
+            const sock = fakeSocket();
+            reg.AttachSocket('CA1', sock, 'MZ1');
+            reg.Send('CA1', mediaFrame('c'));
+            expect(sock.sent).toHaveLength(1);
+            expect(JSON.parse(sock.sent[0]).media.payload).toBe('c');
+        });
+    });
+
+    describe('inbound dispatch', () => {
+        it('delivers inbound frames to handlers registered before the socket existed', () => {
+            const reg = new TwilioCallMediaRegistry();
+            const received: TwilioMediaFrame[] = [];
+            reg.OnFrame('CA1', (f) => received.push(f));
+
+            reg.DispatchInbound('CA1', mediaFrame('in'));
+
+            expect(received).toHaveLength(1);
+            expect(received[0].media?.payload).toBe('in');
+        });
+
+        it('captures the stream SID from a start frame and exposes it via GetStreamSid', () => {
+            const reg = new TwilioCallMediaRegistry();
+            reg.RegisterCall('CA1');
+            expect(reg.GetStreamSid('CA1')).toBe('');
+            reg.DispatchInbound('CA1', { event: 'start', streamSid: 'MZ-XYZ' });
+            expect(reg.GetStreamSid('CA1')).toBe('MZ-XYZ');
+        });
+
+        it('drops inbound frames for an unknown call (no channel) without throwing', () => {
+            const reg = new TwilioCallMediaRegistry();
+            expect(() => reg.DispatchInbound('UNKNOWN', mediaFrame('x'))).not.toThrow();
+        });
+
+        it('fans out to multiple handlers (audio + dtmf + status all registered on one call)', () => {
+            const reg = new TwilioCallMediaRegistry();
+            const h1 = vi.fn();
+            const h2 = vi.fn();
+            reg.OnFrame('CA1', h1);
+            reg.OnFrame('CA1', h2);
+            reg.DispatchInbound('CA1', mediaFrame('y'));
+            expect(h1).toHaveBeenCalledTimes(1);
+            expect(h2).toHaveBeenCalledTimes(1);
+        });
+    });
+
+    describe('lifecycle', () => {
+        it('EndCall closes the socket and forgets the channel', () => {
+            const reg = new TwilioCallMediaRegistry();
+            const sock = fakeSocket();
+            reg.AttachSocket('CA1', sock, 'MZ1');
+            expect(reg.HasCall('CA1')).toBe(true);
+
+            reg.EndCall('CA1');
+
+            expect(sock.closed).toBe(true);
+            expect(reg.HasCall('CA1')).toBe(false);
+        });
+
+        it('EndCall on an unknown call is a no-op', () => {
+            const reg = new TwilioCallMediaRegistry();
+            expect(() => reg.EndCall('NOPE')).not.toThrow();
+        });
+    });
+});