@drmhse/authos-react 0.1.1 → 0.1.3

package/README.md

@@ -157,6 +157,13 @@ function Profile() {
 }
 ```
 
+**Returns:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `client` | `SsoClient` | The AuthOS SDK client |
+| `isLoading` | `boolean` | True while checking auth state |
+| `isAuthenticated` | `boolean` | True if user is logged in |
+
 ### useUser
 
 Get the current user's profile.
@@ -172,6 +179,12 @@ function UserProfile() {
 }
 ```
 
+**Returns:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `user` | `UserProfile \| null` | Current user profile |
+| `isLoading` | `boolean` | True while checking auth state |
+
 ### useOrganization
 
 Get the current organization and list of organizations.
@@ -195,6 +208,14 @@ function OrgInfo() {
 }
 ```
 
+**Returns:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `currentOrganization` | `Organization \| null` | Current organization |
+| `organizations` | `Organization[]` | All user's organizations |
+| `switchOrganization` | `(slug: string) => Promise<void>` | Switch to a different org |
+| `isSwitching` | `boolean` | True while switching |
+
 ### usePermission, useAnyPermission, useAllPermissions
 
 Check user permissions.
@@ -243,7 +264,7 @@ export default async function Dashboard() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `config.baseURL` | `string` | **required** | AuthOS API URL |
+| `config.baseURL` | `string` | **required** | AuthOS API URL (e.g., `https://sso.example.com`) |
 | `config.storage` | `TokenStorage` | `localStorage` | Custom token storage |
 | `config.autoRefresh` | `boolean` | `true` | Auto-refresh expired tokens |
 | `config.onAuthStateChange` | `(user) => void` | - | Callback when auth state changes |

package/dist/index.d.mts

@@ -19,6 +19,12 @@ interface AuthOSProviderProps {
      * Optional: Provide an existing SsoClient instance instead of creating a new one
      */
     client?: SsoClient;
+    /**
+     * Optional: Initial session token from server-side (for SSR hydration).
+     * When provided, skips the initial loading state on the client.
+     * Typically passed from cookies() in Next.js server components.
+     */
+    initialSessionToken?: string;
 }
 /**
  * Authentication context state
@@ -122,8 +128,28 @@ interface ProtectProps {
  *   );
  * }
  * ```
+ *
+ * @example With SSR token (Next.js App Router)
+ * ```tsx
+ * import { cookies } from 'next/headers';
+ * import { AuthOSProvider } from '@drmhse/authos-react';
+ *
+ * export default async function RootLayout({ children }) {
+ *   const cookieStore = cookies();
+ *   const token = cookieStore.get('authos_token')?.value;
+ *
+ *   return (
+ *     <AuthOSProvider
+ *       config={{ baseURL: 'https://auth.example.com' }}
+ *       initialSessionToken={token}
+ *     >
+ *       {children}
+ *     </AuthOSProvider>
+ *   );
+ * }
+ * ```
  */
-declare function AuthOSProvider({ config, children, client: externalClient }: AuthOSProviderProps): react_jsx_runtime.JSX.Element;
+declare function AuthOSProvider({ config, children, client: externalClient, initialSessionToken }: AuthOSProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access the AuthOS context.
  * Must be used within an AuthOSProvider.

package/dist/index.d.ts

@@ -19,6 +19,12 @@ interface AuthOSProviderProps {
      * Optional: Provide an existing SsoClient instance instead of creating a new one
      */
     client?: SsoClient;
+    /**
+     * Optional: Initial session token from server-side (for SSR hydration).
+     * When provided, skips the initial loading state on the client.
+     * Typically passed from cookies() in Next.js server components.
+     */
+    initialSessionToken?: string;
 }
 /**
  * Authentication context state
@@ -122,8 +128,28 @@ interface ProtectProps {
  *   );
  * }
  * ```
+ *
+ * @example With SSR token (Next.js App Router)
+ * ```tsx
+ * import { cookies } from 'next/headers';
+ * import { AuthOSProvider } from '@drmhse/authos-react';
+ *
+ * export default async function RootLayout({ children }) {
+ *   const cookieStore = cookies();
+ *   const token = cookieStore.get('authos_token')?.value;
+ *
+ *   return (
+ *     <AuthOSProvider
+ *       config={{ baseURL: 'https://auth.example.com' }}
+ *       initialSessionToken={token}
+ *     >
+ *       {children}
+ *     </AuthOSProvider>
+ *   );
+ * }
+ * ```
  */
-declare function AuthOSProvider({ config, children, client: externalClient }: AuthOSProviderProps): react_jsx_runtime.JSX.Element;
+declare function AuthOSProvider({ config, children, client: externalClient, initialSessionToken }: AuthOSProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access the AuthOS context.
  * Must be used within an AuthOSProvider.

package/dist/index.js

@@ -6,15 +6,22 @@ var jsxRuntime = require('react/jsx-runtime');
 
 // src/context.tsx
 var AuthOSContext = react.createContext(null);
-function AuthOSProvider({ config, children, client: externalClient }) {
+function AuthOSProvider({ config, children, client: externalClient, initialSessionToken }) {
   const clientRef = react.useRef(null);
   if (!clientRef.current) {
     clientRef.current = externalClient ?? new ssoSdk.SsoClient(config);
   }
   const client = clientRef.current;
+  const hasInitialToken = react.useRef(!!initialSessionToken);
+  react.useEffect(() => {
+    if (initialSessionToken && hasInitialToken.current) {
+      client.setSession({ access_token: initialSessionToken });
+      hasInitialToken.current = false;
+    }
+  }, [client, initialSessionToken]);
   const [user, setUser] = react.useState(null);
   const [organization, setOrganization] = react.useState(null);
-  const [isLoading, setIsLoading] = react.useState(true);
+  const [isLoading, setIsLoading] = react.useState(!initialSessionToken);
   const refreshUser = react.useCallback(async () => {
     try {
       const profile = await client.user.getProfile();

package/dist/index.mjs

@@ -1,19 +1,26 @@
-import { createContext, useRef, useState, useCallback, useEffect, useMemo, useContext } from 'react';
+import { createContext, useRef, useEffect, useState, useCallback, useMemo, useContext } from 'react';
 import { SsoClient, SsoApiError } from '@drmhse/sso-sdk';
 export { AuthErrorCodes, SsoApiError, SsoClient } from '@drmhse/sso-sdk';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
 // src/context.tsx
 var AuthOSContext = createContext(null);
-function AuthOSProvider({ config, children, client: externalClient }) {
+function AuthOSProvider({ config, children, client: externalClient, initialSessionToken }) {
   const clientRef = useRef(null);
   if (!clientRef.current) {
     clientRef.current = externalClient ?? new SsoClient(config);
   }
   const client = clientRef.current;
+  const hasInitialToken = useRef(!!initialSessionToken);
+  useEffect(() => {
+    if (initialSessionToken && hasInitialToken.current) {
+      client.setSession({ access_token: initialSessionToken });
+      hasInitialToken.current = false;
+    }
+  }, [client, initialSessionToken]);
   const [user, setUser] = useState(null);
   const [organization, setOrganization] = useState(null);
-  const [isLoading, setIsLoading] = useState(true);
+  const [isLoading, setIsLoading] = useState(!initialSessionToken);
   const refreshUser = useCallback(async () => {
     try {
       const profile = await client.user.getProfile();

package/dist/nextjs.d.mts

@@ -1,4 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
+import { SsoClient } from '@drmhse/sso-sdk';
 
 interface AuthMiddlewareConfig {
     /**
@@ -143,4 +144,86 @@ declare function auth(): Promise<AuthState>;
  */
 declare function getToken(cookieName?: string): Promise<string | null>;
 
-export { type AuthMiddlewareConfig, type AuthState, type AuthUser, auth, authMiddleware, currentUser, getToken };
+/**
+ * Configuration for creating an AuthOS client optimized for Next.js
+ */
+interface CreateAuthOSClientOptions {
+    /**
+     * Base URL of the SSO API service
+     */
+    baseURL: string;
+    /**
+     * Cookie name for storing the access token
+     * @default 'authos_token'
+     */
+    tokenCookie?: string;
+    /**
+     * Cookie domain (optional)
+     * Use this for subdomain-wide auth
+     */
+    domain?: string;
+    /**
+     * Cookie path
+     * @default '/'
+     */
+    path?: string;
+    /**
+     * SameSite cookie attribute
+     * @default 'lax'
+     */
+    sameSite?: 'strict' | 'lax' | 'none';
+}
+/**
+ * Create an SSO client optimized for Next.js with cookie storage.
+ *
+ * This client uses cookies instead of localStorage, which enables:
+ * - Server-side middleware auth checks
+ * - SSR hydration without loading flash
+ * - Shared auth state across tabs
+ *
+ * @example
+ * ```tsx
+ * // lib/authos.ts
+ * import { createAuthOSClient } from '@drmhse/authos-react/nextjs';
+ *
+ * export const authos = createAuthOSClient({
+ *   baseURL: process.env.NEXT_PUBLIC_AUTHOS_URL!,
+ * });
+ * ```
+ *
+ * @example With custom cookie settings
+ * ```tsx
+ * import { createAuthOSClient } from '@drmhse/authos-react/nextjs';
+ *
+ * export const authos = createAuthOSClient({
+ *   baseURL: 'https://auth.example.com',
+ *   tokenCookie: 'my_app_token',
+ *   domain: '.example.com', // Share across subdomains
+ * });
+ * ```
+ */
+declare function createAuthOSClient(options: CreateAuthOSClientOptions): SsoClient;
+/**
+ * Create an SSO client for use with SSR token fetching.
+ * Use this in server components where you need to make API calls
+ * with a token from cookies.
+ *
+ * @example
+ * ```tsx
+ * // app/dashboard/page.tsx
+ * import { createServerClient } from '@drmhse/authos-react/nextjs';
+ * import { getToken } from '@drmhse/authos-react/nextjs';
+ *
+ * export default async function DashboardPage() {
+ *   const token = await getToken();
+ *   const client = createServerClient(token);
+ *
+ *   const user = token ? await client.user.getProfile() : null;
+ *
+ *   return <div>Welcome, {user?.email}!</div>;
+ * }
+ * ```
+ */
+declare function createServerClient(token: string, baseURL: string): SsoClient;
+
+export { type AuthMiddlewareConfig, type AuthState, type AuthUser, type CreateAuthOSClientOptions, auth, authMiddleware, createAuthOSClient, createServerClient, currentUser, getToken };

package/dist/nextjs.d.ts

@@ -1,4 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
+import { SsoClient } from '@drmhse/sso-sdk';
 
 interface AuthMiddlewareConfig {
     /**
@@ -143,4 +144,86 @@ declare function auth(): Promise<AuthState>;
  */
 declare function getToken(cookieName?: string): Promise<string | null>;
 
-export { type AuthMiddlewareConfig, type AuthState, type AuthUser, auth, authMiddleware, currentUser, getToken };
+/**
+ * Configuration for creating an AuthOS client optimized for Next.js
+ */
+interface CreateAuthOSClientOptions {
+    /**
+     * Base URL of the SSO API service
+     */
+    baseURL: string;
+    /**
+     * Cookie name for storing the access token
+     * @default 'authos_token'
+     */
+    tokenCookie?: string;
+    /**
+     * Cookie domain (optional)
+     * Use this for subdomain-wide auth
+     */
+    domain?: string;
+    /**
+     * Cookie path
+     * @default '/'
+     */
+    path?: string;
+    /**
+     * SameSite cookie attribute
+     * @default 'lax'
+     */
+    sameSite?: 'strict' | 'lax' | 'none';
+}
+/**
+ * Create an SSO client optimized for Next.js with cookie storage.
+ *
+ * This client uses cookies instead of localStorage, which enables:
+ * - Server-side middleware auth checks
+ * - SSR hydration without loading flash
+ * - Shared auth state across tabs
+ *
+ * @example
+ * ```tsx
+ * // lib/authos.ts
+ * import { createAuthOSClient } from '@drmhse/authos-react/nextjs';
+ *
+ * export const authos = createAuthOSClient({
+ *   baseURL: process.env.NEXT_PUBLIC_AUTHOS_URL!,
+ * });
+ * ```
+ *
+ * @example With custom cookie settings
+ * ```tsx
+ * import { createAuthOSClient } from '@drmhse/authos-react/nextjs';
+ *
+ * export const authos = createAuthOSClient({
+ *   baseURL: 'https://auth.example.com',
+ *   tokenCookie: 'my_app_token',
+ *   domain: '.example.com', // Share across subdomains
+ * });
+ * ```
+ */
+declare function createAuthOSClient(options: CreateAuthOSClientOptions): SsoClient;
+/**
+ * Create an SSO client for use with SSR token fetching.
+ * Use this in server components where you need to make API calls
+ * with a token from cookies.
+ *
+ * @example
+ * ```tsx
+ * // app/dashboard/page.tsx
+ * import { createServerClient } from '@drmhse/authos-react/nextjs';
+ * import { getToken } from '@drmhse/authos-react/nextjs';
+ *
+ * export default async function DashboardPage() {
+ *   const token = await getToken();
+ *   const client = createServerClient(token);
+ *
+ *   const user = token ? await client.user.getProfile() : null;
+ *
+ *   return <div>Welcome, {user?.email}!</div>;
+ * }
+ * ```
+ */
+declare function createServerClient(token: string, baseURL: string): SsoClient;
+
+export { type AuthMiddlewareConfig, type AuthState, type AuthUser, type CreateAuthOSClientOptions, auth, authMiddleware, createAuthOSClient, createServerClient, currentUser, getToken };

package/dist/nextjs.js

@@ -1,5 +1,7 @@
 'use strict';
 
+var ssoSdk = require('@drmhse/sso-sdk');
+
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -5871,8 +5873,39 @@ async function getToken(cookieName = "authos_token") {
   const cookieStore = await (0, import_headers.cookies)();
   return cookieStore.get(cookieName)?.value ?? null;
 }
+function createAuthOSClient(options) {
+  const {
+    baseURL,
+    tokenCookie = "authos_token",
+    domain,
+    path = "/",
+    sameSite = "lax"
+  } = options;
+  return new ssoSdk.SsoClient({
+    baseURL,
+    storage: new ssoSdk.CookieStorage({
+      domain,
+      path,
+      secure: true,
+      // Always use secure cookies for auth
+      sameSite,
+      // 30 days default max age
+      maxAge: 30 * 24 * 60 * 60
+    }),
+    storagePrefix: tokenCookie
+  });
+}
+function createServerClient(token, baseURL) {
+  return new ssoSdk.SsoClient({
+    baseURL,
+    token
+    // Initial token for server-side use
+  });
+}
 
 exports.auth = auth;
 exports.authMiddleware = authMiddleware;
+exports.createAuthOSClient = createAuthOSClient;
+exports.createServerClient = createServerClient;
 exports.currentUser = currentUser;
 exports.getToken = getToken;

package/dist/nextjs.mjs

@@ -1,3 +1,5 @@
+import { SsoClient, CookieStorage } from '@drmhse/sso-sdk';
+
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -5869,5 +5871,34 @@ async function getToken(cookieName = "authos_token") {
   const cookieStore = await (0, import_headers.cookies)();
   return cookieStore.get(cookieName)?.value ?? null;
 }
+function createAuthOSClient(options) {
+  const {
+    baseURL,
+    tokenCookie = "authos_token",
+    domain,
+    path = "/",
+    sameSite = "lax"
+  } = options;
+  return new SsoClient({
+    baseURL,
+    storage: new CookieStorage({
+      domain,
+      path,
+      secure: true,
+      // Always use secure cookies for auth
+      sameSite,
+      // 30 days default max age
+      maxAge: 30 * 24 * 60 * 60
+    }),
+    storagePrefix: tokenCookie
+  });
+}
+function createServerClient(token, baseURL) {
+  return new SsoClient({
+    baseURL,
+    token
+    // Initial token for server-side use
+  });
+}
 
-export { auth, authMiddleware, currentUser, getToken };
+export { auth, authMiddleware, createAuthOSClient, createServerClient, currentUser, getToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drmhse/authos-react",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "React and Next.js adapter for AuthOS authentication",
   "main": "dist/index.js",
   "module": "dist/index.mjs",