@servicetitan/journey 2.0.0 → 3.0.0

package/README.md

@@ -4,4 +4,4 @@ Critical user journey monitoring for Datadog RUM (`user_journey` custom actions)
 
 - **Docs:** [Journey](https://docs.st.dev/docs/frontend/journey) (source: [`packages/docs/docs/journey.mdx`](../docs/docs/journey.mdx))
 
-Prefer `defineJourney` handles (`.start` / `.step` / `.complete`). Soft ambient attributes HTTP only when exactly one step is in flight — use `step.tag()` after `await` or when steps overlap.
+Prefer `defineJourney` handles (`.start` / `.step` / `.complete`). Soft ambient attributes HTTP only when exactly one step is in flight — pass `{ stamp: step.stamp() }` after `await` or when steps overlap. `start()` always opens a new instance. Default aborted-request policy is `continue`.

package/dist/__test-utils__/test-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runtime.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/test-runtime.ts"],"names":[],"mappings":"AAQA,sDAAsD;AACtD,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,OAE9C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,QAqBxD"}

package/dist/__test-utils__/test-runtime.js

@@ -0,0 +1,54 @@
+import { resetJourney } from '../core/runtime';
+import { resetSharedPolicies, setJourneyDefaultEnabled } from '../global';
+import { sendToConsole } from '../sinks/console';
+import { sendToDatadog } from '../sinks/datadog';
+/** Package default sinks installed by `config.ts` bootstrap. */ const DEFAULT_SINKS = [
+    sendToDatadog,
+    sendToConsole
+];
+/** Standard journey def used across engine suites. */ export const baseJourneyDef = {
+    name: 'journey-under-test',
+    team: 'platform',
+    group: 'test',
+    service: 'journey',
+    timeoutMs: 0
+};
+/** Last emitted journey payload from a sink mock. */ export function lastJourney(emitMock) {
+    return emitMock.mock.calls[emitMock.mock.calls.length - 1][0].journey;
+}
+/**
+ * Wire `emitMock` as the only sink and restore package defaults after each test.
+ * Call once at the top of a `describe` block.
+ */ export function useJourneyTestRuntime(emitMock) {
+    beforeEach(()=>{
+        setJourneyDefaultEnabled(true);
+        resetSharedPolicies();
+        resetJourney({
+            sinks: [
+                emitMock
+            ],
+            slowRequests: {
+                defaultMs: 4000,
+                endpoints: []
+            }
+        });
+        emitMock.mockClear();
+    });
+    afterEach(()=>{
+        setJourneyDefaultEnabled(false);
+        localStorage.clear();
+        sessionStorage.clear();
+        resetSharedPolicies();
+        resetJourney({
+            sinks: [
+                ...DEFAULT_SINKS
+            ],
+            slowRequests: {
+                defaultMs: 4000,
+                endpoints: []
+            }
+        });
+    });
+}
+
+//# sourceMappingURL=test-runtime.js.map

package/dist/__test-utils__/test-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/__test-utils__/test-runtime.ts"],"sourcesContent":["import { resetJourney } from '../core/runtime';\nimport { resetSharedPolicies, setJourneyDefaultEnabled } from '../global';\nimport { sendToConsole } from '../sinks/console';\nimport { sendToDatadog } from '../sinks/datadog';\n\n/** Package default sinks installed by `config.ts` bootstrap. */\nconst DEFAULT_SINKS = [sendToDatadog, sendToConsole] as const;\n\n/** Standard journey def used across engine suites. */\nexport const baseJourneyDef = {\n    name: 'journey-under-test',\n    team: 'platform',\n    group: 'test',\n    service: 'journey',\n    timeoutMs: 0,\n} as const;\n\n/** Last emitted journey payload from a sink mock. */\nexport function lastJourney(emitMock: jest.Mock) {\n    return emitMock.mock.calls[emitMock.mock.calls.length - 1][0].journey;\n}\n\n/**\n * Wire `emitMock` as the only sink and restore package defaults after each test.\n * Call once at the top of a `describe` block.\n */\nexport function useJourneyTestRuntime(emitMock: jest.Mock) {\n    beforeEach(() => {\n        setJourneyDefaultEnabled(true);\n        resetSharedPolicies();\n        resetJourney({\n            sinks: [emitMock],\n            slowRequests: { defaultMs: 4_000, endpoints: [] },\n        });\n        emitMock.mockClear();\n    });\n\n    afterEach(() => {\n        setJourneyDefaultEnabled(false);\n        localStorage.clear();\n        sessionStorage.clear();\n        resetSharedPolicies();\n        resetJourney({\n            sinks: [...DEFAULT_SINKS],\n            slowRequests: { defaultMs: 4_000, endpoints: [] },\n        });\n    });\n}\n"],"names":["resetJourney","resetSharedPolicies","setJourneyDefaultEnabled","sendToConsole","sendToDatadog","DEFAULT_SINKS","baseJourneyDef","name","team","group","service","timeoutMs","lastJourney","emitMock","mock","calls","length","journey","useJourneyTestRuntime","beforeEach","sinks","slowRequests","defaultMs","endpoints","mockClear","afterEach","localStorage","clear","sessionStorage"],"mappings":"AAAA,SAASA,YAAY,QAAQ,kBAAkB;AAC/C,SAASC,mBAAmB,EAAEC,wBAAwB,QAAQ,YAAY;AAC1E,SAASC,aAAa,QAAQ,mBAAmB;AACjD,SAASC,aAAa,QAAQ,mBAAmB;AAEjD,8DAA8D,GAC9D,MAAMC,gBAAgB;IAACD;IAAeD;CAAc;AAEpD,oDAAoD,GACpD,OAAO,MAAMG,iBAAiB;IAC1BC,MAAM;IACNC,MAAM;IACNC,OAAO;IACPC,SAAS;IACTC,WAAW;AACf,EAAW;AAEX,mDAAmD,GACnD,OAAO,SAASC,YAAYC,QAAmB;IAC3C,OAAOA,SAASC,IAAI,CAACC,KAAK,CAACF,SAASC,IAAI,CAACC,KAAK,CAACC,MAAM,GAAG,EAAE,CAAC,EAAE,CAACC,OAAO;AACzE;AAEA;;;CAGC,GACD,OAAO,SAASC,sBAAsBL,QAAmB;IACrDM,WAAW;QACPjB,yBAAyB;QACzBD;QACAD,aAAa;YACToB,OAAO;gBAACP;aAAS;YACjBQ,cAAc;gBAAEC,WAAW;gBAAOC,WAAW,EAAE;YAAC;QACpD;QACAV,SAASW,SAAS;IACtB;IAEAC,UAAU;QACNvB,yBAAyB;QACzBwB,aAAaC,KAAK;QAClBC,eAAeD,KAAK;QACpB1B;QACAD,aAAa;YACToB,OAAO;mBAAIf;aAAc;YACzBgB,cAAc;gBAAEC,WAAW;gBAAOC,WAAW,EAAE;YAAC;QACpD;IACJ;AACJ"}

package/dist/__tests__/core/ambient.test.d.ts.map

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

package/dist/__tests__/core/api.test.d.ts

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

package/dist/__tests__/core/api.test.d.ts.map

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

package/dist/__tests__/core/define-journey.test.d.ts.map

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

package/dist/__tests__/core/requests.test.d.ts.map

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

package/dist/__tests__/core/runtime.test.d.ts.map

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

package/dist/__tests__/core/sanitize.test.d.ts

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

package/dist/__tests__/core/sanitize.test.d.ts.map

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

package/dist/__tests__/core/step.test.d.ts.map

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

package/dist/__tests__/core/timeouts.test.d.ts.map

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

package/dist/__tests__/global.test.d.ts

@@ -0,0 +1,3 @@
+/** @jest-environment jsdom */
+import '../config';
+//# sourceMappingURL=global.test.d.ts.map

package/dist/__tests__/global.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/global.test.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,WAAW,CAAC"}

package/dist/__tests__/hardening.test.d.ts

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

package/dist/__tests__/hardening.test.d.ts.map

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

package/dist/__tests__/integrations/axios.test.d.ts.map

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

package/dist/__tests__/integrations/context.test.d.ts.map

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

package/dist/__tests__/integrations/expose-app-journey.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expose-app-journey.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integrations/expose-app-journey.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integrations/fetch.test.d.ts.map

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

package/dist/__tests__/integrations/host-mfe.test.d.ts

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

package/dist/__tests__/integrations/host-mfe.test.d.ts.map

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

package/dist/__tests__/integrations/jquery.test.d.ts.map

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

package/dist/__tests__/integrations/request-key.test.d.ts.map

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

package/dist/__tests__/integrations/scope.test.d.ts.map

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

package/dist/__tests__/integrations/use-journey-step.test.d.ts

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

package/dist/__tests__/integrations/use-journey-step.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-journey-step.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integrations/use-journey-step.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/sinks/console.test.d.ts

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

package/dist/__tests__/sinks/console.test.d.ts.map

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

package/dist/__tests__/sinks/datadog.test.d.ts.map

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

package/dist/__tests__/sinks/sinks.test.d.ts.map

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

package/dist/config.d.ts

@@ -1,32 +1,72 @@
-import { type JourneySink } from './core/registry';
-import { type AppRequestTimeouts, type EndpointPolicy } from './endpoint-policy';
+import type { JourneySink } from './core/types';
+import type { RequestPolicyConfig } from './core/request-policy';
+import { type SlowRequestConfig } from './core/endpoint-policy';
 import { type AxiosLikeInstance } from './integrations/axios';
 import { type InstrumentFetchOptions } from './integrations/fetch';
 import { type JqueryStatic, type WindowWithAppJourney } from './integrations/jquery';
-export { longestEndpointMatch, sortEndpointsByLongestMatch } from './endpoint-policy';
-export type { AppRequestTimeouts, EndpointPolicy };
 /** Optional app-wide / per-bundle configuration. */
 export interface JourneyConfig {
-    /** App-wide request-timeout fallback. Defaults to { defaultMs: 4000, endpoints: [] }. */
-    requestTimeouts?: AppRequestTimeouts;
+    /**
+     * App-wide slow-request thresholds (shared on `__stJourney` for all package copies).
+     * Package fallback remains `{ defaultMs: 4000, endpoints: [] }` until set.
+     * Desktop / KO hosts should set `defaultMs` and ignore noisy endpoint prefixes.
+     */
+    slowRequests?: SlowRequestConfig;
+    /**
+     * How attributed aborted/cancelled HTTP counts toward the open journey.
+     * Shared on `__stJourney`. Literal or `(ctx) => …`. Default `'continue'`.
+     */
+    httpAbortedRequests?: RequestPolicyConfig;
+    /**
+     * How attributed 4xx responses count toward the open journey.
+     * Shared on `__stJourney`. Literal or `(ctx) => …`. Default `'continue'` (no verdict change).
+     */
+    httpClientErrorRequests?: RequestPolicyConfig;
+    /**
+     * When true (default), untagged instrumented HTTP is attributed to the sole
+     * in-flight step (if exactly one). When false, only explicit `step.stamp()` attributes.
+     * Prefer false on busy desktop / shared jQuery shells with background traffic.
+     * Shared on `__stJourney`.
+     */
+    autoAttributeRequests?: boolean;
+    /**
+     * Default cap on recorded steps per journey (default 50). Per-journey
+     * `JourneyDef.maxSteps` overrides. Excess steps are dropped and
+     * `tags.steps_truncated` is set.
+     */
+    maxSteps?: number;
+    /**
+     * Applied when a journey omits `timeoutMs`.
+     * Default is 15m and closes as `excluded` with `journey-idle-timeout`.
+     * Pass `0` to disable this idle timeout.
+     */
+    defaultJourneyIdleMs?: number;
     /**
      * Replace the sink list used when a journey finishes.
      * Only applied when provided — omit to leave the current list unchanged.
-     * Package default is `[sendToDatadog]`; pass `[]` to disable emission.
+     * Package default is `[sendToDatadog, sendToConsole]`; pass `[]` to disable emission.
+     * `sendToConsole` is a no-op unless `sessionStorage['st:journey:debug'] === 'true'`.
+     * First `sinks` on this bundle wins; a later `configureJourney({ sinks })` is ignored.
      */
     sinks?: readonly JourneySink[];
     /**
      * Wire this bundle's axios instance (host or MFE). Same as `instrumentAxios(axios)`.
      * Register any async request interceptors (e.g. auth) before `configureJourney`.
+     * Soft-skips when axios is missing / not axios-like — safe to pass a host instance that may be absent.
      */
-    axios?: AxiosLikeInstance;
+    axios?: AxiosLikeInstance | null;
     /**
      * Wire fetch. `true` wraps `globalThis.fetch`; pass options for a scoped target / baseURL.
-     * Same as `instrumentFetch(...)`.
+     * Same as `instrumentFetch(...)`. Soft-skips when the target has no callable `fetch`.
+     * Prefer host-only for `globalThis.fetch` — MFEs inherit the host wrapper.
      */
-    fetch?: true | InstrumentFetchOptions;
-    /** Wire this bundle's jQuery static. Same as `instrumentJquery($)`. */
-    jquery?: JqueryStatic;
+    fetch?: true | InstrumentFetchOptions | null;
+    /**
+     * Wire jQuery. Pass a `$` instance, or `true` to use `globalThis.$` / `globalThis.jQuery`.
+     * `false` skips wiring. Soft-skips when `$` is missing / not real jQuery.
+     * Prefer host-only for shared `$`.
+     */
+    jquery?: boolean | JqueryStatic | null;
     /**
      * Publish `window.App.Journey` for Knockout / legacy hosts.
      * `true` uses the real window; pass a target object in tests.
@@ -36,7 +76,15 @@ export interface JourneyConfig {
 /**
  * Apply bundle options: request thresholds, sinks, and/or HTTP / legacy wiring.
  * Optional — call once at startup. Pass this bundle's own axios / `$` / fetch target.
+ * Policy knobs (`slowRequests`, `httpAbortedRequests`, `httpClientErrorRequests`,
+ * `autoAttributeRequests`) are stored on shared `__stJourney` so MFEs inherit host settings.
+ * No-ops when `isJourneyEnabled()` is false (host default or force flag).
+ * Never throws: missing/invalid config and failures soft-skip (warn / error to console).
  */
 export declare function configureJourney(config: JourneyConfig): void;
-export declare function getRequestTimeouts(): AppRequestTimeouts;
+/**
+ * @internal Read the module runtime's app-wide slow-request config.
+ * Prefer `configureJourney({ slowRequests })` to set thresholds. Test / introspection only.
+ */
+export declare function getSlowRequests(): SlowRequestConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAGH,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACtF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC;AAEnD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC1B,yFAAyF;IACzF,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,sBAAsB,CAAC;IACtC,uEAAuE;IACvE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;CACrD;AASD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAsB5D;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,CAEvD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AASjE,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAGH,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC5B,MAAM,uBAAuB,CAAC;AAK/B,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,mBAAmB,CAAC;IAC9C;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,sBAAsB,GAAG,IAAI,CAAC;IAC7C;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAAC;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;CACrD;AAUD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAoG5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD"}

package/dist/config.js

@@ -1,46 +1,115 @@
-import { defaultRuntime } from './core/runtime';
-import { setJourneySinks } from './core/registry';
-import { sortEndpointsByLongestMatch } from './endpoint-policy';
+import { moduleRuntime } from './core/runtime';
+import { areSharedPoliciesLocked, getSharedSlowRequests, isJourneyEnabled, registerJourneyRuntime, seedSharedPolicies, warnIfSlowRequestsUnset } from './global';
+import { sortEndpointsByLongestMatch } from './core/endpoint-policy';
 import { instrumentAxios } from './integrations/axios';
 import { instrumentFetch } from './integrations/fetch';
 import { exposeAppJourney, instrumentJquery } from './integrations/jquery';
+import { resolveGlobalJquery } from './integrations/jquery/instrument';
+import { sendToConsole } from './sinks/console';
 import { sendToDatadog } from './sinks/datadog';
-export { longestEndpointMatch, sortEndpointsByLongestMatch } from './endpoint-policy';
 /*
- * Default emission target. Kept as a module side effect so any import of this file
- * (see index.ts `import './config'`) installs Datadog. configureJourney only replaces
- * sinks when `sinks` is passed explicitly.
- */ setJourneySinks([
-    sendToDatadog
+ * Default emission targets + `__stJourney` bag. Kept as a module side effect so any import
+ * of this file (see index.ts `import './config'`) installs Datadog, console, and
+ * `__stJourney`. configureJourney only replaces sinks when `sinks` is passed explicitly.
+ */ moduleRuntime.setSinks([
+    sendToDatadog,
+    sendToConsole
 ]);
+registerJourneyRuntime(moduleRuntime);
 /**
  * Apply bundle options: request thresholds, sinks, and/or HTTP / legacy wiring.
  * Optional — call once at startup. Pass this bundle's own axios / `$` / fetch target.
+ * Policy knobs (`slowRequests`, `httpAbortedRequests`, `httpClientErrorRequests`,
+ * `autoAttributeRequests`) are stored on shared `__stJourney` so MFEs inherit host settings.
+ * No-ops when `isJourneyEnabled()` is false (host default or force flag).
+ * Never throws: missing/invalid config and failures soft-skip (warn / error to console).
  */ export function configureJourney(config) {
-    if (config.requestTimeouts !== undefined) {
-        defaultRuntime.setRequestTimeouts({
-            ...config.requestTimeouts,
-            endpoints: sortEndpointsByLongestMatch(config.requestTimeouts.endpoints)
-        });
+    if (config == null || typeof config !== 'object') {
+        // eslint-disable-next-line no-console -- soft-skip missing host config
+        console.warn('[journey] configureJourney: skipped — missing');
+        return;
     }
-    if (config.sinks !== undefined) {
-        setJourneySinks(config.sinks);
+    if (!isJourneyEnabled()) {
+        // eslint-disable-next-line no-console -- soft-skip when host default and force are off
+        console.warn('[journey] configureJourney: skipped — disabled (call setJourneyDefaultEnabled(true) or __stJourney.enable(), then configureJourney again / reload)');
+        return;
     }
-    if (config.axios !== undefined) {
-        instrumentAxios(config.axios);
-    }
-    if (config.fetch !== undefined) {
-        instrumentFetch(config.fetch === true ? {} : config.fetch);
-    }
-    if (config.jquery !== undefined) {
-        instrumentJquery(config.jquery);
-    }
-    if (config.exposeAppJourney) {
-        exposeAppJourney(config.exposeAppJourney === true ? undefined : config.exposeAppJourney);
+    try {
+        const overlay = {};
+        const policyPatch = {};
+        let hasPolicyKnob = false;
+        if (config.slowRequests !== undefined) {
+            const sorted = {
+                ...config.slowRequests,
+                endpoints: sortEndpointsByLongestMatch(config.slowRequests.endpoints)
+            };
+            policyPatch.slowRequests = sorted;
+            policyPatch.slowRequestsConfigured = true;
+            overlay.slowRequests = sorted;
+            hasPolicyKnob = true;
+        }
+        if (config.httpAbortedRequests !== undefined) {
+            policyPatch.httpAbortedRequests = config.httpAbortedRequests;
+            overlay.httpAbortedRequests = config.httpAbortedRequests;
+            hasPolicyKnob = true;
+        }
+        if (config.httpClientErrorRequests !== undefined) {
+            policyPatch.httpClientErrorRequests = config.httpClientErrorRequests;
+            overlay.httpClientErrorRequests = config.httpClientErrorRequests;
+            hasPolicyKnob = true;
+        }
+        if (config.autoAttributeRequests !== undefined) {
+            policyPatch.autoAttributeRequests = config.autoAttributeRequests;
+            overlay.autoAttributeRequests = config.autoAttributeRequests;
+            hasPolicyKnob = true;
+        }
+        if (hasPolicyKnob) {
+            if (!areSharedPoliciesLocked()) {
+                seedSharedPolicies(policyPatch);
+            }
+            moduleRuntime.setPolicyOverlay(overlay);
+        }
+        if (config.maxSteps !== undefined) {
+            moduleRuntime.setMaxSteps(config.maxSteps);
+        }
+        if (config.defaultJourneyIdleMs !== undefined) {
+            moduleRuntime.setDefaultJourneyIdleMs(config.defaultJourneyIdleMs);
+        }
+        if (config.sinks !== undefined) {
+            if (!moduleRuntime.trySetConfiguredSinks(config.sinks)) {
+                // eslint-disable-next-line no-console -- first-writer sinks
+                console.warn('[journey] configureJourney: sinks already set on this runtime — ignoring');
+            }
+        }
+        const wiringTransport = config.axios !== undefined || config.fetch !== undefined || config.jquery !== undefined && config.jquery !== false;
+        if (wiringTransport) {
+            warnIfSlowRequestsUnset();
+        }
+        if (config.axios !== undefined) {
+            instrumentAxios(config.axios);
+        }
+        if (config.fetch !== undefined) {
+            instrumentFetch(config.fetch === true ? {} : config.fetch);
+        }
+        if (config.jquery === true) {
+            instrumentJquery(resolveGlobalJquery());
+        } else if (config.jquery !== undefined && config.jquery !== false) {
+            instrumentJquery(config.jquery);
+        }
+        if (config.exposeAppJourney) {
+            exposeAppJourney(config.exposeAppJourney === true ? undefined : config.exposeAppJourney);
+        }
+    } catch (err) {
+        // eslint-disable-next-line no-console -- soft-fail host wiring
+        console.error('[journey] configureJourney failed', err);
     }
 }
-export function getRequestTimeouts() {
-    return defaultRuntime.getRequestTimeouts();
+/**
+ * @internal Read the module runtime's app-wide slow-request config.
+ * Prefer `configureJourney({ slowRequests })` to set thresholds. Test / introspection only.
+ */ export function getSlowRequests() {
+    var _getSharedSlowRequests;
+    return (_getSharedSlowRequests = getSharedSlowRequests()) !== null && _getSharedSlowRequests !== void 0 ? _getSharedSlowRequests : moduleRuntime.getSlowRequests();
 }
 
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { defaultRuntime } from './core/runtime';\nimport { setJourneySinks, type JourneySink } from './core/registry';\nimport {\n    sortEndpointsByLongestMatch,\n    type AppRequestTimeouts,\n    type EndpointPolicy,\n} from './endpoint-policy';\nimport { instrumentAxios, type AxiosLikeInstance } from './integrations/axios';\nimport { instrumentFetch, type InstrumentFetchOptions } from './integrations/fetch';\nimport {\n    exposeAppJourney,\n    instrumentJquery,\n    type JqueryStatic,\n    type WindowWithAppJourney,\n} from './integrations/jquery';\nimport { sendToDatadog } from './sinks/datadog';\n\nexport { longestEndpointMatch, sortEndpointsByLongestMatch } from './endpoint-policy';\nexport type { AppRequestTimeouts, EndpointPolicy };\n\n/** Optional app-wide / per-bundle configuration. */\nexport interface JourneyConfig {\n    /** App-wide request-timeout fallback. Defaults to { defaultMs: 4000, endpoints: [] }. */\n    requestTimeouts?: AppRequestTimeouts;\n    /**\n     * Replace the sink list used when a journey finishes.\n     * Only applied when provided — omit to leave the current list unchanged.\n     * Package default is `[sendToDatadog]`; pass `[]` to disable emission.\n     */\n    sinks?: readonly JourneySink[];\n    /**\n     * Wire this bundle's axios instance (host or MFE). Same as `instrumentAxios(axios)`.\n     * Register any async request interceptors (e.g. auth) before `configureJourney`.\n     */\n    axios?: AxiosLikeInstance;\n    /**\n     * Wire fetch. `true` wraps `globalThis.fetch`; pass options for a scoped target / baseURL.\n     * Same as `instrumentFetch(...)`.\n     */\n    fetch?: true | InstrumentFetchOptions;\n    /** Wire this bundle's jQuery static. Same as `instrumentJquery($)`. */\n    jquery?: JqueryStatic;\n    /**\n     * Publish `window.App.Journey` for Knockout / legacy hosts.\n     * `true` uses the real window; pass a target object in tests.\n     */\n    exposeAppJourney?: boolean | WindowWithAppJourney;\n}\n\n/*\n * Default emission target. Kept as a module side effect so any import of this file\n * (see index.ts `import './config'`) installs Datadog. configureJourney only replaces\n * sinks when `sinks` is passed explicitly.\n */\nsetJourneySinks([sendToDatadog]);\n\n/**\n * Apply bundle options: request thresholds, sinks, and/or HTTP / legacy wiring.\n * Optional — call once at startup. Pass this bundle's own axios / `$` / fetch target.\n */\nexport function configureJourney(config: JourneyConfig): void {\n    if (config.requestTimeouts !== undefined) {\n        defaultRuntime.setRequestTimeouts({\n            ...config.requestTimeouts,\n            endpoints: sortEndpointsByLongestMatch(config.requestTimeouts.endpoints),\n        });\n    }\n    if (config.sinks !== undefined) {\n        setJourneySinks(config.sinks);\n    }\n    if (config.axios !== undefined) {\n        instrumentAxios(config.axios);\n    }\n    if (config.fetch !== undefined) {\n        instrumentFetch(config.fetch === true ? {} : config.fetch);\n    }\n    if (config.jquery !== undefined) {\n        instrumentJquery(config.jquery);\n    }\n    if (config.exposeAppJourney) {\n        exposeAppJourney(config.exposeAppJourney === true ? undefined : config.exposeAppJourney);\n    }\n}\n\nexport function getRequestTimeouts(): AppRequestTimeouts {\n    return defaultRuntime.getRequestTimeouts();\n}\n"],"names":["defaultRuntime","setJourneySinks","sortEndpointsByLongestMatch","instrumentAxios","instrumentFetch","exposeAppJourney","instrumentJquery","sendToDatadog","longestEndpointMatch","configureJourney","config","requestTimeouts","undefined","setRequestTimeouts","endpoints","sinks","axios","fetch","jquery","getRequestTimeouts"],"mappings":"AAAA,SAASA,cAAc,QAAQ,iBAAiB;AAChD,SAASC,eAAe,QAA0B,kBAAkB;AACpE,SACIC,2BAA2B,QAGxB,oBAAoB;AAC3B,SAASC,eAAe,QAAgC,uBAAuB;AAC/E,SAASC,eAAe,QAAqC,uBAAuB;AACpF,SACIC,gBAAgB,EAChBC,gBAAgB,QAGb,wBAAwB;AAC/B,SAASC,aAAa,QAAQ,kBAAkB;AAEhD,SAASC,oBAAoB,EAAEN,2BAA2B,QAAQ,oBAAoB;AAgCtF;;;;CAIC,GACDD,gBAAgB;IAACM;CAAc;AAE/B;;;CAGC,GACD,OAAO,SAASE,iBAAiBC,MAAqB;IAClD,IAAIA,OAAOC,eAAe,KAAKC,WAAW;QACtCZ,eAAea,kBAAkB,CAAC;YAC9B,GAAGH,OAAOC,eAAe;YACzBG,WAAWZ,4BAA4BQ,OAAOC,eAAe,CAACG,SAAS;QAC3E;IACJ;IACA,IAAIJ,OAAOK,KAAK,KAAKH,WAAW;QAC5BX,gBAAgBS,OAAOK,KAAK;IAChC;IACA,IAAIL,OAAOM,KAAK,KAAKJ,WAAW;QAC5BT,gBAAgBO,OAAOM,KAAK;IAChC;IACA,IAAIN,OAAOO,KAAK,KAAKL,WAAW;QAC5BR,gBAAgBM,OAAOO,KAAK,KAAK,OAAO,CAAC,IAAIP,OAAOO,KAAK;IAC7D;IACA,IAAIP,OAAOQ,MAAM,KAAKN,WAAW;QAC7BN,iBAAiBI,OAAOQ,MAAM;IAClC;IACA,IAAIR,OAAOL,gBAAgB,EAAE;QACzBA,iBAAiBK,OAAOL,gBAAgB,KAAK,OAAOO,YAAYF,OAAOL,gBAAgB;IAC3F;AACJ;AAEA,OAAO,SAASc;IACZ,OAAOnB,eAAemB,kBAAkB;AAC5C"}
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { moduleRuntime } from './core/runtime';\nimport type { JourneySink } from './core/types';\nimport type { RequestPolicyConfig } from './core/request-policy';\nimport {\n    areSharedPoliciesLocked,\n    getSharedSlowRequests,\n    isJourneyEnabled,\n    registerJourneyRuntime,\n    seedSharedPolicies,\n    warnIfSlowRequestsUnset,\n} from './global';\nimport { sortEndpointsByLongestMatch, type SlowRequestConfig } from './core/endpoint-policy';\nimport { instrumentAxios, type AxiosLikeInstance } from './integrations/axios';\nimport { instrumentFetch, type InstrumentFetchOptions } from './integrations/fetch';\nimport {\n    exposeAppJourney,\n    instrumentJquery,\n    type JqueryStatic,\n    type WindowWithAppJourney,\n} from './integrations/jquery';\nimport { resolveGlobalJquery } from './integrations/jquery/instrument';\nimport { sendToConsole } from './sinks/console';\nimport { sendToDatadog } from './sinks/datadog';\n\n/** Optional app-wide / per-bundle configuration. */\nexport interface JourneyConfig {\n    /**\n     * App-wide slow-request thresholds (shared on `__stJourney` for all package copies).\n     * Package fallback remains `{ defaultMs: 4000, endpoints: [] }` until set.\n     * Desktop / KO hosts should set `defaultMs` and ignore noisy endpoint prefixes.\n     */\n    slowRequests?: SlowRequestConfig;\n    /**\n     * How attributed aborted/cancelled HTTP counts toward the open journey.\n     * Shared on `__stJourney`. Literal or `(ctx) => …`. Default `'continue'`.\n     */\n    httpAbortedRequests?: RequestPolicyConfig;\n    /**\n     * How attributed 4xx responses count toward the open journey.\n     * Shared on `__stJourney`. Literal or `(ctx) => …`. Default `'continue'` (no verdict change).\n     */\n    httpClientErrorRequests?: RequestPolicyConfig;\n    /**\n     * When true (default), untagged instrumented HTTP is attributed to the sole\n     * in-flight step (if exactly one). When false, only explicit `step.stamp()` attributes.\n     * Prefer false on busy desktop / shared jQuery shells with background traffic.\n     * Shared on `__stJourney`.\n     */\n    autoAttributeRequests?: boolean;\n    /**\n     * Default cap on recorded steps per journey (default 50). Per-journey\n     * `JourneyDef.maxSteps` overrides. Excess steps are dropped and\n     * `tags.steps_truncated` is set.\n     */\n    maxSteps?: number;\n    /**\n     * Applied when a journey omits `timeoutMs`.\n     * Default is 15m and closes as `excluded` with `journey-idle-timeout`.\n     * Pass `0` to disable this idle timeout.\n     */\n    defaultJourneyIdleMs?: number;\n    /**\n     * Replace the sink list used when a journey finishes.\n     * Only applied when provided — omit to leave the current list unchanged.\n     * Package default is `[sendToDatadog, sendToConsole]`; pass `[]` to disable emission.\n     * `sendToConsole` is a no-op unless `sessionStorage['st:journey:debug'] === 'true'`.\n     * First `sinks` on this bundle wins; a later `configureJourney({ sinks })` is ignored.\n     */\n    sinks?: readonly JourneySink[];\n    /**\n     * Wire this bundle's axios instance (host or MFE). Same as `instrumentAxios(axios)`.\n     * Register any async request interceptors (e.g. auth) before `configureJourney`.\n     * Soft-skips when axios is missing / not axios-like — safe to pass a host instance that may be absent.\n     */\n    axios?: AxiosLikeInstance | null;\n    /**\n     * Wire fetch. `true` wraps `globalThis.fetch`; pass options for a scoped target / baseURL.\n     * Same as `instrumentFetch(...)`. Soft-skips when the target has no callable `fetch`.\n     * Prefer host-only for `globalThis.fetch` — MFEs inherit the host wrapper.\n     */\n    fetch?: true | InstrumentFetchOptions | null;\n    /**\n     * Wire jQuery. Pass a `$` instance, or `true` to use `globalThis.$` / `globalThis.jQuery`.\n     * `false` skips wiring. Soft-skips when `$` is missing / not real jQuery.\n     * Prefer host-only for shared `$`.\n     */\n    jquery?: boolean | JqueryStatic | null;\n    /**\n     * Publish `window.App.Journey` for Knockout / legacy hosts.\n     * `true` uses the real window; pass a target object in tests.\n     */\n    exposeAppJourney?: boolean | WindowWithAppJourney;\n}\n\n/*\n * Default emission targets + `__stJourney` bag. Kept as a module side effect so any import\n * of this file (see index.ts `import './config'`) installs Datadog, console, and\n * `__stJourney`. configureJourney only replaces sinks when `sinks` is passed explicitly.\n */\nmoduleRuntime.setSinks([sendToDatadog, sendToConsole]);\nregisterJourneyRuntime(moduleRuntime);\n\n/**\n * Apply bundle options: request thresholds, sinks, and/or HTTP / legacy wiring.\n * Optional — call once at startup. Pass this bundle's own axios / `$` / fetch target.\n * Policy knobs (`slowRequests`, `httpAbortedRequests`, `httpClientErrorRequests`,\n * `autoAttributeRequests`) are stored on shared `__stJourney` so MFEs inherit host settings.\n * No-ops when `isJourneyEnabled()` is false (host default or force flag).\n * Never throws: missing/invalid config and failures soft-skip (warn / error to console).\n */\nexport function configureJourney(config: JourneyConfig): void {\n    if (config == null || typeof config !== 'object') {\n        // eslint-disable-next-line no-console -- soft-skip missing host config\n        console.warn('[journey] configureJourney: skipped — missing');\n        return;\n    }\n    if (!isJourneyEnabled()) {\n        // eslint-disable-next-line no-console -- soft-skip when host default and force are off\n        console.warn(\n            '[journey] configureJourney: skipped — disabled (call setJourneyDefaultEnabled(true) or __stJourney.enable(), then configureJourney again / reload)'\n        );\n        return;\n    }\n\n    try {\n        const overlay: {\n            slowRequests?: SlowRequestConfig;\n            httpAbortedRequests?: RequestPolicyConfig;\n            httpClientErrorRequests?: RequestPolicyConfig;\n            autoAttributeRequests?: boolean;\n        } = {};\n\n        const policyPatch: Parameters<typeof seedSharedPolicies>[0] = {};\n        let hasPolicyKnob = false;\n\n        if (config.slowRequests !== undefined) {\n            const sorted = {\n                ...config.slowRequests,\n                endpoints: sortEndpointsByLongestMatch(config.slowRequests.endpoints),\n            };\n            policyPatch.slowRequests = sorted;\n            policyPatch.slowRequestsConfigured = true;\n            overlay.slowRequests = sorted;\n            hasPolicyKnob = true;\n        }\n        if (config.httpAbortedRequests !== undefined) {\n            policyPatch.httpAbortedRequests = config.httpAbortedRequests;\n            overlay.httpAbortedRequests = config.httpAbortedRequests;\n            hasPolicyKnob = true;\n        }\n        if (config.httpClientErrorRequests !== undefined) {\n            policyPatch.httpClientErrorRequests = config.httpClientErrorRequests;\n            overlay.httpClientErrorRequests = config.httpClientErrorRequests;\n            hasPolicyKnob = true;\n        }\n        if (config.autoAttributeRequests !== undefined) {\n            policyPatch.autoAttributeRequests = config.autoAttributeRequests;\n            overlay.autoAttributeRequests = config.autoAttributeRequests;\n            hasPolicyKnob = true;\n        }\n\n        if (hasPolicyKnob) {\n            if (!areSharedPoliciesLocked()) {\n                seedSharedPolicies(policyPatch);\n            }\n            moduleRuntime.setPolicyOverlay(overlay);\n        }\n        if (config.maxSteps !== undefined) {\n            moduleRuntime.setMaxSteps(config.maxSteps);\n        }\n        if (config.defaultJourneyIdleMs !== undefined) {\n            moduleRuntime.setDefaultJourneyIdleMs(config.defaultJourneyIdleMs);\n        }\n        if (config.sinks !== undefined) {\n            if (!moduleRuntime.trySetConfiguredSinks(config.sinks)) {\n                // eslint-disable-next-line no-console -- first-writer sinks\n                console.warn(\n                    '[journey] configureJourney: sinks already set on this runtime — ignoring'\n                );\n            }\n        }\n\n        const wiringTransport =\n            config.axios !== undefined ||\n            config.fetch !== undefined ||\n            (config.jquery !== undefined && config.jquery !== false);\n        if (wiringTransport) {\n            warnIfSlowRequestsUnset();\n        }\n\n        if (config.axios !== undefined) {\n            instrumentAxios(config.axios);\n        }\n        if (config.fetch !== undefined) {\n            instrumentFetch(config.fetch === true ? {} : config.fetch);\n        }\n        if (config.jquery === true) {\n            instrumentJquery(resolveGlobalJquery());\n        } else if (config.jquery !== undefined && config.jquery !== false) {\n            instrumentJquery(config.jquery);\n        }\n        if (config.exposeAppJourney) {\n            exposeAppJourney(\n                config.exposeAppJourney === true ? undefined : config.exposeAppJourney\n            );\n        }\n    } catch (err) {\n        // eslint-disable-next-line no-console -- soft-fail host wiring\n        console.error('[journey] configureJourney failed', err);\n    }\n}\n\n/**\n * @internal Read the module runtime's app-wide slow-request config.\n * Prefer `configureJourney({ slowRequests })` to set thresholds. Test / introspection only.\n */\nexport function getSlowRequests(): SlowRequestConfig {\n    return getSharedSlowRequests() ?? moduleRuntime.getSlowRequests();\n}\n"],"names":["moduleRuntime","areSharedPoliciesLocked","getSharedSlowRequests","isJourneyEnabled","registerJourneyRuntime","seedSharedPolicies","warnIfSlowRequestsUnset","sortEndpointsByLongestMatch","instrumentAxios","instrumentFetch","exposeAppJourney","instrumentJquery","resolveGlobalJquery","sendToConsole","sendToDatadog","setSinks","configureJourney","config","console","warn","overlay","policyPatch","hasPolicyKnob","slowRequests","undefined","sorted","endpoints","slowRequestsConfigured","httpAbortedRequests","httpClientErrorRequests","autoAttributeRequests","setPolicyOverlay","maxSteps","setMaxSteps","defaultJourneyIdleMs","setDefaultJourneyIdleMs","sinks","trySetConfiguredSinks","wiringTransport","axios","fetch","jquery","err","error","getSlowRequests"],"mappings":"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"}

package/dist/core/abort-error.d.ts

@@ -0,0 +1,4 @@
+export declare function isAbortError(error: unknown): boolean;
+/** Axios cancel token, CanceledError, AbortError, or ERR_CANCELED. */
+export declare function isCanceledError(error: unknown): boolean;
+//# sourceMappingURL=abort-error.d.ts.map

package/dist/core/abort-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-error.d.ts","sourceRoot":"","sources":["../../src/core/abort-error.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASpD;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWvD"}

package/dist/core/abort-error.js

@@ -0,0 +1,22 @@
+export function isAbortError(error) {
+    if (error == null || typeof error !== 'object') {
+        return false;
+    }
+    const err = error;
+    if (err.name === 'AbortError' || err.name === 'CanceledError') {
+        return true;
+    }
+    return err.code === 'ERR_CANCELED';
+}
+/** Axios cancel token, CanceledError, AbortError, or ERR_CANCELED. */ export function isCanceledError(error) {
+    if (isAbortError(error)) {
+        return true;
+    }
+    if (error == null || typeof error !== 'object') {
+        return false;
+    }
+    /* eslint-disable @typescript-eslint/naming-convention -- axios Cancel token wire format */ const err = error;
+    return err.__CANCEL__ === true;
+/* eslint-enable @typescript-eslint/naming-convention */ }
+
+//# sourceMappingURL=abort-error.js.map

package/dist/core/abort-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/abort-error.ts"],"sourcesContent":["export function isAbortError(error: unknown): boolean {\n    if (error == null || typeof error !== 'object') {\n        return false;\n    }\n    const err = error as { name?: string; code?: string | number };\n    if (err.name === 'AbortError' || err.name === 'CanceledError') {\n        return true;\n    }\n    return err.code === 'ERR_CANCELED';\n}\n\n/** Axios cancel token, CanceledError, AbortError, or ERR_CANCELED. */\nexport function isCanceledError(error: unknown): boolean {\n    if (isAbortError(error)) {\n        return true;\n    }\n    if (error == null || typeof error !== 'object') {\n        return false;\n    }\n    /* eslint-disable @typescript-eslint/naming-convention -- axios Cancel token wire format */\n    const err = error as { __CANCEL__?: boolean };\n    return err.__CANCEL__ === true;\n    /* eslint-enable @typescript-eslint/naming-convention */\n}\n"],"names":["isAbortError","error","err","name","code","isCanceledError","__CANCEL__"],"mappings":"AAAA,OAAO,SAASA,aAAaC,KAAc;IACvC,IAAIA,SAAS,QAAQ,OAAOA,UAAU,UAAU;QAC5C,OAAO;IACX;IACA,MAAMC,MAAMD;IACZ,IAAIC,IAAIC,IAAI,KAAK,gBAAgBD,IAAIC,IAAI,KAAK,iBAAiB;QAC3D,OAAO;IACX;IACA,OAAOD,IAAIE,IAAI,KAAK;AACxB;AAEA,oEAAoE,GACpE,OAAO,SAASC,gBAAgBJ,KAAc;IAC1C,IAAID,aAAaC,QAAQ;QACrB,OAAO;IACX;IACA,IAAIA,SAAS,QAAQ,OAAOA,UAAU,UAAU;QAC5C,OAAO;IACX;IACA,yFAAyF,GACzF,MAAMC,MAAMD;IACZ,OAAOC,IAAII,UAAU,KAAK;AAC1B,sDAAsD,GAC1D"}

package/dist/core/api.d.ts

@@ -0,0 +1,43 @@
+import { JourneyStepStamp } from './step-tag';
+import type { JourneyDef, JourneyHandle, JourneyStepOptions, JourneyStepTarget, StepHandle, StepRecord, TagValue } from './types';
+/**
+ * Unique in-flight step as a stamp-ready {@link JourneyStepStamp}, or null when
+ * auto-attribute is disabled, or when 0 or 2+ steps are in flight app-wide.
+ * Ambient stamps never carry `score` or `ignore`. Untagged traffic is attributed
+ * to that lone step even if unrelated — prefer `step.stamp()` when the page has
+ * background instrumented requests. Disable via
+ * `configureJourney({ autoAttributeRequests: false })`.
+ */
+export declare function singleInFlightJourneyStep(): JourneyStepStamp | null;
+/** @internal Clear cached ambient stamp when runtime state changes. */
+export declare function invalidateAmbientStamp(step?: StepRecord): void;
+/**
+ * Prefer an explicit `step.stamp()` value; else the ambient in-flight stamp.
+ * Same-realm stamps are returned as-is (identity + score + ignore). Branded
+ * foreign copies are adopted into a local stamp. Raw StepRecords are not stamps.
+ */
+export declare function resolveStamp(explicit?: unknown): JourneyStepStamp | undefined;
+/**
+ * Record a finished backend request against a captured step.
+ * 5xx / network / slow (over threshold) mark Bad; 4xx is not counted. Fail-fast on breach.
+ * @internal Prefer {@link onHttpComplete} from adapters.
+ */
+export declare function reportBackendRequest(step: StepRecord | undefined, status: number | undefined, durationMs: number, requestKey: string): void;
+/**
+ * Run one step of a named journey. Runs untraced (noop handle) when no matching journey is open.
+ * `journey` may be a name, null, an ordered candidate list, a def, or a handle.
+ * A def or handle auto-starts when that journey is not already open; a bare name does not.
+ * Prefer `defineJourney(...).step` when you own the journey config.
+ */
+export declare function journeyStep<T>(journey: JourneyStepTarget, stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
+/** Merge custom tags onto an open journey. No-op if not open. Prefer `handle.setTags`. */
+export declare function setJourneyTags(name: string | null, tags: Record<string, TagValue>): void;
+/** Mark a named journey Bad for a custom reason (fail-fast). Prefer `handle.fail`. */
+export declare function failJourney(name: string, reason: string): void;
+/** Successful end. Outcome stays Bad if a breach already occurred. No-op when name is null. Prefer `handle.complete`. */
+export declare function completeJourney(name: string | null, tags?: Record<string, TagValue>): void;
+/** User left before finishing. Stays Bad if a breach already occurred (breach-anchored). Prefer `handle.exclude`. */
+export declare function excludeJourney(name: string): void;
+/** Turn a journey config into a handle with bound lifecycle methods. Preferred public API. */
+export declare function defineJourney(config: JourneyDef): JourneyHandle;
+//# sourceMappingURL=api.d.ts.map

package/dist/core/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/core/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EACR,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,QAAQ,EACX,MAAM,SAAS,CAAC;AAKjB;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,gBAAgB,GAAG,IAAI,CAiBnE;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAK9D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAM7E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACnB,IAAI,CAKN;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAC/B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxC,IAAI,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAExF;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAK9D;AAED,yHAAyH;AACzH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAE1F;AAED,qHAAqH;AACrH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAoC/D"}