@boelabs/billete-sdk 1.1.0-canary.2 → 1.1.0-canary.3

package/README.md

@@ -75,6 +75,13 @@ const checkout = await billete.checkouts.create({
 Cuando el pago se confirma, Billete te avisa con el webhook `checkout.completed` (ver
 [Webhooks](#webhooks)).
 
+Los productos físicos habilitan sus formas de entrega con `fulfillmentMethods`, por ejemplo
+`["pickup", "shipping"]`; la lista está vacía por defecto. Cada método también debe estar activo
+en la configuración del negocio. Desactivarlo conserva la selección de los productos. El checkout
+ofrece «Acordar con el negocio» cuando los productos físicos tienen métodos habilitados y activos
+en el negocio. Sin entrega habilitada, no exige datos para entregarla; respeta los que el enlace
+solicite expresamente. En carritos, solo ofrece los demás métodos que todos los productos físicos admitan.
+
 ## Configuración
 
 ```ts
@@ -122,6 +129,7 @@ Todos los métodos devuelven promesas con el recurso tipado. Los recursos con li
 | `invoices` | `void` (cobros: renovaciones y cobros sueltos, con página de pago en `url`) |
 | `subscriptions` | `cancel`, `resume` |
 | `payments` | `refund`, `listRefunds` |
+| `fulfillments` | `deliver`, `submitTracking` (entregas de productos físicos; también `retrieve`, `list` e `iterate`) |
 | `payouts` | — |
 | `balance` | `retrieve` |
 | `webhookEndpoints` | `delete` |

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { $ as RISK_LEVELS, A as INVOICE_REASONS, At as ListQuery, B as PaymentFailure, Bt as isLandlinePhone, C as Event, Ct as BankCode, D as FeatureReset, Dt as GRACE_PERIOD_DAYS, E as Feature, Et as Currency, F as LineItem, Ft as TAX_BEHAVIORS, G as Plan, Gt as TokenKind, H as PaymentSettlement, Ht as nationalPhone, I as PAYMENT_STATUSES, It as TaxBehavior, J as PortalSession, K as PlanFeatureValues, Kt as tokenEnvironment, L as PRODUCT_CATEGORIES, Lt as Timestamp, M as Invoice, Mt as MOBILE_PREFIXES, N as InvoiceReason, Nt as Metadata, O as FeatureType, Ot as GracePeriodDays, P as InvoiceStatus, Pt as MobilePrefix, Q as RESET_FREQUENCIES, R as Payment, Rt as VENEZUELAN_BANKS, S as CustomerSession, St as BILLING_MONTHS, T as FEATURE_TYPES, Tt as CURRENCIES, U as PaymentStatus, Ut as ENVIRONMENTS, V as PaymentLink, Vt as isMobilePhone, W as Payout, Wt as Environment, X as ProductCategory, Y as Product, Z as ProductVariant, _ as CurrencyAvailability, _t as PAYMENT_FAILURE_CODES, a as Actor, at as SUBSCRIPTION_STATUSES, b as CustomerDetails, bt as Address, c as BalanceAmount, ct as SubscriptionRenewal, d as CancellationFeedback, dt as WebhookEndpoint, et as Refund, f as Checkout, ft as Weekday, g as Coupon, gt as ApiErrorType, h as CollectSettings, ht as ApiErrorEnvelope, i as WebhookEvent, it as SUBMIT_LABELS, j as INVOICE_STATUSES, jt as MAX_QUANTITY, k as FeatureUsageResult, kt as List, l as CANCELLATION_FEEDBACK, lt as SubscriptionStatus, m as CheckoutPurpose, mt as ApiErrorBody, n as EventDataMap, nt as Retirement, o as AfterCompletion, ot as SubmitLabel, p as CheckoutItem, pt as API_ERROR_TYPES, q as PlanPrice, qt as tokenPrefix, r as EventType, rt as RiskLevel, s as Balance, st as Subscription, t as EVENT_TYPES, tt as ResetFrequency, u as CHECKOUT_PURPOSES, ut as USAGE_FEATURE_TYPES, v as CustomField, vt as PaymentFailureCode, w as ExchangeRate, wt as BillingMonths, x as CustomerFeature, xt as AddressInput, y as Customer, yt as ACCOUNT_NUMBER_LENGTH, z as PaymentAttempt, zt as findBank } from "./events-71Q43Ni8.js";
-import { $ as PaymentNextAction, A as PlanCheckoutCreate, B as ProductUpdate, C as FeatureCreate, D as KEY_PATTERN, E as InvoiceLineInput, F as PlanUpdate, G as SubscriptionUpdate, H as RetireInput, I as PortalSessionCreate, J as WebhookEndpointUpdate, K as VariantInput, L as ProductCheckoutCreate, M as PlanFeaturesInput, N as PlanLinkCreate, O as PaymentLinkCreate, P as PlanPriceInput, Q as PaymentMethodOption, R as ProductCreate, S as EventSelector, T as InvoiceCreate, U as SubscriptionCancel, V as RefundCreate, W as SubscriptionCreate, X as PaymentInstructions, Y as CustomerSubscription, Z as PaymentMethodField, _ as CustomFieldInput, a as CheckoutCreate, at as PublicPaymentState, b as CustomerSessionCreate, c as ClientCheckoutUpdate, d as ClientPaymentCode, et as PaymentTestScenario, f as ClientSubscriptionCancel, g as CouponUpdate, h as CouponCreate, i as AfterCompletionInput, it as PublicPaymentLink, j as PlanCreate, k as PaymentLinkUpdate, l as ClientInvoicePay, m as CollectInput, n as RequestOptions, nt as PublicCheckout, o as CheckoutItemInput, ot as PublicPortal, p as ClientSubscriptionUpdate, q as WebhookEndpointCreate, r as TransportOptions, rt as PublicInvoice, s as ClientCheckoutPay, t as BilleteError, tt as PortalFeatures, u as ClientLinkCheckout, v as CustomerCreate, w as FeatureUpdate, x as CustomerUpdate, y as CustomerInput, z as ProductLinkCreate } from "./errors-Cge22x5-.js";
+import { $ as PaymentSettlement, $t as nationalPhone, A as FULFILLMENT_METHODS, At as ACCOUNT_NUMBER_LENGTH, B as FulfillmentTracking, Bt as List, C as Customer, Ct as Weekday, D as Event, Dt as ApiErrorType, E as CustomerSession, Et as ApiErrorEnvelope, F as FeatureUsageResult, Ft as BillingMonths, G as InvoiceStatus, Gt as MobilePrefix, H as INVOICE_STATUSES, Ht as MAX_QUANTITY, I as Fulfillment, It as CURRENCIES, J as PRODUCT_CATEGORIES, Jt as Timestamp, K as LineItem, Kt as TAX_BEHAVIORS, L as FulfillmentChoice, Lt as Currency, M as Feature, Mt as AddressInput, N as FeatureReset, Nt as BILLING_MONTHS, O as ExchangeRate, Ot as PAYMENT_FAILURE_CODES, P as FeatureType, Pt as BankCode, Q as PaymentLink, Qt as isMobilePhone, R as FulfillmentMethod, Rt as GRACE_PERIOD_DAYS, S as CustomField, St as WebhookEndpoint, T as CustomerFeature, Tt as ApiErrorBody, U as Invoice, Ut as MOBILE_PREFIXES, V as INVOICE_REASONS, Vt as ListQuery, W as InvoiceReason, Wt as Metadata, X as PaymentAttempt, Xt as findBank, Y as Payment, Yt as VENEZUELAN_BANKS, Z as PaymentFailure, Zt as isLandlinePhone, _ as CheckoutItem, _t as SubmitLabel, a as Actor, at as PortalSession, b as Coupon, bt as SubscriptionStatus, c as BalanceAmount, ct as ProductVariant, d as CARRIER_TEST_SCENARIOS, dt as Refund, en as ENVIRONMENTS, 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 tokenPrefix, it as PlanPrice, j as FULFILLMENT_STATUSES, jt as Address, k as FEATURE_TYPES, kt as PaymentFailureCode, l as CANCELLATION_FEEDBACK, lt as RESET_FREQUENCIES, m as Carrier, mt as RiskLevel, n as EventDataMap, nn as TokenKind, nt as Plan, o as AfterCompletion, ot as Product, p as CancellationFeedback, pt as Retirement, q as PAYMENT_STATUSES, qt as TaxBehavior, r as EventType, rn as tokenEnvironment, rt as PlanFeatureValues, s as Balance, st as ProductCategory, t as EVENT_TYPES, tn as Environment, tt as Payout, u as CARRIERS, ut as RISK_LEVELS, v as CheckoutPurpose, vt as Subscription, w as CustomerDetails, wt as API_ERROR_TYPES, x as CurrencyAvailability, xt as USAGE_FEATURE_TYPES, y as CollectSettings, yt as SubscriptionRenewal, z as FulfillmentStatus, zt as GracePeriodDays } from "./events-BZDc2Dkj.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-CDU2I75O.js";
 //#region src/create-client.d.ts
 interface ClientOptions extends TransportOptions {
   /**
@@ -20,6 +20,8 @@ interface ClientOptions extends TransportOptions {
  * ```
  */
 export declare function createClient(options?: ClientOptions): {
+  /** Offices offered by a carrier, refreshed daily by Billete. */
+  carrierOffices: (carrier: Carrier, options?: RequestOptions) => Promise<List<CarrierOffice>>;
   checkouts: {
     /** Authorizes the payment with the code; a wrong one fails with `payment_code_invalid`. */
     submitPaymentCode: (id: string, input: ClientPaymentCode, options?: RequestOptions) => Promise<PublicCheckout>;
@@ -58,6 +60,17 @@ export declare function createClient(options?: ClientOptions): {
     /** Submits the payment; the returned Cobro carries the payment status and any failure. */
     pay: (id: string, input: ClientInvoicePay, options?: RequestOptions) => Promise<PublicInvoice>;
   };
+  /**
+   * A purchase's delivery, as its customer follows it. The `token` comes in the link of the
+   * emails Billete sends them, and is the only credential.
+   */
+  fulfillments: {
+    retrieve: (token: string, options?: RequestOptions) => Promise<PublicFulfillment>;
+    /** The customer has it: the business gets its funds. */
+    confirmReceived: (token: string, options?: RequestOptions) => Promise<PublicFulfillment>;
+    /** Something went wrong: the funds stay held while Billete reviews it. */
+    reportProblem: (token: string, input: ClientFulfillmentProblem, options?: RequestOptions) => Promise<PublicFulfillment>;
+  };
   paymentLinks: {
     retrieve: (id: string, options?: RequestOptions) => Promise<PublicPaymentLink>;
     createCheckout: (id: string, selection?: ClientLinkCheckout, options?: RequestOptions) => Promise<PublicCheckout>;
@@ -89,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 CHECKOUT_PURPOSES, type CURRENCIES, type CancellationFeedback, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, 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 Feature, type FeatureCreate, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, 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 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 PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, 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 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 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 RESET_FREQUENCIES, type RISK_LEVELS, 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 };

package/dist/client.js

@@ -1,4 +1,4 @@
-import { n as segment, r as BilleteError, t as createTransport } from "./http-B3vk4X4A.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-Db6uoMeS.js";
 //#region src/create-client.ts
 /**
 * Browser client. It never holds a secret key: checkouts and Cobros are addressed by their
@@ -50,7 +50,15 @@ function createClient(options = {}) {
 		})
 	});
 	const invoicePath = (id) => `/v1/client/invoices/${segment(id)}`;
+	const fulfillmentPath = (token) => `/v1/client/fulfillments/${segment(token)}`;
 	return {
+		/** Offices offered by a carrier, refreshed daily by Billete. */
+		carrierOffices: (carrier, options) => http.request({
+			method: "GET",
+			path: "/v1/client/carrier-offices",
+			query: { carrier },
+			options
+		}),
 		checkouts: {
 			retrieve: (id, options) => http.request({
 				method: "GET",
@@ -100,6 +108,30 @@ function createClient(options = {}) {
 			}),
 			...paymentCode(invoicePath)
 		},
+		/**
+		* A purchase's delivery, as its customer follows it. The `token` comes in the link of the
+		* emails Billete sends them, and is the only credential.
+		*/
+		fulfillments: {
+			retrieve: (token, options) => http.request({
+				method: "GET",
+				path: fulfillmentPath(token),
+				options
+			}),
+			/** The customer has it: the business gets its funds. */
+			confirmReceived: (token, options) => http.request({
+				method: "POST",
+				path: `${fulfillmentPath(token)}/received`,
+				options
+			}),
+			/** Something went wrong: the funds stay held while Billete reviews it. */
+			reportProblem: (token, input, options) => http.request({
+				method: "POST",
+				path: `${fulfillmentPath(token)}/problem`,
+				body: input,
+				options
+			})
+		},
 		paymentLinks: {
 			retrieve: (id, options) => http.request({
 				method: "GET",

package/dist/{errors-Cge22x5-.d.ts → errors-CDU2I75O.d.ts}

@@ -1,4 +1,4 @@
-import { B as PaymentFailure, D as FeatureReset, Et as Currency, F as LineItem, It as TaxBehavior, Lt as Timestamp, N as InvoiceReason, Nt as Metadata, Ot as GracePeriodDays, P as InvoiceStatus, U as PaymentStatus, Wt as Environment, X as ProductCategory, b as CustomerDetails, d as CancellationFeedback, gt as ApiErrorType, h as CollectSettings, m as CheckoutPurpose, mt as ApiErrorBody, o as AfterCompletion, ot as SubmitLabel, p as CheckoutItem, q as PlanPrice, r as EventType, st as Subscription, v as CustomField, wt as BillingMonths, xt as AddressInput } from "./events-71Q43Ni8.js";
+import { B as FulfillmentTracking, Dt as ApiErrorType, Ft as BillingMonths, G as InvoiceStatus, I as Fulfillment, Jt as Timestamp, K as LineItem, Lt as Currency, Mt as AddressInput, N as FeatureReset, R as FulfillmentMethod, S as CustomField, Tt as ApiErrorBody, W as InvoiceReason, Wt as Metadata, Z as PaymentFailure, _ as CheckoutItem, _t as SubmitLabel, et as PaymentStatus, h as CarrierOffice, it as PlanPrice, jt as Address, m as Carrier, o as AfterCompletion, p as CancellationFeedback, qt as TaxBehavior, r as EventType, st as ProductCategory, tn as Environment, v as CheckoutPurpose, vt as Subscription, w as CustomerDetails, y as CollectSettings, z as FulfillmentStatus, zt as GracePeriodDays } from "./events-BZDc2Dkj.js";
 //#region ../contracts/src/client.d.ts
 /**
  * A subscription as its customer sees it, in the browser: without the business's `metadata`, with
@@ -128,9 +128,15 @@ interface PublicCheckout {
     months: BillingMonths;
     amount: number;
   }> | null;
+  /** Required customer details, including name and phone whenever fulfillment is offered. */
   collect: CollectSettings;
   customFields: CustomField[];
   customerDetails: CustomerDetails;
+  /**
+   * How the customer may receive the physical products, chosen when paying (`fulfillment`);
+   * `null` when nothing in it needs handing over.
+   */
+  fulfillmentOptions: FulfillmentOption[] | null;
   submitLabel: SubmitLabel;
   /** What follows payment; a redirect's URL already has `{CHECKOUT_ID}` replaced. */
   afterCompletion: AfterCompletion;
@@ -139,6 +145,56 @@ interface PublicCheckout {
   expiresAt: Timestamp;
   payment: PublicPaymentState | null;
 }
+/** A way to receive a purchase that the business offers, as its checkout shows it. */
+interface FulfillmentOption {
+  method: FulfillmentMethod;
+  /** Where to pick it up (`pickup`) or where the business delivers (`delivery`). */
+  location: string | null;
+  /** The carriers a `shipping` goes with; their offices are listed by `carrierOffices`. */
+  carriers: Carrier[] | null;
+  /** What the business tells customers about it: hours, delivery fees, how it contacts them. */
+  instructions: string | null;
+}
+/**
+ * A purchase's delivery as its customer follows it, on the page their emails link to. The link
+ * carries the only credential (`token`).
+ */
+interface PublicFulfillment {
+  id: string;
+  object: "fulfillment";
+  environment: Environment;
+  merchant: {
+    name: string;
+    supportEmail: string | null;
+    supportPhone: string | null;
+  };
+  method: FulfillmentMethod;
+  status: FulfillmentStatus;
+  option: FulfillmentOption;
+  recipient: {
+    name: string;
+    phone: string;
+    document: string | null;
+  };
+  address: Address | null;
+  office: CarrierOffice | null;
+  /** A shipment's tracking number and what the carrier reported. */
+  tracking: Pick<FulfillmentTracking, "number" | "carrierStatus" | "events"> | null;
+  notes: string | null;
+  items: CheckoutItem[];
+  currency: Currency;
+  total: number;
+  paidAt: Timestamp;
+  deliveredAt: Timestamp | null;
+  confirmBy: Timestamp | null;
+  receivedAt: Timestamp | null;
+  problem: {
+    comment: string;
+    reportedAt: Timestamp;
+  } | null;
+  canceledAt: Timestamp | null;
+  cancellationReason: Fulfillment["cancellationReason"];
+}
 /**
  * The step a provider asks of the payer after starting a charge: leave for its page and come back
  * (`redirect`), or send the funds to what is shown, often as a QR code (`display`).
@@ -278,6 +334,7 @@ interface PublicPaymentLink {
   adjustableQuantity: boolean;
   /** Most units per purchase when `adjustableQuantity`; `null` leaves stock as the only limit. */
   maxQuantity: number | null;
+  /** Effective required details; fulfillment adds name and phone to the saved preferences. */
   collect: CollectSettings;
   customFields: CustomField[];
   allowCoupons: boolean;
@@ -325,6 +382,8 @@ interface ProductCreate {
   description?: string;
   imageUrl?: string;
   category?: ProductCategory;
+  /** How a physical product may be received; none by default. */
+  fulfillmentMethods?: FulfillmentMethod[];
   currency: Currency;
   /** Required without variants; with variants, each variant has its price. */
   amount?: number | null;
@@ -338,6 +397,8 @@ interface ProductUpdate {
   description?: string | null;
   imageUrl?: string | null;
   category?: ProductCategory;
+  /** How a physical product may be received; none by default. */
+  fulfillmentMethods?: FulfillmentMethod[];
   currency?: Currency;
   amount?: number | null;
   stock?: number | null;
@@ -620,6 +681,38 @@ interface ClientCheckoutPay {
   phone?: string;
   address?: AddressInput;
   customFields?: Record<string, string | number>;
+  /**
+   * How the customer receives the physical products, among the checkout's `fulfillmentOptions`.
+   * Required when it offers any; `name` and `phone` are then required too.
+   */
+  fulfillment?: FulfillmentInput;
+}
+type FulfillmentInput = {
+  method: "arrange";
+  notes?: string;
+} | {
+  method: "pickup";
+  notes?: string;
+} | {
+  method: "delivery";
+  address: AddressInput;
+  notes?: string;
+} | {
+  method: "shipping";
+  carrier: Carrier;
+  /** The office's `code`, among `GET /v1/client/carrier-offices`. */
+  office: string;
+  /** The identity card the carrier asks for at the office: `V12345678`. */
+  document: string;
+  notes?: string;
+};
+/** The carrier's tracking number of a shipment, once the business sent it. */
+interface FulfillmentTrackingInput {
+  number: string;
+}
+/** What went wrong with a purchase the business marked as delivered. */
+interface ClientFulfillmentProblem {
+  comment: string;
 }
 //#endregion
 //#region src/http.d.ts
@@ -652,4 +745,4 @@ declare class BilleteError extends Error {
   }, status: number);
 }
 //#endregion
-export { PaymentNextAction as $, PlanCheckoutCreate as A, ProductUpdate as B, FeatureCreate as C, KEY_PATTERN as D, InvoiceLineInput as E, PlanUpdate as F, SubscriptionUpdate as G, RetireInput as H, PortalSessionCreate as I, WebhookEndpointUpdate as J, VariantInput as K, ProductCheckoutCreate as L, PlanFeaturesInput as M, PlanLinkCreate as N, PaymentLinkCreate as O, PlanPriceInput as P, PaymentMethodOption as Q, ProductCreate as R, EventSelector as S, InvoiceCreate as T, SubscriptionCancel as U, RefundCreate as V, SubscriptionCreate as W, PaymentInstructions as X, CustomerSubscription as Y, PaymentMethodField as Z, CustomFieldInput as _, CheckoutCreate as a, PublicPaymentState as at, CustomerSessionCreate as b, ClientCheckoutUpdate as c, ClientPaymentCode as d, PaymentTestScenario as et, ClientSubscriptionCancel as f, CouponUpdate as g, CouponCreate as h, AfterCompletionInput as i, PublicPaymentLink as it, PlanCreate as j, PaymentLinkUpdate as k, ClientInvoicePay as l, CollectInput as m, RequestOptions as n, PublicCheckout as nt, CheckoutItemInput as o, PublicPortal as ot, ClientSubscriptionUpdate as p, WebhookEndpointCreate as q, TransportOptions as r, PublicInvoice as rt, ClientCheckoutPay as s, BilleteError as t, PortalFeatures as tt, ClientLinkCheckout as u, CustomerCreate as v, FeatureUpdate as w, CustomerUpdate as x, CustomerInput as y, ProductLinkCreate as z };
+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 };

package/dist/{events-71Q43Ni8.d.ts → events-BZDc2Dkj.d.ts}

@@ -314,6 +314,11 @@ interface Product extends Resource<"product">, Retirement {
   description: string | null;
   imageUrl: string | null;
   category: ProductCategory;
+  /**
+   * How a `physical` product may be received, among the ways the business offers. Empty: it is
+   * not handed over through Billete, and its purchases complete as any other.
+   */
+  fulfillmentMethods: FulfillmentMethod[];
   currency: Currency;
   /** Null when price and inventory belong to variants. */
   amount: number | null;
@@ -587,12 +592,153 @@ interface Checkout extends Resource<"checkout"> {
   customFields: CustomField[];
   customFieldValues: Record<string, string | number>;
   customerDetails: CustomerDetails;
+  /** How the customer receives a purchase with physical products, once paid. */
+  fulfillmentId: string | null;
   successUrl: string | null;
   cancelUrl: string | null;
   expiresAt: Timestamp;
   completedAt: Timestamp | null;
   metadata: Metadata;
 }
+/**
+ * `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.
+ * `arrange`: they agree on it themselves (another carrier, a meeting point). Each product lists
+ * the ones it allows (`Product.fulfillmentMethods`).
+ */
+declare const FULFILLMENT_METHODS: readonly ["pickup", "delivery", "shipping", "arrange"];
+type FulfillmentMethod = (typeof FULFILLMENT_METHODS)[number];
+/** Carriers a business can ship with. Their offices and tracking come from their own APIs. */
+declare const CARRIERS: readonly ["zoom"];
+type Carrier = (typeof CARRIERS)[number];
+/**
+ * - `pending`: paid, waiting for the business to hand it over (or, when shipping, to send it
+ *   and add its tracking number before `trackingDueAt`).
+ * - `in_transit`: shipped; the carrier is taking it to the office.
+ * - `ready_for_pickup`: at the office, waiting for the customer.
+ * - `delivered`: the business says it handed it over; the customer has until `confirmBy` to
+ *   confirm or report a problem, after which it counts as received.
+ * - `received`: confirmed by the customer, by the carrier, or `confirmBy` passed. Its funds are
+ *   released.
+ * - `problem`: the customer reported a problem, or the carrier is returning it; Billete reviews it
+ *   and its funds stay held.
+ * - `canceled`: its payment was fully refunded, or it was not shipped in time.
+ */
+declare const FULFILLMENT_STATUSES: readonly ["pending", "in_transit", "ready_for_pickup", "delivered", "received", "problem", "canceled"];
+type FulfillmentStatus = (typeof FULFILLMENT_STATUSES)[number];
+/**
+ * Tracking numbers that trigger each outcome in the test environment, where no carrier is asked.
+ * `ready`, `delivered`, `returning`: ends in 2, 3 or 4; `other_office`: ends in 8;
+ * `not_found`: starts with 9. Any other number is in transit.
+ */
+declare const CARRIER_TEST_SCENARIOS: readonly [{
+  readonly number: "1000000001";
+  readonly description: "En camino";
+}, {
+  readonly number: "1000000002";
+  readonly description: "Disponible en la oficina";
+}, {
+  readonly number: "1000000003";
+  readonly description: "Entregada";
+}, {
+  readonly number: "1000000004";
+  readonly description: "En devolución";
+}, {
+  readonly number: "1000000008";
+  readonly description: "Va a otra oficina (se rechaza)";
+}, {
+  readonly number: "9000000001";
+  readonly description: "No existe (se rechaza)";
+}];
+/** A carrier's office where a shipment can be picked up. */
+interface CarrierOffice {
+  carrier: Carrier;
+  /** The carrier's own code for the office. */
+  code: string;
+  name: string;
+  address: string;
+  city: string;
+  state: string;
+  /** Opening hours as the carrier publishes them, one line per day. */
+  hours: string[];
+}
+/**
+ * A shipment's tracking number and what the carrier says about it. `verifying` until the carrier
+ * confirms the number exists and goes to the chosen office; a carrier that does not answer leaves
+ * it `verifying`, and the deadline waits for it.
+ */
+interface FulfillmentTracking {
+  number: string;
+  /** When the deadline was paused for this verification. */
+  submittedAt: Timestamp;
+  status: "verifying" | "verified";
+  /** The carrier's latest status, in its words. */
+  carrierStatus: string | null;
+  /** What the carrier reported, oldest first. */
+  events: Array<{
+    at: Timestamp;
+    description: string;
+    office: string | null;
+  }>;
+  /** When the carrier was last asked. */
+  checkedAt: Timestamp | null;
+}
+/** How a customer receives a physical purchase. Its funds are held until it is received. */
+interface Fulfillment extends Resource<"fulfillment"> {
+  checkoutId: string;
+  /** `null` when nothing was paid (a fully discounted purchase). */
+  paymentId: string | null;
+  customerId: string;
+  method: FulfillmentMethod;
+  status: FulfillmentStatus;
+  /**
+   * Who receives it and how the business reaches them. A shipment also carries the identity card
+   * the carrier asks for at the office (`V12345678`).
+   */
+  recipient: {
+    name: string;
+    phone: string;
+    document: string | null;
+  };
+  /** Where a `delivery` goes; `null` otherwise. */
+  address: Address | null;
+  /** The office a `shipping` goes to; `null` otherwise. */
+  office: CarrierOffice | null;
+  /** What the customer added: a landmark, a time that suits them. */
+  notes: string | null;
+  /** The physical items of the purchase. */
+  items: CheckoutItem[];
+  /** While a shipment is `pending`: when it is canceled if it has no tracking number. */
+  trackingDueAt: Timestamp | null;
+  tracking: FulfillmentTracking | null;
+  /** The last tracking number the carrier did not accept, and why; cleared by a valid one. */
+  trackingRejection: {
+    number: string;
+    reason: string;
+  } | null;
+  deliveredAt: Timestamp | null;
+  /** While `delivered`: when it counts as received if the customer says nothing. */
+  confirmBy: Timestamp | null;
+  receivedAt: Timestamp | null;
+  /**
+   * `customer`: they confirmed it. `timeout`: they said nothing before `confirmBy`. `carrier`: the
+   * carrier delivered it.
+   */
+  receivedBy: "customer" | "timeout" | "carrier" | null;
+  problem: {
+    comment: string;
+    reportedAt: Timestamp;
+  } | null;
+  canceledAt: Timestamp | null;
+  /**
+   * `refunded`: its payment was fully refunded. `not_shipped`: it had no valid tracking number by
+   * `trackingDueAt`; its funds stay held until the customer is refunded.
+   */
+  cancellationReason: "refunded" | "not_shipped" | null;
+  updatedAt: Timestamp;
+}
+/** What the customer chose when paying: how, and who receives it. */
+type FulfillmentChoice = Pick<Fulfillment, "method" | "recipient" | "address" | "office" | "notes">;
 declare const INVOICE_STATUSES: readonly ["open", "paid", "void", "uncollectible"];
 type InvoiceStatus = (typeof INVOICE_STATUSES)[number];
 /** `checkout`: the record of a paid checkout. `subscription_cycle`: a renewal. `manual`: one-off. */
@@ -713,6 +859,8 @@ interface Balance {
   available: BalanceAmount[];
   /** Funds still inside the settlement hold. */
   pending: BalanceAmount[];
+  /** Funds of purchases the customer has not received yet; released when they do. */
+  held: BalanceAmount[];
 }
 interface Payout extends Resource<"payout"> {
   amount: number;
@@ -776,6 +924,20 @@ interface EventDataMap {
   "payment.succeeded": Payment;
   "payment.failed": Payment;
   "payment.refunded": Payment;
+  /** A paid purchase with physical products is waiting to be handed over. */
+  "fulfillment.created": Fulfillment;
+  /** The carrier confirmed its tracking number: it is on its way to the office. */
+  "fulfillment.shipped": Fulfillment;
+  /** It is at the office, waiting for the customer. */
+  "fulfillment.ready_for_pickup": Fulfillment;
+  /** The business handed it over; the customer is asked to confirm. */
+  "fulfillment.delivered": Fulfillment;
+  /** The customer confirmed it, or did not answer in time. Its funds are released. */
+  "fulfillment.received": Fulfillment;
+  /** The customer reported a problem; its funds stay held while Billete reviews it. */
+  "fulfillment.problem_reported": Fulfillment;
+  /** Its payment was fully refunded, or it was not shipped in time. */
+  "fulfillment.canceled": Fulfillment;
   "refund.created": Refund;
   /** The provider could not return the funds; the amount is back in the balance. */
   "refund.failed": Refund;
@@ -796,7 +958,7 @@ 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", "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", "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;
@@ -807,4 +969,4 @@ type WebhookEvent = { [TType in EventType]: {
   data: EventDataMap[TType];
 }; }[EventType];
 //#endregion
-export { RISK_LEVELS as $, INVOICE_REASONS as A, ListQuery as At, PaymentFailure as B, isLandlinePhone as Bt, Event as C, BankCode as Ct, FeatureReset as D, GRACE_PERIOD_DAYS as Dt, Feature as E, Currency as Et, LineItem as F, TAX_BEHAVIORS as Ft, Plan as G, TokenKind as Gt, PaymentSettlement as H, nationalPhone as Ht, PAYMENT_STATUSES as I, TaxBehavior as It, PortalSession as J, PlanFeatureValues as K, tokenEnvironment as Kt, PRODUCT_CATEGORIES as L, Timestamp as Lt, Invoice as M, MOBILE_PREFIXES as Mt, InvoiceReason as N, Metadata as Nt, FeatureType as O, GracePeriodDays as Ot, InvoiceStatus as P, MobilePrefix as Pt, RESET_FREQUENCIES as Q, Payment as R, VENEZUELAN_BANKS as Rt, CustomerSession as S, BILLING_MONTHS as St, FEATURE_TYPES as T, CURRENCIES as Tt, PaymentStatus as U, ENVIRONMENTS as Ut, PaymentLink as V, isMobilePhone as Vt, Payout as W, Environment as Wt, ProductCategory as X, Product as Y, ProductVariant as Z, CurrencyAvailability as _, PAYMENT_FAILURE_CODES as _t, Actor as a, SUBSCRIPTION_STATUSES as at, CustomerDetails as b, Address as bt, BalanceAmount as c, SubscriptionRenewal as ct, CancellationFeedback as d, WebhookEndpoint as dt, Refund as et, Checkout as f, Weekday as ft, Coupon as g, ApiErrorType as gt, CollectSettings as h, ApiErrorEnvelope as ht, WebhookEvent as i, SUBMIT_LABELS as it, INVOICE_STATUSES as j, MAX_QUANTITY as jt, FeatureUsageResult as k, List as kt, CANCELLATION_FEEDBACK as l, SubscriptionStatus as lt, CheckoutPurpose as m, ApiErrorBody as mt, EventDataMap as n, Retirement as nt, AfterCompletion as o, SubmitLabel as ot, CheckoutItem as p, API_ERROR_TYPES as pt, PlanPrice as q, tokenPrefix as qt, EventType as r, RiskLevel as rt, Balance as s, Subscription as st, EVENT_TYPES as t, ResetFrequency as tt, CHECKOUT_PURPOSES as u, USAGE_FEATURE_TYPES as ut, CustomField as v, PaymentFailureCode as vt, ExchangeRate as w, BillingMonths as wt, CustomerFeature as x, AddressInput as xt, Customer as y, ACCOUNT_NUMBER_LENGTH as yt, PaymentAttempt as z, findBank as zt };
+export { PaymentSettlement as $, nationalPhone as $t, FULFILLMENT_METHODS as A, ACCOUNT_NUMBER_LENGTH as At, FulfillmentTracking as B, List as Bt, Customer as C, Weekday as Ct, Event as D, ApiErrorType as Dt, CustomerSession as E, ApiErrorEnvelope as Et, FeatureUsageResult as F, BillingMonths as Ft, InvoiceStatus as G, MobilePrefix as Gt, INVOICE_STATUSES as H, MAX_QUANTITY as Ht, Fulfillment as I, CURRENCIES as It, PRODUCT_CATEGORIES as J, Timestamp as Jt, LineItem as K, TAX_BEHAVIORS as Kt, FulfillmentChoice as L, Currency as Lt, Feature as M, AddressInput as Mt, FeatureReset as N, BILLING_MONTHS as Nt, ExchangeRate as O, PAYMENT_FAILURE_CODES as Ot, FeatureType as P, BankCode as Pt, PaymentLink as Q, isMobilePhone as Qt, FulfillmentMethod as R, GRACE_PERIOD_DAYS as Rt, CustomField as S, WebhookEndpoint as St, CustomerFeature as T, ApiErrorBody as Tt, Invoice as U, MOBILE_PREFIXES as Ut, INVOICE_REASONS as V, ListQuery as Vt, InvoiceReason as W, Metadata as Wt, PaymentAttempt as X, findBank as Xt, Payment as Y, VENEZUELAN_BANKS as Yt, PaymentFailure as Z, isLandlinePhone as Zt, CheckoutItem as _, SubmitLabel as _t, Actor as a, PortalSession as at, Coupon as b, SubscriptionStatus as bt, BalanceAmount as c, ProductVariant as ct, CARRIER_TEST_SCENARIOS as d, Refund as dt, ENVIRONMENTS 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, tokenPrefix as in, PlanPrice as it, FULFILLMENT_STATUSES as j, Address as jt, FEATURE_TYPES as k, PaymentFailureCode as kt, CANCELLATION_FEEDBACK as l, RESET_FREQUENCIES as lt, Carrier as m, RiskLevel as mt, EventDataMap as n, TokenKind as nn, Plan as nt, AfterCompletion as o, Product as ot, CancellationFeedback as p, Retirement as pt, PAYMENT_STATUSES as q, TaxBehavior as qt, EventType as r, tokenEnvironment as rn, PlanFeatureValues as rt, Balance as s, ProductCategory as st, EVENT_TYPES as t, Environment as tn, Payout as tt, CARRIERS as u, RISK_LEVELS as ut, CheckoutPurpose as v, Subscription as vt, CustomerDetails as w, API_ERROR_TYPES as wt, CurrencyAvailability as x, USAGE_FEATURE_TYPES as xt, CollectSettings as y, SubscriptionRenewal as yt, FulfillmentStatus as z, GracePeriodDays as zt };

package/dist/{http-B3vk4X4A.js → http-Db6uoMeS.js}

@@ -18,7 +18,7 @@ var BilleteError = class extends Error {
 };
 //#endregion
 //#region src/http.ts
-const SDK_VERSION = "1.1.0-canary.2";
+const SDK_VERSION = "1.1.0-canary.3";
 const DEFAULT_BASE_URL = "https://api.billete.run";
 const RETRYABLE_STATUS = /* @__PURE__ */ new Set([
 	429,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as RISK_LEVELS, A as INVOICE_REASONS, At as ListQuery, B as PaymentFailure, Bt as isLandlinePhone, C as Event, Ct as BankCode, D as FeatureReset, Dt as GRACE_PERIOD_DAYS, E as Feature, Et as Currency, F as LineItem, Ft as TAX_BEHAVIORS, G as Plan, Gt as TokenKind, H as PaymentSettlement, Ht as nationalPhone, I as PAYMENT_STATUSES, It as TaxBehavior, J as PortalSession, K as PlanFeatureValues, Kt as tokenEnvironment, L as PRODUCT_CATEGORIES, Lt as Timestamp, M as Invoice, Mt as MOBILE_PREFIXES, N as InvoiceReason, Nt as Metadata, O as FeatureType, Ot as GracePeriodDays, P as InvoiceStatus, Pt as MobilePrefix, Q as RESET_FREQUENCIES, R as Payment, Rt as VENEZUELAN_BANKS, S as CustomerSession, St as BILLING_MONTHS, T as FEATURE_TYPES, Tt as CURRENCIES, U as PaymentStatus, Ut as ENVIRONMENTS, V as PaymentLink, Vt as isMobilePhone, W as Payout, Wt as Environment, X as ProductCategory, Y as Product, Z as ProductVariant, _ as CurrencyAvailability, _t as PAYMENT_FAILURE_CODES, a as Actor, at as SUBSCRIPTION_STATUSES, b as CustomerDetails, bt as Address, c as BalanceAmount, ct as SubscriptionRenewal, d as CancellationFeedback, dt as WebhookEndpoint, et as Refund, f as Checkout, ft as Weekday, g as Coupon, gt as ApiErrorType, h as CollectSettings, ht as ApiErrorEnvelope, i as WebhookEvent, it as SUBMIT_LABELS, j as INVOICE_STATUSES, jt as MAX_QUANTITY, k as FeatureUsageResult, kt as List, l as CANCELLATION_FEEDBACK, lt as SubscriptionStatus, m as CheckoutPurpose, mt as ApiErrorBody, n as EventDataMap, nt as Retirement, o as AfterCompletion, ot as SubmitLabel, p as CheckoutItem, pt as API_ERROR_TYPES, q as PlanPrice, qt as tokenPrefix, r as EventType, rt as RiskLevel, s as Balance, st as Subscription, t as EVENT_TYPES, tt as ResetFrequency, u as CHECKOUT_PURPOSES, ut as USAGE_FEATURE_TYPES, v as CustomField, vt as PaymentFailureCode, w as ExchangeRate, wt as BillingMonths, x as CustomerFeature, xt as AddressInput, y as Customer, yt as ACCOUNT_NUMBER_LENGTH, z as PaymentAttempt, zt as findBank } from "./events-71Q43Ni8.js";
-import { $ as PaymentNextAction, A as PlanCheckoutCreate, B as ProductUpdate, C as FeatureCreate, D as KEY_PATTERN, E as InvoiceLineInput, F as PlanUpdate, G as SubscriptionUpdate, H as RetireInput, I as PortalSessionCreate, J as WebhookEndpointUpdate, K as VariantInput, L as ProductCheckoutCreate, M as PlanFeaturesInput, N as PlanLinkCreate, O as PaymentLinkCreate, P as PlanPriceInput, Q as PaymentMethodOption, R as ProductCreate, S as EventSelector, T as InvoiceCreate, U as SubscriptionCancel, V as RefundCreate, W as SubscriptionCreate, X as PaymentInstructions, Y as CustomerSubscription, Z as PaymentMethodField, _ as CustomFieldInput, a as CheckoutCreate, at as PublicPaymentState, b as CustomerSessionCreate, c as ClientCheckoutUpdate, d as ClientPaymentCode, et as PaymentTestScenario, f as ClientSubscriptionCancel, g as CouponUpdate, h as CouponCreate, i as AfterCompletionInput, it as PublicPaymentLink, j as PlanCreate, k as PaymentLinkUpdate, l as ClientInvoicePay, m as CollectInput, n as RequestOptions, nt as PublicCheckout, o as CheckoutItemInput, ot as PublicPortal, p as ClientSubscriptionUpdate, q as WebhookEndpointCreate, r as TransportOptions, rt as PublicInvoice, s as ClientCheckoutPay, t as BilleteError, tt as PortalFeatures, u as ClientLinkCheckout, v as CustomerCreate, w as FeatureUpdate, x as CustomerUpdate, y as CustomerInput, z as ProductLinkCreate } from "./errors-Cge22x5-.js";
+import { $ as PaymentSettlement, $t as nationalPhone, A as FULFILLMENT_METHODS, At as ACCOUNT_NUMBER_LENGTH, B as FulfillmentTracking, Bt as List, C as Customer, Ct as Weekday, D as Event, Dt as ApiErrorType, E as CustomerSession, Et as ApiErrorEnvelope, F as FeatureUsageResult, Ft as BillingMonths, G as InvoiceStatus, Gt as MobilePrefix, H as INVOICE_STATUSES, Ht as MAX_QUANTITY, I as Fulfillment, It as CURRENCIES, J as PRODUCT_CATEGORIES, Jt as Timestamp, K as LineItem, Kt as TAX_BEHAVIORS, L as FulfillmentChoice, Lt as Currency, M as Feature, Mt as AddressInput, N as FeatureReset, Nt as BILLING_MONTHS, O as ExchangeRate, Ot as PAYMENT_FAILURE_CODES, P as FeatureType, Pt as BankCode, Q as PaymentLink, Qt as isMobilePhone, R as FulfillmentMethod, Rt as GRACE_PERIOD_DAYS, S as CustomField, St as WebhookEndpoint, T as CustomerFeature, Tt as ApiErrorBody, U as Invoice, Ut as MOBILE_PREFIXES, V as INVOICE_REASONS, Vt as ListQuery, W as InvoiceReason, Wt as Metadata, X as PaymentAttempt, Xt as findBank, Y as Payment, Yt as VENEZUELAN_BANKS, Z as PaymentFailure, Zt as isLandlinePhone, _ as CheckoutItem, _t as SubmitLabel, a as Actor, at as PortalSession, b as Coupon, bt as SubscriptionStatus, c as BalanceAmount, ct as ProductVariant, d as CARRIER_TEST_SCENARIOS, dt as Refund, en as ENVIRONMENTS, 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 tokenPrefix, it as PlanPrice, j as FULFILLMENT_STATUSES, jt as Address, k as FEATURE_TYPES, kt as PaymentFailureCode, l as CANCELLATION_FEEDBACK, lt as RESET_FREQUENCIES, m as Carrier, mt as RiskLevel, n as EventDataMap, nn as TokenKind, nt as Plan, o as AfterCompletion, ot as Product, p as CancellationFeedback, pt as Retirement, q as PAYMENT_STATUSES, qt as TaxBehavior, r as EventType, rn as tokenEnvironment, rt as PlanFeatureValues, s as Balance, st as ProductCategory, t as EVENT_TYPES, tn as Environment, tt as Payout, u as CARRIERS, ut as RISK_LEVELS, v as CheckoutPurpose, vt as Subscription, w as CustomerDetails, wt as API_ERROR_TYPES, x as CurrencyAvailability, xt as USAGE_FEATURE_TYPES, y as CollectSettings, yt as SubscriptionRenewal, z as FulfillmentStatus, zt as GracePeriodDays } from "./events-BZDc2Dkj.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-CDU2I75O.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region src/server.d.ts
 type Filters<T> = ListQuery & T;
@@ -187,6 +187,21 @@ export declare function createBillete(options: BilleteOptions): {
     refund: (id: string, input?: RefundCreate, options?: RequestOptions) => Promise<Refund>;
     listRefunds: (id: string, options?: RequestOptions) => Promise<List<Refund>>;
   };
+  fulfillments: {
+    retrieve: (id: string, options?: RequestOptions) => Promise<Fulfillment>;
+    list: (query?: Filters<{
+      status?: FulfillmentStatus;
+      search?: string;
+    }>, options?: RequestOptions) => Promise<List<Fulfillment>>;
+    iterate: (query?: Filters<{
+      status?: FulfillmentStatus;
+      search?: string;
+    }>) => AsyncGenerator<Fulfillment, any, any>;
+    /** Sends a tracking number to be verified against the customer's chosen office. */
+    submitTracking: (id: string, input: FulfillmentTrackingInput, options?: RequestOptions) => Promise<Fulfillment>;
+    /** You handed it over: the customer has 48 hours to confirm it or report a problem. */
+    deliver: (id: string, options?: RequestOptions) => Promise<Fulfillment>;
+  };
   balance: {
     retrieve: (options?: RequestOptions) => Promise<Balance>;
   };
@@ -231,4 +246,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 CHECKOUT_PURPOSES, type CURRENCIES, type CancellationFeedback, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, 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 Feature, type FeatureCreate, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, 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 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 PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, 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 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 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 RESET_FREQUENCIES, type RISK_LEVELS, 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 };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as segment, r as BilleteError, t as createTransport } from "./http-B3vk4X4A.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-Db6uoMeS.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region ../contracts/src/environment.ts
 /**
@@ -225,6 +225,26 @@ create: (input, options) => http.request({
 			options
 		})
 	};
+	const fulfillmentCrud = collection(http, "/v1/fulfillments");
+	/** How customers receive physical purchases; each one's funds are held until it is received. */
+	const fulfillments = {
+		retrieve: fulfillmentCrud.retrieve,
+		list: fulfillmentCrud.list,
+		iterate: fulfillmentCrud.iterate,
+		/** Sends a tracking number to be verified against the customer's chosen office. */
+		submitTracking: (id, input, options) => http.request({
+			method: "POST",
+			path: `/v1/fulfillments/${segment(id)}/tracking`,
+			body: input,
+			options
+		}),
+		/** You handed it over: the customer has 48 hours to confirm it or report a problem. */
+		deliver: (id, options) => http.request({
+			method: "POST",
+			path: `/v1/fulfillments/${segment(id)}/deliver`,
+			options
+		})
+	};
 	const balance = { retrieve: (options) => http.request({
 		method: "GET",
 		path: "/v1/balance",
@@ -258,6 +278,7 @@ create: (input, options) => http.request({
 		invoices,
 		subscriptions,
 		payments,
+		fulfillments,
 		balance,
 		payouts,
 		webhookEndpoints,

package/dist/webhooks.d.ts

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