@servicetitan/titan-chat-ui-common 8.0.0 → 9.0.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# v9.0.0 (Mon Jun 08 2026)
+
+#### 💥 Breaking Change
+
+- SPA-8507: Agent Progress Streaming — Frontend Streaming UX [#91](https://github.com/servicetitan/titan-chatbot-client/pull/91) ([@AlexYarmolchuk](https://github.com/AlexYarmolchuk))
+
+#### Authors: 1
+
+- Alexandr Yarmolchuk ([@AlexYarmolchuk](https://github.com/AlexYarmolchuk))
+
+---
+
 # v8.0.0 (Wed Jun 03 2026)
 
 #### 💥 Breaking Change

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './stores';
 export * from './models';
+export * from './streaming';
 export * from './hooks/use-customization-chat';
 export * from './utils/text-utils';
 export * from './utils/test-utils';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './stores';
 export * from './models';
+export * from './streaming';
 export * from './hooks/use-customization-chat';
 export * from './utils/text-utils';
 export * from './utils/test-utils';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './stores';\nexport * from './models';\nexport * from './hooks/use-customization-chat';\nexport * from './utils/text-utils';\nexport * from './utils/test-utils';\n"],"names":[],"mappings":"AAAA,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,iCAAiC;AAC/C,cAAc,qBAAqB;AACnC,cAAc,qBAAqB"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './stores';\nexport * from './models';\nexport * from './streaming';\nexport * from './hooks/use-customization-chat';\nexport * from './utils/text-utils';\nexport * from './utils/test-utils';\n"],"names":[],"mappings":"AAAA,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,cAAc;AAC5B,cAAc,iCAAiC;AAC/C,cAAc,qBAAqB;AACnC,cAAc,qBAAqB"}

package/dist/streaming/__tests__/chat-sse-client-lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat-sse-client-lifecycle.test.d.ts.map

package/dist/streaming/__tests__/chat-sse-client-lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-sse-client-lifecycle.test.d.ts","sourceRoot":"","sources":["../../../src/streaming/__tests__/chat-sse-client-lifecycle.test.ts"],"names":[],"mappings":""}

package/dist/streaming/__tests__/chat-sse-client-lifecycle.test.js

@@ -0,0 +1,86 @@
+import { beforeEach, describe, expect, jest, test } from '@jest/globals';
+import { fetchEventSource } from '@microsoft/fetch-event-source';
+import { ChatSseClient } from '../chat-sse-client';
+jest.mock('@microsoft/fetch-event-source');
+const fetchEventSourceMock = fetchEventSource;
+const msg = (event, data)=>({
+        id: '',
+        event,
+        data
+    });
+const okResponse = ()=>({
+        ok: true,
+        status: 200,
+        headers: {
+            get: ()=>'text/event-stream'
+        }
+    });
+const badResponse = ()=>({
+        ok: false,
+        status: 502,
+        headers: {
+            get: ()=>'text/html'
+        }
+    });
+describe('ChatSseClient — lifecycle wiring', ()=>{
+    beforeEach(()=>{
+        fetchEventSourceMock.mockReset();
+    });
+    test('valid onopen reports connected', async ()=>{
+        const onConnected = jest.fn();
+        fetchEventSourceMock.mockImplementation(async (_url, init)=>{
+            var _init_onopen;
+            await ((_init_onopen = init.onopen) === null || _init_onopen === void 0 ? void 0 : _init_onopen.call(init, okResponse()));
+        });
+        await new ChatSseClient({
+            url: 'u',
+            onConnected
+        }).start();
+        expect(onConnected).toHaveBeenCalledTimes(1);
+    });
+    test('non-OK onopen is a connect-time failure: start rejects and onError fires', async ()=>{
+        const onError = jest.fn();
+        fetchEventSourceMock.mockImplementation(async (_url, init)=>{
+            // Faithful to the lib: an onopen throw is routed to onerror, which (rethrowing) rejects.
+            try {
+                var _init_onopen;
+                await ((_init_onopen = init.onopen) === null || _init_onopen === void 0 ? void 0 : _init_onopen.call(init, badResponse()));
+            } catch (err) {
+                var _init_onerror;
+                const result = (_init_onerror = init.onerror) === null || _init_onerror === void 0 ? void 0 : _init_onerror.call(init, err);
+                if (result === undefined || result === null) {
+                    throw err;
+                }
+            }
+        });
+        const client = new ChatSseClient({
+            url: 'u',
+            onError
+        });
+        await expect(client.start()).rejects.toBeDefined();
+        expect(onError).toHaveBeenCalledTimes(1);
+    });
+    test('malformed JSON data is skipped without tearing down or erroring', async ()=>{
+        const onError = jest.fn();
+        const onEvent = jest.fn();
+        let captured;
+        fetchEventSourceMock.mockImplementation(async (_url, init)=>{
+            var _init_onopen;
+            captured = init;
+            await ((_init_onopen = init.onopen) === null || _init_onopen === void 0 ? void 0 : _init_onopen.call(init, okResponse()));
+        });
+        await new ChatSseClient({
+            url: 'u',
+            onError,
+            onEvent
+        }).start();
+        expect(()=>{
+            var _captured_onmessage;
+            return (_captured_onmessage = captured.onmessage) === null || _captured_onmessage === void 0 ? void 0 : _captured_onmessage.call(captured, msg('status.changed', 'not-json{'));
+        }).not.toThrow();
+        expect(onError).not.toHaveBeenCalled();
+        expect(onEvent).not.toHaveBeenCalled();
+    });
+});
+
+//# sourceMappingURL=chat-sse-client-lifecycle.test.js.map

package/dist/streaming/__tests__/chat-sse-client-lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/streaming/__tests__/chat-sse-client-lifecycle.test.ts"],"sourcesContent":["import { beforeEach, describe, expect, jest, test } from '@jest/globals';\nimport { type EventSourceMessage, fetchEventSource } from '@microsoft/fetch-event-source';\nimport { ChatSseClient } from '../chat-sse-client';\n\njest.mock('@microsoft/fetch-event-source');\n\nconst fetchEventSourceMock = fetchEventSource as jest.MockedFunction<typeof fetchEventSource>;\n\nconst msg = (event: string, data: string): EventSourceMessage => ({ id: '', event, data });\n\nconst okResponse = () =>\n    ({ ok: true, status: 200, headers: { get: () => 'text/event-stream' } }) as unknown as Response;\nconst badResponse = () =>\n    ({ ok: false, status: 502, headers: { get: () => 'text/html' } }) as unknown as Response;\n\ndescribe('ChatSseClient — lifecycle wiring', () => {\n    beforeEach(() => {\n        fetchEventSourceMock.mockReset();\n    });\n\n    test('valid onopen reports connected', async () => {\n        const onConnected = jest.fn();\n        fetchEventSourceMock.mockImplementation(async (_url, init) => {\n            await init.onopen?.(okResponse());\n        });\n\n        await new ChatSseClient({ url: 'u', onConnected }).start();\n\n        expect(onConnected).toHaveBeenCalledTimes(1);\n    });\n\n    test('non-OK onopen is a connect-time failure: start rejects and onError fires', async () => {\n        const onError = jest.fn();\n        fetchEventSourceMock.mockImplementation(async (_url, init) => {\n            // Faithful to the lib: an onopen throw is routed to onerror, which (rethrowing) rejects.\n            try {\n                await init.onopen?.(badResponse());\n            } catch (err) {\n                const result = init.onerror?.(err);\n                if (result === undefined || result === null) {\n                    throw err;\n                }\n            }\n        });\n\n        const client = new ChatSseClient({ url: 'u', onError });\n\n        await expect(client.start()).rejects.toBeDefined();\n        expect(onError).toHaveBeenCalledTimes(1);\n    });\n\n    test('malformed JSON data is skipped without tearing down or erroring', async () => {\n        const onError = jest.fn();\n        const onEvent = jest.fn();\n        let captured: any;\n        fetchEventSourceMock.mockImplementation(async (_url, init) => {\n            captured = init;\n            await init.onopen?.(okResponse());\n        });\n\n        await new ChatSseClient({ url: 'u', onError, onEvent }).start();\n\n        expect(() => captured.onmessage?.(msg('status.changed', 'not-json{'))).not.toThrow();\n        expect(onError).not.toHaveBeenCalled();\n        expect(onEvent).not.toHaveBeenCalled();\n    });\n});\n"],"names":["beforeEach","describe","expect","jest","test","fetchEventSource","ChatSseClient","mock","fetchEventSourceMock","msg","event","data","id","okResponse","ok","status","headers","get","badResponse","mockReset","onConnected","fn","mockImplementation","_url","init","onopen","url","start","toHaveBeenCalledTimes","onError","err","result","onerror","undefined","client","rejects","toBeDefined","onEvent","captured","onmessage","not","toThrow","toHaveBeenCalled"],"mappings":"AAAA,SAASA,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,IAAI,EAAEC,IAAI,QAAQ,gBAAgB;AACzE,SAAkCC,gBAAgB,QAAQ,gCAAgC;AAC1F,SAASC,aAAa,QAAQ,qBAAqB;AAEnDH,KAAKI,IAAI,CAAC;AAEV,MAAMC,uBAAuBH;AAE7B,MAAMI,MAAM,CAACC,OAAeC,OAAsC,CAAA;QAAEC,IAAI;QAAIF;QAAOC;IAAK,CAAA;AAExF,MAAME,aAAa,IACd,CAAA;QAAEC,IAAI;QAAMC,QAAQ;QAAKC,SAAS;YAAEC,KAAK,IAAM;QAAoB;IAAE,CAAA;AAC1E,MAAMC,cAAc,IACf,CAAA;QAAEJ,IAAI;QAAOC,QAAQ;QAAKC,SAAS;YAAEC,KAAK,IAAM;QAAY;IAAE,CAAA;AAEnEhB,SAAS,oCAAoC;IACzCD,WAAW;QACPQ,qBAAqBW,SAAS;IAClC;IAEAf,KAAK,kCAAkC;QACnC,MAAMgB,cAAcjB,KAAKkB,EAAE;QAC3Bb,qBAAqBc,kBAAkB,CAAC,OAAOC,MAAMC;gBAC3CA;YAAN,QAAMA,eAAAA,KAAKC,MAAM,cAAXD,mCAAAA,kBAAAA,MAAcX;QACxB;QAEA,MAAM,IAAIP,cAAc;YAAEoB,KAAK;YAAKN;QAAY,GAAGO,KAAK;QAExDzB,OAAOkB,aAAaQ,qBAAqB,CAAC;IAC9C;IAEAxB,KAAK,4EAA4E;QAC7E,MAAMyB,UAAU1B,KAAKkB,EAAE;QACvBb,qBAAqBc,kBAAkB,CAAC,OAAOC,MAAMC;YACjD,yFAAyF;YACzF,IAAI;oBACMA;gBAAN,QAAMA,eAAAA,KAAKC,MAAM,cAAXD,mCAAAA,kBAAAA,MAAcN;YACxB,EAAE,OAAOY,KAAK;oBACKN;gBAAf,MAAMO,UAASP,gBAAAA,KAAKQ,OAAO,cAAZR,oCAAAA,mBAAAA,MAAeM;gBAC9B,IAAIC,WAAWE,aAAaF,WAAW,MAAM;oBACzC,MAAMD;gBACV;YACJ;QACJ;QAEA,MAAMI,SAAS,IAAI5B,cAAc;YAAEoB,KAAK;YAAKG;QAAQ;QAErD,MAAM3B,OAAOgC,OAAOP,KAAK,IAAIQ,OAAO,CAACC,WAAW;QAChDlC,OAAO2B,SAASD,qBAAqB,CAAC;IAC1C;IAEAxB,KAAK,mEAAmE;QACpE,MAAMyB,UAAU1B,KAAKkB,EAAE;QACvB,MAAMgB,UAAUlC,KAAKkB,EAAE;QACvB,IAAIiB;QACJ9B,qBAAqBc,kBAAkB,CAAC,OAAOC,MAAMC;gBAE3CA;YADNc,WAAWd;YACX,QAAMA,eAAAA,KAAKC,MAAM,cAAXD,mCAAAA,kBAAAA,MAAcX;QACxB;QAEA,MAAM,IAAIP,cAAc;YAAEoB,KAAK;YAAKG;YAASQ;QAAQ,GAAGV,KAAK;QAE7DzB,OAAO;gBAAMoC;oBAAAA,sBAAAA,SAASC,SAAS,cAAlBD,0CAAAA,yBAAAA,UAAqB7B,IAAI,kBAAkB;WAAe+B,GAAG,CAACC,OAAO;QAClFvC,OAAO2B,SAASW,GAAG,CAACE,gBAAgB;QACpCxC,OAAOmC,SAASG,GAAG,CAACE,gBAAgB;IACxC;AACJ"}

package/dist/streaming/__tests__/chat-sse-client-resilience.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat-sse-client-resilience.test.d.ts.map

package/dist/streaming/__tests__/chat-sse-client-resilience.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-sse-client-resilience.test.d.ts","sourceRoot":"","sources":["../../../src/streaming/__tests__/chat-sse-client-resilience.test.ts"],"names":[],"mappings":""}

package/dist/streaming/__tests__/chat-sse-client-resilience.test.js

@@ -0,0 +1,140 @@
+import { afterEach, beforeEach, describe, expect, jest, test } from '@jest/globals';
+import { fetchEventSource } from '@microsoft/fetch-event-source';
+import { ChatSseClient } from '../chat-sse-client';
+jest.mock('@microsoft/fetch-event-source');
+const fetchEventSourceMock = fetchEventSource;
+const msg = (event, data)=>({
+        id: '',
+        event,
+        data: typeof data === 'string' ? data : JSON.stringify(data)
+    });
+const okResponse = ()=>({
+        ok: true,
+        status: 200,
+        headers: {
+            get: ()=>'text/event-stream'
+        }
+    });
+/**
+ * Capture init, run a successful onopen, then stay open (pending) until the client aborts —
+ * mirroring real `fetchEventSource`, which resolves only when the stream actually closes.
+ */ function captureOpen() {
+    const capture = {
+        opened: undefined
+    };
+    capture.opened = new Promise((markOpened)=>{
+        fetchEventSourceMock.mockImplementation(async (_url, init)=>{
+            var _init_onopen;
+            capture.init = init;
+            await ((_init_onopen = init.onopen) === null || _init_onopen === void 0 ? void 0 : _init_onopen.call(init, okResponse()));
+            markOpened();
+            await new Promise((resolve)=>{
+                const signal = init.signal;
+                if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                    resolve();
+                } else {
+                    signal === null || signal === void 0 ? void 0 : signal.addEventListener('abort', ()=>resolve(), {
+                        once: true
+                    });
+                }
+            });
+        });
+    });
+    return capture;
+}
+describe('ChatSseClient — inactivity, reconnect, completion', ()=>{
+    beforeEach(()=>{
+        fetchEventSourceMock.mockReset();
+        jest.useFakeTimers();
+    });
+    afterEach(()=>{
+        jest.useRealTimers();
+    });
+    test('inactivity callback + onTimeout fire after the threshold, keeping the connection open', async ()=>{
+        var _capture_init_signal;
+        const onInactivity = jest.fn();
+        const onTimeout = jest.fn();
+        const capture = captureOpen();
+        new ChatSseClient({
+            url: 'u',
+            inactivityTimeoutMs: 16000,
+            onInactivity,
+            onTimeout
+        }).start();
+        await capture.opened;
+        jest.advanceTimersByTime(15999);
+        expect(onInactivity).not.toHaveBeenCalled();
+        jest.advanceTimersByTime(1);
+        expect(onInactivity).toHaveBeenCalledTimes(1);
+        expect(onTimeout).toHaveBeenCalledTimes(1);
+        // Connection is not aborted by inactivity.
+        expect((_capture_init_signal = capture.init.signal) === null || _capture_init_signal === void 0 ? void 0 : _capture_init_signal.aborted).toBeFalsy();
+    });
+    test('a received event resets the inactivity timer', async ()=>{
+        const onInactivity = jest.fn();
+        const capture = captureOpen();
+        new ChatSseClient({
+            url: 'u',
+            inactivityTimeoutMs: 16000,
+            onInactivity
+        }).start();
+        await capture.opened;
+        jest.advanceTimersByTime(10000);
+        capture.init.onmessage(msg('status.changed', {
+            seq: 1
+        })); // reset
+        jest.advanceTimersByTime(10000); // 10s since reset < 16s
+        expect(onInactivity).not.toHaveBeenCalled();
+        jest.advanceTimersByTime(6000); // now 16s since reset
+        expect(onInactivity).toHaveBeenCalledTimes(1);
+    });
+    test('transient drops reconnect up to the limit, then report a fatal error', async ()=>{
+        const onDisconnected = jest.fn();
+        const onError = jest.fn();
+        const capture = captureOpen();
+        new ChatSseClient({
+            url: 'u',
+            maxReconnectAttempts: 2,
+            onDisconnected,
+            onError
+        }).start();
+        await capture.opened;
+        const r1 = capture.init.onerror(new Error('drop1'));
+        const r2 = capture.init.onerror(new Error('drop2'));
+        expect(typeof r1).toBe('number');
+        expect(typeof r2).toBe('number');
+        expect(onDisconnected).toHaveBeenCalledTimes(2);
+        expect(onError).not.toHaveBeenCalled();
+        expect(()=>capture.init.onerror(new Error('drop3'))).toThrow();
+        expect(onError).toHaveBeenCalledTimes(1);
+    });
+    test('a terminal event completes the run, fires onCompleted, and stops the timer', async ()=>{
+        const onCompleted = jest.fn();
+        const onInactivity = jest.fn();
+        const onFinished = jest.fn();
+        const capture = captureOpen();
+        new ChatSseClient({
+            url: 'u',
+            inactivityTimeoutMs: 16000,
+            isTerminalEvent: (e)=>e.event === 'run.finished',
+            handlers: {
+                'run.finished': onFinished
+            },
+            onCompleted,
+            onInactivity
+        }).start();
+        await capture.opened;
+        capture.init.onmessage(msg('run.finished', {
+            seq: 1,
+            answer: 'done'
+        }));
+        expect(onFinished).toHaveBeenCalledTimes(1);
+        expect(onCompleted).toHaveBeenCalledTimes(1);
+        // After completion: timer stopped and post-terminal errors are not fatal.
+        jest.advanceTimersByTime(60000);
+        expect(onInactivity).not.toHaveBeenCalled();
+        expect(()=>capture.init.onerror(new Error('late'))).not.toThrow();
+    });
+});
+
+//# sourceMappingURL=chat-sse-client-resilience.test.js.map

package/dist/streaming/__tests__/chat-sse-client-resilience.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/streaming/__tests__/chat-sse-client-resilience.test.ts"],"sourcesContent":["import { afterEach, beforeEach, describe, expect, jest, test } from '@jest/globals';\nimport { type EventSourceMessage, fetchEventSource } from '@microsoft/fetch-event-source';\nimport { ChatSseClient } from '../chat-sse-client';\n\njest.mock('@microsoft/fetch-event-source');\n\nconst fetchEventSourceMock = fetchEventSource as jest.MockedFunction<typeof fetchEventSource>;\n\nconst msg = (event: string, data: unknown): EventSourceMessage => ({\n    id: '',\n    event,\n    data: typeof data === 'string' ? data : JSON.stringify(data),\n});\nconst okResponse = () =>\n    ({ ok: true, status: 200, headers: { get: () => 'text/event-stream' } }) as unknown as Response;\n\n/**\n * Capture init, run a successful onopen, then stay open (pending) until the client aborts —\n * mirroring real `fetchEventSource`, which resolves only when the stream actually closes.\n */\nfunction captureOpen() {\n    const capture: { init?: any; opened: Promise<void> } = {\n        opened: undefined as any,\n    };\n    capture.opened = new Promise<void>(markOpened => {\n        fetchEventSourceMock.mockImplementation(async (_url, init) => {\n            capture.init = init;\n            await init.onopen?.(okResponse());\n            markOpened();\n            await new Promise<void>(resolve => {\n                const signal: AbortSignal | null | undefined = init.signal;\n                if (signal?.aborted) {\n                    resolve();\n                } else {\n                    signal?.addEventListener('abort', () => resolve(), { once: true });\n                }\n            });\n        });\n    });\n    return capture;\n}\n\ndescribe('ChatSseClient — inactivity, reconnect, completion', () => {\n    beforeEach(() => {\n        fetchEventSourceMock.mockReset();\n        jest.useFakeTimers();\n    });\n    afterEach(() => {\n        jest.useRealTimers();\n    });\n\n    test('inactivity callback + onTimeout fire after the threshold, keeping the connection open', async () => {\n        const onInactivity = jest.fn();\n        const onTimeout = jest.fn();\n        const capture = captureOpen();\n\n        new ChatSseClient({\n            url: 'u',\n            inactivityTimeoutMs: 16_000,\n            onInactivity,\n            onTimeout,\n        }).start();\n        await capture.opened;\n\n        jest.advanceTimersByTime(15_999);\n        expect(onInactivity).not.toHaveBeenCalled();\n\n        jest.advanceTimersByTime(1);\n        expect(onInactivity).toHaveBeenCalledTimes(1);\n        expect(onTimeout).toHaveBeenCalledTimes(1);\n        // Connection is not aborted by inactivity.\n        expect(capture.init.signal?.aborted).toBeFalsy();\n    });\n\n    test('a received event resets the inactivity timer', async () => {\n        const onInactivity = jest.fn();\n        const capture = captureOpen();\n\n        new ChatSseClient({ url: 'u', inactivityTimeoutMs: 16_000, onInactivity }).start();\n        await capture.opened;\n\n        jest.advanceTimersByTime(10_000);\n        capture.init.onmessage(msg('status.changed', { seq: 1 })); // reset\n        jest.advanceTimersByTime(10_000); // 10s since reset < 16s\n        expect(onInactivity).not.toHaveBeenCalled();\n\n        jest.advanceTimersByTime(6_000); // now 16s since reset\n        expect(onInactivity).toHaveBeenCalledTimes(1);\n    });\n\n    test('transient drops reconnect up to the limit, then report a fatal error', async () => {\n        const onDisconnected = jest.fn();\n        const onError = jest.fn();\n        const capture = captureOpen();\n\n        new ChatSseClient({\n            url: 'u',\n            maxReconnectAttempts: 2,\n            onDisconnected,\n            onError,\n        }).start();\n        await capture.opened;\n\n        const r1 = capture.init.onerror(new Error('drop1'));\n        const r2 = capture.init.onerror(new Error('drop2'));\n        expect(typeof r1).toBe('number');\n        expect(typeof r2).toBe('number');\n        expect(onDisconnected).toHaveBeenCalledTimes(2);\n        expect(onError).not.toHaveBeenCalled();\n\n        expect(() => capture.init.onerror(new Error('drop3'))).toThrow();\n        expect(onError).toHaveBeenCalledTimes(1);\n    });\n\n    test('a terminal event completes the run, fires onCompleted, and stops the timer', async () => {\n        const onCompleted = jest.fn();\n        const onInactivity = jest.fn();\n        const onFinished = jest.fn();\n        const capture = captureOpen();\n\n        new ChatSseClient({\n            url: 'u',\n            inactivityTimeoutMs: 16_000,\n            isTerminalEvent: e => e.event === 'run.finished',\n            handlers: { 'run.finished': onFinished },\n            onCompleted,\n            onInactivity,\n        }).start();\n        await capture.opened;\n\n        capture.init.onmessage(msg('run.finished', { seq: 1, answer: 'done' }));\n\n        expect(onFinished).toHaveBeenCalledTimes(1);\n        expect(onCompleted).toHaveBeenCalledTimes(1);\n\n        // After completion: timer stopped and post-terminal errors are not fatal.\n        jest.advanceTimersByTime(60_000);\n        expect(onInactivity).not.toHaveBeenCalled();\n        expect(() => capture.init.onerror(new Error('late'))).not.toThrow();\n    });\n});\n"],"names":["afterEach","beforeEach","describe","expect","jest","test","fetchEventSource","ChatSseClient","mock","fetchEventSourceMock","msg","event","data","id","JSON","stringify","okResponse","ok","status","headers","get","captureOpen","capture","opened","undefined","Promise","markOpened","mockImplementation","_url","init","onopen","resolve","signal","aborted","addEventListener","once","mockReset","useFakeTimers","useRealTimers","onInactivity","fn","onTimeout","url","inactivityTimeoutMs","start","advanceTimersByTime","not","toHaveBeenCalled","toHaveBeenCalledTimes","toBeFalsy","onmessage","seq","onDisconnected","onError","maxReconnectAttempts","r1","onerror","Error","r2","toBe","toThrow","onCompleted","onFinished","isTerminalEvent","e","handlers","answer"],"mappings":"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"}

package/dist/streaming/__tests__/chat-sse-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat-sse-client.test.d.ts.map

package/dist/streaming/__tests__/chat-sse-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-sse-client.test.d.ts","sourceRoot":"","sources":["../../../src/streaming/__tests__/chat-sse-client.test.ts"],"names":[],"mappings":""}

package/dist/streaming/__tests__/chat-sse-client.test.js

@@ -0,0 +1,209 @@
+import { beforeEach, describe, expect, jest, test } from '@jest/globals';
+import { fetchEventSource } from '@microsoft/fetch-event-source';
+import { ChatSseClient } from '../chat-sse-client';
+jest.mock('@microsoft/fetch-event-source');
+const fetchEventSourceMock = fetchEventSource;
+/** Capture the init passed to fetchEventSource so tests can drive its callbacks. */ function captureInit() {
+    const capture = {};
+    fetchEventSourceMock.mockImplementation((url, init)=>{
+        capture.url = url;
+        capture.init = init;
+        return Promise.resolve();
+    });
+    return capture;
+}
+const msg = (event, data)=>({
+        id: '',
+        event,
+        data: typeof data === 'string' ? data : JSON.stringify(data)
+    });
+describe('ChatSseClient — open / decode / dispatch / seq / registry', ()=>{
+    beforeEach(()=>{
+        fetchEventSourceMock.mockReset();
+    });
+    test('opens a POST stream with body, headers and event-stream Accept', async ()=>{
+        var _capture_init, _capture_init1, _capture_init2;
+        const capture = captureInit();
+        await new ChatSseClient({
+            url: 'https://api.test/api/v2/message/stream',
+            body: {
+                question: 'hi',
+                sessionId: 7
+            },
+            headers: {
+                'Authorization': 'Bearer t',
+                'X-Client-ID': 'help-center'
+            }
+        }).start();
+        expect(capture.url).toBe('https://api.test/api/v2/message/stream');
+        expect((_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : _capture_init.method).toBe('POST');
+        expect((_capture_init1 = capture.init) === null || _capture_init1 === void 0 ? void 0 : _capture_init1.body).toBe(JSON.stringify({
+            question: 'hi',
+            sessionId: 7
+        }));
+        expect((_capture_init2 = capture.init) === null || _capture_init2 === void 0 ? void 0 : _capture_init2.headers).toMatchObject({
+            'Accept': 'text/event-stream',
+            'Content-Type': 'application/json',
+            'Authorization': 'Bearer t',
+            'X-Client-ID': 'help-center'
+        });
+    });
+    test('JSON-decodes data and dispatches to the registered handler with seq', async ()=>{
+        var _capture_init_onmessage, _capture_init;
+        const capture = captureInit();
+        const onStatus = jest.fn();
+        const client = new ChatSseClient({
+            url: 'u',
+            handlers: {
+                'status.changed': onStatus
+            }
+        });
+        await client.start();
+        (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('status.changed', {
+            text: 'Thinking…',
+            seq: 2
+        }));
+        expect(onStatus).toHaveBeenCalledTimes(1);
+        const [data, event] = onStatus.mock.calls[0];
+        expect(data).toEqual({
+            text: 'Thinking…',
+            seq: 2
+        });
+        expect(event).toEqual({
+            event: 'status.changed',
+            data: {
+                text: 'Thinking…',
+                seq: 2
+            },
+            seq: 2
+        });
+    });
+    test('handlers registered via on() receive matching events; consumer can extend new types', async ()=>{
+        var _capture_init_onmessage, _capture_init;
+        const capture = captureInit();
+        const onCustom = jest.fn();
+        const client = new ChatSseClient({
+            url: 'u'
+        });
+        client.on('custom.future-event', onCustom);
+        await client.start();
+        (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('custom.future-event', {
+            foo: 1,
+            seq: 1
+        }));
+        expect(onCustom).toHaveBeenCalledTimes(1);
+        expect(onCustom.mock.calls[0][0]).toEqual({
+            foo: 1,
+            seq: 1
+        });
+    });
+    test('unknown event with no handler is ignored without closing; onEvent still fires', async ()=>{
+        const capture = captureInit();
+        const onEvent = jest.fn();
+        const onError = jest.fn();
+        const client = new ChatSseClient({
+            url: 'u',
+            onEvent,
+            onError
+        });
+        await client.start();
+        expect(()=>{
+            var _capture_init_onmessage, _capture_init;
+            return (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('totally.unknown', {
+                seq: 1
+            }));
+        }).not.toThrow();
+        expect(onError).not.toHaveBeenCalled();
+        expect(onEvent).toHaveBeenCalledTimes(1);
+        expect(onEvent.mock.calls[0][0]).toMatchObject({
+            event: 'totally.unknown',
+            seq: 1
+        });
+    });
+    test('ignores null / non-object JSON payloads without throwing or dispatching', async ()=>{
+        var // A valid event after the bad ones is still processed (the stream is not wedged).
+        _capture_init_onmessage, _capture_init;
+        const capture = captureInit();
+        const onText = jest.fn();
+        const onEvent = jest.fn();
+        const onError = jest.fn();
+        const client = new ChatSseClient({
+            url: 'u',
+            handlers: {
+                'text.appended': onText
+            },
+            onEvent,
+            onError
+        });
+        await client.start();
+        // `JSON.parse` yields a value that has no `seq`; accessing `.seq` on `null` would throw.
+        expect(()=>{
+            var _capture_init_onmessage, _capture_init;
+            return (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('text.appended', null));
+        }).not.toThrow();
+        expect(()=>{
+            var _capture_init_onmessage, _capture_init;
+            return (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('text.appended', '42'));
+        }).not.toThrow();
+        expect(()=>{
+            var _capture_init_onmessage, _capture_init;
+            return (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('text.appended', '"hi"'));
+        }).not.toThrow();
+        // Unparseable data is likewise skipped.
+        expect(()=>{
+            var _capture_init_onmessage, _capture_init;
+            return (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('text.appended', 'not json'));
+        }).not.toThrow();
+        expect(onText).not.toHaveBeenCalled();
+        expect(onEvent).not.toHaveBeenCalled();
+        expect(onError).not.toHaveBeenCalled();
+        (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('text.appended', {
+            text: 'a',
+            seq: 1
+        }));
+        expect(onText).toHaveBeenCalledTimes(1);
+        expect(onText.mock.calls[0][0]).toEqual({
+            text: 'a',
+            seq: 1
+        });
+    });
+    test('discards events whose seq is not greater than the last processed seq', async ()=>{
+        var _capture_init_onmessage, _capture_init, _capture_init_onmessage1, _capture_init1, _capture_init_onmessage2, _capture_init2, _capture_init_onmessage3, _capture_init3;
+        const capture = captureInit();
+        const onText = jest.fn();
+        const client = new ChatSseClient({
+            url: 'u',
+            handlers: {
+                'text.appended': onText
+            }
+        });
+        await client.start();
+        (_capture_init = capture.init) === null || _capture_init === void 0 ? void 0 : (_capture_init_onmessage = _capture_init.onmessage) === null || _capture_init_onmessage === void 0 ? void 0 : _capture_init_onmessage.call(_capture_init, msg('text.appended', {
+            text: 'a',
+            seq: 5
+        }));
+        (_capture_init1 = capture.init) === null || _capture_init1 === void 0 ? void 0 : (_capture_init_onmessage1 = _capture_init1.onmessage) === null || _capture_init_onmessage1 === void 0 ? void 0 : _capture_init_onmessage1.call(_capture_init1, msg('text.appended', {
+            text: 'dup',
+            seq: 5
+        })); // duplicate
+        (_capture_init2 = capture.init) === null || _capture_init2 === void 0 ? void 0 : (_capture_init_onmessage2 = _capture_init2.onmessage) === null || _capture_init_onmessage2 === void 0 ? void 0 : _capture_init_onmessage2.call(_capture_init2, msg('text.appended', {
+            text: 'old',
+            seq: 3
+        })); // out of order
+        (_capture_init3 = capture.init) === null || _capture_init3 === void 0 ? void 0 : (_capture_init_onmessage3 = _capture_init3.onmessage) === null || _capture_init_onmessage3 === void 0 ? void 0 : _capture_init_onmessage3.call(_capture_init3, msg('text.appended', {
+            text: 'b',
+            seq: 6
+        })); // newer
+        expect(onText).toHaveBeenCalledTimes(2);
+        expect(onText.mock.calls[0][0]).toEqual({
+            text: 'a',
+            seq: 5
+        });
+        expect(onText.mock.calls[1][0]).toEqual({
+            text: 'b',
+            seq: 6
+        });
+    });
+});
+
+//# sourceMappingURL=chat-sse-client.test.js.map

package/dist/streaming/__tests__/chat-sse-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/streaming/__tests__/chat-sse-client.test.ts"],"sourcesContent":["import { beforeEach, describe, expect, jest, test } from '@jest/globals';\nimport { type EventSourceMessage, fetchEventSource } from '@microsoft/fetch-event-source';\nimport { ChatSseClient } from '../chat-sse-client';\n\njest.mock('@microsoft/fetch-event-source');\n\nconst fetchEventSourceMock = fetchEventSource as jest.MockedFunction<typeof fetchEventSource>;\n\n/** Capture the init passed to fetchEventSource so tests can drive its callbacks. */\nfunction captureInit() {\n    const capture: { init?: Parameters<typeof fetchEventSource>[1]; url?: any } = {};\n    fetchEventSourceMock.mockImplementation((url, init) => {\n        capture.url = url;\n        capture.init = init;\n        return Promise.resolve();\n    });\n    return capture;\n}\n\nconst msg = (event: string, data: unknown): EventSourceMessage => ({\n    id: '',\n    event,\n    data: typeof data === 'string' ? data : JSON.stringify(data),\n});\n\ndescribe('ChatSseClient — open / decode / dispatch / seq / registry', () => {\n    beforeEach(() => {\n        fetchEventSourceMock.mockReset();\n    });\n\n    test('opens a POST stream with body, headers and event-stream Accept', async () => {\n        const capture = captureInit();\n\n        await new ChatSseClient({\n            url: 'https://api.test/api/v2/message/stream',\n            body: { question: 'hi', sessionId: 7 },\n            headers: { 'Authorization': 'Bearer t', 'X-Client-ID': 'help-center' },\n        }).start();\n\n        expect(capture.url).toBe('https://api.test/api/v2/message/stream');\n        expect(capture.init?.method).toBe('POST');\n        expect(capture.init?.body).toBe(JSON.stringify({ question: 'hi', sessionId: 7 }));\n        expect(capture.init?.headers).toMatchObject({\n            'Accept': 'text/event-stream',\n            'Content-Type': 'application/json',\n            'Authorization': 'Bearer t',\n            'X-Client-ID': 'help-center',\n        });\n    });\n\n    test('JSON-decodes data and dispatches to the registered handler with seq', async () => {\n        const capture = captureInit();\n        const onStatus = jest.fn();\n\n        const client = new ChatSseClient({\n            url: 'u',\n            handlers: { 'status.changed': onStatus },\n        });\n        await client.start();\n\n        capture.init?.onmessage?.(msg('status.changed', { text: 'Thinking…', seq: 2 }));\n\n        expect(onStatus).toHaveBeenCalledTimes(1);\n        const [data, event] = onStatus.mock.calls[0] as any[];\n        expect(data).toEqual({ text: 'Thinking…', seq: 2 });\n        expect(event).toEqual({\n            event: 'status.changed',\n            data: { text: 'Thinking…', seq: 2 },\n            seq: 2,\n        });\n    });\n\n    test('handlers registered via on() receive matching events; consumer can extend new types', async () => {\n        const capture = captureInit();\n        const onCustom = jest.fn();\n\n        const client = new ChatSseClient({ url: 'u' });\n        client.on('custom.future-event', onCustom);\n        await client.start();\n\n        capture.init?.onmessage?.(msg('custom.future-event', { foo: 1, seq: 1 }));\n\n        expect(onCustom).toHaveBeenCalledTimes(1);\n        expect((onCustom.mock.calls[0] as any[])[0]).toEqual({ foo: 1, seq: 1 });\n    });\n\n    test('unknown event with no handler is ignored without closing; onEvent still fires', async () => {\n        const capture = captureInit();\n        const onEvent = jest.fn();\n        const onError = jest.fn();\n\n        const client = new ChatSseClient({ url: 'u', onEvent, onError });\n        await client.start();\n\n        expect(() => capture.init?.onmessage?.(msg('totally.unknown', { seq: 1 }))).not.toThrow();\n\n        expect(onError).not.toHaveBeenCalled();\n        expect(onEvent).toHaveBeenCalledTimes(1);\n        expect((onEvent.mock.calls[0] as any[])[0]).toMatchObject({\n            event: 'totally.unknown',\n            seq: 1,\n        });\n    });\n\n    test('ignores null / non-object JSON payloads without throwing or dispatching', async () => {\n        const capture = captureInit();\n        const onText = jest.fn();\n        const onEvent = jest.fn();\n        const onError = jest.fn();\n\n        const client = new ChatSseClient({\n            url: 'u',\n            handlers: { 'text.appended': onText },\n            onEvent,\n            onError,\n        });\n        await client.start();\n\n        // `JSON.parse` yields a value that has no `seq`; accessing `.seq` on `null` would throw.\n        expect(() => capture.init?.onmessage?.(msg('text.appended', null))).not.toThrow();\n        expect(() => capture.init?.onmessage?.(msg('text.appended', '42'))).not.toThrow();\n        expect(() => capture.init?.onmessage?.(msg('text.appended', '\"hi\"'))).not.toThrow();\n        // Unparseable data is likewise skipped.\n        expect(() => capture.init?.onmessage?.(msg('text.appended', 'not json'))).not.toThrow();\n\n        expect(onText).not.toHaveBeenCalled();\n        expect(onEvent).not.toHaveBeenCalled();\n        expect(onError).not.toHaveBeenCalled();\n\n        // A valid event after the bad ones is still processed (the stream is not wedged).\n        capture.init?.onmessage?.(msg('text.appended', { text: 'a', seq: 1 }));\n        expect(onText).toHaveBeenCalledTimes(1);\n        expect((onText.mock.calls[0] as any[])[0]).toEqual({ text: 'a', seq: 1 });\n    });\n\n    test('discards events whose seq is not greater than the last processed seq', async () => {\n        const capture = captureInit();\n        const onText = jest.fn();\n\n        const client = new ChatSseClient({ url: 'u', handlers: { 'text.appended': onText } });\n        await client.start();\n\n        capture.init?.onmessage?.(msg('text.appended', { text: 'a', seq: 5 }));\n        capture.init?.onmessage?.(msg('text.appended', { text: 'dup', seq: 5 })); // duplicate\n        capture.init?.onmessage?.(msg('text.appended', { text: 'old', seq: 3 })); // out of order\n        capture.init?.onmessage?.(msg('text.appended', { text: 'b', seq: 6 })); // newer\n\n        expect(onText).toHaveBeenCalledTimes(2);\n        expect((onText.mock.calls[0] as any[])[0]).toEqual({ text: 'a', seq: 5 });\n        expect((onText.mock.calls[1] as any[])[0]).toEqual({ text: 'b', seq: 6 });\n    });\n});\n"],"names":["beforeEach","describe","expect","jest","test","fetchEventSource","ChatSseClient","mock","fetchEventSourceMock","captureInit","capture","mockImplementation","url","init","Promise","resolve","msg","event","data","id","JSON","stringify","mockReset","body","question","sessionId","headers","start","toBe","method","toMatchObject","onStatus","fn","client","handlers","onmessage","text","seq","toHaveBeenCalledTimes","calls","toEqual","onCustom","on","foo","onEvent","onError","not","toThrow","toHaveBeenCalled","onText"],"mappings":"AAAA,SAASA,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,IAAI,EAAEC,IAAI,QAAQ,gBAAgB;AACzE,SAAkCC,gBAAgB,QAAQ,gCAAgC;AAC1F,SAASC,aAAa,QAAQ,qBAAqB;AAEnDH,KAAKI,IAAI,CAAC;AAEV,MAAMC,uBAAuBH;AAE7B,kFAAkF,GAClF,SAASI;IACL,MAAMC,UAAwE,CAAC;IAC/EF,qBAAqBG,kBAAkB,CAAC,CAACC,KAAKC;QAC1CH,QAAQE,GAAG,GAAGA;QACdF,QAAQG,IAAI,GAAGA;QACf,OAAOC,QAAQC,OAAO;IAC1B;IACA,OAAOL;AACX;AAEA,MAAMM,MAAM,CAACC,OAAeC,OAAuC,CAAA;QAC/DC,IAAI;QACJF;QACAC,MAAM,OAAOA,SAAS,WAAWA,OAAOE,KAAKC,SAAS,CAACH;IAC3D,CAAA;AAEAjB,SAAS,6DAA6D;IAClED,WAAW;QACPQ,qBAAqBc,SAAS;IAClC;IAEAlB,KAAK,kEAAkE;YAU5DM,eACAA,gBACAA;QAXP,MAAMA,UAAUD;QAEhB,MAAM,IAAIH,cAAc;YACpBM,KAAK;YACLW,MAAM;gBAAEC,UAAU;gBAAMC,WAAW;YAAE;YACrCC,SAAS;gBAAE,iBAAiB;gBAAY,eAAe;YAAc;QACzE,GAAGC,KAAK;QAERzB,OAAOQ,QAAQE,GAAG,EAAEgB,IAAI,CAAC;QACzB1B,QAAOQ,gBAAAA,QAAQG,IAAI,cAAZH,oCAAAA,cAAcmB,MAAM,EAAED,IAAI,CAAC;QAClC1B,QAAOQ,iBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,eAAca,IAAI,EAAEK,IAAI,CAACR,KAAKC,SAAS,CAAC;YAAEG,UAAU;YAAMC,WAAW;QAAE;QAC9EvB,QAAOQ,iBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,eAAcgB,OAAO,EAAEI,aAAa,CAAC;YACxC,UAAU;YACV,gBAAgB;YAChB,iBAAiB;YACjB,eAAe;QACnB;IACJ;IAEA1B,KAAK,uEAAuE;YAUxEM,yBAAAA;QATA,MAAMA,UAAUD;QAChB,MAAMsB,WAAW5B,KAAK6B,EAAE;QAExB,MAAMC,SAAS,IAAI3B,cAAc;YAC7BM,KAAK;YACLsB,UAAU;gBAAE,kBAAkBH;YAAS;QAC3C;QACA,MAAME,OAAON,KAAK;SAElBjB,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,kBAAkB;YAAEoB,MAAM;YAAaC,KAAK;QAAE;QAE5EnC,OAAO6B,UAAUO,qBAAqB,CAAC;QACvC,MAAM,CAACpB,MAAMD,MAAM,GAAGc,SAASxB,IAAI,CAACgC,KAAK,CAAC,EAAE;QAC5CrC,OAAOgB,MAAMsB,OAAO,CAAC;YAAEJ,MAAM;YAAaC,KAAK;QAAE;QACjDnC,OAAOe,OAAOuB,OAAO,CAAC;YAClBvB,OAAO;YACPC,MAAM;gBAAEkB,MAAM;gBAAaC,KAAK;YAAE;YAClCA,KAAK;QACT;IACJ;IAEAjC,KAAK,uFAAuF;YAQxFM,yBAAAA;QAPA,MAAMA,UAAUD;QAChB,MAAMgC,WAAWtC,KAAK6B,EAAE;QAExB,MAAMC,SAAS,IAAI3B,cAAc;YAAEM,KAAK;QAAI;QAC5CqB,OAAOS,EAAE,CAAC,uBAAuBD;QACjC,MAAMR,OAAON,KAAK;SAElBjB,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,uBAAuB;YAAE2B,KAAK;YAAGN,KAAK;QAAE;QAEtEnC,OAAOuC,UAAUH,qBAAqB,CAAC;QACvCpC,OAAO,AAACuC,SAASlC,IAAI,CAACgC,KAAK,CAAC,EAAE,AAAU,CAAC,EAAE,EAAEC,OAAO,CAAC;YAAEG,KAAK;YAAGN,KAAK;QAAE;IAC1E;IAEAjC,KAAK,iFAAiF;QAClF,MAAMM,UAAUD;QAChB,MAAMmC,UAAUzC,KAAK6B,EAAE;QACvB,MAAMa,UAAU1C,KAAK6B,EAAE;QAEvB,MAAMC,SAAS,IAAI3B,cAAc;YAAEM,KAAK;YAAKgC;YAASC;QAAQ;QAC9D,MAAMZ,OAAON,KAAK;QAElBzB,OAAO;gBAAMQ,yBAAAA;oBAAAA,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,mBAAmB;gBAAEqB,KAAK;YAAE;WAAKS,GAAG,CAACC,OAAO;QAEvF7C,OAAO2C,SAASC,GAAG,CAACE,gBAAgB;QACpC9C,OAAO0C,SAASN,qBAAqB,CAAC;QACtCpC,OAAO,AAAC0C,QAAQrC,IAAI,CAACgC,KAAK,CAAC,EAAE,AAAU,CAAC,EAAE,EAAET,aAAa,CAAC;YACtDb,OAAO;YACPoB,KAAK;QACT;IACJ;IAEAjC,KAAK,2EAA2E;YAyB5E,kFAAkF;QAClFM,yBAAAA;QAzBA,MAAMA,UAAUD;QAChB,MAAMwC,SAAS9C,KAAK6B,EAAE;QACtB,MAAMY,UAAUzC,KAAK6B,EAAE;QACvB,MAAMa,UAAU1C,KAAK6B,EAAE;QAEvB,MAAMC,SAAS,IAAI3B,cAAc;YAC7BM,KAAK;YACLsB,UAAU;gBAAE,iBAAiBe;YAAO;YACpCL;YACAC;QACJ;QACA,MAAMZ,OAAON,KAAK;QAElB,yFAAyF;QACzFzB,OAAO;gBAAMQ,yBAAAA;oBAAAA,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,iBAAiB;WAAQ8B,GAAG,CAACC,OAAO;QAC/E7C,OAAO;gBAAMQ,yBAAAA;oBAAAA,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,iBAAiB;WAAQ8B,GAAG,CAACC,OAAO;QAC/E7C,OAAO;gBAAMQ,yBAAAA;oBAAAA,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,iBAAiB;WAAU8B,GAAG,CAACC,OAAO;QACjF,wCAAwC;QACxC7C,OAAO;gBAAMQ,yBAAAA;oBAAAA,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,iBAAiB;WAAc8B,GAAG,CAACC,OAAO;QAErF7C,OAAO+C,QAAQH,GAAG,CAACE,gBAAgB;QACnC9C,OAAO0C,SAASE,GAAG,CAACE,gBAAgB;QACpC9C,OAAO2C,SAASC,GAAG,CAACE,gBAAgB;SAGpCtC,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,iBAAiB;YAAEoB,MAAM;YAAKC,KAAK;QAAE;QACnEnC,OAAO+C,QAAQX,qBAAqB,CAAC;QACrCpC,OAAO,AAAC+C,OAAO1C,IAAI,CAACgC,KAAK,CAAC,EAAE,AAAU,CAAC,EAAE,EAAEC,OAAO,CAAC;YAAEJ,MAAM;YAAKC,KAAK;QAAE;IAC3E;IAEAjC,KAAK,wEAAwE;YAOzEM,yBAAAA,eACAA,0BAAAA,gBACAA,0BAAAA,gBACAA,0BAAAA;QATA,MAAMA,UAAUD;QAChB,MAAMwC,SAAS9C,KAAK6B,EAAE;QAEtB,MAAMC,SAAS,IAAI3B,cAAc;YAAEM,KAAK;YAAKsB,UAAU;gBAAE,iBAAiBe;YAAO;QAAE;QACnF,MAAMhB,OAAON,KAAK;SAElBjB,gBAAAA,QAAQG,IAAI,cAAZH,qCAAAA,0BAAAA,cAAcyB,SAAS,cAAvBzB,8CAAAA,6BAAAA,eAA0BM,IAAI,iBAAiB;YAAEoB,MAAM;YAAKC,KAAK;QAAE;SACnE3B,iBAAAA,QAAQG,IAAI,cAAZH,sCAAAA,2BAAAA,eAAcyB,SAAS,cAAvBzB,+CAAAA,8BAAAA,gBAA0BM,IAAI,iBAAiB;YAAEoB,MAAM;YAAOC,KAAK;QAAE,KAAK,YAAY;SACtF3B,iBAAAA,QAAQG,IAAI,cAAZH,sCAAAA,2BAAAA,eAAcyB,SAAS,cAAvBzB,+CAAAA,8BAAAA,gBAA0BM,IAAI,iBAAiB;YAAEoB,MAAM;YAAOC,KAAK;QAAE,KAAK,eAAe;SACzF3B,iBAAAA,QAAQG,IAAI,cAAZH,sCAAAA,2BAAAA,eAAcyB,SAAS,cAAvBzB,+CAAAA,8BAAAA,gBAA0BM,IAAI,iBAAiB;YAAEoB,MAAM;YAAKC,KAAK;QAAE,KAAK,QAAQ;QAEhFnC,OAAO+C,QAAQX,qBAAqB,CAAC;QACrCpC,OAAO,AAAC+C,OAAO1C,IAAI,CAACgC,KAAK,CAAC,EAAE,AAAU,CAAC,EAAE,EAAEC,OAAO,CAAC;YAAEJ,MAAM;YAAKC,KAAK;QAAE;QACvEnC,OAAO,AAAC+C,OAAO1C,IAAI,CAACgC,KAAK,CAAC,EAAE,AAAU,CAAC,EAAE,EAAEC,OAAO,CAAC;YAAEJ,MAAM;YAAKC,KAAK;QAAE;IAC3E;AACJ"}

package/dist/streaming/__tests__/mock-wiring.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mock-wiring.test.d.ts.map

package/dist/streaming/__tests__/mock-wiring.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-wiring.test.d.ts","sourceRoot":"","sources":["../../../src/streaming/__tests__/mock-wiring.test.ts"],"names":[],"mappings":""}

package/dist/streaming/__tests__/mock-wiring.test.js

@@ -0,0 +1,20 @@
+import { beforeEach, describe, expect, jest, test } from '@jest/globals';
+import { fetchEventSource } from '@microsoft/fetch-event-source';
+jest.mock('@microsoft/fetch-event-source');
+const fetchEventSourceMock = fetchEventSource;
+/**
+ * Task 1.2 — proves the test harness can mock `@microsoft/fetch-event-source`
+ * before the real streaming-client work begins. This is intentionally trivial.
+ */ describe('fetch-event-source mock wiring', ()=>{
+    beforeEach(()=>{
+        fetchEventSourceMock.mockReset();
+    });
+    test('fetchEventSource is mockable and observable', async ()=>{
+        fetchEventSourceMock.mockResolvedValue(undefined);
+        await fetchEventSource('https://example.test/stream', {});
+        expect(fetchEventSourceMock).toHaveBeenCalledTimes(1);
+        expect(fetchEventSourceMock).toHaveBeenCalledWith('https://example.test/stream', {});
+    });
+});
+
+//# sourceMappingURL=mock-wiring.test.js.map

package/dist/streaming/__tests__/mock-wiring.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/streaming/__tests__/mock-wiring.test.ts"],"sourcesContent":["import { beforeEach, describe, expect, jest, test } from '@jest/globals';\nimport { fetchEventSource } from '@microsoft/fetch-event-source';\n\njest.mock('@microsoft/fetch-event-source');\n\nconst fetchEventSourceMock = fetchEventSource as jest.MockedFunction<typeof fetchEventSource>;\n\n/**\n * Task 1.2 — proves the test harness can mock `@microsoft/fetch-event-source`\n * before the real streaming-client work begins. This is intentionally trivial.\n */\ndescribe('fetch-event-source mock wiring', () => {\n    beforeEach(() => {\n        fetchEventSourceMock.mockReset();\n    });\n\n    test('fetchEventSource is mockable and observable', async () => {\n        fetchEventSourceMock.mockResolvedValue(undefined);\n\n        await fetchEventSource('https://example.test/stream', {});\n\n        expect(fetchEventSourceMock).toHaveBeenCalledTimes(1);\n        expect(fetchEventSourceMock).toHaveBeenCalledWith('https://example.test/stream', {});\n    });\n});\n"],"names":["beforeEach","describe","expect","jest","test","fetchEventSource","mock","fetchEventSourceMock","mockReset","mockResolvedValue","undefined","toHaveBeenCalledTimes","toHaveBeenCalledWith"],"mappings":"AAAA,SAASA,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,IAAI,EAAEC,IAAI,QAAQ,gBAAgB;AACzE,SAASC,gBAAgB,QAAQ,gCAAgC;AAEjEF,KAAKG,IAAI,CAAC;AAEV,MAAMC,uBAAuBF;AAE7B;;;CAGC,GACDJ,SAAS,kCAAkC;IACvCD,WAAW;QACPO,qBAAqBC,SAAS;IAClC;IAEAJ,KAAK,+CAA+C;QAChDG,qBAAqBE,iBAAiB,CAACC;QAEvC,MAAML,iBAAiB,+BAA+B,CAAC;QAEvDH,OAAOK,sBAAsBI,qBAAqB,CAAC;QACnDT,OAAOK,sBAAsBK,oBAAoB,CAAC,+BAA+B,CAAC;IACtF;AACJ"}

package/dist/streaming/__tests__/streaming-progress.model.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=streaming-progress.model.test.d.ts.map

package/dist/streaming/__tests__/streaming-progress.model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-progress.model.test.d.ts","sourceRoot":"","sources":["../../../src/streaming/__tests__/streaming-progress.model.test.ts"],"names":[],"mappings":""}