@boelabs/billete-sdk 1.1.0-canary.5 → 2.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-08", 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-08",
   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-08", 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 PaymentSettlement, $t as Timestamp, A as FULFILLMENT_METHODS, At as ApiErrorEnvelope, B as FulfillmentTracking, Bt as CURRENCIES, C as Customer, Ct as Weekday, D as Event, Dt as ReceiptSnapshot, E as CustomerSession, Et as ReceiptSend, F as FeatureUsageResult, Ft as Address, G as InvoiceStatus, Gt as ListQuery, H as INVOICE_STATUSES, Ht as GRACE_PERIOD_DAYS, I as Fulfillment, It as AddressInput, J as PRODUCT_CATEGORIES, Jt as MOBILE_PREFIXES, K as LineItem, Kt as ListSort, L as FulfillmentChoice, Lt as BILLING_MONTHS, M as Feature, Mt as PAYMENT_FAILURE_CODES, N as FeatureReset, Nt as PaymentFailureCode, O as ExchangeRate, Ot as API_ERROR_TYPES, P as FeatureType, Pt as ACCOUNT_NUMBER_LENGTH, Q as PaymentLink, Qt as TaxBehavior, R as FulfillmentMethod, Rt as BankCode, S as CustomField, St as WebhookEndpoint, T as CustomerFeature, Tt as ReceiptReference, U as Invoice, Ut as GracePeriodDays, V as INVOICE_REASONS, Vt as Currency, W as InvoiceReason, Wt as List, X as PaymentAttempt, Xt as MobilePrefix, Y as Payment, Yt as Metadata, Z as PaymentFailure, Zt as TAX_BEHAVIORS, _ as CheckoutItem, _t as SubmitLabel, a as Actor, an as ENVIRONMENTS, at as PortalSession, b as Coupon, bt as SubscriptionStatus, c as BalanceAmount, cn as tokenEnvironment, ct as ProductVariant, d as CARRIER_TEST_SCENARIOS, dt as Refund, en as VENEZUELAN_BANKS, et as PaymentStatus, f as CHECKOUT_PURPOSES, ft as ResetFrequency, g as Checkout, gt as SUBSCRIPTION_STATUSES, h as CarrierOffice, ht as SUBMIT_LABELS, i as WebhookEvent, in as nationalPhone, it as PlanPrice, j as FULFILLMENT_STATUSES, jt as ApiErrorType, k as FEATURE_TYPES, kt as ApiErrorBody, l as CANCELLATION_FEEDBACK, ln as tokenPrefix, lt as RESET_FREQUENCIES, m as Carrier, mt as RiskLevel, n as EventDataMap, nn as isLandlinePhone, nt as Plan, o as AfterCompletion, on as Environment, ot as Product, p as CancellationFeedback, pt as Retirement, q as PAYMENT_STATUSES, qt as MAX_QUANTITY, r as EventType, rn as isMobilePhone, rt as PlanFeatureValues, s as Balance, sn as TokenKind, st as ProductCategory, t as EVENT_TYPES, tn as findBank, tt as Payout, u as CARRIERS, ut as RISK_LEVELS, v as CheckoutPurpose, vt as Subscription, w as CustomerDetails, wt as PublicReceipt, x as CurrencyAvailability, xt as USAGE_FEATURE_TYPES, y as CollectSettings, yt as SubscriptionRenewal, z as FulfillmentStatus, zt as BillingMonths } from "./events-kvUK9zvS.js";
-import { $ as FulfillmentOption, A as KEY_PATTERN, B as ProductCheckoutCreate, C as EventSelector, D as FulfillmentTrackingInput, E as FulfillmentInput, F as PlanFeaturesInput, G as RetireInput, H as ProductLinkCreate, I as PlanLinkCreate, J as SubscriptionUpdate, K as SubscriptionCancel, L as PlanPriceInput, M as PaymentLinkUpdate, N as PlanCheckoutCreate, O as InvoiceCreate, P as PlanCreate, Q as CustomerSubscription, R as PlanUpdate, S as CustomerUpdate, T as FeatureUpdate, U as ProductUpdate, V as ProductCreate, W as RefundCreate, X as WebhookEndpointCreate, Y as VariantInput, Z as WebhookEndpointUpdate, _ as CouponUpdate, a as CheckoutCreate, at as PortalFeatures, b as CustomerInput, c as ClientCheckoutUpdate, ct as PublicInvoice, d as ClientLinkCheckout, dt as PublicPortal, et as PaymentInstructions, f as ClientPaymentCode, g as CouponCreate, h as CollectInput, i as AfterCompletionInput, it as PaymentTestScenario, j as PaymentLinkCreate, k as InvoiceLineInput, l as ClientFulfillmentProblem, lt as PublicPaymentLink, m as ClientSubscriptionUpdate, n as RequestOptions, nt as PaymentMethodOption, o as CheckoutItemInput, ot as PublicCheckout, p as ClientSubscriptionCancel, q as SubscriptionCreate, r as TransportOptions, rt as PaymentNextAction, s as ClientCheckoutPay, st as PublicFulfillment, t as BilleteError, tt as PaymentMethodField, u as ClientInvoicePay, ut as PublicPaymentState, v as CustomFieldInput, w as FeatureCreate, x as CustomerSessionCreate, y as CustomerCreate, z as PortalSessionCreate } from "./errors-DY-3gWvA.js";
+import { $ as SubscriptionCreate, A as FulfillmentInput, At as isApiVersionRetired, B as PlanLinkCreate, C as CustomerSessionCreate, Ct as ApiVersionStage, D as FeatureOperationCommit, Dt as apiVersionStage, E as FeatureCreate, Et as apiVersionLifecycle, 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, Ot as currentApiVersion, P as KEY_PATTERN, Q as SubscriptionChangePreviewInput, R as PlanCreate, S as CustomerMemberUpdate, St as ApiVersionLifecycle, T as EventSelector, Tt as LatestApiVersion, 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, bt as API_VERSION_PATTERN, 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, jt as supportedApiVersions, k as FeatureUpdate, kt as isApiVersion, 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, vt as API_VERSIONS, w as CustomerUpdate, wt as LATEST_API_VERSION, x as CustomerMemberCreate, xt as ApiVersion, y as CustomerCreate, yt as API_VERSION_HEADER, z as PlanFeaturesInput } from "./errors-Cu8XMn5I.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-CrmMdwBX.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-08", 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: {
@@ -102,4 +102,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 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 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 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 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 PublicReceipt, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type ReceiptSnapshot, 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 SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, 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 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 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-Dp-Du1QO.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-CgBMbPS2.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-Dp
 * 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-08", 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,

package/dist/{errors-DY-3gWvA.d.ts → errors-Cu8XMn5I.d.ts}

@@ -1,4 +1,48 @@
-import { $t as Timestamp, B as FulfillmentTracking, Ft as Address, G as InvoiceStatus, I as Fulfillment, It as AddressInput, K as LineItem, N as FeatureReset, Qt as TaxBehavior, R as FulfillmentMethod, S as CustomField, Tt as ReceiptReference, Ut as GracePeriodDays, Vt as Currency, W as InvoiceReason, Yt as Metadata, Z as PaymentFailure, _ as CheckoutItem, _t as SubmitLabel, et as PaymentStatus, h as CarrierOffice, it as PlanPrice, jt as ApiErrorType, kt as ApiErrorBody, m as Carrier, o as AfterCompletion, on as Environment, p as CancellationFeedback, r as EventType, st as ProductCategory, v as CheckoutPurpose, vt as Subscription, w as CustomerDetails, y as CollectSettings, z as FulfillmentStatus, zt as BillingMonths } from "./events-kvUK9zvS.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-CrmMdwBX.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"];
+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
@@ -47,6 +91,12 @@ interface PublicPortal {
 }
 /** Where a payment stands, as a payment page shows it. */
 interface PublicPaymentState {
+  /** Settled amount in the currency actually paid; no payer or bank details. */
+  paid: {
+    amount: number;
+    currency: Currency;
+    paidAt: Timestamp;
+  } | null;
   receipt: (ReceiptReference & {
     sentTo: string | null;
   }) | null;
@@ -91,6 +141,17 @@ interface PublicInvoice {
 }
 /** Browser-safe view of a checkout: everything needed to render and pay it, nothing internal. */
 interface PublicCheckout {
+  subscriptionChange: {
+    fromPlanName: string;
+    toPlanName: string;
+    quantity: number;
+    kind: "restart" | "add_seats";
+    creditApplied: number;
+    unusedCredit: number;
+    currentPeriodEnd: Timestamp;
+    activatedAt: Timestamp | null;
+    outcome: "pending" | "applied" | "rejected";
+  } | null;
   id: string;
   object: "checkout";
   environment: Environment;
@@ -363,6 +424,26 @@ interface CustomerUpdate {
   address?: AddressInput | null;
   metadata?: Metadata;
 }
+interface CustomerMemberCreate {
+  externalId: string;
+  name?: string;
+  metadata?: Metadata;
+}
+interface CustomerMemberUpdate {
+  name?: string | null;
+  metadata?: Metadata;
+}
+interface FeatureOperationCreate {
+  /** Your own ID for the work (e.g. the job ID): repeating it never consumes twice. */
+  operation: string;
+  amount: number;
+  member?: string;
+  expiresInSeconds?: number;
+  metadata?: Metadata;
+}
+interface FeatureOperationCommit {
+  amount?: number;
+}
 /** An existing customer (`cus_…` or your `externalId`), or one to create or update on the fly. */
 type CustomerInput = string | CustomerCreate;
 interface RetireInput {
@@ -418,22 +499,26 @@ type FeatureCreate = {
   key: string;
   name: string;
   type: "boolean";
+  per?: "customer" | "member";
 } | {
   key: string;
   name: string;
   type: "metered";
   unit?: string;
   reset: FeatureReset;
+  per?: "customer" | "member";
 } | {
   key: string;
   name: string;
   type: "count";
   unit?: string;
+  per?: "customer" | "member";
 } | {
   key: string;
   name: string;
   type: "number";
   unit?: string;
+  per?: "customer" | "member";
 };
 /**
  * The key and type are fixed once created (code and usage depend on them). Changing `reset`
@@ -451,6 +536,8 @@ interface PlanPriceInput {
   amount: number;
 }
 interface PlanCreate {
+  seats?: PlanSeats;
+  fallbackPlanId?: string | null;
   name: string;
   description?: string;
   currency: Currency;
@@ -463,6 +550,8 @@ interface PlanCreate {
   metadata?: Metadata;
 }
 interface PlanUpdate {
+  seats?: PlanSeats;
+  fallbackPlanId?: string | null;
   name?: string;
   description?: string | null;
   /** New prices apply to new subscriptions; existing ones keep the price they signed up with. */
@@ -477,17 +566,27 @@ interface PlanUpdate {
   metadata?: Metadata;
 }
 interface SubscriptionCreate {
+  quantity?: number;
   customer: CustomerInput;
   plan: string;
   months: BillingMonths;
-  /** Defaults to the plan trial. A subscription created through the API always starts in trial. */
+  /** Paid plans require a trial; free plans start active and do not accept trialDays. */
   trialDays?: number;
   metadata?: Metadata;
 }
 interface SubscriptionUpdate {
+  metadata?: Metadata;
+}
+interface SubscriptionChangePreviewInput {
   plan?: string;
   months?: BillingMonths;
-  metadata?: Metadata;
+  quantity?: number;
+}
+interface SubscriptionChangeCreate extends SubscriptionChangePreviewInput {
+  when: "now" | "renewal";
+  acceptUnusedCredit?: boolean;
+  successUrl?: string;
+  cancelUrl?: string;
 }
 interface SubscriptionCancel {
   /** `false` ends the subscription immediately. */
@@ -595,6 +694,7 @@ interface ProductCheckoutCreate extends CheckoutFields {
   items: CheckoutItemInput[];
 }
 interface PlanCheckoutCreate extends CheckoutFields {
+  quantity?: number;
   plan: string;
   months: BillingMonths;
 }
@@ -649,11 +749,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;
@@ -720,6 +824,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;
@@ -748,4 +859,4 @@ declare class BilleteError extends Error {
   }, status: number);
 }
 //#endregion
-export { FulfillmentOption as $, KEY_PATTERN as A, ProductCheckoutCreate as B, EventSelector as C, FulfillmentTrackingInput as D, FulfillmentInput as E, PlanFeaturesInput as F, RetireInput as G, ProductLinkCreate as H, PlanLinkCreate as I, SubscriptionUpdate as J, SubscriptionCancel as K, PlanPriceInput as L, PaymentLinkUpdate as M, PlanCheckoutCreate as N, InvoiceCreate as O, PlanCreate as P, CustomerSubscription as Q, PlanUpdate as R, CustomerUpdate as S, FeatureUpdate as T, ProductUpdate as U, ProductCreate as V, RefundCreate as W, WebhookEndpointCreate as X, VariantInput as Y, WebhookEndpointUpdate as Z, CouponUpdate as _, CheckoutCreate as a, PortalFeatures as at, CustomerInput as b, ClientCheckoutUpdate as c, PublicInvoice as ct, ClientLinkCheckout as d, PublicPortal as dt, PaymentInstructions as et, ClientPaymentCode as f, CouponCreate as g, CollectInput as h, AfterCompletionInput as i, PaymentTestScenario as it, PaymentLinkCreate as j, InvoiceLineInput as k, ClientFulfillmentProblem as l, PublicPaymentLink as lt, ClientSubscriptionUpdate as m, RequestOptions as n, PaymentMethodOption as nt, CheckoutItemInput as o, PublicCheckout as ot, ClientSubscriptionCancel as p, SubscriptionCreate as q, TransportOptions as r, PaymentNextAction as rt, ClientCheckoutPay as s, PublicFulfillment as st, BilleteError as t, PaymentMethodField as tt, ClientInvoicePay as u, PublicPaymentState as ut, CustomFieldInput as v, FeatureCreate as w, CustomerSessionCreate as x, CustomerCreate as y, PortalSessionCreate as z };
+export { SubscriptionCreate as $, FulfillmentInput as A, isApiVersionRetired as At, PlanLinkCreate as B, CustomerSessionCreate as C, ApiVersionStage as Ct, FeatureOperationCommit as D, apiVersionStage as Dt, FeatureCreate as E, apiVersionLifecycle as Et, 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, currentApiVersion as Ot, KEY_PATTERN as P, SubscriptionChangePreviewInput as Q, PlanCreate as R, CustomerMemberUpdate as S, ApiVersionLifecycle as St, EventSelector as T, LatestApiVersion as Tt, 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, API_VERSION_PATTERN as bt, 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, supportedApiVersions as jt, FeatureUpdate as k, isApiVersion as kt, 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, API_VERSIONS as vt, CustomerUpdate as w, LATEST_API_VERSION as wt, CustomerMemberCreate as x, ApiVersion as xt, CustomerCreate as y, API_VERSION_HEADER as yt, PlanFeaturesInput as z };

package/dist/{events-kvUK9zvS.d.ts → events-CrmMdwBX.d.ts}

@@ -278,55 +278,6 @@ type PaymentFailureCode = (typeof PAYMENT_FAILURE_CODES)[number];
 interface ReceiptReference {
   id: string;
   number: string;
-  url: string;
-}
-/** Frozen at settlement; never contains fees, net amounts or raw provider data. */
-interface ReceiptSnapshot {
-  business: {
-    name: string;
-    legalName: string | null;
-    taxId: string | null;
-    supportEmail: string | null;
-    supportPhone: string | null;
-    address: Address | null;
-  };
-  customer: {
-    name: string | null;
-    email: string;
-    address: Address | null;
-  };
-  timezone: string;
-  invoiceNumber: string;
-  lines: LineItem[];
-  currency: Currency;
-  subtotal: number;
-  discount: number;
-  couponCode: string | null;
-  tax: number;
-  taxRateBps: number;
-  taxBehavior: TaxBehavior;
-  total: number;
-  periodStart: Timestamp | null;
-  periodEnd: Timestamp | null;
-  paid: {
-    amount: number;
-    currency: Currency;
-    exchangeRate: string | null;
-    method: string;
-    details: Record<string, string>;
-    reference: string | null;
-    paidAt: Timestamp;
-  };
-}
-interface PublicReceipt extends ReceiptReference {
-  environment: Environment;
-  snapshot: ReceiptSnapshot;
-  refunds: Array<{
-    amount: number;
-    currency: Currency;
-    createdAt: Timestamp;
-    status: "succeeded";
-  }>;
 }
 interface ReceiptSend {
   email?: string;
@@ -348,6 +299,32 @@ interface Customer extends Resource<"customer"> {
   metadata: Metadata;
   updatedAt: Timestamp;
 }
+interface CustomerMember extends Resource<"customer_member"> {
+  customerId: string;
+  externalId: string;
+  name: string | null;
+  status: "active" | "removed";
+  enabled: boolean;
+  activeSince: Timestamp;
+  removedAt: Timestamp | null;
+  metadata: Metadata;
+  updatedAt: Timestamp;
+}
+interface CustomerMemberList {
+  data: CustomerMember[];
+  capacity: number | null;
+  enabledCount: number;
+  nextCursor: string | null;
+}
+declare const MAX_SEATS = 10000;
+type PlanSeats = {
+  mode: "included";
+  limit: number | null;
+} | {
+  mode: "per_seat";
+  min: number;
+  max: number;
+};
 declare const PRODUCT_CATEGORIES: readonly ["digital", "physical", "service", "event", "other"];
 type ProductCategory = (typeof PRODUCT_CATEGORIES)[number];
 /** Who performed an action: a dashboard user or an API key. */
@@ -403,6 +380,8 @@ interface PlanPrice {
  */
 type PlanFeatureValues = Record<string, boolean | number | null>;
 interface Plan extends Resource<"plan"> {
+  seats: PlanSeats;
+  fallbackPlanId: string | null;
   name: string;
   description: string | null;
   currency: Currency;
@@ -456,6 +435,7 @@ type FeatureReset = {
   day: number;
 };
 interface Feature extends Resource<"feature"> {
+  per: "customer" | "member";
   key: string;
   name: string;
   type: FeatureType;
@@ -471,6 +451,9 @@ interface Feature extends Resource<"feature"> {
 }
 /** What a customer can do with a feature right now, across all of their ongoing subscriptions. */
 interface CustomerFeature {
+  per: "customer" | "member";
+  reason?: "over_limit";
+  reserved: number | null;
   key: string;
   name: string;
   type: FeatureType;
@@ -480,7 +463,7 @@ interface CustomerFeature {
   limit: number | null;
   /** `number`: the granted value (`null` when no plan grants it). `null` for the other types. */
   value: number | null;
-  used: number;
+  used: number | null;
   /** `null` when unlimited or not a usage type. */
   remaining: number | null;
   /** When `metered` usage restores next; `null` for the other types. */
@@ -491,6 +474,23 @@ interface FeatureUsageResult {
   allowed: boolean;
   feature: CustomerFeature;
 }
+interface FeatureOperation extends Resource<"feature_operation"> {
+  key: string;
+  customerId: string;
+  memberId: string | null;
+  featureId: string;
+  periodStart: Timestamp;
+  amount: number;
+  committedAmount: number | null;
+  status: "reserved" | "committed" | "released" | "expired" | "refunded";
+  expiresAt: Timestamp;
+  metadata: Metadata;
+  updatedAt: Timestamp;
+}
+interface FeatureOperationResult extends FeatureUsageResult {
+  created: boolean;
+  operation: FeatureOperation | null;
+}
 declare const SUBSCRIPTION_STATUSES: readonly ["trialing", "active", "past_due", "canceled", "expired"];
 type SubscriptionStatus = (typeof SUBSCRIPTION_STATUSES)[number];
 interface SubscriptionRenewal {
@@ -511,11 +511,14 @@ interface SubscriptionRenewal {
 declare const CANCELLATION_FEEDBACK: readonly ["too_expensive", "missing_features", "switched_service", "unused", "customer_service", "too_complex", "low_quality", "other"];
 type CancellationFeedback = (typeof CANCELLATION_FEEDBACK)[number];
 interface Subscription extends Resource<"subscription"> {
+  version: number;
+  previousPlanId: string | null;
+  quantity: number;
   customerId: string;
   planId: string;
   status: SubscriptionStatus;
   months: BillingMonths;
-  amount: number;
+  unitAmount: number;
   currency: Currency;
   currentPeriodStart: Timestamp;
   currentPeriodEnd: Timestamp;
@@ -532,6 +535,7 @@ interface Subscription extends Resource<"subscription"> {
   pendingChange: {
     planId: string;
     months: BillingMonths;
+    quantity: number;
   } | null;
   renewal: SubscriptionRenewal | null;
   /**
@@ -626,9 +630,10 @@ interface CustomerDetails {
   phone: string | null;
   address: Address | null;
 }
-declare const CHECKOUT_PURPOSES: readonly ["product", "plan"];
+declare const CHECKOUT_PURPOSES: readonly ["product", "plan", "subscription_change"];
 type CheckoutPurpose = (typeof CHECKOUT_PURPOSES)[number];
 interface Checkout extends Resource<"checkout"> {
+  subscriptionChange: SubscriptionChange | null;
   url: string;
   purpose: CheckoutPurpose;
   status: "open" | "completed" | "expired";
@@ -663,6 +668,46 @@ interface Checkout extends Resource<"checkout"> {
   completedAt: Timestamp | null;
   metadata: Metadata;
 }
+interface SubscriptionTerms {
+  planId: string;
+  months: BillingMonths;
+  quantity: number;
+  unitAmount: number;
+}
+/** The quote a `subscription_change` checkout charges and applies as is once paid. */
+interface SubscriptionChange {
+  quotedAt: Timestamp;
+  version: number;
+  kind: "restart" | "add_seats";
+  from: SubscriptionTerms;
+  to: SubscriptionTerms;
+  currentPeriodEnd: Timestamp;
+  creditApplied: number;
+  unusedCredit: number;
+  subtotal: number;
+  discount: number;
+  tax: number;
+  total: number;
+  activatedAt: Timestamp | null;
+  outcome: "pending" | "applied" | "rejected";
+}
+interface SubscriptionChangePreview {
+  credit: number;
+  charge: number;
+  tax: number;
+  total: number;
+  unusedCredit: number;
+  version: number;
+  currentPeriodEnd: Timestamp;
+  periodEndIfPaidNow?: Timestamp;
+}
+type SubscriptionChangeResult = {
+  type: "scheduled" | "applied";
+  subscription: Subscription;
+} | {
+  type: "checkout";
+  checkout: Checkout;
+};
 /**
  * `pickup`: the customer collects it at the business. `delivery`: the business takes it to them.
  * `shipping`: the business sends it through a carrier to the office the customer chose.
@@ -938,12 +983,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 {
@@ -984,6 +1036,12 @@ interface EventDataMap {
   "payment_link.retired": PaymentLink;
   "customer.created": Customer;
   "customer.updated": Customer;
+  "customer.member_added": CustomerMember;
+  "customer.member_removed": CustomerMember;
+  "subscription.change_failed": {
+    subscription: Subscription;
+    checkoutId: string;
+  };
   "checkout.completed": Checkout;
   "checkout.expired": Checkout;
   "payment.succeeded": Payment;
@@ -1023,15 +1081,17 @@ interface EventDataMap {
   "subscription.expired": Subscription;
 }
 type EventType = keyof EventDataMap;
-declare const EVENT_TYPES: readonly ["product.retired", "product.updated", "payment_link.retired", "customer.created", "customer.updated", "checkout.completed", "checkout.expired", "payment.succeeded", "payment.failed", "payment.refunded", "fulfillment.created", "fulfillment.shipped", "fulfillment.ready_for_pickup", "fulfillment.delivered", "fulfillment.received", "fulfillment.problem_reported", "fulfillment.canceled", "refund.created", "refund.failed", "invoice.created", "invoice.paid", "invoice.voided", "invoice.uncollectible", "subscription.created", "subscription.updated", "subscription.renewal_due", "subscription.renewed", "subscription.past_due", "subscription.canceled", "subscription.expired"];
+declare const EVENT_TYPES: readonly ["product.retired", "product.updated", "payment_link.retired", "customer.created", "customer.updated", "customer.member_added", "customer.member_removed", "subscription.change_failed", "checkout.completed", "checkout.expired", "payment.succeeded", "payment.failed", "payment.refunded", "fulfillment.created", "fulfillment.shipped", "fulfillment.ready_for_pickup", "fulfillment.delivered", "fulfillment.received", "fulfillment.problem_reported", "fulfillment.canceled", "refund.created", "refund.failed", "invoice.created", "invoice.paid", "invoice.voided", "invoice.uncollectible", "subscription.created", "subscription.updated", "subscription.renewal_due", "subscription.renewed", "subscription.past_due", "subscription.canceled", "subscription.expired"];
 /** A delivered webhook, discriminated by `type` so `data` narrows automatically. */
 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];
 }; }[EventType];
 //#endregion
-export { PaymentSettlement as $, Timestamp as $t, FULFILLMENT_METHODS as A, ApiErrorEnvelope as At, FulfillmentTracking as B, CURRENCIES as Bt, Customer as C, Weekday as Ct, Event as D, ReceiptSnapshot as Dt, CustomerSession as E, ReceiptSend as Et, FeatureUsageResult as F, Address as Ft, InvoiceStatus as G, ListQuery as Gt, INVOICE_STATUSES as H, GRACE_PERIOD_DAYS as Ht, Fulfillment as I, AddressInput as It, PRODUCT_CATEGORIES as J, MOBILE_PREFIXES as Jt, LineItem as K, ListSort as Kt, FulfillmentChoice as L, BILLING_MONTHS as Lt, Feature as M, PAYMENT_FAILURE_CODES as Mt, FeatureReset as N, PaymentFailureCode as Nt, ExchangeRate as O, API_ERROR_TYPES as Ot, FeatureType as P, ACCOUNT_NUMBER_LENGTH as Pt, PaymentLink as Q, TaxBehavior as Qt, FulfillmentMethod as R, BankCode as Rt, CustomField as S, WebhookEndpoint as St, CustomerFeature as T, ReceiptReference as Tt, Invoice as U, GracePeriodDays as Ut, INVOICE_REASONS as V, Currency as Vt, InvoiceReason as W, List as Wt, PaymentAttempt as X, MobilePrefix as Xt, Payment as Y, Metadata as Yt, PaymentFailure as Z, TAX_BEHAVIORS as Zt, CheckoutItem as _, SubmitLabel as _t, Actor as a, ENVIRONMENTS as an, PortalSession as at, Coupon as b, SubscriptionStatus as bt, BalanceAmount as c, tokenEnvironment as cn, ProductVariant as ct, CARRIER_TEST_SCENARIOS as d, Refund as dt, VENEZUELAN_BANKS as en, PaymentStatus as et, CHECKOUT_PURPOSES as f, ResetFrequency as ft, Checkout as g, SUBSCRIPTION_STATUSES as gt, CarrierOffice as h, SUBMIT_LABELS as ht, WebhookEvent as i, nationalPhone as in, PlanPrice as it, FULFILLMENT_STATUSES as j, ApiErrorType as jt, FEATURE_TYPES as k, ApiErrorBody as kt, CANCELLATION_FEEDBACK as l, tokenPrefix as ln, RESET_FREQUENCIES as lt, Carrier as m, RiskLevel as mt, EventDataMap as n, isLandlinePhone as nn, Plan as nt, AfterCompletion as o, Environment as on, Product as ot, CancellationFeedback as p, Retirement as pt, PAYMENT_STATUSES as q, MAX_QUANTITY as qt, EventType as r, isMobilePhone as rn, PlanFeatureValues as rt, Balance as s, TokenKind as sn, ProductCategory as st, EVENT_TYPES as t, findBank as tn, Payout as tt, CARRIERS as u, RISK_LEVELS as ut, CheckoutPurpose as v, Subscription as vt, CustomerDetails as w, PublicReceipt as wt, CurrencyAvailability as x, USAGE_FEATURE_TYPES as xt, CollectSettings as y, SubscriptionRenewal as yt, FulfillmentStatus as z, BillingMonths as zt };
+export { PRODUCT_CATEGORIES as $, ListQuery as $t, ExchangeRate as A, SubscriptionTerms as At, Fulfillment as B, PAYMENT_FAILURE_CODES as Bt, Customer as C, SubmitLabel as Ct, CustomerMemberList as D, SubscriptionChangeResult as Dt, CustomerMember as E, SubscriptionChangePreview as Et, FeatureOperation as F, ReceiptSend as Ft, INVOICE_REASONS as G, BILLING_MONTHS as Gt, FulfillmentMethod as H, ACCOUNT_NUMBER_LENGTH as Ht, FeatureOperationResult as I, API_ERROR_TYPES as It, InvoiceReason as J, CURRENCIES as Jt, INVOICE_STATUSES as K, BankCode as Kt, FeatureReset as L, ApiErrorBody as Lt, FULFILLMENT_METHODS as M, WebhookEndpoint as Mt, FULFILLMENT_STATUSES as N, Weekday as Nt, CustomerSession as O, SubscriptionRenewal as Ot, Feature as P, ReceiptReference as Pt, PAYMENT_STATUSES as Q, List as Qt, FeatureType as R, ApiErrorEnvelope as Rt, CustomField as S, SUBSCRIPTION_STATUSES as St, CustomerFeature as T, SubscriptionChange as Tt, FulfillmentStatus as U, Address as Ut, FulfillmentChoice as V, PaymentFailureCode as Vt, FulfillmentTracking as W, AddressInput as Wt, LineItem as X, GRACE_PERIOD_DAYS as Xt, InvoiceStatus as Y, Currency as Yt, MAX_SEATS as Z, GracePeriodDays as Zt, CheckoutItem as _, tokenPrefix as _n, Refund as _t, Actor as a, TAX_BEHAVIORS as an, PaymentStatus as at, Coupon as b, RiskLevel as bt, BalanceAmount as c, VENEZUELAN_BANKS as cn, PlanFeatureValues as ct, CARRIER_TEST_SCENARIOS as d, isMobilePhone as dn, PortalSession as dt, ListSort as en, Payment as et, CHECKOUT_PURPOSES as f, nationalPhone as fn, Product as ft, Checkout as g, tokenEnvironment as gn, RISK_LEVELS as gt, CarrierOffice as h, TokenKind as hn, RESET_FREQUENCIES as ht, WebhookEvent as i, MobilePrefix as in, PaymentSettlement as it, FEATURE_TYPES as j, USAGE_FEATURE_TYPES as jt, Event as k, SubscriptionStatus as kt, CANCELLATION_FEEDBACK as l, findBank as ln, PlanPrice as lt, Carrier as m, Environment as mn, ProductVariant as mt, EventDataMap as n, MOBILE_PREFIXES as nn, PaymentFailure as nt, AfterCompletion as o, TaxBehavior as on, Payout as ot, CancellationFeedback as p, ENVIRONMENTS as pn, ProductCategory as pt, Invoice as q, BillingMonths as qt, EventType as r, Metadata as rn, PaymentLink as rt, Balance as s, Timestamp as sn, Plan as st, EVENT_TYPES as t, MAX_QUANTITY as tn, PaymentAttempt as tt, CARRIERS as u, isLandlinePhone as un, PlanSeats as ut, CheckoutPurpose as v, ResetFrequency as vt, CustomerDetails as w, Subscription as wt, CurrencyAvailability as x, SUBMIT_LABELS as xt, CollectSettings as y, Retirement as yt, FeatureUsageResult as z, ApiErrorType as zt };

package/dist/{http-Dp-Du1QO.js → http-CgBMbPS2.js}

@@ -18,7 +18,7 @@ var BilleteError = class extends Error {
 };
 //#endregion
 //#region src/http.ts
-const SDK_VERSION = "1.1.0-canary.5";
+const SDK_VERSION = "2.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,8 +1,14 @@
-import { $ as PaymentSettlement, $t as Timestamp, A as FULFILLMENT_METHODS, At as ApiErrorEnvelope, B as FulfillmentTracking, Bt as CURRENCIES, C as Customer, Ct as Weekday, D as Event, Dt as ReceiptSnapshot, E as CustomerSession, Et as ReceiptSend, F as FeatureUsageResult, Ft as Address, G as InvoiceStatus, Gt as ListQuery, H as INVOICE_STATUSES, Ht as GRACE_PERIOD_DAYS, I as Fulfillment, It as AddressInput, J as PRODUCT_CATEGORIES, Jt as MOBILE_PREFIXES, K as LineItem, Kt as ListSort, L as FulfillmentChoice, Lt as BILLING_MONTHS, M as Feature, Mt as PAYMENT_FAILURE_CODES, N as FeatureReset, Nt as PaymentFailureCode, O as ExchangeRate, Ot as API_ERROR_TYPES, P as FeatureType, Pt as ACCOUNT_NUMBER_LENGTH, Q as PaymentLink, Qt as TaxBehavior, R as FulfillmentMethod, Rt as BankCode, S as CustomField, St as WebhookEndpoint, T as CustomerFeature, Tt as ReceiptReference, U as Invoice, Ut as GracePeriodDays, V as INVOICE_REASONS, Vt as Currency, W as InvoiceReason, Wt as List, X as PaymentAttempt, Xt as MobilePrefix, Y as Payment, Yt as Metadata, Z as PaymentFailure, Zt as TAX_BEHAVIORS, _ as CheckoutItem, _t as SubmitLabel, a as Actor, an as ENVIRONMENTS, at as PortalSession, b as Coupon, bt as SubscriptionStatus, c as BalanceAmount, cn as tokenEnvironment, ct as ProductVariant, d as CARRIER_TEST_SCENARIOS, dt as Refund, en as VENEZUELAN_BANKS, et as PaymentStatus, f as CHECKOUT_PURPOSES, ft as ResetFrequency, g as Checkout, gt as SUBSCRIPTION_STATUSES, h as CarrierOffice, ht as SUBMIT_LABELS, i as WebhookEvent, in as nationalPhone, it as PlanPrice, j as FULFILLMENT_STATUSES, jt as ApiErrorType, k as FEATURE_TYPES, kt as ApiErrorBody, l as CANCELLATION_FEEDBACK, ln as tokenPrefix, lt as RESET_FREQUENCIES, m as Carrier, mt as RiskLevel, n as EventDataMap, nn as isLandlinePhone, nt as Plan, o as AfterCompletion, on as Environment, ot as Product, p as CancellationFeedback, pt as Retirement, q as PAYMENT_STATUSES, qt as MAX_QUANTITY, r as EventType, rn as isMobilePhone, rt as PlanFeatureValues, s as Balance, sn as TokenKind, st as ProductCategory, t as EVENT_TYPES, tn as findBank, tt as Payout, u as CARRIERS, ut as RISK_LEVELS, v as CheckoutPurpose, vt as Subscription, w as CustomerDetails, wt as PublicReceipt, x as CurrencyAvailability, xt as USAGE_FEATURE_TYPES, y as CollectSettings, yt as SubscriptionRenewal, z as FulfillmentStatus, zt as BillingMonths } from "./events-kvUK9zvS.js";
-import { $ as FulfillmentOption, A as KEY_PATTERN, B as ProductCheckoutCreate, C as EventSelector, D as FulfillmentTrackingInput, E as FulfillmentInput, F as PlanFeaturesInput, G as RetireInput, H as ProductLinkCreate, I as PlanLinkCreate, J as SubscriptionUpdate, K as SubscriptionCancel, L as PlanPriceInput, M as PaymentLinkUpdate, N as PlanCheckoutCreate, O as InvoiceCreate, P as PlanCreate, Q as CustomerSubscription, R as PlanUpdate, S as CustomerUpdate, T as FeatureUpdate, U as ProductUpdate, V as ProductCreate, W as RefundCreate, X as WebhookEndpointCreate, Y as VariantInput, Z as WebhookEndpointUpdate, _ as CouponUpdate, a as CheckoutCreate, at as PortalFeatures, b as CustomerInput, c as ClientCheckoutUpdate, ct as PublicInvoice, d as ClientLinkCheckout, dt as PublicPortal, et as PaymentInstructions, f as ClientPaymentCode, g as CouponCreate, h as CollectInput, i as AfterCompletionInput, it as PaymentTestScenario, j as PaymentLinkCreate, k as InvoiceLineInput, l as ClientFulfillmentProblem, lt as PublicPaymentLink, m as ClientSubscriptionUpdate, n as RequestOptions, nt as PaymentMethodOption, o as CheckoutItemInput, ot as PublicCheckout, p as ClientSubscriptionCancel, q as SubscriptionCreate, r as TransportOptions, rt as PaymentNextAction, s as ClientCheckoutPay, st as PublicFulfillment, t as BilleteError, tt as PaymentMethodField, u as ClientInvoicePay, ut as PublicPaymentState, v as CustomFieldInput, w as FeatureCreate, x as CustomerSessionCreate, y as CustomerCreate, z as PortalSessionCreate } from "./errors-DY-3gWvA.js";
+import { $ as SubscriptionCreate, A as FulfillmentInput, At as isApiVersionRetired, B as PlanLinkCreate, C as CustomerSessionCreate, Ct as ApiVersionStage, D as FeatureOperationCommit, Dt as apiVersionStage, E as FeatureCreate, Et as apiVersionLifecycle, 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, Ot as currentApiVersion, P as KEY_PATTERN, Q as SubscriptionChangePreviewInput, R as PlanCreate, S as CustomerMemberUpdate, St as ApiVersionLifecycle, T as EventSelector, Tt as LatestApiVersion, 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, bt as API_VERSION_PATTERN, 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, jt as supportedApiVersions, k as FeatureUpdate, kt as isApiVersion, 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, vt as API_VERSIONS, w as CustomerUpdate, wt as LATEST_API_VERSION, x as CustomerMemberCreate, xt as ApiVersion, y as CustomerCreate, yt as API_VERSION_HEADER, z as PlanFeaturesInput } from "./errors-Cu8XMn5I.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-CrmMdwBX.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region src/server.d.ts
 type Filters<T> = ListQuery & T;
+type MemberOptions = RequestOptions & {
+  member?: string;
+};
+type UsageOptions = MemberOptions & {
+  operation?: string;
+};
 interface BilleteOptions extends TransportOptions {
   /**
    * Where this client operates: `test` or `production`. Required, and it must match the API key
@@ -18,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-08", environment: "test" });
  * const { allowed } = await billete.features.consume("user_123", "tokens", 850);
  * ```
  */
@@ -37,6 +44,17 @@ export declare function createBillete(options: BilleteOptions): {
       search?: string;
     }>) => AsyncGenerator<Customer, any, any>;
   };
+  members: {
+    list: (customer: string, query?: Filters<{
+      status?: "active" | "removed";
+      search?: string;
+    }>, options?: RequestOptions) => Promise<CustomerMemberList>;
+    /** Re-adding a removed externalId restores its member ID and keeps its usage. */
+    create: (customer: string, input: CustomerMemberCreate, options?: RequestOptions) => Promise<CustomerMember>;
+    retrieve: (customer: string, member: string, options?: RequestOptions) => Promise<CustomerMember>;
+    update: (customer: string, member: string, input: CustomerMemberUpdate, options?: RequestOptions) => Promise<CustomerMember>;
+    remove: (customer: string, member: string, options?: RequestOptions) => Promise<CustomerMember>;
+  };
   customerSessions: {
     /** Short-lived token for the client SDK to read one customer's billing state. */
     create: (input: CustomerSessionCreate, options?: RequestOptions) => Promise<CustomerSession>;
@@ -91,21 +109,40 @@ export declare function createBillete(options: BilleteOptions): {
     iterate: (query?: Filters<{
       sort?: ListSort<"created" | "name">;
     }>) => AsyncGenerator<Feature, any, any>;
+    /**
+     * 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
+     * same reservation without consuming again; running each job once is your queue's job.
+     */
+    reserve: (customer: string, key: string, amount: number, input: Omit<FeatureOperationCreate, "amount">, options?: RequestOptions) => Promise<FeatureOperationResult>;
+    /** Closes reservations. Each call is idempotent, so retry it on doubt instead of releasing. */
+    operations: {
+      retrieve: (operation: string, options?: RequestOptions) => Promise<FeatureOperation>;
+      /** Confirms what the job used (all by default) and returns the rest. */
+      commit: (operation: string, input?: FeatureOperationCommit, options?: RequestOptions) => Promise<FeatureOperation>;
+      /** Returns a reservation whose job failed. */
+      release: (operation: string, options?: RequestOptions) => Promise<FeatureOperation>;
+      /** Returns everything a committed operation used, to the period it was counted in. */
+      refund: (operation: string, options?: RequestOptions) => Promise<FeatureOperation>;
+    };
     /** Current access to one feature. `customer` is a `cus_…` ID or your own `externalId`. */
-    check: (customer: string, key: string, options?: RequestOptions) => Promise<CustomerFeature>;
+    check: (customer: string, key: string, options?: MemberOptions) => Promise<CustomerFeature>;
     /** `true` when the customer can use a boolean feature (or has a limit feature). */
-    isEnabled: (customer: string, key: string, options?: RequestOptions) => Promise<boolean>;
+    isEnabled: (customer: string, key: string, options?: MemberOptions) => Promise<boolean>;
     /** Every feature and its usage for one customer. */
-    listForCustomer: (customer: string, options?: RequestOptions) => Promise<List<CustomerFeature>>;
+    listForCustomer: (customer: string, options?: MemberOptions) => Promise<List<CustomerFeature>>;
     /**
      * Atomically consumes `amount` units. When the limit would be exceeded nothing is consumed
      * and `allowed` is false, so it is safe to call right before doing the work.
      */
-    consume: (customer: string, key: string, amount?: number, options?: RequestOptions) => Promise<FeatureUsageResult>;
-    /** Gives back `amount` units (e.g. a folder was deleted). Usage never drops below zero. */
-    release: (customer: string, key: string, amount?: number, options?: RequestOptions) => Promise<FeatureUsageResult>;
+    consume: (customer: string, key: string, amount?: number, options?: UsageOptions) => Promise<FeatureUsageResult & Partial<Pick<FeatureOperationResult, "created" | "operation">>>;
+    /**
+     * Gives back `amount` units of a `count` feature (e.g. a folder was deleted). Usage never drops
+     * below zero; metered usage is returned through its operation instead.
+     */
+    release: (customer: string, key: string, amount?: number, options?: MemberOptions) => Promise<FeatureUsageResult>;
     /** Reports the absolute current usage (e.g. the customer now has 7 folders). */
-    set: (customer: string, key: string, value: number, options?: RequestOptions) => Promise<CustomerFeature>;
+    set: (customer: string, key: string, value: number, options?: MemberOptions) => Promise<CustomerFeature>;
   };
   coupons: {
     create: (input: CouponCreate, options?: RequestOptions) => Promise<Coupon>;
@@ -186,7 +223,15 @@ export declare function createBillete(options: BilleteOptions): {
       search?: string;
       sort?: ListSort<"created" | "amount">;
     }>) => AsyncGenerator<Subscription, any, any>;
-    /** Cancels at period end by default; pass `{ atPeriodEnd: false }` to end it now. */
+    changes: {
+      /** Apply on renewal, or return a hosted checkout that applies only after payment. */
+      create: (id: string, input: SubscriptionChangeCreate, options?: RequestOptions) => Promise<SubscriptionChangeResult>;
+      preview: (id: string, input: SubscriptionChangePreviewInput, options?: RequestOptions) => Promise<SubscriptionChangePreview>;
+    };
+    /**
+     * Cancels at period end by default; pass `{ atPeriodEnd: false }` to end it now. With a
+     * fallback plan it moves to that free plan instead (`subscription.updated`), keeping its ID.
+     */
     cancel: (id: string, input?: SubscriptionCancel, options?: RequestOptions) => Promise<Subscription>;
     resume: (id: string, options?: RequestOptions) => Promise<Subscription>;
   };
@@ -273,4 +318,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 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 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 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 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 PublicReceipt, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type ReceiptSnapshot, 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 SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, 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 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 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-Dp-Du1QO.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-CgBMbPS2.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-08", environment: "test" });
 * const { allowed } = await billete.features.consume("user_123", "tokens", 850);
 * ```
 */
@@ -80,6 +81,38 @@ function createBillete(options) {
 		token: () => apiKey
 	});
 	const customers = collection(http, "/v1/customers");
+	const memberPath = (customer) => `/v1/customers/${segment(customer)}/members`;
+	const members = {
+		list: (customer, query = {}, options) => http.request({
+			method: "GET",
+			path: memberPath(customer),
+			query,
+			options
+		}),
+		/** Re-adding a removed externalId restores its member ID and keeps its usage. */
+		create: (customer, input, options) => http.request({
+			method: "POST",
+			path: memberPath(customer),
+			body: input,
+			options
+		}),
+		retrieve: (customer, member, options) => http.request({
+			method: "GET",
+			path: `${memberPath(customer)}/${segment(member)}`,
+			options
+		}),
+		update: (customer, member, input, options) => http.request({
+			method: "PATCH",
+			path: `${memberPath(customer)}/${segment(member)}`,
+			body: input,
+			options
+		}),
+		remove: (customer, member, options) => http.request({
+			method: "DELETE",
+			path: `${memberPath(customer)}/${segment(member)}`,
+			options
+		})
+	};
 	const customerSessions = { 
 	/** Short-lived token for the client SDK to read one customer's billing state. */
 create: (input, options) => http.request({
@@ -122,24 +155,70 @@ create: (input, options) => http.request({
 		})
 	};
 	const customerFeature = (customer, key) => `/v1/customers/${segment(customer)}/features/${segment(key)}`;
+	const featureCrud = collection(http, "/v1/features");
+	const operationPath = (operation, action) => `/v1/feature-operations/${segment(operation)}${action ? `/${action}` : ""}`;
 	const features = {
-		...collection(http, "/v1/features"),
+		...featureCrud,
+		/**
+		* 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
+		* same reservation without consuming again; running each job once is your queue's job.
+		*/
+		reserve: (customer, key, amount, input, options) => http.request({
+			method: "POST",
+			path: `${customerFeature(customer, key)}/operations`,
+			body: {
+				...input,
+				amount
+			},
+			options
+		}),
+		/** Closes reservations. Each call is idempotent, so retry it on doubt instead of releasing. */
+		operations: {
+			retrieve: (operation, options) => http.request({
+				method: "GET",
+				path: operationPath(operation),
+				options
+			}),
+			/** Confirms what the job used (all by default) and returns the rest. */
+			commit: (operation, input = {}, options) => http.request({
+				method: "POST",
+				path: operationPath(operation, "commit"),
+				body: input,
+				options
+			}),
+			/** Returns a reservation whose job failed. */
+			release: (operation, options) => http.request({
+				method: "POST",
+				path: operationPath(operation, "release"),
+				options
+			}),
+			/** Returns everything a committed operation used, to the period it was counted in. */
+			refund: (operation, options) => http.request({
+				method: "POST",
+				path: operationPath(operation, "refund"),
+				options
+			})
+		},
 		/** Current access to one feature. `customer` is a `cus_…` ID or your own `externalId`. */
 		check: (customer, key, options) => http.request({
 			method: "GET",
 			path: customerFeature(customer, key),
+			query: { member: options?.member },
 			options
 		}),
 		/** `true` when the customer can use a boolean feature (or has a limit feature). */
 		isEnabled: async (customer, key, options) => (await http.request({
 			method: "GET",
 			path: customerFeature(customer, key),
+			query: { member: options?.member },
 			options
 		})).enabled,
 		/** Every feature and its usage for one customer. */
 		listForCustomer: (customer, options) => http.request({
 			method: "GET",
 			path: `/v1/customers/${segment(customer)}/features`,
+			query: { member: options?.member },
 			options
 		}),
 		/**
@@ -149,21 +228,34 @@ create: (input, options) => http.request({
 		consume: (customer, key, amount = 1, options) => http.request({
 			method: "POST",
 			path: `${customerFeature(customer, key)}/usage`,
-			body: { delta: amount },
+			body: {
+				delta: amount,
+				member: options?.member,
+				operation: options?.operation
+			},
 			options
 		}),
-		/** Gives back `amount` units (e.g. a folder was deleted). Usage never drops below zero. */
+		/**
+		* Gives back `amount` units of a `count` feature (e.g. a folder was deleted). Usage never drops
+		* below zero; metered usage is returned through its operation instead.
+		*/
 		release: (customer, key, amount = 1, options) => http.request({
 			method: "POST",
 			path: `${customerFeature(customer, key)}/usage`,
-			body: { delta: -amount },
+			body: {
+				delta: -amount,
+				member: options?.member
+			},
 			options
 		}),
 		/** Reports the absolute current usage (e.g. the customer now has 7 folders). */
 		set: (customer, key, value, options) => http.request({
 			method: "PUT",
 			path: `${customerFeature(customer, key)}/usage`,
-			body: { value },
+			body: {
+				value,
+				member: options?.member
+			},
 			options
 		})
 	};
@@ -195,7 +287,25 @@ create: (input, options) => http.request({
 	};
 	const subscriptions = {
 		...collection(http, "/v1/subscriptions"),
-		/** Cancels at period end by default; pass `{ atPeriodEnd: false }` to end it now. */
+		changes: {
+			/** Apply on renewal, or return a hosted checkout that applies only after payment. */
+			create: (id, input, options) => http.request({
+				method: "POST",
+				path: `/v1/subscriptions/${segment(id)}/changes`,
+				body: input,
+				options
+			}),
+			preview: (id, input, options) => http.request({
+				method: "POST",
+				path: `/v1/subscriptions/${segment(id)}/changes/preview`,
+				body: input,
+				options
+			})
+		},
+		/**
+		* Cancels at period end by default; pass `{ atPeriodEnd: false }` to end it now. With a
+		* fallback plan it moves to that free plan instead (`subscription.updated`), keeping its ID.
+		*/
 		cancel: (id, input = {}, options) => http.request({
 			method: "POST",
 			path: `/v1/subscriptions/${segment(id)}/cancel`,
@@ -273,6 +383,7 @@ create: (input, options) => http.request({
 	const eventCrud = collection(http, "/v1/events");
 	return {
 		customers,
+		members,
 		customerSessions,
 		portalSessions,
 		products,

package/dist/webhooks.d.ts

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