@xsolla/payment-client-core 0.4.0 → 0.5.0

package/fesm2022/xsolla-payment-client-core.mjs

@@ -13,7 +13,7 @@ import { CommonModule } from '@angular/common';
 import { provideTranslateHttpLoader } from '@ngx-translate/http-loader';
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
-const PAYMENT_CLIENT_CORE_VERSION = '0.4.0';
+const PAYMENT_CLIENT_CORE_VERSION = '0.5.0';
 
 class TranslateHelper {
     static init(service) {
@@ -6215,22 +6215,28 @@ class CheckStatusService extends XpsApiPart {
         this.invoice = invoice;
     }
     request() {
-        const requestParams = this.requestFactory(this.settingsService.token, this.invoice);
-        this.xpsApiService
-            .directPaymentRequest(requestParams)
-            .then((xpsResponse) => {
-            const response = this.xpsResponseErrorsMappingService.mapErrors(xpsResponse);
-            const checkStatusResponse = this.responseFactory({
-                status: response.status,
-                final: response.final,
-                isPaymentAccountAttached: response.is_payment_account_attached,
-            });
-            this.emitResponse(checkStatusResponse);
-        })
+        this.requestStatus(this.invoice)
+            .then((checkStatusResponse) => this.emitResponse(checkStatusResponse))
             .catch((error) => {
             throw new ResponseError(error.message);
         });
     }
+    /**
+     * 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.
+     */
+    async requestStatus(invoice) {
+        const requestParams = this.requestFactory(this.settingsService.token, invoice);
+        const xpsResponse = await this.xpsApiService.directPaymentRequest(requestParams);
+        const response = this.xpsResponseErrorsMappingService.mapErrors(xpsResponse);
+        return this.responseFactory({
+            status: response.status,
+            final: response.final,
+            isPaymentAccountAttached: response.is_payment_account_attached,
+        });
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: CheckStatusService, deps: [{ token: XpsApiService }, { token: SettingsService }, { token: XpsResponseErrorsMappingService }, { token: checkStatusRequestFactoryToken }, { token: checkStatusResponseFactoryToken }], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: CheckStatusService, providedIn: 'root' }); }
 }
@@ -6703,8 +6709,12 @@ class WebsocketStatusService {
             this.clearReinsuranceCheckTimeout();
         }
         if (message === WebSocketStatus.troubledStatus) {
+            // A troubled status can be the terminal AFS-declined/refunded outcome.
+            // Trigger a getstatus poll so listen-status can read the authoritative
+            // verdict and finalize, instead of silently closing and leaving the UI
+            // stuck on "Processing"
             this.clearReinsuranceCheckTimeout();
-            this.closeWebSocket();
+            this.needCheckStatusSubject.next();
         }
     }
     removeSubscription() {
@@ -6740,6 +6750,7 @@ class ListenStatusService {
         this.destroy$ = new Subject();
         this.listenInvoice = null;
         this.websocketInvoice = null;
+        this.pendingTerminalStatus = null;
     }
     listen(invoice) {
         if (this.isListening) {
@@ -6758,6 +6769,7 @@ class ListenStatusService {
         this.isListening = false;
         this.listenInvoice = null;
         this.websocketInvoice = null;
+        this.pendingTerminalStatus = null;
         this.websocketStatusService.closeWebSocket();
         this.destroy$.next();
         this.destroy$.complete();
@@ -6774,6 +6786,13 @@ class ListenStatusService {
             if (!statusResponse?.status) {
                 return;
             }
+            const terminalStatus = this.pendingTerminalStatus;
+            if (terminalStatus) {
+                statusResponse.status.statusState = terminalStatus;
+                if (terminalStatus === StatusEnum.canceled) {
+                    statusResponse.status.isCanceled = true;
+                }
+            }
             const statusSettings = {
                 statusState: statusResponse.status.statusState,
                 isCancelUser: statusResponse.status.isCancelUser,
@@ -6800,6 +6819,14 @@ class ListenStatusService {
                     instanceId: statusResponse.status.pid,
                 });
             }
+            // A terminal verdict from the getstatus poll (e.g. AFS-declined and
+            // refunded) is authoritative: finalize even when the full status still
+            // reports needToCheck.
+            if (terminalStatus) {
+                this.stopListening();
+                this.statusDoneSubject.next(statusSettings);
+                return;
+            }
             if (statusSettings.needWebSocket) {
                 if (!this.websocketStatusService.isOpened ||
                     this.websocketInvoice !== invoice) {
@@ -6826,6 +6853,19 @@ class ListenStatusService {
                 this.websocketStatusService.closeWebSocket();
                 return;
             }
+            // AFS-declined / refunded transactions report a terminal failure here
+            // (canceled/error + final) while the full status may still say
+            // processing. Re-fetch the rich status, then flag it so the update
+            // handler overrides the state to the terminal verdict and finalizes.
+            const isTerminalFailure = checkStatusResponse.final === true &&
+                (checkStatusResponse.status === StatusEnum.canceled ||
+                    checkStatusResponse.status === StatusEnum.error);
+            if (isTerminalFailure) {
+                this.pendingTerminalStatus = checkStatusResponse.status;
+                this.statusService.request();
+                this.websocketStatusService.closeWebSocket();
+                return;
+            }
             if (checkStatusResponse.final === false) {
                 this.websocketStatusService.startReinsuranceCheckTimeout();
                 return;
@@ -7019,13 +7059,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImpo
         }], ctorParameters: () => [{ type: StatusRequestService }, { type: ListenStatusService }, { type: SavedPaymentAccountChangesService }, { type: NextActionService }, { type: CheckStatusService }, { type: StatusUpdatedActionCreator }] });
 
 class StatusService {
-    constructor(urlService, statusRequestService, financeDetailsService, listenStatusService, nextActionService, savePaymentMethodStatusService, statusUpdatedActionCreator) {
+    constructor(urlService, statusRequestService, financeDetailsService, listenStatusService, nextActionService, savePaymentMethodStatusService, checkStatusService, statusUpdatedActionCreator) {
         this.urlService = urlService;
         this.statusRequestService = statusRequestService;
         this.financeDetailsService = financeDetailsService;
         this.listenStatusService = listenStatusService;
         this.nextActionService = nextActionService;
         this.savePaymentMethodStatusService = savePaymentMethodStatusService;
+        this.checkStatusService = checkStatusService;
         this.statusUpdatedActionCreator = statusUpdatedActionCreator;
         this.listenStatusSubscription = null;
     }
@@ -7038,6 +7079,7 @@ class StatusService {
         this.startWaitingStatusUpdates(params.invoice);
         this.statusRequestService.request();
         const statusResponse = await firstValueFrom(this.statusRequestService.response$);
+        await this.applyPollTerminalStatus(statusResponse.status, params.invoice);
         this.financeDetailsService.emitWithStatus(statusResponse.status);
         return statusResponse.status;
     }
@@ -7056,6 +7098,46 @@ class StatusService {
         this.listenStatusSubscription = null;
         this.listenStatusService.stopListening();
     }
+    /**
+     * 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`.
+     */
+    async applyPollTerminalStatus(status, invoice) {
+        const nonTerminalStates = [
+            StatusEnum.created,
+            StatusEnum.awaiting,
+            StatusEnum.processing,
+            StatusEnum.held,
+        ];
+        if (!status.needToCheck ||
+            !nonTerminalStates.includes(status.statusState)) {
+            return;
+        }
+        let pollStatus;
+        try {
+            pollStatus = await this.checkStatusService.requestStatus(invoice);
+        }
+        catch {
+            return;
+        }
+        const terminalStatus = pollStatus.final === true &&
+            (pollStatus.status === StatusEnum.canceled ||
+                pollStatus.status === StatusEnum.error)
+            ? pollStatus.status
+            : null;
+        if (!terminalStatus) {
+            return;
+        }
+        status.statusState = terminalStatus;
+        if (terminalStatus === StatusEnum.canceled) {
+            status.isCanceled = true;
+        }
+    }
     getRequestParamsFromUrl(url) {
         const searchParams = this.urlService.getSearchParams(url ?? '');
         const keys = new Set(Object.keys(searchParams));
@@ -7091,7 +7173,7 @@ class StatusService {
                 this.nextActionService.emitFlowUpdates(this.statusUpdatedActionCreator.getActionData({ statusResponse }));
             });
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: StatusService, deps: [{ token: UrlService }, { token: StatusRequestService }, { token: FinanceDetailsService }, { token: ListenStatusService }, { token: NextActionService }, { token: SavePaymentMethodStatusService }, { token: StatusUpdatedActionCreator }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: StatusService, deps: [{ token: UrlService }, { token: StatusRequestService }, { token: FinanceDetailsService }, { token: ListenStatusService }, { token: NextActionService }, { token: SavePaymentMethodStatusService }, { token: CheckStatusService }, { token: StatusUpdatedActionCreator }], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: StatusService, providedIn: 'root' }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: StatusService, decorators: [{
@@ -7099,7 +7181,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.12", ngImpo
             args: [{
                     providedIn: 'root',
                 }]
-        }], ctorParameters: () => [{ type: UrlService }, { type: StatusRequestService }, { type: FinanceDetailsService }, { type: ListenStatusService }, { type: NextActionService }, { type: SavePaymentMethodStatusService }, { type: StatusUpdatedActionCreator }] });
+        }], ctorParameters: () => [{ type: UrlService }, { type: StatusRequestService }, { type: FinanceDetailsService }, { type: ListenStatusService }, { type: NextActionService }, { type: SavePaymentMethodStatusService }, { type: CheckStatusService }, { type: StatusUpdatedActionCreator }] });
 
 class CreditCardStateService extends EmitDataService {
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.12", ngImport: i0, type: CreditCardStateService, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }