@digitalshieldfe/react-native-backup-card-sdk 0.1.4 → 0.1.6

package/lib/module/NativeBackupCardSdk.js

@@ -1,5 +1,8 @@
 "use strict";
 
 import { TurboModuleRegistry } from 'react-native';
+
+/** App-layer result type (same pattern as react-native-lite-card PromiseResult). */
+
 export default TurboModuleRegistry.getEnforcing('BackupCardSdk');
 //# sourceMappingURL=NativeBackupCardSdk.js.map

package/lib/module/NativeBackupCardSdk.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBackupCardSdk.ts"],"mappings":";;AAAA,SACEA,mBAAmB,QAGd,cAAc;AAgCrB,eAAeA,mBAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBackupCardSdk.ts"],"mappings":";;AAAA,SACEA,mBAAmB,QAGd,cAAc;;AAWrB;;AA+EA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}

package/lib/module/cardOperations.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import BackupCardSdk from "./NativeBackupCardSdk.js";
+function withoutData(result) {
+  return {
+    error: result.error,
+    cardInfo: result.cardInfo,
+    resultCode: result.resultCode,
+    data: null
+  };
+}
+export async function activateCard(pwd, serialNumber) {
+  return withoutData(await BackupCardSdk.activateCard(pwd, serialNumber));
+}
+export async function checkSlotEmpty(slotId, pwd) {
+  return withoutData(await BackupCardSdk.checkSlotEmpty(slotId, pwd));
+}
+export async function writeSlot(slotIndex, data, pwd) {
+  return withoutData(await BackupCardSdk.writeSlot(slotIndex, data, pwd));
+}
+export async function readSlot(slotIndex, pwd) {
+  return BackupCardSdk.readSlot(slotIndex, pwd);
+}
+export async function deleteSlot(slotIndex, pwd) {
+  return withoutData(await BackupCardSdk.deleteSlot(slotIndex, pwd));
+}
+//# sourceMappingURL=cardOperations.js.map

package/lib/module/cardOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BackupCardSdk","withoutData","result","error","cardInfo","resultCode","data","activateCard","pwd","serialNumber","checkSlotEmpty","slotId","writeSlot","slotIndex","readSlot","deleteSlot"],"sourceRoot":"../../src","sources":["cardOperations.ts"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,0BAAuB;AAejD,SAASC,WAAWA,CAClBC,MAAiC,EACN;EAC3B,OAAO;IACLC,KAAK,EAAED,MAAM,CAACC,KAAK;IACnBC,QAAQ,EAAEF,MAAM,CAACE,QAAQ;IACzBC,UAAU,EAAEH,MAAM,CAACG,UAAU;IAC7BC,IAAI,EAAE;EACR,CAAC;AACH;AAEA,OAAO,eAAeC,YAAYA,CAChCC,GAAW,EACXC,YAAoB,EACgB;EACpC,OAAOR,WAAW,CAAC,MAAMD,aAAa,CAACO,YAAY,CAACC,GAAG,EAAEC,YAAY,CAAC,CAAC;AACzE;AAEA,OAAO,eAAeC,cAAcA,CAClCC,MAAc,EACdH,GAAW,EACyB;EACpC,OAAOP,WAAW,CAAC,MAAMD,aAAa,CAACU,cAAc,CAACC,MAAM,EAAEH,GAAG,CAAC,CAAC;AACrE;AAEA,OAAO,eAAeI,SAASA,CAC7BC,SAAiB,EACjBP,IAAmB,EACnBE,GAAW,EACyB;EACpC,OAAOP,WAAW,CAAC,MAAMD,aAAa,CAACY,SAAS,CAACC,SAAS,EAAEP,IAAI,EAAEE,GAAG,CAAC,CAAC;AACzE;AAEA,OAAO,eAAeM,QAAQA,CAC5BD,SAAiB,EACjBL,GAAW,EAC2B;EACtC,OAAOR,aAAa,CAACc,QAAQ,CAACD,SAAS,EAAEL,GAAG,CAAC;AAC/C;AAEA,OAAO,eAAeO,UAAUA,CAC9BF,SAAiB,EACjBL,GAAW,EACyB;EACpC,OAAOP,WAAW,CAAC,MAAMD,aAAa,CAACe,UAAU,CAACF,SAAS,EAAEL,GAAG,CAAC,CAAC;AACpE","ignoreList":[]}

package/lib/module/index.js

@@ -1,5 +1,7 @@
 "use strict";
 
 import BackupCardSdk from "./NativeBackupCardSdk.js";
+export { CardErrors, cancelNfcWait, checkNFCPermission, intoSetting } from "./nfc.js";
+export { activateCard, checkSlotEmpty, deleteSlot, readSlot, writeSlot } from "./cardOperations.js";
 export default BackupCardSdk;
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["BackupCardSdk"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,0BAAuB;AAGjD,eAAeA,aAAa","ignoreList":[]}
+{"version":3,"names":["BackupCardSdk","CardErrors","cancelNfcWait","checkNFCPermission","intoSetting","activateCard","checkSlotEmpty","deleteSlot","readSlot","writeSlot"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,0BAAuB;AASjD,SACEC,UAAU,EACVC,aAAa,EACbC,kBAAkB,EAClBC,WAAW,QACN,UAAO;AACd,SACEC,YAAY,EACZC,cAAc,EACdC,UAAU,EACVC,QAAQ,EACRC,SAAS,QACJ,qBAAkB;AAEzB,eAAeT,aAAa","ignoreList":[]}

package/lib/module/nfc.js

@@ -0,0 +1,75 @@
+"use strict";
+
+import { Platform } from 'react-native';
+import BackupCardSdk from "./NativeBackupCardSdk.js";
+/** Same error codes as @digitalshieldfe/react-native-lite-card for NFC checks. */
+export let CardErrors = /*#__PURE__*/function (CardErrors) {
+  CardErrors[CardErrors["InitChannel"] = 1000] = "InitChannel";
+  CardErrors[CardErrors["NotExistsNFC"] = 1001] = "NotExistsNFC";
+  CardErrors[CardErrors["NotEnableNFC"] = 1002] = "NotEnableNFC";
+  CardErrors[CardErrors["NotNFCPermission"] = 1003] = "NotNFCPermission";
+  CardErrors[CardErrors["ConnectionFail"] = 2001] = "ConnectionFail";
+  CardErrors[CardErrors["NotSameNFCLite"] = 2002] = "NotSameNFCLite";
+  CardErrors[CardErrors["ActivateCardFailed"] = 2003] = "ActivateCardFailed";
+  CardErrors[CardErrors["NotSupportedCard"] = 2004] = "NotSupportedCard";
+  CardErrors[CardErrors["PasswordWrong"] = 2005] = "PasswordWrong";
+  CardErrors[CardErrors["NotSetPassword"] = 2006] = "NotSetPassword";
+  CardErrors[CardErrors["CardLock"] = 2007] = "CardLock";
+  CardErrors[CardErrors["NotInitializedError"] = 2008] = "NotInitializedError";
+  CardErrors[CardErrors["InitializedError"] = 4001] = "InitializedError";
+  return CardErrors;
+}({});
+function parseTurboModuleError(error) {
+  const err = error;
+  const code = err?.userInfo?.code;
+  if (typeof code === 'number') {
+    return {
+      code,
+      message: err.userInfo?.message ?? err.message ?? null
+    };
+  }
+  return {
+    code: CardErrors.InitChannel,
+    message: err?.message ?? null
+  };
+}
+
+/** Android only for now; iOS will be added later. */
+export function checkNFCPermission() {
+  if (Platform.OS !== 'android') {
+    return Promise.resolve({
+      error: {
+        code: CardErrors.InitChannel,
+        message: 'checkNFCPermission is not implemented on iOS yet'
+      },
+      data: null,
+      cardInfo: null,
+      resultCode: -1
+    });
+  }
+  return BackupCardSdk.checkNFCPermission().then(() => ({
+    error: null,
+    data: true,
+    cardInfo: null,
+    resultCode: 0
+  })).catch(error => ({
+    error: parseTurboModuleError(error),
+    data: null,
+    cardInfo: null,
+    resultCode: -1
+  }));
+}
+
+/** Android only for now; iOS will be added later. */
+export function intoSetting() {
+  if (Platform.OS !== 'android') {
+    return;
+  }
+  BackupCardSdk.intoSetting();
+}
+
+/** Call when user dismisses the "tap card" UI to stop waiting. Android only. */
+export function cancelNfcWait() {
+  BackupCardSdk.cancelNfcWait();
+}
+//# sourceMappingURL=nfc.js.map

package/lib/module/nfc.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","BackupCardSdk","CardErrors","parseTurboModuleError","error","err","code","userInfo","message","InitChannel","checkNFCPermission","OS","Promise","resolve","data","cardInfo","resultCode","then","catch","intoSetting","cancelNfcWait"],"sourceRoot":"../../src","sources":["nfc.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AAEvC,OAAOC,aAAa,MAAM,0BAAuB;AAMjD;AACA,WAAYC,UAAU,0BAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAA,OAAVA,UAAU;AAAA;AAkBtB,SAASC,qBAAqBA,CAACC,KAAc,EAAiB;EAC5D,MAAMC,GAAG,GAAGD,KAGX;EACD,MAAME,IAAI,GAAGD,GAAG,EAAEE,QAAQ,EAAED,IAAI;EAChC,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;IAC5B,OAAO;MAAEA,IAAI;MAAEE,OAAO,EAAEH,GAAG,CAACE,QAAQ,EAAEC,OAAO,IAAIH,GAAG,CAACG,OAAO,IAAI;IAAK,CAAC;EACxE;EACA,OAAO;IAAEF,IAAI,EAAEJ,UAAU,CAACO,WAAW;IAAED,OAAO,EAAEH,GAAG,EAAEG,OAAO,IAAI;EAAK,CAAC;AACxE;;AAEA;AACA,OAAO,SAASE,kBAAkBA,CAAA,EAAoC;EACpE,IAAIV,QAAQ,CAACW,EAAE,KAAK,SAAS,EAAE;IAC7B,OAAOC,OAAO,CAACC,OAAO,CAAC;MACrBT,KAAK,EAAE;QACLE,IAAI,EAAEJ,UAAU,CAACO,WAAW;QAC5BD,OAAO,EAAE;MACX,CAAC;MACDM,IAAI,EAAE,IAAI;MACVC,QAAQ,EAAE,IAAI;MACdC,UAAU,EAAE,CAAC;IACf,CAAC,CAAC;EACJ;EACA,OAAOf,aAAa,CAACS,kBAAkB,CAAC,CAAC,CACtCO,IAAI,CAAC,OAAO;IAAEb,KAAK,EAAE,IAAI;IAAEU,IAAI,EAAE,IAAI;IAAEC,QAAQ,EAAE,IAAI;IAAEC,UAAU,EAAE;EAAE,CAAC,CAAC,CAAC,CACxEE,KAAK,CAAEd,KAAc,KAAM;IAC1BA,KAAK,EAAED,qBAAqB,CAACC,KAAK,CAAC;IACnCU,IAAI,EAAE,IAAI;IACVC,QAAQ,EAAE,IAAI;IACdC,UAAU,EAAE,CAAC;EACf,CAAC,CAAC,CAAC;AACP;;AAEA;AACA,OAAO,SAASG,WAAWA,CAAA,EAAS;EAClC,IAAInB,QAAQ,CAACW,EAAE,KAAK,SAAS,EAAE;IAC7B;EACF;EACAV,aAAa,CAACkB,WAAW,CAAC,CAAC;AAC7B;;AAEA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAS;EACpCnB,aAAa,CAACmB,aAAa,CAAC,CAAC;AAC/B","ignoreList":[]}

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

@@ -3,15 +3,61 @@ export type CardInfo = {
     serialNumber: string | null;
     pinRetryCount: number | null;
     isNewCard: boolean | null;
+    isBackup: boolean | null;
 };
+export type CallbackError = {
+    code: number;
+    message: string | null;
+};
+/** App-layer result type (same pattern as react-native-lite-card PromiseResult). */
+export type PromiseResult<T> = {
+    error: CallbackError | null;
+    data: T | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+};
+export type CardOperationResult<T> = PromiseResult<T>;
 export interface Spec extends TurboModule {
+    /** Waits for user to tap the backup card (Android), then reads card info. */
     getCardInfo(): Promise<CardInfo | null>;
+    /** Cancels an in-flight wait for NFC tap (Android). */
+    cancelNfcWait(): void;
+    /** Android: hardware NFC, system switch, MIUI permission. iOS: not implemented yet. */
+    checkNFCPermission(): Promise<boolean>;
+    /** Android: opens system NFC settings. iOS: not implemented yet. */
+    intoSetting(): void;
     resetCard(): Promise<Boolean>;
-    activateCard(pwd: string): Promise<Boolean>;
+    activateCard(pwd: string, serialNumber: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
     changePin(oldPin: string, newPin: string): Promise<Boolean>;
-    checkSlotEmpty(slotId: number, pwd: string): Promise<Boolean>;
-    writeSlot(slotIndex: number, data: Array<number>, pwd: string): Promise<Boolean>;
-    readSlot(slotIndex: number, pwd: string): Promise<Array<number> | null>;
+    checkSlotEmpty(slotId: number, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
+    writeSlot(slotIndex: number, data: Array<number>, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
+    readSlot(slotIndex: number, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
+    deleteSlot(slotIndex: number, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
     readonly onApduLog: CodegenTypes.EventEmitter<{
         message: string;
         isSent: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"NativeBackupCardSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeBackupCardSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAExE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;QAC7C,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;CACJ;;AAED,wBAAuE"}
+{"version":3,"file":"NativeBackupCardSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeBackupCardSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAErE,oFAAoF;AACpF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;AAEtD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,6EAA6E;IAC7E,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxC,uDAAuD;IACvD,aAAa,IAAI,IAAI,CAAC;IACtB,uFAAuF;IACvF,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,oEAAoE;IACpE,WAAW,IAAI,IAAI,CAAC;IACpB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,YAAY,CACV,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QACT,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;QAC5B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC,CAAC;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QACT,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;QAC5B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC,CAAC;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QACT,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;QAC5B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC,CAAC;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QACT,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;QAC5B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC,CAAC;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QACT,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;QAC5B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;QAC7C,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;CACJ;;AAED,wBAAuE"}

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

@@ -0,0 +1,7 @@
+import type { CardOperationResult } from './NativeBackupCardSdk';
+export declare function activateCard(pwd: string, serialNumber: string): Promise<CardOperationResult<null>>;
+export declare function checkSlotEmpty(slotId: number, pwd: string): Promise<CardOperationResult<null>>;
+export declare function writeSlot(slotIndex: number, data: Array<number>, pwd: string): Promise<CardOperationResult<null>>;
+export declare function readSlot(slotIndex: number, pwd: string): Promise<CardOperationResult<string>>;
+export declare function deleteSlot(slotIndex: number, pwd: string): Promise<CardOperationResult<null>>;
+//# sourceMappingURL=cardOperations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cardOperations.d.ts","sourceRoot":"","sources":["../../../src/cardOperations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAoB/B,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAEtC;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC"}

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

@@ -1,5 +1,8 @@
 import BackupCardSdk from './NativeBackupCardSdk';
-import type { CardInfo } from './NativeBackupCardSdk';
-export type { CardInfo };
+import type { CardInfo, CardOperationResult, PromiseResult } from './NativeBackupCardSdk';
+export type { CardInfo, CardOperationResult, PromiseResult };
+export type { CallbackError } from './nfc';
+export { CardErrors, cancelNfcWait, checkNFCPermission, intoSetting, } from './nfc';
+export { activateCard, checkSlotEmpty, deleteSlot, readSlot, writeSlot, } from './cardOperations';
 export default BackupCardSdk;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,CAAC;AACzB,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,OAAO,CAAC;AACf,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { PromiseResult } from './NativeBackupCardSdk';
+export type CallbackError = {
+    code: number;
+    message: string | null;
+} | null;
+/** Same error codes as @digitalshieldfe/react-native-lite-card for NFC checks. */
+export declare enum CardErrors {
+    InitChannel = 1000,
+    NotExistsNFC = 1001,
+    NotEnableNFC = 1002,
+    NotNFCPermission = 1003,
+    ConnectionFail = 2001,
+    NotSameNFCLite = 2002,
+    ActivateCardFailed = 2003,
+    NotSupportedCard = 2004,
+    PasswordWrong = 2005,
+    NotSetPassword = 2006,
+    CardLock = 2007,
+    NotInitializedError = 2008,
+    InitializedError = 4001
+}
+/** Android only for now; iOS will be added later. */
+export declare function checkNFCPermission(): Promise<PromiseResult<boolean>>;
+/** Android only for now; iOS will be added later. */
+export declare function intoSetting(): void;
+/** Call when user dismisses the "tap card" UI to stop waiting. Android only. */
+export declare function cancelNfcWait(): void;
+//# sourceMappingURL=nfc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nfc.d.ts","sourceRoot":"","sources":["../../../src/nfc.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC;AAE5E,kFAAkF;AAClF,oBAAY,UAAU;IACpB,WAAW,OAAO;IAClB,YAAY,OAAO;IACnB,YAAY,OAAO;IACnB,gBAAgB,OAAO;IAEvB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,gBAAgB,OAAO;IACvB,aAAa,OAAO;IACpB,cAAc,OAAO;IACrB,QAAQ,OAAO;IACf,mBAAmB,OAAO;IAE1B,gBAAgB,OAAO;CACxB;AAcD,qDAAqD;AACrD,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAoBpE;AAED,qDAAqD;AACrD,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED,gFAAgF;AAChF,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@digitalshieldfe/react-native-backup-card-sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "ds react-native backup-card sdk",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
     ".": {
-      "source": "./src/index.tsx",
       "types": "./lib/typescript/src/index.d.ts",
+      "react-native": "./src/index.tsx",
       "default": "./lib/module/index.js"
     },
     "./package.json": "./package.json"
@@ -33,7 +33,9 @@
   ],
   "scripts": {
     "example": "yarn workspace react-native-backup-card-sdk-example",
-    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "clean": "del-cli android/build android/libs/*.aar example/android/build example/android/app/build example/ios/build lib",
+    "build:android-aar": "bash scripts/build-android-aar.sh",
+    "prepack": "npm run build:android-aar && bob build",
     "prepare": "bob build",
     "typecheck": "tsc",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
@@ -58,7 +60,8 @@
   },
   "homepage": "https://www.ds.com#readme",
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
   },
   "devDependencies": {
     "@commitlint/config-conventional": "^20.5.0",
@@ -70,7 +73,6 @@
     "@react-native/eslint-config": "0.85.1",
     "@react-native/jest-preset": "0.85.1",
     "@release-it/conventional-changelog": "^10.0.6",
-    "@types/node": "^25.9.1",
     "@types/react": "^19.2.0",
     "commitlint": "^20.5.0",
     "del-cli": "^7.0.0",

package/src/NativeBackupCardSdk.ts

@@ -8,20 +8,78 @@ export type CardInfo = {
   serialNumber: string | null;
   pinRetryCount: number | null;
   isNewCard: boolean | null;
+  isBackup: boolean | null;
 };
 
+export type CallbackError = { code: number; message: string | null };
+
+/** App-layer result type (same pattern as react-native-lite-card PromiseResult). */
+export type PromiseResult<T> = {
+  error: CallbackError | null;
+  data: T | null;
+  cardInfo: CardInfo | null;
+  resultCode: number;
+};
+
+export type CardOperationResult<T> = PromiseResult<T>;
+
 export interface Spec extends TurboModule {
+  /** Waits for user to tap the backup card (Android), then reads card info. */
   getCardInfo(): Promise<CardInfo | null>;
+  /** Cancels an in-flight wait for NFC tap (Android). */
+  cancelNfcWait(): void;
+  /** Android: hardware NFC, system switch, MIUI permission. iOS: not implemented yet. */
+  checkNFCPermission(): Promise<boolean>;
+  /** Android: opens system NFC settings. iOS: not implemented yet. */
+  intoSetting(): void;
   resetCard(): Promise<Boolean>;
-  activateCard(pwd: string): Promise<Boolean>;
+  activateCard(
+    pwd: string,
+    serialNumber: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
   changePin(oldPin: string, newPin: string): Promise<Boolean>;
-  checkSlotEmpty(slotId: number, pwd: string): Promise<Boolean>;
+  checkSlotEmpty(
+    slotId: number,
+    pwd: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
   writeSlot(
     slotIndex: number,
     data: Array<number>,
     pwd: string
-  ): Promise<Boolean>;
-  readSlot(slotIndex: number, pwd: string): Promise<Array<number> | null>;
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
+  readSlot(
+    slotIndex: number,
+    pwd: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
+  deleteSlot(
+    slotIndex: number,
+    pwd: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
 
   readonly onApduLog: CodegenTypes.EventEmitter<{
     message: string;

package/src/cardOperations.ts

@@ -0,0 +1,61 @@
+import BackupCardSdk from './NativeBackupCardSdk';
+
+import type {
+  CallbackError,
+  CardInfo,
+  CardOperationResult,
+} from './NativeBackupCardSdk';
+
+type NativeCardOperationResult = {
+  error: CallbackError | null;
+  cardInfo: CardInfo | null;
+  resultCode: number;
+  data: string | null;
+};
+
+function withoutData(
+  result: NativeCardOperationResult
+): CardOperationResult<null> {
+  return {
+    error: result.error,
+    cardInfo: result.cardInfo,
+    resultCode: result.resultCode,
+    data: null,
+  };
+}
+
+export async function activateCard(
+  pwd: string,
+  serialNumber: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.activateCard(pwd, serialNumber));
+}
+
+export async function checkSlotEmpty(
+  slotId: number,
+  pwd: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.checkSlotEmpty(slotId, pwd));
+}
+
+export async function writeSlot(
+  slotIndex: number,
+  data: Array<number>,
+  pwd: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.writeSlot(slotIndex, data, pwd));
+}
+
+export async function readSlot(
+  slotIndex: number,
+  pwd: string
+): Promise<CardOperationResult<string>> {
+  return BackupCardSdk.readSlot(slotIndex, pwd);
+}
+
+export async function deleteSlot(
+  slotIndex: number,
+  pwd: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.deleteSlot(slotIndex, pwd));
+}

package/src/index.tsx

@@ -1,4 +1,24 @@
 import BackupCardSdk from './NativeBackupCardSdk';
-import type { CardInfo } from './NativeBackupCardSdk';
-export type { CardInfo };
+import type {
+  CardInfo,
+  CardOperationResult,
+  PromiseResult,
+} from './NativeBackupCardSdk';
+
+export type { CardInfo, CardOperationResult, PromiseResult };
+export type { CallbackError } from './nfc';
+export {
+  CardErrors,
+  cancelNfcWait,
+  checkNFCPermission,
+  intoSetting,
+} from './nfc';
+export {
+  activateCard,
+  checkSlotEmpty,
+  deleteSlot,
+  readSlot,
+  writeSlot,
+} from './cardOperations';
+
 export default BackupCardSdk;

package/src/nfc.ts

@@ -0,0 +1,74 @@
+import { Platform } from 'react-native';
+
+import BackupCardSdk from './NativeBackupCardSdk';
+
+import type { PromiseResult } from './NativeBackupCardSdk';
+
+export type CallbackError = { code: number; message: string | null } | null;
+
+/** Same error codes as @digitalshieldfe/react-native-lite-card for NFC checks. */
+export enum CardErrors {
+  InitChannel = 1000,
+  NotExistsNFC = 1001,
+  NotEnableNFC = 1002,
+  NotNFCPermission = 1003,
+
+  ConnectionFail = 2001,
+  NotSameNFCLite = 2002,
+  ActivateCardFailed = 2003,
+  NotSupportedCard = 2004,
+  PasswordWrong = 2005,
+  NotSetPassword = 2006,
+  CardLock = 2007,
+  NotInitializedError = 2008,
+
+  InitializedError = 4001,
+}
+
+function parseTurboModuleError(error: unknown): CallbackError {
+  const err = error as {
+    message?: string;
+    userInfo?: { code?: number; message?: string };
+  };
+  const code = err?.userInfo?.code;
+  if (typeof code === 'number') {
+    return { code, message: err.userInfo?.message ?? err.message ?? null };
+  }
+  return { code: CardErrors.InitChannel, message: err?.message ?? null };
+}
+
+/** Android only for now; iOS will be added later. */
+export function checkNFCPermission(): Promise<PromiseResult<boolean>> {
+  if (Platform.OS !== 'android') {
+    return Promise.resolve({
+      error: {
+        code: CardErrors.InitChannel,
+        message: 'checkNFCPermission is not implemented on iOS yet',
+      },
+      data: null,
+      cardInfo: null,
+      resultCode: -1,
+    });
+  }
+  return BackupCardSdk.checkNFCPermission()
+    .then(() => ({ error: null, data: true, cardInfo: null, resultCode: 0 }))
+    .catch((error: unknown) => ({
+      error: parseTurboModuleError(error),
+      data: null,
+      cardInfo: null,
+      resultCode: -1,
+    }));
+}
+
+/** Android only for now; iOS will be added later. */
+export function intoSetting(): void {
+  if (Platform.OS !== 'android') {
+    return;
+  }
+  BackupCardSdk.intoSetting();
+}
+
+/** Call when user dismisses the "tap card" UI to stop waiting. Android only. */
+export function cancelNfcWait(): void {
+  BackupCardSdk.cancelNfcWait();
+}

package/android/proguard-rules.pro

@@ -1,21 +0,0 @@
-# Add project specific ProGuard rules here.
-# You can control the set of applied configuration files using the
-# proguardFiles setting in build.gradle.
-#
-# For more details, see
-#   http://developer.android.com/guide/developing/tools/proguard.html
-
-# If your project uses WebView with JS, uncomment the following
-# and specify the fully qualified class name to the JavaScript interface
-# class:
-#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
-#   public *;
-#}
-
-# Uncomment this to preserve the line number information for
-# debugging stack traces.
-#-keepattributes SourceFile,LineNumberTable
-
-# If you keep the line number information, uncomment this to
-# hide the original source file name.
-#-renamesourcefileattribute SourceFile