@allem-sdk/auth 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Allem
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kingofmit/allem-sdk/main/.github/AllemSDK.png" alt="Allem SDK" />
+</p>
+
+<p align="center">
+  <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-18+-61dafb" alt="React 18+" />
+  <img src="https://img.shields.io/badge/typescript-strict-blue" alt="TypeScript" />
+</p>
+
+# @allem-sdk/auth
+
+Authentication helpers for React. Provider-agnostic via an adapter interface — works with any auth backend.
+
+## Installation
+
+```bash
+npm install @allem-sdk/auth
+```
+
+## Usage
+
+```tsx
+import { AuthProvider, useAuth, ProtectedRoute } from "@allem-sdk/auth";
+
+// Define an adapter for your auth provider
+const myAuthAdapter = {
+  getSession: async () => {
+    const res = await fetch("/api/auth/session");
+    if (!res.ok) return null;
+    return res.json();
+  },
+  signIn: async (credentials) => {
+    const res = await fetch("/api/auth/signin", {
+      method: "POST",
+      body: JSON.stringify(credentials),
+    });
+    return res.json();
+  },
+  signOut: async () => {
+    await fetch("/api/auth/signout", { method: "POST" });
+  },
+};
+
+function App() {
+  return (
+    <AuthProvider adapter={myAuthAdapter}>
+      <ProtectedRoute
+        fallback={<LoginPage />}
+        loadingFallback={<Spinner />}
+      >
+        <Dashboard />
+      </ProtectedRoute>
+    </AuthProvider>
+  );
+}
+
+function Dashboard() {
+  const { user, status, signOut } = useAuth();
+  return <button onClick={signOut}>Sign out, {user?.name}</button>;
+}
+```
+
+## Exports
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `AuthProvider` | Component | Context provider with automatic session management |
+| `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 |
+
+## Part of [Allem SDK](https://github.com/kingofmit/allem-sdk)
+
+This package can be used standalone or as part of the full SDK. Install `allem-sdk` to get all packages in one install.
+
+## Support
+
+If you find Allem SDK useful, consider supporting its development:
+
+<a href="https://buymeacoffee.com/kingofmit" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50" /></a>
+
+## License
+
+[MIT](https://github.com/kingofmit/allem-sdk/blob/main/LICENSE) - [Ahmed Allem](https://kingallem.com)

package/dist/index.d.mts

@@ -0,0 +1,51 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface AuthUser {
+    id: string;
+    email?: string;
+    name?: string;
+    image?: string;
+    [key: string]: unknown;
+}
+interface AuthSession {
+    user: AuthUser | null;
+    token: string | null;
+    expiresAt: number | null;
+}
+interface AuthAdapter {
+    getSession: () => Promise<AuthSession>;
+    signIn: (credentials: Record<string, string>) => Promise<AuthSession>;
+    signOut: () => Promise<void>;
+}
+type AuthStatus = "loading" | "authenticated" | "unauthenticated";
+interface AuthProviderProps {
+    adapter: AuthAdapter;
+    children: ReactNode;
+}
+declare function AuthProvider({ adapter, children }: AuthProviderProps): react_jsx_runtime.JSX.Element;
+
+interface UseAuthReturn {
+    user: AuthUser | null;
+    status: AuthStatus;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    signIn: (credentials: Record<string, string>) => Promise<void>;
+    signOut: () => Promise<void>;
+}
+declare function useAuth(): UseAuthReturn;
+
+interface UseSessionReturn {
+    session: AuthSession | null;
+    update: () => Promise<void>;
+}
+declare function useSession(): UseSessionReturn;
+
+interface ProtectedRouteProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    loadingFallback?: ReactNode;
+}
+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 };

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface AuthUser {
+    id: string;
+    email?: string;
+    name?: string;
+    image?: string;
+    [key: string]: unknown;
+}
+interface AuthSession {
+    user: AuthUser | null;
+    token: string | null;
+    expiresAt: number | null;
+}
+interface AuthAdapter {
+    getSession: () => Promise<AuthSession>;
+    signIn: (credentials: Record<string, string>) => Promise<AuthSession>;
+    signOut: () => Promise<void>;
+}
+type AuthStatus = "loading" | "authenticated" | "unauthenticated";
+interface AuthProviderProps {
+    adapter: AuthAdapter;
+    children: ReactNode;
+}
+declare function AuthProvider({ adapter, children }: AuthProviderProps): react_jsx_runtime.JSX.Element;
+
+interface UseAuthReturn {
+    user: AuthUser | null;
+    status: AuthStatus;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    signIn: (credentials: Record<string, string>) => Promise<void>;
+    signOut: () => Promise<void>;
+}
+declare function useAuth(): UseAuthReturn;
+
+interface UseSessionReturn {
+    session: AuthSession | null;
+    update: () => Promise<void>;
+}
+declare function useSession(): UseSessionReturn;
+
+interface ProtectedRouteProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    loadingFallback?: ReactNode;
+}
+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 };

package/dist/index.js

@@ -0,0 +1,120 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthProvider: () => AuthProvider,
+  ProtectedRoute: () => ProtectedRoute,
+  useAuth: () => useAuth,
+  useSession: () => useSession
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/AuthProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var AuthContext = (0, import_react.createContext)(null);
+function AuthProvider({ adapter, children }) {
+  const [session, setSession] = (0, import_react.useState)(null);
+  const [status, setStatus] = (0, import_react.useState)("loading");
+  const refresh = (0, import_react.useCallback)(async () => {
+    try {
+      const s = await adapter.getSession();
+      setSession(s);
+      setStatus(s.user ? "authenticated" : "unauthenticated");
+    } catch {
+      setSession(null);
+      setStatus("unauthenticated");
+    }
+  }, [adapter]);
+  (0, import_react.useEffect)(() => {
+    refresh();
+  }, [refresh]);
+  const signIn = (0, import_react.useCallback)(
+    async (credentials) => {
+      setStatus("loading");
+      const s = await adapter.signIn(credentials);
+      setSession(s);
+      setStatus(s.user ? "authenticated" : "unauthenticated");
+    },
+    [adapter]
+  );
+  const signOut = (0, import_react.useCallback)(async () => {
+    await adapter.signOut();
+    setSession(null);
+    setStatus("unauthenticated");
+  }, [adapter]);
+  const value = {
+    user: session?.user ?? null,
+    session,
+    status,
+    signIn,
+    signOut,
+    refresh
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AuthContext.Provider, { value, children });
+}
+function useAuthContext() {
+  const ctx = (0, import_react.useContext)(AuthContext);
+  if (!ctx) {
+    throw new Error("useAuth must be used within an <AuthProvider>");
+  }
+  return ctx;
+}
+
+// src/useAuth.ts
+function useAuth() {
+  const { user, status, signIn, signOut } = useAuthContext();
+  return {
+    user,
+    status,
+    isAuthenticated: status === "authenticated",
+    isLoading: status === "loading",
+    signIn,
+    signOut
+  };
+}
+
+// src/useSession.ts
+function useSession() {
+  const { session, refresh } = useAuthContext();
+  return { session, update: refresh };
+}
+
+// src/ProtectedRoute.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function ProtectedRoute({
+  children,
+  fallback = null,
+  loadingFallback = null
+}) {
+  const { status } = useAuthContext();
+  if (status === "loading") return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: loadingFallback });
+  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 });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthProvider,
+  ProtectedRoute,
+  useAuth,
+  useSession
+});

package/dist/index.mjs

@@ -0,0 +1,91 @@
+"use client";
+
+// src/AuthProvider.tsx
+import { createContext, useContext, useState, useCallback, useEffect } from "react";
+import { jsx } from "react/jsx-runtime";
+var AuthContext = createContext(null);
+function AuthProvider({ adapter, children }) {
+  const [session, setSession] = useState(null);
+  const [status, setStatus] = useState("loading");
+  const refresh = useCallback(async () => {
+    try {
+      const s = await adapter.getSession();
+      setSession(s);
+      setStatus(s.user ? "authenticated" : "unauthenticated");
+    } catch {
+      setSession(null);
+      setStatus("unauthenticated");
+    }
+  }, [adapter]);
+  useEffect(() => {
+    refresh();
+  }, [refresh]);
+  const signIn = useCallback(
+    async (credentials) => {
+      setStatus("loading");
+      const s = await adapter.signIn(credentials);
+      setSession(s);
+      setStatus(s.user ? "authenticated" : "unauthenticated");
+    },
+    [adapter]
+  );
+  const signOut = useCallback(async () => {
+    await adapter.signOut();
+    setSession(null);
+    setStatus("unauthenticated");
+  }, [adapter]);
+  const value = {
+    user: session?.user ?? null,
+    session,
+    status,
+    signIn,
+    signOut,
+    refresh
+  };
+  return /* @__PURE__ */ jsx(AuthContext.Provider, { value, children });
+}
+function useAuthContext() {
+  const ctx = useContext(AuthContext);
+  if (!ctx) {
+    throw new Error("useAuth must be used within an <AuthProvider>");
+  }
+  return ctx;
+}
+
+// src/useAuth.ts
+function useAuth() {
+  const { user, status, signIn, signOut } = useAuthContext();
+  return {
+    user,
+    status,
+    isAuthenticated: status === "authenticated",
+    isLoading: status === "loading",
+    signIn,
+    signOut
+  };
+}
+
+// src/useSession.ts
+function useSession() {
+  const { session, refresh } = useAuthContext();
+  return { session, update: refresh };
+}
+
+// src/ProtectedRoute.tsx
+import { Fragment, jsx as jsx2 } from "react/jsx-runtime";
+function ProtectedRoute({
+  children,
+  fallback = null,
+  loadingFallback = null
+}) {
+  const { status } = useAuthContext();
+  if (status === "loading") return /* @__PURE__ */ jsx2(Fragment, { children: loadingFallback });
+  if (status === "unauthenticated") return /* @__PURE__ */ jsx2(Fragment, { children: fallback });
+  return /* @__PURE__ */ jsx2(Fragment, { children });
+}
+export {
+  AuthProvider,
+  ProtectedRoute,
+  useAuth,
+  useSession
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@allem-sdk/auth",
+  "version": "0.1.0",
+  "description": "Authentication helpers for React — session, protected routes, social login",
+  "license": "MIT",
+  "author": "Ahmed Allem",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^25.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingofmit/allem-sdk.git",
+    "directory": "packages/auth"
+  },
+  "keywords": [
+    "allem-sdk",
+    "react",
+    "hooks",
+    "auth",
+    "authentication",
+    "session",
+    "protected-route"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}