@startsimpli/auth 0.1.0 → 0.1.3

package/dist/client/index.d.ts

@@ -0,0 +1,175 @@
+import { AuthConfig, Session, AuthUser as AuthUser$1, AuthState, CompanyRole } from '../types/index.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Client-side authentication manager
+ * Handles JWT tokens, login/logout, and token refresh
+ */
+
+declare class AuthClient {
+    private config;
+    private session;
+    private refreshTimer;
+    private isRefreshing;
+    private refreshPromise;
+    constructor(config: AuthConfig);
+    /**
+     * Login with email and password
+     */
+    login(email: string, password: string): Promise<Session>;
+    /**
+     * Logout and clear session
+     */
+    logout(): Promise<void>;
+    /**
+     * Refresh access token using refresh token cookie
+     */
+    refreshToken(): Promise<string>;
+    private performTokenRefresh;
+    /**
+     * Get current user data from backend
+     */
+    getCurrentUser(): Promise<AuthUser$1>;
+    /**
+     * Get current session
+     */
+    getSession(): Session | null;
+    /**
+     * Set session (for SSR/hydration)
+     */
+    setSession(session: Session): void;
+    /**
+     * Get auth headers for API requests
+     */
+    getAuthHeaders(): Record<string, string>;
+    /**
+     * Get valid access token (refreshes if needed)
+     */
+    getAccessToken(): Promise<string | null>;
+    /**
+     * Start automatic token refresh timer
+     */
+    private startRefreshTimer;
+    /**
+     * Clear session and stop refresh timer
+     */
+    private clearSession;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+
+interface AuthContextValue extends AuthState {
+    login: (email: string, password: string) => Promise<void>;
+    logout: () => Promise<void>;
+    refreshUser: () => Promise<void>;
+    getAccessToken: () => Promise<string | null>;
+}
+interface AuthProviderProps {
+    children: ReactNode;
+    config: AuthConfig;
+    initialSession?: Session | null;
+}
+declare function AuthProvider({ children, config, initialSession, }: AuthProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access auth context
+ */
+declare function useAuthContext(): AuthContextValue;
+
+/**
+ * React hook for authentication
+ */
+
+interface UseAuthReturn {
+    user: AuthUser$1 | null;
+    session: Session | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    login: (email: string, password: string) => Promise<void>;
+    logout: () => Promise<void>;
+    refreshUser: () => Promise<void>;
+    getAccessToken: () => Promise<string | null>;
+}
+/**
+ * Hook to access authentication state and methods
+ */
+declare function useAuth(): UseAuthReturn;
+
+/**
+ * React hook for permission checks
+ */
+
+interface UsePermissionsReturn {
+    hasRole: (requiredRole: CompanyRole, companyId?: string) => boolean;
+    isOwner: (companyId?: string) => boolean;
+    isAdmin: (companyId?: string) => boolean;
+    canEdit: (companyId?: string) => boolean;
+    canView: (companyId?: string) => boolean;
+    currentRole: CompanyRole | null;
+    currentCompanyId: string | null;
+}
+/**
+ * Hook to check user permissions
+ */
+declare function usePermissions(): UsePermissionsReturn;
+
+/**
+ * Functional auth API for Django backend
+ *
+ * Stateless functions for authentication flows: sign in, register, OAuth, token refresh, etc.
+ * Uses fetch (browser/Node) and getCsrfToken from shared utils.
+ * No Next.js dependency.
+ */
+interface AuthUser {
+    id: string;
+    email: string;
+    name?: string | null;
+    firstName?: string | null;
+    lastName?: string | null;
+    groups?: string[];
+    permissions?: string[];
+    isActive?: boolean;
+    isEmailVerified?: boolean;
+}
+declare function resolveAuthUrl(path: string): string;
+declare function getAccessToken(): string | null;
+declare function setAccessToken(token: string | null): void;
+declare function signInWithCredentials(email: string, password: string): Promise<{
+    access?: string;
+    user?: AuthUser;
+}>;
+declare function registerAccount(payload: {
+    email: string;
+    password: string;
+    passwordConfirm: string;
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+}): Promise<{
+    access?: string;
+    user?: AuthUser;
+}>;
+declare function requestPasswordReset(email: string): Promise<void>;
+declare function resetPassword(payload: {
+    token: string;
+    password: string;
+    passwordConfirm: string;
+    email?: string;
+}): Promise<void>;
+declare function verifyEmail(token: string): Promise<void>;
+declare function resendVerification(access?: string | null): Promise<void>;
+declare function initiateGoogleOAuth(redirectUri: string): Promise<any>;
+declare function completeGoogleOAuth(code: string, state: string): Promise<{
+    access?: string;
+    user?: AuthUser;
+}>;
+declare function refreshAccessToken(): Promise<string | null>;
+declare function getMe(): Promise<AuthUser | null>;
+declare function signOut(): Promise<void>;
+declare function authFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+declare function hasPermission(user: AuthUser | null | undefined, permission: string): boolean;
+declare function hasGroup(user: AuthUser | null | undefined, group: string): boolean;
+
+export { AuthClient, AuthProvider, type AuthUser, type UseAuthReturn, type UsePermissionsReturn, authFetch, completeGoogleOAuth, getAccessToken, getMe, hasGroup, hasPermission, initiateGoogleOAuth, refreshAccessToken, registerAccount, requestPasswordReset, resendVerification, resetPassword, resolveAuthUrl, setAccessToken, signInWithCredentials, signOut, useAuth, useAuthContext, usePermissions, verifyEmail };