@withvlibe/base-sdk 1.0.0

package/dist/index.mjs

@@ -0,0 +1,673 @@
+// src/VlibeBaseDatabase.ts
+import { createClient } from "@supabase/supabase-js";
+var DEFAULT_BASE_URL = "https://vlibe.app";
+var DEFAULT_SUPABASE_URL = "https://qoblysxhxtifxhgdlzgl.supabase.co";
+function resolveBaseUrl(configBaseUrl) {
+  if (configBaseUrl) return configBaseUrl;
+  if (typeof process !== "undefined" && process.env) {
+    if (process.env.VLIBE_BASE_URL) return process.env.VLIBE_BASE_URL;
+    if (process.env.NEXT_PUBLIC_VLIBE_BASE_URL) return process.env.NEXT_PUBLIC_VLIBE_BASE_URL;
+  }
+  return DEFAULT_BASE_URL;
+}
+var VlibeBaseDatabase = class {
+  /**
+   * Create a new VlibeBaseDatabase instance
+   *
+   * @param config - Database configuration
+   * @throws Error if projectId or databaseToken is missing
+   */
+  constructor(config) {
+    this.supabase = null;
+    this.subscriptions = /* @__PURE__ */ new Map();
+    if (!config.projectId) {
+      throw new Error("VlibeBaseDatabase: projectId is required");
+    }
+    if (!config.databaseToken) {
+      throw new Error("VlibeBaseDatabase: databaseToken is required");
+    }
+    this.projectId = config.projectId;
+    this.databaseToken = config.databaseToken;
+    this.baseUrl = resolveBaseUrl(config.baseUrl);
+    this.supabaseUrl = config.supabaseUrl || DEFAULT_SUPABASE_URL;
+  }
+  /**
+   * Initialize Supabase client for real-time subscriptions
+   */
+  initSupabase() {
+    if (this.supabase) return;
+    this.supabase = createClient(this.supabaseUrl, this.databaseToken, {
+      realtime: {
+        params: {
+          eventsPerSecond: 10
+        }
+      }
+    });
+  }
+  /**
+   * Make an authenticated API request
+   */
+  async apiRequest(endpoint, options = {}) {
+    const url = `${this.baseUrl}/api/database/${this.projectId}${endpoint}`;
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.databaseToken}`,
+        ...options.headers
+      }
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      throw new Error(data.error || data.message || "API request failed");
+    }
+    return data;
+  }
+  // ============================================================================
+  // Table Operations
+  // ============================================================================
+  /**
+   * Create a new table
+   */
+  async createTable(name, schema) {
+    const response = await this.apiRequest(
+      "/tables",
+      {
+        method: "POST",
+        body: JSON.stringify({ name, schema })
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get table information
+   */
+  async getTable(name) {
+    try {
+      const response = await this.apiRequest(
+        `/tables/${name}`
+      );
+      return response.data;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * List all tables
+   */
+  async listTables() {
+    const response = await this.apiRequest(
+      "/tables"
+    );
+    return response.data;
+  }
+  /**
+   * Delete a table
+   */
+  async deleteTable(name) {
+    await this.apiRequest(`/tables/${name}`, { method: "DELETE" });
+    return true;
+  }
+  // ============================================================================
+  // CRUD Operations
+  // ============================================================================
+  /**
+   * Insert a document into a collection
+   */
+  async insert(collection, data) {
+    const response = await this.apiRequest(
+      `/collections/${collection}`,
+      {
+        method: "POST",
+        body: JSON.stringify(data)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Query documents from a collection
+   */
+  async query(collection, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit) params.set("limit", String(options.limit));
+    if (options.offset) params.set("offset", String(options.offset));
+    if (options.orderBy) params.set("orderBy", options.orderBy);
+    if (options.orderDirection) params.set("orderDirection", options.orderDirection);
+    if (options.where) params.set("where", JSON.stringify(options.where));
+    const queryString = params.toString();
+    const endpoint = `/collections/${collection}${queryString ? `?${queryString}` : ""}`;
+    const response = await this.apiRequest(endpoint);
+    return response.data;
+  }
+  /**
+   * Get a single document by ID
+   */
+  async get(collection, id) {
+    try {
+      const response = await this.apiRequest(
+        `/collections/${collection}/${id}`
+      );
+      return response.data;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Update a document
+   */
+  async update(collection, id, data) {
+    const response = await this.apiRequest(
+      `/collections/${collection}/${id}`,
+      {
+        method: "PATCH",
+        body: JSON.stringify(data)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Delete a document
+   */
+  async delete(collection, id) {
+    await this.apiRequest(`/collections/${collection}/${id}`, {
+      method: "DELETE"
+    });
+    return true;
+  }
+  /**
+   * Count documents in a collection
+   */
+  async count(collection, where) {
+    const params = new URLSearchParams();
+    if (where) params.set("where", JSON.stringify(where));
+    const queryString = params.toString();
+    const endpoint = `/collections/${collection}/count${queryString ? `?${queryString}` : ""}`;
+    const response = await this.apiRequest(
+      endpoint
+    );
+    return response.data.count;
+  }
+  // ============================================================================
+  // Key-Value Store
+  // ============================================================================
+  /**
+   * Set a key-value pair
+   */
+  async setKV(key, value) {
+    await this.apiRequest("/kv", {
+      method: "POST",
+      body: JSON.stringify({ key, value })
+    });
+  }
+  /**
+   * Get a value by key
+   */
+  async getKV(key) {
+    try {
+      const response = await this.apiRequest(
+        `/kv/${key}`
+      );
+      return response.data.value;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Delete a key-value pair
+   */
+  async deleteKV(key) {
+    await this.apiRequest(`/kv/${key}`, { method: "DELETE" });
+    return true;
+  }
+  // ============================================================================
+  // Real-time Subscriptions
+  // ============================================================================
+  /**
+   * Subscribe to real-time changes on a collection
+   */
+  subscribe(collection, callback) {
+    this.initSupabase();
+    const channelName = `base:${this.projectId}:${collection}`;
+    const tableName = `project_${this.projectId.replace(/-/g, "_")}_${collection}`;
+    const channel = this.supabase.channel(channelName).on(
+      "postgres_changes",
+      {
+        event: "*",
+        schema: "public",
+        table: tableName
+      },
+      (payload) => {
+        callback({
+          eventType: payload.eventType,
+          new: payload.new,
+          old: payload.old,
+          table: collection
+        });
+      }
+    ).subscribe();
+    this.subscriptions.set(channelName, channel);
+    return {
+      unsubscribe: () => {
+        channel.unsubscribe();
+        this.subscriptions.delete(channelName);
+      }
+    };
+  }
+  /**
+   * Unsubscribe from all subscriptions
+   */
+  unsubscribeAll() {
+    for (const channel of this.subscriptions.values()) {
+      channel.unsubscribe();
+    }
+    this.subscriptions.clear();
+  }
+  // ============================================================================
+  // Utilities
+  // ============================================================================
+  /**
+   * Get the project ID
+   */
+  getProjectId() {
+    return this.projectId;
+  }
+  /**
+   * Get the base URL
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+};
+
+// src/VlibeBaseAuth.ts
+var DEFAULT_BASE_URL2 = "https://vlibe.app";
+function resolveBaseUrl2(configBaseUrl) {
+  if (configBaseUrl) return configBaseUrl;
+  if (typeof process !== "undefined" && process.env) {
+    if (process.env.VLIBE_BASE_URL) return process.env.VLIBE_BASE_URL;
+    if (process.env.NEXT_PUBLIC_VLIBE_BASE_URL) return process.env.NEXT_PUBLIC_VLIBE_BASE_URL;
+  }
+  return DEFAULT_BASE_URL2;
+}
+var VlibeBaseAuth = class {
+  /**
+   * Create a new VlibeBaseAuth instance
+   *
+   * @param config - Authentication configuration
+   * @throws Error if appId or appSecret is missing
+   */
+  constructor(config) {
+    if (!config.appId) {
+      throw new Error("VlibeBaseAuth: appId is required");
+    }
+    if (!config.appSecret) {
+      throw new Error("VlibeBaseAuth: appSecret is required");
+    }
+    this.appId = config.appId;
+    this.appSecret = config.appSecret;
+    this.baseUrl = resolveBaseUrl2(config.baseUrl);
+  }
+  /**
+   * Verify a session token and get user information
+   *
+   * @param token - The session token from the SSO callback
+   * @returns The user object if valid, null otherwise
+   */
+  async verifySession(token) {
+    if (!token) {
+      return null;
+    }
+    try {
+      const response = await fetch(`${this.baseUrl}/api/auth/sso/verify`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          token,
+          appId: this.appId,
+          appSecret: this.appSecret,
+          appType: "base"
+          // Indicate this is a Base app
+        })
+      });
+      if (!response.ok) {
+        return null;
+      }
+      const data = await response.json();
+      if (data.valid && data.user) {
+        return data.user;
+      }
+      return null;
+    } catch (error) {
+      console.error("VlibeBaseAuth: Failed to verify session:", error);
+      return null;
+    }
+  }
+  /**
+   * Generate the SSO login URL to redirect unauthenticated users
+   *
+   * @param redirectPath - The path to redirect to after login
+   * @returns The full Vlibe SSO URL
+   */
+  getLoginUrl(redirectPath = "/") {
+    const params = new URLSearchParams({
+      app_id: this.appId,
+      app_type: "base",
+      redirect: redirectPath
+    });
+    return `${this.baseUrl}/api/auth/sso?${params.toString()}`;
+  }
+  /**
+   * Generate the logout URL
+   *
+   * @param redirectPath - The path to redirect to after logout
+   * @returns The logout URL
+   */
+  getLogoutUrl(redirectPath = "/") {
+    const params = new URLSearchParams({
+      app_id: this.appId,
+      redirect: redirectPath
+    });
+    return `${this.baseUrl}/api/auth/sso/logout?${params.toString()}`;
+  }
+  /**
+   * Check if user has access to a specific feature
+   *
+   * @param user - The Vlibe user object
+   * @param feature - The feature name to check
+   * @returns True if user has access to the feature
+   */
+  hasFeature(user, feature) {
+    if (!user) return false;
+    if (user.subscriptionType === "platform") {
+      return true;
+    }
+    if (user.appAccess?.features) {
+      return user.appAccess.features.includes("*") || user.appAccess.features.includes(feature);
+    }
+    return false;
+  }
+  /**
+   * Check if user has an active subscription
+   *
+   * @param user - The Vlibe user object
+   * @returns True if user has any active subscription
+   */
+  hasSubscription(user) {
+    return user?.subscriptionType !== null;
+  }
+  /**
+   * Get the subscription tier for a user
+   *
+   * @param user - The Vlibe user object
+   * @returns The tier name or null
+   */
+  getTier(user) {
+    if (!user) return null;
+    if (user.subscriptionType === "platform") return "platform";
+    return user.appAccess?.tier || null;
+  }
+  /**
+   * Get the app ID
+   */
+  getAppId() {
+    return this.appId;
+  }
+  /**
+   * Get the base URL
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+};
+
+// src/VlibeBasePayments.ts
+var DEFAULT_BASE_URL3 = "https://vlibe.app";
+function resolveBaseUrl3(configBaseUrl) {
+  if (configBaseUrl) return configBaseUrl;
+  if (typeof process !== "undefined" && process.env) {
+    if (process.env.VLIBE_BASE_URL) return process.env.VLIBE_BASE_URL;
+    if (process.env.NEXT_PUBLIC_VLIBE_BASE_URL) return process.env.NEXT_PUBLIC_VLIBE_BASE_URL;
+  }
+  return DEFAULT_BASE_URL3;
+}
+var VlibeBasePayments = class {
+  /**
+   * Create a new VlibeBasePayments instance
+   *
+   * @param config - Payments configuration
+   * @throws Error if appId or appSecret is missing
+   *
+   * @remarks
+   * This class should only be used server-side. Never expose your
+   * appSecret to the client.
+   */
+  constructor(config) {
+    if (!config.appId) {
+      throw new Error("VlibeBasePayments: appId is required");
+    }
+    if (!config.appSecret) {
+      throw new Error("VlibeBasePayments: appSecret is required");
+    }
+    if (typeof window !== "undefined") {
+      console.warn(
+        "VlibeBasePayments: This class should only be used server-side. Never expose your appSecret to the client."
+      );
+    }
+    this.appId = config.appId;
+    this.appSecret = config.appSecret;
+    this.baseUrl = resolveBaseUrl3(config.baseUrl);
+  }
+  /**
+   * Make an authenticated API request
+   */
+  async apiRequest(endpoint, options = {}) {
+    const url = `${this.baseUrl}/api/base/payments${endpoint}`;
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        "X-App-Id": this.appId,
+        "X-App-Secret": this.appSecret,
+        ...options.headers
+      }
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      throw new Error(data.error || data.message || "Payment API request failed");
+    }
+    return data;
+  }
+  // ============================================================================
+  // Stripe Connect
+  // ============================================================================
+  /**
+   * Get Stripe Connect onboarding URL
+   *
+   * Redirect users to this URL to connect their Stripe account.
+   *
+   * @param returnUrl - URL to return to after onboarding
+   * @returns The Stripe Connect onboarding URL
+   */
+  async getConnectOnboardingUrl(returnUrl) {
+    const response = await this.apiRequest(
+      "/connect/onboard",
+      {
+        method: "POST",
+        body: JSON.stringify({ returnUrl })
+      }
+    );
+    return response.data.url;
+  }
+  /**
+   * Check Stripe Connect status
+   *
+   * @returns The current Stripe Connect status
+   */
+  async getConnectStatus() {
+    const response = await this.apiRequest(
+      "/connect/status"
+    );
+    return response.data;
+  }
+  // ============================================================================
+  // Checkout
+  // ============================================================================
+  /**
+   * Create a checkout session for one-time payments
+   *
+   * @param options - Checkout options
+   * @returns The checkout session with URL to redirect user
+   *
+   * @remarks
+   * Transaction fees are automatically calculated based on your plan:
+   * - Free plan: 2% of transaction
+   * - Premium plan: 0.5% of transaction
+   */
+  async createCheckout(options) {
+    const response = await this.apiRequest(
+      "/checkout",
+      {
+        method: "POST",
+        body: JSON.stringify({
+          amount: options.amount,
+          currency: options.currency || "usd",
+          userId: options.userId,
+          userEmail: options.userEmail,
+          description: options.description,
+          metadata: options.metadata,
+          successUrl: options.successUrl,
+          cancelUrl: options.cancelUrl
+        })
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get checkout session by ID
+   *
+   * @param sessionId - The checkout session ID
+   * @returns The checkout session details
+   */
+  async getCheckoutSession(sessionId) {
+    try {
+      const response = await this.apiRequest(
+        `/checkout/${sessionId}`
+      );
+      return response.data;
+    } catch {
+      return null;
+    }
+  }
+  // ============================================================================
+  // Transactions
+  // ============================================================================
+  /**
+   * Get all transactions
+   *
+   * @param options - Query options
+   * @returns List of transactions
+   */
+  async getTransactions(options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit) params.set("limit", String(options.limit));
+    if (options.offset) params.set("offset", String(options.offset));
+    if (options.status) params.set("status", options.status);
+    const queryString = params.toString();
+    const endpoint = `/transactions${queryString ? `?${queryString}` : ""}`;
+    const response = await this.apiRequest(
+      endpoint
+    );
+    return response.data;
+  }
+  /**
+   * Get a single transaction
+   *
+   * @param transactionId - The transaction ID
+   * @returns The transaction details
+   */
+  async getTransaction(transactionId) {
+    try {
+      const response = await this.apiRequest(
+        `/transactions/${transactionId}`
+      );
+      return response.data;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get transaction summary/stats
+   *
+   * @returns Transaction statistics
+   */
+  async getTransactionStats() {
+    const response = await this.apiRequest("/transactions/stats");
+    return response.data;
+  }
+  // ============================================================================
+  // Refunds
+  // ============================================================================
+  /**
+   * Create a refund
+   *
+   * @param options - Refund options
+   * @returns The updated transaction
+   *
+   * @remarks
+   * Note: Transaction fees are not refunded when you issue a refund.
+   */
+  async createRefund(options) {
+    const response = await this.apiRequest(
+      "/refunds",
+      {
+        method: "POST",
+        body: JSON.stringify(options)
+      }
+    );
+    return response.data;
+  }
+  // ============================================================================
+  // Utilities
+  // ============================================================================
+  /**
+   * Calculate the Vlibe fee for an amount
+   *
+   * @param amount - Amount in cents
+   * @param plan - The Base plan ('free' or 'premium')
+   * @returns The fee amount in cents
+   */
+  calculateFee(amount, plan = "free") {
+    const feeRate = plan === "premium" ? 5e-3 : 0.02;
+    return Math.round(amount * feeRate);
+  }
+  /**
+   * Calculate net amount after fees
+   *
+   * @param amount - Gross amount in cents
+   * @param plan - The Base plan ('free' or 'premium')
+   * @returns The net amount in cents
+   */
+  calculateNetAmount(amount, plan = "free") {
+    const fee = this.calculateFee(amount, plan);
+    return amount - fee;
+  }
+  /**
+   * Get the app ID
+   */
+  getAppId() {
+    return this.appId;
+  }
+  /**
+   * Get the base URL
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+};
+export {
+  VlibeBaseAuth,
+  VlibeBaseDatabase,
+  VlibeBasePayments
+};