@fluxbase/sdk 0.0.2-rc.2 → 0.1.0-rc.1

package/dist/index.cjs

@@ -122,6 +122,7 @@ var FluxbaseAuth = class {
   constructor(fetch2, autoRefresh = true, persist = true) {
     this.session = null;
     this.refreshTimer = null;
+    this.stateChangeListeners = /* @__PURE__ */ new Set();
     this.fetch = fetch2;
     this.persist = persist;
     this.autoRefresh = autoRefresh;
@@ -158,6 +159,29 @@ var FluxbaseAuth = class {
   getAccessToken() {
     return this.session?.access_token ?? null;
   }
+  /**
+   * Listen to auth state changes
+   * @param callback - Function called when auth state changes
+   * @returns Subscription object with unsubscribe method
+   *
+   * @example
+   * ```typescript
+   * const { data: { subscription } } = client.auth.onAuthStateChange((event, session) => {
+   *   console.log('Auth event:', event, session)
+   * })
+   *
+   * // Later, to unsubscribe:
+   * subscription.unsubscribe()
+   * ```
+   */
+  onAuthStateChange(callback) {
+    this.stateChangeListeners.add(callback);
+    return {
+      unsubscribe: () => {
+        this.stateChangeListeners.delete(callback);
+      }
+    };
+  }
   /**
    * Sign in with email and password
    * Returns AuthSession if successful, or SignInWith2FAResponse if 2FA is required
@@ -214,7 +238,7 @@ var FluxbaseAuth = class {
       ...response,
       expires_at: Date.now() + response.expires_in * 1e3
     };
-    this.setSession(session);
+    this.setSession(session, "TOKEN_REFRESHED");
     return session;
   }
   /**
@@ -237,6 +261,7 @@ var FluxbaseAuth = class {
     if (this.session) {
       this.session.user = user;
       this.saveSession();
+      this.emitAuthChange("USER_UPDATED", this.session);
     }
     return user;
   }
@@ -298,7 +323,7 @@ var FluxbaseAuth = class {
       ...response,
       expires_at: Date.now() + response.expires_in * 1e3
     };
-    this.setSession(session);
+    this.setSession(session, "MFA_CHALLENGE_VERIFIED");
     return session;
   }
   /**
@@ -425,11 +450,12 @@ var FluxbaseAuth = class {
   /**
    * Internal: Set the session and persist it
    */
-  setSession(session) {
+  setSession(session, event = "SIGNED_IN") {
     this.session = session;
     this.fetch.setAuthToken(session.access_token);
     this.saveSession();
     this.scheduleTokenRefresh();
+    this.emitAuthChange(event, session);
   }
   /**
    * Internal: Clear the session
@@ -444,6 +470,7 @@ var FluxbaseAuth = class {
       clearTimeout(this.refreshTimer);
       this.refreshTimer = null;
     }
+    this.emitAuthChange("SIGNED_OUT", null);
   }
   /**
    * Internal: Save session to storage
@@ -474,6 +501,18 @@ var FluxbaseAuth = class {
       }, delay);
     }
   }
+  /**
+   * Internal: Emit auth state change event to all listeners
+   */
+  emitAuthChange(event, session) {
+    this.stateChangeListeners.forEach((callback) => {
+      try {
+        callback(event, session);
+      } catch (error) {
+        console.error("Error in auth state change listener:", error);
+      }
+    });
+  }
 };
 
 // src/realtime.ts
@@ -481,6 +520,7 @@ var RealtimeChannel = class {
   constructor(url, channelName, token = null) {
     this.ws = null;
     this.callbacks = /* @__PURE__ */ new Map();
+    this.subscriptionConfig = null;
     this.reconnectAttempts = 0;
     this.maxReconnectAttempts = 10;
     this.reconnectDelay = 1e3;
@@ -489,16 +529,25 @@ var RealtimeChannel = class {
     this.channelName = channelName;
     this.token = token;
   }
-  /**
-   * Listen to a specific event type
-   * @param event - The event type (INSERT, UPDATE, DELETE, or '*' for all)
-   * @param callback - The callback function
-   */
-  on(event, callback) {
-    if (!this.callbacks.has(event)) {
-      this.callbacks.set(event, /* @__PURE__ */ new Set());
+  // Implementation
+  on(event, configOrCallback, callback) {
+    if (event === "postgres_changes" && typeof configOrCallback !== "function") {
+      const config = configOrCallback;
+      this.subscriptionConfig = config;
+      const actualCallback = callback;
+      const eventType = config.event;
+      if (!this.callbacks.has(eventType)) {
+        this.callbacks.set(eventType, /* @__PURE__ */ new Set());
+      }
+      this.callbacks.get(eventType).add(actualCallback);
+    } else {
+      const actualEvent = event;
+      const actualCallback = configOrCallback;
+      if (!this.callbacks.has(actualEvent)) {
+        this.callbacks.set(actualEvent, /* @__PURE__ */ new Set());
+      }
+      this.callbacks.get(actualEvent).add(actualCallback);
     }
-    this.callbacks.get(event).add(callback);
     return this;
   }
   /**
@@ -547,10 +596,14 @@ var RealtimeChannel = class {
     this.ws.onopen = () => {
       console.log("[Fluxbase Realtime] Connected");
       this.reconnectAttempts = 0;
-      this.send({
+      const subscribeMessage = {
         type: "subscribe",
         channel: this.channelName
-      });
+      };
+      if (this.subscriptionConfig) {
+        subscribeMessage.config = this.subscriptionConfig;
+      }
+      this.send(subscribeMessage);
       this.startHeartbeat();
     };
     this.ws.onmessage = (event) => {
@@ -2225,7 +2278,9 @@ var FluxbaseAdmin = class {
    * ```
    */
   async getSetupStatus() {
-    return await this.fetch.get("/api/v1/admin/setup/status");
+    return await this.fetch.get(
+      "/api/v1/admin/setup/status"
+    );
   }
   /**
    * Perform initial admin setup
@@ -2251,7 +2306,10 @@ var FluxbaseAdmin = class {
    * ```
    */
   async setup(request) {
-    const response = await this.fetch.post("/api/v1/admin/setup", request);
+    const response = await this.fetch.post(
+      "/api/v1/admin/setup",
+      request
+    );
     this.setToken(response.access_token);
     return response;
   }
@@ -2276,7 +2334,10 @@ var FluxbaseAdmin = class {
    * ```
    */
   async login(request) {
-    const response = await this.fetch.post("/api/v1/admin/login", request);
+    const response = await this.fetch.post(
+      "/api/v1/admin/login",
+      request
+    );
     this.setToken(response.access_token);
     return response;
   }
@@ -2297,7 +2358,10 @@ var FluxbaseAdmin = class {
    * ```
    */
   async refreshToken(request) {
-    const response = await this.fetch.post("/api/v1/admin/refresh", request);
+    const response = await this.fetch.post(
+      "/api/v1/admin/refresh",
+      request
+    );
     this.setToken(response.access_token);
     return response;
   }
@@ -2372,6 +2436,30 @@ var FluxbaseAdmin = class {
     const url = queryString ? `/api/v1/admin/users?${queryString}` : "/api/v1/admin/users";
     return await this.fetch.get(url);
   }
+  /**
+   * Get a user by ID
+   *
+   * Fetch a single user's details by their user ID
+   *
+   * @param userId - User ID to fetch
+   * @param type - User type ('app' or 'dashboard')
+   * @returns User details with metadata
+   *
+   * @example
+   * ```typescript
+   * // Get an app user
+   * const user = await admin.getUserById('user-123');
+   *
+   * // Get a dashboard user
+   * const dashboardUser = await admin.getUserById('admin-456', 'dashboard');
+   * console.log('User email:', dashboardUser.email);
+   * console.log('Last login:', dashboardUser.last_login_at);
+   * ```
+   */
+  async getUserById(userId, type = "app") {
+    const url = `/api/v1/admin/users/${userId}?type=${type}`;
+    return await this.fetch.get(url);
+  }
   /**
    * Invite a new user
    *
@@ -2944,6 +3032,22 @@ var QueryBuilder = class {
       };
     }
   }
+  /**
+   * Make QueryBuilder awaitable (implements PromiseLike)
+   * This allows using `await client.from('table').select()` without calling `.execute()`
+   *
+   * @example
+   * ```typescript
+   * // Without .execute() (new way)
+   * const { data } = await client.from('users').select('*')
+   *
+   * // With .execute() (old way, still supported)
+   * const { data } = await client.from('users').select('*').execute()
+   * ```
+   */
+  then(onfulfilled, onrejected) {
+    return this.execute().then(onfulfilled, onrejected);
+  }
   /**
    * Build the query string from filters, ordering, etc.
    */