@fonderie/client 0.13.0 → 0.15.0

package/brain/signatures.md

@@ -192,8 +192,12 @@ new BillingClient(http: HttpClient, tokens: TokenStore): BillingClient
   .getWallet(opts?: IReadOptions | undefined): Promise<IApiResponse<IWalletResult>>
   .setWalletPreferences(input: IWalletPreferencesInput): Promise<IApiResponse<IWalletResult>>
   .createWalletCheckout(input: IWalletCheckoutInput): Promise<IApiResponse<ICheckoutUrlResult>>
+  .purchaseWalletPack(input: IWalletPurchaseInput): Promise<IApiResponse<IWalletPurchaseResult>>
   .getWalletTransactions(opts?: (IReadOptions & { cursor?: string; limit?: number; }) | undefined): Promise<IApiResponse<IWalletTransactionsResult>>
   .getPaymentMethod(opts?: IReadOptions | undefined): Promise<IApiResponse<IPaymentMethodResult>>
+  .setupPaymentMethod(): Promise<IApiResponse<ISetupIntentResult>>
+  .savePaymentMethod(input: ISavePaymentMethodInput): Promise<IApiResponse<IPaymentMethodResult>>
+  .removePaymentMethod(): Promise<IApiResponse<IPaymentMethodResult>>
   .listInvoices(opts?: IReadOptions | undefined): Promise<IApiResponse<IInvoicesResult>>
 
 interface IConfigAdminClientOptions {
@@ -1011,6 +1015,20 @@ interface IWalletDTO {
     grantedExpiresAt?: string | null;
 }
 
+interface IWalletPurchaseInput {
+    packId: string;
+    idempotencyKey: string;
+}
+
+interface IWalletPurchaseResult {
+    status: 'credited' | 'checkout_required' | 'declined' | 'processing';
+    balance?: string;
+    currency?: string;
+    credits?: string;
+    duplicate?: boolean;
+    reason?: 'no_saved_card' | 'authentication_required';
+}
+
 interface IWalletResult {
     wallet: IWalletDTO;
 }

package/dist/index.cjs

@@ -545,6 +545,21 @@ var BillingClient = class {
       workspaceId: this.workspaceId
     });
   }
+  // Buy a credit pack in-app by charging the saved card — no redirect. Inspect
+  // `result.status`: 'credited' (done — refresh the wallet), 'checkout_required'
+  // (no saved card or the card needs 3-D Secure → fall back to
+  // createWalletCheckout), 'declined', or 'processing' (indeterminate — retry
+  // with the SAME idempotencyKey). Generate one idempotencyKey per attempt and
+  // reuse it on retry so a double-submit can't double-charge.
+  purchaseWalletPack(input) {
+    return this.http.request({
+      method: "POST",
+      path: "/billing/wallet/purchase",
+      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) {
@@ -572,6 +587,37 @@ var BillingClient = class {
       bust: opts?.bust
     });
   }
+  // Begin in-app card entry — returns a SetupIntent client secret for the
+  // provider's embedded card element (Stripe Payment Element); the user never
+  // leaves the site. 501 when the provider has no in-app card support.
+  setupPaymentMethod() {
+    return this.http.request({
+      method: "POST",
+      path: "/billing/payment-method/setup",
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId
+    });
+  }
+  // Save the card after the client confirms the SetupIntent: makes it the
+  // default and records it. 422 when the card isn't attached to this customer.
+  savePaymentMethod(input) {
+    return this.http.request({
+      method: "PUT",
+      path: "/billing/payment-method",
+      body: input,
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId
+    });
+  }
+  // Remove the saved card (detach at the provider + clear the record).
+  removePaymentMethod() {
+    return this.http.request({
+      method: "DELETE",
+      path: "/billing/payment-method",
+      token: this.tokens.get(),
+      workspaceId: this.workspaceId
+    });
+  }
   // The customer's invoices, newest first — each links out to the hosted
   // invoice / PDF. 501 when the provider can't list them.
   listInvoices(opts) {