@servicetitan/journey 2.0.0 → 3.0.0

package/dist/core/api.js

@@ -0,0 +1,122 @@
+import { moduleRuntime, resolveJourneyEngine } from './runtime';
+import { adoptJourneyStepStamp, JourneyStepStamp } from './step-tag';
+let ambientStamp = null;
+let ambientStep = null;
+/**
+ * Unique in-flight step as a stamp-ready {@link JourneyStepStamp}, or null when
+ * auto-attribute is disabled, or when 0 or 2+ steps are in flight app-wide.
+ * Ambient stamps never carry `score` or `ignore`. Untagged traffic is attributed
+ * to that lone step even if unrelated — prefer `step.stamp()` when the page has
+ * background instrumented requests. Disable via
+ * `configureJourney({ autoAttributeRequests: false })`.
+ */ export function singleInFlightJourneyStep() {
+    if (ambientStep === null || ambientStep === void 0 ? void 0 : ambientStep.journey.closed) {
+        ambientStep = null;
+        ambientStamp = null;
+    }
+    const activeStep = moduleRuntime.activeJourneyStep();
+    if (!activeStep) {
+        ambientStamp = null;
+        ambientStep = null;
+        return null;
+    }
+    if (ambientStep === activeStep && ambientStamp) {
+        return ambientStamp;
+    }
+    ambientStep = activeStep;
+    ambientStamp = new JourneyStepStamp(activeStep);
+    return ambientStamp;
+}
+/** @internal Clear cached ambient stamp when runtime state changes. */ export function invalidateAmbientStamp(step) {
+    if (!step || step === ambientStep) {
+        ambientStamp = null;
+        ambientStep = null;
+    }
+}
+/**
+ * Prefer an explicit `step.stamp()` value; else the ambient in-flight stamp.
+ * Same-realm stamps are returned as-is (identity + score + ignore). Branded
+ * foreign copies are adopted into a local stamp. Raw StepRecords are not stamps.
+ */ export function resolveStamp(explicit) {
+    var _singleInFlightJourneyStep;
+    const fromExplicit = adoptJourneyStepStamp(explicit);
+    if (fromExplicit) {
+        return fromExplicit;
+    }
+    return (_singleInFlightJourneyStep = singleInFlightJourneyStep()) !== null && _singleInFlightJourneyStep !== void 0 ? _singleInFlightJourneyStep : undefined;
+}
+/**
+ * Record a finished backend request against a captured step.
+ * 5xx / network / slow (over threshold) mark Bad; 4xx is not counted. Fail-fast on breach.
+ * @internal Prefer {@link onHttpComplete} from adapters.
+ */ export function reportBackendRequest(step, status, durationMs, requestKey) {
+    if (!(step === null || step === void 0 ? void 0 : step.journey)) {
+        return;
+    }
+    resolveJourneyEngine(step.journey).reportBackendRequest(step, status, durationMs, requestKey);
+}
+/**
+ * Run one step of a named journey. Runs untraced (noop handle) when no matching journey is open.
+ * `journey` may be a name, null, an ordered candidate list, a def, or a handle.
+ * A def or handle auto-starts when that journey is not already open; a bare name does not.
+ * Prefer `defineJourney(...).step` when you own the journey config.
+ */ export async function journeyStep(journey, stepName, fn, opts) {
+    return moduleRuntime.journeyStep(journey, stepName, fn, opts);
+}
+/** Merge custom tags onto an open journey. No-op if not open. Prefer `handle.setTags`. */ export function setJourneyTags(name, tags) {
+    moduleRuntime.setJourneyTags(name, tags);
+}
+/** Mark a named journey Bad for a custom reason (fail-fast). Prefer `handle.fail`. */ export function failJourney(name, reason) {
+    const journey = moduleRuntime.getOpenJourney(name);
+    if (journey) {
+        moduleRuntime.failJourney(journey, reason);
+    }
+}
+/** Successful end. Outcome stays Bad if a breach already occurred. No-op when name is null. Prefer `handle.complete`. */ export function completeJourney(name, tags) {
+    moduleRuntime.completeJourney(name, tags);
+}
+/** User left before finishing. Stays Bad if a breach already occurred (breach-anchored). Prefer `handle.exclude`. */ export function excludeJourney(name) {
+    const journey = moduleRuntime.getOpenJourney(name);
+    if (journey) {
+        moduleRuntime.excludeJourney(journey);
+    }
+}
+/** Turn a journey config into a handle with bound lifecycle methods. Preferred public API. */ export function defineJourney(config) {
+    return {
+        config,
+        start (tags) {
+            moduleRuntime.startJourney(config);
+            if (tags) {
+                moduleRuntime.setJourneyTags(config.name, tags);
+            }
+        },
+        step (stepName, fn, opts) {
+            if (!moduleRuntime.getOpenJourney(config.name)) {
+                moduleRuntime.startJourney(config);
+            }
+            return journeyStep(config.name, stepName, fn, opts);
+        },
+        async mountStep (stepName, fn, opts) {
+            // Defer so a parent <JourneyScope> opens first (child effects run before parent).
+            await Promise.resolve();
+            if (!moduleRuntime.getOpenJourney(config.name)) {
+                moduleRuntime.startJourney(config);
+            }
+            return journeyStep(config.name, stepName, fn, opts);
+        },
+        complete (tags) {
+            completeJourney(config.name, tags);
+        },
+        fail (reason) {
+            failJourney(config.name, reason);
+        },
+        exclude () {
+            excludeJourney(config.name);
+        },
+        setTags (tags) {
+            setJourneyTags(config.name, tags);
+        }
+    };
+}
+
+//# sourceMappingURL=api.js.map

package/dist/core/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/api.ts"],"sourcesContent":["import { moduleRuntime, resolveJourneyEngine } from './runtime';\nimport { adoptJourneyStepStamp, JourneyStepStamp } from './step-tag';\nimport type {\n    JourneyDef,\n    JourneyHandle,\n    JourneyStepOptions,\n    JourneyStepTarget,\n    StepHandle,\n    StepRecord,\n    TagValue,\n} from './types';\n\nlet ambientStamp: JourneyStepStamp | null = null;\nlet ambientStep: StepRecord | null = null;\n\n/**\n * Unique in-flight step as a stamp-ready {@link JourneyStepStamp}, or null when\n * auto-attribute is disabled, or when 0 or 2+ steps are in flight app-wide.\n * Ambient stamps never carry `score` or `ignore`. Untagged traffic is attributed\n * to that lone step even if unrelated — prefer `step.stamp()` when the page has\n * background instrumented requests. Disable via\n * `configureJourney({ autoAttributeRequests: false })`.\n */\nexport function singleInFlightJourneyStep(): JourneyStepStamp | null {\n    if (ambientStep?.journey.closed) {\n        ambientStep = null;\n        ambientStamp = null;\n    }\n    const activeStep = moduleRuntime.activeJourneyStep();\n    if (!activeStep) {\n        ambientStamp = null;\n        ambientStep = null;\n        return null;\n    }\n    if (ambientStep === activeStep && ambientStamp) {\n        return ambientStamp;\n    }\n    ambientStep = activeStep;\n    ambientStamp = new JourneyStepStamp(activeStep);\n    return ambientStamp;\n}\n\n/** @internal Clear cached ambient stamp when runtime state changes. */\nexport function invalidateAmbientStamp(step?: StepRecord): void {\n    if (!step || step === ambientStep) {\n        ambientStamp = null;\n        ambientStep = null;\n    }\n}\n\n/**\n * Prefer an explicit `step.stamp()` value; else the ambient in-flight stamp.\n * Same-realm stamps are returned as-is (identity + score + ignore). Branded\n * foreign copies are adopted into a local stamp. Raw StepRecords are not stamps.\n */\nexport function resolveStamp(explicit?: unknown): JourneyStepStamp | undefined {\n    const fromExplicit = adoptJourneyStepStamp(explicit);\n    if (fromExplicit) {\n        return fromExplicit;\n    }\n    return singleInFlightJourneyStep() ?? undefined;\n}\n\n/**\n * Record a finished backend request against a captured step.\n * 5xx / network / slow (over threshold) mark Bad; 4xx is not counted. Fail-fast on breach.\n * @internal Prefer {@link onHttpComplete} from adapters.\n */\nexport function reportBackendRequest(\n    step: StepRecord | undefined,\n    status: number | undefined,\n    durationMs: number,\n    requestKey: string\n): void {\n    if (!step?.journey) {\n        return;\n    }\n    resolveJourneyEngine(step.journey).reportBackendRequest(step, status, durationMs, requestKey);\n}\n\n/**\n * Run one step of a named journey. Runs untraced (noop handle) when no matching journey is open.\n * `journey` may be a name, null, an ordered candidate list, a def, or a handle.\n * A def or handle auto-starts when that journey is not already open; a bare name does not.\n * Prefer `defineJourney(...).step` when you own the journey config.\n */\nexport async function journeyStep<T>(\n    journey: JourneyStepTarget,\n    stepName: string,\n    fn: (step: StepHandle) => T | Promise<T>,\n    opts?: JourneyStepOptions\n): Promise<T> {\n    return moduleRuntime.journeyStep(journey, stepName, fn, opts);\n}\n\n/** Merge custom tags onto an open journey. No-op if not open. Prefer `handle.setTags`. */\nexport function setJourneyTags(name: string | null, tags: Record<string, TagValue>): void {\n    moduleRuntime.setJourneyTags(name, tags);\n}\n\n/** Mark a named journey Bad for a custom reason (fail-fast). Prefer `handle.fail`. */\nexport function failJourney(name: string, reason: string): void {\n    const journey = moduleRuntime.getOpenJourney(name);\n    if (journey) {\n        moduleRuntime.failJourney(journey, reason);\n    }\n}\n\n/** Successful end. Outcome stays Bad if a breach already occurred. No-op when name is null. Prefer `handle.complete`. */\nexport function completeJourney(name: string | null, tags?: Record<string, TagValue>): void {\n    moduleRuntime.completeJourney(name, tags);\n}\n\n/** User left before finishing. Stays Bad if a breach already occurred (breach-anchored). Prefer `handle.exclude`. */\nexport function excludeJourney(name: string): void {\n    const journey = moduleRuntime.getOpenJourney(name);\n    if (journey) {\n        moduleRuntime.excludeJourney(journey);\n    }\n}\n\n/** Turn a journey config into a handle with bound lifecycle methods. Preferred public API. */\nexport function defineJourney(config: JourneyDef): JourneyHandle {\n    return {\n        config,\n        start(tags) {\n            moduleRuntime.startJourney(config);\n            if (tags) {\n                moduleRuntime.setJourneyTags(config.name, tags);\n            }\n        },\n        step(stepName, fn, opts) {\n            if (!moduleRuntime.getOpenJourney(config.name)) {\n                moduleRuntime.startJourney(config);\n            }\n            return journeyStep(config.name, stepName, fn, opts);\n        },\n        async mountStep(stepName, fn, opts) {\n            // Defer so a parent <JourneyScope> opens first (child effects run before parent).\n            await Promise.resolve();\n            if (!moduleRuntime.getOpenJourney(config.name)) {\n                moduleRuntime.startJourney(config);\n            }\n            return journeyStep(config.name, stepName, fn, opts);\n        },\n        complete(tags) {\n            completeJourney(config.name, tags);\n        },\n        fail(reason) {\n            failJourney(config.name, reason);\n        },\n        exclude() {\n            excludeJourney(config.name);\n        },\n        setTags(tags) {\n            setJourneyTags(config.name, tags);\n        },\n    };\n}\n"],"names":["moduleRuntime","resolveJourneyEngine","adoptJourneyStepStamp","JourneyStepStamp","ambientStamp","ambientStep","singleInFlightJourneyStep","journey","closed","activeStep","activeJourneyStep","invalidateAmbientStamp","step","resolveStamp","explicit","fromExplicit","undefined","reportBackendRequest","status","durationMs","requestKey","journeyStep","stepName","fn","opts","setJourneyTags","name","tags","failJourney","reason","getOpenJourney","completeJourney","excludeJourney","defineJourney","config","start","startJourney","mountStep","Promise","resolve","complete","fail","exclude","setTags"],"mappings":"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"}

package/dist/{endpoint-policy.d.ts → core/endpoint-policy.d.ts}

@@ -1,3 +1,4 @@
+import type { JourneyState } from './types';
 /** Per-endpoint request policy (app-wide or per-journey). Longest matching prefix wins. */
 export interface EndpointPolicy {
     /**
@@ -7,18 +8,22 @@ export interface EndpointPolicy {
      * `match` already supplies the boundary.
      */
     match: string;
-    /** Custom slow-request threshold in ms; omit / 0 falls through. */
-    timeoutMs?: number;
-    /** When true, errors and slow responses never mark the journey Bad. */
+    /** Custom slow-request threshold in ms; omit to fall through. `0` disables latency scoring for this prefix. */
+    slowRequestMs?: number;
+    /** When true, this endpoint never changes the journey verdict (errors, latency, aborts, 4xx). */
     ignore?: boolean;
 }
 /** App-wide slow-request threshold fallback (not an axios abort). */
-export interface AppRequestTimeouts {
+export interface SlowRequestConfig {
     /** Fallback threshold when no endpoint or journey override applies. */
     defaultMs: number;
     /** App-wide endpoint overrides; journey-specific ones belong on JourneyDef.endpoints. */
     endpoints?: readonly EndpointPolicy[];
 }
+export interface ResolvedEndpointPolicy {
+    ignore: boolean;
+    slowRequestMs: number;
+}
 /** Copy sorted longest-match-first so lookup can return on the first hit. */
 export declare function sortEndpointsByLongestMatch(endpoints: readonly EndpointPolicy[] | undefined): EndpointPolicy[] | undefined;
 /**
@@ -26,4 +31,9 @@ export declare function sortEndpointsByLongestMatch(endpoints: readonly Endpoint
  * Expects `endpoints` sorted longest-match-first (see `sortEndpointsByLongestMatch`).
  */
 export declare function longestEndpointMatch(endpoints: readonly EndpointPolicy[] | undefined, key: string): EndpointPolicy | undefined;
+/**
+ * Resolve ignore + latency threshold with longest-prefix matching.
+ * Journey overrides win over app defaults for slow thresholds.
+ */
+export declare function resolveEndpointPolicy(journey: JourneyState, appSlow: SlowRequestConfig, requestKey: string): ResolvedEndpointPolicy;
 //# sourceMappingURL=endpoint-policy.d.ts.map

package/dist/core/endpoint-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-policy.d.ts","sourceRoot":"","sources":["../../src/core/endpoint-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC3B;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,+GAA+G;IAC/G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAC9B,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,GACjD,cAAc,EAAE,GAAG,SAAS,CAQ9B;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,EAChD,GAAG,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAO5B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,GACnB,sBAAsB,CAyBxB"}

package/dist/core/endpoint-policy.js

@@ -0,0 +1,70 @@
+/** Copy sorted longest-match-first so lookup can return on the first hit. */ export function sortEndpointsByLongestMatch(endpoints) {
+    if (endpoints == null) {
+        return undefined;
+    }
+    if (endpoints.length <= 1) {
+        return endpoints.length === 0 ? [] : [
+            ...endpoints
+        ];
+    }
+    return [
+        ...endpoints
+    ].sort((a, b)=>b.match.length - a.match.length);
+}
+/**
+ * True when `key` equals `match` or continues past a path boundary.
+ * `/api/user` matches `/api/user` and `/api/user/42`, not `/api/user-preferences`.
+ */ function matchesEndpoint(key, match) {
+    if (!key.startsWith(match)) {
+        return false;
+    }
+    if (match.endsWith('/')) {
+        return true;
+    }
+    const next = key[match.length];
+    return next === undefined || next === '/';
+}
+/**
+ * Longest-prefix match of an endpoint list against a request key.
+ * Expects `endpoints` sorted longest-match-first (see `sortEndpointsByLongestMatch`).
+ */ export function longestEndpointMatch(endpoints, key) {
+    for (const e of endpoints !== null && endpoints !== void 0 ? endpoints : []){
+        if (matchesEndpoint(key, e.match)) {
+            return e;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve ignore + latency threshold with longest-prefix matching.
+ * Journey overrides win over app defaults for slow thresholds.
+ */ export function resolveEndpointPolicy(journey, appSlow, requestKey) {
+    var _ref, _ref1;
+    const own = longestEndpointMatch(journey.endpoints, requestKey);
+    if ((own === null || own === void 0 ? void 0 : own.ignore) === true) {
+        return {
+            ignore: true,
+            slowRequestMs: 0
+        };
+    }
+    const app = longestEndpointMatch(appSlow.endpoints, requestKey);
+    if (own) {
+        var _ref2, _ref3, _own_slowRequestMs;
+        return {
+            ignore: false,
+            slowRequestMs: (_ref2 = (_ref3 = (_own_slowRequestMs = own.slowRequestMs) !== null && _own_slowRequestMs !== void 0 ? _own_slowRequestMs : app === null || app === void 0 ? void 0 : app.slowRequestMs) !== null && _ref3 !== void 0 ? _ref3 : journey.slowRequestMs) !== null && _ref2 !== void 0 ? _ref2 : appSlow.defaultMs
+        };
+    }
+    if ((app === null || app === void 0 ? void 0 : app.ignore) === true) {
+        return {
+            ignore: true,
+            slowRequestMs: 0
+        };
+    }
+    return {
+        ignore: false,
+        slowRequestMs: (_ref = (_ref1 = app === null || app === void 0 ? void 0 : app.slowRequestMs) !== null && _ref1 !== void 0 ? _ref1 : journey.slowRequestMs) !== null && _ref !== void 0 ? _ref : appSlow.defaultMs
+    };
+}
+
+//# sourceMappingURL=endpoint-policy.js.map

package/dist/core/endpoint-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/endpoint-policy.ts"],"sourcesContent":["import type { JourneyState } from './types';\n\n/** Per-endpoint request policy (app-wide or per-journey). Longest matching prefix wins. */\nexport interface EndpointPolicy {\n    /**\n     * Path/host prefix against the request key (`\"/path\"` same-origin, `\"host/path\"` cross-domain).\n     * Match requires an exact hit or a `/` boundary after the prefix — `/api/user` matches\n     * `/api/user` and `/api/user/42`, but not `/api/user-preferences`. A trailing `/` on\n     * `match` already supplies the boundary.\n     */\n    match: string;\n    /** Custom slow-request threshold in ms; omit to fall through. `0` disables latency scoring for this prefix. */\n    slowRequestMs?: number;\n    /** When true, this endpoint never changes the journey verdict (errors, latency, aborts, 4xx). */\n    ignore?: boolean;\n}\n\n/** App-wide slow-request threshold fallback (not an axios abort). */\nexport interface SlowRequestConfig {\n    /** Fallback threshold when no endpoint or journey override applies. */\n    defaultMs: number;\n    /** App-wide endpoint overrides; journey-specific ones belong on JourneyDef.endpoints. */\n    endpoints?: readonly EndpointPolicy[];\n}\n\nexport interface ResolvedEndpointPolicy {\n    ignore: boolean;\n    slowRequestMs: number;\n}\n\n/** Copy sorted longest-match-first so lookup can return on the first hit. */\nexport function sortEndpointsByLongestMatch(\n    endpoints: readonly EndpointPolicy[] | undefined\n): EndpointPolicy[] | undefined {\n    if (endpoints == null) {\n        return undefined;\n    }\n    if (endpoints.length <= 1) {\n        return endpoints.length === 0 ? [] : [...endpoints];\n    }\n    return [...endpoints].sort((a, b) => b.match.length - a.match.length);\n}\n\n/**\n * True when `key` equals `match` or continues past a path boundary.\n * `/api/user` matches `/api/user` and `/api/user/42`, not `/api/user-preferences`.\n */\nfunction matchesEndpoint(key: string, match: string): boolean {\n    if (!key.startsWith(match)) {\n        return false;\n    }\n    if (match.endsWith('/')) {\n        return true;\n    }\n    const next = key[match.length];\n    return next === undefined || next === '/';\n}\n\n/**\n * Longest-prefix match of an endpoint list against a request key.\n * Expects `endpoints` sorted longest-match-first (see `sortEndpointsByLongestMatch`).\n */\nexport function longestEndpointMatch(\n    endpoints: readonly EndpointPolicy[] | undefined,\n    key: string\n): EndpointPolicy | undefined {\n    for (const e of endpoints ?? []) {\n        if (matchesEndpoint(key, e.match)) {\n            return e;\n        }\n    }\n    return undefined;\n}\n\n/**\n * Resolve ignore + latency threshold with longest-prefix matching.\n * Journey overrides win over app defaults for slow thresholds.\n */\nexport function resolveEndpointPolicy(\n    journey: JourneyState,\n    appSlow: SlowRequestConfig,\n    requestKey: string\n): ResolvedEndpointPolicy {\n    const own = longestEndpointMatch(journey.endpoints, requestKey);\n    if (own?.ignore === true) {\n        return { ignore: true, slowRequestMs: 0 };\n    }\n\n    const app = longestEndpointMatch(appSlow.endpoints, requestKey);\n    if (own) {\n        return {\n            ignore: false,\n            slowRequestMs:\n                own.slowRequestMs ??\n                app?.slowRequestMs ??\n                journey.slowRequestMs ??\n                appSlow.defaultMs,\n        };\n    }\n    if (app?.ignore === true) {\n        return { ignore: true, slowRequestMs: 0 };\n    }\n\n    return {\n        ignore: false,\n        slowRequestMs: app?.slowRequestMs ?? journey.slowRequestMs ?? appSlow.defaultMs,\n    };\n}\n"],"names":["sortEndpointsByLongestMatch","endpoints","undefined","length","sort","a","b","match","matchesEndpoint","key","startsWith","endsWith","next","longestEndpointMatch","e","resolveEndpointPolicy","journey","appSlow","requestKey","app","own","ignore","slowRequestMs","defaultMs"],"mappings":"AA8BA,2EAA2E,GAC3E,OAAO,SAASA,4BACZC,SAAgD;IAEhD,IAAIA,aAAa,MAAM;QACnB,OAAOC;IACX;IACA,IAAID,UAAUE,MAAM,IAAI,GAAG;QACvB,OAAOF,UAAUE,MAAM,KAAK,IAAI,EAAE,GAAG;eAAIF;SAAU;IACvD;IACA,OAAO;WAAIA;KAAU,CAACG,IAAI,CAAC,CAACC,GAAGC,IAAMA,EAAEC,KAAK,CAACJ,MAAM,GAAGE,EAAEE,KAAK,CAACJ,MAAM;AACxE;AAEA;;;CAGC,GACD,SAASK,gBAAgBC,GAAW,EAAEF,KAAa;IAC/C,IAAI,CAACE,IAAIC,UAAU,CAACH,QAAQ;QACxB,OAAO;IACX;IACA,IAAIA,MAAMI,QAAQ,CAAC,MAAM;QACrB,OAAO;IACX;IACA,MAAMC,OAAOH,GAAG,CAACF,MAAMJ,MAAM,CAAC;IAC9B,OAAOS,SAASV,aAAaU,SAAS;AAC1C;AAEA;;;CAGC,GACD,OAAO,SAASC,qBACZZ,SAAgD,EAChDQ,GAAW;IAEX,KAAK,MAAMK,KAAKb,sBAAAA,uBAAAA,YAAa,EAAE,CAAE;QAC7B,IAAIO,gBAAgBC,KAAKK,EAAEP,KAAK,GAAG;YAC/B,OAAOO;QACX;IACJ;IACA,OAAOZ;AACX;AAEA;;;CAGC,GACD,OAAO,SAASa,sBACZC,OAAqB,EACrBC,OAA0B,EAC1BC,UAAkB;QAwBCC;IAtBnB,MAAMC,MAAMP,qBAAqBG,QAAQf,SAAS,EAAEiB;IACpD,IAAIE,CAAAA,gBAAAA,0BAAAA,IAAKC,MAAM,MAAK,MAAM;QACtB,OAAO;YAAEA,QAAQ;YAAMC,eAAe;QAAE;IAC5C;IAEA,MAAMH,MAAMN,qBAAqBI,QAAQhB,SAAS,EAAEiB;IACpD,IAAIE,KAAK;YAIGA,OAAAA,OAAAA;QAHR,OAAO;YACHC,QAAQ;YACRC,aAAa,GACTF,SAAAA,SAAAA,qBAAAA,IAAIE,aAAa,cAAjBF,gCAAAA,qBACAD,gBAAAA,0BAAAA,IAAKG,aAAa,cADlBF,mBAAAA,QAEAJ,QAAQM,aAAa,cAFrBF,mBAAAA,QAGAH,QAAQM,SAAS;QACzB;IACJ;IACA,IAAIJ,CAAAA,gBAAAA,0BAAAA,IAAKE,MAAM,MAAK,MAAM;QACtB,OAAO;YAAEA,QAAQ;YAAMC,eAAe;QAAE;IAC5C;IAEA,OAAO;QACHD,QAAQ;QACRC,aAAa,GAAEH,gBAAAA,gBAAAA,0BAAAA,IAAKG,aAAa,yCAAIN,QAAQM,aAAa,cAA3CH,kBAAAA,OAA+CF,QAAQM,SAAS;IACnF;AACJ"}

package/dist/core/index.d.ts

@@ -1,6 +1,7 @@
-/** Core engine barrel — free helpers over the default runtime, plus handles and types. */
-export { activeJourneyStep, addJourneySink, completeJourney, defineJourney, emitJourneyEvent, excludeJourney, failJourney, firstOpenJourney, journeyMountStep, journeyStep, reportBackendRequest, setJourneySinks, setJourneyTags, startJourney, type JourneyHandle, type JourneySink, } from './registry';
-export { createJourneyRuntime, defaultRuntime, resetJourney, type JourneyRuntime, type JourneyRuntimeOptions, } from './runtime';
-export type { JourneyDef, JourneyEvent, JourneyNameLike, JourneyStepEvent, JourneyStepOptions, JourneyStepRef, JourneyStepTarget, StepHandle, TagValue, } from './types';
-export { JourneyStepTag, resolveJourneyStep } from './step-tag';
+/** Core barrel — public free helpers, handles, and types. Engine lives in `./runtime`. */
+export { completeJourney, defineJourney, excludeJourney, failJourney, journeyStep, reportBackendRequest, resolveStamp, setJourneyTags, singleInFlightJourneyStep, } from './api';
+export { resetJourney, } from './runtime';
+export type { JourneyDef, JourneyEvent, JourneyHandle, JourneyNameLike, JourneySink, JourneyStepEvent, JourneyStepOptions, JourneyStepTarget, StepHandle, TagValue, } from './types';
+export { JourneyStepStamp } from './step-tag';
+export type { JourneyHttpPolicyContext, JourneyHttpScore, JourneyHttpScoreContext, JourneyRequestPolicy, JourneyStampOptions, RequestPolicyConfig, } from './request-policy';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,WAAW,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC7B,MAAM,WAAW,CAAC;AACnB,YAAY,EACR,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,QAAQ,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EACH,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,yBAAyB,GAC5B,MAAM,OAAO,CAAC;AACf,OAAO,EAEH,YAAY,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,QAAQ,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACR,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -1,5 +1,6 @@
-/** Core engine barrel — free helpers over the default runtime, plus handles and types. */ export { activeJourneyStep, addJourneySink, completeJourney, defineJourney, emitJourneyEvent, excludeJourney, failJourney, firstOpenJourney, journeyMountStep, journeyStep, reportBackendRequest, setJourneySinks, setJourneyTags, startJourney } from './registry';
-export { createJourneyRuntime, defaultRuntime, resetJourney } from './runtime';
-export { JourneyStepTag, resolveJourneyStep } from './step-tag';
+/** Core barrel — public free helpers, handles, and types. Engine lives in `./runtime`. */ export { completeJourney, defineJourney, excludeJourney, failJourney, journeyStep, reportBackendRequest, resolveStamp, setJourneyTags, singleInFlightJourneyStep } from './api';
+export { // @internal Test helper — not a supported consumer API.
+resetJourney } from './runtime';
+export { JourneyStepStamp } from './step-tag';
 
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["/** Core engine barrel — free helpers over the default runtime, plus handles and types. */\n\nexport {\n    activeJourneyStep,\n    addJourneySink,\n    completeJourney,\n    defineJourney,\n    emitJourneyEvent,\n    excludeJourney,\n    failJourney,\n    firstOpenJourney,\n    journeyMountStep,\n    journeyStep,\n    reportBackendRequest,\n    setJourneySinks,\n    setJourneyTags,\n    startJourney,\n    type JourneyHandle,\n    type JourneySink,\n} from './registry';\nexport {\n    createJourneyRuntime,\n    defaultRuntime,\n    resetJourney,\n    type JourneyRuntime,\n    type JourneyRuntimeOptions,\n} from './runtime';\nexport type {\n    JourneyDef,\n    JourneyEvent,\n    JourneyNameLike,\n    JourneyStepEvent,\n    JourneyStepOptions,\n    JourneyStepRef,\n    JourneyStepTarget,\n    StepHandle,\n    TagValue,\n} from './types';\nexport { JourneyStepTag, resolveJourneyStep } from './step-tag';\n"],"names":["activeJourneyStep","addJourneySink","completeJourney","defineJourney","emitJourneyEvent","excludeJourney","failJourney","firstOpenJourney","journeyMountStep","journeyStep","reportBackendRequest","setJourneySinks","setJourneyTags","startJourney","createJourneyRuntime","defaultRuntime","resetJourney","JourneyStepTag","resolveJourneyStep"],"mappings":"AAAA,wFAAwF,GAExF,SACIA,iBAAiB,EACjBC,cAAc,EACdC,eAAe,EACfC,aAAa,EACbC,gBAAgB,EAChBC,cAAc,EACdC,WAAW,EACXC,gBAAgB,EAChBC,gBAAgB,EAChBC,WAAW,EACXC,oBAAoB,EACpBC,eAAe,EACfC,cAAc,EACdC,YAAY,QAGT,aAAa;AACpB,SACIC,oBAAoB,EACpBC,cAAc,EACdC,YAAY,QAGT,YAAY;AAYnB,SAASC,cAAc,EAAEC,kBAAkB,QAAQ,aAAa"}
+{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["/** Core barrel — public free helpers, handles, and types. Engine lives in `./runtime`. */\n\nexport {\n    completeJourney,\n    defineJourney,\n    excludeJourney,\n    failJourney,\n    journeyStep,\n    reportBackendRequest,\n    resolveStamp,\n    setJourneyTags,\n    singleInFlightJourneyStep,\n} from './api';\nexport {\n    // @internal Test helper — not a supported consumer API.\n    resetJourney,\n} from './runtime';\nexport type {\n    JourneyDef,\n    JourneyEvent,\n    JourneyHandle,\n    JourneyNameLike,\n    JourneySink,\n    JourneyStepEvent,\n    JourneyStepOptions,\n    JourneyStepTarget,\n    StepHandle,\n    TagValue,\n} from './types';\nexport { JourneyStepStamp } from './step-tag';\nexport type {\n    JourneyHttpPolicyContext,\n    JourneyHttpScore,\n    JourneyHttpScoreContext,\n    JourneyRequestPolicy,\n    JourneyStampOptions,\n    RequestPolicyConfig,\n} from './request-policy';\n"],"names":["completeJourney","defineJourney","excludeJourney","failJourney","journeyStep","reportBackendRequest","resolveStamp","setJourneyTags","singleInFlightJourneyStep","resetJourney","JourneyStepStamp"],"mappings":"AAAA,wFAAwF,GAExF,SACIA,eAAe,EACfC,aAAa,EACbC,cAAc,EACdC,WAAW,EACXC,WAAW,EACXC,oBAAoB,EACpBC,YAAY,EACZC,cAAc,EACdC,yBAAyB,QACtB,QAAQ;AACf,SACI,wDAAwD;AACxDC,YAAY,QACT,YAAY;AAanB,SAASC,gBAAgB,QAAQ,aAAa"}

package/dist/core/limits.d.ts

@@ -0,0 +1,29 @@
+/** Payload / timer bounds shared by the engine and default sinks. */
+export declare const DEFAULT_MAX_STEPS = 50;
+export declare const MAX_STEPS_CAP = 200;
+export declare const MAX_TAG_KEYS = 32;
+export declare const MAX_ATTRIBUTE_KEYS = 64;
+export declare const MAX_ATTRIBUTED_REQUEST_KEYS = 50;
+export declare const MAX_TAG_VALUE_LEN = 200;
+export declare const DEFAULT_JOURNEY_IDLE_MS: number;
+/** True for prototype-polluting keys and a small secret-name deny-list (case-insensitive). */
+export declare function isUnsafeKey(key: string): boolean;
+/**
+ * Finite integer ≥ 1, else `fallback`. Used for maxSteps-like caps.
+ * Non-finite / ≤ 0 / non-numbers return `fallback`.
+ */
+export declare function finitePositiveInt(n: unknown, fallback: number): number;
+/**
+ * Journey/step timeout: finite ≥ 0 keeps the value (floored); anything else is 0 (disabled).
+ */
+export declare function finiteTimeoutMs(n: unknown): number;
+/** Clamp recorded-step cap to 1..MAX_STEPS_CAP; invalid → DEFAULT_MAX_STEPS. */
+export declare function clampMaxSteps(n: unknown): number;
+/** Finite ≥ 0 slow-request threshold, or undefined to fall through. */
+export declare function finiteSlowRequestMs(n: unknown): number | undefined;
+/** Explicit 0 disables; omitted uses idle default; finite N keeps caller timeout. */
+export declare function resolveJourneyTimeoutMs(timeoutMs: number | undefined, idleDefaultMs?: number): {
+    ms: number;
+    explicit: boolean;
+};
+//# sourceMappingURL=limits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/core/limits.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AAevD,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAKlD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAGhD;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKlE;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,aAAa,GAAE,MAAgC,GAChD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAKnC"}

package/dist/core/limits.js

@@ -0,0 +1,63 @@
+/** Payload / timer bounds shared by the engine and default sinks. */ export const DEFAULT_MAX_STEPS = 50;
+export const MAX_STEPS_CAP = 200;
+export const MAX_TAG_KEYS = 32;
+export const MAX_ATTRIBUTE_KEYS = 64;
+export const MAX_ATTRIBUTED_REQUEST_KEYS = 50;
+export const MAX_TAG_VALUE_LEN = 200;
+export const DEFAULT_JOURNEY_IDLE_MS = 15 * 60 * 1000;
+const DENIED_KEYS = new Set([
+    '__proto__',
+    'constructor',
+    'prototype',
+    'authorization',
+    'cookie',
+    'set-cookie',
+    'password',
+    'token',
+    'secret',
+    'ssn'
+]);
+/** True for prototype-polluting keys and a small secret-name deny-list (case-insensitive). */ export function isUnsafeKey(key) {
+    return DENIED_KEYS.has(key.toLowerCase());
+}
+/**
+ * Finite integer ≥ 1, else `fallback`. Used for maxSteps-like caps.
+ * Non-finite / ≤ 0 / non-numbers return `fallback`.
+ */ export function finitePositiveInt(n, fallback) {
+    if (typeof n !== 'number' || !Number.isFinite(n) || n <= 0) {
+        return fallback;
+    }
+    return Math.floor(n);
+}
+/**
+ * Journey/step timeout: finite ≥ 0 keeps the value (floored); anything else is 0 (disabled).
+ */ export function finiteTimeoutMs(n) {
+    if (typeof n !== 'number' || !Number.isFinite(n) || n < 0) {
+        return 0;
+    }
+    return Math.floor(n);
+}
+/** Clamp recorded-step cap to 1..MAX_STEPS_CAP; invalid → DEFAULT_MAX_STEPS. */ export function clampMaxSteps(n) {
+    const value = finitePositiveInt(n, DEFAULT_MAX_STEPS);
+    return Math.min(value, MAX_STEPS_CAP);
+}
+/** Finite ≥ 0 slow-request threshold, or undefined to fall through. */ export function finiteSlowRequestMs(n) {
+    if (typeof n !== 'number' || !Number.isFinite(n) || n < 0) {
+        return undefined;
+    }
+    return Math.floor(n);
+}
+/** Explicit 0 disables; omitted uses idle default; finite N keeps caller timeout. */ export function resolveJourneyTimeoutMs(timeoutMs, idleDefaultMs = DEFAULT_JOURNEY_IDLE_MS) {
+    if (timeoutMs === undefined) {
+        return {
+            ms: finiteTimeoutMs(idleDefaultMs),
+            explicit: false
+        };
+    }
+    return {
+        ms: finiteTimeoutMs(timeoutMs),
+        explicit: true
+    };
+}
+
+//# sourceMappingURL=limits.js.map

package/dist/core/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/limits.ts"],"sourcesContent":["/** Payload / timer bounds shared by the engine and default sinks. */\n\nexport const DEFAULT_MAX_STEPS = 50;\nexport const MAX_STEPS_CAP = 200;\nexport const MAX_TAG_KEYS = 32;\nexport const MAX_ATTRIBUTE_KEYS = 64;\nexport const MAX_ATTRIBUTED_REQUEST_KEYS = 50;\nexport const MAX_TAG_VALUE_LEN = 200;\nexport const DEFAULT_JOURNEY_IDLE_MS = 15 * 60 * 1_000;\n\nconst DENIED_KEYS = new Set([\n    '__proto__',\n    'constructor',\n    'prototype',\n    'authorization',\n    'cookie',\n    'set-cookie',\n    'password',\n    'token',\n    'secret',\n    'ssn',\n]);\n\n/** True for prototype-polluting keys and a small secret-name deny-list (case-insensitive). */\nexport function isUnsafeKey(key: string): boolean {\n    return DENIED_KEYS.has(key.toLowerCase());\n}\n\n/**\n * Finite integer ≥ 1, else `fallback`. Used for maxSteps-like caps.\n * Non-finite / ≤ 0 / non-numbers return `fallback`.\n */\nexport function finitePositiveInt(n: unknown, fallback: number): number {\n    if (typeof n !== 'number' || !Number.isFinite(n) || n <= 0) {\n        return fallback;\n    }\n    return Math.floor(n);\n}\n\n/**\n * Journey/step timeout: finite ≥ 0 keeps the value (floored); anything else is 0 (disabled).\n */\nexport function finiteTimeoutMs(n: unknown): number {\n    if (typeof n !== 'number' || !Number.isFinite(n) || n < 0) {\n        return 0;\n    }\n    return Math.floor(n);\n}\n\n/** Clamp recorded-step cap to 1..MAX_STEPS_CAP; invalid → DEFAULT_MAX_STEPS. */\nexport function clampMaxSteps(n: unknown): number {\n    const value = finitePositiveInt(n, DEFAULT_MAX_STEPS);\n    return Math.min(value, MAX_STEPS_CAP);\n}\n\n/** Finite ≥ 0 slow-request threshold, or undefined to fall through. */\nexport function finiteSlowRequestMs(n: unknown): number | undefined {\n    if (typeof n !== 'number' || !Number.isFinite(n) || n < 0) {\n        return undefined;\n    }\n    return Math.floor(n);\n}\n\n/** Explicit 0 disables; omitted uses idle default; finite N keeps caller timeout. */\nexport function resolveJourneyTimeoutMs(\n    timeoutMs: number | undefined,\n    idleDefaultMs: number = DEFAULT_JOURNEY_IDLE_MS\n): { ms: number; explicit: boolean } {\n    if (timeoutMs === undefined) {\n        return { ms: finiteTimeoutMs(idleDefaultMs), explicit: false };\n    }\n    return { ms: finiteTimeoutMs(timeoutMs), explicit: true };\n}\n"],"names":["DEFAULT_MAX_STEPS","MAX_STEPS_CAP","MAX_TAG_KEYS","MAX_ATTRIBUTE_KEYS","MAX_ATTRIBUTED_REQUEST_KEYS","MAX_TAG_VALUE_LEN","DEFAULT_JOURNEY_IDLE_MS","DENIED_KEYS","Set","isUnsafeKey","key","has","toLowerCase","finitePositiveInt","n","fallback","Number","isFinite","Math","floor","finiteTimeoutMs","clampMaxSteps","value","min","finiteSlowRequestMs","undefined","resolveJourneyTimeoutMs","timeoutMs","idleDefaultMs","ms","explicit"],"mappings":"AAAA,mEAAmE,GAEnE,OAAO,MAAMA,oBAAoB,GAAG;AACpC,OAAO,MAAMC,gBAAgB,IAAI;AACjC,OAAO,MAAMC,eAAe,GAAG;AAC/B,OAAO,MAAMC,qBAAqB,GAAG;AACrC,OAAO,MAAMC,8BAA8B,GAAG;AAC9C,OAAO,MAAMC,oBAAoB,IAAI;AACrC,OAAO,MAAMC,0BAA0B,KAAK,KAAK,KAAM;AAEvD,MAAMC,cAAc,IAAIC,IAAI;IACxB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACH;AAED,4FAA4F,GAC5F,OAAO,SAASC,YAAYC,GAAW;IACnC,OAAOH,YAAYI,GAAG,CAACD,IAAIE,WAAW;AAC1C;AAEA;;;CAGC,GACD,OAAO,SAASC,kBAAkBC,CAAU,EAAEC,QAAgB;IAC1D,IAAI,OAAOD,MAAM,YAAY,CAACE,OAAOC,QAAQ,CAACH,MAAMA,KAAK,GAAG;QACxD,OAAOC;IACX;IACA,OAAOG,KAAKC,KAAK,CAACL;AACtB;AAEA;;CAEC,GACD,OAAO,SAASM,gBAAgBN,CAAU;IACtC,IAAI,OAAOA,MAAM,YAAY,CAACE,OAAOC,QAAQ,CAACH,MAAMA,IAAI,GAAG;QACvD,OAAO;IACX;IACA,OAAOI,KAAKC,KAAK,CAACL;AACtB;AAEA,8EAA8E,GAC9E,OAAO,SAASO,cAAcP,CAAU;IACpC,MAAMQ,QAAQT,kBAAkBC,GAAGd;IACnC,OAAOkB,KAAKK,GAAG,CAACD,OAAOrB;AAC3B;AAEA,qEAAqE,GACrE,OAAO,SAASuB,oBAAoBV,CAAU;IAC1C,IAAI,OAAOA,MAAM,YAAY,CAACE,OAAOC,QAAQ,CAACH,MAAMA,IAAI,GAAG;QACvD,OAAOW;IACX;IACA,OAAOP,KAAKC,KAAK,CAACL;AACtB;AAEA,mFAAmF,GACnF,OAAO,SAASY,wBACZC,SAA6B,EAC7BC,gBAAwBtB,uBAAuB;IAE/C,IAAIqB,cAAcF,WAAW;QACzB,OAAO;YAAEI,IAAIT,gBAAgBQ;YAAgBE,UAAU;QAAM;IACjE;IACA,OAAO;QAAED,IAAIT,gBAAgBO;QAAYG,UAAU;IAAK;AAC5D"}

package/dist/core/request-policy.d.ts

@@ -0,0 +1,39 @@
+/** Verdict for attributed HTTP (abort / 4xx / similar). */
+export type JourneyRequestPolicy = 'continue' | 'bad' | 'exclude';
+/** Normalized facts adapters pass into policy resolvers (not axios/jqXHR). */
+export interface JourneyHttpPolicyContext {
+    requestKey: string;
+    /** Present when an HTTP response exists; omitted on abort / hard network failure. */
+    status?: number;
+    aborted: boolean;
+    url?: string;
+    method?: string;
+    journeyName?: string;
+    stepName?: string;
+}
+/**
+ * Per-stamp HTTP scorer from {@link StepHandle.stamp}. Must be synchronous.
+ * Return a policy to set the journey verdict; omit / void to keep default scoring.
+ * Do not consume a fetch body (clone first if you need to read it).
+ */
+export type JourneyHttpScore = (ctx: JourneyHttpScoreContext) => JourneyRequestPolicy | void | undefined;
+/** Context for {@link JourneyHttpScore} — policy facts plus the transport req/res. */
+export interface JourneyHttpScoreContext extends JourneyHttpPolicyContext {
+    durationMs: number;
+    /** Transport request (axios config, fetch input/init, jQuery ajax settings). */
+    request?: unknown;
+    /** Transport response (axios response, fetch Response, jqXHR). */
+    response?: unknown;
+    /** Rejection reason when the transport failed. */
+    error?: unknown;
+}
+/** Options for {@link StepHandle.stamp}. */
+export interface JourneyStampOptions {
+    score?: JourneyHttpScore;
+    /** Skip scoring for this stamped request. Ignore wins over `score`. */
+    ignore?: boolean;
+}
+export type RequestPolicyConfig = JourneyRequestPolicy | ((ctx: JourneyHttpPolicyContext) => JourneyRequestPolicy);
+export declare function resolveRequestPolicy(config: RequestPolicyConfig | undefined, fallback: JourneyRequestPolicy, ctx: JourneyHttpPolicyContext): JourneyRequestPolicy;
+export declare function isJourneyRequestPolicy(value: unknown): value is JourneyRequestPolicy;
+//# sourceMappingURL=request-policy.d.ts.map

package/dist/core/request-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-policy.d.ts","sourceRoot":"","sources":["../../src/core/request-policy.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAElE,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC3B,GAAG,EAAE,uBAAuB,KAC3B,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7C,sFAAsF;AACtF,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B,oBAAoB,GAAG,CAAC,CAAC,GAAG,EAAE,wBAAwB,KAAK,oBAAoB,CAAC,CAAC;AAErF,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,oBAAoB,EAC9B,GAAG,EAAE,wBAAwB,GAC9B,oBAAoB,CAYtB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF"}

package/dist/core/request-policy.js

@@ -0,0 +1,18 @@
+/** Verdict for attributed HTTP (abort / 4xx / similar). */ export function resolveRequestPolicy(config, fallback, ctx) {
+    if (config === undefined) {
+        return fallback;
+    }
+    if (typeof config === 'function') {
+        try {
+            return config(ctx);
+        } catch (unused) {
+            return fallback;
+        }
+    }
+    return config;
+}
+export function isJourneyRequestPolicy(value) {
+    return value === 'continue' || value === 'bad' || value === 'exclude';
+}
+
+//# sourceMappingURL=request-policy.js.map

package/dist/core/request-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/request-policy.ts"],"sourcesContent":["/** Verdict for attributed HTTP (abort / 4xx / similar). */\nexport type JourneyRequestPolicy = 'continue' | 'bad' | 'exclude';\n\n/** Normalized facts adapters pass into policy resolvers (not axios/jqXHR). */\nexport interface JourneyHttpPolicyContext {\n    requestKey: string;\n    /** Present when an HTTP response exists; omitted on abort / hard network failure. */\n    status?: number;\n    aborted: boolean;\n    url?: string;\n    method?: string;\n    journeyName?: string;\n    stepName?: string;\n}\n\n/**\n * Per-stamp HTTP scorer from {@link StepHandle.stamp}. Must be synchronous.\n * Return a policy to set the journey verdict; omit / void to keep default scoring.\n * Do not consume a fetch body (clone first if you need to read it).\n */\nexport type JourneyHttpScore = (\n    ctx: JourneyHttpScoreContext\n) => JourneyRequestPolicy | void | undefined;\n\n/** Context for {@link JourneyHttpScore} — policy facts plus the transport req/res. */\nexport interface JourneyHttpScoreContext extends JourneyHttpPolicyContext {\n    durationMs: number;\n    /** Transport request (axios config, fetch input/init, jQuery ajax settings). */\n    request?: unknown;\n    /** Transport response (axios response, fetch Response, jqXHR). */\n    response?: unknown;\n    /** Rejection reason when the transport failed. */\n    error?: unknown;\n}\n\n/** Options for {@link StepHandle.stamp}. */\nexport interface JourneyStampOptions {\n    score?: JourneyHttpScore;\n    /** Skip scoring for this stamped request. Ignore wins over `score`. */\n    ignore?: boolean;\n}\n\nexport type RequestPolicyConfig =\n    JourneyRequestPolicy | ((ctx: JourneyHttpPolicyContext) => JourneyRequestPolicy);\n\nexport function resolveRequestPolicy(\n    config: RequestPolicyConfig | undefined,\n    fallback: JourneyRequestPolicy,\n    ctx: JourneyHttpPolicyContext\n): JourneyRequestPolicy {\n    if (config === undefined) {\n        return fallback;\n    }\n    if (typeof config === 'function') {\n        try {\n            return config(ctx);\n        } catch {\n            return fallback;\n        }\n    }\n    return config;\n}\n\nexport function isJourneyRequestPolicy(value: unknown): value is JourneyRequestPolicy {\n    return value === 'continue' || value === 'bad' || value === 'exclude';\n}\n"],"names":["resolveRequestPolicy","config","fallback","ctx","undefined","isJourneyRequestPolicy","value"],"mappings":"AAAA,yDAAyD,GA6CzD,OAAO,SAASA,qBACZC,MAAuC,EACvCC,QAA8B,EAC9BC,GAA6B;IAE7B,IAAIF,WAAWG,WAAW;QACtB,OAAOF;IACX;IACA,IAAI,OAAOD,WAAW,YAAY;QAC9B,IAAI;YACA,OAAOA,OAAOE;QAClB,EAAE,eAAM;YACJ,OAAOD;QACX;IACJ;IACA,OAAOD;AACX;AAEA,OAAO,SAASI,uBAAuBC,KAAc;IACjD,OAAOA,UAAU,cAAcA,UAAU,SAASA,UAAU;AAChE"}