@scanly/core 2.0.0 → 2.0.1

package/README.md

@@ -1,3 +1,25 @@
-# @scanly/core
-
-Framework-independent SDK v2 preview contracts, bounded capture router, deterministic session lifecycle, and the migrated QR pipeline. It has no React or Next.js dependency. The default QR path currently supports QR Code Model 2 through jsQR and ZXing JavaScript; other format identifiers are capability vocabulary, not support claims.
+# @scanly/core
+
+`@scanly/core` is the framework-independent core for Scanly SDK v2.0.1. It provides frame/result/error contracts, engine and operator registries, `CaptureRouter`, sessions, tracking, batch, and bounded industrial recovery without React or Next.js dependencies.
+
+```bash
+npm install @scanly/core @scanly/engine-zxing-cpp-wasm
+```
+
+```ts
+import { CaptureRouter, EngineRegistry, createRgbaFrame } from "@scanly/core";
+import { createZxingCppWasmEngine } from "@scanly/engine-zxing-cpp-wasm";
+
+const engines = new EngineRegistry();
+engines.register(createZxingCppWasmEngine());
+const router = new CaptureRouter({ engines, formats: ["qr_code", "data_matrix"] });
+const frame = createRgbaFrame(rgba, width, height, { ownership: "borrowed" });
+const outcome = await router.scan(frame);
+await router.dispose();
+```
+
+The public format contract contains QR Code, Data Matrix, PDF417, Code 128, EAN-13, EAN-8, UPC-A, and UPC-E. Core does not bundle or register concrete decoders by itself; actual support depends on registered engine capabilities. Browser and Node packages provide the default engine composition.
+
+This is an advanced public package. Prefer `@scanly/browser`, `@scanly/node`, or `@scanly/react` for standard applications.
+
+Version: 2.0.1 · [SDK documentation](https://github.com/Yangjunjie-Lin/Scanly/blob/main/docs/sdk/usage.md)

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION: "2.0.0";
+export declare const SDK_VERSION: "2.0.1";
 export * from "./contracts/frame.js";
 export * from "./contracts/errors.js";
 export * from "./contracts/result.js";

package/dist/index.js

@@ -1,4 +1,4 @@
-export const SDK_VERSION = "2.0.0";
+export const SDK_VERSION = "2.0.1";
 export * from "./contracts/frame.js";
 export * from "./contracts/errors.js";
 export * from "./contracts/result.js";

package/dist/node.d.ts

@@ -1,2 +1,2 @@
-export { loadPixelBufferFromPath } from "./qr/image-loader-node.js";
+export { loadPixelBufferFromPath } from "./qr/image-loader-node.js";
 //# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -1,2 +1,2 @@
-export { loadPixelBufferFromPath } from "./qr/image-loader-node.js";
+export { loadPixelBufferFromPath } from "./qr/image-loader-node.js";
 //# sourceMappingURL=node.js.map

package/dist/qr/image-loader-node.d.ts

@@ -1,4 +1,4 @@
-import type { PixelBuffer } from "./types.js";
-/** Load an image path into RGBA PixelBuffer (Node). Honors EXIF orientation via sharp. */
-export declare function loadPixelBufferFromPath(filePath: string): Promise<PixelBuffer>;
+import type { PixelBuffer } from "./types.js";
+/** Load an image path into RGBA PixelBuffer (Node). Honors EXIF orientation via sharp. */
+export declare function loadPixelBufferFromPath(filePath: string): Promise<PixelBuffer>;
 //# sourceMappingURL=image-loader-node.d.ts.map

package/dist/qr/image-loader-node.js

@@ -1,26 +1,26 @@
-import sharp from "sharp";
-import { createPixelBuffer, flattenAlphaOntoWhite } from "./grayscale.js";
-/** Load an image path into RGBA PixelBuffer (Node). Honors EXIF orientation via sharp. */
-export async function loadPixelBufferFromPath(filePath) {
-    try {
-        const { data, info } = await sharp(filePath)
-            .rotate() // apply EXIF orientation
-            .ensureAlpha()
-            .raw()
-            .toBuffer({ resolveWithObject: true });
-        if (info.width < 1 || info.height < 1) {
-            throw Object.assign(new Error("Image has no pixel data."), { code: "empty_image" });
-        }
-        const buffer = createPixelBuffer(new Uint8ClampedArray(data.buffer, data.byteOffset, data.byteLength), info.width, info.height);
-        return flattenAlphaOntoWhite(buffer);
-    }
-    catch (e) {
-        if (e && typeof e === "object" && "code" in e)
-            throw e;
-        throw Object.assign(new Error("Unsupported or corrupted image."), {
-            code: "unsupported_image",
-            cause: e,
-        });
-    }
-}
+import sharp from "sharp";
+import { createPixelBuffer, flattenAlphaOntoWhite } from "./grayscale.js";
+/** Load an image path into RGBA PixelBuffer (Node). Honors EXIF orientation via sharp. */
+export async function loadPixelBufferFromPath(filePath) {
+    try {
+        const { data, info } = await sharp(filePath)
+            .rotate() // apply EXIF orientation
+            .ensureAlpha()
+            .raw()
+            .toBuffer({ resolveWithObject: true });
+        if (info.width < 1 || info.height < 1) {
+            throw Object.assign(new Error("Image has no pixel data."), { code: "empty_image" });
+        }
+        const buffer = createPixelBuffer(new Uint8ClampedArray(data.buffer, data.byteOffset, data.byteLength), info.width, info.height);
+        return flattenAlphaOntoWhite(buffer);
+    }
+    catch (e) {
+        if (e && typeof e === "object" && "code" in e)
+            throw e;
+        throw Object.assign(new Error("Unsupported or corrupted image."), {
+            code: "unsupported_image",
+            cause: e,
+        });
+    }
+}
 //# sourceMappingURL=image-loader-node.js.map

package/dist/qr/jsqr-decoder.d.ts

@@ -1,10 +1,10 @@
-import type { PixelBuffer } from "./types.js";
-export interface JsQRDecodeResult {
-    payload: string;
-    rawBytes: Uint8Array;
-}
-/**
- * Decode with jsQR. Uses attemptBoth by default; callers may pass invertFirst/onlyInvert.
- */
-export declare function decodeWithJsQR(buffer: PixelBuffer, inversionAttempts?: "dontInvert" | "onlyInvert" | "attemptBoth" | "invertFirst"): JsQRDecodeResult | null;
+import type { PixelBuffer } from "./types.js";
+export interface JsQRDecodeResult {
+    payload: string;
+    rawBytes: Uint8Array;
+}
+/**
+ * Decode with jsQR. Uses attemptBoth by default; callers may pass invertFirst/onlyInvert.
+ */
+export declare function decodeWithJsQR(buffer: PixelBuffer, inversionAttempts?: "dontInvert" | "onlyInvert" | "attemptBoth" | "invertFirst"): JsQRDecodeResult | null;
 //# sourceMappingURL=jsqr-decoder.d.ts.map

package/dist/qr/jsqr-decoder.js

@@ -1,18 +1,18 @@
-import jsQR from "jsqr";
-/**
- * Decode with jsQR. Uses attemptBoth by default; callers may pass invertFirst/onlyInvert.
- */
-export function decodeWithJsQR(buffer, inversionAttempts = "attemptBoth") {
-    if (buffer.width < 1 || buffer.height < 1)
-        return null;
-    try {
-        const code = jsQR(buffer.data, buffer.width, buffer.height, { inversionAttempts });
-        if (!code?.data)
-            return null;
-        return { payload: code.data, rawBytes: Uint8Array.from(code.binaryData) };
-    }
-    catch {
-        return null;
-    }
-}
+import jsQR from "jsqr";
+/**
+ * Decode with jsQR. Uses attemptBoth by default; callers may pass invertFirst/onlyInvert.
+ */
+export function decodeWithJsQR(buffer, inversionAttempts = "attemptBoth") {
+    if (buffer.width < 1 || buffer.height < 1)
+        return null;
+    try {
+        const code = jsQR(buffer.data, buffer.width, buffer.height, { inversionAttempts });
+        if (!code?.data)
+            return null;
+        return { payload: code.data, rawBytes: Uint8Array.from(code.binaryData) };
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=jsqr-decoder.js.map

package/dist/qr/zxing-decoder.d.ts

@@ -1,8 +1,8 @@
-import type { PixelBuffer } from "./types.js";
-export interface ZXingDecodeResult {
-    payload: string;
-    rawBytes?: Uint8Array;
-}
-/** Decode QR from RGBA pixel buffer using ZXing library (works in Node and browser). */
-export declare function decodeWithZXing(buffer: PixelBuffer): ZXingDecodeResult | null;
+import type { PixelBuffer } from "./types.js";
+export interface ZXingDecodeResult {
+    payload: string;
+    rawBytes?: Uint8Array;
+}
+/** Decode QR from RGBA pixel buffer using ZXing library (works in Node and browser). */
+export declare function decodeWithZXing(buffer: PixelBuffer): ZXingDecodeResult | null;
 //# sourceMappingURL=zxing-decoder.d.ts.map

package/dist/qr/zxing-decoder.js

@@ -1,33 +1,33 @@
-import { BinaryBitmap, HybridBinarizer, RGBLuminanceSource, DecodeHintType, BarcodeFormat, QRCodeReader, } from "@zxing/library";
-let reader = null;
-function getReader() {
-    if (!reader)
-        reader = new QRCodeReader();
-    return reader;
-}
-/** Decode QR from RGBA pixel buffer using ZXing library (works in Node and browser). */
-export function decodeWithZXing(buffer) {
-    if (buffer.width < 1 || buffer.height < 1)
-        return null;
-    try {
-        const luminance = new Uint8ClampedArray(buffer.width * buffer.height);
-        for (let i = 0, j = 0; i < buffer.data.length; i += 4, j++) {
-            luminance[j] = (buffer.data[i] * 0.299 + buffer.data[i + 1] * 0.587 + buffer.data[i + 2] * 0.114) | 0;
-        }
-        const source = new RGBLuminanceSource(luminance, buffer.width, buffer.height);
-        const bitmap = new BinaryBitmap(new HybridBinarizer(source));
-        const hints = new Map();
-        hints.set(DecodeHintType.POSSIBLE_FORMATS, [BarcodeFormat.QR_CODE]);
-        hints.set(DecodeHintType.TRY_HARDER, true);
-        const result = getReader().decode(bitmap, hints);
-        const text = result?.getText();
-        if (!text)
-            return null;
-        const rawBytes = result.getRawBytes();
-        return { payload: text, ...(rawBytes?.byteLength ? { rawBytes } : {}) };
-    }
-    catch {
-        return null;
-    }
-}
+import { BinaryBitmap, HybridBinarizer, RGBLuminanceSource, DecodeHintType, BarcodeFormat, QRCodeReader, } from "@zxing/library";
+let reader = null;
+function getReader() {
+    if (!reader)
+        reader = new QRCodeReader();
+    return reader;
+}
+/** Decode QR from RGBA pixel buffer using ZXing library (works in Node and browser). */
+export function decodeWithZXing(buffer) {
+    if (buffer.width < 1 || buffer.height < 1)
+        return null;
+    try {
+        const luminance = new Uint8ClampedArray(buffer.width * buffer.height);
+        for (let i = 0, j = 0; i < buffer.data.length; i += 4, j++) {
+            luminance[j] = (buffer.data[i] * 0.299 + buffer.data[i + 1] * 0.587 + buffer.data[i + 2] * 0.114) | 0;
+        }
+        const source = new RGBLuminanceSource(luminance, buffer.width, buffer.height);
+        const bitmap = new BinaryBitmap(new HybridBinarizer(source));
+        const hints = new Map();
+        hints.set(DecodeHintType.POSSIBLE_FORMATS, [BarcodeFormat.QR_CODE]);
+        hints.set(DecodeHintType.TRY_HARDER, true);
+        const result = getReader().decode(bitmap, hints);
+        const text = result?.getText();
+        if (!text)
+            return null;
+        const rawBytes = result.getRawBytes();
+        return { payload: text, ...(rawBytes?.byteLength ? { rawBytes } : {}) };
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=zxing-decoder.js.map

package/dist/runtime/builtin-operators.js

@@ -32,7 +32,7 @@ const MAX_MESSAGE_LENGTH = 512;
 function descriptor(id, accepts, produces, cpu = "low") {
     return {
         id,
-        version: "2.0.0",
+        version: "2.0.1",
         accepts,
         produces,
         configurationSchemaId: "https://scanly.dev/schema/scenario/2.1",

package/dist/runtime/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/runtime/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AACxG,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,CAAC;AACxD,MAAM,WAAW,qBAAqB;IAAG,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;CAAE;AAE3M,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAU;gBACxC,OAAO,GAAE,qBAA0B;IAQ/C,QAAQ,IAAI,mBAAmB;IAC/B,SAAS,IAAI,eAAe,GAAG,IAAI;IACnC,UAAU,IAAI,IAAI;IAIlB,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI;IAMrC,IAAI,IAAI,IAAI;IAMZ,MAAM,IAAI,IAAI;IAKd,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAQvD,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAOrC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAuB1F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,OAAO,CAAC,iBAAiB;IAGzB,OAAO,CAAC,gBAAgB;CAIzB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/runtime/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AACxG,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,CAAC;AACxD,MAAM,WAAW,qBAAqB;IAAG,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;CAAE;AAE3M,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAU;gBACxC,OAAO,GAAE,qBAA0B;IAQ/C,QAAQ,IAAI,mBAAmB;IAC/B,SAAS,IAAI,eAAe,GAAG,IAAI;IACnC,UAAU,IAAI,IAAI;IAIlB,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI;IAMrC,IAAI,IAAI,IAAI;IAMZ,MAAM,IAAI,IAAI;IAKd,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAQvD,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAOrC,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IA2B1F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,OAAO,CAAC,iBAAiB;IAGzB,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/runtime/session.js

@@ -77,14 +77,22 @@ export class CaptureSession {
         this.activeController = controller;
         const onAbort = () => controller.abort();
         options.signal?.addEventListener("abort", onAbort, { once: true });
+        if (options.signal?.aborted)
+            controller.abort();
         try {
+            if (controller.signal.aborted)
+                return this.lifecycleFailure(frame, "cancelled", "Capture cancelled before Router execution.", true);
             const outcome = await this.router.scan(frame, { signal: controller.signal });
+            if (controller.signal.aborted)
+                return this.lifecycleFailure(frame, "cancelled", "Capture cancelled.");
             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) {
+            if (controller.signal.aborted)
+                return this.lifecycleFailure(frame, "cancelled", "Capture cancelled.");
             this.state = "error";
             return this.lifecycleFailure(frame, "internal_invariant_failure", error instanceof Error ? error.message : String(error));
         }

package/dist/runtime/session.js.map

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

package/package.json

@@ -1,7 +1,17 @@
 {
   "name": "@scanly/core",
-  "version": "2.0.0",
-  "description": "UI-independent Scanly barcode capture contracts, router, session, and QR pipeline",
+  "version": "2.0.1",
+  "description": "Framework-independent barcode scanning contracts, router, sessions, tracking, batch, and recovery for Scanly SDK",
+  "keywords": ["barcode", "qr-code", "scanner", "typescript", "tracking", "scanly"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Yangjunjie-Lin/Scanly.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/Yangjunjie-Lin/Scanly#readme",
+  "bugs": {
+    "url": "https://github.com/Yangjunjie-Lin/Scanly/issues"
+  },
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -33,7 +43,7 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@scanly/parsers": "2.0.0",
-    "@scanly/scenario-schema": "2.0.0"
+    "@scanly/parsers": "2.0.1",
+    "@scanly/scenario-schema": "2.0.1"
   }
 }