@solvapay/server 2.2.1 → 2.2.2-preview-e0daec2e600e51dda2adb4993d7d551508ead29c

package/dist/edge.d.ts

@@ -1,4 +1,3 @@
-import * as _solvapay_core from '@solvapay/core';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
 
 interface components {
@@ -333,13 +332,6 @@ interface components {
                     label?: string;
                     /** @enum {string} */
                     onEnd: 'convert' | 'cancel' | 'downgrade';
-                    requireCard?: boolean;
-                } | {
-                    /** @enum {string} */
-                    kind: 'prepaid';
-                    label?: string;
-                    lowBalanceUnits?: number;
-                    minTopUpMinor?: number;
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -536,13 +528,6 @@ interface components {
                 label?: string;
                 /** @enum {string} */
                 onEnd: 'convert' | 'cancel' | 'downgrade';
-                requireCard?: boolean;
-            } | {
-                /** @enum {string} */
-                kind: 'prepaid';
-                label?: string;
-                lowBalanceUnits?: number;
-                minTopUpMinor?: number;
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -633,7 +618,7 @@ interface components {
              * @example duplicate
              * @enum {string}
              */
-            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based';
+            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'plan_billed_at_period_end';
         };
         CreditDebitSuccessResponse: {
             /**
@@ -682,7 +667,7 @@ interface components {
              * @example parity
              * @enum {string}
              */
-            rateSource: 'parity' | 'db' | 'fallback';
+            rateSource: 'parity' | 'db' | 'fallback' | 'funding';
         };
         CustomerBalanceResponse: {
             /**
@@ -739,11 +724,10 @@ interface components {
         };
         DisableAutoRechargeResponse: {
             /**
-             * Always true on success
+             * Whether auto-recharge was disabled
              * @example true
-             * @enum {number}
              */
-            success: true;
+            success: boolean;
         };
         GetCustomerSessionResponse: {
             /**
@@ -968,13 +952,6 @@ interface components {
                     label?: string;
                     /** @enum {string} */
                     onEnd: 'convert' | 'cancel' | 'downgrade';
-                    requireCard?: boolean;
-                } | {
-                    /** @enum {string} */
-                    kind: 'prepaid';
-                    label?: string;
-                    lowBalanceUnits?: number;
-                    minTopUpMinor?: number;
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1555,7 +1532,7 @@ interface components {
                 [key: string]: unknown;
             } | null;
             /**
-             * Whether the frozen plan meters usage
+             * Whether the frozen plan counts usage (prices per unit, or has a limit). Shipped clients read this to show an allowance.
              * @example true
              */
             isMetered?: boolean;
@@ -1876,13 +1853,6 @@ interface components {
                 label?: string;
                 /** @enum {string} */
                 onEnd: 'convert' | 'cancel' | 'downgrade';
-                requireCard?: boolean;
-            } | {
-                /** @enum {string} */
-                kind: 'prepaid';
-                label?: string;
-                lowBalanceUnits?: number;
-                minTopUpMinor?: number;
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -3826,29 +3796,9 @@ type WebhookEvent = {
 type PurchaseInfo = components['schemas']['SdkPurchaseResponse'];
 type AttachBusinessDetailsParams = {
     paymentIntentId: string;
-    customerRef?: string;
-} & BusinessDetailsInput;
-type AttachBusinessDetailsResult = {
-    taxBreakdown: TaxBreakdown;
-};
-type CheckLimitsRequest = components['schemas']['CheckLimitRequest'] & {
-    /**
-     * When `true`, the backend mints a checkout session (or customer
-     * portal session for activation flows) and returns its URL / id on
-     * the response. Default `false` so read-only callers like
-     * `useLimits` / `checkLimitsCore` stop creating orphan
-     * `CheckoutSession` documents and firing spurious
-     * `checkout_session.created` webhooks on every refetch.
-     *
-     * `paywall.decide()` opts in because it bakes the URL into the
-     * 402 `PaywallStructuredContent`.
-     *
-     * NOTE: this intersection is a temporary stand-in until the
-     * backend OpenAPI spec is republished and `generated.ts` is
-     * regenerated to include the field natively.
-     */
-    includeCheckoutSession?: boolean;
-};
+} & components['schemas']['BusinessDetailsDto'];
+type AttachBusinessDetailsResult = components['schemas']['AttachBusinessDetailsResponse'];
+type CheckLimitsRequest = components['schemas']['CheckLimitRequest'];
 /**
  * Extended LimitResponse with SDK-added plan field.
  *
@@ -3875,19 +3825,7 @@ type CustomerResponseMapped = {
     plan?: string;
     purchases?: PurchaseInfo[];
 };
-/**
- * One-time purchase information returned from payment processing
- */
-interface OneTimePurchaseInfo {
-    reference: string;
-    customerRef: string;
-    productRef?: string;
-    amount: number;
-    currency: string;
-    creditsAdded?: number;
-    completedAt: string;
-    createdAt: string;
-}
+type OneTimePurchaseInfo = components['schemas']['OneTimePurchaseInfo'];
 /**
  * Result from processing a payment intent.
  *
@@ -3972,71 +3910,11 @@ 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;
-    maxMonthlySpendMinor?: number;
-    monthlySpendMinor: number;
-    monthlySpendPeriod?: string;
-    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;
-    maxMonthlySpendMajor?: number;
-    currency: string;
-};
+type AutoRechargeInput = Omit<components['schemas']['PutAutoRechargeSdkDto'], 'customerRef' | 'customerEmail' | 'customerName' | 'deferSetupIntent'>;
 /** 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;
-};
+type SaveAutoRechargeInput = Omit<components['schemas']['PutAutoRechargeSdkDto'], 'customerRef' | 'customerEmail' | 'customerName'>;
+type AutoRechargeResponse = components['schemas']['AutoRechargeGetResponse'];
+type SaveAutoRechargeResponse = components['schemas']['SaveAutoRechargeResponse'];
 /**
  * SDK-facing merchant identity (source: GET /v1/sdk/merchant).
  */
@@ -4070,40 +3948,9 @@ type McpBootstrapPlanInput = NonNullable<components['schemas']['McpBootstrapDto'
 type ToolPlanMappingInput = NonNullable<components['schemas']['McpBootstrapDto']['tools']>[number];
 type McpBootstrapRequest = components['schemas']['McpBootstrapDto'];
 type McpToolPlanMappingInput = NonNullable<components['schemas']['ConfigureMcpPlansDto']['toolMapping']>[number];
-interface McpBootstrapResponse {
-    product: components['schemas']['SdkProductResponse'];
-    mcpServer: {
-        reference?: string;
-        subdomain?: string;
-        mcpProxyUrl?: string;
-        url: string;
-        defaultPlanRef?: string;
-    };
-    planMap: Record<string, {
-        reference: string;
-        name?: string;
-    }>;
-    toolsAutoMapped?: boolean;
-    autoMappedTools?: Array<{
-        name: string;
-        description?: string;
-    }>;
-}
+type McpBootstrapResponse = components['schemas']['McpBootstrapResult'];
 type ConfigureMcpPlansRequest = components['schemas']['ConfigureMcpPlansDto'];
-interface ConfigureMcpPlansResponse {
-    product: components['schemas']['SdkProductResponse'];
-    mcpServer: {
-        reference?: string;
-        subdomain?: string;
-        mcpProxyUrl?: string;
-        url: string;
-        defaultPlanRef?: string;
-    };
-    planMap: Record<string, {
-        reference: string;
-        name?: string;
-    }>;
-}
+type ConfigureMcpPlansResponse = components['schemas']['ConfigureMcpPlansResult'];
 /**
  * SolvaPay API Client Interface
  *
@@ -4124,13 +3971,7 @@ interface SolvaPayClient {
      * `externalRef` on an existing email-matched customer, and exposed
      * directly for integrators who need it.
      */
-    updateCustomer?(customerRef: string, params: {
-        email?: string;
-        name?: string;
-        telephone?: string;
-        metadata?: Record<string, unknown>;
-        externalRef?: string;
-    }): Promise<{
+    updateCustomer?(customerRef: string, params: components['schemas']['UpdateCustomerRequest']): Promise<{
         customerRef: string;
     }>;
     getCustomer(params: {
@@ -4154,75 +3995,37 @@ interface SolvaPayClient {
      */
     getPlatformConfig?(): Promise<SdkPlatformConfigResponse>;
     getProduct?(productRef: string): Promise<SdkProductResponse>;
-    listProducts?(): Promise<Array<{
-        reference: string;
-        name: string;
-        description?: string;
-    }>>;
-    createProduct?(params: components['schemas']['CreateProductRequest']): Promise<{
-        reference: string;
-        name: string;
-    }>;
+    listProducts?(): Promise<components['schemas']['SdkProductResponse'][]>;
+    createProduct?(params: components['schemas']['CreateProductRequest']): Promise<components['schemas']['SdkProductResponse']>;
     bootstrapMcpProduct?(params: McpBootstrapRequest): Promise<McpBootstrapResponse>;
     configureMcpPlans?(productRef: string, params: ConfigureMcpPlansRequest): Promise<ConfigureMcpPlansResponse>;
     updateProduct?(productRef: string, params: components['schemas']['UpdateProductRequest']): Promise<components['schemas']['SdkProductResponse']>;
     deleteProduct?(productRef: string): Promise<void>;
-    cloneProduct?(productRef: string, overrides?: {
-        name?: string;
-    }): Promise<{
-        reference: string;
-        name: string;
-    }>;
+    cloneProduct?(productRef: string, overrides?: components['schemas']['CloneProductDto']): Promise<components['schemas']['SdkProductResponse']>;
     listPlans?(productRef: string): Promise<components['schemas']['Plan'][]>;
     createPlan?(params: components['schemas']['CreatePlanRequest'] & {
         productRef: string;
     }): Promise<components['schemas']['Plan']>;
     updatePlan?(productRef: string, planRef: string, params: components['schemas']['UpdatePlanRequest']): Promise<components['schemas']['Plan']>;
     deletePlan?(productRef: string, planRef: string): Promise<void>;
-    createPaymentIntent?(params: {
-        productRef: string;
-        planRef: string;
-        customerRef: string;
-        currency?: string;
+    createPaymentIntent?(params: Omit<components['schemas']['CreatePaymentIntentDto'], 'purpose'> & {
+        purpose?: components['schemas']['CreatePaymentIntentDto']['purpose'];
         idempotencyKey?: string;
-    }): Promise<{
-        processorPaymentId: string;
-        clientSecret: string;
-        publishableKey: string;
-        accountId?: string;
-        /** USD ledger amount in minor units. */
-        amount: number;
-        /** Presentment amount in minor units (matches `currency`). */
-        originalAmount?: number;
-        currency?: string;
-        exchangeRate?: number;
-        status?: string;
-    }>;
-    createTopupPaymentIntent?(params: {
-        customerRef: string;
-        amount: number;
+    }): Promise<components['schemas']['SdkPaymentIntentResponse']>;
+    createTopupPaymentIntent?(params: Pick<components['schemas']['CreatePaymentIntentDto'], 'customerRef' | 'amount' | 'currency' | 'description' | 'autoRecharge'> & {
         currency: string;
-        description?: string;
+        amount: number;
         idempotencyKey?: string;
         autoRecharge?: AutoRechargeInput;
-    }): Promise<{
-        processorPaymentId: string;
-        clientSecret: string;
-        publishableKey: string;
-        accountId?: string;
-    }>;
-    cancelPurchase?(params: {
+    }): Promise<components['schemas']['SdkPaymentIntentResponse']>;
+    cancelPurchase?(params: components['schemas']['CancelPurchaseRequest'] & {
         purchaseRef: string;
-        reason?: string;
     }): Promise<PurchaseInfo>;
     reactivatePurchase?(params: {
         purchaseRef: string;
     }): Promise<PurchaseInfo>;
-    processPaymentIntent?(params: {
+    processPaymentIntent?(params: components['schemas']['ProcessPaymentIntentDto'] & {
         paymentIntentId: string;
-        productRef?: string;
-        customerRef: string;
-        planRef?: string;
     }): Promise<ProcessPaymentResult>;
     attachBusinessDetails?(params: AttachBusinessDetailsParams): Promise<AttachBusinessDetailsResult>;
     getUserInfo?(params: {
@@ -4231,14 +4034,7 @@ interface SolvaPayClient {
     }): Promise<components['schemas']['UserInfoResponse']>;
     getCustomerBalance?(params: {
         customerRef: string;
-    }): Promise<{
-        customerRef: string;
-        credits: number;
-        displayCurrency: string;
-        creditsPerMinorUnit: number;
-        displayExchangeRate: number;
-        display?: CreditDisplayBlock;
-    }>;
+    }): Promise<components['schemas']['CustomerBalanceResponse']>;
     createCheckoutSession(params: operations['CheckoutSessionSdkController_createCheckoutSession']['requestBody']['content']['application/json']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
     createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
     activatePlan?(params: components['schemas']['ActivatePlanDto']): Promise<ActivatePlanResult>;
@@ -4253,9 +4049,7 @@ interface SolvaPayClient {
     }): Promise<SaveAutoRechargeResponse>;
     disableAutoRecharge?(params: {
         customerRef: string;
-    }): Promise<{
-        success: true;
-    }>;
+    }): Promise<components['schemas']['DisableAutoRechargeResponse']>;
 }
 
 /**
@@ -5000,18 +4794,7 @@ interface SolvaPay {
      * // Use intent.clientSecret on the client to confirm payment
      * ```
      */
-    createPaymentIntent(params: {
-        productRef: string;
-        planRef: string;
-        customerRef: string;
-        currency?: string;
-        idempotencyKey?: string;
-    }): Promise<{
-        processorPaymentId: string;
-        clientSecret: string;
-        publishableKey: string;
-        accountId?: string;
-    }>;
+    createPaymentIntent(params: Parameters<NonNullable<SolvaPayClient['createPaymentIntent']>>[0]): Promise<components['schemas']['SdkPaymentIntentResponse']>;
     /**
      * Create a payment intent for a credit top-up.
      *
@@ -5019,19 +4802,7 @@ interface SolvaPay {
      * Credits are recorded via webhook after payment confirmation — no
      * `processPaymentIntent` call is needed.
      */
-    createTopupPaymentIntent(params: {
-        customerRef: string;
-        amount: number;
-        currency: string;
-        description?: string;
-        idempotencyKey?: string;
-        autoRecharge?: AutoRechargeInput;
-    }): Promise<{
-        processorPaymentId: string;
-        clientSecret: string;
-        publishableKey: string;
-        accountId?: string;
-    }>;
+    createTopupPaymentIntent(params: Parameters<NonNullable<SolvaPayClient['createTopupPaymentIntent']>>[0]): Promise<components['schemas']['SdkPaymentIntentResponse']>;
     /**
      * Process a payment intent after client-side payment confirmation.
      *
@@ -5070,17 +4841,7 @@ interface SolvaPay {
      * Attach business purchase details to a payment intent
      * and retrieve the computed tax breakdown.
      */
-    attachBusinessDetails(params: {
-        paymentIntentId: string;
-        customerRef?: string;
-        isBusiness: boolean;
-        businessName?: string;
-        country?: string;
-        taxId?: string;
-        taxIdType?: _solvapay_core.TaxIdType;
-    }): Promise<{
-        taxBreakdown: _solvapay_core.TaxBreakdown;
-    }>;
+    attachBusinessDetails(params: AttachBusinessDetailsParams): Promise<AttachBusinessDetailsResult>;
     /**
      * Check if customer is within usage limits for a product.
      *
@@ -5221,13 +4982,7 @@ interface SolvaPay {
      */
     getCustomerBalance(params: {
         customerRef: string;
-    }): Promise<{
-        customerRef: string;
-        credits: number;
-        displayCurrency: string;
-        creditsPerMinorUnit: number;
-        displayExchangeRate: number;
-    }>;
+    }): Promise<components['schemas']['CustomerBalanceResponse']>;
     /**
      * Create a hosted checkout session for a customer.
      *
@@ -5748,14 +5503,7 @@ declare function getAuthenticatedUserCore(request: Request, options?: {
  * Works with standard Web API Request (works everywhere).
  */
 
-type CustomerBalanceResult = {
-    customerRef: string;
-    credits: number;
-    displayCurrency: string;
-    creditsPerMinorUnit: number;
-    displayExchangeRate: number;
-    display?: CreditDisplayBlock;
-};
+type CustomerBalanceResult = components['schemas']['CustomerBalanceResponse'];
 /**
  * Sync customer with SolvaPay backend (ensure customer exists).
  *
@@ -6146,9 +5894,7 @@ type HelperOptions = {
 };
 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>;
+declare function disableAutoRechargeCore(request: Request, options?: HelperOptions): Promise<components['schemas']['DisableAutoRechargeResponse'] | ErrorResult>;
 
 /**
  * Plans Helper (Core)

package/dist/edge.js

@@ -2114,9 +2114,7 @@ function createSolvaPay(config) {
     },
     attachBusinessDetails(params) {
       if (!apiClient.attachBusinessDetails) {
-        throw new SolvaPayError4(
-          "attachBusinessDetails is not available on this API client"
-        );
+        throw new SolvaPayError4("attachBusinessDetails is not available on this API client");
       }
       return apiClient.attachBusinessDetails(params);
     },

package/dist/fetch/index.cjs

@@ -2261,9 +2261,7 @@ function createSolvaPay(config) {
     },
     attachBusinessDetails(params) {
       if (!apiClient.attachBusinessDetails) {
-        throw new import_core4.SolvaPayError(
-          "attachBusinessDetails is not available on this API client"
-        );
+        throw new import_core4.SolvaPayError("attachBusinessDetails is not available on this API client");
       }
       return apiClient.attachBusinessDetails(params);
     },

package/dist/fetch/index.d.cts

@@ -330,13 +330,6 @@ interface components {
                     label?: string;
                     /** @enum {string} */
                     onEnd: 'convert' | 'cancel' | 'downgrade';
-                    requireCard?: boolean;
-                } | {
-                    /** @enum {string} */
-                    kind: 'prepaid';
-                    label?: string;
-                    lowBalanceUnits?: number;
-                    minTopUpMinor?: number;
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -533,13 +526,6 @@ interface components {
                 label?: string;
                 /** @enum {string} */
                 onEnd: 'convert' | 'cancel' | 'downgrade';
-                requireCard?: boolean;
-            } | {
-                /** @enum {string} */
-                kind: 'prepaid';
-                label?: string;
-                lowBalanceUnits?: number;
-                minTopUpMinor?: number;
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -630,7 +616,7 @@ interface components {
              * @example duplicate
              * @enum {string}
              */
-            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based';
+            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'plan_billed_at_period_end';
         };
         CreditDebitSuccessResponse: {
             /**
@@ -679,7 +665,7 @@ interface components {
              * @example parity
              * @enum {string}
              */
-            rateSource: 'parity' | 'db' | 'fallback';
+            rateSource: 'parity' | 'db' | 'fallback' | 'funding';
         };
         CustomerBalanceResponse: {
             /**
@@ -736,11 +722,10 @@ interface components {
         };
         DisableAutoRechargeResponse: {
             /**
-             * Always true on success
+             * Whether auto-recharge was disabled
              * @example true
-             * @enum {number}
              */
-            success: true;
+            success: boolean;
         };
         GetCustomerSessionResponse: {
             /**
@@ -965,13 +950,6 @@ interface components {
                     label?: string;
                     /** @enum {string} */
                     onEnd: 'convert' | 'cancel' | 'downgrade';
-                    requireCard?: boolean;
-                } | {
-                    /** @enum {string} */
-                    kind: 'prepaid';
-                    label?: string;
-                    lowBalanceUnits?: number;
-                    minTopUpMinor?: number;
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1552,7 +1530,7 @@ interface components {
                 [key: string]: unknown;
             } | null;
             /**
-             * Whether the frozen plan meters usage
+             * Whether the frozen plan counts usage (prices per unit, or has a limit). Shipped clients read this to show an allowance.
              * @example true
              */
             isMetered?: boolean;
@@ -1873,13 +1851,6 @@ interface components {
                 label?: string;
                 /** @enum {string} */
                 onEnd: 'convert' | 'cancel' | 'downgrade';
-                requireCard?: boolean;
-            } | {
-                /** @enum {string} */
-                kind: 'prepaid';
-                label?: string;
-                lowBalanceUnits?: number;
-                minTopUpMinor?: number;
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';