@linabase/js 0.2.3 → 0.3.1

package/dist/index.cjs

@@ -52,10 +52,9 @@ var DatabaseClient = class {
   // ─── Query Methods ──────────────────────────────────────
   /** Select columns. Supports nested joins: "*, comments(*)" and aliases: "full_name:name" */
   select(columns, options) {
-    this.method = "GET";
-    if (columns) this.params.set("select", columns);
+    this.method = options?.head ? "HEAD" : "GET";
+    if (columns && columns !== "*") this.params.set("select", columns);
     if (options?.count) this.preferHeaders.push(`count=${options.count}`);
-    if (options?.head) this.method = "GET";
     return this;
   }
   insert(data) {
@@ -269,6 +268,7 @@ var DatabaseClient = class {
   async execute() {
     const qs = this.params.toString();
     const path = `/rest/v1/${this.table}${qs ? `?${qs}` : ""}`;
+    const isHead = this.method === "HEAD";
     const isSingle = this._single;
     const isMaybeSingle = this._maybeSingle;
     const shouldThrow = this._throwOnError;
@@ -301,8 +301,11 @@ var DatabaseClient = class {
         body: this.body ? JSON.stringify(this.body) : void 0,
         signal: abortSignal
       });
-      const countHeader = res.headers.get("X-Total-Count");
+      const countHeader = res.headers.get("X-Total-Count") || res.headers.get("content-range")?.split("/")[1];
       const totalCount = countHeader ? parseInt(countHeader) : null;
+      if (isHead) {
+        return { data: null, error: res.ok ? null : { message: res.statusText }, count: totalCount };
+      }
       if (isCsv) {
         if (!res.ok) {
           const text = await res.text();
@@ -1072,9 +1075,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

@@ -416,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;
@@ -440,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

@@ -416,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;
@@ -440,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

@@ -20,10 +20,9 @@ var DatabaseClient = class {
   // ─── Query Methods ──────────────────────────────────────
   /** Select columns. Supports nested joins: "*, comments(*)" and aliases: "full_name:name" */
   select(columns, options) {
-    this.method = "GET";
-    if (columns) this.params.set("select", columns);
+    this.method = options?.head ? "HEAD" : "GET";
+    if (columns && columns !== "*") this.params.set("select", columns);
     if (options?.count) this.preferHeaders.push(`count=${options.count}`);
-    if (options?.head) this.method = "GET";
     return this;
   }
   insert(data) {
@@ -237,6 +236,7 @@ var DatabaseClient = class {
   async execute() {
     const qs = this.params.toString();
     const path = `/rest/v1/${this.table}${qs ? `?${qs}` : ""}`;
+    const isHead = this.method === "HEAD";
     const isSingle = this._single;
     const isMaybeSingle = this._maybeSingle;
     const shouldThrow = this._throwOnError;
@@ -269,8 +269,11 @@ var DatabaseClient = class {
         body: this.body ? JSON.stringify(this.body) : void 0,
         signal: abortSignal
       });
-      const countHeader = res.headers.get("X-Total-Count");
+      const countHeader = res.headers.get("X-Total-Count") || res.headers.get("content-range")?.split("/")[1];
       const totalCount = countHeader ? parseInt(countHeader) : null;
+      if (isHead) {
+        return { data: null, error: res.ok ? null : { message: res.statusText }, count: totalCount };
+      }
       if (isCsv) {
         if (!res.ok) {
           const text = await res.text();
@@ -1040,9 +1043,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.3",
+  "version": "0.3.1",
   "description": "JavaScript/TypeScript client SDK for Linabase (database, storage, auth)",
   "license": "MIT",
   "type": "module",