@boelabs/billete-sdk 4.3.0 → 5.0.0

package/README.md

@@ -18,7 +18,8 @@ servidor y tu frontend.
 
 - **Tipado de punta a punta:** cada recurso, entrada y evento tiene su tipo.
 - **Sin dependencias:** solo `fetch` y Web Crypto; funciona en Node.js 20+, Bun, Deno y
-  runtimes edge (Cloudflare Workers, Vercel).
+  runtimes edge (Cloudflare Workers, Vercel). El cliente de navegador también funciona en React
+  Native y Expo.
 - **Seguro ante reintentos:** cada mutación lleva una clave de idempotencia, así un reintento
   nunca cobra dos veces.
 
@@ -62,7 +63,7 @@ Crea una clave secreta en el dashboard (**Desarrolladores → Claves API**) y gu
 ```ts
 import { createBillete } from "@boelabs/billete-sdk";
 
-const billete = createBillete({ apiVersion: "2026-10-10", environment: "test" });
+const billete = createBillete({ apiVersion: "2026-10-16", environment: "test" });
 
 const checkout = await billete.checkouts.create({
   plan: "plan_…",
@@ -90,7 +91,7 @@ solicite expresamente. En carritos, solo ofrece los demás métodos que todos lo
 
 ```ts
 const billete = createBillete({
-  apiVersion: "2026-10-10",
+  apiVersion: "2026-10-16",
   environment: "production",
   apiKey: process.env.BILLETE_API_KEY,
   timeoutMs: 30_000,
@@ -222,7 +223,7 @@ try {
 | Propiedad | Descripción |
 | --- | --- |
 | `type` | Categoría: `invalid_request`, `authentication`, `permission`, `not_found`, `conflict`, `validation`, `rate_limit`, `provider`, `internal` o `network`. |
-| `code` | Código estable, apto para decidir en tu código. |
+| `code` | Código estable, apto para decidir en tu código: uno del [catálogo](https://billete.run/docs/api/errors#catálogo-de-códigos) (`BilleteErrorCode`), o `network_error` / `invalid_response` del SDK. |
 | `message` | Descripción legible del error. |
 | `status` | Código HTTP (`0` si no hubo respuesta). |
 | `param` | Campo que causó el error, cuando aplica. |
@@ -230,7 +231,7 @@ try {
 
 ## Idempotencia y reintentos
 
-Cada mutación envía una `Idempotency-Key` generada automáticamente, que se mantiene entre
+Cada mutación del cliente de servidor envía una `Idempotency-Key` generada automáticamente, que se mantiene entre
 reintentos. Si quieres que un reintento tuyo (por ejemplo, de un job) también sea seguro, pasa
 una clave estable:
 
@@ -256,7 +257,7 @@ return { token: session.token };
 // Navegador
 import { createClient } from "@boelabs/billete-sdk/client";
 
-const billete = createClient({ apiVersion: "2026-10-10", customerSession: token });
+const billete = createClient({ apiVersion: "2026-10-16", customerSession: token });
 
 const { data: subscriptions } = await billete.customer.subscriptions();
 const tokens = await billete.customer.feature("tokens");
@@ -275,6 +276,19 @@ const portal = await billete.portalSessions.create({
 `customerSession` también acepta una función, útil cuando el token se renueva. Sin sesión, el
 cliente puede leer y pagar checkouts, cobros y links de pago, y consultar tasas y monedas.
 
+El cliente de navegador solo necesita `fetch`, `AbortController` y `setTimeout`, así que funciona
+igual en React Native y Expo, sin polyfills. No envía `Idempotency-Key`: cada mutación de
+`/v1/client` ya rechaza su repetición por el estado de lo que cambia (un checkout con un pago en
+curso responde `payment_in_progress`), así que reintentar es seguro.
+
+Para saber cuándo se confirma un pago, espera el siguiente cambio en vez de consultar en bucle:
+`waitForChange` responde en cuanto el checkout cambia, o el mismo checkout si en 25 segundos no
+pasó nada.
+
+```ts
+const next = await billete.checkouts.waitForChange(checkout);
+```
+
 ## Webhooks
 
 Billete firma los webhooks con [Standard Webhooks](https://www.standardwebhooks.com). Verifica la

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { $ as ProductLinkCreate, A as EventSelector, At as API_VERSION_PATTERN, B as PaymentLinkCreate, Bt as isApiVersionRetired, C as CustomFieldInput, Ct as PublicFulfillment, D as CustomerMemberUpdate, Dt as PublicPortal, E as CustomerMemberCreate, Et as PublicPaymentState, F as FulfillmentInput, Ft as LatestApiVersion, G as PlanFeaturesInput, H as PlanCheckoutCreate, I as FulfillmentTrackingInput, It as apiVersionLifecycle, J as PlanUpdate, K as PlanLinkCreate, L as InvoiceCreate, Lt as apiVersionStage, M as FeatureOperationCommit, Mt as ApiVersionLifecycle, N as FeatureOperationCreate, Nt as ApiVersionStage, O as CustomerSessionCreate, Ot as API_VERSIONS, P as FeatureUpdate, Pt as LATEST_API_VERSION, Q as ProductCreate, R as InvoiceLineInput, Rt as currentApiVersion, S as CouponUpdate, St as PublicClaimSummary, T as CustomerInput, Tt as PublicPaymentLink, U as PlanCouponCreate, V as PaymentLinkUpdate, Vt as supportedApiVersions, W as PlanCreate, X as ProductCheckoutCreate, Y as PortalSessionCreate, Z as ProductCouponCreate, _ as ClientSubscriptionCancel, _t as PaymentNextAction, a as CheckoutCreate, at as SubscriptionChangePreviewInput, b as CollectInput, bt as PublicCheckout, c as ClaimRespond, ct as VariantInput, d as ClientClaimCreate, dt as CustomerSubscription, et as ProductUpdate, f as ClientCustomerClaimCreate, ft as CustomerSubscriptionChangeResult, g as ClientPaymentCode, gt as PaymentMethodOption, h as ClientLinkCheckout, ht as PaymentMethodField, i as AfterCompletionInput, it as SubscriptionChangeCreate, j as FeatureCreate, jt as ApiVersion, k as CustomerUpdate, kt as API_VERSION_HEADER, l as ClientCheckoutPay, lt as WebhookEndpointCreate, m as ClientInvoicePay, mt as PaymentInstructions, n as RequestOptions, nt as RetireInput, o as CheckoutItemInput, ot as SubscriptionCreate, p as ClientFulfillmentProblem, pt as FulfillmentOption, q as PlanPriceInput, r as TransportOptions, rt as SubscriptionCancel, s as ClaimResolve, st as SubscriptionUpdate, t as BilleteError, tt as RefundCreate, u as ClientCheckoutUpdate, ut as WebhookEndpointUpdate, v as ClientSubscriptionSeats, vt as PaymentTestScenario, w as CustomerCreate, wt as PublicInvoice, x as CouponCreate, xt as PublicClaim, y as ClientSubscriptionUpdate, yt as PortalFeatures, z as KEY_PATTERN, zt as isApiVersion } from "./errors-DCiynKkL.js";
-import { $ as FulfillmentStatus, $t as ACCOUNT_NUMBER_LENGTH, A as Coupon, At as Retirement, B as ExchangeRate, Bt as SubscriptionStatus, C as CheckoutPurpose, Cn as nationalPhone, Ct as Product, D as ClaimReason, Dn as tokenEnvironment, Dt as RISK_LEVELS, E as ClaimOutcome, En as TokenKind, Et as RESET_FREQUENCIES, F as CustomerFeature, Ft as Subscription, G as FeatureOperation, Gt as ReceiptReference, H as FULFILLMENT_METHODS, Ht as USAGE_FEATURE_TYPES, I as CustomerMember, It as SubscriptionChange, J as FeatureType, Jt as ApiErrorBody, K as FeatureOperationResult, Kt as ReceiptSend, L as CustomerMemberList, Lt as SubscriptionChangePreview, M as CustomField, Mt as SUBMIT_LABELS, N as Customer, Nt as SUBSCRIPTION_STATUSES, O as ClaimStatus, On as tokenPrefix, Ot as Refund, P as CustomerDetails, Pt as SubmitLabel, Q as FulfillmentMethod, Qt as PaymentFailureCode, R as CustomerSession, Rt as SubscriptionChangeResult, S as CheckoutItem, Sn as isMobilePhone, St as PortalSession, T as ClaimMessage, Tn as Environment, Tt as ProductVariant, U as FULFILLMENT_STATUSES, Ut as WebhookEndpoint, V as FEATURE_TYPES, Vt as SubscriptionTerms, W as Feature, Wt as Weekday, X as Fulfillment, Xt as ApiErrorType, Y as FeatureUsageResult, Yt as ApiErrorEnvelope, Z as FulfillmentChoice, Zt as PAYMENT_FAILURE_CODES, _ as CLAIM_STATUSES, _n as TaxBehavior, _t as Payout, a as WEBHOOK_TEST_EVENT, an as CURRENCIES, at as InvoiceStatus, b as CarrierOffice, bn as findBank, bt as PlanPrice, c as AfterCompletion, cn as GracePeriodDays, ct as PAYMENT_STATUSES, d as CANCELLATION_FEEDBACK, dn as ListSort, dt as PaymentAttempt, en as Address, et as FulfillmentTracking, f as CARRIERS, fn as MAX_QUANTITY, ft as PaymentFailure, g as CLAIM_REASONS, gn as TAX_BEHAVIORS, gt as PaymentStatus, h as CLAIM_OUTCOMES, hn as MobilePrefix, ht as PaymentSettlement, i as SubscribableEventType, in as BillingMonths, it as InvoiceReason, j as CurrencyAvailability, jt as RiskLevel, k as CollectSettings, kt as ResetFrequency, l as Balance, ln as List, lt as PRODUCT_CATEGORIES, m as CHECKOUT_PURPOSES, mn as Metadata, mt as PaymentLink, n as EventDataMap, nn as BILLING_MONTHS, nt as INVOICE_STATUSES, o as WebhookEvent, on as Currency, ot as LineItem, p as CARRIER_TEST_SCENARIOS, pn as MOBILE_PREFIXES, pt as PaymentFeeDetails, q as FeatureReset, qt as API_ERROR_TYPES, r as EventType, rn as BankCode, rt as Invoice, s as Actor, sn as GRACE_PERIOD_DAYS, st as MAX_SEATS, t as EVENT_TYPES, tn as AddressInput, tt as INVOICE_REASONS, u as BalanceAmount, un as ListQuery, ut as Payment, v as CancellationFeedback, vn as Timestamp, vt as Plan, w as Claim, wn as ENVIRONMENTS, wt as ProductCategory, x as Checkout, xn as isLandlinePhone, xt as PlanSeats, y as Carrier, yn as VENEZUELAN_BANKS, yt as PlanFeatureValues, z as Event, zt as SubscriptionRenewal } from "./events-CaNwG-EX.js";
+import { $ as ProductCheckoutCreate, A as CustomerUpdate, At as PublicPaymentState, B as InvoiceCreate, Bt as apiVersionLifecycle, C as CouponUpdate, Ct as PublicCheckout, D as CustomerMemberCreate, Dt as PublicFulfillment, E as CustomerInput, Et as PublicClaimSummary, F as FeatureUpdate, Ft as ApiVersion, G as PlanCheckoutCreate, Gt as supportedApiVersions, H as KEY_PATTERN, Ht as currentApiVersion, I as FulfillmentDeliverInput, It as ApiVersionLifecycle, J as PlanFeaturesInput, K as PlanCouponCreate, L as FulfillmentHandoverInput, Lt as ApiVersionStage, M as FeatureCreate, Mt as API_VERSIONS, N as FeatureOperationCommit, Nt as API_VERSION_HEADER, O as CustomerMemberUpdate, Ot as PublicInvoice, P as FeatureOperationCreate, Pt as API_VERSION_PATTERN, Q as PortalSessionCreate, R as FulfillmentInput, Rt as LATEST_API_VERSION, S as CouponCreate, St as PortalFeatures, T as CustomerCreate, Tt as PublicClaim, U as PaymentLinkCreate, Ut as isApiVersion, V as InvoiceLineInput, Vt as apiVersionStage, W as PaymentLinkUpdate, Wt as isApiVersionRetired, X as PlanPriceInput, Y as PlanLinkCreate, Z as PlanUpdate, _ as ClientPaymentCode, _t as PaymentInstructions, a as AfterCompletionInput, at as RetireInput, b as ClientSubscriptionUpdate, bt as PaymentNextAction, c as ClaimResolve, ct as SubscriptionChangePreviewInput, d as ClientCheckoutUpdate, dt as VariantInput, et as ProductCouponCreate, f as ClientClaimCreate, ft as WebhookEndpointCreate, g as ClientLinkCheckout, gt as FulfillmentOption, h as ClientInvoicePay, ht as CustomerSubscriptionChangeResult, i as TransportOptions, it as RefundCreate, j as EventSelector, jt as PublicPortal, k as CustomerSessionCreate, kt as PublicPaymentLink, l as ClaimRespond, lt as SubscriptionCreate, m as ClientFulfillmentProblem, mt as CustomerSubscription, n as BilleteErrorCode, nt as ProductLinkCreate, o as CheckoutCreate, ot as SubscriptionCancel, p as ClientCustomerClaimCreate, pt as WebhookEndpointUpdate, q as PlanCreate, r as RequestOptions, rt as ProductUpdate, s as CheckoutItemInput, st as SubscriptionChangeCreate, t as BilleteError, tt as ProductCreate, u as ClientCheckoutPay, ut as SubscriptionUpdate, v as ClientSubscriptionCancel, vt as PaymentMethodField, w as CustomFieldInput, wt as PublicCheckoutItem, x as CollectInput, xt as PaymentTestScenario, y as ClientSubscriptionSeats, yt as PaymentMethodOption, z as FulfillmentTrackingInput, zt as LatestApiVersion } from "./errors-CGHiFrlh.js";
+import { $ as FulfillmentMethod, $t as PaymentFailureCode, A as Coupon, An as tokenEnvironment, At as ResetFrequency, B as ExchangeRate, Bt as SubscriptionRenewal, C as CheckoutPurpose, Cn as findBank, Ct as PortalSession, D as ClaimReason, Dn as ENVIRONMENTS, Dt as RESET_FREQUENCIES, E as ClaimOutcome, En as nationalPhone, Et as ProductVariant, F as CustomerFeature, Ft as SubmitLabel, G as FeatureOperation, Gt as Weekday, H as FULFILLMENT_METHODS, Ht as SubscriptionTerms, I as CustomerMember, It as Subscription, J as FeatureType, Jt as API_ERROR_TYPES, K as FeatureOperationResult, Kt as ReceiptReference, L as CustomerMemberList, Lt as SubscriptionChange, M as CustomField, Mt as RiskLevel, N as Customer, Nt as SUBMIT_LABELS, O as ClaimStatus, On as Environment, Ot as RISK_LEVELS, P as CustomerDetails, Pt as SUBSCRIPTION_STATUSES, Q as FulfillmentHandover, Qt as PAYMENT_FAILURE_CODES, R as CustomerSession, Rt as SubscriptionChangePreview, S as CheckoutItem, Sn as VENEZUELAN_BANKS, St as PlanSeats, T as ClaimMessage, Tn as isMobilePhone, Tt as ProductCategory, U as FULFILLMENT_STATUSES, Ut as USAGE_FEATURE_TYPES, V as FEATURE_TYPES, Vt as SubscriptionStatus, W as Feature, Wt as WebhookEndpoint, X as Fulfillment, Xt as ApiErrorEnvelope, Y as FeatureUsageResult, Yt as ApiErrorBody, Z as FulfillmentChoice, Zt as ApiErrorType, _ as CLAIM_STATUSES, _n as Metadata, _t as PaymentStatus, a as WEBHOOK_TEST_EVENT, an as BILLING_MONTHS, at as InvoiceReason, b as CarrierOffice, bn as TaxBehavior, bt as PlanFeatureValues, c as AfterCompletion, cn as CURRENCIES, ct as MAX_SEATS, d as CANCELLATION_FEEDBACK, dn as GracePeriodDays, dt as Payment, en as API_ERROR_CODES, et as FulfillmentStatus, f as CARRIERS, fn as List, ft as PaymentAttempt, g as CLAIM_REASONS, gn as MOBILE_PREFIXES, gt as PaymentSettlement, h as CLAIM_OUTCOMES, hn as MAX_QUANTITY, ht as PaymentLink, i as SubscribableEventType, in as AddressInput, it as Invoice, j as CurrencyAvailability, jn as tokenPrefix, jt as Retirement, k as CollectSettings, kn as TokenKind, kt as Refund, l as Balance, ln as Currency, lt as PAYMENT_STATUSES, m as CHECKOUT_PURPOSES, mn as ListSort, mt as PaymentFeeDetails, n as EventDataMap, nn as ACCOUNT_NUMBER_LENGTH, nt as INVOICE_REASONS, o as WebhookEvent, on as BankCode, ot as InvoiceStatus, p as CARRIER_TEST_SCENARIOS, pn as ListQuery, pt as PaymentFailure, q as FeatureReset, qt as ReceiptSend, r as EventType, rn as Address, rt as INVOICE_STATUSES, s as Actor, sn as BillingMonths, st as LineItem, t as EVENT_TYPES, tn as ApiErrorCode, tt as FulfillmentTracking, u as BalanceAmount, un as GRACE_PERIOD_DAYS, ut as PRODUCT_CATEGORIES, v as CancellationFeedback, vn as MobilePrefix, vt as Payout, w as Claim, wn as isLandlinePhone, wt as Product, x as Checkout, xn as Timestamp, xt as PlanPrice, y as Carrier, yn as TAX_BEHAVIORS, yt as Plan, z as Event, zt as SubscriptionChangeResult } from "./events-D09DIgn-.js";
 //#region src/create-client.d.ts
 interface ClientOptions extends TransportOptions {
   /**
@@ -14,7 +14,7 @@ interface ClientOptions extends TransportOptions {
  * and customer data requires a short-lived customer session minted by your server.
  *
  * ```ts
- * const billete = createClient({ apiVersion: "2026-10-10", customerSession: token });
+ * const billete = createClient({ apiVersion: "2026-10-16", customerSession: token });
  * const [subscription] = (await billete.customer.subscriptions()).data;
  * if (subscription?.renewal?.status === "overdue") showBanner(subscription.renewal);
  * ```
@@ -35,6 +35,9 @@ export declare function createClient(options: ClientOptions): {
     /** Goes back before authorizing: the payment fails as `canceled` and can be paid again. */
     cancelPayment: (id: string, options?: RequestOptions) => Promise<PublicCheckout>;
     retrieve: (id: string, options?: RequestOptions) => Promise<PublicCheckout>;
+    waitForChange: (current: PublicCheckout, options?: RequestOptions & {
+      waitSeconds?: number;
+    }) => Promise<PublicCheckout>;
     /** Changes quantity, variant, billing cycle or coupon on a payment link checkout. */
     update: (id: string, changes: ClientCheckoutUpdate, options?: RequestOptions) => Promise<PublicCheckout>;
     /** Methods that can pay this checkout, with the converted amount and transfer details. */
@@ -56,6 +59,9 @@ export declare function createClient(options: ClientOptions): {
     /** Goes back before authorizing: the payment fails as `canceled` and can be paid again. */
     cancelPayment: (id: string, options?: RequestOptions) => Promise<PublicInvoice>;
     retrieve: (id: string, options?: RequestOptions) => Promise<PublicInvoice>;
+    waitForChange: (current: PublicInvoice, options?: RequestOptions & {
+      waitSeconds?: number;
+    }) => Promise<PublicInvoice>;
     /** Methods that can pay this Cobro, with the converted amount and transfer details. */
     paymentMethods: (id: string, options?: RequestOptions) => Promise<List<PaymentMethodOption>>;
     /** Submits the payment; the returned Cobro carries the payment status and any failure. */
@@ -128,4 +134,4 @@ export declare function createClient(options: ClientOptions): {
 };
 type BilleteClient = ReturnType<typeof createClient>;
 //#endregion
-export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type BilleteClient, BilleteError, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CLAIM_OUTCOMES, type CLAIM_REASONS, type CLAIM_STATUSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type Claim, type ClaimMessage, type ClaimOutcome, type ClaimReason, type ClaimResolve, type ClaimRespond, type ClaimStatus, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientClaimCreate, type ClientCustomerClaimCreate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientOptions, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentFeeDetails, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type PublicClaim, type PublicClaimSummary, type PublicFulfillment, type PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type Refund, type RefundCreate, type RequestOptions, type ResetFrequency, type RetireInput, type Retirement, type RiskLevel, type SUBMIT_LABELS, type SUBSCRIPTION_STATUSES, type SubmitLabel, type SubscribableEventType, type Subscription, type SubscriptionCancel, type SubscriptionChange, type SubscriptionChangeCreate, type SubscriptionChangePreview, type SubscriptionChangePreviewInput, type SubscriptionChangeResult, type SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, type SubscriptionTerms, type SubscriptionUpdate, type TAX_BEHAVIORS, type TaxBehavior, type Timestamp, type TokenKind, type USAGE_FEATURE_TYPES, type VENEZUELAN_BANKS, type VariantInput, type WEBHOOK_TEST_EVENT, type WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, type Weekday, type apiVersionLifecycle, type apiVersionStage, type currentApiVersion, type findBank, type isApiVersion, type isApiVersionRetired, type isLandlinePhone, type isMobilePhone, type nationalPhone, type supportedApiVersions, type tokenEnvironment, type tokenPrefix };
+export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_CODES, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorCode, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type BilleteClient, BilleteError, type BilleteErrorCode, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CLAIM_OUTCOMES, type CLAIM_REASONS, type CLAIM_STATUSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type Claim, type ClaimMessage, type ClaimOutcome, type ClaimReason, type ClaimResolve, type ClaimRespond, type ClaimStatus, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientClaimCreate, type ClientCustomerClaimCreate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientOptions, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentDeliverInput, type FulfillmentHandover, type FulfillmentHandoverInput, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentFeeDetails, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type PublicCheckoutItem, type PublicClaim, type PublicClaimSummary, type PublicFulfillment, type PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type Refund, type RefundCreate, type RequestOptions, type ResetFrequency, type RetireInput, type Retirement, type RiskLevel, type SUBMIT_LABELS, type SUBSCRIPTION_STATUSES, type SubmitLabel, type SubscribableEventType, type Subscription, type SubscriptionCancel, type SubscriptionChange, type SubscriptionChangeCreate, type SubscriptionChangePreview, type SubscriptionChangePreviewInput, type SubscriptionChangeResult, type SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, type SubscriptionTerms, type SubscriptionUpdate, type TAX_BEHAVIORS, type TaxBehavior, type Timestamp, type TokenKind, type USAGE_FEATURE_TYPES, type VENEZUELAN_BANKS, type VariantInput, type WEBHOOK_TEST_EVENT, type WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, type Weekday, type apiVersionLifecycle, type apiVersionStage, type currentApiVersion, type findBank, type isApiVersion, type isApiVersionRetired, type isLandlinePhone, type isMobilePhone, type nationalPhone, type supportedApiVersions, type tokenEnvironment, type tokenPrefix };

package/dist/client.js

@@ -1,4 +1,4 @@
-import { n as segment, r as BilleteError, t as createTransport } from "./http-BfxFFQqw.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-D5FMIjK4.js";
 //#region src/create-client.ts
 /**
 * Browser client. It never holds a secret key: checkouts and Cobros are addressed by their
@@ -6,7 +6,7 @@ import { n as segment, r as BilleteError, t as createTransport } from "./http-Bf
 * and customer data requires a short-lived customer session minted by your server.
 *
 * ```ts
-* const billete = createClient({ apiVersion: "2026-10-10", customerSession: token });
+* const billete = createClient({ apiVersion: "2026-10-16", customerSession: token });
 * const [subscription] = (await billete.customer.subscriptions()).data;
 * if (subscription?.renewal?.status === "overdue") showBanner(subscription.renewal);
 * ```
@@ -18,6 +18,22 @@ function createClient(options) {
 		token: typeof session === "function" ? session : () => session
 	});
 	const checkoutPath = (id) => `/v1/client/checkouts/${segment(id)}`;
+	/** Under the transport's timeout, so a wait ends before the request gives up. */
+	const longestWait = Math.max(0, Math.min(25, Math.floor((options.timeoutMs ?? 3e4) / 1e3) - 5));
+	/**
+	* Waits until a checkout or Cobro changes (its `revision`), up to `waitSeconds` (25 at most), and
+	* answers it changed, or the same one when nothing happened meanwhile: call it in a loop while
+	* the payment is pending instead of retrieving it every few seconds.
+	*/
+	const waitForChange = (path) => async (current, options) => await http.request({
+		method: "GET",
+		path: path(current.id),
+		headers: {
+			"If-None-Match": `"${current.revision}"`,
+			Prefer: `wait=${Math.min(options?.waitSeconds ?? longestWait, longestWait)}`
+		},
+		options
+	}) ?? current;
 	/** A pending payment that waits for a code the payer received (`nextAction.type === "code"`). */
 	const paymentCode = (path) => ({
 		/** Authorizes the payment with the code; a wrong one fails with `payment_code_invalid`. */
@@ -73,6 +89,7 @@ function createClient(options) {
 				path: checkoutPath(id),
 				options
 			}),
+			waitForChange: waitForChange(checkoutPath),
 			/** Changes quantity, variant, billing cycle or coupon on a payment link checkout. */
 			update: (id, changes, options) => http.request({
 				method: "PATCH",
@@ -102,6 +119,7 @@ function createClient(options) {
 				path: invoicePath(id),
 				options
 			}),
+			waitForChange: waitForChange(invoicePath),
 			/** Methods that can pay this Cobro, with the converted amount and transfer details. */
 			paymentMethods: (id, options) => http.request({
 				method: "GET",

package/dist/{errors-DCiynKkL.d.ts → errors-CGHiFrlh.d.ts}

@@ -1,4 +1,4 @@
-import { $ as FulfillmentStatus, C as CheckoutPurpose, D as ClaimReason, E as ClaimOutcome, Ft as Subscription, Gt as ReceiptReference, Jt as ApiErrorBody, M as CustomField, O as ClaimStatus, Ot as Refund, P as CustomerDetails, Pt as SubmitLabel, Q as FulfillmentMethod, S as CheckoutItem, T as ClaimMessage, Tn as Environment, X as Fulfillment, Xt as ApiErrorType, _n as TaxBehavior, at as InvoiceStatus, b as CarrierOffice, bt as PlanPrice, c as AfterCompletion, cn as GracePeriodDays, en as Address, et as FulfillmentTracking, ft as PaymentFailure, gt as PaymentStatus, i as SubscribableEventType, in as BillingMonths, it as InvoiceReason, k as CollectSettings, mn as Metadata, on as Currency, ot as LineItem, q as FeatureReset, tn as AddressInput, v as CancellationFeedback, vn as Timestamp, wt as ProductCategory, xt as PlanSeats, y as Carrier } from "./events-CaNwG-EX.js";
+import { $ as FulfillmentMethod, $t as PaymentFailureCode, C as CheckoutPurpose, D as ClaimReason, E as ClaimOutcome, Ft as SubmitLabel, It as Subscription, Kt as ReceiptReference, M as CustomField, O as ClaimStatus, On as Environment, P as CustomerDetails, S as CheckoutItem, St as PlanSeats, T as ClaimMessage, Tt as ProductCategory, X as Fulfillment, Yt as ApiErrorBody, Zt as ApiErrorType, _n as Metadata, _t as PaymentStatus, at as InvoiceReason, b as CarrierOffice, bn as TaxBehavior, c as AfterCompletion, dn as GracePeriodDays, et as FulfillmentStatus, i as SubscribableEventType, in as AddressInput, k as CollectSettings, kt as Refund, ln as Currency, ot as InvoiceStatus, pt as PaymentFailure, q as FeatureReset, rn as Address, sn as BillingMonths, st as LineItem, tn as ApiErrorCode, tt as FulfillmentTracking, v as CancellationFeedback, xn as Timestamp, xt as PlanPrice, y as Carrier } from "./events-D09DIgn-.js";
 //#region ../contracts/src/api-versions.d.ts
 /**
  * Billete API versions. Kept free of runtime dependencies: the dashboard, the API, the worker and
@@ -10,7 +10,7 @@ import { $ as FulfillmentStatus, C as CheckoutPurpose, D as ClaimReason, E as Cl
  * that is still supported.
  */
 /** Every version ever published, oldest first. Append only: retired versions stay listed. */
-declare const API_VERSIONS: readonly ["2026-10-07.beta", "2026-10-08", "2026-10-09", "2026-10-10"];
+declare const API_VERSIONS: readonly ["2026-10-07.beta", "2026-10-08", "2026-10-09", "2026-10-10", "2026-10-16"];
 type ApiVersion = (typeof API_VERSIONS)[number];
 type LatestApiVersion = typeof API_VERSIONS extends readonly [...unknown[], infer Last] ? Last : never;
 /** The version the code speaks: responses are built in its shape. Always the last entry. */
@@ -154,6 +154,13 @@ interface PublicInvoice {
   paidAt: Timestamp | null;
   createdAt: Timestamp;
   payment: PublicPaymentState | null;
+  /** Changes whenever the Cobro does: send it to wait for the next change (`waitForChange`). */
+  revision: string;
+}
+/** What a checkout sells, with the business's own name for it. */
+interface PublicCheckoutItem extends CheckoutItem {
+  /** The `lookupKey` of the plan or product, as it is now; `null` when it has none. */
+  lookupKey: string | null;
 }
 /** Browser-safe view of a checkout: everything needed to render and pay it, nothing internal. */
 interface PublicCheckout {
@@ -171,6 +178,8 @@ interface PublicCheckout {
   id: string;
   object: "checkout";
   environment: Environment;
+  /** The checkout's hosted page: where to send the customer to pay it there instead. */
+  url: string;
   status: "open" | "completed" | "expired";
   purpose: CheckoutPurpose;
   merchant: {
@@ -179,7 +188,7 @@ interface PublicCheckout {
     supportPhone: string | null;
   };
   email: string | null;
-  items: CheckoutItem[];
+  items: PublicCheckoutItem[];
   currency: Currency;
   subtotal: number;
   discount: number;
@@ -229,6 +238,8 @@ interface PublicCheckout {
   cancelUrl: string | null;
   expiresAt: Timestamp;
   payment: PublicPaymentState | null;
+  /** Changes whenever the checkout does: send it to wait for the next change (`waitForChange`). */
+  revision: string;
 }
 /** A way to receive a purchase that the business offers, as its checkout shows it. */
 interface FulfillmentOption {
@@ -270,7 +281,14 @@ interface PublicFulfillment {
   currency: Currency;
   total: number;
   paidAt: Timestamp;
+  /**
+   * What the QR the customer shows when receiving it encodes: the address where the business,
+   * signed in, finds the order and hands it over. Only while the business has not handed it over,
+   * and never for a shipment, which the carrier hands over.
+   */
+  handoverUrl: string | null;
   deliveredAt: Timestamp | null;
+  handover: Fulfillment["handover"];
   confirmBy: Timestamp | null;
   receivedAt: Timestamp | null;
   problem: {
@@ -358,13 +376,27 @@ interface PaymentInstructions {
   qrImage: string | null;
   notes: string | null;
 }
-/** Deterministic inputs that trigger each outcome in the test environment. */
+/**
+ * What to send, step by step, for a known result in the test environment: `fields` go in `pay`
+ * and, for a method that asks for a code after paying (`verification`), `code` goes in
+ * `submitPaymentCode`.
+ */
 interface PaymentTestScenario {
-  outcome: "succeeded" | "failed" | "pending";
   description: string;
+  /** Sent in `pay`; empty for the default scenario. */
   fields: Record<string, string>;
+  /** Sent in `submitPaymentCode`; `null` when the method asks for no code. */
+  code: string | null;
+  /**
+   * How it ends: paid, failed (`failureCode` says why), still waiting for the provider or for
+   * what `nextAction` asks, or the code refused with `payment_code_invalid` while the payment
+   * keeps waiting for another.
+   */
+  outcome: "succeeded" | "failed" | "pending" | "code_invalid";
+  failureCode: PaymentFailureCode | null;
 }
 interface PaymentMethodOption {
+  object: "payment_method";
   id: string;
   name: string;
   description: string | null;
@@ -372,6 +404,12 @@ interface PaymentMethodOption {
   amount: number;
   currency: Currency;
   exchangeRate: string | null;
+  /**
+   * Until when `amount` holds at `exchangeRate`: the rate is frozen for the payer for 30 minutes.
+   * Listing the methods after that quotes them again. `null` when the method charges the price's
+   * own currency.
+   */
+  expiresAt: Timestamp | null;
   fields: PaymentMethodField[];
   /** After paying, the payer verifies it in a step of its own (`nextAction.type === "code"`). */
   verification: boolean;
@@ -551,6 +589,8 @@ interface VariantInput {
 }
 interface ProductCreate {
   name: string;
+  /** Public and unique among the business's products: see `Product.lookupKey`. */
+  lookupKey?: string;
   description?: string;
   imageUrl?: string;
   category?: ProductCategory;
@@ -566,6 +606,8 @@ interface ProductCreate {
 }
 interface ProductUpdate {
   name?: string;
+  /** Public and unique among the business's products: see `Product.lookupKey`. */
+  lookupKey?: string | null;
   description?: string | null;
   imageUrl?: string | null;
   category?: ProductCategory;
@@ -627,6 +669,8 @@ interface PlanCreate {
   seats?: PlanSeats;
   fallbackPlanId?: string | null;
   name: string;
+  /** Public and unique among the business's plans: see `Plan.lookupKey`. */
+  lookupKey?: string;
   description?: string;
   currency: Currency;
   prices: PlanPriceInput[];
@@ -641,6 +685,8 @@ interface PlanUpdate {
   seats?: PlanSeats;
   fallbackPlanId?: string | null;
   name?: string;
+  /** Public and unique among the business's plans: see `Plan.lookupKey`. */
+  lookupKey?: string | null;
   description?: string | null;
   /** New prices apply to new subscriptions; existing ones keep the price they signed up with. */
   prices?: PlanPriceInput[];
@@ -873,6 +919,12 @@ interface InvoiceCreate {
 interface ClientInvoicePay {
   method: string;
   fields?: Record<string, string>;
+  /**
+   * The `amount` of the method the payer saw (`paymentMethods`). With a converted price, a
+   * different amount, after the rate they saw expired, is refused with `exchange_rate_changed`
+   * and nothing is charged.
+   */
+  amount?: number;
 }
 /** The code the payer received to authorize a charge (`nextAction.type === "code"`). */
 interface ClientPaymentCode {
@@ -935,6 +987,12 @@ interface ClientCheckoutPay {
   /** Omit only when the checkout total is 0 (free trial, full discount). */
   method?: string;
   fields?: Record<string, string>;
+  /**
+   * The `amount` of the method the payer saw (`paymentMethods`). With a converted price, a
+   * different amount, after the rate they saw expired, is refused with `exchange_rate_changed`
+   * and nothing is charged.
+   */
+  amount?: number;
   email?: string;
   name?: string;
   phone?: string;
@@ -969,6 +1027,18 @@ type FulfillmentInput = {
 interface FulfillmentTrackingInput {
   number: string;
 }
+/**
+ * The code the customer shows when receiving a purchase: the value its QR encodes (an address that
+ * ends in the code) or the code alone.
+ */
+interface FulfillmentHandoverInput {
+  code: string;
+}
+/** Marks a purchase handed over without the customer's code. */
+interface FulfillmentDeliverInput {
+  /** Why it went without the code: "Lo llevó un motorizado", "El cliente no tenía teléfono". */
+  reason?: string;
+}
 /** What went wrong with a purchase the business marked as delivered. */
 interface ClientFulfillmentProblem {
   comment: string;
@@ -1022,22 +1092,33 @@ interface TransportOptions {
   maxRetries?: number;
 }
 interface RequestOptions {
-  /** Reuse to make a mutation safe to retry; generated automatically when omitted. */
+  /**
+   * Server client: reuse to make a mutation safe to retry; generated automatically when omitted.
+   * The browser client sends none: what each of its mutations changes (a checkout's payment, a
+   * code) already refuses a repeat.
+   */
   idempotencyKey?: string;
   signal?: AbortSignal;
 }
 //#endregion
 //#region src/errors.d.ts
+/**
+ * What a failed request says: a code of the API (`API_ERROR_CODES` lists what each means), or the
+ * SDK's own when Billete could not be reached (`network_error`) or answered something unexpected
+ * (`invalid_response`).
+ */
+type BilleteErrorCode = ApiErrorCode | "network_error" | "invalid_response";
 /** Any failed Billete request. `type`/`code` are stable and safe to branch on. */
 declare class BilleteError extends Error {
   readonly type: ApiErrorType | "network";
-  readonly code: string;
+  readonly code: BilleteErrorCode;
   readonly status: number;
   readonly param?: string;
   readonly requestId?: string;
-  constructor(body: Omit<ApiErrorBody, "type"> & {
+  constructor(body: Omit<ApiErrorBody, "type" | "code"> & {
     type: ApiErrorType | "network";
+    code: BilleteErrorCode;
   }, status: number, options?: ErrorOptions);
 }
 //#endregion
-export { ProductLinkCreate as $, EventSelector as A, API_VERSION_PATTERN as At, PaymentLinkCreate as B, isApiVersionRetired as Bt, CustomFieldInput as C, PublicFulfillment as Ct, CustomerMemberUpdate as D, PublicPortal as Dt, CustomerMemberCreate as E, PublicPaymentState as Et, FulfillmentInput as F, LatestApiVersion as Ft, PlanFeaturesInput as G, PlanCheckoutCreate as H, FulfillmentTrackingInput as I, apiVersionLifecycle as It, PlanUpdate as J, PlanLinkCreate as K, InvoiceCreate as L, apiVersionStage as Lt, FeatureOperationCommit as M, ApiVersionLifecycle as Mt, FeatureOperationCreate as N, ApiVersionStage as Nt, CustomerSessionCreate as O, API_VERSIONS as Ot, FeatureUpdate as P, LATEST_API_VERSION as Pt, ProductCreate as Q, InvoiceLineInput as R, currentApiVersion as Rt, CouponUpdate as S, PublicClaimSummary as St, CustomerInput as T, PublicPaymentLink as Tt, PlanCouponCreate as U, PaymentLinkUpdate as V, supportedApiVersions as Vt, PlanCreate as W, ProductCheckoutCreate as X, PortalSessionCreate as Y, ProductCouponCreate as Z, ClientSubscriptionCancel as _, PaymentNextAction as _t, CheckoutCreate as a, SubscriptionChangePreviewInput as at, CollectInput as b, PublicCheckout as bt, ClaimRespond as c, VariantInput as ct, ClientClaimCreate as d, CustomerSubscription as dt, ProductUpdate as et, ClientCustomerClaimCreate as f, CustomerSubscriptionChangeResult as ft, ClientPaymentCode as g, PaymentMethodOption as gt, ClientLinkCheckout as h, PaymentMethodField as ht, AfterCompletionInput as i, SubscriptionChangeCreate as it, FeatureCreate as j, ApiVersion as jt, CustomerUpdate as k, API_VERSION_HEADER as kt, ClientCheckoutPay as l, WebhookEndpointCreate as lt, ClientInvoicePay as m, PaymentInstructions as mt, RequestOptions as n, RetireInput as nt, CheckoutItemInput as o, SubscriptionCreate as ot, ClientFulfillmentProblem as p, FulfillmentOption as pt, PlanPriceInput as q, TransportOptions as r, SubscriptionCancel as rt, ClaimResolve as s, SubscriptionUpdate as st, BilleteError as t, RefundCreate as tt, ClientCheckoutUpdate as u, WebhookEndpointUpdate as ut, ClientSubscriptionSeats as v, PaymentTestScenario as vt, CustomerCreate as w, PublicInvoice as wt, CouponCreate as x, PublicClaim as xt, ClientSubscriptionUpdate as y, PortalFeatures as yt, KEY_PATTERN as z, isApiVersion as zt };
+export { ProductCheckoutCreate as $, CustomerUpdate as A, PublicPaymentState as At, InvoiceCreate as B, apiVersionLifecycle as Bt, CouponUpdate as C, PublicCheckout as Ct, CustomerMemberCreate as D, PublicFulfillment as Dt, CustomerInput as E, PublicClaimSummary as Et, FeatureUpdate as F, ApiVersion as Ft, PlanCheckoutCreate as G, supportedApiVersions as Gt, KEY_PATTERN as H, currentApiVersion as Ht, FulfillmentDeliverInput as I, ApiVersionLifecycle as It, PlanFeaturesInput as J, PlanCouponCreate as K, FulfillmentHandoverInput as L, ApiVersionStage as Lt, FeatureCreate as M, API_VERSIONS as Mt, FeatureOperationCommit as N, API_VERSION_HEADER as Nt, CustomerMemberUpdate as O, PublicInvoice as Ot, FeatureOperationCreate as P, API_VERSION_PATTERN as Pt, PortalSessionCreate as Q, FulfillmentInput as R, LATEST_API_VERSION as Rt, CouponCreate as S, PortalFeatures as St, CustomerCreate as T, PublicClaim as Tt, PaymentLinkCreate as U, isApiVersion as Ut, InvoiceLineInput as V, apiVersionStage as Vt, PaymentLinkUpdate as W, isApiVersionRetired as Wt, PlanPriceInput as X, PlanLinkCreate as Y, PlanUpdate as Z, ClientPaymentCode as _, PaymentInstructions as _t, AfterCompletionInput as a, RetireInput as at, ClientSubscriptionUpdate as b, PaymentNextAction as bt, ClaimResolve as c, SubscriptionChangePreviewInput as ct, ClientCheckoutUpdate as d, VariantInput as dt, ProductCouponCreate as et, ClientClaimCreate as f, WebhookEndpointCreate as ft, ClientLinkCheckout as g, FulfillmentOption as gt, ClientInvoicePay as h, CustomerSubscriptionChangeResult as ht, TransportOptions as i, RefundCreate as it, EventSelector as j, PublicPortal as jt, CustomerSessionCreate as k, PublicPaymentLink as kt, ClaimRespond as l, SubscriptionCreate as lt, ClientFulfillmentProblem as m, CustomerSubscription as mt, BilleteErrorCode as n, ProductLinkCreate as nt, CheckoutCreate as o, SubscriptionCancel as ot, ClientCustomerClaimCreate as p, WebhookEndpointUpdate as pt, PlanCreate as q, RequestOptions as r, ProductUpdate as rt, CheckoutItemInput as s, SubscriptionChangeCreate as st, BilleteError as t, ProductCreate as tt, ClientCheckoutPay as u, SubscriptionUpdate as ut, ClientSubscriptionCancel as v, PaymentMethodField as vt, CustomFieldInput as w, PublicCheckoutItem as wt, CollectInput as x, PaymentTestScenario as xt, ClientSubscriptionSeats as y, PaymentMethodOption as yt, FulfillmentTrackingInput as z, LatestApiVersion as zt };

package/dist/{events-CaNwG-EX.d.ts → events-D09DIgn-.d.ts}

@@ -250,12 +250,231 @@ interface List<T> {
 /** ISO 8601 timestamp in UTC. */
 type Timestamp = string;
 //#endregion
+//#region ../contracts/src/error-codes.d.ts
+/**
+ * Every `code` the API may answer with in `/v1` and `/v1/client`, with what it means. Stable: an
+ * integration may decide on them. A new code is an incompatible change and ships in a new API
+ * version; the dashboard's own codes are not here (`DASHBOARD_ERROR_CODES`).
+ */
+declare const API_ERROR_CODES: {
+  readonly account_not_found: "No existe el negocio.";
+  readonly account_suspended: "Este negocio está suspendido.";
+  readonly address_required: "Falta la dirección que pide el checkout.";
+  readonly amount_required: "El producto sin variantes necesita un precio.";
+  readonly amount_too_large: "El importe total supera el máximo permitido.";
+  readonly api_key_expired: "Esta clave API venció.";
+  readonly api_key_invalid: "La clave API no es válida.";
+  readonly api_key_missing: "Falta la cabecera Authorization con tu clave secreta (Bearer).";
+  readonly api_version_invalid: "Esa versión de la API no existe; usa una versión vigente.";
+  readonly api_version_missing: "Falta la cabecera Billete-Version con la versión de la API de tu integración.";
+  readonly api_version_retired: "Esa versión de la API ya se retiró; elige una vigente.";
+  readonly approval_not_open: "Esta solicitud ya terminó.";
+  readonly approval_not_pending: "Esta solicitud ya no espera una decisión.";
+  readonly approval_own_request: "Otra persona debe aprobar o rechazar tu solicitud; tú puedes cancelarla.";
+  readonly approval_request_not_found: "No existe la solicitud de aprobación.";
+  readonly auto_charge_off: "Esta suscripción no se cobra automáticamente.";
+  readonly billing_cycle_unavailable: "Este ciclo de pago no está disponible.";
+  readonly business_type_required: "Elige primero el tipo de organización.";
+  readonly carrier_office_unavailable: "Esa oficina ya no recibe envíos; elige otra.";
+  readonly checkout_completed: "Este checkout ya fue pagado.";
+  readonly checkout_expired: "Este checkout venció.";
+  readonly checkout_not_editable: "Este checkout no se puede modificar.";
+  readonly checkout_not_found: "No existe el checkout.";
+  readonly checkout_not_open: "Solo se pueden vencer checkouts abiertos.";
+  readonly checkout_selection_locked: "El producto o la variante fue retirado. Puedes completar el pago con la selección actual, pero no modificarla.";
+  readonly claim_already_open: "Ya tienes un reclamo abierto por este pago: síguelo desde el enlace que te enviamos por correo.";
+  readonly claim_closed: "Este reclamo ya está cerrado.";
+  readonly claim_limit_reached: "Ya no puedes abrir más reclamos por este pago: escribe directamente al negocio.";
+  readonly claim_messages_limit: "Este reclamo ya tiene demasiados mensajes: es momento de resolverlo.";
+  readonly claim_not_found: "No existe el reclamo.";
+  readonly coupon_already_used: "Ya usaste este cupón.";
+  readonly coupon_applies_to_required: "Indica si el cupón es para productos o para planes (appliesTo).";
+  readonly coupon_currency_mismatch: "El cupón solo aplica a precios en otra moneda.";
+  readonly coupon_exhausted: "El cupón alcanzó su límite de usos.";
+  readonly coupon_exists: "Ya existe un cupón con ese código.";
+  readonly coupon_expired: "El cupón venció.";
+  readonly coupon_first_purchase_only: "Este cupón es solo para tu primera compra.";
+  readonly coupon_inactive: "El cupón está desactivado.";
+  readonly coupon_minimum_not_met: "El pedido no llega a la compra mínima del cupón.";
+  readonly coupon_not_applicable: "Un cupón no aplica a puestos agregados a mitad del periodo.";
+  readonly coupon_not_found: "No existe el cupón.";
+  readonly coupons_not_allowed: "Este enlace no acepta cupones.";
+  readonly currency_mismatch: "Todos los productos deben usar la misma moneda.";
+  readonly custom_field_invalid: "El valor de un campo personalizado no es válido; `param` dice cuál.";
+  readonly custom_field_required: "Falta un campo personalizado obligatorio; `param` dice cuál.";
+  readonly customer_changed: "El cliente cambió durante la operación; vuelve a intentarlo.";
+  readonly customer_exists: "Ya existe un cliente con este externalId.";
+  readonly customer_not_found: "No existe el cliente.";
+  readonly customer_session_invalid: "La sesión no es válida o venció.";
+  readonly customer_session_missing: "Falta la cabecera Authorization con el token de la sesión del cliente (Bearer).";
+  readonly delivery_proofs_limit: "La entrega ya tiene el máximo de fotos.";
+  readonly email_required: "El correo es obligatorio.";
+  readonly entity_not_applicable: "Elige primero un tipo de organización con RIF propio.";
+  readonly event_not_found: "No existe el evento.";
+  readonly exchange_rate_changed: "La tasa BCV congelada venció y el monto cambió: consulta de nuevo los métodos y muestra el nuevo monto.";
+  readonly exchange_rate_unavailable: "No hay una tasa oficial vigente para ese par de monedas; inténtalo en unos minutos.";
+  readonly fallback_plan_nested: "Un plan usado como respaldo no puede tener otro respaldo.";
+  readonly fallback_plan_not_free: "El respaldo debe ser un plan gratuito activo, en la misma moneda y sin respaldo propio.";
+  readonly feature_exists: "Ya existe una cuota con esa clave.";
+  readonly feature_not_found: "No existe la cuota.";
+  readonly feature_not_metered: "Esa cuota no registra uso: solo las de consumo y de cantidad lo hacen.";
+  readonly feature_operation_not_allowed: "Solo las cuotas de consumo permiten operaciones.";
+  readonly feature_per_not_applicable: "Solo las cuotas de consumo y de cantidad se cuentan por miembro.";
+  readonly feature_release_requires_operation: "Devuelve el consumo mediante su operación original.";
+  readonly feature_reset_not_applicable: "Solo las cuotas de consumo se reinician.";
+  readonly feature_set_not_allowed: "Solo las cuotas de cantidad permiten fijar su uso.";
+  readonly feature_value_invalid: "El valor de una cuota no es válido para su tipo.";
+  readonly file_empty: "El archivo está vacío.";
+  readonly file_not_found: "No existe el archivo.";
+  readonly file_too_large: "Cada archivo puede pesar hasta 10 MB.";
+  readonly file_type_not_allowed: "El tipo de archivo no está permitido.";
+  readonly fulfillment_closed: "Ya no se puede reportar un problema con esta entrega.";
+  readonly fulfillment_method_unavailable: "Este negocio no ofrece esa forma de entrega.";
+  readonly fulfillment_methods_conflict: "Los productos no comparten ninguna forma de entrega.";
+  readonly fulfillment_not_found: "No existe la entrega.";
+  readonly fulfillment_not_offered: "Esta compra no necesita entrega.";
+  readonly fulfillment_not_pending: "Solo puedes marcar como entregada una entrega por entregar.";
+  readonly fulfillment_not_shipping: "Esta entrega no va por agencia.";
+  readonly fulfillment_required: "Elige cómo quieres recibir tu compra.";
+  readonly fulfillment_shipped_by_carrier: "Un envío se entrega en la oficina de la agencia: agrega su número de guía.";
+  readonly handover_code_invalid: "Este código QR no es el de esta compra.";
+  readonly idempotency_conflict: "Repite la solicitud.";
+  readonly idempotency_key_invalid: "Idempotency-Key debe tener entre 8 y 255 caracteres ASCII imprimibles.";
+  readonly idempotency_key_reused: "Este Idempotency-Key ya se usó con una solicitud distinta.";
+  readonly idempotency_request_in_progress: "Todavía estamos procesando una solicitud con este Idempotency-Key.";
+  readonly insufficient_stock: "No hay suficientes unidades disponibles de un producto.";
+  readonly internal_error: "Ocurrió un error interno; inténtalo de nuevo.";
+  readonly invalid_cursor: "El cursor no es válido para este orden.";
+  readonly invalid_default_variant: "Elige una sola variante principal activa.";
+  readonly invalid_json: "El cuerpo debe ser JSON válido.";
+  readonly invalid_payment_details: "Un dato del método de pago no es válido; `param` dice cuál.";
+  readonly invalid_reference: "Uno de los recursos indicados no existe.";
+  readonly invalid_sort: "Esta lista no se puede ordenar así.";
+  readonly invalid_token: "Este enlace no es válido.";
+  readonly inventory_in_use: "Hay unidades retenidas por pagos en verificación; espera a que terminen antes de cambiar su control de stock.";
+  readonly invoice_closed: "Este cobro ya no se puede pagar.";
+  readonly invoice_not_closable: "Solo se pueden marcar como incobrables cobros abiertos sin un pago en verificación.";
+  readonly invoice_not_found: "No existe el cobro.";
+  readonly invoice_not_open: "Solo se reenvían cobros abiertos.";
+  readonly invoice_not_voidable: "Solo se pueden anular cobros abiertos sin un pago en verificación.";
+  readonly invoice_paid: "Este cobro ya fue pagado.";
+  readonly invoice_resend_limit: "Puedes reenviar un cobro hasta cinco veces por hora. Inténtalo más tarde.";
+  readonly lookup_key_in_use: "Ya tienes otro plan o producto con esa clave (lookupKey).";
+  readonly max_redemptions_below_redemptions: "El máximo de usos no puede ser menor que los usos que ya tiene el cupón.";
+  readonly member_not_found: "No existe el miembro.";
+  readonly member_over_limit: "Este miembro supera los puestos del plan.";
+  readonly member_recently_changed: "Quien se une al negocio o cambia de rol espera 48 horas para las acciones sensibles.";
+  readonly member_removed: "Este miembro fue quitado.";
+  readonly member_required: "Indica el miembro para consultar esta cuota.";
+  readonly method_required: "Elige un método de pago.";
+  readonly name_required: "Nombre: este campo es obligatorio.";
+  readonly notification_not_found: "No existe la notificación.";
+  readonly notification_preference_forbidden: "No puedes cambiar esta notificación.";
+  readonly onboarding_already_submitted: "La verificación ya fue enviada.";
+  readonly onboarding_incomplete: "Completa todos los datos requeridos antes de enviar.";
+  readonly onboarding_locked: "Los datos del negocio ya fueron enviados a revisión; contacta a soporte para cambiarlos.";
+  readonly onboarding_not_submitted: "El negocio todavía no envió su verificación.";
+  readonly operation_amount_exceeded: "No puedes confirmar más de lo reservado.";
+  readonly operation_expired: "La reserva venció y su capacidad fue devuelta.";
+  readonly operation_invalid_state: "La operación ya no está reservada.";
+  readonly operation_key_reused: "Esta clave de operación ya se usó con otros datos.";
+  readonly operation_not_found: "No existe la operación.";
+  readonly parameter_missing: "Falta un parámetro en la ruta.";
+  readonly payload_too_large: "El cuerpo de la solicitud supera 1 MB.";
+  readonly payment_code_in_progress: "Estamos verificando el código; espera unos segundos.";
+  readonly payment_code_invalid: "El código o la referencia no es válido o venció.";
+  readonly payment_code_not_expected: "Este pago no está esperando un código.";
+  readonly payment_code_not_sent: "No pudimos enviar otro código.";
+  readonly payment_in_progress: "Espera a que termine el pago antes de cambiar la selección.";
+  readonly payment_link_not_found: "No existe el enlace de pago.";
+  readonly payment_link_retired: "Un enlace retirado no puede modificarse ni reactivarse.";
+  readonly payment_link_unavailable: "Este enlace de pago ya no está disponible.";
+  readonly payment_method_unavailable: "Ese método no permite pagar en la moneda del checkout o del cobro.";
+  readonly payment_not_claimable: "Solo puedes abrir un reclamo por un pago confirmado.";
+  readonly payment_not_found: "No existe el pago.";
+  readonly payment_not_refundable: "Solo se pueden reembolsar pagos confirmados.";
+  readonly payments_unavailable: "No pudimos contactar al banco o al proveedor; inténtalo en unos segundos.";
+  readonly payout_account_change_pending: "Ya hay un cambio de la cuenta de retiro pendiente: cancélalo antes de pedir otro.";
+  readonly payout_not_found: "No existe el retiro.";
+  readonly phone_required: "Teléfono: este campo es obligatorio.";
+  readonly plan_inactive: "El plan está archivado.";
+  readonly plan_not_found: "No existe el plan.";
+  readonly plan_seats_locked: "No puedes cambiar la forma de cobro de un plan con suscripciones.";
+  readonly portal_action_disabled: "El negocio no permite hacer este cambio desde el portal.";
+  readonly portal_session_invalid: "Este enlace ya se abrió o venció.";
+  readonly product_inactive: "Este producto está desactivado.";
+  readonly product_not_found: "No existe el producto.";
+  readonly product_retired: "Este producto fue retirado.";
+  readonly product_unavailable: "Uno de los productos ya no existe.";
+  readonly production_already_enabled: "El negocio ya opera en producción.";
+  readonly production_not_enabled: "Completa la activación del negocio para usar producción.";
+  readonly provider_not_found: "No existe el proveedor.";
+  readonly quantity_decrease_requires_renewal: "Programa la reducción de puestos para la renovación.";
+  readonly quantity_limit_exceeded: "La cantidad supera el máximo por compra.";
+  readonly quantity_not_adjustable: "Este plan no se cobra por puesto.";
+  readonly quantity_not_allowed: "Este plan no se cobra por puesto.";
+  readonly quantity_out_of_range: "La cantidad está fuera del mínimo y el máximo de puestos del plan.";
+  readonly rate_limited: "Demasiadas solicitudes seguidas; espera un momento e inténtalo de nuevo.";
+  readonly receipt_not_found: "No existe el recibo.";
+  readonly receipt_resend_limit: "Puedes enviar el recibo hasta cinco veces por hora. Inténtalo más tarde.";
+  readonly refund_amount_mismatch: "Registra el importe completo de la devolución pendiente.";
+  readonly refund_approval_pending: "Este pago ya tiene un reembolso esperando aprobación.";
+  readonly refund_exceeds_payment: "El reembolso supera lo que queda por reembolsar del pago.";
+  readonly refund_threshold_change_pending: "Ya hay un cambio de la aprobación de reembolsos pendiente: cancélalo antes de pedir otro.";
+  readonly renewal_invoice: "El cobro es la renovación de una suscripción y no se puede cerrar a mano.";
+  readonly representative_not_found: "No existe el representante.";
+  readonly representatives_limit: "Se alcanzó el máximo de representantes.";
+  readonly request_log_not_found: "No existe el registro.";
+  readonly resource_conflict: "Ya existe un recurso con estos datos únicos.";
+  readonly role_admin_required: "Solo propietarios y administradores.";
+  readonly route_not_found: "Este endpoint no existe.";
+  readonly saved_payer_not_found: "No existe el método de pago guardado.";
+  readonly seat_limit_reached: "No quedan puestos disponibles en el plan.";
+  readonly seats_in_use: "El cambio deja menos puestos que miembros activos: quita miembros o acepta deshabilitarlos (disableExcessMembers).";
+  readonly subscription_change_in_progress: "Estamos verificando el pago de un cambio de esta suscripción.";
+  readonly subscription_ended: "La suscripción ya terminó o se canceló.";
+  readonly subscription_exists: "El cliente ya tiene una suscripción en curso a este plan.";
+  readonly subscription_not_canceling: "Esta suscripción no tiene una cancelación programada.";
+  readonly subscription_not_found: "No existe la suscripción.";
+  readonly subscription_renewal_open: "Paga la renovación o programa el cambio para el próximo periodo.";
+  readonly tax_behavior_mismatch: "Todos los productos deben tratar los impuestos igual.";
+  readonly tax_id_prefix: "El RIF no corresponde al tipo de organización.";
+  readonly too_many_attempts: "Demasiados intentos de pago para este checkout.";
+  readonly tracking_deadline_passed: "El plazo para agregar la guía ya terminó.";
+  readonly tracking_number_in_use: "Esa guía ya pertenece al envío de otro cliente.";
+  readonly tracking_verifying: "Estamos verificando la guía que agregaste.";
+  readonly trial_not_applicable: "Un plan gratuito no necesita prueba.";
+  readonly trial_required: "Las suscripciones creadas por API empiezan con prueba gratis; vende planes pagos con un checkout.";
+  readonly trial_unavailable: "Este cliente ya usó la prueba gratis; el checkout ahora cobra el primer periodo.";
+  readonly unsubscribe_invalid: "El enlace no es válido.";
+  readonly unused_credit_not_accepted: "Este cambio pierde crédito no utilizado; acéptalo expresamente o prográmalo para la renovación.";
+  readonly validation_failed: "El cuerpo o la consulta no cumple el esquema; `param` dice qué campo.";
+  readonly variant_not_found: "No existe la variante.";
+  readonly variant_pricing_required: "Con variantes, el precio y el stock se configuran por variante.";
+  readonly variant_required: "El producto tiene variantes: elige una.";
+  readonly variant_retired: "Una variante retirada no puede modificarse ni reactivarse.";
+  readonly variant_retirement_required: "Retira la variante explícitamente antes de quitarla del producto.";
+  readonly webhook_delivery_in_progress: "Este envío está en curso; podrás reenviarlo cuando termine.";
+  readonly webhook_delivery_not_found: "No existe el envío.";
+  readonly webhook_endpoint_disabled: "Este webhook está desactivado: actívalo para enviarle eventos.";
+  readonly webhook_endpoint_not_found: "No existe el webhook.";
+  readonly webhook_signature_invalid: "La firma del evento no es válida.";
+  readonly webhook_url_credentials_forbidden: "La URL del webhook no puede incluir credenciales.";
+  readonly webhook_url_https_required: "La URL del webhook debe usar HTTPS.";
+  readonly webhook_url_invalid: "La URL del webhook no es válida.";
+  readonly webhook_url_private: "La URL del webhook no puede apuntar a localhost.";
+  readonly webhook_url_protocol: "La URL del webhook debe usar HTTP o HTTPS.";
+  readonly webhook_url_unresolvable: "No pudimos resolver el dominio del webhook.";
+};
+type ApiErrorCode = keyof typeof API_ERROR_CODES;
+//#endregion
 //#region ../contracts/src/errors.d.ts
 declare const API_ERROR_TYPES: readonly ["invalid_request", "authentication", "permission", "not_found", "conflict", "validation", "rate_limit", "provider", "internal"];
 type ApiErrorType = (typeof API_ERROR_TYPES)[number];
 interface ApiErrorBody {
   type: ApiErrorType;
-  code: string;
+  /** Stable and listed in `API_ERROR_CODES`, with what each means. */
+  code: ApiErrorCode;
   message: string;
   /** The request field that caused the error, when there is one. */
   param?: string;
@@ -354,6 +573,11 @@ interface ProductVariant extends Retirement {
 }
 interface Product extends Resource<"product">, Retirement {
   name: string;
+  /**
+   * The business's own name for it, unique among its products in each environment: unlike
+   * `metadata`, it is public, so a custom checkout tells what it sells (`plus`) without keeping IDs.
+   */
+  lookupKey: string | null;
   description: string | null;
   imageUrl: string | null;
   category: ProductCategory;
@@ -386,6 +610,11 @@ interface Plan extends Resource<"plan"> {
   seats: PlanSeats;
   fallbackPlanId: string | null;
   name: string;
+  /**
+   * The business's own name for it, unique among its plans in each environment: unlike
+   * `metadata`, it is public, so a custom checkout tells what it sells (`plus`) without keeping IDs.
+   */
+  lookupKey: string | null;
   description: string | null;
   currency: Currency;
   prices: PlanPrice[];
@@ -820,6 +1049,16 @@ interface FulfillmentTracking {
   /** When the carrier was last asked. */
   checkedAt: Timestamp | null;
 }
+/**
+ * How the business handed a purchase over. `code`: it scanned the code its customer shows (the QR
+ * of their order page), proof they were there; the customer then has 24 hours instead of 48 to
+ * confirm or report a problem. `manual`: marked without the code, with the business's `reason`
+ * when it gave one.
+ */
+interface FulfillmentHandover {
+  method: "code" | "manual";
+  reason: string | null;
+}
 /** How a customer receives a physical purchase. Its funds are held until it is received. */
 interface Fulfillment extends Resource<"fulfillment"> {
   checkoutId: string;
@@ -854,6 +1093,8 @@ interface Fulfillment extends Resource<"fulfillment"> {
     reason: string;
   } | null;
   deliveredAt: Timestamp | null;
+  /** How it was handed over, once the business did; `null` before, and for a shipment. */
+  handover: FulfillmentHandover | null;
   /** While `delivered`: when it counts as received if the customer says nothing. */
   confirmBy: Timestamp | null;
   receivedAt: Timestamp | null;
@@ -953,6 +1194,11 @@ interface PaymentSettlement {
   amount: number;
   currency: Currency;
   exchangeRate: string | null;
+  /**
+   * The IVA charged, in `currency`. A price in another currency is converted line by line and its
+   * IVA computed in `currency`. Absent on conversions before it was recorded.
+   */
+  tax?: number;
   fee: number;
   /** `fee` split into Billete's and the payment method's. */
   feeDetails?: PaymentFeeDetails;
@@ -1204,4 +1450,4 @@ type WebhookEvent = { [TType in EventType]: {
   data: EventDataMap[TType];
 }; }[EventType];
 //#endregion
-export { FulfillmentStatus as $, ACCOUNT_NUMBER_LENGTH as $t, Coupon as A, Retirement as At, ExchangeRate as B, SubscriptionStatus as Bt, CheckoutPurpose as C, nationalPhone as Cn, Product as Ct, ClaimReason as D, tokenEnvironment as Dn, RISK_LEVELS as Dt, ClaimOutcome as E, TokenKind as En, RESET_FREQUENCIES as Et, CustomerFeature as F, Subscription as Ft, FeatureOperation as G, ReceiptReference as Gt, FULFILLMENT_METHODS as H, USAGE_FEATURE_TYPES as Ht, CustomerMember as I, SubscriptionChange as It, FeatureType as J, ApiErrorBody as Jt, FeatureOperationResult as K, ReceiptSend as Kt, CustomerMemberList as L, SubscriptionChangePreview as Lt, CustomField as M, SUBMIT_LABELS as Mt, Customer as N, SUBSCRIPTION_STATUSES as Nt, ClaimStatus as O, tokenPrefix as On, Refund as Ot, CustomerDetails as P, SubmitLabel as Pt, FulfillmentMethod as Q, PaymentFailureCode as Qt, CustomerSession as R, SubscriptionChangeResult as Rt, CheckoutItem as S, isMobilePhone as Sn, PortalSession as St, ClaimMessage as T, Environment as Tn, ProductVariant as Tt, FULFILLMENT_STATUSES as U, WebhookEndpoint as Ut, FEATURE_TYPES as V, SubscriptionTerms as Vt, Feature as W, Weekday as Wt, Fulfillment as X, ApiErrorType as Xt, FeatureUsageResult as Y, ApiErrorEnvelope as Yt, FulfillmentChoice as Z, PAYMENT_FAILURE_CODES as Zt, CLAIM_STATUSES as _, TaxBehavior as _n, Payout as _t, WEBHOOK_TEST_EVENT as a, CURRENCIES as an, InvoiceStatus as at, CarrierOffice as b, findBank as bn, PlanPrice as bt, AfterCompletion as c, GracePeriodDays as cn, PAYMENT_STATUSES as ct, CANCELLATION_FEEDBACK as d, ListSort as dn, PaymentAttempt as dt, Address as en, FulfillmentTracking as et, CARRIERS as f, MAX_QUANTITY as fn, PaymentFailure as ft, CLAIM_REASONS as g, TAX_BEHAVIORS as gn, PaymentStatus as gt, CLAIM_OUTCOMES as h, MobilePrefix as hn, PaymentSettlement as ht, SubscribableEventType as i, BillingMonths as in, InvoiceReason as it, CurrencyAvailability as j, RiskLevel as jt, CollectSettings as k, ResetFrequency as kt, Balance as l, List as ln, PRODUCT_CATEGORIES as lt, CHECKOUT_PURPOSES as m, Metadata as mn, PaymentLink as mt, EventDataMap as n, BILLING_MONTHS as nn, INVOICE_STATUSES as nt, WebhookEvent as o, Currency as on, LineItem as ot, CARRIER_TEST_SCENARIOS as p, MOBILE_PREFIXES as pn, PaymentFeeDetails as pt, FeatureReset as q, API_ERROR_TYPES as qt, EventType as r, BankCode as rn, Invoice as rt, Actor as s, GRACE_PERIOD_DAYS as sn, MAX_SEATS as st, EVENT_TYPES as t, AddressInput as tn, INVOICE_REASONS as tt, BalanceAmount as u, ListQuery as un, Payment as ut, CancellationFeedback as v, Timestamp as vn, Plan as vt, Claim as w, ENVIRONMENTS as wn, ProductCategory as wt, Checkout as x, isLandlinePhone as xn, PlanSeats as xt, Carrier as y, VENEZUELAN_BANKS as yn, PlanFeatureValues as yt, Event as z, SubscriptionRenewal as zt };
+export { FulfillmentMethod as $, PaymentFailureCode as $t, Coupon as A, tokenEnvironment as An, ResetFrequency as At, ExchangeRate as B, SubscriptionRenewal as Bt, CheckoutPurpose as C, findBank as Cn, PortalSession as Ct, ClaimReason as D, ENVIRONMENTS as Dn, RESET_FREQUENCIES as Dt, ClaimOutcome as E, nationalPhone as En, ProductVariant as Et, CustomerFeature as F, SubmitLabel as Ft, FeatureOperation as G, Weekday as Gt, FULFILLMENT_METHODS as H, SubscriptionTerms as Ht, CustomerMember as I, Subscription as It, FeatureType as J, API_ERROR_TYPES as Jt, FeatureOperationResult as K, ReceiptReference as Kt, CustomerMemberList as L, SubscriptionChange as Lt, CustomField as M, RiskLevel as Mt, Customer as N, SUBMIT_LABELS as Nt, ClaimStatus as O, Environment as On, RISK_LEVELS as Ot, CustomerDetails as P, SUBSCRIPTION_STATUSES as Pt, FulfillmentHandover as Q, PAYMENT_FAILURE_CODES as Qt, CustomerSession as R, SubscriptionChangePreview as Rt, CheckoutItem as S, VENEZUELAN_BANKS as Sn, PlanSeats as St, ClaimMessage as T, isMobilePhone as Tn, ProductCategory as Tt, FULFILLMENT_STATUSES as U, USAGE_FEATURE_TYPES as Ut, FEATURE_TYPES as V, SubscriptionStatus as Vt, Feature as W, WebhookEndpoint as Wt, Fulfillment as X, ApiErrorEnvelope as Xt, FeatureUsageResult as Y, ApiErrorBody as Yt, FulfillmentChoice as Z, ApiErrorType as Zt, CLAIM_STATUSES as _, Metadata as _n, PaymentStatus as _t, WEBHOOK_TEST_EVENT as a, BILLING_MONTHS as an, InvoiceReason as at, CarrierOffice as b, TaxBehavior as bn, PlanFeatureValues as bt, AfterCompletion as c, CURRENCIES as cn, MAX_SEATS as ct, CANCELLATION_FEEDBACK as d, GracePeriodDays as dn, Payment as dt, API_ERROR_CODES as en, FulfillmentStatus as et, CARRIERS as f, List as fn, PaymentAttempt as ft, CLAIM_REASONS as g, MOBILE_PREFIXES as gn, PaymentSettlement as gt, CLAIM_OUTCOMES as h, MAX_QUANTITY as hn, PaymentLink as ht, SubscribableEventType as i, AddressInput as in, Invoice as it, CurrencyAvailability as j, tokenPrefix as jn, Retirement as jt, CollectSettings as k, TokenKind as kn, Refund as kt, Balance as l, Currency as ln, PAYMENT_STATUSES as lt, CHECKOUT_PURPOSES as m, ListSort as mn, PaymentFeeDetails as mt, EventDataMap as n, ACCOUNT_NUMBER_LENGTH as nn, INVOICE_REASONS as nt, WebhookEvent as o, BankCode as on, InvoiceStatus as ot, CARRIER_TEST_SCENARIOS as p, ListQuery as pn, PaymentFailure as pt, FeatureReset as q, ReceiptSend as qt, EventType as r, Address as rn, INVOICE_STATUSES as rt, Actor as s, BillingMonths as sn, LineItem as st, EVENT_TYPES as t, ApiErrorCode as tn, FulfillmentTracking as tt, BalanceAmount as u, GRACE_PERIOD_DAYS as un, PRODUCT_CATEGORIES as ut, CancellationFeedback as v, MobilePrefix as vn, Payout as vt, Claim as w, isLandlinePhone as wn, Product as wt, Checkout as x, Timestamp as xn, PlanPrice as xt, Carrier as y, TAX_BEHAVIORS as yn, Plan as yt, Event as z, SubscriptionChangeResult as zt };

package/dist/{http-BfxFFQqw.js → http-D5FMIjK4.js}

@@ -18,7 +18,7 @@ var BilleteError = class extends Error {
 };
 //#endregion
 //#region src/http.ts
-const SDK_VERSION = "4.3.0";
+const SDK_VERSION = "5.0.0";
 const DEFAULT_BASE_URL = "https://api.billete.run";
 const RETRYABLE_STATUS = /* @__PURE__ */ new Set([
 	429,
@@ -41,21 +41,41 @@ function pause(ms, signal) {
 	});
 }
 function buildUrl(baseUrl, path, query) {
-	const url = new URL(path, baseUrl);
-	Object.entries(query ?? {}).filter(([, value]) => value !== void 0).forEach(([key, value]) => url.searchParams.set(key, String(value)));
-	return url;
+	const search = Object.entries(query ?? {}).filter(([, value]) => value !== void 0).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`).join("&");
+	return `${baseUrl.replace(/\/+$/, "")}${path}${search ? `?${search}` : ""}`;
 }
-/** A concurrent request with the same idempotency key is still running: worth retrying. */
-async function inProgress(response) {
-	return (await response.clone().json().catch(() => null))?.error.code === "idempotency_request_in_progress";
+/**
+* Aborts on the attempt's timeout or the caller's signal, whichever comes first. Built by hand
+* because `AbortSignal.timeout` and `AbortSignal.any` are missing in older React Native.
+*/
+function attemptSignal(timeoutMs, caller) {
+	const controller = new AbortController();
+	const abort = () => controller.abort(caller?.reason);
+	const timer = setTimeout(() => controller.abort(/* @__PURE__ */ new Error(`timed out after ${timeoutMs} ms`)), timeoutMs);
+	if (caller?.aborted) abort();
+	else caller?.addEventListener("abort", abort, { once: true });
+	return {
+		signal: controller.signal,
+		done: () => {
+			clearTimeout(timer);
+			caller?.removeEventListener("abort", abort);
+		}
+	};
 }
-async function toError(response) {
-	return new BilleteError((await response.json().catch(() => null))?.error ?? {
+function errorBody(reply) {
+	try {
+		return JSON.parse(reply.text).error;
+	} catch {
+		return;
+	}
+}
+function toError(reply) {
+	return new BilleteError(errorBody(reply) ?? {
 		type: "internal",
 		code: "invalid_response",
-		message: `Unexpected HTTP ${response.status} from Billete`,
-		requestId: response.headers.get("X-Request-Id") ?? void 0
-	}, response.status);
+		message: `Unexpected HTTP ${reply.status} from Billete`,
+		requestId: reply.headers.get("X-Request-Id") ?? void 0
+	}, reply.status);
 }
 function createTransport(options) {
 	if (!options.apiVersion) throw new TypeError("Billete needs apiVersion: the API version your integration is written against");
@@ -71,19 +91,25 @@ function createTransport(options) {
 			"X-Billete-Client": `billete-js/${SDK_VERSION}`,
 			...token ? { Authorization: `Bearer ${token}` } : {},
 			...request.body === void 0 ? {} : { "Content-Type": "application/json" },
-			...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
+			...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+			...request.headers
 		};
-		const signals = [AbortSignal.timeout(timeoutMs), request.options?.signal].filter((signal) => signal !== void 0);
+		const deadline = attemptSignal(timeoutMs, request.options?.signal);
 		const response = await fetchImpl(buildUrl(baseUrl, request.path, request.query), {
 			method: request.method,
 			headers,
 			body: request.body === void 0 ? void 0 : JSON.stringify(request.body),
-			signal: AbortSignal.any(signals)
-		}).catch((error) => {
+			signal: deadline.signal
+		}).then(async (reply) => ({
+			ok: reply.ok,
+			status: reply.status,
+			headers: reply.headers,
+			text: await reply.text()
+		})).catch((error) => {
 			if (request.options?.signal?.aborted) throw error;
 			return error instanceof Error ? error : new Error(String(error));
-		});
-		if ((response instanceof Error || RETRYABLE_STATUS.has(response.status) || response.status === 409 && await inProgress(response)) && attempt < maxRetries) {
+		}).finally(deadline.done);
+		if ((response instanceof Error || RETRYABLE_STATUS.has(response.status) || response.status === 409 && errorBody(response)?.code === "idempotency_request_in_progress") && attempt < maxRetries) {
 			await pause(backoff(attempt, response instanceof Error ? null : response.headers.get("Retry-After")), request.options?.signal);
 			return send(request, idempotencyKey, attempt + 1);
 		}
@@ -92,11 +118,12 @@ function createTransport(options) {
 			code: "network_error",
 			message: `Could not reach Billete: ${response.message}`
 		}, 0, { cause: response });
-		if (!response.ok) throw await toError(response);
-		return response.status === 204 ? void 0 : await response.json();
+		if (response.status === 304) return void 0;
+		if (!response.ok) throw toError(response);
+		return response.status === 204 ? void 0 : JSON.parse(response.text);
 	}
 	function request(request) {
-		return send(request, request.method === "GET" ? void 0 : request.options?.idempotencyKey ?? globalThis.crypto.randomUUID(), 0);
+		return send(request, request.method === "GET" || !options.idempotencyKey ? void 0 : request.options?.idempotencyKey ?? options.idempotencyKey(), 0);
 	}
 	/** Walks every page of a list endpoint. */
 	async function* paginate(path, query = {}) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as ProductLinkCreate, A as EventSelector, At as API_VERSION_PATTERN, B as PaymentLinkCreate, Bt as isApiVersionRetired, C as CustomFieldInput, Ct as PublicFulfillment, D as CustomerMemberUpdate, Dt as PublicPortal, E as CustomerMemberCreate, Et as PublicPaymentState, F as FulfillmentInput, Ft as LatestApiVersion, G as PlanFeaturesInput, H as PlanCheckoutCreate, I as FulfillmentTrackingInput, It as apiVersionLifecycle, J as PlanUpdate, K as PlanLinkCreate, L as InvoiceCreate, Lt as apiVersionStage, M as FeatureOperationCommit, Mt as ApiVersionLifecycle, N as FeatureOperationCreate, Nt as ApiVersionStage, O as CustomerSessionCreate, Ot as API_VERSIONS, P as FeatureUpdate, Pt as LATEST_API_VERSION, Q as ProductCreate, R as InvoiceLineInput, Rt as currentApiVersion, S as CouponUpdate, St as PublicClaimSummary, T as CustomerInput, Tt as PublicPaymentLink, U as PlanCouponCreate, V as PaymentLinkUpdate, Vt as supportedApiVersions, W as PlanCreate, X as ProductCheckoutCreate, Y as PortalSessionCreate, Z as ProductCouponCreate, _ as ClientSubscriptionCancel, _t as PaymentNextAction, a as CheckoutCreate, at as SubscriptionChangePreviewInput, b as CollectInput, bt as PublicCheckout, c as ClaimRespond, ct as VariantInput, d as ClientClaimCreate, dt as CustomerSubscription, et as ProductUpdate, f as ClientCustomerClaimCreate, ft as CustomerSubscriptionChangeResult, g as ClientPaymentCode, gt as PaymentMethodOption, h as ClientLinkCheckout, ht as PaymentMethodField, i as AfterCompletionInput, it as SubscriptionChangeCreate, j as FeatureCreate, jt as ApiVersion, k as CustomerUpdate, kt as API_VERSION_HEADER, l as ClientCheckoutPay, lt as WebhookEndpointCreate, m as ClientInvoicePay, mt as PaymentInstructions, n as RequestOptions, nt as RetireInput, o as CheckoutItemInput, ot as SubscriptionCreate, p as ClientFulfillmentProblem, pt as FulfillmentOption, q as PlanPriceInput, r as TransportOptions, rt as SubscriptionCancel, s as ClaimResolve, st as SubscriptionUpdate, t as BilleteError, tt as RefundCreate, u as ClientCheckoutUpdate, ut as WebhookEndpointUpdate, v as ClientSubscriptionSeats, vt as PaymentTestScenario, w as CustomerCreate, wt as PublicInvoice, x as CouponCreate, xt as PublicClaim, y as ClientSubscriptionUpdate, yt as PortalFeatures, z as KEY_PATTERN, zt as isApiVersion } from "./errors-DCiynKkL.js";
-import { $ as FulfillmentStatus, $t as ACCOUNT_NUMBER_LENGTH, A as Coupon, At as Retirement, B as ExchangeRate, Bt as SubscriptionStatus, C as CheckoutPurpose, Cn as nationalPhone, Ct as Product, D as ClaimReason, Dn as tokenEnvironment, Dt as RISK_LEVELS, E as ClaimOutcome, En as TokenKind, Et as RESET_FREQUENCIES, F as CustomerFeature, Ft as Subscription, G as FeatureOperation, Gt as ReceiptReference, H as FULFILLMENT_METHODS, Ht as USAGE_FEATURE_TYPES, I as CustomerMember, It as SubscriptionChange, J as FeatureType, Jt as ApiErrorBody, K as FeatureOperationResult, Kt as ReceiptSend, L as CustomerMemberList, Lt as SubscriptionChangePreview, M as CustomField, Mt as SUBMIT_LABELS, N as Customer, Nt as SUBSCRIPTION_STATUSES, O as ClaimStatus, On as tokenPrefix, Ot as Refund, P as CustomerDetails, Pt as SubmitLabel, Q as FulfillmentMethod, Qt as PaymentFailureCode, R as CustomerSession, Rt as SubscriptionChangeResult, S as CheckoutItem, Sn as isMobilePhone, St as PortalSession, T as ClaimMessage, Tn as Environment, Tt as ProductVariant, U as FULFILLMENT_STATUSES, Ut as WebhookEndpoint, V as FEATURE_TYPES, Vt as SubscriptionTerms, W as Feature, Wt as Weekday, X as Fulfillment, Xt as ApiErrorType, Y as FeatureUsageResult, Yt as ApiErrorEnvelope, Z as FulfillmentChoice, Zt as PAYMENT_FAILURE_CODES, _ as CLAIM_STATUSES, _n as TaxBehavior, _t as Payout, a as WEBHOOK_TEST_EVENT, an as CURRENCIES, at as InvoiceStatus, b as CarrierOffice, bn as findBank, bt as PlanPrice, c as AfterCompletion, cn as GracePeriodDays, ct as PAYMENT_STATUSES, d as CANCELLATION_FEEDBACK, dn as ListSort, dt as PaymentAttempt, en as Address, et as FulfillmentTracking, f as CARRIERS, fn as MAX_QUANTITY, ft as PaymentFailure, g as CLAIM_REASONS, gn as TAX_BEHAVIORS, gt as PaymentStatus, h as CLAIM_OUTCOMES, hn as MobilePrefix, ht as PaymentSettlement, i as SubscribableEventType, in as BillingMonths, it as InvoiceReason, j as CurrencyAvailability, jt as RiskLevel, k as CollectSettings, kt as ResetFrequency, l as Balance, ln as List, lt as PRODUCT_CATEGORIES, m as CHECKOUT_PURPOSES, mn as Metadata, mt as PaymentLink, n as EventDataMap, nn as BILLING_MONTHS, nt as INVOICE_STATUSES, o as WebhookEvent, on as Currency, ot as LineItem, p as CARRIER_TEST_SCENARIOS, pn as MOBILE_PREFIXES, pt as PaymentFeeDetails, q as FeatureReset, qt as API_ERROR_TYPES, r as EventType, rn as BankCode, rt as Invoice, s as Actor, sn as GRACE_PERIOD_DAYS, st as MAX_SEATS, t as EVENT_TYPES, tn as AddressInput, tt as INVOICE_REASONS, u as BalanceAmount, un as ListQuery, ut as Payment, v as CancellationFeedback, vn as Timestamp, vt as Plan, w as Claim, wn as ENVIRONMENTS, wt as ProductCategory, x as Checkout, xn as isLandlinePhone, xt as PlanSeats, y as Carrier, yn as VENEZUELAN_BANKS, yt as PlanFeatureValues, z as Event, zt as SubscriptionRenewal } from "./events-CaNwG-EX.js";
+import { $ as ProductCheckoutCreate, A as CustomerUpdate, At as PublicPaymentState, B as InvoiceCreate, Bt as apiVersionLifecycle, C as CouponUpdate, Ct as PublicCheckout, D as CustomerMemberCreate, Dt as PublicFulfillment, E as CustomerInput, Et as PublicClaimSummary, F as FeatureUpdate, Ft as ApiVersion, G as PlanCheckoutCreate, Gt as supportedApiVersions, H as KEY_PATTERN, Ht as currentApiVersion, I as FulfillmentDeliverInput, It as ApiVersionLifecycle, J as PlanFeaturesInput, K as PlanCouponCreate, L as FulfillmentHandoverInput, Lt as ApiVersionStage, M as FeatureCreate, Mt as API_VERSIONS, N as FeatureOperationCommit, Nt as API_VERSION_HEADER, O as CustomerMemberUpdate, Ot as PublicInvoice, P as FeatureOperationCreate, Pt as API_VERSION_PATTERN, Q as PortalSessionCreate, R as FulfillmentInput, Rt as LATEST_API_VERSION, S as CouponCreate, St as PortalFeatures, T as CustomerCreate, Tt as PublicClaim, U as PaymentLinkCreate, Ut as isApiVersion, V as InvoiceLineInput, Vt as apiVersionStage, W as PaymentLinkUpdate, Wt as isApiVersionRetired, X as PlanPriceInput, Y as PlanLinkCreate, Z as PlanUpdate, _ as ClientPaymentCode, _t as PaymentInstructions, a as AfterCompletionInput, at as RetireInput, b as ClientSubscriptionUpdate, bt as PaymentNextAction, c as ClaimResolve, ct as SubscriptionChangePreviewInput, d as ClientCheckoutUpdate, dt as VariantInput, et as ProductCouponCreate, f as ClientClaimCreate, ft as WebhookEndpointCreate, g as ClientLinkCheckout, gt as FulfillmentOption, h as ClientInvoicePay, ht as CustomerSubscriptionChangeResult, i as TransportOptions, it as RefundCreate, j as EventSelector, jt as PublicPortal, k as CustomerSessionCreate, kt as PublicPaymentLink, l as ClaimRespond, lt as SubscriptionCreate, m as ClientFulfillmentProblem, mt as CustomerSubscription, n as BilleteErrorCode, nt as ProductLinkCreate, o as CheckoutCreate, ot as SubscriptionCancel, p as ClientCustomerClaimCreate, pt as WebhookEndpointUpdate, q as PlanCreate, r as RequestOptions, rt as ProductUpdate, s as CheckoutItemInput, st as SubscriptionChangeCreate, t as BilleteError, tt as ProductCreate, u as ClientCheckoutPay, ut as SubscriptionUpdate, v as ClientSubscriptionCancel, vt as PaymentMethodField, w as CustomFieldInput, wt as PublicCheckoutItem, x as CollectInput, xt as PaymentTestScenario, y as ClientSubscriptionSeats, yt as PaymentMethodOption, z as FulfillmentTrackingInput, zt as LatestApiVersion } from "./errors-CGHiFrlh.js";
+import { $ as FulfillmentMethod, $t as PaymentFailureCode, A as Coupon, An as tokenEnvironment, At as ResetFrequency, B as ExchangeRate, Bt as SubscriptionRenewal, C as CheckoutPurpose, Cn as findBank, Ct as PortalSession, D as ClaimReason, Dn as ENVIRONMENTS, Dt as RESET_FREQUENCIES, E as ClaimOutcome, En as nationalPhone, Et as ProductVariant, F as CustomerFeature, Ft as SubmitLabel, G as FeatureOperation, Gt as Weekday, H as FULFILLMENT_METHODS, Ht as SubscriptionTerms, I as CustomerMember, It as Subscription, J as FeatureType, Jt as API_ERROR_TYPES, K as FeatureOperationResult, Kt as ReceiptReference, L as CustomerMemberList, Lt as SubscriptionChange, M as CustomField, Mt as RiskLevel, N as Customer, Nt as SUBMIT_LABELS, O as ClaimStatus, On as Environment, Ot as RISK_LEVELS, P as CustomerDetails, Pt as SUBSCRIPTION_STATUSES, Q as FulfillmentHandover, Qt as PAYMENT_FAILURE_CODES, R as CustomerSession, Rt as SubscriptionChangePreview, S as CheckoutItem, Sn as VENEZUELAN_BANKS, St as PlanSeats, T as ClaimMessage, Tn as isMobilePhone, Tt as ProductCategory, U as FULFILLMENT_STATUSES, Ut as USAGE_FEATURE_TYPES, V as FEATURE_TYPES, Vt as SubscriptionStatus, W as Feature, Wt as WebhookEndpoint, X as Fulfillment, Xt as ApiErrorEnvelope, Y as FeatureUsageResult, Yt as ApiErrorBody, Z as FulfillmentChoice, Zt as ApiErrorType, _ as CLAIM_STATUSES, _n as Metadata, _t as PaymentStatus, a as WEBHOOK_TEST_EVENT, an as BILLING_MONTHS, at as InvoiceReason, b as CarrierOffice, bn as TaxBehavior, bt as PlanFeatureValues, c as AfterCompletion, cn as CURRENCIES, ct as MAX_SEATS, d as CANCELLATION_FEEDBACK, dn as GracePeriodDays, dt as Payment, en as API_ERROR_CODES, et as FulfillmentStatus, f as CARRIERS, fn as List, ft as PaymentAttempt, g as CLAIM_REASONS, gn as MOBILE_PREFIXES, gt as PaymentSettlement, h as CLAIM_OUTCOMES, hn as MAX_QUANTITY, ht as PaymentLink, i as SubscribableEventType, in as AddressInput, it as Invoice, j as CurrencyAvailability, jn as tokenPrefix, jt as Retirement, k as CollectSettings, kn as TokenKind, kt as Refund, l as Balance, ln as Currency, lt as PAYMENT_STATUSES, m as CHECKOUT_PURPOSES, mn as ListSort, mt as PaymentFeeDetails, n as EventDataMap, nn as ACCOUNT_NUMBER_LENGTH, nt as INVOICE_REASONS, o as WebhookEvent, on as BankCode, ot as InvoiceStatus, p as CARRIER_TEST_SCENARIOS, pn as ListQuery, pt as PaymentFailure, q as FeatureReset, qt as ReceiptSend, r as EventType, rn as Address, rt as INVOICE_STATUSES, s as Actor, sn as BillingMonths, st as LineItem, t as EVENT_TYPES, tn as ApiErrorCode, tt as FulfillmentTracking, u as BalanceAmount, un as GRACE_PERIOD_DAYS, ut as PRODUCT_CATEGORIES, v as CancellationFeedback, vn as MobilePrefix, vt as Payout, w as Claim, wn as isLandlinePhone, wt as Product, x as Checkout, xn as Timestamp, xt as PlanPrice, y as Carrier, yn as TAX_BEHAVIORS, yt as Plan, z as Event, zt as SubscriptionChangeResult } from "./events-D09DIgn-.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region src/server.d.ts
 type Filters<T> = ListQuery & T;
@@ -25,7 +25,7 @@ interface BilleteOptions extends TransportOptions {
  *
  * ```ts
  * // Reads BILLETE_API_KEY.
- * const billete = createBillete({ apiVersion: "2026-10-10", environment: "test" });
+ * const billete = createBillete({ apiVersion: "2026-10-16", environment: "test" });
  * const { allowed } = await billete.features.consume("user_123", "tokens", 850);
  * ```
  */
@@ -70,6 +70,7 @@ export declare function createBillete(options: BilleteOptions): {
       active?: boolean;
       retired?: boolean;
       search?: string;
+      lookupKey?: string;
       sort?: ListSort<"created" | "name">;
     }>, options?: RequestOptions) => Promise<List<Product>>;
     /** Iterates every item across pages: `for await (const item of iterate())`. */
@@ -77,6 +78,7 @@ export declare function createBillete(options: BilleteOptions): {
       active?: boolean;
       retired?: boolean;
       search?: string;
+      lookupKey?: string;
       sort?: ListSort<"created" | "name">;
     }>) => AsyncGenerator<Product, any, any>;
     retire: (id: string, input?: RetireInput, options?: RequestOptions) => Promise<Product>;
@@ -89,12 +91,14 @@ export declare function createBillete(options: BilleteOptions): {
     list: (query?: Filters<{
       active?: boolean;
       search?: string;
+      lookupKey?: string;
       sort?: ListSort<"created" | "name">;
     }>, options?: RequestOptions) => Promise<List<Plan>>;
     /** Iterates every item across pages: `for await (const item of iterate())`. */
     iterate: (query?: Filters<{
       active?: boolean;
       search?: string;
+      lookupKey?: string;
       sort?: ListSort<"created" | "name">;
     }>) => AsyncGenerator<Plan, any, any>;
   };
@@ -261,17 +265,31 @@ export declare function createBillete(options: BilleteOptions): {
     retrieve: (id: string, options?: RequestOptions) => Promise<Fulfillment>;
     list: (query?: Filters<{
       status?: FulfillmentStatus;
+      /** `search`: part of the ID, or of the customer's name or email. */
       search?: string;
+      /** The one whose code the customer showed: what its QR encodes, or the code alone. */
+      handoverCode?: string;
       sort?: ListSort<"created">;
     }>, options?: RequestOptions) => Promise<List<Fulfillment>>;
     iterate: (query?: Filters<{
       status?: FulfillmentStatus;
+      /** `search`: part of the ID, or of the customer's name or email. */
       search?: string;
+      /** The one whose code the customer showed: what its QR encodes, or the code alone. */
+      handoverCode?: string;
       sort?: ListSort<"created">;
     }>) => AsyncGenerator<Fulfillment, any, any>;
     /** Sends a tracking number to be verified against the customer's chosen office. */
     submitTracking: (id: string, input: FulfillmentTrackingInput, options?: RequestOptions) => Promise<Fulfillment>;
-    /** You handed it over: the customer has 48 hours to confirm it or report a problem. */
+    /**
+     * You handed it over with the code the customer showed (the QR of their order page), proof
+     * they were there: they have 24 hours to confirm it or report a problem.
+     */
+    handOver: (id: string, input: FulfillmentHandoverInput, options?: RequestOptions) => Promise<Fulfillment>;
+    /**
+     * You handed it over without the customer's code, or sent it with a courier: they have 48
+     * hours to confirm it or report a problem.
+     */
     deliver: (id: string, options?: RequestOptions) => Promise<Fulfillment>;
   };
   claims: {
@@ -350,4 +368,4 @@ export declare function createBillete(options: BilleteOptions): {
 /** The server client: what `createBillete` returns. */
 type Billete = ReturnType<typeof createBillete>;
 //#endregion
-export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type Billete, BilleteError, type BilleteOptions, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CLAIM_OUTCOMES, type CLAIM_REASONS, type CLAIM_STATUSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type Claim, type ClaimMessage, type ClaimOutcome, type ClaimReason, type ClaimResolve, type ClaimRespond, type ClaimStatus, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientClaimCreate, type ClientCustomerClaimCreate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentFeeDetails, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type PublicClaim, type PublicClaimSummary, type PublicFulfillment, type PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type Refund, type RefundCreate, type RequestOptions, type ResetFrequency, type RetireInput, type Retirement, type RiskLevel, type SUBMIT_LABELS, type SUBSCRIPTION_STATUSES, type SubmitLabel, type SubscribableEventType, type Subscription, type SubscriptionCancel, type SubscriptionChange, type SubscriptionChangeCreate, type SubscriptionChangePreview, type SubscriptionChangePreviewInput, type SubscriptionChangeResult, type SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, type SubscriptionTerms, type SubscriptionUpdate, type TAX_BEHAVIORS, type TaxBehavior, type Timestamp, type TokenKind, type TransportOptions, type USAGE_FEATURE_TYPES, type VENEZUELAN_BANKS, type VariantInput, type WEBHOOK_TEST_EVENT, type WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, WebhookVerificationError, type Weekday, type apiVersionLifecycle, type apiVersionStage, type currentApiVersion, type findBank, type isApiVersion, type isApiVersionRetired, type isLandlinePhone, type isMobilePhone, type nationalPhone, type supportedApiVersions, type tokenEnvironment, type tokenPrefix, verifyWebhook };
+export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_CODES, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorCode, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type Billete, BilleteError, type BilleteErrorCode, type BilleteOptions, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CLAIM_OUTCOMES, type CLAIM_REASONS, type CLAIM_STATUSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type Claim, type ClaimMessage, type ClaimOutcome, type ClaimReason, type ClaimResolve, type ClaimRespond, type ClaimStatus, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientClaimCreate, type ClientCustomerClaimCreate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentDeliverInput, type FulfillmentHandover, type FulfillmentHandoverInput, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentFeeDetails, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type PublicCheckoutItem, type PublicClaim, type PublicClaimSummary, type PublicFulfillment, type PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type Refund, type RefundCreate, type RequestOptions, type ResetFrequency, type RetireInput, type Retirement, type RiskLevel, type SUBMIT_LABELS, type SUBSCRIPTION_STATUSES, type SubmitLabel, type SubscribableEventType, type Subscription, type SubscriptionCancel, type SubscriptionChange, type SubscriptionChangeCreate, type SubscriptionChangePreview, type SubscriptionChangePreviewInput, type SubscriptionChangeResult, type SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, type SubscriptionTerms, type SubscriptionUpdate, type TAX_BEHAVIORS, type TaxBehavior, type Timestamp, type TokenKind, type TransportOptions, type USAGE_FEATURE_TYPES, type VENEZUELAN_BANKS, type VariantInput, type WEBHOOK_TEST_EVENT, type WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, WebhookVerificationError, type Weekday, type apiVersionLifecycle, type apiVersionStage, type currentApiVersion, type findBank, type isApiVersion, type isApiVersionRetired, type isLandlinePhone, type isMobilePhone, type nationalPhone, type supportedApiVersions, type tokenEnvironment, type tokenPrefix, verifyWebhook };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as segment, r as BilleteError, t as createTransport } from "./http-BfxFFQqw.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-D5FMIjK4.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region ../contracts/src/environment.ts
 /**
@@ -64,7 +64,7 @@ function fromEnv(name) {
 *
 * ```ts
 * // Reads BILLETE_API_KEY.
-* const billete = createBillete({ apiVersion: "2026-10-10", environment: "test" });
+* const billete = createBillete({ apiVersion: "2026-10-16", environment: "test" });
 * const { allowed } = await billete.features.consume("user_123", "tokens", 850);
 * ```
 */
@@ -78,7 +78,8 @@ function createBillete(options) {
 	const http = createTransport({
 		...options,
 		baseUrl: options.baseUrl ?? fromEnv("BILLETE_BASE_URL"),
-		token: () => apiKey
+		token: () => apiKey,
+		idempotencyKey: () => globalThis.crypto.randomUUID()
 	});
 	const customers = collection(http, "/v1/customers");
 	const memberPath = (customer) => `/v1/customers/${segment(customer)}/members`;
@@ -358,7 +359,20 @@ create: (input, options) => http.request({
 			body: input,
 			options
 		}),
-		/** You handed it over: the customer has 48 hours to confirm it or report a problem. */
+		/**
+		* You handed it over with the code the customer showed (the QR of their order page), proof
+		* they were there: they have 24 hours to confirm it or report a problem.
+		*/
+		handOver: (id, input, options) => http.request({
+			method: "POST",
+			path: `/v1/fulfillments/${segment(id)}/handover`,
+			body: input,
+			options
+		}),
+		/**
+		* You handed it over without the customer's code, or sent it with a courier: they have 48
+		* hours to confirm it or report a problem.
+		*/
 		deliver: (id, options) => http.request({
 			method: "POST",
 			path: `/v1/fulfillments/${segment(id)}/deliver`,

package/dist/webhooks.d.ts

@@ -1,4 +1,4 @@
-import { o as WebhookEvent } from "./events-CaNwG-EX.js";
+import { o as WebhookEvent } from "./events-D09DIgn-.js";
 //#region src/webhooks.d.ts
 export declare class WebhookVerificationError extends Error {
   constructor(message: string);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boelabs/billete-sdk",
-  "version": "4.3.0",
+  "version": "5.0.0",
   "description": "Billete SDK: server client, browser client and webhook verification",
   "keywords": [
     "billete",