@marcwelti/mw-core 0.3.1 → 0.4.0

package/dist/context/index.d.mts

@@ -1,27 +1,22 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { User, UserCredential } from 'firebase/auth';
-import { UserRole } from '../types/index.mjs';
+import { ExtendedUser, UserRole, Subscription } from '../types/index.mjs';
 import 'firebase/firestore';
 
 /**
  * User data from Firestore (includes role and additional profile data)
  */
-interface UserData {
+interface UserData extends ExtendedUser {
     id: string;
-    uid: string;
-    email: string | null;
-    displayName: string | null;
-    photoURL: string | null;
-    role: UserRole | null;
-    phoneNumber?: string | null;
-    isActive?: boolean;
 }
 interface AuthContextValue {
     /** The current authenticated Firebase user, or null if not authenticated */
     user: User | null;
-    /** User data from Firestore (includes role) */
+    /** Extended user data from Firestore (includes role, KYC, phone, etc.) */
     userData: UserData | null;
+    /** Raw Firebase user object */
+    firebaseUser: User | null;
     /** The user's role from Firestore */
     role: UserRole | null;
     /** Whether the auth state is still loading */
@@ -36,7 +31,11 @@ interface AuthContextValue {
     isStaff: boolean;
     /** Whether the user is the owner */
     isOwner: boolean;
-    /** Any auth error that occurred */
+    /** User subscription data */
+    subscription: Subscription | null;
+    /** Any auth error that occurred (e.g., "SIGNUP_DISABLED") */
+    authError: string | null;
+    /** Any general error that occurred */
     error: Error | null;
     /** Sign in with email and password */
     signIn: (email: string, password: string) => Promise<UserCredential>;
@@ -45,18 +44,40 @@ interface AuthContextValue {
     /** Sign out the current user */
     signOut: () => Promise<void>;
     /** Sign in with Google */
-    signInWithGoogle: () => Promise<UserCredential>;
+    signInWithGoogle: () => Promise<UserCredential | void>;
     /** Send a password reset email */
     resetPassword: (email: string) => Promise<void>;
-    /** Update the user's profile */
+    /** Update the user's profile (displayName, photoURL) */
     updateProfile: (profile: {
         displayName?: string;
         photoURL?: string;
     }) => Promise<void>;
     /** Send email verification */
     sendEmailVerification: () => Promise<void>;
+    /** Update user password (requires current password) */
+    updateUserPassword: (currentPassword: string, newPassword: string) => Promise<void>;
+    /** Update user email (requires current password) */
+    updateUserEmail: (newEmail: string, currentPassword: string) => Promise<void>;
+    /** Update user phone number */
+    updateUserPhone: (phoneNumber: string, phoneVerified: boolean) => Promise<void>;
+    /** Update user Amicus ID */
+    updateUserAmicusId: (amicusId: string) => Promise<void>;
+    /** Update user profile data (address, plz, city) */
+    updateUserProfile: (data: {
+        address?: string;
+        plz?: string;
+        city?: string;
+    }) => Promise<void>;
+    /** Update another user's role (admin only) */
+    updateUserRole: (targetUserId: string, newRole: UserRole) => Promise<void>;
+    /** Delete the user's account */
+    deleteAccount: (currentPassword?: string) => Promise<boolean>;
+    /** Refresh user data from Firebase and Firestore */
+    refreshUser: () => Promise<void>;
     /** Clear any auth errors */
     clearError: () => void;
+    /** Clear auth error */
+    clearAuthError: () => void;
     /** Refresh user data from Firestore */
     refreshUserData: () => void;
 }
@@ -70,56 +91,36 @@ interface AuthProviderProps {
     loadingComponent?: ReactNode;
     /** Optional: Collection path for user documents (default: 'users') */
     usersCollection?: string;
+    /** Enable cross-domain session cookies (default: false) */
+    enableSessionCookies?: boolean;
+    /** Session login endpoint (default: '/api/auth/login') */
+    sessionLoginEndpoint?: string;
+    /** Session logout endpoint (default: '/api/auth/logout') */
+    sessionLogoutEndpoint?: string;
+    /** Enable signup blocking when NEXT_PUBLIC_SIGNUP_DISABLED=true (default: false) */
+    enableSignupBlocking?: boolean;
+    /** Check email endpoint for email change (default: '/api/user/check-email') */
+    checkEmailEndpoint?: string;
+    /** Delete account endpoint (default: '/api/user/delete-account') */
+    deleteAccountEndpoint?: string;
+    /** Public pages that allow state updates on logout (default: ['/', '/login']) */
+    publicPagesForLogout?: string[];
+    /** Auto-create user document if it doesn't exist (default: true) */
+    autoCreateUserDocument?: boolean;
 }
 /**
  * Auth Provider component that wraps your app and provides auth context
  * Automatically fetches user data from Firestore including role
- *
- * @example
- * ```tsx
- * // app/layout.tsx
- * import { AuthProvider } from '@marcwelti/mw-core';
- *
- * export default function RootLayout({ children }) {
- *   return (
- *     <html>
- *       <body>
- *         <AuthProvider>
- *           {children}
- *         </AuthProvider>
- *       </body>
- *     </html>
- *   );
- * }
- * ```
+ * Supports user document creation, session cookies, and signup blocking
  */
-declare function AuthProvider({ children, onAuthStateChange, onUserDataChange, loadingComponent, usersCollection, }: AuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function AuthProvider({ children, onAuthStateChange, onUserDataChange, loadingComponent, usersCollection, enableSessionCookies, sessionLoginEndpoint, sessionLogoutEndpoint, enableSignupBlocking, checkEmailEndpoint, deleteAccountEndpoint, publicPagesForLogout, autoCreateUserDocument, }: AuthProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access auth context
  * Must be used within an AuthProvider
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const { user, signOut, isAuthenticated } = useAuthContext();
- *
- *   if (!isAuthenticated) {
- *     return <LoginForm />;
- *   }
- *
- *   return (
- *     <div>
- *       <p>Welcome, {user?.displayName}</p>
- *       <button onClick={signOut}>Sign Out</button>
- *     </div>
- *   );
- * }
- * ```
  */
 declare function useAuthContext(): AuthContextValue;
 /**
  * HOC for protecting routes that require authentication
- * Redirects to login or shows loading state
  */
 declare function withAuth<P extends object>(WrappedComponent: React.ComponentType<P>, options?: {
     LoadingComponent?: React.ComponentType;

package/dist/context/index.d.ts

@@ -1,27 +1,22 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { User, UserCredential } from 'firebase/auth';
-import { UserRole } from '../types/index.js';
+import { ExtendedUser, UserRole, Subscription } from '../types/index.js';
 import 'firebase/firestore';
 
 /**
  * User data from Firestore (includes role and additional profile data)
  */
-interface UserData {
+interface UserData extends ExtendedUser {
     id: string;
-    uid: string;
-    email: string | null;
-    displayName: string | null;
-    photoURL: string | null;
-    role: UserRole | null;
-    phoneNumber?: string | null;
-    isActive?: boolean;
 }
 interface AuthContextValue {
     /** The current authenticated Firebase user, or null if not authenticated */
     user: User | null;
-    /** User data from Firestore (includes role) */
+    /** Extended user data from Firestore (includes role, KYC, phone, etc.) */
     userData: UserData | null;
+    /** Raw Firebase user object */
+    firebaseUser: User | null;
     /** The user's role from Firestore */
     role: UserRole | null;
     /** Whether the auth state is still loading */
@@ -36,7 +31,11 @@ interface AuthContextValue {
     isStaff: boolean;
     /** Whether the user is the owner */
     isOwner: boolean;
-    /** Any auth error that occurred */
+    /** User subscription data */
+    subscription: Subscription | null;
+    /** Any auth error that occurred (e.g., "SIGNUP_DISABLED") */
+    authError: string | null;
+    /** Any general error that occurred */
     error: Error | null;
     /** Sign in with email and password */
     signIn: (email: string, password: string) => Promise<UserCredential>;
@@ -45,18 +44,40 @@ interface AuthContextValue {
     /** Sign out the current user */
     signOut: () => Promise<void>;
     /** Sign in with Google */
-    signInWithGoogle: () => Promise<UserCredential>;
+    signInWithGoogle: () => Promise<UserCredential | void>;
     /** Send a password reset email */
     resetPassword: (email: string) => Promise<void>;
-    /** Update the user's profile */
+    /** Update the user's profile (displayName, photoURL) */
     updateProfile: (profile: {
         displayName?: string;
         photoURL?: string;
     }) => Promise<void>;
     /** Send email verification */
     sendEmailVerification: () => Promise<void>;
+    /** Update user password (requires current password) */
+    updateUserPassword: (currentPassword: string, newPassword: string) => Promise<void>;
+    /** Update user email (requires current password) */
+    updateUserEmail: (newEmail: string, currentPassword: string) => Promise<void>;
+    /** Update user phone number */
+    updateUserPhone: (phoneNumber: string, phoneVerified: boolean) => Promise<void>;
+    /** Update user Amicus ID */
+    updateUserAmicusId: (amicusId: string) => Promise<void>;
+    /** Update user profile data (address, plz, city) */
+    updateUserProfile: (data: {
+        address?: string;
+        plz?: string;
+        city?: string;
+    }) => Promise<void>;
+    /** Update another user's role (admin only) */
+    updateUserRole: (targetUserId: string, newRole: UserRole) => Promise<void>;
+    /** Delete the user's account */
+    deleteAccount: (currentPassword?: string) => Promise<boolean>;
+    /** Refresh user data from Firebase and Firestore */
+    refreshUser: () => Promise<void>;
     /** Clear any auth errors */
     clearError: () => void;
+    /** Clear auth error */
+    clearAuthError: () => void;
     /** Refresh user data from Firestore */
     refreshUserData: () => void;
 }
@@ -70,56 +91,36 @@ interface AuthProviderProps {
     loadingComponent?: ReactNode;
     /** Optional: Collection path for user documents (default: 'users') */
     usersCollection?: string;
+    /** Enable cross-domain session cookies (default: false) */
+    enableSessionCookies?: boolean;
+    /** Session login endpoint (default: '/api/auth/login') */
+    sessionLoginEndpoint?: string;
+    /** Session logout endpoint (default: '/api/auth/logout') */
+    sessionLogoutEndpoint?: string;
+    /** Enable signup blocking when NEXT_PUBLIC_SIGNUP_DISABLED=true (default: false) */
+    enableSignupBlocking?: boolean;
+    /** Check email endpoint for email change (default: '/api/user/check-email') */
+    checkEmailEndpoint?: string;
+    /** Delete account endpoint (default: '/api/user/delete-account') */
+    deleteAccountEndpoint?: string;
+    /** Public pages that allow state updates on logout (default: ['/', '/login']) */
+    publicPagesForLogout?: string[];
+    /** Auto-create user document if it doesn't exist (default: true) */
+    autoCreateUserDocument?: boolean;
 }
 /**
  * Auth Provider component that wraps your app and provides auth context
  * Automatically fetches user data from Firestore including role
- *
- * @example
- * ```tsx
- * // app/layout.tsx
- * import { AuthProvider } from '@marcwelti/mw-core';
- *
- * export default function RootLayout({ children }) {
- *   return (
- *     <html>
- *       <body>
- *         <AuthProvider>
- *           {children}
- *         </AuthProvider>
- *       </body>
- *     </html>
- *   );
- * }
- * ```
+ * Supports user document creation, session cookies, and signup blocking
  */
-declare function AuthProvider({ children, onAuthStateChange, onUserDataChange, loadingComponent, usersCollection, }: AuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function AuthProvider({ children, onAuthStateChange, onUserDataChange, loadingComponent, usersCollection, enableSessionCookies, sessionLoginEndpoint, sessionLogoutEndpoint, enableSignupBlocking, checkEmailEndpoint, deleteAccountEndpoint, publicPagesForLogout, autoCreateUserDocument, }: AuthProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access auth context
  * Must be used within an AuthProvider
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const { user, signOut, isAuthenticated } = useAuthContext();
- *
- *   if (!isAuthenticated) {
- *     return <LoginForm />;
- *   }
- *
- *   return (
- *     <div>
- *       <p>Welcome, {user?.displayName}</p>
- *       <button onClick={signOut}>Sign Out</button>
- *     </div>
- *   );
- * }
- * ```
  */
 declare function useAuthContext(): AuthContextValue;
 /**
  * HOC for protecting routes that require authentication
- * Redirects to login or shows loading state
  */
 declare function withAuth<P extends object>(WrappedComponent: React.ComponentType<P>, options?: {
     LoadingComponent?: React.ComponentType;