@servicetitan/journey 2.0.0 → 3.0.0

package/dist/integrations/axios.js

@@ -1,51 +1,163 @@
-import { activeJourneyStep, JourneyStepTag, reportBackendRequest, resolveJourneyStep } from '../core';
+import { resolveStamp } from '../core';
+import { adoptJourneyStepStamp } from '../core/step-tag';
+import { getInstrumentedAxiosSet, registerInstrumentRecord } from '../global';
+import { isCanceledError, onHttpComplete } from './http-report';
 import { requestKey } from './request-key';
-function reportTiming(instance, config, status) {
-    var _config_journeyStart;
-    const step = resolveJourneyStep(config === null || config === void 0 ? void 0 : config.journeyStep);
-    if (!step || !config) {
+import { acceptInstrumentTarget } from './soft-skip';
+const axiosStamps = new WeakMap();
+function stampFromConfig(config) {
+    var _axiosStamps_get;
+    if (!config) {
+        return undefined;
+    }
+    return (_axiosStamps_get = axiosStamps.get(config)) !== null && _axiosStamps_get !== void 0 ? _axiosStamps_get : adoptJourneyStepStamp(config.stamp);
+}
+function reportTiming(instance, config, status, aborted, extras) {
+    var _config_journeyStart, _ref;
+    if (!config || config.ignore === true) {
+        return;
+    }
+    const stamp = stampFromConfig(config);
+    if (!stamp || stamp.ignore) {
         return;
     }
     const start = (_config_journeyStart = config.journeyStart) !== null && _config_journeyStart !== void 0 ? _config_journeyStart : globalThis.performance.now();
     const key = requestKey(config.url, config.baseURL, instance.defaults.baseURL);
-    reportBackendRequest(step, status, globalThis.performance.now() - start, key);
+    onHttpComplete({
+        stamp,
+        status,
+        durationMs: globalThis.performance.now() - start,
+        requestKey: key,
+        aborted,
+        url: config.url,
+        method: config.method,
+        meta: config,
+        request: (_ref = extras === null || extras === void 0 ? void 0 : extras.request) !== null && _ref !== void 0 ? _ref : config,
+        response: extras === null || extras === void 0 ? void 0 : extras.response,
+        error: extras === null || extras === void 0 ? void 0 : extras.error
+    });
+}
+function isAxiosLikeInstance(value) {
+    var _instance_interceptors_request, _instance_interceptors, _instance_interceptors_response, _instance_interceptors1;
+    if (value == null || typeof value !== 'object' && typeof value !== 'function') {
+        return false;
+    }
+    const instance = value;
+    return instance.defaults != null && typeof instance.defaults === 'object' && typeof ((_instance_interceptors = instance.interceptors) === null || _instance_interceptors === void 0 ? void 0 : (_instance_interceptors_request = _instance_interceptors.request) === null || _instance_interceptors_request === void 0 ? void 0 : _instance_interceptors_request.use) === 'function' && typeof ((_instance_interceptors1 = instance.interceptors) === null || _instance_interceptors1 === void 0 ? void 0 : (_instance_interceptors_response = _instance_interceptors1.response) === null || _instance_interceptors_response === void 0 ? void 0 : _instance_interceptors_response.use) === 'function';
+}
+function ejectInterceptor(interceptors, id) {
+    if (id === undefined || typeof (interceptors === null || interceptors === void 0 ? void 0 : interceptors.eject) !== 'function') {
+        return false;
+    }
+    try {
+        interceptors.eject(id);
+        return true;
+    } catch (unused) {
+        return false;
+    }
 }
-const instrumented = new WeakSet();
 /**
  * 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 function instrumentAxios(instance) {
-    if (instrumented.has(instance)) {
-        return;
+    const axios = acceptInstrumentTarget('Axios', instance, isAxiosLikeInstance);
+    const instrumented = getInstrumentedAxiosSet();
+    if (!axios || instrumented.has(axios)) {
+        return ()=>{};
     }
-    instrumented.add(instance);
-    instance.interceptors.request.use((config)=>{
-        const timed = config;
-        /*
-         * Prefer explicit step.tag(); else soft ambient (null when 0 or 2+ steps in flight).
-         * Box ambient steps in JourneyStepTag — raw StepRecord is circular and blows axios mergeConfig.
-         */ if (!resolveJourneyStep(timed.journeyStep)) {
-            const step = activeJourneyStep();
-            if (step) {
-                timed.journeyStep = new JourneyStepTag(step);
+    const record = {
+        disposed: false
+    };
+    let requestId;
+    let responseId;
+    let requestAdded = false;
+    let responseAdded = false;
+    try {
+        requestId = axios.interceptors.request.use((config)=>{
+            if (record.disposed) {
+                return config;
+            }
+            const timed = config;
+            if (timed.ignore === true) {
+                return config;
+            }
+            const stamp = resolveStamp(timed.stamp);
+            if (stamp) {
+                axiosStamps.set(timed, stamp);
+            /*
+                 * Keep config.stamp so later interceptors that clone/spread config
+                 * still carry attribution. JourneyStepStamp.toJSON keeps this safe
+                 * for AxiosError serialization.
+                 */ }
+            if ((stamp === null || stamp === void 0 ? void 0 : stamp.ignore) === true) {
+                return config;
+            }
+            if (stamp) {
+                timed.journeyStart = globalThis.performance.now();
+            }
+            return config;
+        });
+        requestAdded = true;
+        responseId = axios.interceptors.response.use((response)=>{
+            if (!record.disposed) {
+                reportTiming(axios, response === null || response === void 0 ? void 0 : response.config, response === null || response === void 0 ? void 0 : response.status, false, {
+                    request: response === null || response === void 0 ? void 0 : response.config,
+                    response
+                });
             }
+            return response;
+        }, (error)=>{
+            if (!record.disposed) {
+                var _axiosError_response;
+                const axiosError = error;
+                reportTiming(axios, axiosError === null || axiosError === void 0 ? void 0 : axiosError.config, axiosError === null || axiosError === void 0 ? void 0 : (_axiosError_response = axiosError.response) === null || _axiosError_response === void 0 ? void 0 : _axiosError_response.status, isCanceledError(error), {
+                    request: axiosError === null || axiosError === void 0 ? void 0 : axiosError.config,
+                    response: axiosError === null || axiosError === void 0 ? void 0 : axiosError.response,
+                    error
+                });
+            }
+            /*
+                 * Passthrough original reason (AxiosError or test doubles). Do not wrap —
+                 * callers match on .response / AxiosError identity.
+                 */ return Promise.reject(error);
+        });
+        responseAdded = true;
+        instrumented.add(axios);
+    } catch (err) {
+        const unwound = (!responseAdded || ejectInterceptor(axios.interceptors.response, responseId)) && (!requestAdded || ejectInterceptor(axios.interceptors.request, requestId));
+        if (!unwound) {
+            /*
+             * Interceptors may still be registered and cannot be ejected. Mark disposed
+             * and keep the WeakSet slot, but register a restore so teardownJourney can
+             * unmark and a later retry can proceed.
+             */ record.disposed = true;
+            instrumented.add(axios);
+            const restore = ()=>{
+                record.disposed = true;
+                instrumented.delete(axios);
+            };
+            record.restore = restore;
+            registerInstrumentRecord(record);
+            // eslint-disable-next-line no-console -- soft-fail host wiring
+            console.error('[journey] instrumentAxios failed', err);
+            return restore;
         }
-        timed.journeyStart = globalThis.performance.now();
-        return config;
-    });
-    instance.interceptors.response.use((response)=>{
-        reportTiming(instance, response === null || response === void 0 ? void 0 : response.config, response === null || response === void 0 ? void 0 : response.status);
-        return response;
-    }, (error)=>{
-        var _axiosError_response;
-        const axiosError = error;
-        reportTiming(instance, axiosError === null || axiosError === void 0 ? void 0 : axiosError.config, axiosError === null || axiosError === void 0 ? void 0 : (_axiosError_response = axiosError.response) === null || _axiosError_response === void 0 ? void 0 : _axiosError_response.status);
-        /*
-             * Passthrough original reason (AxiosError or test doubles). Do not wrap —
-             * callers match on .response / AxiosError identity.
-             */ return Promise.reject(error);
-    });
+        // eslint-disable-next-line no-console -- soft-fail host wiring
+        console.error('[journey] instrumentAxios failed', err);
+        return ()=>{};
+    }
+    const restore = ()=>{
+        record.disposed = true;
+        ejectInterceptor(axios.interceptors.request, requestId);
+        ejectInterceptor(axios.interceptors.response, responseId);
+        instrumented.delete(axios);
+    };
+    record.restore = restore;
+    registerInstrumentRecord(record);
+    return restore;
 }
 
 //# sourceMappingURL=axios.js.map

package/dist/integrations/axios.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/integrations/axios.ts"],"sourcesContent":["import {\n    activeJourneyStep,\n    JourneyStepTag,\n    reportBackendRequest,\n    resolveJourneyStep,\n} from '../core';\nimport { requestKey, type JourneyTimedMeta } from './request-key';\n\n/**\n * Minimal structural axios surface. No axios dependency — works across 0.31 and 1.x.\n */\nexport interface AxiosLikeInstance {\n    defaults: { baseURL?: string };\n    interceptors: {\n        request: { use(onFulfilled: (config: any) => any): unknown };\n        response: {\n            use(onFulfilled: (response: any) => any, onRejected?: (error: any) => any): unknown;\n        };\n    };\n}\n\ntype TimedConfig = JourneyTimedMeta & { url?: string; baseURL?: string };\n\nfunction reportTiming(\n    instance: AxiosLikeInstance,\n    config: TimedConfig | undefined,\n    status: number | undefined\n): void {\n    const step = resolveJourneyStep(config?.journeyStep);\n    if (!step || !config) {\n        return;\n    }\n    const start = config.journeyStart ?? globalThis.performance.now();\n    const key = requestKey(config.url, config.baseURL, instance.defaults.baseURL);\n    reportBackendRequest(step, status, globalThis.performance.now() - start, key);\n}\n\nconst instrumented = new WeakSet<object>();\n\n/**\n * Wire an axios instance into the journey engine (observation-only).\n * Call once per instance (idempotent). Register any async request interceptors\n * (e.g. auth) before this call so this one runs first.\n */\nexport function instrumentAxios(instance: AxiosLikeInstance): void {\n    if (instrumented.has(instance as object)) {\n        return;\n    }\n    instrumented.add(instance as object);\n\n    instance.interceptors.request.use(config => {\n        const timed = config as TimedConfig;\n        /*\n         * Prefer explicit step.tag(); else soft ambient (null when 0 or 2+ steps in flight).\n         * Box ambient steps in JourneyStepTag — raw StepRecord is circular and blows axios mergeConfig.\n         */\n        if (!resolveJourneyStep(timed.journeyStep)) {\n            const step = activeJourneyStep();\n            if (step) {\n                timed.journeyStep = new JourneyStepTag(step);\n            }\n        }\n        timed.journeyStart = globalThis.performance.now();\n        return config;\n    });\n\n    instance.interceptors.response.use(\n        response => {\n            reportTiming(instance, response?.config as TimedConfig | undefined, response?.status);\n            return response;\n        },\n        (error: unknown) => {\n            const axiosError = error as {\n                config?: TimedConfig;\n                response?: { status?: number };\n            };\n            reportTiming(instance, axiosError?.config, axiosError?.response?.status);\n            /*\n             * Passthrough original reason (AxiosError or test doubles). Do not wrap —\n             * callers match on .response / AxiosError identity.\n             */\n            return Promise.reject(error as Error);\n        }\n    );\n}\n"],"names":["activeJourneyStep","JourneyStepTag","reportBackendRequest","resolveJourneyStep","requestKey","reportTiming","instance","config","status","step","journeyStep","start","journeyStart","globalThis","performance","now","key","url","baseURL","defaults","instrumented","WeakSet","instrumentAxios","has","add","interceptors","request","use","timed","response","error","axiosError","Promise","reject"],"mappings":"AAAA,SACIA,iBAAiB,EACjBC,cAAc,EACdC,oBAAoB,EACpBC,kBAAkB,QACf,UAAU;AACjB,SAASC,UAAU,QAA+B,gBAAgB;AAiBlE,SAASC,aACLC,QAA2B,EAC3BC,MAA+B,EAC/BC,MAA0B;QAMZD;IAJd,MAAME,OAAON,mBAAmBI,mBAAAA,6BAAAA,OAAQG,WAAW;IACnD,IAAI,CAACD,QAAQ,CAACF,QAAQ;QAClB;IACJ;IACA,MAAMI,SAAQJ,uBAAAA,OAAOK,YAAY,cAAnBL,kCAAAA,uBAAuBM,WAAWC,WAAW,CAACC,GAAG;IAC/D,MAAMC,MAAMZ,WAAWG,OAAOU,GAAG,EAAEV,OAAOW,OAAO,EAAEZ,SAASa,QAAQ,CAACD,OAAO;IAC5EhB,qBAAqBO,MAAMD,QAAQK,WAAWC,WAAW,CAACC,GAAG,KAAKJ,OAAOK;AAC7E;AAEA,MAAMI,eAAe,IAAIC;AAEzB;;;;CAIC,GACD,OAAO,SAASC,gBAAgBhB,QAA2B;IACvD,IAAIc,aAAaG,GAAG,CAACjB,WAAqB;QACtC;IACJ;IACAc,aAAaI,GAAG,CAAClB;IAEjBA,SAASmB,YAAY,CAACC,OAAO,CAACC,GAAG,CAACpB,CAAAA;QAC9B,MAAMqB,QAAQrB;QACd;;;SAGC,GACD,IAAI,CAACJ,mBAAmByB,MAAMlB,WAAW,GAAG;YACxC,MAAMD,OAAOT;YACb,IAAIS,MAAM;gBACNmB,MAAMlB,WAAW,GAAG,IAAIT,eAAeQ;YAC3C;QACJ;QACAmB,MAAMhB,YAAY,GAAGC,WAAWC,WAAW,CAACC,GAAG;QAC/C,OAAOR;IACX;IAEAD,SAASmB,YAAY,CAACI,QAAQ,CAACF,GAAG,CAC9BE,CAAAA;QACIxB,aAAaC,UAAUuB,qBAAAA,+BAAAA,SAAUtB,MAAM,EAA6BsB,qBAAAA,+BAAAA,SAAUrB,MAAM;QACpF,OAAOqB;IACX,GACA,CAACC;YAK8CC;QAJ3C,MAAMA,aAAaD;QAInBzB,aAAaC,UAAUyB,uBAAAA,iCAAAA,WAAYxB,MAAM,EAAEwB,uBAAAA,kCAAAA,uBAAAA,WAAYF,QAAQ,cAApBE,2CAAAA,qBAAsBvB,MAAM;QACvE;;;aAGC,GACD,OAAOwB,QAAQC,MAAM,CAACH;IAC1B;AAER"}
+{"version":3,"sources":["../../src/integrations/axios.ts"],"sourcesContent":["import { resolveStamp } from '../core';\nimport { adoptJourneyStepStamp, type JourneyStepStamp } from '../core/step-tag';\nimport {\n    getInstrumentedAxiosSet,\n    registerInstrumentRecord,\n    type InstrumentRecord,\n} from '../global';\nimport { isCanceledError, onHttpComplete } from './http-report';\nimport { requestKey, type JourneyTimedMeta } from './request-key';\nimport { acceptInstrumentTarget } from './soft-skip';\n\n/**\n * Minimal structural axios surface. No axios dependency — works across 0.31 and 1.x.\n */\nexport interface AxiosLikeInstance {\n    defaults: { baseURL?: string };\n    interceptors: {\n        request: {\n            use(onFulfilled: (config: any) => any): unknown;\n            eject?(id: unknown): void;\n        };\n        response: {\n            use(onFulfilled: (response: any) => any, onRejected?: (error: any) => any): unknown;\n            eject?(id: unknown): void;\n        };\n    };\n}\n\ntype TimedConfig = JourneyTimedMeta & { url?: string; baseURL?: string; method?: string };\n\nconst axiosStamps = new WeakMap<object, JourneyStepStamp>();\n\nfunction stampFromConfig(config: TimedConfig | undefined): JourneyStepStamp | undefined {\n    if (!config) {\n        return undefined;\n    }\n    return axiosStamps.get(config) ?? adoptJourneyStepStamp(config.stamp);\n}\n\nfunction reportTiming(\n    instance: AxiosLikeInstance,\n    config: TimedConfig | undefined,\n    status: number | undefined,\n    aborted: boolean,\n    extras?: { request?: unknown; response?: unknown; error?: unknown }\n): void {\n    if (!config || config.ignore === true) {\n        return;\n    }\n    const stamp = stampFromConfig(config);\n    if (!stamp || stamp.ignore) {\n        return;\n    }\n    const start = config.journeyStart ?? globalThis.performance.now();\n    const key = requestKey(config.url, config.baseURL, instance.defaults.baseURL);\n    onHttpComplete({\n        stamp,\n        status,\n        durationMs: globalThis.performance.now() - start,\n        requestKey: key,\n        aborted,\n        url: config.url,\n        method: config.method,\n        meta: config,\n        request: extras?.request ?? config,\n        response: extras?.response,\n        error: extras?.error,\n    });\n}\n\nfunction isAxiosLikeInstance(value: unknown): value is AxiosLikeInstance {\n    if (value == null || (typeof value !== 'object' && typeof value !== 'function')) {\n        return false;\n    }\n    const instance = value as AxiosLikeInstance;\n    return (\n        instance.defaults != null &&\n        typeof instance.defaults === 'object' &&\n        typeof instance.interceptors?.request?.use === 'function' &&\n        typeof instance.interceptors?.response?.use === 'function'\n    );\n}\n\nfunction ejectInterceptor(\n    interceptors: { eject?: (id: unknown) => void } | undefined,\n    id: unknown\n): boolean {\n    if (id === undefined || typeof interceptors?.eject !== 'function') {\n        return false;\n    }\n    try {\n        interceptors.eject(id);\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Wire an axios instance into the journey engine (observation-only).\n * Call once per instance (idempotent). Register any async request interceptors\n * (e.g. auth) before this call so this one runs first.\n * Soft-skips when `instance` is missing or not axios-like — hosts can pass axios as-is.\n * Returns a restore function that disposes handlers (they no-op after restore).\n */\nexport function instrumentAxios(instance: AxiosLikeInstance | null | undefined): () => void {\n    const axios = acceptInstrumentTarget('Axios', instance, isAxiosLikeInstance);\n    const instrumented = getInstrumentedAxiosSet();\n    if (!axios || instrumented.has(axios as object)) {\n        return () => {};\n    }\n\n    const record: InstrumentRecord = { disposed: false };\n    let requestId: unknown;\n    let responseId: unknown;\n    let requestAdded = false;\n    let responseAdded = false;\n\n    try {\n        requestId = axios.interceptors.request.use(config => {\n            if (record.disposed) {\n                return config;\n            }\n            const timed = config as TimedConfig;\n            if (timed.ignore === true) {\n                return config;\n            }\n            const stamp = resolveStamp(timed.stamp);\n            if (stamp) {\n                axiosStamps.set(timed, stamp);\n                /*\n                 * Keep config.stamp so later interceptors that clone/spread config\n                 * still carry attribution. JourneyStepStamp.toJSON keeps this safe\n                 * for AxiosError serialization.\n                 */\n            }\n            if (stamp?.ignore === true) {\n                return config;\n            }\n            if (stamp) {\n                timed.journeyStart = globalThis.performance.now();\n            }\n            return config;\n        });\n        requestAdded = true;\n\n        responseId = axios.interceptors.response.use(\n            response => {\n                if (!record.disposed) {\n                    reportTiming(\n                        axios,\n                        response?.config as TimedConfig | undefined,\n                        response?.status,\n                        false,\n                        { request: response?.config, response }\n                    );\n                }\n                return response;\n            },\n            (error: unknown) => {\n                if (!record.disposed) {\n                    const axiosError = error as {\n                        config?: TimedConfig;\n                        response?: { status?: number };\n                    };\n                    reportTiming(\n                        axios,\n                        axiosError?.config,\n                        axiosError?.response?.status,\n                        isCanceledError(error),\n                        {\n                            request: axiosError?.config,\n                            response: axiosError?.response,\n                            error,\n                        }\n                    );\n                }\n                /*\n                 * Passthrough original reason (AxiosError or test doubles). Do not wrap —\n                 * callers match on .response / AxiosError identity.\n                 */\n                return Promise.reject(error as Error);\n            }\n        );\n        responseAdded = true;\n        instrumented.add(axios as object);\n    } catch (err) {\n        const unwound =\n            (!responseAdded || ejectInterceptor(axios.interceptors.response, responseId)) &&\n            (!requestAdded || ejectInterceptor(axios.interceptors.request, requestId));\n        if (!unwound) {\n            /*\n             * Interceptors may still be registered and cannot be ejected. Mark disposed\n             * and keep the WeakSet slot, but register a restore so teardownJourney can\n             * unmark and a later retry can proceed.\n             */\n            record.disposed = true;\n            instrumented.add(axios as object);\n            const restore = () => {\n                record.disposed = true;\n                instrumented.delete(axios as object);\n            };\n            record.restore = restore;\n            registerInstrumentRecord(record);\n            // eslint-disable-next-line no-console -- soft-fail host wiring\n            console.error('[journey] instrumentAxios failed', err);\n            return restore;\n        }\n        // eslint-disable-next-line no-console -- soft-fail host wiring\n        console.error('[journey] instrumentAxios failed', err);\n        return () => {};\n    }\n\n    const restore = () => {\n        record.disposed = true;\n        ejectInterceptor(axios.interceptors.request, requestId);\n        ejectInterceptor(axios.interceptors.response, responseId);\n        instrumented.delete(axios as object);\n    };\n    record.restore = restore;\n    registerInstrumentRecord(record);\n    return restore;\n}\n"],"names":["resolveStamp","adoptJourneyStepStamp","getInstrumentedAxiosSet","registerInstrumentRecord","isCanceledError","onHttpComplete","requestKey","acceptInstrumentTarget","axiosStamps","WeakMap","stampFromConfig","config","undefined","get","stamp","reportTiming","instance","status","aborted","extras","ignore","start","journeyStart","globalThis","performance","now","key","url","baseURL","defaults","durationMs","method","meta","request","response","error","isAxiosLikeInstance","value","interceptors","use","ejectInterceptor","id","eject","instrumentAxios","axios","instrumented","has","record","disposed","requestId","responseId","requestAdded","responseAdded","timed","set","axiosError","Promise","reject","add","err","unwound","restore","delete","console"],"mappings":"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"}

package/dist/integrations/fetch.d.ts

@@ -1,14 +1,14 @@
 /** Minimal structural fetch shape. */
-export type FetchLike = (input: any, init?: any) => Promise<{
+type FetchLike = (input: any, init?: any) => Promise<{
     status: number;
 }>;
 /** Holder of a `fetch` property — globalThis by default, or a scoped object. */
-export interface FetchTarget {
+interface FetchTarget {
     fetch: FetchLike;
 }
 export interface InstrumentFetchOptions {
     /** Object whose `fetch` is wrapped. Defaults to globalThis. */
-    target?: FetchTarget;
+    target?: FetchTarget | null;
     /** Home API base URL for request-key origin resolution. */
     baseURL?: string;
 }
@@ -16,6 +16,8 @@ export interface InstrumentFetchOptions {
  * Wrap a target's fetch so requests inside a journeyStep are attributed and timed.
  * Call once per target (idempotent — second call is a no-op). Returns a restore
  * function that puts the original fetch back. Observation-only.
+ * Soft-skips when the resolved target is missing or has no callable `fetch`.
  */
-export declare function instrumentFetch(options?: InstrumentFetchOptions): () => void;
+export declare function instrumentFetch(options?: InstrumentFetchOptions | null): () => void;
+export {};
 //# sourceMappingURL=fetch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/integrations/fetch.ts"],"names":[],"mappings":"AAGA,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,IAAI,CAyDhF"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/integrations/fetch.ts"],"names":[],"mappings":"AAWA,sCAAsC;AACtC,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEzE,gFAAgF;AAChF,UAAU,WAAW;IACjB,KAAK,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAoCD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,GAAG,MAAM,IAAI,CAoHnF"}

package/dist/integrations/fetch.js

@@ -1,6 +1,8 @@
-import { activeJourneyStep, reportBackendRequest, resolveJourneyStep } from '../core';
+import { resolveStamp } from '../core';
+import { getInstrumentedFetchSet, registerInstrumentRecord, setFetchRestore } from '../global';
+import { isAbortError, onHttpComplete } from './http-report';
 import { requestKey } from './request-key';
-const instrumented = new WeakSet();
+import { acceptInstrumentTarget } from './soft-skip';
 const originals = new WeakMap();
 function resolveUrl(input) {
     if (typeof input === 'string') {
@@ -14,50 +16,127 @@ function resolveUrl(input) {
     }
     return undefined;
 }
+/** Fetch defaults to GET; `init.method` overrides a Request's method. */ function resolveMethod(input, init) {
+    if (typeof (init === null || init === void 0 ? void 0 : init.method) === 'string' && init.method !== '') {
+        return init.method;
+    }
+    if (typeof (input === null || input === void 0 ? void 0 : input.method) === 'string' && input.method !== '') {
+        return input.method;
+    }
+    return 'GET';
+}
+function isFetchTarget(value) {
+    return value != null && (typeof value === 'object' || typeof value === 'function') && typeof value.fetch === 'function';
+}
 /**
  * Wrap a target's fetch so requests inside a journeyStep are attributed and timed.
  * Call once per target (idempotent — second call is a no-op). Returns a restore
  * function that puts the original fetch back. Observation-only.
- */ export function instrumentFetch(options = {}) {
-    var _options_target;
-    const target = (_options_target = options.target) !== null && _options_target !== void 0 ? _options_target : globalThis;
+ * Soft-skips when the resolved target is missing or has no callable `fetch`.
+ */ export function instrumentFetch(options) {
+    if (options === null) {
+        acceptInstrumentTarget('Fetch', null, isFetchTarget);
+        return ()=>{};
+    }
+    const opts = options !== null && options !== void 0 ? options : {};
+    const candidate = opts.target !== undefined ? opts.target : globalThis;
+    const target = acceptInstrumentTarget('Fetch', candidate, isFetchTarget);
+    if (!target) {
+        return ()=>{};
+    }
     const key = target;
+    const instrumented = getInstrumentedFetchSet();
     if (instrumented.has(key)) {
         return ()=>{};
     }
     const original = target.fetch;
     originals.set(key, original);
     instrumented.add(key);
-    // Call through `target` — native fetch throws "Illegal invocation" with the wrong receiver.
-    const wrapped = (input, init)=>{
-        // Prefer explicit step.tag(); else soft ambient.
-        const explicit = resolveJourneyStep(init === null || init === void 0 ? void 0 : init.journeyStep);
-        const step = explicit !== null && explicit !== void 0 ? explicit : activeJourneyStep();
-        if (!step) {
-            return original.call(target, input, init);
-        }
-        const start = globalThis.performance.now();
-        const endpointKey = requestKey(resolveUrl(input), undefined, options.baseURL);
-        const promise = original.call(target, input, init);
-        return promise.then((response)=>{
-            reportBackendRequest(step, response.status, globalThis.performance.now() - start, endpointKey);
-            return response;
-        }, (error)=>{
-            reportBackendRequest(step, undefined, globalThis.performance.now() - start, endpointKey);
-            // Passthrough original rejection reason; do not wrap (identity / AbortError).
-            return Promise.reject(error);
-        });
+    const record = {
+        disposed: false
     };
-    target.fetch = wrapped;
-    return ()=>{
+    try {
+        // Call through `target` — native fetch throws "Illegal invocation" with the wrong receiver.
+        const wrapped = (input, init)=>{
+            if (record.disposed) {
+                return original.call(target, input, init);
+            }
+            // Prefer explicit step.stamp(); else auto-attribute when enabled.
+            const meta = init;
+            if ((meta === null || meta === void 0 ? void 0 : meta.ignore) === true) {
+                return original.call(target, input, init);
+            }
+            const stamp = resolveStamp(meta === null || meta === void 0 ? void 0 : meta.stamp);
+            if (!stamp || stamp.ignore) {
+                return original.call(target, input, init);
+            }
+            const start = globalThis.performance.now();
+            const url = resolveUrl(input);
+            const method = resolveMethod(input, init);
+            const endpointKey = requestKey(url, undefined, opts.baseURL);
+            const promise = original.call(target, input, init);
+            return promise.then((response)=>{
+                if (!record.disposed) {
+                    onHttpComplete({
+                        stamp,
+                        status: response.status,
+                        durationMs: globalThis.performance.now() - start,
+                        requestKey: endpointKey,
+                        url,
+                        method,
+                        meta,
+                        request: init !== null && init !== void 0 ? init : input,
+                        response
+                    });
+                }
+                return response;
+            }, (error)=>{
+                if (!record.disposed) {
+                    onHttpComplete({
+                        stamp,
+                        status: undefined,
+                        durationMs: globalThis.performance.now() - start,
+                        requestKey: endpointKey,
+                        aborted: isAbortError(error),
+                        url,
+                        method,
+                        meta,
+                        request: init !== null && init !== void 0 ? init : input,
+                        error
+                    });
+                }
+                // Passthrough original rejection reason; do not wrap (identity / AbortError).
+                return Promise.reject(error);
+            });
+        };
+        target.fetch = wrapped;
+    } catch (err) {
+        target.fetch = original;
+        instrumented.delete(key);
+        originals.delete(key);
+        // eslint-disable-next-line no-console -- soft-fail host wiring
+        console.error('[journey] instrumentFetch failed', err);
+        return ()=>{};
+    }
+    const restore = ()=>{
         var _originals_get;
         if (!instrumented.has(key)) {
             return;
         }
+        record.disposed = true;
         target.fetch = (_originals_get = originals.get(key)) !== null && _originals_get !== void 0 ? _originals_get : original;
         instrumented.delete(key);
         originals.delete(key);
+        if (target === globalThis) {
+            setFetchRestore(undefined);
+        }
     };
+    record.restore = restore;
+    registerInstrumentRecord(record);
+    if (target === globalThis) {
+        setFetchRestore(restore);
+    }
+    return restore;
 }
 
 //# sourceMappingURL=fetch.js.map

package/dist/integrations/fetch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/integrations/fetch.ts"],"sourcesContent":["import { activeJourneyStep, reportBackendRequest, resolveJourneyStep } from '../core';\nimport { requestKey, type JourneyTimedMeta } from './request-key';\n\n/** Minimal structural fetch shape. */\nexport type FetchLike = (input: any, init?: any) => Promise<{ status: number }>;\n\n/** Holder of a `fetch` property — globalThis by default, or a scoped object. */\nexport interface FetchTarget {\n    fetch: FetchLike;\n}\n\nexport interface InstrumentFetchOptions {\n    /** Object whose `fetch` is wrapped. Defaults to globalThis. */\n    target?: FetchTarget;\n    /** Home API base URL for request-key origin resolution. */\n    baseURL?: string;\n}\n\nconst instrumented = new WeakSet<object>();\nconst originals = new WeakMap<object, FetchLike>();\n\nfunction resolveUrl(input: any): string | undefined {\n    if (typeof input === 'string') {\n        return input;\n    }\n    if (input && typeof input.url === 'string') {\n        return input.url;\n    }\n    if (input && typeof input.href === 'string') {\n        return input.href;\n    }\n    return undefined;\n}\n\n/**\n * Wrap a target's fetch so requests inside a journeyStep are attributed and timed.\n * Call once per target (idempotent — second call is a no-op). Returns a restore\n * function that puts the original fetch back. Observation-only.\n */\nexport function instrumentFetch(options: InstrumentFetchOptions = {}): () => void {\n    const target = options.target ?? (globalThis as unknown as FetchTarget);\n    const key = target as object;\n\n    if (instrumented.has(key)) {\n        return () => {};\n    }\n\n    const original = target.fetch;\n    originals.set(key, original);\n    instrumented.add(key);\n\n    // Call through `target` — native fetch throws \"Illegal invocation\" with the wrong receiver.\n    const wrapped: FetchLike = (input, init) => {\n        // Prefer explicit step.tag(); else soft ambient.\n        const explicit = resolveJourneyStep((init as JourneyTimedMeta | undefined)?.journeyStep);\n        const step = explicit ?? activeJourneyStep();\n        if (!step) {\n            return original.call(target, input, init);\n        }\n\n        const start = globalThis.performance.now();\n        const endpointKey = requestKey(resolveUrl(input), undefined, options.baseURL);\n        const promise = original.call(target, input, init);\n        return promise.then(\n            response => {\n                reportBackendRequest(\n                    step,\n                    response.status,\n                    globalThis.performance.now() - start,\n                    endpointKey\n                );\n                return response;\n            },\n            (error: unknown) => {\n                reportBackendRequest(\n                    step,\n                    undefined,\n                    globalThis.performance.now() - start,\n                    endpointKey\n                );\n                // Passthrough original rejection reason; do not wrap (identity / AbortError).\n                return Promise.reject(error as Error);\n            }\n        );\n    };\n\n    target.fetch = wrapped;\n\n    return () => {\n        if (!instrumented.has(key)) {\n            return;\n        }\n        target.fetch = originals.get(key) ?? original;\n        instrumented.delete(key);\n        originals.delete(key);\n    };\n}\n"],"names":["activeJourneyStep","reportBackendRequest","resolveJourneyStep","requestKey","instrumented","WeakSet","originals","WeakMap","resolveUrl","input","url","href","undefined","instrumentFetch","options","target","globalThis","key","has","original","fetch","set","add","wrapped","init","explicit","journeyStep","step","call","start","performance","now","endpointKey","baseURL","promise","then","response","status","error","Promise","reject","get","delete"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,oBAAoB,EAAEC,kBAAkB,QAAQ,UAAU;AACtF,SAASC,UAAU,QAA+B,gBAAgB;AAiBlE,MAAMC,eAAe,IAAIC;AACzB,MAAMC,YAAY,IAAIC;AAEtB,SAASC,WAAWC,KAAU;IAC1B,IAAI,OAAOA,UAAU,UAAU;QAC3B,OAAOA;IACX;IACA,IAAIA,SAAS,OAAOA,MAAMC,GAAG,KAAK,UAAU;QACxC,OAAOD,MAAMC,GAAG;IACpB;IACA,IAAID,SAAS,OAAOA,MAAME,IAAI,KAAK,UAAU;QACzC,OAAOF,MAAME,IAAI;IACrB;IACA,OAAOC;AACX;AAEA;;;;CAIC,GACD,OAAO,SAASC,gBAAgBC,UAAkC,CAAC,CAAC;QACjDA;IAAf,MAAMC,UAASD,kBAAAA,QAAQC,MAAM,cAAdD,6BAAAA,kBAAmBE;IAClC,MAAMC,MAAMF;IAEZ,IAAIX,aAAac,GAAG,CAACD,MAAM;QACvB,OAAO,KAAO;IAClB;IAEA,MAAME,WAAWJ,OAAOK,KAAK;IAC7Bd,UAAUe,GAAG,CAACJ,KAAKE;IACnBf,aAAakB,GAAG,CAACL;IAEjB,4FAA4F;IAC5F,MAAMM,UAAqB,CAACd,OAAOe;QAC/B,iDAAiD;QACjD,MAAMC,WAAWvB,mBAAoBsB,iBAAAA,2BAAD,AAACA,KAAuCE,WAAW;QACvF,MAAMC,OAAOF,qBAAAA,sBAAAA,WAAYzB;QACzB,IAAI,CAAC2B,MAAM;YACP,OAAOR,SAASS,IAAI,CAACb,QAAQN,OAAOe;QACxC;QAEA,MAAMK,QAAQb,WAAWc,WAAW,CAACC,GAAG;QACxC,MAAMC,cAAc7B,WAAWK,WAAWC,QAAQG,WAAWE,QAAQmB,OAAO;QAC5E,MAAMC,UAAUf,SAASS,IAAI,CAACb,QAAQN,OAAOe;QAC7C,OAAOU,QAAQC,IAAI,CACfC,CAAAA;YACInC,qBACI0B,MACAS,SAASC,MAAM,EACfrB,WAAWc,WAAW,CAACC,GAAG,KAAKF,OAC/BG;YAEJ,OAAOI;QACX,GACA,CAACE;YACGrC,qBACI0B,MACAf,WACAI,WAAWc,WAAW,CAACC,GAAG,KAAKF,OAC/BG;YAEJ,8EAA8E;YAC9E,OAAOO,QAAQC,MAAM,CAACF;QAC1B;IAER;IAEAvB,OAAOK,KAAK,GAAGG;IAEf,OAAO;YAIYjB;QAHf,IAAI,CAACF,aAAac,GAAG,CAACD,MAAM;YACxB;QACJ;QACAF,OAAOK,KAAK,IAAGd,iBAAAA,UAAUmC,GAAG,CAACxB,kBAAdX,4BAAAA,iBAAsBa;QACrCf,aAAasC,MAAM,CAACzB;QACpBX,UAAUoC,MAAM,CAACzB;IACrB;AACJ"}
+{"version":3,"sources":["../../src/integrations/fetch.ts"],"sourcesContent":["import { resolveStamp } from '../core';\nimport {\n    getInstrumentedFetchSet,\n    registerInstrumentRecord,\n    setFetchRestore,\n    type InstrumentRecord,\n} from '../global';\nimport { isAbortError, onHttpComplete } from './http-report';\nimport { requestKey, type JourneyTimedMeta } from './request-key';\nimport { acceptInstrumentTarget } from './soft-skip';\n\n/** Minimal structural fetch shape. */\ntype FetchLike = (input: any, init?: any) => Promise<{ status: number }>;\n\n/** Holder of a `fetch` property — globalThis by default, or a scoped object. */\ninterface FetchTarget {\n    fetch: FetchLike;\n}\n\nexport interface InstrumentFetchOptions {\n    /** Object whose `fetch` is wrapped. Defaults to globalThis. */\n    target?: FetchTarget | null;\n    /** Home API base URL for request-key origin resolution. */\n    baseURL?: string;\n}\n\nconst originals = new WeakMap<object, FetchLike>();\n\nfunction resolveUrl(input: any): string | undefined {\n    if (typeof input === 'string') {\n        return input;\n    }\n    if (input && typeof input.url === 'string') {\n        return input.url;\n    }\n    if (input && typeof input.href === 'string') {\n        return input.href;\n    }\n    return undefined;\n}\n\n/** Fetch defaults to GET; `init.method` overrides a Request's method. */\nfunction resolveMethod(input: any, init?: any): string {\n    if (typeof init?.method === 'string' && init.method !== '') {\n        return init.method;\n    }\n    if (typeof input?.method === 'string' && input.method !== '') {\n        return input.method;\n    }\n    return 'GET';\n}\n\nfunction isFetchTarget(value: unknown): value is FetchTarget {\n    return (\n        value != null &&\n        (typeof value === 'object' || typeof value === 'function') &&\n        typeof (value as FetchTarget).fetch === 'function'\n    );\n}\n\n/**\n * Wrap a target's fetch so requests inside a journeyStep are attributed and timed.\n * Call once per target (idempotent — second call is a no-op). Returns a restore\n * function that puts the original fetch back. Observation-only.\n * Soft-skips when the resolved target is missing or has no callable `fetch`.\n */\nexport function instrumentFetch(options?: InstrumentFetchOptions | null): () => void {\n    if (options === null) {\n        acceptInstrumentTarget('Fetch', null, isFetchTarget);\n        return () => {};\n    }\n\n    const opts = options ?? {};\n    const candidate =\n        opts.target !== undefined ? opts.target : (globalThis as unknown as FetchTarget);\n    const target = acceptInstrumentTarget('Fetch', candidate, isFetchTarget);\n    if (!target) {\n        return () => {};\n    }\n\n    const key = target as object;\n    const instrumented = getInstrumentedFetchSet();\n\n    if (instrumented.has(key)) {\n        return () => {};\n    }\n\n    const original = target.fetch;\n    originals.set(key, original);\n    instrumented.add(key);\n\n    const record: InstrumentRecord = { disposed: false };\n\n    try {\n        // Call through `target` — native fetch throws \"Illegal invocation\" with the wrong receiver.\n        const wrapped: FetchLike = (input, init) => {\n            if (record.disposed) {\n                return original.call(target, input, init);\n            }\n            // Prefer explicit step.stamp(); else auto-attribute when enabled.\n            const meta = init as JourneyTimedMeta | undefined;\n            if (meta?.ignore === true) {\n                return original.call(target, input, init);\n            }\n            const stamp = resolveStamp(meta?.stamp);\n            if (!stamp || stamp.ignore) {\n                return original.call(target, input, init);\n            }\n\n            const start = globalThis.performance.now();\n            const url = resolveUrl(input);\n            const method = resolveMethod(input, init);\n            const endpointKey = requestKey(url, undefined, opts.baseURL);\n            const promise = original.call(target, input, init);\n            return promise.then(\n                response => {\n                    if (!record.disposed) {\n                        onHttpComplete({\n                            stamp,\n                            status: response.status,\n                            durationMs: globalThis.performance.now() - start,\n                            requestKey: endpointKey,\n                            url,\n                            method,\n                            meta,\n                            request: init ?? input,\n                            response,\n                        });\n                    }\n                    return response;\n                },\n                (error: unknown) => {\n                    if (!record.disposed) {\n                        onHttpComplete({\n                            stamp,\n                            status: undefined,\n                            durationMs: globalThis.performance.now() - start,\n                            requestKey: endpointKey,\n                            aborted: isAbortError(error),\n                            url,\n                            method,\n                            meta,\n                            request: init ?? input,\n                            error,\n                        });\n                    }\n                    // Passthrough original rejection reason; do not wrap (identity / AbortError).\n                    return Promise.reject(error as Error);\n                }\n            );\n        };\n\n        target.fetch = wrapped;\n    } catch (err) {\n        target.fetch = original;\n        instrumented.delete(key);\n        originals.delete(key);\n        // eslint-disable-next-line no-console -- soft-fail host wiring\n        console.error('[journey] instrumentFetch failed', err);\n        return () => {};\n    }\n\n    const restore = () => {\n        if (!instrumented.has(key)) {\n            return;\n        }\n        record.disposed = true;\n        target.fetch = originals.get(key) ?? original;\n        instrumented.delete(key);\n        originals.delete(key);\n        if (target === (globalThis as unknown as FetchTarget)) {\n            setFetchRestore(undefined);\n        }\n    };\n\n    record.restore = restore;\n    registerInstrumentRecord(record);\n    if (target === (globalThis as unknown as FetchTarget)) {\n        setFetchRestore(restore);\n    }\n\n    return restore;\n}\n"],"names":["resolveStamp","getInstrumentedFetchSet","registerInstrumentRecord","setFetchRestore","isAbortError","onHttpComplete","requestKey","acceptInstrumentTarget","originals","WeakMap","resolveUrl","input","url","href","undefined","resolveMethod","init","method","isFetchTarget","value","fetch","instrumentFetch","options","opts","candidate","target","globalThis","key","instrumented","has","original","set","add","record","disposed","wrapped","call","meta","ignore","stamp","start","performance","now","endpointKey","baseURL","promise","then","response","status","durationMs","request","error","aborted","Promise","reject","err","delete","console","restore","get"],"mappings":"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"}

package/dist/integrations/http-report.d.ts

@@ -0,0 +1,27 @@
+import type { JourneyStepStamp } from '../core/step-tag';
+import type { JourneyTimedMeta } from './request-key';
+export interface HttpCompleteReport {
+    stamp: JourneyStepStamp | undefined;
+    status?: number;
+    durationMs: number;
+    requestKey: string;
+    aborted?: boolean;
+    url?: string;
+    method?: string;
+    /** Per-request literal overrides from JourneyTimedMeta. */
+    meta?: JourneyTimedMeta;
+    /** Transport request (axios config, fetch input/init, jQuery settings). */
+    request?: unknown;
+    /** Transport response (axios response, fetch Response, jqXHR). */
+    response?: unknown;
+    /** Rejection reason when the transport failed. */
+    error?: unknown;
+}
+/**
+ * Attribute a finished HTTP call: abort / 4xx policies, else 5xx+latency via reportBackendRequest.
+ * Ignored endpoint prefixes never change the journey verdict.
+ * 4xx with policy `'continue'` (default) still scores latency.
+ */
+export declare function onHttpComplete(report: HttpCompleteReport): void;
+export { isAbortError, isCanceledError } from '../core/abort-error';
+//# sourceMappingURL=http-report.d.ts.map

package/dist/integrations/http-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-report.d.ts","sourceRoot":"","sources":["../../src/integrations/http-report.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAwCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CA2G/D;AAED,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/integrations/http-report.js

@@ -0,0 +1,123 @@
+import { MAX_ATTRIBUTED_REQUEST_KEYS } from '../core/limits';
+import { isJourneyRequestPolicy, resolveRequestPolicy } from '../core/request-policy';
+import { reportBackendRequest } from '../core/api';
+import { canRouteHttpToJourney, resolveJourneyEngine } from '../core/runtime';
+function applyPolicy(policy, step, reason, status) {
+    var _step, _reason;
+    if (policy === 'continue') {
+        return;
+    }
+    const journey = step.journey;
+    if (!journey || journey.closed) {
+        return;
+    }
+    const engine = resolveJourneyEngine(journey);
+    if (policy === 'exclude') {
+        engine.exclude();
+        return;
+    }
+    // 'bad'
+    step.outcome = 'bad';
+    (_reason = (_step = step).reason) !== null && _reason !== void 0 ? _reason : _step.reason = reason;
+    if (status !== undefined) {
+        step.httpStatus = status;
+    }
+    engine.failJourney(reason);
+}
+function httpScoreReason(report) {
+    if (report.aborted) {
+        return 'request-aborted';
+    }
+    const status = report.status;
+    if (status !== undefined && status >= 400 && status < 500) {
+        return 'request-client-error';
+    }
+    return 'request-error';
+}
+/**
+ * Attribute a finished HTTP call: abort / 4xx policies, else 5xx+latency via reportBackendRequest.
+ * Ignored endpoint prefixes never change the journey verdict.
+ * 4xx with policy `'continue'` (default) still scores latency.
+ */ export function onHttpComplete(report) {
+    const { stamp, status, durationMs, requestKey, aborted, url, method, meta, request, response, error } = report;
+    if (!stamp) {
+        return;
+    }
+    const step = stamp.step;
+    if (!(step === null || step === void 0 ? void 0 : step.journey)) {
+        return;
+    }
+    /*
+     * Unstamped foreign journeys (older package copies) cannot be closed from
+     * this bundle — do not write onHttpAborted / step.outcome on them.
+     */ if (!canRouteHttpToJourney(step.journey)) {
+        return;
+    }
+    const engine = resolveJourneyEngine(step.journey);
+    if ((meta === null || meta === void 0 ? void 0 : meta.ignore) === true || stamp.ignore === true) {
+        return;
+    }
+    if (aborted) {
+        step.onHttpAborted = true;
+    }
+    if (requestKey) {
+        var _step, _attributedRequestKeys;
+        (_attributedRequestKeys = (_step = step).attributedRequestKeys) !== null && _attributedRequestKeys !== void 0 ? _attributedRequestKeys : _step.attributedRequestKeys = [];
+        if (step.attributedRequestKeys.length < MAX_ATTRIBUTED_REQUEST_KEYS && !step.attributedRequestKeys.includes(requestKey)) {
+            step.attributedRequestKeys.push(requestKey);
+        }
+    }
+    if (requestKey && engine.shouldIgnoreRequest(requestKey)) {
+        return;
+    }
+    const ctx = {
+        requestKey,
+        status,
+        aborted: aborted === true,
+        url,
+        method,
+        journeyName: step.journey.name,
+        stepName: step.name
+    };
+    const score = stamp.score;
+    if (score) {
+        let policy;
+        try {
+            const scored = score({
+                ...ctx,
+                durationMs,
+                request,
+                response,
+                error
+            });
+            if (isJourneyRequestPolicy(scored)) {
+                policy = scored;
+            }
+        } catch (unused) {
+            policy = undefined;
+        }
+        if (policy !== undefined) {
+            applyPolicy(policy, step, httpScoreReason(report), status);
+            return;
+        }
+    }
+    if (aborted) {
+        const override = meta === null || meta === void 0 ? void 0 : meta.httpAbortedRequests;
+        const policy = isJourneyRequestPolicy(override) ? override : resolveRequestPolicy(engine.getHttpAbortedRequestsPolicy(), 'continue', ctx);
+        applyPolicy(policy, step, 'request-aborted');
+        return;
+    }
+    if (status !== undefined && status >= 400 && status < 500) {
+        const override = meta === null || meta === void 0 ? void 0 : meta.httpClientErrorRequests;
+        const policy = isJourneyRequestPolicy(override) ? override : resolveRequestPolicy(engine.getHttpClientErrorRequestsPolicy(), 'continue', ctx);
+        if (policy !== 'continue') {
+            applyPolicy(policy, step, 'request-client-error', status);
+            return;
+        }
+    // 'continue' does not count 4xx as an error; still score latency below.
+    }
+    reportBackendRequest(step, status, durationMs, requestKey);
+}
+export { isAbortError, isCanceledError } from '../core/abort-error';
+
+//# sourceMappingURL=http-report.js.map