@trustchex/react-native-sdk 1.161.0

package/src/Shared/EIDReader/bacKey.ts

@@ -0,0 +1,132 @@
+import cryptoUtils from './utils/crypto.utils';
+import type { BACKeySpec } from './bacKeySpec';
+import { MRZInfo } from './lds/icao/mrzInfo';
+
+export class BACKey implements BACKeySpec {
+  private static readonly SDF: string = 'yyMMdd';
+
+  private documentNumber: string;
+  private dateOfBirth: string;
+  private dateOfExpiry: string;
+
+  /**
+   * Creates a BAC key.
+   *
+   * @param documentNumber the document number string, cannot be `null`
+   * @param dateOfBirth the date of birth string in `yymmdd` format, cannot be `null`
+   * @param dateOfExpiry the date of expiry string in `yymmdd` format, cannot be `null`
+   */
+  public constructor(
+    documentNumber: string,
+    dateOfBirth: string,
+    dateOfExpiry: string
+  ) {
+    if (documentNumber === null) {
+      throw new Error('Illegal document number');
+    }
+    if (dateOfBirth === null || dateOfBirth.length !== 6) {
+      throw new Error(`Illegal date: ${dateOfBirth}`);
+    }
+    if (dateOfExpiry === null || dateOfExpiry.length !== 6) {
+      throw new Error(`Illegal date: ${dateOfExpiry}`);
+    }
+
+    this.documentNumber = BACKey.fixDocumentNumber(documentNumber);
+    this.dateOfBirth = dateOfBirth;
+    this.dateOfExpiry = dateOfExpiry;
+  }
+
+  /**
+   * Returns the document number string.
+   *
+   * @return the document number string
+   */
+  public getDocumentNumber(): string {
+    return this.documentNumber;
+  }
+
+  /**
+   * Returns the date of birth string.
+   *
+   * @return a date in `yymmdd` format
+   */
+  public getDateOfBirth(): string {
+    return this.dateOfBirth;
+  }
+
+  /**
+   * Returns the date of expiry string.
+   *
+   * @return a date in `yymmdd` format
+   */
+  public getDateOfExpiry(): string {
+    return this.dateOfExpiry;
+  }
+
+  /**
+   * The algorithm of this key specification.
+   *
+   * @return constant "BAC"
+   */
+  public getAlgorithm(): string {
+    return 'BAC';
+  }
+
+  /**
+   * Returns the encoded key (key seed) for use in key derivation.
+   *
+   * @return the encoded key
+   */
+  public getKey() {
+    try {
+      const mrz =
+        this.documentNumber +
+        MRZInfo.checkDigit(this.documentNumber, false) +
+        this.dateOfBirth +
+        MRZInfo.checkDigit(this.dateOfBirth, false) +
+        this.dateOfExpiry +
+        MRZInfo.checkDigit(this.dateOfExpiry, false);
+      return cryptoUtils.computeKeySeed(mrz, 'SHA-1', true);
+    } catch (gse) {
+      throw new Error('Unexpected exception');
+    }
+  }
+
+  /**
+   * Sets the document number.
+   *
+   * @param documentNumber the document number to set
+   */
+  protected setDocumentNumber(documentNumber: string): void {
+    this.documentNumber = documentNumber;
+  }
+
+  /**
+   * Sets the date of birth.
+   *
+   * @param dateOfBirth the date of birth to set
+   */
+  protected setDateOfBirth(dateOfBirth: string): void {
+    this.dateOfBirth = dateOfBirth;
+  }
+
+  /**
+   * Sets the date of expiry.
+   *
+   * @param dateOfExpiry the date of expiry to set
+   */
+  protected setDateOfExpiry(dateOfExpiry: string): void {
+    this.dateOfExpiry = dateOfExpiry;
+  }
+
+  private static fixDocumentNumber(documentNumber: string): string {
+    let maxDocumentNumber: string =
+      documentNumber == null
+        ? ''
+        : documentNumber.replace('<', ' ').trim().replace(' ', '<');
+    while (maxDocumentNumber.length < 9) {
+      maxDocumentNumber += '<';
+    }
+    return maxDocumentNumber;
+  }
+}

package/src/Shared/EIDReader/bacKeySpec.ts

@@ -0,0 +1,26 @@
+import type { AccessKeySpec } from './accessKeySpec';
+
+export interface BACKeySpec extends AccessKeySpec {
+  /**
+   * Returns the document number. This does not include a check digit.
+   * The result may include filler characters to make sure the resulting
+   * length is at least 9.
+   *
+   * @return the document number
+   */
+  getDocumentNumber(): string;
+
+  /**
+   * Returns the date of birth string.
+   *
+   * @return a <i>yymmdd</i> string
+   */
+  getDateOfBirth(): string;
+
+  /**
+   * Returns the date of expiry string.
+   *
+   * @return a <i>yymmdd</i> string
+   */
+  getDateOfExpiry(): string;
+}

package/src/Shared/EIDReader/cardFileInputStream.ts

@@ -0,0 +1,188 @@
+import { FileInfo } from './fileInfo';
+import { InputStream } from './java/inputStream';
+import type { FileSystemStructured } from './smartcards/fileSystemStructured';
+import { Buffer } from 'buffer';
+
+export class CardFileInputStream extends InputStream {
+  private path!: FileInfo[];
+  private buffer!: Buffer;
+  private bufferLength!: number;
+  private offsetBufferInFile!: number;
+  private offsetInBuffer!: number;
+  private markedOffset!: number;
+  private fileLength!: number;
+  private fs: FileSystemStructured;
+  private maxBlockSize: number;
+
+  constructor(maxBlockSize: number, fs: FileSystemStructured) {
+    super();
+    this.fs = fs;
+    this.maxBlockSize = maxBlockSize;
+  }
+
+  async init(): Promise<void> {
+    const fsPath = await this.fs.getSelectedPath();
+    if (fsPath != null && fsPath.length >= 1) {
+      this.path = new Array<FileInfo>(fsPath.length);
+      this.path = [...fsPath];
+      this.fileLength = fsPath[fsPath.length - 1].getFileLength();
+      this.buffer = Buffer.alloc(this.maxBlockSize);
+      this.bufferLength = 0;
+      this.offsetBufferInFile = 0;
+      this.offsetInBuffer = 0;
+      this.markedOffset = -1;
+    } else {
+      throw new Error('No valid file selected');
+    }
+  }
+
+  async read() {
+    let le: number;
+    let newOffsetBufferInFile: number;
+    try {
+      const selectedPath = await this.fs.getSelectedPath();
+      if (!this.arePathsSame(this.path, selectedPath)) {
+        const var12 = this.path;
+        le = var12.length;
+
+        for (
+          newOffsetBufferInFile = 0;
+          newOffsetBufferInFile < le;
+          ++newOffsetBufferInFile
+        ) {
+          const fileInfo = var12[newOffsetBufferInFile];
+          this.fs.selectFile(fileInfo.getFID());
+        }
+      }
+    } catch (error) {
+      throw new Error('Could not select file');
+    }
+
+    const offsetInFile = this.offsetBufferInFile + this.offsetInBuffer;
+    if (offsetInFile >= this.fileLength) {
+      return -1;
+    } else {
+      if (this.offsetInBuffer >= this.bufferLength) {
+        le = Math.min(this.buffer.length, this.fileLength - offsetInFile);
+
+        try {
+          newOffsetBufferInFile = this.offsetBufferInFile + this.bufferLength;
+          let newOffsetInBuffer = 0;
+          let newBufferLength = 0;
+          while (newBufferLength === 0) {
+            newBufferLength = await this.fillBufferFromFile(
+              this.path,
+              newOffsetBufferInFile,
+              le
+            );
+          }
+
+          this.offsetBufferInFile = newOffsetBufferInFile;
+          this.offsetInBuffer = newOffsetInBuffer;
+          this.bufferLength = newBufferLength;
+        } catch (error) {
+          throw new Error('Could not read file');
+        }
+      }
+
+      le = this.buffer[this.offsetInBuffer] & 255;
+      ++this.offsetInBuffer;
+      return le;
+    }
+  }
+
+  skip(n: number): Promise<number> {
+    if (n < this.bufferLength - this.offsetInBuffer) {
+      this.offsetInBuffer = this.offsetInBuffer + n;
+    } else {
+      const offsetInFile = this.offsetBufferInFile + this.offsetInBuffer;
+      this.offsetBufferInFile = offsetInFile + n;
+      this.offsetInBuffer = 0;
+      this.bufferLength = 0;
+    }
+
+    return Promise.resolve(n);
+  }
+
+  available(): number {
+    return this.bufferLength - this.offsetInBuffer;
+  }
+
+  mark(_readLimit: number): void {
+    this.markedOffset = this.offsetBufferInFile + this.offsetInBuffer;
+  }
+
+  reset(): void {
+    if (this.markedOffset < 0) {
+      throw new Error('Mark not set');
+    } else {
+      this.offsetBufferInFile = this.markedOffset;
+      this.offsetInBuffer = 0;
+      this.bufferLength = 0;
+    }
+  }
+
+  markSupported(): boolean {
+    return true;
+  }
+
+  getLength(): number {
+    return this.fileLength;
+  }
+
+  getPosition(): number {
+    return this.offsetBufferInFile + this.offsetInBuffer;
+  }
+
+  private async fillBufferFromFile(
+    path: FileInfo[],
+    offsetInFile: number,
+    le: number
+  ): Promise<number> {
+    if (le > this.buffer.length) {
+      throw new Error('length too big');
+    } else {
+      const selectedPath = await this.fs.getSelectedPath();
+      if (!this.arePathsSame(selectedPath, path)) {
+        const var5 = path;
+        const var6 = path.length;
+
+        for (let var7 = 0; var7 < var6; ++var7) {
+          const fileInfo = var5[var7];
+          this.fs.selectFile(fileInfo.getFID());
+        }
+      }
+
+      const data = await this.fs.readBinary(offsetInFile, le);
+      if (data == null) {
+        return 0;
+      } else {
+        for (let i = 0; i < data.length; i++) {
+          this.buffer[i] = data[i];
+        }
+        return data.length;
+      }
+    }
+  }
+
+  private arePathsSame(
+    path1: FileInfo[] | null,
+    path2: FileInfo[] | null
+  ): boolean {
+    if (path1 == null || path2 == null) {
+      return false;
+    }
+
+    if (path1.length !== path2.length) {
+      return false;
+    }
+
+    for (let i = 0; i < path1.length; i++) {
+      if (path1[i] !== path2[i]) {
+        return false;
+      }
+    }
+
+    return true;
+  }
+}

package/src/Shared/EIDReader/cardService.ts

@@ -0,0 +1,51 @@
+import { APDUEvent } from './smartcards/apduEvent';
+import type { APDUListener } from './smartcards/apduListener';
+import { CommandAPDU } from './smartcards/commandAPDU';
+import { ResponseAPDU } from './smartcards/responseAPDU';
+
+export abstract class CardService {
+  protected static readonly SESSION_STOPPED_STATE = 0;
+  protected static readonly SESSION_STARTED_STATE = 1;
+  private apduListeners: Set<APDUListener> = new Set();
+  protected state = 0;
+
+  public addAPDUListener(listener: APDUListener): void {
+    if (this.apduListeners != null && listener != null) {
+      this.apduListeners.add(listener);
+    }
+  }
+
+  public removeAPDUListener(listener: APDUListener): void {
+    if (this.apduListeners != null) {
+      this.apduListeners.delete(listener);
+    }
+  }
+
+  public getAPDUListeners(): ReadonlySet<APDUListener> {
+    return new Set(this.apduListeners);
+  }
+
+  protected notifyExchangedAPDU(event: APDUEvent): void {
+    if (this.apduListeners != null && this.apduListeners.size > 0) {
+      for (const listener of this.apduListeners) {
+        listener.exchangedAPDU(event);
+      }
+    }
+  }
+
+  public abstract open(): Promise<void>;
+
+  public abstract transmit(commandAPDU: CommandAPDU): Promise<ResponseAPDU>;
+
+  public abstract close(): Promise<void>;
+
+  public abstract getIsOpen(): boolean;
+
+  public abstract getATR(): Uint8Array;
+
+  public getIsExtendedAPDULengthSupported(): boolean {
+    return false;
+  }
+
+  public abstract getIsConnectionLost(error: Error): boolean;
+}

package/src/Shared/EIDReader/cbeff/biometricDataBlock.ts

@@ -0,0 +1,5 @@
+import { StandardBiometricHeader } from './standardBiometricHeader';
+
+export interface BiometricDataBlock {
+  getStandardBiometricHeader(): StandardBiometricHeader;
+}

package/src/Shared/EIDReader/cbeff/biometricDataBlockDecoder.ts

@@ -0,0 +1,12 @@
+import { InputStream } from '../java/inputStream';
+import type { BiometricDataBlock } from './biometricDataBlock';
+import { StandardBiometricHeader } from './standardBiometricHeader';
+
+export interface BiometricDataBlockDecoder<B extends BiometricDataBlock> {
+  decode(
+    inputStream: InputStream,
+    sbh: StandardBiometricHeader,
+    index: number,
+    length: number
+  ): Promise<B>;
+}

package/src/Shared/EIDReader/cbeff/biometricDataBlockEncoder.ts

@@ -0,0 +1,6 @@
+import { OutputStream } from '../java/outputStream';
+import type { BiometricDataBlock } from './biometricDataBlock';
+
+export interface BiometricDataBlockEncoder<B extends BiometricDataBlock> {
+  encode(bdb: B, out: OutputStream): void;
+}

package/src/Shared/EIDReader/cbeff/cbeffInfo.ts

@@ -0,0 +1,100 @@
+export class CBEFFInfo {
+  /*
+   * Biometric type value, based on
+   * Section 5.2.1.5 and Table 4 in NISTIR-6529A,
+   * Table C.2 in ISO/IEC 7816-11,
+   * Section 6.5.6 of ISO/IEC 19785-1.
+   */
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_NO_INFORMATION_GIVEN = 0x000000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_MULTIPLE_BIOMETRICS_USED = 0x000001;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_FACIAL_FEATURES = 0x000002;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_VOICE = 0x000004;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_FINGERPRINT = 0x000008;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_IRIS = 0x000010;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_RETINA = 0x000020;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_HAND_GEOMETRY = 0x000040;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_SIGNATURE_DYNAMICS = 0x000080;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_KEYSTROKE_DYNAMICS = 0x000100;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_LIP_MOVEMENT = 0x000200;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_THERMAL_FACE_IMAGE = 0x000400;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_THERMAL_HAND_IMAGE = 0x000800;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_GAIT = 0x001000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_BODY_ODOR = 0x002000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_DNA = 0x004000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_EAR_SHAPE = 0x008000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_FINGER_GEOMETRY = 0x010000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_PALM_PRINT = 0x020000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_VEIN_PATTERN = 0x040000;
+
+  /** Biometric type value. */
+  public static readonly BIOMETRIC_TYPE_FOOT_PRINT = 0x080000;
+
+  /*
+   * Biometric subtype, based on
+   * Section 5.1.2.6 and Table 6 in NISTIR-6529A,
+   * Table C.3 in ISO/IEC 7816-11,
+   * Section 6.5.7 of ISO/IEC 19785-1.
+   */
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_NONE = 0x00; /* 00000000 */
+
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_MASK_RIGHT = 0x01; /* xxxxxx01 */
+
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_MASK_LEFT = 0x02; /* xxxxxx10 */
+
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_MASK_THUMB = 0x04; /* xxx001xx */
+
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_MASK_POINTER_FINGER = 0x08; /* xxx010xx */
+
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_MASK_MIDDLE_FINGER = 0x0c; /* xxx011xx */
+
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_MASK_RING_FINGER = 0x10; /* xxx100xx */
+
+  /** Biometric subtype. */
+  public static readonly BIOMETRIC_SUBTYPE_MASK_LITTLE_FINGER = 0x14; /* xxx101xx */
+}

package/src/Shared/EIDReader/cbeff/complexCBEFFInfo.ts

@@ -0,0 +1,48 @@
+import { CBEFFInfo } from './cbeffInfo';
+
+export class ComplexCBEFFInfo implements CBEFFInfo {
+  private subRecords: CBEFFInfo[];
+
+  /**
+   * Constructs a default complex info, with an empty list of sub-records.
+   */
+  constructor() {
+    this.subRecords = [];
+  }
+
+  /**
+   * Returns the records inside this complex CBEFF info.
+   *
+   * @return a list of CBEFF infos
+   */
+  getSubRecords(): CBEFFInfo[] {
+    return [...this.subRecords];
+  }
+
+  /**
+   * Adds a record to this complex CBEFF info.
+   *
+   * @param subRecord the CBEFF info to add
+   */
+  add(subRecord: CBEFFInfo): void {
+    this.subRecords.push(subRecord);
+  }
+
+  /**
+   * Adds all records in a list to this complex CBEFF info.
+   *
+   * @param subRecords a list of CBEFF infos
+   */
+  addAll(subRecords: CBEFFInfo[]): void {
+    this.subRecords.push(...subRecords);
+  }
+
+  /**
+   * Removes a record in this complex CBEFF info.
+   *
+   * @param index the index of the CBEFF info to remove
+   */
+  remove(index: number): void {
+    this.subRecords.splice(index, 1);
+  }
+}

package/src/Shared/EIDReader/cbeff/faceDataBlockDecoder.ts

@@ -0,0 +1,17 @@
+import { InputStream } from '../java/inputStream';
+import { FaceInfo } from '../lds/iso19794/faceInfo';
+import type { BiometricDataBlockDecoder } from './biometricDataBlockDecoder';
+import { StandardBiometricHeader } from './standardBiometricHeader';
+
+export class FaceDataBlockDecoder
+  implements BiometricDataBlockDecoder<FaceInfo>
+{
+  public async decode(
+    inputStream: InputStream,
+    _sbh?: StandardBiometricHeader,
+    _index?: number,
+    _length?: number
+  ): Promise<FaceInfo> {
+    return await FaceInfo.from(inputStream, _sbh);
+  }
+}

package/src/Shared/EIDReader/cbeff/iso781611.ts

@@ -0,0 +1,79 @@
+export class ISO781611 {
+  static readonly BIOMETRIC_INFORMATION_GROUP_TEMPLATE_TAG = 0x7f61;
+  static readonly BIOMETRIC_INFORMATION_TEMPLATE_TAG = 0x7f60;
+
+  static readonly BIOMETRIC_INFO_COUNT_TAG = 0x02;
+  static readonly BIOMETRIC_HEADER_TEMPLATE_BASE_TAG = 0xa1;
+  static readonly BIOMETRIC_DATA_BLOCK_TAG = 0x5f2e;
+  static readonly BIOMETRIC_DATA_BLOCK_CONSTRUCTED_TAG = 0x7f2e;
+
+  static readonly DISCRETIONARY_DATA_FOR_PAYLOAD_TAG = 0x53;
+  static readonly DISCRETIONARY_DATA_FOR_PAYLOAD_CONSTRUCTED_TAG = 0x73;
+
+  /*
+   * FIXME: For 7F2E check ISO7816-11, Table 3: a 7F2E structure appears to include a 5F2E structure?
+   * Difference between primitive/constructed.
+   */
+
+  /** From ISO7816-11: Secure Messaging Template tag. */
+  static readonly SMT_TAG = 0x7d;
+
+  /** From ISO7816-11: Secure Messaging Template tag. */
+  static readonly SMT_DO_PV = 0x81;
+
+  /** From ISO7816-11: Secure Messaging Template tag. */
+  static readonly SMT_DO_CG = 0x85;
+
+  /** From ISO7816-11: Secure Messaging Template tag. */
+  static readonly SMT_DO_CC = 0x8e;
+
+  /** From ISO7816-11: Secure Messaging Template tag. */
+  static readonly SMT_DO_DS = 0x9e;
+
+  /**
+   * ISO 7816-11, table C.1., used inside the BHT.
+   * Length 2.
+   */
+  static readonly PATRON_HEADER_VERSION_TAG = 0x80;
+
+  /**
+   * Biometric Type tag, ISO7816-11.
+   */
+  static readonly BIOMETRIC_TYPE_TAG = 0x81;
+
+  /**
+   * Biometric Subtype tag, ISO7816-11.
+   */
+  static readonly BIOMETRIC_SUBTYPE_TAG = 0x82;
+
+  /**
+   * ISO7816-11 table C.1, (7), creation date and time of biometric data (CCYYMMDDhhmmss), used inside the BHT.
+   * Length 2.
+   */
+  static readonly CREATION_DATE_AND_TIME_TAG = 0x83;
+
+  /**
+   * ISO7816-11 table C.1, (8), validity period (from CCYYMMDD, to CCYYMMDD), used inside the BHT.
+   * Length 2.
+   */
+  static readonly VALIDITY_PERIOD_TAG = 0x85;
+
+  /**
+   * ISO7816-11 table C.1, (2), Identifier of product (PID) that created the biometric reference data,
+   * value assigned by IBIA.
+   * Length 2.
+   */
+  static readonly CREATOR_OF_BIOMETRIC_REFERENCE_DATA = 0x86;
+
+  /**
+   * ID of the Group or Vendor which defined the BDB, specified in NISTIR-6529A and/or ISO7817-11.
+   * Length 2.
+   */
+  static readonly FORMAT_OWNER_TAG = 0x87;
+
+  /**
+   * BDB Format Type as specified by the Format Owner, specified in NISTIR-6529A and/or ISO7816-11.
+   * Length 2.
+   */
+  static readonly FORMAT_TYPE_TAG = 0x88;
+}