edfapay-softpos-sdk-rn 1.0.0

package/src/enums/Presentation.ts

@@ -0,0 +1,12 @@
+export enum Presentation {
+  FULLSCREEN = 'FULLSCREEN',
+  DIALOG_CENTER = 'DIALOG_CENTER',
+  DIALOG_TOP_FILL = 'DIALOG_TOP_FILL',
+  DIALOG_TOP_START = 'DIALOG_TOP_START',
+  DIALOG_TOP_END = 'DIALOG_TOP_END',
+  DIALOG_TOP_CENTER = 'DIALOG_TOP_CENTER',
+  DIALOG_BOTTOM_FILL = 'DIALOG_BOTTOM_FILL',
+  DIALOG_BOTTOM_START = 'DIALOG_BOTTOM_START',
+  DIALOG_BOTTOM_END = 'DIALOG_BOTTOM_END',
+  DIALOG_BOTTOM_CENTER = 'DIALOG_BOTTOM_CENTER',
+}

package/src/enums/PurchaseSecondaryAction.ts

@@ -0,0 +1,5 @@
+export enum PurchaseSecondaryAction {
+  NONE = 'NONE',
+  REVERSE = 'REVERSE',
+  REFUND = 'REFUND',
+}

package/src/enums/TransactionType.ts

@@ -0,0 +1,11 @@
+export enum TransactionType {
+  PURCHASE = 'PURCHASE',
+  AUTHORIZE = 'AUTHORIZE',
+  CAPTURE = 'CAPTURE',
+  REFUND = 'REFUND',
+  REVERSAL = 'REVERSAL',
+  VOID = 'VOID',
+  CASHBACK = 'CASHBACK',
+  CHANGE_PIN = 'CHANGE_PIN',
+  CARD_ACTIVATION = 'CARD_ACTIVATION',
+}

package/src/globals.d.ts

@@ -0,0 +1 @@
+declare const __DEV__: boolean;

package/src/index.tsx

@@ -0,0 +1,52 @@
+export { multiply } from './multiply';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// EdfaPay React Native SDK — barrel export
+// ─────────────────────────────────────────────────────────────────────────────
+
+// Main plugin
+export { EdfaPayPlugin } from './EdfaPayPlugin';
+
+// Callback type aliases
+export type {
+  ProcessCompleteCallback,
+  OnProcessComplete,
+  TimeOutCallback,
+  CancelByUserCallback,
+  OnErrorCallback,
+  OnSuccessCallback,
+  OnTerminalBindingTask,
+} from './types';
+
+// Enums
+export { Env } from './enums/Env';
+export { FlowType } from './enums/FlowType';
+export { TransactionType } from './enums/TransactionType';
+export { Presentation } from './enums/Presentation';
+export { PurchaseSecondaryAction } from './enums/PurchaseSecondaryAction';
+export { FunctionCode } from './enums/FunctionCode';
+export { PaymentMethod } from './enums/PaymentMethod';
+
+// Models
+export { Location } from './models/Location';
+export { Terminal } from './models/Terminal';
+export { TerminalBindingTask } from './models/TerminalBindingTask';
+export { EdfaPayCredentials } from './models/EdfaPayCredentials';
+export { Transaction } from './models/Transaction';
+export { TxnParams } from './models/TxnParams';
+export { Pagination, SortOrder, SortField } from './models/Pagination';
+export { BnplResponse } from './models/BnplResponse';
+export {
+  InvoiceRequest,
+  Invoice,
+  InvoiceLineItem,
+  AdditionalData,
+} from './models/InvoiceRequest';
+export { UserInfo } from './models/UserInfo';
+export { PresentationConfig } from './models/PresentationConfig';
+export { SdkTheme } from './models/SdkTheme';
+
+// Namespaces (also accessible as EdfaPayPlugin.Extension, .Utils, .RemoteChannel)
+export { PluginExtension } from './namespaces/Extension';
+export { PluginUtils } from './namespaces/Utils';
+export { RemoteAccess, LocalNetworkChannel } from './namespaces/RemoteChannel';

package/src/models/BnplResponse.ts

@@ -0,0 +1,31 @@
+/// BNPL checkout response. Mirrors native BnplResponse class.
+export class BnplResponse {
+  constructor(
+    public readonly checkoutId: string,
+    public readonly paymentGatewayTransactionId: string,
+    public readonly checkoutDeeplink: string,
+    public readonly transactionId: string,
+  ) {}
+
+  static fromJSON(json: Record<string, any>): BnplResponse {
+    return new BnplResponse(
+      (json['checkoutId'] as string) ?? '',
+      (json['paymentGatewayTransactionId'] as string) ?? '',
+      (json['checkoutDeeplink'] as string) ?? '',
+      (json['transactionId'] as string) ?? '',
+    );
+  }
+
+  toJSON(): Record<string, any> {
+    return {
+      checkoutId: this.checkoutId,
+      paymentGatewayTransactionId: this.paymentGatewayTransactionId,
+      checkoutDeeplink: this.checkoutDeeplink,
+      transactionId: this.transactionId,
+    };
+  }
+
+  toString(): string {
+    return `BnplResponse(checkoutId: ${this.checkoutId}, transactionId: ${this.transactionId}, checkoutDeeplink: ${this.checkoutDeeplink})`;
+  }
+}

package/src/models/EdfaPayCredentials.ts

@@ -0,0 +1,36 @@
+import { Env } from '../enums/Env';
+
+/// Credentials for SDK initialization. Matches: EdfaPayCredentials in native SDK.
+export class EdfaPayCredentials {
+  constructor(
+    public readonly environment: Env,
+    public readonly token?: string,
+    public readonly email?: string,
+    public readonly password?: string,
+  ) {}
+
+  static withToken(environment: Env, token: string): EdfaPayCredentials {
+    return new EdfaPayCredentials(environment, token);
+  }
+
+  static withEmailPassword(environment: Env, email: string, password: string): EdfaPayCredentials {
+    return new EdfaPayCredentials(environment, undefined, email, password);
+  }
+
+  static withInput(environment: Env): EdfaPayCredentials {
+    return new EdfaPayCredentials(environment);
+  }
+
+  static withEmail(environment: Env, email: string): EdfaPayCredentials {
+    return new EdfaPayCredentials(environment, undefined, email);
+  }
+
+  toJSON(): Record<string, any> {
+    return {
+      environment: this.environment,
+      token: this.token,
+      email: this.email,
+      password: this.password,
+    };
+  }
+}

package/src/models/InvoiceRequest.ts

@@ -0,0 +1,93 @@
+import { PaymentMethod } from '../enums/PaymentMethod';
+
+/// Line item in BNPL invoice. Mirrors native InvoiceLineItem class.
+export class InvoiceLineItem {
+  constructor(
+    public readonly sku: string,
+    public readonly description: string,
+    public readonly unitCost: number,
+    public readonly quantity: number,
+    public readonly netTotal: number,
+    public readonly discountAmount: number = 0,
+    public readonly taxTotal: number = 0,
+    public readonly total: number,
+  ) {}
+
+  toJSON(): Record<string, any> {
+    return {
+      sku: this.sku,
+      description: this.description,
+      unitCost: this.unitCost,
+      quantity: this.quantity,
+      netTotal: this.netTotal,
+      discountAmount: this.discountAmount,
+      taxTotal: this.taxTotal,
+      total: this.total,
+    };
+  }
+}
+
+/// Invoice details for BNPL checkout. Mirrors native Invoice class.
+export class Invoice {
+  constructor(
+    public readonly total: number,
+    public readonly lineItems: InvoiceLineItem[],
+    public readonly shippingCharges: number = 0,
+    public readonly extraDiscount: number = 0,
+  ) {}
+
+  toJSON(): Record<string, any> {
+    return {
+      shippingCharges: this.shippingCharges,
+      extraDiscount: this.extraDiscount,
+      total: this.total,
+      lineItems: this.lineItems.map((item) => item.toJSON()),
+    };
+  }
+}
+
+/// Additional data for BNPL checkout. Mirrors native AdditionalData class.
+export class AdditionalData {
+  constructor(public readonly storeId: string) {}
+
+  toJSON(): Record<string, any> {
+    return {
+      storeId: this.storeId,
+    };
+  }
+}
+
+/// BNPL/Invoice checkout request. Mirrors native InvoiceRequest class.
+export class InvoiceRequest {
+  constructor(
+    public readonly paymentMethod: PaymentMethod,
+    public readonly merchantId: string,
+    public readonly amount: number,
+    public readonly currency: string,
+    public readonly phoneNumber: string,
+    public readonly email: string,
+    public readonly orderReferenceId: string,
+    public readonly orderNumber: string,
+    public readonly invoice: Invoice,
+    public readonly additionalData: AdditionalData,
+    public readonly locale: string = 'en_US',
+    public readonly paymentType: string = 'PAY_BY_INSTALMENTS',
+  ) {}
+
+  toJSON(): Record<string, any> {
+    return {
+      paymentMethod: this.paymentMethod,
+      merchantId: this.merchantId,
+      amount: this.amount,
+      currency: this.currency,
+      phoneNumber: this.phoneNumber,
+      email: this.email,
+      orderReferenceId: this.orderReferenceId,
+      orderNumber: this.orderNumber,
+      locale: this.locale,
+      paymentType: this.paymentType,
+      invoice: this.invoice.toJSON(),
+      additionalData: this.additionalData.toJSON(),
+    };
+  }
+}

package/src/models/Location.ts

@@ -0,0 +1,14 @@
+/// Device location. Matches: Location in native SDK.
+export class Location {
+  constructor(
+    public readonly latitude: number,
+    public readonly longitude: number,
+  ) {}
+
+  toJSON(): Record<string, any> {
+    return {
+      latitude: this.latitude,
+      longitude: this.longitude,
+    };
+  }
+}

package/src/models/Pagination.ts

@@ -0,0 +1,29 @@
+/// Sort order for pagination. Matches: SortOrder in native SDK.
+export enum SortOrder {
+  ASCENDING = 'ASCENDING',
+  DESCENDING = 'DESCENDING',
+}
+
+/// Sort field for pagination. Matches: SortField in native SDK.
+export enum SortField {
+  CREATED = 'CREATED',
+}
+
+/// Pagination parameters. Matches: Pagination in native SDK.
+export class Pagination {
+  constructor(
+    public readonly pageNumber: number = 0,
+    public readonly pageSize: number = 50,
+    public readonly sortOrder: SortOrder = SortOrder.DESCENDING,
+    public readonly sortBy: SortField = SortField.CREATED,
+  ) {}
+
+  toJSON(): Record<string, any> {
+    return {
+      pageNumber: this.pageNumber,
+      pageSize: this.pageSize,
+      sortOrder: this.sortOrder,
+      sortBy: this.sortBy,
+    };
+  }
+}

package/src/models/PresentationConfig.ts

@@ -0,0 +1,105 @@
+import { Presentation } from '../enums/Presentation';
+import { PurchaseSecondaryAction } from '../enums/PurchaseSecondaryAction';
+
+/// Chainable presentation configuration.
+/// Matches: Presentation.DIALOG_BOTTOM_FILL.cornerRadius(16)... in native SDK.
+export class PresentationConfig {
+  private _dismissOnTouchOutside: boolean = true;
+  private _dismissOnBackPress: boolean = true;
+  private _animateEntry: boolean = true;
+  private _animateExit: boolean = true;
+  private _dimBackground: boolean = true;
+  private _dimAmount: number = 0.5;
+  private _cornerRadius: number = 16;
+  private _marginHorizontal: number = 0;
+  private _marginVertical: number = 0;
+  private _sizePercent?: number;
+  private _purchaseSecondaryAction: PurchaseSecondaryAction = PurchaseSecondaryAction.NONE;
+  private _shufflePinPad: boolean = false;
+
+  constructor(public readonly presentation: Presentation) {}
+
+  dismissOnTouchOutside(value: boolean): PresentationConfig {
+    this._dismissOnTouchOutside = value;
+    return this;
+  }
+
+  dismissOnBackPress(value: boolean): PresentationConfig {
+    this._dismissOnBackPress = value;
+    return this;
+  }
+
+  animateEntry(value: boolean): PresentationConfig {
+    this._animateEntry = value;
+    return this;
+  }
+
+  animateExit(value: boolean): PresentationConfig {
+    this._animateExit = value;
+    return this;
+  }
+
+  dimBackground(value: boolean): PresentationConfig {
+    this._dimBackground = value;
+    return this;
+  }
+
+  dimAmount(amount: number): PresentationConfig {
+    this._dimAmount = amount;
+    return this;
+  }
+
+  cornerRadius(radius: number): PresentationConfig {
+    this._cornerRadius = radius;
+    return this;
+  }
+
+  marginHorizontal(margin: number): PresentationConfig {
+    this._marginHorizontal = margin;
+    return this;
+  }
+
+  marginVertical(margin: number): PresentationConfig {
+    this._marginVertical = margin;
+    return this;
+  }
+
+  marginAll(margin: number): PresentationConfig {
+    this._marginHorizontal = margin;
+    this._marginVertical = margin;
+    return this;
+  }
+
+  sizePercent(percent: number): PresentationConfig {
+    this._sizePercent = percent;
+    return this;
+  }
+
+  setPurchaseSecondaryAction(action: PurchaseSecondaryAction): PresentationConfig {
+    this._purchaseSecondaryAction = action;
+    return this;
+  }
+
+  setShufflePinPad(shuffle: boolean = true): PresentationConfig {
+    this._shufflePinPad = shuffle;
+    return this;
+  }
+
+  toJSON(): Record<string, any> {
+    return {
+      presentation: this.presentation,
+      dismissOnTouchOutside: this._dismissOnTouchOutside,
+      dismissOnBackPress: this._dismissOnBackPress,
+      animateEntry: this._animateEntry,
+      animateExit: this._animateExit,
+      dimBackground: this._dimBackground,
+      dimAmount: this._dimAmount,
+      cornerRadius: this._cornerRadius,
+      marginHorizontal: this._marginHorizontal,
+      marginVertical: this._marginVertical,
+      sizePercent: this._sizePercent,
+      purchaseSecondaryAction: this._purchaseSecondaryAction,
+      shufflePinPad: this._shufflePinPad,
+    };
+  }
+}

package/src/models/SdkTheme.ts

@@ -0,0 +1,64 @@
+import { EdfaPayBridge } from '../bridge';
+import { Presentation } from '../enums/Presentation';
+import { PresentationConfig } from './PresentationConfig';
+
+/// Chainable theme builder. Access via EdfaPayPlugin.theme().
+/// Matches: SdkTheme in native SDK.
+export class SdkTheme {
+  private constructor() {}
+
+  static create(): SdkTheme {
+    return new SdkTheme();
+  }
+
+  setPrimaryColor(color: string): SdkTheme {
+    EdfaPayBridge.invoke('setPrimaryColor', { color });
+    return this;
+  }
+
+  setSecondaryColor(color: string): SdkTheme {
+    EdfaPayBridge.invoke('setSecondaryColor', { color });
+    return this;
+  }
+
+  setFontScale(scale: number): SdkTheme {
+    EdfaPayBridge.invoke('setFontScale', { scale });
+    return this;
+  }
+
+  setHeaderImage(base64: string): SdkTheme {
+    EdfaPayBridge.invoke('setHeaderImage', { base64 });
+    return this;
+  }
+
+  setPoweredByImage(base64: string): SdkTheme {
+    EdfaPayBridge.invoke('setPoweredByImage', { base64 });
+    return this;
+  }
+
+  setRegisterCelebrationAnimation(lottieJsonBase64: string | null, speed: number = 1.0): SdkTheme {
+    EdfaPayBridge.invoke('setRegisterCelebrationAnimation', { lottieJsonBase64, speed });
+    return this;
+  }
+
+  setPurchaseCelebrationAnimation(lottieJsonBase64: string | null, speed: number = 1.0): SdkTheme {
+    EdfaPayBridge.invoke('setPurchaseCelebrationAnimation', { lottieJsonBase64, speed });
+    return this;
+  }
+
+  /**
+   * Accepts a Presentation enum value or a PresentationConfig instance.
+   * Usage: .setPresentation(Presentation.DIALOG_CENTER)
+   *        .setPresentation(new PresentationConfig(Presentation.DIALOG_BOTTOM_FILL).cornerRadius(20))
+   */
+  setPresentation(presentation: Presentation | PresentationConfig): SdkTheme {
+    let config: Record<string, any>;
+    if (presentation instanceof PresentationConfig) {
+      config = presentation.toJSON();
+    } else {
+      config = new PresentationConfig(presentation).toJSON();
+    }
+    EdfaPayBridge.invoke('setPresentation', { presentation: config });
+    return this;
+  }
+}

package/src/models/Terminal.ts

@@ -0,0 +1,41 @@
+import { EdfaPayBridge } from "../bridge";
+
+/// Terminal available for binding. Mirrors native Terminal class.
+export class Terminal {
+  constructor(
+    public readonly terminalId: string,
+    public readonly trsm: string,
+    public readonly providerTid: string
+  ) {}
+
+  static fromJSON(json: Record<string, any>): Terminal {
+    console.log('>>> Terminal.fromJSON called with', json);
+    return new Terminal(
+      (json.terminalId as string) ?? '',
+      (json.trsm as string) ?? '',
+      (json.providerTid as string) ?? ''
+    );
+  }
+
+  toJSON(): Record<string, any> {
+    return {
+      terminalId: this.terminalId,
+      trsm: this.trsm,
+      providerTid: this.providerTid,
+    };
+  }
+
+  toString(): string {
+    return `Terminal(terminalId: ${this.terminalId}, trsm: ${this.trsm}, providerTid: ${this.providerTid})`;
+  }
+
+  /**
+   * Show native terminal selection UI (no arg), or bind a specific terminal.
+   * On completion, initiate()'s onSuccess or onError will be called.
+   */
+  bind(): void {
+    console.log('>>> Terminal Binding Task received, showing binding UI');
+    console.log(this.toJSON());
+    EdfaPayBridge.invoke('bindTerminal', { trsm: this.trsm });
+  }
+}

package/src/models/TerminalBindingTask.ts

@@ -0,0 +1,32 @@
+import { EdfaPayBridge } from '../bridge';
+import type { OnTerminalRefresh } from '../types';
+import { Terminal } from './Terminal';
+
+/// Task for binding a terminal. Mirrors native TerminalBindingTask.
+///
+/// When binding completes (success or error), the original callbacks
+/// from initiate() are triggered automatically.
+///
+/// The _invoke function is injected by the bridge at construction time
+/// to avoid a circular import between bridge.ts and TerminalBindingTask.ts.
+export class TerminalBindingTask {
+  constructor(public readonly terminals: Terminal[]) {}
+
+  /**
+   * Show native terminal selection UI (no arg), or bind a specific terminal.
+   * On completion, initiate()'s onSuccess or onError will be called.
+   */
+  bind(): void {
+    console.log('>>> Terminal Binding Task received, showing binding UI');
+    EdfaPayBridge.invoke('showBindingUI');
+  }
+
+  refresh(onRefresh: OnTerminalRefresh): void {
+    console.log('>>> Terminal Binding Task received, refreshing terminal list');
+    EdfaPayBridge.invoke(
+      'refreshTerminal',
+      {},
+      { OnTerminalRefresh: onRefresh }
+    );
+  }
+}

package/src/models/Transaction.ts

@@ -0,0 +1,39 @@
+import { TransactionType } from '../enums/TransactionType';
+
+/// Lightweight transaction reference used for reverse/void/capture/refund.
+/// Matches: Transaction.withRRN(...) / Transaction.withTxnNumber(...) in native SDK.
+export class Transaction {
+  private constructor(
+    public readonly rrn?: string,
+    public readonly txnNumber?: string,
+    public readonly txnDate?: string, // ISO date string formatted as YYYY-MM-DD
+    public readonly type?: TransactionType
+  ) {}
+
+  /// Create a transaction reference using RRN (for refund, capture, reversal).
+  static withRRN(
+    rrn: string,
+    txnDate?: string,
+    type?: TransactionType
+  ): Transaction {
+    return new Transaction(rrn, undefined, txnDate, type);
+  }
+
+  /// Create a transaction reference using transaction number.
+  static withTxnNumber(
+    txnNumber: string,
+    txnDate?: string,
+    type?: TransactionType
+  ): Transaction {
+    return new Transaction(undefined, txnNumber, txnDate, type);
+  }
+
+  toJSON(): Record<string, any> {
+    return {
+      rrn: this.rrn,
+      txnNumber: this.txnNumber,
+      txnDate: this.txnDate,
+      type: this.type,
+    };
+  }
+}

package/src/models/TxnParams.ts

@@ -0,0 +1,26 @@
+import { Transaction } from './Transaction';
+
+/// Transaction parameters. Matches: TxnParams in native SDK.
+export class TxnParams {
+  public originalTransaction?: Transaction;
+
+  constructor(
+    public readonly amount: string,
+    public readonly orderId?: string,
+    originalTransaction?: Transaction,
+  ) {
+    this.originalTransaction = originalTransaction;
+  }
+
+  setOriginalTransaction(txn: Transaction): void {
+    this.originalTransaction = txn;
+  }
+
+  toJSON(): Record<string, any> {
+    return {
+      amount: this.amount,
+      orderId: this.orderId,
+      originalTransaction: this.originalTransaction?.toJSON(),
+    };
+  }
+}

package/src/models/UserInfo.ts

@@ -0,0 +1,50 @@
+/// User information returned by Extension.getUserInfo().
+/// Mirrors native UserInfo class.
+export class UserInfo {
+  constructor(
+    public readonly id: number,
+    public readonly userId: string,
+    public readonly username: string,
+    public readonly businessUnitId: string,
+    public readonly keyHash: string,
+    public readonly status: boolean,
+    public readonly deleted: boolean,
+    public readonly role: string,
+    public readonly createdAt: number,
+    public readonly updatedAt?: number,
+  ) {}
+
+  static fromJSON(json: Record<string, any>): UserInfo {
+    return new UserInfo(
+      (json['id'] as number) ?? 0,
+      (json['userID'] as string) ?? '',
+      (json['username'] as string) ?? '',
+      (json['businessUnitID'] as string) ?? '',
+      (json['keyHash'] as string) ?? '',
+      (json['status'] as boolean) ?? false,
+      (json['deleted'] as boolean) ?? false,
+      (json['role'] as string) ?? '',
+      (json['createdAt'] as number) ?? 0,
+      json['updatedAt'] as number | undefined,
+    );
+  }
+
+  toJSON(): Record<string, any> {
+    return {
+      id: this.id,
+      userID: this.userId,
+      username: this.username,
+      businessUnitID: this.businessUnitId,
+      keyHash: this.keyHash,
+      status: this.status,
+      deleted: this.deleted,
+      role: this.role,
+      createdAt: this.createdAt,
+      updatedAt: this.updatedAt,
+    };
+  }
+
+  toString(): string {
+    return `UserInfo(id: ${this.id}, username: ${this.username}, role: ${this.role})`;
+  }
+}

package/src/multiply.native.tsx

@@ -0,0 +1,5 @@
+import EdfapaySoftposSdkRn from './NativeEdfapaySoftposSdkRn';
+
+export function multiply(a: number, b: number): number {
+  return EdfapaySoftposSdkRn.multiply(a, b);
+}

package/src/multiply.tsx

@@ -0,0 +1,5 @@
+export function multiply(_a: number, _b: number): number {
+  throw new Error(
+    "'edfapay-softpos-sdk-rn' is only supported on native platforms."
+  );
+}