@fonderie/client 0.11.0 → 0.13.0

package/dist/index.d.cts

@@ -197,6 +197,67 @@ interface IUsageResult {
     total: number;
     since: string;
 }
+interface IWalletDTO {
+    balance: string;
+    currency: string;
+    precision: number;
+    granted?: string;
+    purchased?: string;
+    spendPurchased?: boolean;
+    grantedExpiresAt?: string | null;
+}
+interface IWalletResult {
+    wallet: IWalletDTO;
+}
+interface IWalletTransactionDTO {
+    id: string;
+    type: string;
+    amount: string;
+    balanceAfter: string;
+    currency: string;
+    description: string | null;
+    providerTxId: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+interface IWalletTransactionsResult {
+    transactions: IWalletTransactionDTO[];
+    nextCursor: string | null;
+}
+interface IWalletCheckoutInput {
+    packId: string;
+}
+interface ICancelSubscriptionInput {
+    atPeriodEnd?: boolean;
+}
+interface ISubscriptionChangeResult {
+    atPeriodEnd: boolean;
+    status: string;
+    currentPeriodEnd: string | null;
+}
+interface IPaymentMethodDTO {
+    brand: string;
+    last4: string;
+    expMonth: number;
+    expYear: number;
+}
+interface IPaymentMethodResult {
+    paymentMethod: IPaymentMethodDTO | null;
+}
+interface IInvoiceDTO {
+    id: string;
+    number: string | null;
+    amountDue: string;
+    amountPaid: string;
+    currency: string;
+    status: string;
+    created: string;
+    hostedInvoiceUrl: string | null;
+    invoicePdf: string | null;
+}
+interface IInvoicesResult {
+    invoices: IInvoiceDTO[];
+}
 interface IWorkspaceAddressDTO {
     line1: string;
     line2: string;
@@ -641,6 +702,9 @@ interface IRecordUsageInput {
     metric: string;
     quantity?: number;
 }
+interface IWalletPreferencesInput {
+    spendPurchased: boolean;
+}
 interface ICreatePlanInput {
     name: string;
     description?: string | null;
@@ -668,10 +732,21 @@ declare class BillingClient {
     updatePlan(planId: string, input: IUpdatePlanInput): Promise<IApiResponse<IPlanResult>>;
     deletePlan(planId: string): Promise<IApiResponse<undefined>>;
     getSubscription(opts?: IReadOptions): Promise<IApiResponse<ISubscriptionResult>>;
+    cancelSubscription(input?: ICancelSubscriptionInput): Promise<IApiResponse<ISubscriptionChangeResult>>;
+    reactivateSubscription(): Promise<IApiResponse<ISubscriptionChangeResult>>;
     createCheckoutSession(input: ICheckoutInput): Promise<IApiResponse<ICheckoutUrlResult>>;
     createPortalSession(): Promise<IApiResponse<IPortalUrlResult>>;
     recordUsage(input: IRecordUsageInput): Promise<IApiResponse<undefined>>;
     getUsage(metric: string, opts?: IReadOptions): Promise<IApiResponse<IUsageResult>>;
+    getWallet(opts?: IReadOptions): Promise<IApiResponse<IWalletResult>>;
+    setWalletPreferences(input: IWalletPreferencesInput): Promise<IApiResponse<IWalletResult>>;
+    createWalletCheckout(input: IWalletCheckoutInput): Promise<IApiResponse<ICheckoutUrlResult>>;
+    getWalletTransactions(opts?: IReadOptions & {
+        cursor?: string;
+        limit?: number;
+    }): Promise<IApiResponse<IWalletTransactionsResult>>;
+    getPaymentMethod(opts?: IReadOptions): Promise<IApiResponse<IPaymentMethodResult>>;
+    listInvoices(opts?: IReadOptions): Promise<IApiResponse<IInvoicesResult>>;
 }
 
 interface IListCustomersInput {
@@ -1006,4 +1081,4 @@ declare class CourierAdminClient {
     rollback(type: string, input: IRollbackTemplateInput, locale?: string | null): Promise<IApiResponse<ITemplateEntry>>;
 }
 
-export { AuditClient, AuthClient, BillingClient, ConfigAdminClient, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IApiError, type IApiResponse, type IAuditEventDTO, type IAuditPageResult, type IBlacklistCustomerInput, type ICache, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginInput, type ILoginResult, type IMeResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRequestConfig, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type SubscriberType, WebhooksClient, WorkspacesClient, createMemoryCache, isMfaRequired };
+export { AuditClient, AuthClient, BillingClient, ConfigAdminClient, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IApiError, type IApiResponse, type IAuditEventDTO, type IAuditPageResult, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginInput, type ILoginResult, type IMeResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRequestConfig, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type SubscriberType, WebhooksClient, WorkspacesClient, createMemoryCache, isMfaRequired };

package/dist/index.d.ts

@@ -197,6 +197,67 @@ interface IUsageResult {
     total: number;
     since: string;
 }
+interface IWalletDTO {
+    balance: string;
+    currency: string;
+    precision: number;
+    granted?: string;
+    purchased?: string;
+    spendPurchased?: boolean;
+    grantedExpiresAt?: string | null;
+}
+interface IWalletResult {
+    wallet: IWalletDTO;
+}
+interface IWalletTransactionDTO {
+    id: string;
+    type: string;
+    amount: string;
+    balanceAfter: string;
+    currency: string;
+    description: string | null;
+    providerTxId: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+interface IWalletTransactionsResult {
+    transactions: IWalletTransactionDTO[];
+    nextCursor: string | null;
+}
+interface IWalletCheckoutInput {
+    packId: string;
+}
+interface ICancelSubscriptionInput {
+    atPeriodEnd?: boolean;
+}
+interface ISubscriptionChangeResult {
+    atPeriodEnd: boolean;
+    status: string;
+    currentPeriodEnd: string | null;
+}
+interface IPaymentMethodDTO {
+    brand: string;
+    last4: string;
+    expMonth: number;
+    expYear: number;
+}
+interface IPaymentMethodResult {
+    paymentMethod: IPaymentMethodDTO | null;
+}
+interface IInvoiceDTO {
+    id: string;
+    number: string | null;
+    amountDue: string;
+    amountPaid: string;
+    currency: string;
+    status: string;
+    created: string;
+    hostedInvoiceUrl: string | null;
+    invoicePdf: string | null;
+}
+interface IInvoicesResult {
+    invoices: IInvoiceDTO[];
+}
 interface IWorkspaceAddressDTO {
     line1: string;
     line2: string;
@@ -641,6 +702,9 @@ interface IRecordUsageInput {
     metric: string;
     quantity?: number;
 }
+interface IWalletPreferencesInput {
+    spendPurchased: boolean;
+}
 interface ICreatePlanInput {
     name: string;
     description?: string | null;
@@ -668,10 +732,21 @@ declare class BillingClient {
     updatePlan(planId: string, input: IUpdatePlanInput): Promise<IApiResponse<IPlanResult>>;
     deletePlan(planId: string): Promise<IApiResponse<undefined>>;
     getSubscription(opts?: IReadOptions): Promise<IApiResponse<ISubscriptionResult>>;
+    cancelSubscription(input?: ICancelSubscriptionInput): Promise<IApiResponse<ISubscriptionChangeResult>>;
+    reactivateSubscription(): Promise<IApiResponse<ISubscriptionChangeResult>>;
     createCheckoutSession(input: ICheckoutInput): Promise<IApiResponse<ICheckoutUrlResult>>;
     createPortalSession(): Promise<IApiResponse<IPortalUrlResult>>;
     recordUsage(input: IRecordUsageInput): Promise<IApiResponse<undefined>>;
     getUsage(metric: string, opts?: IReadOptions): Promise<IApiResponse<IUsageResult>>;
+    getWallet(opts?: IReadOptions): Promise<IApiResponse<IWalletResult>>;
+    setWalletPreferences(input: IWalletPreferencesInput): Promise<IApiResponse<IWalletResult>>;
+    createWalletCheckout(input: IWalletCheckoutInput): Promise<IApiResponse<ICheckoutUrlResult>>;
+    getWalletTransactions(opts?: IReadOptions & {
+        cursor?: string;
+        limit?: number;
+    }): Promise<IApiResponse<IWalletTransactionsResult>>;
+    getPaymentMethod(opts?: IReadOptions): Promise<IApiResponse<IPaymentMethodResult>>;
+    listInvoices(opts?: IReadOptions): Promise<IApiResponse<IInvoicesResult>>;
 }
 
 interface IListCustomersInput {
@@ -1006,4 +1081,4 @@ declare class CourierAdminClient {
     rollback(type: string, input: IRollbackTemplateInput, locale?: string | null): Promise<IApiResponse<ITemplateEntry>>;
 }
 
-export { AuditClient, AuthClient, BillingClient, ConfigAdminClient, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IApiError, type IApiResponse, type IAuditEventDTO, type IAuditPageResult, type IBlacklistCustomerInput, type ICache, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginInput, type ILoginResult, type IMeResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRequestConfig, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type SubscriberType, WebhooksClient, WorkspacesClient, createMemoryCache, isMfaRequired };
+export { AuditClient, AuthClient, BillingClient, ConfigAdminClient, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IApiError, type IApiResponse, type IAuditEventDTO, type IAuditPageResult, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginInput, type ILoginResult, type IMeResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRequestConfig, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type SubscriberType, WebhooksClient, WorkspacesClient, createMemoryCache, isMfaRequired };

package/dist/index.js

@@ -419,6 +419,28 @@ var BillingClient = class {
       bust: opts?.bust
     });
   }
+  // First-party cancel — no portal round-trip. Default keeps access until the
+  // paid-through date; pass { atPeriodEnd: false } to end it immediately. 501
+  // when the provider has no first-party cancel (the portal remains a fallback).
+  cancelSubscription(input) {
+    return this.http.request({
+      method: "POST",
+      path: "/billing/subscription/cancel",
+      body: input ?? {},
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId
+    });
+  }
+  // Un-cancel a subscription scheduled to cancel at period end. Idempotent; 409
+  // when the subscription is already fully canceled (start a new checkout).
+  reactivateSubscription() {
+    return this.http.request({
+      method: "POST",
+      path: "/billing/subscription/reactivate",
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId
+    });
+  }
   // ── Checkout / portal ────────────────────────────────────────────────────────
   createCheckoutSession(input) {
     return this.http.request({
@@ -456,6 +478,74 @@ var BillingClient = class {
       bust: opts?.bust
     });
   }
+  // ── Wallet ─────────────────────────────────────────────────────────────────────
+  getWallet(opts) {
+    return this.http.request({
+      method: "GET",
+      path: "/billing/wallet",
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId,
+      bust: opts?.bust
+    });
+  }
+  setWalletPreferences(input) {
+    return this.http.request({
+      method: "POST",
+      path: "/billing/wallet/preferences",
+      body: input,
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId
+    });
+  }
+  // Start a one-time credit-pack purchase. Returns a hosted checkout URL to
+  // redirect the buyer to; the wallet is credited by the payment webhook.
+  createWalletCheckout(input) {
+    return this.http.request({
+      method: "POST",
+      path: "/billing/wallet/checkout",
+      body: input,
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId
+    });
+  }
+  // The wallet ledger, newest first — every credit/debit with a running
+  // balanceAfter. Cursor-paginated: pass the previous result's `nextCursor`.
+  getWalletTransactions(opts) {
+    const params = new URLSearchParams();
+    if (opts?.cursor) params.set("cursor", opts.cursor);
+    if (opts?.limit !== void 0) params.set("limit", String(opts.limit));
+    const qs = params.toString();
+    return this.http.request({
+      method: "GET",
+      path: `/billing/wallet/transactions${qs ? "?" + qs : ""}`,
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId,
+      bust: opts?.bust
+    });
+  }
+  // ── Account ──────────────────────────────────────────────────────────────────
+  // The customer's card on file (brand/last4/expiry), or { paymentMethod: null }
+  // when none is stored. 501 when the provider can't retrieve it.
+  getPaymentMethod(opts) {
+    return this.http.request({
+      method: "GET",
+      path: "/billing/payment-method",
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId,
+      bust: opts?.bust
+    });
+  }
+  // The customer's invoices, newest first — each links out to the hosted
+  // invoice / PDF. 501 when the provider can't list them.
+  listInvoices(opts) {
+    return this.http.request({
+      method: "GET",
+      path: "/billing/invoices",
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId,
+      bust: opts?.bust
+    });
+  }
 };
 
 // src/modules/customers.ts