@solvapay/server 1.0.0-preview.19 → 1.0.0-preview.20

package/dist/index.d.cts

@@ -1,11 +1,11 @@
 interface components {
     schemas: {
-        UpdateProviderProfileDto: Record<string, never>;
+        UpdateProviderDto: Record<string, never>;
         CreateSecretKey: Record<string, never>;
         CheckName: Record<string, never>;
         CreateAdminAgent: Record<string, never>;
         UpdateAdminAgent: Record<string, never>;
-        SdkAgentResponse: Record<string, never>;
+        Agent: Record<string, never>;
         CreateAgentRequest: Record<string, never>;
         UpdateAgentRequest: Record<string, never>;
         Signup: Record<string, never>;
@@ -20,80 +20,105 @@ interface components {
         UpdatePreferences: Record<string, never>;
         ChangePassword: Record<string, never>;
         RequestEmailChange: Record<string, never>;
-        CreateCheckoutSessionRequest: {
+        CreateProductRequest: {
             /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
+             * Product name
+             * @example AI Writing Assistant
              */
-            customerRef: string;
+            name: string;
             /**
-             * Agent reference identifier
-             * @example agt_1a2b3c4d5e6f
+             * Product description
+             * @example AI-powered writing tool
              */
-            agentRef: string;
+            description?: string;
+            /** URL to the product image */
+            imageUrl?: string;
             /**
-             * Plan reference identifier (optional)
-             * @example pln_2b3c4d5e6f7g
+             * Free-form product type defined by the provider
+             * @example Coding Assistant
              */
-            planRef?: string;
+            productType?: string;
             /**
-             * URL to redirect to after successful payment (optional)
-             * @example https://example.com/payment-success
+             * Whether this product uses MCP Pay proxy
+             * @default false
              */
-            returnUrl?: string;
+            isMcpPay: boolean;
+            /** Product-specific configuration */
+            config?: Record<string, never>;
+            /** Arbitrary key-value metadata */
+            metadata?: Record<string, never>;
         };
-        CheckoutSessionResponse: {
+        SdkProductResponse: {
             /**
-             * Checkout session ID
+             * Product ID
              * @example 507f1f77bcf86cd799439011
              */
             id: string;
             /**
-             * Public session ID used in checkout URL
-             * @example a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
-             */
-            sessionId: string;
-            /**
-             * Amount in cents
-             * @example 2999
+             * Product reference
+             * @example prd_1A2B3C4D
              */
-            amount: number;
+            reference: string;
             /**
-             * Currency code
-             * @example USD
+             * Product name
+             * @example AI Writing Assistant
              */
-            currency: string;
+            name: string;
+            /** Product description */
+            description?: string;
+            /** URL to the product image */
+            imageUrl?: string;
+            /** Free-form product type */
+            productType?: string;
             /**
-             * Session status
+             * Product status
              * @example active
              */
             status: string;
             /**
-             * Checkout URL to open the checkout page
-             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+             * Product balance in cents
+             * @example 0
              */
-            checkoutUrl: string;
-        };
-        CancelSubscriptionRequest: {
+            balance: number;
             /**
-             * Reason for cancellation
-             * @example Customer request
+             * Total number of transactions
+             * @example 0
              */
-            reason?: string;
-        };
-        CreateConnectedAccount: Record<string, never>;
-        UpdateConnectedAccount: Record<string, never>;
-        CreateCheckoutSessionResponse: {
+            totalTransactions: number;
             /**
-             * Checkout session ID/token
-             * @example e3f1c2d4b6a89f001122334455667788
+             * Whether this product uses MCP Pay proxy
+             * @example false
              */
-            sessionId: string;
+            isMcpPay: boolean;
+            /** Product-specific configuration */
+            config?: Record<string, never>;
+            /** Arbitrary key-value metadata */
+            metadata?: Record<string, never>;
+            /** Creation timestamp */
+            createdAt: string;
+            /** Last update timestamp */
+            updatedAt: string;
+            /** Plans associated with this product */
+            plans?: string[];
+        };
+        UpdateProductRequest: {
+            /** Product name */
+            name?: string;
+            /** Product description */
+            description?: string;
+            /** URL to the product image */
+            imageUrl?: string;
+            /** Free-form product type defined by the provider */
+            productType?: string;
             /**
-             * Full checkout URL based on backend configuration (ready to redirect customer)
-             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             * Product status
+             * @enum {string}
              */
-            checkoutUrl: string;
+            status?: "active" | "inactive" | "suspended";
+            /** Product-specific configuration */
+            config?: Record<string, never>;
+            /** Arbitrary key-value metadata */
+            metadata?: Record<string, never>;
         };
         CreatePlanRequest: {
             /**
@@ -113,7 +138,7 @@ interface components {
              */
             type?: "recurring" | "usage-based" | "hybrid" | "one-time";
             /**
-             * Billing cycle
+             * Billing cycle (required for recurring/hybrid, optional for post-paid usage-based)
              * @example monthly
              * @enum {string}
              */
@@ -144,8 +169,6 @@ interface components {
              * @example 100
              */
             freeUnits?: number;
-            /** @description Optional agent ID to associate plan with (not stored on plan, only used for initial association) */
-            agentId?: string;
             /**
              * Billing model for usage-based plans
              * @example pre-paid
@@ -178,16 +201,14 @@ interface components {
              */
             basePrice?: number;
             /**
-             * Usage limits
+             * Usage limits (shape varies by plan type)
              * @example {
-             *       "maxTransactions": 1000,
-             *       "maxCalls": 500,
-             *       "maxHours": 24
+             *       "maxTransactions": 1000
              *     }
              */
             limits?: Record<string, never>;
             /**
-             * Plan features (can be array of strings or object with boolean flags)
+             * Plan features (generic key/value, shape is provider-defined)
              * @example {
              *       "apiAccess": true,
              *       "prioritySupport": false
@@ -205,10 +226,11 @@ interface components {
              */
             requiresPayment?: boolean;
             /**
-             * Whether the plan is active
-             * @example true
+             * Plan status
+             * @example active
+             * @enum {string}
              */
-            isActive?: boolean;
+            status?: "active" | "inactive" | "archived";
             /**
              * Maximum number of active users
              * @example 10
@@ -219,10 +241,8 @@ interface components {
              * @example 30
              */
             accessExpiryDays?: number;
-            /** @description Additional metadata */
+            /** Additional metadata */
             metadata?: Record<string, never>;
-            /** @description Usage tracking (internal use, not validated) */
-            customerUsage?: Record<string, never>;
             /**
              * Whether this is the default plan
              * @example false
@@ -230,7 +250,95 @@ interface components {
             default?: boolean;
         };
         UpdatePlanRequest: Record<string, never>;
-        BasePlan: Record<string, never>;
+        CreateCheckoutSessionRequest: {
+            /**
+             * Customer reference
+             * @example cus_3c4d5e6f7g8h
+             */
+            customerReference: string;
+            /**
+             * Plan reference (optional)
+             * @example pln_2b3c4d5e6f7g
+             */
+            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;
+        };
+        CancelRenewalRequest: Record<string, never>;
+        UpdateConnectedAccount: Record<string, never>;
+        CancelPurchaseRequest: {
+            /** Reason for cancellation */
+            reason?: string;
+        };
+        CheckLimitRequest: {
+            /**
+             * Customer reference identifier
+             * @example cus_3C4D5E6F
+             */
+            customerRef: string;
+            /**
+             * Product reference identifier
+             * @example prd_1A2B3C4D
+             */
+            productRef: 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;
+        };
         CreateCustomerSessionRequest: {
             /**
              * Customer reference identifier
@@ -277,9 +385,9 @@ interface components {
              */
             externalRef?: string;
         };
-        SubscriptionInfo: {
+        PurchaseInfo: {
             /**
-             * Subscription reference
+             * Purchase reference
              * @example sub_abc123
              */
             reference: string;
@@ -289,12 +397,12 @@ interface components {
              */
             planName: string;
             /**
-             * Agent name
-             * @example AI Assistant
+             * Product reference
+             * @example prd_abc123
              */
-            agentName: string;
+            productReference?: string;
             /**
-             * Subscription status
+             * Purchase status
              * @example active
              */
             status: string;
@@ -314,12 +422,12 @@ interface components {
              */
             currency: string;
             /**
-             * End date of subscription
+             * End date of purchase
              * @example 2025-11-27T10:00:00Z
              */
             endDate?: string;
             /**
-             * When subscription was cancelled
+             * When purchase was cancelled
              * @example 2025-10-28T10:00:00Z
              */
             cancelledAt?: string;
@@ -350,8 +458,8 @@ interface components {
              * @example auth_user_12345
              */
             externalRef?: string;
-            /** @description Active subscriptions */
-            subscriptions?: components["schemas"]["SubscriptionInfo"][];
+            /** Active purchases */
+            purchases?: components["schemas"]["PurchaseInfo"][];
         };
         CreateCustomerSessionResponse: {
             /**
@@ -387,7 +495,7 @@ interface components {
              * @example 2025-01-01T12:00:00.000Z
              */
             expiresAt: string;
-            /** @description Customer object from session data */
+            /** Customer object from session data */
             customer: components["schemas"]["CustomerResponse"];
             /**
              * Session creation date
@@ -400,252 +508,173 @@ interface components {
              */
             updatedAt: string;
         };
-        CreateOAuthClientDto: Record<string, never>;
-        UpdateOAuthClientDto: Record<string, never>;
+        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 */
+            /** The authorization code returned by Google */
             code: string;
-            /** @description The redirect URI used in the initial authorization request */
+            /** The redirect URI used in the initial authorization request */
             redirect_uri: string;
-            /** @description The state parameter returned by Google (contains client_id) */
+            /** The state parameter returned by Google (contains client_id) */
             state: string;
         };
         GithubLoginDto: {
-            /** @description The authorization code returned by GitHub */
+            /** The authorization code returned by GitHub */
             code: string;
-            /** @description The redirect URI used in the initial authorization request */
+            /** The redirect URI used in the initial authorization request */
             redirect_uri: string;
-            /** @description The state parameter returned by GitHub (contains client_id) */
+            /** The state parameter returned by GitHub (contains client_id) */
             state: string;
         };
         ExecuteAnalyticsQuery: Record<string, never>;
         ExecuteMultipleQueries: Record<string, never>;
-        SubscriptionResponse: {
-            /**
-             * Subscription reference identifier
-             * @example sub_1a2b3c4d5e6f
-             */
-            reference: string;
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            customerRef: string;
-            /**
-             * Customer email
-             * @example customer@example.com
-             */
-            customerEmail: string;
-            /**
-             * Customer name
-             * @example John Doe
-             */
-            customerName?: string;
-            /**
-             * Agent reference identifier
-             * @example agt_1a2b3c4d5e6f
-             */
-            agentRef: string;
-            /**
-             * Agent name
-             * @example My AI Agent
-             */
-            agentName: string;
-            /**
-             * Plan reference identifier
-             * @example pln_1a2b3c4d5e6f
-             */
-            planRef: string;
-            /**
-             * Plan name
-             * @example Premium Plan
-             */
-            planName: string;
-            /**
-             * Plan type
-             * @example recurring
-             * @enum {string}
-             */
-            planType: "recurring" | "usage-based" | "one-time" | "hybrid";
+        UpdateThemePreferenceDto: {
             /**
-             * Subscription status
-             * @example active
+             * Selected UI theme mode
+             * @example dark
              * @enum {string}
              */
-            status: "pending" | "active" | "expired" | "cancelled" | "suspended" | "refunded";
-            /**
-             * Amount paid in original currency (in cents)
-             * @example 9900
-             */
-            amount: number;
-            /**
-             * Currency code
-             * @example USD
-             */
-            currency: string;
-            /**
-             * Start date of subscription
-             * @example 2025-01-01T00:00:00.000Z
-             */
-            startDate: string;
-            /**
-             * End date of subscription (if applicable)
-             * @example 2025-02-01T00:00:00.000Z
-             */
-            endDate?: string;
-            /**
-             * When payment was confirmed
-             * @example 2025-01-01T00:00:00.000Z
-             */
-            paidAt?: string;
-            /** @description Usage quota information (for usage-based plans) */
-            usageQuota?: Record<string, never>;
-            /**
-             * Whether this is a recurring subscription
-             * @example true
-             */
-            isRecurring: boolean;
-            /**
-             * Next billing date (for recurring subscriptions)
-             * @example 2025-02-01T00:00:00.000Z
-             */
-            nextBillingDate?: string;
-            /**
-             * When subscription was cancelled (if applicable)
-             * @example 2025-01-15T00:00:00.000Z
-             */
-            cancelledAt?: string;
-            /**
-             * Reason for cancellation (if applicable)
-             * @example Customer request
-             */
-            cancellationReason?: string;
-            /**
-             * When subscription was created
-             * @example 2025-01-01T00:00:00.000Z
-             */
-            createdAt: string;
-        };
-        CheckLimitRequest: {
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            customerRef: string;
-            /**
-             * Agent reference identifier
-             * @example agt_1a2b3c4d5e6f
-             */
-            agentRef: 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;
-            /**
-             * Optional checkout session ID/token if payment is required
-             * @example e3f1c2d4b6a89f001122334455667788
-             */
-            checkoutSessionId?: string;
-            /**
-             * Optional full checkout URL if payment is required (based on backend configuration)
-             * @example https://app.solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
-             */
-            checkoutUrl?: string;
+            mode: "light" | "dark";
         };
-        UsageEvent: {
-            /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            customerRef: string;
-            /**
-             * Agent reference identifier
-             * @example agt_1a2b3c4d5e6f
-             */
-            agentRef: string;
-            /**
-             * Outcome of the action
-             * @example success
-             * @enum {string}
-             */
-            outcome: "success" | "paywall" | "fail";
+        ThemeModeColorsDto: {
             /**
-             * Optional action identifier
-             * @example generate_text
+             * Page background color
+             * @example #f7f7f8
              */
-            action?: string;
+            background?: string;
             /**
-             * Unique request identifier matching the limits check
-             * @example req_1a2b3c4d5e6f
+             * Card/surface background color
+             * @example #ffffff
              */
-            requestId: string;
+            surface?: string;
             /**
-             * Duration of the action in milliseconds
-             * @example 1250
+             * Primary text color
+             * @example #181818
              */
-            actionDuration: number;
+            text?: string;
             /**
-             * ISO 8601 timestamp of when the action occurred
-             * @example 2025-10-21T10:30:00.000Z
+             * Secondary/muted text color
+             * @example #5c5c5c
              */
-            timestamp: string;
+            secondary?: string;
         };
-        UpdateThemePreferenceDto: {
-            /**
-             * Selected UI theme mode
-             * @example dark
-             * @enum {string}
-             */
-            mode: "light" | "dark";
+        ThemeOverridesDto: {
+            /** Light mode color overrides */
+            light?: components["schemas"]["ThemeModeColorsDto"];
+            /** Dark mode color overrides */
+            dark?: components["schemas"]["ThemeModeColorsDto"];
         };
-        CreatePageSettings: {
-            /** @description Page identifier */
-            id: string;
-            /** @description Page display name */
-            name: string;
-            /** @description Logo URL */
-            logo?: string;
+        UpdateBrandThemeDto: {
             /**
-             * Text color in hex format
-             * @example #2d3748
+             * Provider's brand name displayed on hosted pages
+             * @example Acme Corp
              */
-            textColor: string;
+            brandName: string;
             /**
-             * Button color in hex format
+             * Primary/accent color in hex format
              * @example #3182ce
              */
-            buttonColor: string;
-            /**
-             * Left background color in hex format
-             * @example #f7fafc
-             */
-            leftBackgroundColor: string;
-            /**
-             * Right background color in hex format
-             * @example #ffffff
-             */
-            rightBackgroundColor: string;
+            primaryColor: string;
             /**
-             * Font family
+             * Font family for hosted pages
+             * @default Inter
              * @example Inter
              */
             fontFamily: string;
             /**
-             * Font size
+             * Base font size
+             * @default 16px
              * @example 16px
              */
             fontSize: string;
+            /** Per-mode color overrides for light and dark themes */
+            themes?: components["schemas"]["ThemeOverridesDto"];
         };
         CreateWebhookEndpointDto: Record<string, never>;
         UpdateWebhookEndpointDto: Record<string, 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;
+            };
+        };
     };
     responses: never;
     parameters: never;
@@ -669,9 +698,8 @@ type LimitResponseWithPlan = components['schemas']['LimitResponse'] & {
 /**
  * Extended CustomerResponse with proper field mapping
  *
- * Note: The backend API may return subscriptions with additional fields beyond SubscriptionInfo
- * (e.g., amount, endDate, cancelledAt, cancellationReason) as defined in SubscriptionResponse.
- * These additional fields are preserved in the subscriptions array.
+ * Note: The backend API returns purchases as PurchaseInfo objects.
+ * Additional fields (paidAt, nextBillingDate) may be present in the response.
  */
 type CustomerResponseMapped = {
     customerRef: string;
@@ -679,12 +707,15 @@ type CustomerResponseMapped = {
     name?: string;
     externalRef?: string;
     plan?: string;
-    subscriptions?: Array<components['schemas']['SubscriptionInfo'] & Partial<Pick<components['schemas']['SubscriptionResponse'], 'amount' | 'currency' | 'endDate' | 'cancelledAt' | 'cancellationReason' | 'paidAt' | 'nextBillingDate'>>>;
+    purchases?: Array<components['schemas']['PurchaseInfo'] & {
+        paidAt?: string;
+        nextBillingDate?: string;
+    }>;
 };
 /**
- * Purchase information returned from payment processing
+ * One-time purchase information returned from payment processing
  */
-interface PurchaseInfo {
+interface OneTimePurchaseInfo {
     reference: string;
     productRef?: string;
     amount: number;
@@ -696,9 +727,9 @@ interface PurchaseInfo {
  * Result from processing a payment intent
  */
 interface ProcessPaymentResult {
-    type: 'subscription' | 'purchase';
-    subscription?: components['schemas']['SubscriptionInfo'];
-    purchase?: PurchaseInfo;
+    type: 'recurring' | 'one-time';
+    purchase?: components['schemas']['PurchaseInfo'];
+    oneTimePurchase?: OneTimePurchaseInfo;
     status: 'completed';
 }
 /**
@@ -710,8 +741,15 @@ interface ProcessPaymentResult {
  */
 interface SolvaPayClient {
     checkLimits(params: components['schemas']['CheckLimitRequest']): Promise<LimitResponseWithPlan>;
-    trackUsage(params: components['schemas']['UsageEvent'] & {
+    trackUsage(params: {
+        customerRef: string;
+        productRef: string;
         planRef: string;
+        outcome: string;
+        action?: string;
+        requestId?: string;
+        actionDuration?: number;
+        timestamp?: string;
     }): Promise<void>;
     createCustomer?(params: components['schemas']['CreateCustomerRequest']): Promise<{
         customerRef: string;
@@ -719,18 +757,21 @@ interface SolvaPayClient {
     getCustomer(params: {
         customerRef?: string;
         externalRef?: string;
+        email?: string;
     }): Promise<CustomerResponseMapped>;
-    listAgents?(): Promise<Array<{
+    listProducts?(): Promise<Array<{
         reference: string;
         name: string;
         description?: string;
+        status?: string;
     }>>;
-    createAgent?(params: components['schemas']['CreateAgentRequest']): Promise<{
+    createProduct?(params: components['schemas']['CreateProductRequest']): Promise<{
         reference: string;
         name: string;
     }>;
-    deleteAgent?(agentRef: string): Promise<void>;
-    listPlans?(agentRef: string): Promise<Array<{
+    updateProduct?(productRef: string, params: components['schemas']['UpdateProductRequest']): Promise<components['schemas']['SdkProductResponse']>;
+    deleteProduct?(productRef: string): Promise<void>;
+    listPlans?(productRef: string): Promise<Array<{
         reference: string;
         name: string;
         description?: string;
@@ -739,18 +780,18 @@ interface SolvaPayClient {
         interval?: string;
         isFreeTier?: boolean;
         freeUnits?: number;
-        metadata?: Record<string, any>;
-        [key: string]: any;
+        metadata?: Record<string, unknown>;
+        [key: string]: unknown;
     }>>;
     createPlan?(params: components['schemas']['CreatePlanRequest'] & {
-        agentRef: string;
+        productRef: string;
     }): Promise<{
         reference: string;
         name: string;
     }>;
-    deletePlan?(agentRef: string, planRef: string): Promise<void>;
+    deletePlan?(productRef: string, planRef: string): Promise<void>;
     createPaymentIntent?(params: {
-        agentRef: string;
+        productRef: string;
         planRef: string;
         customerRef: string;
         idempotencyKey?: string;
@@ -760,17 +801,17 @@ interface SolvaPayClient {
         publishableKey: string;
         accountId?: string;
     }>;
-    cancelSubscription?(params: {
-        subscriptionRef: string;
+    cancelPurchase?(params: {
+        purchaseRef: string;
         reason?: string;
-    }): Promise<components['schemas']['SubscriptionResponse']>;
-    processPayment?(params: {
+    }): Promise<components['schemas']['PurchaseInfo']>;
+    processPaymentIntent?(params: {
         paymentIntentId: string;
-        agentRef: string;
+        productRef: string;
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
-    createCheckoutSession(params: components['schemas']['CreateCheckoutSessionRequest']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
+    createCheckoutSession(params: components['schemas']['CreateCheckoutSessionRequest']): Promise<components['schemas']['CheckoutSessionResponse']>;
     createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
 }
 
@@ -783,7 +824,7 @@ interface SolvaPayClient {
  * Arguments passed to protected handlers
  */
 interface PaywallArgs {
-    [key: string]: any;
+    [key: string]: unknown;
     auth?: {
         customer_ref?: string;
     };
@@ -792,7 +833,7 @@ interface PaywallArgs {
  * Metadata for configuring paywall protection
  */
 interface PaywallMetadata {
-    agent?: string;
+    product?: string;
     plan?: string;
 }
 /**
@@ -800,7 +841,7 @@ interface PaywallMetadata {
  */
 interface PaywallStructuredContent {
     kind: 'payment_required';
-    agent: string;
+    product: string;
     checkoutUrl: string;
     message: string;
 }
@@ -862,15 +903,15 @@ interface RetryOptions {
  */
 interface PayableOptions {
     /**
-     * Agent identifier (auto-detected from package.json if not provided)
+     * Product identifier
      */
-    agent?: string;
+    product?: string;
     /**
-     * Agent reference (alias for agent, preferred for consistency with backend API)
+     * Product reference (alias for product, preferred for consistency with backend API)
      */
-    agentRef?: string;
+    productRef?: string;
     /**
-     * Plan identifier (defaults to agent name if not provided)
+     * Plan identifier (defaults to product name if not provided)
      */
     plan?: string;
     /**
@@ -978,7 +1019,7 @@ interface CreateSolvaPayConfig {
  *
  * @example
  * ```typescript
- * const payable = solvaPay.payable({ agent: 'agt_myapi', plan: 'pln_premium' });
+ * const payable = solvaPay.payable({ product: 'prd_myapi', plan: 'pln_premium' });
  *
  * // Express.js
  * app.post('/tasks', payable.http(createTask));
@@ -1009,7 +1050,7 @@ interface PayableFunction {
      * }));
      * ```
      */
-    http<T = any>(businessLogic: (args: any) => Promise<T>, options?: HttpAdapterOptions): (req: any, reply: any) => Promise<any>;
+    http<T = any>(businessLogic: (args: any) => Promise<T>, options?: HttpAdapterOptions): (req: any, reply: any) => Promise<unknown>;
     /**
      * Next.js adapter for App Router API routes.
      *
@@ -1041,7 +1082,7 @@ interface PayableFunction {
      * });
      * ```
      */
-    mcp<T = any>(businessLogic: (args: any) => Promise<T>, options?: McpAdapterOptions): (args: any) => Promise<any>;
+    mcp<T = any>(businessLogic: (args: any) => Promise<T>, options?: McpAdapterOptions): (args: Record<string, unknown>) => Promise<unknown>;
     /**
      * Pure function adapter for direct function protection.
      *
@@ -1076,32 +1117,32 @@ interface PayableFunction {
  * const solvaPay = createSolvaPay();
  *
  * // Create payable handlers
- * const payable = solvaPay.payable({ agent: 'agt_myapi', plan: 'pln_premium' });
- *
- * // Manage customers
- * const customerRef = await solvaPay.ensureCustomer('user_123', 'user_123', {
- *   email: 'user@example.com'
- * });
- *
- * // Create payment intents
- * const intent = await solvaPay.createPaymentIntent({
- *   agentRef: 'agt_myapi',
- *   planRef: 'pln_premium',
- *   customerRef: 'user_123'
- * });
+   * const payable = solvaPay.payable({ product: 'prd_myapi', plan: 'pln_premium' });
+   *
+   * // Manage customers
+   * const customerRef = await solvaPay.ensureCustomer('user_123', 'user_123', {
+   *   email: 'user@example.com'
+   * });
+   *
+   * // Create payment intents
+   * const intent = await solvaPay.createPaymentIntent({
+   *   productRef: 'prd_myapi',
+   *   planRef: 'pln_premium',
+   *   customerRef: 'user_123'
+   * });
  * ```
  */
 interface SolvaPay {
     /**
      * Create a payable handler with explicit adapters for different frameworks.
      *
-     * @param options - Payable options including agent and plan references
+     * @param options - Payable options including product and plan references
      * @returns PayableFunction with framework-specific adapters
      *
      * @example
      * ```typescript
      * const payable = solvaPay.payable({
-     *   agent: 'agt_myapi',
+     *   product: 'prd_myapi',
      *   plan: 'pln_premium'
      * });
      *
@@ -1143,15 +1184,15 @@ interface SolvaPay {
         name?: string;
     }): Promise<string>;
     /**
-     * Create a Stripe payment intent for a customer to subscribe to a plan.
+     * Create a Stripe payment intent for a customer to purchase a plan.
      *
      * This creates a payment intent that can be confirmed on the client side
-     * using Stripe.js. After confirmation, call `processPayment()` to complete
-     * the subscription.
+     * using Stripe.js. After confirmation, call `processPaymentIntent()` to complete
+     * the purchase.
      *
      * @param params - Payment intent parameters
-     * @param params.agentRef - Agent reference
-     * @param params.planRef - Plan reference to subscribe to
+     * @param params.productRef - Product reference
+     * @param params.planRef - Plan reference to purchase
      * @param params.customerRef - Customer reference
      * @param params.idempotencyKey - Optional idempotency key for retry safety
      * @returns Payment intent with client secret and publishable key
@@ -1159,7 +1200,7 @@ interface SolvaPay {
      * @example
      * ```typescript
      * const intent = await solvaPay.createPaymentIntent({
-     *   agentRef: 'agt_myapi',
+     *   productRef: 'prd_myapi',
      *   planRef: 'pln_premium',
      *   customerRef: 'user_123',
      *   idempotencyKey: 'unique-key-123'
@@ -1169,7 +1210,7 @@ interface SolvaPay {
      * ```
      */
     createPaymentIntent(params: {
-        agentRef: string;
+        productRef: string;
         planRef: string;
         customerRef: string;
         idempotencyKey?: string;
@@ -1182,53 +1223,53 @@ interface SolvaPay {
     /**
      * Process a payment intent after client-side Stripe confirmation.
      *
-     * Creates subscription or purchase immediately, eliminating webhook delay.
+     * Creates the purchase immediately, eliminating webhook delay.
      * Call this after the client has confirmed the payment intent with Stripe.js.
      *
      * @param params - Payment processing parameters
      * @param params.paymentIntentId - Stripe payment intent ID from client confirmation
-     * @param params.agentRef - Agent reference
+     * @param params.productRef - Product reference
      * @param params.customerRef - Customer reference
      * @param params.planRef - Optional plan reference (if not in payment intent)
-     * @returns Payment processing result with subscription details
+     * @returns Payment processing result with purchase details
      *
      * @example
      * ```typescript
      * // After client confirms payment with Stripe.js
-     * const result = await solvaPay.processPayment({
+     * const result = await solvaPay.processPaymentIntent({
      *   paymentIntentId: 'pi_1234567890',
-     *   agentRef: 'agt_myapi',
+     *   productRef: 'prd_myapi',
      *   customerRef: 'user_123',
      *   planRef: 'pln_premium'
      * });
      *
      * if (result.success) {
-     *   console.log('Subscription created:', result.subscriptionRef);
+     *   console.log('Purchase created:', result.purchase);
      * }
      * ```
      */
-    processPayment(params: {
+    processPaymentIntent(params: {
         paymentIntentId: string;
-        agentRef: string;
+        productRef: string;
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
     /**
-     * Check if customer is within usage limits for an agent.
+     * Check if customer is within usage limits for a product.
      *
-     * This method checks subscription status and usage limits without
+     * This method checks purchase status and usage limits without
      * executing business logic. Use `payable()` for automatic protection.
      *
      * @param params - Limit check parameters
      * @param params.customerRef - Customer reference
-     * @param params.agentRef - Agent reference
+     * @param params.productRef - Product reference
      * @returns Limit check result with remaining usage and checkout URL if needed
      *
      * @example
      * ```typescript
      * const limits = await solvaPay.checkLimits({
      *   customerRef: 'user_123',
-     *   agentRef: 'agt_myapi'
+     *   productRef: 'prd_myapi'
      * });
      *
      * if (!limits.withinLimits) {
@@ -1239,7 +1280,7 @@ interface SolvaPay {
      */
     checkLimits(params: {
         customerRef: string;
-        agentRef: string;
+        productRef: string;
     }): Promise<{
         withinLimits: boolean;
         remaining: number;
@@ -1254,7 +1295,7 @@ interface SolvaPay {
      *
      * @param params - Usage tracking parameters
      * @param params.customerRef - Customer reference
-     * @param params.agentRef - Agent reference
+     * @param params.productRef - Product reference
      * @param params.planRef - Plan reference
      * @param params.outcome - Action outcome ('success', 'paywall', or 'fail')
      * @param params.action - Optional action name for analytics
@@ -1266,7 +1307,7 @@ interface SolvaPay {
      * ```typescript
      * await solvaPay.trackUsage({
      *   customerRef: 'user_123',
-     *   agentRef: 'agt_myapi',
+     *   productRef: 'prd_myapi',
      *   planRef: 'pln_premium',
      *   outcome: 'success',
      *   action: 'api_call',
@@ -1278,7 +1319,7 @@ interface SolvaPay {
      */
     trackUsage(params: {
         customerRef: string;
-        agentRef: string;
+        productRef: string;
         planRef: string;
         outcome: 'success' | 'paywall' | 'fail';
         action?: string;
@@ -1312,15 +1353,15 @@ interface SolvaPay {
         customerRef: string;
     }>;
     /**
-     * Get customer details including subscriptions and usage.
+     * Get customer details including purchases and usage.
      *
      * Returns full customer information from the SolvaPay backend, including
-     * all active subscriptions, usage history, and customer metadata.
+     * all active purchases, usage history, and customer metadata.
      *
      * @param params - Customer lookup parameters
      * @param params.customerRef - Optional customer reference (SolvaPay ID)
      * @param params.externalRef - Optional external reference (e.g., Supabase ID)
-     * @returns Customer details with subscriptions and metadata
+     * @returns Customer details with purchases and metadata
      *
      * @example
      * ```typescript
@@ -1346,7 +1387,7 @@ interface SolvaPay {
      * to a hosted payment page. After payment, customer is redirected back.
      *
      * @param params - Checkout session parameters
-     * @param params.agentRef - Agent reference
+     * @param params.productRef - Product reference
      * @param params.customerRef - Customer reference
      * @param params.planRef - Optional plan reference (if not specified, shows plan selector)
      * @param params.returnUrl - URL to redirect to after successful payment
@@ -1355,7 +1396,7 @@ interface SolvaPay {
      * @example
      * ```typescript
      * const session = await solvaPay.createCheckoutSession({
-     *   agentRef: 'agt_myapi',
+     *   productRef: 'prd_myapi',
      *   customerRef: 'user_123',
      *   planRef: 'pln_premium',
      *   returnUrl: 'https://myapp.com/success'
@@ -1366,7 +1407,7 @@ interface SolvaPay {
      * ```
      */
     createCheckoutSession(params: {
-        agentRef: string;
+        productRef: string;
         customerRef: string;
         planRef?: string;
         returnUrl?: string;
@@ -1375,10 +1416,10 @@ interface SolvaPay {
         checkoutUrl: string;
     }>;
     /**
-     * Create a customer portal session for managing subscriptions.
+     * Create a customer portal session for managing purchases.
      *
      * This creates a Stripe Customer Portal session that allows customers
-     * to manage their subscriptions, update payment methods, and view invoices.
+     * to manage their purchases, update payment methods, and view invoices.
      *
      * @param params - Customer session parameters
      * @param params.customerRef - Customer reference
@@ -1404,12 +1445,12 @@ interface SolvaPay {
      * Direct access to the API client for advanced operations.
      *
      * Use this for operations not exposed by the SolvaPay interface,
-     * such as agent/plan management or custom API calls.
+     * such as product/plan management or custom API calls.
      *
      * @example
      * ```typescript
      * // Access API client directly for custom operations
-     * const agents = await solvaPay.apiClient.listAgents();
+     * const products = await solvaPay.apiClient.listProducts();
      * ```
      */
     apiClient: SolvaPayClient;
@@ -1419,7 +1460,7 @@ interface SolvaPay {
  *
  * This factory function creates a SolvaPay instance that can be used to
  * protect API endpoints, functions, and MCP tools with usage limits and
- * subscription checks.
+   * purchase checks.
  *
  * @param config - Optional configuration object
  * @param config.apiKey - API key for production use (defaults to `SOLVAPAY_SECRET_KEY` env var)
@@ -1442,9 +1483,9 @@ interface SolvaPay {
  *   apiClient: mockClient
  * });
  *
- * // Create payable handlers for your agent
+ * // Create payable handlers for your product
  * const payable = solvaPay.payable({
- *   agent: 'agt_myapi',
+ *   product: 'prd_myapi',
  *   plan: 'pln_premium'
  * });
  *
@@ -1509,7 +1550,7 @@ type ServerClientOptions = {
  * });
  *
  * // Use client for custom operations
- * const agents = await client.listAgents();
+ * const products = await client.listProducts();
  * ```
  *
  * @see {@link createSolvaPay} for the recommended high-level API
@@ -1528,10 +1569,10 @@ declare function createSolvaPayClient(opts: ServerClientOptions): SolvaPayClient
  */
 
 /**
- * Error thrown when a paywall is triggered (subscription required or usage limit exceeded).
+ * Error thrown when a paywall is triggered (purchase required or usage limit exceeded).
  *
  * This error is automatically thrown by the paywall protection system when:
- * - Customer doesn't have required subscription
+ * - Customer doesn't have required purchase
  * - Customer has exceeded usage limits
  * - Customer needs to upgrade their plan
  *
@@ -1750,7 +1791,7 @@ declare function syncCustomerCore(request: Request, options?: {
 }): Promise<string | ErrorResult>;
 
 /**
- * Create a Stripe payment intent for a customer to subscribe to a plan.
+ * Create a Stripe payment intent for a customer to purchase a plan.
  *
  * This is a framework-agnostic helper that:
  * 1. Extracts authenticated user from the request
@@ -1758,12 +1799,12 @@ declare function syncCustomerCore(request: Request, options?: {
  * 3. Creates a payment intent for the specified plan
  *
  * The payment intent can then be confirmed on the client side using Stripe.js.
- * After confirmation, use `processPaymentCore()` to complete the subscription.
+ * After confirmation, use `processPaymentIntentCore()` to complete the purchase.
  *
  * @param request - Standard Web API Request object
  * @param body - Payment intent parameters
- * @param body.planRef - Plan reference to subscribe to (required)
- * @param body.agentRef - Agent reference (required)
+ * @param body.planRef - Plan reference to purchase (required)
+ * @param body.productRef - Product reference (required)
  * @param options - Configuration options
  * @param options.solvaPay - Optional SolvaPay instance (creates new one if not provided)
  * @param options.includeEmail - Whether to include email in customer data (default: true)
@@ -1785,13 +1826,13 @@ declare function syncCustomerCore(request: Request, options?: {
  * }
  * ```
  *
- * @see {@link processPaymentCore} for processing confirmed payments
+ * @see {@link processPaymentIntentCore} for processing confirmed payments
  * @see {@link ErrorResult} for error handling
  * @since 1.0.0
  */
 declare function createPaymentIntentCore(request: Request, body: {
     planRef: string;
-    agentRef: string;
+    productRef: string;
 }, options?: {
     solvaPay?: SolvaPay;
     includeEmail?: boolean;
@@ -1807,7 +1848,7 @@ declare function createPaymentIntentCore(request: Request, body: {
  * Process a payment intent after client-side Stripe confirmation.
  *
  * This helper processes a payment intent that has been confirmed on the client
- * side using Stripe.js. It creates the subscription or purchase immediately,
+ * side using Stripe.js. It creates the purchase immediately,
  * eliminating webhook delay.
  *
  * Call this after the client has confirmed the payment intent with Stripe.js.
@@ -1815,27 +1856,23 @@ declare function createPaymentIntentCore(request: Request, body: {
  * @param request - Standard Web API Request object
  * @param body - Payment processing parameters
  * @param body.paymentIntentId - Stripe payment intent ID from client confirmation (required)
- * @param body.agentRef - Agent reference (required)
+ * @param body.productRef - Product reference (required)
  * @param body.planRef - Optional plan reference (if not in payment intent)
  * @param options - Configuration options
  * @param options.solvaPay - Optional SolvaPay instance (creates new one if not provided)
- * @returns Process payment result with subscription details, or error result
+ * @returns Process payment result with purchase details, or error result
  *
  * @example
  * ```typescript
  * // In an API route handler
  * export async function POST(request: Request) {
  *   const body = await request.json();
- *   const result = await processPaymentCore(request, body);
+ *   const result = await processPaymentIntentCore(request, body);
  *
  *   if (isErrorResult(result)) {
  *     return Response.json(result, { status: result.status });
  *   }
  *
- *   if (result.success) {
- *     console.log('Subscription created:', result.subscriptionRef);
- *   }
- *
  *   return Response.json(result);
  * }
  * ```
@@ -1844,9 +1881,9 @@ declare function createPaymentIntentCore(request: Request, body: {
  * @see {@link ErrorResult} for error handling
  * @since 1.0.0
  */
-declare function processPaymentCore(request: Request, body: {
+declare function processPaymentIntentCore(request: Request, body: {
     paymentIntentId: string;
-    agentRef: string;
+    productRef: string;
     planRef?: string;
 }, options?: {
     solvaPay?: SolvaPay;
@@ -1868,7 +1905,7 @@ declare function processPaymentCore(request: Request, body: {
  * @returns Checkout session response or error result
  */
 declare function createCheckoutSessionCore(request: Request, body: {
-    agentRef: string;
+    productRef: string;
     planRef?: string;
     returnUrl?: string;
 }, options?: {
@@ -1897,26 +1934,26 @@ declare function createCustomerSessionCore(request: Request, options?: {
 } | ErrorResult>;
 
 /**
- * Subscription Helpers (Core)
+ * Purchase Cancellation Helpers (Core)
  *
- * Generic helpers for subscription operations.
+ * Generic helpers for purchase cancellation operations.
  * Works with standard Web API Request (works everywhere).
  */
 
 /**
- * Cancel subscription - core implementation
+ * Cancel purchase - core implementation
  *
  * @param request - Standard Web API Request
  * @param body - Cancellation parameters
  * @param options - Configuration options
- * @returns Cancelled subscription response or error result
+ * @returns Cancelled purchase response or error result
  */
-declare function cancelSubscriptionCore(request: Request, body: {
-    subscriptionRef: string;
+declare function cancelPurchaseCore(request: Request, body: {
+    purchaseRef: string;
     reason?: string;
 }, options?: {
     solvaPay?: SolvaPay;
-}): Promise<any | ErrorResult>;
+}): Promise<Record<string, unknown> | ErrorResult>;
 
 /**
  * Plans Helper (Core)
@@ -1928,13 +1965,10 @@ declare function cancelSubscriptionCore(request: Request, body: {
 
 /**
  * List plans - core implementation
- *
- * @param request - Standard Web API Request
- * @returns Plans response or error result
  */
 declare function listPlansCore(request: Request): Promise<{
-    plans: any[];
-    agentRef: string;
+    plans: Record<string, unknown>[];
+    productRef: string;
 } | ErrorResult>;
 
 /**
@@ -1973,8 +2007,8 @@ declare function listPlansCore(request: Request): Promise<{
  *     });
  *
  *     // Handle webhook event
- *     if (payload.type === 'subscription.created') {
- *       // Process subscription creation
+ *     if (payload.type === 'purchase.created') {
+ *       // Process purchase creation
  *     }
  *
  *     res.json({ received: true });
@@ -1993,4 +2027,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): any;
 
-export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerResponseMapped, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, type NextAdapterOptions, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type PurchaseInfo, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, cancelSubscriptionCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, getAuthenticatedUserCore, handleRouteError, isErrorResult, listPlansCore, processPaymentCore, syncCustomerCore, verifyWebhook, withRetry };
+export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerResponseMapped, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, 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, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, getAuthenticatedUserCore, handleRouteError, isErrorResult, listPlansCore, processPaymentIntentCore, syncCustomerCore, verifyWebhook, withRetry };