@ukeyfe/react-native-nfc-litecard 1.0.2 → 1.0.3

package/dist/reader.js

@@ -46,18 +46,20 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_PIN_RETRY_COUNT = exports.clearNfcOperationCancelledByCleanup = exports.getNfcOperationCancelledByCleanupTimestamp = exports.consumeNfcOperationCancelledByCleanup = exports.markNfcOperationCancelledByCleanup = exports.releaseNfcOperationLock = exports.isNfcOperationLocked = exports.ResultCode = void 0;
+exports.DEFAULT_PIN_RETRY_COUNT = exports.clearNfcOperationCancelledByCleanup = exports.getNfcOperationCancelledByCleanupTimestamp = exports.consumeNfcOperationCancelledByCleanup = exports.markNfcOperationCancelledByCleanup = exports.releaseNfcOperationLock = exports.isNfcOperationLocked = exports.NfcStatusCode = void 0;
 exports.cardInfoToJson = cardInfoToJson;
 exports.checkCard = checkCard;
 exports.readMnemonic = readMnemonic;
 exports.readUserNickname = readUserNickname;
 exports.readMnemonicRetryCount = readMnemonicRetryCount;
 exports.resetRetryCountTo10 = resetRetryCountTo10;
+exports.getCardVersion = getCardVersion;
+exports.readOriginality = readOriginality;
 const bip39 = __importStar(require("bip39"));
 const constants_1 = require("./constants");
 Object.defineProperty(exports, "DEFAULT_PIN_RETRY_COUNT", { enumerable: true, get: function () { return constants_1.DEFAULT_PIN_RETRY_COUNT; } });
 const types_1 = require("./types");
-Object.defineProperty(exports, "ResultCode", { enumerable: true, get: function () { return types_1.ResultCode; } });
+Object.defineProperty(exports, "NfcStatusCode", { enumerable: true, get: function () { return types_1.NfcStatusCode; } });
 const utils_1 = require("./utils");
 const crypto_1 = require("./crypto");
 const nfc_core_1 = require("./nfc-core");
@@ -72,13 +74,6 @@ Object.defineProperty(exports, "clearNfcOperationCancelledByCleanup", { enumerab
 // ===========================================================================
 // Internal read helpers
 // ===========================================================================
-/** FAST_READ pages 0x08–0x27 (user memory). */
-async function readUserMemory() {
-    const response = await (0, nfc_core_1.transceive)([constants_1.CMD_FAST_READ, constants_1.USER_PAGE_START, constants_1.USER_PAGE_END]);
-    if (!response || response.length < constants_1.USER_MEMORY_SIZE)
-        throw new Error('READ_FAILED');
-    return new Uint8Array(response.slice(0, constants_1.USER_MEMORY_SIZE));
-}
 /** FAST_READ pages 0x04–0x07 (card info area). */
 async function readUserCardInfo() {
     const response = await (0, nfc_core_1.transceive)([constants_1.CMD_FAST_READ, constants_1.USER_CARD_INFO_PAGE_START, constants_1.USER_CARD_INFO_PAGE_END]);
@@ -125,32 +120,7 @@ function entropyToMnemonic(data) {
         throw new Error('INVALID_CARD_DATA');
     if (data.every(b => b === 0))
         throw new Error('EMPTY_CARD');
-    const typeId = data[0];
-    let entropyLength;
-    let typeStr;
-    switch (typeId) {
-        case constants_1.MNEMONIC_TYPE_12:
-            entropyLength = 16;
-            typeStr = '12 words (128-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_15:
-            entropyLength = 20;
-            typeStr = '15 words (160-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_18:
-            entropyLength = 24;
-            typeStr = '18 words (192-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_21:
-            entropyLength = 28;
-            typeStr = '21 words (224-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_24:
-            entropyLength = 32;
-            typeStr = '24 words (256-bit)';
-            break;
-        default: throw new Error('INVALID_CARD_DATA');
-    }
+    const { entropyLength, description } = (0, utils_1.getMnemonicTypeInfo)(data[0]);
     const expectedTotal = 1 + entropyLength + 2;
     if (data.length < expectedTotal)
         throw new Error('INVALID_CARD_DATA');
@@ -163,7 +133,7 @@ function entropyToMnemonic(data) {
     const entropyHex = (0, utils_1.bytesToHex)(Array.from(entropyBytes));
     const rawBytes = (0, utils_1.bytesToHex)(Array.from(dataBlock));
     const mnemonic = bip39.entropyToMnemonic(entropyHex);
-    return { mnemonic, entropyHex, type: typeStr, rawBytes, crc16: calcCRC };
+    return { mnemonic, entropyHex, type: description, rawBytes, crc16: calcCRC };
 }
 // ===========================================================================
 // Card info parsing
@@ -243,7 +213,7 @@ async function checkCard(password, onCardIdentified) {
         await (0, nfc_core_1.acquireNfcLock)();
     }
     catch {
-        return { code: types_1.ResultCode.UNKNOWN_ERROR, success: false };
+        return { code: types_1.NfcStatusCode.UNKNOWN_ERROR, success: false };
     }
     try {
         try {
@@ -251,25 +221,41 @@ async function checkCard(password, onCardIdentified) {
         }
         catch {
             (0, nfc_core_1.releaseNfcLock)();
-            return { code: types_1.ResultCode.NFC_CONNECT_FAILED, success: false };
+            return { code: types_1.NfcStatusCode.NFC_CONNECT_FAILED, success: false };
         }
         try {
             if (password) {
-                // Authenticated check: authenticate → read full memory → validate CRC16
+                // Authenticated check: decrement retry → authenticate → read → validate CRC16
+                try {
+                    await (0, nfc_core_1.decrementRetryCountInSession)();
+                }
+                catch (error) {
+                    const code = (0, types_1.errorToCode)(error);
+                    if (code === types_1.NfcStatusCode.RETRY_COUNT_EXHAUSTED) {
+                        await (0, nfc_core_1.releaseNfcTech)();
+                        (0, nfc_core_1.releaseNfcLock)();
+                        return (0, types_1.nfcResultRetryCountExhausted)();
+                    }
+                }
                 const aesKey = (0, crypto_1.passwordToAesKey)(password);
                 await (0, nfc_core_1.authenticate)(aesKey);
+                // Auth succeeded – reset retry counter
+                try {
+                    await (0, nfc_core_1.writeRetryCountInSession)(constants_1.DEFAULT_PIN_RETRY_COUNT);
+                }
+                catch { /* non-fatal */ }
                 onCardIdentified?.();
-                const data = await readUserMemory();
+                const data = await (0, nfc_core_1.readUserMemory)();
                 try {
                     const decoded = (0, utils_1.validateMnemonicPayload)(data);
                     await (0, nfc_core_1.releaseNfcTech)();
                     (0, nfc_core_1.releaseNfcLock)();
-                    return { code: types_1.ResultCode.CHECK_HAS_DATA, success: true, data: { type: decoded.type } };
+                    return { code: types_1.NfcStatusCode.CHECK_HAS_DATA, success: true, data: { type: decoded.type } };
                 }
                 catch {
                     await (0, nfc_core_1.releaseNfcTech)();
                     (0, nfc_core_1.releaseNfcLock)();
-                    return { code: types_1.ResultCode.CHECK_EMPTY, success: true };
+                    return { code: types_1.NfcStatusCode.CHECK_EMPTY, success: true };
                 }
             }
             else {
@@ -283,16 +269,16 @@ async function checkCard(password, onCardIdentified) {
                 await (0, nfc_core_1.releaseNfcTech)();
                 (0, nfc_core_1.releaseNfcLock)();
                 if (response && response.length >= 4) {
-                    const first = response[0];
-                    const hasData = first === constants_1.MNEMONIC_TYPE_12 ||
-                        first === constants_1.MNEMONIC_TYPE_15 ||
-                        first === constants_1.MNEMONIC_TYPE_18 ||
-                        first === constants_1.MNEMONIC_TYPE_21 ||
-                        first === constants_1.MNEMONIC_TYPE_24;
-                    return { code: hasData ? types_1.ResultCode.CHECK_HAS_DATA : types_1.ResultCode.CHECK_EMPTY, success: true };
+                    let hasData = false;
+                    try {
+                        (0, utils_1.getMnemonicTypeInfo)(response[0]);
+                        hasData = true;
+                    }
+                    catch { /* not a valid type */ }
+                    return { code: hasData ? types_1.NfcStatusCode.CHECK_HAS_DATA : types_1.NfcStatusCode.CHECK_EMPTY, success: true };
                 }
                 // Read failed = protection is on, assume has data
-                return { code: types_1.ResultCode.CHECK_HAS_DATA, success: true };
+                return { code: types_1.NfcStatusCode.CHECK_HAS_DATA, success: true };
             }
         }
         catch (error) {
@@ -318,7 +304,7 @@ async function readMnemonic(password, onCardIdentified) {
         await (0, nfc_core_1.acquireNfcLock)();
     }
     catch {
-        return { code: types_1.ResultCode.UNKNOWN_ERROR, success: false };
+        return { code: types_1.NfcStatusCode.UNKNOWN_ERROR, success: false };
     }
     let retryCountAfterPreDecrement;
     try {
@@ -327,7 +313,7 @@ async function readMnemonic(password, onCardIdentified) {
         }
         catch {
             (0, nfc_core_1.releaseNfcLock)();
-            return { code: types_1.ResultCode.NFC_CONNECT_FAILED, success: false };
+            return { code: types_1.NfcStatusCode.NFC_CONNECT_FAILED, success: false };
         }
         try {
             // Pre-decrement retry counter before auth attempt
@@ -338,7 +324,7 @@ async function readMnemonic(password, onCardIdentified) {
             }
             catch (error) {
                 const code = (0, types_1.errorToCode)(error);
-                if (code === types_1.ResultCode.RETRY_COUNT_EXHAUSTED) {
+                if (code === types_1.NfcStatusCode.RETRY_COUNT_EXHAUSTED) {
                     await (0, nfc_core_1.releaseNfcTech)();
                     (0, nfc_core_1.releaseNfcLock)();
                     return (0, types_1.nfcResultRetryCountExhausted)();
@@ -347,8 +333,7 @@ async function readMnemonic(password, onCardIdentified) {
             const aesKey = (0, crypto_1.passwordToAesKey)(password);
             await (0, nfc_core_1.authenticate)(aesKey);
             onCardIdentified?.();
-            const data = await readUserMemory();
-            await readUserCardInfo(); // read but not used directly yet
+            const data = await (0, nfc_core_1.readUserMemory)();
             const result = entropyToMnemonic(data);
             let nickname;
             try {
@@ -365,7 +350,7 @@ async function readMnemonic(password, onCardIdentified) {
             await (0, nfc_core_1.releaseNfcTech)();
             (0, nfc_core_1.releaseNfcLock)();
             return {
-                code: types_1.ResultCode.READ_SUCCESS,
+                code: types_1.NfcStatusCode.READ_SUCCESS,
                 success: true,
                 data: {
                     mnemonic: result.mnemonic,
@@ -405,7 +390,7 @@ async function readUserNickname(password, onCardIdentified) {
         await (0, nfc_core_1.acquireNfcLock)();
     }
     catch {
-        return { code: types_1.ResultCode.UNKNOWN_ERROR, success: false };
+        return { code: types_1.NfcStatusCode.UNKNOWN_ERROR, success: false };
     }
     try {
         try {
@@ -413,7 +398,7 @@ async function readUserNickname(password, onCardIdentified) {
         }
         catch {
             (0, nfc_core_1.releaseNfcLock)();
-            return { code: types_1.ResultCode.NFC_CONNECT_FAILED, success: false };
+            return { code: types_1.NfcStatusCode.NFC_CONNECT_FAILED, success: false };
         }
         try {
             if (password) {
@@ -425,7 +410,7 @@ async function readUserNickname(password, onCardIdentified) {
             await (0, nfc_core_1.releaseNfcTech)();
             (0, nfc_core_1.releaseNfcLock)();
             return {
-                code: types_1.ResultCode.READ_NICKNAME_SUCCESS,
+                code: types_1.NfcStatusCode.READ_NICKNAME_SUCCESS,
                 success: true,
                 data: { nickname },
             };
@@ -448,7 +433,7 @@ async function readMnemonicRetryCount(onCardIdentified) {
         await (0, nfc_core_1.acquireNfcLock)();
     }
     catch {
-        return { code: types_1.ResultCode.UNKNOWN_ERROR, success: false };
+        return { code: types_1.NfcStatusCode.UNKNOWN_ERROR, success: false };
     }
     try {
         try {
@@ -456,7 +441,7 @@ async function readMnemonicRetryCount(onCardIdentified) {
         }
         catch {
             (0, nfc_core_1.releaseNfcLock)();
-            return { code: types_1.ResultCode.NFC_CONNECT_FAILED, success: false };
+            return { code: types_1.NfcStatusCode.NFC_CONNECT_FAILED, success: false };
         }
         try {
             onCardIdentified?.();
@@ -465,7 +450,7 @@ async function readMnemonicRetryCount(onCardIdentified) {
                 await (0, nfc_core_1.releaseNfcTech)();
                 (0, nfc_core_1.releaseNfcLock)();
                 return {
-                    code: types_1.ResultCode.READ_RETRY_COUNT_SUCCESS,
+                    code: types_1.NfcStatusCode.READ_RETRY_COUNT_SUCCESS,
                     success: true,
                     data: { retryCount: 0 },
                 };
@@ -474,7 +459,7 @@ async function readMnemonicRetryCount(onCardIdentified) {
             await (0, nfc_core_1.releaseNfcTech)();
             (0, nfc_core_1.releaseNfcLock)();
             return {
-                code: types_1.ResultCode.READ_RETRY_COUNT_SUCCESS,
+                code: types_1.NfcStatusCode.READ_RETRY_COUNT_SUCCESS,
                 success: true,
                 data: { retryCount },
             };
@@ -497,7 +482,7 @@ async function resetRetryCountTo10(onCardIdentified) {
         await (0, nfc_core_1.acquireNfcLock)();
     }
     catch {
-        return { code: types_1.ResultCode.UNKNOWN_ERROR, success: false };
+        return { code: types_1.NfcStatusCode.UNKNOWN_ERROR, success: false };
     }
     try {
         try {
@@ -505,7 +490,7 @@ async function resetRetryCountTo10(onCardIdentified) {
         }
         catch {
             (0, nfc_core_1.releaseNfcLock)();
-            return { code: types_1.ResultCode.NFC_CONNECT_FAILED, success: false };
+            return { code: types_1.NfcStatusCode.NFC_CONNECT_FAILED, success: false };
         }
         try {
             onCardIdentified?.();
@@ -513,7 +498,7 @@ async function resetRetryCountTo10(onCardIdentified) {
             await (0, nfc_core_1.releaseNfcTech)();
             (0, nfc_core_1.releaseNfcLock)();
             return {
-                code: types_1.ResultCode.READ_RETRY_COUNT_SUCCESS,
+                code: types_1.NfcStatusCode.READ_RETRY_COUNT_SUCCESS,
                 success: true,
                 data: { retryCount: constants_1.DEFAULT_PIN_RETRY_COUNT },
             };
@@ -530,3 +515,105 @@ async function resetRetryCountTo10(onCardIdentified) {
         throw error;
     }
 }
+/**
+ * Read card product version info (GET_VERSION command).
+ * No authentication required.
+ */
+async function getCardVersion(onCardIdentified) {
+    try {
+        await (0, nfc_core_1.acquireNfcLock)();
+    }
+    catch {
+        return { code: types_1.NfcStatusCode.UNKNOWN_ERROR, success: false };
+    }
+    try {
+        try {
+            await (0, nfc_core_1.requestNfcTech)();
+        }
+        catch {
+            (0, nfc_core_1.releaseNfcLock)();
+            return { code: types_1.NfcStatusCode.NFC_CONNECT_FAILED, success: false };
+        }
+        try {
+            onCardIdentified?.();
+            const response = await (0, nfc_core_1.transceive)([constants_1.CMD_GET_VERSION]);
+            if (!response || response.length < 8) {
+                throw new Error('READ_FAILED');
+            }
+            await (0, nfc_core_1.releaseNfcTech)();
+            (0, nfc_core_1.releaseNfcLock)();
+            return {
+                code: types_1.NfcStatusCode.GET_VERSION_SUCCESS,
+                success: true,
+                data: {
+                    version: {
+                        vendorId: response[1],
+                        productType: response[2],
+                        productSubtype: response[3],
+                        majorVersion: response[4],
+                        minorVersion: response[5],
+                        storageSize: response[6],
+                        protocolType: response[7],
+                    },
+                },
+            };
+        }
+        catch (error) {
+            await (0, nfc_core_1.releaseNfcTech)();
+            (0, nfc_core_1.releaseNfcLock)();
+            const code = (0, types_1.errorToCode)(error);
+            return { code, success: false };
+        }
+    }
+    catch (error) {
+        (0, nfc_core_1.releaseNfcLock)();
+        throw error;
+    }
+}
+/**
+ * Read the ECC originality signature (READ_SIG command).
+ * Verifies the card is a genuine NXP product.
+ * No authentication required (unless Random ID is enabled).
+ */
+async function readOriginality(onCardIdentified) {
+    try {
+        await (0, nfc_core_1.acquireNfcLock)();
+    }
+    catch {
+        return { code: types_1.NfcStatusCode.UNKNOWN_ERROR, success: false };
+    }
+    try {
+        try {
+            await (0, nfc_core_1.requestNfcTech)();
+        }
+        catch {
+            (0, nfc_core_1.releaseNfcLock)();
+            return { code: types_1.NfcStatusCode.NFC_CONNECT_FAILED, success: false };
+        }
+        try {
+            onCardIdentified?.();
+            const response = await (0, nfc_core_1.transceive)([constants_1.CMD_READ_SIG, 0x00]);
+            if (!response || response.length < 48) {
+                throw new Error('READ_FAILED');
+            }
+            const signatureHex = (0, utils_1.bytesToHex)(response.slice(0, 48));
+            await (0, nfc_core_1.releaseNfcTech)();
+            (0, nfc_core_1.releaseNfcLock)();
+            return {
+                code: types_1.NfcStatusCode.READ_SIG_SUCCESS,
+                success: true,
+                data: { signature: signatureHex },
+            };
+        }
+        catch (error) {
+            await (0, nfc_core_1.releaseNfcTech)();
+            (0, nfc_core_1.releaseNfcLock)();
+            const code = (0, types_1.errorToCode)(error);
+            return { code, success: false };
+        }
+    }
+    catch (error) {
+        (0, nfc_core_1.releaseNfcLock)();
+        throw error;
+    }
+}

package/dist/types.d.ts

@@ -7,14 +7,16 @@
  *   - Failure        : 4xxxx (shared)
  *
  * This library does NOT provide user-facing messages.
- * The caller should map ResultCode to their own localised strings.
+ * The caller should map NfcStatusCode to their own localised strings.
  */
-export declare const ResultCode: {
+export declare const NfcStatusCode: {
     readonly READ_SUCCESS: 10102;
     readonly READ_NICKNAME_SUCCESS: 10103;
     readonly CHECK_EMPTY: 10104;
     readonly CHECK_HAS_DATA: 10105;
     readonly READ_RETRY_COUNT_SUCCESS: 10106;
+    readonly GET_VERSION_SUCCESS: 10107;
+    readonly READ_SIG_SUCCESS: 10108;
     readonly INIT_SUCCESS: 10201;
     readonly WRITE_SUCCESS: 10203;
     readonly UPDATE_PASSWORD_SUCCESS: 10204;
@@ -40,7 +42,7 @@ export declare const ResultCode: {
     readonly RETRY_COUNT_EXHAUSTED: 40015;
 };
 export interface NfcResult {
-    /** Numeric result code – compare against ResultCode constants */
+    /** Numeric result code – compare against NfcStatusCode constants */
     code: number;
     /** Whether the operation succeeded */
     success: boolean;
@@ -54,6 +56,16 @@ export interface NfcResult {
         retryCount?: number;
         aesKeyHex?: string;
         crc16?: number;
+        version?: {
+            vendorId: number;
+            productType: number;
+            productSubtype: number;
+            majorVersion: number;
+            minorVersion: number;
+            storageSize: number;
+            protocolType: number;
+        };
+        signature?: string;
     };
 }
 /**
@@ -62,7 +74,7 @@ export interface NfcResult {
  */
 export declare function nfcResultRetryCountExhausted(): NfcResult;
 /**
- * Derive a ResultCode from an error thrown during NFC operations.
+ * Derive a NfcStatusCode from an error thrown during NFC operations.
  * Handles iOS-specific cancel detection, known error strings, and fallback.
  */
 export declare function errorToCode(error: any): number;

package/dist/types.js

@@ -8,23 +8,25 @@
  *   - Failure        : 4xxxx (shared)
  *
  * This library does NOT provide user-facing messages.
- * The caller should map ResultCode to their own localised strings.
+ * The caller should map NfcStatusCode to their own localised strings.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResultCode = void 0;
+exports.NfcStatusCode = void 0;
 exports.nfcResultRetryCountExhausted = nfcResultRetryCountExhausted;
 exports.errorToCode = errorToCode;
 const react_native_1 = require("react-native");
 // ---------------------------------------------------------------------------
 // Unified result codes
 // ---------------------------------------------------------------------------
-exports.ResultCode = {
+exports.NfcStatusCode = {
     // Reader success (101xx)
     READ_SUCCESS: 10102,
     READ_NICKNAME_SUCCESS: 10103,
     CHECK_EMPTY: 10104,
     CHECK_HAS_DATA: 10105,
     READ_RETRY_COUNT_SUCCESS: 10106,
+    GET_VERSION_SUCCESS: 10107,
+    READ_SIG_SUCCESS: 10108,
     // Writer success (102xx)
     INIT_SUCCESS: 10201,
     WRITE_SUCCESS: 10203,
@@ -57,7 +59,7 @@ exports.ResultCode = {
  */
 function nfcResultRetryCountExhausted() {
     return {
-        code: exports.ResultCode.RETRY_COUNT_EXHAUSTED,
+        code: exports.NfcStatusCode.RETRY_COUNT_EXHAUSTED,
         success: false,
         data: { retryCount: 0 },
     };
@@ -66,7 +68,7 @@ function nfcResultRetryCountExhausted() {
 // Error → code mapping (internal use)
 // ---------------------------------------------------------------------------
 /**
- * Derive a ResultCode from an error thrown during NFC operations.
+ * Derive a NfcStatusCode from an error thrown during NFC operations.
  * Handles iOS-specific cancel detection, known error strings, and fallback.
  */
 function errorToCode(error) {
@@ -78,34 +80,34 @@ function errorToCode(error) {
         if (error &&
             typeof error === 'object' &&
             (error.name === 'UserCancel' || error.constructor?.name === 'UserCancel')) {
-            return exports.ResultCode.NFC_USER_CANCELED;
+            return exports.NfcStatusCode.NFC_USER_CANCELED;
         }
         if (!msg || msg.includes('User Canceled') || msg.includes('Unknown empty error')) {
-            return exports.ResultCode.NFC_USER_CANCELED;
+            return exports.NfcStatusCode.NFC_USER_CANCELED;
         }
     }
     if (msg.includes('NFC_USER_CANCELED_SIGNAL'))
-        return exports.ResultCode.NFC_USER_CANCELED;
+        return exports.NfcStatusCode.NFC_USER_CANCELED;
     const keywords = [
-        ['RETRY_COUNT_EXHAUSTED', exports.ResultCode.RETRY_COUNT_EXHAUSTED],
-        ['AUTH_WRONG_PASSWORD', exports.ResultCode.AUTH_WRONG_PASSWORD],
-        ['AUTH_INVALID_RESPONSE', exports.ResultCode.AUTH_INVALID_RESPONSE],
-        ['AUTH_VERIFY_FAILED', exports.ResultCode.AUTH_VERIFY_FAILED],
-        ['READ_FAILED', exports.ResultCode.READ_FAILED],
-        ['WRITE_FAILED', exports.ResultCode.WRITE_FAILED],
-        ['CRC16_CHECK_FAILED', exports.ResultCode.CRC16_CHECK_FAILED],
-        ['EMPTY_CARD', exports.ResultCode.CHECK_EMPTY],
-        ['INVALID_CARD_DATA', exports.ResultCode.INVALID_CARD_DATA],
-        ['INVALID_MNEMONIC', exports.ResultCode.INVALID_MNEMONIC],
-        ['UNSUPPORTED_MNEMONIC_LENGTH', exports.ResultCode.UNSUPPORTED_MNEMONIC_LENGTH],
-        ['NFC_LOCK_TIMEOUT', exports.ResultCode.NFC_LOCK_TIMEOUT],
-        ['NFC_CONNECT_FAILED', exports.ResultCode.NFC_CONNECT_FAILED],
-        ['connection failed', exports.ResultCode.NFC_CONNECT_FAILED],
-        ['transceive fail', exports.ResultCode.NFC_CONNECT_FAILED],
+        ['RETRY_COUNT_EXHAUSTED', exports.NfcStatusCode.RETRY_COUNT_EXHAUSTED],
+        ['AUTH_WRONG_PASSWORD', exports.NfcStatusCode.AUTH_WRONG_PASSWORD],
+        ['AUTH_INVALID_RESPONSE', exports.NfcStatusCode.AUTH_INVALID_RESPONSE],
+        ['AUTH_VERIFY_FAILED', exports.NfcStatusCode.AUTH_VERIFY_FAILED],
+        ['READ_FAILED', exports.NfcStatusCode.READ_FAILED],
+        ['WRITE_FAILED', exports.NfcStatusCode.WRITE_FAILED],
+        ['CRC16_CHECK_FAILED', exports.NfcStatusCode.CRC16_CHECK_FAILED],
+        ['EMPTY_CARD', exports.NfcStatusCode.CHECK_EMPTY],
+        ['INVALID_CARD_DATA', exports.NfcStatusCode.INVALID_CARD_DATA],
+        ['INVALID_MNEMONIC', exports.NfcStatusCode.INVALID_MNEMONIC],
+        ['UNSUPPORTED_MNEMONIC_LENGTH', exports.NfcStatusCode.UNSUPPORTED_MNEMONIC_LENGTH],
+        ['NFC_LOCK_TIMEOUT', exports.NfcStatusCode.NFC_LOCK_TIMEOUT],
+        ['NFC_CONNECT_FAILED', exports.NfcStatusCode.NFC_CONNECT_FAILED],
+        ['connection failed', exports.NfcStatusCode.NFC_CONNECT_FAILED],
+        ['transceive fail', exports.NfcStatusCode.NFC_CONNECT_FAILED],
     ];
     for (const [keyword, code] of keywords) {
         if (msg.includes(keyword))
             return code;
     }
-    return exports.ResultCode.UNKNOWN_ERROR;
+    return exports.NfcStatusCode.UNKNOWN_ERROR;
 }

package/dist/utils.d.ts

@@ -15,6 +15,22 @@ export declare function crc16ToBytes(crc16: number): Uint8Array;
  * @throws if buffer is shorter than 2 bytes.
  */
 export declare function extractCRC16(data: Uint8Array): number;
+/**
+ * Get entropy length and description for a mnemonic type ID.
+ * @throws INVALID_CARD_DATA if the type ID is unknown.
+ */
+export declare function getMnemonicTypeInfo(typeId: number): {
+    entropyLength: number;
+    description: string;
+};
+/**
+ * Get type ID and description for a given entropy byte length.
+ * @throws UNSUPPORTED_MNEMONIC_LENGTH if the length is not recognized.
+ */
+export declare function getMnemonicTypeByEntropyLength(entropyLength: number): {
+    typeId: number;
+    description: string;
+};
 /**
  * Validate whether raw card data contains a valid mnemonic payload.
  * Checks type byte, length, and CRC16 — does NOT decode the mnemonic.

package/dist/utils.js

@@ -8,6 +8,8 @@ exports.hexToBytes = hexToBytes;
 exports.calculateCRC16 = calculateCRC16;
 exports.crc16ToBytes = crc16ToBytes;
 exports.extractCRC16 = extractCRC16;
+exports.getMnemonicTypeInfo = getMnemonicTypeInfo;
+exports.getMnemonicTypeByEntropyLength = getMnemonicTypeByEntropyLength;
 exports.validateMnemonicPayload = validateMnemonicPayload;
 const constants_1 = require("./constants");
 // ---------------------------------------------------------------------------
@@ -23,7 +25,7 @@ function bytesToHex(bytes) {
 function hexToBytes(hex) {
     const bytes = new Uint8Array(hex.length / 2);
     for (let i = 0; i < hex.length; i += 2) {
-        bytes[i / 2] = parseInt(hex.substr(i, 2), 16);
+        bytes[i / 2] = parseInt(hex.substring(i, i + 2), 16);
     }
     return bytes;
 }
@@ -64,6 +66,37 @@ function extractCRC16(data) {
     return data[data.length - 2] | (data[data.length - 1] << 8);
 }
 // ---------------------------------------------------------------------------
+// Mnemonic type info
+// ---------------------------------------------------------------------------
+/** Mnemonic type info table: [typeId, entropyLength, description] */
+const MNEMONIC_TYPE_TABLE = [
+    [constants_1.MNEMONIC_TYPE_12, 16, '12 words (128-bit)'],
+    [constants_1.MNEMONIC_TYPE_15, 20, '15 words (160-bit)'],
+    [constants_1.MNEMONIC_TYPE_18, 24, '18 words (192-bit)'],
+    [constants_1.MNEMONIC_TYPE_21, 28, '21 words (224-bit)'],
+    [constants_1.MNEMONIC_TYPE_24, 32, '24 words (256-bit)'],
+];
+/**
+ * Get entropy length and description for a mnemonic type ID.
+ * @throws INVALID_CARD_DATA if the type ID is unknown.
+ */
+function getMnemonicTypeInfo(typeId) {
+    const entry = MNEMONIC_TYPE_TABLE.find(([id]) => id === typeId);
+    if (!entry)
+        throw new Error('INVALID_CARD_DATA');
+    return { entropyLength: entry[1], description: entry[2] };
+}
+/**
+ * Get type ID and description for a given entropy byte length.
+ * @throws UNSUPPORTED_MNEMONIC_LENGTH if the length is not recognized.
+ */
+function getMnemonicTypeByEntropyLength(entropyLength) {
+    const entry = MNEMONIC_TYPE_TABLE.find(([, len]) => len === entropyLength);
+    if (!entry)
+        throw new Error('UNSUPPORTED_MNEMONIC_LENGTH');
+    return { typeId: entry[0], description: entry[2] };
+}
+// ---------------------------------------------------------------------------
 // Mnemonic payload validation
 // ---------------------------------------------------------------------------
 /**
@@ -78,32 +111,7 @@ function validateMnemonicPayload(data) {
         throw new Error('INVALID_CARD_DATA');
     if (data.every(b => b === 0))
         throw new Error('EMPTY_CARD');
-    const typeId = data[0];
-    let entropyLength;
-    let typeStr;
-    switch (typeId) {
-        case constants_1.MNEMONIC_TYPE_12:
-            entropyLength = 16;
-            typeStr = '12 words (128-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_15:
-            entropyLength = 20;
-            typeStr = '15 words (160-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_18:
-            entropyLength = 24;
-            typeStr = '18 words (192-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_21:
-            entropyLength = 28;
-            typeStr = '21 words (224-bit)';
-            break;
-        case constants_1.MNEMONIC_TYPE_24:
-            entropyLength = 32;
-            typeStr = '24 words (256-bit)';
-            break;
-        default: throw new Error('INVALID_CARD_DATA');
-    }
+    const { entropyLength, description } = getMnemonicTypeInfo(data[0]);
     const expectedTotal = 1 + entropyLength + 2;
     if (data.length < expectedTotal)
         throw new Error('INVALID_CARD_DATA');
@@ -112,5 +120,5 @@ function validateMnemonicPayload(data) {
     const calcCRC = calculateCRC16(dataBlock);
     if (storedCRC !== calcCRC)
         throw new Error('CRC16_CHECK_FAILED');
-    return { type: typeStr };
+    return { type: description };
 }