@solvapay/server 1.0.1-preview.3 → 1.0.1-preview.4

package/dist/index.d.ts

@@ -1,214 +1,83 @@
-type WebhookEventType = 'payment.succeeded' | 'payment.failed' | 'payment.refunded' | 'payment.refund_failed' | 'purchase.created' | 'purchase.updated' | 'purchase.cancelled' | 'purchase.expired' | 'purchase.suspended' | 'customer.created' | 'customer.updated' | 'customer.deleted';
-interface WebhookEvent {
+type WebhookEventType = 'payment.succeeded' | 'payment.failed' | 'payment.refunded' | 'payment.refund_failed' | 'purchase.created' | 'purchase.updated' | 'purchase.cancelled' | 'purchase.expired' | 'purchase.suspended' | 'customer.created' | 'customer.updated' | 'customer.deleted' | 'checkout_session.created';
+interface WebhookProduct {
+    reference: string;
+}
+interface CustomerWebhookObject {
+    id: string;
+    created: number;
+    product: WebhookProduct | null;
+    reference?: string;
+    name?: string;
+    email?: string;
+    telephone?: string;
+    status?: string;
+}
+type WebhookPayloadObject = Record<string, unknown>;
+type WebhookEventObjectMap = {
+    'payment.succeeded': WebhookPayloadObject;
+    'payment.failed': WebhookPayloadObject;
+    'payment.refunded': WebhookPayloadObject;
+    'payment.refund_failed': WebhookPayloadObject;
+    'purchase.created': WebhookPayloadObject;
+    'purchase.updated': WebhookPayloadObject;
+    'purchase.cancelled': WebhookPayloadObject;
+    'purchase.expired': WebhookPayloadObject;
+    'purchase.suspended': WebhookPayloadObject;
+    'customer.created': CustomerWebhookObject;
+    'customer.updated': CustomerWebhookObject;
+    'customer.deleted': CustomerWebhookObject;
+    'checkout_session.created': WebhookPayloadObject;
+};
+type WebhookEventForType<TType extends WebhookEventType> = {
     id: string;
-    type: WebhookEventType;
+    type: TType;
     created: number;
     api_version: string;
     data: {
-        object: Record<string, any>;
-        previous_attributes: Record<string, any> | null;
+        object: WebhookEventObjectMap[TType];
+        previous_attributes: Record<string, unknown> | null;
     };
     livemode: boolean;
     request: {
         id: string | null;
         idempotency_key: string | null;
     };
-}
+};
+type WebhookEvent = {
+    [TType in WebhookEventType]: WebhookEventForType<TType>;
+}[WebhookEventType];
 
 interface components {
     schemas: {
-        UpdateProviderDto: {
-            /** @description Legal entity information */
-            legalEntity?: Record<string, never>;
-            /**
-             * Provider description
-             * @example My business
-             */
-            description?: string;
-            /**
-             * Business website URL
-             * @example https://example.com
-             */
-            website?: string;
+        CreatePaymentIntentDto: {
+            productRef?: string;
+            customerReference: string;
+            planRef?: string;
+            pricingTier?: string;
             /**
-             * Business type
-             * @example individual
+             * @default product
              * @enum {string}
              */
-            businessType?: "individual" | "company";
-            /**
-             * Business email address
-             * @example business@example.com
-             */
-            businessEmail?: string;
-            /**
-             * Support email address
-             * @example support@example.com
-             */
-            supportEmail?: string;
-            /**
-             * Business telephone number
-             * @example +1234567890
-             */
-            telephone?: string;
-            /**
-             * Support telephone number
-             * @example +1234567890
-             */
-            supportTelephone?: string;
-            /**
-             * Default currency code
-             * @example usd
-             */
-            defaultCurrency?: string;
-            /** @description Arbitrary metadata */
-            metadata?: Record<string, never>;
-            /** @description Terms of Service acceptance */
-            tosAcceptance?: Record<string, never>;
-        };
-        CreateSecretKey: Record<string, never>;
-        CreateUser: Record<string, never>;
-        UpdateUser: Record<string, never>;
-        UpdateProfile: Record<string, never>;
-        UpdatePreferences: Record<string, never>;
-        RequestEmailChange: {
-            newEmail: string;
-        };
-        VerifyEmailChange: {
-            code: string;
-        };
-        CreateUiCheckoutSessionRequest: {
-            /**
-             * Customer reference
-             * @example cus_3c4d5e6f7g8h
-             */
+            purpose: "product" | "credit_topup" | "usage_billing";
+            amount?: number;
+            currency?: string;
+            description?: string;
+        };
+        CreateCheckoutSessionRequest: {
             customerRef: string;
-            /**
-             * Plan reference (optional)
-             * @example pln_2b3c4d5e6f7g
-             */
+            productRef?: string;
             planRef?: string;
-            /**
-             * Product reference (required)
-             * @example prd_1a2b3c4d5e6f
-             */
-            productRef: string;
-        };
-        CheckoutSessionResponse: {
-            /**
-             * Checkout session ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
-            /**
-             * Public session ID used in checkout URL
-             * @example a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
-             */
-            sessionId: string;
-            /**
-             * Amount in cents
-             * @example 2999
-             */
-            amount: number;
-            /**
-             * Currency code
-             * @example USD
-             */
-            currency: string;
-            /**
-             * Session status
-             * @example active
-             */
-            status: string;
-            /**
-             * Checkout URL to open the checkout page
-             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
-             */
-            checkoutUrl: string;
-        };
-        SelectCustomerSessionProductRequest: {
-            /**
-             * Product reference or ID to scope the customer manage session
-             * @example prd_1a2b3c4d5e6f
-             */
-            productRef: string;
+            returnUrl?: string;
+            /** @enum {string} */
+            purpose?: "credit_topup";
         };
-        CancelRenewalRequest: {
-            /** @description Reason for cancelling renewal */
+        CancelPurchaseRequest: {
             reason?: string;
         };
-        ExternalAccount: {
-            /**
-             * Country code
-             * @example US
-             */
-            country: string;
-            /**
-             * Currency code
-             * @example usd
-             */
-            currency: string;
-            /**
-             * Account holder name
-             * @example John Doe
-             */
-            accountHolderName: string;
-            /**
-             * Account holder type
-             * @example individual
-             * @enum {string}
-             */
-            accountHolderType: "individual" | "company";
-            /**
-             * Routing number
-             * @example 110000000
-             */
-            routingNumber: string;
-            /**
-             * Account number
-             * @example 000123456789
-             */
-            accountNumber: string;
-        };
-        TosAcceptance: {
-            /**
-             * IP address of user accepting ToS
-             * @example 192.168.1.1
-             */
-            ip: string;
-        };
-        UpdateConnectedAccount: {
-            /**
-             * Business website URL
-             * @example https://example.com
-             */
-            website?: string;
-            /** @description External bank account */
-            externalAccount?: components["schemas"]["ExternalAccount"];
-            /** @description Terms of Service acceptance */
-            tosAcceptance?: components["schemas"]["TosAcceptance"];
-        };
-        CreateCheckoutSessionRequest: {
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            customerRef: string;
-            /**
-             * Product reference identifier
-             * @example prd_1A2B3C4D
-             */
+        ProcessPaymentIntentDto: {
             productRef: string;
-            /**
-             * Plan reference identifier (optional)
-             * @example pln_2b3c4d5e6f7g
-             */
+            customerRef: string;
             planRef?: string;
-            /**
-             * URL to redirect to after successful payment (optional)
-             * @example https://example.com/payment-success
-             */
-            returnUrl?: string;
         };
         CreateCheckoutSessionResponse: {
             /**
@@ -222,141 +91,13 @@ interface components {
              */
             checkoutUrl: string;
         };
-        Signup: {
-            name: string;
-            email: string;
-            /** @enum {string} */
-            type?: "provider" | "admin" | "super_admin";
-        };
-        AuthUserDto: {
-            id: string;
-            name: string;
-            email: string;
-            /** @enum {string} */
-            type: "provider" | "admin" | "super_admin";
-            emailVerified: boolean;
-            /** @enum {string} */
-            authProvider: "local" | "google" | "github" | "facebook";
-            providerId?: string;
-            providerRole?: string;
-            preferences?: Record<string, never>;
-        };
-        AuthResponse: {
-            user: components["schemas"]["AuthUserDto"];
-            accessToken?: string;
-            refreshToken?: string;
-            expiresIn?: number;
-            message?: string;
-            requiresMfa?: boolean;
-            requiresMfaSetup?: boolean;
-        };
-        Login: {
-            /** @description Email to send a 6-digit login code to */
-            email: string;
-        };
-        VerifyLoginCode: {
-            email: string;
-            /** @description 6-digit login code sent to email */
-            code: string;
-        };
-        VerifyEmail: {
-            emailVerificationCode: string;
-        };
-        DynamicClientRegistrationDto: {
-            /** @example My AI Agent */
-            client_name: string;
-            /**
-             * @example [
-             *       "https://agent.example.com/callback"
-             *     ]
-             */
-            redirect_uris: string[];
-            /**
-             * @example [
-             *       "authorization_code",
-             *       "refresh_token"
-             *     ]
-             */
-            grant_types?: string[];
-            /**
-             * @example [
-             *       "code"
-             *     ]
-             */
-            response_types?: string[];
-            /** @example agent-123 */
-            software_id?: string;
-            /** @example 1.0.0 */
-            software_version?: string;
-            /** @example https://example.com/logo.png */
-            logo_uri?: string;
-            /** @example https://example.com/tos */
-            tos_uri?: string;
-            /** @example https://example.com/policy */
-            policy_uri?: string;
-            /** @example https://example.com */
-            client_uri?: string;
-        };
-        DynamicClientRegistrationResponseDto: {
-            /** @example client-id-123 */
-            client_id: string;
-            /** @example client-secret-456 */
-            client_secret: string;
-            /** @example 1734567890 */
-            client_id_issued_at: number;
-            /** @example 0 */
-            client_secret_expires_at: number;
-            /** @example My AI Agent */
-            client_name: string;
-            /**
-             * @example [
-             *       "https://agent.example.com/callback"
-             *     ]
-             */
-            redirect_uris: string[];
-            /**
-             * @example [
-             *       "authorization_code",
-             *       "refresh_token"
-             *     ]
-             */
-            grant_types: string[];
-            /**
-             * @example [
-             *       "code"
-             *     ]
-             */
-            response_types: string[];
-            /** @example openid profile email */
-            scope: string;
-            /** @example client_secret_basic */
-            token_endpoint_auth_method: string;
-        };
-        GoogleLoginDto: {
-            /** @description The authorization code returned by Google */
-            code: string;
-            /** @description The redirect URI used in the initial authorization request */
-            redirect_uri: string;
-            /** @description The state parameter returned by Google (contains client_id) */
-            state: string;
-        };
-        GithubLoginDto: {
-            /** @description The authorization code returned by GitHub */
-            code: string;
-            /** @description The redirect URI used in the initial authorization request */
-            redirect_uri: string;
-            /** @description The state parameter returned by GitHub (contains client_id) */
-            state: string;
-        };
-        CreateOAuthClientDto: Record<string, never>;
-        UpdateOAuthClientDto: Record<string, never>;
         Plan: {
             /**
              * Plan type exposed in SDK
              * @example recurring
              * @enum {string}
              */
-            type: "recurring" | "one-time";
+            type: "recurring" | "one-time" | "usage-based";
             /**
              * Plan ID
              * @example 507f1f77bcf86cd799439011
@@ -367,6 +108,16 @@ interface components {
              * @example pln_1A2B3C4D
              */
             reference: string;
+            /**
+             * Plan name
+             * @example Starter
+             */
+            name?: string;
+            /**
+             * Plan description
+             * @example Best for teams getting started
+             */
+            description?: string;
             /**
              * Plan price in cents
              * @example 2999
@@ -409,8 +160,8 @@ interface components {
              */
             billingModel?: "pre-paid" | "post-paid";
             /**
-             * Price per usage unit
-             * @example 0.01
+             * Price per usage unit in cents (supports decimals, e.g. 0.1 = 1/10 cent)
+             * @example 0.1
              */
             pricePerUnit?: number;
             /**
@@ -436,11 +187,6 @@ interface components {
             features?: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier: boolean;
             /**
              * Whether payment is required
              * @example true
@@ -466,176 +212,76 @@ interface components {
             updatedAt: string;
         };
         CreatePlanRequest: {
-            /**
-             * Plan type exposed in SDK
-             * @example recurring
-             * @enum {string}
-             */
-            type?: "recurring" | "one-time";
-            /**
-             * Billing cycle (required for recurring/hybrid, optional for post-paid usage-based)
-             * @example monthly
-             * @enum {string}
-             */
+            name?: string;
+            description?: string;
+            /** @enum {string} */
+            type?: "recurring" | "usage-based" | "hybrid" | "one-time";
+            /** @enum {string} */
             billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan price in cents
-             * @example 2999
-             */
             price?: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             * @enum {string}
-             */
-            currency?: "USD" | "EUR" | "GBP" | "SEK" | "NOK" | "DKK" | "CAD" | "AUD" | "JPY" | "CHF" | "PLN" | "CZK" | "HUF" | "RON" | "BGN" | "HRK" | "RSD" | "MKD" | "BAM" | "ALL" | "ISK" | "TRY" | "RUB" | "UAH" | "BYN" | "MDL" | "GEL" | "AMD" | "AZN" | "KZT" | "KGS" | "TJS" | "TMT" | "UZS" | "MNT" | "CNY" | "KRW" | "THB" | "VND" | "IDR" | "MYR" | "SGD" | "PHP" | "INR" | "PKR" | "BDT" | "LKR" | "NPR" | "AFN" | "IRR" | "IQD" | "JOD" | "KWD" | "LBP" | "OMR" | "QAR" | "SAR" | "SYP" | "AED" | "YER" | "ILS" | "EGP" | "MAD" | "TND" | "DZD" | "LYD" | "SDG" | "ETB" | "KES" | "TZS" | "UGX" | "RWF" | "BIF" | "DJF" | "SOS" | "ERN" | "SLL" | "GMD" | "GNF" | "CVE" | "STN" | "AOA" | "ZAR" | "BWP" | "SZL" | "LSL" | "NAD" | "ZMW" | "ZWL" | "MZN" | "MWK" | "MGA" | "MUR" | "SCR" | "KMF" | "MVR";
-            /**
-             * Number of free units included
-             * @example 100
-             */
+            pricePerUnit?: number;
+            currency?: string;
+            /** @enum {string} */
+            billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
-            /**
-             * Usage limit for the meter
-             * @example 10000
-             */
             limit?: number;
-            /**
-             * Usage limits (shape varies by plan type)
-             * @example {
-             *       "maxTransactions": 1000
-             *     }
-             */
-            limits?: {
+            limits: {
                 [key: string]: unknown;
             };
-            /**
-             * Plan features (generic key/value, shape is provider-defined)
-             * @example {
-             *       "apiAccess": true,
-             *       "prioritySupport": false
-             *     }
-             */
-            features?: {
+            metadata: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier?: boolean;
-            /**
-             * Whether payment is required
-             * @example true
-             */
-            requiresPayment?: boolean;
-            /**
-             * Plan status
-             * @example active
-             * @enum {string}
-             */
+            features: {
+                [key: string]: unknown;
+            };
+            /** @enum {string} */
             status?: "active" | "inactive" | "archived";
-            /**
-             * Maximum number of active users
-             * @example 10
-             */
             maxActiveUsers?: number;
-            /**
-             * Access expiry in days
-             * @example 30
-             */
             accessExpiryDays?: number;
-            /** @description Additional metadata */
-            metadata?: {
-                [key: string]: unknown;
-            };
-            /**
-             * Whether this is the default plan
-             * @example false
-             */
             default?: boolean;
         };
         UpdatePlanRequest: {
-            /**
-             * Billing cycle
-             * @example monthly
-             * @enum {string}
-             */
+            name?: string;
+            description?: string;
+            /** @enum {string} */
             billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan price in cents
-             * @example 2999
-             */
             price?: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             */
+            pricePerUnit?: number;
             currency?: string;
-            /**
-             * Number of free units included
-             * @example 100
-             */
+            /** @enum {string} */
+            billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
-            /**
-             * Usage limit for the meter
-             * @example 10000
-             */
             limit?: number;
-            /**
-             * Usage limits (shape varies by plan type)
-             * @example {
-             *       "maxTransactions": 1000
-             *     }
-             */
-            limits?: {
+            limits: {
                 [key: string]: unknown;
             };
-            /**
-             * Plan features (generic key/value, shape is provider-defined)
-             * @example {
-             *       "apiAccess": true,
-             *       "prioritySupport": false
-             *     }
-             */
-            features?: {
+            features: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier?: boolean;
-            /**
-             * Whether payment is required
-             * @example true
-             */
-            requiresPayment?: boolean;
-            /**
-             * Plan status
-             * @example active
-             * @enum {string}
-             */
+            /** @enum {string} */
             status?: "active" | "inactive" | "archived";
-            /**
-             * Maximum number of active users
-             * @example 10
-             */
             maxActiveUsers?: number;
-            /**
-             * Access expiry in days
-             * @example 30
-             */
             accessExpiryDays?: number;
-            /** @description Additional metadata */
-            metadata?: {
+            metadata: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is the default plan
-             * @example false
-             */
             default?: boolean;
         };
+        CreateProductRequest: {
+            name: string;
+            description?: string;
+            imageUrl?: string;
+            productType?: string;
+            isMcpPay?: boolean;
+            config: {
+                fulfillmentType?: string;
+                validityPeriod?: number;
+                deliveryMethod?: string;
+            };
+            metadata: {
+                [key: string]: unknown;
+            };
+        };
         ProductConfigDto: {
             /**
              * Fulfillment type
@@ -653,36 +299,6 @@ interface components {
              */
             deliveryMethod?: string;
         };
-        CreateProductRequest: {
-            /**
-             * Product name
-             * @example AI Writing Assistant
-             */
-            name: string;
-            /**
-             * Product description
-             * @example AI-powered writing tool
-             */
-            description?: string;
-            /** @description URL to the product image */
-            imageUrl?: string;
-            /**
-             * Free-form product type defined by the provider
-             * @example Coding Assistant
-             */
-            productType?: string;
-            /**
-             * Whether this product uses MCP Pay proxy
-             * @default false
-             */
-            isMcpPay: boolean;
-            /** @description Product-specific configuration */
-            config?: components["schemas"]["ProductConfigDto"];
-            /** @description Arbitrary key-value metadata */
-            metadata?: {
-                [key: string]: unknown;
-            };
-        };
         SdkPlanResponse: {
             /**
              * Plan ID
@@ -730,8 +346,8 @@ interface components {
              */
             billingModel?: string;
             /**
-             * Price per unit in cents
-             * @example 10
+             * Price per usage unit in cents (supports decimals, e.g. 0.1 = 1/10 cent)
+             * @example 0.1
              */
             pricePerUnit?: number;
             /**
@@ -762,11 +378,6 @@ interface components {
             features?: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier: boolean;
             /**
              * Whether payment is required
              * @example true
@@ -848,184 +459,68 @@ interface components {
              *       "mcpServerReference": "mcp_ABC123",
              *       "mcpSubdomain": "acme-docs",
              *       "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
-             *       "originUrl": "https://origin.example.com/mcp",
-             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
-             *     }
-             */
-            mcp?: {
-                [key: string]: unknown;
-            };
-        };
-        UpdateProductRequest: {
-            /** @description Product name */
-            name?: string;
-            /** @description Product description */
-            description?: string;
-            /** @description URL to the product image */
-            imageUrl?: string;
-            /** @description Free-form product type defined by the provider */
-            productType?: string;
-            /**
-             * Product status
-             * @enum {string}
-             */
-            status?: "active" | "inactive" | "suspended";
-            /** @description Product-specific configuration */
-            config?: components["schemas"]["ProductConfigDto"];
-            /** @description Arbitrary key-value metadata */
-            metadata?: {
-                [key: string]: unknown;
-            };
-        };
-        McpBootstrapFreePlanConfig: {
-            /**
-             * Free plan display name override
-             * @example Starter
-             */
-            name?: string;
-            /**
-             * Included free units (default 1000)
-             * @example 500
-             */
-            freeUnits?: number;
-        };
-        McpBootstrapPaidPlanInput: {
-            /**
-             * Logical plan key (must not be "free")
-             * @example pro
-             */
-            key: string;
-            /**
-             * Plan display name
-             * @example Pro
-             */
-            name: string;
-            /**
-             * Plan price in cents (must be > 0)
-             * @example 2000
-             */
-            price: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             */
-            currency: string;
-            /**
-             * Billing cycle for recurring plans
-             * @example monthly
-             * @enum {string}
-             */
-            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan type
-             * @example recurring
-             * @enum {string}
-             */
-            type?: "recurring" | "one-time";
-            /**
-             * Included free units
-             * @example 1000
-             */
-            freeUnits?: number;
-            /**
-             * Meter id for usage tracking
-             * @example 67f90f1f1b1c9c0b8df0f001
-             */
-            meterId?: string;
-            /**
-             * Plan usage limit
-             * @example 10000
+             *       "originUrl": "https://origin.example.com/mcp",
+             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
+             *     }
              */
-            limit?: number;
-            /** @description Plan features */
-            features?: {
+            mcp?: {
                 [key: string]: unknown;
             };
         };
-        McpBootstrapToolInput: {
-            /**
-             * Tool name
-             * @example search_docs
-             */
-            name: string;
-            /**
-             * Tool description
-             * @example Search indexed documents
-             */
+        UpdateProductRequest: {
+            name?: string;
             description?: string;
-            /**
-             * If true, tool is publicly available without a plan
-             * @example false
-             */
-            noPlan?: boolean;
-            /**
-             * Direct plan IDs allowed for this tool
-             * @example [
-             *       "67f90f1f1b1c9c0b8df0f001"
-             *     ]
-             */
-            planIds?: string[];
-            /**
-             * Plan references allowed for this tool
-             * @example [
-             *       "pln_ABC123"
-             *     ]
-             */
-            planRefs?: string[];
-            /**
-             * Bootstrap plan keys allowed for this tool (for example free or starter_paid)
-             * @example [
-             *       "free"
-             *     ]
-             */
-            planKeys?: string[];
+            imageUrl?: string;
+            productType?: string;
+            /** @enum {string} */
+            status?: "active" | "inactive" | "suspended";
+            config: {
+                fulfillmentType?: string;
+                validityPeriod?: number;
+                deliveryMethod?: string;
+            };
+            metadata: {
+                [key: string]: unknown;
+            };
         };
-        McpBootstrapRequest: {
-            /**
-             * Product name (optional when derivable from origin MCP metadata)
-             * @example Acme MCP Toolkit
-             */
+        McpBootstrapDto: {
             name?: string;
-            /**
-             * Product description
-             * @example MCP toolkit with tiered access
-             */
             description?: string;
-            /** @description Product image URL */
             imageUrl?: string;
-            /**
-             * Free-form product type
-             * @example MCP Server
-             */
             productType?: string;
-            /**
-             * Origin MCP server URL (must be https)
-             * @example https://origin.example.com/mcp
-             */
+            /** Format: uri */
             originUrl: string;
-            /**
-             * Optional final MCP subdomain override (for example, value returned by bootstrap-subdomain-checks)
-             * @example acme-docs
-             */
             mcpDomain?: string;
-            /**
-             * Optional auth header name forwarded to origin server
-             * @example X-API-Key
-             */
             authHeaderName?: string;
-            /**
-             * Optional auth API key forwarded to origin server
-             * @example sk-origin-123
-             */
             authApiKey?: string;
-            /** @description Free plan config overrides. A free plan is always created; this just customizes name/freeUnits. */
-            freePlan?: components["schemas"]["McpBootstrapFreePlanConfig"];
-            /** @description Paid plan definitions requiring price + currency */
-            paidPlans?: components["schemas"]["McpBootstrapPaidPlanInput"][];
-            /** @description Tool to plan mapping configuration */
-            tools?: components["schemas"]["McpBootstrapToolInput"][];
-            /** @description Arbitrary product metadata */
-            metadata?: {
+            plans?: {
+                key: string;
+                name: string;
+                price: number;
+                currency: string;
+                /** @enum {string} */
+                billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
+                /** @enum {string} */
+                type?: "recurring" | "one-time" | "usage-based";
+                pricePerUnit?: number;
+                /** @enum {string} */
+                billingModel?: "pre-paid" | "post-paid";
+                freeUnits?: number;
+                meterId?: string;
+                limit?: number;
+                features?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            tools?: {
+                name: string;
+                description?: string;
+                noPlan?: boolean;
+                planIds?: string[];
+                planRefs?: string[];
+                planKeys?: string[];
+            }[];
+            metadata: {
                 [key: string]: unknown;
             };
         };
@@ -1070,130 +565,138 @@ interface components {
                 description?: string;
             }[];
         };
-        McpBootstrapPreviewResult: {
-            /** @description Discovered tools from the origin MCP server */
-            discoveredTools: {
-                name?: string;
-                description?: string;
+        ConfigureMcpPlansDto: {
+            plans?: {
+                key: string;
+                name: string;
+                price: number;
+                currency: string;
+                /** @enum {string} */
+                billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
+                /** @enum {string} */
+                type?: "recurring" | "one-time" | "usage-based";
+                pricePerUnit?: number;
+                /** @enum {string} */
+                billingModel?: "pre-paid" | "post-paid";
+                freeUnits?: number;
+                meterId?: string;
+                limit?: number;
+                features?: {
+                    [key: string]: unknown;
+                };
             }[];
-            /** @description Validation status for the provided bootstrap payload */
-            validation: {
-                valid?: boolean;
-                errors?: components["schemas"]["McpBootstrapPreviewValidationError"][];
+            toolMapping?: {
+                name: string;
+                planKeys: string[];
+            }[];
+        };
+        ConfigureMcpPlansResult: {
+            /** @description Updated product */
+            product: components["schemas"]["SdkProductResponse"];
+            /** @description Updated MCP server identity */
+            mcpServer: {
+                [key: string]: unknown;
+            };
+            /** @description Resolved plan mapping by key (includes existing free plan) */
+            planMap: {
+                [key: string]: unknown;
             };
+        };
+        CloneProductDto: {
+            name?: string;
+        };
+        CreateUsageRequest: {
+            customerId: string;
             /**
-             * Product name derived from origin MCP metadata or hostname fallback
-             * @example acme-origin-mcp
+             * @default api_call
+             * @enum {string}
              */
-            derivedName?: string;
+            actionType: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
+            /** @default 1 */
+            units: number;
             /**
-             * Product description derived from origin server instructions
-             * @example MCP toolkit for document retrieval and summarization.
+             * @default success
+             * @enum {string}
              */
-            derivedDescription?: string;
-            /** @description Source of derived metadata */
-            metadataSource: {
-                /** @enum {string} */
-                name?: "request" | "origin" | "hostname";
-                /** @enum {string} */
-                description?: "request" | "instructions" | "none";
+            outcome: "success" | "paywall" | "fail";
+            productReference?: string;
+            purchaseReference?: string;
+            description?: string;
+            errorMessage?: string;
+            metadata: {
+                [key: string]: unknown;
             };
-            /** @description Suggested default tool-to-plan mapping for UI review */
-            suggestedMapping: {
-                name?: string;
+            duration?: number;
+            /** Format: date-time */
+            timestamp: string;
+            idempotencyKey?: string;
+        };
+        BulkCreateUsageRequest: {
+            events: {
+                customerId: string;
+                /**
+                 * @default api_call
+                 * @enum {string}
+                 */
+                actionType: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
+                /** @default 1 */
+                units: number;
+                /**
+                 * @default success
+                 * @enum {string}
+                 */
+                outcome: "success" | "paywall" | "fail";
+                productReference?: string;
+                purchaseReference?: string;
                 description?: string;
-                planKey?: string;
+                errorMessage?: string;
+                metadata?: {
+                    [key: string]: unknown;
+                };
+                duration?: number;
+                /** Format: date-time */
+                timestamp: string;
+                idempotencyKey?: string;
             }[];
         };
-        RecordMeterEventDto: {
-            /**
-             * Meter name to record against
-             * @example requests
-             */
+        RecordMeterEventZodDto: {
             meterName: string;
-            /**
-             * Customer reference
-             * @example cus_ABC123
-             */
             customerId: string;
-            /**
-             * Numeric value (default 1)
-             * @default 1
-             * @example 1
-             */
-            value: number;
-            /**
-             * Arbitrary key-value tags
-             * @example {
-             *       "endpoint": "/api/v1/search",
-             *       "region": "us-east-1"
-             *     }
-             */
-            properties?: {
+            value?: number;
+            properties: {
                 [key: string]: unknown;
             };
-            /** @description Product ID to scope the usage event to */
             productId?: string;
-            /** @description Product reference to scope the usage event to */
             productReference?: string;
-            /** @description ISO 8601 timestamp (defaults to now) */
             timestamp?: string;
         };
-        RecordBulkMeterEventsDto: {
-            /** @description Array of events to record */
-            events: components["schemas"]["RecordMeterEventDto"][];
-        };
-        CreateCustomerSessionRequest: {
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            customerRef: string;
-            /**
-             * Optional product reference or ID to scope the customer manage page to a single product.
-             * @example prd_1a2b3c4d5e6f
-             */
-            productRef?: string;
-        };
-        CustomerSessionResponse: {
-            /**
-             * Customer session ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
-            /**
-             * Public session ID used in customer URL
-             * @example e3f1c2d4b6a89f001122334455667788
-             */
-            sessionId: string;
-            /**
-             * Session status
-             * @example active
-             */
-            status: string;
-            /**
-             * Customer URL to open the customer page
-             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
-             */
-            customerUrl: string;
+        RecordBulkMeterEventsZodDto: {
+            events: {
+                meterName: string;
+                customerId: string;
+                value?: number;
+                properties?: {
+                    [key: string]: unknown;
+                };
+                productId?: string;
+                productReference?: string;
+                timestamp?: string;
+            }[];
         };
         CreateCustomerRequest: {
-            /**
-             * Customer email address (required)
-             * @example customer@example.com
-             */
+            /** Format: email */
             email: string;
-            /**
-             * Customer full name (optional)
-             * @example John Doe
-             */
             name?: string;
-            /**
-             * External reference ID from your auth system to map this customer to an auth user (optional)
-             * @example auth_user_12345
-             */
+            telephone?: string;
+            metadata: {
+                [key: string]: unknown;
+            };
             externalRef?: string;
         };
+        CreateCustomerSessionRequest: {
+            customerRef: string;
+            productRef?: string;
+        };
         PurchaseInfo: {
             /**
              * Purchase reference
@@ -1221,15 +724,25 @@ interface components {
              */
             startDate: string;
             /**
-             * Amount paid in original currency (in cents)
+             * Amount in USD cents (normalised for aggregation)
              * @example 9900
              */
             amount: number;
             /**
-             * Currency code
-             * @example USD
+             * Original amount in the payment currency (minor units)
+             * @example 7500
+             */
+            originalAmount?: number;
+            /**
+             * ISO 4217 currency code of the customer-facing charge
+             * @example GBP
              */
             currency: string;
+            /**
+             * Exchange rate from original currency to USD
+             * @example 1.32
+             */
+            exchangeRate?: number;
             /**
              * End date of purchase
              * @example 2025-11-27T10:00:00Z
@@ -1320,15 +833,7 @@ interface components {
             updatedAt: string;
         };
         UserInfoRequest: {
-            /**
-             * Customer reference
-             * @example cus_3C4D5E6F
-             */
             customerRef: string;
-            /**
-             * Product reference
-             * @example prd_1A2B3C4D
-             */
             productRef: string;
         };
         UserInfoUserDto: {
@@ -1350,169 +855,60 @@ interface components {
             remaining: number;
             /**
              * Meter ObjectId reference
-             * @example 507f1f77bcf86cd799439011
-             */
-            meterId?: string;
-            /** @example 25 */
-            percentUsed?: number | null;
-        };
-        UserInfoPlanDto: {
-            /** @example pln_2B3C4D5E */
-            reference: string;
-            /**
-             * Price in minor currency units (e.g. cents)
-             * @example 2999
-             */
-            price: number;
-            /** @example USD */
-            currency: string;
-            /** @example recurring */
-            type: string;
-            /** @example monthly */
-            billingCycle?: string | null;
-            features?: string[] | null;
-            limits?: {
-                [key: string]: unknown;
-            } | null;
-        };
-        UserInfoPurchaseDto: {
-            /** @example pur_1A2B3C4D */
-            reference: string;
-            /** @example active */
-            status: string;
-            /** @example My API Product */
-            productName: string;
-            /** @example recurring */
-            planType: string;
-            /** @example 2025-10-27T10:00:00Z */
-            startDate?: string | null;
-            /** @example 2025-11-27T10:00:00Z */
-            endDate?: string | null;
-            usage?: components["schemas"]["UserInfoUsageDto"];
-            plan?: components["schemas"]["UserInfoPlanDto"];
-        };
-        UserInfoResponse: {
-            /**
-             * Human-readable status summary
-             * @example Active subscription: My API Product (25% usage consumed)
-             */
-            status: string;
-            /**
-             * Customer portal session URL
-             * @example https://solvapay.com/customer/manage?id=abc123
-             */
-            verifyUrl?: string | null;
-            user?: components["schemas"]["UserInfoUserDto"];
-            purchase?: components["schemas"]["UserInfoPurchaseDto"];
-        };
-        McpToolDto: {
-            /**
-             * Tool name
-             * @example search_documents
-             */
-            name: string;
-            /**
-             * Plan IDs that grant access to this tool
-             * @example [
-             *       "pln_abc123"
-             *     ]
-             */
-            planIds?: string[];
-            /**
-             * If true, the tool is unprotected (no purchase check or usage tracking)
-             * @example false
-             */
-            noPlan?: boolean;
-            /**
-             * Human-readable tool description
-             * @example Search indexed documents
-             */
-            description?: string;
-            /**
-             * Whether this is a virtual platform tool handled by SolvaPay
-             * @example false
-             */
-            isVirtual?: boolean;
-        };
-        McpServerDto: {
-            /**
-             * Server ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id?: string;
-            /**
-             * Unique server reference
-             * @example mcp_abc123
-             */
-            reference?: string;
-            /**
-             * Domain slug used to derive the MCP endpoint subdomain
-             * @example my-mcp-server
-             */
-            name: string;
-            /**
-             * URL-safe subdomain derived from name
-             * @example my-mcp-server
-             */
-            subdomain: string;
-            /**
-             * SolvaPay proxy URL that MCP clients connect to
-             * @example https://mytelescope.mcp.solvapay.com/mcp
-             */
-            mcpProxyUrl?: string;
-            /**
-             * Origin URL of the actual MCP server
-             * @example https://origin.example.com/mcp
-             */
-            url: string;
-            /**
-             * Avatar image URL
-             * @example https://example.com/avatar.png
-             */
-            avatarUrl?: string;
-            /** @description Registered tools for this server */
-            tools?: components["schemas"]["McpToolDto"][];
-            /**
-             * Default plan ID for tool access gating. Must belong to the linked product and be a free-tier plan (isFreeTier=true or price=0).
-             * @example pln_default
-             */
-            defaultPlanId?: string;
-            /**
-             * Associated product ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            productId?: string;
-            /**
-             * Server status
-             * @example active
-             * @enum {string}
-             */
-            status?: "active" | "inactive" | "suspended";
-            /**
-             * Provider ID that owns this server
-             * @example 507f1f77bcf86cd799439011
-             */
-            providerId: string;
-            /**
-             * Custom auth header name for origin requests
-             * @example X-API-Key
+             * @example 507f1f77bcf86cd799439011
              */
-            authHeaderName?: string;
+            meterId?: string;
+            /** @example 25 */
+            percentUsed?: number | null;
+        };
+        UserInfoPlanDto: {
+            /** @example pln_2B3C4D5E */
+            reference: string;
             /**
-             * Whether an auth API key is configured
-             * @example true
+             * Price in minor currency units (e.g. cents)
+             * @example 2999
              */
-            hasAuthApiKey?: boolean;
+            price: number;
+            /** @example USD */
+            currency: string;
+            /** @example recurring */
+            type: string;
+            /** @example monthly */
+            billingCycle?: string | null;
+            features?: string[] | null;
+            limits?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        UserInfoPurchaseDto: {
+            /** @example pur_1A2B3C4D */
+            reference: string;
+            /** @example active */
+            status: string;
+            /** @example My API Product */
+            productName: string;
+            /** @example recurring */
+            planType: string;
+            /** @example 2025-10-27T10:00:00Z */
+            startDate?: string | null;
+            /** @example 2025-11-27T10:00:00Z */
+            endDate?: string | null;
+            usage?: components["schemas"]["UserInfoUsageDto"];
+            plan?: components["schemas"]["UserInfoPlanDto"];
+        };
+        UserInfoResponse: {
             /**
-             * Total number of tool-call transactions
-             * @example 42
+             * Human-readable status summary
+             * @example Active subscription: My API Product (25% usage consumed)
              */
-            totalTransactions?: number;
+            status: string;
             /**
-             * Current balance in cents
-             * @example 1500
+             * Customer portal session URL
+             * @example https://solvapay.com/customer/manage?id=abc123
              */
-            balance?: number;
+            verifyUrl?: string | null;
+            user?: components["schemas"]["UserInfoUserDto"];
+            purchase?: components["schemas"]["UserInfoPurchaseDto"];
         };
         PlanSnapshotDto: {
             /**
@@ -1564,8 +960,8 @@ interface components {
              */
             freeUnits?: number;
             /**
-             * Price per usage unit in cents
-             * @example 10
+             * Price per usage unit in cents (supports decimals, e.g. 0.1 = 1/10 cent)
+             * @example 0.1
              */
             pricePerUnit?: number;
         };
@@ -1632,23 +1028,33 @@ interface components {
              * @example API Gateway Manager
              */
             productName?: string;
-            /** @description Plan snapshot at time of purchase */
-            planSnapshot: components["schemas"]["PlanSnapshotDto"];
+            /** @description Plan snapshot at time of purchase (null for credit topups) */
+            planSnapshot?: components["schemas"]["PlanSnapshotDto"];
             /**
              * Purchase status
              * @example active
              */
             status: string;
             /**
-             * Amount in cents
+             * Amount in USD cents (normalised for aggregation)
              * @example 9900
              */
             amount: number;
             /**
-             * Currency code
-             * @example USD
+             * Original amount in the payment currency (cents/pence)
+             * @example 10000
+             */
+            originalAmount?: number;
+            /**
+             * Original payment currency code
+             * @example GBP
              */
             currency: string;
+            /**
+             * Exchange rate from original currency to USD
+             * @example 1.3082
+             */
+            exchangeRate?: number;
             /** @description Start date */
             startDate: string;
             /** @description End date */
@@ -1671,46 +1077,52 @@ interface components {
             nextBillingDate?: string;
             /** @description Auto-renew enabled */
             autoRenew?: boolean;
-            /** @description Whether this is a free tier purchase */
-            isFreeTier?: boolean;
             /** @description Cancelled at */
             cancelledAt?: string;
             /** @description Cancellation reason */
             cancellationReason?: string;
+            /** @description Arbitrary metadata attached to the purchase */
+            metadata?: {
+                [key: string]: unknown;
+            };
             /** @description Created at */
             createdAt: string;
         };
-        CancelPurchaseRequest: {
-            /** @description Reason for cancellation */
-            reason?: string;
-        };
         CheckLimitRequest: {
-            /**
-             * Customer reference identifier
-             * @example cus_3C4D5E6F
-             */
             customerRef: string;
-            /**
-             * Product reference identifier
-             * @example prd_1A2B3C4D
-             */
             productRef: string;
-            /**
-             * Plan reference to pre-select when creating a checkout session. If provided and the customer needs to purchase, the checkout page skips plan selection and shows the payment form directly.
-             * @example pln_2B3C4D5E
-             */
             planRef?: string;
-            /**
-             * Canonical usage meter name used for limit checks (for example: requests, tokens).
-             * @example requests
-             */
             meterName?: string;
-            /**
-             * Usage type alias for meterName. If both are provided, meterName takes precedence.
-             * @example requests
-             */
             usageType?: string;
         };
+        LimitPlanItemDto: {
+            reference: string;
+            name?: string;
+            type: string;
+            /** @description Price in smallest currency unit (e.g. cents) */
+            price: number;
+            currency: string;
+            requiresPayment: boolean;
+            freeUnits?: number;
+            /** @description Price per usage unit in mils (usage-based plans) */
+            pricePerUnit?: number;
+            billingModel?: string;
+            billingCycle?: string;
+        };
+        LimitBalanceDto: {
+            /** @description Credit balance in mils */
+            creditBalance: number;
+            /** @description Price per usage unit in mils */
+            pricePerUnit: number;
+            currency: string;
+            /** @description Estimated whole units remaining from prepaid balance at current pricePerUnit */
+            remainingUnits?: number;
+        };
+        LimitProductBriefDto: {
+            id?: string;
+            reference: string;
+            name?: string;
+        };
         LimitResponse: {
             /**
              * Whether the customer is within their usage limits
@@ -1737,213 +1149,22 @@ interface components {
              * @example requests
              */
             meterName?: string;
-        };
-        ExecuteAnalyticsQuery: Record<string, never>;
-        ExecuteMultipleQueries: Record<string, never>;
-        CreateWebhookEndpointDto: {
-            /**
-             * Webhook endpoint URL
-             * @example https://example.com/webhook
-             */
-            url: string;
-            /**
-             * Webhook endpoint description
-             * @example Production webhook
-             */
-            description?: string;
-        };
-        UpdateWebhookEndpointDto: {
-            /**
-             * Webhook endpoint URL
-             * @example https://example.com/webhook
-             */
-            url?: string;
-            /**
-             * Webhook endpoint description
-             * @example Updated webhook
-             */
-            description?: string;
-        };
-        UpdateThemePreferenceDto: {
-            /**
-             * Selected UI theme mode
-             * @example dark
-             * @enum {string}
-             */
-            mode: "light" | "dark";
-        };
-        ThemeModeColorsDto: {
-            /**
-             * Page background color
-             * @example #f7f7f8
-             */
-            background?: string;
-            /**
-             * Card/surface background color
-             * @example #ffffff
-             */
-            surface?: string;
-            /**
-             * Primary text color
-             * @example #181818
-             */
-            text?: string;
-            /**
-             * Secondary/muted text color
-             * @example #5c5c5c
-             */
-            secondary?: string;
-        };
-        ThemeOverridesDto: {
-            /** @description Light mode color overrides */
-            light?: components["schemas"]["ThemeModeColorsDto"];
-            /** @description Dark mode color overrides */
-            dark?: components["schemas"]["ThemeModeColorsDto"];
-        };
-        UpdateBrandThemeDto: {
-            /**
-             * Logo image URL displayed in hosted page headers
-             * @example /ui/files/download/provider-assets/provider-123/logos/logo.png
-             */
-            logo?: string;
-            /**
-             * Provider's brand name displayed on hosted pages
-             * @example Acme Corp
-             */
-            brandName: string;
-            /**
-             * Primary/accent color in hex format
-             * @example #3182ce
-             */
-            primaryColor: string;
-            /**
-             * Font family for hosted pages
-             * @default Inter
-             * @example Inter
-             */
-            fontFamily: string;
-            /**
-             * Base font size
-             * @default 16px
-             * @example 16px
-             */
-            fontSize: string;
-            /** @description Per-mode color overrides for light and dark themes */
-            themes?: components["schemas"]["ThemeOverridesDto"];
-        };
-        CreatePreregistrationDto: {
-            /** @example jane@company.com */
-            email: string;
-            /** @example Jane Smith */
-            fullName: string;
-            /** @example Acme Corp */
-            companyName: string;
-            /** @example SaaS */
-            businessType?: string;
-            /** @example Purchase billing for our platform */
-            useCase?: string;
-            customFields?: {
-                [key: string]: string;
-            };
-        };
-        RevenueDataDto: {
-            grossRevenue: number;
-            refunds: number;
-            platformFees: number;
-            netRevenue: number;
-            costOfRevenue: number;
-            grossProfit?: Record<string, never> | null;
-            grossMargin?: Record<string, never> | null;
-            recognisedRevenue: number;
-            deferredRevenue: number;
-            hasCostTransactions: boolean;
-        };
-        BalanceDataDto: {
-            openingBalance: number;
-            paymentsReceived: number;
-            refundsIssued: number;
-            platformFees: number;
-            costsPaid: number;
-            closingBalance: number;
-            netChange: number;
-        };
-        MonthlyFinancialsDto: {
-            month: string;
-            revenue: components["schemas"]["RevenueDataDto"];
-            balance: components["schemas"]["BalanceDataDto"];
-        };
-        RevenueResponseDto: {
-            current: components["schemas"]["RevenueDataDto"];
-            prior: components["schemas"]["RevenueDataDto"];
-            monthly: components["schemas"]["MonthlyFinancialsDto"][];
-            periodLabel: string;
-            /**
-             * ISO 4217 currency code
-             * @example SEK
-             */
-            currency: string;
-        };
-        BalanceResponseDto: {
-            current: components["schemas"]["BalanceDataDto"];
-            monthly: components["schemas"]["MonthlyFinancialsDto"][];
-            periodLabel: string;
-            /**
-             * ISO 4217 currency code
-             * @example SEK
-             */
-            currency: string;
-        };
-        ProductRevenueRowDto: {
-            productRef: string;
-            productName: string;
-            productType: string;
-            revenue: number;
-            costs: number;
-            grossProfit?: Record<string, never> | null;
-            share: number;
-            estimatedARR: number;
-            transactionCount: number;
-        };
-        TopProductDto: {
-            name: string;
-            revenue: number;
-        };
-        RevenueByProductResponseDto: {
-            products: components["schemas"]["ProductRevenueRowDto"][];
-            activeProductCount: number;
-            totalMRR: number;
-            topProduct?: components["schemas"]["TopProductDto"] | null;
-            /**
-             * ISO 4217 currency code
-             * @example SEK
-             */
-            currency: string;
-        };
-        LedgerEntryDto: {
-            date: string;
-            reference: string;
-            description: string;
-            type: string;
-            direction: string;
-            account: string;
-            debit: number;
-            credit: number;
-            status: string;
-        };
-        LedgerResponseDto: {
-            entries: components["schemas"]["LedgerEntryDto"][];
-            total: number;
-            totalCredit: number;
-            totalDebit: number;
-            /**
-             * ISO 4217 currency code
-             * @example SEK
-             */
-            currency: string;
-        };
-        /** @description Auto-generated fallback schema for unresolved reference: McpBootstrapPreviewValidationError */
-        McpBootstrapPreviewValidationError: {
-            [key: string]: unknown;
+            /** @description Credit balance in mils (for pre-paid usage-based plans) */
+            creditBalance?: number;
+            /** @description Price per usage unit in mils (for pre-paid usage-based plans) */
+            pricePerUnit?: number;
+            /** @description ISO 4217 currency code for credit fields */
+            currency?: string;
+            /** @description True when the customer must activate a priced default plan before usage is allowed */
+            activationRequired?: boolean;
+            /** @description Active plans on the product available for activation or checkout */
+            plans?: components["schemas"]["LimitPlanItemDto"][];
+            /** @description Prepaid usage balance context when the default plan is usage-based */
+            balance?: components["schemas"]["LimitBalanceDto"];
+            /** @description Product the limit check applies to */
+            product?: components["schemas"]["LimitProductBriefDto"];
+            /** @description Customer portal confirmation URL when activation is required (fallback when not starting checkout) */
+            confirmationUrl?: string;
         };
     };
     responses: never;
@@ -1991,28 +1212,7 @@ interface operations {
         /** @description Payment intent creation data */
         requestBody: {
             content: {
-                "application/json": {
-                    /**
-                     * Plan reference to purchase
-                     * @example pln_2b3c4d5e6f7g
-                     */
-                    planRef: string;
-                    /**
-                     * Product reference that owns the plan
-                     * @example prd_1A2B3C4D
-                     */
-                    productRef: string;
-                    /**
-                     * Customer reference identifier
-                     * @example cus_3c4d5e6f7g8h
-                     */
-                    customerReference: string;
-                    /**
-                     * Name of the pricing tier to purchase (for plans with pricingTiers). If not specified, uses the plan base price.
-                     * @example Pro
-                     */
-                    pricingTier?: string;
-                };
+                "application/json": components["schemas"]["CreatePaymentIntentDto"];
             };
         };
         responses: {
@@ -2081,23 +1281,7 @@ interface operations {
         /** @description Payment processing data */
         requestBody: {
             content: {
-                "application/json": {
-                    /**
-                     * Product reference that owns the plan
-                     * @example prd_123
-                     */
-                    productRef: string;
-                    /**
-                     * Customer reference identifier
-                     * @example cus_456
-                     */
-                    customerRef: string;
-                    /**
-                     * Plan reference - helps determine if payment is for purchase
-                     * @example pln_789
-                     */
-                    planRef?: string;
-                };
+                "application/json": components["schemas"]["ProcessPaymentIntentDto"];
             };
         };
         responses: {
@@ -2496,7 +1680,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["McpBootstrapRequest"];
+                "application/json": components["schemas"]["McpBootstrapDto"];
             };
         };
         responses: {
@@ -2518,6 +1702,47 @@ interface operations {
             };
         };
     };
+    ProductSdkController_configureMcpPlans: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ConfigureMcpPlansDto"];
+            };
+        };
+        responses: {
+            /** @description MCP plans configured successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ConfigureMcpPlansResult"];
+                };
+            };
+            /** @description Invalid MCP plans request or product is not MCP-enabled */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     ProductSdkController_cloneProduct: {
         parameters: {
             query?: never;
@@ -2528,7 +1753,11 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CloneProductDto"];
+            };
+        };
         responses: {
             /** @description Product cloned successfully */
             201: {
@@ -2557,44 +1786,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": {
-                    /**
-                     * Customer identifier
-                     * @example cus_3C4D5E6F
-                     */
-                    customerId: string;
-                    /**
-                     * Action type (default: api_call)
-                     * @example api_call
-                     * @enum {string}
-                     */
-                    actionType?: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
-                    /**
-                     * Number of usage units (default: 1)
-                     * @example 1
-                     */
-                    units?: number;
-                    /** @description Product reference */
-                    productReference?: string;
-                    /** @description Purchase reference */
-                    purchaseReference?: string;
-                    /**
-                     * Outcome (default: success)
-                     * @enum {string}
-                     */
-                    outcome?: "success" | "paywall" | "fail";
-                    /** @description Arbitrary event properties */
-                    metadata?: {
-                        [key: string]: unknown;
-                    };
-                    /**
-                     * Format: date-time
-                     * @description ISO 8601 timestamp (defaults to now)
-                     */
-                    timestamp?: string;
-                    /** @description Unique key to prevent duplicate recording (max 256 chars) */
-                    idempotencyKey?: string;
-                };
+                "application/json": components["schemas"]["CreateUsageRequest"];
             };
         };
         responses: {
@@ -2630,24 +1822,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": {
-                    events: {
-                        customerId: string;
-                        /** @enum {string} */
-                        actionType?: "transaction" | "api_call" | "hour" | "email" | "storage" | "custom";
-                        units?: number;
-                        productReference?: string;
-                        purchaseReference?: string;
-                        /** @enum {string} */
-                        outcome?: "success" | "paywall" | "fail";
-                        metadata?: {
-                            [key: string]: unknown;
-                        };
-                        /** Format: date-time */
-                        timestamp?: string;
-                        idempotencyKey?: string;
-                    }[];
-                };
+                "application/json": components["schemas"]["BulkCreateUsageRequest"];
             };
         };
         responses: {
@@ -2676,7 +1851,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["RecordMeterEventDto"];
+                "application/json": components["schemas"]["RecordMeterEventZodDto"];
             };
         };
         responses: {
@@ -2710,7 +1885,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["RecordBulkMeterEventsDto"];
+                "application/json": components["schemas"]["RecordBulkMeterEventsZodDto"];
             };
         };
         responses: {
@@ -3167,17 +2342,12 @@ interface operations {
  * Types related to the SolvaPay API client and backend communication.
  */
 
-type UsageMeterType = 'requests' | 'tokens';
-type CheckLimitsRequest = components['schemas']['CheckLimitRequest'] & {
-    meterName?: string;
-    usageType?: UsageMeterType;
-};
+type CheckLimitsRequest = components['schemas']['CheckLimitRequest'];
 /**
- * Extended LimitResponse with plan field
+ * Extended LimitResponse with SDK-added plan field
  */
 type LimitResponseWithPlan = components['schemas']['LimitResponse'] & {
     plan: string;
-    meterName?: string;
 };
 /**
  * Extended CustomerResponse with proper field mapping
@@ -3216,46 +2386,10 @@ interface ProcessPaymentResult {
     oneTimePurchase?: OneTimePurchaseInfo;
     status: 'completed';
 }
-interface McpBootstrapFreePlanConfig {
-    name?: string;
-    freeUnits?: number;
-}
-interface McpBootstrapPaidPlanInput {
-    key: string;
-    name: string;
-    /** Price in cents (e.g. 2000 = $20.00) */
-    price: number;
-    currency: string;
-    billingCycle?: 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';
-    type?: 'recurring' | 'one-time';
-    freeUnits?: number;
-    meterId?: string;
-    limit?: number;
-    features?: Record<string, unknown>;
-}
-interface ToolPlanMappingInput {
-    name: string;
-    description?: string;
-    noPlan?: boolean;
-    planIds?: string[];
-    planRefs?: string[];
-    planKeys?: string[];
-}
-interface McpBootstrapRequest {
-    name?: string;
-    description?: string;
-    imageUrl?: string;
-    productType?: string;
-    originUrl: string;
-    /** Optional token combined with provider name to derive the final MCP subdomain. */
-    mcpDomain?: string;
-    authHeaderName?: string;
-    authApiKey?: string;
-    freePlan?: McpBootstrapFreePlanConfig;
-    paidPlans?: McpBootstrapPaidPlanInput[];
-    tools?: ToolPlanMappingInput[];
-    metadata?: Record<string, unknown>;
-}
+type McpBootstrapPlanInput = NonNullable<components['schemas']['McpBootstrapDto']['plans']>[number];
+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: {
@@ -3277,6 +2411,23 @@ interface McpBootstrapResponse {
         description?: string;
     }>;
 }
+type ConfigureMcpPlansRequest = components['schemas']['ConfigureMcpPlansDto'];
+interface ConfigureMcpPlansResponse {
+    product: components['schemas']['SdkProductResponse'];
+    mcpServer: {
+        id?: string;
+        reference?: string;
+        subdomain?: string;
+        mcpProxyUrl?: string;
+        url: string;
+        defaultPlanId?: string;
+    };
+    planMap: Record<string, {
+        id: string;
+        reference: string;
+        name?: string;
+    }>;
+}
 /**
  * SolvaPay API Client Interface
  *
@@ -3318,6 +2469,7 @@ interface SolvaPayClient {
         name: string;
     }>;
     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?: {
@@ -3326,29 +2478,11 @@ interface SolvaPayClient {
         reference: string;
         name: string;
     }>;
-    listPlans?(productRef: string): Promise<Array<{
-        reference: string;
-        price?: number;
-        currency?: string;
-        interval?: string;
-        isFreeTier?: boolean;
-        freeUnits?: number;
-        measures?: string;
-        limit?: number;
-        pricePerUnit?: number;
-        billingModel?: string;
-        metadata?: Record<string, unknown>;
-        [key: string]: unknown;
-    }>>;
+    listPlans?(productRef: string): Promise<components['schemas']['Plan'][]>;
     createPlan?(params: components['schemas']['CreatePlanRequest'] & {
         productRef: string;
-    }): Promise<{
-        reference: string;
-    }>;
-    updatePlan?(productRef: string, planRef: string, params: Partial<components['schemas']['CreatePlanRequest']>): Promise<{
-        reference: string;
-        [key: string]: unknown;
-    }>;
+    }): 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;
@@ -3375,7 +2509,7 @@ interface SolvaPayClient {
         customerRef: string;
         productRef: string;
     }): Promise<components['schemas']['UserInfoResponse']>;
-    createCheckoutSession(params: operations['CheckoutSessionSdkController_createCheckoutSession']['requestBody']['content']['application/json']): Promise<components['schemas']['CheckoutSessionResponse']>;
+    createCheckoutSession(params: operations['CheckoutSessionSdkController_createCheckoutSession']['requestBody']['content']['application/json']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
     createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
 }
 
@@ -3384,6 +2518,10 @@ interface SolvaPayClient {
  *
  * Types related to paywall protection, limits, and gating functionality.
  */
+
+type LimitPlanSummary = components['schemas']['LimitPlanItemDto'];
+type LimitActivationBalance = components['schemas']['LimitBalanceDto'];
+type LimitActivationProduct = components['schemas']['LimitProductBriefDto'];
 /**
  * Arguments passed to protected handlers
  */
@@ -3402,14 +2540,29 @@ interface PaywallMetadata {
     usageType?: 'requests' | 'tokens';
 }
 /**
- * Structured content for paywall errors
+ * Structured content for paywall errors (MCP structuredContent and manual handling).
  */
-interface PaywallStructuredContent {
+type PaywallStructuredContent = {
     kind: 'payment_required';
+    /** Product ref from paywall metadata (or env default) */
     product: string;
     checkoutUrl: string;
     message: string;
-}
+} | {
+    kind: 'activation_required';
+    /** Product ref from paywall metadata (or env default) */
+    product: string;
+    message: string;
+    /**
+     * Best URL for completing purchase or confirmation; mirrors confirmationUrl when present.
+     */
+    checkoutUrl: string;
+    confirmationUrl?: string;
+    plans?: LimitPlanSummary[];
+    balance?: LimitActivationBalance;
+    /** Rich product context from checkLimits (name, ref, provider slug/id) */
+    productDetails?: LimitActivationProduct;
+};
 /**
  * MCP tool result with optional paywall information
  */
@@ -3930,14 +3083,17 @@ interface SolvaPay {
         customerRef: string;
         productRef: string;
         planRef?: string;
-        meterName?: 'requests' | 'tokens';
-        usageType?: 'requests' | 'tokens';
+        meterName?: string;
+        usageType?: string;
     }): Promise<{
         withinLimits: boolean;
         remaining: number;
         plan: string;
         checkoutUrl?: string;
         meterName?: string;
+        creditBalance?: number;
+        pricePerUnit?: number;
+        currency?: string;
     }>;
     /**
      * Track usage for a customer action.
@@ -4001,6 +3157,7 @@ interface SolvaPay {
     createCustomer(params: {
         email: string;
         name?: string;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         customerRef: string;
     }>;
@@ -4102,6 +3259,13 @@ interface SolvaPay {
      * fast setup flows where you want one call for product + plans + MCP config.
      */
     bootstrapMcpProduct(params: McpBootstrapRequest): Promise<McpBootstrapResponse>;
+    /**
+     * Configure MCP plans and tool mappings for an existing MCP product.
+     *
+     * This helper wraps the backend MCP plans endpoint and supports adding/removing
+     * paid plans as well as remapping tool access.
+     */
+    configureMcpPlans(productRef: string, params: ConfigureMcpPlansRequest): Promise<ConfigureMcpPlansResponse>;
     /**
      * Get virtual tool definitions with bound handlers for MCP server integration.
      *
@@ -4309,6 +3473,8 @@ declare class PaywallError extends Error {
      */
     constructor(message: string, structuredContent: PaywallStructuredContent);
 }
+/** JSON body shape for HTTP adapters and MCP text content (stable fields for clients). */
+declare function paywallErrorToClientPayload(error: PaywallError): Record<string, unknown>;
 
 /**
  * MCP OAuth helper utilities.
@@ -4730,11 +3896,12 @@ declare function cancelPurchaseCore(request: Request, body: {
  * This is a public route - no authentication required.
  */
 
+type Plan = components['schemas']['Plan'];
 /**
  * List plans - core implementation
  */
 declare function listPlansCore(request: Request): Promise<{
-    plans: Record<string, unknown>[];
+    plans: Plan[];
     productRef: string;
 } | ErrorResult>;
 
@@ -4793,4 +3960,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): WebhookEvent;
 
-export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerResponseMapped, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, McpBearerAuthError, type McpBootstrapFreePlanConfig, type McpBootstrapPaidPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpServerLike, type McpToolExtra, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, type WebhookEvent, type WebhookEventType, buildAuthInfoFromBearer, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createMcpOAuthBridge, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createVirtualTools, decodeJwtPayload, extractBearerToken, getAuthenticatedUserCore, getCustomerRefFromBearerAuthHeader, getCustomerRefFromJwtPayload, getOAuthAuthorizationServerResponse, getOAuthProtectedResourceResponse, handleRouteError, isErrorResult, jsonSchemaToZodRawShape, listPlansCore, processPaymentIntentCore, registerVirtualToolsMcpImpl, syncCustomerCore, verifyWebhook, withRetry };
+export { type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type McpAdapterOptions, McpBearerAuthError, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpServerLike, type McpToolExtra, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, buildAuthInfoFromBearer, cancelPurchaseCore, type components, createCheckoutSessionCore, createCustomerSessionCore, createMcpOAuthBridge, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createVirtualTools, decodeJwtPayload, extractBearerToken, getAuthenticatedUserCore, getCustomerRefFromBearerAuthHeader, getCustomerRefFromJwtPayload, getOAuthAuthorizationServerResponse, getOAuthProtectedResourceResponse, handleRouteError, isErrorResult, jsonSchemaToZodRawShape, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, registerVirtualToolsMcpImpl, syncCustomerCore, verifyWebhook, withRetry };