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

package/dist/index.d.cts

@@ -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,176 +212,76 @@ interface components {
             updatedAt: string;
         };
         CreatePlanRequest: {
-            /**
-             * Plan type exposed in SDK
-             * @example recurring
-             * @enum {string}
-             */
-            type?: "recurring" | "one-time";
-            /**
-             * Billing cycle (required for recurring/hybrid, optional for post-paid usage-based)
-             * @example monthly
-             * @enum {string}
-             */
+            name?: string;
+            description?: string;
+            /** @enum {string} */
+            type?: "recurring" | "usage-based" | "hybrid" | "one-time";
+            /** @enum {string} */
             billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan price in cents
-             * @example 2999
-             */
             price?: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             * @enum {string}
-             */
-            currency?: "USD" | "EUR" | "GBP" | "SEK" | "NOK" | "DKK" | "CAD" | "AUD" | "JPY" | "CHF" | "PLN" | "CZK" | "HUF" | "RON" | "BGN" | "HRK" | "RSD" | "MKD" | "BAM" | "ALL" | "ISK" | "TRY" | "RUB" | "UAH" | "BYN" | "MDL" | "GEL" | "AMD" | "AZN" | "KZT" | "KGS" | "TJS" | "TMT" | "UZS" | "MNT" | "CNY" | "KRW" | "THB" | "VND" | "IDR" | "MYR" | "SGD" | "PHP" | "INR" | "PKR" | "BDT" | "LKR" | "NPR" | "AFN" | "IRR" | "IQD" | "JOD" | "KWD" | "LBP" | "OMR" | "QAR" | "SAR" | "SYP" | "AED" | "YER" | "ILS" | "EGP" | "MAD" | "TND" | "DZD" | "LYD" | "SDG" | "ETB" | "KES" | "TZS" | "UGX" | "RWF" | "BIF" | "DJF" | "SOS" | "ERN" | "SLL" | "GMD" | "GNF" | "CVE" | "STN" | "AOA" | "ZAR" | "BWP" | "SZL" | "LSL" | "NAD" | "ZMW" | "ZWL" | "MZN" | "MWK" | "MGA" | "MUR" | "SCR" | "KMF" | "MVR";
-            /**
-             * Number of free units included
-             * @example 100
-             */
+            pricePerUnit?: number;
+            currency?: string;
+            /** @enum {string} */
+            billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
-            /**
-             * Usage limit for the meter
-             * @example 10000
-             */
             limit?: number;
-            /**
-             * Usage limits (shape varies by plan type)
-             * @example {
-             *       "maxTransactions": 1000
-             *     }
-             */
-            limits?: {
+            limits: {
                 [key: string]: unknown;
             };
-            /**
-             * Plan features (generic key/value, shape is provider-defined)
-             * @example {
-             *       "apiAccess": true,
-             *       "prioritySupport": false
-             *     }
-             */
-            features?: {
+            metadata: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier?: boolean;
-            /**
-             * Whether payment is required
-             * @example true
-             */
-            requiresPayment?: boolean;
-            /**
-             * Plan status
-             * @example active
-             * @enum {string}
-             */
+            features: {
+                [key: string]: unknown;
+            };
+            /** @enum {string} */
             status?: "active" | "inactive" | "archived";
-            /**
-             * Maximum number of active users
-             * @example 10
-             */
             maxActiveUsers?: number;
-            /**
-             * Access expiry in days
-             * @example 30
-             */
             accessExpiryDays?: number;
-            /** @description Additional metadata */
-            metadata?: {
-                [key: string]: unknown;
-            };
-            /**
-             * Whether this is the default plan
-             * @example false
-             */
             default?: boolean;
         };
         UpdatePlanRequest: {
-            /**
-             * Billing cycle
-             * @example monthly
-             * @enum {string}
-             */
+            name?: string;
+            description?: string;
+            /** @enum {string} */
             billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan price in cents
-             * @example 2999
-             */
             price?: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             */
+            pricePerUnit?: number;
             currency?: string;
-            /**
-             * Number of free units included
-             * @example 100
-             */
+            /** @enum {string} */
+            billingModel?: "pre-paid" | "post-paid";
             freeUnits?: number;
-            /**
-             * Usage limit for the meter
-             * @example 10000
-             */
             limit?: number;
-            /**
-             * Usage limits (shape varies by plan type)
-             * @example {
-             *       "maxTransactions": 1000
-             *     }
-             */
-            limits?: {
+            limits: {
                 [key: string]: unknown;
             };
-            /**
-             * Plan features (generic key/value, shape is provider-defined)
-             * @example {
-             *       "apiAccess": true,
-             *       "prioritySupport": false
-             *     }
-             */
-            features?: {
+            features: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is a free tier plan
-             * @example false
-             */
-            isFreeTier?: boolean;
-            /**
-             * Whether payment is required
-             * @example true
-             */
-            requiresPayment?: boolean;
-            /**
-             * Plan status
-             * @example active
-             * @enum {string}
-             */
+            /** @enum {string} */
             status?: "active" | "inactive" | "archived";
-            /**
-             * Maximum number of active users
-             * @example 10
-             */
             maxActiveUsers?: number;
-            /**
-             * Access expiry in days
-             * @example 30
-             */
             accessExpiryDays?: number;
-            /** @description Additional metadata */
-            metadata?: {
+            metadata: {
                 [key: string]: unknown;
             };
-            /**
-             * Whether this is the default plan
-             * @example false
-             */
             default?: boolean;
         };
+        CreateProductRequest: {
+            name: string;
+            description?: string;
+            imageUrl?: string;
+            productType?: string;
+            isMcpPay?: boolean;
+            config: {
+                fulfillmentType?: string;
+                validityPeriod?: number;
+                deliveryMethod?: string;
+            };
+            metadata: {
+                [key: string]: unknown;
+            };
+        };
         ProductConfigDto: {
             /**
              * Fulfillment type
@@ -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
@@ -809,189 +454,73 @@ interface components {
             plans?: components["schemas"]["SdkPlanResponse"][];
             /**
              * MCP linkage details for MCP-enabled products
-             * @example {
-             *       "mcpServerId": "67f90f1f1b1c9c0b8df0f111",
-             *       "mcpServerReference": "mcp_ABC123",
-             *       "mcpSubdomain": "acme-docs",
-             *       "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
-             *       "originUrl": "https://origin.example.com/mcp",
-             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
-             *     }
-             */
-            mcp?: {
-                [key: string]: unknown;
-            };
-        };
-        UpdateProductRequest: {
-            /** @description Product name */
-            name?: string;
-            /** @description Product description */
-            description?: string;
-            /** @description URL to the product image */
-            imageUrl?: string;
-            /** @description Free-form product type defined by the provider */
-            productType?: string;
-            /**
-             * Product status
-             * @enum {string}
-             */
-            status?: "active" | "inactive" | "suspended";
-            /** @description Product-specific configuration */
-            config?: components["schemas"]["ProductConfigDto"];
-            /** @description Arbitrary key-value metadata */
-            metadata?: {
-                [key: string]: unknown;
-            };
-        };
-        McpBootstrapFreePlanConfig: {
-            /**
-             * Free plan display name override
-             * @example Starter
-             */
-            name?: string;
-            /**
-             * Included free units (default 1000)
-             * @example 500
-             */
-            freeUnits?: number;
-        };
-        McpBootstrapPaidPlanInput: {
-            /**
-             * Logical plan key (must not be "free")
-             * @example pro
-             */
-            key: string;
-            /**
-             * Plan display name
-             * @example Pro
-             */
-            name: string;
-            /**
-             * Plan price in cents (must be > 0)
-             * @example 2000
-             */
-            price: number;
-            /**
-             * Currency code (ISO 4217)
-             * @example USD
-             */
-            currency: string;
-            /**
-             * Billing cycle for recurring plans
-             * @example monthly
-             * @enum {string}
-             */
-            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
-            /**
-             * Plan type
-             * @example recurring
-             * @enum {string}
-             */
-            type?: "recurring" | "one-time";
-            /**
-             * Included free units
-             * @example 1000
-             */
-            freeUnits?: number;
-            /**
-             * Meter id for usage tracking
-             * @example 67f90f1f1b1c9c0b8df0f001
-             */
-            meterId?: string;
-            /**
-             * Plan usage limit
-             * @example 10000
+             * @example {
+             *       "mcpServerId": "67f90f1f1b1c9c0b8df0f111",
+             *       "mcpServerReference": "mcp_ABC123",
+             *       "mcpSubdomain": "acme-docs",
+             *       "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
+             *       "originUrl": "https://origin.example.com/mcp",
+             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
+             *     }
              */
-            limit?: number;
-            /** @description Plan features */
-            features?: {
+            mcp?: {
                 [key: string]: unknown;
             };
         };
-        McpBootstrapToolInput: {
-            /**
-             * Tool name
-             * @example search_docs
-             */
-            name: string;
-            /**
-             * Tool description
-             * @example Search indexed documents
-             */
+        UpdateProductRequest: {
+            name?: string;
             description?: string;
-            /**
-             * If true, tool is publicly available without a plan
-             * @example false
-             */
-            noPlan?: boolean;
-            /**
-             * Direct plan IDs allowed for this tool
-             * @example [
-             *       "67f90f1f1b1c9c0b8df0f001"
-             *     ]
-             */
-            planIds?: string[];
-            /**
-             * Plan references allowed for this tool
-             * @example [
-             *       "pln_ABC123"
-             *     ]
-             */
-            planRefs?: string[];
-            /**
-             * Bootstrap plan keys allowed for this tool (for example free or starter_paid)
-             * @example [
-             *       "free"
-             *     ]
-             */
-            planKeys?: string[];
+            imageUrl?: string;
+            productType?: string;
+            /** @enum {string} */
+            status?: "active" | "inactive" | "suspended";
+            config: {
+                fulfillmentType?: string;
+                validityPeriod?: number;
+                deliveryMethod?: string;
+            };
+            metadata: {
+                [key: string]: unknown;
+            };
         };
-        McpBootstrapRequest: {
-            /**
-             * Product name (optional when derivable from origin MCP metadata)
-             * @example Acme MCP Toolkit
-             */
+        McpBootstrapDto: {
             name?: string;
-            /**
-             * Product description
-             * @example MCP toolkit with tiered access
-             */
             description?: string;
-            /** @description Product image URL */
             imageUrl?: string;
-            /**
-             * Free-form product type
-             * @example MCP Server
-             */
             productType?: string;
-            /**
-             * Origin MCP server URL (must be https)
-             * @example https://origin.example.com/mcp
-             */
+            /** Format: uri */
             originUrl: string;
-            /**
-             * Optional final MCP subdomain override (for example, value returned by bootstrap-subdomain-checks)
-             * @example acme-docs
-             */
             mcpDomain?: string;
-            /**
-             * Optional auth header name forwarded to origin server
-             * @example X-API-Key
-             */
             authHeaderName?: string;
-            /**
-             * Optional auth API key forwarded to origin server
-             * @example sk-origin-123
-             */
             authApiKey?: string;
-            /** @description Free plan config overrides. A free plan is always created; this just customizes name/freeUnits. */
-            freePlan?: components["schemas"]["McpBootstrapFreePlanConfig"];
-            /** @description Paid plan definitions requiring price + currency */
-            paidPlans?: components["schemas"]["McpBootstrapPaidPlanInput"][];
-            /** @description Tool to plan mapping configuration */
-            tools?: components["schemas"]["McpBootstrapToolInput"][];
-            /** @description Arbitrary product metadata */
-            metadata?: {
+            plans?: {
+                key: string;
+                name: string;
+                price: number;
+                currency: string;
+                /** @enum {string} */
+                billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
+                /** @enum {string} */
+                type?: "recurring" | "one-time" | "usage-based";
+                pricePerUnit?: number;
+                /** @enum {string} */
+                billingModel?: "pre-paid" | "post-paid";
+                freeUnits?: number;
+                meterId?: string;
+                limit?: number;
+                features?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            tools?: {
+                name: string;
+                description?: string;
+                noPlan?: boolean;
+                planIds?: string[];
+                planRefs?: string[];
+                planKeys?: string[];
+            }[];
+            metadata: {
                 [key: string]: unknown;
             };
         };
@@ -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: {
@@ -1311,174 +850,65 @@ interface components {
             /** @example 1000 */
             total: number;
             /** @example 250 */
-            used: number;
-            /** @example 750 */
-            remaining: number;
-            /**
-             * Meter ObjectId reference
-             * @example 507f1f77bcf86cd799439011
-             */
-            meterId?: string;
-            /** @example 25 */
-            percentUsed?: number | null;
-        };
-        UserInfoPlanDto: {
-            /** @example pln_2B3C4D5E */
-            reference: string;
-            /**
-             * Price in minor currency units (e.g. cents)
-             * @example 2999
-             */
-            price: number;
-            /** @example USD */
-            currency: string;
-            /** @example recurring */
-            type: string;
-            /** @example monthly */
-            billingCycle?: string | null;
-            features?: string[] | null;
-            limits?: {
-                [key: string]: unknown;
-            } | null;
-        };
-        UserInfoPurchaseDto: {
-            /** @example pur_1A2B3C4D */
-            reference: string;
-            /** @example active */
-            status: string;
-            /** @example My API Product */
-            productName: string;
-            /** @example recurring */
-            planType: string;
-            /** @example 2025-10-27T10:00:00Z */
-            startDate?: string | null;
-            /** @example 2025-11-27T10:00:00Z */
-            endDate?: string | null;
-            usage?: components["schemas"]["UserInfoUsageDto"];
-            plan?: components["schemas"]["UserInfoPlanDto"];
-        };
-        UserInfoResponse: {
-            /**
-             * Human-readable status summary
-             * @example Active subscription: My API Product (25% usage consumed)
-             */
-            status: string;
-            /**
-             * Customer portal session URL
-             * @example https://solvapay.com/customer/manage?id=abc123
-             */
-            verifyUrl?: string | null;
-            user?: components["schemas"]["UserInfoUserDto"];
-            purchase?: components["schemas"]["UserInfoPurchaseDto"];
-        };
-        McpToolDto: {
-            /**
-             * Tool name
-             * @example search_documents
-             */
-            name: string;
-            /**
-             * Plan IDs that grant access to this tool
-             * @example [
-             *       "pln_abc123"
-             *     ]
-             */
-            planIds?: string[];
-            /**
-             * If true, the tool is unprotected (no purchase check or usage tracking)
-             * @example false
-             */
-            noPlan?: boolean;
-            /**
-             * Human-readable tool description
-             * @example Search indexed documents
-             */
-            description?: string;
-            /**
-             * Whether this is a virtual platform tool handled by SolvaPay
-             * @example false
-             */
-            isVirtual?: boolean;
-        };
-        McpServerDto: {
-            /**
-             * Server ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            id?: string;
-            /**
-             * Unique server reference
-             * @example mcp_abc123
-             */
-            reference?: string;
-            /**
-             * Domain slug used to derive the MCP endpoint subdomain
-             * @example my-mcp-server
-             */
-            name: string;
-            /**
-             * URL-safe subdomain derived from name
-             * @example my-mcp-server
-             */
-            subdomain: string;
-            /**
-             * SolvaPay proxy URL that MCP clients connect to
-             * @example https://mytelescope.mcp.solvapay.com/mcp
-             */
-            mcpProxyUrl?: string;
-            /**
-             * Origin URL of the actual MCP server
-             * @example https://origin.example.com/mcp
-             */
-            url: string;
-            /**
-             * Avatar image URL
-             * @example https://example.com/avatar.png
-             */
-            avatarUrl?: string;
-            /** @description Registered tools for this server */
-            tools?: components["schemas"]["McpToolDto"][];
-            /**
-             * Default plan ID for tool access gating. Must belong to the linked product and be a free-tier plan (isFreeTier=true or price=0).
-             * @example pln_default
-             */
-            defaultPlanId?: string;
-            /**
-             * Associated product ID
-             * @example 507f1f77bcf86cd799439011
-             */
-            productId?: string;
-            /**
-             * Server status
-             * @example active
-             * @enum {string}
-             */
-            status?: "active" | "inactive" | "suspended";
+            used: number;
+            /** @example 750 */
+            remaining: number;
             /**
-             * Provider ID that owns this server
+             * Meter ObjectId reference
              * @example 507f1f77bcf86cd799439011
              */
-            providerId: string;
-            /**
-             * Custom auth header name for origin requests
-             * @example X-API-Key
-             */
-            authHeaderName?: string;
+            meterId?: string;
+            /** @example 25 */
+            percentUsed?: number | null;
+        };
+        UserInfoPlanDto: {
+            /** @example pln_2B3C4D5E */
+            reference: string;
             /**
-             * Whether an auth API key is configured
-             * @example true
+             * Price in minor currency units (e.g. cents)
+             * @example 2999
              */
-            hasAuthApiKey?: boolean;
+            price: number;
+            /** @example USD */
+            currency: string;
+            /** @example recurring */
+            type: string;
+            /** @example monthly */
+            billingCycle?: string | null;
+            features?: string[] | null;
+            limits?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        UserInfoPurchaseDto: {
+            /** @example pur_1A2B3C4D */
+            reference: string;
+            /** @example active */
+            status: string;
+            /** @example My API Product */
+            productName: string;
+            /** @example recurring */
+            planType: string;
+            /** @example 2025-10-27T10:00:00Z */
+            startDate?: string | null;
+            /** @example 2025-11-27T10:00:00Z */
+            endDate?: string | null;
+            usage?: components["schemas"]["UserInfoUsageDto"];
+            plan?: components["schemas"]["UserInfoPlanDto"];
+        };
+        UserInfoResponse: {
             /**
-             * Total number of tool-call transactions
-             * @example 42
+             * Human-readable status summary
+             * @example Active subscription: My API Product (25% usage consumed)
              */
-            totalTransactions?: number;
+            status: string;
             /**
-             * Current balance in cents
-             * @example 1500
+             * Customer portal session URL
+             * @example https://solvapay.com/customer/manage?id=abc123
              */
-            balance?: number;
+            verifyUrl?: string | null;
+            user?: components["schemas"]["UserInfoUserDto"];
+            purchase?: components["schemas"]["UserInfoPurchaseDto"];
         };
         PlanSnapshotDto: {
             /**
@@ -1530,8 +960,8 @@ interface components {
              */
             freeUnits?: number;
             /**
-             * Price per usage unit in cents
-             * @example 10
+             * Price per usage unit in cents (supports decimals, e.g. 0.1 = 1/10 cent)
+             * @example 0.1
              */
             pricePerUnit?: number;
         };
@@ -1598,23 +1028,33 @@ interface components {
              * @example API Gateway Manager
              */
             productName?: string;
-            /** @description Plan snapshot at time of purchase */
-            planSnapshot: components["schemas"]["PlanSnapshotDto"];
+            /** @description Plan snapshot at time of purchase (null for credit topups) */
+            planSnapshot?: components["schemas"]["PlanSnapshotDto"];
             /**
              * Purchase status
              * @example active
              */
             status: string;
             /**
-             * Amount in cents
+             * Amount in USD cents (normalised for aggregation)
              * @example 9900
              */
             amount: number;
             /**
-             * Currency code
-             * @example USD
+             * Original amount in the payment currency (cents/pence)
+             * @example 10000
+             */
+            originalAmount?: number;
+            /**
+             * Original payment currency code
+             * @example GBP
              */
             currency: string;
+            /**
+             * Exchange rate from original currency to USD
+             * @example 1.3082
+             */
+            exchangeRate?: number;
             /** @description Start date */
             startDate: string;
             /** @description End date */
@@ -1637,191 +1077,1263 @@ interface components {
             nextBillingDate?: string;
             /** @description Auto-renew enabled */
             autoRenew?: boolean;
-            /** @description Whether this is a free tier purchase */
-            isFreeTier?: boolean;
             /** @description Cancelled at */
             cancelledAt?: string;
             /** @description Cancellation reason */
             cancellationReason?: string;
+            /** @description Arbitrary metadata attached to the purchase */
+            metadata?: {
+                [key: string]: unknown;
+            };
             /** @description Created at */
             createdAt: string;
         };
-        CancelPurchaseRequest: {
-            /** @description Reason for cancellation */
-            reason?: string;
+        CheckLimitRequest: {
+            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;
+        };
+        LimitBalanceDto: {
+            /** @description Credit balance in mils */
+            creditBalance: number;
+            /** @description Price per usage unit in mils */
+            pricePerUnit: number;
+            currency: string;
+            /** @description Estimated whole units remaining from prepaid balance at current pricePerUnit */
+            remainingUnits?: number;
+        };
+        LimitProductBriefDto: {
+            id?: string;
+            reference: string;
+            name?: string;
+        };
+        LimitResponse: {
+            /**
+             * Whether the customer is within their usage limits
+             * @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;
+            /** @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;
+            };
         };
-        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;
+    };
+    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;
+                };
+            };
         };
-        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;
+    };
+    CustomerSdkController_createCustomer: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Customer creation data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCustomerRequest"];
+            };
         };
-        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;
+        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;
+                };
+            };
         };
-        UpdateWebhookEndpointDto: {
-            /**
-             * Webhook endpoint URL
-             * @example https://example.com/webhook
-             */
-            url?: string;
-            /**
-             * Webhook endpoint description
-             * @example Updated webhook
-             */
-            description?: string;
+    };
+    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;
+                };
+            };
         };
-        UpdateThemePreferenceDto: {
-            /**
-             * Selected UI theme mode
-             * @example dark
-             * @enum {string}
-             */
-            mode: "light" | "dark";
+    };
+    CustomerSdkController_createCustomerSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Customer session creation request data */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCustomerSessionRequest"];
+            };
         };
-        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;
+        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;
+                };
+            };
         };
-        ThemeOverridesDto: {
-            /** @description Light mode color overrides */
-            light?: components["schemas"]["ThemeModeColorsDto"];
-            /** @description Dark mode color overrides */
-            dark?: components["schemas"]["ThemeModeColorsDto"];
+    };
+    UserInfoSdkController_getUserInfo: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UserInfoRequest"];
+            };
         };
-        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"];
+        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;
+            };
         };
-        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;
+    };
+    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"][];
+                    };
+                };
+            };
+        };
+    };
+    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;
+            };
+        };
+    };
+    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;
+            };
+        };
+    };
+    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;
+            };
+        };
+    };
+    PurchaseSdkController_cancelPurchase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Purchase reference or ID */
+                purchaseRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CancelPurchaseRequest"];
+            };
+        };
+        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;
+            };
+        };
+    };
+    LimitsSdkController_checkLimits: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CheckLimitRequest"];
+            };
+        };
+        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,10 @@ interface ProcessPaymentResult {
     oneTimePurchase?: OneTimePurchaseInfo;
     status: 'completed';
 }
-interface McpBootstrapFreePlanConfig {
-    name?: string;
-    freeUnits?: number;
-}
-interface McpBootstrapPaidPlanInput {
-    key: string;
-    name: string;
-    /** Price in cents (e.g. 2000 = $20.00) */
-    price: number;
-    currency: string;
-    billingCycle?: 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';
-    type?: 'recurring' | 'one-time';
-    freeUnits?: number;
-    meterId?: string;
-    limit?: number;
-    features?: Record<string, unknown>;
-}
-interface ToolPlanMappingInput {
-    name: string;
-    description?: string;
-    noPlan?: boolean;
-    planIds?: string[];
-    planRefs?: string[];
-    planKeys?: string[];
-}
-interface McpBootstrapRequest {
-    name?: string;
-    description?: string;
-    imageUrl?: string;
-    productType?: string;
-    originUrl: string;
-    /** Optional token combined with provider name to derive the final MCP subdomain. */
-    mcpDomain?: string;
-    authHeaderName?: string;
-    authApiKey?: string;
-    freePlan?: McpBootstrapFreePlanConfig;
-    paidPlans?: McpBootstrapPaidPlanInput[];
-    tools?: ToolPlanMappingInput[];
-    metadata?: Record<string, unknown>;
-}
+type McpBootstrapPlanInput = NonNullable<components['schemas']['McpBootstrapDto']['plans']>[number];
+type ToolPlanMappingInput = NonNullable<components['schemas']['McpBootstrapDto']['tools']>[number];
+type McpBootstrapRequest = components['schemas']['McpBootstrapDto'];
+type McpToolPlanMappingInput = NonNullable<components['schemas']['ConfigureMcpPlansDto']['toolMapping']>[number];
 interface McpBootstrapResponse {
     product: components['schemas']['SdkProductResponse'];
     mcpServer: {
@@ -1940,6 +2411,23 @@ interface McpBootstrapResponse {
         description?: string;
     }>;
 }
+type ConfigureMcpPlansRequest = components['schemas']['ConfigureMcpPlansDto'];
+interface ConfigureMcpPlansResponse {
+    product: components['schemas']['SdkProductResponse'];
+    mcpServer: {
+        id?: string;
+        reference?: string;
+        subdomain?: string;
+        mcpProxyUrl?: string;
+        url: string;
+        defaultPlanId?: string;
+    };
+    planMap: Record<string, {
+        id: string;
+        reference: string;
+        name?: string;
+    }>;
+}
 /**
  * SolvaPay API Client Interface
  *
@@ -1981,6 +2469,7 @@ interface SolvaPayClient {
         name: string;
     }>;
     bootstrapMcpProduct?(params: McpBootstrapRequest): Promise<McpBootstrapResponse>;
+    configureMcpPlans?(productRef: string, params: ConfigureMcpPlansRequest): Promise<ConfigureMcpPlansResponse>;
     updateProduct?(productRef: string, params: components['schemas']['UpdateProductRequest']): Promise<components['schemas']['SdkProductResponse']>;
     deleteProduct?(productRef: string): Promise<void>;
     cloneProduct?(productRef: string, overrides?: {
@@ -1989,29 +2478,11 @@ interface SolvaPayClient {
         reference: string;
         name: string;
     }>;
-    listPlans?(productRef: string): Promise<Array<{
-        reference: string;
-        price?: number;
-        currency?: string;
-        interval?: string;
-        isFreeTier?: boolean;
-        freeUnits?: number;
-        measures?: string;
-        limit?: number;
-        pricePerUnit?: number;
-        billingModel?: string;
-        metadata?: Record<string, unknown>;
-        [key: string]: unknown;
-    }>>;
+    listPlans?(productRef: string): Promise<components['schemas']['Plan'][]>;
     createPlan?(params: components['schemas']['CreatePlanRequest'] & {
         productRef: string;
-    }): Promise<{
-        reference: string;
-    }>;
-    updatePlan?(productRef: string, planRef: string, params: Partial<components['schemas']['CreatePlanRequest']>): Promise<{
-        reference: string;
-        [key: string]: unknown;
-    }>;
+    }): Promise<components['schemas']['Plan']>;
+    updatePlan?(productRef: string, planRef: string, params: components['schemas']['UpdatePlanRequest']): Promise<components['schemas']['Plan']>;
     deletePlan?(productRef: string, planRef: string): Promise<void>;
     createPaymentIntent?(params: {
         productRef: string;
@@ -2038,7 +2509,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 +2518,10 @@ interface SolvaPayClient {
  *
  * Types related to paywall protection, limits, and gating functionality.
  */
+
+type LimitPlanSummary = components['schemas']['LimitPlanItemDto'];
+type LimitActivationBalance = components['schemas']['LimitBalanceDto'];
+type LimitActivationProduct = components['schemas']['LimitProductBriefDto'];
 /**
  * Arguments passed to protected handlers
  */
@@ -2065,14 +2540,29 @@ interface PaywallMetadata {
     usageType?: 'requests' | 'tokens';
 }
 /**
- * Structured content for paywall errors
+ * Structured content for paywall errors (MCP structuredContent and manual handling).
  */
-interface PaywallStructuredContent {
+type PaywallStructuredContent = {
     kind: 'payment_required';
+    /** Product ref from paywall metadata (or env default) */
     product: string;
     checkoutUrl: string;
     message: string;
-}
+} | {
+    kind: 'activation_required';
+    /** Product ref from paywall metadata (or env default) */
+    product: string;
+    message: string;
+    /**
+     * Best URL for completing purchase or confirmation; mirrors confirmationUrl when present.
+     */
+    checkoutUrl: string;
+    confirmationUrl?: string;
+    plans?: LimitPlanSummary[];
+    balance?: LimitActivationBalance;
+    /** Rich product context from checkLimits (name, ref, provider slug/id) */
+    productDetails?: LimitActivationProduct;
+};
 /**
  * MCP tool result with optional paywall information
  */
@@ -2084,7 +2574,7 @@ interface PaywallToolResult {
         mimeType?: string;
     }>;
     isError?: boolean;
-    structuredContent?: PaywallStructuredContent;
+    structuredContent?: PaywallStructuredContent | Record<string, unknown>;
 }
 
 /**
@@ -2126,6 +2616,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 +2696,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
      */
@@ -2215,7 +2715,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[];
 }
@@ -2227,7 +2727,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;
@@ -2246,6 +2746,25 @@ declare const VIRTUAL_TOOL_DEFINITIONS: {
 }[];
 declare function createVirtualTools(apiClient: SolvaPayClient, options: VirtualToolsOptions): VirtualToolDefinition[];
 
+type ZodRawShape = Record<string, unknown>;
+type JsonSchemaProperty = {
+    type?: string;
+    enum?: unknown[];
+    items?: JsonSchemaProperty;
+    properties?: Record<string, JsonSchemaProperty>;
+};
+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;
+}
+declare function jsonSchemaToZodRawShape(properties: Record<string, JsonSchemaProperty>, required?: string[]): ZodRawShape;
+declare function registerVirtualToolsMcpImpl(server: McpServerLike, apiClient: SolvaPayClient, options: RegisterVirtualToolsMcpOptions): void;
+
 /**
  * Configuration for creating a SolvaPay instance.
  *
@@ -2363,7 +2882,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.
      *
@@ -2564,14 +3083,17 @@ interface SolvaPay {
         customerRef: string;
         productRef: string;
         planRef?: string;
-        meterName?: 'requests' | 'tokens';
-        usageType?: 'requests' | 'tokens';
+        meterName?: string;
+        usageType?: string;
     }): Promise<{
         withinLimits: boolean;
         remaining: number;
         plan: string;
         checkoutUrl?: string;
         meterName?: string;
+        creditBalance?: number;
+        pricePerUnit?: number;
+        currency?: string;
     }>;
     /**
      * Track usage for a customer action.
@@ -2635,6 +3157,7 @@ interface SolvaPay {
     createCustomer(params: {
         email: string;
         name?: string;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         customerRef: string;
     }>;
@@ -2736,6 +3259,13 @@ interface SolvaPay {
      * fast setup flows where you want one call for product + plans + MCP config.
      */
     bootstrapMcpProduct(params: McpBootstrapRequest): Promise<McpBootstrapResponse>;
+    /**
+     * Configure MCP plans and tool mappings for an existing MCP product.
+     *
+     * This helper wraps the backend MCP plans endpoint and supports adding/removing
+     * paid plans as well as remapping tool access.
+     */
+    configureMcpPlans(productRef: string, params: ConfigureMcpPlansRequest): Promise<ConfigureMcpPlansResponse>;
     /**
      * Get virtual tool definitions with bound handlers for MCP server integration.
      *
@@ -2755,7 +3285,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
@@ -2765,6 +3295,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.
      *
@@ -2936,6 +3473,78 @@ declare class PaywallError extends Error {
      */
     constructor(message: string, structuredContent: PaywallStructuredContent);
 }
+/** JSON body shape for HTTP adapters and MCP text content (stable fields for clients). */
+declare function paywallErrorToClientPayload(error: PaywallError): Record<string, unknown>;
+
+/**
+ * MCP OAuth helper utilities.
+ *
+ * These helpers are intentionally lightweight and do not verify JWT signatures.
+ * Use them after token validation (for example via /v1/customer/auth/userinfo).
+ */
+declare class McpBearerAuthError extends Error {
+    constructor(message: string);
+}
+type McpBearerCustomerRefOptions = {
+    claimPriority?: string[];
+};
+declare function extractBearerToken(authorization?: string | null): string | null;
+declare function decodeJwtPayload(token: string): Record<string, unknown>;
+declare function getCustomerRefFromJwtPayload(payload: Record<string, unknown>, options?: McpBearerCustomerRefOptions): string;
+declare function getCustomerRefFromBearerAuthHeader(authorization?: string | null, options?: McpBearerCustomerRefOptions): string;
+
+interface BuildAuthInfoFromBearerOptions extends McpBearerCustomerRefOptions {
+    clientId?: string;
+    defaultScopes?: string[];
+    includePayload?: boolean;
+}
+declare function buildAuthInfoFromBearer(authorization?: string | null, options?: BuildAuthInfoFromBearerOptions): McpToolExtra['authInfo'] | null;
+
+type RequestLike = {
+    method?: string;
+    path?: string;
+    headers?: Record<string, string | string[] | undefined>;
+    body?: unknown;
+    auth?: unknown;
+};
+type ResponseLike = {
+    status: (code: number) => ResponseLike;
+    json: (payload: unknown) => void;
+    setHeader: (name: string, value: string) => void;
+};
+type NextLike = () => void;
+type Middleware = (req: RequestLike, res: ResponseLike, next: NextLike) => void;
+interface OAuthAuthorizationServerOptions {
+    apiBaseUrl: string;
+    productRef: string;
+}
+interface McpOAuthBridgeOptions {
+    publicBaseUrl: string;
+    apiBaseUrl: string;
+    productRef: string;
+    mcpPath?: string;
+    requireAuth?: boolean;
+    authInfo?: BuildAuthInfoFromBearerOptions;
+    protectedResourcePath?: string;
+    authorizationServerPath?: string;
+}
+declare function getOAuthProtectedResourceResponse(publicBaseUrl: string): {
+    resource: string;
+    authorization_servers: string[];
+    scopes_supported: string[];
+};
+declare function getOAuthAuthorizationServerResponse({ apiBaseUrl, productRef, }: OAuthAuthorizationServerOptions): {
+    issuer: string;
+    authorization_endpoint: string;
+    token_endpoint: string;
+    registration_endpoint: string;
+    token_endpoint_auth_methods_supported: string[];
+    response_types_supported: string[];
+    grant_types_supported: string[];
+    scopes_supported: string[];
+    code_challenge_methods_supported: string[];
+};
+declare function createMcpOAuthBridge(options: McpOAuthBridgeOptions): Middleware[];
 
 /**
  * Utility functions for the SolvaPay Server SDK
@@ -2980,23 +3589,6 @@ declare class PaywallError extends Error {
  */
 declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
 
-/**
- * MCP OAuth helper utilities.
- *
- * These helpers are intentionally lightweight and do not verify JWT signatures.
- * Use them after token validation (for example via /v1/customer/auth/userinfo).
- */
-declare class McpBearerAuthError extends Error {
-    constructor(message: string);
-}
-type McpBearerCustomerRefOptions = {
-    claimPriority?: string[];
-};
-declare function extractBearerToken(authorization?: string | null): string | null;
-declare function decodeJwtPayload(token: string): Record<string, unknown>;
-declare function getCustomerRefFromJwtPayload(payload: Record<string, unknown>, options?: McpBearerCustomerRefOptions): string;
-declare function getCustomerRefFromBearerAuthHeader(authorization?: string | null, options?: McpBearerCustomerRefOptions): string;
-
 /**
  * Helper Types
  *
@@ -3304,11 +3896,12 @@ declare function cancelPurchaseCore(request: Request, body: {
  * This is a public route - no authentication required.
  */
 
+type Plan = components['schemas']['Plan'];
 /**
  * List plans - core implementation
  */
 declare function listPlansCore(request: Request): Promise<{
-    plans: Record<string, unknown>[];
+    plans: Plan[];
     productRef: string;
 } | ErrorResult>;
 
@@ -3367,4 +3960,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): WebhookEvent;
 
-export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerResponseMapped, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, McpBearerAuthError, type McpBootstrapFreePlanConfig, type McpBootstrapPaidPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, type WebhookEvent, type WebhookEventType, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createVirtualTools, decodeJwtPayload, extractBearerToken, getAuthenticatedUserCore, getCustomerRefFromBearerAuthHeader, getCustomerRefFromJwtPayload, handleRouteError, isErrorResult, listPlansCore, processPaymentIntentCore, syncCustomerCore, verifyWebhook, withRetry };
+export { type AuthenticatedUser, type ConfigureMcpPlansRequest, type ConfigureMcpPlansResponse, type CreateSolvaPayConfig, type CustomerResponseMapped, type CustomerWebhookObject, type ErrorResult, type HttpAdapterOptions, type LimitActivationBalance, type LimitActivationProduct, type LimitPlanSummary, type McpAdapterOptions, McpBearerAuthError, type McpBootstrapPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type McpServerLike, type McpToolExtra, type McpToolPlanMappingInput, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type RegisterVirtualToolsMcpOptions, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, type WebhookEvent, type WebhookEventForType, type WebhookEventObjectMap, type WebhookEventType, type WebhookProduct, buildAuthInfoFromBearer, cancelPurchaseCore, type components, createCheckoutSessionCore, createCustomerSessionCore, createMcpOAuthBridge, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createVirtualTools, decodeJwtPayload, extractBearerToken, getAuthenticatedUserCore, getCustomerRefFromBearerAuthHeader, getCustomerRefFromJwtPayload, getOAuthAuthorizationServerResponse, getOAuthProtectedResourceResponse, handleRouteError, isErrorResult, jsonSchemaToZodRawShape, listPlansCore, paywallErrorToClientPayload, processPaymentIntentCore, registerVirtualToolsMcpImpl, syncCustomerCore, verifyWebhook, withRetry };