@solvapay/server 1.0.0-preview.7 → 1.0.0-preview.9

package/dist/edge.d.ts

@@ -24,20 +24,25 @@ interface components {
         ExecuteMultipleQueries: Record<string, never>;
         CreateCheckoutSessionRequest: {
             /**
-             * @description Customer reference
+             * @description Customer reference identifier
              * @example cus_3c4d5e6f7g8h
              */
-            customerReference: string;
+            customerRef: string;
             /**
-             * @description Plan reference (optional)
+             * @description Agent reference identifier
+             * @example agt_1a2b3c4d5e6f
+             */
+            agentRef: string;
+            /**
+             * @description Plan reference identifier (optional)
              * @example pln_2b3c4d5e6f7g
              */
             planRef?: string;
             /**
-             * @description Agent reference (optional)
-             * @example agt_1a2b3c4d5e6f
+             * @description URL to redirect to after successful payment (optional)
+             * @example https://example.com/payment-success
              */
-            agentRef?: string;
+            returnUrl?: string;
         };
         CheckoutSessionResponse: {
             /**
@@ -67,7 +72,7 @@ interface components {
             status: string;
             /**
              * @description Checkout URL to open the checkout page
-             * @example http://localhost:3000/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
              */
             checkoutUrl: string;
         };
@@ -102,15 +107,15 @@ interface components {
              */
             remaining: number;
             /**
-             * @description Optional checkout URL if payment is required
-             * @example https://checkout.solvapay.com/pay_1a2b3c4d
-             */
-            checkoutUrl?: string;
-            /**
-             * @description Optional checkout session ID if payment is required
+             * @description Optional checkout session ID/token if payment is required
              * @example e3f1c2d4b6a89f001122334455667788
              */
             checkoutSessionId?: string;
+            /**
+             * @description Optional full checkout URL if payment is required (based on backend configuration)
+             * @example https://app.solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             */
+            checkoutUrl?: string;
         };
         UsageEvent: {
             /**
@@ -218,6 +223,60 @@ interface components {
             /** @description Active subscriptions */
             subscriptions?: components["schemas"]["SubscriptionInfo"][];
         };
+        CreateCustomerSessionRequest: {
+            /**
+             * @description Customer reference identifier
+             * @example cus_3c4d5e6f7g8h
+             */
+            customerRef: string;
+        };
+        CreateCustomerSessionResponse: {
+            /**
+             * @description Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+        };
+        GetCustomerSessionResponse: {
+            /**
+             * @description Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Session status
+             * @example active
+             * @enum {string}
+             */
+            status: "active" | "expired" | "used";
+            /**
+             * @description Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+            /**
+             * @description Session expiration date
+             * @example 2025-01-01T12:00:00.000Z
+             */
+            expiresAt: string;
+            /** @description Customer object from session data */
+            customer: components["schemas"]["CustomerResponse"];
+            /**
+             * @description Session creation date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            createdAt: string;
+            /**
+             * @description Session last update date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            updatedAt: string;
+        };
         Agent: Record<string, never>;
         CreateAgentRequest: Record<string, never>;
         UpdateAgentRequest: Record<string, never>;
@@ -328,6 +387,18 @@ interface components {
              */
             createdAt: string;
         };
+        CreateCheckoutSessionResponse: {
+            /**
+             * @description Checkout session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Full checkout URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             */
+            checkoutUrl: string;
+        };
         CreatePageSettings: {
             /** @description Page identifier */
             id: string;
@@ -488,6 +559,8 @@ interface SolvaPayClient {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    createCheckoutSession(params: components['schemas']['CreateCheckoutSessionRequest']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
+    createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
 }
 
 /**
@@ -822,6 +895,26 @@ interface SolvaPay {
             startDate: string;
         }>;
     }>;
+    /**
+     * Create a checkout session for a customer
+     */
+    createCheckoutSession(params: {
+        agentRef: string;
+        customerRef: string;
+        planRef?: string;
+    }): Promise<{
+        sessionId: string;
+        checkoutUrl: string;
+    }>;
+    /**
+     * Create a customer session for accessing customer-specific functionality
+     */
+    createCustomerSession(params: {
+        customerRef: string;
+    }): Promise<{
+        sessionId: string;
+        customerUrl: string;
+    }>;
     /**
      * Direct access to the API client for advanced operations
      * (agent/plan management, etc.)

package/dist/edge.js

@@ -308,6 +308,38 @@ function createSolvaPayClient(opts) {
         throw new SolvaPayError(`Invalid subscription data in cancel subscription response`);
       }
       return result;
+    },
+    // POST: /v1/sdk/checkout-sessions
+    async createCheckoutSession(params) {
+      const url = `${base}/v1/sdk/checkout-sessions`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(`Create checkout session failed (${res.status}): ${error}`);
+      }
+      const result = await res.json();
+      return result;
+    },
+    // POST: /v1/sdk/customers/customer-sessions
+    async createCustomerSession(params) {
+      const url = `${base}/v1/sdk/customers/customer-sessions`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(`Create customer session failed (${res.status}): ${error}`);
+      }
+      const result = await res.json();
+      return result;
     }
   };
 }
@@ -984,6 +1016,12 @@ function createSolvaPay(config) {
       }
       return apiClient.getCustomer(params);
     },
+    createCheckoutSession(params) {
+      return apiClient.createCheckoutSession(params);
+    },
+    createCustomerSession(params) {
+      return apiClient.createCustomerSession(params);
+    },
     // Payable API for framework-specific handlers
     payable(options = {}) {
       const agent = options.agentRef || options.agent || process.env.SOLVAPAY_AGENT || getPackageJsonName() || "default-agent";

package/dist/index.cjs

@@ -4567,6 +4567,38 @@ function createSolvaPayClient(opts) {
         throw new import_core.SolvaPayError(`Invalid subscription data in cancel subscription response`);
       }
       return result;
+    },
+    // POST: /v1/sdk/checkout-sessions
+    async createCheckoutSession(params) {
+      const url = `${base}/v1/sdk/checkout-sessions`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new import_core.SolvaPayError(`Create checkout session failed (${res.status}): ${error}`);
+      }
+      const result = await res.json();
+      return result;
+    },
+    // POST: /v1/sdk/customers/customer-sessions
+    async createCustomerSession(params) {
+      const url = `${base}/v1/sdk/customers/customer-sessions`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new import_core.SolvaPayError(`Create customer session failed (${res.status}): ${error}`);
+      }
+      const result = await res.json();
+      return result;
     }
   };
 }
@@ -5243,6 +5275,12 @@ function createSolvaPay(config) {
       }
       return apiClient.getCustomer(params);
     },
+    createCheckoutSession(params) {
+      return apiClient.createCheckoutSession(params);
+    },
+    createCustomerSession(params) {
+      return apiClient.createCustomerSession(params);
+    },
     // Payable API for framework-specific handlers
     payable(options = {}) {
       const agent = options.agentRef || options.agent || process.env.SOLVAPAY_AGENT || getPackageJsonName() || "default-agent";

package/dist/index.d.cts

@@ -24,20 +24,25 @@ interface components {
         ExecuteMultipleQueries: Record<string, never>;
         CreateCheckoutSessionRequest: {
             /**
-             * @description Customer reference
+             * @description Customer reference identifier
              * @example cus_3c4d5e6f7g8h
              */
-            customerReference: string;
+            customerRef: string;
             /**
-             * @description Plan reference (optional)
+             * @description Agent reference identifier
+             * @example agt_1a2b3c4d5e6f
+             */
+            agentRef: string;
+            /**
+             * @description Plan reference identifier (optional)
              * @example pln_2b3c4d5e6f7g
              */
             planRef?: string;
             /**
-             * @description Agent reference (optional)
-             * @example agt_1a2b3c4d5e6f
+             * @description URL to redirect to after successful payment (optional)
+             * @example https://example.com/payment-success
              */
-            agentRef?: string;
+            returnUrl?: string;
         };
         CheckoutSessionResponse: {
             /**
@@ -67,7 +72,7 @@ interface components {
             status: string;
             /**
              * @description Checkout URL to open the checkout page
-             * @example http://localhost:3000/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
              */
             checkoutUrl: string;
         };
@@ -102,15 +107,15 @@ interface components {
              */
             remaining: number;
             /**
-             * @description Optional checkout URL if payment is required
-             * @example https://checkout.solvapay.com/pay_1a2b3c4d
-             */
-            checkoutUrl?: string;
-            /**
-             * @description Optional checkout session ID if payment is required
+             * @description Optional checkout session ID/token if payment is required
              * @example e3f1c2d4b6a89f001122334455667788
              */
             checkoutSessionId?: string;
+            /**
+             * @description Optional full checkout URL if payment is required (based on backend configuration)
+             * @example https://app.solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             */
+            checkoutUrl?: string;
         };
         UsageEvent: {
             /**
@@ -218,6 +223,60 @@ interface components {
             /** @description Active subscriptions */
             subscriptions?: components["schemas"]["SubscriptionInfo"][];
         };
+        CreateCustomerSessionRequest: {
+            /**
+             * @description Customer reference identifier
+             * @example cus_3c4d5e6f7g8h
+             */
+            customerRef: string;
+        };
+        CreateCustomerSessionResponse: {
+            /**
+             * @description Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+        };
+        GetCustomerSessionResponse: {
+            /**
+             * @description Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Session status
+             * @example active
+             * @enum {string}
+             */
+            status: "active" | "expired" | "used";
+            /**
+             * @description Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+            /**
+             * @description Session expiration date
+             * @example 2025-01-01T12:00:00.000Z
+             */
+            expiresAt: string;
+            /** @description Customer object from session data */
+            customer: components["schemas"]["CustomerResponse"];
+            /**
+             * @description Session creation date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            createdAt: string;
+            /**
+             * @description Session last update date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            updatedAt: string;
+        };
         Agent: Record<string, never>;
         CreateAgentRequest: Record<string, never>;
         UpdateAgentRequest: Record<string, never>;
@@ -328,6 +387,18 @@ interface components {
              */
             createdAt: string;
         };
+        CreateCheckoutSessionResponse: {
+            /**
+             * @description Checkout session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Full checkout URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             */
+            checkoutUrl: string;
+        };
         CreatePageSettings: {
             /** @description Page identifier */
             id: string;
@@ -488,6 +559,8 @@ interface SolvaPayClient {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    createCheckoutSession(params: components['schemas']['CreateCheckoutSessionRequest']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
+    createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
 }
 
 /**
@@ -782,6 +855,26 @@ interface SolvaPay {
             startDate: string;
         }>;
     }>;
+    /**
+     * Create a checkout session for a customer
+     */
+    createCheckoutSession(params: {
+        agentRef: string;
+        customerRef: string;
+        planRef?: string;
+    }): Promise<{
+        sessionId: string;
+        checkoutUrl: string;
+    }>;
+    /**
+     * Create a customer session for accessing customer-specific functionality
+     */
+    createCustomerSession(params: {
+        customerRef: string;
+    }): Promise<{
+        sessionId: string;
+        customerUrl: string;
+    }>;
     /**
      * Direct access to the API client for advanced operations
      * (agent/plan management, etc.)

package/dist/index.d.ts

@@ -24,20 +24,25 @@ interface components {
         ExecuteMultipleQueries: Record<string, never>;
         CreateCheckoutSessionRequest: {
             /**
-             * @description Customer reference
+             * @description Customer reference identifier
              * @example cus_3c4d5e6f7g8h
              */
-            customerReference: string;
+            customerRef: string;
             /**
-             * @description Plan reference (optional)
+             * @description Agent reference identifier
+             * @example agt_1a2b3c4d5e6f
+             */
+            agentRef: string;
+            /**
+             * @description Plan reference identifier (optional)
              * @example pln_2b3c4d5e6f7g
              */
             planRef?: string;
             /**
-             * @description Agent reference (optional)
-             * @example agt_1a2b3c4d5e6f
+             * @description URL to redirect to after successful payment (optional)
+             * @example https://example.com/payment-success
              */
-            agentRef?: string;
+            returnUrl?: string;
         };
         CheckoutSessionResponse: {
             /**
@@ -67,7 +72,7 @@ interface components {
             status: string;
             /**
              * @description Checkout URL to open the checkout page
-             * @example http://localhost:3000/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
              */
             checkoutUrl: string;
         };
@@ -102,15 +107,15 @@ interface components {
              */
             remaining: number;
             /**
-             * @description Optional checkout URL if payment is required
-             * @example https://checkout.solvapay.com/pay_1a2b3c4d
-             */
-            checkoutUrl?: string;
-            /**
-             * @description Optional checkout session ID if payment is required
+             * @description Optional checkout session ID/token if payment is required
              * @example e3f1c2d4b6a89f001122334455667788
              */
             checkoutSessionId?: string;
+            /**
+             * @description Optional full checkout URL if payment is required (based on backend configuration)
+             * @example https://app.solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             */
+            checkoutUrl?: string;
         };
         UsageEvent: {
             /**
@@ -218,6 +223,60 @@ interface components {
             /** @description Active subscriptions */
             subscriptions?: components["schemas"]["SubscriptionInfo"][];
         };
+        CreateCustomerSessionRequest: {
+            /**
+             * @description Customer reference identifier
+             * @example cus_3c4d5e6f7g8h
+             */
+            customerRef: string;
+        };
+        CreateCustomerSessionResponse: {
+            /**
+             * @description Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+        };
+        GetCustomerSessionResponse: {
+            /**
+             * @description Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Session status
+             * @example active
+             * @enum {string}
+             */
+            status: "active" | "expired" | "used";
+            /**
+             * @description Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+            /**
+             * @description Session expiration date
+             * @example 2025-01-01T12:00:00.000Z
+             */
+            expiresAt: string;
+            /** @description Customer object from session data */
+            customer: components["schemas"]["CustomerResponse"];
+            /**
+             * @description Session creation date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            createdAt: string;
+            /**
+             * @description Session last update date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            updatedAt: string;
+        };
         Agent: Record<string, never>;
         CreateAgentRequest: Record<string, never>;
         UpdateAgentRequest: Record<string, never>;
@@ -328,6 +387,18 @@ interface components {
              */
             createdAt: string;
         };
+        CreateCheckoutSessionResponse: {
+            /**
+             * @description Checkout session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * @description Full checkout URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             */
+            checkoutUrl: string;
+        };
         CreatePageSettings: {
             /** @description Page identifier */
             id: string;
@@ -488,6 +559,8 @@ interface SolvaPayClient {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    createCheckoutSession(params: components['schemas']['CreateCheckoutSessionRequest']): Promise<components['schemas']['CreateCheckoutSessionResponse']>;
+    createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
 }
 
 /**
@@ -782,6 +855,26 @@ interface SolvaPay {
             startDate: string;
         }>;
     }>;
+    /**
+     * Create a checkout session for a customer
+     */
+    createCheckoutSession(params: {
+        agentRef: string;
+        customerRef: string;
+        planRef?: string;
+    }): Promise<{
+        sessionId: string;
+        checkoutUrl: string;
+    }>;
+    /**
+     * Create a customer session for accessing customer-specific functionality
+     */
+    createCustomerSession(params: {
+        customerRef: string;
+    }): Promise<{
+        sessionId: string;
+        customerUrl: string;
+    }>;
     /**
      * Direct access to the API client for advanced operations
      * (agent/plan management, etc.)

package/dist/index.js

@@ -309,6 +309,38 @@ function createSolvaPayClient(opts) {
         throw new SolvaPayError(`Invalid subscription data in cancel subscription response`);
       }
       return result;
+    },
+    // POST: /v1/sdk/checkout-sessions
+    async createCheckoutSession(params) {
+      const url = `${base}/v1/sdk/checkout-sessions`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(`Create checkout session failed (${res.status}): ${error}`);
+      }
+      const result = await res.json();
+      return result;
+    },
+    // POST: /v1/sdk/customers/customer-sessions
+    async createCustomerSession(params) {
+      const url = `${base}/v1/sdk/customers/customer-sessions`;
+      const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params)
+      });
+      if (!res.ok) {
+        const error = await res.text();
+        log(`\u274C API Error: ${res.status} - ${error}`);
+        throw new SolvaPayError(`Create customer session failed (${res.status}): ${error}`);
+      }
+      const result = await res.json();
+      return result;
     }
   };
 }
@@ -985,6 +1017,12 @@ function createSolvaPay(config) {
       }
       return apiClient.getCustomer(params);
     },
+    createCheckoutSession(params) {
+      return apiClient.createCheckoutSession(params);
+    },
+    createCustomerSession(params) {
+      return apiClient.createCustomerSession(params);
+    },
     // Payable API for framework-specific handlers
     payable(options = {}) {
       const agent = options.agentRef || options.agent || process.env.SOLVAPAY_AGENT || getPackageJsonName() || "default-agent";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/server",
-  "version": "1.0.0-preview.7",
+  "version": "1.0.0-preview.9",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -37,7 +37,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@solvapay/core": "1.0.0-preview.7"
+    "@solvapay/core": "1.0.0-preview.9"
   },
   "devDependencies": {
     "dotenv": "^17.2.3",