@unif/react-native-hms-scan 0.6.1 → 1.0.0

package/lib/module/Scanner/ScannerInner.js

@@ -0,0 +1,310 @@
+"use strict";
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { AppState, Linking, StyleSheet, View } from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
+import { HmsScanView } from '../HmsScanView/HmsScanView';
+import { decodeImage } from '../decodeImage';
+import { getCameraPermissionStatus, requestCameraPermission } from '../permissions';
+import { formatConfiguration } from "../format.js";
+import { scanError } from "../errors.js";
+import { Viewfinder } from "./Viewfinder.js";
+import { ScanTopBar } from "./ScanTopBar.js";
+import { ScanToolbar } from "./ScanToolbar.js";
+import { ResultFocus } from "./ResultFocus/ResultFocus.js";
+import { ResultFail } from "./ResultFail.js";
+import { DeniedOverlay } from "./DeniedOverlay.js";
+import { ScanErrorOverlay } from "./ScanErrorOverlay.js";
+import { styles } from "./styles.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function ScannerInner({
+  title = '扫一扫',
+  hintText = '将条码 / 二维码放入框内，自动扫描',
+  formats,
+  topInset,
+  bottomInset,
+  showTorch = true,
+  autoConfirm = false,
+  pickImage,
+  onConfirm,
+  onClose,
+  onError
+}) {
+  const insets = useSafeAreaInsets();
+  const config = formatConfiguration(formats);
+  const configKey = config.error?.message ?? config.csv;
+  const configRef = useRef(config);
+  configRef.current = config;
+  const callbacks = useRef({
+    onConfirm,
+    onClose,
+    onError,
+    autoConfirm
+  });
+  callbacks.current = {
+    onConfirm,
+    onClose,
+    onError,
+    autoConfirm
+  };
+  const [phase, setPhase] = useState('init');
+  const [result, setResult] = useState(null);
+  const [torchRequest, setTorchRequest] = useState(false);
+  const [torchState, setTorchState] = useState({
+    on: false
+  });
+  const [scanSession, setScanSession] = useState(0);
+  const [activeFormats, setActiveFormats] = useState([]);
+  const mounted = useRef(false);
+  const closed = useRef(false);
+  const accepting = useRef(false);
+  const cameraSession = useRef(0);
+  const permissionRun = useRef(0);
+  const imageRun = useRef(0);
+  const imagePending = useRef(false);
+  const restartAfterImage = useRef(false);
+  const waitingForSettings = useRef(false);
+  const selected = useRef(null);
+  const stopAdoption = useCallback(() => {
+    accepting.current = false;
+    ++cameraSession.current;
+    ++imageRun.current;
+    ++permissionRun.current;
+    selected.current = null;
+  }, []);
+  const startScan = useCallback(() => {
+    if (!mounted.current || closed.current) return;
+    if (imagePending.current) {
+      restartAfterImage.current = true;
+      setPhase('processing');
+      return;
+    }
+    const current = configRef.current;
+    if (current.error) {
+      setPhase('error');
+      callbacks.current.onError?.(current.error);
+      return;
+    }
+    setActiveFormats(current.csv ? current.csv.split(',') : []);
+    setResult(null);
+    selected.current = null;
+    accepting.current = true;
+    setScanSession(++cameraSession.current);
+    setPhase('scan');
+  }, []);
+  const reportFatal = useCallback(error => {
+    stopAdoption();
+    setResult(null);
+    setTorchRequest(false);
+    setPhase(error.reason === 'permission_denied' ? 'denied' : 'error');
+    callbacks.current.onError?.(error);
+  }, [stopAdoption]);
+  const runPermission = useCallback(async requestIfNeeded => {
+    const run = ++permissionRun.current;
+    const current = () => mounted.current && !closed.current && run === permissionRun.current;
+    let status;
+    try {
+      status = await getCameraPermissionStatus();
+      if (!current()) return;
+      if (requestIfNeeded && (status === 'denied' || status === 'undetermined')) {
+        status = await requestCameraPermission();
+        if (!current()) return;
+      }
+    } catch (error) {
+      if (current()) reportFatal(error);
+      return;
+    }
+    if (status === 'granted') startScan();else {
+      accepting.current = false;
+      setPhase('denied');
+    }
+  }, [reportFatal, startScan]);
+  useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+      stopAdoption();
+    };
+  }, [stopAdoption]);
+  useEffect(() => {
+    if (closed.current) return;
+    stopAdoption();
+    setResult(null);
+    if (imagePending.current) {
+      restartAfterImage.current = true;
+      setPhase('processing');
+      return;
+    }
+    if (configRef.current.error) {
+      reportFatal(configRef.current.error);
+      return;
+    }
+    setPhase('init');
+    void runPermission(true);
+  }, [configKey, reportFatal, runPermission, stopAdoption]);
+  useEffect(() => {
+    const subscription = AppState.addEventListener('change', state => {
+      if (state === 'active' && waitingForSettings.current && !closed.current) {
+        waitingForSettings.current = false;
+        void runPermission(false);
+      }
+    });
+    return () => subscription.remove();
+  }, [runPermission]);
+  useEffect(() => {
+    if (!showTorch) setTorchRequest(false);
+  }, [showTorch]);
+  const deliver = useCallback(() => {
+    const item = selected.current;
+    if (!mounted.current || closed.current || !item || item.delivered) return;
+    // Mark delivery before calling business code. A callback failure cannot undo it.
+    item.delivered = true;
+    setPhase('done');
+    callbacks.current.onConfirm(item.result);
+  }, []);
+  const adopt = useCallback(next => {
+    selected.current = {
+      result: next,
+      delivered: false
+    };
+    setResult(next);
+    setPhase('result');
+    if (callbacks.current.autoConfirm) deliver();
+  }, [deliver]);
+  const onCameraResult = useCallback(results => {
+    if (!mounted.current || closed.current || !accepting.current || scanSession !== cameraSession.current) return;
+    const first = results[0];
+    if (!first) return;
+    accepting.current = false;
+    adopt(first);
+  }, [adopt, scanSession]);
+  const onCameraError = useCallback(error => {
+    if (!mounted.current || closed.current || !accepting.current || scanSession !== cameraSession.current) return;
+    reportFatal(error);
+  }, [reportFatal, scanSession]);
+  const close = useCallback(() => {
+    if (closed.current) return;
+    closed.current = true;
+    stopAdoption();
+    setTorchRequest(false);
+    setPhase('closed');
+    callbacks.current.onClose?.();
+  }, [stopAdoption]);
+  const reset = useCallback(() => {
+    stopAdoption();
+    startScan();
+  }, [startScan, stopAdoption]);
+  const retry = useCallback(() => {
+    stopAdoption();
+    if (imagePending.current) {
+      restartAfterImage.current = true;
+      return;
+    }
+    setPhase('init');
+    void runPermission(true);
+  }, [runPermission, stopAdoption]);
+  const openSettings = useCallback(async () => {
+    waitingForSettings.current = true;
+    try {
+      await Linking.openSettings();
+    } catch (error) {
+      waitingForSettings.current = false;
+      if (mounted.current && !closed.current) reportFatal(scanError(error, {
+        reason: 'unavailable',
+        message: '打开系统设置失败'
+      }));
+    }
+  }, [reportFatal]);
+  const onAlbum = useCallback(async () => {
+    if (!pickImage || !accepting.current || imagePending.current || closed.current) return;
+    accepting.current = false;
+    const run = ++imageRun.current;
+    const current = () => mounted.current && !closed.current && run === imageRun.current;
+    const inputFormats = activeFormats;
+    imagePending.current = true;
+    setPhase('processing');
+    let image = null;
+    let results;
+    let failure;
+    try {
+      image = await pickImage();
+      if (current() && image) results = await decodeImage({
+        uri: image.uri,
+        formats: inputFormats
+      });
+    } catch (error) {
+      failure = scanError(error, {
+        reason: 'image_unavailable',
+        message: '选择或读取图片失败'
+      });
+    } finally {
+      imagePending.current = false;
+      // The original provider owns cleanup, including after this component unmounts.
+      try {
+        image?.onSourceReleased?.();
+      } finally {
+        if (current()) {
+          if (failure) {
+            setPhase('imageError');
+            callbacks.current.onError?.(failure);
+          } else if (!image) startScan();else if (results?.[0]) adopt(results[0]);else setPhase('empty');
+        } else if (restartAfterImage.current && mounted.current && !closed.current) {
+          restartAfterImage.current = false;
+          setPhase('init');
+          void runPermission(true);
+        }
+      }
+    }
+  }, [activeFormats, adopt, pickImage, runPermission, startScan]);
+  const hasCamera = !['init', 'denied', 'error', 'closed'].includes(phase);
+  const showChrome = phase === 'scan' || phase === 'processing';
+  const bottom = bottomInset ?? insets.bottom;
+  return /*#__PURE__*/_jsxs(View, {
+    style: styles.root,
+    children: [hasCamera && /*#__PURE__*/_jsx(HmsScanView, {
+      style: StyleSheet.absoluteFill,
+      formats: activeFormats,
+      paused: phase !== 'scan',
+      torch: torchRequest,
+      onScanResult: onCameraResult,
+      onScanError: onCameraError,
+      onTorchState: state => {
+        if (!closed.current && mounted.current && scanSession === cameraSession.current) {
+          setTorchState(state);
+          // A failed request or the SDK's controls can change actual state.
+          // Keep the next toggle based on that report, without optimistic UI.
+          setTorchRequest(showTorch && state.on);
+        }
+      }
+    }, scanSession), showChrome && /*#__PURE__*/_jsx(Viewfinder, {
+      size: 256,
+      detecting: phase === 'processing',
+      hintText: hintText
+    }), hasCamera && /*#__PURE__*/_jsx(ScanTopBar, {
+      title: title,
+      topInset: topInset ?? insets.top
+    }), showChrome && /*#__PURE__*/_jsx(ScanToolbar, {
+      flash: torchState.on,
+      bottomInset: bottom,
+      onFlash: showTorch && torchState.available !== false ? () => setTorchRequest(value => !value) : undefined,
+      onAlbum: pickImage ? onAlbum : undefined,
+      onClose: onClose ? close : undefined
+    }), phase === 'result' && result && /*#__PURE__*/_jsx(ResultFocus, {
+      result: result,
+      bottomInset: bottom,
+      onRescan: reset,
+      onConfirm: deliver
+    }), (phase === 'empty' || phase === 'imageError') && /*#__PURE__*/_jsx(ResultFail, {
+      bottomInset: bottom,
+      failed: phase === 'imageError',
+      onRescan: reset
+    }), phase === 'error' && /*#__PURE__*/_jsx(ScanErrorOverlay, {
+      onClose: onClose ? close : undefined,
+      onRetry: retry
+    }), phase === 'denied' && /*#__PURE__*/_jsx(DeniedOverlay, {
+      onClose: onClose ? close : undefined,
+      onSettings: openSettings
+    })]
+  });
+}
+//# sourceMappingURL=ScannerInner.js.map

package/lib/module/Scanner/ScannerInner.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","AppState","Linking","StyleSheet","View","useSafeAreaInsets","HmsScanView","decodeImage","getCameraPermissionStatus","requestCameraPermission","formatConfiguration","scanError","Viewfinder","ScanTopBar","ScanToolbar","ResultFocus","ResultFail","DeniedOverlay","ScanErrorOverlay","styles","jsx","_jsx","jsxs","_jsxs","ScannerInner","title","hintText","formats","topInset","bottomInset","showTorch","autoConfirm","pickImage","onConfirm","onClose","onError","insets","config","configKey","error","message","csv","configRef","current","callbacks","phase","setPhase","result","setResult","torchRequest","setTorchRequest","torchState","setTorchState","on","scanSession","setScanSession","activeFormats","setActiveFormats","mounted","closed","accepting","cameraSession","permissionRun","imageRun","imagePending","restartAfterImage","waitingForSettings","selected","stopAdoption","startScan","split","reportFatal","reason","runPermission","requestIfNeeded","run","status","subscription","addEventListener","state","remove","deliver","item","delivered","adopt","next","onCameraResult","results","first","onCameraError","close","reset","retry","openSettings","onAlbum","inputFormats","image","failure","uri","onSourceReleased","hasCamera","includes","showChrome","bottom","style","root","children","absoluteFill","paused","torch","onScanResult","onScanError","onTorchState","size","detecting","top","flash","onFlash","available","value","undefined","onRescan","failed","onRetry","onSettings"],"sourceRoot":"../../../src","sources":["Scanner/ScannerInner.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/Scanner/styles.js

@@ -0,0 +1,11 @@
+"use strict";
+
+import { StyleSheet } from 'react-native';
+import { scanChrome } from "./scanChrome.js";
+export const styles = StyleSheet.create({
+  root: {
+    flex: 1,
+    backgroundColor: scanChrome.cameraBg
+  }
+});
+//# sourceMappingURL=styles.js.map

package/lib/module/Scanner/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["StyleSheet","scanChrome","styles","create","root","flex","backgroundColor","cameraBg"],"sourceRoot":"../../../src","sources":["Scanner/styles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,UAAU,QAAQ,iBAAc;AAEzC,OAAO,MAAMC,MAAM,GAAGF,UAAU,CAACG,MAAM,CAAC;EACtCC,IAAI,EAAE;IAAEC,IAAI,EAAE,CAAC;IAAEC,eAAe,EAAEL,UAAU,CAACM;EAAS;AACxD,CAAC,CAAC","ignoreList":[]}

package/lib/module/Scanner/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/Scanner/types.js.map

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

package/lib/module/constants.js

@@ -0,0 +1,20 @@
+"use strict";
+
+/** The one source for public scan formats and input validation. */
+export const SCAN_FORMATS = ['QR_CODE', 'AZTEC', 'DATA_MATRIX', 'PDF417', 'CODABAR', 'CODE_39', 'CODE_93', 'CODE_128', 'EAN_8', 'EAN_13', 'UPC_A', 'UPC_E', 'ITF14', 'MULTI_FUNCTIONAL', 'UNKNOWN'];
+export const SCAN_CONTENT_TYPES = ['TEXT', 'URL', 'EMAIL', 'PHONE', 'SMS', 'WIFI', 'CONTACT', 'EVENT', 'LOCATION', 'DRIVER', 'ISBN', 'ARTICLE', 'OTHER'];
+export const SCAN_FORMAT_SET = new Set(SCAN_FORMATS);
+export const SCAN_CONTENT_TYPE_SET = new Set(SCAN_CONTENT_TYPES);
+export const SCAN_ERROR_REASONS = {
+  E_INVALID_INPUT: 'invalid_input',
+  E_NO_CAMERA_PERMISSION: 'permission_denied',
+  E_NO_READ_PERMISSION: 'permission_denied',
+  E_IMAGE_LOAD_FAILED: 'image_unavailable',
+  E_DECODE_FAILED: 'decode_failed',
+  E_INVALID_RESPONSE: 'invalid_response',
+  E_UNSUPPORTED: 'unsupported',
+  E_UNSUPPORTED_FORMAT: 'unsupported',
+  E_CAMERA_INIT: 'unavailable',
+  E_UNAVAILABLE: 'unavailable'
+};
+//# sourceMappingURL=constants.js.map

package/lib/module/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SCAN_FORMATS","SCAN_CONTENT_TYPES","SCAN_FORMAT_SET","Set","SCAN_CONTENT_TYPE_SET","SCAN_ERROR_REASONS","E_INVALID_INPUT","E_NO_CAMERA_PERMISSION","E_NO_READ_PERMISSION","E_IMAGE_LOAD_FAILED","E_DECODE_FAILED","E_INVALID_RESPONSE","E_UNSUPPORTED","E_UNSUPPORTED_FORMAT","E_CAMERA_INIT","E_UNAVAILABLE"],"sourceRoot":"../../src","sources":["constants.ts"],"mappings":";;AAEA;AACA,OAAO,MAAMA,YAAY,GAAG,CAC1B,SAAS,EACT,OAAO,EACP,aAAa,EACb,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,SAAS,CACD;AACV,OAAO,MAAMC,kBAAkB,GAAG,CAChC,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,EACN,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,MAAM,EACN,SAAS,EACT,OAAO,CACC;AAEV,OAAO,MAAMC,eAAoC,GAAG,IAAIC,GAAG,CAACH,YAAY,CAAC;AACzE,OAAO,MAAMI,qBAA0C,GAAG,IAAID,GAAG,CAC/DF,kBACF,CAAC;AAED,OAAO,MAAMI,kBAEZ,GAAG;EACFC,eAAe,EAAE,eAAe;EAChCC,sBAAsB,EAAE,mBAAmB;EAC3CC,oBAAoB,EAAE,mBAAmB;EACzCC,mBAAmB,EAAE,mBAAmB;EACxCC,eAAe,EAAE,eAAe;EAChCC,kBAAkB,EAAE,kBAAkB;EACtCC,aAAa,EAAE,aAAa;EAC5BC,oBAAoB,EAAE,aAAa;EACnCC,aAAa,EAAE,aAAa;EAC5BC,aAAa,EAAE;AACjB,CAAC","ignoreList":[]}

package/lib/module/decodeImage.js

@@ -2,32 +2,37 @@
 
 import NativeHmsScan from "./NativeHmsScan.js";
 import { formatsToCsv, parseResultsJson } from "./format.js";
-import { HmsScanError } from "./types.js";
-
-/**
- * 从本地图片解码条码 / 二维码（华为 Bitmap 模式）。
- *
- * @param uri 本地图片。iOS 支持 file://、绝对路径、data:；Android 支持
- *            file://、绝对路径、content://、android.resource://。
- *            两端都不下载远程 URL，也不支持 ph:// / assets-library://。
- * @param options 可选；formats 限定码制，不传 = 全部。
- * @returns 命中的结果数组（可能为空）。
- * @throws HmsScanError 图片加载失败 / 读权限缺失等。
- */
-export async function decodeImage(uri, options) {
-  if (!uri) {
-    throw new HmsScanError('E_IMAGE_LOAD_FAILED', 'decodeImage: uri 不能为空');
+import { scanError } from "./errors.js";
+import { ScanError } from "./ScanError.js";
+export async function decodeImage(input) {
+  // No remote authority, empty filename, fragment, query or malformed escapes.
+  const uri = input?.uri;
+  if (typeof uri !== 'string' || !/^file:\/\/\/(?:[^?#\s]+\/)*[^/?#\s]+$/i.test(uri)) {
+    throw new ScanError({
+      reason: 'invalid_input',
+      message: 'decodeImage 需要可读的 file URI'
+    });
+  }
+  try {
+    decodeURIComponent(uri);
+  } catch {
+    throw new ScanError({
+      reason: 'invalid_input',
+      message: '图片 URI 编码无效'
+    });
   }
+  const csv = formatsToCsv(input.formats);
+  if (!NativeHmsScan) throw new ScanError({
+    reason: 'unavailable',
+    message: 'HMS Scan 原生模块未安装'
+  });
   try {
-    const json = await NativeHmsScan.decodeImage(uri, formatsToCsv(options?.formats));
-    return parseResultsJson(json);
-  } catch (e) {
-    // 原生 reject 的 code 透传为 HmsScanError
-    const err = e;
-    if (err.code === 'E_NO_READ_PERMISSION' || err.code === 'E_IMAGE_LOAD_FAILED' || err.code === 'E_DECODE_FAILED') {
-      throw new HmsScanError(err.code, err.message);
-    }
-    throw new HmsScanError('E_UNKNOWN', err.message ?? 'decodeImage failed');
+    return parseResultsJson(await NativeHmsScan.decodeImage(uri, csv));
+  } catch (error) {
+    throw scanError(error, {
+      reason: 'decode_failed',
+      message: '图片识别失败'
+    });
   }
 }
 //# sourceMappingURL=decodeImage.js.map

package/lib/module/decodeImage.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeHmsScan","formatsToCsv","parseResultsJson","HmsScanError","decodeImage","uri","options","json","formats","e","err","code","message"],"sourceRoot":"../../src","sources":["decodeImage.ts"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,oBAAiB;AAC3C,SAASC,YAAY,EAAEC,gBAAgB,QAAQ,aAAU;AACzD,SAASC,YAAY,QAAkD,YAAS;;AAEhF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,WAAWA,CAC/BC,GAAW,EACXC,OAA4B,EACL;EACvB,IAAI,CAACD,GAAG,EAAE;IACR,MAAM,IAAIF,YAAY,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;EACxE;EACA,IAAI;IACF,MAAMI,IAAI,GAAG,MAAMP,aAAa,CAACI,WAAW,CAACC,GAAG,EAAEJ,YAAY,CAACK,OAAO,EAAEE,OAAO,CAAC,CAAC;IACjF,OAAON,gBAAgB,CAACK,IAAI,CAAC;EAC/B,CAAC,CAAC,OAAOE,CAAC,EAAE;IACV;IACA,MAAMC,GAAG,GAAGD,CAAwC;IACpD,IACEC,GAAG,CAACC,IAAI,KAAK,sBAAsB,IACnCD,GAAG,CAACC,IAAI,KAAK,qBAAqB,IAClCD,GAAG,CAACC,IAAI,KAAK,iBAAiB,EAC9B;MACA,MAAM,IAAIR,YAAY,CAACO,GAAG,CAACC,IAAI,EAAED,GAAG,CAACE,OAAO,CAAC;IAC/C;IACA,MAAM,IAAIT,YAAY,CAAC,WAAW,EAAEO,GAAG,CAACE,OAAO,IAAI,oBAAoB,CAAC;EAC1E;AACF","ignoreList":[]}
+{"version":3,"names":["NativeHmsScan","formatsToCsv","parseResultsJson","scanError","ScanError","decodeImage","input","uri","test","reason","message","decodeURIComponent","csv","formats","error"],"sourceRoot":"../../src","sources":["decodeImage.ts"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,oBAAiB;AAC3C,SAASC,YAAY,EAAEC,gBAAgB,QAAQ,aAAU;AACzD,SAASC,SAAS,QAAQ,aAAU;AACpC,SAASC,SAAS,QAAQ,gBAAa;AAGvC,OAAO,eAAeC,WAAWA,CAC/BC,KAAqC,EACL;EAChC;EACA,MAAMC,GAAG,GAAGD,KAAK,EAAEC,GAAG;EACtB,IACE,OAAOA,GAAG,KAAK,QAAQ,IACvB,CAAC,wCAAwC,CAACC,IAAI,CAACD,GAAG,CAAC,EACnD;IACA,MAAM,IAAIH,SAAS,CAAC;MAClBK,MAAM,EAAE,eAAe;MACvBC,OAAO,EAAE;IACX,CAAC,CAAC;EACJ;EACA,IAAI;IACFC,kBAAkB,CAACJ,GAAG,CAAC;EACzB,CAAC,CAAC,MAAM;IACN,MAAM,IAAIH,SAAS,CAAC;MAClBK,MAAM,EAAE,eAAe;MACvBC,OAAO,EAAE;IACX,CAAC,CAAC;EACJ;EACA,MAAME,GAAG,GAAGX,YAAY,CAACK,KAAK,CAACO,OAAO,CAAC;EACvC,IAAI,CAACb,aAAa,EAChB,MAAM,IAAII,SAAS,CAAC;IAClBK,MAAM,EAAE,aAAa;IACrBC,OAAO,EAAE;EACX,CAAC,CAAC;EACJ,IAAI;IACF,OAAOR,gBAAgB,CAAC,MAAMF,aAAa,CAACK,WAAW,CAACE,GAAG,EAAEK,GAAG,CAAC,CAAC;EACpE,CAAC,CAAC,OAAOE,KAAK,EAAE;IACd,MAAMX,SAAS,CAACW,KAAK,EAAE;MACrBL,MAAM,EAAE,eAAe;MACvBC,OAAO,EAAE;IACX,CAAC,CAAC;EACJ;AACF","ignoreList":[]}

package/lib/module/decodeImage.web.js

@@ -0,0 +1,7 @@
+"use strict";
+
+import { unsupportedScanError } from "./errors.js";
+export async function decodeImage(_input) {
+  throw unsupportedScanError();
+}
+//# sourceMappingURL=decodeImage.web.js.map

package/lib/module/decodeImage.web.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["unsupportedScanError","decodeImage","_input"],"sourceRoot":"../../src","sources":["decodeImage.web.ts"],"mappings":";;AAAA,SAASA,oBAAoB,QAAQ,aAAU;AAG/C,OAAO,eAAeC,WAAWA,CAC/BC,MAAsC,EACN;EAChC,MAAMF,oBAAoB,CAAC,CAAC;AAC9B","ignoreList":[]}

package/lib/module/errors.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { ScanError } from "./ScanError.js";
+import { SCAN_ERROR_REASONS } from "./constants.js";
+/** Native boundary normalization; Scanner only uses this for its external picker. */
+export function scanError(error, fallback) {
+  if (error instanceof ScanError) return error;
+  const raw = error && typeof error === 'object' ? error : {};
+  const sourceCode = typeof raw.code === 'string' ? raw.code : undefined;
+  return new ScanError({
+    reason: sourceCode && SCAN_ERROR_REASONS[sourceCode] || fallback.reason,
+    message: typeof raw.message === 'string' ? raw.message : fallback.message,
+    ...(sourceCode ? {
+      sourceCode
+    } : {})
+  });
+}
+export function unsupportedScanError() {
+  return new ScanError({
+    reason: 'unsupported',
+    message: 'HMS Scan 仅支持 Android 与 iOS 设备'
+  });
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ScanError","SCAN_ERROR_REASONS","scanError","error","fallback","raw","sourceCode","code","undefined","reason","message","unsupportedScanError"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,gBAAa;AACvC,SAASC,kBAAkB,QAAQ,gBAAa;AAGhD;AACA,OAAO,SAASC,SAASA,CACvBC,KAAc,EACdC,QAA+B,EACpB;EACX,IAAID,KAAK,YAAYH,SAAS,EAAE,OAAOG,KAAK;EAC5C,MAAME,GAAG,GACPF,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,GAAIA,KAAK,GAAyB,CAAC,CAAC;EACxE,MAAMG,UAAU,GAAG,OAAOD,GAAG,CAACE,IAAI,KAAK,QAAQ,GAAGF,GAAG,CAACE,IAAI,GAAGC,SAAS;EACtE,OAAO,IAAIR,SAAS,CAAC;IACnBS,MAAM,EAAGH,UAAU,IAAIL,kBAAkB,CAACK,UAAU,CAAC,IAAKF,QAAQ,CAACK,MAAM;IACzEC,OAAO,EAAE,OAAOL,GAAG,CAACK,OAAO,KAAK,QAAQ,GAAGL,GAAG,CAACK,OAAO,GAAGN,QAAQ,CAACM,OAAO;IACzE,IAAIJ,UAAU,GAAG;MAAEA;IAAW,CAAC,GAAG,CAAC,CAAC;EACtC,CAAC,CAAC;AACJ;AAEA,OAAO,SAASK,oBAAoBA,CAAA,EAAc;EAChD,OAAO,IAAIX,SAAS,CAAC;IACnBS,MAAM,EAAE,aAAa;IACrBC,OAAO,EAAE;EACX,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/format.js

@@ -1,66 +1,72 @@
 "use strict";
 
-import { ALL_BARCODE_FORMATS } from "./types.js";
-const FORMAT_SET = new Set([...ALL_BARCODE_FORMATS, 'UNKNOWN']);
-const CONTENT_TYPES = ['TEXT', 'URL', 'EMAIL', 'PHONE', 'SMS', 'WIFI', 'CONTACT', 'EVENT', 'LOCATION', 'DRIVER', 'ISBN', 'ARTICLE', 'OTHER'];
-const CONTENT_SET = new Set(CONTENT_TYPES);
-
-/** 把任意字符串安全收敛成 BarcodeFormat（未知归 UNKNOWN）。 */
+import { SCAN_FORMAT_SET, SCAN_CONTENT_TYPE_SET } from "./constants.js";
+import { ScanError } from "./ScanError.js";
 export function coerceFormat(value) {
-  return typeof value === 'string' && FORMAT_SET.has(value) ? value : 'UNKNOWN';
+  return typeof value === 'string' && SCAN_FORMAT_SET.has(value) ? value : 'UNKNOWN';
 }
-
-/** 把任意字符串安全收敛成 BarcodeContentType（未知/缺省 → undefined）。 */
 export function coerceContentType(value) {
-  return typeof value === 'string' && CONTENT_SET.has(value) ? value : undefined;
+  return typeof value === 'string' && SCAN_CONTENT_TYPE_SET.has(value) ? value : undefined;
 }
-
-/** formats[] → 逗号分隔 CSV（传给原生）；空/未传 → ''（= 全部码制）。 */
-export function formatsToCsv(formats) {
-  return formats && formats.length > 0 ? formats.join(',') : '';
+/** Empty means no extra filter. Order and duplicates do not change the filter. */
+export function formatsToCsv(value) {
+  if (value === undefined) return '';
+  if (!Array.isArray(value) || [...value].some(item => typeof item !== 'string' || item === 'UNKNOWN' || !SCAN_FORMAT_SET.has(item))) {
+    throw new ScanError({
+      reason: 'invalid_input',
+      message: 'formats 包含无效码制'
+    });
+  }
+  return [...new Set(value)].sort().join(',');
 }
-function coerceCornerPoints(value) {
+export function formatConfiguration(value) {
+  try {
+    return {
+      csv: formatsToCsv(value),
+      error: undefined
+    };
+  } catch (error) {
+    return {
+      csv: '',
+      error: error
+    };
+  }
+}
+function cornerPoints(value) {
   if (!Array.isArray(value)) return undefined;
-  const points = value.filter(p => !!p && typeof p.x === 'number' && typeof p.y === 'number').map(p => ({
+  const points = value.filter(p => !!p && typeof p.x === 'number' && Number.isFinite(p.x) && typeof p.y === 'number' && Number.isFinite(p.y)).map(p => ({
     x: p.x,
     y: p.y
   }));
-  return points.length > 0 ? points : undefined;
+  return points.length ? points : undefined;
 }
-function coerceResult(raw) {
-  if (!raw || typeof raw !== 'object') return null;
-  const r = raw;
-  // 没有有效 value 的命中无意义，丢弃
-  if (typeof r.value !== 'string' || r.value.length === 0) return null;
-  const result = {
-    value: r.value,
-    format: coerceFormat(r.format)
-  };
-  const contentType = coerceContentType(r.contentType);
-  if (contentType) result.contentType = contentType;
-  const cornerPoints = coerceCornerPoints(r.cornerPoints);
-  if (cornerPoints) result.cornerPoints = cornerPoints;
-  return result;
+function invalidResponse() {
+  throw new ScanError({
+    reason: 'invalid_response',
+    message: '原生扫码结果不符合约定'
+  });
 }
-
-/**
- * 解析原生回传的 JSON 字符串 → 强类型 ScanResult[]。
- * 任何脏数据都被安全过滤；解析失败返回空数组而非抛错。
- */
+/** Malformed bridge data is distinct from a successfully decoded empty batch. */
 export function parseResultsJson(json) {
-  if (!json) return [];
-  let parsed;
+  let data;
+  if (typeof json !== 'string') return invalidResponse();
   try {
-    parsed = JSON.parse(json);
+    data = JSON.parse(json);
   } catch {
-    return [];
-  }
-  if (!Array.isArray(parsed)) return [];
-  const out = [];
-  for (const item of parsed) {
-    const r = coerceResult(item);
-    if (r) out.push(r);
+    return invalidResponse();
   }
-  return out;
+  if (!Array.isArray(data)) return invalidResponse();
+  return data.map(raw => {
+    if (!raw || typeof raw !== 'object' || typeof raw.value !== 'string' || typeof raw.format !== 'string') return invalidResponse();
+    const result = {
+      value: raw.value,
+      format: coerceFormat(raw.format)
+    };
+    const contentType = coerceContentType(raw.contentType);
+    const points = cornerPoints(raw.cornerPoints);
+    if (contentType !== undefined) result.contentType = contentType;
+    if (points !== undefined) result.cornerPoints = points;
+    return result;
+  });
 }
 //# sourceMappingURL=format.js.map