@xsolla/payment-client-core 0.3.1 → 0.3.3

package/lib/core/capabilities/capabilities.service.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+export declare class CapabilitiesService {
+    private capabilities;
+    set(list?: string[]): void;
+    has(capability: string): boolean;
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CapabilitiesService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CapabilitiesService>;
+}

package/lib/core/capabilities/capability.const.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Known capability identifiers. Values mirror the SDK-side
+ * {@link Capability} enum but are kept as plain strings because
+ * payment-client-core must not depend on pay-station-sdk.
+ */
+export declare const SHOW_INIT_FORM_CAPABILITY = "show_init_form_action";

package/lib/core/payment/actions/next-action.interface.d.ts

@@ -1,5 +1,6 @@
 import { CheckStatusAction } from './check-status/check-status.action.type';
 import { ShowFieldsAction } from './show-fields/show-fields.action.type';
+import { ShowInitFormAction } from './show-init-form/show-init-form.action.type';
 import { StatusUpdatedAction } from './status-updated/status-updated.action.type';
 import { RedirectAction } from './redirect/redirect.action.type';
 import { ShowErrorsAction } from './show-errors/show-errors.action.type';
@@ -11,4 +12,4 @@ import { ShowXsollaNumberAction } from './show-xsolla-number/show-xsolla-number.
 import { ShowCashPaymentInstructionAction } from './show-cash-payment-instruction/show-cash-payment-instruction.action.type';
 import { ThreeDsRedirectAction } from './three-ds-redirect/three-ds-redirect.action.type';
 import { ServerErrorAction } from './server-error/server-error.action.type';
-export type NextAction = CheckStatusAction | ShowFieldsAction | StatusUpdatedAction | ShowErrorsAction | RedirectAction | ThreeDsAction | ThreeDsRedirectAction | SpecialButtonAction | ShowQrCodeAction | ShowMobilePaymentScreenAction | ShowXsollaNumberAction | ShowCashPaymentInstructionAction | ServerErrorAction;
+export type NextAction = CheckStatusAction | ShowFieldsAction | ShowInitFormAction | StatusUpdatedAction | ShowErrorsAction | RedirectAction | ThreeDsAction | ThreeDsRedirectAction | SpecialButtonAction | ShowQrCodeAction | ShowMobilePaymentScreenAction | ShowXsollaNumberAction | ShowCashPaymentInstructionAction | ServerErrorAction;

package/lib/core/payment/actions/show-init-form/show-init-form.action.class.d.ts

@@ -0,0 +1,17 @@
+import { ActionCreator } from '../action.interface';
+import { ShowInitFormAction, ShowInitFormActionType } from './show-init-form.action.type';
+import { SubmitResponse } from '../../requests/submit/response/submit-response.class';
+import { PaymentConfigService } from '../../config/config.service';
+import { CapabilitiesService } from '../../../capabilities/capabilities.service';
+import * as i0 from "@angular/core";
+export declare class ShowInitFormActionCreator implements ActionCreator {
+    private readonly paymentConfigService;
+    private readonly capabilitiesService;
+    type: ShowInitFormActionType;
+    constructor(paymentConfigService: PaymentConfigService, capabilitiesService: CapabilitiesService);
+    getActionData(submitResponse: SubmitResponse): ShowInitFormAction;
+    isSuitable(response: SubmitResponse): boolean;
+    private isExternalVaultActive;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ShowInitFormActionCreator, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ShowInitFormActionCreator>;
+}

package/lib/core/payment/actions/show-init-form/show-init-form.action.type.d.ts

@@ -0,0 +1,11 @@
+import { Action } from '../action.interface';
+import { Field } from '../../field.interface';
+import { XpsError } from '../../xps-error.interface';
+import { XpsMessage } from '../../xps-message.interface';
+export type ShowInitFormActionType = 'show_init_form';
+export interface ShowInitFormActionData {
+    fields: Field[];
+    errors: XpsError[] | null;
+    messages: XpsMessage[] | undefined;
+}
+export type ShowInitFormAction = Action<ShowInitFormActionType, ShowInitFormActionData>;

package/lib/core/payment/config/config.service.d.ts

@@ -5,7 +5,10 @@ import * as i0 from "@angular/core";
 export declare class PaymentConfigService {
     private readonly urlService;
     private readonly settingsService;
+    private _activeConfig;
     constructor(urlService: UrlService, settingsService: SettingsService);
+    get activeConfig(): PaymentConfiguration | null;
+    setActiveConfig(config: PaymentConfiguration | null): void;
     enrich(config: PaymentConfiguration): PaymentConfiguration;
     updateReferByPaymentConfiguration(config: PaymentConfiguration): void;
     private enrichReturnUrl;

package/lib/core/payment/field-names.enum.d.ts

@@ -61,6 +61,7 @@ export declare enum FieldNames {
     psAccountCountry = "psAccountCountry",
     allowSave = "allowSave",
     koreaLimitsInstruction = "korea_limits_instruction",
+    koreaCashReceiptInstruction = "korea_cash_receipt_instruction",
     tokenApplePay = "token_applepay",
     fixInvoice = "fix_invoice",
     fixPid = "fix_pid",

package/lib/core/payment/finance-details/cart-summary.interface.d.ts

@@ -7,4 +7,6 @@ export interface CartSummary {
     subtotalDetails?: CartLine[];
     total: CartLine;
     totalDetails?: CartLine[];
+    salesTax?: number | null;
+    currency?: string;
 }

package/lib/core/payment/payment-configuration.interface.d.ts

@@ -10,6 +10,7 @@ export interface BasePaymentConfiguration {
     paymentMethodId: number;
     returnUrl: string;
     accountId?: number;
+    country?: string;
     paymentWithSavedMethod?: boolean;
     savedMethodId?: number;
     savePaymentMethod?: boolean;

package/lib/core/payment/payment.service.d.ts

@@ -113,6 +113,9 @@ export declare class PaymentService {
     private setupSyncService;
     private listenFinanceDetails;
     private listenFormStatusChanges;
+    /**
+     * In case the form pid changes despite the one passed during initialization
+     */
     private updatePidConfig;
     private emitFormResponse;
     private getInitializeMessages;

package/lib/core/payment/status/status.service.d.ts

@@ -18,11 +18,9 @@ export declare class StatusService {
     private readonly nextActionService;
     private readonly savePaymentMethodStatusService;
     private readonly statusUpdatedActionCreator;
-    private listenStatusSubscription;
     constructor(urlService: UrlService, statusRequestService: StatusRequestService, financeDetailsService: FinanceDetailsService, listenStatusService: ListenStatusService, nextActionService: NextActionService, savePaymentMethodStatusService: SavePaymentMethodStatusService, statusUpdatedActionCreator: StatusUpdatedActionCreator);
     getStatus(params: StatusRequestParams): Promise<Status>;
     getStatusWithUrlSearchParams(url?: string): Promise<Status>;
-    stopListening(): void;
     listenFinalStatus(invoice: number): Observable<StatusSettings>;
     private getRequestParamsFromUrl;
     private startWaitingStatusUpdates;

package/lib/core/settings/configuration.interface.d.ts

@@ -15,4 +15,11 @@ export interface InitConfiguration {
      * Will be ignored in production.
      */
     apiUrl?: string;
+    /**
+     * Features the SDK declares it can handle. Used by the iframe to gate
+     * behaviour that would otherwise break partners on older SDK versions
+     * (e.g. new NextAction types). Internal handshake — not consumed by the
+     * server.
+     */
+    capabilities?: string[];
 }

package/lib/core-library.service.d.ts

@@ -54,6 +54,7 @@ import { CommonLogAttributes } from './core/exceptions-handling/common-log-attri
 import { LogHandler } from './core/exceptions-handling/logger/log-handler.interface';
 import { LoggerService } from './core/exceptions-handling/logger/logger.service';
 import { XpsError } from './core/payment/xps-error.interface';
+import { CapabilitiesService } from './core/capabilities/capabilities.service';
 import * as i0 from "@angular/core";
 export declare class CoreLibraryService {
     private readonly settingsService;
@@ -81,6 +82,7 @@ export declare class CoreLibraryService {
     private readonly scriptTrackerService;
     private readonly translateService;
     private readonly commonLogAttributesService;
+    private readonly capabilitiesService;
     paymentMethods: {
         getList: (isSaveMethodMode?: boolean) => Promise<PaymentMethod[]>;
         getQuickMethods: () => Promise<PaymentMethod[]>;
@@ -93,10 +95,9 @@ export declare class CoreLibraryService {
     finance: {
         getDetailsFromSummary: (summary: XpsSummary) => FinanceDetails;
     };
-    constructor(settingsService: SettingsService, loggerService: LoggerService, countryService: CountryService, paymentMethodsService: PaymentMethodsService, savedMethodsService: SavedMethodsService, userBalanceService: UserBalanceService, paymentConfigService: PaymentConfigService, paymentService: PaymentService, deviceFingerPrintService: DeviceFingerPrintService, financeDetailsService: FinanceDetailsService, legalService: LegalService, statusService: StatusService, nextActionService: NextActionService, creditCardService: CreditCardService, creditCardStateService: CreditCardStateService, formMessagesService: FormMessagesService, editSavedMethodsService: EditSavedMethodsService, userBehaviourAnalyticsService: UserBehaviourAnalyticsService, performanceService: PerformanceService, combinedPaymentMethodsService: CombinedPaymentMethodsService, countriesApiService: CountriesApiService, sendInstructionService: SendInstructionService, scriptTrackerService: ScriptTrackerService, translateService: TranslateService, commonLogAttributesService: CommonLogAttributesService);
+    constructor(settingsService: SettingsService, loggerService: LoggerService, countryService: CountryService, paymentMethodsService: PaymentMethodsService, savedMethodsService: SavedMethodsService, userBalanceService: UserBalanceService, paymentConfigService: PaymentConfigService, paymentService: PaymentService, deviceFingerPrintService: DeviceFingerPrintService, financeDetailsService: FinanceDetailsService, legalService: LegalService, statusService: StatusService, nextActionService: NextActionService, creditCardService: CreditCardService, creditCardStateService: CreditCardStateService, formMessagesService: FormMessagesService, editSavedMethodsService: EditSavedMethodsService, userBehaviourAnalyticsService: UserBehaviourAnalyticsService, performanceService: PerformanceService, combinedPaymentMethodsService: CombinedPaymentMethodsService, countriesApiService: CountriesApiService, sendInstructionService: SendInstructionService, scriptTrackerService: ScriptTrackerService, translateService: TranslateService, commonLogAttributesService: CommonLogAttributesService, capabilitiesService: CapabilitiesService);
     init(configuration: InitConfiguration): Promise<void>;
     getStatus(url?: string): Promise<Status>;
-    stopStatusListening(): void;
     calculateField(changedField: Field, fields: Field[]): Promise<SyncResponse>;
     submit(fields: Field[]): Promise<{
         response: SubmitResponse;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xsolla/payment-client-core",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "engines": {
     "node": ">=16.10.0",
     "npm": ">=8.11.0"