@linabase/js 0.2.2 → 0.3.0

package/dist/index.cjs

@@ -631,13 +631,28 @@ var AuthClient = class {
   /**
    * Set (or clear) the current session. Use this to restore a persisted
    * session on app launch (e.g., from AsyncStorage / SecureStore).
+   * Automatically refreshes the token if it has expired.
    * Emits INITIAL_SESSION to onAuthStateChange listeners when called externally.
    * Internal callers (signIn, signUp, etc.) pass _internal=true to skip the emit.
    */
   setSession(session, _internal) {
     this.currentSession = session;
     if (this.onSessionChange) this.onSessionChange(session);
-    if (!_internal) this.emit("INITIAL_SESSION", session);
+    if (!_internal) {
+      if (session && session.expires_at <= Math.floor(Date.now() / 1e3)) {
+        this.refreshSession().then(({ error }) => {
+          if (error) {
+            this.currentSession = null;
+            if (this.onSessionChange) this.onSessionChange(null);
+            this.emit("SIGNED_OUT", null);
+          } else {
+            this.emit("INITIAL_SESSION", this.currentSession);
+          }
+        });
+      } else {
+        this.emit("INITIAL_SESSION", session);
+      }
+    }
   }
   // ─── Email/Password ────────────────────────────────────────
   async signUp(params) {
@@ -1057,9 +1072,30 @@ function createClient(config) {
     });
   }
   const authClient = new AuthClient(request);
+  const persistSession = config.auth?.persistSession !== false && !!config.auth?.storage;
+  const sessionStorage = config.auth?.storage;
+  const sessionKey = config.auth?.storageKey || "@linabase/session";
   authClient.onSessionChange = (session) => {
     accessToken = session?.access_token || null;
   };
+  if (persistSession && sessionStorage) {
+    authClient.onAuthStateChange((event, session) => {
+      if (session) {
+        sessionStorage.setItem(sessionKey, JSON.stringify(session));
+      } else if (event === "SIGNED_OUT") {
+        sessionStorage.removeItem(sessionKey);
+      }
+    });
+    Promise.resolve(sessionStorage.getItem(sessionKey)).then((raw) => {
+      if (raw) {
+        try {
+          authClient.setSession(JSON.parse(raw));
+        } catch {
+          sessionStorage.removeItem(sessionKey);
+        }
+      }
+    });
+  }
   function buildClient(reqFn, branchSlug) {
     const rc = new RpcClient(reqFn);
     const ac = new AuthClient(reqFn);

package/dist/index.d.cts

@@ -236,6 +236,7 @@ declare class AuthClient {
     /**
      * Set (or clear) the current session. Use this to restore a persisted
      * session on app launch (e.g., from AsyncStorage / SecureStore).
+     * Automatically refreshes the token if it has expired.
      * Emits INITIAL_SESSION to onAuthStateChange listeners when called externally.
      * Internal callers (signIn, signUp, etc.) pass _internal=true to skip the emit.
      */
@@ -415,10 +416,24 @@ declare class FunctionsClient {
     }>;
 }
 
+/**
+ * Minimal async key-value storage interface (compatible with AsyncStorage, localStorage, etc.)
+ */
+interface SessionStorage {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}
 interface LinabaseConfig {
     url: string;
     anonKey?: string;
     serviceRoleKey?: string;
+    /** Persistent storage for auth sessions (e.g., AsyncStorage for React Native). */
+    auth?: {
+        storage?: SessionStorage;
+        storageKey?: string;
+        persistSession?: boolean;
+    };
 }
 interface LinabaseClient {
     from: (table: string) => DatabaseClient;
@@ -439,4 +454,4 @@ interface LinabaseClient {
 }
 declare function createClient(config: LinabaseConfig): LinabaseClient;
 
-export { AuthClient, type AuthSession, type AuthUser, BucketClient, type CsvQueryResult, DatabaseClient, type FunctionInvokeOptions, FunctionsClient, type LinabaseClient, type LinabaseConfig, type OAuthProvider, type PostgrestError, type QueryResult, RpcClient, type SingleQueryResult, StorageClient, createClient };
+export { AuthClient, type AuthSession, type AuthUser, BucketClient, type CsvQueryResult, DatabaseClient, type FunctionInvokeOptions, FunctionsClient, type LinabaseClient, type LinabaseConfig, type OAuthProvider, type PostgrestError, type QueryResult, RpcClient, type SessionStorage, type SingleQueryResult, StorageClient, createClient };

package/dist/index.d.ts

@@ -236,6 +236,7 @@ declare class AuthClient {
     /**
      * Set (or clear) the current session. Use this to restore a persisted
      * session on app launch (e.g., from AsyncStorage / SecureStore).
+     * Automatically refreshes the token if it has expired.
      * Emits INITIAL_SESSION to onAuthStateChange listeners when called externally.
      * Internal callers (signIn, signUp, etc.) pass _internal=true to skip the emit.
      */
@@ -415,10 +416,24 @@ declare class FunctionsClient {
     }>;
 }
 
+/**
+ * Minimal async key-value storage interface (compatible with AsyncStorage, localStorage, etc.)
+ */
+interface SessionStorage {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}
 interface LinabaseConfig {
     url: string;
     anonKey?: string;
     serviceRoleKey?: string;
+    /** Persistent storage for auth sessions (e.g., AsyncStorage for React Native). */
+    auth?: {
+        storage?: SessionStorage;
+        storageKey?: string;
+        persistSession?: boolean;
+    };
 }
 interface LinabaseClient {
     from: (table: string) => DatabaseClient;
@@ -439,4 +454,4 @@ interface LinabaseClient {
 }
 declare function createClient(config: LinabaseConfig): LinabaseClient;
 
-export { AuthClient, type AuthSession, type AuthUser, BucketClient, type CsvQueryResult, DatabaseClient, type FunctionInvokeOptions, FunctionsClient, type LinabaseClient, type LinabaseConfig, type OAuthProvider, type PostgrestError, type QueryResult, RpcClient, type SingleQueryResult, StorageClient, createClient };
+export { AuthClient, type AuthSession, type AuthUser, BucketClient, type CsvQueryResult, DatabaseClient, type FunctionInvokeOptions, FunctionsClient, type LinabaseClient, type LinabaseConfig, type OAuthProvider, type PostgrestError, type QueryResult, RpcClient, type SessionStorage, type SingleQueryResult, StorageClient, createClient };

package/dist/index.js

@@ -599,13 +599,28 @@ var AuthClient = class {
   /**
    * Set (or clear) the current session. Use this to restore a persisted
    * session on app launch (e.g., from AsyncStorage / SecureStore).
+   * Automatically refreshes the token if it has expired.
    * Emits INITIAL_SESSION to onAuthStateChange listeners when called externally.
    * Internal callers (signIn, signUp, etc.) pass _internal=true to skip the emit.
    */
   setSession(session, _internal) {
     this.currentSession = session;
     if (this.onSessionChange) this.onSessionChange(session);
-    if (!_internal) this.emit("INITIAL_SESSION", session);
+    if (!_internal) {
+      if (session && session.expires_at <= Math.floor(Date.now() / 1e3)) {
+        this.refreshSession().then(({ error }) => {
+          if (error) {
+            this.currentSession = null;
+            if (this.onSessionChange) this.onSessionChange(null);
+            this.emit("SIGNED_OUT", null);
+          } else {
+            this.emit("INITIAL_SESSION", this.currentSession);
+          }
+        });
+      } else {
+        this.emit("INITIAL_SESSION", session);
+      }
+    }
   }
   // ─── Email/Password ────────────────────────────────────────
   async signUp(params) {
@@ -1025,9 +1040,30 @@ function createClient(config) {
     });
   }
   const authClient = new AuthClient(request);
+  const persistSession = config.auth?.persistSession !== false && !!config.auth?.storage;
+  const sessionStorage = config.auth?.storage;
+  const sessionKey = config.auth?.storageKey || "@linabase/session";
   authClient.onSessionChange = (session) => {
     accessToken = session?.access_token || null;
   };
+  if (persistSession && sessionStorage) {
+    authClient.onAuthStateChange((event, session) => {
+      if (session) {
+        sessionStorage.setItem(sessionKey, JSON.stringify(session));
+      } else if (event === "SIGNED_OUT") {
+        sessionStorage.removeItem(sessionKey);
+      }
+    });
+    Promise.resolve(sessionStorage.getItem(sessionKey)).then((raw) => {
+      if (raw) {
+        try {
+          authClient.setSession(JSON.parse(raw));
+        } catch {
+          sessionStorage.removeItem(sessionKey);
+        }
+      }
+    });
+  }
   function buildClient(reqFn, branchSlug) {
     const rc = new RpcClient(reqFn);
     const ac = new AuthClient(reqFn);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linabase/js",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "JavaScript/TypeScript client SDK for Linabase (database, storage, auth)",
   "license": "MIT",
   "type": "module",