@sazito/checkout 0.4.19 → 0.4.21

package/dist/next/index.d.cts

@@ -106,7 +106,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 CheckoutConfig {
@@ -234,8 +241,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;
 }
 
@@ -499,4 +506,4 @@ interface SazitoProviderProps {
 declare function SazitoProvider({ client, children }: SazitoProviderProps): react_jsx_runtime.JSX.Element;
 
 export { Button, CheckoutProvider, ErrorBanner, Field, ProductPlaceholder, SazitoCheckout, SazitoCheckoutPage, SazitoProvider, SectionTitle, Spinner, useCheckout };
-export type { ButtonProps, CheckoutPaymentReturn, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, PaymentReturnSearchParams, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, RenderResultProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };
+export type { ButtonProps, CheckoutPaymentReturn, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, PaymentReturnResolution, PaymentReturnSearchParams, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, RenderResultProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };

package/dist/next/index.d.ts

@@ -106,7 +106,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 CheckoutConfig {
@@ -234,8 +241,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;
 }
 
@@ -499,4 +506,4 @@ interface SazitoProviderProps {
 declare function SazitoProvider({ client, children }: SazitoProviderProps): react_jsx_runtime.JSX.Element;
 
 export { Button, CheckoutProvider, ErrorBanner, Field, ProductPlaceholder, SazitoCheckout, SazitoCheckoutPage, SazitoProvider, SectionTitle, Spinner, useCheckout };
-export type { ButtonProps, CheckoutPaymentReturn, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, PaymentReturnSearchParams, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, RenderResultProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };
+export type { ButtonProps, CheckoutPaymentReturn, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, PaymentReturnResolution, PaymentReturnSearchParams, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, RenderResultProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };

package/dist/next/index.js

@@ -1,10 +1,10 @@
 'use client';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 import { isValidElement, cloneElement, useMemo, useState, useRef, useEffect, useCallback } from 'react';
-import { u as useCheckout, b as useSazitoClient, C as CheckoutProvider } from '../chunks/use-checkout-uWEi8iqK.js';
-export { S as SazitoProvider } from '../chunks/use-checkout-uWEi8iqK.js';
-import { m as formatPercent, E as sortCartItemsNewestFirst, H as toPersianDigits, r as isDigitalServiceGroup, t as isValidIranianMobile, z as normalizeIranianPhone, A as paymentMethodInfo, l as formatNumber } from '../chunks/labels-Cysz2BgA.js';
-import { parsePaymentReturnUrl } from './payment-return.js';
+import { u as useCheckout, b as useSazitoClient, C as CheckoutProvider } from '../chunks/use-checkout-BRDfZp4Z.js';
+export { S as SazitoProvider } from '../chunks/use-checkout-BRDfZp4Z.js';
+import { m as formatPercent, E as sortCartItemsNewestFirst, H as toPersianDigits, r as isDigitalServiceGroup, t as isValidIranianMobile, z as normalizeIranianPhone, A as paymentMethodInfo, l as formatNumber } from '../chunks/labels-Cqrb2MwA.js';
+import { parsePaymentReturnUrl, stripPaymentStatusReturn } from './payment-return.js';
 import '@sazito/client-sdk';
 
 /**
@@ -934,14 +934,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 = useSazitoClient();
-    return (jsxs(CheckoutProvider, { client: client, credentials: checkoutCredentials, config: config, autoStart: !isReturn, children: [returnParams ? jsx(ResolveReturn, { params: returnParams }) : null, jsx(SazitoCheckout, { theme: config?.theme, continueShoppingUrl: config?.continueShoppingUrl, className: className, renderNextButton: renderNextButton, renderBackButton: renderBackButton, renderEmptyCart: renderEmptyCart, renderResult: renderResult, emptyCart: emptyCart })] }));
+    return (jsxs(CheckoutProvider, { client: client, credentials: checkoutCredentials, config: config, autoStart: !isReturn, children: [returnParams ? (jsx(ResolveReturn, { params: returnParams, resolution: returnResolution })) : null, 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();
     const resolvedKey = useRef(null);
     const paramsKey = JSON.stringify(Object.entries(params).sort(([a], [b]) => a.localeCompare(b)));
@@ -949,8 +950,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 = stripPaymentStatusReturn(window.location.href);
+            if (cleanUrl)
+                window.history.replaceState(window.history.state, '', cleanUrl);
+        }
+    }, [actions, params, paramsKey, resolution]);
     return null;
 }