@servicetitan/journey 2.1.0 → 3.0.0

package/dist/integrations/http-report.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/integrations/http-report.ts"],"sourcesContent":["import { MAX_ATTRIBUTED_REQUEST_KEYS } from '../core/limits';\nimport {\n    isJourneyRequestPolicy,\n    resolveRequestPolicy,\n    type JourneyHttpPolicyContext,\n    type JourneyRequestPolicy,\n} from '../core/request-policy';\nimport { reportBackendRequest } from '../core/api';\nimport { canRouteHttpToJourney, resolveJourneyEngine } from '../core/runtime';\nimport type { JourneyStepStamp } from '../core/step-tag';\nimport type { StepRecord } from '../core/types';\nimport type { JourneyTimedMeta } from './request-key';\n\nexport interface HttpCompleteReport {\n    stamp: JourneyStepStamp | undefined;\n    status?: number;\n    durationMs: number;\n    requestKey: string;\n    aborted?: boolean;\n    url?: string;\n    method?: string;\n    /** Per-request literal overrides from JourneyTimedMeta. */\n    meta?: JourneyTimedMeta;\n    /** Transport request (axios config, fetch input/init, jQuery 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\nfunction applyPolicy(\n    policy: JourneyRequestPolicy,\n    step: StepRecord,\n    reason: string,\n    status?: number\n): void {\n    if (policy === 'continue') {\n        return;\n    }\n    const journey = step.journey;\n    if (!journey || journey.closed) {\n        return;\n    }\n    const engine = resolveJourneyEngine(journey);\n    if (policy === 'exclude') {\n        engine.exclude();\n        return;\n    }\n    // 'bad'\n    step.outcome = 'bad';\n    step.reason ??= reason;\n    if (status !== undefined) {\n        step.httpStatus = status;\n    }\n    engine.failJourney(reason);\n}\n\nfunction httpScoreReason(report: HttpCompleteReport): string {\n    if (report.aborted) {\n        return 'request-aborted';\n    }\n    const status = report.status;\n    if (status !== undefined && status >= 400 && status < 500) {\n        return 'request-client-error';\n    }\n    return 'request-error';\n}\n\n/**\n * Attribute a finished HTTP call: abort / 4xx policies, else 5xx+latency via reportBackendRequest.\n * Ignored endpoint prefixes never change the journey verdict.\n * 4xx with policy `'continue'` (default) still scores latency.\n */\nexport function onHttpComplete(report: HttpCompleteReport): void {\n    const {\n        stamp,\n        status,\n        durationMs,\n        requestKey,\n        aborted,\n        url,\n        method,\n        meta,\n        request,\n        response,\n        error,\n    } = report;\n    if (!stamp) {\n        return;\n    }\n    const step = stamp.step;\n    if (!step?.journey) {\n        return;\n    }\n    /*\n     * Unstamped foreign journeys (older package copies) cannot be closed from\n     * this bundle — do not write onHttpAborted / step.outcome on them.\n     */\n    if (!canRouteHttpToJourney(step.journey)) {\n        return;\n    }\n    const engine = resolveJourneyEngine(step.journey);\n\n    if (meta?.ignore === true || stamp.ignore === true) {\n        return;\n    }\n\n    if (aborted) {\n        step.onHttpAborted = true;\n    }\n\n    if (requestKey) {\n        step.attributedRequestKeys ??= [];\n        if (\n            step.attributedRequestKeys.length < MAX_ATTRIBUTED_REQUEST_KEYS &&\n            !step.attributedRequestKeys.includes(requestKey)\n        ) {\n            step.attributedRequestKeys.push(requestKey);\n        }\n    }\n\n    if (requestKey && engine.shouldIgnoreRequest(requestKey)) {\n        return;\n    }\n\n    const ctx: JourneyHttpPolicyContext = {\n        requestKey,\n        status,\n        aborted: aborted === true,\n        url,\n        method,\n        journeyName: step.journey.name,\n        stepName: step.name,\n    };\n\n    const score = stamp.score;\n    if (score) {\n        let policy: JourneyRequestPolicy | undefined;\n        try {\n            const scored = score({\n                ...ctx,\n                durationMs,\n                request,\n                response,\n                error,\n            });\n            if (isJourneyRequestPolicy(scored)) {\n                policy = scored;\n            }\n        } catch {\n            policy = undefined;\n        }\n        if (policy !== undefined) {\n            applyPolicy(policy, step, httpScoreReason(report), status);\n            return;\n        }\n    }\n\n    if (aborted) {\n        const override = meta?.httpAbortedRequests;\n        const policy = isJourneyRequestPolicy(override)\n            ? override\n            : resolveRequestPolicy(engine.getHttpAbortedRequestsPolicy(), 'continue', ctx);\n        applyPolicy(policy, step, 'request-aborted');\n        return;\n    }\n\n    if (status !== undefined && status >= 400 && status < 500) {\n        const override = meta?.httpClientErrorRequests;\n        const policy = isJourneyRequestPolicy(override)\n            ? override\n            : resolveRequestPolicy(engine.getHttpClientErrorRequestsPolicy(), 'continue', ctx);\n        if (policy !== 'continue') {\n            applyPolicy(policy, step, 'request-client-error', status);\n            return;\n        }\n        // 'continue' does not count 4xx as an error; still score latency below.\n    }\n\n    reportBackendRequest(step, status, durationMs, requestKey);\n}\n\nexport { isAbortError, isCanceledError } from '../core/abort-error';\n"],"names":["MAX_ATTRIBUTED_REQUEST_KEYS","isJourneyRequestPolicy","resolveRequestPolicy","reportBackendRequest","canRouteHttpToJourney","resolveJourneyEngine","applyPolicy","policy","step","reason","status","journey","closed","engine","exclude","outcome","undefined","httpStatus","failJourney","httpScoreReason","report","aborted","onHttpComplete","stamp","durationMs","requestKey","url","method","meta","request","response","error","ignore","onHttpAborted","attributedRequestKeys","length","includes","push","shouldIgnoreRequest","ctx","journeyName","name","stepName","score","scored","override","httpAbortedRequests","getHttpAbortedRequestsPolicy","httpClientErrorRequests","getHttpClientErrorRequestsPolicy","isAbortError","isCanceledError"],"mappings":"AAAA,SAASA,2BAA2B,QAAQ,iBAAiB;AAC7D,SACIC,sBAAsB,EACtBC,oBAAoB,QAGjB,yBAAyB;AAChC,SAASC,oBAAoB,QAAQ,cAAc;AACnD,SAASC,qBAAqB,EAAEC,oBAAoB,QAAQ,kBAAkB;AAuB9E,SAASC,YACLC,MAA4B,EAC5BC,IAAgB,EAChBC,MAAc,EACdC,MAAe;QAgBfF,OAAAA;IAdA,IAAID,WAAW,YAAY;QACvB;IACJ;IACA,MAAMI,UAAUH,KAAKG,OAAO;IAC5B,IAAI,CAACA,WAAWA,QAAQC,MAAM,EAAE;QAC5B;IACJ;IACA,MAAMC,SAASR,qBAAqBM;IACpC,IAAIJ,WAAW,WAAW;QACtBM,OAAOC,OAAO;QACd;IACJ;IACA,QAAQ;IACRN,KAAKO,OAAO,GAAG;KACfP,UAAAA,CAAAA,QAAAA,MAAKC,MAAM,cAAXD,qBAAAA,UAAAA,MAAKC,MAAM,GAAKA;IAChB,IAAIC,WAAWM,WAAW;QACtBR,KAAKS,UAAU,GAAGP;IACtB;IACAG,OAAOK,WAAW,CAACT;AACvB;AAEA,SAASU,gBAAgBC,MAA0B;IAC/C,IAAIA,OAAOC,OAAO,EAAE;QAChB,OAAO;IACX;IACA,MAAMX,SAASU,OAAOV,MAAM;IAC5B,IAAIA,WAAWM,aAAaN,UAAU,OAAOA,SAAS,KAAK;QACvD,OAAO;IACX;IACA,OAAO;AACX;AAEA;;;;CAIC,GACD,OAAO,SAASY,eAAeF,MAA0B;IACrD,MAAM,EACFG,KAAK,EACLb,MAAM,EACNc,UAAU,EACVC,UAAU,EACVJ,OAAO,EACPK,GAAG,EACHC,MAAM,EACNC,IAAI,EACJC,OAAO,EACPC,QAAQ,EACRC,KAAK,EACR,GAAGX;IACJ,IAAI,CAACG,OAAO;QACR;IACJ;IACA,MAAMf,OAAOe,MAAMf,IAAI;IACvB,IAAI,EAACA,iBAAAA,2BAAAA,KAAMG,OAAO,GAAE;QAChB;IACJ;IACA;;;KAGC,GACD,IAAI,CAACP,sBAAsBI,KAAKG,OAAO,GAAG;QACtC;IACJ;IACA,MAAME,SAASR,qBAAqBG,KAAKG,OAAO;IAEhD,IAAIiB,CAAAA,iBAAAA,2BAAAA,KAAMI,MAAM,MAAK,QAAQT,MAAMS,MAAM,KAAK,MAAM;QAChD;IACJ;IAEA,IAAIX,SAAS;QACTb,KAAKyB,aAAa,GAAG;IACzB;IAEA,IAAIR,YAAY;YACZjB,OAAAA;SAAAA,yBAAAA,CAAAA,QAAAA,MAAK0B,qBAAqB,cAA1B1B,oCAAAA,yBAAAA,MAAK0B,qBAAqB,GAAK,EAAE;QACjC,IACI1B,KAAK0B,qBAAqB,CAACC,MAAM,GAAGnC,+BACpC,CAACQ,KAAK0B,qBAAqB,CAACE,QAAQ,CAACX,aACvC;YACEjB,KAAK0B,qBAAqB,CAACG,IAAI,CAACZ;QACpC;IACJ;IAEA,IAAIA,cAAcZ,OAAOyB,mBAAmB,CAACb,aAAa;QACtD;IACJ;IAEA,MAAMc,MAAgC;QAClCd;QACAf;QACAW,SAASA,YAAY;QACrBK;QACAC;QACAa,aAAahC,KAAKG,OAAO,CAAC8B,IAAI;QAC9BC,UAAUlC,KAAKiC,IAAI;IACvB;IAEA,MAAME,QAAQpB,MAAMoB,KAAK;IACzB,IAAIA,OAAO;QACP,IAAIpC;QACJ,IAAI;YACA,MAAMqC,SAASD,MAAM;gBACjB,GAAGJ,GAAG;gBACNf;gBACAK;gBACAC;gBACAC;YACJ;YACA,IAAI9B,uBAAuB2C,SAAS;gBAChCrC,SAASqC;YACb;QACJ,EAAE,eAAM;YACJrC,SAASS;QACb;QACA,IAAIT,WAAWS,WAAW;YACtBV,YAAYC,QAAQC,MAAMW,gBAAgBC,SAASV;YACnD;QACJ;IACJ;IAEA,IAAIW,SAAS;QACT,MAAMwB,WAAWjB,iBAAAA,2BAAAA,KAAMkB,mBAAmB;QAC1C,MAAMvC,SAASN,uBAAuB4C,YAChCA,WACA3C,qBAAqBW,OAAOkC,4BAA4B,IAAI,YAAYR;QAC9EjC,YAAYC,QAAQC,MAAM;QAC1B;IACJ;IAEA,IAAIE,WAAWM,aAAaN,UAAU,OAAOA,SAAS,KAAK;QACvD,MAAMmC,WAAWjB,iBAAAA,2BAAAA,KAAMoB,uBAAuB;QAC9C,MAAMzC,SAASN,uBAAuB4C,YAChCA,WACA3C,qBAAqBW,OAAOoC,gCAAgC,IAAI,YAAYV;QAClF,IAAIhC,WAAW,YAAY;YACvBD,YAAYC,QAAQC,MAAM,wBAAwBE;YAClD;QACJ;IACA,wEAAwE;IAC5E;IAEAP,qBAAqBK,MAAME,QAAQc,YAAYC;AACnD;AAEA,SAASyB,YAAY,EAAEC,eAAe,QAAQ,sBAAsB"}

package/dist/integrations/jquery/index.d.ts

@@ -1,12 +1,16 @@
 import { type JourneyDef, type JourneyHandle, type JourneyStepOptions, type JourneyStepTarget, type StepHandle } from '../../core';
 /**
  * Knockout / desktop-legacy bridge on `window.App.Journey`.
- * Prefer `defineJourney` handles; `journeyStep` / `firstOpenJourney` cover multi-journey steps.
+ * Prefer `defineJourney` handles; `journeyStep` / `firstOpenJourneyName` cover multi-journey steps.
+ * Use `getJourneyHandle(name)` when you need the handle from another module.
  */
 interface AppJourneyApi {
-    defineJourney(def: JourneyDef): JourneyHandle;
+    defineJourney(config: JourneyDef): JourneyHandle;
     journeyStep<T>(journey: JourneyStepTarget, stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
-    firstOpenJourney(names: readonly string[]): string | null;
+    /** First open journey **name** among candidates, or null. */
+    firstOpenJourneyName(names: readonly string[]): string | null;
+    /** `defineJourney` handle for an open name, or null. */
+    getJourneyHandle(name: string): JourneyHandle | null;
 }
 export type WindowWithAppJourney = Window & {
     App?: {
@@ -15,7 +19,7 @@ export type WindowWithAppJourney = Window & {
 };
 /**
  * Publish the Knockout bridge on window.App.Journey. Idempotent for the real window.
- * Optional `target` is for tests.
+ * Optional `target` is for tests. Never throws — logs and returns a usable API if publish fails.
  */
 export declare function exposeAppJourney(target?: WindowWithAppJourney): AppJourneyApi;
 export { instrumentJquery, type JqueryStatic } from './instrument';

package/dist/integrations/jquery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/jquery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAClB,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,UAAU,aAAa;IACnB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,CAAC;IAC9C,WAAW,CAAC,CAAC,EACT,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxC,IAAI,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IACxC,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/D,CAAC;AAKF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,oBAA6B,GAAG,aAAa,CAiBrF;AAED,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/jquery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAClB,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AACH,UAAU,aAAa;IACnB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAAC;IACjD,WAAW,CAAC,CAAC,EACT,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxC,IAAI,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,6DAA6D;IAC7D,oBAAoB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9D,wDAAwD;IACxD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;CACxD;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IACxC,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/D,CAAC;AAaF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,oBAA6B,GAAG,aAAa,CA6BrF;AAED,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/integrations/jquery/index.js

@@ -2,24 +2,42 @@ import { defineJourney, journeyStep } from '../../core';
 import { moduleRuntime } from '../../core/runtime';
 let journeyExposed = false;
 let windowJourneyApi;
+function handleForOpenJourney(name) {
+    const open = moduleRuntime.getOpenJourney(name);
+    if (!open) {
+        return null;
+    }
+    return defineJourney(open.config);
+}
 /**
  * Publish the Knockout bridge on window.App.Journey. Idempotent for the real window.
- * Optional `target` is for tests.
+ * Optional `target` is for tests. Never throws — logs and returns a usable API if publish fails.
  */ export function exposeAppJourney(target = window) {
-    var _target_App;
     if (journeyExposed && target === window && windowJourneyApi) {
         return windowJourneyApi;
     }
     const api = {
         defineJourney,
         journeyStep,
-        firstOpenJourney: (names)=>moduleRuntime.firstOpenJourney(names)
+        firstOpenJourneyName: (names)=>moduleRuntime.firstOpenJourneyName(names),
+        getJourneyHandle: handleForOpenJourney
     };
-    target.App = (_target_App = target.App) !== null && _target_App !== void 0 ? _target_App : {};
-    target.App.Journey = api;
-    if (target === window) {
-        journeyExposed = true;
-        windowJourneyApi = api;
+    try {
+        var _target_App;
+        if (target == null || typeof target !== 'object' && typeof target !== 'function') {
+            // eslint-disable-next-line no-console -- soft-skip missing host window
+            console.warn('[journey] exposeAppJourney: skipped — missing');
+            return api;
+        }
+        target.App = (_target_App = target.App) !== null && _target_App !== void 0 ? _target_App : {};
+        target.App.Journey = Object.freeze(api);
+        if (target === window) {
+            journeyExposed = true;
+            windowJourneyApi = api;
+        }
+    } catch (err) {
+        // eslint-disable-next-line no-console -- soft-fail host wiring
+        console.error('[journey] exposeAppJourney failed', err);
     }
     return api;
 }

package/dist/integrations/jquery/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/integrations/jquery/index.ts"],"sourcesContent":["import {\n    defineJourney,\n    journeyStep,\n    type JourneyDef,\n    type JourneyHandle,\n    type JourneyStepOptions,\n    type JourneyStepTarget,\n    type StepHandle,\n} from '../../core';\nimport { moduleRuntime } from '../../core/runtime';\n\n/**\n * Knockout / desktop-legacy bridge on `window.App.Journey`.\n * Prefer `defineJourney` handles; `journeyStep` / `firstOpenJourney` cover multi-journey steps.\n */\ninterface AppJourneyApi {\n    defineJourney(def: JourneyDef): JourneyHandle;\n    journeyStep<T>(\n        journey: JourneyStepTarget,\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n    firstOpenJourney(names: readonly string[]): string | null;\n}\n\nexport type WindowWithAppJourney = Window & {\n    App?: { Journey?: AppJourneyApi } & Record<string, unknown>;\n};\n\nlet journeyExposed = false;\nlet windowJourneyApi: AppJourneyApi | undefined;\n\n/**\n * Publish the Knockout bridge on window.App.Journey. Idempotent for the real window.\n * Optional `target` is for tests.\n */\nexport function exposeAppJourney(target: WindowWithAppJourney = window): AppJourneyApi {\n    if (journeyExposed && target === window && windowJourneyApi) {\n        return windowJourneyApi;\n    }\n\n    const api: AppJourneyApi = {\n        defineJourney,\n        journeyStep,\n        firstOpenJourney: names => moduleRuntime.firstOpenJourney(names),\n    };\n    target.App = target.App ?? {};\n    target.App.Journey = api;\n    if (target === window) {\n        journeyExposed = true;\n        windowJourneyApi = api;\n    }\n    return api;\n}\n\nexport { instrumentJquery, type JqueryStatic } from './instrument';\n"],"names":["defineJourney","journeyStep","moduleRuntime","journeyExposed","windowJourneyApi","exposeAppJourney","target","window","api","firstOpenJourney","names","App","Journey","instrumentJquery"],"mappings":"AAAA,SACIA,aAAa,EACbC,WAAW,QAMR,aAAa;AACpB,SAASC,aAAa,QAAQ,qBAAqB;AAqBnD,IAAIC,iBAAiB;AACrB,IAAIC;AAEJ;;;CAGC,GACD,OAAO,SAASC,iBAAiBC,SAA+BC,MAAM;QAUrDD;IATb,IAAIH,kBAAkBG,WAAWC,UAAUH,kBAAkB;QACzD,OAAOA;IACX;IAEA,MAAMI,MAAqB;QACvBR;QACAC;QACAQ,kBAAkBC,CAAAA,QAASR,cAAcO,gBAAgB,CAACC;IAC9D;IACAJ,OAAOK,GAAG,IAAGL,cAAAA,OAAOK,GAAG,cAAVL,yBAAAA,cAAc,CAAC;IAC5BA,OAAOK,GAAG,CAACC,OAAO,GAAGJ;IACrB,IAAIF,WAAWC,QAAQ;QACnBJ,iBAAiB;QACjBC,mBAAmBI;IACvB;IACA,OAAOA;AACX;AAEA,SAASK,gBAAgB,QAA2B,eAAe"}
+{"version":3,"sources":["../../../src/integrations/jquery/index.ts"],"sourcesContent":["import {\n    defineJourney,\n    journeyStep,\n    type JourneyDef,\n    type JourneyHandle,\n    type JourneyStepOptions,\n    type JourneyStepTarget,\n    type StepHandle,\n} from '../../core';\nimport { moduleRuntime } from '../../core/runtime';\n\n/**\n * Knockout / desktop-legacy bridge on `window.App.Journey`.\n * Prefer `defineJourney` handles; `journeyStep` / `firstOpenJourneyName` cover multi-journey steps.\n * Use `getJourneyHandle(name)` when you need the handle from another module.\n */\ninterface AppJourneyApi {\n    defineJourney(config: JourneyDef): JourneyHandle;\n    journeyStep<T>(\n        journey: JourneyStepTarget,\n        stepName: string,\n        fn: (step: StepHandle) => T | Promise<T>,\n        opts?: JourneyStepOptions\n    ): Promise<T>;\n    /** First open journey **name** among candidates, or null. */\n    firstOpenJourneyName(names: readonly string[]): string | null;\n    /** `defineJourney` handle for an open name, or null. */\n    getJourneyHandle(name: string): JourneyHandle | null;\n}\n\nexport type WindowWithAppJourney = Window & {\n    App?: { Journey?: AppJourneyApi } & Record<string, unknown>;\n};\n\nlet journeyExposed = false;\nlet windowJourneyApi: AppJourneyApi | undefined;\n\nfunction handleForOpenJourney(name: string): JourneyHandle | null {\n    const open = moduleRuntime.getOpenJourney(name);\n    if (!open) {\n        return null;\n    }\n    return defineJourney(open.config);\n}\n\n/**\n * Publish the Knockout bridge on window.App.Journey. Idempotent for the real window.\n * Optional `target` is for tests. Never throws — logs and returns a usable API if publish fails.\n */\nexport function exposeAppJourney(target: WindowWithAppJourney = window): AppJourneyApi {\n    if (journeyExposed && target === window && windowJourneyApi) {\n        return windowJourneyApi;\n    }\n\n    const api: AppJourneyApi = {\n        defineJourney,\n        journeyStep,\n        firstOpenJourneyName: names => moduleRuntime.firstOpenJourneyName(names),\n        getJourneyHandle: handleForOpenJourney,\n    };\n\n    try {\n        if (target == null || (typeof target !== 'object' && typeof target !== 'function')) {\n            // eslint-disable-next-line no-console -- soft-skip missing host window\n            console.warn('[journey] exposeAppJourney: skipped — missing');\n            return api;\n        }\n        target.App = target.App ?? {};\n        target.App.Journey = Object.freeze(api);\n        if (target === window) {\n            journeyExposed = true;\n            windowJourneyApi = api;\n        }\n    } catch (err) {\n        // eslint-disable-next-line no-console -- soft-fail host wiring\n        console.error('[journey] exposeAppJourney failed', err);\n    }\n    return api;\n}\n\nexport { instrumentJquery, type JqueryStatic } from './instrument';\n"],"names":["defineJourney","journeyStep","moduleRuntime","journeyExposed","windowJourneyApi","handleForOpenJourney","name","open","getOpenJourney","config","exposeAppJourney","target","window","api","firstOpenJourneyName","names","getJourneyHandle","console","warn","App","Journey","Object","freeze","err","error","instrumentJquery"],"mappings":"AAAA,SACIA,aAAa,EACbC,WAAW,QAMR,aAAa;AACpB,SAASC,aAAa,QAAQ,qBAAqB;AAyBnD,IAAIC,iBAAiB;AACrB,IAAIC;AAEJ,SAASC,qBAAqBC,IAAY;IACtC,MAAMC,OAAOL,cAAcM,cAAc,CAACF;IAC1C,IAAI,CAACC,MAAM;QACP,OAAO;IACX;IACA,OAAOP,cAAcO,KAAKE,MAAM;AACpC;AAEA;;;CAGC,GACD,OAAO,SAASC,iBAAiBC,SAA+BC,MAAM;IAClE,IAAIT,kBAAkBQ,WAAWC,UAAUR,kBAAkB;QACzD,OAAOA;IACX;IAEA,MAAMS,MAAqB;QACvBb;QACAC;QACAa,sBAAsBC,CAAAA,QAASb,cAAcY,oBAAoB,CAACC;QAClEC,kBAAkBX;IACtB;IAEA,IAAI;YAMaM;QALb,IAAIA,UAAU,QAAS,OAAOA,WAAW,YAAY,OAAOA,WAAW,YAAa;YAChF,uEAAuE;YACvEM,QAAQC,IAAI,CAAC;YACb,OAAOL;QACX;QACAF,OAAOQ,GAAG,IAAGR,cAAAA,OAAOQ,GAAG,cAAVR,yBAAAA,cAAc,CAAC;QAC5BA,OAAOQ,GAAG,CAACC,OAAO,GAAGC,OAAOC,MAAM,CAACT;QACnC,IAAIF,WAAWC,QAAQ;YACnBT,iBAAiB;YACjBC,mBAAmBS;QACvB;IACJ,EAAE,OAAOU,KAAK;QACV,+DAA+D;QAC/DN,QAAQO,KAAK,CAAC,qCAAqCD;IACvD;IACA,OAAOV;AACX;AAEA,SAASY,gBAAgB,QAA2B,eAAe"}

package/dist/integrations/jquery/instrument.d.ts

@@ -1,11 +1,14 @@
+import { type JourneyTimedMeta } from '../request-key';
 export interface JqueryXHR {
     status: number;
-    journeyStep?: unknown;
+    statusText?: string;
+    stamp?: unknown;
     journeyStart?: number;
 }
-export interface JqueryAjaxSettings {
+export interface JqueryAjaxSettings extends JourneyTimedMeta {
     url?: string;
-    journeyStep?: unknown;
+    type?: string;
+    method?: string;
 }
 export interface JqueryStatic {
     ajaxPrefilter(handler: (options: JqueryAjaxSettings, originalOptions: JqueryAjaxSettings, jqXHR: JqueryXHR) => void): void;
@@ -13,6 +16,12 @@ export interface JqueryStatic {
         ajaxComplete(handler: (event: unknown, jqXHR: JqueryXHR, settings: JqueryAjaxSettings) => void): void;
     };
 }
-/** Wire a jQuery static into the journey engine. Call once per $ (idempotent). Observation-only. */
-export declare function instrumentJquery($: JqueryStatic): void;
+/** Resolve `globalThis.$`, then `globalThis.jQuery`. */
+export declare function resolveGlobalJquery(): JqueryStatic | null | undefined;
+/**
+ * Wire a jQuery static into the journey engine. Call once per $ (idempotent). Observation-only.
+ * Soft-skips when `$` is missing or not a real jQuery (no `ajaxPrefilter`) so hosts can pass `$` as-is.
+ * Returns a restore that disposes handlers (they no-op after restore).
+ */
+export declare function instrumentJquery($: JqueryStatic | null | undefined): () => void;
 //# sourceMappingURL=instrument.d.ts.map

package/dist/integrations/jquery/instrument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../../../src/integrations/jquery/instrument.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IACzB,aAAa,CACT,OAAO,EAAE,CACL,OAAO,EAAE,kBAAkB,EAC3B,eAAe,EAAE,kBAAkB,EACnC,KAAK,EAAE,SAAS,KACf,IAAI,GACV,IAAI,CAAC;IACR,CAAC,QAAQ,EAAE,QAAQ,GAAG;QAClB,YAAY,CACR,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAClF,IAAI,CAAC;KACX,CAAC;CACL;AAoBD,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CA8BtD"}
+{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../../../src/integrations/jquery/instrument.ts"],"names":[],"mappings":"AAQA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,YAAY;IACzB,aAAa,CACT,OAAO,EAAE,CACL,OAAO,EAAE,kBAAkB,EAC3B,eAAe,EAAE,kBAAkB,EACnC,KAAK,EAAE,SAAS,KACf,IAAI,GACV,IAAI,CAAC;IACR,CAAC,QAAQ,EAAE,QAAQ,GAAG;QAClB,YAAY,CACR,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAClF,IAAI,CAAC;KACX,CAAC;CACL;AA+BD,wDAAwD;AACxD,wBAAgB,mBAAmB,IAAI,YAAY,GAAG,IAAI,GAAG,SAAS,CAGrE;AAuBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,CAiE/E"}

package/dist/integrations/jquery/instrument.js

@@ -1,44 +1,126 @@
-import { activeJourneyStep, JourneyStepTag, reportBackendRequest, resolveJourneyStep } from '../../core';
+import { resolveStamp } from '../../core';
+import { adoptJourneyStepStamp } from '../../core/step-tag';
+import { getInstrumentedJquerySet, registerInstrumentRecord } from '../../global';
+import { onHttpComplete } from '../http-report';
 import { requestKey } from '../request-key';
-const instrumented = new WeakSet();
+import { acceptInstrumentTarget } from '../soft-skip';
+const jqueryStamps = new WeakMap();
 function reportTiming(jqXHR, settings) {
-    var _jqXHR_journeyStart;
-    const step = resolveJourneyStep(jqXHR.journeyStep);
-    if (!step) {
+    var _jqueryStamps_get, _jqXHR_journeyStart, _settings_type;
+    const stamp = (_jqueryStamps_get = jqueryStamps.get(jqXHR)) !== null && _jqueryStamps_get !== void 0 ? _jqueryStamps_get : adoptJourneyStepStamp(jqXHR.stamp);
+    if (!stamp || stamp.ignore || settings.ignore === true) {
         return;
     }
     const start = (_jqXHR_journeyStart = jqXHR.journeyStart) !== null && _jqXHR_journeyStart !== void 0 ? _jqXHR_journeyStart : globalThis.performance.now();
+    const aborted = jqXHR.statusText === 'abort';
     // jQuery uses status 0 for network / abort failures — treat like a missing status.
-    const status = jqXHR.status === 0 ? undefined : jqXHR.status;
-    reportBackendRequest(step, status, globalThis.performance.now() - start, requestKey(settings.url, undefined, undefined));
+    const status = aborted || jqXHR.status === 0 ? undefined : jqXHR.status;
+    onHttpComplete({
+        stamp,
+        status,
+        durationMs: globalThis.performance.now() - start,
+        requestKey: requestKey(settings.url, undefined, undefined),
+        aborted,
+        url: settings.url,
+        method: (_settings_type = settings.type) !== null && _settings_type !== void 0 ? _settings_type : settings.method,
+        meta: settings,
+        request: settings,
+        response: jqXHR
+    });
+}
+function isJqueryStatic(value) {
+    return typeof value === 'function' && typeof value.ajaxPrefilter === 'function';
 }
-/** Wire a jQuery static into the journey engine. Call once per $ (idempotent). Observation-only. */ export function instrumentJquery($) {
-    if (instrumented.has($)) {
+/** Resolve `globalThis.$`, then `globalThis.jQuery`. */ export function resolveGlobalJquery() {
+    var _g_$;
+    const g = globalThis;
+    return (_g_$ = g.$) !== null && _g_$ !== void 0 ? _g_$ : g.jQuery;
+}
+/** Live record per $ — handlers look this up so restore+rewire does not stack prefilters. */ const jqueryLiveRecords = new WeakMap();
+/** jQuery cannot unregister these; track each so a partial-wire retry does not stack. */ const jqueryPrefiltersInstalled = new WeakSet();
+const jqueryCompletesInstalled = new WeakSet();
+function stampAjax(jqXHR, options) {
+    var _jqXHR_stamp;
+    if (options.ignore === true) {
         return;
     }
-    instrumented.add($);
-    $.ajaxPrefilter((options, _originalOptions, jqXHR)=>{
-        /*
-         * Prefer explicit step.tag() (settings or XHR); else soft ambient.
-         * Box ambient steps in JourneyStepTag — raw StepRecord is circular and blows jQuery deep-merge.
-         */ if (!jqXHR.journeyStep) {
-            const fromSettings = options.journeyStep;
-            if (fromSettings) {
-                jqXHR.journeyStep = fromSettings;
-            } else {
-                const step = activeJourneyStep();
-                if (step) {
-                    jqXHR.journeyStep = new JourneyStepTag(step);
+    const stamp = resolveStamp((_jqXHR_stamp = jqXHR.stamp) !== null && _jqXHR_stamp !== void 0 ? _jqXHR_stamp : options.stamp);
+    if (stamp) {
+        jqueryStamps.set(jqXHR, stamp);
+        delete jqXHR.stamp;
+        delete options.stamp;
+    }
+    if (stamp && !stamp.ignore) {
+        jqXHR.journeyStart = globalThis.performance.now();
+    }
+}
+/**
+ * Wire a jQuery static into the journey engine. Call once per $ (idempotent). Observation-only.
+ * Soft-skips when `$` is missing or not a real jQuery (no `ajaxPrefilter`) so hosts can pass `$` as-is.
+ * Returns a restore that disposes handlers (they no-op after restore).
+ */ export function instrumentJquery($) {
+    const jquery = acceptInstrumentTarget('Jquery', $, isJqueryStatic);
+    const instrumented = getInstrumentedJquerySet();
+    if (!jquery || instrumented.has(jquery)) {
+        return ()=>{};
+    }
+    const key = jquery;
+    const record = {
+        disposed: false
+    };
+    try {
+        if (!jqueryPrefiltersInstalled.has(key)) {
+            jquery.ajaxPrefilter((options, _originalOptions, jqXHR)=>{
+                const current = jqueryLiveRecords.get(key);
+                if (!current || current.disposed) {
+                    return;
                 }
-            }
+                stampAjax(jqXHR, options);
+            });
+            jqueryPrefiltersInstalled.add(key);
         }
-        if (resolveJourneyStep(jqXHR.journeyStep)) {
-            jqXHR.journeyStart = globalThis.performance.now();
+        if (!jqueryCompletesInstalled.has(key)) {
+            jquery(document).ajaxComplete((_event, jqXHR, settings)=>{
+                const current = jqueryLiveRecords.get(key);
+                if (!current || current.disposed) {
+                    return;
+                }
+                reportTiming(jqXHR, settings);
+            });
+            jqueryCompletesInstalled.add(key);
         }
-    });
-    $(document).ajaxComplete((_event, jqXHR, settings)=>{
-        reportTiming(jqXHR, settings);
-    });
+        jqueryLiveRecords.set(key, record);
+        instrumented.add(key);
+    } catch (err) {
+        /*
+         * Keep per-handler installed flags so a retry cannot double-register
+         * prefilters. Restore deletes the shared instrumented slot so teardown /
+         * retry can finish whichever handler never succeeded.
+         */ record.disposed = true;
+        instrumented.add(key);
+        const restore = ()=>{
+            record.disposed = true;
+            if (jqueryLiveRecords.get(key) === record) {
+                jqueryLiveRecords.delete(key);
+            }
+            instrumented.delete(key);
+        };
+        record.restore = restore;
+        registerInstrumentRecord(record);
+        // eslint-disable-next-line no-console -- soft-fail host wiring
+        console.error('[journey] instrumentJquery failed', err);
+        return restore;
+    }
+    const restore = ()=>{
+        record.disposed = true;
+        if (jqueryLiveRecords.get(key) === record) {
+            jqueryLiveRecords.delete(key);
+        }
+        instrumented.delete(key);
+    };
+    record.restore = restore;
+    registerInstrumentRecord(record);
+    return restore;
 }
 
 //# sourceMappingURL=instrument.js.map

package/dist/integrations/jquery/instrument.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/integrations/jquery/instrument.ts"],"sourcesContent":["import {\n    activeJourneyStep,\n    JourneyStepTag,\n    reportBackendRequest,\n    resolveJourneyStep,\n} from '../../core';\nimport { requestKey } from '../request-key';\n\nexport interface JqueryXHR {\n    status: number;\n    journeyStep?: unknown;\n    journeyStart?: number;\n}\n\nexport interface JqueryAjaxSettings {\n    url?: string;\n    journeyStep?: unknown;\n}\n\nexport interface JqueryStatic {\n    ajaxPrefilter(\n        handler: (\n            options: JqueryAjaxSettings,\n            originalOptions: JqueryAjaxSettings,\n            jqXHR: JqueryXHR\n        ) => void\n    ): void;\n    (selector: Document): {\n        ajaxComplete(\n            handler: (event: unknown, jqXHR: JqueryXHR, settings: JqueryAjaxSettings) => void\n        ): void;\n    };\n}\n\nconst instrumented = new WeakSet<object>();\n\nfunction reportTiming(jqXHR: JqueryXHR, settings: JqueryAjaxSettings): void {\n    const step = resolveJourneyStep(jqXHR.journeyStep);\n    if (!step) {\n        return;\n    }\n    const start = jqXHR.journeyStart ?? globalThis.performance.now();\n    // jQuery uses status 0 for network / abort failures — treat like a missing status.\n    const status = jqXHR.status === 0 ? undefined : jqXHR.status;\n    reportBackendRequest(\n        step,\n        status,\n        globalThis.performance.now() - start,\n        requestKey(settings.url, undefined, undefined)\n    );\n}\n\n/** Wire a jQuery static into the journey engine. Call once per $ (idempotent). Observation-only. */\nexport function instrumentJquery($: JqueryStatic): void {\n    if (instrumented.has($ as object)) {\n        return;\n    }\n    instrumented.add($ as object);\n\n    $.ajaxPrefilter((options, _originalOptions, jqXHR) => {\n        /*\n         * Prefer explicit step.tag() (settings or XHR); else soft ambient.\n         * Box ambient steps in JourneyStepTag — raw StepRecord is circular and blows jQuery deep-merge.\n         */\n        if (!jqXHR.journeyStep) {\n            const fromSettings = options.journeyStep;\n            if (fromSettings) {\n                jqXHR.journeyStep = fromSettings;\n            } else {\n                const step = activeJourneyStep();\n                if (step) {\n                    jqXHR.journeyStep = new JourneyStepTag(step);\n                }\n            }\n        }\n        if (resolveJourneyStep(jqXHR.journeyStep)) {\n            jqXHR.journeyStart = globalThis.performance.now();\n        }\n    });\n\n    $(document).ajaxComplete((_event, jqXHR, settings) => {\n        reportTiming(jqXHR, settings);\n    });\n}\n"],"names":["activeJourneyStep","JourneyStepTag","reportBackendRequest","resolveJourneyStep","requestKey","instrumented","WeakSet","reportTiming","jqXHR","settings","step","journeyStep","start","journeyStart","globalThis","performance","now","status","undefined","url","instrumentJquery","$","has","add","ajaxPrefilter","options","_originalOptions","fromSettings","document","ajaxComplete","_event"],"mappings":"AAAA,SACIA,iBAAiB,EACjBC,cAAc,EACdC,oBAAoB,EACpBC,kBAAkB,QACf,aAAa;AACpB,SAASC,UAAU,QAAQ,iBAAiB;AA4B5C,MAAMC,eAAe,IAAIC;AAEzB,SAASC,aAAaC,KAAgB,EAAEC,QAA4B;QAKlDD;IAJd,MAAME,OAAOP,mBAAmBK,MAAMG,WAAW;IACjD,IAAI,CAACD,MAAM;QACP;IACJ;IACA,MAAME,SAAQJ,sBAAAA,MAAMK,YAAY,cAAlBL,iCAAAA,sBAAsBM,WAAWC,WAAW,CAACC,GAAG;IAC9D,mFAAmF;IACnF,MAAMC,SAAST,MAAMS,MAAM,KAAK,IAAIC,YAAYV,MAAMS,MAAM;IAC5Df,qBACIQ,MACAO,QACAH,WAAWC,WAAW,CAACC,GAAG,KAAKJ,OAC/BR,WAAWK,SAASU,GAAG,EAAED,WAAWA;AAE5C;AAEA,kGAAkG,GAClG,OAAO,SAASE,iBAAiBC,CAAe;IAC5C,IAAIhB,aAAaiB,GAAG,CAACD,IAAc;QAC/B;IACJ;IACAhB,aAAakB,GAAG,CAACF;IAEjBA,EAAEG,aAAa,CAAC,CAACC,SAASC,kBAAkBlB;QACxC;;;SAGC,GACD,IAAI,CAACA,MAAMG,WAAW,EAAE;YACpB,MAAMgB,eAAeF,QAAQd,WAAW;YACxC,IAAIgB,cAAc;gBACdnB,MAAMG,WAAW,GAAGgB;YACxB,OAAO;gBACH,MAAMjB,OAAOV;gBACb,IAAIU,MAAM;oBACNF,MAAMG,WAAW,GAAG,IAAIV,eAAeS;gBAC3C;YACJ;QACJ;QACA,IAAIP,mBAAmBK,MAAMG,WAAW,GAAG;YACvCH,MAAMK,YAAY,GAAGC,WAAWC,WAAW,CAACC,GAAG;QACnD;IACJ;IAEAK,EAAEO,UAAUC,YAAY,CAAC,CAACC,QAAQtB,OAAOC;QACrCF,aAAaC,OAAOC;IACxB;AACJ"}
+{"version":3,"sources":["../../../src/integrations/jquery/instrument.ts"],"sourcesContent":["import { resolveStamp } from '../../core';\nimport { adoptJourneyStepStamp, type JourneyStepStamp } from '../../core/step-tag';\nimport {\n    getInstrumentedJquerySet,\n    registerInstrumentRecord,\n    type InstrumentRecord,\n} from '../../global';\nimport { onHttpComplete } from '../http-report';\nimport { requestKey, type JourneyTimedMeta } from '../request-key';\nimport { acceptInstrumentTarget } from '../soft-skip';\n\nexport interface JqueryXHR {\n    status: number;\n    statusText?: string;\n    stamp?: unknown;\n    journeyStart?: number;\n}\n\nexport interface JqueryAjaxSettings extends JourneyTimedMeta {\n    url?: string;\n    type?: string;\n    method?: string;\n}\n\nconst jqueryStamps = new WeakMap<object, JourneyStepStamp>();\n\nexport interface JqueryStatic {\n    ajaxPrefilter(\n        handler: (\n            options: JqueryAjaxSettings,\n            originalOptions: JqueryAjaxSettings,\n            jqXHR: JqueryXHR\n        ) => void\n    ): void;\n    (selector: Document): {\n        ajaxComplete(\n            handler: (event: unknown, jqXHR: JqueryXHR, settings: JqueryAjaxSettings) => void\n        ): void;\n    };\n}\n\nfunction reportTiming(jqXHR: JqueryXHR, settings: JqueryAjaxSettings): void {\n    const stamp = jqueryStamps.get(jqXHR) ?? adoptJourneyStepStamp(jqXHR.stamp);\n    if (!stamp || stamp.ignore || settings.ignore === true) {\n        return;\n    }\n    const start = jqXHR.journeyStart ?? globalThis.performance.now();\n    const aborted = jqXHR.statusText === 'abort';\n    // jQuery uses status 0 for network / abort failures — treat like a missing status.\n    const status = aborted || jqXHR.status === 0 ? undefined : jqXHR.status;\n    onHttpComplete({\n        stamp,\n        status,\n        durationMs: globalThis.performance.now() - start,\n        requestKey: requestKey(settings.url, undefined, undefined),\n        aborted,\n        url: settings.url,\n        method: settings.type ?? settings.method,\n        meta: settings,\n        request: settings,\n        response: jqXHR,\n    });\n}\n\nfunction isJqueryStatic(value: unknown): value is JqueryStatic {\n    return (\n        typeof value === 'function' && typeof (value as JqueryStatic).ajaxPrefilter === 'function'\n    );\n}\n\n/** Resolve `globalThis.$`, then `globalThis.jQuery`. */\nexport function resolveGlobalJquery(): JqueryStatic | null | undefined {\n    const g = globalThis as typeof globalThis & { $?: unknown; jQuery?: unknown };\n    return (g.$ ?? g.jQuery) as JqueryStatic | null | undefined;\n}\n\n/** Live record per $ — handlers look this up so restore+rewire does not stack prefilters. */\nconst jqueryLiveRecords = new WeakMap<object, InstrumentRecord>();\n/** jQuery cannot unregister these; track each so a partial-wire retry does not stack. */\nconst jqueryPrefiltersInstalled = new WeakSet<object>();\nconst jqueryCompletesInstalled = new WeakSet<object>();\n\nfunction stampAjax(jqXHR: JqueryXHR, options: JqueryAjaxSettings): void {\n    if (options.ignore === true) {\n        return;\n    }\n    const stamp = resolveStamp(jqXHR.stamp ?? options.stamp);\n    if (stamp) {\n        jqueryStamps.set(jqXHR, stamp);\n        delete jqXHR.stamp;\n        delete options.stamp;\n    }\n    if (stamp && !stamp.ignore) {\n        jqXHR.journeyStart = globalThis.performance.now();\n    }\n}\n\n/**\n * Wire a jQuery static into the journey engine. Call once per $ (idempotent). Observation-only.\n * Soft-skips when `$` is missing or not a real jQuery (no `ajaxPrefilter`) so hosts can pass `$` as-is.\n * Returns a restore that disposes handlers (they no-op after restore).\n */\nexport function instrumentJquery($: JqueryStatic | null | undefined): () => void {\n    const jquery = acceptInstrumentTarget('Jquery', $, isJqueryStatic);\n    const instrumented = getInstrumentedJquerySet();\n    if (!jquery || instrumented.has(jquery as object)) {\n        return () => {};\n    }\n\n    const key = jquery as object;\n    const record: InstrumentRecord = { disposed: false };\n\n    try {\n        if (!jqueryPrefiltersInstalled.has(key)) {\n            jquery.ajaxPrefilter((options, _originalOptions, jqXHR) => {\n                const current = jqueryLiveRecords.get(key);\n                if (!current || current.disposed) {\n                    return;\n                }\n                stampAjax(jqXHR, options);\n            });\n            jqueryPrefiltersInstalled.add(key);\n        }\n        if (!jqueryCompletesInstalled.has(key)) {\n            jquery(document).ajaxComplete((_event, jqXHR, settings) => {\n                const current = jqueryLiveRecords.get(key);\n                if (!current || current.disposed) {\n                    return;\n                }\n                reportTiming(jqXHR, settings);\n            });\n            jqueryCompletesInstalled.add(key);\n        }\n        jqueryLiveRecords.set(key, record);\n        instrumented.add(key);\n    } catch (err) {\n        /*\n         * Keep per-handler installed flags so a retry cannot double-register\n         * prefilters. Restore deletes the shared instrumented slot so teardown /\n         * retry can finish whichever handler never succeeded.\n         */\n        record.disposed = true;\n        instrumented.add(key);\n        const restore = () => {\n            record.disposed = true;\n            if (jqueryLiveRecords.get(key) === record) {\n                jqueryLiveRecords.delete(key);\n            }\n            instrumented.delete(key);\n        };\n        record.restore = restore;\n        registerInstrumentRecord(record);\n        // eslint-disable-next-line no-console -- soft-fail host wiring\n        console.error('[journey] instrumentJquery failed', err);\n        return restore;\n    }\n\n    const restore = () => {\n        record.disposed = true;\n        if (jqueryLiveRecords.get(key) === record) {\n            jqueryLiveRecords.delete(key);\n        }\n        instrumented.delete(key);\n    };\n    record.restore = restore;\n    registerInstrumentRecord(record);\n    return restore;\n}\n"],"names":["resolveStamp","adoptJourneyStepStamp","getInstrumentedJquerySet","registerInstrumentRecord","onHttpComplete","requestKey","acceptInstrumentTarget","jqueryStamps","WeakMap","reportTiming","jqXHR","settings","stamp","get","ignore","start","journeyStart","globalThis","performance","now","aborted","statusText","status","undefined","durationMs","url","method","type","meta","request","response","isJqueryStatic","value","ajaxPrefilter","resolveGlobalJquery","g","$","jQuery","jqueryLiveRecords","jqueryPrefiltersInstalled","WeakSet","jqueryCompletesInstalled","stampAjax","options","set","instrumentJquery","jquery","instrumented","has","key","record","disposed","_originalOptions","current","add","document","ajaxComplete","_event","err","restore","delete","console","error"],"mappings":"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"}

package/dist/integrations/react/context.d.ts

@@ -1,6 +1,9 @@
 export declare const JourneyNameContext: import("react").Context<string | null>;
 /** Active journey name, or null outside a `<JourneyScope>` (steps run untraced). */
 export declare function useOptionalJourneyName(): string | null;
-/** Active journey name; throws outside a `<JourneyScope>`. */
+/**
+ * Active journey name; throws outside a `<JourneyScope>`.
+ * Prefer {@link useOptionalJourneyName} when the shell may omit a scope.
+ */
 export declare function useJourneyName(): string;
 //# sourceMappingURL=context.d.ts.map

package/dist/integrations/react/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/integrations/react/context.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,wCAAqC,CAAC;AAErE,oFAAoF;AACpF,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,IAAI,MAAM,CAMvC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/integrations/react/context.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,wCAAqC,CAAC;AAErE,oFAAoF;AACpF,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC"}

package/dist/integrations/react/context.js

@@ -3,7 +3,10 @@ export const JourneyNameContext = createContext(null);
 /** Active journey name, or null outside a `<JourneyScope>` (steps run untraced). */ export function useOptionalJourneyName() {
     return useContext(JourneyNameContext);
 }
-/** Active journey name; throws outside a `<JourneyScope>`. */ export function useJourneyName() {
+/**
+ * Active journey name; throws outside a `<JourneyScope>`.
+ * Prefer {@link useOptionalJourneyName} when the shell may omit a scope.
+ */ export function useJourneyName() {
     const name = useContext(JourneyNameContext);
     if (!name) {
         throw new Error('useJourneyName must be used within a <JourneyScope>');

package/dist/integrations/react/context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/integrations/react/context.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nexport const JourneyNameContext = createContext<string | null>(null);\n\n/** Active journey name, or null outside a `<JourneyScope>` (steps run untraced). */\nexport function useOptionalJourneyName(): string | null {\n    return useContext(JourneyNameContext);\n}\n\n/** Active journey name; throws outside a `<JourneyScope>`. */\nexport function useJourneyName(): string {\n    const name = useContext(JourneyNameContext);\n    if (!name) {\n        throw new Error('useJourneyName must be used within a <JourneyScope>');\n    }\n    return name;\n}\n"],"names":["createContext","useContext","JourneyNameContext","useOptionalJourneyName","useJourneyName","name","Error"],"mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,QAAQ;AAElD,OAAO,MAAMC,qBAAqBF,cAA6B,MAAM;AAErE,kFAAkF,GAClF,OAAO,SAASG;IACZ,OAAOF,WAAWC;AACtB;AAEA,4DAA4D,GAC5D,OAAO,SAASE;IACZ,MAAMC,OAAOJ,WAAWC;IACxB,IAAI,CAACG,MAAM;QACP,MAAM,IAAIC,MAAM;IACpB;IACA,OAAOD;AACX"}
+{"version":3,"sources":["../../../src/integrations/react/context.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nexport const JourneyNameContext = createContext<string | null>(null);\n\n/** Active journey name, or null outside a `<JourneyScope>` (steps run untraced). */\nexport function useOptionalJourneyName(): string | null {\n    return useContext(JourneyNameContext);\n}\n\n/**\n * Active journey name; throws outside a `<JourneyScope>`.\n * Prefer {@link useOptionalJourneyName} when the shell may omit a scope.\n */\nexport function useJourneyName(): string {\n    const name = useContext(JourneyNameContext);\n    if (!name) {\n        throw new Error('useJourneyName must be used within a <JourneyScope>');\n    }\n    return name;\n}\n"],"names":["createContext","useContext","JourneyNameContext","useOptionalJourneyName","useJourneyName","name","Error"],"mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,QAAQ;AAElD,OAAO,MAAMC,qBAAqBF,cAA6B,MAAM;AAErE,kFAAkF,GAClF,OAAO,SAASG;IACZ,OAAOF,WAAWC;AACtB;AAEA;;;CAGC,GACD,OAAO,SAASE;IACZ,MAAMC,OAAOJ,WAAWC;IACxB,IAAI,CAACG,MAAM;QACP,MAAM,IAAIC,MAAM;IACpB;IACA,OAAOD;AACX"}

package/dist/integrations/react/scope.d.ts

@@ -1,13 +1,24 @@
 import { type ReactNode } from 'react';
 import { type JourneyDef } from '../../core';
 import type { TagValue } from '../../core/types';
+type JourneyScopeDef = JourneyDef | {
+    config: JourneyDef;
+};
 /**
  * Opens a journey while the subtree is mounted; Excludes on unmount.
- * Config (timeouts, endpoints, tags, …) is captured when the journey opens;
- * only a `name` change re-opens.
+ * `name` is the lifecycle key — changing it excludes the previous instance
+ * and opens a new one. Other config fields and `tags` update the open instance
+ * in place (timeouts re-arm; they do not restart).
+ *
+ * Pass a {@link JourneyDef} (`<JourneyScope {...def}>`) or spread a handle
+ * (`<JourneyScope {...makeASaleJourney}>` reads `handle.config`).
+ *
+ * React 18 Strict Mode (development) remounts once: expect an `excluded` emission
+ * then a fresh open. Production single-mount does not.
  */
-export declare function JourneyScope({ tags, children, ...def }: JourneyDef & {
+export declare function JourneyScope({ tags, children, ...rest }: JourneyScopeDef & {
     tags?: Record<string, TagValue>;
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
+export {};
 //# sourceMappingURL=scope.d.ts.map

package/dist/integrations/react/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/integrations/react/scope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EACzB,IAAI,EACJ,QAAQ,EACR,GAAG,GAAG,EACT,EAAE,UAAU,GAAG;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,QAAQ,EAAE,SAAS,CAAC;CACvB,2CAaA"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/integrations/react/scope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,KAAK,eAAe,GAAG,UAAU,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EACzB,IAAI,EACJ,QAAQ,EACR,GAAG,IAAI,EACV,EAAE,eAAe,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,QAAQ,EAAE,SAAS,CAAC;CACvB,2CAqDA"}

package/dist/integrations/react/scope.js

@@ -1,23 +1,61 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect } from 'react';
-import { excludeJourney, setJourneyTags } from '../../core';
+import { setJourneyTags } from '../../core';
 import { moduleRuntime } from '../../core/runtime';
 import { JourneyNameContext } from './context';
+import { stableEndpointKey, stableExpectedKey, stableTagsKey } from './stable-config-keys';
 /**
  * Opens a journey while the subtree is mounted; Excludes on unmount.
- * Config (timeouts, endpoints, tags, …) is captured when the journey opens;
- * only a `name` change re-opens.
- */ export function JourneyScope({ tags, children, ...def }) {
-    const { name } = def;
+ * `name` is the lifecycle key — changing it excludes the previous instance
+ * and opens a new one. Other config fields and `tags` update the open instance
+ * in place (timeouts re-arm; they do not restart).
+ *
+ * Pass a {@link JourneyDef} (`<JourneyScope {...def}>`) or spread a handle
+ * (`<JourneyScope {...makeASaleJourney}>` reads `handle.config`).
+ *
+ * React 18 Strict Mode (development) remounts once: expect an `excluded` emission
+ * then a fresh open. Production single-mount does not.
+ */ export function JourneyScope({ tags, children, ...rest }) {
+    const def = 'config' in rest ? rest.config : rest;
+    const { name, timeoutMs, stepTimeoutMs, slowRequestMs, endpoints, expected, service, team, group, maxSteps } = def;
+    const endpointKey = stableEndpointKey(endpoints);
+    const expectedKey = stableExpectedKey(expected);
+    const configTagsKey = stableTagsKey(def.tags);
     useEffect(()=>{
         moduleRuntime.startJourney(def);
+        const opened = moduleRuntime.getOpenJourney(name);
+        return ()=>{
+            if (opened) {
+                moduleRuntime.excludeJourney(opened);
+            }
+        };
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- name is the lifecycle key
+    }, [
+        name
+    ]);
+    useEffect(()=>{
         if (tags) {
             setJourneyTags(name, tags);
         }
-        return ()=>excludeJourney(name);
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- freeze-on-mount; name is the lifecycle key
     }, [
-        name
+        name,
+        tags
+    ]);
+    useEffect(()=>{
+        moduleRuntime.updateOpenJourney(def);
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- field-level live updates; name-change is the other effect
+    }, [
+        name,
+        timeoutMs,
+        stepTimeoutMs,
+        slowRequestMs,
+        endpointKey,
+        expectedKey,
+        service,
+        team,
+        group,
+        maxSteps,
+        configTagsKey
     ]);
     return /*#__PURE__*/ _jsx(JourneyNameContext.Provider, {
         value: name,

package/dist/integrations/react/scope.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/integrations/react/scope.tsx"],"sourcesContent":["import { useEffect, type ReactNode } from 'react';\n\nimport { excludeJourney, setJourneyTags, type JourneyDef } from '../../core';\nimport { moduleRuntime } from '../../core/runtime';\nimport type { TagValue } from '../../core/types';\nimport { JourneyNameContext } from './context';\n\n/**\n * Opens a journey while the subtree is mounted; Excludes on unmount.\n * Config (timeouts, endpoints, tags, …) is captured when the journey opens;\n * only a `name` change re-opens.\n */\nexport function JourneyScope({\n    tags,\n    children,\n    ...def\n}: JourneyDef & {\n    tags?: Record<string, TagValue>;\n    children: ReactNode;\n}) {\n    const { name } = def;\n\n    useEffect(() => {\n        moduleRuntime.startJourney(def);\n        if (tags) {\n            setJourneyTags(name, tags);\n        }\n        return () => excludeJourney(name);\n        // eslint-disable-next-line react-hooks/exhaustive-deps -- freeze-on-mount; name is the lifecycle key\n    }, [name]);\n\n    return <JourneyNameContext.Provider value={name}>{children}</JourneyNameContext.Provider>;\n}\n"],"names":["useEffect","excludeJourney","setJourneyTags","moduleRuntime","JourneyNameContext","JourneyScope","tags","children","def","name","startJourney","Provider","value"],"mappings":";AAAA,SAASA,SAAS,QAAwB,QAAQ;AAElD,SAASC,cAAc,EAAEC,cAAc,QAAyB,aAAa;AAC7E,SAASC,aAAa,QAAQ,qBAAqB;AAEnD,SAASC,kBAAkB,QAAQ,YAAY;AAE/C;;;;CAIC,GACD,OAAO,SAASC,aAAa,EACzBC,IAAI,EACJC,QAAQ,EACR,GAAGC,KAIN;IACG,MAAM,EAAEC,IAAI,EAAE,GAAGD;IAEjBR,UAAU;QACNG,cAAcO,YAAY,CAACF;QAC3B,IAAIF,MAAM;YACNJ,eAAeO,MAAMH;QACzB;QACA,OAAO,IAAML,eAAeQ;IAC5B,qGAAqG;IACzG,GAAG;QAACA;KAAK;IAET,qBAAO,KAACL,mBAAmBO,QAAQ;QAACC,OAAOH;kBAAOF;;AACtD"}
+{"version":3,"sources":["../../../src/integrations/react/scope.tsx"],"sourcesContent":["import { useEffect, type ReactNode } from 'react';\n\nimport { setJourneyTags, type JourneyDef } from '../../core';\nimport { moduleRuntime } from '../../core/runtime';\nimport type { TagValue } from '../../core/types';\nimport { JourneyNameContext } from './context';\nimport { stableEndpointKey, stableExpectedKey, stableTagsKey } from './stable-config-keys';\n\ntype JourneyScopeDef = JourneyDef | { config: JourneyDef };\n\n/**\n * Opens a journey while the subtree is mounted; Excludes on unmount.\n * `name` is the lifecycle key — changing it excludes the previous instance\n * and opens a new one. Other config fields and `tags` update the open instance\n * in place (timeouts re-arm; they do not restart).\n *\n * Pass a {@link JourneyDef} (`<JourneyScope {...def}>`) or spread a handle\n * (`<JourneyScope {...makeASaleJourney}>` reads `handle.config`).\n *\n * React 18 Strict Mode (development) remounts once: expect an `excluded` emission\n * then a fresh open. Production single-mount does not.\n */\nexport function JourneyScope({\n    tags,\n    children,\n    ...rest\n}: JourneyScopeDef & {\n    tags?: Record<string, TagValue>;\n    children: ReactNode;\n}) {\n    const def: JourneyDef = 'config' in rest ? rest.config : rest;\n    const {\n        name,\n        timeoutMs,\n        stepTimeoutMs,\n        slowRequestMs,\n        endpoints,\n        expected,\n        service,\n        team,\n        group,\n        maxSteps,\n    } = def;\n    const endpointKey = stableEndpointKey(endpoints);\n    const expectedKey = stableExpectedKey(expected);\n    const configTagsKey = stableTagsKey(def.tags);\n\n    useEffect(() => {\n        moduleRuntime.startJourney(def);\n        const opened = moduleRuntime.getOpenJourney(name);\n        return () => {\n            if (opened) {\n                moduleRuntime.excludeJourney(opened);\n            }\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps -- name is the lifecycle key\n    }, [name]);\n\n    useEffect(() => {\n        if (tags) {\n            setJourneyTags(name, tags);\n        }\n    }, [name, tags]);\n\n    useEffect(() => {\n        moduleRuntime.updateOpenJourney(def);\n        // eslint-disable-next-line react-hooks/exhaustive-deps -- field-level live updates; name-change is the other effect\n    }, [\n        name,\n        timeoutMs,\n        stepTimeoutMs,\n        slowRequestMs,\n        endpointKey,\n        expectedKey,\n        service,\n        team,\n        group,\n        maxSteps,\n        configTagsKey,\n    ]);\n\n    return <JourneyNameContext.Provider value={name}>{children}</JourneyNameContext.Provider>;\n}\n"],"names":["useEffect","setJourneyTags","moduleRuntime","JourneyNameContext","stableEndpointKey","stableExpectedKey","stableTagsKey","JourneyScope","tags","children","rest","def","config","name","timeoutMs","stepTimeoutMs","slowRequestMs","endpoints","expected","service","team","group","maxSteps","endpointKey","expectedKey","configTagsKey","startJourney","opened","getOpenJourney","excludeJourney","updateOpenJourney","Provider","value"],"mappings":";AAAA,SAASA,SAAS,QAAwB,QAAQ;AAElD,SAASC,cAAc,QAAyB,aAAa;AAC7D,SAASC,aAAa,QAAQ,qBAAqB;AAEnD,SAASC,kBAAkB,QAAQ,YAAY;AAC/C,SAASC,iBAAiB,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,uBAAuB;AAI3F;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,aAAa,EACzBC,IAAI,EACJC,QAAQ,EACR,GAAGC,MAIN;IACG,MAAMC,MAAkB,YAAYD,OAAOA,KAAKE,MAAM,GAAGF;IACzD,MAAM,EACFG,IAAI,EACJC,SAAS,EACTC,aAAa,EACbC,aAAa,EACbC,SAAS,EACTC,QAAQ,EACRC,OAAO,EACPC,IAAI,EACJC,KAAK,EACLC,QAAQ,EACX,GAAGX;IACJ,MAAMY,cAAcnB,kBAAkBa;IACtC,MAAMO,cAAcnB,kBAAkBa;IACtC,MAAMO,gBAAgBnB,cAAcK,IAAIH,IAAI;IAE5CR,UAAU;QACNE,cAAcwB,YAAY,CAACf;QAC3B,MAAMgB,SAASzB,cAAc0B,cAAc,CAACf;QAC5C,OAAO;YACH,IAAIc,QAAQ;gBACRzB,cAAc2B,cAAc,CAACF;YACjC;QACJ;IACA,oFAAoF;IACxF,GAAG;QAACd;KAAK;IAETb,UAAU;QACN,IAAIQ,MAAM;YACNP,eAAeY,MAAML;QACzB;IACJ,GAAG;QAACK;QAAML;KAAK;IAEfR,UAAU;QACNE,cAAc4B,iBAAiB,CAACnB;IAChC,oHAAoH;IACxH,GAAG;QACCE;QACAC;QACAC;QACAC;QACAO;QACAC;QACAL;QACAC;QACAC;QACAC;QACAG;KACH;IAED,qBAAO,KAACtB,mBAAmB4B,QAAQ;QAACC,OAAOnB;kBAAOJ;;AACtD"}

package/dist/integrations/react/stable-config-keys.d.ts

@@ -0,0 +1,6 @@
+import type { EndpointPolicy } from '../../core/endpoint-policy';
+import type { TagValue } from '../../core/types';
+export declare function stableEndpointKey(endpoints?: readonly EndpointPolicy[]): string;
+export declare function stableExpectedKey(expected?: readonly string[]): string;
+export declare function stableTagsKey(tags?: Record<string, TagValue>): string;
+//# sourceMappingURL=stable-config-keys.d.ts.map

package/dist/integrations/react/stable-config-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-config-keys.d.ts","sourceRoot":"","sources":["../../../src/integrations/react/stable-config-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAU/E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEtE;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAQrE"}

package/dist/integrations/react/stable-config-keys.js

@@ -0,0 +1,21 @@
+export function stableEndpointKey(endpoints) {
+    if (!(endpoints === null || endpoints === void 0 ? void 0 : endpoints.length)) {
+        return '';
+    }
+    return endpoints.map((endpoint)=>{
+        var _endpoint_slowRequestMs;
+        return `${endpoint.match}\0${(_endpoint_slowRequestMs = endpoint.slowRequestMs) !== null && _endpoint_slowRequestMs !== void 0 ? _endpoint_slowRequestMs : ''}\0${endpoint.ignore === true}`;
+    }).join('\n');
+}
+export function stableExpectedKey(expected) {
+    var _ref;
+    return (_ref = expected === null || expected === void 0 ? void 0 : expected.join('\0')) !== null && _ref !== void 0 ? _ref : '';
+}
+export function stableTagsKey(tags) {
+    if (!tags) {
+        return '';
+    }
+    return Object.keys(tags).sort().map((key)=>`${key}\0${String(tags[key])}`).join('\n');
+}
+
+//# sourceMappingURL=stable-config-keys.js.map

package/dist/integrations/react/stable-config-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/integrations/react/stable-config-keys.ts"],"sourcesContent":["import type { EndpointPolicy } from '../../core/endpoint-policy';\nimport type { TagValue } from '../../core/types';\n\nexport function stableEndpointKey(endpoints?: readonly EndpointPolicy[]): string {\n    if (!endpoints?.length) {\n        return '';\n    }\n    return endpoints\n        .map(\n            endpoint =>\n                `${endpoint.match}\\0${endpoint.slowRequestMs ?? ''}\\0${endpoint.ignore === true}`\n        )\n        .join('\\n');\n}\n\nexport function stableExpectedKey(expected?: readonly string[]): string {\n    return expected?.join('\\0') ?? '';\n}\n\nexport function stableTagsKey(tags?: Record<string, TagValue>): string {\n    if (!tags) {\n        return '';\n    }\n    return Object.keys(tags)\n        .sort()\n        .map(key => `${key}\\0${String(tags[key])}`)\n        .join('\\n');\n}\n"],"names":["stableEndpointKey","endpoints","length","map","endpoint","match","slowRequestMs","ignore","join","stableExpectedKey","expected","stableTagsKey","tags","Object","keys","sort","key","String"],"mappings":"AAGA,OAAO,SAASA,kBAAkBC,SAAqC;IACnE,IAAI,EAACA,sBAAAA,gCAAAA,UAAWC,MAAM,GAAE;QACpB,OAAO;IACX;IACA,OAAOD,UACFE,GAAG,CACAC,CAAAA;YAC0BA;eAAtB,GAAGA,SAASC,KAAK,CAAC,EAAE,GAAED,0BAAAA,SAASE,aAAa,cAAtBF,qCAAAA,0BAA0B,GAAG,EAAE,EAAEA,SAASG,MAAM,KAAK,MAAM;OAExFC,IAAI,CAAC;AACd;AAEA,OAAO,SAASC,kBAAkBC,QAA4B;;IAC1D,eAAOA,qBAAAA,+BAAAA,SAAUF,IAAI,CAAC,4CAAS;AACnC;AAEA,OAAO,SAASG,cAAcC,IAA+B;IACzD,IAAI,CAACA,MAAM;QACP,OAAO;IACX;IACA,OAAOC,OAAOC,IAAI,CAACF,MACdG,IAAI,GACJZ,GAAG,CAACa,CAAAA,MAAO,GAAGA,IAAI,EAAE,EAAEC,OAAOL,IAAI,CAACI,IAAI,GAAG,EACzCR,IAAI,CAAC;AACd"}

package/dist/integrations/react/use-journey-step.d.ts

@@ -0,0 +1,11 @@
+import { type JourneyHandle, type JourneyStepOptions, type StepHandle } from '../../core';
+/**
+ * Run a step on the active `<JourneyScope>` journey, an explicit name, or a handle.
+ * A handle auto-starts when the journey is not open; a bare name does not.
+ *
+ * @example
+ * const runStep = useJourneyStep();
+ * await runStep('load', async step => { await api.get('/x', { stamp: step.stamp() }); });
+ */
+export declare function useJourneyStep(journey?: string | JourneyHandle | null): <T>(stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions) => Promise<T>;
+//# sourceMappingURL=use-journey-step.d.ts.map

package/dist/integrations/react/use-journey-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-journey-step.d.ts","sourceRoot":"","sources":["../../../src/integrations/react/use-journey-step.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAClB,MAAM,YAAY,CAAC;AAGpB;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,IAK7D,CAAC,YACY,MAAM,MACZ,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,SACjC,kBAAkB,KAC1B,OAAO,CAAC,CAAC,CAAC,CAGpB"}