react-native-credit-card-scanner 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Developer
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# react-native-credit-card-scanner
+
+A high-performance credit card scanning library for React Native built on top of Vision Camera.
+
+## Demo
+
+https://github.com/user-attachments/assets/0c07269a-17da-410f-aacd-a179115bfac4
+
+## Requirements
+
+| Requirement                         | Minimum version |
+| ----------------------------------- | --------------- |
+| React Native                        | 0.81            |
+| iOS                                 | 15.1            |
+| Android Minimum SDK                 | 26              |
+| Android Target SDK                  | 36              |
+| react-native-vision-camera          | 5.0.0           |
+| react-native-vision-camera-ocr-plus | 2.0.0           |
+| react-native-worklets               | 0.8.x           |
+| Expo (if used)                      | 54              |
+
+## Installation
+
+### 1. Install the library
+
+```sh
+npm install react-native-credit-card-scanner
+# or
+yarn add react-native-credit-card-scanner
+```
+
+### 2. Install Peer Dependencies
+
+This library relies on several peer dependencies to function properly. You must install them in your project:
+
+```sh
+npm install react-native-vision-camera \
+  react-native-vision-camera-ocr-plus \
+  react-native-hole-view \
+  react-native-vision-camera-worklets \
+  react-native-worklets \
+  react-native-nitro-modules \
+  react-native-nitro-image
+```
+
+### Peer dependencies
+
+| Package                               | Version   |
+| ------------------------------------- | --------- |
+| `react-native-vision-camera`          | `>=5.0.0` |
+| `react-native-vision-camera-ocr-plus` | `>=2.0.0` |
+| `react-native-hole-view`              | `*`       |
+| `react-native-nitro-modules`          | `*`       |
+| `react-native-nitro-image`            | `*`       |
+| `react-native-vision-camera-worklets` | `*`       |
+| `react-native-worklets`               | `>=0.8.0` |
+
+### 3. Add Babel Plugin for Worklets
+
+You must add the worklets plugin to your `babel.config.js`:
+
+```javascript
+module.exports = {
+  //other options.....
+  plugins: [
+    // ...other plugins
+    ['react-native-worklets/plugin'],
+  ],
+};
+```
+
+> **Warning**: Ensure you clear your bundler cache after adding the babel plugin (e.g., `npm start -- --reset-cache` or `yarn start --reset-cache`).
+
+### 4. Setup Permissions
+
+#### iOS
+
+Add the camera permission to your `ios/YourApp/Info.plist`:
+
+```xml
+<key>NSCameraUsageDescription</key>
+<string>We need access to your camera to scan credit cards.</string>
+```
+
+#### Android
+
+Add the camera permission to your `android/app/src/main/AndroidManifest.xml`:
+
+```xml
+<uses-permission android:name="android.permission.CAMERA" />
+```
+
+### 5. Expo Usage
+
+This library works with Expo, **but only with custom Expo Development Builds (Prebuild)** or the Bare Workflow. It **will not work in Expo Go** due to its reliance on custom native code, C++ Nitro Modules, and JSI.
+
+If you are using Expo, make sure to follow the specific setup guides for Expo in the official documentation of our core dependencies:
+
+- [React Native Vision Camera - Expo Guide](https://react-native-vision-camera.com/docs/guides/getting-started)
+- [React Native Worklets - Getting Started](https://docs.swmansion.com/react-native-worklets/docs/fundamentals/getting-started/)
+
+You will typically need to configure the `app.json` config plugins for Vision Camera to automatically handle camera permissions during prebuild.
+
+---
+
+## Available Components
+
+### `CreditCardScanner`
+
+The main orchestrator component that handles rendering the camera, drawing the overlay cutout, and processing the OCR output.
+
+#### Props
+
+| Prop               | Type                               | Description                                                                                                                                                                                                |
+| ------------------ | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `isActive`         | `boolean`                          | Determines if the camera and scanner are actively running. Pass `false` to pause/hide it and save battery.                                                                                                 |
+| `onScanSuccess`    | `(result: CardResult) => void`     | Callback triggered when a valid credit card is successfully scanned and verified.                                                                                                                          |
+| `cameraRef`        | `React.RefObject<CameraRef\|null>` | _(Optional)_ Programatically control camera properties/functions.                                                                                                                                          |
+| `overlayColor`     | `string`                           | _(Optional)_ The color of the dimming mask over the camera (e.g., `rgba(0, 0, 0, 0.7)`).                                                                                                                   |
+| `holeViewConfig`   | `HoleViewConfig`                   | _(Optional)_ Configuration object specifying the position and size of the clear cutout window where the card should be aligned. Includes `left`, `top`, `width`, and `height`.                             |
+| `parentViewHeight` | `number`                           | _(Optional)_ The exact height of the parent container holding the scanner, required for accurate proportional cutout bounds and scanRegion mapping (always pass it if the camera view is not full screen). |
+| `style`            | `ViewStyle`                        | _(Optional)_ Style applied to the underlying container wrapper.                                                                                                                                            |
+| `cameraProps`      | `Partial<CameraProps>`             | _(Optional)_ Pass vision camera props to <Camera /> component.                                                                                                                                             |
+
+#### Types
+
+**`CardResult`**
+
+```typescript
+interface CardResult {
+  cardNumber: string; // The 13-19 digit card number
+  expiryDate: string | null; // e.g., '12/26'
+  cardholderName: string | undefined; // Extracted name (if matched)
+  issuer: 'Visa' | 'Mastercard' | 'Amex' | 'Discover' | 'Unknown';
+}
+```
+
+---
+
+## Usage Example
+
+```tsx
+import React, { useState } from 'react';
+import { View, Text, Button } from 'react-native';
+import {
+  CreditCardScanner,
+  type CardResult,
+} from 'react-native-credit-card-scanner';
+import { useCameraPermission } from 'react-native-vision-camera';
+
+export default function App() {
+  const [isActive, setIsActive] = useState(false);
+  const { hasPermission, requestPermission } = useCameraPermission();
+
+  const handleScanSuccess = (result: CardResult) => {
+    setIsActive(false);
+    console.log('Card Scanned:', result.cardNumber);
+  };
+
+  const startScan = () => {
+    if (!hasPermission) requestPermission();
+    else setIsActive(true);
+  };
+
+  return (
+    <View style={{ flex: 1, backgroundColor: '#000' }}>
+      {isActive ? (
+        <CreditCardScanner
+          isActive={isActive}
+          onScanSuccess={handleScanSuccess}
+          overlayColor="rgba(0, 0, 0, 0.8)"
+        />
+      ) : (
+        <View
+          style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}
+        >
+          <Button title="Scan Credit Card" onPress={startScan} />
+        </View>
+      )}
+    </View>
+  );
+}
+```
+
+## Acknowledgments
+
+This library depends on several awesome packages by community, Thanks to the authors of these libraries for making this possible.
+
+- [react-native-vision-camera](https://github.com/mrousavy/react-native-vision-camera)
+- [react-native-vision-camera-ocr-plus](https://github.com/jamenamcinteer/react-native-vision-camera-ocr-plus)
+- [react-native-hole-view](https://github.com/ibitcy/react-native-hole-view)
+- [react-native-worklets](https://docs.swmansion.com/react-native-worklets)
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT

package/lib/module/components/CreditCardScanner.js

@@ -0,0 +1,66 @@
+"use strict";
+
+import React from 'react';
+import { View, StyleSheet, Text, Dimensions } from 'react-native';
+import { Camera, useCameraDevice } from 'react-native-vision-camera';
+import { useCardScanner } from "../hooks/useCardScanner.js";
+import { ScannerOverlay } from "./ScannerOverlay.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const width = Dimensions.get('window').width * 0.95;
+const height = width / 1.586;
+export const CreditCardScanner = ({
+  cameraRef,
+  isActive,
+  onScanSuccess,
+  onError,
+  style,
+  overlayColor = 'rgba(0, 0, 0, 0.6)',
+  holeViewConfig = {
+    left: 10,
+    top: 50,
+    width: width,
+    height: height
+  },
+  cameraProps,
+  parentViewHeight
+}) => {
+  const device = useCameraDevice('back');
+  // Custom hook that manages MLKit and the validation pipeline
+  const {
+    frameOutput
+  } = useCardScanner({
+    onScanSuccess,
+    holeViewConfig,
+    parentViewHeight
+  });
+  if (!device) {
+    if (onError) onError(new Error('No back camera device found'));
+    return /*#__PURE__*/_jsx(View, {
+      style: style,
+      children: /*#__PURE__*/_jsx(Text, {
+        children: "Camera not available"
+      })
+    });
+  }
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.container, style],
+    children: [/*#__PURE__*/_jsx(Camera, {
+      ref: cameraRef,
+      style: StyleSheet.absoluteFill,
+      device: device,
+      isActive: isActive,
+      outputs: [frameOutput],
+      ...cameraProps
+    }), /*#__PURE__*/_jsx(ScannerOverlay, {
+      color: overlayColor,
+      config: holeViewConfig
+    })]
+  });
+};
+const styles = StyleSheet.create({
+  container: {
+    overflow: 'hidden',
+    position: 'relative'
+  }
+});
+//# sourceMappingURL=CreditCardScanner.js.map

package/lib/module/components/CreditCardScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","View","StyleSheet","Text","Dimensions","Camera","useCameraDevice","useCardScanner","ScannerOverlay","jsx","_jsx","jsxs","_jsxs","width","get","height","CreditCardScanner","cameraRef","isActive","onScanSuccess","onError","style","overlayColor","holeViewConfig","left","top","cameraProps","parentViewHeight","device","frameOutput","Error","children","styles","container","ref","absoluteFill","outputs","color","config","create","overflow","position"],"sourceRoot":"../../../src","sources":["components/CreditCardScanner.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,IAAI,EAAEC,UAAU,EAAEC,IAAI,EAAEC,UAAU,QAAQ,cAAc;AACjE,SAASC,MAAM,EAAEC,eAAe,QAAQ,4BAA4B;AACpE,SAASC,cAAc,QAAQ,4BAAyB;AACxD,SAASC,cAAc,QAAQ,qBAAkB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAElD,MAAMC,KAAK,GAAGT,UAAU,CAACU,GAAG,CAAC,QAAQ,CAAC,CAACD,KAAK,GAAG,IAAI;AACnD,MAAME,MAAM,GAAGF,KAAK,GAAG,KAAK;AAE5B,OAAO,MAAMG,iBAAmD,GAAGA,CAAC;EAClEC,SAAS;EACTC,QAAQ;EACRC,aAAa;EACbC,OAAO;EACPC,KAAK;EACLC,YAAY,GAAG,oBAAoB;EACnCC,cAAc,GAAG;IACfC,IAAI,EAAE,EAAE;IACRC,GAAG,EAAE,EAAE;IACPZ,KAAK,EAAEA,KAAK;IACZE,MAAM,EAAEA;EACV,CAAC;EACDW,WAAW;EACXC;AACF,CAAC,KAAK;EACJ,MAAMC,MAAM,GAAGtB,eAAe,CAAC,MAAM,CAAC;EACtC;EACA,MAAM;IAAEuB;EAAY,CAAC,GAAGtB,cAAc,CAAC;IACrCY,aAAa;IACbI,cAAc;IACdI;EACF,CAAC,CAAC;EAEF,IAAI,CAACC,MAAM,EAAE;IACX,IAAIR,OAAO,EAAEA,OAAO,CAAC,IAAIU,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC9D,oBACEpB,IAAA,CAACT,IAAI;MAACoB,KAAK,EAAEA,KAAM;MAAAU,QAAA,eACjBrB,IAAA,CAACP,IAAI;QAAA4B,QAAA,EAAC;MAAoB,CAAM;IAAC,CAC7B,CAAC;EAEX;EAEA,oBACEnB,KAAA,CAACX,IAAI;IAACoB,KAAK,EAAE,CAACW,MAAM,CAACC,SAAS,EAAEZ,KAAK,CAAE;IAAAU,QAAA,gBACrCrB,IAAA,CAACL,MAAM;MACL6B,GAAG,EAAEjB,SAAU;MACfI,KAAK,EAAEnB,UAAU,CAACiC,YAAa;MAC/BP,MAAM,EAAEA,MAAO;MACfV,QAAQ,EAAEA,QAAS;MACnBkB,OAAO,EAAE,CAACP,WAAW,CAAE;MAAA,GACnBH;IAAW,CAChB,CAAC,eACFhB,IAAA,CAACF,cAAc;MAAC6B,KAAK,EAAEf,YAAa;MAACgB,MAAM,EAAEf;IAAe,CAAE,CAAC;EAAA,CAC3D,CAAC;AAEX,CAAC;AAED,MAAMS,MAAM,GAAG9B,UAAU,CAACqC,MAAM,CAAC;EAC/BN,SAAS,EAAE;IACTO,QAAQ,EAAE,QAAQ;IAClBC,QAAQ,EAAE;EACZ;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/ScannerOverlay.js

@@ -0,0 +1,43 @@
+"use strict";
+
+import React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { RNHoleView } from 'react-native-hole-view';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export const ScannerOverlay = ({
+  color,
+  config
+}) => {
+  return /*#__PURE__*/_jsxs(View, {
+    style: StyleSheet.absoluteFill,
+    pointerEvents: "none",
+    children: [/*#__PURE__*/_jsx(RNHoleView, {
+      style: [StyleSheet.absoluteFill, {
+        backgroundColor: color
+      }],
+      holes: [{
+        x: config.left,
+        y: config.top,
+        width: config.width,
+        height: config.height,
+        borderRadius: 12
+      }]
+    }), /*#__PURE__*/_jsx(View, {
+      style: [styles.borderOverlay, {
+        left: config.left,
+        top: config.top,
+        width: config.width,
+        height: config.height
+      }]
+    })]
+  });
+};
+const styles = StyleSheet.create({
+  borderOverlay: {
+    // position: 'absolute',
+    borderWidth: 2,
+    borderColor: 'rgba(255, 255, 255, 0.7)',
+    borderRadius: 12
+  }
+});
+//# sourceMappingURL=ScannerOverlay.js.map

package/lib/module/components/ScannerOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","RNHoleView","jsx","_jsx","jsxs","_jsxs","ScannerOverlay","color","config","style","absoluteFill","pointerEvents","children","backgroundColor","holes","x","left","y","top","width","height","borderRadius","styles","borderOverlay","create","borderWidth","borderColor"],"sourceRoot":"../../../src","sources":["components/ScannerOverlay.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,UAAU,EAAEC,IAAI,QAAQ,cAAc;AAC/C,SAASC,UAAU,QAAQ,wBAAwB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAQpD,OAAO,MAAMC,cAA6C,GAAGA,CAAC;EAC5DC,KAAK;EACLC;AACF,CAAC,KAAK;EACJ,oBACEH,KAAA,CAACL,IAAI;IAACS,KAAK,EAAEV,UAAU,CAACW,YAAa;IAACC,aAAa,EAAC,MAAM;IAAAC,QAAA,gBACxDT,IAAA,CAACF,UAAU;MACTQ,KAAK,EAAE,CAACV,UAAU,CAACW,YAAY,EAAE;QAAEG,eAAe,EAAEN;MAAM,CAAC,CAAE;MAC7DO,KAAK,EAAE,CACL;QACEC,CAAC,EAAEP,MAAM,CAACQ,IAAI;QACdC,CAAC,EAAET,MAAM,CAACU,GAAG;QACbC,KAAK,EAAEX,MAAM,CAACW,KAAK;QACnBC,MAAM,EAAEZ,MAAM,CAACY,MAAM;QACrBC,YAAY,EAAE;MAChB,CAAC;IACD,CACH,CAAC,eAEFlB,IAAA,CAACH,IAAI;MACHS,KAAK,EAAE,CACLa,MAAM,CAACC,aAAa,EACpB;QACEP,IAAI,EAAER,MAAM,CAACQ,IAAI;QACjBE,GAAG,EAAEV,MAAM,CAACU,GAAG;QACfC,KAAK,EAAEX,MAAM,CAACW,KAAK;QACnBC,MAAM,EAAEZ,MAAM,CAACY;MACjB,CAAC;IACD,CACH,CAAC;EAAA,CACE,CAAC;AAEX,CAAC;AAED,MAAME,MAAM,GAAGvB,UAAU,CAACyB,MAAM,CAAC;EAC/BD,aAAa,EAAE;IACb;IACAE,WAAW,EAAE,CAAC;IACdC,WAAW,EAAE,0BAA0B;IACvCL,YAAY,EAAE;EAChB;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/hooks/useCardScanner.js

@@ -0,0 +1,53 @@
+"use strict";
+
+import { useTextRecognition } from 'react-native-vision-camera-ocr-plus';
+import { useFrameOutput } from 'react-native-vision-camera';
+import { scheduleOnRN } from 'react-native-worklets';
+import { parseCardData } from "../utils/parsers.js";
+import { isValidLuhn } from "../utils/validators.js";
+import { Dimensions } from 'react-native';
+const {
+  width: windowWidth,
+  height: windowHeight
+} = Dimensions.get('window');
+export const useCardScanner = ({
+  onScanSuccess,
+  holeViewConfig,
+  parentViewHeight
+}) => {
+  const handleSuccess = data => {
+    onScanSuccess(data);
+  };
+  const HEIGHT = parentViewHeight ? parentViewHeight : windowHeight;
+  const {
+    scanText
+  } = useTextRecognition({
+    language: 'latin',
+    frameSkipThreshold: 10,
+    scanRegion: {
+      left: `${holeViewConfig.left / windowWidth * 100}%`,
+      top: `${holeViewConfig.top / HEIGHT * 100}%`,
+      width: `${holeViewConfig.width / windowWidth * 100}%`,
+      height: `${holeViewConfig.height / HEIGHT * 100}%`
+    }
+  });
+  const frameOutput = useFrameOutput({
+    pixelFormat: 'rgb',
+    onFrame: frame => {
+      'worklet';
+
+      const result = scanText(frame);
+      if (result.resultText) {
+        const cardData = parseCardData(result.blocks);
+        if (cardData.cardNumber && isValidLuhn(cardData.cardNumber)) {
+          scheduleOnRN(handleSuccess, cardData);
+        }
+      }
+      frame.dispose();
+    }
+  });
+  return {
+    frameOutput
+  };
+};
+//# sourceMappingURL=useCardScanner.js.map

package/lib/module/hooks/useCardScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useTextRecognition","useFrameOutput","scheduleOnRN","parseCardData","isValidLuhn","Dimensions","width","windowWidth","height","windowHeight","get","useCardScanner","onScanSuccess","holeViewConfig","parentViewHeight","handleSuccess","data","HEIGHT","scanText","language","frameSkipThreshold","scanRegion","left","top","frameOutput","pixelFormat","onFrame","frame","result","resultText","cardData","blocks","cardNumber","dispose"],"sourceRoot":"../../../src","sources":["hooks/useCardScanner.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,qCAAqC;AACxE,SAASC,cAAc,QAAQ,4BAA4B;AAC3D,SAASC,YAAY,QAAQ,uBAAuB;AACpD,SAASC,aAAa,QAAQ,qBAAkB;AAChD,SAASC,WAAW,QAAQ,wBAAqB;AAEjD,SAASC,UAAU,QAAQ,cAAc;AAEzC,MAAM;EAAEC,KAAK,EAAEC,WAAW;EAAEC,MAAM,EAAEC;AAAa,CAAC,GAAGJ,UAAU,CAACK,GAAG,CAAC,QAAQ,CAAC;AAQ7E,OAAO,MAAMC,cAAc,GAAGA,CAAC;EAC7BC,aAAa;EACbC,cAAc;EACdC;AACmB,CAAC,KAAK;EACzB,MAAMC,aAAa,GAAIC,IAAgB,IAAK;IAC1CJ,aAAa,CAACI,IAAI,CAAC;EACrB,CAAC;EACD,MAAMC,MAAM,GAAGH,gBAAgB,GAAGA,gBAAgB,GAAGL,YAAY;EACjE,MAAM;IAAES;EAAS,CAAC,GAAGlB,kBAAkB,CAAC;IACtCmB,QAAQ,EAAE,OAAO;IACjBC,kBAAkB,EAAE,EAAE;IACtBC,UAAU,EAAE;MACVC,IAAI,EAAE,GAAIT,cAAc,CAACS,IAAI,GAAGf,WAAW,GAAI,GAAG,GAAG;MACrDgB,GAAG,EAAE,GAAIV,cAAc,CAACU,GAAG,GAAGN,MAAM,GAAI,GAAG,GAAG;MAC9CX,KAAK,EAAE,GAAIO,cAAc,CAACP,KAAK,GAAGC,WAAW,GAAI,GAAG,GAAG;MACvDC,MAAM,EAAE,GAAIK,cAAc,CAACL,MAAM,GAAGS,MAAM,GAAI,GAAG;IACnD;EACF,CAAC,CAAC;EAEF,MAAMO,WAAW,GAAGvB,cAAc,CAAC;IACjCwB,WAAW,EAAE,KAAK;IAClBC,OAAO,EAAGC,KAAK,IAAK;MAClB,SAAS;;MAET,MAAMC,MAAM,GAAGV,QAAQ,CAACS,KAAK,CAAC;MAC9B,IAAIC,MAAM,CAACC,UAAU,EAAE;QACrB,MAAMC,QAAQ,GAAG3B,aAAa,CAACyB,MAAM,CAACG,MAAM,CAAC;QAE7C,IAAID,QAAQ,CAACE,UAAU,IAAI5B,WAAW,CAAC0B,QAAQ,CAACE,UAAU,CAAC,EAAE;UAC3D9B,YAAY,CAACa,aAAa,EAAEe,QAAsB,CAAC;QACrD;MACF;MAEAH,KAAK,CAACM,OAAO,CAAC,CAAC;IACjB;EACF,CAAC,CAAC;EAEF,OAAO;IAAET;EAAY,CAAC;AACxB,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export * from "./components/CreditCardScanner.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,cAAc,mCAAgC;AAC9C,cAAc,kBAAS","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types/index.js

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

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

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

package/lib/module/utils/parsers.js

@@ -0,0 +1,75 @@
+"use strict";
+
+import { getCardIssuer } from "./validators.js";
+const CARD_KEYWORDS_REGEX = /\b(VISA|MASTERCARD|DISCOVER|AMERICAN|EXPRESS|AMEX|RUPAY|MAESTRO|CIRRUS|DEBIT|CREDIT|PREPAID|PLATINUM|GOLD|CLASSIC|SIGNATURE|INFINITE|WORLD|ELITE|BUSINESS|CORPORATE|BANK|CARD|SERVICES|FINANCIAL|TRUST|UNION|FEDERAL|NATIONAL|INTERNATIONAL|GLOBAL|PLUS|REWARDS|CASHBACK|VALID|THRU|FROM|UNTIL|EXPIRES|EXP|DATE|GOOD|MEMBER|SINCE|CVV|CVC|CID|AUTHORIZED|PROPERTY|RETURN|CUSTOMER|SERVICE|ACCOUNT|SAVING)\b/i;
+function isValidNameLine(text) {
+  'worklet';
+
+  // 1. Clean up whitespace
+  const cleanedText = text.trim();
+
+  // 2. Ignore if it contains any numbers (names don't have digits)
+  if (/\d/.test(cleanedText)) return false;
+
+  // 3. Ignore if it contains common card boilerplate keywords
+  const hasKeywords = CARD_KEYWORDS_REGEX.test(cleanedText);
+  if (hasKeywords) return false;
+
+  // 4. Ignore if it's too short to be a full name (e.g., single letters or noise)
+  if (cleanedText.length < 4 || cleanedText.length > 30) return false;
+  return true;
+}
+export const parseCardData = blocks => {
+  'worklet';
+
+  let cardNumber;
+  let expiryDate = null;
+  let cardholderName;
+
+  // Potential name block lines
+  const potentialNames = [];
+  for (const block of blocks) {
+    const text = block.blockText.trim();
+    // Normalize string to help with matching
+    const normalizedText = text.replace(/[\r\n]+/g, ' ');
+
+    // 1. Extract Card Number
+    // Looks for 13 to 19 digits, possibly separated by spaces or dashes
+    if (!cardNumber) {
+      const cardNumMatch = normalizedText.match(/(?:\d[ -]*?){13,19}/);
+      if (cardNumMatch) {
+        const potentialNumber = cardNumMatch[0].replace(/\D/g, '');
+        if (potentialNumber.length >= 13 && potentialNumber.length <= 19) {
+          cardNumber = potentialNumber;
+          continue; // Skip further parsing on this block if it's the card number
+        }
+      }
+    }
+
+    // 2. Extract Expiry Date (MM/YY or MM/YYYY)
+    if (!expiryDate) {
+      const expiryMatch = normalizedText.match(/\b(0[1-9]|1[0-2])\s*[\/\-]\s*(\d{2}|\d{4})\b/);
+      if (expiryMatch) {
+        expiryDate = `${expiryMatch[1]}/${expiryMatch[2]}`;
+        continue;
+      }
+    }
+
+    // 3. Name heuristics
+    if (isValidNameLine(text)) {
+      potentialNames.push(text);
+    }
+  }
+
+  // Very basic heuristic for name: take the longest block that matches our criteria
+  if (potentialNames.length > 0) {
+    cardholderName = potentialNames.sort((a, b) => b.length - a.length)[0];
+  }
+  return {
+    cardNumber: cardNumber || '',
+    expiryDate,
+    cardholderName,
+    issuer: cardNumber ? getCardIssuer(cardNumber) : 'Unknown'
+  };
+};
+//# sourceMappingURL=parsers.js.map

package/lib/module/utils/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getCardIssuer","CARD_KEYWORDS_REGEX","isValidNameLine","text","cleanedText","trim","test","hasKeywords","length","parseCardData","blocks","cardNumber","expiryDate","cardholderName","potentialNames","block","blockText","normalizedText","replace","cardNumMatch","match","potentialNumber","expiryMatch","push","sort","a","b","issuer"],"sourceRoot":"../../../src","sources":["utils/parsers.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,iBAAc;AAM5C,MAAMC,mBAAmB,GACvB,8YAA8Y;AAEhZ,SAASC,eAAeA,CAACC,IAAY,EAAE;EACrC,SAAS;;EACT;EACA,MAAMC,WAAW,GAAGD,IAAI,CAACE,IAAI,CAAC,CAAC;;EAE/B;EACA,IAAI,IAAI,CAACC,IAAI,CAACF,WAAW,CAAC,EAAE,OAAO,KAAK;;EAExC;EACA,MAAMG,WAAW,GAAGN,mBAAmB,CAACK,IAAI,CAACF,WAAW,CAAC;EACzD,IAAIG,WAAW,EAAE,OAAO,KAAK;;EAE7B;EACA,IAAIH,WAAW,CAACI,MAAM,GAAG,CAAC,IAAIJ,WAAW,CAACI,MAAM,GAAG,EAAE,EAAE,OAAO,KAAK;EAEnE,OAAO,IAAI;AACb;AAEA,OAAO,MAAMC,aAAa,GAAIC,MAAkB,IAA0B;EACxE,SAAS;;EACT,IAAIC,UAA8B;EAClC,IAAIC,UAAyB,GAAG,IAAI;EACpC,IAAIC,cAAkC;;EAEtC;EACA,MAAMC,cAAwB,GAAG,EAAE;EAEnC,KAAK,MAAMC,KAAK,IAAIL,MAAM,EAAE;IAC1B,MAAMP,IAAI,GAAGY,KAAK,CAACC,SAAS,CAACX,IAAI,CAAC,CAAC;IACnC;IACA,MAAMY,cAAc,GAAGd,IAAI,CAACe,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;;IAEpD;IACA;IACA,IAAI,CAACP,UAAU,EAAE;MACf,MAAMQ,YAAY,GAAGF,cAAc,CAACG,KAAK,CAAC,qBAAqB,CAAC;MAChE,IAAID,YAAY,EAAE;QAChB,MAAME,eAAe,GAAGF,YAAY,CAAC,CAAC,CAAC,CAACD,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1D,IAAIG,eAAe,CAACb,MAAM,IAAI,EAAE,IAAIa,eAAe,CAACb,MAAM,IAAI,EAAE,EAAE;UAChEG,UAAU,GAAGU,eAAe;UAC5B,SAAS,CAAC;QACZ;MACF;IACF;;IAEA;IACA,IAAI,CAACT,UAAU,EAAE;MACf,MAAMU,WAAW,GAAGL,cAAc,CAACG,KAAK,CACtC,8CACF,CAAC;MACD,IAAIE,WAAW,EAAE;QACfV,UAAU,GAAG,GAAGU,WAAW,CAAC,CAAC,CAAC,IAAIA,WAAW,CAAC,CAAC,CAAC,EAAE;QAClD;MACF;IACF;;IAEA;IACA,IAAIpB,eAAe,CAACC,IAAI,CAAC,EAAE;MACzBW,cAAc,CAACS,IAAI,CAACpB,IAAI,CAAC;IAC3B;EACF;;EAEA;EACA,IAAIW,cAAc,CAACN,MAAM,GAAG,CAAC,EAAE;IAC7BK,cAAc,GAAGC,cAAc,CAACU,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKA,CAAC,CAAClB,MAAM,GAAGiB,CAAC,CAACjB,MAAM,CAAC,CAAC,CAAC,CAAC;EACxE;EACA,OAAO;IACLG,UAAU,EAAEA,UAAU,IAAI,EAAE;IAC5BC,UAAU;IACVC,cAAc;IACdc,MAAM,EAAEhB,UAAU,GAAGX,aAAa,CAACW,UAAU,CAAC,GAAG;EACnD,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/module/utils/validators.js

@@ -0,0 +1,65 @@
+"use strict";
+
+export const isValidLuhn = cardNumber => {
+  'worklet';
+
+  // Remove all non-digit characters
+  const cleanNumber = cardNumber.replace(/\D/g, '');
+  if (cleanNumber.length === 0) return false;
+  let sum = 0;
+  let isEven = false;
+
+  // Loop from right to left
+  for (let i = cleanNumber.length - 1; i >= 0; i--) {
+    let digit = parseInt(cleanNumber.charAt(i), 10);
+    if (isEven) {
+      digit *= 2;
+      if (digit > 9) {
+        digit -= 9;
+      }
+    }
+    sum += digit;
+    isEven = !isEven;
+  }
+  return sum % 10 === 0;
+};
+export const getCardIssuer = cardNumber => {
+  'worklet';
+
+  const cleanNumber = cardNumber.replace(/\D/g, '');
+
+  // 1. VISA – must come before UnionPay (some 4* UnionPay co-brands exist)
+  if (/^4/.test(cleanNumber)) return 'Visa';
+
+  // 2. MASTERCARD – 51-55 OR 2221-2720
+  if (/^5[1-5]/.test(cleanNumber) || /^(222[1-9]|22[3-9]\d|2[3-6]\d{2}|27[01]\d|2720)/.test(cleanNumber)) return 'Mastercard';
+
+  // 3. AMEX
+  if (/^3[47]/.test(cleanNumber)) return 'Amex';
+
+  // 4. DINERS CLUB – before JCB (both start with 3)
+  if (/^(30[0-5]|3095|36|3[89])/.test(cleanNumber)) return 'Diners Club';
+
+  // 5. JCB – 3528-3589
+  if (/^35(2[89]|[3-8]\d)/.test(cleanNumber)) return 'JCB';
+
+  // 6. MIR (Russia)
+  if (/^220[0-4]/.test(cleanNumber)) return 'Mir';
+
+  // 7. RUPAY – check before Discover (shares 60/65 prefixes)
+  if (/^(508|353|356|652[12]|6[0-9]{3}(?=.*81|.*82)|81[0-9]|82[0-9])/.test(cleanNumber) || /^(508[0-9]|6521|6522)/.test(cleanNumber) || /^(60[2-9]|81|82)/.test(cleanNumber)) return 'RuPay';
+
+  // 8. DISCOVER – 6011, 644-649, 65, 622126-622925
+  if (/^6011/.test(cleanNumber) || /^64[4-9]/.test(cleanNumber) || /^65/.test(cleanNumber) || /^622(1(2[6-9]|[3-9]\d)|[2-8]\d{2}|9([01]\d|2[0-5]))/.test(cleanNumber)) return 'Discover';
+
+  // 9. CHINA UNIONPAY – broad 62 catch (after Discover's 622* check)
+  if (/^62/.test(cleanNumber)) return 'UnionPay';
+
+  // 10. MAESTRO
+  if (/^(5018|5020|5038|5893|6304|6759|676[1-3])/.test(cleanNumber)) return 'Maestro';
+
+  // 11. INSTAPAYMENT
+  if (/^63[7-9]/.test(cleanNumber)) return 'InstaPayment';
+  return 'Unknown';
+};
+//# sourceMappingURL=validators.js.map

package/lib/module/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isValidLuhn","cardNumber","cleanNumber","replace","length","sum","isEven","i","digit","parseInt","charAt","getCardIssuer","test"],"sourceRoot":"../../../src","sources":["utils/validators.ts"],"mappings":";;AAEA,OAAO,MAAMA,WAAW,GAAIC,UAAkB,IAAc;EAC1D,SAAS;;EACT;EACA,MAAMC,WAAW,GAAGD,UAAU,CAACE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;EACjD,IAAID,WAAW,CAACE,MAAM,KAAK,CAAC,EAAE,OAAO,KAAK;EAE1C,IAAIC,GAAG,GAAG,CAAC;EACX,IAAIC,MAAM,GAAG,KAAK;;EAElB;EACA,KAAK,IAAIC,CAAC,GAAGL,WAAW,CAACE,MAAM,GAAG,CAAC,EAAEG,CAAC,IAAI,CAAC,EAAEA,CAAC,EAAE,EAAE;IAChD,IAAIC,KAAK,GAAGC,QAAQ,CAACP,WAAW,CAACQ,MAAM,CAACH,CAAC,CAAC,EAAE,EAAE,CAAC;IAE/C,IAAID,MAAM,EAAE;MACVE,KAAK,IAAI,CAAC;MACV,IAAIA,KAAK,GAAG,CAAC,EAAE;QACbA,KAAK,IAAI,CAAC;MACZ;IACF;IAEAH,GAAG,IAAIG,KAAK;IACZF,MAAM,GAAG,CAACA,MAAM;EAClB;EAEA,OAAOD,GAAG,GAAG,EAAE,KAAK,CAAC;AACvB,CAAC;AAED,OAAO,MAAMM,aAAa,GAAIV,UAAkB,IAA2B;EACzE,SAAS;;EACT,MAAMC,WAAW,GAAGD,UAAU,CAACE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;;EAEjD;EACA,IAAI,IAAI,CAACS,IAAI,CAACV,WAAW,CAAC,EAAE,OAAO,MAAM;;EAEzC;EACA,IACE,SAAS,CAACU,IAAI,CAACV,WAAW,CAAC,IAC3B,iDAAiD,CAACU,IAAI,CAACV,WAAW,CAAC,EAEnE,OAAO,YAAY;;EAErB;EACA,IAAI,QAAQ,CAACU,IAAI,CAACV,WAAW,CAAC,EAAE,OAAO,MAAM;;EAE7C;EACA,IAAI,0BAA0B,CAACU,IAAI,CAACV,WAAW,CAAC,EAAE,OAAO,aAAa;;EAEtE;EACA,IAAI,oBAAoB,CAACU,IAAI,CAACV,WAAW,CAAC,EAAE,OAAO,KAAK;;EAExD;EACA,IAAI,WAAW,CAACU,IAAI,CAACV,WAAW,CAAC,EAAE,OAAO,KAAK;;EAE/C;EACA,IACE,+DAA+D,CAACU,IAAI,CAClEV,WACF,CAAC,IACD,uBAAuB,CAACU,IAAI,CAACV,WAAW,CAAC,IACzC,kBAAkB,CAACU,IAAI,CAACV,WAAW,CAAC,EAEpC,OAAO,OAAO;;EAEhB;EACA,IACE,OAAO,CAACU,IAAI,CAACV,WAAW,CAAC,IACzB,UAAU,CAACU,IAAI,CAACV,WAAW,CAAC,IAC5B,KAAK,CAACU,IAAI,CAACV,WAAW,CAAC,IACvB,qDAAqD,CAACU,IAAI,CAACV,WAAW,CAAC,EAEvE,OAAO,UAAU;;EAEnB;EACA,IAAI,KAAK,CAACU,IAAI,CAACV,WAAW,CAAC,EAAE,OAAO,UAAU;;EAE9C;EACA,IAAI,2CAA2C,CAACU,IAAI,CAACV,WAAW,CAAC,EAC/D,OAAO,SAAS;;EAElB;EACA,IAAI,UAAU,CAACU,IAAI,CAACV,WAAW,CAAC,EAAE,OAAO,cAAc;EAEvD,OAAO,SAAS;AAClB,CAAC","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/components/CreditCardScanner.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { type CreditCardScannerProps } from '../types';
+export declare const CreditCardScanner: React.FC<CreditCardScannerProps>;
+//# sourceMappingURL=CreditCardScanner.d.ts.map

package/lib/typescript/src/components/CreditCardScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreditCardScanner.d.ts","sourceRoot":"","sources":["../../../../src/components/CreditCardScanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAIvD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA8C9D,CAAC"}

package/lib/typescript/src/components/ScannerOverlay.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { type HoleViewConfig } from '../types';
+interface ScannerOverlayProps {
+    color: string;
+    config: HoleViewConfig;
+}
+export declare const ScannerOverlay: React.FC<ScannerOverlayProps>;
+export {};
+//# sourceMappingURL=ScannerOverlay.d.ts.map

package/lib/typescript/src/components/ScannerOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScannerOverlay.d.ts","sourceRoot":"","sources":["../../../../src/components/ScannerOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAgCxD,CAAC"}

package/lib/typescript/src/hooks/useCardScanner.d.ts

@@ -0,0 +1,11 @@
+import { type CardResult, type HoleViewConfig } from '../types';
+interface UseCardScannerProps {
+    onScanSuccess: (result: CardResult) => void;
+    holeViewConfig: HoleViewConfig;
+    parentViewHeight?: number;
+}
+export declare const useCardScanner: ({ onScanSuccess, holeViewConfig, parentViewHeight, }: UseCardScannerProps) => {
+    frameOutput: import("react-native-vision-camera").CameraFrameOutput;
+};
+export {};
+//# sourceMappingURL=useCardScanner.d.ts.map

package/lib/typescript/src/hooks/useCardScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCardScanner.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useCardScanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAKhE,UAAU,mBAAmB;IAC3B,aAAa,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,GAAI,sDAI5B,mBAAmB;;CAmCrB,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './components/CreditCardScanner';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,SAAS,CAAC"}

package/lib/typescript/src/types/index.d.ts

@@ -0,0 +1,35 @@
+import { type ViewStyle, type StyleProp } from 'react-native';
+import { type CameraProps, type CameraRef } from 'react-native-vision-camera';
+export interface CardResult {
+    cardNumber: string;
+    expiryDate: string | null;
+    cardholderName: string | null;
+    issuer: 'Visa' | 'Mastercard' | 'Amex' | 'RuPay' | 'Discover' | 'Diners Club' | 'JCB' | 'Mir' | 'UnionPay' | 'Maestro' | 'InstaPayment' | 'Unknown';
+}
+export interface HoleViewConfig {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface CreditCardScannerProps {
+    /** Ref to controll camera programatically */
+    cameraRef?: React.RefObject<CameraRef | null> | undefined;
+    /** Enables or disables the camera and frame processing */
+    isActive: boolean;
+    /** Callback fired when a valid card is detected (passes Luhn check) */
+    onScanSuccess: (result: CardResult) => void;
+    /** Callback for camera initialization or permission errors */
+    onError?: (error: Error) => void;
+    /** Container style to allow full-screen or partial-screen rendering */
+    style?: StyleProp<ViewStyle>;
+    /** Optional: Customize the HoleView overlay mask */
+    overlayColor?: string;
+    /** Optional: Customize the cutout coordinates */
+    holeViewConfig?: HoleViewConfig;
+    /** Optional: Pass down native camera props (e.g., enable torch) */
+    cameraProps?: Partial<CameraProps>;
+    /** Optional: Pass parent height to align hole view correctly with scan region */
+    parentViewHeight?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE9E,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EACF,MAAM,GACN,YAAY,GACZ,MAAM,GACN,OAAO,GACP,UAAU,GACV,aAAa,GACb,KAAK,GACL,KAAK,GACL,UAAU,GACV,SAAS,GACT,cAAc,GACd,SAAS,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1D,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAElB,uEAAuE;IACvE,aAAa,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAE5C,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAE7B,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,iDAAiD;IACjD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnC,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/lib/typescript/src/utils/parsers.d.ts

@@ -0,0 +1,6 @@
+import { type CardResult } from '../types';
+export interface OCRBlock {
+    blockText: string;
+}
+export declare const parseCardData: (blocks: OCRBlock[]) => Partial<CardResult>;
+//# sourceMappingURL=parsers.d.ts.map

package/lib/typescript/src/utils/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../../../src/utils/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAuBD,eAAO,MAAM,aAAa,GAAI,QAAQ,QAAQ,EAAE,KAAG,OAAO,CAAC,UAAU,CAsDpE,CAAC"}

package/lib/typescript/src/utils/validators.d.ts

@@ -0,0 +1,4 @@
+import { type CardResult } from '../types';
+export declare const isValidLuhn: (cardNumber: string) => boolean;
+export declare const getCardIssuer: (cardNumber: string) => CardResult["issuer"];
+//# sourceMappingURL=validators.d.ts.map

package/lib/typescript/src/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../../src/utils/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,KAAG,OAyBhD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,KAAG,UAAU,CAAC,QAAQ,CAwDrE,CAAC"}

package/package.json

@@ -0,0 +1,137 @@
+{
+  "name": "react-native-credit-card-scanner",
+  "version": "1.0.0",
+  "description": "A high-performance credit card scanning library for React Native",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-credit-card-scanner-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rvibit/react-native-credit-card-scanner"
+  },
+  "author": "ravi singh <singh.ravi488@gmail.com> (https://github.com/rvibit)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/rvibit/react-native-credit-card-scanner/issues"
+  },
+  "homepage": "https://github.com/rvibit/react-native-credit-card-scanner#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^9",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.2.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^30.4.2",
+    "prettier": "^3.8.1",
+    "react": "19.2.3",
+    "react-native": "0.85.0",
+    "react-native-builder-bob": "^0.41.0",
+    "react-native-hole-view": "^5.0.0",
+    "react-native-monorepo-config": "^0.3.3",
+    "react-native-nitro-image": "^0.15.1",
+    "react-native-nitro-modules": "^0.35.9",
+    "react-native-vision-camera": ">=5.0.0",
+    "react-native-vision-camera-ocr-plus": "^2.0.0",
+    "react-native-vision-camera-worklets": "^5.0.11",
+    "react-native-worklets": "*",
+    "turbo": "^2.8.21",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-hole-view": "^5.0.0",
+    "react-native-nitro-image": "^0.15.1",
+    "react-native-nitro-modules": "^0.35.9",
+    "react-native-vision-camera": ">=5.0.0",
+    "react-native-vision-camera-ocr-plus": "*",
+    "react-native-vision-camera-worklets": "^5.0.11",
+    "react-native-worklets": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "eslint"
+    ],
+    "version": "0.62.0"
+  }
+}

package/src/components/CreditCardScanner.tsx

@@ -0,0 +1,63 @@
+import React from 'react';
+import { View, StyleSheet, Text, Dimensions } from 'react-native';
+import { Camera, useCameraDevice } from 'react-native-vision-camera';
+import { useCardScanner } from '../hooks/useCardScanner';
+import { ScannerOverlay } from './ScannerOverlay';
+import { type CreditCardScannerProps } from '../types';
+const width = Dimensions.get('window').width * 0.95;
+const height = width / 1.586;
+
+export const CreditCardScanner: React.FC<CreditCardScannerProps> = ({
+  cameraRef,
+  isActive,
+  onScanSuccess,
+  onError,
+  style,
+  overlayColor = 'rgba(0, 0, 0, 0.6)',
+  holeViewConfig = {
+    left: 10,
+    top: 50,
+    width: width,
+    height: height,
+  },
+  cameraProps,
+  parentViewHeight,
+}) => {
+  const device = useCameraDevice('back');
+  // Custom hook that manages MLKit and the validation pipeline
+  const { frameOutput } = useCardScanner({
+    onScanSuccess,
+    holeViewConfig,
+    parentViewHeight,
+  });
+
+  if (!device) {
+    if (onError) onError(new Error('No back camera device found'));
+    return (
+      <View style={style}>
+        <Text>Camera not available</Text>
+      </View>
+    );
+  }
+
+  return (
+    <View style={[styles.container, style]}>
+      <Camera
+        ref={cameraRef}
+        style={StyleSheet.absoluteFill}
+        device={device}
+        isActive={isActive}
+        outputs={[frameOutput]}
+        {...cameraProps}
+      />
+      <ScannerOverlay color={overlayColor} config={holeViewConfig} />
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    overflow: 'hidden',
+    position: 'relative',
+  },
+});

package/src/components/ScannerOverlay.tsx

@@ -0,0 +1,52 @@
+import React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { RNHoleView } from 'react-native-hole-view';
+import { type HoleViewConfig } from '../types';
+
+interface ScannerOverlayProps {
+  color: string;
+  config: HoleViewConfig;
+}
+
+export const ScannerOverlay: React.FC<ScannerOverlayProps> = ({
+  color,
+  config,
+}) => {
+  return (
+    <View style={StyleSheet.absoluteFill} pointerEvents="none">
+      <RNHoleView
+        style={[StyleSheet.absoluteFill, { backgroundColor: color }]}
+        holes={[
+          {
+            x: config.left,
+            y: config.top,
+            width: config.width,
+            height: config.height,
+            borderRadius: 12,
+          },
+        ]}
+      />
+      {/* Draw a subtle border around the hole cutout */}
+      <View
+        style={[
+          styles.borderOverlay,
+          {
+            left: config.left,
+            top: config.top,
+            width: config.width,
+            height: config.height,
+          },
+        ]}
+      />
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  borderOverlay: {
+    // position: 'absolute',
+    borderWidth: 2,
+    borderColor: 'rgba(255, 255, 255, 0.7)',
+    borderRadius: 12,
+  },
+});

package/src/hooks/useCardScanner.ts

@@ -0,0 +1,56 @@
+import { useTextRecognition } from 'react-native-vision-camera-ocr-plus';
+import { useFrameOutput } from 'react-native-vision-camera';
+import { scheduleOnRN } from 'react-native-worklets';
+import { parseCardData } from '../utils/parsers';
+import { isValidLuhn } from '../utils/validators';
+import { type CardResult, type HoleViewConfig } from '../types';
+import { Dimensions } from 'react-native';
+
+const { width: windowWidth, height: windowHeight } = Dimensions.get('window');
+
+interface UseCardScannerProps {
+  onScanSuccess: (result: CardResult) => void;
+  holeViewConfig: HoleViewConfig;
+  parentViewHeight?: number;
+}
+
+export const useCardScanner = ({
+  onScanSuccess,
+  holeViewConfig,
+  parentViewHeight,
+}: UseCardScannerProps) => {
+  const handleSuccess = (data: CardResult) => {
+    onScanSuccess(data);
+  };
+  const HEIGHT = parentViewHeight ? parentViewHeight : windowHeight;
+  const { scanText } = useTextRecognition({
+    language: 'latin',
+    frameSkipThreshold: 10,
+    scanRegion: {
+      left: `${(holeViewConfig.left / windowWidth) * 100}%`,
+      top: `${(holeViewConfig.top / HEIGHT) * 100}%`,
+      width: `${(holeViewConfig.width / windowWidth) * 100}%`,
+      height: `${(holeViewConfig.height / HEIGHT) * 100}%`,
+    },
+  });
+
+  const frameOutput = useFrameOutput({
+    pixelFormat: 'rgb',
+    onFrame: (frame) => {
+      'worklet';
+
+      const result = scanText(frame);
+      if (result.resultText) {
+        const cardData = parseCardData(result.blocks);
+
+        if (cardData.cardNumber && isValidLuhn(cardData.cardNumber)) {
+          scheduleOnRN(handleSuccess, cardData as CardResult);
+        }
+      }
+
+      frame.dispose();
+    },
+  });
+
+  return { frameOutput };
+};

package/src/index.tsx

@@ -0,0 +1,2 @@
+export * from './components/CreditCardScanner';
+export * from './types';

package/src/types/index.ts

@@ -0,0 +1,56 @@
+import { type ViewStyle, type StyleProp } from 'react-native';
+import { type CameraProps, type CameraRef } from 'react-native-vision-camera';
+
+export interface CardResult {
+  cardNumber: string;
+  expiryDate: string | null; // Format: MM/YY
+  cardholderName: string | null;
+  issuer:
+    | 'Visa'
+    | 'Mastercard'
+    | 'Amex'
+    | 'RuPay'
+    | 'Discover'
+    | 'Diners Club'
+    | 'JCB'
+    | 'Mir'
+    | 'UnionPay'
+    | 'Maestro'
+    | 'InstaPayment'
+    | 'Unknown';
+}
+
+export interface HoleViewConfig {
+  left: number; // Percentages (e.g., 10 for 10%)
+  top: number;
+  width: number;
+  height: number;
+}
+
+export interface CreditCardScannerProps {
+  /** Ref to controll camera programatically */
+  cameraRef?: React.RefObject<CameraRef | null> | undefined;
+  /** Enables or disables the camera and frame processing */
+  isActive: boolean;
+
+  /** Callback fired when a valid card is detected (passes Luhn check) */
+  onScanSuccess: (result: CardResult) => void;
+
+  /** Callback for camera initialization or permission errors */
+  onError?: (error: Error) => void;
+
+  /** Container style to allow full-screen or partial-screen rendering */
+  style?: StyleProp<ViewStyle>;
+
+  /** Optional: Customize the HoleView overlay mask */
+  overlayColor?: string; // Default: 'rgba(0,0,0,0.6)'
+
+  /** Optional: Customize the cutout coordinates */
+  holeViewConfig?: HoleViewConfig;
+
+  /** Optional: Pass down native camera props (e.g., enable torch) */
+  cameraProps?: Partial<CameraProps>;
+
+  /** Optional: Pass parent height to align hole view correctly with scan region */
+  parentViewHeight?: number;
+}

package/src/utils/parsers.ts

@@ -0,0 +1,83 @@
+import { type CardResult } from '../types';
+import { getCardIssuer } from './validators';
+
+export interface OCRBlock {
+  blockText: string;
+}
+
+const CARD_KEYWORDS_REGEX =
+  /\b(VISA|MASTERCARD|DISCOVER|AMERICAN|EXPRESS|AMEX|RUPAY|MAESTRO|CIRRUS|DEBIT|CREDIT|PREPAID|PLATINUM|GOLD|CLASSIC|SIGNATURE|INFINITE|WORLD|ELITE|BUSINESS|CORPORATE|BANK|CARD|SERVICES|FINANCIAL|TRUST|UNION|FEDERAL|NATIONAL|INTERNATIONAL|GLOBAL|PLUS|REWARDS|CASHBACK|VALID|THRU|FROM|UNTIL|EXPIRES|EXP|DATE|GOOD|MEMBER|SINCE|CVV|CVC|CID|AUTHORIZED|PROPERTY|RETURN|CUSTOMER|SERVICE|ACCOUNT|SAVING)\b/i;
+
+function isValidNameLine(text: string) {
+  'worklet';
+  // 1. Clean up whitespace
+  const cleanedText = text.trim();
+
+  // 2. Ignore if it contains any numbers (names don't have digits)
+  if (/\d/.test(cleanedText)) return false;
+
+  // 3. Ignore if it contains common card boilerplate keywords
+  const hasKeywords = CARD_KEYWORDS_REGEX.test(cleanedText);
+  if (hasKeywords) return false;
+
+  // 4. Ignore if it's too short to be a full name (e.g., single letters or noise)
+  if (cleanedText.length < 4 || cleanedText.length > 30) return false;
+
+  return true;
+}
+
+export const parseCardData = (blocks: OCRBlock[]): Partial<CardResult> => {
+  'worklet';
+  let cardNumber: string | undefined;
+  let expiryDate: string | null = null;
+  let cardholderName: string | undefined;
+
+  // Potential name block lines
+  const potentialNames: string[] = [];
+
+  for (const block of blocks) {
+    const text = block.blockText.trim();
+    // Normalize string to help with matching
+    const normalizedText = text.replace(/[\r\n]+/g, ' ');
+
+    // 1. Extract Card Number
+    // Looks for 13 to 19 digits, possibly separated by spaces or dashes
+    if (!cardNumber) {
+      const cardNumMatch = normalizedText.match(/(?:\d[ -]*?){13,19}/);
+      if (cardNumMatch) {
+        const potentialNumber = cardNumMatch[0].replace(/\D/g, '');
+        if (potentialNumber.length >= 13 && potentialNumber.length <= 19) {
+          cardNumber = potentialNumber;
+          continue; // Skip further parsing on this block if it's the card number
+        }
+      }
+    }
+
+    // 2. Extract Expiry Date (MM/YY or MM/YYYY)
+    if (!expiryDate) {
+      const expiryMatch = normalizedText.match(
+        /\b(0[1-9]|1[0-2])\s*[\/\-]\s*(\d{2}|\d{4})\b/
+      );
+      if (expiryMatch) {
+        expiryDate = `${expiryMatch[1]}/${expiryMatch[2]}`;
+        continue;
+      }
+    }
+
+    // 3. Name heuristics
+    if (isValidNameLine(text)) {
+      potentialNames.push(text);
+    }
+  }
+
+  // Very basic heuristic for name: take the longest block that matches our criteria
+  if (potentialNames.length > 0) {
+    cardholderName = potentialNames.sort((a, b) => b.length - a.length)[0];
+  }
+  return {
+    cardNumber: cardNumber || '',
+    expiryDate,
+    cardholderName,
+    issuer: cardNumber ? getCardIssuer(cardNumber) : 'Unknown',
+  };
+};

package/src/utils/validators.ts

@@ -0,0 +1,86 @@
+import { type CardResult } from '../types';
+
+export const isValidLuhn = (cardNumber: string): boolean => {
+  'worklet';
+  // Remove all non-digit characters
+  const cleanNumber = cardNumber.replace(/\D/g, '');
+  if (cleanNumber.length === 0) return false;
+
+  let sum = 0;
+  let isEven = false;
+
+  // Loop from right to left
+  for (let i = cleanNumber.length - 1; i >= 0; i--) {
+    let digit = parseInt(cleanNumber.charAt(i), 10);
+
+    if (isEven) {
+      digit *= 2;
+      if (digit > 9) {
+        digit -= 9;
+      }
+    }
+
+    sum += digit;
+    isEven = !isEven;
+  }
+
+  return sum % 10 === 0;
+};
+
+export const getCardIssuer = (cardNumber: string): CardResult['issuer'] => {
+  'worklet';
+  const cleanNumber = cardNumber.replace(/\D/g, '');
+
+  // 1. VISA – must come before UnionPay (some 4* UnionPay co-brands exist)
+  if (/^4/.test(cleanNumber)) return 'Visa';
+
+  // 2. MASTERCARD – 51-55 OR 2221-2720
+  if (
+    /^5[1-5]/.test(cleanNumber) ||
+    /^(222[1-9]|22[3-9]\d|2[3-6]\d{2}|27[01]\d|2720)/.test(cleanNumber)
+  )
+    return 'Mastercard';
+
+  // 3. AMEX
+  if (/^3[47]/.test(cleanNumber)) return 'Amex';
+
+  // 4. DINERS CLUB – before JCB (both start with 3)
+  if (/^(30[0-5]|3095|36|3[89])/.test(cleanNumber)) return 'Diners Club';
+
+  // 5. JCB – 3528-3589
+  if (/^35(2[89]|[3-8]\d)/.test(cleanNumber)) return 'JCB';
+
+  // 6. MIR (Russia)
+  if (/^220[0-4]/.test(cleanNumber)) return 'Mir';
+
+  // 7. RUPAY – check before Discover (shares 60/65 prefixes)
+  if (
+    /^(508|353|356|652[12]|6[0-9]{3}(?=.*81|.*82)|81[0-9]|82[0-9])/.test(
+      cleanNumber
+    ) ||
+    /^(508[0-9]|6521|6522)/.test(cleanNumber) ||
+    /^(60[2-9]|81|82)/.test(cleanNumber)
+  )
+    return 'RuPay';
+
+  // 8. DISCOVER – 6011, 644-649, 65, 622126-622925
+  if (
+    /^6011/.test(cleanNumber) ||
+    /^64[4-9]/.test(cleanNumber) ||
+    /^65/.test(cleanNumber) ||
+    /^622(1(2[6-9]|[3-9]\d)|[2-8]\d{2}|9([01]\d|2[0-5]))/.test(cleanNumber)
+  )
+    return 'Discover';
+
+  // 9. CHINA UNIONPAY – broad 62 catch (after Discover's 622* check)
+  if (/^62/.test(cleanNumber)) return 'UnionPay';
+
+  // 10. MAESTRO
+  if (/^(5018|5020|5038|5893|6304|6759|676[1-3])/.test(cleanNumber))
+    return 'Maestro';
+
+  // 11. INSTAPAYMENT
+  if (/^63[7-9]/.test(cleanNumber)) return 'InstaPayment';
+
+  return 'Unknown';
+};