@dejadex/web 0.0.0-stage → 0.1.1

package/dist/identify/assets.js

@@ -0,0 +1,167 @@
+/**
+ * Downloads of the manifest, the model and the shard: time-bounded, checked
+ * against the manifest's SHA-256 and size, and kept in the Cache API under
+ * their digest (content-addressed). A new manifest version downloads only the
+ * files whose digest changed; a corrupted cache entry is noticed on read,
+ * dropped and fetched again.
+ *
+ * The last manifest that loaded is cached too, so the device engine starts
+ * offline from a complete cache.
+ */
+import { ScannerError } from '../errors.js';
+/** The Cache API cache the SDK owns. Bump the suffix if the key scheme changes. */
+export const CACHE_NAME = 'dejadex-assets-v1';
+/** Keys are synthetic URLs; nothing is ever fetched from this origin. */
+const KEY_ORIGIN = 'https://cache.dejadex.invalid';
+/** Smallest download speed assumed when bounding a file's download (bytes/s). */
+const MIN_BYTES_PER_SECOND = 100_000;
+const MIN_FILE_TIMEOUT_MS = 30_000;
+export const MANIFEST_TIMEOUT_MS = 10_000;
+export async function sha256Hex(data) {
+    const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', data));
+    let out = '';
+    for (const b of digest)
+        out += b.toString(16).padStart(2, '0');
+    return out;
+}
+const fileKey = (sha256) => `${KEY_ORIGIN}/sha256/${sha256}`;
+const manifestKey = (url) => {
+    // A signed URL changes its query every time; the manifest it names does not.
+    const u = new URL(url);
+    return `${KEY_ORIGIN}/manifest/${encodeURIComponent(u.origin + u.pathname)}`;
+};
+/** `AbortSignal.any` where the runtime has it, else a controller following both. */
+export function anySignal(signals) {
+    const list = signals.filter((s) => s !== undefined);
+    if (list.length === 1)
+        return list[0];
+    if (typeof AbortSignal.any === 'function')
+        return AbortSignal.any(list);
+    const controller = new AbortController();
+    for (const s of list) {
+        if (s.aborted) {
+            controller.abort(s.reason);
+            break;
+        }
+        s.addEventListener('abort', () => controller.abort(s.reason), { once: true });
+    }
+    return controller.signal;
+}
+const errorText = (err) => (err instanceof Error ? err.message || err.name : String(err));
+export function createAssetStore(options) {
+    const { fetch: doFetch, cache } = options;
+    async function verified(buffer, file) {
+        return buffer.byteLength === file.size && (await sha256Hex(buffer)) === file.sha256;
+    }
+    async function download(file, signal) {
+        const timeoutMs = options.fileTimeoutMs ?? Math.max(MIN_FILE_TIMEOUT_MS, Math.ceil((file.size / MIN_BYTES_PER_SECOND) * 1000));
+        const bound = anySignal([AbortSignal.timeout(timeoutMs), signal]);
+        try {
+            // The body is read inside this try, so the bound covers it too.
+            const res = await doFetch(file.url, { signal: bound, cache: 'no-store' });
+            if (!res.ok)
+                throw new ScannerError('NETWORK', `${file.url} answered ${res.status}`);
+            return await res.arrayBuffer();
+        }
+        catch (err) {
+            if (err instanceof ScannerError)
+                throw err;
+            throw new ScannerError('NETWORK', `download of ${file.url} failed: ${errorText(err)}`, { cause: err });
+        }
+    }
+    return {
+        async get(file, signal) {
+            const key = fileKey(file.sha256);
+            if (cache) {
+                const hit = await cache.match(key).catch(() => undefined);
+                if (hit) {
+                    const buffer = await hit.arrayBuffer();
+                    if (await verified(buffer, file))
+                        return buffer;
+                    await cache.delete(key).catch(() => false);
+                }
+            }
+            // One retry: a truncated or corrupted transfer gets a second chance.
+            for (let attempt = 1;; attempt++) {
+                const buffer = await download(file, signal);
+                if (await verified(buffer, file)) {
+                    if (cache) {
+                        await cache
+                            .put(key, new Response(buffer.slice(0), { headers: { 'Content-Type': 'application/octet-stream' } }))
+                            .catch(() => undefined); // a full disk only costs the next start a download
+                    }
+                    return buffer;
+                }
+                if (attempt >= 2) {
+                    throw new ScannerError('MODEL_INTEGRITY', `${file.url} does not match its manifest checksum or size`);
+                }
+            }
+        },
+        async manifest(url, signal) {
+            const bound = anySignal([AbortSignal.timeout(MANIFEST_TIMEOUT_MS), signal]);
+            let networkError;
+            try {
+                const res = await doFetch(url, { signal: bound, cache: 'no-store' });
+                if (!res.ok)
+                    throw new ScannerError('NETWORK', `manifest ${url} answered ${res.status}`);
+                const text = await res.text();
+                let doc;
+                try {
+                    doc = JSON.parse(text);
+                }
+                catch {
+                    throw new ScannerError('MODEL_INTEGRITY', `manifest ${url} is not JSON`);
+                }
+                if (cache) {
+                    await cache.put(manifestKey(url), new Response(text, { headers: { 'Content-Type': 'application/json' } })).catch(() => undefined);
+                }
+                return doc;
+            }
+            catch (err) {
+                if (err instanceof ScannerError && err.code === 'MODEL_INTEGRITY')
+                    throw err;
+                if (signal?.aborted)
+                    throw err;
+                networkError = err;
+            }
+            // Offline (or the CDN is down): the last manifest that loaded from this URL.
+            const hit = cache ? await cache.match(manifestKey(url)).catch(() => undefined) : undefined;
+            if (hit)
+                return JSON.parse(await hit.text());
+            if (networkError instanceof ScannerError)
+                throw networkError;
+            throw new ScannerError('NETWORK', `manifest ${url} could not be fetched: ${errorText(networkError)}`, { cause: networkError });
+        },
+        async evictExcept(keep) {
+            if (!cache)
+                return 0;
+            const wanted = new Set(keep.map(fileKey));
+            let removed = 0;
+            for (const req of await cache.keys()) {
+                if (req.url.startsWith(`${KEY_ORIGIN}/sha256/`) && !wanted.has(req.url)) {
+                    if (await cache.delete(req.url))
+                        removed++;
+                }
+            }
+            return removed;
+        },
+    };
+}
+/** The page's Cache API cache, or null where there is none (or it is blocked). */
+export async function openDefaultCache() {
+    try {
+        if (typeof caches === 'undefined')
+            return null;
+        const c = await caches.open(CACHE_NAME);
+        return {
+            match: (key) => c.match(key),
+            put: (key, response) => c.put(key, response),
+            delete: (key) => c.delete(key),
+            keys: () => c.keys(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=assets.js.map

package/dist/identify/assets.js.map

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

package/dist/identify/decode.d.ts

@@ -0,0 +1,6 @@
+import type { PixelImage } from './preprocess.js';
+/** A crop this large is not one card; refuse it before allocating its pixels. */
+export declare const MAX_CROP_PIXELS = 40000000;
+export type CropDecoder = (crop: Blob) => Promise<PixelImage>;
+export declare const decodeCrop: CropDecoder;
+//# sourceMappingURL=decode.d.ts.map

package/dist/identify/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/identify/decode.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,iFAAiF;AACjF,eAAO,MAAM,eAAe,WAAa,CAAA;AAEzC,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;AAE7D,eAAO,MAAM,UAAU,EAAE,WAkBxB,CAAA"}

package/dist/identify/decode.js

@@ -0,0 +1,53 @@
+/**
+ * Crop `Blob` → pixels, in a Worker or on the main thread.
+ *
+ * Decoded without colour management (`colorSpaceConversion: 'none'`) and
+ * without premultiplied alpha, as the Python reference (PIL) reads a JPEG: an
+ * embedded ICC profile would otherwise shift every value the gallery was
+ * embedded from. JPEG decoders still differ by a unit here and there between
+ * libjpeg builds; that difference is the decoder's, not the resize's.
+ */
+import { ScannerError } from '../errors.js';
+/** A crop this large is not one card; refuse it before allocating its pixels. */
+export const MAX_CROP_PIXELS = 40_000_000;
+export const decodeCrop = async (crop) => {
+    if (typeof createImageBitmap !== 'function')
+        throw new ScannerError('UNSUPPORTED_DEVICE', 'createImageBitmap is not available');
+    let bitmap;
+    try {
+        bitmap = await createImageBitmap(crop, { colorSpaceConversion: 'none', premultiplyAlpha: 'none' });
+    }
+    catch (err) {
+        throw new ScannerError('INVALID_OPTIONS', 'a crop could not be decoded as an image', { cause: err });
+    }
+    try {
+        const { width, height } = bitmap;
+        if (width * height > MAX_CROP_PIXELS)
+            throw new ScannerError('INVALID_OPTIONS', `a crop of ${width}x${height} is too large`);
+        const ctx = context2d(width, height);
+        ctx.drawImage(bitmap, 0, 0);
+        const image = ctx.getImageData(0, 0, width, height);
+        return { width, height, channels: 4, data: image.data };
+    }
+    finally {
+        bitmap.close();
+    }
+};
+function context2d(width, height) {
+    const opts = { willReadFrequently: true, alpha: false };
+    if (typeof OffscreenCanvas !== 'undefined') {
+        const ctx = new OffscreenCanvas(width, height).getContext('2d', opts);
+        if (ctx)
+            return ctx;
+    }
+    if (typeof document !== 'undefined') {
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext('2d', opts);
+        if (ctx)
+            return ctx;
+    }
+    throw new ScannerError('UNSUPPORTED_DEVICE', 'no 2D canvas to decode crops with');
+}
+//# sourceMappingURL=decode.js.map

package/dist/identify/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../src/identify/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAA;AAIzC,MAAM,CAAC,MAAM,UAAU,GAAgB,KAAK,EAAE,IAAI,EAAE,EAAE;IACpD,IAAI,OAAO,iBAAiB,KAAK,UAAU;QAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,oCAAoC,CAAC,CAAA;IAC/H,IAAI,MAAmB,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAA;IACpG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,yCAAyC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IACtG,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;QAChC,IAAI,KAAK,GAAG,MAAM,GAAG,eAAe;YAAE,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,aAAa,KAAK,IAAI,MAAM,eAAe,CAAC,CAAA;QAC5H,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QACnD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;IACzD,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAA;IAChB,CAAC;AACH,CAAC,CAAA;AAID,SAAS,SAAS,CAAC,KAAa,EAAE,MAAc;IAC9C,MAAM,IAAI,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAW,CAAA;IAChE,IAAI,OAAO,eAAe,KAAK,WAAW,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACrE,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;IACrB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC/C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAoC,CAAA;QAC5E,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;IACrB,CAAC;IACD,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,mCAAmC,CAAC,CAAA;AACnF,CAAC"}

package/dist/identify/engine.d.ts

@@ -0,0 +1,32 @@
+import { type AssetStore } from './assets.js';
+import { type CropDecoder } from './decode.js';
+import { type Manifest } from './manifest.js';
+import { type RuntimeEnv, type RuntimeOptions } from './runtime.js';
+import type { DeviceEngineInfo, IdentifyResult } from './types.js';
+/** What the engine must load: plain data, so it crosses a Worker boundary. */
+export interface EngineConfig {
+    readonly manifestUrl: string;
+    /** The lease's versions and shard; a manifest that differs is refused. */
+    readonly expect: {
+        readonly modelVersion: string;
+        readonly indexVersion: string;
+        readonly shard: string;
+    };
+    readonly runtime: RuntimeOptions;
+}
+export interface DeviceEngine {
+    readonly info: DeviceEngineInfo;
+    identify(crops: readonly Blob[], top: number): Promise<IdentifyResult[]>;
+    release(): Promise<void>;
+}
+export interface EngineDeps {
+    readonly assets: AssetStore;
+    readonly runtimeEnv: RuntimeEnv;
+    readonly decode: CropDecoder;
+    readonly now: () => number;
+}
+export declare function defaultEngineDeps(): Promise<EngineDeps>;
+/** Checks the manifest against what the lease grants (versions are locked together). */
+export declare function checkManifestAgainstLease(manifest: Manifest, expect: EngineConfig['expect']): void;
+export declare function loadDeviceEngine(config: EngineConfig, deps: EngineDeps): Promise<DeviceEngine>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/identify/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/identify/engine.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsC,KAAK,UAAU,EAAkB,MAAM,aAAa,CAAA;AACjG,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE5D,OAAO,EAA4D,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAG7H,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAElE,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzG,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACxE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAA;CAC3B;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CAQ7D;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,IAAI,CAUlG;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAqCpG"}

package/dist/identify/engine.js

@@ -0,0 +1,127 @@
+/**
+ * The on-device identification engine: manifest → model session + shard →
+ * crops → answers. Runs wherever it is constructed; `worker.ts` runs it in a
+ * dedicated Worker (the default), `identifier.ts` talks to it through the
+ * `DeviceEngine` interface either way.
+ */
+import { ScannerError } from '../errors.js';
+import { createAssetStore, openDefaultCache } from './assets.js';
+import { decodeCrop } from './decode.js';
+import { parseManifest } from './manifest.js';
+import { preprocessCrop } from './preprocess.js';
+import { createEmbedBackend, defaultRuntimeEnv } from './runtime.js';
+import { decodeShard, parseIds } from './shard.js';
+import { toResult, topK } from './search.js';
+export async function defaultEngineDeps() {
+    const doFetch = (url, init) => fetch(url, init);
+    return {
+        assets: createAssetStore({ fetch: doFetch, cache: await openDefaultCache() }),
+        runtimeEnv: defaultRuntimeEnv(),
+        decode: decodeCrop,
+        now: () => performance.now(),
+    };
+}
+/** Checks the manifest against what the lease grants (versions are locked together). */
+export function checkManifestAgainstLease(manifest, expect) {
+    if (manifest.shard !== expect.shard) {
+        throw new ScannerError('DOMAIN_NOT_ALLOWED', `manifest is for shard ${manifest.shard}, the lease grants ${expect.shard}`);
+    }
+    if (manifest.modelVersion !== expect.modelVersion || manifest.indexVersion !== expect.indexVersion) {
+        throw new ScannerError('MODEL_INTEGRITY', `manifest is model ${manifest.modelVersion} / index ${manifest.indexVersion}, the lease is ${expect.modelVersion} / ${expect.indexVersion}`);
+    }
+}
+export async function loadDeviceEngine(config, deps) {
+    const { assets } = deps;
+    const manifest = parseManifest(await assets.manifest(config.manifestUrl), config.manifestUrl);
+    checkManifestAgainstLease(manifest, config.expect);
+    const [indexBytes, idsBytes] = await Promise.all([assets.get(manifest.index), assets.get(manifest.ids)]);
+    let idsDoc;
+    try {
+        idsDoc = JSON.parse(new TextDecoder().decode(idsBytes));
+    }
+    catch {
+        throw new ScannerError('MODEL_INTEGRITY', 'ids sidecar is not JSON');
+    }
+    const expectShard = {
+        domain: manifest.shard,
+        modelVersion: manifest.modelVersion,
+        indexVersion: manifest.indexVersion,
+        rows: manifest.rows,
+        dim: manifest.dims,
+    };
+    const shard = decodeShard(indexBytes, parseIds(idsDoc, expectShard), expectShard);
+    const used = [manifest.index.sha256, manifest.ids.sha256];
+    const backend = await createEmbedBackend(manifest, async (model) => {
+        used.push(model.sha256);
+        return assets.get(model);
+    }, config.runtime, deps.runtimeEnv);
+    // Older versions' files go only once this one has loaded.
+    await assets.evictExcept(used).catch(() => 0);
+    const engine = makeEngine(manifest, shard, backend, deps);
+    await engine.warmUp();
+    return engine;
+}
+function makeEngine(manifest, shard, backend, deps) {
+    const { width, height, mean, std, orientations } = manifest.preprocessing;
+    const norm = { mean, std };
+    const plane = 3 * width * height;
+    const perCrop = orientations.length;
+    const thresholds = { notACardBelow: manifest.notACardBelow, confidentMargin: manifest.confidentMargin };
+    let perCropMs = Number.NaN;
+    let released = false;
+    const info = () => ({
+        backend: backend.backend,
+        precision: backend.precision,
+        threads: backend.threads,
+        perCropMs,
+        modelVersion: manifest.modelVersion,
+        indexVersion: manifest.indexVersion,
+        shard: manifest.shard,
+        rows: shard.rows,
+    });
+    async function run(images, top) {
+        if (released)
+            throw new ScannerError('INVALID_OPTIONS', 'the device engine was released');
+        const n = images.length;
+        if (n === 0)
+            return [];
+        const input = new Float32Array(n * perCrop * plane);
+        images.forEach((img, i) => preprocessCrop(img, { width, height }, norm, orientations, input, i * perCrop * plane));
+        const emb = await backend.embed(input, n * perCrop);
+        const dims = manifest.dims;
+        const k = Math.max(top, 2);
+        const results = [];
+        for (let i = 0; i < n; i++) {
+            const queries = emb.subarray(i * perCrop * dims, (i + 1) * perCrop * dims);
+            results.push(toResult(i, topK(shard.matrix, dims, queries, k), shard.ids, top, thresholds));
+        }
+        return results;
+    }
+    return {
+        get info() {
+            return info();
+        },
+        async identify(crops, top) {
+            const images = await Promise.all(crops.map((c) => deps.decode(c)));
+            const t0 = deps.now();
+            const results = await run(images, top);
+            // Keep the per-crop time current: a device that heats up slows down.
+            const ms = (deps.now() - t0) / Math.max(1, crops.length);
+            perCropMs = Number.isFinite(perCropMs) ? perCropMs * 0.7 + ms * 0.3 : ms;
+            return results;
+        },
+        async warmUp() {
+            // The first run pays for shader compilation and allocation; time the second.
+            const blank = { width, height, channels: 3, data: new Uint8Array(width * height * 3) };
+            await run([blank], 2);
+            const t0 = deps.now();
+            await run([blank], 2);
+            perCropMs = deps.now() - t0;
+        },
+        async release() {
+            released = true;
+            await backend.release();
+        },
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/identify/engine.js.map

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

package/dist/identify/identifier.d.ts

@@ -0,0 +1,91 @@
+import { type Ed25519Verify, type LeasePublicKey } from '../lease/verify.js';
+import type { DomainCode, Lease, LeaseGrant, LeaseRequest } from '../types.js';
+import { type DrainResult } from '../usage/meter.js';
+import { type UsageStore } from '../usage/store.js';
+import { type DeviceEngine, type EngineConfig } from './engine.js';
+import type { RuntimeOptions } from './runtime.js';
+import { type ServerFetch } from './server.js';
+import { type DeviceEngineInfo, type IdentificationMode, type IdentifierStatus, type IdentifyCallOptions, type IdentifyOutcome } from './types.js';
+import { type WorkerLike } from './workerProtocol.js';
+import type { UsageBatch } from '../types.js';
+export interface IdentifierOptions {
+    /** The shard to identify against; the lease must grant it. */
+    readonly domain: DomainCode;
+    /** The service's lease-signing public keys (JWK `x`, optionally with `kid`). */
+    readonly leasePublicKeys: readonly LeasePublicKey[];
+    /** The first lease, as the host's backend returned it. Later ones go through `setLease`. */
+    readonly lease?: LeaseGrant;
+    /** Base URL of the identify route, `{serverUrl}/v1/identify`. Omit or null: the device only. */
+    readonly serverUrl?: string | null;
+    /** Default `auto`. `local` never sends an image. */
+    readonly identification?: IdentificationMode;
+    /** `auto` uses the server when the device takes longer than this per crop (no WebGPU). Default 300. */
+    readonly slowDeviceBudgetMs?: number;
+    /** The server's deadline while the device engine is not loaded yet. Default 8000. */
+    readonly serverTimeoutMs?: number;
+    readonly runtime?: RuntimeOptions;
+    /**
+     * Where the device engine runs: `worker` (default where `Worker` exists), `inline`
+     * (this thread; tests, or a host that already runs the SDK in its own Worker), or a
+     * factory for a Worker the host builds from `@dejadex/web/identify-worker`.
+     */
+    readonly engine?: 'worker' | 'inline' | (() => WorkerLike);
+    /** Download and warm the device engine as soon as a lease is set. Default true. */
+    readonly preload?: boolean;
+    /** The page origin the lease must allow. Default `location.origin`. */
+    readonly origin?: string | null;
+    /**
+     * Default IndexedDB (`dejadex-usage`), memory where it is unavailable. The
+     * default store is the identifier's own: `destroy()` closes it. A store passed
+     * here is the host's: `destroy()` leaves it open, and the host closes it.
+     */
+    readonly usageStore?: UsageStore;
+    /** Background failures (a device engine that failed to load). Never called from `identify`. */
+    readonly onError?: (error: Error) => void;
+    /** @internal Test seams. */
+    readonly fetch?: ServerFetch;
+    /** @internal */
+    readonly now?: () => number;
+    /** @internal */
+    readonly online?: () => boolean;
+    /** @internal */
+    readonly loadEngine?: (config: EngineConfig) => Promise<DeviceEngine>;
+    /** @internal */
+    readonly verify?: Ed25519Verify;
+}
+export interface Identifier {
+    /** At most 9 crops (JPEG for the server path). Always resolves. */
+    identify(crops: readonly Blob[], options?: IdentifyCallOptions): Promise<IdentifyOutcome>;
+    /** Verifies and installs a lease (rejects with a `ScannerError` when it is not valid here). */
+    setLease(grant: LeaseGrant): Promise<Lease>;
+    /** The identifier's own session id, used when a call names none. */
+    readonly session: string;
+    /** Starts a new default session: cards seen before are counted again. */
+    newSession(): string;
+    /** Loads (or awaits) the device engine for the current lease. */
+    prepare(): Promise<DeviceEngineInfo>;
+    status(): IdentifierStatus;
+    /** Hands queued usage to `deliver` (the host forwards it to its backend). See `UsageMeter.drain`. */
+    drainUsage(deliver: (batch: UsageBatch) => Promise<void>): Promise<DrainResult>;
+    pendingUsage(): Promise<number>;
+    /**
+     * The body the host sends its backend to renew: the current lease and the
+     * last report `seq` of it already delivered (null before the first lease).
+     * Drain usage first, or the service refuses the renewal (USAGE_UNREPORTED).
+     *
+     * `previousLeaseId` names another lease to renew instead: one the host
+     * stored but has not set here (it expired, or this page never identified).
+     * Null asks as a device with no lease.
+     */
+    leaseRequest(previousLeaseId?: string | null): Promise<LeaseRequest>;
+    /**
+     * Releases the device engine and its Worker, and closes the usage store the
+     * identifier opened itself (never one passed as `options.usageStore`). Later
+     * calls resolve `unavailable`, and the usage methods reject once that store
+     * is closed. Drain usage first: what is still queued stays on the device
+     * until a later identifier drains it or the host deletes `dejadex-usage`.
+     */
+    destroy(): Promise<void>;
+}
+export declare function createIdentifier(options: IdentifierOptions): Identifier;
+//# sourceMappingURL=identifier.d.ts.map

package/dist/identify/identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/identify/identifier.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAe,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC3F,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAuC,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AASvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAK7C,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAA;IACnD,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAA;IAC5C,uGAAuG;IACvG,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IACpC,qFAAqF;IACrF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,MAAM,UAAU,CAAC,CAAA;IAC1D,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAEzC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;IAC5B,gBAAgB;IAChB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,gBAAgB;IAChB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAA;IAC/B,gBAAgB;IAChB,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IACrE,gBAAgB;IAChB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IACzF,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,yEAAyE;IACzE,UAAU,IAAI,MAAM,CAAA;IACpB,iEAAiE;IACjE,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACpC,MAAM,IAAI,gBAAgB,CAAA;IAC1B,qGAAqG;IACrG,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC/E,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/B;;;;;;;;OAQG;IACH,YAAY,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACpE;;;;;;OAMG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAgDD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA8PvE"}