@sazito/checkout 0.3.0 → 0.4.1

package/dist/next/index.d.cts

@@ -94,14 +94,32 @@ interface CheckoutCredentials {
         id: number;
         identifier: string;
     };
+    payment?: {
+        id: number;
+        identifier: string;
+    };
+}
+/** Normalized payment callback data accepted by `SazitoCheckoutPage`. */
+interface CheckoutPaymentReturn {
+    payment: {
+        id: number;
+        identifier: string;
+    };
+    params: Record<string, string>;
 }
+/** Search-param shape exposed by current Next.js App Router pages. */
+type PaymentReturnSearchParams = Record<string, string | string[] | undefined>;
 interface CheckoutConfig {
     locale?: CheckoutLocale;
     direction?: CheckoutDirection;
     theme?: CheckoutTheme;
     /** URL for the "continue shopping" / back-to-store action. */
     continueShoppingUrl?: string;
-    /** URL the gateway returns to after payment. Defaults to current URL. */
+    /**
+     * Reserved for gateways that support a caller-provided return URL.
+     * Current Sazito legacy callbacks use their generated nested result path.
+     * @deprecated Use an optional catch-all route with `parsePaymentReturn`.
+     */
     returnUrl?: string;
     /** Pending-payment poll interval in ms (default 15000). */
     pollIntervalMs?: number;
@@ -411,6 +429,9 @@ declare function ErrorBanner({ message, asChild, children, className }: ErrorBan
 interface SazitoCheckoutPageProps {
     credentials?: CheckoutCredentials;
     config?: CheckoutConfig;
+    /** Parsed nested gateway callback. Prefer `parsePaymentReturn()` to create it. */
+    paymentReturn?: CheckoutPaymentReturn;
+    /** @deprecated Prefer `paymentReturn`; retained for query-only callbacks. */
     paymentReturnParams?: Record<string, string>;
     className?: string;
     renderNextButton?: (props: RenderButtonProps) => React.ReactNode;
@@ -418,7 +439,7 @@ interface SazitoCheckoutPageProps {
     renderEmptyCart?: (props: RenderEmptyCartProps) => React.ReactNode;
     emptyCart?: EmptyCartOptions;
 }
-declare function SazitoCheckoutPage({ credentials, config, paymentReturnParams, className, renderNextButton, renderBackButton, renderEmptyCart, emptyCart, }: SazitoCheckoutPageProps): react_jsx_runtime.JSX.Element;
+declare function SazitoCheckoutPage({ credentials, config, paymentReturn, paymentReturnParams, className, renderNextButton, renderBackButton, renderEmptyCart, emptyCart, }: SazitoCheckoutPageProps): react_jsx_runtime.JSX.Element;
 
 interface CheckoutProviderProps {
     /** Override the SazitoProvider client for this checkout instance only. */
@@ -451,4 +472,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, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };
+export type { ButtonProps, CheckoutPaymentReturn, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, PaymentReturnSearchParams, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };

package/dist/next/index.d.ts

@@ -94,14 +94,32 @@ interface CheckoutCredentials {
         id: number;
         identifier: string;
     };
+    payment?: {
+        id: number;
+        identifier: string;
+    };
+}
+/** Normalized payment callback data accepted by `SazitoCheckoutPage`. */
+interface CheckoutPaymentReturn {
+    payment: {
+        id: number;
+        identifier: string;
+    };
+    params: Record<string, string>;
 }
+/** Search-param shape exposed by current Next.js App Router pages. */
+type PaymentReturnSearchParams = Record<string, string | string[] | undefined>;
 interface CheckoutConfig {
     locale?: CheckoutLocale;
     direction?: CheckoutDirection;
     theme?: CheckoutTheme;
     /** URL for the "continue shopping" / back-to-store action. */
     continueShoppingUrl?: string;
-    /** URL the gateway returns to after payment. Defaults to current URL. */
+    /**
+     * Reserved for gateways that support a caller-provided return URL.
+     * Current Sazito legacy callbacks use their generated nested result path.
+     * @deprecated Use an optional catch-all route with `parsePaymentReturn`.
+     */
     returnUrl?: string;
     /** Pending-payment poll interval in ms (default 15000). */
     pollIntervalMs?: number;
@@ -411,6 +429,9 @@ declare function ErrorBanner({ message, asChild, children, className }: ErrorBan
 interface SazitoCheckoutPageProps {
     credentials?: CheckoutCredentials;
     config?: CheckoutConfig;
+    /** Parsed nested gateway callback. Prefer `parsePaymentReturn()` to create it. */
+    paymentReturn?: CheckoutPaymentReturn;
+    /** @deprecated Prefer `paymentReturn`; retained for query-only callbacks. */
     paymentReturnParams?: Record<string, string>;
     className?: string;
     renderNextButton?: (props: RenderButtonProps) => React.ReactNode;
@@ -418,7 +439,7 @@ interface SazitoCheckoutPageProps {
     renderEmptyCart?: (props: RenderEmptyCartProps) => React.ReactNode;
     emptyCart?: EmptyCartOptions;
 }
-declare function SazitoCheckoutPage({ credentials, config, paymentReturnParams, className, renderNextButton, renderBackButton, renderEmptyCart, emptyCart, }: SazitoCheckoutPageProps): react_jsx_runtime.JSX.Element;
+declare function SazitoCheckoutPage({ credentials, config, paymentReturn, paymentReturnParams, className, renderNextButton, renderBackButton, renderEmptyCart, emptyCart, }: SazitoCheckoutPageProps): react_jsx_runtime.JSX.Element;
 
 interface CheckoutProviderProps {
     /** Override the SazitoProvider client for this checkout instance only. */
@@ -451,4 +472,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, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };
+export type { ButtonProps, CheckoutPaymentReturn, CheckoutProviderProps, EmptyCartOptions, ErrorBannerProps, FieldProps, PaymentReturnSearchParams, ProductPlaceholderProps, RenderButtonProps, RenderEmptyCartProps as RenderEmptyCartPageProps, RenderEmptyCartProps, SazitoCheckoutPageProps, SazitoCheckoutProps, SazitoProviderProps, SectionTitleProps, SpinnerProps };

package/dist/next/index.js

@@ -1,9 +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-Bh4tXxFJ.js';
-export { S as SazitoProvider } from '../chunks/use-checkout-Bh4tXxFJ.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-BdxqgReM.js';
+import { u as useCheckout, b as useSazitoClient, C as CheckoutProvider } from '../chunks/use-checkout-BM810__v.js';
+export { S as SazitoProvider } from '../chunks/use-checkout-BM810__v.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-e8w4zRbg.js';
+import { parsePaymentReturnUrl } from './payment-return.js';
 import '@sazito/client-sdk';
 
 /**
@@ -847,17 +848,35 @@ function SazitoCheckout({ theme, continueShoppingUrl, className, renderNextButto
     return (jsxs("div", { className: `szc-root${className ? ` ${className}` : ''}`, dir: direction, style: themeVars(theme), children: [mobileHead, jsx(Stepper, {}), bootstrapping ? (jsx(CheckoutLoading, { label: t.loading })) : fatal ? (jsx(ErrorBanner, { message: error.message })) : isResult ? (jsx("div", { className: "szc-result-wrap", children: jsx(ResultStep, { continueShoppingUrl: continueShoppingUrl }) })) : (jsx(Fragment, { children: jsxs("div", { className: `szc-layout${cartEmpty ? ' szc-layout--full' : ''}`, children: [jsxs("main", { className: "szc-main", children: [error && !emptyCartError ? jsx(ErrorBanner, { message: error.message }) : null, step === 'cart' ? (jsx(CartStep, { continueShoppingUrl: continueShoppingUrl, emptyCart: emptyCart, renderEmpty: renderEmptyCart })) : null, step === 'shipping' ? jsx(ShippingStep, {}) : null, step === 'payment' ? jsx(PaymentStep, {}) : null, actionsVisible && backButtonNode ? (jsx("div", { className: "szc-back-row", children: backButtonNode })) : null] }), !cartEmpty ? (jsxs("div", { className: "szc-side", children: [jsx(OrderSummary, {}), actionsVisible ? jsx("div", { className: "szc-side__cta", children: nextButtonNode }) : null] })) : null] }) })), actionsVisible ? (jsx("div", { className: "szc-footer-bar", children: jsxs("div", { className: "szc-footer", children: [jsxs("div", { className: "szc-footer__total", children: [jsx("span", { className: "szc-footer__total-label", children: t.total }), jsx("span", { className: "szc-footer__total-value", children: money(summary.total) })] }), jsx("div", { className: "szc-footer__actions", children: nextButtonNode })] }) })) : null] }));
 }
 
-function SazitoCheckoutPage({ credentials, config, paymentReturnParams, className, renderNextButton, renderBackButton, renderEmptyCart, emptyCart, }) {
-    const isReturn = paymentReturnParams != null;
+function SazitoCheckoutPage({ credentials, config, paymentReturn, paymentReturnParams, className, renderNextButton, renderBackButton, renderEmptyCart, emptyCart, }) {
+    // The explicit server-parsed value remains authoritative. As a fallback,
+    // detect Sazito's well-known nested callback in the browser. This prevents a
+    // caught callback route from silently booting a fresh checkout when the host
+    // forgot to forward its catch-all params.
+    const detectedPaymentReturn = paymentReturn == null &&
+        paymentReturnParams == null &&
+        typeof window !== 'undefined'
+        ? parsePaymentReturnUrl(window.location.href)
+        : undefined;
+    const resolvedPaymentReturn = paymentReturn ?? detectedPaymentReturn;
+    const returnParams = resolvedPaymentReturn?.params ?? paymentReturnParams;
+    const isReturn = returnParams != null;
+    const checkoutCredentials = resolvedPaymentReturn
+        ? { ...credentials, payment: resolvedPaymentReturn.payment }
+        : credentials;
     const client = useSazitoClient();
-    return (jsxs(CheckoutProvider, { client: client, credentials: credentials, config: config, autoStart: !isReturn, children: [isReturn ? jsx(ResolveReturn, { params: paymentReturnParams }) : null, jsx(SazitoCheckout, { theme: config?.theme, continueShoppingUrl: config?.continueShoppingUrl, className: className, renderNextButton: renderNextButton, renderBackButton: renderBackButton, renderEmptyCart: renderEmptyCart, emptyCart: emptyCart })] }));
+    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, emptyCart: emptyCart })] }));
 }
 function ResolveReturn({ params }) {
     const { actions } = useCheckout();
+    const resolvedKey = useRef(null);
+    const paramsKey = JSON.stringify(Object.entries(params).sort(([a], [b]) => a.localeCompare(b)));
     useEffect(() => {
+        if (resolvedKey.current === paramsKey)
+            return;
+        resolvedKey.current = paramsKey;
         void actions.resolvePaymentReturn(params);
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
+    }, [actions, params, paramsKey]);
     return null;
 }