@aurabase/aurabase-js 0.5.2 → 0.5.4

package/dist/react.cjs

@@ -0,0 +1,150 @@
+'use strict';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/react.ts
+function getReact() {
+  const g = globalThis;
+  if (g.React) {
+    return g.React;
+  }
+  if (typeof __require === "function") {
+    try {
+      return __require("react");
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+var defaultAuthContextValue = {
+  client: null,
+  user: null,
+  session: null,
+  accessToken: null,
+  isLoading: true,
+  isAuthenticated: false,
+  signOut: async () => {
+  }
+};
+var authContextInstance = null;
+function getAuthContext() {
+  if (!authContextInstance) {
+    const React = getReact();
+    if (React?.createContext) {
+      authContextInstance = React.createContext(defaultAuthContextValue);
+    }
+  }
+  return authContextInstance;
+}
+function AuthProvider({ client, children, initialSession = null }) {
+  const React = getReact();
+  if (!React) {
+    throw new Error("[@aurabase/react] React est requis pour utiliser <AuthProvider>.");
+  }
+  const [session, setSession] = React.useState(initialSession);
+  const [user, setUser] = React.useState(initialSession?.user ?? null);
+  const [isLoading, setIsLoading] = React.useState(!initialSession);
+  React.useEffect(() => {
+    let isMounted = true;
+    void client.auth.getSession().then(({ data }) => {
+      if (!isMounted) return;
+      const s = data?.session ?? null;
+      setSession(s);
+      setUser(s?.user ?? null);
+      setIsLoading(false);
+    }).catch(() => {
+      if (!isMounted) return;
+      setIsLoading(false);
+    });
+    const subscription = client.auth.onAuthStateChange(({ event, user: nextUser }) => {
+      if (!isMounted) return;
+      if (event === "SIGNED_OUT") {
+        setSession(null);
+        setUser(null);
+      } else if (event === "SIGNED_IN" || event === "TOKEN_REFRESHED" || event === "USER_UPDATED") {
+        void client.auth.getSession().then(({ data }) => {
+          if (!isMounted) return;
+          const s = data?.session ?? null;
+          setSession(s);
+          setUser(nextUser ?? s?.user ?? null);
+        }).catch(() => {
+        });
+      }
+    });
+    return () => {
+      isMounted = false;
+      subscription.unsubscribe();
+    };
+  }, [client]);
+  const value = React.useMemo(
+    () => ({
+      client,
+      user,
+      session,
+      accessToken: session?.access_token ?? null,
+      isLoading,
+      isAuthenticated: !!user,
+      signOut: async () => {
+        await client.auth.signOut();
+        setSession(null);
+        setUser(null);
+      }
+    }),
+    [client, user, session, isLoading]
+  );
+  const Context = getAuthContext();
+  if (!Context) {
+    return children;
+  }
+  return React.createElement(Context.Provider, { value }, children);
+}
+function useAuth() {
+  const React = getReact();
+  const Context = getAuthContext();
+  if (!React || !Context) {
+    return {
+      client: null,
+      user: null,
+      session: null,
+      accessToken: null,
+      isLoading: false,
+      isAuthenticated: false,
+      signOut: async () => {
+      }
+    };
+  }
+  return React.useContext(Context);
+}
+function useUser() {
+  const { user } = useAuth();
+  return user;
+}
+function useSession() {
+  const { session } = useAuth();
+  return session;
+}
+function SignedIn({ children }) {
+  const React = getReact();
+  const { isAuthenticated, isLoading } = useAuth();
+  if (isLoading || !isAuthenticated || !React) return null;
+  return React.createElement(React.Fragment, null, children);
+}
+function SignedOut({ children }) {
+  const React = getReact();
+  const { isAuthenticated, isLoading } = useAuth();
+  if (isLoading || isAuthenticated || !React) return null;
+  return React.createElement(React.Fragment, null, children);
+}
+
+exports.AuthProvider = AuthProvider;
+exports.SignedIn = SignedIn;
+exports.SignedOut = SignedOut;
+exports.useAuth = useAuth;
+exports.useSession = useSession;
+exports.useUser = useUser;

package/dist/react.d.cts

@@ -0,0 +1,82 @@
+import { User, Session } from '@aurabase/core';
+import { A as AuraClient } from './AuraClient-5jDiXjrO.cjs';
+import '@aurabase/ai';
+import '@aurabase/auth';
+import '@aurabase/db';
+import '@aurabase/functions';
+import '@aurabase/notifications';
+import '@aurabase/realtime';
+import '@aurabase/storage';
+
+/**
+ * React Context, hooks, and lifecycle primitives for Aurabase Auth.
+ *
+ * Provides Clerk-level reactive DX:
+ * - `<AuthProvider>`: React context managing real-time auth state across the tree.
+ * - `useAuth()`: Access client, status, token, and sign-out helpers.
+ * - `useUser()`: Reactive access to the currently signed-in user.
+ * - `useSession()`: Reactive access to active session data.
+ * - `<SignedIn>` / `<SignedOut>`: Conditional rendering wrappers.
+ *
+ * @module react
+ */
+
+type ReactNode = unknown;
+interface ReactContext<T> {
+    Provider: unknown;
+    Consumer: unknown;
+    _currentValue?: T;
+}
+interface ReactRuntime {
+    createContext<T>(defaultValue: T): ReactContext<T>;
+    useContext<T>(context: ReactContext<T>): T;
+    useState<T>(initialState: T | (() => T)): [T, (value: T | ((prev: T) => T)) => void];
+    useEffect(effect: () => void | (() => void), deps?: readonly unknown[]): void;
+    useMemo<T>(factory: () => T, deps?: readonly unknown[]): T;
+    createElement(type: unknown, props?: Record<string, unknown> | null, ...children: unknown[]): unknown;
+    Fragment: unknown;
+}
+interface AuthContextValue {
+    client: AuraClient | null;
+    user: User | null;
+    session: Session | null;
+    accessToken: string | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    signOut: () => Promise<void>;
+}
+interface AuthProviderProps {
+    client: AuraClient;
+    children: ReactNode;
+    initialSession?: Session | null;
+}
+/**
+ * Wraps your application to provide reactive Aurabase authentication context.
+ */
+declare function AuthProvider({ client, children, initialSession }: AuthProviderProps): unknown;
+/**
+ * Access the core Aurabase authentication state and actions.
+ */
+declare function useAuth(): AuthContextValue;
+/**
+ * Returns the currently authenticated user, or null if unauthenticated.
+ */
+declare function useUser(): User | null;
+/**
+ * Returns the current active session.
+ */
+declare function useSession(): Session | null;
+/**
+ * Conditional component rendering children only when a user is signed in.
+ */
+declare function SignedIn({ children }: {
+    children: ReactNode;
+}): unknown;
+/**
+ * Conditional component rendering children only when NO user is signed in.
+ */
+declare function SignedOut({ children }: {
+    children: ReactNode;
+}): unknown;
+
+export { type AuthContextValue, AuthProvider, type AuthProviderProps, type ReactContext, type ReactNode, type ReactRuntime, SignedIn, SignedOut, useAuth, useSession, useUser };

package/dist/react.d.ts

@@ -0,0 +1,82 @@
+import { User, Session } from '@aurabase/core';
+import { A as AuraClient } from './AuraClient-5jDiXjrO.js';
+import '@aurabase/ai';
+import '@aurabase/auth';
+import '@aurabase/db';
+import '@aurabase/functions';
+import '@aurabase/notifications';
+import '@aurabase/realtime';
+import '@aurabase/storage';
+
+/**
+ * React Context, hooks, and lifecycle primitives for Aurabase Auth.
+ *
+ * Provides Clerk-level reactive DX:
+ * - `<AuthProvider>`: React context managing real-time auth state across the tree.
+ * - `useAuth()`: Access client, status, token, and sign-out helpers.
+ * - `useUser()`: Reactive access to the currently signed-in user.
+ * - `useSession()`: Reactive access to active session data.
+ * - `<SignedIn>` / `<SignedOut>`: Conditional rendering wrappers.
+ *
+ * @module react
+ */
+
+type ReactNode = unknown;
+interface ReactContext<T> {
+    Provider: unknown;
+    Consumer: unknown;
+    _currentValue?: T;
+}
+interface ReactRuntime {
+    createContext<T>(defaultValue: T): ReactContext<T>;
+    useContext<T>(context: ReactContext<T>): T;
+    useState<T>(initialState: T | (() => T)): [T, (value: T | ((prev: T) => T)) => void];
+    useEffect(effect: () => void | (() => void), deps?: readonly unknown[]): void;
+    useMemo<T>(factory: () => T, deps?: readonly unknown[]): T;
+    createElement(type: unknown, props?: Record<string, unknown> | null, ...children: unknown[]): unknown;
+    Fragment: unknown;
+}
+interface AuthContextValue {
+    client: AuraClient | null;
+    user: User | null;
+    session: Session | null;
+    accessToken: string | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    signOut: () => Promise<void>;
+}
+interface AuthProviderProps {
+    client: AuraClient;
+    children: ReactNode;
+    initialSession?: Session | null;
+}
+/**
+ * Wraps your application to provide reactive Aurabase authentication context.
+ */
+declare function AuthProvider({ client, children, initialSession }: AuthProviderProps): unknown;
+/**
+ * Access the core Aurabase authentication state and actions.
+ */
+declare function useAuth(): AuthContextValue;
+/**
+ * Returns the currently authenticated user, or null if unauthenticated.
+ */
+declare function useUser(): User | null;
+/**
+ * Returns the current active session.
+ */
+declare function useSession(): Session | null;
+/**
+ * Conditional component rendering children only when a user is signed in.
+ */
+declare function SignedIn({ children }: {
+    children: ReactNode;
+}): unknown;
+/**
+ * Conditional component rendering children only when NO user is signed in.
+ */
+declare function SignedOut({ children }: {
+    children: ReactNode;
+}): unknown;
+
+export { type AuthContextValue, AuthProvider, type AuthProviderProps, type ReactContext, type ReactNode, type ReactRuntime, SignedIn, SignedOut, useAuth, useSession, useUser };

package/dist/react.js

@@ -0,0 +1,143 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/react.ts
+function getReact() {
+  const g = globalThis;
+  if (g.React) {
+    return g.React;
+  }
+  if (typeof __require === "function") {
+    try {
+      return __require("react");
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+var defaultAuthContextValue = {
+  client: null,
+  user: null,
+  session: null,
+  accessToken: null,
+  isLoading: true,
+  isAuthenticated: false,
+  signOut: async () => {
+  }
+};
+var authContextInstance = null;
+function getAuthContext() {
+  if (!authContextInstance) {
+    const React = getReact();
+    if (React?.createContext) {
+      authContextInstance = React.createContext(defaultAuthContextValue);
+    }
+  }
+  return authContextInstance;
+}
+function AuthProvider({ client, children, initialSession = null }) {
+  const React = getReact();
+  if (!React) {
+    throw new Error("[@aurabase/react] React est requis pour utiliser <AuthProvider>.");
+  }
+  const [session, setSession] = React.useState(initialSession);
+  const [user, setUser] = React.useState(initialSession?.user ?? null);
+  const [isLoading, setIsLoading] = React.useState(!initialSession);
+  React.useEffect(() => {
+    let isMounted = true;
+    void client.auth.getSession().then(({ data }) => {
+      if (!isMounted) return;
+      const s = data?.session ?? null;
+      setSession(s);
+      setUser(s?.user ?? null);
+      setIsLoading(false);
+    }).catch(() => {
+      if (!isMounted) return;
+      setIsLoading(false);
+    });
+    const subscription = client.auth.onAuthStateChange(({ event, user: nextUser }) => {
+      if (!isMounted) return;
+      if (event === "SIGNED_OUT") {
+        setSession(null);
+        setUser(null);
+      } else if (event === "SIGNED_IN" || event === "TOKEN_REFRESHED" || event === "USER_UPDATED") {
+        void client.auth.getSession().then(({ data }) => {
+          if (!isMounted) return;
+          const s = data?.session ?? null;
+          setSession(s);
+          setUser(nextUser ?? s?.user ?? null);
+        }).catch(() => {
+        });
+      }
+    });
+    return () => {
+      isMounted = false;
+      subscription.unsubscribe();
+    };
+  }, [client]);
+  const value = React.useMemo(
+    () => ({
+      client,
+      user,
+      session,
+      accessToken: session?.access_token ?? null,
+      isLoading,
+      isAuthenticated: !!user,
+      signOut: async () => {
+        await client.auth.signOut();
+        setSession(null);
+        setUser(null);
+      }
+    }),
+    [client, user, session, isLoading]
+  );
+  const Context = getAuthContext();
+  if (!Context) {
+    return children;
+  }
+  return React.createElement(Context.Provider, { value }, children);
+}
+function useAuth() {
+  const React = getReact();
+  const Context = getAuthContext();
+  if (!React || !Context) {
+    return {
+      client: null,
+      user: null,
+      session: null,
+      accessToken: null,
+      isLoading: false,
+      isAuthenticated: false,
+      signOut: async () => {
+      }
+    };
+  }
+  return React.useContext(Context);
+}
+function useUser() {
+  const { user } = useAuth();
+  return user;
+}
+function useSession() {
+  const { session } = useAuth();
+  return session;
+}
+function SignedIn({ children }) {
+  const React = getReact();
+  const { isAuthenticated, isLoading } = useAuth();
+  if (isLoading || !isAuthenticated || !React) return null;
+  return React.createElement(React.Fragment, null, children);
+}
+function SignedOut({ children }) {
+  const React = getReact();
+  const { isAuthenticated, isLoading } = useAuth();
+  if (isLoading || isAuthenticated || !React) return null;
+  return React.createElement(React.Fragment, null, children);
+}
+
+export { AuthProvider, SignedIn, SignedOut, useAuth, useSession, useUser };

package/dist/ssr.cjs

@@ -63,6 +63,11 @@ var AuraClient = class {
         "[aurabase] No API key provided. Most operations require an API key (apikey header). Only public auth routes (register, login, refresh) will work without one."
       );
     }
+    if (typeof console !== "undefined" && /^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?\/?$/.test(this.baseUrl)) {
+      console.warn(
+        "[aurabase] Attention : en local, l'URL du projet doit inclure le sous-domaine (ex: http://<slug>.localhost:8080) pour permettre la r\xE9solution automatique du projet par la passerelle."
+      );
+    }
     if (this.apiKey?.startsWith(SERVICE_ROLE_KEY_PREFIX) && isBrowserContext()) {
       const refuse = resolvedOptions?.refuseServiceRoleInBrowser ?? true;
       const message = "[aurabase] S\xC9CURIT\xC9 : une cl\xE9 service_role (aura_sk_\u2026) est fournie \xE0 createClient() dans un contexte navigateur. Cette cl\xE9 \xE0 privil\xE8ges \xE9lev\xE9s NE DOIT JAMAIS \xEAtre expos\xE9e c\xF4t\xE9 client (elle fuiterait dans le bundle). Utilisez une cl\xE9 anon (aura_anon_\u2026) c\xF4t\xE9 client, et createAdminClient() c\xF4t\xE9 serveur pour les op\xE9rations d'administration.";
@@ -76,7 +81,12 @@ var AuraClient = class {
       this.authStore = resolvedOptions.auth.storage;
     } else if (resolvedOptions?.auth?.persistSession === false) {
       this.authStore = new core.BaseAuthStore();
-    } else if (typeof localStorage !== "undefined") {
+    } else if (isBrowserContext() && typeof window.localStorage !== "undefined" || typeof globalThis !== "undefined" && (() => {
+      const g = globalThis;
+      const proc = g?.process;
+      const isTest = !!(proc?.env?.VITEST || proc?.env?.NODE_ENV === "test" || proc?.env?.JEST_WORKER_ID);
+      return isTest && !!g?.localStorage && typeof g.localStorage.getItem === "function";
+    })()) {
       this.authStore = new core.LocalAuthStore(`aura-${core.clientScope(this.baseUrl)}-auth`);
     } else {
       this.authStore = new core.BaseAuthStore();
@@ -153,6 +163,21 @@ var AuraClient = class {
     if (!this._notifications) this._notifications = new notifications.NotificationsService(this);
     return this._notifications;
   }
+  from(table) {
+    return this.db.from(table);
+  }
+  /**
+   * Shortcut: call a stored procedure / PostgreSQL function via RPC (Supabase-compatible API).
+   * Equivalent to `aura.db.rpc(fn, args, options)`.
+   *
+   * @example
+   * ```ts
+   * const { data, error } = await aura.rpc('echo_test', { message: 'hello' })
+   * ```
+   */
+  rpc(fn, args, options) {
+    return this.db.rpc(fn, args, options);
+  }
   /**
    * Shortcut: create a realtime channel with Supabase-compatible API.
    * Equivalent to `aura.realtime.channel(name)`.

package/dist/ssr.d.cts

@@ -1,6 +1,6 @@
 import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
 export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
-import { A as AuraClient } from './AuraClient-DL7mqfNu.cjs';
+import { A as AuraClient } from './AuraClient-5jDiXjrO.cjs';
 import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';

package/dist/ssr.d.ts

@@ -1,6 +1,6 @@
 import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
 export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
-import { A as AuraClient } from './AuraClient-DL7mqfNu.js';
+import { A as AuraClient } from './AuraClient-5jDiXjrO.js';
 import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';

package/dist/ssr.js

@@ -62,6 +62,11 @@ var AuraClient = class {
         "[aurabase] No API key provided. Most operations require an API key (apikey header). Only public auth routes (register, login, refresh) will work without one."
       );
     }
+    if (typeof console !== "undefined" && /^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?\/?$/.test(this.baseUrl)) {
+      console.warn(
+        "[aurabase] Attention : en local, l'URL du projet doit inclure le sous-domaine (ex: http://<slug>.localhost:8080) pour permettre la r\xE9solution automatique du projet par la passerelle."
+      );
+    }
     if (this.apiKey?.startsWith(SERVICE_ROLE_KEY_PREFIX) && isBrowserContext()) {
       const refuse = resolvedOptions?.refuseServiceRoleInBrowser ?? true;
       const message = "[aurabase] S\xC9CURIT\xC9 : une cl\xE9 service_role (aura_sk_\u2026) est fournie \xE0 createClient() dans un contexte navigateur. Cette cl\xE9 \xE0 privil\xE8ges \xE9lev\xE9s NE DOIT JAMAIS \xEAtre expos\xE9e c\xF4t\xE9 client (elle fuiterait dans le bundle). Utilisez une cl\xE9 anon (aura_anon_\u2026) c\xF4t\xE9 client, et createAdminClient() c\xF4t\xE9 serveur pour les op\xE9rations d'administration.";
@@ -75,7 +80,12 @@ var AuraClient = class {
       this.authStore = resolvedOptions.auth.storage;
     } else if (resolvedOptions?.auth?.persistSession === false) {
       this.authStore = new BaseAuthStore();
-    } else if (typeof localStorage !== "undefined") {
+    } else if (isBrowserContext() && typeof window.localStorage !== "undefined" || typeof globalThis !== "undefined" && (() => {
+      const g = globalThis;
+      const proc = g?.process;
+      const isTest = !!(proc?.env?.VITEST || proc?.env?.NODE_ENV === "test" || proc?.env?.JEST_WORKER_ID);
+      return isTest && !!g?.localStorage && typeof g.localStorage.getItem === "function";
+    })()) {
       this.authStore = new LocalAuthStore(`aura-${clientScope(this.baseUrl)}-auth`);
     } else {
       this.authStore = new BaseAuthStore();
@@ -152,6 +162,21 @@ var AuraClient = class {
     if (!this._notifications) this._notifications = new NotificationsService(this);
     return this._notifications;
   }
+  from(table) {
+    return this.db.from(table);
+  }
+  /**
+   * Shortcut: call a stored procedure / PostgreSQL function via RPC (Supabase-compatible API).
+   * Equivalent to `aura.db.rpc(fn, args, options)`.
+   *
+   * @example
+   * ```ts
+   * const { data, error } = await aura.rpc('echo_test', { message: 'hello' })
+   * ```
+   */
+  rpc(fn, args, options) {
+    return this.db.rpc(fn, args, options);
+  }
   /**
    * Shortcut: create a realtime channel with Supabase-compatible API.
    * Equivalent to `aura.realtime.channel(name)`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurabase/aurabase-js",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Official JavaScript/TypeScript client for Aurabase BaaS",
   "type": "module",
   "main": "dist/index.cjs",
@@ -26,6 +26,26 @@
         "types": "./dist/ssr.d.cts",
         "default": "./dist/ssr.cjs"
       }
+    },
+    "./nextjs": {
+      "import": {
+        "types": "./dist/nextjs.d.ts",
+        "default": "./dist/nextjs.js"
+      },
+      "require": {
+        "types": "./dist/nextjs.d.cts",
+        "default": "./dist/nextjs.cjs"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
     }
   },
   "sideEffects": false,
@@ -56,14 +76,14 @@
     "client"
   ],
   "dependencies": {
-    "@aurabase/core": "0.5.2",
-    "@aurabase/db": "0.5.2",
-    "@aurabase/storage": "0.5.2",
-    "@aurabase/auth": "0.5.2",
-    "@aurabase/realtime": "0.5.2",
-    "@aurabase/notifications": "0.5.2",
-    "@aurabase/ai": "0.5.2",
-    "@aurabase/functions": "0.5.2"
+    "@aurabase/db": "0.5.4",
+    "@aurabase/core": "0.5.4",
+    "@aurabase/auth": "0.5.4",
+    "@aurabase/realtime": "0.5.4",
+    "@aurabase/storage": "0.5.4",
+    "@aurabase/notifications": "0.5.4",
+    "@aurabase/ai": "0.5.4",
+    "@aurabase/functions": "0.5.4"
   },
   "devDependencies": {
     "@types/node": "20.14.15",