@bloonio/lokotro-pay 1.0.1 → 1.1.0

package/index.d.ts

@@ -1,11 +1,9 @@
 import * as i0 from '@angular/core';
-import { OnInit, OnDestroy, EventEmitter, ModuleWithProviders, InjectionToken } from '@angular/core';
-import * as i1 from '@angular/common';
-import * as i2 from '@angular/common/http';
-import { HttpClient } from '@angular/common/http';
-import * as i3 from '@angular/forms';
+import { OnInit, OnDestroy, EventEmitter, InjectionToken, ModuleWithProviders } from '@angular/core';
+import * as i1 from '@angular/forms';
 import { FormGroup, FormBuilder } from '@angular/forms';
 import { Observable } from 'rxjs';
+import { HttpClient } from '@angular/common/http';
 
 /**
  * Lokotro Pay - Enums
@@ -119,12 +117,8 @@ declare const LokotroPayApiResponseCodeInfo: {
 declare enum LokotroPayLanguage {
     English = "en",
     French = "fr",
-    German = "de",
     Spanish = "es",
-    Italian = "it",
     Russian = "ru",
-    Hindi = "hi",
-    Japanese = "ja",
     Chinese = "zh",
     Lingala = "ln"
 }
@@ -285,6 +279,7 @@ interface LokotroPaymentInfo {
     showUserInfoForm: boolean;
     showPaymentMethodForm: boolean;
     fillingInfo?: string;
+    channelInfo?: string;
 }
 /**
  * Payment method model
@@ -386,8 +381,14 @@ interface LokotroTransactionDetails {
  * Payment submit request
  */
 interface LokotroPaymentSubmitRequest {
-    transactionId: string;
-    paymentMethod: string;
+    transactionId?: string;
+    paymentId?: string;
+    paymentMethod?: string;
+    paymentMethodId?: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phoneNumber?: string;
     walletNumber?: string;
     walletPin?: string;
     mobileMoneyPhoneNumber?: string;
@@ -398,6 +399,15 @@ interface LokotroPaymentSubmitRequest {
     cardCvv?: string;
     cardHolderName?: string;
     bankTransferAccountId?: string;
+    bankAccountId?: string;
+    bankAccountNumber?: string;
+    bankAccountLabel?: string;
+    bankId?: string;
+    bankEntityId?: string;
+    mastercardPaymentMethod?: 'HOSTED_SESSION' | 'DIRECT_CAPTURE';
+    sessionId?: string;
+    cardData?: Record<string, unknown>;
+    savePaymentMethod?: boolean;
 }
 /**
  * Payment submit response
@@ -415,8 +425,10 @@ interface LokotroPaymentSubmitResponse {
  * OTP verification request
  */
 interface LokotroOtpVerifyRequest {
-    transactionId: string;
-    otp: string;
+    transactionId?: string;
+    paymentId?: string;
+    otp?: string;
+    otpCode?: string;
 }
 /**
  * OTP verification response
@@ -431,7 +443,8 @@ interface LokotroOtpVerifyResponse {
  * OTP resend request
  */
 interface LokotroOtpResendRequest {
-    transactionId: string;
+    transactionId?: string;
+    paymentId?: string;
 }
 /**
  * Theme configuration
@@ -477,6 +490,8 @@ interface LokotroHttpClientConfig {
  */
 declare class LokotroHttpClientService {
     private http;
+    private static instanceCounter;
+    private instanceId;
     private appKey?;
     private acceptLanguage;
     private customHeaders;
@@ -541,6 +556,7 @@ declare class LokotroHttpClientService {
     static ɵprov: i0.ɵɵInjectableDeclaration<LokotroHttpClientService>;
 }
 
+type JsonRecord = Record<string, unknown>;
 /**
  * Payment state for reactive updates
  */
@@ -557,6 +573,11 @@ declare class LokotroPaymentService {
     private httpClient;
     private stateSubject;
     state$: Observable<LokotroPaymentState>;
+    private currentPaymentBody?;
+    private mobileMoneyPollingTimer?;
+    private mobileMoneyPollingAttempts;
+    private static readonly MOBILE_MONEY_POLL_INTERVAL;
+    private static readonly MOBILE_MONEY_MAX_ATTEMPTS;
     constructor(httpClient: LokotroHttpClientService);
     /**
      * Get current state
@@ -611,6 +632,14 @@ declare class LokotroPaymentService {
      * Navigate to screen
      */
     navigateToScreen(screen: LokotroPayScreenNavigation): void;
+    /**
+     * Start polling for mobile money payment status
+     */
+    private startMobileMoneyPolling;
+    /**
+     * Stop mobile money status polling
+     */
+    private stopMobileMoneyPolling;
     /**
      * Handle payment success
      */
@@ -619,6 +648,14 @@ declare class LokotroPaymentService {
      * Handle payment failure
      */
     private handlePaymentFailure;
+    /**
+     * Resolve the collect response into the same flow the Flutter SDK uses.
+     */
+    private resolveCollectResponse;
+    /**
+     * Resolve transaction details into the correct screen or auto-submit flow.
+     */
+    private resolveTransactionResponse;
     /**
      * Get form screen for payment channel
      */
@@ -632,60 +669,100 @@ declare class LokotroPaymentService {
      */
     private convertSubmitRequestToData;
     /**
-     * Parse payment info from API response
+     * Parse payment info from collect response.
      */
     private parsePaymentInfo;
     /**
-     * Parse payment method from API response
+     * Parse payment info from transaction details response.
+     */
+    private parseTransactionPaymentInfo;
+    /**
+     * Parse payment method from API response.
      */
     private parsePaymentMethod;
     /**
-     * Parse submit response from API
+     * Parse submit response from API.
      */
     private parseSubmitResponse;
+    /**
+     * Build an auto-submit request using the original payment body.
+     */
+    private buildAutoSubmitRequest;
+    /**
+     * Resolve the selected payment method from transaction details.
+     */
+    private resolveSelectedPaymentMethod;
+    /**
+     * Normalize payloads that sometimes return data nested inside data.
+     */
+    private unwrapPayload;
+    private resolvePaymentId;
+    private parseChannel;
+    private normalizeMethodKey;
+    private getNumber;
+    private getString;
+    private getBoolean;
+    private asRecord;
+    private getRecordArray;
     static ɵfac: i0.ɵɵFactoryDeclaration<LokotroPaymentService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<LokotroPaymentService>;
 }
 interface CreatePaymentResponse {
     transaction_id?: string;
-    amount?: string;
+    payment_id?: string;
+    amount?: number | string;
     currency?: string;
     description?: string;
     merchant_name?: string;
     merchant_id?: string;
-    available_payment_methods?: Record<string, unknown>[];
+    available_payment_methods?: JsonRecord[];
     created_at?: string;
     expires_at?: string;
-    metadata?: Record<string, unknown>;
+    metadata?: JsonRecord;
     payment_url?: string;
-    show_user_info_form?: boolean;
-    show_payment_method_form?: boolean;
+    status?: string;
+    additional_data?: JsonRecord;
 }
 interface TransactionDetailsResponse {
+    payment_id?: string;
     transaction_id?: string;
-    amount?: string;
-    currency?: string;
+    transactional_amount?: number | string;
+    amount?: number | string;
+    transactional_currency?: string;
+    currency_str?: string;
     status?: string;
-    payment_method?: string;
+    channel?: string;
+    payment_method_id?: string;
+    payment_method_str?: string;
+    filling_info?: string;
+    channel_info?: string;
+    payment_methods?: JsonRecord[];
     customer_reference?: string;
-    system_reference?: string;
     created_at?: string;
     updated_at?: string;
-    metadata?: Record<string, unknown>;
+    metadata?: JsonRecord;
+    success_redirect_url?: string;
+    fail_redirect_url?: string;
+    mastercardUrl?: string;
+    redirect_url?: string;
 }
 interface PaymentSubmitResponse {
     success?: boolean;
     message?: string;
+    payment_id?: string;
     transaction_id?: string;
     status?: string;
     requires_otp?: boolean;
     otp_destination?: string;
+    otp_sent_to?: string;
     redirect_url?: string;
+    mastercardUrl?: string;
     [key: string]: unknown;
 }
 interface OtpVerifyResponse {
     success?: boolean;
     message?: string;
+    payment_id?: string;
     transaction_id?: string;
     status?: string;
     [key: string]: unknown;
@@ -693,7 +770,9 @@ interface OtpVerifyResponse {
 interface OtpResendResponse {
     success?: boolean;
     message?: string;
+    payment_id?: string;
     otp_destination?: string;
+    otp_sent_to?: string;
 }
 
 /**
@@ -787,6 +866,8 @@ interface LokotroTranslations {
     accountLabel: string;
     bankTransferProofInstructions: string;
     confirmBankTransfer: string;
+    redirectingIn: string;
+    tapToCancel: string;
 }
 declare class LokotroLocalizationService {
     private currentLanguageSubject;
@@ -816,9 +897,11 @@ declare class LokotroLocalizationService {
      */
     setLanguageByCode(code: string): void;
     /**
-     * Get translation by key
+     * Get translation by key with optional interpolation
+     * @param key - Translation key
+     * @param params - Optional parameters for interpolation (e.g., { seconds: 3 })
      */
-    translate(key: keyof LokotroTranslations): string;
+    translate(key: keyof LokotroTranslations, params?: Record<string, string | number>): string;
     /**
      * Get all supported languages
      */
@@ -862,8 +945,12 @@ declare class LokotroPayCheckoutComponent implements OnInit, OnDestroy {
     closed: EventEmitter<void>;
     state?: LokotroPaymentState;
     isDarkTheme: boolean;
+    private static readonly MAX_RETRY_ATTEMPTS;
+    private retryAttempts;
     private stateSubscription?;
     constructor(paymentService: LokotroPaymentService, localization: LokotroLocalizationService);
+    /** Check if user has retries left */
+    get hasRetriesLeft(): boolean;
     ngOnInit(): void;
     ngOnDestroy(): void;
     private initializeEnvironment;
@@ -887,6 +974,10 @@ declare class LokotroPayCheckoutComponent implements OnInit, OnDestroy {
     onRetry(): void;
     onDone(): void;
     onContinue(): void;
+    /** Handle auto-redirect from success screen */
+    onSuccessAutoRedirect(): void;
+    /** Handle auto-redirect from error screen (after retries exhausted) */
+    onErrorAutoRedirect(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LokotroPayCheckoutComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LokotroPayCheckoutComponent, "lokotro-pay-checkout", never, { "title": { "alias": "title"; "required": false; }; "titleStyle": { "alias": "titleStyle"; "required": false; }; "titleBackgroundColor": { "alias": "titleBackgroundColor"; "required": false; }; "configs": { "alias": "configs"; "required": false; }; "paymentBody": { "alias": "paymentBody"; "required": false; }; "enableHapticFeedback": { "alias": "enableHapticFeedback"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "themeConfig": { "alias": "themeConfig"; "required": false; }; "language": { "alias": "language"; "required": false; }; }, { "response": "response"; "error": "error"; "closed": "closed"; }, never, never, true, never>;
 }
@@ -1000,7 +1091,7 @@ declare class LokotroProcessingComponent {
  */
 
 type ResultType = 'success' | 'error' | 'warning' | 'info';
-declare class LokotroResultComponent {
+declare class LokotroResultComponent implements OnInit, OnDestroy {
     localization: LokotroLocalizationService;
     type: ResultType;
     title: string;
@@ -1010,14 +1101,28 @@ declare class LokotroResultComponent {
     transactionId?: string;
     primaryActionLabel?: string;
     secondaryActionLabel?: string;
+    /** Auto-redirect duration in seconds. If > 0, will auto-call onAutoRedirect after countdown. */
+    autoRedirectSeconds: number;
     primaryAction: EventEmitter<void>;
     secondaryAction: EventEmitter<void>;
+    /** Emitted when auto-redirect triggers after countdown completes. */
+    autoRedirect: EventEmitter<void>;
+    countdownSeconds: number;
+    isCountdownCancelled: boolean;
+    private countdownInterval?;
     constructor(localization: LokotroLocalizationService);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private startAutoRedirectCountdown;
+    cancelCountdown(): void;
+    private clearCountdown;
+    private triggerAutoRedirect;
+    getCountdownProgress(): number;
     formatAmount(amount: number, currency?: string): string;
     onPrimaryClick(): void;
     onSecondaryClick(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LokotroResultComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LokotroResultComponent, "lokotro-result", never, { "type": { "alias": "type"; "required": false; }; "title": { "alias": "title"; "required": false; }; "message": { "alias": "message"; "required": false; }; "amount": { "alias": "amount"; "required": false; }; "currency": { "alias": "currency"; "required": false; }; "transactionId": { "alias": "transactionId"; "required": false; }; "primaryActionLabel": { "alias": "primaryActionLabel"; "required": false; }; "secondaryActionLabel": { "alias": "secondaryActionLabel"; "required": false; }; }, { "primaryAction": "primaryAction"; "secondaryAction": "secondaryAction"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LokotroResultComponent, "lokotro-result", never, { "type": { "alias": "type"; "required": false; }; "title": { "alias": "title"; "required": false; }; "message": { "alias": "message"; "required": false; }; "amount": { "alias": "amount"; "required": false; }; "currency": { "alias": "currency"; "required": false; }; "transactionId": { "alias": "transactionId"; "required": false; }; "primaryActionLabel": { "alias": "primaryActionLabel"; "required": false; }; "secondaryActionLabel": { "alias": "secondaryActionLabel"; "required": false; }; "autoRedirectSeconds": { "alias": "autoRedirectSeconds"; "required": false; }; }, { "primaryAction": "primaryAction"; "secondaryAction": "secondaryAction"; "autoRedirect": "autoRedirect"; }, never, never, true, never>;
 }
 
 declare class LokotroLoadingComponent {
@@ -1080,7 +1185,7 @@ declare class LokotroPayModule {
         defaultConfig: Partial<LokotroPayConfig>;
     }>): ModuleWithProviders<LokotroPayModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<LokotroPayModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<LokotroPayModule, never, [typeof i1.CommonModule, typeof i2.HttpClientModule, typeof i3.ReactiveFormsModule, typeof i3.FormsModule, typeof LokotroPayCheckoutComponent, typeof LokotroPaymentMethodSelectionComponent, typeof LokotroPaymentFormComponent, typeof LokotroOtpVerificationComponent, typeof LokotroProcessingComponent, typeof LokotroResultComponent, typeof LokotroLoadingComponent], [typeof LokotroPayCheckoutComponent, typeof LokotroPaymentMethodSelectionComponent, typeof LokotroPaymentFormComponent, typeof LokotroOtpVerificationComponent, typeof LokotroProcessingComponent, typeof LokotroResultComponent, typeof LokotroLoadingComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<LokotroPayModule, never, [typeof i1.ReactiveFormsModule, typeof i1.FormsModule, typeof LokotroPayCheckoutComponent, typeof LokotroPaymentMethodSelectionComponent, typeof LokotroPaymentFormComponent, typeof LokotroOtpVerificationComponent, typeof LokotroProcessingComponent, typeof LokotroResultComponent, typeof LokotroLoadingComponent], [typeof LokotroPayCheckoutComponent, typeof LokotroPaymentMethodSelectionComponent, typeof LokotroPaymentFormComponent, typeof LokotroOtpVerificationComponent, typeof LokotroProcessingComponent, typeof LokotroResultComponent, typeof LokotroLoadingComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<LokotroPayModule>;
 }
 
@@ -1209,6 +1314,7 @@ declare class LokotroPayEnv {
     static get endpoints(): {
         collect: string;
         transaction: string;
+        mobileMoneyStatus: string;
         submit: string;
         verifyOtp: string;
         resendOtp: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloonio/lokotro-pay",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Angular SDK for Lokotro Pay - Payment processing library with multiple payment methods",
   "keywords": [
     "angular",
@@ -18,9 +18,9 @@
     "url": "https://github.com/bloonio/lokotro-pay-angular.git"
   },
   "peerDependencies": {
-    "@angular/common": "^17.0.0 || ^18.0.0 || ^19.0.0",
-    "@angular/core": "^17.0.0 || ^18.0.0 || ^19.0.0",
-    "@angular/forms": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@angular/common": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "@angular/core": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
+    "@angular/forms": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0",
     "rxjs": "^7.8.0"
   },
   "dependencies": {