@vppos/react-native-nfc 1.0.0

package/package.json

@@ -0,0 +1,155 @@
+{
+  "name": "@vppos/react-native-nfc",
+  "version": "1.0.0",
+  "description": "react-native-nfc",
+  "source": "./src/index.tsx",
+  "main": "./lib/module/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "vendor",
+    "*.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-nfc-sdk-example",
+    "test": "jest",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "release": "release-it"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trnguyen5885/react-native-nfc-sdk.git"
+  },
+  "author": "trnguyen5885 <trungnguyenk4.it@gmail.com> (https://github.com/trnguyen5885)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/trnguyen5885/react-native-nfc-sdk/issues"
+  },
+  "homepage": "https://github.com/trnguyen5885/react-native-nfc-sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.6.0",
+    "@eslint/compat": "^1.2.7",
+    "@eslint/eslintrc": "^3.3.0",
+    "@eslint/js": "^9.22.0",
+    "@evilmartians/lefthook": "^1.5.0",
+    "@react-native/eslint-config": "^0.78.0",
+    "@release-it/conventional-changelog": "^9.0.2",
+    "@types/jest": "^29.5.5",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.6.1",
+    "del-cli": "^5.1.0",
+    "eslint": "^9.22.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-prettier": "^5.2.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.3",
+    "react": "19.2.3",
+    "react-native": "0.85.3",
+    "react-native-builder-bob": "^0.38.3",
+    "release-it": "^17.10.0",
+    "turbo": "^1.10.7",
+    "typescript": "^5.2.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "create-react-native-library": {
+    "type": "legacy-module",
+    "languages": "kotlin-swift",
+    "version": "0.49.3"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,6 @@
+export class NFCSDKError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'NFCSDKError';
+  }
+}

package/src/index.tsx

@@ -0,0 +1,141 @@
+/**
+ * react-native-nfc-sdk — Đọc thông tin CCCD qua chip NFC.
+ *
+ * @example
+ * ```ts
+ * import { NFCSDK, type NFCScanResult } from 'react-native-nfc-sdk';
+ *
+ * // Lắng nghe kết quả
+ * const sub = NFCSDK.onScanResult((result) => {
+ *   console.log(result.fullName, result.citizenId);
+ * });
+ *
+ * // Quét
+ * NFCSDK.startScan({ citizenId: '001234567890' });
+ *
+ * // Cleanup
+ * sub.remove();
+ * ```
+ *
+ * @packageDocumentation
+ * @module react-native-nfc-sdk
+ */
+
+import {
+  NativeEventEmitter,
+  NativeModules,
+  Platform,
+  type EmitterSubscription,
+} from 'react-native';
+
+import { NFCSDKError } from './errors';
+import type { NFCProgressEvent, NFCScanResult } from './types';
+
+const MODULE_NAME = 'NFCSDK';
+
+const LINKING_ERROR =
+  `'react-native-nfc-sdk' is not linked. ` +
+  Platform.select({ ios: "Run 'pod install'. ", default: '' }) +
+  'Rebuild your app after installing.';
+
+const nativeModule = NativeModules[MODULE_NAME];
+const emitter = nativeModule
+  ? new NativeEventEmitter(NativeModules[MODULE_NAME])
+  : null;
+
+function requireModule() {
+  if (!nativeModule) {
+    throw new NFCSDKError(LINKING_ERROR);
+  }
+  return nativeModule;
+}
+
+function requireEmitter() {
+  if (!emitter) {
+    throw new NFCSDKError(`${MODULE_NAME} event emitter unavailable.`);
+  }
+  return emitter;
+}
+
+export { NFCSDKError } from './errors';
+export type { NFCProgressEvent, NFCScanResult } from './types';
+
+/**
+ * NFC SDK — API chính để đọc CCCD qua chip NFC.
+ *
+ * @example
+ * ```ts
+ * // 1. Lắng nghe kết quả (trong useEffect)
+ * const resultSub = NFCSDK.onScanResult((result) => {
+ *   console.log(result.fullName, result.citizenId);
+ * });
+ * const progressSub = NFCSDK.onProgress((e) => {
+ *   console.log(`${e.progress}% - ${e.message}`);
+ * });
+ *
+ * // 2. Bắt đầu quét
+ * NFCSDK.startScan({ citizenId: '001234567890' });
+ *
+ * // 3. Cleanup khi unmount
+ * resultSub.remove();
+ * progressSub.remove();
+ * ```
+ */
+export const NFCSDK = {
+  /** Kiểm tra SDK có sẵn sàng không. */
+  isAvailable(): boolean {
+    return !!nativeModule && typeof nativeModule.startNfcScan === 'function';
+  },
+
+  /**
+   * Bắt đầu quét NFC để đọc thông tin CCCD.
+   *
+   * @param options - Object chứa `citizenId` (số CCCD, tối thiểu 6 ký tự)
+   * @throws {NFCSDKError} Nếu module chưa link hoặc citizenId không hợp lệ
+   */
+  startScan(options: { citizenId: string }): void {
+    const mod = requireModule();
+    const id = options.citizenId.trim();
+
+    if (id.length < 6) {
+      throw new NFCSDKError('citizenId must be at least 6 characters.');
+    }
+
+    mod.setCitizenId(id);
+    mod.startNfcScan();
+  },
+
+  /**
+   * Lắng nghe kết quả quét NFC.
+   * Gọi `.remove()` trên subscription để hủy.
+   *
+   * @param listener - Callback nhận `NFCScanResult`
+   * @returns EmitterSubscription
+   * @throws {NFCSDKError} Nếu event emitter không khả dụng
+   */
+  onScanResult(listener: (result: NFCScanResult) => void): EmitterSubscription {
+    return requireEmitter().addListener('onNfcCompleted', listener);
+  },
+
+  /**
+   * Lắng nghe tiến trình quét (0–100%).
+   * Gọi `.remove()` trên subscription để hủy.
+   *
+   * @param listener - Callback nhận `NFCProgressEvent`
+   * @returns EmitterSubscription
+   * @throws {NFCSDKError} Nếu event emitter không khả dụng
+   */
+  onProgress(listener: (event: NFCProgressEvent) => void): EmitterSubscription {
+    return requireEmitter().addListener(
+      'onNfcProgress',
+      (raw: Record<string, unknown>) => {
+        listener({
+          progress: Math.round(Number(raw?.progress ?? 0)),
+          message: String(raw?.message ?? ''),
+        });
+      }
+    );
+  },
+};
+
+export default NFCSDK;

package/src/types.ts

@@ -0,0 +1,45 @@
+/** Sự kiện tiến trình quét NFC. */
+export type NFCProgressEvent = {
+  /** Phần trăm hoàn thành (0–100). */
+  progress: number;
+  /** Mô tả bước đang thực hiện. */
+  message: string;
+};
+
+/** Kết quả quét CCCD qua NFC. */
+export type NFCScanResult = {
+  /** Số CCCD. */
+  citizenId?: string;
+  /** Họ và tên. */
+  fullName?: string;
+  /** Ngày sinh (DD/MM/YYYY). */
+  dob?: string;
+  /** Giới tính (Nam/Nữ/Khác). */
+  gender?: string;
+  /** Quốc tịch. */
+  nationality?: string;
+  /** Địa chỉ thường trú. */
+  permanentAddress?: string;
+  /** Ngày cấp (DD/MM/YYYY). */
+  issueDate?: string;
+  /** Nơi cấp. */
+  issuePlace?: string;
+  /** Ngày hết hạn (DD/MM/YYYY). */
+  expireDate?: string;
+  /** Ảnh chân dung từ chip (Base64). */
+  imageFromChip?: string;
+  /** Ảnh mặt trước thẻ (Base64). */
+  frontCardBase64?: string;
+  /** Ảnh mặt sau thẻ (Base64). */
+  backCardBase64?: string;
+  /** DG1 raw data (Base64). */
+  dg1DataB64?: string;
+  /** DG2 raw data (Base64). */
+  dg2DataB64?: string;
+  /** DG13 raw data (Base64). */
+  dg13DataB64?: string;
+  /** DG14 raw data (Base64). */
+  dg14DataB64?: string;
+  /** SOD security data (Base64). */
+  sodData?: string;
+};