@servicetitan/journey 2.1.0 → 3.0.1

package/dist/core/types.d.ts

@@ -1,9 +1,15 @@
 import type { EndpointPolicy } from './endpoint-policy';
+import type { JourneyHttpScore, JourneyStampOptions, RequestPolicyConfig } from './request-policy';
+import type { JourneyStepStamp } from './step-tag';
 /** Arbitrary tag values a developer can attach. */
 export type TagValue = string | number | boolean;
 /** Config for one journey — supplied by the caller (typically `<JourneyScope>` props). */
 export interface JourneyDef {
-    /** Journey name — lifecycle key, event field, and concurrency map key. */
+    /**
+     * Journey name — lifecycle key, event field, and concurrency map key.
+     * Must be unique among concurrently open journeys on the same runtime
+     * (a second start with the same name restarts / excludes the previous).
+     */
     name: string;
     /** Owner team (required tag). */
     team: string;
@@ -11,16 +17,23 @@ export interface JourneyDef {
     group: string;
     /** Business component label, e.g. "checkout" — not the Datadog RUM service. */
     service: string;
-    /** Whole-journey budget in ms; omit / 0 to disable. */
+    /**
+     * Whole-journey timeout in ms.
+     * - Omit to use the runtime idle timeout default (15m unless overridden)
+     * - Set `0` to disable the journey countdown
+     * - Set `N > 0` to enforce an explicit SLO budget
+     */
     timeoutMs?: number;
     /** Default per-step timeout in ms; per-call option overrides. Omit / 0 to disable. */
     stepTimeoutMs?: number;
-    /** Slow-request threshold for this journey; falls back to app-wide default. */
-    requestTimeoutMs?: number;
+    /** Slow-request threshold for this journey; omit to fall through. `0` disables latency scoring. */
+    slowRequestMs?: number;
     /** Per-endpoint overrides for this journey (longest prefix wins over app-wide). */
     endpoints?: readonly EndpointPolicy[];
-    /** Optional expected step names (rides as `expected` on the event). */
-    steps?: readonly string[];
+    /** Optional expected happy-path step names (copied onto the event as `expected`). */
+    expected?: readonly string[];
+    /** Cap recorded steps for this journey; falls back to the runtime default (50). */
+    maxSteps?: number;
     /** Custom tags on every event of this journey. */
     tags?: Record<string, TagValue>;
 }
@@ -28,29 +41,33 @@ export type Outcome = 'good' | 'bad' | 'excluded';
 /** Handle passed to each step function. */
 export interface StepHandle {
     /** Resolved journey name for this step, or null if untraced. */
-    readonly name: string | null;
+    readonly journeyName: string | null;
     setAttribute(key: string, value: string | number | boolean): void;
     /** Journey-level tags without closing. */
     setTags(tags: Record<string, TagValue>): void;
-    /** Apply optional tags then completeJourney. No-op if name is null. */
-    complete(tags?: Record<string, TagValue>): void;
-    /** Soft business Bad without throw. No-op if name is null. */
-    fail(reason: string): void;
+    /** Apply optional tags then complete the whole journey. No-op if journeyName is null. */
+    completeJourney(tags?: Record<string, TagValue>): void;
+    /** Soft business Bad without throw. Closes the whole journey. No-op if journeyName is null. */
+    failJourney(reason: string): void;
     /**
-     * Bind this step to a request explicitly (spread into axios config / fetch init /
-     * jQuery ajax settings). Needed when requests fire after an await or while steps
-     * overlap — see docs soft ambient. Untraced (noop) steps omit `journeyStep`.
+     * Bind this step to a request explicitly. Pass as `{ stamp: step.stamp() }` on
+     * axios config / fetch init / jQuery ajax settings. Needed when requests fire
+     * after an await, while steps overlap, or when `autoAttributeRequests` is false.
+     * Untraced (noop) steps return `undefined`.
      *
-     * The value is a non-plain {@link JourneyStepTag} so jQuery/axios deep-merge will
+     * Pass `score` (or `{ score, ignore }`) to score or skip this stamped request.
+     * Auto-attributed requests never run a score function and never set ignore.
+     *
+     * The value is a non-plain {@link JourneyStepStamp} so jQuery/axios deep-merge will
      * not recurse into the circular StepRecord graph.
      */
-    tag(): {
-        journeyStep?: unknown;
-    };
+    stamp(scoreOrOpts?: JourneyHttpScore | JourneyStampOptions): JourneyStepStamp | undefined;
 }
-/** A journey name, or anything with a `name` (e.g. a JourneyHandle / JourneyDef). */
+/** A journey name, a config object, or a handle (`handle.config.name`). */
 export type JourneyNameLike = string | {
     readonly name: string;
+} | {
+    readonly config: JourneyDef;
 };
 /** First argument to journeyStep / journeyMountStep. */
 export type JourneyStepTarget = JourneyNameLike | null | readonly JourneyNameLike[];
@@ -59,6 +76,24 @@ export interface JourneyStepOptions {
     /** Timeout for this step in ms; overrides journey stepTimeoutMs. Omit / 0 to disable. */
     timeoutMs?: number;
 }
+/**
+ * @internal Cross-bundle key for the engine that created a {@link JourneyState}.
+ * Host adapters read this off an MFE `step.stamp()` so abort/4xx/5xx close the owning copy.
+ */
+export declare const JOURNEY_ENGINE: unique symbol;
+/**
+ * @internal Bound fail/exclude/report hooks for a journey's creating engine.
+ * Name lookup on another package copy cannot see this journey.
+ */
+export interface JourneyEngine {
+    /** Close this journey as bad on the creating engine — not a by-name lookup. */
+    failJourney(reason: string): void;
+    exclude(): void;
+    shouldIgnoreRequest(key: string): boolean;
+    reportBackendRequest(step: StepRecord, status: number | undefined, durationMs: number, requestKey: string): void;
+    getHttpAbortedRequestsPolicy(): RequestPolicyConfig;
+    getHttpClientErrorRequestsPolicy(): RequestPolicyConfig;
+}
 /** @internal Engine open-journey record — not part of the supported public API. */
 export interface JourneyState {
     name: string;
@@ -68,6 +103,8 @@ export interface JourneyState {
     verdict: Outcome;
     startedAt: number;
     timeoutMs: number;
+    /** True when JourneyDef.timeoutMs was explicitly provided by caller. */
+    timeoutExplicit: boolean;
     stepTimeoutMs?: number;
     /**
      * Why the journey closed as bad, else null.
@@ -78,10 +115,14 @@ export interface JourneyState {
     steps: StepRecord[];
     expected: string[] | null;
     tags: Record<string, TagValue>;
-    requestTimeoutMs?: number;
+    slowRequestMs?: number;
     endpoints?: readonly EndpointPolicy[];
     timer: ReturnType<typeof setTimeout> | null;
     closed: boolean;
+    maxSteps?: number;
+    /** Frozen snapshot taken at start — not the caller's original object. */
+    config: JourneyDef;
+    [JOURNEY_ENGINE]?: JourneyEngine;
 }
 /** @internal Engine in-flight / completed step record — not part of the supported public API. */
 export interface StepRecord {
@@ -93,9 +134,11 @@ export interface StepRecord {
     httpStatus?: number;
     attributes: Record<string, string | number | boolean>;
     journey: JourneyState;
+    /** True after onHttpComplete handled an abort for this step (including ignore). */
+    onHttpAborted?: boolean;
+    /** @internal Request keys attributed while this step was in flight (debug). */
+    attributedRequestKeys?: string[];
 }
-/** Opaque handle to a step, captured at request initiation for response attribution. */
-export type JourneyStepRef = StepRecord;
 export interface JourneyStepEvent {
     name: string;
     /** Offset from the journey start, ms. */
@@ -123,9 +166,14 @@ export interface JourneyEvent {
 }
 /** Destination for a terminal journey event. */
 export type JourneySink = (event: JourneyEvent) => void;
-/** Callable journey — config plus lifecycle helpers bound to `name`. Prefer this over free helpers. */
-export interface JourneyHandle extends JourneyDef {
-    /** Open this journey (restarts if already open). */
+/** Callable journey — `config` plus lifecycle helpers. Prefer this over free helpers. */
+export interface JourneyHandle {
+    /** Same config object passed to `defineJourney` / used to start. */
+    readonly config: JourneyDef;
+    /**
+     * Always opens a new instance. If this name is already open, the previous
+     * instance is finished (Bad if it had breached, else Excluded).
+     */
     start(tags?: Record<string, TagValue>): void;
     /**
      * Record a step. Opens the journey first when it isn't already open

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -1,3 +1,6 @@
-/** Callable journey — config plus lifecycle helpers bound to `name`. Prefer this over free helpers. */ export { };
+/**
+ * @internal Cross-bundle key for the engine that created a {@link JourneyState}.
+ * Host adapters read this off an MFE `step.stamp()` so abort/4xx/5xx close the owning copy.
+ */ export const JOURNEY_ENGINE = Symbol.for('st.journey.engine');
 
 //# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["import type { EndpointPolicy } from './endpoint-policy';\n\n/** Arbitrary tag values a developer can attach. */\nexport type TagValue = string | number | boolean;\n\n/** Config for one journey — supplied by the caller (typically `<JourneyScope>` props). */\nexport interface JourneyDef {\n    /** Journey name — lifecycle key, event field, and concurrency map key. */\n    name: string;\n    /** Owner team (required tag). */\n    team: string;\n    /** Functional area, e.g. \"sales\" (required tag). */\n    group: string;\n    /** Business component label, e.g. \"checkout\" — not the Datadog RUM service. */\n    service: string;\n    /** Whole-journey budget in ms; omit / 0 to disable. */\n    timeoutMs?: number;\n    /** Default per-step timeout in ms; per-call option overrides. Omit / 0 to disable. */\n    stepTimeoutMs?: number;\n    /** Slow-request threshold for this journey; falls back to app-wide default. */\n    requestTimeoutMs?: number;\n    /** Per-endpoint overrides for this journey (longest prefix wins over app-wide). */\n    endpoints?: readonly EndpointPolicy[];\n    /** Optional expected step names (rides as `expected` on the event). */\n    steps?: readonly string[];\n    /** Custom tags on every event of this journey. */\n    tags?: Record<string, TagValue>;\n}\n\nexport type Outcome = 'good' | 'bad' | 'excluded';\n\n/** Handle passed to each step function. */\nexport interface StepHandle {\n    /** Resolved journey name for this step, or null if untraced. */\n    readonly name: string | null;\n    setAttribute(key: string, value: string | number | boolean): void;\n    /** Journey-level tags without closing. */\n    setTags(tags: Record<string, TagValue>): void;\n    /** Apply optional tags then completeJourney. No-op if name is null. */\n    complete(tags?: Record<string, TagValue>): void;\n    /** Soft business Bad without throw. No-op if name is null. */\n    fail(reason: string): void;\n    /**\n     * Bind this step to a request explicitly (spread into axios config / fetch init /\n     * jQuery ajax settings). Needed when requests fire after an await or while steps\n     * overlap — see docs soft ambient. Untraced (noop) steps omit `journeyStep`.\n     *\n     * The value is a non-plain {@link JourneyStepTag} so jQuery/axios deep-merge will\n     * not recurse into the circular StepRecord graph.\n     */\n    tag(): { journeyStep?: unknown };\n}\n\n/** A journey name, or anything with a `name` (e.g. a JourneyHandle / JourneyDef). */\nexport type JourneyNameLike = string | { readonly name: string };\n\n/** First argument to journeyStep / journeyMountStep. */\nexport type JourneyStepTarget = JourneyNameLike | null | readonly JourneyNameLike[];\n\n/** Per-call options for journeyStep. */\nexport interface JourneyStepOptions {\n    /** Timeout for this step in ms; overrides journey stepTimeoutMs. Omit / 0 to disable. */\n    timeoutMs?: number;\n}\n\n/** @internal Engine open-journey record — not part of the supported public API. */\nexport interface JourneyState {\n    name: string;\n    team: string;\n    group: string;\n    service: string;\n    verdict: Outcome;\n    startedAt: number;\n    timeoutMs: number;\n    stepTimeoutMs?: number;\n    /**\n     * Why the journey closed as bad, else null.\n     * Engine: request-error | request-latency | journey-timeout | step-timeout | step-error.\n     * Also any custom business reason (e.g. call-not-associated).\n     */\n    reason: string | null;\n    steps: StepRecord[];\n    expected: string[] | null;\n    tags: Record<string, TagValue>;\n    requestTimeoutMs?: number;\n    endpoints?: readonly EndpointPolicy[];\n    timer: ReturnType<typeof setTimeout> | null;\n    closed: boolean;\n}\n\n/** @internal Engine in-flight / completed step record — not part of the supported public API. */\nexport interface StepRecord {\n    name: string;\n    startedAt: number;\n    durationMs: number;\n    outcome: 'good' | 'bad';\n    reason?: string;\n    httpStatus?: number;\n    attributes: Record<string, string | number | boolean>;\n    journey: JourneyState;\n}\n\n/** Opaque handle to a step, captured at request initiation for response attribution. */\nexport type JourneyStepRef = StepRecord;\n\nexport interface JourneyStepEvent {\n    name: string;\n    /** Offset from the journey start, ms. */\n    startMs: number;\n    durationMs: number;\n    outcome: 'good' | 'bad';\n    reason?: string;\n    httpStatus?: number;\n    attributes?: Record<string, TagValue>;\n}\n\n/** Neutral journey event payload (journey-specific fields only; session context is host RUM globals). */\nexport interface JourneyEvent {\n    journey: {\n        name: string;\n        team: string;\n        group: string;\n        service: string;\n        outcome: Outcome;\n        reason?: string;\n        durationMs: number;\n        steps: JourneyStepEvent[];\n        expected?: string[];\n        tags?: Record<string, TagValue>;\n    };\n}\n\n/** Destination for a terminal journey event. */\nexport type JourneySink = (event: JourneyEvent) => void;\n\n/** Callable journey — config plus lifecycle helpers bound to `name`. Prefer this over free helpers. */\nexport interface JourneyHandle extends JourneyDef {\n    /** Open this journey (restarts if already open). */\n    start(tags?: Record<string, TagValue>): void;\n    /**\n     * Record a step. Opens the journey first when it isn't already open\n     * (one-shot store actions); no-op start when a `<JourneyScope>` already opened it.\n     */\n    step<T>(\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n    /**\n     * Like `step`, deferred one microtask for mount-effect use under `<JourneyScope>`\n     * (React runs child effects before parent). Also auto-starts if not already open.\n     */\n    mountStep<T>(\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n    complete(tags?: Record<string, TagValue>): void;\n    fail(reason: string): void;\n    exclude(): void;\n    setTags(tags: Record<string, TagValue>): void;\n}\n"],"names":[],"mappings":"AAuIA,qGAAqG,GACrG,WAyBC"}
+{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["import type { EndpointPolicy } from './endpoint-policy';\nimport type { JourneyHttpScore, JourneyStampOptions, RequestPolicyConfig } from './request-policy';\nimport type { JourneyStepStamp } from './step-tag';\n\n/** Arbitrary tag values a developer can attach. */\nexport type TagValue = string | number | boolean;\n\n/** Config for one journey — supplied by the caller (typically `<JourneyScope>` props). */\nexport interface JourneyDef {\n    /**\n     * Journey name — lifecycle key, event field, and concurrency map key.\n     * Must be unique among concurrently open journeys on the same runtime\n     * (a second start with the same name restarts / excludes the previous).\n     */\n    name: string;\n    /** Owner team (required tag). */\n    team: string;\n    /** Functional area, e.g. \"sales\" (required tag). */\n    group: string;\n    /** Business component label, e.g. \"checkout\" — not the Datadog RUM service. */\n    service: string;\n    /**\n     * Whole-journey timeout in ms.\n     * - Omit to use the runtime idle timeout default (15m unless overridden)\n     * - Set `0` to disable the journey countdown\n     * - Set `N > 0` to enforce an explicit SLO budget\n     */\n    timeoutMs?: number;\n    /** Default per-step timeout in ms; per-call option overrides. Omit / 0 to disable. */\n    stepTimeoutMs?: number;\n    /** Slow-request threshold for this journey; omit to fall through. `0` disables latency scoring. */\n    slowRequestMs?: number;\n    /** Per-endpoint overrides for this journey (longest prefix wins over app-wide). */\n    endpoints?: readonly EndpointPolicy[];\n    /** Optional expected happy-path step names (copied onto the event as `expected`). */\n    expected?: readonly string[];\n    /** Cap recorded steps for this journey; falls back to the runtime default (50). */\n    maxSteps?: number;\n    /** Custom tags on every event of this journey. */\n    tags?: Record<string, TagValue>;\n}\n\nexport type Outcome = 'good' | 'bad' | 'excluded';\n\n/** Handle passed to each step function. */\nexport interface StepHandle {\n    /** Resolved journey name for this step, or null if untraced. */\n    readonly journeyName: string | null;\n    setAttribute(key: string, value: string | number | boolean): void;\n    /** Journey-level tags without closing. */\n    setTags(tags: Record<string, TagValue>): void;\n    /** Apply optional tags then complete the whole journey. No-op if journeyName is null. */\n    completeJourney(tags?: Record<string, TagValue>): void;\n    /** Soft business Bad without throw. Closes the whole journey. No-op if journeyName is null. */\n    failJourney(reason: string): void;\n    /**\n     * Bind this step to a request explicitly. Pass as `{ stamp: step.stamp() }` on\n     * axios config / fetch init / jQuery ajax settings. Needed when requests fire\n     * after an await, while steps overlap, or when `autoAttributeRequests` is false.\n     * Untraced (noop) steps return `undefined`.\n     *\n     * Pass `score` (or `{ score, ignore }`) to score or skip this stamped request.\n     * Auto-attributed requests never run a score function and never set ignore.\n     *\n     * The value is a non-plain {@link JourneyStepStamp} so jQuery/axios deep-merge will\n     * not recurse into the circular StepRecord graph.\n     */\n    stamp(scoreOrOpts?: JourneyHttpScore | JourneyStampOptions): JourneyStepStamp | undefined;\n}\n\n/** A journey name, a config object, or a handle (`handle.config.name`). */\nexport type JourneyNameLike = string | { readonly name: string } | { readonly config: JourneyDef };\n\n/** First argument to journeyStep / journeyMountStep. */\nexport type JourneyStepTarget = JourneyNameLike | null | readonly JourneyNameLike[];\n\n/** Per-call options for journeyStep. */\nexport interface JourneyStepOptions {\n    /** Timeout for this step in ms; overrides journey stepTimeoutMs. Omit / 0 to disable. */\n    timeoutMs?: number;\n}\n\n/**\n * @internal Cross-bundle key for the engine that created a {@link JourneyState}.\n * Host adapters read this off an MFE `step.stamp()` so abort/4xx/5xx close the owning copy.\n */\nexport const JOURNEY_ENGINE = Symbol.for('st.journey.engine');\n\n/**\n * @internal Bound fail/exclude/report hooks for a journey's creating engine.\n * Name lookup on another package copy cannot see this journey.\n */\nexport interface JourneyEngine {\n    /** Close this journey as bad on the creating engine — not a by-name lookup. */\n    failJourney(reason: string): void;\n    exclude(): void;\n    shouldIgnoreRequest(key: string): boolean;\n    reportBackendRequest(\n        step: StepRecord,\n        status: number | undefined,\n        durationMs: number,\n        requestKey: string\n    ): void;\n    getHttpAbortedRequestsPolicy(): RequestPolicyConfig;\n    getHttpClientErrorRequestsPolicy(): RequestPolicyConfig;\n}\n\n/** @internal Engine open-journey record — not part of the supported public API. */\nexport interface JourneyState {\n    name: string;\n    team: string;\n    group: string;\n    service: string;\n    verdict: Outcome;\n    startedAt: number;\n    timeoutMs: number;\n    /** True when JourneyDef.timeoutMs was explicitly provided by caller. */\n    timeoutExplicit: boolean;\n    stepTimeoutMs?: number;\n    /**\n     * Why the journey closed as bad, else null.\n     * Engine: request-error | request-latency | journey-timeout | step-timeout | step-error.\n     * Also any custom business reason (e.g. call-not-associated).\n     */\n    reason: string | null;\n    steps: StepRecord[];\n    expected: string[] | null;\n    tags: Record<string, TagValue>;\n    slowRequestMs?: number;\n    endpoints?: readonly EndpointPolicy[];\n    timer: ReturnType<typeof setTimeout> | null;\n    closed: boolean;\n    maxSteps?: number;\n    /** Frozen snapshot taken at start — not the caller's original object. */\n    config: JourneyDef;\n    [JOURNEY_ENGINE]?: JourneyEngine;\n}\n\n/** @internal Engine in-flight / completed step record — not part of the supported public API. */\nexport interface StepRecord {\n    name: string;\n    startedAt: number;\n    durationMs: number;\n    outcome: 'good' | 'bad';\n    reason?: string;\n    httpStatus?: number;\n    attributes: Record<string, string | number | boolean>;\n    journey: JourneyState;\n    /** True after onHttpComplete handled an abort for this step (including ignore). */\n    onHttpAborted?: boolean;\n    /** @internal Request keys attributed while this step was in flight (debug). */\n    attributedRequestKeys?: string[];\n}\n\nexport interface JourneyStepEvent {\n    name: string;\n    /** Offset from the journey start, ms. */\n    startMs: number;\n    durationMs: number;\n    outcome: 'good' | 'bad';\n    reason?: string;\n    httpStatus?: number;\n    attributes?: Record<string, TagValue>;\n}\n\n/** Neutral journey event payload (journey-specific fields only; session context is host RUM globals). */\nexport interface JourneyEvent {\n    journey: {\n        name: string;\n        team: string;\n        group: string;\n        service: string;\n        outcome: Outcome;\n        reason?: string;\n        durationMs: number;\n        steps: JourneyStepEvent[];\n        expected?: string[];\n        tags?: Record<string, TagValue>;\n    };\n}\n\n/** Destination for a terminal journey event. */\nexport type JourneySink = (event: JourneyEvent) => void;\n\n/** Callable journey — `config` plus lifecycle helpers. Prefer this over free helpers. */\nexport interface JourneyHandle {\n    /** Same config object passed to `defineJourney` / used to start. */\n    readonly config: JourneyDef;\n    /**\n     * Always opens a new instance. If this name is already open, the previous\n     * instance is finished (Bad if it had breached, else Excluded).\n     */\n    start(tags?: Record<string, TagValue>): void;\n    /**\n     * Record a step. Opens the journey first when it isn't already open\n     * (one-shot store actions); no-op start when a `<JourneyScope>` already opened it.\n     */\n    step<T>(\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n    /**\n     * Like `step`, deferred one microtask for mount-effect use under `<JourneyScope>`\n     * (React runs child effects before parent). Also auto-starts if not already open.\n     */\n    mountStep<T>(\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n    complete(tags?: Record<string, TagValue>): void;\n    fail(reason: string): void;\n    exclude(): void;\n    setTags(tags: Record<string, TagValue>): void;\n}\n"],"names":["JOURNEY_ENGINE","Symbol","for"],"mappings":"AAkFA;;;CAGC,GACD,OAAO,MAAMA,iBAAiBC,OAAOC,GAAG,CAAC,qBAAqB"}

package/dist/global.d.ts

@@ -1,3 +1,5 @@
+import type { SlowRequestConfig } from './core/endpoint-policy';
+import { type RequestPolicyConfig } from './core/request-policy';
 import type { JourneyRuntime, JourneyRuntimeDebugSnapshot } from './core/runtime';
 /** Force-enable journey host wiring outside go* hosts (`__stJourney.enable()`). */
 export declare const JOURNEY_ENABLED_STORAGE_KEY = "st:journey:enabled";
@@ -5,19 +7,40 @@ export declare const JOURNEY_ENABLED_STORAGE_KEY = "st:journey:enabled";
 export declare const JOURNEY_DEBUG_STORAGE_KEY = "st:journey:debug";
 /** @internal Shared cross-bundle bag on globalThis (`rum` fallback + DevTools helpers). */
 export declare const ST_JOURNEY_GLOBAL_KEY = "__stJourney";
-export interface JourneyDebugRuntimeEntry extends JourneyRuntimeDebugSnapshot {
-    id: string;
-}
+/** Bump when shared bag shape / policy semantics change incompatibly. */
+export declare const ST_JOURNEY_SCHEMA_VERSION = 2;
 export interface JourneyDebugState {
-    /** Force-enable flag (`st:journey:enabled`). */
+    /** Host default or force-enable (`isJourneyEnabled()`). */
     enabled: boolean;
     /** Console-logging flag (`st:journey:debug`). */
     debug: boolean;
     hasRum: boolean;
-    runtimes: JourneyDebugRuntimeEntry[];
+    runtimes: JourneyRuntimeDebugSnapshot[];
+}
+/** Shared host policies visible to every package copy on the page. */
+export interface JourneySharedPolicies {
+    slowRequests?: SlowRequestConfig;
+    /** Whether shared slowRequests were explicitly set via configureJourney. */
+    slowRequestsConfigured: boolean;
+    httpAbortedRequests: RequestPolicyConfig;
+    httpClientErrorRequests: RequestPolicyConfig;
+    autoAttributeRequests: boolean;
+    /** True after the first configureJourney that set any shared policy knob. */
+    locked: boolean;
+}
+/** DevTools registration — `{ id, getSnapshot }` so older package copies can still list runtimes. */
+export interface RuntimeRegistration {
+    id: string;
+    getSnapshot: () => JourneyRuntimeDebugSnapshot;
+    teardown?: () => void;
+}
+/** @internal Restore/dispose record for HTTP instrumentation. */
+export interface InstrumentRecord {
+    disposed: boolean;
+    restore?: () => void;
 }
 /**
- * @internal Cross-bundle surface on `globalThis.__stJourney`.
+ * Cross-bundle surface on `globalThis.__stJourney`.
  * Prefer importing `isJourneyEnabled` / `isJourneyDebugEnabled` from the package in app code.
  */
 export interface StJourneyGlobal {
@@ -26,6 +49,24 @@ export interface StJourneyGlobal {
      * Prefer `DD_RUM` (ST host: `datadogGuard`).
      */
     rum?: unknown;
+    /** Shared bag schema; mismatched copies warn but continue. */
+    schemaVersion?: number;
+    /** Host default enable (e.g. RUM active). Set via `setJourneyDefaultEnabled`. */
+    defaultEnabled?: boolean;
+    /** Shared configureJourney policies. */
+    policies: JourneySharedPolicies;
+    /**
+     * Bundle runtimes registered for DevTools `getDebugState()`.
+     * `{ id, getSnapshot }` so mixed package copies can list each other.
+     */
+    runtimeRegistrations: RuntimeRegistration[];
+    /** @internal Cross-bundle instrumented axios/fetch/jquery targets. */
+    instrumentedAxios: WeakSet<object>;
+    instrumentedFetch: WeakSet<object>;
+    instrumentedJquery: WeakSet<object>;
+    /** @internal Active instrument records for teardown. */
+    instrumentRecords: InstrumentRecord[];
+    fetchRestore?: () => void;
     enable(): void;
     disable(): void;
     isEnabled(): boolean;
@@ -38,25 +79,56 @@ export interface StJourneyGlobal {
      */
     getDebugState(): JourneyDebugState;
 }
-/** True when `localStorage['st:journey:enabled'] === 'true'` (force-on outside go*). */
+/**
+ * Host default for journey wiring (e.g. RUM initialized). Stored on `__stJourney` so
+ * MFEs see the same value without importing Datadog. Call once after RUM init.
+ */
+export declare function setJourneyDefaultEnabled(enabled: boolean): void;
+/**
+ * True when the host default is on or force-enable is set
+ * (`st:journey:enabled` / `__stJourney.enable()`).
+ */
 export declare function isJourneyEnabled(): boolean;
 /** Set the force-enable flag. Reload after calling from DevTools. */
 export declare function enableJourney(): void;
 /** Clear the force-enable flag. Reload after calling from DevTools. */
 export declare function disableJourney(): void;
-/** True when `localStorage['st:journey:debug'] === 'true'`. */
+/** True when `sessionStorage['st:journey:debug'] === 'true'`. */
 export declare function isJourneyDebugEnabled(): boolean;
 /** Set the console-debug flag. Reload after calling from DevTools. */
 export declare function enableJourneyDebugging(): void;
 /** Clear the console-debug flag. Reload after calling from DevTools. */
 export declare function disableJourneyDebugging(): void;
+/** @internal Shared policies bag. */
+export declare function getSharedPolicies(): JourneySharedPolicies;
+export declare function areSharedPoliciesLocked(): boolean;
 /**
- * @internal Register this bundle's module runtime on `__stJourney` so DevTools can
- * list every host/MFE engine copy on the page.
+ * First writer: merge `patch` into the shared bag and freeze it.
+ * Returns false when already locked (caller should overlay locally instead).
  */
-export declare function registerJourneyRuntime(runtime: JourneyRuntime): void;
-/** @internal Ensure `__stJourney` exists (idempotent). */
-export declare function installJourneyGlobal(): void;
+export declare function seedSharedPolicies(patch: Partial<Omit<JourneySharedPolicies, 'locked'>>): boolean;
+export declare function getAutoAttributeRequests(): boolean;
+export declare function getHttpAbortedRequestsPolicy(): RequestPolicyConfig;
+export declare function getHttpClientErrorRequestsPolicy(): RequestPolicyConfig;
+export declare function getSharedSlowRequests(): SlowRequestConfig | undefined;
+export declare function areSharedSlowRequestsConfigured(): boolean;
+/** One-time warn when transports are wired without explicit slowRequests. */
+export declare function warnIfSlowRequestsUnset(): void;
+/** @internal Reset shared policies (tests / teardown). */
+export declare function resetSharedPolicies(): void;
+export declare function getInstrumentedAxiosSet(): WeakSet<object>;
+export declare function getInstrumentedFetchSet(): WeakSet<object>;
+export declare function getInstrumentedJquerySet(): WeakSet<object>;
+export declare function registerInstrumentRecord(record: InstrumentRecord): void;
+export declare function setFetchRestore(restore: (() => void) | undefined): void;
+/**
+ * @internal Register this bundle's engine on `__stJourney` so DevTools can list
+ * every host/MFE copy on the page. Auto-assigns `runtime-N` when `runtime.id` is empty.
+ * Replaces an existing registration with the same id (HMR / test re-register).
+ */
+export declare function registerJourneyRuntime(runtime: JourneyRuntime, options?: {
+    teardown?: () => void;
+}): void;
 /**
  * @internal Store a fallback RUM instance on `__stJourney.rum` when `DD_RUM` is absent.
  * Used by `setJourneyRum`.
@@ -64,4 +136,10 @@ export declare function installJourneyGlobal(): void;
 export declare function setJourneyRumFallback(rum: unknown): void;
 /** @internal Read `__stJourney.rum` (setJourneyRum fallback). */
 export declare function getJourneyRumFallback(): unknown;
+/**
+ * Dispose HTTP instrumentation hooks and reset registered engines that supplied a
+ * teardown callback. Intended for tests (e.g. afterEach). Prefer `resetJourney`
+ * when you only need this bundle's engine state.
+ */
+export declare function teardownJourney(): void;
 //# sourceMappingURL=global.d.ts.map

package/dist/global.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAElF,mFAAmF;AACnF,eAAO,MAAM,2BAA2B,uBAAuB,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAE5D,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,MAAM,WAAW,wBAAyB,SAAQ,2BAA2B;IACzE,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAC9B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,IAAI,OAAO,CAAC;IACrB,eAAe,IAAI,IAAI,CAAC;IACxB,gBAAgB,IAAI,IAAI,CAAC;IACzB,cAAc,IAAI,OAAO,CAAC;IAC1B;;;OAGG;IACH,aAAa,IAAI,iBAAiB,CAAC;CACtC;AAkCD,wFAAwF;AACxF,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,uEAAuE;AACvE,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAyDD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAOpE;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAExD;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,IAAI,OAAO,CAI/C"}
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"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"}