edfapay-softpos-sdk-rn 1.0.0-dev.1

package/src/EdfaPayPlugin.ts

@@ -0,0 +1,551 @@
+// ignore-file: non-constant-identifier-names
+import { EdfaPayBridge } from './bridge';
+import { FlowType } from './enums/FlowType';
+import { EdfaPayCredentials } from './models/EdfaPayCredentials';
+import { TxnParams } from './models/TxnParams';
+import { Transaction } from './models/Transaction';
+import { SdkTheme } from './models/SdkTheme';
+import { Pagination } from './models/Pagination';
+import { InvoiceRequest } from './models/InvoiceRequest';
+import { BnplResponse } from './models/BnplResponse';
+import { PluginExtension } from './namespaces/Extension';
+import { PluginUtils } from './namespaces/Utils';
+import { RemoteAccess } from './namespaces/RemoteChannel';
+import type {
+  ProcessCompleteCallback,
+  OnProcessComplete,
+  TimeOutCallback,
+  CancelByUserCallback,
+  OnErrorCallback,
+  OnSuccessCallback,
+  OnTerminalBindingTask,
+} from './types';
+
+export type {
+  ProcessCompleteCallback,
+  OnProcessComplete,
+  TimeOutCallback,
+  CancelByUserCallback,
+  OnErrorCallback,
+  OnSuccessCallback,
+  OnTerminalBindingTask,
+};
+
+/// Main EdfaPay SDK entry point.
+///
+/// Mirrors the native Kotlin API exactly:
+///   EdfaPayPlugin.initiate(...)
+///   EdfaPayPlugin.purchase(...)
+///   EdfaPayPlugin.Extension.loginWithToken(...)
+///   EdfaPayPlugin.Utils.getDeviceId()
+///   EdfaPayPlugin.RemoteChannel.LocalNetwork({port:8080, timeout:30}).open()
+export class EdfaPayPlugin {
+  private constructor() {}
+
+  // ── Sub-namespaces ────────────────────────────────────────────────────────
+
+  static readonly Extension: PluginExtension = PluginExtension.create();
+  static readonly Utils: PluginUtils = PluginUtils.create();
+  static readonly RemoteChannel: RemoteAccess = RemoteAccess.create();
+
+  // ── Theme ─────────────────────────────────────────────────────────────────
+
+  /// Returns a chainable SdkTheme builder.
+  /// Usage: EdfaPayPlugin.theme().setPrimaryColor('#00cc66')
+  static theme(): SdkTheme {
+    return SdkTheme.create();
+  }
+
+  /// Set global animation speed multiplier.
+  static setAnimationSpeedX(speed: number): void {
+    EdfaPayBridge.invoke('setAnimationSpeedX', { speed });
+  }
+
+  // ── Initialization ────────────────────────────────────────────────────────
+
+  /// Set encrypted partner configuration before calling initiate().
+  static setPartnerConfig(config: string): void {
+    EdfaPayBridge.invoke('setPartnerConfig', { partnerConfig: config });
+  }
+
+  /// Enable or disable debug logging.
+  static enableLogs(enable: boolean): void {
+    EdfaPayBridge.invoke('setEnableLogs', { enable });
+  }
+
+  /// Initialize the SDK with credentials.
+  ///
+  /// When terminal binding is required, [onTerminalBindingTask] will be called
+  /// with a [TerminalBindingTask] that contains available terminals.
+  /// Use `task.bind()` to show native UI or `task.bind(terminal)` to bind
+  /// programmatically. After binding completes, [onSuccess] or [onError]
+  /// will be called automatically.
+  static initiate(params: {
+    credentials: EdfaPayCredentials;
+    onSuccess: (sessionId: string | null) => void;
+    onTerminalBindingTask: OnTerminalBindingTask;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'initiate',
+      { credentials: params.credentials.toJSON() },
+      {
+        onTerminalBindingTask: params.onTerminalBindingTask,
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  // ── Payment Operations ────────────────────────────────────────────────────
+
+  static purchase(params: {
+    txnParams: TxnParams;
+    flowType?: FlowType;
+    onPaymentProcessComplete: ProcessCompleteCallback;
+    onRequestTimerEnd: TimeOutCallback;
+    onCardScanTimerEnd: TimeOutCallback;
+    onCancelByUser: CancelByUserCallback;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'purchase',
+      {
+        txnParams: params.txnParams.toJSON(),
+        flowType: params.flowType ?? FlowType.DETAIL,
+      },
+      {
+        onPaymentProcessComplete: params.onPaymentProcessComplete,
+        onRequestTimerEnd: params.onRequestTimerEnd,
+        onCardScanTimerEnd: params.onCardScanTimerEnd,
+        onCancelByUser: params.onCancelByUser,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static authorize(params: {
+    txnParams: TxnParams;
+    flowType?: FlowType;
+    onPaymentProcessComplete: ProcessCompleteCallback;
+    onRequestTimerEnd: TimeOutCallback;
+    onCardScanTimerEnd: TimeOutCallback;
+    onCancelByUser: CancelByUserCallback;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'authorize',
+      {
+        txnParams: params.txnParams.toJSON(),
+        flowType: params.flowType ?? FlowType.DETAIL,
+      },
+      {
+        onPaymentProcessComplete: params.onPaymentProcessComplete,
+        onRequestTimerEnd: params.onRequestTimerEnd,
+        onCardScanTimerEnd: params.onCardScanTimerEnd,
+        onCancelByUser: params.onCancelByUser,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static capture(params: {
+    txnParams: TxnParams;
+    flowType?: FlowType;
+    onPaymentProcessComplete: ProcessCompleteCallback;
+    onRequestTimerEnd: TimeOutCallback;
+    onCardScanTimerEnd: TimeOutCallback;
+    onCancelByUser: CancelByUserCallback;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'capture',
+      {
+        txnParams: params.txnParams.toJSON(),
+        flowType: params.flowType ?? FlowType.DETAIL,
+      },
+      {
+        onPaymentProcessComplete: params.onPaymentProcessComplete,
+        onRequestTimerEnd: params.onRequestTimerEnd,
+        onCardScanTimerEnd: params.onCardScanTimerEnd,
+        onCancelByUser: params.onCancelByUser,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static refund(params: {
+    txnParams: TxnParams;
+    flowType?: FlowType;
+    onPaymentProcessComplete: ProcessCompleteCallback;
+    onRequestTimerEnd: TimeOutCallback;
+    onCardScanTimerEnd: TimeOutCallback;
+    onCancelByUser: CancelByUserCallback;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'refund',
+      {
+        txnParams: params.txnParams.toJSON(),
+        flowType: params.flowType ?? FlowType.DETAIL,
+      },
+      {
+        onPaymentProcessComplete: params.onPaymentProcessComplete,
+        onRequestTimerEnd: params.onRequestTimerEnd,
+        onCardScanTimerEnd: params.onCardScanTimerEnd,
+        onCancelByUser: params.onCancelByUser,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static changePin(params: {
+    parameters: string[];
+    flowType?: FlowType;
+    onProcessComplete: OnProcessComplete;
+    onRequestTimerEnd: TimeOutCallback;
+    onCardScanTimerEnd: TimeOutCallback;
+    onCancelByUser: CancelByUserCallback;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'changePin',
+      {
+        parameters: params.parameters,
+        flowType: params.flowType ?? FlowType.DETAIL,
+      },
+      {
+        onProcessComplete: params.onProcessComplete,
+        onRequestTimerEnd: params.onRequestTimerEnd,
+        onCardScanTimerEnd: params.onCardScanTimerEnd,
+        onCancelByUser: params.onCancelByUser,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static activateCard(params: {
+    parameters: string[];
+    flowType?: FlowType;
+    onProcessComplete: OnProcessComplete;
+    onRequestTimerEnd: TimeOutCallback;
+    onCardScanTimerEnd: TimeOutCallback;
+    onCancelByUser: CancelByUserCallback;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'activateCard',
+      {
+        parameters: params.parameters,
+        flowType: params.flowType ?? FlowType.DETAIL,
+      },
+      {
+        onProcessComplete: params.onProcessComplete,
+        onRequestTimerEnd: params.onRequestTimerEnd,
+        onCardScanTimerEnd: params.onCardScanTimerEnd,
+        onCancelByUser: params.onCancelByUser,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static void$(params: {
+    transaction: Transaction;
+    onSuccess: (response: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'void',
+      { transaction: params.transaction.toJSON() },
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static reverse(params: {
+    transaction: Transaction;
+    onSuccess: (response: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'reverse',
+      { transaction: params.transaction.toJSON() },
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static reverseLastTransaction(params: {
+    onSuccess: (response: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'reverseLastTransaction',
+      {},
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  // ── BNPL (Buy Now Pay Later) ──────────────────────────────────────────────
+
+  /// Initiate BNPL checkout with Tamara or Tabby.
+  ///
+  /// [request] contains provider, merchant info, customer details, and invoice.
+  /// [onSuccess] returns a BnplResponse with checkout deeplink URL.
+  /// [onError] called on failure with error details.
+  static buyNowPayLater(params: {
+    request: InvoiceRequest;
+    onSuccess: (response: BnplResponse) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'buyNowPayLater',
+      { request: params.request.toJSON() },
+      {
+        onSuccess: (result: Record<string, any>) =>
+          params.onSuccess(BnplResponse.fromJSON(result)),
+        onError: params.onError,
+      }
+    );
+  }
+
+  /// Initiate checkout link generation (invoice-based payment link).
+  ///
+  /// [request] contains provider, merchant info, customer details, and invoice.
+  /// [onSuccess] returns a BnplResponse with checkout deeplink URL.
+  /// [onError] called on failure with error details.
+  static checkoutLinkApi(params: {
+    request: InvoiceRequest;
+    onSuccess: (response: BnplResponse) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'checkoutLinkApi',
+      { request: params.request.toJSON() },
+      {
+        onSuccess: (result: Record<string, any>) =>
+          params.onSuccess(BnplResponse.fromJSON(result)),
+        onError: params.onError,
+      }
+    );
+  }
+
+  // ── Transaction History ───────────────────────────────────────────────────
+
+  static txnHistory(params: {
+    pagination?: Pagination;
+    onSuccess: (transactions: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'txnHistory',
+      { pagination: params.pagination?.toJSON() },
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static txnDetail(params: {
+    txnId: string;
+    onSuccess: (transaction: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'txnDetail',
+      { txnId: params.txnId },
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static txnDetailApi(params: {
+    txnId: string;
+    onSuccess: (transaction: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'txnDetailApi',
+      { txnId: params.txnId },
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  // ── Reconciliation ────────────────────────────────────────────────────────
+
+  static reconcile(params: {
+    onSuccess: (response: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'reconcile',
+      {},
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static reconciliationHistory(params: {
+    onSuccess: (response: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'reconciliationHistory',
+      {},
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static reconciliationDetail(params: {
+    id: string;
+    onSuccess: (response: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'reconciliationDetail',
+      { id: params.id },
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  static reconciliationReceipt(params: {
+    id: string;
+    onSuccess: (response: Record<string, any>) => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'reconciliationReceipt',
+      { id: params.id },
+      {
+        onSuccess: params.onSuccess,
+        onError: params.onError,
+      }
+    );
+  }
+
+  // ── Terminal Management ───────────────────────────────────────────────────
+
+  static terminalInfo(params: {
+    onSuccess: (terminalInfo: Record<string, any>) => void;
+    onError?: OnErrorCallback;
+  }): void {
+    const callbacks: Record<string, Function> = {
+      onSuccess: params.onSuccess,
+    };
+    if (params.onError) {
+      callbacks.onError = params.onError;
+    }
+    EdfaPayBridge.invoke('terminalInfo', {}, callbacks);
+  }
+
+  static activateTerminal(params: {
+    password?: string;
+    onSuccess: () => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'activateTerminal',
+      { password: params.password },
+      {
+        onSuccess: (_: any) => params.onSuccess(),
+        onError: params.onError,
+      }
+    );
+  }
+
+  static deActivateTerminal(params: {
+    password?: string;
+    onSuccess: () => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'deActivateTerminal',
+      { password: params.password },
+      {
+        onSuccess: (_: any) => params.onSuccess(),
+        onError: params.onError,
+      }
+    );
+  }
+
+  static syncTerminal(params: {
+    onSuccess: () => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'syncTerminal',
+      {},
+      {
+        onSuccess: (_: any) => params.onSuccess(),
+        onError: params.onError,
+      }
+    );
+  }
+
+  // ── Session Management ────────────────────────────────────────────────────
+
+  static async getSessionId(): Promise<string | null> {
+    const result = await EdfaPayBridge.invokeAsync('getSessionId');
+    return result as string | null;
+  }
+
+  static async getSessionDetail(): Promise<Record<string, any> | null> {
+    const result = await EdfaPayBridge.invokeAsync('getSessionDetail');
+    return result == null ? null : (result as Record<string, any>);
+  }
+
+  static async getSessionList(): Promise<Record<string, any>[]> {
+    const result = await EdfaPayBridge.invokeAsync('getSessionList');
+    return ((result as any[]) ?? []) as Record<string, any>[];
+  }
+
+  static logoutCurrentSession(params: {
+    onSuccess: () => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'logoutCurrentSession',
+      {},
+      {
+        onSuccess: (_: any) => params.onSuccess(),
+        onError: params.onError,
+      }
+    );
+  }
+
+  static logoutSession(params: {
+    sessionId: string;
+    onSuccess: () => void;
+    onError: OnErrorCallback;
+  }): void {
+    EdfaPayBridge.invoke(
+      'logoutSession',
+      { sessionId: params.sessionId },
+      {
+        onSuccess: (_: any) => params.onSuccess(),
+        onError: params.onError,
+      }
+    );
+  }
+}

package/src/NativeEdfapaySoftposSdkRn.ts

@@ -0,0 +1,7 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+export interface Spec extends TurboModule {
+  multiply(a: number, b: number): number;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('EdfapaySoftposSdkRn');

package/src/bridge.ts

@@ -0,0 +1,106 @@
+// ignore-file: avoid-console
+import { NativeModules, DeviceEventEmitter } from 'react-native';
+import { Terminal } from './models/Terminal';
+import { TerminalBindingTask } from './models/TerminalBindingTask';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// EdfaPayBridge  (INTERNAL — do not use directly, use EdfaPayPlugin)
+//
+//  Invoke channel  : JS → Native via NativeModules.EdfapaySoftposSdkRn
+//  Callback event  : Native → JS via RCTDeviceEventEmitter "EdfaPayCallback"
+//                    payload: { method: String, args: Array<Any> }
+//
+// Flutter equivalents:
+//   invoke channel  = com.edfapay.invoke   MethodChannel
+//   callback channel= com.edfapay.callback MethodChannel (replaced by DeviceEventEmitter)
+// ─────────────────────────────────────────────────────────────────────────────
+
+const { EdfapaySoftposSdkRn } = NativeModules;
+
+if (!EdfapaySoftposSdkRn && __DEV__) {
+  console.warn(
+    '[EdfaPayBridge] Native module "EdfapaySoftposSdkRn" not found. ' +
+      'Make sure the native module is linked and the app has been rebuilt.'
+  );
+}
+
+// Callback storage — same structure as Flutter: Map<callbackName, Function>
+// Replaced entirely on each invoke (same as Flutter: _callbacks = callbacks)
+let _callbacks: Record<string, Function> = {};
+
+// ── Native → JS event handler ──────────────────────────────────────────────
+
+DeviceEventEmitter.addListener(
+  'EdfaPayCallback',
+  (event: { method: string; args: any[] }) => {
+    const { method, args } = event;
+    // Native SDK may send prefixed names like "initiate.onError" — fall back to
+    // the unprefixed key (e.g. "onError") when an exact match isn't found.
+    const unprefixed = method.includes('.') ? method.split('.').pop()! : method;
+    const cb = _callbacks[method] ?? _callbacks[unprefixed];
+
+    if (!cb) {
+      console.log('[EdfaPayBridge] No callback registered for:', method);
+      return;
+    }
+
+    // Special handling: onTerminalBindingTask — wrap raw terminal maps in TerminalBindingTask.
+    // Pass a bound invoker so TerminalBindingTask.bind() calls back into the bridge
+    // without a circular module import.
+    if (unprefixed === 'onTerminalBindingTask') {
+      const rawList: any[] = args[0] ?? [];
+      const terminalList: Terminal[] = rawList.map((t: any) =>
+        Terminal.fromJSON(t as Record<string, any>)
+      );
+      const task = new TerminalBindingTask(terminalList);
+      cb(task);
+      console.log(
+        `[EdfaPayBridge] Triggered onTerminalBindingTask with ${terminalList.length} terminal(s)`
+      );
+      return;
+    }
+
+    // Default handling: normalise each arg (Map stays as-is, primitives pass through)
+    const positionalArgs: any[] = (args ?? []).map((arg: any) => {
+      if (arg !== null && typeof arg === 'object' && !Array.isArray(arg)) {
+        return arg as Record<string, any>;
+      }
+      return arg;
+    });
+
+    cb(...positionalArgs);
+    console.log(
+      `[EdfaPayBridge] Triggered "${method}" with ${positionalArgs.length} arg(s)`
+    );
+  }
+);
+
+// ── Public bridge API ──────────────────────────────────────────────────────
+
+export const EdfaPayBridge = {
+  /**
+   * Send a method call to native and (optionally) replace the active callback map.
+   * Mirrors Flutter: _bridge.invoke(method, params: ..., callbacks: ...)
+   */
+  invoke(
+    method: string,
+    params?: Record<string, any>,
+    callbacks?: Record<string, Function>
+  ): void {
+    if (callbacks) {
+      _callbacks = callbacks;
+    }
+    EdfapaySoftposSdkRn?.invoke?.(method, params ?? {});
+  },
+
+  /**
+   * Send a method call to native and return a Promise with the result.
+   * Mirrors Flutter: await _bridge.invoke(method, params: ...)
+   */
+  invokeAsync(method: string, params?: Record<string, any>): Promise<any> {
+    return (
+      EdfapaySoftposSdkRn?.invokeAsync?.(method, params ?? {}) ??
+      Promise.resolve(null)
+    );
+  },
+};

package/src/enums/Env.ts

@@ -0,0 +1,7 @@
+export enum Env {
+  DEVELOPMENT = 'DEVELOPMENT',
+  STAGING = 'STAGING',
+  SANDBOX = 'SANDBOX',
+  PRODUCTION = 'PRODUCTION',
+  REVAMP = 'REVAMP'
+}

package/src/enums/FlowType.ts

@@ -0,0 +1,5 @@
+export enum FlowType {
+  IMMEDIATE = 'IMMEDIATE',
+  STATUS = 'STATUS',
+  DETAIL = 'DETAIL',
+}

package/src/enums/FunctionCode.ts

@@ -0,0 +1,8 @@
+export enum FunctionCode {
+  FULL_TERMINAL_CONFIGURATION = 'FULL_TERMINAL_CONFIGURATION',
+  PARTIAL_TERMINAL_CONFIGURATION = 'PARTIAL_TERMINAL_CONFIGURATION',
+  FORCE_RECONCILIATION = 'FORCE_RECONCILIATION',
+  NORMAL_RECONCILIATION = 'NORMAL_RECONCILIATION',
+  REVERSE_TRANSACTION = 'REVERSE_TRANSACTION',
+  CANCEL_TRANSACTION = 'CANCEL_TRANSACTION',
+}

package/src/enums/PaymentMethod.ts

@@ -0,0 +1,4 @@
+export enum PaymentMethod {
+  TAMARA = 'TAMARA',
+  TABBY = 'TABBY',
+}