@dodicandra/minesec-rn 1.0.0

package/plugin/build/index.js

@@ -0,0 +1,219 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const { getMainApplicationOrThrow } = config_plugins_1.AndroidConfig.Manifest;
+const HEADLESS_ACTIVITY = 'expo.modules.minesecrn.MinesecrnHeadlessActivity';
+const MINESEC_MAVEN_URL = 'https://maven.pkg.github.com/TheMinesec/ms-registry-client';
+const OLD_MINESEC_MAVEN_URL = 'https://maven.theminesec.com/releases';
+const MINESEC_MIN_SDK = 30;
+const MINESEC_SENTINEL = '/* minesec-minSdk */';
+/**
+ * Hapus satu maven block yang mengandung urlSubstring.
+ * Menghitung nested braces agar aman untuk blok credentials/content bersarang.
+ */
+function removeMavenBlock(contents, urlSubstring) {
+    const lines = contents.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        if (lines[i].includes(urlSubstring)) {
+            // Cari baris pembuka `maven {` dengan mundur
+            let openIdx = i;
+            while (openIdx > 0 && !lines[openIdx].trimStart().startsWith('maven')) {
+                openIdx--;
+            }
+            // Hitung brace untuk menemukan penutup `}`
+            let depth = 0;
+            let closeIdx = openIdx;
+            for (let j = openIdx; j < lines.length; j++) {
+                for (const ch of lines[j]) {
+                    if (ch === '{')
+                        depth++;
+                    else if (ch === '}')
+                        depth--;
+                }
+                if (depth === 0) {
+                    closeIdx = j;
+                    break;
+                }
+            }
+            lines.splice(openIdx, closeIdx - openIdx + 1);
+            i = openIdx;
+        }
+        else {
+            i++;
+        }
+    }
+    return lines.join('\n');
+}
+const withMinesecManifest = (config, options = {}) => (0, config_plugins_1.withAndroidManifest)(config, (mod) => {
+    var _a;
+    const manifest = mod.modResults.manifest;
+    const enableNfc = (_a = options.enableNfc) !== null && _a !== void 0 ? _a : true;
+    if (!manifest['uses-permission'])
+        manifest['uses-permission'] = [];
+    if (!manifest['uses-feature'])
+        manifest['uses-feature'] = [];
+    const permissions = manifest['uses-permission'];
+    const features = manifest['uses-feature'];
+    if (!permissions.some((p) => p.$['android:name'] === 'android.permission.INTERNET')) {
+        permissions.push({ $: { 'android:name': 'android.permission.INTERNET' } });
+    }
+    if (enableNfc) {
+        if (!permissions.some((p) => p.$['android:name'] === 'android.permission.NFC')) {
+            permissions.push({ $: { 'android:name': 'android.permission.NFC' } });
+        }
+        if (!features.some((f) => f.$['android:name'] === 'android.hardware.nfc')) {
+            features.push({
+                $: { 'android:name': 'android.hardware.nfc', 'android:required': 'true' },
+            });
+        }
+    }
+    const mainApplication = getMainApplicationOrThrow(mod.modResults);
+    if (!mainApplication.activity)
+        mainApplication.activity = [];
+    const activities = mainApplication.activity;
+    // SDK v1 (headless 1.2.37): activity berjalan di proses utama dengan
+    // launchMode singleTask, mengikuti contoh resmi ms-example-sdk-headless.
+    // Proses terpisah (":headless") hanya untuk SDK v2 (headless-mpoc).
+    const existingActivity = activities.find((a) => a.$['android:name'] === HEADLESS_ACTIVITY);
+    if (existingActivity) {
+        delete existingActivity.$['android:process'];
+        existingActivity.$['android:launchMode'] = 'singleTask';
+    }
+    else {
+        activities.push({
+            $: {
+                'android:name': HEADLESS_ACTIVITY,
+                'android:exported': 'false',
+                'android:launchMode': 'singleTask',
+            },
+        });
+    }
+    return mod;
+});
+const withMinesecRootGradle = (config) => (0, config_plugins_1.withProjectBuildGradle)(config, (mod) => {
+    // Hapus blok lama (handle nested braces dengan removeMavenBlock)
+    mod.modResults.contents = removeMavenBlock(mod.modResults.contents, OLD_MINESEC_MAVEN_URL);
+    mod.modResults.contents = removeMavenBlock(mod.modResults.contents, MINESEC_MAVEN_URL);
+    // Inject blok baru dengan credentials yang benar
+    const mavenBlock = `
+        maven {
+            url = uri("${MINESEC_MAVEN_URL}")
+            credentials {
+                username = (findProperty("username") ?: System.getenv("MINESEC_MAVEN_USER") ?: "").toString()
+                password = (findProperty("usertoken") ?: System.getenv("MINESEC_MAVEN_TOKEN") ?: "").toString()
+            }
+            content {
+                includeGroupByRegex "com\\\\.theminesec\\\\..*"
+            }
+        }`;
+    mod.modResults.contents = mod.modResults.contents.replace(/allprojects\s*\{\s*\n(\s*)repositories\s*\{/, `allprojects {\n$1repositories {${mavenBlock}`);
+    return mod;
+});
+const withMinesecAppGradle = (config) => (0, config_plugins_1.withAppBuildGradle)(config, (mod) => {
+    // Pastikan minSdkVersion >= MINESEC_MIN_SDK; idempoten via sentinel
+    if (!mod.modResults.contents.includes(MINESEC_SENTINEL)) {
+        mod.modResults.contents = mod.modResults.contents.replace(/minSdkVersion\s+\S+/, `minSdkVersion Math.max(rootProject.ext.minSdkVersion.toInteger(), ${MINESEC_MIN_SDK}) ${MINESEC_SENTINEL}`);
+    }
+    // Tambah packaging exclusions jika belum ada
+    if (mod.modResults.contents.includes('packagingOptions') &&
+        !mod.modResults.contents.includes('META-INF/DEPENDENCIES')) {
+        const exclusionsBlock = `
+        resources {
+            excludes += [
+                'META-INF/DEPENDENCIES',
+                'META-INF/LICENSE*',
+                'META-INF/NOTICE*',
+            ]
+        }`;
+        mod.modResults.contents = mod.modResults.contents.replace(/packagingOptions\s*\{/, `packagingOptions {${exclusionsBlock}`);
+    }
+    return mod;
+});
+const withMinesecGradleProperties = (config, options) => (0, config_plugins_1.withGradleProperties)(config, (mod) => {
+    // Hapus entri lama agar tidak duplikat
+    mod.modResults = mod.modResults.filter((item) => !(item.type === 'property' && (item.key === 'username' || item.key === 'usertoken')));
+    if (options.username) {
+        mod.modResults.push({ type: 'property', key: 'username', value: options.username });
+    }
+    if (options.usertoken) {
+        mod.modResults.push({ type: 'property', key: 'usertoken', value: options.usertoken });
+    }
+    return mod;
+});
+const withMinesecLicenseFile = (config, options) => (0, config_plugins_1.withAndroidManifest)(config, (mod) => {
+    const { projectRoot } = mod.modRequest;
+    const licenseFileName = options.licenseFileName;
+    const srcPath = path.join(projectRoot, licenseFileName);
+    const destDir = path.join(projectRoot, 'android', 'app', 'src', 'main', 'assets');
+    const destPath = path.join(destDir, path.basename(licenseFileName));
+    if (fs.existsSync(srcPath)) {
+        if (!fs.existsSync(destDir))
+            fs.mkdirSync(destDir, { recursive: true });
+        fs.copyFileSync(srcPath, destPath);
+    }
+    else {
+        console.warn(`[minesecrn] License file not found: ${srcPath}. Tempatkan file di project root sebelum build.`);
+    }
+    return mod;
+});
+/**
+ * Expo Config Plugin untuk Minesec Headless SoftPOS SDK.
+ *
+ * Options (di app.json):
+ *   enableNfc      — tambah NFC permission/feature (default: true). Set false jika konflik dengan lib lain.
+ *   licenseFileName — nama file lisensi SDK dari project root; dicopy ke android assets saat prebuild.
+ *   username       — Maven username; ditulis ke gradle.properties sebagai "username".
+ *   usertoken      — Maven token; ditulis ke gradle.properties sebagai "usertoken".
+ *
+ * Untuk production, gunakan ~/.gradle/gradle.properties atau env vars
+ * MINESEC_MAVEN_USER / MINESEC_MAVEN_TOKEN daripada menyimpan credentials di app.json.
+ */
+const withMinesec = (config, options = {}) => {
+    config = withMinesecManifest(config, options);
+    config = withMinesecRootGradle(config);
+    config = withMinesecAppGradle(config);
+    if (options.username || options.usertoken) {
+        config = withMinesecGradleProperties(config, options);
+    }
+    if (options.licenseFileName) {
+        config = withMinesecLicenseFile(config, options);
+    }
+    return config;
+};
+exports.default = withMinesec;

package/plugin/src/index.ts

@@ -0,0 +1,239 @@
+import {
+  type ConfigPlugin,
+  withAndroidManifest,
+  withProjectBuildGradle,
+  withAppBuildGradle,
+  withGradleProperties,
+  AndroidConfig,
+} from '@expo/config-plugins';
+import * as fs from 'fs';
+import * as path from 'path';
+
+const { getMainApplicationOrThrow } = AndroidConfig.Manifest;
+
+export interface MinesecPluginOptions {
+  enableNfc?: boolean;
+  licenseFileName?: string;
+  username?: string;
+  usertoken?: string;
+}
+
+const HEADLESS_ACTIVITY = 'expo.modules.minesecrn.MinesecrnHeadlessActivity';
+const MINESEC_MAVEN_URL = 'https://maven.pkg.github.com/TheMinesec/ms-registry-client';
+const OLD_MINESEC_MAVEN_URL = 'https://maven.theminesec.com/releases';
+const MINESEC_MIN_SDK = 30;
+const MINESEC_SENTINEL = '/* minesec-minSdk */';
+
+/**
+ * Hapus satu maven block yang mengandung urlSubstring.
+ * Menghitung nested braces agar aman untuk blok credentials/content bersarang.
+ */
+function removeMavenBlock(contents: string, urlSubstring: string): string {
+  const lines = contents.split('\n');
+  let i = 0;
+  while (i < lines.length) {
+    if (lines[i].includes(urlSubstring)) {
+      // Cari baris pembuka `maven {` dengan mundur
+      let openIdx = i;
+      while (openIdx > 0 && !lines[openIdx].trimStart().startsWith('maven')) {
+        openIdx--;
+      }
+      // Hitung brace untuk menemukan penutup `}`
+      let depth = 0;
+      let closeIdx = openIdx;
+      for (let j = openIdx; j < lines.length; j++) {
+        for (const ch of lines[j]) {
+          if (ch === '{') depth++;
+          else if (ch === '}') depth--;
+        }
+        if (depth === 0) {
+          closeIdx = j;
+          break;
+        }
+      }
+      lines.splice(openIdx, closeIdx - openIdx + 1);
+      i = openIdx;
+    } else {
+      i++;
+    }
+  }
+  return lines.join('\n');
+}
+
+const withMinesecManifest: ConfigPlugin<MinesecPluginOptions> = (config, options = {}) =>
+  withAndroidManifest(config, (mod) => {
+    const manifest = mod.modResults.manifest;
+    const enableNfc = options.enableNfc ?? true;
+
+    if (!manifest['uses-permission']) manifest['uses-permission'] = [];
+    if (!manifest['uses-feature']) manifest['uses-feature'] = [];
+
+    const permissions = manifest['uses-permission'] as { $: { 'android:name': string } }[];
+    const features = manifest['uses-feature'] as {
+      $: { 'android:name': string; 'android:required': string };
+    }[];
+
+    if (!permissions.some((p) => p.$['android:name'] === 'android.permission.INTERNET')) {
+      permissions.push({ $: { 'android:name': 'android.permission.INTERNET' } });
+    }
+
+    if (enableNfc) {
+      if (!permissions.some((p) => p.$['android:name'] === 'android.permission.NFC')) {
+        permissions.push({ $: { 'android:name': 'android.permission.NFC' } });
+      }
+      if (!features.some((f) => f.$['android:name'] === 'android.hardware.nfc')) {
+        features.push({
+          $: { 'android:name': 'android.hardware.nfc', 'android:required': 'true' },
+        });
+      }
+    }
+
+    const mainApplication = getMainApplicationOrThrow(mod.modResults);
+    if (!mainApplication.activity) mainApplication.activity = [];
+
+    const activities = mainApplication.activity as { $: Record<string, string> }[];
+    // SDK v1 (headless 1.2.37): activity berjalan di proses utama dengan
+    // launchMode singleTask, mengikuti contoh resmi ms-example-sdk-headless.
+    // Proses terpisah (":headless") hanya untuk SDK v2 (headless-mpoc).
+    const existingActivity = activities.find((a) => a.$['android:name'] === HEADLESS_ACTIVITY);
+    if (existingActivity) {
+      delete existingActivity.$['android:process'];
+      existingActivity.$['android:launchMode'] = 'singleTask';
+    } else {
+      activities.push({
+        $: {
+          'android:name': HEADLESS_ACTIVITY,
+          'android:exported': 'false',
+          'android:launchMode': 'singleTask',
+        },
+      });
+    }
+
+    return mod;
+  });
+
+const withMinesecRootGradle: ConfigPlugin = (config) =>
+  withProjectBuildGradle(config, (mod) => {
+    // Hapus blok lama (handle nested braces dengan removeMavenBlock)
+    mod.modResults.contents = removeMavenBlock(mod.modResults.contents, OLD_MINESEC_MAVEN_URL);
+    mod.modResults.contents = removeMavenBlock(mod.modResults.contents, MINESEC_MAVEN_URL);
+
+    // Inject blok baru dengan credentials yang benar
+    const mavenBlock = `
+        maven {
+            url = uri("${MINESEC_MAVEN_URL}")
+            credentials {
+                username = (findProperty("username") ?: System.getenv("MINESEC_MAVEN_USER") ?: "").toString()
+                password = (findProperty("usertoken") ?: System.getenv("MINESEC_MAVEN_TOKEN") ?: "").toString()
+            }
+            content {
+                includeGroupByRegex "com\\\\.theminesec\\\\..*"
+            }
+        }`;
+
+    mod.modResults.contents = mod.modResults.contents.replace(
+      /allprojects\s*\{\s*\n(\s*)repositories\s*\{/,
+      `allprojects {\n$1repositories {${mavenBlock}`
+    );
+
+    return mod;
+  });
+
+const withMinesecAppGradle: ConfigPlugin = (config) =>
+  withAppBuildGradle(config, (mod) => {
+    // Pastikan minSdkVersion >= MINESEC_MIN_SDK; idempoten via sentinel
+    if (!mod.modResults.contents.includes(MINESEC_SENTINEL)) {
+      mod.modResults.contents = mod.modResults.contents.replace(
+        /minSdkVersion\s+\S+/,
+        `minSdkVersion Math.max(rootProject.ext.minSdkVersion.toInteger(), ${MINESEC_MIN_SDK}) ${MINESEC_SENTINEL}`
+      );
+    }
+
+    // Tambah packaging exclusions jika belum ada
+    if (
+      mod.modResults.contents.includes('packagingOptions') &&
+      !mod.modResults.contents.includes('META-INF/DEPENDENCIES')
+    ) {
+      const exclusionsBlock = `
+        resources {
+            excludes += [
+                'META-INF/DEPENDENCIES',
+                'META-INF/LICENSE*',
+                'META-INF/NOTICE*',
+            ]
+        }`;
+      mod.modResults.contents = mod.modResults.contents.replace(
+        /packagingOptions\s*\{/,
+        `packagingOptions {${exclusionsBlock}`
+      );
+    }
+
+    return mod;
+  });
+
+const withMinesecGradleProperties: ConfigPlugin<MinesecPluginOptions> = (config, options) =>
+  withGradleProperties(config, (mod) => {
+    // Hapus entri lama agar tidak duplikat
+    mod.modResults = mod.modResults.filter(
+      (item) => !(item.type === 'property' && (item.key === 'username' || item.key === 'usertoken'))
+    );
+
+    if (options.username) {
+      mod.modResults.push({ type: 'property', key: 'username', value: options.username });
+    }
+    if (options.usertoken) {
+      mod.modResults.push({ type: 'property', key: 'usertoken', value: options.usertoken });
+    }
+
+    return mod;
+  });
+
+const withMinesecLicenseFile: ConfigPlugin<MinesecPluginOptions> = (config, options) =>
+  withAndroidManifest(config, (mod) => {
+    const { projectRoot } = mod.modRequest;
+    const licenseFileName = options.licenseFileName!;
+    const srcPath = path.join(projectRoot, licenseFileName);
+    const destDir = path.join(projectRoot, 'android', 'app', 'src', 'main', 'assets');
+    const destPath = path.join(destDir, path.basename(licenseFileName));
+
+    if (fs.existsSync(srcPath)) {
+      if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+      fs.copyFileSync(srcPath, destPath);
+    } else {
+      console.warn(
+        `[minesecrn] License file not found: ${srcPath}. Tempatkan file di project root sebelum build.`
+      );
+    }
+
+    return mod;
+  });
+
+/**
+ * Expo Config Plugin untuk Minesec Headless SoftPOS SDK.
+ *
+ * Options (di app.json):
+ *   enableNfc      — tambah NFC permission/feature (default: true). Set false jika konflik dengan lib lain.
+ *   licenseFileName — nama file lisensi SDK dari project root; dicopy ke android assets saat prebuild.
+ *   username       — Maven username; ditulis ke gradle.properties sebagai "username".
+ *   usertoken      — Maven token; ditulis ke gradle.properties sebagai "usertoken".
+ *
+ * Untuk production, gunakan ~/.gradle/gradle.properties atau env vars
+ * MINESEC_MAVEN_USER / MINESEC_MAVEN_TOKEN daripada menyimpan credentials di app.json.
+ */
+const withMinesec: ConfigPlugin<MinesecPluginOptions> = (config, options = {}) => {
+  config = withMinesecManifest(config, options);
+  config = withMinesecRootGradle(config);
+  config = withMinesecAppGradle(config);
+
+  if (options.username || options.usertoken) {
+    config = withMinesecGradleProperties(config, options);
+  }
+
+  if (options.licenseFileName) {
+    config = withMinesecLicenseFile(config, options);
+  }
+
+  return config;
+};
+
+export default withMinesec;

package/plugin/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "lib": ["esnext"],
+    "target": "ES2019",
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "rootDir": "./src",
+    "outDir": "./build",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "types": ["node"]
+  },
+  "include": ["./src"]
+}

package/plugin/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts"],"version":"5.9.3"}

package/src/Minesecrn.types.ts

@@ -0,0 +1,126 @@
+// ─── Amount ───────────────────────────────────────────────────────────────────
+
+export type Amount = {
+  /** Nilai transaksi dalam string desimal, contoh: "1.00" */
+  value: string;
+  /** Kode mata uang ISO 4217, contoh: "HKD", "USD", "IDR" */
+  currencyCode: string;
+};
+
+// ─── Transaction Type ──────────────────────────────────────────────────────────
+
+export type TranType = 'SALE' | 'AUTH' | 'REFUND';
+
+// ─── CvmSignatureMode ─────────────────────────────────────────────────────────
+
+export type CvmSignatureMode = 'ELECTRONIC_SIGNATURE' | 'SIGN_ON_PAPER';
+
+// ─── PoiRequest variants ───────────────────────────────────────────────────────
+
+/** Memulai transaksi baru dengan NFC tap — membutuhkan UI HeadlessActivity */
+export type PoiRequestActionNew = {
+  type: 'ActionNew';
+  tranType: TranType;
+  amount: Amount;
+  /** Profile ID dari Minesec backend untuk routing transaksi */
+  profileId: string;
+  primaryTid?: string;
+  description?: string;
+  /** Referensi POS internal untuk rekonsiliasi */
+  posReference?: string;
+  cvmSignatureMode?: CvmSignatureMode;
+  tapToOwnDevice?: boolean;
+  installmentPlan?: number;
+  extra?: Record<string, string>;
+};
+
+/** Void transaksi sebelum settlement — tidak perlu NFC */
+export type PoiRequestActionVoid = {
+  type: 'ActionVoid';
+  tranId: string;
+};
+
+/** Refund tanpa tap ulang — hanya MPGS gateway yang support */
+export type PoiRequestActionLinkedRefund = {
+  type: 'ActionLinkedRefund';
+  tranId: string;
+  /** Jika null, refund penuh */
+  amount?: Amount;
+};
+
+/** Adjustment jumlah (tip, incremental auth) */
+export type PoiRequestActionAdjust = {
+  type: 'ActionAdjust';
+  tranId: string;
+  /** Total jumlah baru setelah adjustment */
+  amount: Amount;
+};
+
+/** Capture pre-authorized transaction */
+export type PoiRequestActionAuthComp = {
+  type: 'ActionAuthComp';
+  tranId: string;
+  amount: Amount;
+};
+
+export type PoiRequest =
+  | PoiRequestActionNew
+  | PoiRequestActionVoid
+  | PoiRequestActionLinkedRefund
+  | PoiRequestActionAdjust
+  | PoiRequestActionAuthComp;
+
+/** PoiRequest yang bisa digunakan tanpa UI (HeadlessService) */
+export type PoiRequestBackground = Exclude<PoiRequest, PoiRequestActionNew>;
+
+// ─── Reference untuk query transaksi ──────────────────────────────────────────
+
+export type TransactionReferenceType = 'tranId' | 'posReference';
+
+// ─── Result types ─────────────────────────────────────────────────────────────
+
+export type MinesecResult<T> =
+  | { success: true; value: T }
+  | {
+      success: false;
+      code: number;
+      message: string;
+      contextual?: string;
+      extra?: Record<string, string>;
+    };
+
+// ─── SDK Init ─────────────────────────────────────────────────────────────────
+
+export type SdkInitResult = {
+  sdkVersion: string;
+  sdkId: string;
+};
+
+// ─── Setup Result ──────────────────────────────────────────────────────────────
+
+export type SetupResult = {
+  sdkRes: MinesecResult<SdkInitResult>;
+  emvRes: MinesecResult<unknown>[];
+  capkRes: MinesecResult<unknown>[];
+  termRes: MinesecResult<unknown>;
+  keyRes: MinesecResult<unknown>[];
+};
+
+// ─── Transaction ───────────────────────────────────────────────────────────────
+
+export type Transaction = {
+  id: string;
+  status: string | null;
+  tranType: string | null;
+  amount: Amount | null;
+  posReference: string | null;
+  approvalCode: string | null;
+  /** Metode pembayaran, contoh: "VISA", "MASTERCARD" */
+  paymentMethod: string | null;
+  /** Nomor kartu yang disamarkan */
+  accountMasked: string | null;
+  rrn: string | null;
+  batchNo: string | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+};

package/src/MinesecrnModule.ts

@@ -0,0 +1,52 @@
+import { NativeModule, requireNativeModule } from 'expo';
+
+import type {
+  MinesecResult,
+  PoiRequest,
+  PoiRequestBackground,
+  SdkInitResult,
+  SetupResult,
+  Transaction,
+  TransactionReferenceType,
+} from './Minesecrn.types';
+
+declare class MinesecrnModule extends NativeModule<Record<string, never>> {
+  /**
+   * Inisialisasi Minesec SDK. Harus dipanggil setiap kali aplikasi launch.
+   * @param licenseFileName Nama file .license di folder assets, contoh: "license.license"
+   */
+  initSoftPos(licenseFileName: string): Promise<MinesecResult<SdkInitResult>>;
+
+  /**
+   * Setup awal SDK — download EMV params, CAPK, terminal config, dan inject keys.
+   * Cukup dipanggil sekali per instalasi.
+   * @param withTestCapk Set true untuk development/staging environment
+   */
+  initialSetup(withTestCapk?: boolean): Promise<SetupResult>;
+
+  /**
+   * Launch HeadlessActivity untuk memproses transaksi dengan UI dan NFC.
+   * Mendukung ActionNew, ActionVoid, ActionLinkedRefund, ActionAdjust, ActionAuthComp.
+   * @param request PoiRequest object
+   */
+  launchTransaction(request: PoiRequest): Promise<MinesecResult<Transaction>>;
+
+  /**
+   * Eksekusi aksi background tanpa UI (void, refund, adjust, auth-complete).
+   * Gunakan HeadlessService di backend — tidak ada NFC tap.
+   * @param request PoiRequest non-ActionNew
+   */
+  createAction(request: PoiRequestBackground): Promise<MinesecResult<Transaction>>;
+
+  /**
+   * Query transaksi berdasarkan referensi.
+   * @param refType 'tranId' (prefix tran_) atau 'posReference'
+   * @param refValue Nilai referensi
+   */
+  getTransaction(
+    refType: TransactionReferenceType,
+    refValue: string
+  ): Promise<MinesecResult<Transaction>>;
+}
+
+export default requireNativeModule<MinesecrnModule>('Minesecrn');

package/src/MinesecrnModule.web.ts

@@ -0,0 +1,27 @@
+import { NativeModule, registerWebModule } from 'expo';
+
+// Minesec Headless SDK tidak tersedia di platform web atau iOS.
+// Semua method akan throw error jika dipanggil di luar Android.
+class MinesecrnModule extends NativeModule<Record<string, never>> {
+  async initSoftPos(_licenseFileName: string): Promise<never> {
+    throw new Error('Minesec Headless SDK is only available on Android');
+  }
+
+  async initialSetup(_withTestCapk?: boolean): Promise<never> {
+    throw new Error('Minesec Headless SDK is only available on Android');
+  }
+
+  async launchTransaction(_request: unknown): Promise<never> {
+    throw new Error('Minesec Headless SDK is only available on Android');
+  }
+
+  async createAction(_request: unknown): Promise<never> {
+    throw new Error('Minesec Headless SDK is only available on Android');
+  }
+
+  async getTransaction(_refType: string, _refValue: string): Promise<never> {
+    throw new Error('Minesec Headless SDK is only available on Android');
+  }
+}
+
+export default registerWebModule(MinesecrnModule, 'Minesecrn');

package/src/index.ts

@@ -0,0 +1,2 @@
+export { default } from './MinesecrnModule';
+export * from './Minesecrn.types';