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

package/dist/edge.d.ts

@@ -1,328 +1,103 @@
-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;
+            purpose: "product" | "credit_topup" | "usage_billing";
+            amount?: number;
+            currency?: string;
+            description?: string;
         };
         CreateCheckoutSessionRequest: {
-            /**
-             * Customer reference
-             * @example cus_3c4d5e6f7g8h
-             */
-            customerReference: string;
-            /**
-             * Plan reference (optional)
-             * @example pln_2b3c4d5e6f7g
-             */
+            customerRef: string;
+            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;
+        ProcessPaymentIntentDto: {
+            productRef: string;
+            customerRef: string;
+            planRef?: string;
         };
-        TosAcceptance: {
+        CreateCheckoutSessionResponse: {
             /**
-             * IP address of user accepting ToS
-             * @example 192.168.1.1
+             * Checkout session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
              */
-            ip: string;
-        };
-        UpdateConnectedAccount: {
+            sessionId: string;
             /**
-             * Business website URL
-             * @example https://example.com
+             * Full checkout URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
              */
-            website?: string;
-            /** @description External bank account */
-            externalAccount?: components["schemas"]["ExternalAccount"];
-            /** @description Terms of Service acceptance */
-            tosAcceptance?: components["schemas"]["TosAcceptance"];
-        };
-        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;
+            checkoutUrl: 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
@@ -333,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
@@ -375,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;
             /**
@@ -402,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
@@ -432,181 +212,81 @@ 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;
         };
-        ProductConfigDto: {
-            /**
-             * Fulfillment type
-             * @example digital
-             */
+        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
+             * @example digital
+             */
             fulfillmentType?: string;
             /**
              * Validity period in days
@@ -619,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
@@ -696,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;
             /**
@@ -728,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
@@ -823,175 +468,59 @@ interface components {
             };
         };
         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}
-             */
+            /** @enum {string} */
             status?: "active" | "inactive" | "suspended";
-            /** @description Product-specific configuration */
-            config?: components["schemas"]["ProductConfigDto"];
-            /** @description Arbitrary key-value metadata */
-            metadata?: {
-                [key: string]: unknown;
+            config: {
+                fulfillmentType?: string;
+                validityPeriod?: number;
+                deliveryMethod?: string;
             };
-        };
-        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
-             */
-            limit?: number;
-            /** @description Plan features */
-            features?: {
+            metadata: {
                 [key: string]: unknown;
             };
         };
-        McpBootstrapToolInput: {
-            /**
-             * Tool name
-             * @example search_docs
-             */
-            name: string;
-            /**
-             * Tool description
-             * @example Search indexed documents
-             */
-            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[];
-        };
-        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;
             };
         };
@@ -1036,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;
+                };
+            }[];
+            toolMapping?: {
+                name: string;
+                planKeys: string[];
             }[];
-            /** @description Validation status for the provided bootstrap payload */
-            validation: {
-                valid?: boolean;
-                errors?: components["schemas"]["McpBootstrapPreviewValidationError"][];
+        };
+        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
@@ -1187,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
@@ -1286,15 +833,7 @@ interface components {
             updatedAt: string;
         };
         UserInfoRequest: {
-            /**
-             * Customer reference
-             * @example cus_3C4D5E6F
-             */
             customerRef: string;
-            /**
-             * Product reference
-             * @example prd_1A2B3C4D
-             */
             productRef: string;
         };
         UserInfoUserDto: {
@@ -1371,457 +910,1430 @@ interface components {
             user?: components["schemas"]["UserInfoUserDto"];
             purchase?: components["schemas"]["UserInfoPurchaseDto"];
         };
-        McpToolDto: {
+        PlanSnapshotDto: {
             /**
-             * Tool name
-             * @example search_documents
+             * Plan reference
+             * @example pln_1A2B3C4D
              */
-            name: string;
+            reference?: string;
             /**
-             * Plan IDs that grant access to this tool
-             * @example [
-             *       "pln_abc123"
-             *     ]
+             * Plan price in cents
+             * @example 2999
              */
-            planIds?: string[];
+            price: number;
             /**
-             * If true, the tool is unprotected (no purchase check or usage tracking)
-             * @example false
+             * Currency code
+             * @example USD
              */
-            noPlan?: boolean;
+            currency: string;
             /**
-             * Human-readable tool description
-             * @example Search indexed documents
+             * Plan type
+             * @example recurring
              */
-            description?: string;
+            planType: string;
             /**
-             * Whether this is a virtual platform tool handled by SolvaPay
-             * @example false
+             * Billing cycle
+             * @example monthly
              */
-            isVirtual?: boolean;
-        };
-        McpServerDto: {
-            /**
-             * Server ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id?: string;
+            billingCycle?: string | null;
+            /** @description Plan features */
+            features?: {
+                [key: string]: unknown;
+            } | null;
+            /** @description Usage limits */
+            limits?: {
+                [key: string]: unknown;
+            } | null;
             /**
-             * Unique server reference
-             * @example mcp_abc123
+             * Meter ObjectId reference
+             * @example 507f1f77bcf86cd799439011
              */
-            reference?: string;
+            meterId?: string;
             /**
-             * Domain slug used to derive the MCP endpoint subdomain
-             * @example my-mcp-server
+             * Usage limit for the meter
+             * @example 5000
              */
-            name: string;
+            limit?: number;
             /**
-             * URL-safe subdomain derived from name
-             * @example my-mcp-server
+             * Number of free units included
+             * @example 100
              */
-            subdomain: string;
+            freeUnits?: number;
             /**
-             * SolvaPay proxy URL that MCP clients connect to
-             * @example https://mytelescope.mcp.solvapay.com/mcp
+             * Price per usage unit in cents (supports decimals, e.g. 0.1 = 1/10 cent)
+             * @example 0.1
              */
-            mcpProxyUrl?: string;
+            pricePerUnit?: number;
+        };
+        UsageBillingDto: {
             /**
-             * Origin URL of the actual MCP server
-             * @example https://origin.example.com/mcp
+             * Units consumed in current period
+             * @example 150
              */
-            url: string;
+            used: number;
             /**
-             * Avatar image URL
-             * @example https://example.com/avatar.png
+             * Units exceeding the plan limit
+             * @example 0
              */
-            avatarUrl?: string;
-            /** @description Registered tools for this server */
-            tools?: components["schemas"]["McpToolDto"][];
+            overageUnits: number;
             /**
-             * 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
+             * Overage cost in cents
+             * @example 0
              */
-            defaultPlanId?: string;
+            overageCost: number;
             /**
-             * Associated product ID
-             * @example 507f1f77bcf86cd799439011
+             * Period start date
+             * @example 2025-10-01T00:00:00Z
              */
-            productId?: string;
+            periodStart?: string;
             /**
-             * Server status
-             * @example active
-             * @enum {string}
+             * Period end date
+             * @example 2025-11-01T00:00:00Z
              */
-            status?: "active" | "inactive" | "suspended";
+            periodEnd?: string;
+        };
+        PurchaseResponse: {
             /**
-             * Provider ID that owns this server
+             * Purchase ID
              * @example 507f1f77bcf86cd799439011
              */
-            providerId: string;
+            id: string;
             /**
-             * Custom auth header name for origin requests
-             * @example X-API-Key
+             * Purchase reference
+             * @example pur_1A2B3C4D
              */
-            authHeaderName?: string;
+            reference: string;
             /**
-             * Whether an auth API key is configured
-             * @example true
+             * Customer reference
+             * @example cus_3C4D5E6F
              */
-            hasAuthApiKey?: boolean;
+            customerRef: string;
             /**
-             * Total number of tool-call transactions
-             * @example 42
+             * Customer email
+             * @example customer@example.com
              */
-            totalTransactions?: number;
+            customerEmail: string;
             /**
-             * Current balance in cents
-             * @example 1500
+             * Product reference
+             * @example prd_1A2B3C4D
              */
-            balance?: number;
-        };
-        PlanSnapshotDto: {
+            productRef: string;
             /**
-             * Plan reference
-             * @example pln_1A2B3C4D
+             * Product ID
+             * @example 507f1f77bcf86cd799439012
              */
-            reference?: string;
+            productId?: string;
             /**
-             * Plan price in cents
-             * @example 2999
+             * Product name
+             * @example API Gateway Manager
              */
-            price: number;
+            productName?: string;
+            /** @description Plan snapshot at time of purchase (null for credit topups) */
+            planSnapshot?: components["schemas"]["PlanSnapshotDto"];
             /**
-             * Currency code
-             * @example USD
+             * Purchase status
+             * @example active
              */
-            currency: string;
+            status: string;
             /**
-             * Plan type
-             * @example recurring
+             * Amount in USD cents (normalised for aggregation)
+             * @example 9900
              */
-            planType: string;
+            amount: number;
             /**
-             * Billing cycle
-             * @example monthly
+             * Original amount in the payment currency (cents/pence)
+             * @example 10000
              */
-            billingCycle?: string | null;
-            /** @description Plan features */
-            features?: {
-                [key: string]: unknown;
-            } | null;
-            /** @description Usage limits */
-            limits?: {
-                [key: string]: unknown;
-            } | null;
+            originalAmount?: number;
             /**
-             * Meter ObjectId reference
-             * @example 507f1f77bcf86cd799439011
+             * Original payment currency code
+             * @example GBP
              */
-            meterId?: string;
+            currency: string;
             /**
-             * Usage limit for the meter
-             * @example 5000
+             * Exchange rate from original currency to USD
+             * @example 1.3082
              */
-            limit?: number;
+            exchangeRate?: number;
+            /** @description Start date */
+            startDate: string;
+            /** @description End date */
+            endDate?: string;
+            /** @description Paid at timestamp */
+            paidAt?: string;
+            /** @description Usage billing state for usage-based plans */
+            usage?: components["schemas"]["UsageBillingDto"];
             /**
-             * Number of free units included
-             * @example 100
+             * Is recurring
+             * @example true
              */
-            freeUnits?: number;
+            isRecurring: boolean;
             /**
-             * Price per usage unit in cents
-             * @example 10
+             * Billing cycle
+             * @enum {string}
              */
+            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly";
+            /** @description Next billing date */
+            nextBillingDate?: string;
+            /** @description Auto-renew enabled */
+            autoRenew?: 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;
+        };
+        CheckLimitRequest: {
+            customerRef: string;
+            productRef: string;
+            planRef?: string;
+            meterName?: string;
+            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;
         };
-        UsageBillingDto: {
+        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: {
             /**
-             * Units consumed in current period
-             * @example 150
+             * Whether the customer is within their usage limits
+             * @example true
              */
-            used: number;
+            withinLimits: boolean;
             /**
-             * Units exceeding the plan limit
-             * @example 0
+             * Remaining usage units before hitting the limit
+             * @example 997
              */
-            overageUnits: number;
+            remaining: number;
             /**
-             * Overage cost in cents
-             * @example 0
+             * Checkout session ID if payment is required
+             * @example e3f1c2d4b6a89f001122334455667788
              */
-            overageCost: number;
+            checkoutSessionId?: string;
             /**
-             * Period start date
-             * @example 2025-10-01T00:00:00Z
+             * Checkout URL if payment is required
+             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
              */
-            periodStart?: string;
+            checkoutUrl?: string;
             /**
-             * Period end date
-             * @example 2025-11-01T00:00:00Z
+             * The meter name to use when tracking usage events
+             * @example requests
              */
-            periodEnd?: string;
+            meterName?: string;
+            /** @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;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+interface operations {
+    PaymentIntentSdkController_getPaymentIntents: {
+        parameters: {
+            query?: {
+                /** @description Maximum number of results */
+                limit?: number;
+                /** @description Pagination offset */
+                offset?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Payment intents retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    PaymentIntentSdkController_createPaymentIntent: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Unique idempotency key to prevent duplicate payments (required) */
+                "idempotency-key": string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Payment intent creation data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreatePaymentIntentDto"];
+            };
+        };
+        responses: {
+            /** @description Payment intent created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Missing required fields or invalid data */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    PaymentIntentSdkController_getPaymentIntent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Payment intent MongoDB ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Payment intent retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Payment intent not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    PaymentIntentSdkController_processPaymentIntent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Stripe payment intent ID (format: pi_xxx) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        /** @description Payment processing data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProcessPaymentIntentDto"];
+            };
+        };
+        responses: {
+            /** @description Payment intent status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Payment intent status
+                         * @example succeeded
+                         * @enum {string}
+                         */
+                        status?: "succeeded" | "timeout" | "failed" | "cancelled";
+                        /**
+                         * Optional message, only present for timeout status
+                         * @example Timeout while waiting for payment intent confirmation, try again later. This could be due to Stripe webhooks not being configured correctly.
+                         */
+                        message?: string;
+                    };
+                };
+            };
+            /** @description Payment not succeeded, invalid request, or forbidden */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    CheckoutSessionSdkController_createCheckoutSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCheckoutSessionRequest"];
+            };
+        };
+        responses: {
+            /** @description Checkout session created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateCheckoutSessionResponse"];
+                };
+            };
+            /** @description Missing customerRef or productRef */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PlanSdkController_listPlans: {
+        parameters: {
+            query?: {
+                limit?: number;
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Plans retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        plans?: components["schemas"]["Plan"][];
+                        /** @description Total number of plans for the product */
+                        total?: number;
+                        limit?: number;
+                        offset?: number;
+                    };
+                };
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PlanSdkController_createPlan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreatePlanRequest"];
+            };
+        };
+        responses: {
+            /** @description Plan created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Plan"];
+                };
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PlanSdkController_getPlan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+                /** @description Plan reference or ID */
+                planRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Plan retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Plan"];
+                };
+            };
+            /** @description Plan or product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PlanSdkController_updatePlan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+                /** @description Plan reference or ID */
+                planRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdatePlanRequest"];
+            };
+        };
+        responses: {
+            /** @description Plan updated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Plan"];
+                };
+            };
+            /** @description Plan or product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PlanSdkController_deletePlan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+                /** @description Plan reference or ID */
+                planRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Plan deleted successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Plan or product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    ProductSdkController_listProducts: {
+        parameters: {
+            query?: {
+                /** @description Max results (1-100) */
+                limit?: number;
+                /** @description Pagination offset */
+                offset?: number;
+                /** @description Search by name or description */
+                search?: string;
+                /** @description Filter by status */
+                status?: "active" | "inactive" | "suspended";
+                /** @description Filter MCP Pay products */
+                isMcpPay?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Products retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    ProductSdkController_createProduct: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateProductRequest"];
+            };
+        };
+        responses: {
+            /** @description Product created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdkProductResponse"];
+                };
+            };
+            /** @description Missing required fields or validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    ProductSdkController_getProduct: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Product retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdkProductResponse"];
+                };
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    ProductSdkController_updateProduct: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateProductRequest"];
+            };
+        };
+        responses: {
+            /** @description Product updated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdkProductResponse"];
+                };
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    ProductSdkController_deleteProduct: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Product deleted or deactivated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    ProductSdkController_bootstrapMcpProduct: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["McpBootstrapDto"];
+            };
+        };
+        responses: {
+            /** @description MCP product bootstrapped successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["McpBootstrapResult"];
+                };
+            };
+            /** @description Invalid bootstrap request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    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;
+            header?: never;
+            path: {
+                /** @description Product reference or ID to clone */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CloneProductDto"];
+            };
+        };
+        responses: {
+            /** @description Product cloned successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SdkProductResponse"];
+                };
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    UsageSdkController_recordUsage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateUsageRequest"];
+            };
+        };
+        responses: {
+            /** @description Usage recorded successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example true */
+                        success?: boolean;
+                        /** @example usage_A1B2C3D4 */
+                        reference?: string;
+                    };
+                };
+            };
+            /** @description Validation failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    UsageSdkController_recordBulkUsage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkCreateUsageRequest"];
+            };
+        };
+        responses: {
+            /** @description Bulk usage events processed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    MeterEventsSdkController_recordEvent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RecordMeterEventZodDto"];
+            };
+        };
+        responses: {
+            /** @description Event recorded */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example true */
+                        success?: boolean;
+                    };
+                };
+            };
+            /** @description Invalid meter name or meter is archived */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    MeterEventsSdkController_recordBulkEvents: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RecordBulkMeterEventsZodDto"];
+            };
+        };
+        responses: {
+            /** @description Events recorded */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example true */
+                        success?: boolean;
+                        /** @example 50 */
+                        inserted?: number;
+                    };
+                };
+            };
+            /** @description Invalid meter name or meter is archived */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    CustomerSdkController_getCustomerByQuery: {
+        parameters: {
+            query?: {
+                /** @description Customer reference identifier (use exactly one query parameter) */
+                reference?: string;
+                /** @description External reference ID from your auth system (use exactly one query parameter) */
+                externalRef?: string;
+                /** @description Customer email address (use exactly one query parameter) */
+                email?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Customer retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomerResponse"];
+                };
+            };
+            /** @description Invalid request - must provide exactly one of reference, externalRef, or email */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Customer not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    CustomerSdkController_createCustomer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Customer creation data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCustomerRequest"];
+            };
+        };
+        responses: {
+            /** @description Customer created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomerResponse"];
+                };
+            };
+            /** @description Invalid email or missing required fields */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    CustomerSdkController_getCustomer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Customer reference identifier */
+                reference: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Customer retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomerResponse"];
+                };
+            };
+            /** @description Customer not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    CustomerSdkController_createCustomerSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Customer session creation request data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCustomerSessionRequest"];
+            };
+        };
+        responses: {
+            /** @description Customer session created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateCustomerSessionResponse"];
+                };
+            };
+            /** @description Invalid request data or customer not found */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @description Customer not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
+    CustomerSdkController_getCustomerSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Customer session ID/token */
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Customer session retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetCustomerSessionResponse"];
+                };
+            };
+            /** @description Customer session not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
         };
-        PurchaseResponse: {
-            /**
-             * Purchase ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id: string;
-            /**
-             * Purchase reference
-             * @example pur_1A2B3C4D
-             */
-            reference: string;
-            /**
-             * Customer reference
-             * @example cus_3C4D5E6F
-             */
-            customerRef: string;
-            /**
-             * Customer email
-             * @example customer@example.com
-             */
-            customerEmail: string;
-            /**
-             * Product reference
-             * @example prd_1A2B3C4D
-             */
-            productRef: string;
-            /**
-             * Product ID
-             * @example 507f1f77bcf86cd799439012
-             */
-            productId?: string;
-            /**
-             * Product name
-             * @example API Gateway Manager
-             */
-            productName?: string;
-            /** @description Plan snapshot at time of purchase */
-            planSnapshot: components["schemas"]["PlanSnapshotDto"];
-            /**
-             * Purchase status
-             * @example active
-             */
-            status: string;
-            /**
-             * Amount in cents
-             * @example 9900
-             */
-            amount: number;
-            /**
-             * Currency code
-             * @example USD
-             */
-            currency: string;
-            /** @description Start date */
-            startDate: string;
-            /** @description End date */
-            endDate?: string;
-            /** @description Paid at timestamp */
-            paidAt?: string;
-            /** @description Usage billing state for usage-based plans */
-            usage?: components["schemas"]["UsageBillingDto"];
-            /**
-             * Is recurring
-             * @example true
-             */
-            isRecurring: boolean;
-            /**
-             * Billing cycle
-             * @enum {string}
-             */
-            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly";
-            /** @description Next billing date */
-            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 Created at */
-            createdAt: string;
+    };
+    UserInfoSdkController_getUserInfo: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UserInfoRequest"];
+            };
         };
-        CancelPurchaseRequest: {
-            /** @description Reason for cancellation */
-            reason?: string;
+        responses: {
+            /** @description User info with purchase status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UserInfoResponse"];
+                };
+            };
+            /** @description Missing customerRef or productRef */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Customer or product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
-        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;
+    };
+    PurchaseSdkController_listPurchases: {
+        parameters: {
+            query?: {
+                /** @description Filter by purchase status */
+                status?: "pending" | "active" | "trialing" | "past_due" | "cancelled" | "expired" | "suspended" | "refunded";
+                /** @description Filter by product ID */
+                productId?: string;
+                /** @description Filter by customer ID */
+                customerId?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Purchases retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        purchases?: components["schemas"]["PurchaseResponse"][];
+                    };
+                };
+            };
         };
-        LimitResponse: {
-            /**
-             * Whether the customer is within their usage limits
-             * @example true
-             */
-            withinLimits: boolean;
-            /**
-             * Remaining usage units before hitting the limit
-             * @example 997
-             */
-            remaining: number;
-            /**
-             * Checkout session ID if payment is required
-             * @example e3f1c2d4b6a89f001122334455667788
-             */
-            checkoutSessionId?: string;
-            /**
-             * Checkout URL if payment is required
-             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
-             */
-            checkoutUrl?: string;
-            /**
-             * The meter name to use when tracking usage events
-             * @example requests
-             */
-            meterName?: string;
+    };
+    PurchaseSdkController_getPurchasesForCustomer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Customer reference or ID */
+                customerRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Customer purchases retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        purchases?: components["schemas"]["PurchaseResponse"][];
+                    };
+                };
+            };
+            /** @description Customer not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
-        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;
+    };
+    PurchaseSdkController_getPurchasesForProduct: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Product reference or ID */
+                productRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Product purchases retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        purchases?: components["schemas"]["PurchaseResponse"][];
+                    };
+                };
+            };
+            /** @description Product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
-        UpdateWebhookEndpointDto: {
-            /**
-             * Webhook endpoint URL
-             * @example https://example.com/webhook
-             */
-            url?: string;
-            /**
-             * Webhook endpoint description
-             * @example Updated webhook
-             */
-            description?: string;
+    };
+    PurchaseSdkController_getPurchase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Purchase ID or reference */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Purchase retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PurchaseResponse"];
+                };
+            };
+            /** @description Purchase not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
-        UpdateThemePreferenceDto: {
-            /**
-             * Selected UI theme mode
-             * @example dark
-             * @enum {string}
-             */
-            mode: "light" | "dark";
+    };
+    PurchaseSdkController_cancelPurchase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Purchase reference or ID */
+                purchaseRef: string;
+            };
+            cookie?: never;
         };
-        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;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CancelPurchaseRequest"];
+            };
         };
-        ThemeOverridesDto: {
-            /** @description Light mode color overrides */
-            light?: components["schemas"]["ThemeModeColorsDto"];
-            /** @description Dark mode color overrides */
-            dark?: components["schemas"]["ThemeModeColorsDto"];
+        responses: {
+            /** @description Purchase cancelled successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        success?: boolean;
+                        purchase?: components["schemas"]["PurchaseResponse"];
+                    };
+                };
+            };
+            /** @description Purchase not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
-        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"];
+    };
+    LimitsSdkController_checkLimits: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CheckLimitRequest"];
+            };
         };
-        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;
-            };
-        };
-        /** @description Auto-generated fallback schema for unresolved reference: McpBootstrapPreviewValidationError */
-        McpBootstrapPreviewValidationError: {
-            [key: string]: unknown;
+        responses: {
+            /** @description Limit check result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LimitResponse"];
+                };
+            };
+            /** @description Missing customerRef or productRef */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Customer or product not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
 }
 
 /**
@@ -1830,17 +2342,12 @@ interface components {
  * 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
@@ -1879,46 +2386,7 @@ 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 McpBootstrapRequest = components['schemas']['McpBootstrapDto'];
 interface McpBootstrapResponse {
     product: components['schemas']['SdkProductResponse'];
     mcpServer: {
@@ -1940,6 +2408,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
  *
@@ -1981,6 +2466,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?: {
@@ -1989,29 +2475,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;
@@ -2038,7 +2506,7 @@ interface SolvaPayClient {
         customerRef: string;
         productRef: string;
     }): Promise<components['schemas']['UserInfoResponse']>;
-    createCheckoutSession(params: components['schemas']['CreateCheckoutSessionRequest']): 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']>;
 }
 
@@ -2047,6 +2515,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
  */
@@ -2065,14 +2537,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
  */
@@ -2084,7 +2571,7 @@ interface PaywallToolResult {
         mimeType?: string;
     }>;
     isError?: boolean;
-    structuredContent?: PaywallStructuredContent;
+    structuredContent?: PaywallStructuredContent | Record<string, unknown>;
 }
 
 /**
@@ -2126,6 +2613,16 @@ interface RetryOptions {
      */
     onRetry?: (error: Error, attempt: number) => void;
 }
+interface McpToolExtra {
+    authInfo?: {
+        token: string;
+        clientId: string;
+        scopes: string[];
+        expiresAt?: number;
+        extra?: Record<string, unknown>;
+    };
+    [key: string]: unknown;
+}
 /**
  * Options for configuring payable protection
  */
@@ -2196,7 +2693,7 @@ interface McpAdapterOptions {
     /**
      * Extract customer reference from MCP args
      */
-    getCustomerRef?: (args: any) => string | Promise<string>;
+    getCustomerRef?: (args: any, extra?: McpToolExtra) => string | Promise<string>;
     /**
      * Transform the response before wrapping in MCP format
      */
@@ -2273,7 +2770,7 @@ interface VirtualToolsOptions {
     /** Product reference (required) */
     product: string;
     /** Extract customer reference from MCP tool args */
-    getCustomerRef: (args: Record<string, unknown>) => string;
+    getCustomerRef: (args: Record<string, unknown>, extra?: McpToolExtra) => string;
     /** Tool names to exclude from registration (optional) */
     exclude?: string[];
 }
@@ -2285,7 +2782,7 @@ interface VirtualToolDefinition {
         properties: Record<string, object>;
         required: string[];
     };
-    handler: (args: Record<string, unknown>) => Promise<{
+    handler: (args: Record<string, unknown>, extra?: McpToolExtra) => Promise<{
         content: Array<{
             type: string;
             text: string;
@@ -2294,6 +2791,16 @@ interface VirtualToolDefinition {
     }>;
 }
 
+interface McpServerLike {
+    registerTool: (name: string, config: Record<string, unknown>, handler: (args: Record<string, unknown>, extra?: McpToolExtra) => unknown) => unknown;
+}
+interface RegisterVirtualToolsMcpOptions extends Omit<VirtualToolsOptions, 'getCustomerRef'> {
+    getCustomerRef?: VirtualToolsOptions['getCustomerRef'];
+    filter?: (definition: VirtualToolDefinition) => boolean;
+    mapDefinition?: (definition: VirtualToolDefinition) => VirtualToolDefinition;
+    wrapHandler?: (handler: VirtualToolDefinition['handler'], definition: VirtualToolDefinition) => (args: Record<string, unknown>, extra?: McpToolExtra) => Promise<unknown> | unknown;
+}
+
 /**
  * Configuration for creating a SolvaPay instance.
  *
@@ -2411,7 +2918,7 @@ interface PayableFunction {
      * });
      * ```
      */
-    mcp<T = any>(businessLogic: (args: any) => Promise<T>, options?: McpAdapterOptions): (args: Record<string, unknown>) => Promise<unknown>;
+    mcp<T = any>(businessLogic: (args: any) => Promise<T>, options?: McpAdapterOptions): (args: Record<string, unknown>, extra?: McpToolExtra) => Promise<unknown>;
     /**
      * Pure function adapter for direct function protection.
      *
@@ -2612,14 +3119,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.
@@ -2683,6 +3193,7 @@ interface SolvaPay {
     createCustomer(params: {
         email: string;
         name?: string;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         customerRef: string;
     }>;
@@ -2784,6 +3295,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.
      *
@@ -2803,7 +3321,7 @@ interface SolvaPay {
      * ```typescript
      * const virtualTools = solvaPay.getVirtualTools({
      *   product: 'prd_myapi',
-     *   getCustomerRef: args => args._auth?.customer_ref || 'anonymous',
+     *   getCustomerRef: (_args, extra) => String(extra?.authInfo?.extra?.customer_ref || 'anonymous'),
      * });
      *
      * // Register on your MCP server
@@ -2813,6 +3331,13 @@ interface SolvaPay {
      * ```
      */
     getVirtualTools(options: VirtualToolsOptions): VirtualToolDefinition[];
+    /**
+     * Register virtual tools directly on an MCP server with one call.
+     *
+     * This helper converts virtual tool JSON schemas to Zod schemas and registers
+     * each tool on an MCP server that supports `registerTool()`.
+     */
+    registerVirtualToolsMcp(server: McpServerLike, options: RegisterVirtualToolsMcpOptions): Promise<void>;
     /**
      * Direct access to the API client for advanced operations.
      *
@@ -2926,6 +3451,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>;
 
 /**
  * Utility functions for the SolvaPay Server SDK
@@ -3277,11 +3804,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>;
 
@@ -3298,4 +3826,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): Promise<WebhookEvent>;
 
-export { type AuthenticatedUser, type CreateSolvaPayConfig, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, type NextAdapterOptions, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type WebhookEvent, type WebhookEventType, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, getAuthenticatedUserCore, handleRouteError, isErrorResult, listPlansCore, processPaymentIntentCore, syncCustomerCore, verifyWebhook, withRetry };
+export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerWebhookObject, type ErrorResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type McpAdapterOptions, type NextAdapterOptions, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, getAuthenticatedUserCore, handleRouteError, isErrorResult, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, syncCustomerCore, verifyWebhook, withRetry };