@sazito/checkout 0.4.19 → 0.4.21

package/dist/core/index.d.ts

@@ -105,7 +105,14 @@ interface CheckoutPaymentReturn {
         identifier: string;
     };
     params: Record<string, string>;
+    /**
+     * `callback` forwards gateway fields for verification. `status` is emitted
+     * by the SDK server handler after it has already verified the gateway POST,
+     * so the browser performs only an authoritative status read.
+     */
+    resolution?: PaymentReturnResolution;
 }
+type PaymentReturnResolution = 'callback' | 'status';
 /** Search-param shape exposed by current Next.js App Router pages. */
 type PaymentReturnSearchParams = Record<string, string | string[] | undefined>;
 interface PaymentReturnParserOptions {
@@ -259,8 +266,8 @@ interface CheckoutActions {
     placeOrder(): Promise<void>;
     /** Rehydrate a failed gateway return and reopen a usable payment step. */
     retryPayment(): Promise<void>;
-    /** Resolve a return from the payment gateway (query params from the URL). */
-    resolvePaymentReturn(params: Record<string, string>): Promise<void>;
+    /** Resolve a gateway callback or a server-verified payment status return. */
+    resolvePaymentReturn(params: Record<string, string>, resolution?: PaymentReturnResolution): Promise<void>;
     reset(): void;
 }
 
@@ -311,6 +318,13 @@ declare function createBrowserEffectExecutor(config?: CheckoutConfig): CheckoutE
 /** A no-op executor for SSR / tests. */
 declare const noopEffectExecutor: CheckoutEffectExecutor;
 
+declare const SAZITO_PAYMENT_STATUS_QUERY: {
+    readonly resolution: "sazito_payment_return";
+    readonly paymentId: "sazito_payment_id";
+    readonly paymentIdentifier: "sazito_payment_identifier";
+};
+/** Remove internal payment-return credentials from the visible URL after they are read. */
+declare function stripPaymentStatusReturn(url: string | URL): string | undefined;
 declare const SAZITO_PAYMENT_RESULT_MARKERS: readonly ["mellatpaymentresult", "pecpaymentresult", "uppaymentresult", "seppaymentresult", "vandarpaymentresult", "yourgatepaymentresult", "bazarpaymentresult", "zifypaymentresult", "zibalpaymentresult", "snapppaypaymentresult", "torobpaypaymentresult", "ghestapaypaymentresult", "azkipaymentresult", "digipaypaymentresult", "greenpaypaymentresult", "novapaypaymentresult", "zarinpluspaymentresult", "tomanpaymentresult", "tarapaymentresult", "ozonpaymentresult", "millipaypaymentresult", "ayriapaymentresult", "sadadpaymentresult", "freepaymentresult", "paymentinplaceresult", "cardtocardpaymentresult", "zarinpalpaymentresult", "directpayresult", "paypingpaymentresult", "podpaymentresult", "sabinpaymentresult", "firoozepaymentresult", "technopaypaymentresult", "buywithdigikalaresult"];
 /**
  * Parse Sazito's nested payment callback path into checkout-ready data.
@@ -538,5 +552,5 @@ declare function selectSummary(invoice: Invoice | null): CheckoutSummary;
 /** Items that don't require shipping (digital), for display in the shipping step. */
 declare function selectDigitalItems(invoice: Invoice | null, groups: ShippingGroup[], applicable: ApplicableShippingMethods | null): InvoiceItem[];
 
-export { SAZITO_PAYMENT_RESULT_MARKERS, addressFormFromInvoice, buildShippingAssignments, classifyAppliedDiscount, createBrowserEffectExecutor, createCheckoutEngine, createSdkBinding, createStore, defaultCurrencyLabel, deriveShippingGroups, emptyAddressForm, formatMoney, formatNumber, formatPercent, formatPrice, fromSdkError, isAddressComplete, isAddressDirty, isDigitalServiceGroup, isShippingComplete, isValidIranianMobile, isValidIranianPhone, makeError, makeEvent, messageForCode, noopEffectExecutor, normalizeIranianPhone, parsePaymentReturn, parsePaymentReturnUrl, paymentMethodInfo, paymentMethodLabel, selectDigitalItems, selectSummary, sortCartItemsNewestFirst, strings, toEnglishDigits, toPersianDigits };
-export type { AddressFormValues, AppliedDiscount, CheckoutActions, CheckoutCity, CheckoutConfig, CheckoutCredentials, CheckoutDirection, CheckoutEffect, CheckoutEffectExecutor, CheckoutEngine, CheckoutEngineOptions, CheckoutError, CheckoutErrorCode, CheckoutEvent, CheckoutEventName, CheckoutFlags, CheckoutLocale, CheckoutPaymentReturn, CheckoutRegion, CheckoutResult, CheckoutResultStatus, CheckoutSdkBinding, CheckoutState, CheckoutStatus, CheckoutStep, CheckoutSummary, CheckoutTheme, DiscountKind, PaymentMethodInfo, PaymentMethodKind, PaymentReturnParserOptions, PaymentReturnSearchParams, ShippingGroup, Store, Strings, SummaryLine, SummaryLineKey };
+export { SAZITO_PAYMENT_RESULT_MARKERS, SAZITO_PAYMENT_STATUS_QUERY, addressFormFromInvoice, buildShippingAssignments, classifyAppliedDiscount, createBrowserEffectExecutor, createCheckoutEngine, createSdkBinding, createStore, defaultCurrencyLabel, deriveShippingGroups, emptyAddressForm, formatMoney, formatNumber, formatPercent, formatPrice, fromSdkError, isAddressComplete, isAddressDirty, isDigitalServiceGroup, isShippingComplete, isValidIranianMobile, isValidIranianPhone, makeError, makeEvent, messageForCode, noopEffectExecutor, normalizeIranianPhone, parsePaymentReturn, parsePaymentReturnUrl, paymentMethodInfo, paymentMethodLabel, selectDigitalItems, selectSummary, sortCartItemsNewestFirst, strings, stripPaymentStatusReturn, toEnglishDigits, toPersianDigits };
+export type { AddressFormValues, AppliedDiscount, CheckoutActions, CheckoutCity, CheckoutConfig, CheckoutCredentials, CheckoutDirection, CheckoutEffect, CheckoutEffectExecutor, CheckoutEngine, CheckoutEngineOptions, CheckoutError, CheckoutErrorCode, CheckoutEvent, CheckoutEventName, CheckoutFlags, CheckoutLocale, CheckoutPaymentReturn, CheckoutRegion, CheckoutResult, CheckoutResultStatus, CheckoutSdkBinding, CheckoutState, CheckoutStatus, CheckoutStep, CheckoutSummary, CheckoutTheme, DiscountKind, PaymentMethodInfo, PaymentMethodKind, PaymentReturnParserOptions, PaymentReturnResolution, PaymentReturnSearchParams, ShippingGroup, Store, Strings, SummaryLine, SummaryLineKey };

package/dist/core/index.js

@@ -1,4 +1,4 @@
-export { a as addressFormFromInvoice, b as buildShippingAssignments, c as classifyAppliedDiscount, d as createBrowserEffectExecutor, e as createCheckoutEngine, f as createSdkBinding, g as createStore, h as defaultCurrencyLabel, i as deriveShippingGroups, j as emptyAddressForm, k as formatMoney, l as formatNumber, m as formatPercent, n as formatPrice, o as fromSdkError, p as isAddressComplete, q as isAddressDirty, r as isDigitalServiceGroup, s as isShippingComplete, t as isValidIranianMobile, u as isValidIranianPhone, v as makeError, w as makeEvent, x as messageForCode, y as noopEffectExecutor, z as normalizeIranianPhone, A as paymentMethodInfo, B as paymentMethodLabel, C as selectDigitalItems, D as selectSummary, E as sortCartItemsNewestFirst, F as strings, G as toEnglishDigits, H as toPersianDigits } from '../chunks/labels-Cysz2BgA.js';
-export { SAZITO_PAYMENT_RESULT_MARKERS, parsePaymentReturn, parsePaymentReturnUrl } from '../next/payment-return.js';
+export { a as addressFormFromInvoice, b as buildShippingAssignments, c as classifyAppliedDiscount, d as createBrowserEffectExecutor, e as createCheckoutEngine, f as createSdkBinding, g as createStore, h as defaultCurrencyLabel, i as deriveShippingGroups, j as emptyAddressForm, k as formatMoney, l as formatNumber, m as formatPercent, n as formatPrice, o as fromSdkError, p as isAddressComplete, q as isAddressDirty, r as isDigitalServiceGroup, s as isShippingComplete, t as isValidIranianMobile, u as isValidIranianPhone, v as makeError, w as makeEvent, x as messageForCode, y as noopEffectExecutor, z as normalizeIranianPhone, A as paymentMethodInfo, B as paymentMethodLabel, C as selectDigitalItems, D as selectSummary, E as sortCartItemsNewestFirst, F as strings, G as toEnglishDigits, H as toPersianDigits } from '../chunks/labels-Cqrb2MwA.js';
+export { SAZITO_PAYMENT_RESULT_MARKERS, SAZITO_PAYMENT_STATUS_QUERY, parsePaymentReturn, parsePaymentReturnUrl, stripPaymentStatusReturn } from '../next/payment-return.js';
 import '@sazito/client-sdk';
 //# sourceMappingURL=index.js.map

package/dist/next/index.cjs

@@ -3,8 +3,8 @@
 
 var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
-var useCheckout = require('../chunks/use-checkout-wHkKNkbK.cjs');
-var labels = require('../chunks/labels-Cy05dLJx.cjs');
+var useCheckout = require('../chunks/use-checkout-MM-Ld0Ew.cjs');
+var labels = require('../chunks/labels-BYJQjaT_.cjs');
 var next_paymentReturn = require('./payment-return.cjs');
 require('@sazito/client-sdk');
 
@@ -935,14 +935,15 @@ function SazitoCheckoutPage({ credentials, config, paymentReturn, paymentReturnP
         : undefined;
     const resolvedPaymentReturn = paymentReturn ?? detectedPaymentReturn;
     const returnParams = resolvedPaymentReturn?.params ?? paymentReturnParams;
+    const returnResolution = resolvedPaymentReturn?.resolution ?? 'callback';
     const isReturn = returnParams != null;
     const checkoutCredentials = resolvedPaymentReturn
         ? { ...credentials, payment: resolvedPaymentReturn.payment }
         : credentials;
     const client = useCheckout.useSazitoClient();
-    return (jsxRuntime.jsxs(useCheckout.CheckoutProvider, { client: client, credentials: checkoutCredentials, config: config, autoStart: !isReturn, children: [returnParams ? jsxRuntime.jsx(ResolveReturn, { params: returnParams }) : null, jsxRuntime.jsx(SazitoCheckout, { theme: config?.theme, continueShoppingUrl: config?.continueShoppingUrl, className: className, renderNextButton: renderNextButton, renderBackButton: renderBackButton, renderEmptyCart: renderEmptyCart, renderResult: renderResult, emptyCart: emptyCart })] }));
+    return (jsxRuntime.jsxs(useCheckout.CheckoutProvider, { client: client, credentials: checkoutCredentials, config: config, autoStart: !isReturn, children: [returnParams ? (jsxRuntime.jsx(ResolveReturn, { params: returnParams, resolution: returnResolution })) : null, jsxRuntime.jsx(SazitoCheckout, { theme: config?.theme, continueShoppingUrl: config?.continueShoppingUrl, className: className, renderNextButton: renderNextButton, renderBackButton: renderBackButton, renderEmptyCart: renderEmptyCart, renderResult: renderResult, emptyCart: emptyCart })] }));
 }
-function ResolveReturn({ params }) {
+function ResolveReturn({ params, resolution }) {
     const { actions } = useCheckout.useCheckout();
     const resolvedKey = react.useRef(null);
     const paramsKey = JSON.stringify(Object.entries(params).sort(([a], [b]) => a.localeCompare(b)));
@@ -950,8 +951,13 @@ function ResolveReturn({ params }) {
         if (resolvedKey.current === paramsKey)
             return;
         resolvedKey.current = paramsKey;
-        void actions.resolvePaymentReturn(params);
-    }, [actions, params, paramsKey]);
+        void actions.resolvePaymentReturn(params, resolution);
+        if (typeof window !== 'undefined') {
+            const cleanUrl = next_paymentReturn.stripPaymentStatusReturn(window.location.href);
+            if (cleanUrl)
+                window.history.replaceState(window.history.state, '', cleanUrl);
+        }
+    }, [actions, params, paramsKey, resolution]);
     return null;
 }