@sazito/checkout 0.4.0 → 0.4.1

package/README.md

@@ -97,6 +97,11 @@ export default async function CheckoutPage({
 `paymentReturnParams` remains available for existing query-only callback
 integrations.
 
+As a fallback, `SazitoCheckoutPage` also recognizes this callback suffix from
+the browser URL when `paymentReturn` is omitted. The catch-all route is still
+required so Next.js serves the callback URL, and explicit server parsing remains
+recommended because it validates the route before rendering.
+
 ### Theme variables
 
 `config.theme` (or the `theme` prop on `SazitoCheckout`) accepts:

package/dist/core/index.cjs

@@ -41,4 +41,5 @@ exports.strings = labels.strings;
 exports.toEnglishDigits = labels.toEnglishDigits;
 exports.toPersianDigits = labels.toPersianDigits;
 exports.parsePaymentReturn = next_paymentReturn.parsePaymentReturn;
+exports.parsePaymentReturnUrl = next_paymentReturn.parsePaymentReturnUrl;
 //# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/core/index.d.cts

@@ -308,6 +308,12 @@ declare const noopEffectExecutor: CheckoutEffectExecutor;
  * Returns undefined for ordinary checkout URLs and malformed callbacks.
  */
 declare function parsePaymentReturn(segments: readonly string[] | undefined, searchParams?: PaymentReturnSearchParams): CheckoutPaymentReturn | undefined;
+/**
+ * Parse a complete checkout URL containing Sazito's nested payment callback.
+ * The callback may be mounted below any checkout base path; only its final
+ * five path segments are significant.
+ */
+declare function parsePaymentReturnUrl(url: string | URL): CheckoutPaymentReturn | undefined;
 
 /**
  * Typed event bus helpers.
@@ -516,5 +522,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 { 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, paymentMethodInfo, paymentMethodLabel, selectDigitalItems, selectSummary, sortCartItemsNewestFirst, strings, toEnglishDigits, toPersianDigits };
+export { 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, PaymentReturnSearchParams, ShippingGroup, Store, Strings, SummaryLine, SummaryLineKey };

package/dist/core/index.d.ts

@@ -308,6 +308,12 @@ declare const noopEffectExecutor: CheckoutEffectExecutor;
  * Returns undefined for ordinary checkout URLs and malformed callbacks.
  */
 declare function parsePaymentReturn(segments: readonly string[] | undefined, searchParams?: PaymentReturnSearchParams): CheckoutPaymentReturn | undefined;
+/**
+ * Parse a complete checkout URL containing Sazito's nested payment callback.
+ * The callback may be mounted below any checkout base path; only its final
+ * five path segments are significant.
+ */
+declare function parsePaymentReturnUrl(url: string | URL): CheckoutPaymentReturn | undefined;
 
 /**
  * Typed event bus helpers.
@@ -516,5 +522,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 { 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, paymentMethodInfo, paymentMethodLabel, selectDigitalItems, selectSummary, sortCartItemsNewestFirst, strings, toEnglishDigits, toPersianDigits };
+export { 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, 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-e8w4zRbg.js';
-export { parsePaymentReturn } from '../next/payment-return.js';
+export { parsePaymentReturn, parsePaymentReturnUrl } from '../next/payment-return.js';
 import '@sazito/client-sdk';
 //# sourceMappingURL=index.js.map

package/dist/next/index.cjs

@@ -5,6 +5,7 @@ var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
 var useCheckout = require('../chunks/use-checkout-DPtLgxlA.cjs');
 var labels = require('../chunks/labels-CnPllzhT.cjs');
+var next_paymentReturn = require('./payment-return.cjs');
 require('@sazito/client-sdk');
 
 /**
@@ -849,10 +850,20 @@ function SazitoCheckout({ theme, continueShoppingUrl, className, renderNextButto
 }
 
 function SazitoCheckoutPage({ credentials, config, paymentReturn, paymentReturnParams, className, renderNextButton, renderBackButton, renderEmptyCart, emptyCart, }) {
-    const returnParams = paymentReturn?.params ?? paymentReturnParams;
+    // 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'
+        ? next_paymentReturn.parsePaymentReturnUrl(window.location.href)
+        : undefined;
+    const resolvedPaymentReturn = paymentReturn ?? detectedPaymentReturn;
+    const returnParams = resolvedPaymentReturn?.params ?? paymentReturnParams;
     const isReturn = returnParams != null;
-    const checkoutCredentials = paymentReturn
-        ? { ...credentials, payment: paymentReturn.payment }
+    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, emptyCart: emptyCart })] }));