@servicetitan/journey 2.0.0 → 2.1.0

package/src/__tests__/{registry.test.ts → core/api.test.ts}

@@ -1,26 +1,29 @@
 /** @jest-environment jsdom */
-import { baseJourneyDef, lastJourney, useJourneyTestRuntime } from '../__mocks__/test-runtime';
+import {
+    baseJourneyDef,
+    lastJourney,
+    useJourneyTestRuntime,
+} from '../../__test-utils__/test-runtime';
 import {
     completeJourney,
     excludeJourney,
     failJourney,
-    firstOpenJourney,
     journeyStep,
     setJourneyTags,
-    startJourney,
-} from '../core';
+} from '../../core';
+import { moduleRuntime } from '../../core/runtime';
 
 const emitMock = jest.fn();
-const baseDef = { ...baseJourneyDef, name: 'registry-api' };
-const otherDef = { ...baseJourneyDef, name: 'registry-other' };
+const baseDef = { ...baseJourneyDef, name: 'api-lifecycle' };
+const otherDef = { ...baseJourneyDef, name: 'api-other' };
 
-describe('[journey] registry', () => {
+describe('[journey] api', () => {
     useJourneyTestRuntime(emitMock);
 
     describe('firstOpenJourney', () => {
         const names = [baseDef.name, otherDef.name];
 
-        const subject = () => firstOpenJourney(names);
+        const subject = () => moduleRuntime.firstOpenJourney(names);
 
         describe('when none are open', () => {
             test('returns null', () => {
@@ -30,7 +33,7 @@ describe('[journey] registry', () => {
 
         describe('when only the second name is open', () => {
             beforeEach(() => {
-                startJourney(otherDef);
+                moduleRuntime.startJourney(otherDef);
             });
 
             test('returns that name', () => {
@@ -40,13 +43,15 @@ describe('[journey] registry', () => {
 
         describe('when both are open', () => {
             beforeEach(() => {
-                startJourney(otherDef);
-                startJourney(baseDef);
+                moduleRuntime.startJourney(otherDef);
+                moduleRuntime.startJourney(baseDef);
             });
 
             test('returns the first match in order', () => {
                 expect(subject()).toBe(baseDef.name);
-                expect(firstOpenJourney([otherDef.name, baseDef.name])).toBe(otherDef.name);
+                expect(moduleRuntime.firstOpenJourney([otherDef.name, baseDef.name])).toBe(
+                    otherDef.name
+                );
             });
         });
     });
@@ -54,7 +59,7 @@ describe('[journey] registry', () => {
     describe('completeJourney', () => {
         describe('with tags', () => {
             beforeEach(() => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
             });
 
             const subject = () => completeJourney(baseDef.name, { 'lead.id': 7 });
@@ -78,7 +83,7 @@ describe('[journey] registry', () => {
 
         describe('when already closed', () => {
             beforeEach(async () => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
                 await journeyStep(baseDef.name, 'do-work', step => {
                     step.complete();
                 });
@@ -95,7 +100,7 @@ describe('[journey] registry', () => {
 
         describe('after a fail', () => {
             beforeEach(async () => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
                 await journeyStep(baseDef.name, 'do-work', step => {
                     step.fail('validation');
                 });
@@ -115,10 +120,10 @@ describe('[journey] registry', () => {
     describe('startJourney', () => {
         describe('when restarting the same name', () => {
             beforeEach(() => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
             });
 
-            const subject = () => startJourney(baseDef);
+            const subject = () => moduleRuntime.startJourney(baseDef);
 
             test('excludes the prior open journey', () => {
                 subject();
@@ -129,13 +134,13 @@ describe('[journey] registry', () => {
 
         describe('when restarting after a bad close', () => {
             beforeEach(async () => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
                 await journeyStep(baseDef.name, 'do-work', step => {
                     step.fail('validation');
                 });
             });
 
-            const subject = () => startJourney(baseDef);
+            const subject = () => moduleRuntime.startJourney(baseDef);
 
             test('opens fresh without a second exclude', () => {
                 subject();
@@ -148,7 +153,7 @@ describe('[journey] registry', () => {
 
         describe('with static def tags', () => {
             const subject = () => {
-                startJourney({ ...baseDef, tags: { plan: 'pro' } });
+                moduleRuntime.startJourney({ ...baseDef, tags: { plan: 'pro' } });
                 completeJourney(baseDef.name, { 'job.id': 5 });
             };
 
@@ -162,7 +167,7 @@ describe('[journey] registry', () => {
 
     describe('failJourney', () => {
         beforeEach(() => {
-            startJourney(baseDef);
+            moduleRuntime.startJourney(baseDef);
         });
 
         const subject = () => failJourney(baseDef.name, 'manual-bad');
@@ -188,7 +193,7 @@ describe('[journey] registry', () => {
     describe('excludeJourney', () => {
         describe('with a clean journey', () => {
             beforeEach(() => {
-                startJourney(otherDef);
+                moduleRuntime.startJourney(otherDef);
             });
 
             const subject = () => excludeJourney(otherDef.name);
@@ -202,7 +207,7 @@ describe('[journey] registry', () => {
 
         describe('after a breach', () => {
             beforeEach(async () => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
                 await journeyStep(baseDef.name, 'do-work', step => {
                     step.fail('validation');
                 });
@@ -221,7 +226,7 @@ describe('[journey] registry', () => {
         describe('when past the journey budget', () => {
             beforeEach(() => {
                 jest.spyOn(globalThis.performance, 'now').mockReturnValue(1_000);
-                startJourney({ ...baseDef, timeoutMs: 50 });
+                moduleRuntime.startJourney({ ...baseDef, timeoutMs: 50 });
                 (globalThis.performance.now as jest.Mock).mockReturnValue(1_100);
             });
 
@@ -251,7 +256,7 @@ describe('[journey] registry', () => {
 
         describe('with a closed journey', () => {
             beforeEach(() => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
                 completeJourney(baseDef.name);
             });
 

package/src/__tests__/{define-journey.test.ts → core/define-journey.test.ts}

@@ -1,6 +1,7 @@
 /** @jest-environment jsdom */
-import { lastJourney, useJourneyTestRuntime } from '../__mocks__/test-runtime';
-import { defineJourney, journeyStep, startJourney } from '../core';
+import { lastJourney, useJourneyTestRuntime } from '../../__test-utils__/test-runtime';
+import { defineJourney, journeyStep } from '../../core';
+import { moduleRuntime } from '../../core/runtime';
 
 const emitMock = jest.fn();
 
@@ -51,7 +52,7 @@ describe('[journey] defineJourney', () => {
 
     describe('when a JourneyScope already opened the journey', () => {
         beforeEach(() => {
-            startJourney(base);
+            moduleRuntime.startJourney(base);
         });
 
         const subject = () =>
@@ -147,7 +148,7 @@ describe('[journey] defineJourney', () => {
 
     describe('when mountStep runs under an already-open journey', () => {
         beforeEach(() => {
-            startJourney(base);
+            moduleRuntime.startJourney(base);
         });
 
         const subject = () =>

package/src/__tests__/{requests.test.ts → core/requests.test.ts}

@@ -1,15 +1,19 @@
 /** @jest-environment jsdom */
-import { baseJourneyDef, lastJourney, useJourneyTestRuntime } from '../__mocks__/test-runtime';
-import { configureJourney } from '../config';
+import {
+    baseJourneyDef,
+    lastJourney,
+    useJourneyTestRuntime,
+} from '../../__test-utils__/test-runtime';
+import { configureJourney } from '../../config';
 import {
     completeJourney,
     journeyStep,
     reportBackendRequest,
     resolveJourneyStep,
-    startJourney,
     type JourneyDef,
     type JourneyStepRef,
-} from '../core';
+} from '../../core';
+import { moduleRuntime } from '../../core/runtime';
 
 const emitMock = jest.fn();
 const baseDef = { ...baseJourneyDef, name: 'requests-journey' };
@@ -35,7 +39,7 @@ describe('[journey] reportBackendRequest', () => {
         run: (ref: JourneyStepRef) => void | Promise<void>,
         def: JourneyDef = { ...baseDef, requestTimeoutMs: 5_000 }
     ) {
-        startJourney(def);
+        moduleRuntime.startJourney(def);
         await journeyStep(baseDef.name, 'do-work', async step => {
             stepRef = resolveJourneyStep((step.tag() as { journeyStep: unknown }).journeyStep);
             await run(stepRef!);
@@ -168,7 +172,7 @@ describe('[journey] reportBackendRequest', () => {
 
     describe('when a journey endpoint timeoutMs is 0', () => {
         test('falls through to the journey requestTimeoutMs', async () => {
-            startJourney({
+            moduleRuntime.startJourney({
                 ...baseDef,
                 requestTimeoutMs: 30,
                 endpoints: [{ match: '/special', timeoutMs: 0 }],
@@ -281,7 +285,7 @@ describe('[journey] reportBackendRequest', () => {
         });
 
         test('falls through to defaultMs', async () => {
-            startJourney(baseDef);
+            moduleRuntime.startJourney(baseDef);
 
             await journeyStep(baseDef.name, 'do-work', step => {
                 stepRef = resolveJourneyStep((step.tag() as { journeyStep: unknown }).journeyStep);
@@ -301,7 +305,7 @@ describe('[journey] reportBackendRequest', () => {
         });
 
         test('uses the app defaultMs', async () => {
-            startJourney(baseDef);
+            moduleRuntime.startJourney(baseDef);
 
             await journeyStep(baseDef.name, 'do-work', step => {
                 stepRef = resolveJourneyStep((step.tag() as { journeyStep: unknown }).journeyStep);

package/src/__tests__/{runtime.test.ts → core/runtime.test.ts}

@@ -1,18 +1,18 @@
 /** @jest-environment jsdom */
-import { lastJourney, useJourneyTestRuntime } from '../__mocks__/test-runtime';
-import { configureJourney, getRequestTimeouts } from '../config';
+import { lastJourney, useJourneyTestRuntime } from '../../__test-utils__/test-runtime';
+import { configureJourney, getRequestTimeouts } from '../../config';
 import {
     activeJourneyStep,
     completeJourney,
-    createJourneyRuntime,
     defineJourney,
     journeyStep,
     resetJourney,
-    startJourney,
-} from '../core';
-import { sendToDatadog } from '../sinks/datadog';
+} from '../../core';
+import { createJourneyRuntime, moduleRuntime } from '../../core/runtime';
+import { sendToConsole } from '../../sinks/console';
+import { sendToDatadog } from '../../sinks/datadog';
 
-jest.mock('../sinks/datadog', () => ({
+jest.mock('../../sinks/datadog', () => ({
     sendToDatadog: jest.fn(),
 }));
 
@@ -31,7 +31,7 @@ describe('[journey] resetJourney', () => {
 
     describe('when a journey is open', () => {
         beforeEach(() => {
-            startJourney(def);
+            moduleRuntime.startJourney(def);
         });
 
         const subject = () => resetJourney({ sinks: [emitMock] });
@@ -82,7 +82,7 @@ describe('[journey] resetJourney', () => {
         beforeEach(() => {
             resetJourney({ sinks: [emitMock] });
             emitMock.mockClear();
-            startJourney(def);
+            moduleRuntime.startJourney(def);
             completeJourney(def.name);
             emitMock.mockClear();
         });
@@ -91,7 +91,7 @@ describe('[journey] resetJourney', () => {
 
         test('leaves sinks empty', () => {
             subject();
-            startJourney(def);
+            moduleRuntime.startJourney(def);
             completeJourney(def.name);
 
             expect(emitMock).not.toHaveBeenCalled();
@@ -103,7 +103,7 @@ describe('[journey] resetJourney', () => {
         let stepPromise: Promise<unknown>;
 
         beforeEach(() => {
-            startJourney(def);
+            moduleRuntime.startJourney(def);
             const hang = new Promise<void>(resolve => {
                 resolveWork = resolve;
             });
@@ -131,7 +131,7 @@ describe('[journey] resetJourney', () => {
     describe('when a journey countdown is armed', () => {
         beforeEach(() => {
             jest.useFakeTimers();
-            startJourney({ ...def, timeoutMs: 50 });
+            moduleRuntime.startJourney({ ...def, timeoutMs: 50 });
         });
 
         afterEach(() => {
@@ -168,7 +168,7 @@ describe('[journey] createJourneyRuntime', () => {
 
     afterEach(() => {
         resetJourney({
-            sinks: [sendToDatadog],
+            sinks: [sendToDatadog, sendToConsole],
             requestTimeouts: { defaultMs: 4_000, endpoints: [] },
         });
     });
@@ -176,7 +176,7 @@ describe('[journey] createJourneyRuntime', () => {
     describe('when both runtimes open a journey', () => {
         beforeEach(() => {
             runtime.startJourney(def);
-            startJourney({ ...def, name: 'default-side' });
+            moduleRuntime.startJourney({ ...def, name: 'default-side' });
         });
 
         const subject = () => {
@@ -201,7 +201,7 @@ describe('[journey] createJourneyRuntime', () => {
             configureJourney({ requestTimeouts: { defaultMs: 9_000, endpoints: [] } });
         });
 
-        test('keeps timeouts separate from the default engine', () => {
+        test('keeps timeouts separate from the module engine', () => {
             expect(runtime.getRequestTimeouts().defaultMs).toBe(10);
             expect(getRequestTimeouts().defaultMs).toBe(9_000);
         });
@@ -210,12 +210,12 @@ describe('[journey] createJourneyRuntime', () => {
     describe('when the isolated runtime is reset', () => {
         beforeEach(() => {
             runtime.startJourney(def);
-            startJourney({ ...def, name: 'default-side' });
+            moduleRuntime.startJourney({ ...def, name: 'default-side' });
         });
 
         const subject = () => runtime.reset({ sinks: [isolatedEmit] });
 
-        test('does not clear the default engine', () => {
+        test('does not clear the module engine', () => {
             subject();
             completeJourney('default-side');
 
@@ -230,7 +230,7 @@ describe('[journey] createJourneyRuntime', () => {
                 step.complete();
             });
 
-        test('binds to the default runtime', async () => {
+        test('binds to the module runtime', async () => {
             await subject();
 
             expect(defaultEmit).toHaveBeenCalledTimes(1);

package/src/__tests__/{step.test.ts → core/step.test.ts}

@@ -1,13 +1,11 @@
 /** @jest-environment jsdom */
-import { baseJourneyDef, lastJourney, useJourneyTestRuntime } from '../__mocks__/test-runtime';
 import {
-    completeJourney,
-    failJourney,
-    journeyMountStep,
-    journeyStep,
-    resolveJourneyStep,
-    startJourney,
-} from '../core';
+    baseJourneyDef,
+    lastJourney,
+    useJourneyTestRuntime,
+} from '../../__test-utils__/test-runtime';
+import { completeJourney, failJourney, journeyStep, resolveJourneyStep } from '../../core';
+import { moduleRuntime } from '../../core/runtime';
 
 const emitMock = jest.fn();
 const baseDef = { ...baseJourneyDef, name: 'step-api' };
@@ -18,7 +16,7 @@ describe('[journey] journeyStep', () => {
 
     describe('with a candidate list', () => {
         beforeEach(() => {
-            startJourney(baseDef);
+            moduleRuntime.startJourney(baseDef);
         });
 
         const subject = () => journeyStep(['missing', baseDef.name], 'do-work', step => step.name);
@@ -30,8 +28,8 @@ describe('[journey] journeyStep', () => {
 
     describe('with multiple open candidates', () => {
         beforeEach(() => {
-            startJourney(otherDef);
-            startJourney(baseDef);
+            moduleRuntime.startJourney(otherDef);
+            moduleRuntime.startJourney(baseDef);
         });
 
         const subject = () =>
@@ -67,7 +65,7 @@ describe('[journey] journeyStep', () => {
 
     describe('with an open journey', () => {
         beforeEach(() => {
-            startJourney(baseDef);
+            moduleRuntime.startJourney(baseDef);
         });
 
         describe('when the step completes with tags', () => {
@@ -186,7 +184,7 @@ describe('[journey] journeyStep', () => {
             beforeEach(() => {
                 // Parent already opened baseDef; restart with expected steps.
                 emitMock.mockClear();
-                startJourney({ ...baseDef, steps: ['load', 'save'] });
+                moduleRuntime.startJourney({ ...baseDef, steps: ['load', 'save'] });
                 emitMock.mockClear();
             });
 
@@ -238,11 +236,11 @@ describe('[journey] journeyStep', () => {
     describe('journeyMountStep', () => {
         describe('with candidates', () => {
             beforeEach(() => {
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
             });
 
             const subject = () =>
-                journeyMountStep(['missing', baseDef.name], 'mount-load', step => {
+                moduleRuntime.journeyMountStep(['missing', baseDef.name], 'mount-load', step => {
                     step.complete();
                     return step.name;
                 });
@@ -260,10 +258,10 @@ describe('[journey] journeyStep', () => {
             });
 
             test('defers until after a sync startJourney', async () => {
-                const mount = journeyMountStep(baseDef.name, 'boot', () => {
+                const mount = moduleRuntime.journeyMountStep(baseDef.name, 'boot', () => {
                     order.push('mount-step');
                 });
-                startJourney(baseDef);
+                moduleRuntime.startJourney(baseDef);
                 order.push('started');
                 await mount;
                 completeJourney(baseDef.name);
@@ -276,7 +274,7 @@ describe('[journey] journeyStep', () => {
     describe('when fail-fast happens mid-step', () => {
         beforeEach(() => {
             jest.spyOn(globalThis.performance, 'now').mockReturnValue(1_000);
-            startJourney(baseDef);
+            moduleRuntime.startJourney(baseDef);
         });
 
         afterEach(() => {

package/src/__tests__/{timeouts.test.ts → core/timeouts.test.ts}

@@ -1,6 +1,11 @@
 /** @jest-environment jsdom */
-import { baseJourneyDef, lastJourney, useJourneyTestRuntime } from '../__mocks__/test-runtime';
-import { completeJourney, journeyStep, resolveJourneyStep, startJourney } from '../core';
+import {
+    baseJourneyDef,
+    lastJourney,
+    useJourneyTestRuntime,
+} from '../../__test-utils__/test-runtime';
+import { completeJourney, journeyStep, resolveJourneyStep } from '../../core';
+import { moduleRuntime } from '../../core/runtime';
 
 const emitMock = jest.fn();
 const baseDef = { ...baseJourneyDef, name: 'timeout-api' };
@@ -18,7 +23,7 @@ describe('[journey] timeouts', () => {
 
     describe('with a journey timeoutMs', () => {
         beforeEach(() => {
-            startJourney({ ...baseDef, timeoutMs: 50 });
+            moduleRuntime.startJourney({ ...baseDef, timeoutMs: 50 });
         });
 
         const subject = () => jest.advanceTimersByTimeAsync(50);
@@ -33,7 +38,7 @@ describe('[journey] timeouts', () => {
 
     describe('with timeoutMs 0', () => {
         beforeEach(() => {
-            startJourney({ ...baseDef, timeoutMs: 0 });
+            moduleRuntime.startJourney({ ...baseDef, timeoutMs: 0 });
         });
 
         const subject = () => jest.advanceTimersByTimeAsync(60_000);
@@ -52,7 +57,7 @@ describe('[journey] timeouts', () => {
         let stepPromise: Promise<unknown>;
 
         beforeEach(() => {
-            startJourney({ ...baseDef, stepTimeoutMs: 40 });
+            moduleRuntime.startJourney({ ...baseDef, stepTimeoutMs: 40 });
             const hang = new Promise<void>(resolve => {
                 resolveWork = resolve;
             });
@@ -81,7 +86,7 @@ describe('[journey] timeouts', () => {
         let stepPromise: Promise<unknown>;
 
         beforeEach(() => {
-            startJourney({ ...baseDef, stepTimeoutMs: 5_000 });
+            moduleRuntime.startJourney({ ...baseDef, stepTimeoutMs: 5_000 });
             const hang = new Promise<void>(resolve => {
                 resolveWork = resolve;
             });
@@ -114,7 +119,7 @@ describe('[journey] timeouts', () => {
         let stepPromise: Promise<unknown>;
 
         beforeEach(() => {
-            startJourney({ ...baseDef, stepTimeoutMs: 40 });
+            moduleRuntime.startJourney({ ...baseDef, stepTimeoutMs: 40 });
             const hang = new Promise<void>(resolve => {
                 resolveWork = resolve;
             });
@@ -144,7 +149,7 @@ describe('[journey] timeouts', () => {
         let stepPromise: Promise<unknown>;
 
         beforeEach(() => {
-            startJourney({ ...baseDef, stepTimeoutMs: 40 });
+            moduleRuntime.startJourney({ ...baseDef, stepTimeoutMs: 40 });
             const hang = new Promise<void>(resolve => {
                 resolveWork = resolve;
             });
@@ -176,7 +181,7 @@ describe('[journey] timeouts', () => {
     describe('when clearTimeout is bypassed after complete', () => {
         beforeEach(() => {
             jest.spyOn(globalThis, 'clearTimeout').mockImplementation(() => {});
-            startJourney({ ...baseDef, timeoutMs: 50 });
+            moduleRuntime.startJourney({ ...baseDef, timeoutMs: 50 });
             completeJourney(baseDef.name);
             emitMock.mockClear();
         });
@@ -199,7 +204,7 @@ describe('[journey] timeouts', () => {
         let stepPromise: Promise<unknown>;
 
         beforeEach(() => {
-            startJourney({ ...baseDef, stepTimeoutMs: 0 });
+            moduleRuntime.startJourney({ ...baseDef, stepTimeoutMs: 0 });
             const hang = new Promise<void>(resolve => {
                 resolveWork = resolve;
             });

package/src/__tests__/global.test.ts

@@ -0,0 +1,113 @@
+/** @jest-environment jsdom */
+import '../config';
+import { defineJourney, resetJourney } from '../core';
+import {
+    JOURNEY_DEBUG_STORAGE_KEY,
+    JOURNEY_ENABLED_STORAGE_KEY,
+    ST_JOURNEY_GLOBAL_KEY,
+    disableJourney,
+    enableJourney,
+    isJourneyEnabled,
+    type StJourneyGlobal,
+} from '../global';
+import { setJourneyRum } from '../sinks/datadog';
+
+function getStJourney(): StJourneyGlobal {
+    return (globalThis as Record<string, unknown>)[ST_JOURNEY_GLOBAL_KEY] as StJourneyGlobal;
+}
+
+describe('[journey] __stJourney global', () => {
+    beforeEach(() => {
+        localStorage.clear();
+        delete getStJourney().rum;
+        delete (globalThis as Record<string, unknown>).DD_RUM;
+        resetJourney({ sinks: [] });
+    });
+
+    afterEach(() => {
+        localStorage.clear();
+        delete getStJourney().rum;
+        delete (globalThis as Record<string, unknown>).DD_RUM;
+        resetJourney({ sinks: [] });
+    });
+
+    test('installs __stJourney on package load', () => {
+        expect(getStJourney()).toEqual(
+            expect.objectContaining({
+                enable: expect.any(Function),
+                disable: expect.any(Function),
+                isEnabled: expect.any(Function),
+                enableDebugging: expect.any(Function),
+                disableDebugging: expect.any(Function),
+                isDebugEnabled: expect.any(Function),
+                getDebugState: expect.any(Function),
+            })
+        );
+    });
+
+    test('enable / disable toggle force-enable localStorage', () => {
+        expect(isJourneyEnabled()).toBe(false);
+
+        enableJourney();
+        expect(localStorage.getItem(JOURNEY_ENABLED_STORAGE_KEY)).toBe('true');
+        expect(isJourneyEnabled()).toBe(true);
+        expect(getStJourney().isEnabled()).toBe(true);
+
+        disableJourney();
+        expect(localStorage.getItem(JOURNEY_ENABLED_STORAGE_KEY)).toBeNull();
+        expect(isJourneyEnabled()).toBe(false);
+    });
+
+    test('enableDebugging / disableDebugging toggle console-debug localStorage', () => {
+        const st = getStJourney();
+
+        st.enableDebugging();
+        expect(localStorage.getItem(JOURNEY_DEBUG_STORAGE_KEY)).toBe('true');
+        expect(st.isDebugEnabled()).toBe(true);
+
+        st.disableDebugging();
+        expect(localStorage.getItem(JOURNEY_DEBUG_STORAGE_KEY)).toBeNull();
+        expect(st.isDebugEnabled()).toBe(false);
+    });
+
+    test('getDebugState omits runtimes until debugging is enabled', () => {
+        enableJourney();
+        const journey = defineJourney({
+            name: 'Book Job',
+            team: 'jbce',
+            group: 'call-booking',
+            service: 'call-screen',
+        });
+        journey.start();
+
+        expect(getStJourney().getDebugState()).toEqual(
+            expect.objectContaining({
+                enabled: true,
+                debug: false,
+                runtimes: [],
+            })
+        );
+
+        getStJourney().enableDebugging();
+        const on = getStJourney().getDebugState();
+        expect(on.debug).toBe(true);
+        expect(on.runtimes.some(r => r.openJourneys.some(j => j.name === 'Book Job'))).toBe(true);
+
+        getStJourney().disableDebugging();
+        expect(getStJourney().getDebugState().runtimes).toEqual([]);
+    });
+
+    test('getDebugState.hasRum reflects DD_RUM or the fallback bridge', () => {
+        getStJourney().enableDebugging();
+
+        expect(getStJourney().getDebugState().hasRum).toBe(false);
+
+        (globalThis as Record<string, unknown>).DD_RUM = { addAction: jest.fn() };
+        expect(getStJourney().getDebugState().hasRum).toBe(true);
+
+        delete (globalThis as Record<string, unknown>).DD_RUM;
+        jest.spyOn(console, 'warn').mockImplementation(() => undefined);
+        setJourneyRum({ addAction: jest.fn() });
+        expect(getStJourney().getDebugState().hasRum).toBe(true);
+    });
+});