@allem-sdk/auth 0.1.1 → 0.1.3

package/README.md

@@ -3,6 +3,7 @@
 </p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/@allem-sdk/auth"><img src="https://img.shields.io/npm/v/@allem-sdk/auth.svg" alt="npm version" /></a>
   <a href="https://github.com/kingofmit/allem-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
   <img src="https://img.shields.io/badge/react-19-61dafb" alt="React 19" />
   <img src="https://img.shields.io/badge/typescript-strict-blue" alt="TypeScript" />
@@ -10,7 +11,7 @@
 
 # @allem-sdk/auth
 
-Authentication helpers for React. Provider-agnostic via an adapter interface — works with any auth backend.
+Authentication helpers for React. Provider-agnostic via an adapter interface that works with any auth backend.
 
 ## Installation
 
@@ -61,6 +62,33 @@ function Dashboard() {
 }
 ```
 
+## Built-in Adapters
+
+Pre-built adapters for popular auth providers — no need to write your own:
+
+```tsx
+import { supabaseAdapter, nextAuthAdapter, clerkAdapter } from "@allem-sdk/auth";
+```
+
+| Adapter | Usage | Notes |
+|---------|-------|-------|
+| `supabaseAdapter(supabase)` | Pass your Supabase client | Wraps `signInWithPassword`, reads session/user |
+| `nextAuthAdapter(options?)` | `{ basePath?: string }` | Fetches from `/api/auth/session`. Works with v4/v5 |
+| `clerkAdapter(clerk)` | Pass the Clerk instance | Read-only — sign-in is handled by Clerk's `<SignIn />` |
+
+```tsx
+// Supabase
+import { createClient } from "@supabase/supabase-js";
+const supabase = createClient(url, key);
+<AuthProvider adapter={supabaseAdapter(supabase)}>
+
+// NextAuth
+<AuthProvider adapter={nextAuthAdapter()}>
+
+// Clerk
+<AuthProvider adapter={clerkAdapter(clerk)}>
+```
+
 ## Exports
 
 | Export | Type | Description |
@@ -69,6 +97,9 @@ function Dashboard() {
 | `useAuth` | Hook | Returns `user`, `status`, `isAuthenticated`, `isLoading`, `signIn`, `signOut` |
 | `useSession` | Hook | Returns `session` object and `update` function |
 | `ProtectedRoute` | Component | Renders children only when authenticated, with fallback support |
+| `supabaseAdapter` | Factory | Adapter for Supabase auth |
+| `nextAuthAdapter` | Factory | Adapter for NextAuth.js |
+| `clerkAdapter` | Factory | Adapter for Clerk |
 
 ## Part of [Allem SDK](https://github.com/kingofmit/allem-sdk)
 

package/dist/index.d.mts

@@ -48,4 +48,74 @@ interface ProtectedRouteProps {
 }
 declare function ProtectedRoute({ children, fallback, loadingFallback, }: ProtectedRouteProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthAdapter, AuthProvider, type AuthProviderProps, type AuthSession, type AuthStatus, type AuthUser, ProtectedRoute, type ProtectedRouteProps, type UseAuthReturn, type UseSessionReturn, useAuth, useSession };
+/**
+ * Supabase auth adapter. Wraps `@supabase/supabase-js` client.
+ *
+ * @example
+ * ```tsx
+ * import { createClient } from "@supabase/supabase-js";
+ * const supabase = createClient(url, key);
+ *
+ * <AuthProvider adapter={supabaseAdapter(supabase)}>
+ * ```
+ */
+declare function supabaseAdapter(supabase: {
+    auth: {
+        getSession: () => Promise<{
+            data: {
+                session: unknown;
+            };
+        }>;
+        signInWithPassword: (creds: {
+            email: string;
+            password: string;
+        }) => Promise<{
+            data: {
+                session: unknown;
+                user: unknown;
+            };
+            error: unknown;
+        }>;
+        signOut: () => Promise<unknown>;
+    };
+}): AuthAdapter;
+/**
+ * NextAuth adapter. Works with NextAuth.js v4/v5 session endpoint.
+ *
+ * @example
+ * ```tsx
+ * <AuthProvider adapter={nextAuthAdapter()}>
+ * // or with custom base URL:
+ * <AuthProvider adapter={nextAuthAdapter({ basePath: "/api/auth" })}>
+ * ```
+ */
+declare function nextAuthAdapter(options?: {
+    basePath?: string;
+}): AuthAdapter;
+/**
+ * Clerk adapter. Wraps `@clerk/clerk-react` hooks for use with AuthProvider.
+ *
+ * @example
+ * ```tsx
+ * import { useClerk, useUser } from "@clerk/clerk-react";
+ *
+ * // Pass the Clerk instance:
+ * <AuthProvider adapter={clerkAdapter(clerk)}>
+ * ```
+ */
+declare function clerkAdapter(clerk: {
+    session: {
+        getToken: () => Promise<string | null>;
+    } | null;
+    user: {
+        id: string;
+        primaryEmailAddress?: {
+            emailAddress: string;
+        } | null;
+        fullName?: string | null;
+        imageUrl?: string | null;
+    } | null | undefined;
+    signOut: () => Promise<void>;
+}): AuthAdapter;
+
+export { type AuthAdapter, AuthProvider, type AuthProviderProps, type AuthSession, type AuthStatus, type AuthUser, ProtectedRoute, type ProtectedRouteProps, type UseAuthReturn, type UseSessionReturn, clerkAdapter, nextAuthAdapter, supabaseAdapter, useAuth, useSession };

package/dist/index.d.ts

@@ -48,4 +48,74 @@ interface ProtectedRouteProps {
 }
 declare function ProtectedRoute({ children, fallback, loadingFallback, }: ProtectedRouteProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthAdapter, AuthProvider, type AuthProviderProps, type AuthSession, type AuthStatus, type AuthUser, ProtectedRoute, type ProtectedRouteProps, type UseAuthReturn, type UseSessionReturn, useAuth, useSession };
+/**
+ * Supabase auth adapter. Wraps `@supabase/supabase-js` client.
+ *
+ * @example
+ * ```tsx
+ * import { createClient } from "@supabase/supabase-js";
+ * const supabase = createClient(url, key);
+ *
+ * <AuthProvider adapter={supabaseAdapter(supabase)}>
+ * ```
+ */
+declare function supabaseAdapter(supabase: {
+    auth: {
+        getSession: () => Promise<{
+            data: {
+                session: unknown;
+            };
+        }>;
+        signInWithPassword: (creds: {
+            email: string;
+            password: string;
+        }) => Promise<{
+            data: {
+                session: unknown;
+                user: unknown;
+            };
+            error: unknown;
+        }>;
+        signOut: () => Promise<unknown>;
+    };
+}): AuthAdapter;
+/**
+ * NextAuth adapter. Works with NextAuth.js v4/v5 session endpoint.
+ *
+ * @example
+ * ```tsx
+ * <AuthProvider adapter={nextAuthAdapter()}>
+ * // or with custom base URL:
+ * <AuthProvider adapter={nextAuthAdapter({ basePath: "/api/auth" })}>
+ * ```
+ */
+declare function nextAuthAdapter(options?: {
+    basePath?: string;
+}): AuthAdapter;
+/**
+ * Clerk adapter. Wraps `@clerk/clerk-react` hooks for use with AuthProvider.
+ *
+ * @example
+ * ```tsx
+ * import { useClerk, useUser } from "@clerk/clerk-react";
+ *
+ * // Pass the Clerk instance:
+ * <AuthProvider adapter={clerkAdapter(clerk)}>
+ * ```
+ */
+declare function clerkAdapter(clerk: {
+    session: {
+        getToken: () => Promise<string | null>;
+    } | null;
+    user: {
+        id: string;
+        primaryEmailAddress?: {
+            emailAddress: string;
+        } | null;
+        fullName?: string | null;
+        imageUrl?: string | null;
+    } | null | undefined;
+    signOut: () => Promise<void>;
+}): AuthAdapter;
+
+export { type AuthAdapter, AuthProvider, type AuthProviderProps, type AuthSession, type AuthStatus, type AuthUser, ProtectedRoute, type ProtectedRouteProps, type UseAuthReturn, type UseSessionReturn, clerkAdapter, nextAuthAdapter, supabaseAdapter, useAuth, useSession };

package/dist/index.js

@@ -23,6 +23,9 @@ var index_exports = {};
 __export(index_exports, {
   AuthProvider: () => AuthProvider,
   ProtectedRoute: () => ProtectedRoute,
+  clerkAdapter: () => clerkAdapter,
+  nextAuthAdapter: () => nextAuthAdapter,
+  supabaseAdapter: () => supabaseAdapter,
   useAuth: () => useAuth,
   useSession: () => useSession
 });
@@ -111,10 +114,116 @@ function ProtectedRoute({
   if (status === "unauthenticated") return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: fallback });
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children });
 }
+
+// src/adapters.ts
+function supabaseAdapter(supabase) {
+  return {
+    async getSession() {
+      const { data } = await supabase.auth.getSession();
+      const session = data.session;
+      if (!session) return { user: null, token: null, expiresAt: null };
+      const user = session.user;
+      return {
+        user: user ? {
+          id: String(user.id),
+          email: user.email,
+          name: user.user_metadata?.full_name,
+          image: user.user_metadata?.avatar_url
+        } : null,
+        token: session.access_token ?? null,
+        expiresAt: session.expires_at ? session.expires_at * 1e3 : null
+      };
+    },
+    async signIn(credentials) {
+      const { data, error } = await supabase.auth.signInWithPassword({
+        email: credentials.email,
+        password: credentials.password
+      });
+      if (error) throw error;
+      const user = data.user;
+      const session = data.session;
+      return {
+        user: user ? {
+          id: String(user.id),
+          email: user.email,
+          name: user.user_metadata?.full_name
+        } : null,
+        token: session ? session.access_token : null,
+        expiresAt: session?.expires_at ? session.expires_at * 1e3 : null
+      };
+    },
+    async signOut() {
+      await supabase.auth.signOut();
+    }
+  };
+}
+function nextAuthAdapter(options) {
+  const basePath = options?.basePath ?? "/api/auth";
+  return {
+    async getSession() {
+      const res = await fetch(`${basePath}/session`);
+      if (!res.ok) return { user: null, token: null, expiresAt: null };
+      const data = await res.json();
+      if (!data.user) return { user: null, token: null, expiresAt: null };
+      const user = data.user;
+      return {
+        user: {
+          id: String(user.id ?? user.email),
+          email: user.email,
+          name: user.name,
+          image: user.image
+        },
+        token: data.accessToken ?? null,
+        expiresAt: data.expires ? new Date(data.expires).getTime() : null
+      };
+    },
+    async signIn(credentials) {
+      const res = await fetch(`${basePath}/callback/credentials`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(credentials)
+      });
+      if (!res.ok) throw new Error("Sign in failed");
+      return this.getSession();
+    },
+    async signOut() {
+      await fetch(`${basePath}/signout`, { method: "POST" });
+    }
+  };
+}
+function clerkAdapter(clerk) {
+  return {
+    async getSession() {
+      if (!clerk.user) return { user: null, token: null, expiresAt: null };
+      const token = clerk.session ? await clerk.session.getToken() : null;
+      return {
+        user: {
+          id: clerk.user.id,
+          email: clerk.user.primaryEmailAddress?.emailAddress,
+          name: clerk.user.fullName ?? void 0,
+          image: clerk.user.imageUrl ?? void 0
+        },
+        token,
+        expiresAt: null
+      };
+    },
+    async signIn() {
+      throw new Error(
+        "Clerk manages sign-in via its own components. Use <SignIn /> from @clerk/clerk-react."
+      );
+    },
+    async signOut() {
+      await clerk.signOut();
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthProvider,
   ProtectedRoute,
+  clerkAdapter,
+  nextAuthAdapter,
+  supabaseAdapter,
   useAuth,
   useSession
 });

package/dist/index.mjs

@@ -83,9 +83,115 @@ function ProtectedRoute({
   if (status === "unauthenticated") return /* @__PURE__ */ jsx2(Fragment, { children: fallback });
   return /* @__PURE__ */ jsx2(Fragment, { children });
 }
+
+// src/adapters.ts
+function supabaseAdapter(supabase) {
+  return {
+    async getSession() {
+      const { data } = await supabase.auth.getSession();
+      const session = data.session;
+      if (!session) return { user: null, token: null, expiresAt: null };
+      const user = session.user;
+      return {
+        user: user ? {
+          id: String(user.id),
+          email: user.email,
+          name: user.user_metadata?.full_name,
+          image: user.user_metadata?.avatar_url
+        } : null,
+        token: session.access_token ?? null,
+        expiresAt: session.expires_at ? session.expires_at * 1e3 : null
+      };
+    },
+    async signIn(credentials) {
+      const { data, error } = await supabase.auth.signInWithPassword({
+        email: credentials.email,
+        password: credentials.password
+      });
+      if (error) throw error;
+      const user = data.user;
+      const session = data.session;
+      return {
+        user: user ? {
+          id: String(user.id),
+          email: user.email,
+          name: user.user_metadata?.full_name
+        } : null,
+        token: session ? session.access_token : null,
+        expiresAt: session?.expires_at ? session.expires_at * 1e3 : null
+      };
+    },
+    async signOut() {
+      await supabase.auth.signOut();
+    }
+  };
+}
+function nextAuthAdapter(options) {
+  const basePath = options?.basePath ?? "/api/auth";
+  return {
+    async getSession() {
+      const res = await fetch(`${basePath}/session`);
+      if (!res.ok) return { user: null, token: null, expiresAt: null };
+      const data = await res.json();
+      if (!data.user) return { user: null, token: null, expiresAt: null };
+      const user = data.user;
+      return {
+        user: {
+          id: String(user.id ?? user.email),
+          email: user.email,
+          name: user.name,
+          image: user.image
+        },
+        token: data.accessToken ?? null,
+        expiresAt: data.expires ? new Date(data.expires).getTime() : null
+      };
+    },
+    async signIn(credentials) {
+      const res = await fetch(`${basePath}/callback/credentials`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(credentials)
+      });
+      if (!res.ok) throw new Error("Sign in failed");
+      return this.getSession();
+    },
+    async signOut() {
+      await fetch(`${basePath}/signout`, { method: "POST" });
+    }
+  };
+}
+function clerkAdapter(clerk) {
+  return {
+    async getSession() {
+      if (!clerk.user) return { user: null, token: null, expiresAt: null };
+      const token = clerk.session ? await clerk.session.getToken() : null;
+      return {
+        user: {
+          id: clerk.user.id,
+          email: clerk.user.primaryEmailAddress?.emailAddress,
+          name: clerk.user.fullName ?? void 0,
+          image: clerk.user.imageUrl ?? void 0
+        },
+        token,
+        expiresAt: null
+      };
+    },
+    async signIn() {
+      throw new Error(
+        "Clerk manages sign-in via its own components. Use <SignIn /> from @clerk/clerk-react."
+      );
+    },
+    async signOut() {
+      await clerk.signOut();
+    }
+  };
+}
 export {
   AuthProvider,
   ProtectedRoute,
+  clerkAdapter,
+  nextAuthAdapter,
+  supabaseAdapter,
   useAuth,
   useSession
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@allem-sdk/auth",
-  "version": "0.1.1",
-  "description": "Authentication helpers for React — session, protected routes, social login",
+  "version": "0.1.3",
+  "description": "React authentication hooks with session management and protected routes. Provider-agnostic adapter pattern. useAuth, useSession, ProtectedRoute.",
   "license": "MIT",
   "author": "Ahmed Allem",
   "main": "./dist/index.js",
@@ -39,11 +39,15 @@
   "keywords": [
     "allem-sdk",
     "react",
-    "hooks",
+    "react-hooks",
     "auth",
     "authentication",
     "session",
-    "protected-route"
+    "protected-route",
+    "login",
+    "useAuth",
+    "typescript",
+    "nextjs"
   ],
   "publishConfig": {
     "access": "public"