@servicetitan/journey 2.0.0 → 3.0.0

package/dist/integrations/react/use-journey-step.js

@@ -0,0 +1,19 @@
+import { useCallback } from 'react';
+import { journeyStep } from '../../core';
+import { useOptionalJourneyName } from './context';
+/**
+ * Run a step on the active `<JourneyScope>` journey, an explicit name, or a handle.
+ * A handle auto-starts when the journey is not open; a bare name does not.
+ *
+ * @example
+ * const runStep = useJourneyStep();
+ * await runStep('load', async step => { await api.get('/x', { stamp: step.stamp() }); });
+ */ export function useJourneyStep(journey) {
+    const fromScope = useOptionalJourneyName();
+    const resolved = journey !== undefined ? journey : fromScope;
+    return useCallback((stepName, fn, opts)=>journeyStep(resolved, stepName, fn, opts), [
+        resolved
+    ]);
+}
+
+//# sourceMappingURL=use-journey-step.js.map

package/dist/integrations/react/use-journey-step.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/integrations/react/use-journey-step.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nimport {\n    journeyStep,\n    type JourneyHandle,\n    type JourneyStepOptions,\n    type StepHandle,\n} from '../../core';\nimport { useOptionalJourneyName } from './context';\n\n/**\n * Run a step on the active `<JourneyScope>` journey, an explicit name, or a handle.\n * A handle auto-starts when the journey is not open; a bare name does not.\n *\n * @example\n * const runStep = useJourneyStep();\n * await runStep('load', async step => { await api.get('/x', { stamp: step.stamp() }); });\n */\nexport function useJourneyStep(journey?: string | JourneyHandle | null) {\n    const fromScope = useOptionalJourneyName();\n    const resolved = journey !== undefined ? journey : fromScope;\n\n    return useCallback(\n        <T>(\n            stepName: string,\n            fn: (step: StepHandle) => T | Promise<T>,\n            opts?: JourneyStepOptions\n        ): Promise<T> => journeyStep(resolved, stepName, fn, opts),\n        [resolved]\n    );\n}\n"],"names":["useCallback","journeyStep","useOptionalJourneyName","useJourneyStep","journey","fromScope","resolved","undefined","stepName","fn","opts"],"mappings":"AAAA,SAASA,WAAW,QAAQ,QAAQ;AAEpC,SACIC,WAAW,QAIR,aAAa;AACpB,SAASC,sBAAsB,QAAQ,YAAY;AAEnD;;;;;;;CAOC,GACD,OAAO,SAASC,eAAeC,OAAuC;IAClE,MAAMC,YAAYH;IAClB,MAAMI,WAAWF,YAAYG,YAAYH,UAAUC;IAEnD,OAAOL,YACH,CACIQ,UACAC,IACAC,OACaT,YAAYK,UAAUE,UAAUC,IAAIC,OACrD;QAACJ;KAAS;AAElB"}

package/dist/integrations/request-key.d.ts

@@ -2,12 +2,17 @@
  * Timing metadata stamped onto a request config so the response handler can attribute
  * and measure the round trip. Intersect with your transport's config type.
  *
- * `journeyStep` is a JourneyStepTag (from `step.tag()` or ambient instrumentation)
- * or, historically, a raw StepRecord. Adapters unwrap via `resolveJourneyStep`.
+ * `stamp` is a JourneyStepStamp from `step.stamp()` or ambient instrumentation.
  */
 export interface JourneyTimedMeta {
     journeyStart?: number;
-    journeyStep?: unknown;
+    stamp?: unknown;
+    /** Skip attribution for this request (no ambient stamp, no scoring). */
+    ignore?: boolean;
+    /** Per-request override for aborted/cancelled HTTP policy. */
+    httpAbortedRequests?: 'continue' | 'bad' | 'exclude';
+    /** Per-request override for 4xx HTTP policy. */
+    httpClientErrorRequests?: 'continue' | 'bad' | 'exclude';
 }
 /**
  * Endpoint key for timeout / ignore lookup: PATH for same-origin (vs instance baseURL),

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

@@ -1 +1 @@
-{"version":3,"file":"request-key.d.ts","sourceRoot":"","sources":["../../src/integrations/request-key.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAUD;;;GAGG;AACH,wBAAgB,UAAU,CACtB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,eAAe,EAAE,MAAM,GAAG,SAAS,GACpC,MAAM,CAiBR"}
+{"version":3,"file":"request-key.d.ts","sourceRoot":"","sources":["../../src/integrations/request-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;IACrD,gDAAgD;IAChD,uBAAuB,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;CAC5D;AAmBD;;;GAGG;AACH,wBAAgB,UAAU,CACtB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,eAAe,EAAE,MAAM,GAAG,SAAS,GACpC,MAAM,CAWR"}

package/dist/integrations/request-key.js

@@ -2,8 +2,7 @@
  * Timing metadata stamped onto a request config so the response handler can attribute
  * and measure the round trip. Intersect with your transport's config type.
  *
- * `journeyStep` is a JourneyStepTag (from `step.tag()` or ambient instrumentation)
- * or, historically, a raw StepRecord. Adapters unwrap via `resolveJourneyStep`.
+ * `stamp` is a JourneyStepStamp from `step.stamp()` or ambient instrumentation.
  */ function pageOrigin() {
     try {
         var _ref;
@@ -13,6 +12,14 @@
         return '';
     }
 }
+function resolveHomeOrigin(instanceBaseURL, origin) {
+    try {
+        const homeBase = instanceBaseURL !== null && instanceBaseURL !== void 0 ? instanceBaseURL : origin;
+        return new URL(homeBase || 'http://localhost').origin;
+    } catch (unused) {
+        return origin;
+    }
+}
 /**
  * Endpoint key for timeout / ignore lookup: PATH for same-origin (vs instance baseURL),
  * or "host/path" for cross-domain.
@@ -26,13 +33,7 @@
     } catch (unused) {
         return url !== null && url !== void 0 ? url : '';
     }
-    let homeOrigin;
-    try {
-        const homeBase = instanceBaseURL !== null && instanceBaseURL !== void 0 ? instanceBaseURL : origin;
-        homeOrigin = new URL(homeBase || 'http://localhost').origin;
-    } catch (unused) {
-        homeOrigin = origin;
-    }
+    const homeOrigin = resolveHomeOrigin(instanceBaseURL, origin);
     return abs.origin === homeOrigin ? abs.pathname : abs.host + abs.pathname;
 }
 

package/dist/integrations/request-key.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/integrations/request-key.ts"],"sourcesContent":["/**\n * Timing metadata stamped onto a request config so the response handler can attribute\n * and measure the round trip. Intersect with your transport's config type.\n *\n * `journeyStep` is a JourneyStepTag (from `step.tag()` or ambient instrumentation)\n * or, historically, a raw StepRecord. Adapters unwrap via `resolveJourneyStep`.\n */\nexport interface JourneyTimedMeta {\n    journeyStart?: number;\n    journeyStep?: unknown;\n}\n\nfunction pageOrigin(): string {\n    try {\n        return globalThis.location?.origin ?? '';\n    } catch {\n        return '';\n    }\n}\n\n/**\n * Endpoint key for timeout / ignore lookup: PATH for same-origin (vs instance baseURL),\n * or \"host/path\" for cross-domain.\n */\nexport function requestKey(\n    url: string | undefined,\n    configBaseURL: string | undefined,\n    instanceBaseURL: string | undefined\n): string {\n    const origin = pageOrigin();\n    const base = configBaseURL ?? instanceBaseURL ?? origin;\n    let abs: URL;\n    try {\n        abs = new URL(url ?? '', base || undefined);\n    } catch {\n        return url ?? '';\n    }\n    let homeOrigin: string;\n    try {\n        const homeBase = instanceBaseURL ?? origin;\n        homeOrigin = new URL(homeBase || 'http://localhost').origin;\n    } catch {\n        homeOrigin = origin;\n    }\n    return abs.origin === homeOrigin ? abs.pathname : abs.host + abs.pathname;\n}\n"],"names":["pageOrigin","globalThis","location","origin","requestKey","url","configBaseURL","instanceBaseURL","base","abs","URL","undefined","homeOrigin","homeBase","pathname","host"],"mappings":"AAAA;;;;;;CAMC,GAMD,SAASA;IACL,IAAI;;YACOC;QAAP,gBAAOA,uBAAAA,WAAWC,QAAQ,cAAnBD,2CAAAA,qBAAqBE,MAAM,uCAAI;IAC1C,EAAE,eAAM;QACJ,OAAO;IACX;AACJ;AAEA;;;CAGC,GACD,OAAO,SAASC,WACZC,GAAuB,EACvBC,aAAiC,EACjCC,eAAmC;QAGtBD;IADb,MAAMH,SAASH;IACf,MAAMQ,QAAOF,OAAAA,0BAAAA,2BAAAA,gBAAiBC,6BAAjBD,kBAAAA,OAAoCH;IACjD,IAAIM;IACJ,IAAI;QACAA,MAAM,IAAIC,IAAIL,gBAAAA,iBAAAA,MAAO,IAAIG,QAAQG;IACrC,EAAE,eAAM;QACJ,OAAON,gBAAAA,iBAAAA,MAAO;IAClB;IACA,IAAIO;IACJ,IAAI;QACA,MAAMC,WAAWN,4BAAAA,6BAAAA,kBAAmBJ;QACpCS,aAAa,IAAIF,IAAIG,YAAY,oBAAoBV,MAAM;IAC/D,EAAE,eAAM;QACJS,aAAaT;IACjB;IACA,OAAOM,IAAIN,MAAM,KAAKS,aAAaH,IAAIK,QAAQ,GAAGL,IAAIM,IAAI,GAAGN,IAAIK,QAAQ;AAC7E"}
+{"version":3,"sources":["../../src/integrations/request-key.ts"],"sourcesContent":["/**\n * Timing metadata stamped onto a request config so the response handler can attribute\n * and measure the round trip. Intersect with your transport's config type.\n *\n * `stamp` is a JourneyStepStamp from `step.stamp()` or ambient instrumentation.\n */\nexport interface JourneyTimedMeta {\n    journeyStart?: number;\n    stamp?: unknown;\n    /** Skip attribution for this request (no ambient stamp, no scoring). */\n    ignore?: boolean;\n    /** Per-request override for aborted/cancelled HTTP policy. */\n    httpAbortedRequests?: 'continue' | 'bad' | 'exclude';\n    /** Per-request override for 4xx HTTP policy. */\n    httpClientErrorRequests?: 'continue' | 'bad' | 'exclude';\n}\n\nfunction pageOrigin(): string {\n    try {\n        return globalThis.location?.origin ?? '';\n    } catch {\n        return '';\n    }\n}\n\nfunction resolveHomeOrigin(instanceBaseURL: string | undefined, origin: string): string {\n    try {\n        const homeBase = instanceBaseURL ?? origin;\n        return new URL(homeBase || 'http://localhost').origin;\n    } catch {\n        return origin;\n    }\n}\n\n/**\n * Endpoint key for timeout / ignore lookup: PATH for same-origin (vs instance baseURL),\n * or \"host/path\" for cross-domain.\n */\nexport function requestKey(\n    url: string | undefined,\n    configBaseURL: string | undefined,\n    instanceBaseURL: string | undefined\n): string {\n    const origin = pageOrigin();\n    const base = configBaseURL ?? instanceBaseURL ?? origin;\n    let abs: URL;\n    try {\n        abs = new URL(url ?? '', base || undefined);\n    } catch {\n        return url ?? '';\n    }\n    const homeOrigin = resolveHomeOrigin(instanceBaseURL, origin);\n    return abs.origin === homeOrigin ? abs.pathname : abs.host + abs.pathname;\n}\n"],"names":["pageOrigin","globalThis","location","origin","resolveHomeOrigin","instanceBaseURL","homeBase","URL","requestKey","url","configBaseURL","base","abs","undefined","homeOrigin","pathname","host"],"mappings":"AAAA;;;;;CAKC,GAYD,SAASA;IACL,IAAI;;YACOC;QAAP,gBAAOA,uBAAAA,WAAWC,QAAQ,cAAnBD,2CAAAA,qBAAqBE,MAAM,uCAAI;IAC1C,EAAE,eAAM;QACJ,OAAO;IACX;AACJ;AAEA,SAASC,kBAAkBC,eAAmC,EAAEF,MAAc;IAC1E,IAAI;QACA,MAAMG,WAAWD,4BAAAA,6BAAAA,kBAAmBF;QACpC,OAAO,IAAII,IAAID,YAAY,oBAAoBH,MAAM;IACzD,EAAE,eAAM;QACJ,OAAOA;IACX;AACJ;AAEA;;;CAGC,GACD,OAAO,SAASK,WACZC,GAAuB,EACvBC,aAAiC,EACjCL,eAAmC;QAGtBK;IADb,MAAMP,SAASH;IACf,MAAMW,QAAOD,OAAAA,0BAAAA,2BAAAA,gBAAiBL,6BAAjBK,kBAAAA,OAAoCP;IACjD,IAAIS;IACJ,IAAI;QACAA,MAAM,IAAIL,IAAIE,gBAAAA,iBAAAA,MAAO,IAAIE,QAAQE;IACrC,EAAE,eAAM;QACJ,OAAOJ,gBAAAA,iBAAAA,MAAO;IAClB;IACA,MAAMK,aAAaV,kBAAkBC,iBAAiBF;IACtD,OAAOS,IAAIT,MAAM,KAAKW,aAAaF,IAAIG,QAAQ,GAAGH,IAAII,IAAI,GAAGJ,IAAIG,QAAQ;AAC7E"}

package/dist/integrations/soft-skip.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Soft-accept an instrumentation target. Never throws.
+ * - `null` / `undefined` → `console.warn` and return `undefined`
+ * - fails `isValid` → `console.error` and return `undefined`
+ */
+export declare function acceptInstrumentTarget<T>(kind: string, value: unknown, isValid: (value: unknown) => value is T): T | undefined;
+//# sourceMappingURL=soft-skip.d.ts.map

package/dist/integrations/soft-skip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soft-skip.d.ts","sourceRoot":"","sources":["../../src/integrations/soft-skip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACxC,CAAC,GAAG,SAAS,CAcf"}

package/dist/integrations/soft-skip.js

@@ -0,0 +1,30 @@
+/**
+ * Soft-accept an instrumentation target. Never throws.
+ * - `null` / `undefined` → `console.warn` and return `undefined`
+ * - fails `isValid` → `console.error` and return `undefined`
+ */ export function acceptInstrumentTarget(kind, value, isValid) {
+    if (value == null) {
+        // eslint-disable-next-line no-console -- soft-skip missing host wiring
+        console.warn(`[journey] instrument${kind}: skipped — missing`);
+        return undefined;
+    }
+    if (!isValid(value)) {
+        // eslint-disable-next-line no-console -- soft-skip invalid host wiring
+        console.error(`[journey] instrument${kind}: skipped — invalid shape (${describeTarget(value)})`);
+        return undefined;
+    }
+    return value;
+}
+function describeTarget(value) {
+    const kind = typeof value;
+    if (value != null && (kind === 'object' || kind === 'function')) {
+        var _value_constructor;
+        const name = (_value_constructor = value.constructor) === null || _value_constructor === void 0 ? void 0 : _value_constructor.name;
+        if (typeof name === 'string' && name !== '' && name !== 'Object') {
+            return `${kind} ${name}`;
+        }
+    }
+    return kind;
+}
+
+//# sourceMappingURL=soft-skip.js.map

package/dist/integrations/soft-skip.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/integrations/soft-skip.ts"],"sourcesContent":["/**\n * Soft-accept an instrumentation target. Never throws.\n * - `null` / `undefined` → `console.warn` and return `undefined`\n * - fails `isValid` → `console.error` and return `undefined`\n */\nexport function acceptInstrumentTarget<T>(\n    kind: string,\n    value: unknown,\n    isValid: (value: unknown) => value is T\n): T | undefined {\n    if (value == null) {\n        // eslint-disable-next-line no-console -- soft-skip missing host wiring\n        console.warn(`[journey] instrument${kind}: skipped — missing`);\n        return undefined;\n    }\n    if (!isValid(value)) {\n        // eslint-disable-next-line no-console -- soft-skip invalid host wiring\n        console.error(\n            `[journey] instrument${kind}: skipped — invalid shape (${describeTarget(value)})`\n        );\n        return undefined;\n    }\n    return value;\n}\n\nfunction describeTarget(value: unknown): string {\n    const kind = typeof value;\n    if (value != null && (kind === 'object' || kind === 'function')) {\n        const name = (value as { constructor?: { name?: string } }).constructor?.name;\n        if (typeof name === 'string' && name !== '' && name !== 'Object') {\n            return `${kind} ${name}`;\n        }\n    }\n    return kind;\n}\n"],"names":["acceptInstrumentTarget","kind","value","isValid","console","warn","undefined","error","describeTarget","name"],"mappings":"AAAA;;;;CAIC,GACD,OAAO,SAASA,uBACZC,IAAY,EACZC,KAAc,EACdC,OAAuC;IAEvC,IAAID,SAAS,MAAM;QACf,uEAAuE;QACvEE,QAAQC,IAAI,CAAC,CAAC,oBAAoB,EAAEJ,KAAK,mBAAmB,CAAC;QAC7D,OAAOK;IACX;IACA,IAAI,CAACH,QAAQD,QAAQ;QACjB,uEAAuE;QACvEE,QAAQG,KAAK,CACT,CAAC,oBAAoB,EAAEN,KAAK,2BAA2B,EAAEO,eAAeN,OAAO,CAAC,CAAC;QAErF,OAAOI;IACX;IACA,OAAOJ;AACX;AAEA,SAASM,eAAeN,KAAc;IAClC,MAAMD,OAAO,OAAOC;IACpB,IAAIA,SAAS,QAASD,CAAAA,SAAS,YAAYA,SAAS,UAAS,GAAI;YAChD;QAAb,MAAMQ,QAAO,qBAAA,AAACP,MAA8C,WAAW,cAA1D,yCAAA,mBAA4DO,IAAI;QAC7E,IAAI,OAAOA,SAAS,YAAYA,SAAS,MAAMA,SAAS,UAAU;YAC9D,OAAO,GAAGR,KAAK,CAAC,EAAEQ,MAAM;QAC5B;IACJ;IACA,OAAOR;AACX"}

package/dist/sinks/console.d.ts

@@ -0,0 +1,11 @@
+import type { JourneyEvent } from '../core/types';
+/**
+ * Log a terminal journey to the browser console when debugging is enabled.
+ * No-op unless `__stJourney.enableDebugging()` / `enableJourneyDebugging()` was used
+ * (reload after enabling from DevTools).
+ *
+ * There is no reliable cross-browser API to detect an open DevTools console;
+ * use the explicit debug flag instead.
+ */
+export declare function sendToConsole(event: JourneyEvent): void;
+//# sourceMappingURL=console.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/sinks/console.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAQvD"}

package/dist/sinks/console.js

@@ -0,0 +1,19 @@
+import { isSanitizedJourneyEvent, sanitizeJourneyEvent } from '../core/sanitize';
+import { isJourneyDebugEnabled } from '../global';
+/**
+ * Log a terminal journey to the browser console when debugging is enabled.
+ * No-op unless `__stJourney.enableDebugging()` / `enableJourneyDebugging()` was used
+ * (reload after enabling from DevTools).
+ *
+ * There is no reliable cross-browser API to detect an open DevTools console;
+ * use the explicit debug flag instead.
+ */ export function sendToConsole(event) {
+    if (!isJourneyDebugEnabled()) {
+        return;
+    }
+    const j = isSanitizedJourneyEvent(event) ? event.journey : sanitizeJourneyEvent(event).journey;
+    // eslint-disable-next-line no-console -- intentional debug sink
+    console.debug(`[journey] ${j.name} → ${j.outcome}`, j);
+}
+
+//# sourceMappingURL=console.js.map

package/dist/sinks/console.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sinks/console.ts"],"sourcesContent":["import { isSanitizedJourneyEvent, sanitizeJourneyEvent } from '../core/sanitize';\nimport { isJourneyDebugEnabled } from '../global';\nimport type { JourneyEvent } from '../core/types';\n\n/**\n * Log a terminal journey to the browser console when debugging is enabled.\n * No-op unless `__stJourney.enableDebugging()` / `enableJourneyDebugging()` was used\n * (reload after enabling from DevTools).\n *\n * There is no reliable cross-browser API to detect an open DevTools console;\n * use the explicit debug flag instead.\n */\nexport function sendToConsole(event: JourneyEvent): void {\n    if (!isJourneyDebugEnabled()) {\n        return;\n    }\n\n    const j = isSanitizedJourneyEvent(event) ? event.journey : sanitizeJourneyEvent(event).journey;\n    // eslint-disable-next-line no-console -- intentional debug sink\n    console.debug(`[journey] ${j.name} → ${j.outcome}`, j);\n}\n"],"names":["isSanitizedJourneyEvent","sanitizeJourneyEvent","isJourneyDebugEnabled","sendToConsole","event","j","journey","console","debug","name","outcome"],"mappings":"AAAA,SAASA,uBAAuB,EAAEC,oBAAoB,QAAQ,mBAAmB;AACjF,SAASC,qBAAqB,QAAQ,YAAY;AAGlD;;;;;;;CAOC,GACD,OAAO,SAASC,cAAcC,KAAmB;IAC7C,IAAI,CAACF,yBAAyB;QAC1B;IACJ;IAEA,MAAMG,IAAIL,wBAAwBI,SAASA,MAAME,OAAO,GAAGL,qBAAqBG,OAAOE,OAAO;IAC9F,gEAAgE;IAChEC,QAAQC,KAAK,CAAC,CAAC,UAAU,EAAEH,EAAEI,IAAI,CAAC,GAAG,EAAEJ,EAAEK,OAAO,EAAE,EAAEL;AACxD"}

package/dist/sinks/datadog.d.ts

@@ -1,5 +1,16 @@
 import type { JourneyEvent } from '../core/types';
-/** Host-only: publish the initialized RUM instance so MFE bundles share the same session. */
+export { normalizeTagValue } from '../core/sanitize';
+/**
+ * Publish a RUM instance for MFE bundles to share — **only needed if
+ * `globalThis.DD_RUM` is not set**.
+ *
+ * Prefer exposing the initialized instance as `globalThis.DD_RUM` (ST host:
+ * `datadogGuard`). `sendToDatadog` resolves `DD_RUM` first, then `__stJourney.rum`
+ * (this fallback), then the bundle's imported `datadogRum`.
+ *
+ * Calling `setJourneyRum` while `globalThis.DD_RUM` is already set logs a warning —
+ * the call is redundant because `sendToDatadog` prefers `DD_RUM`.
+ */
 export declare function setJourneyRum(rum: unknown): void;
 /** Ship one terminal journey as a RUM custom action (`user_journey`). */
 export declare function sendToDatadog(payload: JourneyEvent): void;

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

@@ -1 +1 @@
-{"version":3,"file":"datadog.d.ts","sourceRoot":"","sources":["../../src/sinks/datadog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,eAAe,CAAC;AAM9E,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAEhD;AAwCD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAkBzD"}
+{"version":3,"file":"datadog.d.ts","sourceRoot":"","sources":["../../src/sinks/datadog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAUrD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQhD;AA2BD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CA0BzD"}

package/dist/sinks/datadog.js

@@ -1,24 +1,36 @@
 import { datadogRum } from '@datadog/browser-rum';
+import { isSanitizedJourneyEvent, sanitizeJourneyEvent } from '../core/sanitize';
+import { getJourneyRumFallback, setJourneyRumFallback } from '../global';
+export { normalizeTagValue } from '../core/sanitize';
 const JOURNEY_ACTION = 'user_journey';
-const RUM_GLOBAL_KEY = '__stJourneyRum';
-/** Host-only: publish the initialized RUM instance so MFE bundles share the same session. */ export function setJourneyRum(rum) {
-    globalThis[RUM_GLOBAL_KEY] = rum;
+const DD_RUM_KEY = 'DD_RUM';
+function getDdRum() {
+    return globalThis[DD_RUM_KEY];
 }
-function resolveRum() {
-    const shared = globalThis[RUM_GLOBAL_KEY];
-    return shared !== null && shared !== void 0 ? shared : datadogRum;
-}
-// Match Datadog metric-tag value rules so RUM attributes join derived SLO tags.
-const MAX_TAG_VALUE_LEN = 200;
-function normalizeTagValue(value) {
-    return value.toLowerCase().replace(/[^a-z0-9_\-:./]/g, '_').replace(/_+/g, '_').slice(0, MAX_TAG_VALUE_LEN).replace(/_+$/, '');
+/**
+ * Publish a RUM instance for MFE bundles to share — **only needed if
+ * `globalThis.DD_RUM` is not set**.
+ *
+ * Prefer exposing the initialized instance as `globalThis.DD_RUM` (ST host:
+ * `datadogGuard`). `sendToDatadog` resolves `DD_RUM` first, then `__stJourney.rum`
+ * (this fallback), then the bundle's imported `datadogRum`.
+ *
+ * Calling `setJourneyRum` while `globalThis.DD_RUM` is already set logs a warning —
+ * the call is redundant because `sendToDatadog` prefers `DD_RUM`.
+ */ export function setJourneyRum(rum) {
+    if (getDdRum()) {
+        // eslint-disable-next-line no-console -- soft-deprecate redundant bridge use
+        console.warn('[journey] setJourneyRum() is unnecessary when globalThis.DD_RUM is set — sendToDatadog already prefers DD_RUM');
+    }
+    setJourneyRumFallback(rum);
 }
-function normalizeTags(tags) {
-    const out = {};
-    for (const [key, value] of Object.entries(tags)){
-        out[key] = typeof value === 'string' ? normalizeTagValue(value) : value;
+function resolveRum() {
+    const ddRum = getDdRum();
+    if (ddRum) {
+        return ddRum;
     }
-    return out;
+    const shared = getJourneyRumFallback();
+    return shared !== null && shared !== void 0 ? shared : datadogRum;
 }
 function toDatadogStep(step) {
     /* eslint-disable @typescript-eslint/naming-convention -- Datadog RUM wire format (snake_case) */ return {
@@ -32,22 +44,27 @@ function toDatadogStep(step) {
         ...step.httpStatus !== undefined ? {
             http_status: step.httpStatus
         } : {},
-        ...step.attributes ? {
+        ...step.attributes && Object.keys(step.attributes).length ? {
             attributes: step.attributes
         } : {}
     };
 /* eslint-enable @typescript-eslint/naming-convention */ }
 /** Ship one terminal journey as a RUM custom action (`user_journey`). */ export function sendToDatadog(payload) {
-    const j = payload.journey;
-    /* eslint-disable @typescript-eslint/naming-convention -- Datadog RUM wire format (snake_case) */ resolveRum().addAction(JOURNEY_ACTION, {
+    const rum = resolveRum();
+    // Skip bad/missing host stubs — uninit RUM still buffers addAction safely.
+    if (typeof rum.addAction !== 'function') {
+        return;
+    }
+    const j = isSanitizedJourneyEvent(payload) ? payload.journey : sanitizeJourneyEvent(payload).journey;
+    /* eslint-disable @typescript-eslint/naming-convention -- Datadog RUM wire format (snake_case) */ rum.addAction(JOURNEY_ACTION, {
         journey: {
-            name: normalizeTagValue(j.name),
-            team: normalizeTagValue(j.team),
-            group: normalizeTagValue(j.group),
-            service: normalizeTagValue(j.service),
+            name: j.name,
+            team: j.team,
+            group: j.group,
+            service: j.service,
             outcome: j.outcome,
             ...j.reason ? {
-                reason: normalizeTagValue(j.reason)
+                reason: j.reason
             } : {},
             duration_ms: j.durationMs,
             steps: j.steps.map(toDatadogStep),
@@ -55,7 +72,7 @@ function toDatadogStep(step) {
                 expected: j.expected
             } : {},
             ...j.tags ? {
-                tags: normalizeTags(j.tags)
+                tags: j.tags
             } : {}
         }
     });

package/dist/sinks/datadog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sinks/datadog.ts"],"sourcesContent":["import { datadogRum } from '@datadog/browser-rum';\n\nimport type { JourneyEvent, JourneyStepEvent, TagValue } from '../core/types';\n\nconst JOURNEY_ACTION = 'user_journey';\n\nconst RUM_GLOBAL_KEY = '__stJourneyRum';\n\n/** Host-only: publish the initialized RUM instance so MFE bundles share the same session. */\nexport function setJourneyRum(rum: unknown): void {\n    (globalThis as Record<string, unknown>)[RUM_GLOBAL_KEY] = rum;\n}\n\nfunction resolveRum(): typeof datadogRum {\n    const shared = (globalThis as Record<string, unknown>)[RUM_GLOBAL_KEY];\n    return (shared as typeof datadogRum | undefined) ?? datadogRum;\n}\n\n// Match Datadog metric-tag value rules so RUM attributes join derived SLO tags.\nconst MAX_TAG_VALUE_LEN = 200;\nfunction normalizeTagValue(value: string): string {\n    return value\n        .toLowerCase()\n        .replace(/[^a-z0-9_\\-:./]/g, '_')\n        .replace(/_+/g, '_')\n        .slice(0, MAX_TAG_VALUE_LEN)\n        .replace(/_+$/, '');\n}\n\nfunction normalizeTags(tags: Record<string, TagValue>): Record<string, TagValue> {\n    const out: Record<string, TagValue> = {};\n    for (const [key, value] of Object.entries(tags)) {\n        out[key] = typeof value === 'string' ? normalizeTagValue(value) : value;\n    }\n    return out;\n}\n\nfunction toDatadogStep(step: JourneyStepEvent) {\n    /* eslint-disable @typescript-eslint/naming-convention -- Datadog RUM wire format (snake_case) */\n    return {\n        name: step.name,\n        start_ms: step.startMs,\n        duration_ms: step.durationMs,\n        outcome: step.outcome,\n        ...(step.reason ? { reason: step.reason } : {}),\n        ...(step.httpStatus !== undefined ? { http_status: step.httpStatus } : {}),\n        ...(step.attributes ? { attributes: step.attributes } : {}),\n    };\n    /* eslint-enable @typescript-eslint/naming-convention */\n}\n\n/** Ship one terminal journey as a RUM custom action (`user_journey`). */\nexport function sendToDatadog(payload: JourneyEvent): void {\n    const j = payload.journey;\n    /* eslint-disable @typescript-eslint/naming-convention -- Datadog RUM wire format (snake_case) */\n    resolveRum().addAction(JOURNEY_ACTION, {\n        journey: {\n            name: normalizeTagValue(j.name),\n            team: normalizeTagValue(j.team),\n            group: normalizeTagValue(j.group),\n            service: normalizeTagValue(j.service),\n            outcome: j.outcome,\n            ...(j.reason ? { reason: normalizeTagValue(j.reason) } : {}),\n            duration_ms: j.durationMs,\n            steps: j.steps.map(toDatadogStep),\n            ...(j.expected ? { expected: j.expected } : {}),\n            ...(j.tags ? { tags: normalizeTags(j.tags) } : {}),\n        },\n    });\n    /* eslint-enable @typescript-eslint/naming-convention */\n}\n"],"names":["datadogRum","JOURNEY_ACTION","RUM_GLOBAL_KEY","setJourneyRum","rum","globalThis","resolveRum","shared","MAX_TAG_VALUE_LEN","normalizeTagValue","value","toLowerCase","replace","slice","normalizeTags","tags","out","key","Object","entries","toDatadogStep","step","name","start_ms","startMs","duration_ms","durationMs","outcome","reason","httpStatus","undefined","http_status","attributes","sendToDatadog","payload","j","journey","addAction","team","group","service","steps","map","expected"],"mappings":"AAAA,SAASA,UAAU,QAAQ,uBAAuB;AAIlD,MAAMC,iBAAiB;AAEvB,MAAMC,iBAAiB;AAEvB,2FAA2F,GAC3F,OAAO,SAASC,cAAcC,GAAY;IACrCC,UAAsC,CAACH,eAAe,GAAGE;AAC9D;AAEA,SAASE;IACL,MAAMC,SAAS,AAACF,UAAsC,CAACH,eAAe;IACtE,OAAQK,mBAAAA,oBAAAA,SAA4CP;AACxD;AAEA,gFAAgF;AAChF,MAAMQ,oBAAoB;AAC1B,SAASC,kBAAkBC,KAAa;IACpC,OAAOA,MACFC,WAAW,GACXC,OAAO,CAAC,oBAAoB,KAC5BA,OAAO,CAAC,OAAO,KACfC,KAAK,CAAC,GAAGL,mBACTI,OAAO,CAAC,OAAO;AACxB;AAEA,SAASE,cAAcC,IAA8B;IACjD,MAAMC,MAAgC,CAAC;IACvC,KAAK,MAAM,CAACC,KAAKP,MAAM,IAAIQ,OAAOC,OAAO,CAACJ,MAAO;QAC7CC,GAAG,CAACC,IAAI,GAAG,OAAOP,UAAU,WAAWD,kBAAkBC,SAASA;IACtE;IACA,OAAOM;AACX;AAEA,SAASI,cAAcC,IAAsB;IACzC,+FAA+F,GAC/F,OAAO;QACHC,MAAMD,KAAKC,IAAI;QACfC,UAAUF,KAAKG,OAAO;QACtBC,aAAaJ,KAAKK,UAAU;QAC5BC,SAASN,KAAKM,OAAO;QACrB,GAAIN,KAAKO,MAAM,GAAG;YAAEA,QAAQP,KAAKO,MAAM;QAAC,IAAI,CAAC,CAAC;QAC9C,GAAIP,KAAKQ,UAAU,KAAKC,YAAY;YAAEC,aAAaV,KAAKQ,UAAU;QAAC,IAAI,CAAC,CAAC;QACzE,GAAIR,KAAKW,UAAU,GAAG;YAAEA,YAAYX,KAAKW,UAAU;QAAC,IAAI,CAAC,CAAC;IAC9D;AACA,sDAAsD,GAC1D;AAEA,uEAAuE,GACvE,OAAO,SAASC,cAAcC,OAAqB;IAC/C,MAAMC,IAAID,QAAQE,OAAO;IACzB,+FAA+F,GAC/F9B,aAAa+B,SAAS,CAACpC,gBAAgB;QACnCmC,SAAS;YACLd,MAAMb,kBAAkB0B,EAAEb,IAAI;YAC9BgB,MAAM7B,kBAAkB0B,EAAEG,IAAI;YAC9BC,OAAO9B,kBAAkB0B,EAAEI,KAAK;YAChCC,SAAS/B,kBAAkB0B,EAAEK,OAAO;YACpCb,SAASQ,EAAER,OAAO;YAClB,GAAIQ,EAAEP,MAAM,GAAG;gBAAEA,QAAQnB,kBAAkB0B,EAAEP,MAAM;YAAE,IAAI,CAAC,CAAC;YAC3DH,aAAaU,EAAET,UAAU;YACzBe,OAAON,EAAEM,KAAK,CAACC,GAAG,CAACtB;YACnB,GAAIe,EAAEQ,QAAQ,GAAG;gBAAEA,UAAUR,EAAEQ,QAAQ;YAAC,IAAI,CAAC,CAAC;YAC9C,GAAIR,EAAEpB,IAAI,GAAG;gBAAEA,MAAMD,cAAcqB,EAAEpB,IAAI;YAAE,IAAI,CAAC,CAAC;QACrD;IACJ;AACA,sDAAsD,GAC1D"}
+{"version":3,"sources":["../../src/sinks/datadog.ts"],"sourcesContent":["import { datadogRum } from '@datadog/browser-rum';\n\nimport { isSanitizedJourneyEvent, sanitizeJourneyEvent } from '../core/sanitize';\nimport { getJourneyRumFallback, setJourneyRumFallback } from '../global';\nimport type { JourneyEvent, JourneyStepEvent } from '../core/types';\n\nexport { normalizeTagValue } from '../core/sanitize';\n\nconst JOURNEY_ACTION = 'user_journey';\n\nconst DD_RUM_KEY = 'DD_RUM';\n\nfunction getDdRum(): typeof datadogRum | undefined {\n    return (globalThis as Record<string, unknown>)[DD_RUM_KEY] as typeof datadogRum | undefined;\n}\n\n/**\n * Publish a RUM instance for MFE bundles to share — **only needed if\n * `globalThis.DD_RUM` is not set**.\n *\n * Prefer exposing the initialized instance as `globalThis.DD_RUM` (ST host:\n * `datadogGuard`). `sendToDatadog` resolves `DD_RUM` first, then `__stJourney.rum`\n * (this fallback), then the bundle's imported `datadogRum`.\n *\n * Calling `setJourneyRum` while `globalThis.DD_RUM` is already set logs a warning —\n * the call is redundant because `sendToDatadog` prefers `DD_RUM`.\n */\nexport function setJourneyRum(rum: unknown): void {\n    if (getDdRum()) {\n        // eslint-disable-next-line no-console -- soft-deprecate redundant bridge use\n        console.warn(\n            '[journey] setJourneyRum() is unnecessary when globalThis.DD_RUM is set — sendToDatadog already prefers DD_RUM'\n        );\n    }\n    setJourneyRumFallback(rum);\n}\n\nfunction resolveRum(): typeof datadogRum {\n    const ddRum = getDdRum();\n    if (ddRum) {\n        return ddRum;\n    }\n    const shared = getJourneyRumFallback();\n    return (shared as typeof datadogRum | undefined) ?? datadogRum;\n}\n\nfunction toDatadogStep(step: JourneyStepEvent) {\n    /* eslint-disable @typescript-eslint/naming-convention -- Datadog RUM wire format (snake_case) */\n    return {\n        name: step.name,\n        start_ms: step.startMs,\n        duration_ms: step.durationMs,\n        outcome: step.outcome,\n        ...(step.reason ? { reason: step.reason } : {}),\n        ...(step.httpStatus !== undefined ? { http_status: step.httpStatus } : {}),\n        ...(step.attributes && Object.keys(step.attributes).length\n            ? { attributes: step.attributes }\n            : {}),\n    };\n    /* eslint-enable @typescript-eslint/naming-convention */\n}\n\n/** Ship one terminal journey as a RUM custom action (`user_journey`). */\nexport function sendToDatadog(payload: JourneyEvent): void {\n    const rum = resolveRum();\n    // Skip bad/missing host stubs — uninit RUM still buffers addAction safely.\n    if (typeof rum.addAction !== 'function') {\n        return;\n    }\n\n    const j = isSanitizedJourneyEvent(payload)\n        ? payload.journey\n        : sanitizeJourneyEvent(payload).journey;\n    /* eslint-disable @typescript-eslint/naming-convention -- Datadog RUM wire format (snake_case) */\n    rum.addAction(JOURNEY_ACTION, {\n        journey: {\n            name: j.name,\n            team: j.team,\n            group: j.group,\n            service: j.service,\n            outcome: j.outcome,\n            ...(j.reason ? { reason: j.reason } : {}),\n            duration_ms: j.durationMs,\n            steps: j.steps.map(toDatadogStep),\n            ...(j.expected ? { expected: j.expected } : {}),\n            ...(j.tags ? { tags: j.tags } : {}),\n        },\n    });\n    /* eslint-enable @typescript-eslint/naming-convention */\n}\n"],"names":["datadogRum","isSanitizedJourneyEvent","sanitizeJourneyEvent","getJourneyRumFallback","setJourneyRumFallback","normalizeTagValue","JOURNEY_ACTION","DD_RUM_KEY","getDdRum","globalThis","setJourneyRum","rum","console","warn","resolveRum","ddRum","shared","toDatadogStep","step","name","start_ms","startMs","duration_ms","durationMs","outcome","reason","httpStatus","undefined","http_status","attributes","Object","keys","length","sendToDatadog","payload","addAction","j","journey","team","group","service","steps","map","expected","tags"],"mappings":"AAAA,SAASA,UAAU,QAAQ,uBAAuB;AAElD,SAASC,uBAAuB,EAAEC,oBAAoB,QAAQ,mBAAmB;AACjF,SAASC,qBAAqB,EAAEC,qBAAqB,QAAQ,YAAY;AAGzE,SAASC,iBAAiB,QAAQ,mBAAmB;AAErD,MAAMC,iBAAiB;AAEvB,MAAMC,aAAa;AAEnB,SAASC;IACL,OAAO,AAACC,UAAsC,CAACF,WAAW;AAC9D;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASG,cAAcC,GAAY;IACtC,IAAIH,YAAY;QACZ,6EAA6E;QAC7EI,QAAQC,IAAI,CACR;IAER;IACAT,sBAAsBO;AAC1B;AAEA,SAASG;IACL,MAAMC,QAAQP;IACd,IAAIO,OAAO;QACP,OAAOA;IACX;IACA,MAAMC,SAASb;IACf,OAAQa,mBAAAA,oBAAAA,SAA4ChB;AACxD;AAEA,SAASiB,cAAcC,IAAsB;IACzC,+FAA+F,GAC/F,OAAO;QACHC,MAAMD,KAAKC,IAAI;QACfC,UAAUF,KAAKG,OAAO;QACtBC,aAAaJ,KAAKK,UAAU;QAC5BC,SAASN,KAAKM,OAAO;QACrB,GAAIN,KAAKO,MAAM,GAAG;YAAEA,QAAQP,KAAKO,MAAM;QAAC,IAAI,CAAC,CAAC;QAC9C,GAAIP,KAAKQ,UAAU,KAAKC,YAAY;YAAEC,aAAaV,KAAKQ,UAAU;QAAC,IAAI,CAAC,CAAC;QACzE,GAAIR,KAAKW,UAAU,IAAIC,OAAOC,IAAI,CAACb,KAAKW,UAAU,EAAEG,MAAM,GACpD;YAAEH,YAAYX,KAAKW,UAAU;QAAC,IAC9B,CAAC,CAAC;IACZ;AACA,sDAAsD,GAC1D;AAEA,uEAAuE,GACvE,OAAO,SAASI,cAAcC,OAAqB;IAC/C,MAAMvB,MAAMG;IACZ,2EAA2E;IAC3E,IAAI,OAAOH,IAAIwB,SAAS,KAAK,YAAY;QACrC;IACJ;IAEA,MAAMC,IAAInC,wBAAwBiC,WAC5BA,QAAQG,OAAO,GACfnC,qBAAqBgC,SAASG,OAAO;IAC3C,+FAA+F,GAC/F1B,IAAIwB,SAAS,CAAC7B,gBAAgB;QAC1B+B,SAAS;YACLlB,MAAMiB,EAAEjB,IAAI;YACZmB,MAAMF,EAAEE,IAAI;YACZC,OAAOH,EAAEG,KAAK;YACdC,SAASJ,EAAEI,OAAO;YAClBhB,SAASY,EAAEZ,OAAO;YAClB,GAAIY,EAAEX,MAAM,GAAG;gBAAEA,QAAQW,EAAEX,MAAM;YAAC,IAAI,CAAC,CAAC;YACxCH,aAAac,EAAEb,UAAU;YACzBkB,OAAOL,EAAEK,KAAK,CAACC,GAAG,CAACzB;YACnB,GAAImB,EAAEO,QAAQ,GAAG;gBAAEA,UAAUP,EAAEO,QAAQ;YAAC,IAAI,CAAC,CAAC;YAC9C,GAAIP,EAAEQ,IAAI,GAAG;gBAAEA,MAAMR,EAAEQ,IAAI;YAAC,IAAI,CAAC,CAAC;QACtC;IACJ;AACA,sDAAsD,GAC1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicetitan/journey",
-    "version": "2.0.0",
+    "version": "3.0.0",
     "description": "Critical user journey monitoring — reports good/bad/excluded verdicts to Datadog RUM as a custom action",
     "homepage": "https://docs.st.dev/docs/frontend/journey",
     "repository": {
@@ -41,5 +41,5 @@
     "cli": {
         "webpack": false
     },
-    "gitHead": "af4dee1e6d65f7b611a03a15771adf5a6fa6f45d"
+    "gitHead": "1ebcfc7b65a6b2979cbb89a93d411abe7144ca51"
 }

package/src/{__mocks__ → __test-utils__}/test-runtime.ts

@@ -1,6 +1,11 @@
-import { resetJourney } from '../core';
+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] as const;
+
 /** Standard journey def used across engine suites. */
 export const baseJourneyDef = {
     name: 'journey-under-test',
@@ -21,17 +26,23 @@ export function lastJourney(emitMock: jest.Mock) {
  */
 export function useJourneyTestRuntime(emitMock: jest.Mock) {
     beforeEach(() => {
+        setJourneyDefaultEnabled(true);
+        resetSharedPolicies();
         resetJourney({
             sinks: [emitMock],
-            requestTimeouts: { defaultMs: 4_000, endpoints: [] },
+            slowRequests: { defaultMs: 4_000, endpoints: [] },
         });
         emitMock.mockClear();
     });
 
     afterEach(() => {
+        setJourneyDefaultEnabled(false);
+        localStorage.clear();
+        sessionStorage.clear();
+        resetSharedPolicies();
         resetJourney({
-            sinks: [sendToDatadog],
-            requestTimeouts: { defaultMs: 4_000, endpoints: [] },
+            sinks: [...DEFAULT_SINKS],
+            slowRequests: { defaultMs: 4_000, endpoints: [] },
         });
     });
 }