@insforge/sdk 1.2.5-dev.0 → 1.2.6-payments.0

package/README.md

@@ -12,6 +12,7 @@ Official TypeScript/JavaScript SDK for [InsForge](https://github.com/InsForge/In
 - **Storage** - File upload and management with S3-compatible storage
 - **Edge Functions** - Serverless function invocation
 - **AI Integration** - Built-in AI capabilities
+- **Payments** - Stripe Checkout and Billing Portal session helpers
 - **TypeScript** - Full TypeScript support with type definitions
 - **Automatic OAuth Handling** - Seamless OAuth callback detection
 
@@ -187,6 +188,49 @@ const { data, error } = await insforge.functions.invoke('my-function', {
 });
 ```
 
+### Payments
+
+```javascript
+// Create and redirect to a Stripe Checkout Session
+const { data, error } = await insforge.payments.createCheckoutSession({
+  environment: 'test',
+  mode: 'payment',
+  lineItems: [{ stripePriceId: 'price_123', quantity: 1 }],
+  successUrl: `${window.location.origin}/success`,
+  cancelUrl: `${window.location.origin}/pricing`,
+  idempotencyKey: 'cart_123'
+});
+
+if (!error && data?.checkoutSession.url) {
+  window.location.assign(data.checkoutSession.url);
+}
+
+// Create a subscription checkout for an app billing subject
+const { data: subscriptionCheckout } = await insforge.payments.createCheckoutSession({
+  environment: 'test',
+  mode: 'subscription',
+  subject: { type: 'team', id: 'team_123' },
+  lineItems: [{ stripePriceId: 'price_monthly_123', quantity: 1 }],
+  successUrl: `${window.location.origin}/billing/success`,
+  cancelUrl: `${window.location.origin}/billing`
+});
+
+if (subscriptionCheckout?.checkoutSession.url) {
+  window.location.assign(subscriptionCheckout.checkoutSession.url);
+}
+
+// Let an authenticated customer manage their subscription in Stripe Billing Portal
+const { data: portal } = await insforge.payments.createCustomerPortalSession({
+  environment: 'test',
+  subject: { type: 'team', id: 'team_123' },
+  returnUrl: `${window.location.origin}/billing`
+});
+
+if (portal?.customerPortalSession.url) {
+  window.location.assign(portal.customerPortalSession.url);
+}
+```
+
 ### AI Integration
 
 ```javascript

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, RefreshSessionResponse, GetProfileResponse, SendVerificationEmailRequest, VerifyEmailRequest, VerifyEmailResponse, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, ExchangeResetPasswordTokenResponse, ResetPasswordResponse, GetPublicAuthConfigResponse, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest, EmbeddingsRequest, SubscribeResponse, SocketMessage, SendRawEmailRequest, SendEmailResponse } from '@insforge/shared-schemas';
+import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, RefreshSessionResponse, GetProfileResponse, SendVerificationEmailRequest, VerifyEmailRequest, VerifyEmailResponse, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, ExchangeResetPasswordTokenResponse, ResetPasswordResponse, GetPublicAuthConfigResponse, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest, EmbeddingsRequest, SubscribeResponse, SocketMessage, SendRawEmailRequest, SendEmailResponse, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateCustomerPortalSessionRequest, CreateCustomerPortalSessionResponse } from '@insforge/shared-schemas';
 export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, RealtimeErrorPayload, SendRawEmailRequest as SendEmailOptions, SendEmailResponse, SocketMessage, SubscribeResponse, UserSchema } from '@insforge/shared-schemas';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
 
@@ -974,6 +974,45 @@ declare class Emails {
     }>;
 }
 
+interface PaymentsResponse<T> {
+    data: T | null;
+    error: InsForgeError | null;
+}
+/**
+ * Payments client for runtime Stripe payment flows.
+ *
+ * These methods are safe to call from generated app frontends with the current
+ * user token or anon key. Admin-only Stripe key/catalog APIs are intentionally
+ * not exposed here.
+ */
+declare class Payments {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Create a Stripe Checkout Session through the InsForge backend.
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await client.payments.createCheckoutSession({
+     *   environment: 'test',
+     *   mode: 'payment',
+     *   lineItems: [{ stripePriceId: 'price_123', quantity: 1 }],
+     *   successUrl: `${window.location.origin}/success`,
+     *   cancelUrl: `${window.location.origin}/pricing`
+     * });
+     *
+     * if (!error && data.checkoutSession.url) {
+     *   window.location.assign(data.checkoutSession.url);
+     * }
+     * ```
+     */
+    createCheckoutSession(request: CreateCheckoutSessionRequest): Promise<PaymentsResponse<CreateCheckoutSessionResponse>>;
+    /**
+     * Create a Stripe Billing Portal Session for a mapped billing subject.
+     */
+    createCustomerPortalSession(request: CreateCustomerPortalSessionRequest): Promise<PaymentsResponse<CreateCustomerPortalSessionResponse>>;
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -1028,6 +1067,7 @@ declare class InsForgeClient {
     readonly functions: Functions;
     readonly realtime: Realtime;
     readonly emails: Emails;
+    readonly payments: Payments;
     constructor(config?: InsForgeConfig);
     /**
      * Get the underlying HTTP client for custom requests
@@ -1049,4 +1089,4 @@ declare class InsForgeClient {
 
 declare function createClient(config: InsForgeConfig): InsForgeClient;
 
-export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, type ConnectionState, Database, Emails, type EventCallback, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, Logger, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, createClient, InsForgeClient as default };
+export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, type ConnectionState, Database, Emails, type EventCallback, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, Logger, Payments, type PaymentsResponse, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, createClient, InsForgeClient as default };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, RefreshSessionResponse, GetProfileResponse, SendVerificationEmailRequest, VerifyEmailRequest, VerifyEmailResponse, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, ExchangeResetPasswordTokenResponse, ResetPasswordResponse, GetPublicAuthConfigResponse, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest, EmbeddingsRequest, SubscribeResponse, SocketMessage, SendRawEmailRequest, SendEmailResponse } from '@insforge/shared-schemas';
+import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, RefreshSessionResponse, GetProfileResponse, SendVerificationEmailRequest, VerifyEmailRequest, VerifyEmailResponse, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, ExchangeResetPasswordTokenResponse, ResetPasswordResponse, GetPublicAuthConfigResponse, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest, EmbeddingsRequest, SubscribeResponse, SocketMessage, SendRawEmailRequest, SendEmailResponse, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateCustomerPortalSessionRequest, CreateCustomerPortalSessionResponse } from '@insforge/shared-schemas';
 export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, RealtimeErrorPayload, SendRawEmailRequest as SendEmailOptions, SendEmailResponse, SocketMessage, SubscribeResponse, UserSchema } from '@insforge/shared-schemas';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
 
@@ -974,6 +974,45 @@ declare class Emails {
     }>;
 }
 
+interface PaymentsResponse<T> {
+    data: T | null;
+    error: InsForgeError | null;
+}
+/**
+ * Payments client for runtime Stripe payment flows.
+ *
+ * These methods are safe to call from generated app frontends with the current
+ * user token or anon key. Admin-only Stripe key/catalog APIs are intentionally
+ * not exposed here.
+ */
+declare class Payments {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Create a Stripe Checkout Session through the InsForge backend.
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await client.payments.createCheckoutSession({
+     *   environment: 'test',
+     *   mode: 'payment',
+     *   lineItems: [{ stripePriceId: 'price_123', quantity: 1 }],
+     *   successUrl: `${window.location.origin}/success`,
+     *   cancelUrl: `${window.location.origin}/pricing`
+     * });
+     *
+     * if (!error && data.checkoutSession.url) {
+     *   window.location.assign(data.checkoutSession.url);
+     * }
+     * ```
+     */
+    createCheckoutSession(request: CreateCheckoutSessionRequest): Promise<PaymentsResponse<CreateCheckoutSessionResponse>>;
+    /**
+     * Create a Stripe Billing Portal Session for a mapped billing subject.
+     */
+    createCustomerPortalSession(request: CreateCustomerPortalSessionRequest): Promise<PaymentsResponse<CreateCustomerPortalSessionResponse>>;
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -1028,6 +1067,7 @@ declare class InsForgeClient {
     readonly functions: Functions;
     readonly realtime: Realtime;
     readonly emails: Emails;
+    readonly payments: Payments;
     constructor(config?: InsForgeConfig);
     /**
      * Get the underlying HTTP client for custom requests
@@ -1049,4 +1089,4 @@ declare class InsForgeClient {
 
 declare function createClient(config: InsForgeConfig): InsForgeClient;
 
-export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, type ConnectionState, Database, Emails, type EventCallback, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, Logger, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, createClient, InsForgeClient as default };
+export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, type ConnectionState, Database, Emails, type EventCallback, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, Logger, Payments, type PaymentsResponse, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, createClient, InsForgeClient as default };

package/dist/index.js

@@ -29,6 +29,7 @@ __export(index_exports, {
   InsForgeClient: () => InsForgeClient,
   InsForgeError: () => InsForgeError,
   Logger: () => Logger,
+  Payments: () => Payments,
   Realtime: () => Realtime,
   Storage: () => Storage,
   StorageBucket: () => StorageBucket,
@@ -2160,7 +2161,7 @@ var Realtime = class {
    */
   async subscribe(channel) {
     if (this.subscribedChannels.has(channel)) {
-      return { ok: true, channel };
+      return { ok: true, channel, presence: { members: [] } };
     }
     if (!this.socket?.connected) {
       try {
@@ -2291,6 +2292,63 @@ var Emails = class {
   }
 };
 
+// src/modules/payments.ts
+var Payments = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Create a Stripe Checkout Session through the InsForge backend.
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.payments.createCheckoutSession({
+   *   environment: 'test',
+   *   mode: 'payment',
+   *   lineItems: [{ stripePriceId: 'price_123', quantity: 1 }],
+   *   successUrl: `${window.location.origin}/success`,
+   *   cancelUrl: `${window.location.origin}/pricing`
+   * });
+   *
+   * if (!error && data.checkoutSession.url) {
+   *   window.location.assign(data.checkoutSession.url);
+   * }
+   * ```
+   */
+  async createCheckoutSession(request) {
+    try {
+      const data = await this.http.post(
+        "/api/payments/checkout-sessions",
+        request,
+        { idempotent: !!request.idempotencyKey }
+      );
+      return { data, error: null };
+    } catch (error) {
+      return wrapError(
+        error,
+        "Checkout session creation failed"
+      );
+    }
+  }
+  /**
+   * Create a Stripe Billing Portal Session for a mapped billing subject.
+   */
+  async createCustomerPortalSession(request) {
+    try {
+      const data = await this.http.post(
+        "/api/payments/customer-portal-sessions",
+        request
+      );
+      return { data, error: null };
+    } catch (error) {
+      return wrapError(
+        error,
+        "Customer portal session creation failed"
+      );
+    }
+  }
+};
+
 // src/client.ts
 var InsForgeClient = class {
   constructor(config = {}) {
@@ -2302,7 +2360,7 @@ var InsForgeClient = class {
       this.tokenManager.setAccessToken(config.edgeFunctionToken);
     }
     this.auth = new Auth(this.http, this.tokenManager, {
-      isServerMode: config.isServerMode ?? false
+      isServerMode: config.isServerMode ?? !!config.edgeFunctionToken
     });
     this.database = new Database(this.http, this.tokenManager);
     this.storage = new Storage(this.http);
@@ -2314,6 +2372,7 @@ var InsForgeClient = class {
       config.anonKey
     );
     this.emails = new Emails(this.http);
+    this.payments = new Payments(this.http);
   }
   /**
    * Get the underlying HTTP client for custom requests
@@ -2353,6 +2412,7 @@ var index_default = InsForgeClient;
   InsForgeClient,
   InsForgeError,
   Logger,
+  Payments,
   Realtime,
   Storage,
   StorageBucket,