@scanly/browser 2.0.0

package/dist/batch/batch-session.js

@@ -0,0 +1,267 @@
+import { BarcodeTracker } from "../tracking/barcode-tracker.js";
+import { BatchController } from "./batch-controller.js";
+/**
+ * ScannerSession + BarcodeTracker + BatchController composition. React and
+ * other UI layers only subscribe to the resulting SDK state.
+ */
+export class BatchScanSession {
+    scanner;
+    tracker;
+    controller;
+    disposeScanner;
+    disposeTracker;
+    subscriptions;
+    pendingScannerFrames = new Map();
+    generation = 0;
+    stopRequested = false;
+    disposed = false;
+    constructor(options) {
+        this.scanner = options.scanner;
+        this.tracker = options.tracker ?? new BarcodeTracker(options.trackerOptions);
+        this.controller = new BatchController(options);
+        this.disposeScanner = options.disposeScanner ?? true;
+        this.disposeTracker = options.disposeTracker ?? true;
+        const observationSubscription = typeof this.scanner.onObservations === "function"
+            ? this.scanner.onObservations((set) => this.observeScannerObservationSet(set))
+            : this.scanner.onDiagnostics((diagnostic) => this.observeScannerDiagnostic(diagnostic));
+        this.subscriptions = [observationSubscription, this.scanner.onStateChange((state) => this.observeScannerState(state))];
+    }
+    async start() {
+        this.assertUsable();
+        const state = this.scanner.getState();
+        if (state === "starting" || state === "scanning" || state === "paused")
+            return;
+        this.generation += 1;
+        this.pendingScannerFrames.clear();
+        this.tracker.reset();
+        this.controller.reset();
+        this.stopRequested = false;
+        try {
+            await this.scanner.start();
+        }
+        catch (error) {
+            this.controller.fail(error);
+            throw error;
+        }
+    }
+    pause() {
+        if (this.disposed || this.scanner.getState() !== "scanning")
+            return;
+        this.invalidatePendingFrames();
+        this.scanner.pause();
+    }
+    resume() {
+        if (this.disposed || this.scanner.getState() !== "paused")
+            return;
+        this.scanner.resume();
+    }
+    async stop() {
+        if (this.disposed)
+            return;
+        this.stopRequested = true;
+        this.invalidatePendingFrames();
+        const errors = [];
+        try {
+            await this.scanner.stop();
+        }
+        catch (error) {
+            errors.push(error);
+            this.controller.fail(error);
+        }
+        finally {
+            // A ScannerSession implementation may reject before changing state.
+            // Keep the generation closed so late observation callbacks cannot mutate
+            // the terminal batch state.
+            this.invalidatePendingFrames();
+            try {
+                this.tracker.reset();
+            }
+            catch (error) {
+                errors.push(error);
+                this.controller.fail(error);
+            }
+            if (errors.length === 0 && this.controller.getState().status === "collecting")
+                this.controller.cancel();
+            try {
+                this.controller.releaseRetainedState();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        if (errors.length === 1)
+            throw errors[0];
+        if (errors.length > 1)
+            throw new AggregateError(errors, "BatchScanSession stop failed after attempting runtime cleanup.");
+    }
+    async dispose() {
+        if (this.disposed)
+            return;
+        // Close callbacks before awaiting fallible delegated lifecycle methods.
+        this.disposed = true;
+        this.stopRequested = true;
+        this.invalidatePendingFrames();
+        const errors = [];
+        try {
+            await this.scanner.stop();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        finally {
+            if (this.controller.getState().status === "collecting")
+                this.controller.cancel();
+            for (const unsubscribe of this.subscriptions.splice(0)) {
+                try {
+                    unsubscribe();
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+            }
+            if (this.disposeTracker) {
+                // Reset first so an injected/fallible dispose implementation cannot
+                // strand live identities owned by this composition.
+                try {
+                    this.tracker.reset();
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+                try {
+                    this.tracker.dispose();
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+            }
+            this.pendingScannerFrames.clear();
+            try {
+                this.controller.clear();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            if (this.disposeScanner) {
+                try {
+                    await this.scanner.dispose();
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+            }
+        }
+        if (errors.length === 1)
+            throw errors[0];
+        if (errors.length > 1)
+            throw new AggregateError(errors, "BatchScanSession disposal failed after completing all cleanup steps.");
+    }
+    getTracks() {
+        return this.tracker.getTracks();
+    }
+    getBatchState() {
+        return this.controller.getState();
+    }
+    getStatistics() {
+        return this.controller.getStatistics();
+    }
+    onTrack(listener) {
+        return this.controller.onTrack(listener);
+    }
+    onBatchEvent(listener) {
+        return this.controller.onEvent(listener);
+    }
+    /** Explicit frame API used by deterministic runtimes and custom capture adapters. */
+    processFrame(observations, frame) {
+        this.assertUsable();
+        const update = this.tracker.observeFrame(observations, frame);
+        this.controller.applyTrackerUpdate(update);
+        return update;
+    }
+    /** Accept an update from an externally-driven instance of the same tracker. */
+    applyTrackerUpdate(update) {
+        this.assertUsable();
+        this.controller.applyTrackerUpdate(update);
+    }
+    observeScannerDiagnostic(diagnostic) {
+        if (this.disposed || this.stopRequested || !diagnostic.event || diagnostic.frameId === undefined)
+            return;
+        if (diagnostic.event.type !== "detected" && diagnostic.event.type !== "lost")
+            return;
+        if (this.scanner.getState() !== "starting" && this.scanner.getState() !== "scanning")
+            return;
+        const frameId = diagnostic.frameId;
+        const pending = this.pendingScannerFrames.get(frameId) ?? {
+            timestamp: diagnostic.timestamp,
+            observations: [],
+            generation: this.generation,
+            scheduled: false,
+        };
+        pending.timestamp = Math.max(pending.timestamp, diagnostic.timestamp);
+        const event = diagnostic.event;
+        if (event.type === "detected" && event.geometry) {
+            pending.observations.push({
+                payload: event.barcode.text,
+                format: event.barcode.format,
+                geometry: event.geometry,
+            });
+        }
+        this.pendingScannerFrames.set(frameId, pending);
+        if (pending.scheduled)
+            return;
+        pending.scheduled = true;
+        queueMicrotask(() => this.flushScannerFrame(frameId, pending));
+    }
+    observeScannerObservationSet(set) {
+        if (this.disposed || this.stopRequested || (this.scanner.getState() !== "starting" && this.scanner.getState() !== "scanning"))
+            return;
+        const observations = set.observations.flatMap((observation) => observation.geometry ? [{
+                payload: observation.barcode.text,
+                format: observation.barcode.format,
+                geometry: observation.geometry,
+            }] : []);
+        try {
+            this.processFrame(observations, { frameId: set.frameId, timestamp: set.timestamp });
+        }
+        catch (error) {
+            this.controller.fail(error);
+        }
+    }
+    flushScannerFrame(frameId, pending) {
+        if (this.pendingScannerFrames.get(frameId) !== pending)
+            return;
+        this.pendingScannerFrames.delete(frameId);
+        if (this.disposed || this.stopRequested || pending.generation !== this.generation)
+            return;
+        if (this.scanner.getState() !== "starting" && this.scanner.getState() !== "scanning")
+            return;
+        try {
+            this.processFrame(pending.observations, { frameId, timestamp: pending.timestamp });
+        }
+        catch (error) {
+            this.controller.fail(error);
+        }
+    }
+    observeScannerState(state) {
+        if (this.disposed)
+            return;
+        if (state === "failed") {
+            this.invalidatePendingFrames();
+            this.controller.fail(new Error("ScannerSession failed while collecting a batch."));
+            return;
+        }
+        if (state === "stopped" && !this.stopRequested && this.controller.getState().status === "collecting") {
+            this.invalidatePendingFrames();
+            this.controller.cancel();
+        }
+    }
+    invalidatePendingFrames() {
+        this.generation += 1;
+        this.pendingScannerFrames.clear();
+    }
+    assertUsable() {
+        if (this.disposed)
+            throw new Error("BatchScanSession has been disposed.");
+    }
+}
+//# sourceMappingURL=batch-session.js.map

package/dist/batch/batch-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-session.js","sourceRoot":"","sources":["../../src/batch/batch-session.ts"],"names":[],"mappings":"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"}

package/dist/batch/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./batch-controller.js";
+export * from "./batch-session.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/batch/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/batch/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./batch-controller.js";
+export * from "./batch-session.js";
+//# sourceMappingURL=index.js.map

package/dist/batch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/batch/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/batch/types.d.ts

@@ -0,0 +1,101 @@
+import type { BarcodeFormat } from "@scanly/core";
+import type { BarcodeTrack } from "../tracking/types.js";
+/** Batch behavior is orthogonal to camera capture and frame scheduling. */
+export type BatchMode = "continuous" | "expected-count" | "checklist" | "unique-physical-instance";
+export type BatchStatus = "collecting" | "complete" | "failed" | "cancelled";
+export interface ExpectedBatchItem {
+    payload: string;
+    format?: BarcodeFormat;
+    /** Defaults to one. Quantities are physical instances, not decoder events. */
+    quantity?: number;
+}
+export interface BatchMatchedItem {
+    item: ExpectedBatchItem;
+    track: BarcodeTrack;
+}
+export interface BatchMissingItem {
+    item: ExpectedBatchItem;
+    quantity: number;
+}
+export interface BatchState {
+    mode: BatchMode;
+    status: BatchStatus;
+    expectedCount?: number;
+    confirmedPhysicalInstanceCount: number;
+    matched: readonly BatchMatchedItem[];
+    missing: readonly BatchMissingItem[];
+    unexpected: readonly BarcodeTrack[];
+    duplicate: readonly BarcodeTrack[];
+    completedAt?: number;
+    failureReason?: string;
+}
+export type TrackEvent = {
+    type: "track-added";
+    track: BarcodeTrack;
+} | {
+    type: "track-updated";
+    track: BarcodeTrack;
+} | {
+    type: "track-lost";
+    trackId: string;
+    track: BarcodeTrack;
+} | {
+    type: "track-restored";
+    track: BarcodeTrack;
+} | {
+    type: "track-retired";
+    trackId: string;
+    track: BarcodeTrack;
+};
+export type BatchEvent = TrackEvent | {
+    type: "item-matched";
+    item: ExpectedBatchItem;
+    track: BarcodeTrack;
+} | {
+    type: "unexpected-item";
+    track: BarcodeTrack;
+} | {
+    type: "duplicate-item";
+    item: ExpectedBatchItem;
+    track: BarcodeTrack;
+} | {
+    type: "batch-completed";
+    state: BatchState;
+} | {
+    type: "batch-cancelled";
+    state: BatchState;
+} | {
+    type: "batch-failed";
+    state: BatchState;
+    error: unknown;
+};
+export interface BatchStatistics {
+    confirmedPhysicalInstanceCount: number;
+    maxRetainedTracks: number;
+    maxRetainedPhysicalInstances: number;
+    /** Current bounded controller snapshots, exposed for memory evidence. */
+    retainedTrackCount: number;
+    retainedPhysicalInstanceCount: number;
+    peakRetainedTrackCount: number;
+    peakRetainedPhysicalInstanceCount: number;
+    peakUnexpectedQuantity: number;
+    peakDuplicateQuantity: number;
+    retentionRejectedTrackCount: number;
+    retentionRejectedPhysicalInstanceCount: number;
+    retentionEvictedPhysicalInstanceCount: number;
+    matchedQuantity: number;
+    missingQuantity: number;
+    unexpectedQuantity: number;
+    duplicateQuantity: number;
+    trackAddedEvents: number;
+    trackUpdatedEvents: number;
+    trackLostEvents: number;
+    trackRestoredEvents: number;
+    trackRetiredEvents: number;
+    batchCompletedEvents: number;
+    completionAccuracy: number;
+}
+export type TrackListener = (event: TrackEvent) => void;
+export type BatchEventListener = (event: BatchEvent) => void;
+export type BatchUnsubscribe = () => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/batch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/batch/types.ts"],"names":[],"mappings":"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"}

package/dist/batch/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/batch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/batch/types.ts"],"names":[],"mappings":""}

package/dist/browser-session.d.ts

@@ -0,0 +1,51 @@
+import { CaptureRouter, type BarcodeFormat, type ConcurrentCallPolicy, type FormatSelection, type RecoveryBudget, type RecoveryProfile, type RecoveryRouteId, type ScanOutcome } from "@scanly/core";
+import { type ScenarioDefinition } from "@scanly/scenario-schema";
+import { type DecodeWorkerFactory, type WorkerScanOptions } from "./worker/worker-client.js";
+export type BrowserCaptureSessionState = "idle" | "initialized" | "running" | "stopped" | "disposed";
+export interface BrowserScanFileOptions extends WorkerScanOptions {
+    forceMainThread?: boolean;
+}
+export interface BrowserCaptureSessionOptions {
+    scenario?: ScenarioDefinition;
+    formats?: FormatSelection | readonly BarcodeFormat[];
+    concurrentCallPolicy?: ConcurrentCallPolicy;
+    workerFactory?: DecodeWorkerFactory;
+    router?: CaptureRouter;
+    disposeRouter?: boolean;
+    /** Static industrial recovery is explicit; normal upload behavior is unchanged. */
+    recovery?: false | BrowserStaticIndustrialRecoveryOptions;
+}
+export interface BrowserStaticIndustrialRecoveryOptions {
+    profile?: RecoveryProfile;
+    budget?: RecoveryBudget;
+    dpmExperimental?: boolean;
+    excludedRoutes?: readonly RecoveryRouteId[];
+}
+export declare class BrowserCaptureSession {
+    private state;
+    private scenario;
+    private readonly concurrentPolicy;
+    private readonly worker;
+    private readonly router;
+    private readonly ownsRouter;
+    private controller;
+    private owner;
+    private recovery;
+    private readonly recoveryPipeline;
+    constructor(options?: BrowserCaptureSessionOptions);
+    getState(): BrowserCaptureSessionState;
+    initialize(): void;
+    start(): void;
+    stop(): void;
+    cancel(): void;
+    updateConfiguration(scenario: ScenarioDefinition): void;
+    updateFormats(selection: FormatSelection | readonly BarcodeFormat[]): void;
+    scanFile(file: File, options?: BrowserScanFileOptions): Promise<ScanOutcome>;
+    updateRecovery(recovery: false | BrowserStaticIndustrialRecoveryOptions): void;
+    private workerRecovery;
+    private decodeOnMain;
+    dispose(): Promise<void>;
+    private assertNotDisposed;
+    private failure;
+}
+//# sourceMappingURL=browser-session.d.ts.map

package/dist/browser-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../src/browser-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgH,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAoB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrU,OAAO,EAAwC,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGxG,OAAO,EAAsC,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEjI,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AACrG,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAAG,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE;AAC/F,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,aAAa,EAAE,CAAC;IACrD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,KAAK,GAAG,sCAAsC,CAAC;CAC3D;AAED,MAAM,WAAW,sCAAsC;IACrD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAID,qBAAa,qBAAqB;IAChC,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoC;gBAEzD,OAAO,GAAE,4BAAiC;IAatD,QAAQ,IAAI,0BAA0B;IACtC,UAAU,IAAI,IAAI;IAClB,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,MAAM,IAAI,IAAI;IAEd,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IASvD,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,SAAS,aAAa,EAAE,GAAG,IAAI;IAKpE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,WAAW,CAAC;IAyEtF,cAAc,CAAC,QAAQ,EAAE,KAAK,GAAG,sCAAsC,GAAG,IAAI;IAM9E,OAAO,CAAC,cAAc;YAYR,YAAY;IASpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,OAAO;CAGhB"}

package/dist/browser-session.js

@@ -0,0 +1,168 @@
+import { CaptureRouter, IndustrialRecoveryPipeline, createRecoveryProbeScenario, createRgbaFrame, normalizeFormatSelection, sdkError } from "@scanly/core";
+import { getBuiltinScenario, validateScenario } from "@scanly/scenario-schema";
+import { loadPixelBufferFromFile } from "./image-loader.js";
+import { createBrowserCaptureRouter } from "./runtime.js";
+import { DecodeWorkerClient, markDecodePath } from "./worker/worker-client.js";
+let browserFrameSequence = 0;
+export class BrowserCaptureSession {
+    state = "idle";
+    scenario;
+    concurrentPolicy;
+    worker;
+    router;
+    ownsRouter;
+    controller = null;
+    owner = 0;
+    recovery;
+    recoveryPipeline = new IndustrialRecoveryPipeline();
+    constructor(options = {}) {
+        const initial = options.scenario ?? getBuiltinScenario("balanced");
+        const configured = options.formats ? { ...initial, acceptedFormats: [...normalizeFormatSelection(options.formats).formats] } : initial;
+        const validation = validateScenario(configured);
+        if (!validation.ok)
+            throw Object.assign(new Error(validation.message), { code: "malformed_scenario", issues: validation.issues });
+        this.scenario = validation.value;
+        this.concurrentPolicy = options.concurrentCallPolicy ?? "replace";
+        this.worker = new DecodeWorkerClient(options.workerFactory);
+        this.router = options.router ?? createBrowserCaptureRouter({ scenario: this.scenario });
+        this.ownsRouter = options.disposeRouter ?? !options.router;
+        this.recovery = options.recovery ?? false;
+    }
+    getState() { return this.state; }
+    initialize() { this.assertNotDisposed(); if (this.state === "idle" || this.state === "stopped")
+        this.state = "initialized"; }
+    start() { this.assertNotDisposed(); if (this.state === "idle")
+        this.initialize(); this.state = "running"; }
+    stop() { if (this.state === "disposed")
+        return; this.cancel(); this.state = "stopped"; }
+    cancel() { this.owner += 1; this.controller?.abort(); this.controller = null; this.worker.cancel(); }
+    updateConfiguration(scenario) {
+        this.assertNotDisposed();
+        const validation = validateScenario(scenario);
+        if (!validation.ok)
+            throw Object.assign(new Error(validation.message), { code: "malformed_scenario", issues: validation.issues });
+        this.cancel();
+        this.router.updateScenario(validation.value);
+        this.scenario = validation.value;
+    }
+    updateFormats(selection) {
+        const formats = normalizeFormatSelection(selection).formats;
+        this.updateConfiguration({ ...this.scenario, acceptedFormats: [...formats] });
+    }
+    async scanFile(file, options = {}) {
+        const frameId = `browser-frame-${Date.now()}-${++browserFrameSequence}`;
+        if (this.state === "disposed")
+            return this.failure(frameId, "session_disposed", "Browser capture session has been disposed.");
+        if (this.state !== "running")
+            return this.failure(frameId, "session_not_running", "Browser capture session must be started before scanFile().");
+        if (this.controller && this.concurrentPolicy === "reject")
+            return this.failure(frameId, "concurrent_call_rejected", "This session allows one active scan.");
+        if (this.controller)
+            this.cancel();
+        const owner = ++this.owner;
+        const controller = new AbortController();
+        this.controller = controller;
+        const onAbort = () => controller.abort();
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            options.onStage?.("Loading image...");
+            const pixels = await loadPixelBufferFromFile(file);
+            if (controller.signal.aborted)
+                return this.failure(frameId, "cancelled", "Decode cancelled.");
+            const workerPath = !options.forceMainThread && typeof Worker !== "undefined";
+            const frame = createRgbaFrame(pixels.data, pixels.width, pixels.height, { id: frameId, sourceType: "upload", ownership: workerPath ? "transferred" : "owned" });
+            let outcome;
+            if (workerPath) {
+                const decodeStartedAt = Date.now();
+                const scenario = this.scenario;
+                markDecodePath("worker");
+                outcome = await this.worker.scan(frame, scenario, { signal: controller.signal, preserveSourceForFallback: true, onStage: options.onStage, onProgress: options.onProgress, ...(this.workerRecovery() ? { recovery: this.workerRecovery() } : {}) });
+                if (!outcome.ok && ["worker_initialization_failure", "engine_execution_failure"].includes(outcome.error.code) && !controller.signal.aborted && owner === this.owner) {
+                    const workerOutcome = outcome;
+                    const workerElapsedMs = Math.max(Date.now() - decodeStartedAt, workerOutcome.timing.totalMs);
+                    const remainingExecutionMs = Math.floor(scenario.budgets.maxExecutionMs - workerElapsedMs);
+                    const remainingAttempts = scenario.budgets.maxAttempts - workerOutcome.attemptCount;
+                    if (remainingExecutionMs > 0 && remainingAttempts > 0) {
+                        markDecodePath("main-thread");
+                        options.onStage?.("Worker unavailable; retrying on main thread within the remaining scan budget...");
+                        const fallbackScenario = {
+                            ...scenario,
+                            multiCode: { ...scenario.multiCode, maxResults: Math.min(scenario.multiCode.maxResults, remainingAttempts) },
+                            budgets: { ...scenario.budgets, maxAttempts: remainingAttempts, maxExecutionMs: remainingExecutionMs },
+                        };
+                        const fallback = await this.decodeOnMain(createRgbaFrame(pixels.data, pixels.width, pixels.height, { id: frameId, sourceType: "upload", ownership: "owned" }), fallbackScenario, controller.signal);
+                        const totalMs = Math.max(Date.now() - decodeStartedAt, workerElapsedMs + fallback.timing.totalMs);
+                        outcome = {
+                            ...fallback,
+                            attemptCount: workerOutcome.attemptCount + fallback.attemptCount,
+                            timing: {
+                                ...fallback.timing,
+                                totalMs,
+                                ...(workerOutcome.timing.workerSetupMs === undefined ? {} : { workerSetupMs: workerOutcome.timing.workerSetupMs }),
+                                ...(workerOutcome.timing.workerTransferMs === undefined ? {} : { workerTransferMs: workerOutcome.timing.workerTransferMs }),
+                            },
+                        };
+                        options.onProgress?.({ attemptCount: outcome.attemptCount });
+                    }
+                }
+            }
+            else {
+                markDecodePath("main-thread");
+                options.onStage?.("Routing normalized frame...");
+                outcome = await this.decodeOnMain(frame, this.scenario, controller.signal);
+                options.onProgress?.({ attemptCount: outcome.attemptCount });
+            }
+            if (owner !== this.owner)
+                return this.failure(frameId, "cancelled", "Result belongs to a superseded browser job.");
+            return outcome;
+        }
+        catch (error) {
+            const code = error && typeof error === "object" && "code" in error ? String(error.code) : "unsupported_image";
+            const mapped = code === "image_too_large" ? "resource_limit_exceeded" : code === "invalid_file" || code === "unsupported_image" || code === "empty_image" || code === "invalid_image" ? "invalid_image" : controller.signal.aborted ? "cancelled" : "engine_execution_failure";
+            return this.failure(frameId, mapped, error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            options.signal?.removeEventListener("abort", onAbort);
+            if (this.controller === controller)
+                this.controller = null;
+        }
+    }
+    updateRecovery(recovery) {
+        this.assertNotDisposed();
+        this.cancel();
+        this.recovery = recovery;
+    }
+    workerRecovery() {
+        if (this.recovery === false)
+            return undefined;
+        const profile = this.recovery.profile ?? "industrial";
+        return {
+            profile,
+            sourceMode: "static",
+            ...(this.recovery.budget ? { budget: this.recovery.budget } : {}),
+            dpmExperimental: this.recovery.dpmExperimental === true || profile === "dpm-experimental",
+            ...(this.recovery.excludedRoutes ? { excludedRoutes: [...this.recovery.excludedRoutes] } : {}),
+        };
+    }
+    async decodeOnMain(frame, scenario, signal) {
+        const recovery = this.workerRecovery();
+        if (!recovery)
+            return this.router.scan(frame, { signal, scenario });
+        return (await this.recoveryPipeline.run(frame, (candidate, request) => this.router.scan({ ...candidate, ownership: "borrowed", dispose: undefined }, { signal: request.signal, scenario: request.routeId === "general" ? scenario : createRecoveryProbeScenario(scenario, request.routeId) }), { profile: recovery.profile, sourceMode: "static", ...(recovery.budget ? { budget: recovery.budget } : {}), signal, dpmExperimental: recovery.dpmExperimental, excludedRoutes: recovery.excludedRoutes })).outcome;
+    }
+    async dispose() {
+        if (this.state === "disposed")
+            return;
+        this.cancel();
+        this.worker.dispose();
+        this.state = "disposed";
+        if (this.ownsRouter)
+            await this.router.dispose();
+    }
+    assertNotDisposed() { if (this.state === "disposed")
+        throw Object.assign(new Error("Browser capture session has been disposed."), { code: "session_disposed" }); }
+    failure(frameId, code, message) {
+        return { ok: false, error: sdkError(code, message), frameId, scenarioId: this.scenario.id, attemptCount: 0, timing: { totalMs: 0 } };
+    }
+}
+//# sourceMappingURL=browser-session.js.map