@sazito/checkout 0.3.0 → 0.4.1

package/dist/next/payment-return.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+/**
+ * Parse Sazito's nested payment callback path into checkout-ready data.
+ * Returns undefined for ordinary checkout URLs and malformed callbacks.
+ */
+function parsePaymentReturn(segments, searchParams = {}) {
+    const [resultRoute, paymentSegment, rawPaymentId, identifierSegment, rawIdentifier] = segments ?? [];
+    const paymentId = Number(rawPaymentId);
+    const identifier = rawIdentifier?.trim();
+    if (segments?.length !== 5 ||
+        !resultRoute?.toLowerCase().endsWith('result') ||
+        paymentSegment?.toLowerCase() !== 'payment' ||
+        identifierSegment?.toLowerCase() !== 'identifier' ||
+        !Number.isSafeInteger(paymentId) ||
+        paymentId <= 0 ||
+        !identifier) {
+        return undefined;
+    }
+    const params = normalizeSearchParams(searchParams);
+    params.id = String(paymentId);
+    params.paymentIdentifier = identifier;
+    return {
+        payment: { id: paymentId, identifier },
+        params
+    };
+}
+/**
+ * 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.
+ */
+function parsePaymentReturnUrl(url) {
+    let parsedUrl;
+    try {
+        parsedUrl = typeof url === 'string'
+            ? new URL(url, 'https://checkout.sazito.invalid')
+            : url;
+    }
+    catch {
+        return undefined;
+    }
+    const segments = parsedUrl.pathname
+        .split('/')
+        .filter(Boolean)
+        .map(decodePathSegment);
+    if (segments.length < 5) {
+        return undefined;
+    }
+    const searchParams = {};
+    for (const [key, value] of parsedUrl.searchParams) {
+        // Match Next.js search-param normalization: preserve the first value.
+        if (searchParams[key] === undefined) {
+            searchParams[key] = value;
+        }
+    }
+    return parsePaymentReturn(segments.slice(-5), searchParams);
+}
+function decodePathSegment(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return segment;
+    }
+}
+function normalizeSearchParams(searchParams) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(searchParams)) {
+        const firstValue = Array.isArray(value) ? value[0] : value;
+        if (firstValue !== undefined) {
+            normalized[key] = firstValue;
+        }
+    }
+    return normalized;
+}
+
+exports.parsePaymentReturn = parsePaymentReturn;
+exports.parsePaymentReturnUrl = parsePaymentReturnUrl;
+//# sourceMappingURL=payment-return.cjs.map

package/dist/next/payment-return.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-return.cjs","sources":["../../src/core/payment-return.ts"],"sourcesContent":["import type {\n  CheckoutPaymentReturn,\n  PaymentReturnSearchParams\n} from './types';\n\n/**\n * Parse Sazito's nested payment callback path into checkout-ready data.\n * Returns undefined for ordinary checkout URLs and malformed callbacks.\n */\nexport function parsePaymentReturn(\n  segments: readonly string[] | undefined,\n  searchParams: PaymentReturnSearchParams = {}\n): CheckoutPaymentReturn | undefined {\n  const [resultRoute, paymentSegment, rawPaymentId, identifierSegment, rawIdentifier] =\n    segments ?? [];\n  const paymentId = Number(rawPaymentId);\n  const identifier = rawIdentifier?.trim();\n\n  if (\n    segments?.length !== 5 ||\n    !resultRoute?.toLowerCase().endsWith('result') ||\n    paymentSegment?.toLowerCase() !== 'payment' ||\n    identifierSegment?.toLowerCase() !== 'identifier' ||\n    !Number.isSafeInteger(paymentId) ||\n    paymentId <= 0 ||\n    !identifier\n  ) {\n    return undefined;\n  }\n\n  const params = normalizeSearchParams(searchParams);\n  params.id = String(paymentId);\n  params.paymentIdentifier = identifier;\n\n  return {\n    payment: { id: paymentId, identifier },\n    params\n  };\n}\n\n/**\n * Parse a complete checkout URL containing Sazito's nested payment callback.\n * The callback may be mounted below any checkout base path; only its final\n * five path segments are significant.\n */\nexport function parsePaymentReturnUrl(\n  url: string | URL\n): CheckoutPaymentReturn | undefined {\n  let parsedUrl: URL;\n\n  try {\n    parsedUrl = typeof url === 'string'\n      ? new URL(url, 'https://checkout.sazito.invalid')\n      : url;\n  } catch {\n    return undefined;\n  }\n\n  const segments = parsedUrl.pathname\n    .split('/')\n    .filter(Boolean)\n    .map(decodePathSegment);\n\n  if (segments.length < 5) {\n    return undefined;\n  }\n\n  const searchParams: Record<string, string> = {};\n  for (const [key, value] of parsedUrl.searchParams) {\n    // Match Next.js search-param normalization: preserve the first value.\n    if (searchParams[key] === undefined) {\n      searchParams[key] = value;\n    }\n  }\n\n  return parsePaymentReturn(segments.slice(-5), searchParams);\n}\n\nfunction decodePathSegment(segment: string): string {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return segment;\n  }\n}\n\nfunction normalizeSearchParams(\n  searchParams: PaymentReturnSearchParams\n): Record<string, string> {\n  const normalized: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(searchParams)) {\n    const firstValue = Array.isArray(value) ? value[0] : value;\n    if (firstValue !== undefined) {\n      normalized[key] = firstValue;\n    }\n  }\n\n  return normalized;\n}\n"],"names":[],"mappings":";;AAKA;;;AAGG;SACa,kBAAkB,CAChC,QAAuC,EACvC,eAA0C,EAAE,EAAA;AAE5C,IAAA,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,CAAC,GACjF,QAAQ,IAAI,EAAE;AAChB,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC;AACtC,IAAA,MAAM,UAAU,GAAG,aAAa,EAAE,IAAI,EAAE;AAExC,IAAA,IACE,QAAQ,EAAE,MAAM,KAAK,CAAC;QACtB,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAC9C,QAAA,cAAc,EAAE,WAAW,EAAE,KAAK,SAAS;AAC3C,QAAA,iBAAiB,EAAE,WAAW,EAAE,KAAK,YAAY;AACjD,QAAA,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;AAChC,QAAA,SAAS,IAAI,CAAC;QACd,CAAC,UAAU,EACX;AACA,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC;AAClD,IAAA,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC;AAC7B,IAAA,MAAM,CAAC,iBAAiB,GAAG,UAAU;IAErC,OAAO;AACL,QAAA,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;QACtC;KACD;AACH;AAEA;;;;AAIG;AACG,SAAU,qBAAqB,CACnC,GAAiB,EAAA;AAEjB,IAAA,IAAI,SAAc;AAElB,IAAA,IAAI;AACF,QAAA,SAAS,GAAG,OAAO,GAAG,KAAK;AACzB,cAAE,IAAI,GAAG,CAAC,GAAG,EAAE,iCAAiC;cAC9C,GAAG;IACT;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,QAAQ,GAAG,SAAS,CAAC;SACxB,KAAK,CAAC,GAAG;SACT,MAAM,CAAC,OAAO;SACd,GAAG,CAAC,iBAAiB,CAAC;AAEzB,IAAA,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;AACvB,QAAA,OAAO,SAAS;IAClB;IAEA,MAAM,YAAY,GAA2B,EAAE;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,YAAY,EAAE;;AAEjD,QAAA,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;AACnC,YAAA,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK;QAC3B;IACF;AAEA,IAAA,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC;AAC7D;AAEA,SAAS,iBAAiB,CAAC,OAAe,EAAA;AACxC,IAAA,IAAI;AACF,QAAA,OAAO,kBAAkB,CAAC,OAAO,CAAC;IACpC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,OAAO;IAChB;AACF;AAEA,SAAS,qBAAqB,CAC5B,YAAuC,EAAA;IAEvC,MAAM,UAAU,GAA2B,EAAE;AAE7C,IAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;AACvD,QAAA,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;AAC1D,QAAA,IAAI,UAAU,KAAK,SAAS,EAAE;AAC5B,YAAA,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU;QAC9B;IACF;AAEA,IAAA,OAAO,UAAU;AACnB;;;;;"}

package/dist/next/payment-return.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Checkout domain types.
+ *
+ * The package re-exports the SDK data models (camelCase) and layers
+ * checkout-specific state, config, events and effects on top.
+ */
+
+/** 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>;
+
+/**
+ * Parse Sazito's nested payment callback path into checkout-ready data.
+ * 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;
+
+export { parsePaymentReturn, parsePaymentReturnUrl };
+export type { CheckoutPaymentReturn, PaymentReturnSearchParams };

package/dist/next/payment-return.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Checkout domain types.
+ *
+ * The package re-exports the SDK data models (camelCase) and layers
+ * checkout-specific state, config, events and effects on top.
+ */
+
+/** 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>;
+
+/**
+ * Parse Sazito's nested payment callback path into checkout-ready data.
+ * 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;
+
+export { parsePaymentReturn, parsePaymentReturnUrl };
+export type { CheckoutPaymentReturn, PaymentReturnSearchParams };

package/dist/next/payment-return.js

@@ -0,0 +1,77 @@
+/**
+ * Parse Sazito's nested payment callback path into checkout-ready data.
+ * Returns undefined for ordinary checkout URLs and malformed callbacks.
+ */
+function parsePaymentReturn(segments, searchParams = {}) {
+    const [resultRoute, paymentSegment, rawPaymentId, identifierSegment, rawIdentifier] = segments ?? [];
+    const paymentId = Number(rawPaymentId);
+    const identifier = rawIdentifier?.trim();
+    if (segments?.length !== 5 ||
+        !resultRoute?.toLowerCase().endsWith('result') ||
+        paymentSegment?.toLowerCase() !== 'payment' ||
+        identifierSegment?.toLowerCase() !== 'identifier' ||
+        !Number.isSafeInteger(paymentId) ||
+        paymentId <= 0 ||
+        !identifier) {
+        return undefined;
+    }
+    const params = normalizeSearchParams(searchParams);
+    params.id = String(paymentId);
+    params.paymentIdentifier = identifier;
+    return {
+        payment: { id: paymentId, identifier },
+        params
+    };
+}
+/**
+ * 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.
+ */
+function parsePaymentReturnUrl(url) {
+    let parsedUrl;
+    try {
+        parsedUrl = typeof url === 'string'
+            ? new URL(url, 'https://checkout.sazito.invalid')
+            : url;
+    }
+    catch {
+        return undefined;
+    }
+    const segments = parsedUrl.pathname
+        .split('/')
+        .filter(Boolean)
+        .map(decodePathSegment);
+    if (segments.length < 5) {
+        return undefined;
+    }
+    const searchParams = {};
+    for (const [key, value] of parsedUrl.searchParams) {
+        // Match Next.js search-param normalization: preserve the first value.
+        if (searchParams[key] === undefined) {
+            searchParams[key] = value;
+        }
+    }
+    return parsePaymentReturn(segments.slice(-5), searchParams);
+}
+function decodePathSegment(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return segment;
+    }
+}
+function normalizeSearchParams(searchParams) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(searchParams)) {
+        const firstValue = Array.isArray(value) ? value[0] : value;
+        if (firstValue !== undefined) {
+            normalized[key] = firstValue;
+        }
+    }
+    return normalized;
+}
+
+export { parsePaymentReturn, parsePaymentReturnUrl };
+//# sourceMappingURL=payment-return.js.map

package/dist/next/payment-return.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-return.js","sources":["../../src/core/payment-return.ts"],"sourcesContent":["import type {\n  CheckoutPaymentReturn,\n  PaymentReturnSearchParams\n} from './types';\n\n/**\n * Parse Sazito's nested payment callback path into checkout-ready data.\n * Returns undefined for ordinary checkout URLs and malformed callbacks.\n */\nexport function parsePaymentReturn(\n  segments: readonly string[] | undefined,\n  searchParams: PaymentReturnSearchParams = {}\n): CheckoutPaymentReturn | undefined {\n  const [resultRoute, paymentSegment, rawPaymentId, identifierSegment, rawIdentifier] =\n    segments ?? [];\n  const paymentId = Number(rawPaymentId);\n  const identifier = rawIdentifier?.trim();\n\n  if (\n    segments?.length !== 5 ||\n    !resultRoute?.toLowerCase().endsWith('result') ||\n    paymentSegment?.toLowerCase() !== 'payment' ||\n    identifierSegment?.toLowerCase() !== 'identifier' ||\n    !Number.isSafeInteger(paymentId) ||\n    paymentId <= 0 ||\n    !identifier\n  ) {\n    return undefined;\n  }\n\n  const params = normalizeSearchParams(searchParams);\n  params.id = String(paymentId);\n  params.paymentIdentifier = identifier;\n\n  return {\n    payment: { id: paymentId, identifier },\n    params\n  };\n}\n\n/**\n * Parse a complete checkout URL containing Sazito's nested payment callback.\n * The callback may be mounted below any checkout base path; only its final\n * five path segments are significant.\n */\nexport function parsePaymentReturnUrl(\n  url: string | URL\n): CheckoutPaymentReturn | undefined {\n  let parsedUrl: URL;\n\n  try {\n    parsedUrl = typeof url === 'string'\n      ? new URL(url, 'https://checkout.sazito.invalid')\n      : url;\n  } catch {\n    return undefined;\n  }\n\n  const segments = parsedUrl.pathname\n    .split('/')\n    .filter(Boolean)\n    .map(decodePathSegment);\n\n  if (segments.length < 5) {\n    return undefined;\n  }\n\n  const searchParams: Record<string, string> = {};\n  for (const [key, value] of parsedUrl.searchParams) {\n    // Match Next.js search-param normalization: preserve the first value.\n    if (searchParams[key] === undefined) {\n      searchParams[key] = value;\n    }\n  }\n\n  return parsePaymentReturn(segments.slice(-5), searchParams);\n}\n\nfunction decodePathSegment(segment: string): string {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return segment;\n  }\n}\n\nfunction normalizeSearchParams(\n  searchParams: PaymentReturnSearchParams\n): Record<string, string> {\n  const normalized: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(searchParams)) {\n    const firstValue = Array.isArray(value) ? value[0] : value;\n    if (firstValue !== undefined) {\n      normalized[key] = firstValue;\n    }\n  }\n\n  return normalized;\n}\n"],"names":[],"mappings":"AAKA;;;AAGG;SACa,kBAAkB,CAChC,QAAuC,EACvC,eAA0C,EAAE,EAAA;AAE5C,IAAA,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,CAAC,GACjF,QAAQ,IAAI,EAAE;AAChB,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC;AACtC,IAAA,MAAM,UAAU,GAAG,aAAa,EAAE,IAAI,EAAE;AAExC,IAAA,IACE,QAAQ,EAAE,MAAM,KAAK,CAAC;QACtB,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAC9C,QAAA,cAAc,EAAE,WAAW,EAAE,KAAK,SAAS;AAC3C,QAAA,iBAAiB,EAAE,WAAW,EAAE,KAAK,YAAY;AACjD,QAAA,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;AAChC,QAAA,SAAS,IAAI,CAAC;QACd,CAAC,UAAU,EACX;AACA,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC;AAClD,IAAA,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC;AAC7B,IAAA,MAAM,CAAC,iBAAiB,GAAG,UAAU;IAErC,OAAO;AACL,QAAA,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;QACtC;KACD;AACH;AAEA;;;;AAIG;AACG,SAAU,qBAAqB,CACnC,GAAiB,EAAA;AAEjB,IAAA,IAAI,SAAc;AAElB,IAAA,IAAI;AACF,QAAA,SAAS,GAAG,OAAO,GAAG,KAAK;AACzB,cAAE,IAAI,GAAG,CAAC,GAAG,EAAE,iCAAiC;cAC9C,GAAG;IACT;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,QAAQ,GAAG,SAAS,CAAC;SACxB,KAAK,CAAC,GAAG;SACT,MAAM,CAAC,OAAO;SACd,GAAG,CAAC,iBAAiB,CAAC;AAEzB,IAAA,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;AACvB,QAAA,OAAO,SAAS;IAClB;IAEA,MAAM,YAAY,GAA2B,EAAE;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,YAAY,EAAE;;AAEjD,QAAA,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;AACnC,YAAA,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK;QAC3B;IACF;AAEA,IAAA,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC;AAC7D;AAEA,SAAS,iBAAiB,CAAC,OAAe,EAAA;AACxC,IAAA,IAAI;AACF,QAAA,OAAO,kBAAkB,CAAC,OAAO,CAAC;IACpC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,OAAO;IAChB;AACF;AAEA,SAAS,qBAAqB,CAC5B,YAAuC,EAAA;IAEvC,MAAM,UAAU,GAA2B,EAAE;AAE7C,IAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;AACvD,QAAA,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;AAC1D,QAAA,IAAI,UAAU,KAAK,SAAS,EAAE;AAC5B,YAAA,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU;QAC9B;IACF;AAEA,IAAA,OAAO,UAAU;AACnB;;;;"}

package/dist/react/index.cjs

@@ -1,10 +1,10 @@
 'use client';
 'use strict';
 
-var useCheckout = require('../chunks/use-checkout-DGP2xazd.cjs');
+var useCheckout = require('../chunks/use-checkout-DPtLgxlA.cjs');
 require('react/jsx-runtime');
 require('react');
-require('../chunks/labels-3zH04p3y.cjs');
+require('../chunks/labels-CnPllzhT.cjs');
 require('@sazito/client-sdk');
 
 

package/dist/react/index.d.cts

@@ -94,6 +94,10 @@ interface CheckoutCredentials {
         id: number;
         identifier: string;
     };
+    payment?: {
+        id: number;
+        identifier: string;
+    };
 }
 interface CheckoutConfig {
     locale?: CheckoutLocale;
@@ -101,7 +105,11 @@ interface CheckoutConfig {
     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;

package/dist/react/index.d.ts

@@ -94,6 +94,10 @@ interface CheckoutCredentials {
         id: number;
         identifier: string;
     };
+    payment?: {
+        id: number;
+        identifier: string;
+    };
 }
 interface CheckoutConfig {
     locale?: CheckoutLocale;
@@ -101,7 +105,11 @@ interface CheckoutConfig {
     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;

package/dist/react/index.js

@@ -1,7 +1,7 @@
 'use client';
-export { C as CheckoutProvider, S as SazitoProvider, u as useCheckout, a as useCheckoutEngine, b as useSazitoClient } from '../chunks/use-checkout-Bh4tXxFJ.js';
+export { C as CheckoutProvider, S as SazitoProvider, u as useCheckout, a as useCheckoutEngine, b as useSazitoClient } from '../chunks/use-checkout-BM810__v.js';
 import 'react/jsx-runtime';
 import 'react';
-import '../chunks/labels-BdxqgReM.js';
+import '../chunks/labels-e8w4zRbg.js';
 import '@sazito/client-sdk';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sazito/checkout",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Headless checkout engine + React UI for the Sazito platform, powered by @sazito/client-sdk",
   "license": "MIT",
   "repository": {
@@ -56,6 +56,17 @@
       },
       "default": "./dist/next/index.js"
     },
+    "./next/payment-return": {
+      "import": {
+        "types": "./dist/next/payment-return.d.ts",
+        "default": "./dist/next/payment-return.js"
+      },
+      "require": {
+        "types": "./dist/next/payment-return.d.cts",
+        "default": "./dist/next/payment-return.cjs"
+      },
+      "default": "./dist/next/payment-return.js"
+    },
     "./styles.css": "./dist/styles.css"
   },
   "typesVersions": {
@@ -68,6 +79,9 @@
       ],
       "next": [
         "dist/next/index.d.ts"
+      ],
+      "next/payment-return": [
+        "dist/next/payment-return.d.ts"
       ]
     }
   },