@boelabs/billete-sdk 4.1.0 → 4.3.0

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { $ as SubscriptionCancel, A as FeatureUpdate, At as apiVersionLifecycle, B as PlanCreate, C as CustomerMemberUpdate, Ct as API_VERSION_HEADER, D as FeatureCreate, Dt as ApiVersionStage, E as EventSelector, Et as ApiVersionLifecycle, F as KEY_PATTERN, Ft as supportedApiVersions, G as PortalSessionCreate, H as PlanLinkCreate, I as PaymentLinkCreate, J as ProductCreate, K as ProductCheckoutCreate, L as PaymentLinkUpdate, M as FulfillmentTrackingInput, Mt as currentApiVersion, N as InvoiceCreate, Nt as isApiVersion, O as FeatureOperationCommit, Ot as LATEST_API_VERSION, P as InvoiceLineInput, Pt as isApiVersionRetired, Q as RetireInput, R as PlanCheckoutCreate, S as CustomerMemberCreate, St as API_VERSIONS, T as CustomerUpdate, Tt as ApiVersion, U as PlanPriceInput, V as PlanFeaturesInput, W as PlanUpdate, X as ProductUpdate, Y as ProductLinkCreate, Z as RefundCreate, _ as CouponCreate, _t as PublicFulfillment, a as CheckoutCreate, at as WebhookEndpointCreate, b as CustomerCreate, bt as PublicPaymentState, c as ClientCheckoutUpdate, ct as CustomerSubscriptionChangeResult, d as ClientLinkCheckout, dt as PaymentMethodField, et as SubscriptionChangeCreate, f as ClientPaymentCode, ft as PaymentMethodOption, g as CollectInput, gt as PublicCheckout, h as ClientSubscriptionUpdate, ht as PortalFeatures, i as AfterCompletionInput, it as VariantInput, j as FulfillmentInput, jt as apiVersionStage, k as FeatureOperationCreate, kt as LatestApiVersion, l as ClientFulfillmentProblem, lt as FulfillmentOption, m as ClientSubscriptionSeats, mt as PaymentTestScenario, n as RequestOptions, nt as SubscriptionCreate, o as CheckoutItemInput, ot as WebhookEndpointUpdate, p as ClientSubscriptionCancel, pt as PaymentNextAction, q as ProductCouponCreate, r as TransportOptions, rt as SubscriptionUpdate, s as ClientCheckoutPay, st as CustomerSubscription, t as BilleteError, tt as SubscriptionChangePreviewInput, u as ClientInvoicePay, ut as PaymentInstructions, v as CouponUpdate, vt as PublicInvoice, w as CustomerSessionCreate, wt as API_VERSION_PATTERN, x as CustomerInput, xt as PublicPortal, y as CustomFieldInput, yt as PublicPaymentLink, z as PlanCouponCreate } from "./errors-AObvDES-.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-C0pKiZ_h.js";
+import { $ as ProductLinkCreate, A as EventSelector, At as API_VERSION_PATTERN, B as PaymentLinkCreate, Bt as isApiVersionRetired, C as CustomFieldInput, Ct as PublicFulfillment, D as CustomerMemberUpdate, Dt as PublicPortal, E as CustomerMemberCreate, Et as PublicPaymentState, F as FulfillmentInput, Ft as LatestApiVersion, G as PlanFeaturesInput, H as PlanCheckoutCreate, I as FulfillmentTrackingInput, It as apiVersionLifecycle, J as PlanUpdate, K as PlanLinkCreate, L as InvoiceCreate, Lt as apiVersionStage, M as FeatureOperationCommit, Mt as ApiVersionLifecycle, N as FeatureOperationCreate, Nt as ApiVersionStage, O as CustomerSessionCreate, Ot as API_VERSIONS, P as FeatureUpdate, Pt as LATEST_API_VERSION, Q as ProductCreate, R as InvoiceLineInput, Rt as currentApiVersion, S as CouponUpdate, St as PublicClaimSummary, T as CustomerInput, Tt as PublicPaymentLink, U as PlanCouponCreate, V as PaymentLinkUpdate, Vt as supportedApiVersions, W as PlanCreate, X as ProductCheckoutCreate, Y as PortalSessionCreate, Z as ProductCouponCreate, _ as ClientSubscriptionCancel, _t as PaymentNextAction, a as CheckoutCreate, at as SubscriptionChangePreviewInput, b as CollectInput, bt as PublicCheckout, c as ClaimRespond, ct as VariantInput, d as ClientClaimCreate, dt as CustomerSubscription, et as ProductUpdate, f as ClientCustomerClaimCreate, ft as CustomerSubscriptionChangeResult, g as ClientPaymentCode, gt as PaymentMethodOption, h as ClientLinkCheckout, ht as PaymentMethodField, i as AfterCompletionInput, it as SubscriptionChangeCreate, j as FeatureCreate, jt as ApiVersion, k as CustomerUpdate, kt as API_VERSION_HEADER, l as ClientCheckoutPay, lt as WebhookEndpointCreate, m as ClientInvoicePay, mt as PaymentInstructions, n as RequestOptions, nt as RetireInput, o as CheckoutItemInput, ot as SubscriptionCreate, p as ClientFulfillmentProblem, pt as FulfillmentOption, q as PlanPriceInput, r as TransportOptions, rt as SubscriptionCancel, s as ClaimResolve, st as SubscriptionUpdate, t as BilleteError, tt as RefundCreate, u as ClientCheckoutUpdate, ut as WebhookEndpointUpdate, v as ClientSubscriptionSeats, vt as PaymentTestScenario, w as CustomerCreate, wt as PublicInvoice, x as CouponCreate, xt as PublicClaim, y as ClientSubscriptionUpdate, yt as PortalFeatures, z as KEY_PATTERN, zt as isApiVersion } from "./errors-DCiynKkL.js";
+import { $ as FulfillmentStatus, $t as ACCOUNT_NUMBER_LENGTH, A as Coupon, At as Retirement, B as ExchangeRate, Bt as SubscriptionStatus, C as CheckoutPurpose, Cn as nationalPhone, Ct as Product, D as ClaimReason, Dn as tokenEnvironment, Dt as RISK_LEVELS, E as ClaimOutcome, En as TokenKind, Et as RESET_FREQUENCIES, F as CustomerFeature, Ft as Subscription, G as FeatureOperation, Gt as ReceiptReference, H as FULFILLMENT_METHODS, Ht as USAGE_FEATURE_TYPES, I as CustomerMember, It as SubscriptionChange, J as FeatureType, Jt as ApiErrorBody, K as FeatureOperationResult, Kt as ReceiptSend, L as CustomerMemberList, Lt as SubscriptionChangePreview, M as CustomField, Mt as SUBMIT_LABELS, N as Customer, Nt as SUBSCRIPTION_STATUSES, O as ClaimStatus, On as tokenPrefix, Ot as Refund, P as CustomerDetails, Pt as SubmitLabel, Q as FulfillmentMethod, Qt as PaymentFailureCode, R as CustomerSession, Rt as SubscriptionChangeResult, S as CheckoutItem, Sn as isMobilePhone, St as PortalSession, T as ClaimMessage, Tn as Environment, Tt as ProductVariant, U as FULFILLMENT_STATUSES, Ut as WebhookEndpoint, V as FEATURE_TYPES, Vt as SubscriptionTerms, W as Feature, Wt as Weekday, X as Fulfillment, Xt as ApiErrorType, Y as FeatureUsageResult, Yt as ApiErrorEnvelope, Z as FulfillmentChoice, Zt as PAYMENT_FAILURE_CODES, _ as CLAIM_STATUSES, _n as TaxBehavior, _t as Payout, a as WEBHOOK_TEST_EVENT, an as CURRENCIES, at as InvoiceStatus, b as CarrierOffice, bn as findBank, bt as PlanPrice, c as AfterCompletion, cn as GracePeriodDays, ct as PAYMENT_STATUSES, d as CANCELLATION_FEEDBACK, dn as ListSort, dt as PaymentAttempt, en as Address, et as FulfillmentTracking, f as CARRIERS, fn as MAX_QUANTITY, ft as PaymentFailure, g as CLAIM_REASONS, gn as TAX_BEHAVIORS, gt as PaymentStatus, h as CLAIM_OUTCOMES, hn as MobilePrefix, ht as PaymentSettlement, i as SubscribableEventType, in as BillingMonths, it as InvoiceReason, j as CurrencyAvailability, jt as RiskLevel, k as CollectSettings, kt as ResetFrequency, l as Balance, ln as List, lt as PRODUCT_CATEGORIES, m as CHECKOUT_PURPOSES, mn as Metadata, mt as PaymentLink, n as EventDataMap, nn as BILLING_MONTHS, nt as INVOICE_STATUSES, o as WebhookEvent, on as Currency, ot as LineItem, p as CARRIER_TEST_SCENARIOS, pn as MOBILE_PREFIXES, pt as PaymentFeeDetails, q as FeatureReset, qt as API_ERROR_TYPES, r as EventType, rn as BankCode, rt as Invoice, s as Actor, sn as GRACE_PERIOD_DAYS, st as MAX_SEATS, t as EVENT_TYPES, tn as AddressInput, tt as INVOICE_REASONS, u as BalanceAmount, un as ListQuery, ut as Payment, v as CancellationFeedback, vn as Timestamp, vt as Plan, w as Claim, wn as ENVIRONMENTS, wt as ProductCategory, x as Checkout, xn as isLandlinePhone, xt as PlanSeats, y as Carrier, yn as VENEZUELAN_BANKS, yt as PlanFeatureValues, z as Event, zt as SubscriptionRenewal } from "./events-CaNwG-EX.js";
 //#region src/create-client.d.ts
 interface ClientOptions extends TransportOptions {
   /**
@@ -41,6 +41,7 @@ export declare function createClient(options: ClientOptions): {
     paymentMethods: (id: string, options?: RequestOptions) => Promise<List<PaymentMethodOption>>;
     /** Submits the payment; the returned checkout carries the payment status and any failure. */
     pay: (id: string, input: ClientCheckoutPay, options?: RequestOptions) => Promise<PublicCheckout>;
+    openClaim: (id: string, input: ClientClaimCreate, options?: RequestOptions) => Promise<PublicClaim>;
   };
   invoices: {
     /** Authorizes the payment with the code; a wrong one fails with `payment_code_invalid`. */
@@ -59,6 +60,7 @@ export declare function createClient(options: ClientOptions): {
     paymentMethods: (id: string, options?: RequestOptions) => Promise<List<PaymentMethodOption>>;
     /** Submits the payment; the returned Cobro carries the payment status and any failure. */
     pay: (id: string, input: ClientInvoicePay, options?: RequestOptions) => Promise<PublicInvoice>;
+    openClaim: (id: string, input: ClientClaimCreate, options?: RequestOptions) => Promise<PublicClaim>;
   };
   /**
    * A purchase's delivery, as its customer follows it. The `token` comes in the link of the
@@ -68,9 +70,26 @@ export declare function createClient(options: ClientOptions): {
     retrieve: (token: string, options?: RequestOptions) => Promise<PublicFulfillment>;
     /** The customer has it: the business gets its funds. */
     confirmReceived: (token: string, options?: RequestOptions) => Promise<PublicFulfillment>;
+    /**
+     * Opens a claim about the payment that bought it, whatever the delivery's status; one not
+     * received yet goes to `problem` and its funds stay held. The delivery comes back with the
+     * claim (`claim`), whose page (`claim.url`) the customer follows.
+     */
+    openClaim: (token: string, input: ClientClaimCreate, options?: RequestOptions) => Promise<PublicFulfillment>;
     /** Something went wrong: the funds stay held while Billete reviews it. */
     reportProblem: (token: string, input: ClientFulfillmentProblem, options?: RequestOptions) => Promise<PublicFulfillment>;
   };
+  /**
+   * A claim about a payment, as its customer follows it. The `token` comes in its page's link
+   * (`url`), sent by email when it is opened, and is the only credential.
+   */
+  claims: {
+    retrieve: (token: string, options?: RequestOptions) => Promise<PublicClaim>;
+    /** Writes to the business; the business is told. */
+    respond: (token: string, input: ClaimRespond, options?: RequestOptions) => Promise<PublicClaim>;
+    /** Drops it. A delivery it held stays held until it is confirmed received. */
+    withdraw: (token: string, options?: RequestOptions) => Promise<PublicClaim>;
+  };
   paymentLinks: {
     retrieve: (id: string, options?: RequestOptions) => Promise<PublicPaymentLink>;
     createCheckout: (id: string, selection?: ClientLinkCheckout, options?: RequestOptions) => Promise<PublicCheckout>;
@@ -101,10 +120,12 @@ export declare function createClient(options: ClientOptions): {
     changeSeats: (id: string, input: ClientSubscriptionSeats, options?: RequestOptions) => Promise<CustomerSubscriptionChangeResult>;
     /** Withdraws the mandate: renewals are then paid by hand from their Cobro. */
     stopAutoCharge: (id: string, options?: RequestOptions) => Promise<CustomerSubscription>;
+    /** Opens a claim about one of the customer's payments (`PublicPortal.invoices[].payment`). */
+    openClaim: (input: ClientCustomerClaimCreate, options?: RequestOptions) => Promise<PublicClaim>;
     features: (options?: RequestOptions) => Promise<List<CustomerFeature>>;
     feature: (key: string, options?: RequestOptions) => Promise<CustomerFeature>;
   };
 };
 type BilleteClient = ReturnType<typeof createClient>;
 //#endregion
-export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type BilleteClient, BilleteError, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientOptions, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type 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 };
+export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type BilleteClient, BilleteError, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CLAIM_OUTCOMES, type CLAIM_REASONS, type CLAIM_STATUSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type Claim, type ClaimMessage, type ClaimOutcome, type ClaimReason, type ClaimResolve, type ClaimRespond, type ClaimStatus, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientClaimCreate, type ClientCustomerClaimCreate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientOptions, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentFeeDetails, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type PublicClaim, type PublicClaimSummary, type PublicFulfillment, type PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type Refund, type RefundCreate, type RequestOptions, type ResetFrequency, type RetireInput, type Retirement, type RiskLevel, type SUBMIT_LABELS, type SUBSCRIPTION_STATUSES, type SubmitLabel, type SubscribableEventType, type Subscription, type SubscriptionCancel, type SubscriptionChange, type SubscriptionChangeCreate, type SubscriptionChangePreview, type SubscriptionChangePreviewInput, type SubscriptionChangeResult, type SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, type SubscriptionTerms, type SubscriptionUpdate, type TAX_BEHAVIORS, type TaxBehavior, type Timestamp, type TokenKind, type USAGE_FEATURE_TYPES, type VENEZUELAN_BANKS, type VariantInput, type WEBHOOK_TEST_EVENT, type WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, type Weekday, type apiVersionLifecycle, type apiVersionStage, type currentApiVersion, type findBank, type isApiVersion, type isApiVersionRetired, type isLandlinePhone, type isMobilePhone, type nationalPhone, type supportedApiVersions, type tokenEnvironment, type tokenPrefix };

package/dist/client.js

@@ -1,4 +1,4 @@
-import { n as segment, r as BilleteError, t as createTransport } from "./http-D1e4okoX.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-BfxFFQqw.js";
 //#region src/create-client.ts
 /**
 * Browser client. It never holds a secret key: checkouts and Cobros are addressed by their
@@ -51,6 +51,14 @@ function createClient(options) {
 	});
 	const invoicePath = (id) => `/v1/client/invoices/${segment(id)}`;
 	const fulfillmentPath = (token) => `/v1/client/fulfillments/${segment(token)}`;
+	const claimPath = (token) => `/v1/client/claims/${segment(token)}`;
+	/** Opens a claim about the payment of a paid checkout or Cobro, from its page. */
+	const openClaim = (path) => (id, input, options) => http.request({
+		method: "POST",
+		path: `${path(id)}/claims`,
+		body: input,
+		options
+	});
 	return {
 		/** Offices offered by a carrier, refreshed daily by Billete. */
 		carrierOffices: (carrier, options) => http.request({
@@ -85,7 +93,8 @@ function createClient(options) {
 				body: input,
 				options
 			}),
-			...paymentCode(checkoutPath)
+			...paymentCode(checkoutPath),
+			openClaim: openClaim(checkoutPath)
 		},
 		invoices: {
 			retrieve: (id, options) => http.request({
@@ -106,7 +115,8 @@ function createClient(options) {
 				body: input,
 				options
 			}),
-			...paymentCode(invoicePath)
+			...paymentCode(invoicePath),
+			openClaim: openClaim(invoicePath)
 		},
 		/**
 		* A purchase's delivery, as its customer follows it. The `token` comes in the link of the
@@ -124,6 +134,17 @@ function createClient(options) {
 				path: `${fulfillmentPath(token)}/received`,
 				options
 			}),
+			/**
+			* Opens a claim about the payment that bought it, whatever the delivery's status; one not
+			* received yet goes to `problem` and its funds stay held. The delivery comes back with the
+			* claim (`claim`), whose page (`claim.url`) the customer follows.
+			*/
+			openClaim: (token, input, options) => http.request({
+				method: "POST",
+				path: `${fulfillmentPath(token)}/claims`,
+				body: input,
+				options
+			}),
 			/** Something went wrong: the funds stay held while Billete reviews it. */
 			reportProblem: (token, input, options) => http.request({
 				method: "POST",
@@ -132,6 +153,30 @@ function createClient(options) {
 				options
 			})
 		},
+		/**
+		* A claim about a payment, as its customer follows it. The `token` comes in its page's link
+		* (`url`), sent by email when it is opened, and is the only credential.
+		*/
+		claims: {
+			retrieve: (token, options) => http.request({
+				method: "GET",
+				path: claimPath(token),
+				options
+			}),
+			/** Writes to the business; the business is told. */
+			respond: (token, input, options) => http.request({
+				method: "POST",
+				path: `${claimPath(token)}/respond`,
+				body: input,
+				options
+			}),
+			/** Drops it. A delivery it held stays held until it is confirmed received. */
+			withdraw: (token, options) => http.request({
+				method: "POST",
+				path: `${claimPath(token)}/withdraw`,
+				options
+			})
+		},
 		paymentLinks: {
 			retrieve: (id, options) => http.request({
 				method: "GET",
@@ -211,6 +256,13 @@ list: (options) => http.request({
 				path: `/v1/client/customer/subscriptions/${segment(id)}/stop-auto-charge`,
 				options
 			}),
+			/** Opens a claim about one of the customer's payments (`PublicPortal.invoices[].payment`). */
+			openClaim: (input, options) => http.request({
+				method: "POST",
+				path: "/v1/client/customer/claims",
+				body: input,
+				options
+			}),
 			features: (options) => http.request({
 				method: "GET",
 				path: "/v1/client/customer/features",

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

@@ -1,4 +1,4 @@
-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-C0pKiZ_h.js";
+import { $ as FulfillmentStatus, C as CheckoutPurpose, D as ClaimReason, E as ClaimOutcome, Ft as Subscription, Gt as ReceiptReference, Jt as ApiErrorBody, M as CustomField, O as ClaimStatus, Ot as Refund, P as CustomerDetails, Pt as SubmitLabel, Q as FulfillmentMethod, S as CheckoutItem, T as ClaimMessage, Tn as Environment, X as Fulfillment, Xt as ApiErrorType, _n as TaxBehavior, at as InvoiceStatus, b as CarrierOffice, bt as PlanPrice, c as AfterCompletion, cn as GracePeriodDays, en as Address, et as FulfillmentTracking, ft as PaymentFailure, gt as PaymentStatus, i as SubscribableEventType, in as BillingMonths, it as InvoiceReason, k as CollectSettings, mn as Metadata, on as Currency, ot as LineItem, q as FeatureReset, tn as AddressInput, v as CancellationFeedback, vn as Timestamp, wt as ProductCategory, xt as PlanSeats, y as Carrier } from "./events-CaNwG-EX.js";
 //#region ../contracts/src/api-versions.d.ts
 /**
  * Billete API versions. Kept free of runtime dependencies: the dashboard, the API, the worker and
@@ -102,6 +102,8 @@ interface PublicPortal {
   subscriptions: CustomerSubscription[];
   /** The latest Cobros, newest first; open ones are paid on their page (`url`). */
   invoices: PublicInvoice[];
+  /** The customer's latest claims, newest first; each is followed on its page (`url`). */
+  claims: PublicClaimSummary[];
 }
 /** Where a payment stands, as a payment page shows it. */
 interface PublicPaymentState {
@@ -277,6 +279,8 @@ interface PublicFulfillment {
   } | null;
   canceledAt: Timestamp | null;
   cancellationReason: Fulfillment["cancellationReason"];
+  /** The latest claim about it, followed on its page (`url`); `null` without one. */
+  claim: PublicClaimSummary | null;
 }
 /**
  * The step a provider asks of the payer after starting a charge: leave for its page and come back
@@ -429,6 +433,59 @@ interface PublicPaymentLink {
   allowCoupons: boolean;
   submitLabel: SubmitLabel;
 }
+/** A claim as its customer sees it in a list: where it stands and the page to follow it. */
+interface PublicClaimSummary {
+  id: string;
+  /** The claim's page; the link carries the only credential. */
+  url: string;
+  paymentId: string;
+  reason: ClaimReason;
+  status: ClaimStatus;
+  createdAt: Timestamp;
+}
+/**
+ * A claim as its customer follows it, on the page their emails link to (`url`): the
+ * conversation with the business and how it ended. The link carries the only credential.
+ */
+interface PublicClaim extends PublicClaimSummary {
+  object: "claim";
+  environment: Environment;
+  merchant: {
+    name: string;
+    supportEmail: string | null;
+    supportPhone: string | null;
+  };
+  description: string;
+  messages: ClaimMessage[];
+  /** What the claim is about: the payment and what it bought. */
+  payment: {
+    amount: number;
+    currency: Currency;
+    paidAt: Timestamp;
+    items: Array<{
+      name: string;
+      quantity: number;
+    }>;
+  };
+  /**
+   * The delivery of the purchase, when it has one, and its page (`url`). A claim keeps a delivery
+   * not yet received in `problem`, with its funds held, until the customer confirms it there or
+   * the payment is refunded.
+   */
+  fulfillment: {
+    method: FulfillmentMethod;
+    status: FulfillmentStatus;
+    url: string;
+  } | null;
+  resolution: {
+    outcome: ClaimOutcome;
+    note: string;
+    refund: Pick<Refund, "amount" | "currency" | "status"> | null;
+    resolvedAt: Timestamp;
+  } | null;
+  withdrawnAt: Timestamp | null;
+  updatedAt: Timestamp;
+}
 //#endregion
 //#region ../contracts/src/inputs.d.ts
 /** Identifiers merchants choose and use in code: `ai_tokens`, `export-pdf`. */
@@ -833,7 +890,7 @@ interface RefundCreate {
   reason?: string;
 }
 /** An event type, or `*` for every event. */
-type EventSelector = "*" | EventType;
+type EventSelector = "*" | SubscribableEventType;
 interface WebhookEndpointCreate {
   url: string;
   events: EventSelector[];
@@ -916,6 +973,35 @@ interface FulfillmentTrackingInput {
 interface ClientFulfillmentProblem {
   comment: string;
 }
+/** Opens a claim about a payment, from the customer's page of it. */
+interface ClientClaimCreate {
+  reason: ClaimReason;
+  /** What went wrong, in the customer's words. */
+  description: string;
+}
+/** Opens a claim from the customer portal, about one of the customer's payments. */
+interface ClientCustomerClaimCreate extends ClientClaimCreate {
+  /** The payment's ID (`pay_…`), as each Cobro of the portal shows it. */
+  payment: string;
+}
+/** A message added to a claim's conversation. */
+interface ClaimRespond {
+  message: string;
+}
+/**
+ * Closes a claim. In the customer's favor it may refund the payment in the same step (`refund`:
+ * what is left of it, or `amount`), through the same refund as `POST /v1/payments/:payment/refunds`.
+ */
+type ClaimResolve = {
+  outcome: "customer";
+  note: string;
+  refund?: {
+    amount?: number;
+  };
+} | {
+  outcome: "business";
+  note: string;
+};
 //#endregion
 //#region src/http.d.ts
 interface TransportOptions {
@@ -951,7 +1037,7 @@ declare class BilleteError extends Error {
   readonly requestId?: string;
   constructor(body: Omit<ApiErrorBody, "type"> & {
     type: ApiErrorType | "network";
-  }, status: number);
+  }, status: number, options?: ErrorOptions);
 }
 //#endregion
-export { SubscriptionCancel as $, FeatureUpdate as A, apiVersionLifecycle as At, PlanCreate as B, CustomerMemberUpdate as C, API_VERSION_HEADER as Ct, FeatureCreate as D, ApiVersionStage as Dt, EventSelector as E, ApiVersionLifecycle as Et, KEY_PATTERN as F, supportedApiVersions as Ft, PortalSessionCreate as G, PlanLinkCreate as H, PaymentLinkCreate as I, ProductCreate as J, ProductCheckoutCreate as K, PaymentLinkUpdate as L, FulfillmentTrackingInput as M, currentApiVersion as Mt, InvoiceCreate as N, isApiVersion as Nt, FeatureOperationCommit as O, LATEST_API_VERSION as Ot, InvoiceLineInput as P, isApiVersionRetired as Pt, RetireInput as Q, PlanCheckoutCreate as R, CustomerMemberCreate as S, API_VERSIONS as St, CustomerUpdate as T, ApiVersion as Tt, PlanPriceInput as U, PlanFeaturesInput as V, PlanUpdate as W, ProductUpdate as X, ProductLinkCreate as Y, RefundCreate as Z, CouponCreate as _, PublicFulfillment as _t, CheckoutCreate as a, WebhookEndpointCreate as at, CustomerCreate as b, PublicPaymentState as bt, ClientCheckoutUpdate as c, CustomerSubscriptionChangeResult as ct, ClientLinkCheckout as d, PaymentMethodField as dt, SubscriptionChangeCreate as et, ClientPaymentCode as f, PaymentMethodOption as ft, CollectInput as g, PublicCheckout as gt, ClientSubscriptionUpdate as h, PortalFeatures as ht, AfterCompletionInput as i, VariantInput as it, FulfillmentInput as j, apiVersionStage as jt, FeatureOperationCreate as k, LatestApiVersion as kt, ClientFulfillmentProblem as l, FulfillmentOption as lt, ClientSubscriptionSeats as m, PaymentTestScenario as mt, RequestOptions as n, SubscriptionCreate as nt, CheckoutItemInput as o, WebhookEndpointUpdate as ot, ClientSubscriptionCancel as p, PaymentNextAction as pt, ProductCouponCreate as q, TransportOptions as r, SubscriptionUpdate as rt, ClientCheckoutPay as s, CustomerSubscription as st, BilleteError as t, SubscriptionChangePreviewInput as tt, ClientInvoicePay as u, PaymentInstructions as ut, CouponUpdate as v, PublicInvoice as vt, CustomerSessionCreate as w, API_VERSION_PATTERN as wt, CustomerInput as x, PublicPortal as xt, CustomFieldInput as y, PublicPaymentLink as yt, PlanCouponCreate as z };
+export { ProductLinkCreate as $, EventSelector as A, API_VERSION_PATTERN as At, PaymentLinkCreate as B, isApiVersionRetired as Bt, CustomFieldInput as C, PublicFulfillment as Ct, CustomerMemberUpdate as D, PublicPortal as Dt, CustomerMemberCreate as E, PublicPaymentState as Et, FulfillmentInput as F, LatestApiVersion as Ft, PlanFeaturesInput as G, PlanCheckoutCreate as H, FulfillmentTrackingInput as I, apiVersionLifecycle as It, PlanUpdate as J, PlanLinkCreate as K, InvoiceCreate as L, apiVersionStage as Lt, FeatureOperationCommit as M, ApiVersionLifecycle as Mt, FeatureOperationCreate as N, ApiVersionStage as Nt, CustomerSessionCreate as O, API_VERSIONS as Ot, FeatureUpdate as P, LATEST_API_VERSION as Pt, ProductCreate as Q, InvoiceLineInput as R, currentApiVersion as Rt, CouponUpdate as S, PublicClaimSummary as St, CustomerInput as T, PublicPaymentLink as Tt, PlanCouponCreate as U, PaymentLinkUpdate as V, supportedApiVersions as Vt, PlanCreate as W, ProductCheckoutCreate as X, PortalSessionCreate as Y, ProductCouponCreate as Z, ClientSubscriptionCancel as _, PaymentNextAction as _t, CheckoutCreate as a, SubscriptionChangePreviewInput as at, CollectInput as b, PublicCheckout as bt, ClaimRespond as c, VariantInput as ct, ClientClaimCreate as d, CustomerSubscription as dt, ProductUpdate as et, ClientCustomerClaimCreate as f, CustomerSubscriptionChangeResult as ft, ClientPaymentCode as g, PaymentMethodOption as gt, ClientLinkCheckout as h, PaymentMethodField as ht, AfterCompletionInput as i, SubscriptionChangeCreate as it, FeatureCreate as j, ApiVersion as jt, CustomerUpdate as k, API_VERSION_HEADER as kt, ClientCheckoutPay as l, WebhookEndpointCreate as lt, ClientInvoicePay as m, PaymentInstructions as mt, RequestOptions as n, RetireInput as nt, CheckoutItemInput as o, SubscriptionCreate as ot, ClientFulfillmentProblem as p, FulfillmentOption as pt, PlanPriceInput as q, TransportOptions as r, SubscriptionCancel as rt, ClaimResolve as s, SubscriptionUpdate as st, BilleteError as t, RefundCreate as tt, ClientCheckoutUpdate as u, WebhookEndpointUpdate as ut, ClientSubscriptionSeats as v, PaymentTestScenario as vt, CustomerCreate as w, PublicInvoice as wt, CouponCreate as x, PublicClaim as xt, ClientSubscriptionUpdate as y, PortalFeatures as yt, KEY_PATTERN as z, isApiVersion as zt };

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

@@ -938,12 +938,24 @@ interface PaymentAttempt {
 }
 declare const PAYMENT_STATUSES: readonly ["pending", "failed", "succeeded", "refunded", "partially_refunded"];
 type PaymentStatus = (typeof PAYMENT_STATUSES)[number];
-/** How the money actually moved: the charged currency, conversion, Billete fee and merchant net. */
+/** What makes up a settled payment's fee, in its settlement currency: `platform + method = fee`. */
+interface PaymentFeeDetails {
+  /** Billete's fee. */
+  platform: number;
+  /** The payment method's fee (a percentage and a fixed part); `0` for payments before it existed. */
+  method: number;
+}
+/**
+ * How the money actually moved: the charged currency, conversion, the fees the business pays
+ * (`fee`, Billete's and the payment method's together) and its net (`amount - fee`).
+ */
 interface PaymentSettlement {
   amount: number;
   currency: Currency;
   exchangeRate: string | null;
   fee: number;
+  /** `fee` split into Billete's and the payment method's. */
+  feeDetails?: PaymentFeeDetails;
   net: number;
 }
 interface Payment extends Resource<"payment"> {
@@ -987,6 +999,58 @@ interface Refund extends Resource<"refund"> {
   mode: "provider" | "manual";
   status: "pending" | "succeeded" | "failed";
 }
+/**
+ * Why a customer opened a claim. `not_received`: they paid and nothing arrived. `overcharged`:
+ * they were charged more than agreed. `unrecognized`: they do not recognize the payment.
+ * `order_issue`: the purchase came damaged, incomplete or is not what they ordered. `other`.
+ */
+declare const CLAIM_REASONS: readonly ["not_received", "overcharged", "unrecognized", "order_issue", "other"];
+type ClaimReason = (typeof CLAIM_REASONS)[number];
+/**
+ * - `open`: the customer opened it; the business has not answered yet.
+ * - `under_review`: the business answered and is working on it.
+ * - `resolved`: the business closed it, in the customer's favor or in its own (`resolution`).
+ * - `withdrawn`: the customer withdrew it, or confirmed receiving the purchase it was about.
+ */
+declare const CLAIM_STATUSES: readonly ["open", "under_review", "resolved", "withdrawn"];
+type ClaimStatus = (typeof CLAIM_STATUSES)[number];
+/** In whose favor a claim was resolved. */
+declare const CLAIM_OUTCOMES: readonly ["customer", "business"];
+type ClaimOutcome = (typeof CLAIM_OUTCOMES)[number];
+/** One message of a claim's conversation between the customer and the business. */
+interface ClaimMessage {
+  id: string;
+  author: "customer" | "business";
+  body: string;
+  createdAt: Timestamp;
+}
+/**
+ * A customer's claim about a payment ("reclamo"): what went wrong, the conversation with the
+ * business and how it ended. Opening one never moves money; resolving it in the customer's favor
+ * may refund the payment (`resolution.refundId`).
+ */
+interface Claim extends Resource<"claim"> {
+  paymentId: string;
+  /** The delivery it is about, when the payment's purchase has one. */
+  fulfillmentId: string | null;
+  customerId: string;
+  reason: ClaimReason;
+  /** What the customer said when opening it. */
+  description: string;
+  status: ClaimStatus;
+  /** What the customer and the business wrote after opening it, oldest first. */
+  messages: ClaimMessage[];
+  resolution: {
+    outcome: ClaimOutcome;
+    /** What the business told the customer. */
+    note: string;
+    /** The refund issued when resolving it in the customer's favor. */
+    refundId: string | null;
+    resolvedAt: Timestamp;
+  } | null;
+  withdrawnAt: Timestamp | null;
+  updatedAt: Timestamp;
+}
 interface BalanceAmount {
   amount: number;
   currency: Currency;
@@ -1018,7 +1082,7 @@ interface WebhookEndpoint extends Resource<"webhook_endpoint"> {
    */
   apiVersion: string;
   enabled: boolean;
-  /** Returned only when the endpoint is created. */
+  /** Returned only when the endpoint is created or its secret is rolled. */
   secret?: string;
 }
 interface Event<TData = Record<string, unknown>> extends Resource<"event"> {
@@ -1090,6 +1154,14 @@ interface EventDataMap {
   "fulfillment.problem_reported": Fulfillment;
   /** Its payment was fully refunded, or it was not shipped in time. */
   "fulfillment.canceled": Fulfillment;
+  /** A customer opened a claim about a payment. Opening it moves no money. */
+  "claim.created": Claim;
+  /** A new message in its conversation, or the business started reviewing it. */
+  "claim.updated": Claim;
+  /** The business resolved it (`resolution`): in the customer's favor, maybe with a refund, or its own. */
+  "claim.resolved": Claim;
+  /** The customer withdrew it, or confirmed receiving the purchase it was about. */
+  "claim.withdrawn": Claim;
   "refund.created": Refund;
   /** The provider could not return the funds; the amount is back in the balance. */
   "refund.failed": Refund;
@@ -1108,9 +1180,18 @@ interface EventDataMap {
   "subscription.canceled": Subscription;
   /** Grace period over without payment; access is revoked. */
   "subscription.expired": Subscription;
+  /**
+   * Sent on request to a single endpoint, to check that it receives and verifies deliveries.
+   * Nothing happened in the business; it never reaches other endpoints and is not subscribable.
+   */
+  "webhook_endpoint.test": WebhookEndpoint;
 }
 type EventType = keyof EventDataMap;
-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"];
+/** The event a business sends itself to try an endpoint. */
+declare const WEBHOOK_TEST_EVENT: "webhook_endpoint.test";
+/** What a webhook endpoint can subscribe to: everything that happens in a business. */
+type SubscribableEventType = Exclude<EventType, typeof WEBHOOK_TEST_EVENT>;
+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", "claim.created", "claim.updated", "claim.resolved", "claim.withdrawn", "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;
@@ -1123,4 +1204,4 @@ type WebhookEvent = { [TType in EventType]: {
   data: EventDataMap[TType];
 }; }[EventType];
 //#endregion
-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 };
+export { FulfillmentStatus as $, ACCOUNT_NUMBER_LENGTH as $t, Coupon as A, Retirement as At, ExchangeRate as B, SubscriptionStatus as Bt, CheckoutPurpose as C, nationalPhone as Cn, Product as Ct, ClaimReason as D, tokenEnvironment as Dn, RISK_LEVELS as Dt, ClaimOutcome as E, TokenKind as En, RESET_FREQUENCIES as Et, CustomerFeature as F, Subscription as Ft, FeatureOperation as G, ReceiptReference as Gt, FULFILLMENT_METHODS as H, USAGE_FEATURE_TYPES as Ht, CustomerMember as I, SubscriptionChange as It, FeatureType as J, ApiErrorBody as Jt, FeatureOperationResult as K, ReceiptSend as Kt, CustomerMemberList as L, SubscriptionChangePreview as Lt, CustomField as M, SUBMIT_LABELS as Mt, Customer as N, SUBSCRIPTION_STATUSES as Nt, ClaimStatus as O, tokenPrefix as On, Refund as Ot, CustomerDetails as P, SubmitLabel as Pt, FulfillmentMethod as Q, PaymentFailureCode as Qt, CustomerSession as R, SubscriptionChangeResult as Rt, CheckoutItem as S, isMobilePhone as Sn, PortalSession as St, ClaimMessage as T, Environment as Tn, ProductVariant as Tt, FULFILLMENT_STATUSES as U, WebhookEndpoint as Ut, FEATURE_TYPES as V, SubscriptionTerms as Vt, Feature as W, Weekday as Wt, Fulfillment as X, ApiErrorType as Xt, FeatureUsageResult as Y, ApiErrorEnvelope as Yt, FulfillmentChoice as Z, PAYMENT_FAILURE_CODES as Zt, CLAIM_STATUSES as _, TaxBehavior as _n, Payout as _t, WEBHOOK_TEST_EVENT as a, CURRENCIES as an, InvoiceStatus as at, CarrierOffice as b, findBank as bn, PlanPrice as bt, AfterCompletion as c, GracePeriodDays as cn, PAYMENT_STATUSES as ct, CANCELLATION_FEEDBACK as d, ListSort as dn, PaymentAttempt as dt, Address as en, FulfillmentTracking as et, CARRIERS as f, MAX_QUANTITY as fn, PaymentFailure as ft, CLAIM_REASONS as g, TAX_BEHAVIORS as gn, PaymentStatus as gt, CLAIM_OUTCOMES as h, MobilePrefix as hn, PaymentSettlement as ht, SubscribableEventType as i, BillingMonths as in, InvoiceReason as it, CurrencyAvailability as j, RiskLevel as jt, CollectSettings as k, ResetFrequency as kt, Balance as l, List as ln, PRODUCT_CATEGORIES as lt, CHECKOUT_PURPOSES as m, Metadata as mn, PaymentLink as mt, EventDataMap as n, BILLING_MONTHS as nn, INVOICE_STATUSES as nt, WebhookEvent as o, Currency as on, LineItem as ot, CARRIER_TEST_SCENARIOS as p, MOBILE_PREFIXES as pn, PaymentFeeDetails as pt, FeatureReset as q, API_ERROR_TYPES as qt, EventType as r, BankCode as rn, Invoice as rt, Actor as s, GRACE_PERIOD_DAYS as sn, MAX_SEATS as st, EVENT_TYPES as t, AddressInput as tn, INVOICE_REASONS as tt, BalanceAmount as u, ListQuery as un, Payment as ut, CancellationFeedback as v, Timestamp as vn, Plan as vt, Claim as w, ENVIRONMENTS as wn, ProductCategory as wt, Checkout as x, isLandlinePhone as xn, PlanSeats as xt, Carrier as y, VENEZUELAN_BANKS as yn, PlanFeatureValues as yt, Event as z, SubscriptionRenewal as zt };

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

@@ -6,8 +6,8 @@ var BilleteError = class extends Error {
 	status;
 	param;
 	requestId;
-	constructor(body, status) {
-		super(body.message);
+	constructor(body, status, options) {
+		super(body.message, options);
 		this.name = "BilleteError";
 		this.type = body.type;
 		this.code = body.code;
@@ -18,7 +18,7 @@ var BilleteError = class extends Error {
 };
 //#endregion
 //#region src/http.ts
-const SDK_VERSION = "4.1.0";
+const SDK_VERSION = "4.3.0";
 const DEFAULT_BASE_URL = "https://api.billete.run";
 const RETRYABLE_STATUS = /* @__PURE__ */ new Set([
 	429,
@@ -91,7 +91,7 @@ function createTransport(options) {
 			type: "network",
 			code: "network_error",
 			message: `Could not reach Billete: ${response.message}`
-		}, 0);
+		}, 0, { cause: response });
 		if (!response.ok) throw await toError(response);
 		return response.status === 204 ? void 0 : await response.json();
 	}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as SubscriptionCancel, A as FeatureUpdate, At as apiVersionLifecycle, B as PlanCreate, C as CustomerMemberUpdate, Ct as API_VERSION_HEADER, D as FeatureCreate, Dt as ApiVersionStage, E as EventSelector, Et as ApiVersionLifecycle, F as KEY_PATTERN, Ft as supportedApiVersions, G as PortalSessionCreate, H as PlanLinkCreate, I as PaymentLinkCreate, J as ProductCreate, K as ProductCheckoutCreate, L as PaymentLinkUpdate, M as FulfillmentTrackingInput, Mt as currentApiVersion, N as InvoiceCreate, Nt as isApiVersion, O as FeatureOperationCommit, Ot as LATEST_API_VERSION, P as InvoiceLineInput, Pt as isApiVersionRetired, Q as RetireInput, R as PlanCheckoutCreate, S as CustomerMemberCreate, St as API_VERSIONS, T as CustomerUpdate, Tt as ApiVersion, U as PlanPriceInput, V as PlanFeaturesInput, W as PlanUpdate, X as ProductUpdate, Y as ProductLinkCreate, Z as RefundCreate, _ as CouponCreate, _t as PublicFulfillment, a as CheckoutCreate, at as WebhookEndpointCreate, b as CustomerCreate, bt as PublicPaymentState, c as ClientCheckoutUpdate, ct as CustomerSubscriptionChangeResult, d as ClientLinkCheckout, dt as PaymentMethodField, et as SubscriptionChangeCreate, f as ClientPaymentCode, ft as PaymentMethodOption, g as CollectInput, gt as PublicCheckout, h as ClientSubscriptionUpdate, ht as PortalFeatures, i as AfterCompletionInput, it as VariantInput, j as FulfillmentInput, jt as apiVersionStage, k as FeatureOperationCreate, kt as LatestApiVersion, l as ClientFulfillmentProblem, lt as FulfillmentOption, m as ClientSubscriptionSeats, mt as PaymentTestScenario, n as RequestOptions, nt as SubscriptionCreate, o as CheckoutItemInput, ot as WebhookEndpointUpdate, p as ClientSubscriptionCancel, pt as PaymentNextAction, q as ProductCouponCreate, r as TransportOptions, rt as SubscriptionUpdate, s as ClientCheckoutPay, st as CustomerSubscription, t as BilleteError, tt as SubscriptionChangePreviewInput, u as ClientInvoicePay, ut as PaymentInstructions, v as CouponUpdate, vt as PublicInvoice, w as CustomerSessionCreate, wt as API_VERSION_PATTERN, x as CustomerInput, xt as PublicPortal, y as CustomFieldInput, yt as PublicPaymentLink, z as PlanCouponCreate } from "./errors-AObvDES-.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-C0pKiZ_h.js";
+import { $ as ProductLinkCreate, A as EventSelector, At as API_VERSION_PATTERN, B as PaymentLinkCreate, Bt as isApiVersionRetired, C as CustomFieldInput, Ct as PublicFulfillment, D as CustomerMemberUpdate, Dt as PublicPortal, E as CustomerMemberCreate, Et as PublicPaymentState, F as FulfillmentInput, Ft as LatestApiVersion, G as PlanFeaturesInput, H as PlanCheckoutCreate, I as FulfillmentTrackingInput, It as apiVersionLifecycle, J as PlanUpdate, K as PlanLinkCreate, L as InvoiceCreate, Lt as apiVersionStage, M as FeatureOperationCommit, Mt as ApiVersionLifecycle, N as FeatureOperationCreate, Nt as ApiVersionStage, O as CustomerSessionCreate, Ot as API_VERSIONS, P as FeatureUpdate, Pt as LATEST_API_VERSION, Q as ProductCreate, R as InvoiceLineInput, Rt as currentApiVersion, S as CouponUpdate, St as PublicClaimSummary, T as CustomerInput, Tt as PublicPaymentLink, U as PlanCouponCreate, V as PaymentLinkUpdate, Vt as supportedApiVersions, W as PlanCreate, X as ProductCheckoutCreate, Y as PortalSessionCreate, Z as ProductCouponCreate, _ as ClientSubscriptionCancel, _t as PaymentNextAction, a as CheckoutCreate, at as SubscriptionChangePreviewInput, b as CollectInput, bt as PublicCheckout, c as ClaimRespond, ct as VariantInput, d as ClientClaimCreate, dt as CustomerSubscription, et as ProductUpdate, f as ClientCustomerClaimCreate, ft as CustomerSubscriptionChangeResult, g as ClientPaymentCode, gt as PaymentMethodOption, h as ClientLinkCheckout, ht as PaymentMethodField, i as AfterCompletionInput, it as SubscriptionChangeCreate, j as FeatureCreate, jt as ApiVersion, k as CustomerUpdate, kt as API_VERSION_HEADER, l as ClientCheckoutPay, lt as WebhookEndpointCreate, m as ClientInvoicePay, mt as PaymentInstructions, n as RequestOptions, nt as RetireInput, o as CheckoutItemInput, ot as SubscriptionCreate, p as ClientFulfillmentProblem, pt as FulfillmentOption, q as PlanPriceInput, r as TransportOptions, rt as SubscriptionCancel, s as ClaimResolve, st as SubscriptionUpdate, t as BilleteError, tt as RefundCreate, u as ClientCheckoutUpdate, ut as WebhookEndpointUpdate, v as ClientSubscriptionSeats, vt as PaymentTestScenario, w as CustomerCreate, wt as PublicInvoice, x as CouponCreate, xt as PublicClaim, y as ClientSubscriptionUpdate, yt as PortalFeatures, z as KEY_PATTERN, zt as isApiVersion } from "./errors-DCiynKkL.js";
+import { $ as FulfillmentStatus, $t as ACCOUNT_NUMBER_LENGTH, A as Coupon, At as Retirement, B as ExchangeRate, Bt as SubscriptionStatus, C as CheckoutPurpose, Cn as nationalPhone, Ct as Product, D as ClaimReason, Dn as tokenEnvironment, Dt as RISK_LEVELS, E as ClaimOutcome, En as TokenKind, Et as RESET_FREQUENCIES, F as CustomerFeature, Ft as Subscription, G as FeatureOperation, Gt as ReceiptReference, H as FULFILLMENT_METHODS, Ht as USAGE_FEATURE_TYPES, I as CustomerMember, It as SubscriptionChange, J as FeatureType, Jt as ApiErrorBody, K as FeatureOperationResult, Kt as ReceiptSend, L as CustomerMemberList, Lt as SubscriptionChangePreview, M as CustomField, Mt as SUBMIT_LABELS, N as Customer, Nt as SUBSCRIPTION_STATUSES, O as ClaimStatus, On as tokenPrefix, Ot as Refund, P as CustomerDetails, Pt as SubmitLabel, Q as FulfillmentMethod, Qt as PaymentFailureCode, R as CustomerSession, Rt as SubscriptionChangeResult, S as CheckoutItem, Sn as isMobilePhone, St as PortalSession, T as ClaimMessage, Tn as Environment, Tt as ProductVariant, U as FULFILLMENT_STATUSES, Ut as WebhookEndpoint, V as FEATURE_TYPES, Vt as SubscriptionTerms, W as Feature, Wt as Weekday, X as Fulfillment, Xt as ApiErrorType, Y as FeatureUsageResult, Yt as ApiErrorEnvelope, Z as FulfillmentChoice, Zt as PAYMENT_FAILURE_CODES, _ as CLAIM_STATUSES, _n as TaxBehavior, _t as Payout, a as WEBHOOK_TEST_EVENT, an as CURRENCIES, at as InvoiceStatus, b as CarrierOffice, bn as findBank, bt as PlanPrice, c as AfterCompletion, cn as GracePeriodDays, ct as PAYMENT_STATUSES, d as CANCELLATION_FEEDBACK, dn as ListSort, dt as PaymentAttempt, en as Address, et as FulfillmentTracking, f as CARRIERS, fn as MAX_QUANTITY, ft as PaymentFailure, g as CLAIM_REASONS, gn as TAX_BEHAVIORS, gt as PaymentStatus, h as CLAIM_OUTCOMES, hn as MobilePrefix, ht as PaymentSettlement, i as SubscribableEventType, in as BillingMonths, it as InvoiceReason, j as CurrencyAvailability, jt as RiskLevel, k as CollectSettings, kt as ResetFrequency, l as Balance, ln as List, lt as PRODUCT_CATEGORIES, m as CHECKOUT_PURPOSES, mn as Metadata, mt as PaymentLink, n as EventDataMap, nn as BILLING_MONTHS, nt as INVOICE_STATUSES, o as WebhookEvent, on as Currency, ot as LineItem, p as CARRIER_TEST_SCENARIOS, pn as MOBILE_PREFIXES, pt as PaymentFeeDetails, q as FeatureReset, qt as API_ERROR_TYPES, r as EventType, rn as BankCode, rt as Invoice, s as Actor, sn as GRACE_PERIOD_DAYS, st as MAX_SEATS, t as EVENT_TYPES, tn as AddressInput, tt as INVOICE_REASONS, u as BalanceAmount, un as ListQuery, ut as Payment, v as CancellationFeedback, vn as Timestamp, vt as Plan, w as Claim, wn as ENVIRONMENTS, wt as ProductCategory, x as Checkout, xn as isLandlinePhone, xt as PlanSeats, y as Carrier, yn as VENEZUELAN_BANKS, yt as PlanFeatureValues, z as Event, zt as SubscriptionRenewal } from "./events-CaNwG-EX.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region src/server.d.ts
 type Filters<T> = ListQuery & T;
@@ -274,6 +274,34 @@ export declare function createBillete(options: BilleteOptions): {
     /** You handed it over: the customer has 48 hours to confirm it or report a problem. */
     deliver: (id: string, options?: RequestOptions) => Promise<Fulfillment>;
   };
+  claims: {
+    retrieve: (id: string, options?: RequestOptions) => Promise<Claim>;
+    list: (query?: Filters<{
+      status?: ClaimStatus;
+      /** A payment's claims (`pay_…`). */
+      payment?: string;
+      customer?: string;
+      /** `search`: part of the claim's or the payment's ID, or of the customer's name or email. */
+      search?: string;
+      sort?: ListSort<"created">;
+    }>, options?: RequestOptions) => Promise<List<Claim>>;
+    iterate: (query?: Filters<{
+      status?: ClaimStatus;
+      /** A payment's claims (`pay_…`). */
+      payment?: string;
+      customer?: string;
+      /** `search`: part of the claim's or the payment's ID, or of the customer's name or email. */
+      search?: string;
+      sort?: ListSort<"created">;
+    }>) => AsyncGenerator<Claim, any, any>;
+    /** Answers the customer, who gets it by email; the first answer puts it `under_review`. */
+    respond: (id: string, input: ClaimRespond, options?: RequestOptions) => Promise<Claim>;
+    /**
+     * Closes it with your decision. In the customer's favor, `refund` refunds the payment in the
+     * same step (what is left of it, or `amount`).
+     */
+    resolve: (id: string, input: ClaimResolve, options?: RequestOptions) => Promise<Claim>;
+  };
   balance: {
     retrieve: (options?: RequestOptions) => Promise<Balance>;
   };
@@ -322,4 +350,4 @@ export declare function createBillete(options: BilleteOptions): {
 /** The server client: what `createBillete` returns. */
 type Billete = ReturnType<typeof createBillete>;
 //#endregion
-export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type Billete, BilleteError, type BilleteOptions, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type 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 };
+export { type ACCOUNT_NUMBER_LENGTH, type API_ERROR_TYPES, type API_VERSIONS, type API_VERSION_HEADER, type API_VERSION_PATTERN, type Actor, type Address, type AddressInput, type AfterCompletion, type AfterCompletionInput, type ApiErrorBody, type ApiErrorEnvelope, type ApiErrorType, type ApiVersion, type ApiVersionLifecycle, type ApiVersionStage, type BILLING_MONTHS, type Balance, type BalanceAmount, type BankCode, type Billete, BilleteError, type BilleteOptions, type BillingMonths, type CANCELLATION_FEEDBACK, type CARRIERS, type CARRIER_TEST_SCENARIOS, type CHECKOUT_PURPOSES, type CLAIM_OUTCOMES, type CLAIM_REASONS, type CLAIM_STATUSES, type CURRENCIES, type CancellationFeedback, type Carrier, type CarrierOffice, type Checkout, type CheckoutCreate, type CheckoutItem, type CheckoutItemInput, type CheckoutPurpose, type Claim, type ClaimMessage, type ClaimOutcome, type ClaimReason, type ClaimResolve, type ClaimRespond, type ClaimStatus, type ClientCheckoutPay, type ClientCheckoutUpdate, type ClientClaimCreate, type ClientCustomerClaimCreate, type ClientFulfillmentProblem, type ClientInvoicePay, type ClientLinkCheckout, type ClientPaymentCode, type ClientSubscriptionCancel, type ClientSubscriptionSeats, type ClientSubscriptionUpdate, type CollectInput, type CollectSettings, type Coupon, type CouponCreate, type CouponUpdate, type Currency, type CurrencyAvailability, type CustomField, type CustomFieldInput, type Customer, type CustomerCreate, type CustomerDetails, type CustomerFeature, type CustomerInput, type CustomerMember, type CustomerMemberCreate, type CustomerMemberList, type CustomerMemberUpdate, type CustomerSession, type CustomerSessionCreate, type CustomerSubscription, type CustomerSubscriptionChangeResult, type CustomerUpdate, type ENVIRONMENTS, type EVENT_TYPES, type Environment, type Event, type EventDataMap, type EventSelector, type EventType, type ExchangeRate, type FEATURE_TYPES, type FULFILLMENT_METHODS, type FULFILLMENT_STATUSES, type Feature, type FeatureCreate, type FeatureOperation, type FeatureOperationCommit, type FeatureOperationCreate, type FeatureOperationResult, type FeatureReset, type FeatureType, type FeatureUpdate, type FeatureUsageResult, type Fulfillment, type FulfillmentChoice, type FulfillmentInput, type FulfillmentMethod, type FulfillmentOption, type FulfillmentStatus, type FulfillmentTracking, type FulfillmentTrackingInput, type GRACE_PERIOD_DAYS, type GracePeriodDays, type INVOICE_REASONS, type INVOICE_STATUSES, type Invoice, type InvoiceCreate, type InvoiceLineInput, type InvoiceReason, type InvoiceStatus, type KEY_PATTERN, type LATEST_API_VERSION, type LatestApiVersion, type LineItem, type List, type ListQuery, type ListSort, type MAX_QUANTITY, type MAX_SEATS, type MOBILE_PREFIXES, type Metadata, type MobilePrefix, type PAYMENT_FAILURE_CODES, type PAYMENT_STATUSES, type PRODUCT_CATEGORIES, type Payment, type PaymentAttempt, type PaymentFailure, type PaymentFailureCode, type PaymentFeeDetails, type PaymentInstructions, type PaymentLink, type PaymentLinkCreate, type PaymentLinkUpdate, type PaymentMethodField, type PaymentMethodOption, type PaymentNextAction, type PaymentSettlement, type PaymentStatus, type PaymentTestScenario, type Payout, type Plan, type PlanCheckoutCreate, type PlanCouponCreate, type PlanCreate, type PlanFeatureValues, type PlanFeaturesInput, type PlanLinkCreate, type PlanPrice, type PlanPriceInput, type PlanSeats, type PlanUpdate, type PortalFeatures, type PortalSession, type PortalSessionCreate, type Product, type ProductCategory, type ProductCheckoutCreate, type ProductCouponCreate, type ProductCreate, type ProductLinkCreate, type ProductUpdate, type ProductVariant, type PublicCheckout, type PublicClaim, type PublicClaimSummary, type PublicFulfillment, type PublicInvoice, type PublicPaymentLink, type PublicPaymentState, type PublicPortal, type RESET_FREQUENCIES, type RISK_LEVELS, type ReceiptReference, type ReceiptSend, type Refund, type RefundCreate, type RequestOptions, type ResetFrequency, type RetireInput, type Retirement, type RiskLevel, type SUBMIT_LABELS, type SUBSCRIPTION_STATUSES, type SubmitLabel, type SubscribableEventType, type Subscription, type SubscriptionCancel, type SubscriptionChange, type SubscriptionChangeCreate, type SubscriptionChangePreview, type SubscriptionChangePreviewInput, type SubscriptionChangeResult, type SubscriptionCreate, type SubscriptionRenewal, type SubscriptionStatus, type SubscriptionTerms, type SubscriptionUpdate, type TAX_BEHAVIORS, type TaxBehavior, type Timestamp, type TokenKind, type TransportOptions, type USAGE_FEATURE_TYPES, type VENEZUELAN_BANKS, type VariantInput, type WEBHOOK_TEST_EVENT, type WebhookEndpoint, type WebhookEndpointCreate, type WebhookEndpointUpdate, type WebhookEvent, WebhookVerificationError, type Weekday, type apiVersionLifecycle, type apiVersionStage, type currentApiVersion, type findBank, type isApiVersion, type isApiVersionRetired, type isLandlinePhone, type isMobilePhone, type nationalPhone, type supportedApiVersions, type tokenEnvironment, type tokenPrefix, verifyWebhook };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as segment, r as BilleteError, t as createTransport } from "./http-D1e4okoX.js";
+import { n as segment, r as BilleteError, t as createTransport } from "./http-BfxFFQqw.js";
 import { WebhookVerificationError, verifyWebhook } from "./webhooks.js";
 //#region ../contracts/src/environment.ts
 /**
@@ -365,6 +365,30 @@ create: (input, options) => http.request({
 			options
 		})
 	};
+	const claimCrud = collection(http, "/v1/claims");
+	/** Your customers' claims about their payments: the conversation and how each one ends. */
+	const claims = {
+		retrieve: claimCrud.retrieve,
+		list: claimCrud.list,
+		iterate: claimCrud.iterate,
+		/** Answers the customer, who gets it by email; the first answer puts it `under_review`. */
+		respond: (id, input, options) => http.request({
+			method: "POST",
+			path: `/v1/claims/${segment(id)}/respond`,
+			body: input,
+			options
+		}),
+		/**
+		* Closes it with your decision. In the customer's favor, `refund` refunds the payment in the
+		* same step (what is left of it, or `amount`).
+		*/
+		resolve: (id, input, options) => http.request({
+			method: "POST",
+			path: `/v1/claims/${segment(id)}/resolve`,
+			body: input,
+			options
+		})
+	};
 	const balance = { retrieve: (options) => http.request({
 		method: "GET",
 		path: "/v1/balance",
@@ -400,6 +424,7 @@ create: (input, options) => http.request({
 		subscriptions,
 		payments,
 		fulfillments,
+		claims,
 		balance,
 		payouts,
 		webhookEndpoints,

package/dist/webhooks.d.ts

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

package/package.json

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