@boelabs/billete-sdk 1.1.0-canary.6 → 3.0.0

package/README.md

@@ -42,6 +42,10 @@ servidor y tu frontend.
 npm install @boelabs/billete-sdk
 ```
 
+Cada versión del SDK habla una sola versión de la API, la que pide su opción `apiVersion`: una
+versión mayor nueva del SDK es una versión nueva de la API. Las versiones beta de la API tienen su
+SDK en `@boelabs/billete-sdk@beta`.
+
 El paquete tiene tres puntos de entrada:
 
 | Import | Dónde se usa | Para qué |
@@ -58,7 +62,7 @@ Crea una clave secreta en el dashboard (**Desarrolladores → Claves API**) y gu
 ```ts
 import { createBillete } from "@boelabs/billete-sdk";
 
-const billete = createBillete({ environment: "test" });
+const billete = createBillete({ apiVersion: "2026-10-09", environment: "test" });
 
 const checkout = await billete.checkouts.create({
   plan: "plan_…",
@@ -86,6 +90,7 @@ solicite expresamente. En carritos, solo ofrece los demás métodos que todos lo
 
 ```ts
 const billete = createBillete({
+  apiVersion: "2026-10-09",
   environment: "production",
   apiKey: process.env.BILLETE_API_KEY,
   timeoutMs: 30_000,
@@ -251,7 +256,7 @@ return { token: session.token };
 // Navegador
 import { createClient } from "@boelabs/billete-sdk/client";
 
-const billete = createClient({ customerSession: token });
+const billete = createClient({ apiVersion: "2026-10-09", customerSession: token });
 
 const { data: subscriptions } = await billete.customer.subscriptions();
 const tokens = await billete.customer.feature("tokens");

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { $ as PRODUCT_CATEGORIES, $t as ListQuery, A as ExchangeRate, At as SubscriptionTerms, B as Fulfillment, Bt as PAYMENT_FAILURE_CODES, C as Customer, Ct as SubmitLabel, D as CustomerMemberList, Dt as SubscriptionChangeResult, E as CustomerMember, Et as SubscriptionChangePreview, F as FeatureOperation, Ft as ReceiptSend, G as INVOICE_REASONS, Gt as BILLING_MONTHS, H as FulfillmentMethod, Ht as ACCOUNT_NUMBER_LENGTH, I as FeatureOperationResult, It as API_ERROR_TYPES, J as InvoiceReason, Jt as CURRENCIES, K as INVOICE_STATUSES, Kt as BankCode, L as FeatureReset, Lt as ApiErrorBody, M as FULFILLMENT_METHODS, Mt as WebhookEndpoint, N as FULFILLMENT_STATUSES, Nt as Weekday, O as CustomerSession, Ot as SubscriptionRenewal, P as Feature, Pt as ReceiptReference, Q as PAYMENT_STATUSES, Qt as List, R as FeatureType, Rt as ApiErrorEnvelope, S as CustomField, St as SUBSCRIPTION_STATUSES, T as CustomerFeature, Tt as SubscriptionChange, U as FulfillmentStatus, Ut as Address, V as FulfillmentChoice, Vt as PaymentFailureCode, W as FulfillmentTracking, Wt as AddressInput, X as LineItem, Xt as GRACE_PERIOD_DAYS, Y as InvoiceStatus, Yt as Currency, Z as MAX_SEATS, Zt as GracePeriodDays, _ as CheckoutItem, _n as tokenPrefix, _t as Refund, a as Actor, an as TAX_BEHAVIORS, at as PaymentStatus, b as Coupon, bt as RiskLevel, c as BalanceAmount, cn as VENEZUELAN_BANKS, ct as PlanFeatureValues, d as CARRIER_TEST_SCENARIOS, dn as isMobilePhone, dt as PortalSession, en as ListSort, et as Payment, f as CHECKOUT_PURPOSES, fn as nationalPhone, ft as Product, g as Checkout, gn as tokenEnvironment, gt as RISK_LEVELS, h as CarrierOffice, hn as TokenKind, ht as RESET_FREQUENCIES, i as WebhookEvent, in as MobilePrefix, it as PaymentSettlement, j as FEATURE_TYPES, jt as USAGE_FEATURE_TYPES, k as Event, kt as SubscriptionStatus, l as CANCELLATION_FEEDBACK, ln as findBank, lt as PlanPrice, m as Carrier, mn as Environment, mt as ProductVariant, n as EventDataMap, nn as MOBILE_PREFIXES, nt as PaymentFailure, o as AfterCompletion, on as TaxBehavior, ot as Payout, p as CancellationFeedback, pn as ENVIRONMENTS, pt as ProductCategory, q as Invoice, qt as BillingMonths, r as EventType, rn as Metadata, rt as PaymentLink, s as Balance, sn as Timestamp, st as Plan, t as EVENT_TYPES, tn as MAX_QUANTITY, tt as PaymentAttempt, u as CARRIERS, un as isLandlinePhone, ut as PlanSeats, v as CheckoutPurpose, vt as ResetFrequency, w as CustomerDetails, wt as Subscription, x as CurrencyAvailability, xt as SUBMIT_LABELS, y as CollectSettings, yt as Retirement, z as FeatureUsageResult, zt as ApiErrorType } from "./events-Dz2ghaMl.js";
-import { $ as SubscriptionCreate, A as FulfillmentInput, B as PlanLinkCreate, C as CustomerSessionCreate, D as FeatureOperationCommit, E as FeatureCreate, F as PaymentLinkCreate, G as ProductCreate, H as PlanUpdate, I as PaymentLinkUpdate, J as RefundCreate, K as ProductLinkCreate, L as PlanCheckoutCreate, M as InvoiceCreate, N as InvoiceLineInput, O as FeatureOperationCreate, P as KEY_PATTERN, Q as SubscriptionChangePreviewInput, R as PlanCreate, S as CustomerMemberUpdate, T as EventSelector, U as PortalSessionCreate, V as PlanPriceInput, W as ProductCheckoutCreate, X as SubscriptionCancel, Y as RetireInput, Z as SubscriptionChangeCreate, _ as CouponUpdate, _t as PublicPortal, a as CheckoutCreate, at as FulfillmentOption, b as CustomerInput, c as ClientCheckoutUpdate, ct as PaymentMethodOption, d as ClientLinkCheckout, dt as PortalFeatures, et as SubscriptionUpdate, f as ClientPaymentCode, ft as PublicCheckout, g as CouponCreate, gt as PublicPaymentState, h as CollectInput, ht as PublicPaymentLink, i as AfterCompletionInput, it as CustomerSubscription, j as FulfillmentTrackingInput, k as FeatureUpdate, l as ClientFulfillmentProblem, lt as PaymentNextAction, m as ClientSubscriptionUpdate, mt as PublicInvoice, n as RequestOptions, nt as WebhookEndpointCreate, o as CheckoutItemInput, ot as PaymentInstructions, p as ClientSubscriptionCancel, pt as PublicFulfillment, q as ProductUpdate, r as TransportOptions, rt as WebhookEndpointUpdate, s as ClientCheckoutPay, st as PaymentMethodField, t as BilleteError, tt as VariantInput, u as ClientInvoicePay, ut as PaymentTestScenario, v as CustomFieldInput, w as CustomerUpdate, x as CustomerMemberCreate, y as CustomerCreate, z as PlanFeaturesInput } from "./errors-De_fISnn.js";
+import { $ as SubscriptionChangePreviewInput, A as FeatureUpdate, At as currentApiVersion, B as PlanFeaturesInput, C as CustomerMemberUpdate, Ct as ApiVersion, D as FeatureCreate, Dt as LatestApiVersion, E as EventSelector, Et as LATEST_API_VERSION, F as KEY_PATTERN, G as ProductCheckoutCreate, H as PlanPriceInput, I as PaymentLinkCreate, J as ProductUpdate, K as ProductCreate, L as PaymentLinkUpdate, M as FulfillmentTrackingInput, Mt as isApiVersionRetired, N as InvoiceCreate, Nt as supportedApiVersions, O as FeatureOperationCommit, Ot as apiVersionLifecycle, P as InvoiceLineInput, Q as SubscriptionChangeCreate, R as PlanCheckoutCreate, S as CustomerMemberCreate, St as API_VERSION_PATTERN, T as CustomerUpdate, Tt as ApiVersionStage, U as PlanUpdate, V as PlanLinkCreate, W as PortalSessionCreate, X as RetireInput, Y as RefundCreate, Z as SubscriptionCancel, _ as CouponCreate, _t as PublicPaymentLink, a as CheckoutCreate, at as CustomerSubscription, b as CustomerCreate, bt as API_VERSIONS, c as ClientCheckoutUpdate, ct as PaymentInstructions, d as ClientLinkCheckout, dt as PaymentNextAction, et as SubscriptionCreate, f as ClientPaymentCode, ft as PaymentTestScenario, g as CollectInput, gt as PublicInvoice, h as ClientSubscriptionUpdate, ht as PublicFulfillment, i as AfterCompletionInput, it as WebhookEndpointUpdate, j as FulfillmentInput, jt as isApiVersion, k as FeatureOperationCreate, kt as apiVersionStage, l as ClientFulfillmentProblem, lt as PaymentMethodField, m as ClientSubscriptionSeats, mt as PublicCheckout, n as RequestOptions, nt as VariantInput, o as CheckoutItemInput, ot as CustomerSubscriptionChangeResult, p as ClientSubscriptionCancel, pt as PortalFeatures, q as ProductLinkCreate, r as TransportOptions, rt as WebhookEndpointCreate, s as ClientCheckoutPay, st as FulfillmentOption, t as BilleteError, tt as SubscriptionUpdate, u as ClientInvoicePay, ut as PaymentMethodOption, v as CouponUpdate, vt as PublicPaymentState, w as CustomerSessionCreate, wt as ApiVersionLifecycle, x as CustomerInput, xt as API_VERSION_HEADER, y as CustomFieldInput, yt as PublicPortal, z as PlanCreate } from "./errors-BRQlJDjy.js";
+import { $ as PRODUCT_CATEGORIES, $t as ListQuery, A as ExchangeRate, At as SubscriptionTerms, B as Fulfillment, Bt as PAYMENT_FAILURE_CODES, C as Customer, Ct as SubmitLabel, D as CustomerMemberList, Dt as SubscriptionChangeResult, E as CustomerMember, Et as SubscriptionChangePreview, F as FeatureOperation, Ft as ReceiptSend, G as INVOICE_REASONS, Gt as BILLING_MONTHS, H as FulfillmentMethod, Ht as ACCOUNT_NUMBER_LENGTH, I as FeatureOperationResult, It as API_ERROR_TYPES, J as InvoiceReason, Jt as CURRENCIES, K as INVOICE_STATUSES, Kt as BankCode, L as FeatureReset, Lt as ApiErrorBody, M as FULFILLMENT_METHODS, Mt as WebhookEndpoint, N as FULFILLMENT_STATUSES, Nt as Weekday, O as CustomerSession, Ot as SubscriptionRenewal, P as Feature, Pt as ReceiptReference, Q as PAYMENT_STATUSES, Qt as List, R as FeatureType, Rt as ApiErrorEnvelope, S as CustomField, St as SUBSCRIPTION_STATUSES, T as CustomerFeature, Tt as SubscriptionChange, U as FulfillmentStatus, Ut as Address, V as FulfillmentChoice, Vt as PaymentFailureCode, W as FulfillmentTracking, Wt as AddressInput, X as LineItem, Xt as GRACE_PERIOD_DAYS, Y as InvoiceStatus, Yt as Currency, Z as MAX_SEATS, Zt as GracePeriodDays, _ as CheckoutItem, _n as tokenPrefix, _t as Refund, a as Actor, an as TAX_BEHAVIORS, at as PaymentStatus, b as Coupon, bt as RiskLevel, c as BalanceAmount, cn as VENEZUELAN_BANKS, ct as PlanFeatureValues, d as CARRIER_TEST_SCENARIOS, dn as isMobilePhone, dt as PortalSession, en as ListSort, et as Payment, f as CHECKOUT_PURPOSES, fn as nationalPhone, ft as Product, g as Checkout, gn as tokenEnvironment, gt as RISK_LEVELS, h as CarrierOffice, hn as TokenKind, ht as RESET_FREQUENCIES, i as WebhookEvent, in as MobilePrefix, it as PaymentSettlement, j as FEATURE_TYPES, jt as USAGE_FEATURE_TYPES, k as Event, kt as SubscriptionStatus, l as CANCELLATION_FEEDBACK, ln as findBank, lt as PlanPrice, m as Carrier, mn as Environment, mt as ProductVariant, n as EventDataMap, nn as MOBILE_PREFIXES, nt as PaymentFailure, o as AfterCompletion, on as TaxBehavior, ot as Payout, p as CancellationFeedback, pn as ENVIRONMENTS, pt as ProductCategory, q as Invoice, qt as BillingMonths, r as EventType, rn as Metadata, rt as PaymentLink, s as Balance, sn as Timestamp, st as Plan, t as EVENT_TYPES, tn as MAX_QUANTITY, tt as PaymentAttempt, u as CARRIERS, un as isLandlinePhone, ut as PlanSeats, v as CheckoutPurpose, vt as ResetFrequency, w as CustomerDetails, wt as Subscription, x as CurrencyAvailability, xt as SUBMIT_LABELS, y as CollectSettings, yt as Retirement, z as FeatureUsageResult, zt as ApiErrorType } from "./events-rtkF8fBQ.js";
 //#region src/create-client.d.ts
 interface ClientOptions extends TransportOptions {
   /**
@@ -14,12 +14,12 @@ interface ClientOptions extends TransportOptions {
  * and customer data requires a short-lived customer session minted by your server.
  *
  * ```ts
- * const billete = createClient({ customerSession: token });
+ * const billete = createClient({ apiVersion: "2026-10-09", customerSession: token });
  * const [subscription] = (await billete.customer.subscriptions()).data;
  * if (subscription?.renewal?.status === "overdue") showBanner(subscription.renewal);
  * ```
  */
-export declare function createClient(options?: ClientOptions): {
+export declare function createClient(options: ClientOptions): {
   /** Offices offered by a carrier, refreshed daily by Billete. */
   carrierOffices: (carrier: Carrier, options?: RequestOptions) => Promise<List<CarrierOffice>>;
   checkouts: {
@@ -94,6 +94,11 @@ export declare function createClient(options?: ClientOptions): {
     resumeSubscription: (id: string, options?: RequestOptions) => Promise<CustomerSubscription>;
     /** Switches the billing cycle from the next renewal. */
     updateSubscription: (id: string, input: ClientSubscriptionUpdate, options?: RequestOptions) => Promise<CustomerSubscription>;
+    /**
+     * Buys more seats now, paid in the checkout it returns (`type: "checkout"`), or leaves fewer
+     * from the next renewal; during a trial both apply now. Only for plans charged per seat.
+     */
+    changeSeats: (id: string, input: ClientSubscriptionSeats, options?: RequestOptions) => Promise<CustomerSubscriptionChangeResult>;
     /** Withdraws the mandate: renewals are then paid by hand from their Cobro. */
     stopAutoCharge: (id: string, options?: RequestOptions) => Promise<CustomerSubscription>;
     features: (options?: RequestOptions) => Promise<List<CustomerFeature>>;
@@ -102,4 +107,4 @@ export declare function createClient(options?: ClientOptions): {
 };
 type BilleteClient = ReturnType<typeof createClient>;
 //#endregion
-export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_TYPES, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, 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 CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientOptions, type ClientPaymentCode, type ClientSubscriptionCancel, 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 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 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 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 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 ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, 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 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 WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, type Weekday, type findBank, type isLandlinePhone, type isMobilePhone, type nationalPhone, type tokenEnvironment, type tokenPrefix };
+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 CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, 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 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 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 ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, 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 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 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-DNd4UhbT.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-PMxK43GM.js";
 //#region src/create-client.ts
 /**
 * Browser client. It never holds a secret key: checkouts and Cobros are addressed by their
@@ -6,12 +6,12 @@ import { n as segment, r as BilleteError, t as createTransport } from "./http-DN
 * and customer data requires a short-lived customer session minted by your server.
 *
 * ```ts
-* const billete = createClient({ customerSession: token });
+* const billete = createClient({ apiVersion: "2026-10-09", customerSession: token });
 * const [subscription] = (await billete.customer.subscriptions()).data;
 * if (subscription?.renewal?.status === "overdue") showBanner(subscription.renewal);
 * ```
 */
-function createClient(options = {}) {
+function createClient(options) {
 	const session = options.customerSession;
 	const http = createTransport({
 		...options,
@@ -195,6 +195,16 @@ list: (options) => http.request({
 				body: input,
 				options
 			}),
+			/**
+			* Buys more seats now, paid in the checkout it returns (`type: "checkout"`), or leaves fewer
+			* from the next renewal; during a trial both apply now. Only for plans charged per seat.
+			*/
+			changeSeats: (id, input, options) => http.request({
+				method: "POST",
+				path: `/v1/client/customer/subscriptions/${segment(id)}/seats`,
+				body: input,
+				options
+			}),
 			/** Withdraws the mandate: renewals are then paid by hand from their Cobro. */
 			stopAutoCharge: (id, options) => http.request({
 				method: "POST",

package/dist/{errors-De_fISnn.d.ts → errors-BRQlJDjy.d.ts}

@@ -1,4 +1,48 @@
-import { B as Fulfillment, Ct as SubmitLabel, H as FulfillmentMethod, J as InvoiceReason, L as FeatureReset, Lt as ApiErrorBody, Pt as ReceiptReference, S as CustomField, U as FulfillmentStatus, Ut as Address, W as FulfillmentTracking, Wt as AddressInput, X as LineItem, Y as InvoiceStatus, Yt as Currency, Zt as GracePeriodDays, _ as CheckoutItem, at as PaymentStatus, h as CarrierOffice, lt as PlanPrice, m as Carrier, mn as Environment, nt as PaymentFailure, o as AfterCompletion, on as TaxBehavior, p as CancellationFeedback, pt as ProductCategory, qt as BillingMonths, r as EventType, rn as Metadata, sn as Timestamp, ut as PlanSeats, v as CheckoutPurpose, w as CustomerDetails, wt as Subscription, y as CollectSettings, zt as ApiErrorType } from "./events-Dz2ghaMl.js";
+import { B as Fulfillment, Ct as SubmitLabel, H as FulfillmentMethod, J as InvoiceReason, L as FeatureReset, Lt as ApiErrorBody, Pt as ReceiptReference, S as CustomField, U as FulfillmentStatus, Ut as Address, W as FulfillmentTracking, Wt as AddressInput, X as LineItem, Y as InvoiceStatus, Yt as Currency, Zt as GracePeriodDays, _ as CheckoutItem, at as PaymentStatus, h as CarrierOffice, lt as PlanPrice, m as Carrier, mn as Environment, nt as PaymentFailure, o as AfterCompletion, on as TaxBehavior, p as CancellationFeedback, pt as ProductCategory, qt as BillingMonths, r as EventType, rn as Metadata, sn as Timestamp, ut as PlanSeats, v as CheckoutPurpose, w as CustomerDetails, wt as Subscription, y as CollectSettings, zt as ApiErrorType } from "./events-rtkF8fBQ.js";
+//#region ../contracts/src/api-versions.d.ts
+/**
+ * Billete API versions. Kept free of runtime dependencies: the dashboard, the API, the worker and
+ * the docs read it, and the public SDK pins its newest entry as a type.
+ *
+ * A version is named after the day it was published: `2026-11-01` is stable and
+ * `2026-11-01.beta` is a beta. Once published a version never changes; anything incompatible
+ * ships as a new version. Additive changes (new endpoints, optional fields) reach every version
+ * 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"];
+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. */
+declare const LATEST_API_VERSION: LatestApiVersion;
+/** The request header that names the version a request is written against. */
+declare const API_VERSION_HEADER = "Billete-Version";
+declare const API_VERSION_PATTERN: RegExp;
+type ApiVersionStage = "stable" | "beta";
+interface ApiVersionLifecycle {
+  stage: ApiVersionStage;
+  /** Day it was published (UTC), `YYYY-MM-DD`. */
+  releasedOn: string;
+  /** Day merchants start hearing about its retirement, once a successor exists. */
+  noticeOn: string | null;
+  /** First day requests with it are rejected, once a successor exists. */
+  retiresOn: string | null;
+}
+declare function isApiVersion(value: string): value is ApiVersion;
+declare function apiVersionStage(version: string): ApiVersionStage;
+/**
+ * When a version was published, when its retirement is announced and when it stops working. Both
+ * dates follow from the registry alone (a successor stable version starts the clock), so retiring a
+ * version needs no manual step.
+ */
+declare function apiVersionLifecycle(version: string, registry?: readonly string[]): ApiVersionLifecycle;
+declare function isApiVersionRetired(version: string, now: Date, registry?: readonly string[]): boolean;
+/** Versions that still work on `now`, oldest first. */
+declare function supportedApiVersions(now: Date): ApiVersion[];
+declare function supportedApiVersions<T extends string>(now: Date, registry: readonly T[]): T[];
+/** What new integrations should use: the newest stable version, or the newest beta before any. */
+declare function currentApiVersion(): ApiVersion;
+//#endregion
 //#region ../contracts/src/client.d.ts
 /**
  * A subscription as its customer sees it, in the browser: without the business's `metadata`, with
@@ -8,8 +52,20 @@ interface CustomerSubscription extends Omit<Subscription, "metadata"> {
   plan: {
     name: string;
     cycles: PlanPrice[];
+    seats: PlanSeats;
   };
 }
+/** What a customer's change from the portal did: applied, scheduled, or a checkout to pay it. */
+type CustomerSubscriptionChangeResult = {
+  type: "applied" | "scheduled";
+  subscription: CustomerSubscription;
+} | {
+  type: "checkout";
+  checkout: {
+    id: string;
+    url: string;
+  };
+};
 /** What the business lets its customers do from the portal. */
 interface PortalFeatures {
   /** Paid and closed Cobros are listed; open ones always are, so they can be paid. */
@@ -20,6 +76,8 @@ interface PortalFeatures {
   cancellationReasons: boolean;
   /** Switch between the plan's billing cycles, from the next renewal. */
   switchCycle: boolean;
+  /** Buy more seats of a plan charged per seat, or fewer from the next renewal. */
+  changeSeats: boolean;
   /** Turn off automatic charging and pay each renewal by hand. */
   stopAutoCharge: boolean;
 }
@@ -129,9 +187,14 @@ interface PublicCheckout {
   trialDays: number | null;
   couponCode: string | null;
   allowCoupons: boolean;
-  /** The customer may change the quantity of the single item. */
+  /** The customer may change the quantity of the single item: units, or seats of a plan. */
   adjustableQuantity: boolean;
-  /** Most units the customer can choose right now: the link's limit, capped by stock. */
+  /** Fewest units the customer can choose: 1, or the plan's minimum seats. */
+  minQuantity: number;
+  /**
+   * Most units the customer can choose right now: the link's limit, capped by stock, or the
+   * plan's maximum seats.
+   */
   maxQuantity: number;
   /**
    * Variants the customer may switch between for a product checkout. `maxQuantity` is the most
@@ -350,9 +413,15 @@ interface PublicPaymentLink {
     trialDays: number;
     cycles: PlanPrice[];
   } | null;
-  /** The customer chooses how many units to buy; otherwise every purchase is one unit. */
+  /**
+   * The customer chooses how many units to buy, or how many seats of a plan charged per seat;
+   * otherwise every purchase is one unit, or the plan's minimum seats.
+   */
   adjustableQuantity: boolean;
-  /** Most units per purchase when `adjustableQuantity`; `null` leaves stock as the only limit. */
+  /**
+   * Most units (or seats) per purchase when `adjustableQuantity`; `null` leaves stock (or the
+   * plan's maximum) as the only limit.
+   */
   maxQuantity: number | null;
   /** Effective required details; fulfillment adds name and phone to the saved preferences. */
   collect: CollectSettings;
@@ -383,10 +452,16 @@ interface CustomerUpdate {
 interface CustomerMemberCreate {
   externalId: string;
   name?: string;
+  /**
+   * Takes a seat before the others when there are fewer seats than active members (the
+   * organization's admin, say). Defaults to `false`.
+   */
+  priority?: boolean;
   metadata?: Metadata;
 }
 interface CustomerMemberUpdate {
   name?: string | null;
+  priority?: boolean;
   metadata?: Metadata;
 }
 interface FeatureOperationCreate {
@@ -537,9 +612,19 @@ interface SubscriptionChangePreviewInput {
   plan?: string;
   months?: BillingMonths;
   quantity?: number;
+  /**
+   * During a trial a change made `now` applies at no cost and the trial goes on; `true` ends the
+   * trial instead and charges the new terms from today.
+   */
+  endTrial?: boolean;
 }
 interface SubscriptionChangeCreate extends SubscriptionChangePreviewInput {
   when: "now" | "renewal";
+  /**
+   * Accepts a change that leaves fewer seats than active members: the ones without a seat lose
+   * access (`enabled: false`) until seats free up. Otherwise it fails with `seats_in_use`.
+   */
+  disableExcessMembers?: boolean;
   acceptUnusedCredit?: boolean;
   successUrl?: string;
   cancelUrl?: string;
@@ -615,6 +700,13 @@ interface PlanLinkCreate extends PaymentLinkFields {
   type: "plan";
   plan: string;
   months?: BillingMonths[];
+  /**
+   * Lets the customer choose how many seats to buy, within the plan's range; only for plans
+   * charged per seat. Defaults to the plan's minimum.
+   */
+  adjustableQuantity?: boolean;
+  /** Most seats per purchase; only with `adjustableQuantity`. Omit to allow the plan's maximum. */
+  maxQuantity?: number;
 }
 type PaymentLinkCreate = ProductLinkCreate | PlanLinkCreate;
 interface PaymentLinkUpdate {
@@ -650,7 +742,14 @@ interface ProductCheckoutCreate extends CheckoutFields {
   items: CheckoutItemInput[];
 }
 interface PlanCheckoutCreate extends CheckoutFields {
+  /** Seats of a plan charged per seat; fixed unless `adjustableQuantity`. */
   quantity?: number;
+  /**
+   * Lets the customer choose the seats in the checkout, within the plan's range, starting at
+   * `quantity` (or the plan's minimum). Defaults to `true` for a plan charged per seat when
+   * `quantity` is omitted.
+   */
+  adjustableQuantity?: boolean;
   plan: string;
   months: BillingMonths;
 }
@@ -705,11 +804,15 @@ type EventSelector = "*" | EventType;
 interface WebhookEndpointCreate {
   url: string;
   events: EventSelector[];
+  /** Version its events are delivered in. Defaults to the version of the request. */
+  apiVersion?: ApiVersion;
 }
 interface WebhookEndpointUpdate {
   url?: string;
   events?: EventSelector[];
   enabled?: boolean;
+  /** Moves the endpoint to another supported version; its next deliveries use it. */
+  apiVersion?: ApiVersion;
 }
 interface CustomerSessionCreate {
   customer: string;
@@ -724,6 +827,13 @@ interface PortalSessionCreate {
 interface ClientSubscriptionUpdate {
   months: BillingMonths;
 }
+/**
+ * The seats a customer wants from the portal: more are paid now for what is left of the period;
+ * fewer apply from the next renewal (during a trial, both apply now).
+ */
+interface ClientSubscriptionSeats {
+  quantity: number;
+}
 interface ClientCheckoutUpdate {
   quantity?: number;
   variant?: string;
@@ -776,6 +886,13 @@ interface ClientFulfillmentProblem {
 //#endregion
 //#region src/http.d.ts
 interface TransportOptions {
+  /**
+   * The Billete API version your integration is written against. Required: Billete never changes
+   * a published version, so your integration keeps working until you choose to upgrade. Each SDK
+   * release speaks exactly one version; upgrading the SDK to a new major asks you to set the new
+   * one after reading what changed.
+   */
+  apiVersion: LatestApiVersion;
   /** Defaults to `BILLETE_BASE_URL` on the server, then `https://api.billete.run`. Use
    * `http://localhost:9999` in development. */
   baseUrl?: string;
@@ -804,4 +921,4 @@ declare class BilleteError extends Error {
   }, status: number);
 }
 //#endregion
-export { SubscriptionCreate as $, FulfillmentInput as A, PlanLinkCreate as B, CustomerSessionCreate as C, FeatureOperationCommit as D, FeatureCreate as E, PaymentLinkCreate as F, ProductCreate as G, PlanUpdate as H, PaymentLinkUpdate as I, RefundCreate as J, ProductLinkCreate as K, PlanCheckoutCreate as L, InvoiceCreate as M, InvoiceLineInput as N, FeatureOperationCreate as O, KEY_PATTERN as P, SubscriptionChangePreviewInput as Q, PlanCreate as R, CustomerMemberUpdate as S, EventSelector as T, PortalSessionCreate as U, PlanPriceInput as V, ProductCheckoutCreate as W, SubscriptionCancel as X, RetireInput as Y, SubscriptionChangeCreate as Z, CouponUpdate as _, PublicPortal as _t, CheckoutCreate as a, FulfillmentOption as at, CustomerInput as b, ClientCheckoutUpdate as c, PaymentMethodOption as ct, ClientLinkCheckout as d, PortalFeatures as dt, SubscriptionUpdate as et, ClientPaymentCode as f, PublicCheckout as ft, CouponCreate as g, PublicPaymentState as gt, CollectInput as h, PublicPaymentLink as ht, AfterCompletionInput as i, CustomerSubscription as it, FulfillmentTrackingInput as j, FeatureUpdate as k, ClientFulfillmentProblem as l, PaymentNextAction as lt, ClientSubscriptionUpdate as m, PublicInvoice as mt, RequestOptions as n, WebhookEndpointCreate as nt, CheckoutItemInput as o, PaymentInstructions as ot, ClientSubscriptionCancel as p, PublicFulfillment as pt, ProductUpdate as q, TransportOptions as r, WebhookEndpointUpdate as rt, ClientCheckoutPay as s, PaymentMethodField as st, BilleteError as t, VariantInput as tt, ClientInvoicePay as u, PaymentTestScenario as ut, CustomFieldInput as v, CustomerUpdate as w, CustomerMemberCreate as x, CustomerCreate as y, PlanFeaturesInput as z };
+export { SubscriptionChangePreviewInput as $, FeatureUpdate as A, currentApiVersion as At, PlanFeaturesInput as B, CustomerMemberUpdate as C, ApiVersion as Ct, FeatureCreate as D, LatestApiVersion as Dt, EventSelector as E, LATEST_API_VERSION as Et, KEY_PATTERN as F, ProductCheckoutCreate as G, PlanPriceInput as H, PaymentLinkCreate as I, ProductUpdate as J, ProductCreate as K, PaymentLinkUpdate as L, FulfillmentTrackingInput as M, isApiVersionRetired as Mt, InvoiceCreate as N, supportedApiVersions as Nt, FeatureOperationCommit as O, apiVersionLifecycle as Ot, InvoiceLineInput as P, SubscriptionChangeCreate as Q, PlanCheckoutCreate as R, CustomerMemberCreate as S, API_VERSION_PATTERN as St, CustomerUpdate as T, ApiVersionStage as Tt, PlanUpdate as U, PlanLinkCreate as V, PortalSessionCreate as W, RetireInput as X, RefundCreate as Y, SubscriptionCancel as Z, CouponCreate as _, PublicPaymentLink as _t, CheckoutCreate as a, CustomerSubscription as at, CustomerCreate as b, API_VERSIONS as bt, ClientCheckoutUpdate as c, PaymentInstructions as ct, ClientLinkCheckout as d, PaymentNextAction as dt, SubscriptionCreate as et, ClientPaymentCode as f, PaymentTestScenario as ft, CollectInput as g, PublicInvoice as gt, ClientSubscriptionUpdate as h, PublicFulfillment as ht, AfterCompletionInput as i, WebhookEndpointUpdate as it, FulfillmentInput as j, isApiVersion as jt, FeatureOperationCreate as k, apiVersionStage as kt, ClientFulfillmentProblem as l, PaymentMethodField as lt, ClientSubscriptionSeats as m, PublicCheckout as mt, RequestOptions as n, VariantInput as nt, CheckoutItemInput as o, CustomerSubscriptionChangeResult as ot, ClientSubscriptionCancel as p, PortalFeatures as pt, ProductLinkCreate as q, TransportOptions as r, WebhookEndpointCreate as rt, ClientCheckoutPay as s, FulfillmentOption as st, BilleteError as t, SubscriptionUpdate as tt, ClientInvoicePay as u, PaymentMethodOption as ut, CouponUpdate as v, PublicPaymentState as vt, CustomerSessionCreate as w, ApiVersionLifecycle as wt, CustomerInput as x, API_VERSION_HEADER as xt, CustomFieldInput as y, PublicPortal as yt, PlanCreate as z };

package/dist/{events-Dz2ghaMl.d.ts → events-rtkF8fBQ.d.ts}

@@ -304,6 +304,9 @@ interface CustomerMember extends Resource<"customer_member"> {
   externalId: string;
   name: string | null;
   status: "active" | "removed";
+  /** Takes a seat before members without priority; then the longest active go first. */
+  priority: boolean;
+  /** Active and within the seats: what the customer's subscriptions grant all add up. */
   enabled: boolean;
   activeSince: Timestamp;
   removedAt: Timestamp | null;
@@ -590,9 +593,15 @@ interface PaymentLink extends Resource<"payment_link">, Retirement {
   productId: string | null;
   /** Variants offered for a product link; `null` offers every active variant. */
   variantIds: string[] | null;
-  /** The customer chooses how many units to buy; otherwise every purchase is one unit. */
+  /**
+   * The customer chooses how many units to buy, or how many seats of a plan charged per seat;
+   * otherwise every purchase is one unit, or the plan's minimum seats.
+   */
   adjustableQuantity: boolean;
-  /** Most units per purchase when `adjustableQuantity`; `null` leaves stock as the only limit. */
+  /**
+   * Most units (or seats) per purchase when `adjustableQuantity`; `null` leaves stock (or the
+   * plan's maximum) as the only limit.
+   */
   maxQuantity: number | null;
   planId: string | null;
   /** Billing cycles offered for a plan link; `null` offers every plan price. */
@@ -700,6 +709,11 @@ interface SubscriptionChangePreview {
   version: number;
   currentPeriodEnd: Timestamp;
   periodEndIfPaidNow?: Timestamp;
+  /**
+   * Active members the change leaves without a seat: remove them first, or accept it with
+   * `disableExcessMembers`.
+   */
+  excessMembers: number;
 }
 type SubscriptionChangeResult = {
   type: "scheduled" | "applied";
@@ -983,12 +997,19 @@ interface Payout extends Resource<"payout"> {
 interface WebhookEndpoint extends Resource<"webhook_endpoint"> {
   url: string;
   events: string[];
+  /**
+   * Version its events are delivered in. Typed as text: responses never change shape when new
+   * versions are published.
+   */
+  apiVersion: string;
   enabled: boolean;
   /** Returned only when the endpoint is created. */
   secret?: string;
 }
 interface Event<TData = Record<string, unknown>> extends Resource<"event"> {
   type: string;
+  /** The version whose shape `data` is in: the request's, or the webhook endpoint's. */
+  apiVersion: string;
   data: TData;
 }
 interface ExchangeRate {
@@ -1080,6 +1101,8 @@ type WebhookEvent = { [TType in EventType]: {
   id: string;
   object: "event";
   type: TType;
+  /** The webhook endpoint's version: `data` comes in its shape. */
+  apiVersion: string;
   environment: Environment;
   createdAt: string;
   data: EventDataMap[TType];

package/dist/{http-DNd4UhbT.js → http-PMxK43GM.js}

@@ -18,7 +18,7 @@ var BilleteError = class extends Error {
 };
 //#endregion
 //#region src/http.ts
-const SDK_VERSION = "1.1.0-canary.6";
+const SDK_VERSION = "3.0.0";
 const DEFAULT_BASE_URL = "https://api.billete.run";
 const RETRYABLE_STATUS = /* @__PURE__ */ new Set([
 	429,
@@ -58,6 +58,7 @@ async function toError(response) {
 	}, response.status);
 }
 function createTransport(options) {
+	if (!options.apiVersion) throw new TypeError("Billete needs apiVersion: the API version your integration is written against");
 	const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
 	const fetchImpl = options.fetch ?? ((...args) => globalThis.fetch(...args));
 	const timeoutMs = options.timeoutMs ?? 3e4;
@@ -66,6 +67,7 @@ function createTransport(options) {
 		const token = options.token?.();
 		const headers = {
 			Accept: "application/json",
+			"Billete-Version": options.apiVersion,
 			"X-Billete-Client": `billete-js/${SDK_VERSION}`,
 			...token ? { Authorization: `Bearer ${token}` } : {},
 			...request.body === void 0 ? {} : { "Content-Type": "application/json" },

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as PRODUCT_CATEGORIES, $t as ListQuery, A as ExchangeRate, At as SubscriptionTerms, B as Fulfillment, Bt as PAYMENT_FAILURE_CODES, C as Customer, Ct as SubmitLabel, D as CustomerMemberList, Dt as SubscriptionChangeResult, E as CustomerMember, Et as SubscriptionChangePreview, F as FeatureOperation, Ft as ReceiptSend, G as INVOICE_REASONS, Gt as BILLING_MONTHS, H as FulfillmentMethod, Ht as ACCOUNT_NUMBER_LENGTH, I as FeatureOperationResult, It as API_ERROR_TYPES, J as InvoiceReason, Jt as CURRENCIES, K as INVOICE_STATUSES, Kt as BankCode, L as FeatureReset, Lt as ApiErrorBody, M as FULFILLMENT_METHODS, Mt as WebhookEndpoint, N as FULFILLMENT_STATUSES, Nt as Weekday, O as CustomerSession, Ot as SubscriptionRenewal, P as Feature, Pt as ReceiptReference, Q as PAYMENT_STATUSES, Qt as List, R as FeatureType, Rt as ApiErrorEnvelope, S as CustomField, St as SUBSCRIPTION_STATUSES, T as CustomerFeature, Tt as SubscriptionChange, U as FulfillmentStatus, Ut as Address, V as FulfillmentChoice, Vt as PaymentFailureCode, W as FulfillmentTracking, Wt as AddressInput, X as LineItem, Xt as GRACE_PERIOD_DAYS, Y as InvoiceStatus, Yt as Currency, Z as MAX_SEATS, Zt as GracePeriodDays, _ as CheckoutItem, _n as tokenPrefix, _t as Refund, a as Actor, an as TAX_BEHAVIORS, at as PaymentStatus, b as Coupon, bt as RiskLevel, c as BalanceAmount, cn as VENEZUELAN_BANKS, ct as PlanFeatureValues, d as CARRIER_TEST_SCENARIOS, dn as isMobilePhone, dt as PortalSession, en as ListSort, et as Payment, f as CHECKOUT_PURPOSES, fn as nationalPhone, ft as Product, g as Checkout, gn as tokenEnvironment, gt as RISK_LEVELS, h as CarrierOffice, hn as TokenKind, ht as RESET_FREQUENCIES, i as WebhookEvent, in as MobilePrefix, it as PaymentSettlement, j as FEATURE_TYPES, jt as USAGE_FEATURE_TYPES, k as Event, kt as SubscriptionStatus, l as CANCELLATION_FEEDBACK, ln as findBank, lt as PlanPrice, m as Carrier, mn as Environment, mt as ProductVariant, n as EventDataMap, nn as MOBILE_PREFIXES, nt as PaymentFailure, o as AfterCompletion, on as TaxBehavior, ot as Payout, p as CancellationFeedback, pn as ENVIRONMENTS, pt as ProductCategory, q as Invoice, qt as BillingMonths, r as EventType, rn as Metadata, rt as PaymentLink, s as Balance, sn as Timestamp, st as Plan, t as EVENT_TYPES, tn as MAX_QUANTITY, tt as PaymentAttempt, u as CARRIERS, un as isLandlinePhone, ut as PlanSeats, v as CheckoutPurpose, vt as ResetFrequency, w as CustomerDetails, wt as Subscription, x as CurrencyAvailability, xt as SUBMIT_LABELS, y as CollectSettings, yt as Retirement, z as FeatureUsageResult, zt as ApiErrorType } from "./events-Dz2ghaMl.js";
-import { $ as SubscriptionCreate, A as FulfillmentInput, B as PlanLinkCreate, C as CustomerSessionCreate, D as FeatureOperationCommit, E as FeatureCreate, F as PaymentLinkCreate, G as ProductCreate, H as PlanUpdate, I as PaymentLinkUpdate, J as RefundCreate, K as ProductLinkCreate, L as PlanCheckoutCreate, M as InvoiceCreate, N as InvoiceLineInput, O as FeatureOperationCreate, P as KEY_PATTERN, Q as SubscriptionChangePreviewInput, R as PlanCreate, S as CustomerMemberUpdate, T as EventSelector, U as PortalSessionCreate, V as PlanPriceInput, W as ProductCheckoutCreate, X as SubscriptionCancel, Y as RetireInput, Z as SubscriptionChangeCreate, _ as CouponUpdate, _t as PublicPortal, a as CheckoutCreate, at as FulfillmentOption, b as CustomerInput, c as ClientCheckoutUpdate, ct as PaymentMethodOption, d as ClientLinkCheckout, dt as PortalFeatures, et as SubscriptionUpdate, f as ClientPaymentCode, ft as PublicCheckout, g as CouponCreate, gt as PublicPaymentState, h as CollectInput, ht as PublicPaymentLink, i as AfterCompletionInput, it as CustomerSubscription, j as FulfillmentTrackingInput, k as FeatureUpdate, l as ClientFulfillmentProblem, lt as PaymentNextAction, m as ClientSubscriptionUpdate, mt as PublicInvoice, n as RequestOptions, nt as WebhookEndpointCreate, o as CheckoutItemInput, ot as PaymentInstructions, p as ClientSubscriptionCancel, pt as PublicFulfillment, q as ProductUpdate, r as TransportOptions, rt as WebhookEndpointUpdate, s as ClientCheckoutPay, st as PaymentMethodField, t as BilleteError, tt as VariantInput, u as ClientInvoicePay, ut as PaymentTestScenario, v as CustomFieldInput, w as CustomerUpdate, x as CustomerMemberCreate, y as CustomerCreate, z as PlanFeaturesInput } from "./errors-De_fISnn.js";
+import { $ as SubscriptionChangePreviewInput, A as FeatureUpdate, At as currentApiVersion, B as PlanFeaturesInput, C as CustomerMemberUpdate, Ct as ApiVersion, D as FeatureCreate, Dt as LatestApiVersion, E as EventSelector, Et as LATEST_API_VERSION, F as KEY_PATTERN, G as ProductCheckoutCreate, H as PlanPriceInput, I as PaymentLinkCreate, J as ProductUpdate, K as ProductCreate, L as PaymentLinkUpdate, M as FulfillmentTrackingInput, Mt as isApiVersionRetired, N as InvoiceCreate, Nt as supportedApiVersions, O as FeatureOperationCommit, Ot as apiVersionLifecycle, P as InvoiceLineInput, Q as SubscriptionChangeCreate, R as PlanCheckoutCreate, S as CustomerMemberCreate, St as API_VERSION_PATTERN, T as CustomerUpdate, Tt as ApiVersionStage, U as PlanUpdate, V as PlanLinkCreate, W as PortalSessionCreate, X as RetireInput, Y as RefundCreate, Z as SubscriptionCancel, _ as CouponCreate, _t as PublicPaymentLink, a as CheckoutCreate, at as CustomerSubscription, b as CustomerCreate, bt as API_VERSIONS, c as ClientCheckoutUpdate, ct as PaymentInstructions, d as ClientLinkCheckout, dt as PaymentNextAction, et as SubscriptionCreate, f as ClientPaymentCode, ft as PaymentTestScenario, g as CollectInput, gt as PublicInvoice, h as ClientSubscriptionUpdate, ht as PublicFulfillment, i as AfterCompletionInput, it as WebhookEndpointUpdate, j as FulfillmentInput, jt as isApiVersion, k as FeatureOperationCreate, kt as apiVersionStage, l as ClientFulfillmentProblem, lt as PaymentMethodField, m as ClientSubscriptionSeats, mt as PublicCheckout, n as RequestOptions, nt as VariantInput, o as CheckoutItemInput, ot as CustomerSubscriptionChangeResult, p as ClientSubscriptionCancel, pt as PortalFeatures, q as ProductLinkCreate, r as TransportOptions, rt as WebhookEndpointCreate, s as ClientCheckoutPay, st as FulfillmentOption, t as BilleteError, tt as SubscriptionUpdate, u as ClientInvoicePay, ut as PaymentMethodOption, v as CouponUpdate, vt as PublicPaymentState, w as CustomerSessionCreate, wt as ApiVersionLifecycle, x as CustomerInput, xt as API_VERSION_HEADER, y as CustomFieldInput, yt as PublicPortal, z as PlanCreate } from "./errors-BRQlJDjy.js";
+import { $ as PRODUCT_CATEGORIES, $t as ListQuery, A as ExchangeRate, At as SubscriptionTerms, B as Fulfillment, Bt as PAYMENT_FAILURE_CODES, C as Customer, Ct as SubmitLabel, D as CustomerMemberList, Dt as SubscriptionChangeResult, E as CustomerMember, Et as SubscriptionChangePreview, F as FeatureOperation, Ft as ReceiptSend, G as INVOICE_REASONS, Gt as BILLING_MONTHS, H as FulfillmentMethod, Ht as ACCOUNT_NUMBER_LENGTH, I as FeatureOperationResult, It as API_ERROR_TYPES, J as InvoiceReason, Jt as CURRENCIES, K as INVOICE_STATUSES, Kt as BankCode, L as FeatureReset, Lt as ApiErrorBody, M as FULFILLMENT_METHODS, Mt as WebhookEndpoint, N as FULFILLMENT_STATUSES, Nt as Weekday, O as CustomerSession, Ot as SubscriptionRenewal, P as Feature, Pt as ReceiptReference, Q as PAYMENT_STATUSES, Qt as List, R as FeatureType, Rt as ApiErrorEnvelope, S as CustomField, St as SUBSCRIPTION_STATUSES, T as CustomerFeature, Tt as SubscriptionChange, U as FulfillmentStatus, Ut as Address, V as FulfillmentChoice, Vt as PaymentFailureCode, W as FulfillmentTracking, Wt as AddressInput, X as LineItem, Xt as GRACE_PERIOD_DAYS, Y as InvoiceStatus, Yt as Currency, Z as MAX_SEATS, Zt as GracePeriodDays, _ as CheckoutItem, _n as tokenPrefix, _t as Refund, a as Actor, an as TAX_BEHAVIORS, at as PaymentStatus, b as Coupon, bt as RiskLevel, c as BalanceAmount, cn as VENEZUELAN_BANKS, ct as PlanFeatureValues, d as CARRIER_TEST_SCENARIOS, dn as isMobilePhone, dt as PortalSession, en as ListSort, et as Payment, f as CHECKOUT_PURPOSES, fn as nationalPhone, ft as Product, g as Checkout, gn as tokenEnvironment, gt as RISK_LEVELS, h as CarrierOffice, hn as TokenKind, ht as RESET_FREQUENCIES, i as WebhookEvent, in as MobilePrefix, it as PaymentSettlement, j as FEATURE_TYPES, jt as USAGE_FEATURE_TYPES, k as Event, kt as SubscriptionStatus, l as CANCELLATION_FEEDBACK, ln as findBank, lt as PlanPrice, m as Carrier, mn as Environment, mt as ProductVariant, n as EventDataMap, nn as MOBILE_PREFIXES, nt as PaymentFailure, o as AfterCompletion, on as TaxBehavior, ot as Payout, p as CancellationFeedback, pn as ENVIRONMENTS, pt as ProductCategory, q as Invoice, qt as BillingMonths, r as EventType, rn as Metadata, rt as PaymentLink, s as Balance, sn as Timestamp, st as Plan, t as EVENT_TYPES, tn as MAX_QUANTITY, tt as PaymentAttempt, u as CARRIERS, un as isLandlinePhone, ut as PlanSeats, v as CheckoutPurpose, vt as ResetFrequency, w as CustomerDetails, wt as Subscription, x as CurrencyAvailability, xt as SUBMIT_LABELS, y as CollectSettings, yt as Retirement, z as FeatureUsageResult, zt as ApiErrorType } from "./events-rtkF8fBQ.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region src/server.d.ts
 type Filters<T> = ListQuery & T;
@@ -24,7 +24,8 @@ interface BilleteOptions extends TransportOptions {
  * Server-side Billete client. Works in any runtime with `fetch` (Node, Bun, Deno, edge).
  *
  * ```ts
- * const billete = createBillete({ environment: "test" }); // reads BILLETE_API_KEY
+ * // Reads BILLETE_API_KEY.
+ * const billete = createBillete({ apiVersion: "2026-10-09", environment: "test" });
  * const { allowed } = await billete.features.consume("user_123", "tokens", 850);
  * ```
  */
@@ -99,8 +100,6 @@ export declare function createBillete(options: BilleteOptions): {
   };
   features: {
     create: (input: FeatureCreate, options?: RequestOptions) => Promise<Feature>;
-    retrieve: (id: string, options?: RequestOptions) => Promise<Feature>;
-    update: (id: string, input: FeatureUpdate, options?: RequestOptions) => Promise<Feature>;
     list: (query?: Filters<{
       sort?: ListSort<"created" | "name">;
     }>, options?: RequestOptions) => Promise<List<Feature>>;
@@ -108,6 +107,10 @@ export declare function createBillete(options: BilleteOptions): {
     iterate: (query?: Filters<{
       sort?: ListSort<"created" | "name">;
     }>) => AsyncGenerator<Feature, any, any>;
+    /** A feature by its `key` (`tokens`) or its `feat_` ID. */
+    retrieve: (key: string, options?: RequestOptions) => Promise<Feature>;
+    /** Renames a feature or changes its schedule; `key` also takes its `feat_` ID. */
+    update: (key: string, input: FeatureUpdate, options?: RequestOptions) => Promise<Feature>;
     /**
      * Reserves `amount` of a metered feature for one job: it counts as used right away and the
      * operation is closed later through `features.operations`. Repeating `operation` returns the
@@ -317,4 +320,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 Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, 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 CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientPaymentCode, type ClientSubscriptionCancel, 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 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 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 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 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 ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, 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 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 WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, WebhookVerificationError, type Weekday, type findBank, type isLandlinePhone, type isMobilePhone, type nationalPhone, type tokenEnvironment, type tokenPrefix, verifyWebhook };
+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 CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, 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 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 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 ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, 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 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 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-DNd4UhbT.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-PMxK43GM.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region ../contracts/src/environment.ts
 /**
@@ -63,7 +63,8 @@ function fromEnv(name) {
 * Server-side Billete client. Works in any runtime with `fetch` (Node, Bun, Deno, edge).
 *
 * ```ts
-* const billete = createBillete({ environment: "test" }); // reads BILLETE_API_KEY
+* // Reads BILLETE_API_KEY.
+* const billete = createBillete({ apiVersion: "2026-10-09", environment: "test" });
 * const { allowed } = await billete.features.consume("user_123", "tokens", 850);
 * ```
 */
@@ -158,6 +159,10 @@ create: (input, options) => http.request({
 	const operationPath = (operation, action) => `/v1/feature-operations/${segment(operation)}${action ? `/${action}` : ""}`;
 	const features = {
 		...featureCrud,
+		/** A feature by its `key` (`tokens`) or its `feat_` ID. */
+		retrieve: (key, options) => featureCrud.retrieve(key, options),
+		/** Renames a feature or changes its schedule; `key` also takes its `feat_` ID. */
+		update: (key, input, options) => featureCrud.update(key, input, options),
 		/**
 		* Reserves `amount` of a metered feature for one job: it counts as used right away and the
 		* operation is closed later through `features.operations`. Repeating `operation` returns the

package/dist/webhooks.d.ts

@@ -1,4 +1,4 @@
-import { i as WebhookEvent } from "./events-Dz2ghaMl.js";
+import { i as WebhookEvent } from "./events-rtkF8fBQ.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": "1.1.0-canary.6",
+  "version": "3.0.0",
   "description": "Billete SDK: server client, browser client and webhook verification",
   "keywords": [
     "billete",