@scanly/core 2.0.0

package/dist/runtime/session.js

@@ -0,0 +1,117 @@
+import { validateScenario } from "@scanly/scenario-schema";
+import { SdkException, sdkError } from "../contracts/errors.js";
+import { DuplicateSuppressionPolicy } from "./result-policies.js";
+import { CaptureRouter } from "./router.js";
+export class CaptureSession {
+    state = "idle";
+    router;
+    concurrentPolicy;
+    activeController = null;
+    ownership = 0;
+    source = null;
+    ownsRouter;
+    duplicatePolicy;
+    applyDuplicateSuppression;
+    constructor(options = {}) {
+        this.router = options.router ?? new CaptureRouter({ scenario: options.scenario });
+        this.ownsRouter = options.disposeRouter ?? !options.router;
+        this.concurrentPolicy = options.concurrentCallPolicy ?? "replace";
+        this.applyDuplicateSuppression = options.applyDuplicateSuppression ?? true;
+        const scenario = options.scenario ?? this.router.getScenario();
+        this.duplicatePolicy = new DuplicateSuppressionPolicy(scenario.duplicateSuppression.enabled ? scenario.duplicateSuppression.windowMs : 0);
+    }
+    getState() { return this.state; }
+    getSource() { return this.source; }
+    initialize() {
+        this.assertNotDisposed();
+        if (this.state === "idle" || this.state === "stopped" || this.state === "error")
+            this.state = "initialized";
+    }
+    start(source) {
+        this.assertNotDisposed();
+        if (this.state === "idle")
+            this.initialize();
+        this.source = source ?? this.source;
+        this.state = "running";
+    }
+    stop() {
+        if (this.state === "disposed")
+            return;
+        this.cancel();
+        this.duplicatePolicy.clear();
+        this.state = "stopped";
+    }
+    cancel() {
+        this.ownership += 1;
+        this.activeController?.abort();
+        this.activeController = null;
+    }
+    updateConfiguration(scenario) {
+        this.assertNotDisposed();
+        const validated = validateScenario(scenario);
+        if (!validated.ok)
+            throw new SdkException(sdkError("malformed_scenario", validated.message));
+        this.cancel();
+        this.router.updateScenario(validated.value);
+        this.duplicatePolicy = new DuplicateSuppressionPolicy(validated.value.duplicateSuppression.enabled ? validated.value.duplicateSuppression.windowMs : 0);
+    }
+    switchSource(source) {
+        this.assertNotDisposed();
+        this.cancel();
+        this.source = source;
+        this.duplicatePolicy.clear();
+        if (this.state === "idle")
+            this.state = "initialized";
+    }
+    async scan(frame, options = {}) {
+        if (this.state === "disposed")
+            return this.lifecycleFailure(frame, "session_disposed", "Capture session has been disposed.", true);
+        if (this.state !== "running")
+            return this.lifecycleFailure(frame, "session_not_running", "Capture session must be started before scan().", true);
+        if (this.activeController && this.concurrentPolicy === "reject")
+            return this.lifecycleFailure(frame, "concurrent_call_rejected", "This session allows only one active scan.", true);
+        if (this.activeController)
+            this.cancel();
+        const owner = ++this.ownership;
+        const controller = new AbortController();
+        this.activeController = controller;
+        const onAbort = () => controller.abort();
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            const outcome = await this.router.scan(frame, { signal: controller.signal });
+            if (owner !== this.ownership)
+                return this.lifecycleFailure(frame, "cancelled", "Result belongs to a superseded session job.");
+            const continuous = this.source === "camera" || this.source === "video-frame" || this.source === "hardware-scanner";
+            return continuous && this.applyDuplicateSuppression ? this.duplicatePolicy.filter(outcome) : outcome;
+        }
+        catch (error) {
+            this.state = "error";
+            return this.lifecycleFailure(frame, "internal_invariant_failure", error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            options.signal?.removeEventListener("abort", onAbort);
+            if (this.activeController === controller)
+                this.activeController = null;
+        }
+    }
+    async dispose() {
+        if (this.state === "disposed")
+            return;
+        this.cancel();
+        this.duplicatePolicy.clear();
+        this.source = null;
+        this.state = "disposed";
+        if (this.ownsRouter)
+            await this.router.dispose();
+    }
+    assertNotDisposed() {
+        if (this.state === "disposed")
+            throw new SdkException(sdkError("session_disposed", "Capture session has been disposed."));
+    }
+    lifecycleFailure(frame, code, message, release = false) {
+        if (release && frame.ownership !== "borrowed")
+            frame.dispose?.();
+        return { ok: false, error: sdkError(code, message), frameId: frame.id, scenarioId: this.router.getScenario().id, attemptCount: 0, timing: { totalMs: 0 } };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/runtime/session.js.map

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

package/dist/runtime/validator-registry.d.ts

@@ -0,0 +1,11 @@
+import type { ResultValidator } from "../contracts/validator.js";
+export declare class ValidatorRegistry {
+    private readonly validators;
+    register(validator: ResultValidator, options?: {
+        replace?: boolean;
+    }): void;
+    unregister(id: string): void;
+    get(id: string): ResultValidator | undefined;
+    list(): readonly ResultValidator[];
+}
+//# sourceMappingURL=validator-registry.d.ts.map

package/dist/runtime/validator-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/validator-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IAEjE,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAQ/E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAC5C,IAAI,IAAI,SAAS,eAAe,EAAE;CACnC"}

package/dist/runtime/validator-registry.js

@@ -0,0 +1,16 @@
+import { SdkException, sdkError } from "../contracts/errors.js";
+export class ValidatorRegistry {
+    validators = new Map();
+    register(validator, options = {}) {
+        if (!validator.id.trim())
+            throw new SdkException(sdkError("invalid_configuration", "Validator id must be non-empty."));
+        if (this.validators.has(validator.id) && !options.replace) {
+            throw new SdkException(sdkError("invalid_configuration", `Validator '${validator.id}' is already registered.`, { validatorId: validator.id }));
+        }
+        this.validators.set(validator.id, validator);
+    }
+    unregister(id) { this.validators.delete(id); }
+    get(id) { return this.validators.get(id); }
+    list() { return Object.freeze([...this.validators.values()]); }
+}
+//# sourceMappingURL=validator-registry.js.map

package/dist/runtime/validator-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-registry.js","sourceRoot":"","sources":["../../src/runtime/validator-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGhE,MAAM,OAAO,iBAAiB;IACX,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEjE,QAAQ,CAAC,SAA0B,EAAE,UAAiC,EAAE;QACtE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,uBAAuB,EAAE,iCAAiC,CAAC,CAAC,CAAC;QACvH,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1D,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,uBAAuB,EAAE,cAAc,SAAS,CAAC,EAAE,0BAA0B,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACjJ,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,UAAU,CAAC,EAAU,IAAU,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,GAAG,CAAC,EAAU,IAAiC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChF,IAAI,KAAiC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5F"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@scanly/core",
+  "version": "2.0.0",
+  "description": "UI-independent Scanly barcode capture contracts, router, session, and QR pipeline",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./qr": {
+      "types": "./dist/qr/index.d.ts",
+      "import": "./dist/qr/index.js"
+    },
+    "./barcode": {
+      "types": "./dist/barcode/index.d.ts",
+      "import": "./dist/barcode/index.js"
+    },
+    "./industrial": {
+      "types": "./dist/industrial/index.d.ts",
+      "import": "./dist/industrial/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@scanly/parsers": "2.0.0",
+    "@scanly/scenario-schema": "2.0.0"
+  }
+}