digipay-utility-payment 0.0.2

package/index.d.ts

@@ -0,0 +1,257 @@
+import * as i0 from '@angular/core';
+import { OnInit, OnDestroy, OnChanges, SimpleChanges, InjectionToken } from '@angular/core';
+import * as i1 from '@angular/common';
+import * as _angular_forms from '@angular/forms';
+import * as rxjs from 'rxjs';
+import { Observable, BehaviorSubject } from 'rxjs';
+
+type WorkflowStep = 'CATEGORY' | 'PROVIDER' | 'REGION' | 'WORKFLOW' | 'BILLS' | 'PLANS' | 'PRODUCTS' | 'REVIEW' | 'SUMMARY';
+
+declare class SdkStateService {
+    private activeSubject;
+    private stepSubject;
+    isActive(): boolean;
+    setActive(active: boolean): void;
+    get step$(): rxjs.Observable<WorkflowStep>;
+    setStep(step: WorkflowStep): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdkStateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdkStateService>;
+}
+
+/**
+ * Runtime configuration passed from any host app into `<sdk-utility-payments [config]="...">`.
+ * The SDK does not depend on a specific host project — only this shape + optional auth provider.
+ */
+interface UtilityPaymentsConfigInput {
+    baseUrl: string;
+    defaultHeaders?: Record<string, string>;
+}
+
+/**
+ * Embeddable utilities / bill-pay flow. Host apps should:
+ * - Mount `<sdk-utility-payments [config]="...">` with `baseUrl` and `defaultHeaders` (auth, companyid, userid, etc.).
+ * - Mount only inside a route or lazy-loaded chunk so the SDK is not in the initial bundle unless needed.
+ * - Rely on internal step state when `SdkStateService` is active (default here) so host routes/layout stay unchanged.
+ *
+ * Optional dev form: set global `UTILITY_PAYMENTS_TEST_MODE` / env flags, or use demo app — not required in production hosts.
+ */
+declare class UtilityPaymentsContainerComponent implements OnInit, OnDestroy, OnChanges {
+    sdkState: SdkStateService;
+    private configService;
+    private dataService;
+    private formBuilder;
+    private destroy$;
+    private readonly runtimeConfigStorageKey;
+    config?: UtilityPaymentsConfigInput | any;
+    currentStep: string;
+    isConfigured: boolean;
+    isTestMode: boolean;
+    configForm: _angular_forms.FormGroup<{
+        baseUrl: _angular_forms.FormControl<string | null>;
+        companyId: _angular_forms.FormControl<string | null>;
+        userId: _angular_forms.FormControl<string | null>;
+        token: _angular_forms.FormControl<string | null>;
+    }>;
+    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    private applyConfig;
+    saveRuntimeConfig(): void;
+    isControlInvalid(controlName: 'baseUrl' | 'companyId'): boolean;
+    private resolveTestMode;
+    private buildRuntimeConfig;
+    private normalizeConfig;
+    private loadRuntimeConfigFromStorage;
+    private persistRuntimeConfigToStorage;
+    ngOnDestroy(): void;
+    private shortUrlForLog;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UtilityPaymentsContainerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UtilityPaymentsContainerComponent, "sdk-utility-payments", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class UtilityPaymentsModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<UtilityPaymentsModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<UtilityPaymentsModule, never, [typeof i1.CommonModule, typeof UtilityPaymentsContainerComponent], [typeof UtilityPaymentsContainerComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<UtilityPaymentsModule>;
+}
+
+interface UtilityPaymentsAuthProvider {
+    getToken(): string | null;
+    getCompanyId(): string | null;
+    getUserId(): string | null;
+}
+declare const UTILITY_PAYMENTS_AUTH_PROVIDER: InjectionToken<UtilityPaymentsAuthProvider>;
+
+declare class PaymentsApiService {
+    private http;
+    private config;
+    private authProvider;
+    private get baseUrl();
+    private get defaultHeaders();
+    private buildAuthHeaders;
+    getVendorDetailsById(id: string): Observable<any>;
+    getTopupAndBillpaymentCategories(params?: any): Observable<any>;
+    getTopupAndBillpaymentCategoryById(id: string): Observable<any>;
+    getTopupAndBillpaymentVendorPlans(params?: any): Observable<any>;
+    getTopupAndBillpaymentVendorProviders(params?: any): Observable<any>;
+    getTopupAndBillpaymentWorkFlowDetails(params?: any): Observable<any>;
+    getTopupBillDetails(payload: any): Observable<any>;
+    getVendorContractDetails(params?: any): Observable<any>;
+    getRevenueConfigDetails(params?: any): Observable<any>;
+    getVendorChargeConfig(params?: any): Observable<any>;
+    getCompanyDetailFromJava(params?: any): Observable<any>;
+    getAllCompanyConfigsListUsingJava(params?: any): Observable<any>;
+    getCurrencyDataFromJava(params?: any): Observable<any>;
+    /**
+     * Convenience aliases aligned with the initial SDK shape
+     */
+    getCategories(params?: any): Observable<any>;
+    getProviders(params?: any): Observable<any>;
+    getWorkflowDetails(params?: any): Observable<any>;
+    getBills(payload: any): Observable<any>;
+    executePayment(payload: any): Observable<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PaymentsApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PaymentsApiService>;
+}
+
+declare class WorkflowStateService {
+    private stepSubject;
+    step$: rxjs.Observable<string>;
+    setStep(step: string): void;
+    nextStep(step: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkflowStateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WorkflowStateService>;
+}
+
+declare class PaymentsConfigService {
+    config: any;
+    setConfig(config: any): void;
+    getConfig(): any;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PaymentsConfigService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PaymentsConfigService>;
+}
+
+declare class TopupAndBillpaymentService {
+    private api;
+    private vendorCategorySubject;
+    vendorCategory: Observable<any>;
+    private vendorProviderSubject;
+    vendorProvider: Observable<any>;
+    private vendorPlanSubject;
+    vendorPlan: Observable<any>;
+    private workFlowUserInputSubject;
+    workFlowUserInput: Observable<any>;
+    private billDataSubject;
+    billData: Observable<any>;
+    private txnDataSubject;
+    txnData: Observable<any>;
+    private workflowScreensSubject;
+    workflowScreens: Observable<any[] | null>;
+    private currentScreenIndexSubject;
+    currentScreenStep: Observable<number>;
+    private workflowDataSubject;
+    workflowData: Observable<any>;
+    constructor(api: PaymentsApiService);
+    saveVendorCategory(vendorCategory: any): void;
+    deleteVendorCategory(): void;
+    saveVendorProvider(vendorProvider: any): void;
+    deleteVendorProvider(): void;
+    saveVendorPlan(vendorPlan: any): void;
+    deleteVendorPlan(): void;
+    saveWorkflowUserInput(userInput: any): void;
+    deleteWorkflowUserInput(): void;
+    saveBillData(billData: any): void;
+    deleteBillData(): void;
+    saveTxnData(txnData: any): void;
+    deleteTxnData(): void;
+    saveWorkflowScreens(screens: any[]): void;
+    deleteWorkflowScreens(): void;
+    setCurrentScreenStep(index: number): void;
+    saveWorkflowData(data: any): void;
+    deleteWorkflowData(): void;
+    getVendorDetailsById(id: string): Observable<any>;
+    getTopupAndBillpaymentCategories(params?: any): Observable<any>;
+    getTopupAndBillpaymentCategoryById(id: string): Observable<any>;
+    getTopupAndBillpaymentVendorPlans(params?: any): Observable<any>;
+    getTopupAndBillpaymentVendorProviders(params?: any): Observable<any>;
+    getTopupAndBillpaymentWorkFlowDetails(params?: any): Observable<any>;
+    getTopupBillDetails(payload: any): Observable<any>;
+    getVendorContractDetails(params?: any): Observable<any>;
+    getRevenueConfigDetails(params?: any): Observable<any>;
+    getVendorChargeConfig(params?: any): Observable<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TopupAndBillpaymentService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TopupAndBillpaymentService>;
+}
+
+declare class TranslationService {
+    private static readonly LABELS;
+    translate(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TranslationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TranslationService>;
+}
+
+declare class DataService {
+    private paymentsApi;
+    private userService;
+    private walletService;
+    private configService;
+    currentCompanyCurrency: BehaviorSubject<any>;
+    currentWallet: BehaviorSubject<any>;
+    userWallet: BehaviorSubject<any>;
+    companyConfigData: BehaviorSubject<any[] | null>;
+    currentUserDetails: BehaviorSubject<any>;
+    adminUserDetails: BehaviorSubject<any>;
+    companyDetails: BehaviorSubject<any>;
+    private walletUserAccountId;
+    private contextLoading;
+    private contextLoaded;
+    getWalletUserAccountId(): string | null;
+    /** Clears loaded context so the next initializeFromApi() runs a full reload (e.g. after host config change). */
+    resetApiContext(): void;
+    saveUserWallet(wallet: any): void;
+    initializeFromApi(): void;
+    private loadContext;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DataService>;
+}
+
+declare class TransactionService {
+    private http;
+    private config;
+    private authProvider;
+    private get baseUrl();
+    private get defaultHeaders();
+    private buildAuthHeaders;
+    getTopupBillPaymentTransactions(params?: any): Observable<any>;
+    calculateVendorCharge(payload: any): Observable<any>;
+    createTransactionIntent(payload: any): Observable<any>;
+    createTransactionSession(payload: any): Observable<any>;
+    private withEncryptedMethodValues;
+    initiateTopupBillPaymentTransaction(payload: any): Observable<any>;
+    payTopupBill(payload: any): Observable<any>;
+    updateTransactionStatus(payload: any): Observable<any>;
+    getKafkaQueueOperationDetailsUsingJava(params?: any): Observable<any>;
+    cashTransferRequest(payload: any): Observable<any>;
+    getCashTransferRequestByID(id: string): Observable<any>;
+    getTransactionDetails(id: string): Observable<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TransactionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TransactionService>;
+}
+
+/**
+ * Bump this string whenever you publish a new package so the host app’s DevTools
+ * proves which build is loaded (filter console by "utility-payments-sdk").
+ */
+declare const UTILITY_PAYMENTS_SDK_BUILD_TAG = "utility-payments@0.0.2 build sync";
+declare function utilityPaymentsSdkIsVerboseDebug(): boolean;
+/**
+ * @param event - short label for filtering
+ * @param detail - optional JSON-safe fields
+ *
+ * Always logs: CONFIG_APPLIED, VENDOR_PROVIDERS_MOUNTED (so you can confirm the new bundle).
+ * Other events only when verbose: set localStorage UTILITY_PAYMENTS_SDK_DEBUG=1 or
+ * globalThis.__UTILITY_PAYMENTS_SDK_DEBUG__ = true before loading the page.
+ */
+declare function utilityPaymentsSdkDebug(event: string, detail?: Record<string, unknown>): void;
+
+export { DataService, PaymentsApiService, PaymentsConfigService, SdkStateService, TopupAndBillpaymentService, TransactionService, TranslationService, UTILITY_PAYMENTS_AUTH_PROVIDER, UTILITY_PAYMENTS_SDK_BUILD_TAG, UtilityPaymentsContainerComponent, UtilityPaymentsModule, WorkflowStateService, utilityPaymentsSdkDebug, utilityPaymentsSdkIsVerboseDebug };
+export type { UtilityPaymentsAuthProvider, UtilityPaymentsConfigInput };

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "digipay-utility-payment",
+  "version": "0.0.2",
+  "peerDependencies": {
+    "@angular/common": "^20.3.0",
+    "@angular/core": "^20.3.0"
+  },
+  "dependencies": {
+    "@popperjs/core": "^2.11.8",
+    "bootstrap": "^5.3.3",
+    "crypto-js": "^4.2.0",
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/digipay-utility-payment.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/digipay-utility-payment.mjs"
+    }
+  }
+}