@servicetitan/journey 2.0.0 → 3.0.0

package/dist/global.js

@@ -0,0 +1,326 @@
+/** Force-enable journey host wiring outside go* hosts (`__stJourney.enable()`). */ export const JOURNEY_ENABLED_STORAGE_KEY = 'st:journey:enabled';
+/** Opt-in journey console logging (`__stJourney.enableDebugging()`). */ export const JOURNEY_DEBUG_STORAGE_KEY = 'st:journey:debug';
+/** @internal Shared cross-bundle bag on globalThis (`rum` fallback + DevTools helpers). */ export const ST_JOURNEY_GLOBAL_KEY = '__stJourney';
+/** Bump when shared bag shape / policy semantics change incompatibly. */ export const ST_JOURNEY_SCHEMA_VERSION = 2;
+let warnedMissingSlowRequests = false;
+let debugEnabledCache;
+const MAX_INSTRUMENT_RECORDS = 32;
+function storageFor(key) {
+    return key === JOURNEY_DEBUG_STORAGE_KEY ? globalThis.sessionStorage : globalThis.localStorage;
+}
+function readFlag(key) {
+    try {
+        var _storageFor;
+        return ((_storageFor = storageFor(key)) === null || _storageFor === void 0 ? void 0 : _storageFor.getItem(key)) === 'true';
+    } catch (unused) {
+        return false;
+    }
+}
+function writeFlag(key, on) {
+    try {
+        const storage = storageFor(key);
+        if (on) {
+            storage === null || storage === void 0 ? void 0 : storage.setItem(key, 'true');
+        } else {
+            storage === null || storage === void 0 ? void 0 : storage.removeItem(key);
+        }
+    } catch (unused) {
+    // ignore storage failures (privacy mode, non-browser)
+    }
+}
+/**
+ * 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 function setJourneyDefaultEnabled(enabled) {
+    ensureGlobal().defaultEnabled = enabled === true;
+}
+/**
+ * True when the host default is on or force-enable is set
+ * (`st:journey:enabled` / `__stJourney.enable()`).
+ */ export function isJourneyEnabled() {
+    return ensureGlobal().defaultEnabled === true || readFlag(JOURNEY_ENABLED_STORAGE_KEY);
+}
+/** Set the force-enable flag. Reload after calling from DevTools. */ export function enableJourney() {
+    writeFlag(JOURNEY_ENABLED_STORAGE_KEY, true);
+}
+/** Clear the force-enable flag. Reload after calling from DevTools. */ export function disableJourney() {
+    writeFlag(JOURNEY_ENABLED_STORAGE_KEY, false);
+}
+/** True when `sessionStorage['st:journey:debug'] === 'true'`. */ export function isJourneyDebugEnabled() {
+    const next = readFlag(JOURNEY_DEBUG_STORAGE_KEY);
+    if (debugEnabledCache !== next) {
+        debugEnabledCache = next;
+    }
+    return debugEnabledCache;
+}
+/** Set the console-debug flag. Reload after calling from DevTools. */ export function enableJourneyDebugging() {
+    writeFlag(JOURNEY_DEBUG_STORAGE_KEY, true);
+    debugEnabledCache = true;
+}
+/** Clear the console-debug flag. Reload after calling from DevTools. */ export function disableJourneyDebugging() {
+    writeFlag(JOURNEY_DEBUG_STORAGE_KEY, false);
+    debugEnabledCache = false;
+}
+function hasRum() {
+    return globalThis.DD_RUM != null || getJourneyRumFallback() != null;
+}
+function snapshotOf(entry) {
+    if (entry == null || typeof entry !== 'object') {
+        return undefined;
+    }
+    const rec = entry;
+    try {
+        if (typeof rec.getSnapshot === 'function') {
+            var _rec_id, _withId_policyOverlay;
+            const snap = rec.getSnapshot();
+            const withId = snap.id ? snap : {
+                ...snap,
+                id: (_rec_id = rec.id) !== null && _rec_id !== void 0 ? _rec_id : ''
+            };
+            return {
+                ...withId,
+                policyOverlay: (_withId_policyOverlay = withId.policyOverlay) !== null && _withId_policyOverlay !== void 0 ? _withId_policyOverlay : {
+                    slowRequests: false,
+                    httpAbortedRequests: false,
+                    httpClientErrorRequests: false,
+                    autoAttributeRequests: false
+                }
+            };
+        }
+        if (typeof rec.getDebugSnapshot === 'function') {
+            return rec.getDebugSnapshot();
+        }
+    } catch (unused) {
+        return undefined;
+    }
+    return undefined;
+}
+function buildDebugState(runtimes) {
+    if (!isJourneyDebugEnabled()) {
+        return {
+            enabled: isJourneyEnabled(),
+            debug: false,
+            hasRum: hasRum(),
+            runtimes: []
+        };
+    }
+    return {
+        enabled: isJourneyEnabled(),
+        debug: true,
+        hasRum: hasRum(),
+        runtimes: runtimes.map(snapshotOf).filter((snap)=>snap != null)
+    };
+}
+function createEmptyPolicies() {
+    return {
+        slowRequestsConfigured: false,
+        httpAbortedRequests: 'continue',
+        httpClientErrorRequests: 'continue',
+        autoAttributeRequests: true,
+        locked: false
+    };
+}
+function ensureGlobal() {
+    var _ref;
+    const g = globalThis;
+    const existing = g[ST_JOURNEY_GLOBAL_KEY];
+    // Reuse when a prior load already installed the full surface (incl. enable).
+    if ((existing === null || existing === void 0 ? void 0 : existing.runtimeRegistrations) && typeof existing.enable === 'function') {
+        var _existing, _policies, _existing1, _instrumentedAxios, _existing2, _instrumentedFetch, _existing3, _instrumentedJquery, _existing4, _instrumentRecords;
+        if (existing.schemaVersion != null && existing.schemaVersion !== ST_JOURNEY_SCHEMA_VERSION) {
+            // eslint-disable-next-line no-console -- cross-bundle version skew
+            console.warn(`[journey] __stJourney.schemaVersion mismatch: bag=${existing.schemaVersion}, package=${ST_JOURNEY_SCHEMA_VERSION}`);
+        } else {
+            var _existing5, _schemaVersion;
+            (_schemaVersion = (_existing5 = existing).schemaVersion) !== null && _schemaVersion !== void 0 ? _schemaVersion : _existing5.schemaVersion = ST_JOURNEY_SCHEMA_VERSION;
+        }
+        (_policies = (_existing = existing).policies) !== null && _policies !== void 0 ? _policies : _existing.policies = createEmptyPolicies();
+        if (existing.policies.locked !== true && existing.policies.locked !== false) {
+            existing.policies.locked = false;
+        }
+        (_instrumentedAxios = (_existing1 = existing).instrumentedAxios) !== null && _instrumentedAxios !== void 0 ? _instrumentedAxios : _existing1.instrumentedAxios = new WeakSet();
+        (_instrumentedFetch = (_existing2 = existing).instrumentedFetch) !== null && _instrumentedFetch !== void 0 ? _instrumentedFetch : _existing2.instrumentedFetch = new WeakSet();
+        (_instrumentedJquery = (_existing3 = existing).instrumentedJquery) !== null && _instrumentedJquery !== void 0 ? _instrumentedJquery : _existing3.instrumentedJquery = new WeakSet();
+        (_instrumentRecords = (_existing4 = existing).instrumentRecords) !== null && _instrumentRecords !== void 0 ? _instrumentRecords : _existing4.instrumentRecords = [];
+        return existing;
+    }
+    const runtimes = (_ref = existing === null || existing === void 0 ? void 0 : existing.runtimeRegistrations) !== null && _ref !== void 0 ? _ref : [];
+    const api = {
+        rum: existing === null || existing === void 0 ? void 0 : existing.rum,
+        schemaVersion: ST_JOURNEY_SCHEMA_VERSION,
+        defaultEnabled: (existing === null || existing === void 0 ? void 0 : existing.defaultEnabled) === true,
+        runtimeRegistrations: runtimes,
+        policies: createEmptyPolicies(),
+        instrumentedAxios: new WeakSet(),
+        instrumentedFetch: new WeakSet(),
+        instrumentedJquery: new WeakSet(),
+        instrumentRecords: [],
+        enable: enableJourney,
+        disable: disableJourney,
+        isEnabled: isJourneyEnabled,
+        enableDebugging: enableJourneyDebugging,
+        disableDebugging: disableJourneyDebugging,
+        isDebugEnabled: isJourneyDebugEnabled,
+        getDebugState () {
+            return buildDebugState(api.runtimeRegistrations);
+        }
+    };
+    g[ST_JOURNEY_GLOBAL_KEY] = api;
+    return api;
+}
+/** @internal Shared policies bag. */ export function getSharedPolicies() {
+    return ensureGlobal().policies;
+}
+export function areSharedPoliciesLocked() {
+    return ensureGlobal().policies.locked === true;
+}
+function freezePolicies(policies) {
+    const next = {
+        ...policies,
+        locked: true
+    };
+    if (next.slowRequests) {
+        const endpoints = next.slowRequests.endpoints ? Object.freeze([
+            ...next.slowRequests.endpoints
+        ]) : next.slowRequests.endpoints;
+        next.slowRequests = Object.freeze({
+            ...next.slowRequests,
+            endpoints
+        });
+    }
+    return Object.freeze(next);
+}
+/**
+ * First writer: merge `patch` into the shared bag and freeze it.
+ * Returns false when already locked (caller should overlay locally instead).
+ */ export function seedSharedPolicies(patch) {
+    const api = ensureGlobal();
+    if (api.policies.locked) {
+        return false;
+    }
+    api.policies = freezePolicies({
+        ...api.policies,
+        ...patch
+    });
+    return true;
+}
+export function getAutoAttributeRequests() {
+    return ensureGlobal().policies.autoAttributeRequests !== false;
+}
+export function getHttpAbortedRequestsPolicy() {
+    return ensureGlobal().policies.httpAbortedRequests;
+}
+export function getHttpClientErrorRequestsPolicy() {
+    return ensureGlobal().policies.httpClientErrorRequests;
+}
+export function getSharedSlowRequests() {
+    return ensureGlobal().policies.slowRequests;
+}
+export function areSharedSlowRequestsConfigured() {
+    return ensureGlobal().policies.slowRequestsConfigured === true;
+}
+/** One-time warn when transports are wired without explicit slowRequests. */ export function warnIfSlowRequestsUnset() {
+    if (warnedMissingSlowRequests || areSharedSlowRequestsConfigured()) {
+        return;
+    }
+    warnedMissingSlowRequests = true;
+    // eslint-disable-next-line no-console -- host config guidance
+    console.warn('[journey] using default slowRequests.defaultMs=4000 — set configureJourney({ slowRequests }) to tune');
+}
+/** @internal Reset shared policies (tests / teardown). */ export function resetSharedPolicies() {
+    const api = ensureGlobal();
+    api.policies = createEmptyPolicies();
+    warnedMissingSlowRequests = false;
+    debugEnabledCache = undefined;
+}
+export function getInstrumentedAxiosSet() {
+    return ensureGlobal().instrumentedAxios;
+}
+export function getInstrumentedFetchSet() {
+    return ensureGlobal().instrumentedFetch;
+}
+export function getInstrumentedJquerySet() {
+    return ensureGlobal().instrumentedJquery;
+}
+export function registerInstrumentRecord(record) {
+    const api = ensureGlobal();
+    if (api.instrumentRecords.length >= MAX_INSTRUMENT_RECORDS) {
+        // eslint-disable-next-line no-console -- defensive cap for repeated instrumentation
+        console.warn('[journey] instrumentRecords cap reached — call teardownJourney()');
+        return;
+    }
+    api.instrumentRecords.push(record);
+}
+export function setFetchRestore(restore) {
+    ensureGlobal().fetchRestore = restore;
+}
+/**
+ * @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 function registerJourneyRuntime(runtime, options) {
+    const bag = ensureGlobal();
+    if (runtime.id === '') {
+        runtime.id = `runtime-${bag.runtimeRegistrations.length + 1}`;
+    }
+    const entry = {
+        id: runtime.id,
+        getSnapshot: ()=>runtime.getDebugSnapshot(),
+        teardown: options === null || options === void 0 ? void 0 : options.teardown
+    };
+    const existing = bag.runtimeRegistrations.findIndex((reg)=>reg.id === runtime.id);
+    if (existing >= 0) {
+        bag.runtimeRegistrations[existing] = entry;
+    } else {
+        bag.runtimeRegistrations.push(entry);
+    }
+}
+/**
+ * @internal Store a fallback RUM instance on `__stJourney.rum` when `DD_RUM` is absent.
+ * Used by `setJourneyRum`.
+ */ export function setJourneyRumFallback(rum) {
+    ensureGlobal().rum = rum;
+}
+/** @internal Read `__stJourney.rum` (setJourneyRum fallback). */ export function getJourneyRumFallback() {
+    const existing = globalThis[ST_JOURNEY_GLOBAL_KEY];
+    return existing === null || existing === void 0 ? void 0 : existing.rum;
+}
+/**
+ * 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 function teardownJourney() {
+    const api = ensureGlobal();
+    for (const record of api.instrumentRecords){
+        record.disposed = true;
+        try {
+            var _record_restore;
+            (_record_restore = record.restore) === null || _record_restore === void 0 ? void 0 : _record_restore.call(record);
+        } catch (unused) {
+        // ignore restore failures
+        }
+    }
+    api.instrumentRecords = [];
+    try {
+        var _api_fetchRestore;
+        (_api_fetchRestore = api.fetchRestore) === null || _api_fetchRestore === void 0 ? void 0 : _api_fetchRestore.call(api);
+    } catch (unused) {
+    // ignore
+    }
+    api.fetchRestore = undefined;
+    const kept = [];
+    for (const entry of api.runtimeRegistrations){
+        if (entry.teardown) {
+            try {
+                entry.teardown();
+            } catch (unused) {
+            // ignore
+            }
+            continue;
+        }
+        kept.push(entry);
+    }
+    api.runtimeRegistrations = kept;
+}
+
+//# sourceMappingURL=global.js.map

package/dist/global.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/global.ts"],"sourcesContent":["import type { SlowRequestConfig } from './core/endpoint-policy';\nimport { type RequestPolicyConfig } from './core/request-policy';\nimport type { JourneyRuntime, JourneyRuntimeDebugSnapshot } from './core/runtime';\n\n/** Force-enable journey host wiring outside go* hosts (`__stJourney.enable()`). */\nexport const JOURNEY_ENABLED_STORAGE_KEY = 'st:journey:enabled';\n\n/** Opt-in journey console logging (`__stJourney.enableDebugging()`). */\nexport const JOURNEY_DEBUG_STORAGE_KEY = 'st:journey:debug';\n\n/** @internal Shared cross-bundle bag on globalThis (`rum` fallback + DevTools helpers). */\nexport const ST_JOURNEY_GLOBAL_KEY = '__stJourney';\n\n/** Bump when shared bag shape / policy semantics change incompatibly. */\nexport const ST_JOURNEY_SCHEMA_VERSION = 2;\n\nexport interface JourneyDebugState {\n    /** Host default or force-enable (`isJourneyEnabled()`). */\n    enabled: boolean;\n    /** Console-logging flag (`st:journey:debug`). */\n    debug: boolean;\n    hasRum: boolean;\n    runtimes: JourneyRuntimeDebugSnapshot[];\n}\n\n/** Shared host policies visible to every package copy on the page. */\nexport interface JourneySharedPolicies {\n    slowRequests?: SlowRequestConfig;\n    /** Whether shared slowRequests were explicitly set via configureJourney. */\n    slowRequestsConfigured: boolean;\n    httpAbortedRequests: RequestPolicyConfig;\n    httpClientErrorRequests: RequestPolicyConfig;\n    autoAttributeRequests: boolean;\n    /** True after the first configureJourney that set any shared policy knob. */\n    locked: boolean;\n}\n\n/** DevTools registration — `{ id, getSnapshot }` so older package copies can still list runtimes. */\nexport interface RuntimeRegistration {\n    id: string;\n    getSnapshot: () => JourneyRuntimeDebugSnapshot;\n    teardown?: () => void;\n}\n\n/** @internal Restore/dispose record for HTTP instrumentation. */\nexport interface InstrumentRecord {\n    disposed: boolean;\n    restore?: () => void;\n}\n\n/**\n * Cross-bundle surface on `globalThis.__stJourney`.\n * Prefer importing `isJourneyEnabled` / `isJourneyDebugEnabled` from the package in app code.\n */\nexport interface StJourneyGlobal {\n    /**\n     * Fallback RUM instance from `setJourneyRum` when `globalThis.DD_RUM` is absent.\n     * Prefer `DD_RUM` (ST host: `datadogGuard`).\n     */\n    rum?: unknown;\n    /** Shared bag schema; mismatched copies warn but continue. */\n    schemaVersion?: number;\n    /** Host default enable (e.g. RUM active). Set via `setJourneyDefaultEnabled`. */\n    defaultEnabled?: boolean;\n    /** Shared configureJourney policies. */\n    policies: JourneySharedPolicies;\n    /**\n     * Bundle runtimes registered for DevTools `getDebugState()`.\n     * `{ id, getSnapshot }` so mixed package copies can list each other.\n     */\n    runtimeRegistrations: RuntimeRegistration[];\n    /** @internal Cross-bundle instrumented axios/fetch/jquery targets. */\n    instrumentedAxios: WeakSet<object>;\n    instrumentedFetch: WeakSet<object>;\n    instrumentedJquery: WeakSet<object>;\n    /** @internal Active instrument records for teardown. */\n    instrumentRecords: InstrumentRecord[];\n    fetchRestore?: () => void;\n    enable(): void;\n    disable(): void;\n    isEnabled(): boolean;\n    enableDebugging(): void;\n    disableDebugging(): void;\n    isDebugEnabled(): boolean;\n    /**\n     * Open-journey snapshot for DevTools. Returns empty `runtimes` unless debugging\n     * is enabled (`enableDebugging()` / `st:journey:debug`).\n     */\n    getDebugState(): JourneyDebugState;\n}\n\nlet warnedMissingSlowRequests = false;\nlet debugEnabledCache: boolean | undefined;\nconst MAX_INSTRUMENT_RECORDS = 32;\n\nfunction storageFor(key: string): Storage | undefined {\n    return key === JOURNEY_DEBUG_STORAGE_KEY ? globalThis.sessionStorage : globalThis.localStorage;\n}\n\nfunction readFlag(key: string): boolean {\n    try {\n        return storageFor(key)?.getItem(key) === 'true';\n    } catch {\n        return false;\n    }\n}\n\nfunction writeFlag(key: string, on: boolean): void {\n    try {\n        const storage = storageFor(key);\n        if (on) {\n            storage?.setItem(key, 'true');\n        } else {\n            storage?.removeItem(key);\n        }\n    } catch {\n        // ignore storage failures (privacy mode, non-browser)\n    }\n}\n\n/**\n * Host default for journey wiring (e.g. RUM initialized). Stored on `__stJourney` so\n * MFEs see the same value without importing Datadog. Call once after RUM init.\n */\nexport function setJourneyDefaultEnabled(enabled: boolean): void {\n    ensureGlobal().defaultEnabled = enabled === true;\n}\n\n/**\n * True when the host default is on or force-enable is set\n * (`st:journey:enabled` / `__stJourney.enable()`).\n */\nexport function isJourneyEnabled(): boolean {\n    return ensureGlobal().defaultEnabled === true || readFlag(JOURNEY_ENABLED_STORAGE_KEY);\n}\n\n/** Set the force-enable flag. Reload after calling from DevTools. */\nexport function enableJourney(): void {\n    writeFlag(JOURNEY_ENABLED_STORAGE_KEY, true);\n}\n\n/** Clear the force-enable flag. Reload after calling from DevTools. */\nexport function disableJourney(): void {\n    writeFlag(JOURNEY_ENABLED_STORAGE_KEY, false);\n}\n\n/** True when `sessionStorage['st:journey:debug'] === 'true'`. */\nexport function isJourneyDebugEnabled(): boolean {\n    const next = readFlag(JOURNEY_DEBUG_STORAGE_KEY);\n    if (debugEnabledCache !== next) {\n        debugEnabledCache = next;\n    }\n    return debugEnabledCache;\n}\n\n/** Set the console-debug flag. Reload after calling from DevTools. */\nexport function enableJourneyDebugging(): void {\n    writeFlag(JOURNEY_DEBUG_STORAGE_KEY, true);\n    debugEnabledCache = true;\n}\n\n/** Clear the console-debug flag. Reload after calling from DevTools. */\nexport function disableJourneyDebugging(): void {\n    writeFlag(JOURNEY_DEBUG_STORAGE_KEY, false);\n    debugEnabledCache = false;\n}\n\nfunction hasRum(): boolean {\n    return (\n        (globalThis as Record<string, unknown>).DD_RUM != null || getJourneyRumFallback() != null\n    );\n}\n\nfunction snapshotOf(entry: unknown): JourneyRuntimeDebugSnapshot | undefined {\n    if (entry == null || typeof entry !== 'object') {\n        return undefined;\n    }\n    const rec = entry as {\n        id?: string;\n        getSnapshot?: () => JourneyRuntimeDebugSnapshot;\n        getDebugSnapshot?: () => JourneyRuntimeDebugSnapshot;\n    };\n    try {\n        if (typeof rec.getSnapshot === 'function') {\n            const snap = rec.getSnapshot();\n            const withId = snap.id ? snap : { ...snap, id: rec.id ?? '' };\n            return {\n                ...withId,\n                policyOverlay: withId.policyOverlay ?? {\n                    slowRequests: false,\n                    httpAbortedRequests: false,\n                    httpClientErrorRequests: false,\n                    autoAttributeRequests: false,\n                },\n            };\n        }\n        if (typeof rec.getDebugSnapshot === 'function') {\n            return rec.getDebugSnapshot();\n        }\n    } catch {\n        return undefined;\n    }\n    return undefined;\n}\n\nfunction buildDebugState(runtimes: readonly unknown[]): JourneyDebugState {\n    if (!isJourneyDebugEnabled()) {\n        return {\n            enabled: isJourneyEnabled(),\n            debug: false,\n            hasRum: hasRum(),\n            runtimes: [],\n        };\n    }\n\n    return {\n        enabled: isJourneyEnabled(),\n        debug: true,\n        hasRum: hasRum(),\n        runtimes: runtimes\n            .map(snapshotOf)\n            .filter((snap): snap is JourneyRuntimeDebugSnapshot => snap != null),\n    };\n}\n\nfunction createEmptyPolicies(): JourneySharedPolicies {\n    return {\n        slowRequestsConfigured: false,\n        httpAbortedRequests: 'continue',\n        httpClientErrorRequests: 'continue',\n        autoAttributeRequests: true,\n        locked: false,\n    };\n}\n\nfunction ensureGlobal(): StJourneyGlobal {\n    const g = globalThis as Record<string, unknown>;\n    const existing = g[ST_JOURNEY_GLOBAL_KEY] as StJourneyGlobal | undefined;\n    // Reuse when a prior load already installed the full surface (incl. enable).\n    if (existing?.runtimeRegistrations && typeof existing.enable === 'function') {\n        if (\n            existing.schemaVersion != null &&\n            existing.schemaVersion !== ST_JOURNEY_SCHEMA_VERSION\n        ) {\n            // eslint-disable-next-line no-console -- cross-bundle version skew\n            console.warn(\n                `[journey] __stJourney.schemaVersion mismatch: bag=${existing.schemaVersion}, package=${ST_JOURNEY_SCHEMA_VERSION}`\n            );\n        } else {\n            existing.schemaVersion ??= ST_JOURNEY_SCHEMA_VERSION;\n        }\n        existing.policies ??= createEmptyPolicies();\n        if (existing.policies.locked !== true && existing.policies.locked !== false) {\n            existing.policies.locked = false;\n        }\n        existing.instrumentedAxios ??= new WeakSet();\n        existing.instrumentedFetch ??= new WeakSet();\n        existing.instrumentedJquery ??= new WeakSet();\n        existing.instrumentRecords ??= [];\n        return existing;\n    }\n\n    const runtimes: RuntimeRegistration[] = existing?.runtimeRegistrations ?? [];\n\n    const api: StJourneyGlobal = {\n        rum: existing?.rum,\n        schemaVersion: ST_JOURNEY_SCHEMA_VERSION,\n        defaultEnabled: existing?.defaultEnabled === true,\n        runtimeRegistrations: runtimes,\n        policies: createEmptyPolicies(),\n        instrumentedAxios: new WeakSet(),\n        instrumentedFetch: new WeakSet(),\n        instrumentedJquery: new WeakSet(),\n        instrumentRecords: [],\n        enable: enableJourney,\n        disable: disableJourney,\n        isEnabled: isJourneyEnabled,\n        enableDebugging: enableJourneyDebugging,\n        disableDebugging: disableJourneyDebugging,\n        isDebugEnabled: isJourneyDebugEnabled,\n        getDebugState() {\n            return buildDebugState(api.runtimeRegistrations);\n        },\n    };\n\n    g[ST_JOURNEY_GLOBAL_KEY] = api;\n    return api;\n}\n\n/** @internal Shared policies bag. */\nexport function getSharedPolicies(): JourneySharedPolicies {\n    return ensureGlobal().policies;\n}\n\nexport function areSharedPoliciesLocked(): boolean {\n    return ensureGlobal().policies.locked === true;\n}\n\nfunction freezePolicies(policies: JourneySharedPolicies): JourneySharedPolicies {\n    const next: JourneySharedPolicies = { ...policies, locked: true };\n    if (next.slowRequests) {\n        const endpoints = next.slowRequests.endpoints\n            ? Object.freeze([...next.slowRequests.endpoints])\n            : next.slowRequests.endpoints;\n        next.slowRequests = Object.freeze({ ...next.slowRequests, endpoints });\n    }\n    return Object.freeze(next);\n}\n\n/**\n * First writer: merge `patch` into the shared bag and freeze it.\n * Returns false when already locked (caller should overlay locally instead).\n */\nexport function seedSharedPolicies(patch: Partial<Omit<JourneySharedPolicies, 'locked'>>): boolean {\n    const api = ensureGlobal();\n    if (api.policies.locked) {\n        return false;\n    }\n    api.policies = freezePolicies({ ...api.policies, ...patch });\n    return true;\n}\n\nexport function getAutoAttributeRequests(): boolean {\n    return ensureGlobal().policies.autoAttributeRequests !== false;\n}\n\nexport function getHttpAbortedRequestsPolicy(): RequestPolicyConfig {\n    return ensureGlobal().policies.httpAbortedRequests;\n}\n\nexport function getHttpClientErrorRequestsPolicy(): RequestPolicyConfig {\n    return ensureGlobal().policies.httpClientErrorRequests;\n}\n\nexport function getSharedSlowRequests(): SlowRequestConfig | undefined {\n    return ensureGlobal().policies.slowRequests;\n}\n\nexport function areSharedSlowRequestsConfigured(): boolean {\n    return ensureGlobal().policies.slowRequestsConfigured === true;\n}\n\n/** One-time warn when transports are wired without explicit slowRequests. */\nexport function warnIfSlowRequestsUnset(): void {\n    if (warnedMissingSlowRequests || areSharedSlowRequestsConfigured()) {\n        return;\n    }\n    warnedMissingSlowRequests = true;\n    // eslint-disable-next-line no-console -- host config guidance\n    console.warn(\n        '[journey] using default slowRequests.defaultMs=4000 — set configureJourney({ slowRequests }) to tune'\n    );\n}\n\n/** @internal Reset shared policies (tests / teardown). */\nexport function resetSharedPolicies(): void {\n    const api = ensureGlobal();\n    api.policies = createEmptyPolicies();\n    warnedMissingSlowRequests = false;\n    debugEnabledCache = undefined;\n}\n\nexport function getInstrumentedAxiosSet(): WeakSet<object> {\n    return ensureGlobal().instrumentedAxios;\n}\n\nexport function getInstrumentedFetchSet(): WeakSet<object> {\n    return ensureGlobal().instrumentedFetch;\n}\n\nexport function getInstrumentedJquerySet(): WeakSet<object> {\n    return ensureGlobal().instrumentedJquery;\n}\n\nexport function registerInstrumentRecord(record: InstrumentRecord): void {\n    const api = ensureGlobal();\n    if (api.instrumentRecords.length >= MAX_INSTRUMENT_RECORDS) {\n        // eslint-disable-next-line no-console -- defensive cap for repeated instrumentation\n        console.warn('[journey] instrumentRecords cap reached — call teardownJourney()');\n        return;\n    }\n    api.instrumentRecords.push(record);\n}\n\nexport function setFetchRestore(restore: (() => void) | undefined): void {\n    ensureGlobal().fetchRestore = restore;\n}\n\n/**\n * @internal Register this bundle's engine on `__stJourney` so DevTools can list\n * every host/MFE copy on the page. Auto-assigns `runtime-N` when `runtime.id` is empty.\n * Replaces an existing registration with the same id (HMR / test re-register).\n */\nexport function registerJourneyRuntime(\n    runtime: JourneyRuntime,\n    options?: { teardown?: () => void }\n): void {\n    const bag = ensureGlobal();\n    if (runtime.id === '') {\n        (runtime as { id: string }).id = `runtime-${bag.runtimeRegistrations.length + 1}`;\n    }\n    const entry: RuntimeRegistration = {\n        id: runtime.id,\n        getSnapshot: () => runtime.getDebugSnapshot(),\n        teardown: options?.teardown,\n    };\n    const existing = bag.runtimeRegistrations.findIndex(reg => reg.id === runtime.id);\n    if (existing >= 0) {\n        bag.runtimeRegistrations[existing] = entry;\n    } else {\n        bag.runtimeRegistrations.push(entry);\n    }\n}\n\n/**\n * @internal Store a fallback RUM instance on `__stJourney.rum` when `DD_RUM` is absent.\n * Used by `setJourneyRum`.\n */\nexport function setJourneyRumFallback(rum: unknown): void {\n    ensureGlobal().rum = rum;\n}\n\n/** @internal Read `__stJourney.rum` (setJourneyRum fallback). */\nexport function getJourneyRumFallback(): unknown {\n    const existing = (globalThis as Record<string, unknown>)[ST_JOURNEY_GLOBAL_KEY] as\n        StJourneyGlobal | undefined;\n    return existing?.rum;\n}\n\n/**\n * Dispose HTTP instrumentation hooks and reset registered engines that supplied a\n * teardown callback. Intended for tests (e.g. afterEach). Prefer `resetJourney`\n * when you only need this bundle's engine state.\n */\nexport function teardownJourney(): void {\n    const api = ensureGlobal();\n    for (const record of api.instrumentRecords) {\n        record.disposed = true;\n        try {\n            record.restore?.();\n        } catch {\n            // ignore restore failures\n        }\n    }\n    api.instrumentRecords = [];\n    try {\n        api.fetchRestore?.();\n    } catch {\n        // ignore\n    }\n    api.fetchRestore = undefined;\n\n    const kept: RuntimeRegistration[] = [];\n    for (const entry of api.runtimeRegistrations) {\n        if (entry.teardown) {\n            try {\n                entry.teardown();\n            } catch {\n                // ignore\n            }\n            continue;\n        }\n        kept.push(entry);\n    }\n    api.runtimeRegistrations = kept;\n}\n"],"names":["JOURNEY_ENABLED_STORAGE_KEY","JOURNEY_DEBUG_STORAGE_KEY","ST_JOURNEY_GLOBAL_KEY","ST_JOURNEY_SCHEMA_VERSION","warnedMissingSlowRequests","debugEnabledCache","MAX_INSTRUMENT_RECORDS","storageFor","key","globalThis","sessionStorage","localStorage","readFlag","getItem","writeFlag","on","storage","setItem","removeItem","setJourneyDefaultEnabled","enabled","ensureGlobal","defaultEnabled","isJourneyEnabled","enableJourney","disableJourney","isJourneyDebugEnabled","next","enableJourneyDebugging","disableJourneyDebugging","hasRum","DD_RUM","getJourneyRumFallback","snapshotOf","entry","undefined","rec","getSnapshot","withId","snap","id","policyOverlay","slowRequests","httpAbortedRequests","httpClientErrorRequests","autoAttributeRequests","getDebugSnapshot","buildDebugState","runtimes","debug","map","filter","createEmptyPolicies","slowRequestsConfigured","locked","g","existing","runtimeRegistrations","enable","schemaVersion","console","warn","policies","instrumentedAxios","WeakSet","instrumentedFetch","instrumentedJquery","instrumentRecords","api","rum","disable","isEnabled","enableDebugging","disableDebugging","isDebugEnabled","getDebugState","getSharedPolicies","areSharedPoliciesLocked","freezePolicies","endpoints","Object","freeze","seedSharedPolicies","patch","getAutoAttributeRequests","getHttpAbortedRequestsPolicy","getHttpClientErrorRequestsPolicy","getSharedSlowRequests","areSharedSlowRequestsConfigured","warnIfSlowRequestsUnset","resetSharedPolicies","getInstrumentedAxiosSet","getInstrumentedFetchSet","getInstrumentedJquerySet","registerInstrumentRecord","record","length","push","setFetchRestore","restore","fetchRestore","registerJourneyRuntime","runtime","options","bag","teardown","findIndex","reg","setJourneyRumFallback","teardownJourney","disposed","kept"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,15 +1,19 @@
 import './config';
-export { activeJourneyStep, completeJourney, defineJourney, excludeJourney, failJourney, journeyStep, reportBackendRequest, resolveJourneyStep, setJourneyTags, JourneyStepTag, type JourneyDef, type JourneyHandle, type JourneyNameLike, type JourneyStepOptions, type JourneyStepRef, type JourneyStepTarget, type StepHandle, } from './core';
-export { configureJourney, type AppRequestTimeouts, type EndpointPolicy, type JourneyConfig, } from './config';
+export { defineJourney, completeJourney, excludeJourney, failJourney, journeyStep, setJourneyTags, singleInFlightJourneyStep, resolveStamp, JourneyStepStamp, type JourneyDef, type JourneyHandle, type JourneyNameLike, type JourneyStepOptions, type JourneyStepTarget, type StepHandle, } from './core';
+export { configureJourney, type JourneyConfig } from './config';
+export type { EndpointPolicy, SlowRequestConfig } from './core/endpoint-policy';
+export type { JourneyHttpPolicyContext, JourneyHttpScore, JourneyHttpScoreContext, JourneyRequestPolicy, JourneyStampOptions, RequestPolicyConfig, } from './core/request-policy';
 export type { JourneySink } from './core';
-/** Test helper — clears open journeys / ambient steps on the default engine. */
-export { resetJourney } from './core';
 export { instrumentAxios } from './integrations/axios';
 export { instrumentFetch } from './integrations/fetch';
 export { exposeAppJourney, instrumentJquery } from './integrations/jquery';
 export { requestKey, type JourneyTimedMeta } from './integrations/request-key';
-export { sendToDatadog, setJourneyRum } from './sinks/datadog';
+export { onHttpComplete, type HttpCompleteReport } from './integrations/http-report';
+export { disableJourney, disableJourneyDebugging, enableJourney, enableJourneyDebugging, isJourneyDebugEnabled, isJourneyEnabled, setJourneyDefaultEnabled, teardownJourney, } from './global';
+export { sendToConsole } from './sinks/console';
+export { normalizeTagValue, sendToDatadog, setJourneyRum } from './sinks/datadog';
 export type { JourneyEvent, JourneyStepEvent, TagValue } from './core';
 export { useJourneyName, useOptionalJourneyName } from './integrations/react/context';
 export { JourneyScope } from './integrations/react/scope';
+export { useJourneyStep } from './integrations/react/use-journey-step';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,UAAU,CAAC;AAElB,OAAO,EAEH,iBAAiB,EAEjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAClB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACH,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,GACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE/D,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,UAAU,CAAC;AAElB,OAAO,EAEH,aAAa,EAEb,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,cAAc,EAEd,yBAAyB,EACzB,YAAY,EACZ,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,GAClB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChF,YAAY,EACR,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EACH,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElF,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/index.js

@@ -3,17 +3,21 @@
  * import core APIs (defineJourney, etc.). Paired with package.json "sideEffects" for
  * config — otherwise bundlers with sideEffects:false would drop an unused re-export.
  */ import './config';
-export { // Custom transport adapters only.
-activeJourneyStep, // Prefer defineJourney(...).complete/fail/… — free helpers for name-from-context call sites.
-completeJourney, defineJourney, excludeJourney, failJourney, journeyStep, reportBackendRequest, resolveJourneyStep, setJourneyTags, JourneyStepTag } from './core';
+export { // Preferred app API.
+defineJourney, // Name-string lifecycle (prefer handle methods when you own the journey).
+completeJourney, excludeJourney, failJourney, journeyStep, setJourneyTags, // Custom transport adapters / request attribution.
+singleInFlightJourneyStep, resolveStamp, JourneyStepStamp } from './core';
 export { configureJourney } from './config';
-/** Test helper — clears open journeys / ambient steps on the default engine. */ export { resetJourney } from './core';
 export { instrumentAxios } from './integrations/axios';
 export { instrumentFetch } from './integrations/fetch';
 export { exposeAppJourney, instrumentJquery } from './integrations/jquery';
 export { requestKey } from './integrations/request-key';
-export { sendToDatadog, setJourneyRum } from './sinks/datadog';
+export { onHttpComplete } from './integrations/http-report';
+export { disableJourney, disableJourneyDebugging, enableJourney, enableJourneyDebugging, isJourneyDebugEnabled, isJourneyEnabled, setJourneyDefaultEnabled, teardownJourney } from './global';
+export { sendToConsole } from './sinks/console';
+export { normalizeTagValue, sendToDatadog, setJourneyRum } from './sinks/datadog';
 export { useJourneyName, useOptionalJourneyName } from './integrations/react/context';
 export { JourneyScope } from './integrations/react/scope';
+export { useJourneyStep } from './integrations/react/use-journey-step';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/*\n * Force-evaluate config so the default Datadog sink registers even when consumers only\n * import core APIs (defineJourney, etc.). Paired with package.json \"sideEffects\" for\n * config — otherwise bundlers with sideEffects:false would drop an unused re-export.\n */\nimport './config';\n\nexport {\n    // Custom transport adapters only.\n    activeJourneyStep,\n    // Prefer defineJourney(...).complete/fail/… — free helpers for name-from-context call sites.\n    completeJourney,\n    defineJourney,\n    excludeJourney,\n    failJourney,\n    journeyStep,\n    reportBackendRequest,\n    resolveJourneyStep,\n    setJourneyTags,\n    JourneyStepTag,\n    type JourneyDef,\n    type JourneyHandle,\n    type JourneyNameLike,\n    type JourneyStepOptions,\n    type JourneyStepRef,\n    type JourneyStepTarget,\n    type StepHandle,\n} from './core';\n\nexport {\n    configureJourney,\n    type AppRequestTimeouts,\n    type EndpointPolicy,\n    type JourneyConfig,\n} from './config';\n\nexport type { JourneySink } from './core';\n\n/** Test helper — clears open journeys / ambient steps on the default engine. */\nexport { resetJourney } from './core';\n\nexport { instrumentAxios } from './integrations/axios';\nexport { instrumentFetch } from './integrations/fetch';\nexport { exposeAppJourney, instrumentJquery } from './integrations/jquery';\nexport { requestKey, type JourneyTimedMeta } from './integrations/request-key';\nexport { sendToDatadog, setJourneyRum } from './sinks/datadog';\n\nexport type { JourneyEvent, JourneyStepEvent, TagValue } from './core';\n\nexport { useJourneyName, useOptionalJourneyName } from './integrations/react/context';\nexport { JourneyScope } from './integrations/react/scope';\n"],"names":["activeJourneyStep","completeJourney","defineJourney","excludeJourney","failJourney","journeyStep","reportBackendRequest","resolveJourneyStep","setJourneyTags","JourneyStepTag","configureJourney","resetJourney","instrumentAxios","instrumentFetch","exposeAppJourney","instrumentJquery","requestKey","sendToDatadog","setJourneyRum","useJourneyName","useOptionalJourneyName","JourneyScope"],"mappings":"AAAA;;;;CAIC,GACD,OAAO,WAAW;AAElB,SACI,kCAAkC;AAClCA,iBAAiB,EACjB,6FAA6F;AAC7FC,eAAe,EACfC,aAAa,EACbC,cAAc,EACdC,WAAW,EACXC,WAAW,EACXC,oBAAoB,EACpBC,kBAAkB,EAClBC,cAAc,EACdC,cAAc,QAQX,SAAS;AAEhB,SACIC,gBAAgB,QAIb,WAAW;AAIlB,8EAA8E,GAC9E,SAASC,YAAY,QAAQ,SAAS;AAEtC,SAASC,eAAe,QAAQ,uBAAuB;AACvD,SAASC,eAAe,QAAQ,uBAAuB;AACvD,SAASC,gBAAgB,EAAEC,gBAAgB,QAAQ,wBAAwB;AAC3E,SAASC,UAAU,QAA+B,6BAA6B;AAC/E,SAASC,aAAa,EAAEC,aAAa,QAAQ,kBAAkB;AAI/D,SAASC,cAAc,EAAEC,sBAAsB,QAAQ,+BAA+B;AACtF,SAASC,YAAY,QAAQ,6BAA6B"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/*\n * Force-evaluate config so the default Datadog sink registers even when consumers only\n * import core APIs (defineJourney, etc.). Paired with package.json \"sideEffects\" for\n * config — otherwise bundlers with sideEffects:false would drop an unused re-export.\n */\nimport './config';\n\nexport {\n    // Preferred app API.\n    defineJourney,\n    // Name-string lifecycle (prefer handle methods when you own the journey).\n    completeJourney,\n    excludeJourney,\n    failJourney,\n    journeyStep,\n    setJourneyTags,\n    // Custom transport adapters / request attribution.\n    singleInFlightJourneyStep,\n    resolveStamp,\n    JourneyStepStamp,\n    type JourneyDef,\n    type JourneyHandle,\n    type JourneyNameLike,\n    type JourneyStepOptions,\n    type JourneyStepTarget,\n    type StepHandle,\n} from './core';\n\nexport { configureJourney, type JourneyConfig } from './config';\nexport type { EndpointPolicy, SlowRequestConfig } from './core/endpoint-policy';\nexport type {\n    JourneyHttpPolicyContext,\n    JourneyHttpScore,\n    JourneyHttpScoreContext,\n    JourneyRequestPolicy,\n    JourneyStampOptions,\n    RequestPolicyConfig,\n} from './core/request-policy';\n\nexport type { JourneySink } from './core';\n\nexport { instrumentAxios } from './integrations/axios';\nexport { instrumentFetch } from './integrations/fetch';\nexport { exposeAppJourney, instrumentJquery } from './integrations/jquery';\nexport { requestKey, type JourneyTimedMeta } from './integrations/request-key';\nexport { onHttpComplete, type HttpCompleteReport } from './integrations/http-report';\nexport {\n    disableJourney,\n    disableJourneyDebugging,\n    enableJourney,\n    enableJourneyDebugging,\n    isJourneyDebugEnabled,\n    isJourneyEnabled,\n    setJourneyDefaultEnabled,\n    teardownJourney,\n} from './global';\nexport { sendToConsole } from './sinks/console';\nexport { normalizeTagValue, sendToDatadog, setJourneyRum } from './sinks/datadog';\n\nexport type { JourneyEvent, JourneyStepEvent, TagValue } from './core';\n\nexport { useJourneyName, useOptionalJourneyName } from './integrations/react/context';\nexport { JourneyScope } from './integrations/react/scope';\nexport { useJourneyStep } from './integrations/react/use-journey-step';\n"],"names":["defineJourney","completeJourney","excludeJourney","failJourney","journeyStep","setJourneyTags","singleInFlightJourneyStep","resolveStamp","JourneyStepStamp","configureJourney","instrumentAxios","instrumentFetch","exposeAppJourney","instrumentJquery","requestKey","onHttpComplete","disableJourney","disableJourneyDebugging","enableJourney","enableJourneyDebugging","isJourneyDebugEnabled","isJourneyEnabled","setJourneyDefaultEnabled","teardownJourney","sendToConsole","normalizeTagValue","sendToDatadog","setJourneyRum","useJourneyName","useOptionalJourneyName","JourneyScope","useJourneyStep"],"mappings":"AAAA;;;;CAIC,GACD,OAAO,WAAW;AAElB,SACI,qBAAqB;AACrBA,aAAa,EACb,0EAA0E;AAC1EC,eAAe,EACfC,cAAc,EACdC,WAAW,EACXC,WAAW,EACXC,cAAc,EACd,mDAAmD;AACnDC,yBAAyB,EACzBC,YAAY,EACZC,gBAAgB,QAOb,SAAS;AAEhB,SAASC,gBAAgB,QAA4B,WAAW;AAahE,SAASC,eAAe,QAAQ,uBAAuB;AACvD,SAASC,eAAe,QAAQ,uBAAuB;AACvD,SAASC,gBAAgB,EAAEC,gBAAgB,QAAQ,wBAAwB;AAC3E,SAASC,UAAU,QAA+B,6BAA6B;AAC/E,SAASC,cAAc,QAAiC,6BAA6B;AACrF,SACIC,cAAc,EACdC,uBAAuB,EACvBC,aAAa,EACbC,sBAAsB,EACtBC,qBAAqB,EACrBC,gBAAgB,EAChBC,wBAAwB,EACxBC,eAAe,QACZ,WAAW;AAClB,SAASC,aAAa,QAAQ,kBAAkB;AAChD,SAASC,iBAAiB,EAAEC,aAAa,EAAEC,aAAa,QAAQ,kBAAkB;AAIlF,SAASC,cAAc,EAAEC,sBAAsB,QAAQ,+BAA+B;AACtF,SAASC,YAAY,QAAQ,6BAA6B;AAC1D,SAASC,cAAc,QAAQ,wCAAwC"}

package/dist/integrations/axios.d.ts

@@ -8,9 +8,11 @@ export interface AxiosLikeInstance {
     interceptors: {
         request: {
             use(onFulfilled: (config: any) => any): unknown;
+            eject?(id: unknown): void;
         };
         response: {
             use(onFulfilled: (response: any) => any, onRejected?: (error: any) => any): unknown;
+            eject?(id: unknown): void;
         };
     };
 }
@@ -18,6 +20,8 @@ export interface AxiosLikeInstance {
  * Wire an axios instance into the journey engine (observation-only).
  * Call once per instance (idempotent). Register any async request interceptors
  * (e.g. auth) before this call so this one runs first.
+ * Soft-skips when `instance` is missing or not axios-like — hosts can pass axios as-is.
+ * Returns a restore function that disposes handlers (they no-op after restore).
  */
-export declare function instrumentAxios(instance: AxiosLikeInstance): void;
+export declare function instrumentAxios(instance: AxiosLikeInstance | null | undefined): () => void;
 //# sourceMappingURL=axios.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"axios.d.ts","sourceRoot":"","sources":["../../src/integrations/axios.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,EAAE;QACV,OAAO,EAAE;YAAE,GAAG,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAA;SAAE,CAAC;QAC7D,QAAQ,EAAE;YACN,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,GAAG,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC;SACvF,CAAC;KACL,CAAC;CACL;AAoBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAwCjE"}
+{"version":3,"file":"axios.d.ts","sourceRoot":"","sources":["../../src/integrations/axios.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,EAAE;QACV,OAAO,EAAE;YACL,GAAG,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC;YAChD,KAAK,CAAC,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;SAC7B,CAAC;QACF,QAAQ,EAAE;YACN,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,GAAG,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC;YACpF,KAAK,CAAC,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;SAC7B,CAAC;KACL,CAAC;CACL;AAwED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,CAqH1F"}