@solvapay/server 1.2.1 → 1.3.0-preview-ecd61384a4e849717e13d47ab2daa086cdcd91c5

package/dist/edge.d.ts

@@ -838,6 +838,14 @@ interface components {
              * @example 99
              */
             unitsRemaining: number;
+            autoRecharge?: components["schemas"]["AutoRechargeTriggeredResponse"];
+        };
+        AutoRechargeTriggeredResponse: {
+            /**
+             * Whether the server initiated an auto-recharge charge after this debit
+             * @example true
+             */
+            triggered: boolean;
         };
         CreditDebitSkippedResponse: {
             /** @enum {number} */
@@ -3123,6 +3131,68 @@ type ActivatePlanResult = components['schemas']['ActivatePlanResponseDto'];
  * `{ kind: 'card', ... } | { kind: 'none' }` discriminated union here.
  */
 type PaymentMethodInfo = operations['PaymentMethodSdkController_getPaymentMethod']['responses']['200']['content']['application/json'];
+type AutoRechargeStatus = 'active' | 'disabled' | 'failed' | 'pending_setup';
+type AutoRechargeConfig = {
+    enabled: boolean;
+    trigger: {
+        type: 'balance';
+        thresholdAmountMinor: number;
+    };
+    topup: {
+        mode: 'fixed';
+        amountMinor: number;
+        currency: string;
+    };
+    fundingSourceType?: 'saved_card' | 'tokenized_card';
+    paymentMethodId?: string;
+    status: AutoRechargeStatus;
+    failureCount: number;
+    lastChargeAt?: string;
+    updatedAt?: string;
+    /** Backend-computed display values — render verbatim; do not derive from trigger fields. */
+    display?: AutoRechargeDisplayBlock;
+};
+type AutoRechargeDisplayBlock = {
+    thresholdAmountMajor: number;
+    topupAmountMajor: number;
+    currency: string;
+    formatted: {
+        threshold: string;
+        topup: string;
+    };
+    exchangeRate: number;
+    rateSource: 'parity' | 'db' | 'fallback';
+};
+type CreditDisplayBlock = {
+    amountMajor: number;
+    currency: string;
+    formatted: string;
+    exchangeRate: number;
+    rateSource: 'parity' | 'db' | 'fallback';
+};
+type AutoRechargeInput = {
+    enabled: boolean;
+    triggerType: 'balance';
+    thresholdAmountMajor?: number;
+    topupAmountMajor?: number;
+    maxRecharges?: number;
+    currency: string;
+};
+/** PUT /sdk/auto-recharge — input plus request-only flags. */
+type SaveAutoRechargeInput = AutoRechargeInput & {
+    deferSetupIntent?: boolean;
+};
+type AutoRechargeResponse = {
+    config: AutoRechargeConfig | null;
+    display?: AutoRechargeDisplayBlock;
+};
+type SaveAutoRechargeResponse = {
+    config: AutoRechargeConfig;
+    display?: AutoRechargeDisplayBlock;
+    setupClientSecret?: string;
+    publishableKey?: string;
+    stripeAccountId?: string;
+};
 /**
  * SDK-facing merchant identity (source: GET /v1/sdk/merchant).
  */
@@ -3284,6 +3354,7 @@ interface SolvaPayClient {
         currency: string;
         description?: string;
         idempotencyKey?: string;
+        autoRecharge?: AutoRechargeInput;
     }): Promise<{
         processorPaymentId: string;
         clientSecret: string;
@@ -3315,6 +3386,7 @@ interface SolvaPayClient {
         displayCurrency: string;
         creditsPerMinorUnit: number;
         displayExchangeRate: number;
+        display?: CreditDisplayBlock;
     }>;
     createCheckoutSession(params: operations['CheckoutSessionSdkController_createCheckoutSession']['requestBody']['content']['application/json']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
     createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
@@ -3322,6 +3394,17 @@ interface SolvaPayClient {
     getPaymentMethod?(params: {
         customerRef: string;
     }): Promise<PaymentMethodInfo>;
+    getAutoRecharge?(params: {
+        customerRef: string;
+    }): Promise<AutoRechargeResponse>;
+    saveAutoRecharge?(params: SaveAutoRechargeInput & {
+        customerRef: string;
+    }): Promise<SaveAutoRechargeResponse>;
+    disableAutoRecharge?(params: {
+        customerRef: string;
+    }): Promise<{
+        success: true;
+    }>;
 }
 
 /**
@@ -4043,6 +4126,7 @@ interface SolvaPay {
         currency: string;
         description?: string;
         idempotencyKey?: string;
+        autoRecharge?: AutoRechargeInput;
     }): Promise<{
         processorPaymentId: string;
         clientSecret: string;
@@ -4754,6 +4838,7 @@ type CustomerBalanceResult = {
     displayCurrency: string;
     creditsPerMinorUnit: number;
     displayExchangeRate: number;
+    display?: CreditDisplayBlock;
 };
 /**
  * Sync customer with SolvaPay backend (ensure customer exists).
@@ -4884,6 +4969,7 @@ declare function createTopupPaymentIntentCore(request: Request, body: {
     amount: number;
     currency: string;
     description?: string;
+    autoRecharge?: AutoRechargeInput;
 }, options?: {
     solvaPay?: SolvaPay;
     includeEmail?: boolean;
@@ -5122,6 +5208,17 @@ declare function getPaymentMethodCore(request: Request, options?: {
     includeName?: boolean;
 }): Promise<PaymentMethodInfo | ErrorResult>;
 
+type HelperOptions = {
+    solvaPay?: SolvaPay;
+    includeEmail?: boolean;
+    includeName?: boolean;
+};
+declare function getAutoRechargeCore(request: Request, options?: HelperOptions): Promise<AutoRechargeResponse | ErrorResult>;
+declare function saveAutoRechargeCore(request: Request, input: AutoRechargeInput, options?: HelperOptions): Promise<SaveAutoRechargeResponse | ErrorResult>;
+declare function disableAutoRechargeCore(request: Request, options?: HelperOptions): Promise<{
+    success: true;
+} | ErrorResult>;
+
 /**
  * Plans Helper (Core)
  *
@@ -5280,4 +5377,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): Promise<WebhookEvent>;
 
-export { type ActivatePlanResult, type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type GetUsageResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type LimitResponseWithPlan, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableAllowResult, type PayableFunction, type PayableGateOptions, type PayableGateResult, type PayableOptions, type PayablePaywallResult, type PaymentMethodInfo, type PaywallArgs, type PaywallDecision, PaywallError, type PaywallMetadata, type PaywallState, type PaywallStructuredContent, type ProcessPaymentResult, type PurchaseCheckResult, type RetryOptions, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, type TopupProcessResult, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, buildGateMessage, buildNudgeMessage, buildPaywallGate, cancelPurchaseCore, checkLimitsCore, checkPurchaseCore, classifyPaywallState, type components, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, getAuthenticatedUserCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };
+export { type ActivatePlanResult, type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerBalanceResult, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type GetUsageResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type LimitResponseWithPlan, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableAllowResult, type PayableFunction, type PayableGateOptions, type PayableGateResult, type PayableOptions, type PayablePaywallResult, type PaymentMethodInfo, type PaywallArgs, type PaywallDecision, PaywallError, type PaywallMetadata, type PaywallState, type PaywallStructuredContent, type ProcessPaymentResult, type PurchaseCheckResult, type RetryOptions, type SdkMerchantResponse, type SdkProductResponse, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, type TopupProcessResult, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, activatePlanCore, buildGateMessage, buildNudgeMessage, buildPaywallGate, cancelPurchaseCore, checkLimitsCore, checkPurchaseCore, classifyPaywallState, type components, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createTopupPaymentIntentCore, disableAutoRechargeCore, getAuthenticatedUserCore, getAutoRechargeCore, getCustomerBalanceCore, getMerchantCore, getPaymentMethodCore, getProductCore, getUsageCore, handleRouteError, isErrorResult, isPaywallStructuredContent, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, processTopupPaymentIntentCore, reactivatePurchaseCore, saveAutoRechargeCore, syncCustomerCore, trackUsageCore, verifyWebhook, withRetry };

package/dist/edge.js

@@ -451,7 +451,8 @@ function createSolvaPayClient(opts) {
           purpose: "credit_topup",
           amount: params.amount,
           currency: params.currency,
-          description: params.description
+          description: params.description,
+          ...params.autoRecharge ? { autoRecharge: params.autoRecharge } : {}
         })
       });
       if (!res.ok) {
@@ -689,6 +690,47 @@ function createSolvaPayClient(opts) {
         });
       }
       return await res.json();
+    },
+    async getAutoRecharge(params) {
+      const url = new URL(`${base}/v1/sdk/auto-recharge`);
+      url.searchParams.set("customerRef", params.customerRef);
+      const res = await fetch(url.toString(), { method: "GET", headers });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(`Get auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
+    },
+    async saveAutoRecharge(params) {
+      const res = await fetch(`${base}/v1/sdk/auto-recharge`, {
+        method: "PUT",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(`Save auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
+    },
+    async disableAutoRecharge(params) {
+      const url = new URL(`${base}/v1/sdk/auto-recharge`);
+      url.searchParams.set("customerRef", params.customerRef);
+      const res = await fetch(url.toString(), { method: "DELETE", headers });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(`Disable auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
     }
   };
 }
@@ -2370,6 +2412,23 @@ async function getCustomerBalanceCore(request, options = {}) {
   }
 }
 
+// src/helpers/balance-poll.ts
+var TOPUP_BALANCE_POLL_DELAYS_MS = [500, 1e3, 2e3, 4e3];
+var BALANCE_RECONCILE_DELAYS_MS = [500, 1e3, 2e3, 4e3, 8e3, 16e3];
+async function pollBalanceUntilIncreased(getBalance, baseline, delays = BALANCE_RECONCILE_DELAYS_MS) {
+  for (const delay of delays) {
+    await new Promise((resolve) => setTimeout(resolve, delay));
+    try {
+      const post = await getBalance();
+      if (post.credits > baseline) {
+        return { creditsAdded: post.credits - baseline };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+
 // src/helpers/payment.ts
 async function createPaymentIntentCore(request, body, options = {}) {
   try {
@@ -2440,7 +2499,8 @@ async function createTopupPaymentIntentCore(request, body, options = {}) {
       customerRef,
       amount: body.amount,
       currency: body.currency,
-      description: body.description
+      description: body.description,
+      ...body.autoRecharge ? { autoRecharge: body.autoRecharge } : {}
     });
     return {
       processorPaymentId: paymentIntent.processorPaymentId,
@@ -2484,7 +2544,6 @@ async function processPaymentIntentCore(request, body, options = {}) {
     return handleRouteError(error, "Process payment intent", "Payment processing failed");
   }
 }
-var TOPUP_BALANCE_POLL_DELAYS_MS = [500, 1e3, 2e3, 4e3];
 async function processTopupPaymentIntentCore(request, body, options = {}) {
   try {
     if (!body.paymentIntentId) {
@@ -2527,15 +2586,13 @@ async function processTopupPaymentIntentCore(request, body, options = {}) {
     if (preCredits === null || typeof solvaPay.getCustomerBalance !== "function") {
       return { status: "succeeded" };
     }
-    for (const delay of TOPUP_BALANCE_POLL_DELAYS_MS) {
-      await new Promise((resolve) => setTimeout(resolve, delay));
-      try {
-        const post = await solvaPay.getCustomerBalance({ customerRef });
-        if (post.credits > preCredits) {
-          return { status: "succeeded", creditsAdded: post.credits - preCredits };
-        }
-      } catch {
-      }
+    const pollResult = await pollBalanceUntilIncreased(
+      () => solvaPay.getCustomerBalance({ customerRef }),
+      preCredits,
+      TOPUP_BALANCE_POLL_DELAYS_MS
+    );
+    if (pollResult) {
+      return { status: "succeeded", creditsAdded: pollResult.creditsAdded };
     }
     return { status: "succeeded" };
   } catch (error) {
@@ -2804,6 +2861,54 @@ async function getPaymentMethodCore(request, options = {}) {
   }
 }
 
+// src/helpers/auto-recharge.ts
+async function resolveCustomerRef(request, options) {
+  return syncCustomerCore(request, {
+    solvaPay: options.solvaPay,
+    includeEmail: options.includeEmail,
+    includeName: options.includeName
+  });
+}
+async function getAutoRechargeCore(request, options = {}) {
+  try {
+    const customerRef = await resolveCustomerRef(request, options);
+    if (isErrorResult(customerRef)) return customerRef;
+    const solvaPay = options.solvaPay ?? createSolvaPay();
+    if (!solvaPay.apiClient.getAutoRecharge) {
+      return { error: "getAutoRecharge is not implemented on this API client", status: 500 };
+    }
+    return solvaPay.apiClient.getAutoRecharge({ customerRef });
+  } catch (error) {
+    return handleRouteError(error, "Get auto-recharge", "Failed to load auto-recharge");
+  }
+}
+async function saveAutoRechargeCore(request, input, options = {}) {
+  try {
+    const customerRef = await resolveCustomerRef(request, options);
+    if (isErrorResult(customerRef)) return customerRef;
+    const solvaPay = options.solvaPay ?? createSolvaPay();
+    if (!solvaPay.apiClient.saveAutoRecharge) {
+      return { error: "saveAutoRecharge is not implemented on this API client", status: 500 };
+    }
+    return solvaPay.apiClient.saveAutoRecharge({ customerRef, ...input });
+  } catch (error) {
+    return handleRouteError(error, "Save auto-recharge", "Failed to save auto-recharge");
+  }
+}
+async function disableAutoRechargeCore(request, options = {}) {
+  try {
+    const customerRef = await resolveCustomerRef(request, options);
+    if (isErrorResult(customerRef)) return customerRef;
+    const solvaPay = options.solvaPay ?? createSolvaPay();
+    if (!solvaPay.apiClient.disableAutoRecharge) {
+      return { error: "disableAutoRecharge is not implemented on this API client", status: 500 };
+    }
+    return solvaPay.apiClient.disableAutoRecharge({ customerRef });
+  } catch (error) {
+    return handleRouteError(error, "Disable auto-recharge", "Failed to disable auto-recharge");
+  }
+}
+
 // src/helpers/plans.ts
 import { getSolvaPayConfig as getSolvaPayConfig2 } from "@solvapay/core";
 async function listPlansCore(request, options = {}) {
@@ -3132,7 +3237,9 @@ export {
   createSolvaPay,
   createSolvaPayClient,
   createTopupPaymentIntentCore,
+  disableAutoRechargeCore,
   getAuthenticatedUserCore,
+  getAutoRechargeCore,
   getCustomerBalanceCore,
   getMerchantCore,
   getPaymentMethodCore,
@@ -3146,6 +3253,7 @@ export {
   processPaymentIntentCore,
   processTopupPaymentIntentCore,
   reactivatePurchaseCore,
+  saveAutoRechargeCore,
   syncCustomerCore,
   trackUsageCore,
   verifyWebhook,

package/dist/fetch/index.cjs

@@ -655,7 +655,8 @@ function createSolvaPayClient(opts) {
           purpose: "credit_topup",
           amount: params.amount,
           currency: params.currency,
-          description: params.description
+          description: params.description,
+          ...params.autoRecharge ? { autoRecharge: params.autoRecharge } : {}
         })
       });
       if (!res.ok) {
@@ -893,6 +894,47 @@ function createSolvaPayClient(opts) {
         });
       }
       return await res.json();
+    },
+    async getAutoRecharge(params) {
+      const url = new URL(`${base}/v1/sdk/auto-recharge`);
+      url.searchParams.set("customerRef", params.customerRef);
+      const res = await fetch(url.toString(), { method: "GET", headers });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new import_core2.SolvaPayError(`Get auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
+    },
+    async saveAutoRecharge(params) {
+      const res = await fetch(`${base}/v1/sdk/auto-recharge`, {
+        method: "PUT",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new import_core2.SolvaPayError(`Save auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
+    },
+    async disableAutoRecharge(params) {
+      const url = new URL(`${base}/v1/sdk/auto-recharge`);
+      url.searchParams.set("customerRef", params.customerRef);
+      const res = await fetch(url.toString(), { method: "DELETE", headers });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new import_core2.SolvaPayError(`Disable auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
     }
   };
 }
@@ -2467,7 +2509,8 @@ async function createTopupPaymentIntentCore(request, body, options = {}) {
       customerRef,
       amount: body.amount,
       currency: body.currency,
-      description: body.description
+      description: body.description,
+      ...body.autoRecharge ? { autoRecharge: body.autoRecharge } : {}
     });
     return {
       processorPaymentId: paymentIntent.processorPaymentId,

package/dist/fetch/index.d.cts

@@ -838,6 +838,14 @@ interface components {
              * @example 99
              */
             unitsRemaining: number;
+            autoRecharge?: components["schemas"]["AutoRechargeTriggeredResponse"];
+        };
+        AutoRechargeTriggeredResponse: {
+            /**
+             * Whether the server initiated an auto-recharge charge after this debit
+             * @example true
+             */
+            triggered: boolean;
         };
         CreditDebitSkippedResponse: {
             /** @enum {number} */

package/dist/fetch/index.d.ts

@@ -838,6 +838,14 @@ interface components {
              * @example 99
              */
             unitsRemaining: number;
+            autoRecharge?: components["schemas"]["AutoRechargeTriggeredResponse"];
+        };
+        AutoRechargeTriggeredResponse: {
+            /**
+             * Whether the server initiated an auto-recharge charge after this debit
+             * @example true
+             */
+            triggered: boolean;
         };
         CreditDebitSkippedResponse: {
             /** @enum {number} */

package/dist/fetch/index.js

@@ -602,7 +602,8 @@ function createSolvaPayClient(opts) {
           purpose: "credit_topup",
           amount: params.amount,
           currency: params.currency,
-          description: params.description
+          description: params.description,
+          ...params.autoRecharge ? { autoRecharge: params.autoRecharge } : {}
         })
       });
       if (!res.ok) {
@@ -840,6 +841,47 @@ function createSolvaPayClient(opts) {
         });
       }
       return await res.json();
+    },
+    async getAutoRecharge(params) {
+      const url = new URL(`${base}/v1/sdk/auto-recharge`);
+      url.searchParams.set("customerRef", params.customerRef);
+      const res = await fetch(url.toString(), { method: "GET", headers });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError2(`Get auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
+    },
+    async saveAutoRecharge(params) {
+      const res = await fetch(`${base}/v1/sdk/auto-recharge`, {
+        method: "PUT",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError2(`Save auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
+    },
+    async disableAutoRecharge(params) {
+      const url = new URL(`${base}/v1/sdk/auto-recharge`);
+      url.searchParams.set("customerRef", params.customerRef);
+      const res = await fetch(url.toString(), { method: "DELETE", headers });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError2(`Disable auto-recharge failed (${res.status}): ${error}`, {
+          status: res.status
+        });
+      }
+      return await res.json();
     }
   };
 }
@@ -2414,7 +2456,8 @@ async function createTopupPaymentIntentCore(request, body, options = {}) {
       customerRef,
       amount: body.amount,
       currency: body.currency,
-      description: body.description
+      description: body.description,
+      ...body.autoRecharge ? { autoRecharge: body.autoRecharge } : {}
     });
     return {
       processorPaymentId: paymentIntent.processorPaymentId,