@xsolla/payment-client-core 0.4.0 → 0.5.0

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

@@ -16,6 +16,13 @@ export declare class CheckStatusService extends XpsApiPart<CheckStatusResponse>
     constructor(xpsApiService: XpsApiService, settingsService: SettingsService, xpsResponseErrorsMappingService: XpsResponseErrorsMappingService, requestFactory: CheckStatusRequestFactory, responseFactory: CheckStatusResponseFactory);
     setRequestParams(invoice: number): void;
     request(): void;
+    /**
+     * Performs a one-shot getstatus poll and returns the mapped response without
+     * emitting it to the shared `response$` stream. Used by StatusService to
+     * consult the authoritative terminal signal without interfering with the
+     * listen-status polling loop. See PAYMENTS-29021.
+     */
+    requestStatus(invoice: number): Promise<CheckStatusResponse>;
     static ɵfac: i0.ɵɵFactoryDeclaration<CheckStatusService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CheckStatusService>;
 }

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

@@ -18,6 +18,7 @@ export declare class ListenStatusService {
     private destroy$;
     private listenInvoice;
     private websocketInvoice;
+    private pendingTerminalStatus;
     get websocketOpened$(): Observable<StatusSettings>;
     get statusUpdated$(): Observable<StatusUpdated>;
     constructor(statusService: StatusRequestService, checkStatusService: CheckStatusService, websocketStatusService: WebsocketStatusService, userBehaviourAnalyticsService: UserBehaviourAnalyticsService);

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

@@ -8,6 +8,7 @@ import { StatusUpdatedActionCreator } from '../actions/status-updated/status-upd
 import { UrlService } from '../../url/url.service';
 import { FinanceDetailsService } from '../finance-details/finance-details.service';
 import { SavePaymentMethodStatusService } from './save-payment-method-status/save-payment-method-status.service';
+import { CheckStatusService } from './check-status/check-status.service';
 import { StatusSettings } from './status-settings.interface';
 import * as i0 from "@angular/core";
 export declare class StatusService {
@@ -17,13 +18,24 @@ export declare class StatusService {
     private readonly listenStatusService;
     private readonly nextActionService;
     private readonly savePaymentMethodStatusService;
+    private readonly checkStatusService;
     private readonly statusUpdatedActionCreator;
     private listenStatusSubscription;
-    constructor(urlService: UrlService, statusRequestService: StatusRequestService, financeDetailsService: FinanceDetailsService, listenStatusService: ListenStatusService, nextActionService: NextActionService, savePaymentMethodStatusService: SavePaymentMethodStatusService, statusUpdatedActionCreator: StatusUpdatedActionCreator);
+    constructor(urlService: UrlService, statusRequestService: StatusRequestService, financeDetailsService: FinanceDetailsService, listenStatusService: ListenStatusService, nextActionService: NextActionService, savePaymentMethodStatusService: SavePaymentMethodStatusService, checkStatusService: CheckStatusService, statusUpdatedActionCreator: StatusUpdatedActionCreator);
     getStatus(params: StatusRequestParams): Promise<Status>;
     getStatusWithUrlSearchParams(url?: string): Promise<Status>;
     listenFinalStatus(invoice: number): Observable<StatusSettings>;
     stopWaitingStatusUpdates(): void;
+    /**
+     * The full-status endpoint can report a non-terminal state (e.g.
+     * `processing` with group `delivering`) for a transaction that has actually
+     * been terminated — most notably a card payment declined by AFS and then
+     * auto-refunded. In that scenario the lightweight getstatus poll is the only
+     * authoritative terminal signal (`status: canceled`, `final: true`), so we
+     * consult it and surface the terminal verdict to the partner instead of
+     * leaving `statusState` stuck on `processing`.
+     */
+    private applyPollTerminalStatus;
     private getRequestParamsFromUrl;
     private startWaitingStatusUpdates;
     static ɵfac: i0.ɵɵFactoryDeclaration<StatusService, never>;

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const PAYMENT_CLIENT_CORE_VERSION = "0.4.0";
+export declare const PAYMENT_CLIENT_CORE_VERSION = "0.5.0";

package/package.json

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