@servicetitan/journey 1.0.0

package/dist/core/runtime.js

@@ -0,0 +1,401 @@
+import { longestEndpointMatch, sortEndpointsByLongestMatch } from '../endpoint-policy';
+import { JourneyStepTag } from './step-tag';
+const DEFAULT_REQUEST_TIMEOUTS = {
+    defaultMs: 4000,
+    endpoints: []
+};
+const noopStep = {
+    name: null,
+    setAttribute () {},
+    setTags () {},
+    complete () {},
+    fail () {},
+    tag: ()=>({})
+};
+function toName(target) {
+    return typeof target === 'string' ? target : target.name;
+}
+/**
+ * @internal Private — not part of the public package API.
+ * Build an isolated engine. Rarely needed — apps use the default via free helpers.
+ */ export function createJourneyRuntime(options = {}) {
+    var _options_sinks, _ref, _ref1;
+    var _options_requestTimeouts, _options_requestTimeouts1;
+    const journeys = new Map();
+    const inFlight = new Set();
+    let sinks = [
+        ...(_options_sinks = options.sinks) !== null && _options_sinks !== void 0 ? _options_sinks : []
+    ];
+    let requestTimeouts = {
+        defaultMs: (_ref = (_options_requestTimeouts = options.requestTimeouts) === null || _options_requestTimeouts === void 0 ? void 0 : _options_requestTimeouts.defaultMs) !== null && _ref !== void 0 ? _ref : DEFAULT_REQUEST_TIMEOUTS.defaultMs,
+        endpoints: sortEndpointsByLongestMatch((_ref1 = (_options_requestTimeouts1 = options.requestTimeouts) === null || _options_requestTimeouts1 === void 0 ? void 0 : _options_requestTimeouts1.endpoints) !== null && _ref1 !== void 0 ? _ref1 : DEFAULT_REQUEST_TIMEOUTS.endpoints)
+    };
+    function getInFlightSteps(journey) {
+        const out = [];
+        for (const step of inFlight){
+            if (step.journey === journey) {
+                out.push(step);
+            }
+        }
+        return out;
+    }
+    function enterStep(step) {
+        inFlight.add(step);
+    }
+    function leaveStep(step) {
+        inFlight.delete(step);
+    }
+    function clearCountdown(journey) {
+        if (journey.timer != null) {
+            clearTimeout(journey.timer);
+            journey.timer = null;
+        }
+    }
+    function emit(payload) {
+        for (const sink of sinks){
+            try {
+                sink(payload);
+            } catch (unused) {
+            // One sinking throw must not block the remaining sinks.
+            }
+        }
+    }
+    function finish(journey, outcome, reason) {
+        var _journey_reason;
+        if (journey.closed) {
+            return;
+        }
+        journey.closed = true;
+        journeys.delete(journey.name);
+        clearCountdown(journey);
+        for (const step of getInFlightSteps(journey)){
+            if (step.durationMs === 0) {
+                step.durationMs = Math.round(globalThis.performance.now() - step.startedAt);
+            }
+        }
+        let finalReason = (_journey_reason = journey.reason) !== null && _journey_reason !== void 0 ? _journey_reason : reason;
+        let finalOutcome = outcome;
+        const durationMs = Math.round(globalThis.performance.now() - journey.startedAt);
+        if (journey.timeoutMs > 0 && durationMs > journey.timeoutMs) {
+            finalOutcome = 'bad';
+            finalReason = finalReason !== null && finalReason !== void 0 ? finalReason : 'journey-timeout';
+        }
+        const steps = journey.steps.map((s)=>({
+                name: s.name,
+                startMs: Math.round(s.startedAt - journey.startedAt),
+                durationMs: s.durationMs,
+                outcome: s.outcome,
+                ...s.reason ? {
+                    reason: s.reason
+                } : {},
+                ...s.httpStatus !== undefined ? {
+                    httpStatus: s.httpStatus
+                } : {},
+                ...Object.keys(s.attributes).length ? {
+                    attributes: s.attributes
+                } : {}
+            }));
+        emit({
+            journey: {
+                name: journey.name,
+                team: journey.team,
+                group: journey.group,
+                service: journey.service,
+                outcome: finalOutcome,
+                ...finalOutcome === 'bad' && finalReason ? {
+                    reason: finalReason
+                } : {},
+                durationMs,
+                steps,
+                ...journey.expected ? {
+                    expected: journey.expected
+                } : {},
+                ...Object.keys(journey.tags).length ? {
+                    tags: journey.tags
+                } : {}
+            }
+        });
+    }
+    function armCountdown(journey) {
+        if (journey.timeoutMs <= 0) {
+            return;
+        }
+        journey.timer = setTimeout(()=>{
+            finish(journey, 'bad', 'journey-timeout');
+        }, journey.timeoutMs);
+    }
+    function resolveRequestTimeoutMs(journey, key) {
+        const own = longestEndpointMatch(journey.endpoints, key);
+        if (own === null || own === void 0 ? void 0 : own.timeoutMs) {
+            return own.timeoutMs;
+        }
+        const app = longestEndpointMatch(requestTimeouts.endpoints, key);
+        if (app === null || app === void 0 ? void 0 : app.timeoutMs) {
+            return app.timeoutMs;
+        }
+        if (journey.requestTimeoutMs != null) {
+            return journey.requestTimeoutMs;
+        }
+        return requestTimeouts.defaultMs;
+    }
+    function shouldIgnoreRequest(journey, key) {
+        var _longestEndpointMatch;
+        const own = longestEndpointMatch(journey.endpoints, key);
+        if (own) {
+            return own.ignore === true;
+        }
+        return ((_longestEndpointMatch = longestEndpointMatch(requestTimeouts.endpoints, key)) === null || _longestEndpointMatch === void 0 ? void 0 : _longestEndpointMatch.ignore) === true;
+    }
+    function resolveJourneyName(journey) {
+        if (journey == null) {
+            return null;
+        }
+        if (typeof journey === 'string' || !Array.isArray(journey)) {
+            return toName(journey);
+        }
+        return api.firstOpenJourney(journey.map(toName));
+    }
+    function createStepHandle(journeyName, step) {
+        return {
+            name: journeyName,
+            setAttribute (key, value) {
+                step.attributes[key] = value;
+            },
+            setTags (tags) {
+                api.setJourneyTags(journeyName, tags);
+            },
+            complete (tags) {
+                api.completeJourney(journeyName, tags);
+            },
+            fail (reason) {
+                api.failJourney(journeyName, reason);
+            },
+            // Box in JourneyStepTag — raw StepRecord is circular and blows jQuery/axios deep-merge.
+            tag: ()=>({
+                    journeyStep: new JourneyStepTag(step)
+                })
+        };
+    }
+    const api = {
+        getRequestTimeouts () {
+            return requestTimeouts;
+        },
+        setRequestTimeouts (next) {
+            requestTimeouts = {
+                ...next,
+                endpoints: sortEndpointsByLongestMatch(next.endpoints)
+            };
+        },
+        setSinks (next) {
+            sinks = [
+                ...next
+            ];
+        },
+        addSink (sink) {
+            sinks.push(sink);
+        },
+        emit,
+        getOpenJourney (name) {
+            return journeys.get(name);
+        },
+        firstOpenJourney (names) {
+            for (const name of names){
+                if (journeys.has(name)) {
+                    return name;
+                }
+            }
+            return null;
+        },
+        setJourneyTags (name, tags) {
+            const journey = name ? journeys.get(name) : undefined;
+            if (journey) {
+                Object.assign(journey.tags, tags);
+            }
+        },
+        startJourney (def) {
+            var _def_timeoutMs, _def_tags;
+            const existing = journeys.get(def.name);
+            if (existing) {
+                finish(existing, existing.verdict === 'bad' ? 'bad' : 'excluded');
+            }
+            const journey = {
+                name: def.name,
+                team: def.team,
+                group: def.group,
+                service: def.service,
+                verdict: 'good',
+                startedAt: globalThis.performance.now(),
+                timeoutMs: (_def_timeoutMs = def.timeoutMs) !== null && _def_timeoutMs !== void 0 ? _def_timeoutMs : 0,
+                stepTimeoutMs: def.stepTimeoutMs,
+                reason: null,
+                steps: [],
+                expected: def.steps ? [
+                    ...def.steps
+                ] : null,
+                tags: {
+                    ...(_def_tags = def.tags) !== null && _def_tags !== void 0 ? _def_tags : {}
+                },
+                requestTimeoutMs: def.requestTimeoutMs,
+                endpoints: sortEndpointsByLongestMatch(def.endpoints),
+                timer: null,
+                closed: false
+            };
+            journeys.set(def.name, journey);
+            armCountdown(journey);
+        },
+        failJourneyNow (journey, reason) {
+            var _journey, _reason;
+            if (journey.closed) {
+                return;
+            }
+            journey.verdict = 'bad';
+            (_reason = (_journey = journey).reason) !== null && _reason !== void 0 ? _reason : _journey.reason = reason;
+            finish(journey, 'bad');
+        },
+        failJourney (name, reason) {
+            const journey = journeys.get(name);
+            if (journey) {
+                api.failJourneyNow(journey, reason);
+            }
+        },
+        completeJourney (name, tags) {
+            if (!name) {
+                return;
+            }
+            if (tags) {
+                api.setJourneyTags(name, tags);
+            }
+            const journey = journeys.get(name);
+            if (journey) {
+                finish(journey, journey.verdict === 'bad' ? 'bad' : 'good');
+            }
+        },
+        excludeJourney (name) {
+            const journey = journeys.get(name);
+            if (journey) {
+                finish(journey, journey.verdict === 'bad' ? 'bad' : 'excluded');
+            }
+        },
+        activeJourneyStep () {
+            var _inFlight_values_next_value;
+            if (inFlight.size !== 1) {
+                return null;
+            }
+            return (_inFlight_values_next_value = inFlight.values().next().value) !== null && _inFlight_values_next_value !== void 0 ? _inFlight_values_next_value : null;
+        },
+        async journeyStep (journey, stepName, fn, opts) {
+            var _ref, _ref1;
+            const journeyName = resolveJourneyName(journey);
+            const open = journeyName ? journeys.get(journeyName) : undefined;
+            if (!open || !journeyName) {
+                return fn(noopStep);
+            }
+            const step = {
+                name: stepName,
+                startedAt: globalThis.performance.now(),
+                durationMs: 0,
+                outcome: 'good',
+                attributes: {},
+                journey: open
+            };
+            open.steps.push(step);
+            const handle = createStepHandle(journeyName, step);
+            const stepTimeoutMs = (_ref = (_ref1 = opts === null || opts === void 0 ? void 0 : opts.timeoutMs) !== null && _ref1 !== void 0 ? _ref1 : open.stepTimeoutMs) !== null && _ref !== void 0 ? _ref : 0;
+            let timeoutTimer = null;
+            if (stepTimeoutMs > 0) {
+                timeoutTimer = setTimeout(()=>{
+                    var _step, _reason, _step_attributes, _timeout_ms;
+                    if (open.closed) {
+                        return;
+                    }
+                    step.outcome = 'bad';
+                    (_reason = (_step = step).reason) !== null && _reason !== void 0 ? _reason : _step.reason = 'step-timeout';
+                    (_timeout_ms = (_step_attributes = step.attributes).timeout_ms) !== null && _timeout_ms !== void 0 ? _timeout_ms : _step_attributes.timeout_ms = stepTimeoutMs;
+                    step.durationMs = Math.round(globalThis.performance.now() - step.startedAt);
+                    api.failJourneyNow(open, 'step-timeout');
+                }, stepTimeoutMs);
+            }
+            enterStep(step);
+            try {
+                return await fn(handle);
+            } catch (err) {
+                var _step, _reason, _step_attributes, _error;
+                const message = err instanceof Error ? err.message : String(err);
+                step.outcome = 'bad';
+                (_reason = (_step = step).reason) !== null && _reason !== void 0 ? _reason : _step.reason = 'step-error';
+                (_error = (_step_attributes = step.attributes).error) !== null && _error !== void 0 ? _error : _step_attributes.error = message;
+                api.failJourneyNow(open, 'step-error');
+                throw err;
+            } finally{
+                if (timeoutTimer != null) {
+                    clearTimeout(timeoutTimer);
+                }
+                if (step.durationMs === 0) {
+                    step.durationMs = Math.round(globalThis.performance.now() - step.startedAt);
+                }
+                leaveStep(step);
+            }
+        },
+        async journeyMountStep (journey, stepName, fn, opts) {
+            await Promise.resolve();
+            return api.journeyStep(journey, stepName, fn, opts);
+        },
+        reportBackendRequest (step, status, durationMs, requestKey) {
+            var _step, _reason;
+            if (!step) {
+                return;
+            }
+            const journey = step.journey;
+            if (journey.closed) {
+                return;
+            }
+            if (shouldIgnoreRequest(journey, requestKey)) {
+                return;
+            }
+            const failed = status === undefined || status >= 500;
+            const slow = durationMs > resolveRequestTimeoutMs(journey, requestKey);
+            if (!failed && !slow) {
+                return;
+            }
+            const category = failed ? 'request-error' : 'request-latency';
+            step.outcome = 'bad';
+            (_reason = (_step = step).reason) !== null && _reason !== void 0 ? _reason : _step.reason = category;
+            if (failed && status !== undefined) {
+                step.httpStatus = status;
+            }
+            api.failJourneyNow(journey, category);
+        },
+        reset (next = {}) {
+            var _next_sinks, _ref, _ref1;
+            var _next_requestTimeouts, _next_requestTimeouts1;
+            for (const journey of [
+                ...journeys.values()
+            ]){
+                clearCountdown(journey);
+                journey.closed = true;
+            }
+            journeys.clear();
+            inFlight.clear();
+            sinks = [
+                ...(_next_sinks = next.sinks) !== null && _next_sinks !== void 0 ? _next_sinks : []
+            ];
+            requestTimeouts = {
+                defaultMs: (_ref = (_next_requestTimeouts = next.requestTimeouts) === null || _next_requestTimeouts === void 0 ? void 0 : _next_requestTimeouts.defaultMs) !== null && _ref !== void 0 ? _ref : DEFAULT_REQUEST_TIMEOUTS.defaultMs,
+                endpoints: sortEndpointsByLongestMatch((_ref1 = (_next_requestTimeouts1 = next.requestTimeouts) === null || _next_requestTimeouts1 === void 0 ? void 0 : _next_requestTimeouts1.endpoints) !== null && _ref1 !== void 0 ? _ref1 : DEFAULT_REQUEST_TIMEOUTS.endpoints)
+            };
+        }
+    };
+    return api;
+}
+/**
+ * @internal Private — not part of the public package API.
+ * Process-wide engine used by free helpers. App code does not need to touch this.
+ */ export const defaultRuntime = createJourneyRuntime();
+/**
+ * Reset the default engine (open journeys, ambient steps, sinks, request thresholds).
+ * Intended for tests — call in `beforeEach` / `afterEach` instead of manual cleanup.
+ */ export function resetJourney(options) {
+    defaultRuntime.reset(options);
+}
+
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/runtime.ts"],"sourcesContent":["import {\n    longestEndpointMatch,\n    sortEndpointsByLongestMatch,\n    type AppRequestTimeouts,\n} from '../endpoint-policy';\nimport { JourneyStepTag } from './step-tag';\nimport type {\n    JourneyDef,\n    JourneyEvent,\n    JourneySink,\n    JourneyState,\n    JourneyStepEvent,\n    JourneyStepOptions,\n    JourneyStepRef,\n    JourneyStepTarget,\n    Outcome,\n    StepHandle,\n    StepRecord,\n    TagValue,\n} from './types';\n\nconst DEFAULT_REQUEST_TIMEOUTS: AppRequestTimeouts = { defaultMs: 4_000, endpoints: [] };\n\nconst noopStep: StepHandle = {\n    name: null,\n    setAttribute() {},\n    setTags() {},\n    complete() {},\n    fail() {},\n    tag: () => ({}),\n};\n\nfunction toName(target: string | { readonly name: string }): string {\n    return typeof target === 'string' ? target : target.name;\n}\n\n/** @internal Private — not part of the public package API. */\nexport interface JourneyRuntimeOptions {\n    /** Initial sinks. Defaults to `[]` — package bootstrap installs Datadog on the default runtime. */\n    sinks?: readonly JourneySink[];\n    requestTimeouts?: AppRequestTimeouts;\n}\n\n/**\n * @internal Private — not part of the public package API.\n * Isolated journey engine (open journeys, ambient steps, sinks, request thresholds).\n * App code should keep using free helpers (`defineJourney`, `journeyStep`, …) — they\n * bind to the process default runtime. Prefer `resetJourney()` in tests.\n */\nexport interface JourneyRuntime {\n    getRequestTimeouts(): AppRequestTimeouts;\n    setRequestTimeouts(next: AppRequestTimeouts): void;\n\n    setSinks(next: readonly JourneySink[]): void;\n    addSink(sink: JourneySink): void;\n    emit(payload: JourneyEvent): void;\n\n    getOpenJourney(name: string): JourneyState | undefined;\n    firstOpenJourney(names: readonly string[]): string | null;\n    setJourneyTags(name: string | null, tags: Record<string, TagValue>): void;\n    startJourney(def: JourneyDef): void;\n    failJourneyNow(journey: JourneyState, reason: string): void;\n    failJourney(name: string, reason: string): void;\n    completeJourney(name: string | null, tags?: Record<string, TagValue>): void;\n    excludeJourney(name: string): void;\n\n    activeJourneyStep(): JourneyStepRef | null;\n    journeyStep<T>(\n        journey: JourneyStepTarget,\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n    journeyMountStep<T>(\n        journey: JourneyStepTarget,\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n\n    reportBackendRequest(\n        step: JourneyStepRef | undefined,\n        status: number | undefined,\n        durationMs: number,\n        requestKey: string\n    ): void;\n\n    /** Close open journeys, clear ambient steps, restore default timeouts/sinks. */\n    reset(options?: JourneyRuntimeOptions): void;\n}\n\n/**\n * @internal Private — not part of the public package API.\n * Build an isolated engine. Rarely needed — apps use the default via free helpers.\n */\nexport function createJourneyRuntime(options: JourneyRuntimeOptions = {}): JourneyRuntime {\n    const journeys = new Map<string, JourneyState>();\n    const inFlight = new Set<StepRecord>();\n    let sinks: JourneySink[] = [...(options.sinks ?? [])];\n    let requestTimeouts: AppRequestTimeouts = {\n        defaultMs: options.requestTimeouts?.defaultMs ?? DEFAULT_REQUEST_TIMEOUTS.defaultMs,\n        endpoints: sortEndpointsByLongestMatch(\n            options.requestTimeouts?.endpoints ?? DEFAULT_REQUEST_TIMEOUTS.endpoints\n        ),\n    };\n\n    function getInFlightSteps(journey: JourneyState): StepRecord[] {\n        const out: StepRecord[] = [];\n        for (const step of inFlight) {\n            if (step.journey === journey) {\n                out.push(step);\n            }\n        }\n        return out;\n    }\n\n    function enterStep(step: StepRecord): void {\n        inFlight.add(step);\n    }\n\n    function leaveStep(step: StepRecord): void {\n        inFlight.delete(step);\n    }\n\n    function clearCountdown(journey: JourneyState): void {\n        if (journey.timer != null) {\n            clearTimeout(journey.timer);\n            journey.timer = null;\n        }\n    }\n\n    function emit(payload: JourneyEvent): void {\n        for (const sink of sinks) {\n            try {\n                sink(payload);\n            } catch {\n                // One sinking throw must not block the remaining sinks.\n            }\n        }\n    }\n\n    function finish(journey: JourneyState, outcome: Outcome, reason?: string): void {\n        if (journey.closed) {\n            return;\n        }\n        journey.closed = true;\n        journeys.delete(journey.name);\n        clearCountdown(journey);\n\n        for (const step of getInFlightSteps(journey)) {\n            if (step.durationMs === 0) {\n                step.durationMs = Math.round(globalThis.performance.now() - step.startedAt);\n            }\n        }\n\n        let finalReason = journey.reason ?? reason;\n        let finalOutcome = outcome;\n        const durationMs = Math.round(globalThis.performance.now() - journey.startedAt);\n        if (journey.timeoutMs > 0 && durationMs > journey.timeoutMs) {\n            finalOutcome = 'bad';\n            finalReason = finalReason ?? 'journey-timeout';\n        }\n\n        const steps: JourneyStepEvent[] = journey.steps.map(s => ({\n            name: s.name,\n            startMs: Math.round(s.startedAt - journey.startedAt),\n            durationMs: s.durationMs,\n            outcome: s.outcome,\n            ...(s.reason ? { reason: s.reason } : {}),\n            ...(s.httpStatus !== undefined ? { httpStatus: s.httpStatus } : {}),\n            ...(Object.keys(s.attributes).length ? { attributes: s.attributes } : {}),\n        }));\n\n        emit({\n            journey: {\n                name: journey.name,\n                team: journey.team,\n                group: journey.group,\n                service: journey.service,\n                outcome: finalOutcome,\n                ...(finalOutcome === 'bad' && finalReason ? { reason: finalReason } : {}),\n                durationMs,\n                steps,\n                ...(journey.expected ? { expected: journey.expected } : {}),\n                ...(Object.keys(journey.tags).length ? { tags: journey.tags } : {}),\n            },\n        });\n    }\n\n    function armCountdown(journey: JourneyState): void {\n        if (journey.timeoutMs <= 0) {\n            return;\n        }\n        journey.timer = setTimeout(() => {\n            finish(journey, 'bad', 'journey-timeout');\n        }, journey.timeoutMs);\n    }\n\n    function resolveRequestTimeoutMs(journey: JourneyState, key: string): number {\n        const own = longestEndpointMatch(journey.endpoints, key);\n        if (own?.timeoutMs) {\n            return own.timeoutMs;\n        }\n\n        const app = longestEndpointMatch(requestTimeouts.endpoints, key);\n        if (app?.timeoutMs) {\n            return app.timeoutMs;\n        }\n\n        if (journey.requestTimeoutMs != null) {\n            return journey.requestTimeoutMs;\n        }\n\n        return requestTimeouts.defaultMs;\n    }\n\n    function shouldIgnoreRequest(journey: JourneyState, key: string): boolean {\n        const own = longestEndpointMatch(journey.endpoints, key);\n        if (own) {\n            return own.ignore === true;\n        }\n        return longestEndpointMatch(requestTimeouts.endpoints, key)?.ignore === true;\n    }\n\n    function resolveJourneyName(journey: JourneyStepTarget): string | null {\n        if (journey == null) {\n            return null;\n        }\n        if (typeof journey === 'string' || !Array.isArray(journey)) {\n            return toName(journey as string | { readonly name: string });\n        }\n        return api.firstOpenJourney(journey.map(toName));\n    }\n\n    function createStepHandle(journeyName: string, step: StepRecord): StepHandle {\n        return {\n            name: journeyName,\n            setAttribute(key, value) {\n                step.attributes[key] = value;\n            },\n            setTags(tags) {\n                api.setJourneyTags(journeyName, tags);\n            },\n            complete(tags) {\n                api.completeJourney(journeyName, tags);\n            },\n            fail(reason) {\n                api.failJourney(journeyName, reason);\n            },\n            // Box in JourneyStepTag — raw StepRecord is circular and blows jQuery/axios deep-merge.\n            tag: () => ({ journeyStep: new JourneyStepTag(step) }),\n        };\n    }\n\n    const api: JourneyRuntime = {\n        getRequestTimeouts() {\n            return requestTimeouts;\n        },\n\n        setRequestTimeouts(next) {\n            requestTimeouts = {\n                ...next,\n                endpoints: sortEndpointsByLongestMatch(next.endpoints),\n            };\n        },\n\n        setSinks(next) {\n            sinks = [...next];\n        },\n\n        addSink(sink) {\n            sinks.push(sink);\n        },\n\n        emit,\n\n        getOpenJourney(name) {\n            return journeys.get(name);\n        },\n\n        firstOpenJourney(names) {\n            for (const name of names) {\n                if (journeys.has(name)) {\n                    return name;\n                }\n            }\n            return null;\n        },\n\n        setJourneyTags(name, tags) {\n            const journey = name ? journeys.get(name) : undefined;\n            if (journey) {\n                Object.assign(journey.tags, tags);\n            }\n        },\n\n        startJourney(def) {\n            const existing = journeys.get(def.name);\n            if (existing) {\n                finish(existing, existing.verdict === 'bad' ? 'bad' : 'excluded');\n            }\n\n            const journey: JourneyState = {\n                name: def.name,\n                team: def.team,\n                group: def.group,\n                service: def.service,\n                verdict: 'good',\n                startedAt: globalThis.performance.now(),\n                timeoutMs: def.timeoutMs ?? 0,\n                stepTimeoutMs: def.stepTimeoutMs,\n                reason: null,\n                steps: [],\n                expected: def.steps ? [...def.steps] : null,\n                tags: { ...(def.tags ?? {}) },\n                requestTimeoutMs: def.requestTimeoutMs,\n                endpoints: sortEndpointsByLongestMatch(def.endpoints),\n                timer: null,\n                closed: false,\n            };\n            journeys.set(def.name, journey);\n            armCountdown(journey);\n        },\n\n        failJourneyNow(journey, reason) {\n            if (journey.closed) {\n                return;\n            }\n            journey.verdict = 'bad';\n            journey.reason ??= reason;\n            finish(journey, 'bad');\n        },\n\n        failJourney(name, reason) {\n            const journey = journeys.get(name);\n            if (journey) {\n                api.failJourneyNow(journey, reason);\n            }\n        },\n\n        completeJourney(name, tags) {\n            if (!name) {\n                return;\n            }\n            if (tags) {\n                api.setJourneyTags(name, tags);\n            }\n            const journey = journeys.get(name);\n            if (journey) {\n                finish(journey, journey.verdict === 'bad' ? 'bad' : 'good');\n            }\n        },\n\n        excludeJourney(name) {\n            const journey = journeys.get(name);\n            if (journey) {\n                finish(journey, journey.verdict === 'bad' ? 'bad' : 'excluded');\n            }\n        },\n\n        activeJourneyStep() {\n            if (inFlight.size !== 1) {\n                return null;\n            }\n            return inFlight.values().next().value ?? null;\n        },\n\n        async journeyStep(journey, stepName, fn, opts) {\n            const journeyName = resolveJourneyName(journey);\n            const open = journeyName ? journeys.get(journeyName) : undefined;\n            if (!open || !journeyName) {\n                return fn(noopStep);\n            }\n\n            const step: StepRecord = {\n                name: stepName,\n                startedAt: globalThis.performance.now(),\n                durationMs: 0,\n                outcome: 'good',\n                attributes: {},\n                journey: open,\n            };\n            open.steps.push(step);\n\n            const handle = createStepHandle(journeyName, step);\n\n            const stepTimeoutMs = opts?.timeoutMs ?? open.stepTimeoutMs ?? 0;\n            let timeoutTimer: ReturnType<typeof setTimeout> | null = null;\n            if (stepTimeoutMs > 0) {\n                timeoutTimer = setTimeout(() => {\n                    if (open.closed) {\n                        return;\n                    }\n                    step.outcome = 'bad';\n                    step.reason ??= 'step-timeout';\n                    step.attributes.timeout_ms ??= stepTimeoutMs;\n                    step.durationMs = Math.round(globalThis.performance.now() - step.startedAt);\n                    api.failJourneyNow(open, 'step-timeout');\n                }, stepTimeoutMs);\n            }\n\n            enterStep(step);\n            try {\n                return await fn(handle);\n            } catch (err) {\n                const message = err instanceof Error ? err.message : String(err);\n                step.outcome = 'bad';\n                step.reason ??= 'step-error';\n                step.attributes.error ??= message;\n                api.failJourneyNow(open, 'step-error');\n                throw err;\n            } finally {\n                if (timeoutTimer != null) {\n                    clearTimeout(timeoutTimer);\n                }\n                if (step.durationMs === 0) {\n                    step.durationMs = Math.round(globalThis.performance.now() - step.startedAt);\n                }\n                leaveStep(step);\n            }\n        },\n\n        async journeyMountStep(journey, stepName, fn, opts) {\n            await Promise.resolve();\n            return api.journeyStep(journey, stepName, fn, opts);\n        },\n\n        reportBackendRequest(step, status, durationMs, requestKey) {\n            if (!step) {\n                return;\n            }\n            const journey = step.journey;\n            if (journey.closed) {\n                return;\n            }\n            if (shouldIgnoreRequest(journey, requestKey)) {\n                return;\n            }\n\n            const failed = status === undefined || status >= 500;\n            const slow = durationMs > resolveRequestTimeoutMs(journey, requestKey);\n            if (!failed && !slow) {\n                return;\n            }\n\n            const category = failed ? 'request-error' : 'request-latency';\n\n            step.outcome = 'bad';\n            step.reason ??= category;\n            if (failed && status !== undefined) {\n                step.httpStatus = status;\n            }\n\n            api.failJourneyNow(journey, category);\n        },\n\n        reset(next = {}) {\n            for (const journey of [...journeys.values()]) {\n                clearCountdown(journey);\n                journey.closed = true;\n            }\n            journeys.clear();\n            inFlight.clear();\n            sinks = [...(next.sinks ?? [])];\n            requestTimeouts = {\n                defaultMs: next.requestTimeouts?.defaultMs ?? DEFAULT_REQUEST_TIMEOUTS.defaultMs,\n                endpoints: sortEndpointsByLongestMatch(\n                    next.requestTimeouts?.endpoints ?? DEFAULT_REQUEST_TIMEOUTS.endpoints\n                ),\n            };\n        },\n    };\n\n    return api;\n}\n\n/**\n * @internal Private — not part of the public package API.\n * Process-wide engine used by free helpers. App code does not need to touch this.\n */\nexport const defaultRuntime: JourneyRuntime = createJourneyRuntime();\n\n/**\n * Reset the default engine (open journeys, ambient steps, sinks, request thresholds).\n * Intended for tests — call in `beforeEach` / `afterEach` instead of manual cleanup.\n */\nexport function resetJourney(options?: JourneyRuntimeOptions): void {\n    defaultRuntime.reset(options);\n}\n"],"names":["longestEndpointMatch","sortEndpointsByLongestMatch","JourneyStepTag","DEFAULT_REQUEST_TIMEOUTS","defaultMs","endpoints","noopStep","name","setAttribute","setTags","complete","fail","tag","toName","target","createJourneyRuntime","options","journeys","Map","inFlight","Set","sinks","requestTimeouts","getInFlightSteps","journey","out","step","push","enterStep","add","leaveStep","delete","clearCountdown","timer","clearTimeout","emit","payload","sink","finish","outcome","reason","closed","durationMs","Math","round","globalThis","performance","now","startedAt","finalReason","finalOutcome","timeoutMs","steps","map","s","startMs","httpStatus","undefined","Object","keys","attributes","length","team","group","service","expected","tags","armCountdown","setTimeout","resolveRequestTimeoutMs","key","own","app","requestTimeoutMs","shouldIgnoreRequest","ignore","resolveJourneyName","Array","isArray","api","firstOpenJourney","createStepHandle","journeyName","value","setJourneyTags","completeJourney","failJourney","journeyStep","getRequestTimeouts","setRequestTimeouts","next","setSinks","addSink","getOpenJourney","get","names","has","assign","startJourney","def","existing","verdict","stepTimeoutMs","set","failJourneyNow","excludeJourney","activeJourneyStep","size","values","stepName","fn","opts","open","handle","timeoutTimer","timeout_ms","err","message","Error","String","error","journeyMountStep","Promise","resolve","reportBackendRequest","status","requestKey","failed","slow","category","reset","clear","defaultRuntime","resetJourney"],"mappings":"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"}

package/dist/core/step-tag.d.ts

@@ -0,0 +1,16 @@
+import type { JourneyStepRef, StepRecord } from './types';
+/**
+ * Non-plain wrapper for {@link StepHandle.tag}.
+ *
+ * jQuery `ajaxSetup` / axios `mergeConfig` deep-merge plain objects. A raw
+ * {@link StepRecord} is circular (`step.journey.steps → step`), so putting it
+ * on ajax/axios options causes "Maximum call stack size exceeded". Class
+ * instances are assigned by reference instead of recursed.
+ */
+export declare class JourneyStepTag {
+    readonly step: StepRecord;
+    constructor(step: StepRecord);
+}
+/** Unwrap `step.tag().journeyStep` or a JourneyStepTag / StepRecord stamp. */
+export declare function resolveJourneyStep(value: unknown): JourneyStepRef | undefined;
+//# sourceMappingURL=step-tag.d.ts.map

package/dist/core/step-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-tag.d.ts","sourceRoot":"","sources":["../../src/core/step-tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;GAOG;AACH,qBAAa,cAAc;IACX,QAAQ,CAAC,IAAI,EAAE,UAAU;gBAAhB,IAAI,EAAE,UAAU;CACxC;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAQ7E"}

package/dist/core/step-tag.js

@@ -0,0 +1,35 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else obj[key] = value;
+    return obj;
+}
+/**
+ * Non-plain wrapper for {@link StepHandle.tag}.
+ *
+ * jQuery `ajaxSetup` / axios `mergeConfig` deep-merge plain objects. A raw
+ * {@link StepRecord} is circular (`step.journey.steps → step`), so putting it
+ * on ajax/axios options causes "Maximum call stack size exceeded". Class
+ * instances are assigned by reference instead of recursed.
+ */ export class JourneyStepTag {
+    constructor(step){
+        _define_property(this, "step", void 0);
+        this.step = step;
+    }
+}
+/** Unwrap `step.tag().journeyStep` or a JourneyStepTag / StepRecord stamp. */ export function resolveJourneyStep(value) {
+    if (value instanceof JourneyStepTag) {
+        return value.step;
+    }
+    if (value && typeof value === 'object') {
+        return value;
+    }
+    return undefined;
+}
+
+//# sourceMappingURL=step-tag.js.map

package/dist/core/step-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/step-tag.ts"],"sourcesContent":["import type { JourneyStepRef, StepRecord } from './types';\n\n/**\n * Non-plain wrapper for {@link StepHandle.tag}.\n *\n * jQuery `ajaxSetup` / axios `mergeConfig` deep-merge plain objects. A raw\n * {@link StepRecord} is circular (`step.journey.steps → step`), so putting it\n * on ajax/axios options causes \"Maximum call stack size exceeded\". Class\n * instances are assigned by reference instead of recursed.\n */\nexport class JourneyStepTag {\n    constructor(readonly step: StepRecord) {}\n}\n\n/** Unwrap `step.tag().journeyStep` or a JourneyStepTag / StepRecord stamp. */\nexport function resolveJourneyStep(value: unknown): JourneyStepRef | undefined {\n    if (value instanceof JourneyStepTag) {\n        return value.step;\n    }\n    if (value && typeof value === 'object') {\n        return value as JourneyStepRef;\n    }\n    return undefined;\n}\n"],"names":["JourneyStepTag","step","resolveJourneyStep","value","undefined"],"mappings":";;;;;;;;;;;AAEA;;;;;;;CAOC,GACD,OAAO,MAAMA;IACT,YAAY,AAASC,IAAgB,CAAE;;aAAlBA,OAAAA;IAAmB;AAC5C;AAEA,4EAA4E,GAC5E,OAAO,SAASC,mBAAmBC,KAAc;IAC7C,IAAIA,iBAAiBH,gBAAgB;QACjC,OAAOG,MAAMF,IAAI;IACrB;IACA,IAAIE,SAAS,OAAOA,UAAU,UAAU;QACpC,OAAOA;IACX;IACA,OAAOC;AACX"}

package/dist/core/types.d.ts

@@ -0,0 +1,143 @@
+import type { EndpointPolicy } from '../endpoint-policy';
+/** 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. */
+    name: string;
+    /** Owner team (required tag). */
+    team: string;
+    /** Functional area, e.g. "sales" (required tag). */
+    group: string;
+    /** Business component label, e.g. "checkout" — not the Datadog RUM service. */
+    service: string;
+    /** Whole-journey budget in ms; omit / 0 to disable. */
+    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;
+    /** 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[];
+    /** Custom tags on every event of this journey. */
+    tags?: Record<string, TagValue>;
+}
+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;
+    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;
+    /**
+     * 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`.
+     *
+     * The value is a non-plain {@link JourneyStepTag} so jQuery/axios deep-merge will
+     * not recurse into the circular StepRecord graph.
+     */
+    tag(): {
+        journeyStep?: unknown;
+    };
+}
+/** A journey name, or anything with a `name` (e.g. a JourneyHandle / JourneyDef). */
+export type JourneyNameLike = string | {
+    readonly name: string;
+};
+/** First argument to journeyStep / journeyMountStep. */
+export type JourneyStepTarget = JourneyNameLike | null | readonly JourneyNameLike[];
+/** Per-call options for journeyStep. */
+export interface JourneyStepOptions {
+    /** Timeout for this step in ms; overrides journey stepTimeoutMs. Omit / 0 to disable. */
+    timeoutMs?: number;
+}
+export interface JourneyState {
+    name: string;
+    team: string;
+    group: string;
+    service: string;
+    verdict: Outcome;
+    startedAt: number;
+    timeoutMs: number;
+    stepTimeoutMs?: number;
+    /**
+     * Why the journey closed as bad, else null.
+     * Engine: request-error | request-latency | journey-timeout | step-timeout | step-error.
+     * Also any custom business reason (e.g. call-not-associated).
+     */
+    reason: string | null;
+    steps: StepRecord[];
+    expected: string[] | null;
+    tags: Record<string, TagValue>;
+    requestTimeoutMs?: number;
+    endpoints?: readonly EndpointPolicy[];
+    timer: ReturnType<typeof setTimeout> | null;
+    closed: boolean;
+}
+export interface StepRecord {
+    name: string;
+    startedAt: number;
+    durationMs: number;
+    outcome: 'good' | 'bad';
+    reason?: string;
+    httpStatus?: number;
+    attributes: Record<string, string | number | boolean>;
+    journey: JourneyState;
+}
+/** 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. */
+    startMs: number;
+    durationMs: number;
+    outcome: 'good' | 'bad';
+    reason?: string;
+    httpStatus?: number;
+    attributes?: Record<string, TagValue>;
+}
+/** Neutral journey event payload (journey-specific fields only; session context is host RUM globals). */
+export interface JourneyEvent {
+    journey: {
+        name: string;
+        team: string;
+        group: string;
+        service: string;
+        outcome: Outcome;
+        reason?: string;
+        durationMs: number;
+        steps: JourneyStepEvent[];
+        expected?: string[];
+        tags?: Record<string, TagValue>;
+    };
+}
+/** 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). */
+    start(tags?: Record<string, TagValue>): void;
+    /**
+     * Record a step. Opens the journey first when it isn't already open
+     * (one-shot store actions); no-op start when a `<JourneyScope>` already opened it.
+     */
+    step<T>(stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
+    /**
+     * Like `step`, deferred one microtask for mount-effect use under `<JourneyScope>`
+     * (React runs child effects before parent). Also auto-starts if not already open.
+     */
+    mountStep<T>(stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
+    complete(tags?: Record<string, TagValue>): void;
+    fail(reason: string): void;
+    exclude(): void;
+    setTags(tags: Record<string, TagValue>): void;
+}
+//# sourceMappingURL=types.d.ts.map