pi-kiosk-shared 2.3.3 → 2.3.6

package/dist/checkout/sessionMetadataV5.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Read-only v5 session-metadata contract for kiosk/customer/PWA consumers.
+ *
+ * SSOT for upgrade/merge/payment resolution: `up-backend/src/application/services/checkout/sessionMetadataCompat.ts`
+ * and `up-backend/src/domain/types/checkout/sessionMetadataV5.ts` (domain guard only).
+ * Shared package = type mirror for future consumers; kiosk/customer re-export via `pi-kiosk-shared`.
+ * Keep field names and optionality in sync with ADR-006 when backend evolves.
+ */
+import type { SessionMetadataCheckoutMode, SessionMetadataCollect, SessionMetadataShopLine } from './sessionMetadataV3.js';
+import type { SessionMetadataLoyaltyV4 } from './sessionMetadataV4.js';
+export type PromoStackingMode = 'EXCLUSIVE' | 'STACK_PROMO_THEN_LOYALTY';
+/**
+ * How the activated promo reward entered checkout.
+ * MANUAL_CODE = typed apply-code path (reward metadata.source mirror).
+ * WALLET_REWARD = customer/kiosk wallet activate path.
+ */
+export type PromoActivationSource = 'MANUAL_CODE' | 'WALLET_REWARD';
+export interface SessionMetadataShopV5 {
+    salesPointId: number;
+    lines: SessionMetadataShopLine[];
+}
+export interface SessionMetadataPromotionsV5 {
+    readonly activatedPromoRewardId?: string | null;
+    readonly stackingMode?: PromoStackingMode;
+    readonly activatedAt?: string | null;
+    readonly ruleVersionId?: string | null;
+    /** Typed apply-code vs wallet activation (plan MANUAL_CODE instrument bridge). */
+    readonly source?: PromoActivationSource | null;
+    /** Bound promo event when known (display / AUTO_DEAL suppress). */
+    readonly eventId?: string | null;
+}
+export interface SessionMetadataEnvelopeV5 {
+    version: 5;
+    collect?: SessionMetadataCollect;
+    checkoutMode?: SessionMetadataCheckoutMode;
+    shop?: SessionMetadataShopV5;
+    loyalty?: SessionMetadataLoyaltyV4;
+    promotions?: SessionMetadataPromotionsV5;
+}
+export declare function isSessionMetadataV5(value: unknown): value is SessionMetadataEnvelopeV5;
+/** Channel/mode matrix — throws on invalid combinations (inherits v4 rules). */
+export declare function assertSessionMetadataV5ChannelRules(envelope: SessionMetadataEnvelopeV5): void;
+export declare function upgradeSessionMetadataV4ToV5(envelope: {
+    version: 4;
+} & Omit<SessionMetadataEnvelopeV5, 'version'>): SessionMetadataEnvelopeV5;
+//# sourceMappingURL=sessionMetadataV5.d.ts.map

package/dist/checkout/sessionMetadataV5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionMetadataV5.d.ts","sourceRoot":"","sources":["../../src/checkout/sessionMetadataV5.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,0BAA0B,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,eAAe,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,uBAAuB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC/C,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,YAAY,CAAC,EAAE,2BAA2B,CAAC;IAC3C,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAMtF;AAED,gFAAgF;AAChF,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CA+B7F;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,GACpE,yBAAyB,CAM3B"}

package/dist/checkout/sessionMetadataV5.js

@@ -0,0 +1,40 @@
+export function isSessionMetadataV5(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.version === 5);
+}
+/** Channel/mode matrix — throws on invalid combinations (inherits v4 rules). */
+export function assertSessionMetadataV5ChannelRules(envelope) {
+    const mode = envelope.checkoutMode;
+    if (mode === undefined) {
+        return;
+    }
+    if (mode.channel === 'MOBILE_FIRST' &&
+        mode.selectedMode !== 'PREPAY_COLLECT_LATER' &&
+        mode.selectedMode !== 'PAY_NOW_SELF_SERVICE') {
+        throw new Error('SESSION_METADATA_V5_MOBILE_MODE_INVALID');
+    }
+    if (mode.channel === 'KIOSK_FIRST' && mode.selectedMode === 'PREPAY_COLLECT_LATER') {
+        throw new Error('SESSION_METADATA_V5_KIOSK_MODE_INVALID');
+    }
+    if (envelope.collect !== undefined) {
+        if (mode.channel === 'MOBILE_FIRST' &&
+            mode.selectedMode === 'PREPAY_COLLECT_LATER' &&
+            envelope.collect.timing !== 'LATER') {
+            throw new Error('SESSION_METADATA_V5_MOBILE_COLLECT_TIMING_INVALID');
+        }
+        if (mode.channel === 'MOBILE_FIRST' &&
+            mode.selectedMode === 'PAY_NOW_SELF_SERVICE' &&
+            envelope.collect.timing !== 'NOW') {
+            throw new Error('SESSION_METADATA_V5_MOBILE_COLLECT_TIMING_INVALID');
+        }
+    }
+}
+export function upgradeSessionMetadataV4ToV5(envelope) {
+    return {
+        ...envelope,
+        version: 5,
+        promotions: envelope.promotions ?? {},
+    };
+}
+//# sourceMappingURL=sessionMetadataV5.js.map

package/dist/checkout/sessionMetadataV5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionMetadataV5.js","sourceRoot":"","sources":["../../src/checkout/sessionMetadataV5.ts"],"names":[],"mappings":"AAiDA,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAmC,CAAC,OAAO,KAAK,CAAC,CACnD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mCAAmC,CAAC,QAAmC;IACrF,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,IACE,IAAI,CAAC,OAAO,KAAK,cAAc;QAC/B,IAAI,CAAC,YAAY,KAAK,sBAAsB;QAC5C,IAAI,CAAC,YAAY,KAAK,sBAAsB,EAC5C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,aAAa,IAAI,IAAI,CAAC,YAAY,KAAK,sBAAsB,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,IACE,IAAI,CAAC,OAAO,KAAK,cAAc;YAC/B,IAAI,CAAC,YAAY,KAAK,sBAAsB;YAC5C,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO,EACnC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IACE,IAAI,CAAC,OAAO,KAAK,cAAc;YAC/B,IAAI,CAAC,YAAY,KAAK,sBAAsB;YAC5C,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,EACjC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAqE;IAErE,OAAO;QACL,GAAG,QAAQ;QACX,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,EAAE;KACtC,CAAC;AACJ,CAAC"}

package/dist/errors/pickLocalizedApiMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pick one language from CS-first API messages shaped as `CS / EN` or `CS / SK / EN`.
+ * Non-matching strings (no slash segments, or >3 parts) are returned unchanged.
+ */
+export declare function pickLocalizedApiMessage(message: string, locale: string | undefined): string;
+//# sourceMappingURL=pickLocalizedApiMessage.d.ts.map

package/dist/errors/pickLocalizedApiMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickLocalizedApiMessage.d.ts","sourceRoot":"","sources":["../../src/errors/pickLocalizedApiMessage.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CA2BR"}

package/dist/errors/pickLocalizedApiMessage.js

@@ -0,0 +1,31 @@
+import { normalizeLabelLocale } from '../labels/localizedLabel.js';
+/**
+ * Pick one language from CS-first API messages shaped as `CS / EN` or `CS / SK / EN`.
+ * Non-matching strings (no slash segments, or >3 parts) are returned unchanged.
+ */
+export function pickLocalizedApiMessage(message, locale) {
+    const trimmed = message.trim();
+    if (trimmed.length === 0) {
+        return message;
+    }
+    const parts = trimmed.split(' / ').map((part) => part.trim()).filter((part) => part.length > 0);
+    if (parts.length < 2 || parts.length > 3) {
+        return message;
+    }
+    const loc = normalizeLabelLocale(locale);
+    if (parts.length === 3) {
+        if (loc === 'cs') {
+            return parts[0];
+        }
+        if (loc === 'sk') {
+            return parts[1];
+        }
+        return parts[2];
+    }
+    // Legacy bilingual `CS / EN`
+    if (loc === 'en') {
+        return parts[1];
+    }
+    return parts[0];
+}
+//# sourceMappingURL=pickLocalizedApiMessage.js.map

package/dist/errors/pickLocalizedApiMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickLocalizedApiMessage.js","sourceRoot":"","sources":["../../src/errors/pickLocalizedApiMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,6BAA6B,CAAC;AAErF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,MAA0B;IAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,GAAG,GAAgB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;QACnB,CAAC;QACD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,CAAC;IAED,6BAA6B;IAC7B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;AACnB,CAAC"}

package/dist/hooks/scannerCameraConstraints.d.ts

@@ -0,0 +1,57 @@
+/**
+ * High-sensitivity camera constraints for live barcode / QR decode.
+ * Prefer rear camera + high ideal resolution so small symbols fill pixels.
+ *
+ * Do not set hard `min` width/height - Android Chrome often rejects those with
+ * OverconstrainedError. Some Android builds also surface soft-constraint failure
+ * as NotAllowedError; the ladder retries NotAllowed only until the final
+ * `video: true` rung (a true user deny there is not retried).
+ */
+export declare const SCANNER_VIDEO_CONSTRAINTS: MediaTrackConstraints;
+/**
+ * Progressive getUserMedia ladder for mobile browsers.
+ * Soften resolution first, then facingMode-only, then any camera.
+ */
+export declare const SCANNER_VIDEO_CONSTRAINT_FALLBACKS: ReadonlyArray<MediaTrackConstraints | true>;
+/**
+ * Optical zoom policy for scanner tracks: use the device's capability max
+ * (not a hard 2x ceiling). Documented for callers; resolution is via
+ * resolvePreferredOpticalZoom.
+ */
+export declare const SCANNER_OPTICAL_ZOOM_POLICY: "max";
+/**
+ * Resolve preferred optical zoom from MediaTrackCapabilities.zoom bounds.
+ * Targets device max (G2) - no fixed 2x ceiling. Snaps down to a valid step
+ * when `step` is provided.
+ */
+export declare function resolvePreferredOpticalZoom(min: number, max: number, step?: number): number;
+/**
+ * Midpoint zoom for a stepped ladder toward max (G4 distance lever).
+ * Snaps to step when provided.
+ */
+export declare function resolveMidOpticalZoom(min: number, maxTarget: number, step?: number): number;
+/**
+ * Open a camera stream with progressive constraint fallbacks.
+ *
+ * Overconstrained / NotFound / NotReadable / Abort -> next rung.
+ * NotAllowedError -> next rung only while `video` is not yet the final `true`
+ * (any-camera) rung; on that last rung NotAllowed is a real deny and is rethrown.
+ * Other failures (SecurityError, etc.) are rethrown immediately.
+ */
+export declare function openScannerMediaStream(getUserMedia: MediaDevices['getUserMedia']): Promise<MediaStream>;
+/**
+ * Best-effort continuous autofocus + torch after getUserMedia.
+ * Optical zoom is NOT applied here — max zoom on open blurs/crops close barcodes
+ * (camera shows a sharp code but @zxing never locks). The hook applies
+ * {@link applyScannerDistanceZoom} only after multi-pass has already started
+ * (second assist window), never at open and never at the first assist tick.
+ */
+export declare function applyScannerTrackEnhancements(track: MediaStreamTrack): Promise<void>;
+/**
+ * Delayed distance lever (G2/G4): mid → max optical zoom from capabilities.
+ * Hook policy: call only after SCANNER_DISTANCE_ASSIST_DELAY_MS (multi-pass first)
+ * plus SCANNER_DISTANCE_ZOOM_DELAY_MS — never on open and never at the first
+ * assist tick, so close codes with slow AF are not forced into max zoom.
+ */
+export declare function applyScannerDistanceZoom(track: MediaStreamTrack): Promise<void>;
+//# sourceMappingURL=scannerCameraConstraints.d.ts.map

package/dist/hooks/scannerCameraConstraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scannerCameraConstraints.d.ts","sourceRoot":"","sources":["../../src/hooks/scannerCameraConstraints.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,EAAE,qBAKvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kCAAkC,EAAE,aAAa,CAAC,qBAAqB,GAAG,IAAI,CAS1F,CAAC;AAqBF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAG,KAAc,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAWR;AAmBD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,GACzC,OAAO,CAAC,WAAW,CAAC,CAqBtB;AAED;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B1F;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDrF"}

package/dist/hooks/scannerCameraConstraints.js

@@ -0,0 +1,195 @@
+/**
+ * High-sensitivity camera constraints for live barcode / QR decode.
+ * Prefer rear camera + high ideal resolution so small symbols fill pixels.
+ *
+ * Do not set hard `min` width/height - Android Chrome often rejects those with
+ * OverconstrainedError. Some Android builds also surface soft-constraint failure
+ * as NotAllowedError; the ladder retries NotAllowed only until the final
+ * `video: true` rung (a true user deny there is not retried).
+ */
+export const SCANNER_VIDEO_CONSTRAINTS = {
+    facingMode: { ideal: 'environment' },
+    width: { ideal: 1920 },
+    height: { ideal: 1080 },
+    frameRate: { ideal: 30 },
+};
+/**
+ * Progressive getUserMedia ladder for mobile browsers.
+ * Soften resolution first, then facingMode-only, then any camera.
+ */
+export const SCANNER_VIDEO_CONSTRAINT_FALLBACKS = [
+    SCANNER_VIDEO_CONSTRAINTS,
+    {
+        facingMode: { ideal: 'environment' },
+        width: { ideal: 1280 },
+        height: { ideal: 720 },
+    },
+    { facingMode: { ideal: 'environment' } },
+    true,
+];
+/**
+ * Optical zoom policy for scanner tracks: use the device's capability max
+ * (not a hard 2x ceiling). Documented for callers; resolution is via
+ * resolvePreferredOpticalZoom.
+ */
+export const SCANNER_OPTICAL_ZOOM_POLICY = 'max';
+/**
+ * Resolve preferred optical zoom from MediaTrackCapabilities.zoom bounds.
+ * Targets device max (G2) - no fixed 2x ceiling. Snaps down to a valid step
+ * when `step` is provided.
+ */
+export function resolvePreferredOpticalZoom(min, max, step) {
+    if (!(max > min)) {
+        return min;
+    }
+    if (step !== undefined && step > 0) {
+        const stepsFromMin = Math.floor((max - min) / step + Number.EPSILON);
+        return min + stepsFromMin * step;
+    }
+    return max;
+}
+/**
+ * Midpoint zoom for a stepped ladder toward max (G4 distance lever).
+ * Snaps to step when provided.
+ */
+export function resolveMidOpticalZoom(min, maxTarget, step) {
+    if (!(maxTarget > min)) {
+        return min;
+    }
+    const mid = (min + maxTarget) / 2;
+    if (step !== undefined && step > 0) {
+        const stepsFromMin = Math.round((mid - min) / step);
+        const snapped = min + stepsFromMin * step;
+        return Math.min(maxTarget, Math.max(min, snapped));
+    }
+    return mid;
+}
+function isConstraintRetryableError(err) {
+    if (!(err instanceof DOMException)) {
+        return false;
+    }
+    return (err.name === 'OverconstrainedError' ||
+        err.name === 'ConstraintNotSatisfiedError' ||
+        err.name === 'NotFoundError' ||
+        err.name === 'NotReadableError' ||
+        err.name === 'AbortError');
+}
+function isNotAllowedError(err) {
+    return err instanceof DOMException && err.name === 'NotAllowedError';
+}
+/**
+ * Open a camera stream with progressive constraint fallbacks.
+ *
+ * Overconstrained / NotFound / NotReadable / Abort -> next rung.
+ * NotAllowedError -> next rung only while `video` is not yet the final `true`
+ * (any-camera) rung; on that last rung NotAllowed is a real deny and is rethrown.
+ * Other failures (SecurityError, etc.) are rethrown immediately.
+ */
+export async function openScannerMediaStream(getUserMedia) {
+    let lastError;
+    for (let i = 0; i < SCANNER_VIDEO_CONSTRAINT_FALLBACKS.length; i++) {
+        const video = SCANNER_VIDEO_CONSTRAINT_FALLBACKS[i];
+        try {
+            return await getUserMedia({ video, audio: false });
+        }
+        catch (err) {
+            lastError = err;
+            if (isConstraintRetryableError(err)) {
+                continue;
+            }
+            // Soft-constraint NotAllowed: retry until final any-camera rung only.
+            if (isNotAllowedError(err) && video !== true) {
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw lastError instanceof Error
+        ? lastError
+        : new Error('Could not open scanner camera', { cause: lastError });
+}
+/**
+ * Best-effort continuous autofocus + torch after getUserMedia.
+ * Optical zoom is NOT applied here — max zoom on open blurs/crops close barcodes
+ * (camera shows a sharp code but @zxing never locks). The hook applies
+ * {@link applyScannerDistanceZoom} only after multi-pass has already started
+ * (second assist window), never at open and never at the first assist tick.
+ */
+export async function applyScannerTrackEnhancements(track) {
+    const getCapabilities = track.getCapabilities;
+    if (getCapabilities === undefined) {
+        return;
+    }
+    const capabilities = getCapabilities.call(track);
+    const hasContinuousFocus = capabilities.focusMode?.includes('continuous') === true;
+    const hasTorch = capabilities.torch === true;
+    if (!hasContinuousFocus && !hasTorch) {
+        return;
+    }
+    const advanced = [];
+    if (hasContinuousFocus) {
+        advanced.push({ focusMode: 'continuous' });
+    }
+    if (hasTorch) {
+        advanced.push({ torch: true });
+    }
+    try {
+        const next = { advanced };
+        await track.applyConstraints(next);
+    }
+    catch {
+        // Device rejected advanced focus/torch — keep the stream as opened.
+    }
+}
+/**
+ * Delayed distance lever (G2/G4): mid → max optical zoom from capabilities.
+ * Hook policy: call only after SCANNER_DISTANCE_ASSIST_DELAY_MS (multi-pass first)
+ * plus SCANNER_DISTANCE_ZOOM_DELAY_MS — never on open and never at the first
+ * assist tick, so close codes with slow AF are not forced into max zoom.
+ */
+export async function applyScannerDistanceZoom(track) {
+    const getCapabilities = track.getCapabilities;
+    if (getCapabilities === undefined) {
+        return;
+    }
+    const capabilities = getCapabilities.call(track);
+    const zoomCap = capabilities.zoom;
+    if (zoomCap === undefined) {
+        return;
+    }
+    const zoomMin = zoomCap.min ?? 1;
+    const zoomMax = zoomCap.max ?? 1;
+    const zoomStep = zoomCap.step;
+    if (!(zoomMax > zoomMin)) {
+        return;
+    }
+    const preferredZoom = resolvePreferredOpticalZoom(zoomMin, zoomMax, zoomStep);
+    if (!(preferredZoom > zoomMin)) {
+        return;
+    }
+    const midZoom = resolveMidOpticalZoom(zoomMin, preferredZoom, zoomStep);
+    const useZoomLadder = midZoom > zoomMin && midZoom < preferredZoom;
+    try {
+        if (useZoomLadder) {
+            await track.applyConstraints({
+                advanced: [{ zoom: midZoom }],
+            });
+            try {
+                await track.applyConstraints({
+                    advanced: [{ zoom: preferredZoom }],
+                });
+            }
+            catch {
+                // Max rejected after mid — keep mid.
+            }
+            return;
+        }
+        await track.applyConstraints({
+            advanced: [{ zoom: preferredZoom }],
+        });
+    }
+    catch {
+        // Zoom unsupported after open — keep current stream.
+    }
+}
+//# sourceMappingURL=scannerCameraConstraints.js.map

package/dist/hooks/scannerCameraConstraints.js.map

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

package/dist/hooks/scannerFormats.d.ts

@@ -0,0 +1,11 @@
+import { BarcodeFormat } from '@zxing/library';
+export type BarcodeScannerFormatProfile = 'retail' | 'qr-only' | 'all';
+export declare const REQUIRED_NATIVE_FORMATS_RETAIL: readonly ["code_128", "ean_13", "ean_8", "upc_a"];
+export declare const REQUIRED_NATIVE_FORMATS_QR_ONLY: readonly ["qr_code"];
+export declare const REQUIRED_NATIVE_FORMATS_ALL: readonly ["code_128", "ean_13", "ean_8", "upc_a", "qr_code"];
+export interface ScannerFormatConfig {
+    readonly nativeFormats: readonly string[];
+    readonly zxingFormats: readonly BarcodeFormat[];
+}
+export declare function resolveScannerFormatConfig(formatProfile?: BarcodeScannerFormatProfile): ScannerFormatConfig;
+//# sourceMappingURL=scannerFormats.d.ts.map

package/dist/hooks/scannerFormats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scannerFormats.d.ts","sourceRoot":"","sources":["../../src/hooks/scannerFormats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAEvE,eAAO,MAAM,8BAA8B,mDAKjC,CAAC;AAEX,eAAO,MAAM,+BAA+B,sBAAuB,CAAC;AAEpE,eAAO,MAAM,2BAA2B,8DAG9B,CAAC;AAaX,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;CACjD;AAED,wBAAgB,0BAA0B,CACxC,aAAa,GAAE,2BAAsC,GACpD,mBAAmB,CAiBrB"}

package/dist/hooks/scannerFormats.js

@@ -0,0 +1,39 @@
+import { BarcodeFormat } from '@zxing/library';
+export const REQUIRED_NATIVE_FORMATS_RETAIL = [
+    'code_128',
+    'ean_13',
+    'ean_8',
+    'upc_a',
+];
+export const REQUIRED_NATIVE_FORMATS_QR_ONLY = ['qr_code'];
+export const REQUIRED_NATIVE_FORMATS_ALL = [
+    ...REQUIRED_NATIVE_FORMATS_RETAIL,
+    'qr_code',
+];
+const ZXING_RETAIL_FORMATS = [
+    BarcodeFormat.CODE_128,
+    BarcodeFormat.EAN_13,
+    BarcodeFormat.EAN_8,
+    BarcodeFormat.UPC_A,
+];
+const ZXING_QR_ONLY_FORMATS = [BarcodeFormat.QR_CODE];
+const ZXING_ALL_FORMATS = [...ZXING_RETAIL_FORMATS, BarcodeFormat.QR_CODE];
+export function resolveScannerFormatConfig(formatProfile = 'retail') {
+    if (formatProfile === 'qr-only') {
+        return {
+            nativeFormats: REQUIRED_NATIVE_FORMATS_QR_ONLY,
+            zxingFormats: ZXING_QR_ONLY_FORMATS,
+        };
+    }
+    if (formatProfile === 'all') {
+        return {
+            nativeFormats: REQUIRED_NATIVE_FORMATS_ALL,
+            zxingFormats: ZXING_ALL_FORMATS,
+        };
+    }
+    return {
+        nativeFormats: REQUIRED_NATIVE_FORMATS_RETAIL,
+        zxingFormats: ZXING_RETAIL_FORMATS,
+    };
+}
+//# sourceMappingURL=scannerFormats.js.map

package/dist/hooks/scannerFormats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scannerFormats.js","sourceRoot":"","sources":["../../src/hooks/scannerFormats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,UAAU;IACV,QAAQ;IACR,OAAO;IACP,OAAO;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,SAAS,CAAU,CAAC;AAEpE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,GAAG,8BAA8B;IACjC,SAAS;CACD,CAAC;AAEX,MAAM,oBAAoB,GAAoB;IAC5C,aAAa,CAAC,QAAQ;IACtB,aAAa,CAAC,MAAM;IACpB,aAAa,CAAC,KAAK;IACnB,aAAa,CAAC,KAAK;CACpB,CAAC;AAEF,MAAM,qBAAqB,GAAoB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAEvE,MAAM,iBAAiB,GAAoB,CAAC,GAAG,oBAAoB,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;AAO5F,MAAM,UAAU,0BAA0B,CACxC,gBAA6C,QAAQ;IAErD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO;YACL,aAAa,EAAE,+BAA+B;YAC9C,YAAY,EAAE,qBAAqB;SACpC,CAAC;IACJ,CAAC;IACD,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO;YACL,aAAa,EAAE,2BAA2B;YAC1C,YAAY,EAAE,iBAAiB;SAChC,CAAC;IACJ,CAAC;IACD,OAAO;QACL,aAAa,EAAE,8BAA8B;QAC7C,YAAY,EAAE,oBAAoB;KACnC,CAAC;AACJ,CAAC"}

package/dist/hooks/scannerNativeTypes.d.ts

@@ -0,0 +1,18 @@
+export interface NativeBarcodeDetector {
+    detect: (source: CanvasImageSource) => Promise<Array<{
+        rawValue: string;
+    }>>;
+}
+export interface NativeBarcodeDetectorConstructor {
+    new (init?: {
+        formats?: string[];
+    }): NativeBarcodeDetector;
+    getSupportedFormats: () => Promise<string[]>;
+}
+declare global {
+    interface Window {
+        BarcodeDetector?: NativeBarcodeDetectorConstructor;
+    }
+}
+export {};
+//# sourceMappingURL=scannerNativeTypes.d.ts.map

package/dist/hooks/scannerNativeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scannerNativeTypes.d.ts","sourceRoot":"","sources":["../../src/hooks/scannerNativeTypes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,qBAAqB,CAAC;IAC3D,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,eAAe,CAAC,EAAE,gCAAgC,CAAC;KACpD;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/hooks/scannerNativeTypes.js

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

package/dist/hooks/scannerNativeTypes.js.map

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

package/dist/hooks/scannerPlatformProfile.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Platform-specific scanner engine ordering and UX hints.
+ * Firefox: ZBar WASM + @zxing only — no @undecaf/barcode-detector-polyfill package.
+ */
+export type ScannerPlatformProfileId = 'chrome-android' | 'chrome-desktop' | 'ios-safari' | 'crios-ios' | 'firefox-desktop' | 'generic';
+export interface ScannerPlatformProfile {
+    readonly id: ScannerPlatformProfileId;
+    /** Prefer preview snap CTA over live-only decode (PC webcams). */
+    readonly preferPreviewSnap: boolean;
+    /** Run Chromium BarcodeDetector when probe succeeds. */
+    readonly nativeEnabled: boolean;
+    /** ZBar full pass every frame (desktop); mobile uses budget backoff in hook. */
+    readonly zbarFullPassEveryFrame: boolean;
+    /** @zxing assist starts on frame 0 (always true in v2.2). */
+    readonly zxingFrameZero: boolean;
+}
+/**
+ * Resolve scanner platform profile from UA + feature hints.
+ * Safe in SSR (returns `generic`).
+ */
+export declare function resolveScannerPlatformProfile(): ScannerPlatformProfile;
+export { resolveScannerPlatformProfile as getScannerPlatformProfile };
+//# sourceMappingURL=scannerPlatformProfile.d.ts.map

package/dist/hooks/scannerPlatformProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scannerPlatformProfile.d.ts","sourceRoot":"","sources":["../../src/hooks/scannerPlatformProfile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,wBAAwB,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAsBD;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,sBAAsB,CAyDtE;AAYD,OAAO,EAAE,6BAA6B,IAAI,yBAAyB,EAAE,CAAC"}

package/dist/hooks/scannerPlatformProfile.js

@@ -0,0 +1,86 @@
+/**
+ * Platform-specific scanner engine ordering and UX hints.
+ * Firefox: ZBar WASM + @zxing only — no @undecaf/barcode-detector-polyfill package.
+ */
+function isIosDevice(ua) {
+    return /iPad|iPhone|iPod/.test(ua) || (ua.includes('Mac') && typeof document !== 'undefined' && 'ontouchend' in document);
+}
+function isCriOs(ua) {
+    return /CriOS/.test(ua);
+}
+function isFirefox(ua) {
+    return /Firefox\//.test(ua) && !/Seamonkey|Waterfox/.test(ua);
+}
+function isChromeDesktop(ua) {
+    return /Chrome\//.test(ua) && !/Edg\/|OPR\/|CriOS|Mobile/.test(ua);
+}
+function isChromeAndroid(ua) {
+    return /Android/.test(ua) && /Chrome\//.test(ua) && !/Edg\//.test(ua);
+}
+/**
+ * Resolve scanner platform profile from UA + feature hints.
+ * Safe in SSR (returns `generic`).
+ */
+export function resolveScannerPlatformProfile() {
+    if (typeof navigator === 'undefined') {
+        return genericProfile();
+    }
+    const ua = navigator.userAgent;
+    if (isFirefox(ua)) {
+        return {
+            id: 'firefox-desktop',
+            preferPreviewSnap: true,
+            nativeEnabled: false,
+            zbarFullPassEveryFrame: true,
+            zxingFrameZero: true,
+        };
+    }
+    if (isCriOs(ua) && isIosDevice(ua)) {
+        return {
+            id: 'crios-ios',
+            preferPreviewSnap: false,
+            nativeEnabled: false,
+            zbarFullPassEveryFrame: false,
+            zxingFrameZero: true,
+        };
+    }
+    if (isIosDevice(ua)) {
+        return {
+            id: 'ios-safari',
+            preferPreviewSnap: false,
+            nativeEnabled: false,
+            zbarFullPassEveryFrame: false,
+            zxingFrameZero: true,
+        };
+    }
+    if (isChromeDesktop(ua)) {
+        return {
+            id: 'chrome-desktop',
+            preferPreviewSnap: true,
+            nativeEnabled: true,
+            zbarFullPassEveryFrame: true,
+            zxingFrameZero: true,
+        };
+    }
+    if (isChromeAndroid(ua)) {
+        return {
+            id: 'chrome-android',
+            preferPreviewSnap: false,
+            nativeEnabled: true,
+            zbarFullPassEveryFrame: true,
+            zxingFrameZero: true,
+        };
+    }
+    return genericProfile();
+}
+function genericProfile() {
+    return {
+        id: 'generic',
+        preferPreviewSnap: false,
+        nativeEnabled: typeof window !== 'undefined' && window.BarcodeDetector !== undefined,
+        zbarFullPassEveryFrame: false,
+        zxingFrameZero: true,
+    };
+}
+export { resolveScannerPlatformProfile as getScannerPlatformProfile };
+//# sourceMappingURL=scannerPlatformProfile.js.map

package/dist/hooks/scannerPlatformProfile.js.map

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

package/dist/hooks/scannerScanPasses.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Digital-zoom scan regions for distant / small barcodes.
+ * Used by the pure-JS @zxing multi-pass decoder.
+ */
+export interface ScanPass {
+    readonly sx: number;
+    readonly sy: number;
+    readonly sw: number;
+    readonly sh: number;
+    /** Upscale factor when drawing the crop into the decode canvas. */
+    readonly scale: number;
+}
+/**
+ * Full frame + center zooms + mid-band (1D) + four corner crops + optional tight center.
+ * Covers off-center / distant codes that are not in the viewfinder center.
+ *
+ * CPU bound: at most 10 passes (1 full + 3 center + 1 mid-band + 4 corners + 1 tight center).
+ * Do not add more regions without raising this documented ceiling (~10–12 max).
+ */
+/** Full-frame only — cheap first pass (~1 crop per tick; G9 CPU bound). */
+export declare function buildQuickScanPass(videoWidth: number, videoHeight: number): ScanPass[];
+export declare function buildMaxSensitivityScanPasses(videoWidth: number, videoHeight: number): ScanPass[];
+//# sourceMappingURL=scannerScanPasses.d.ts.map