@thetechfossil/auth2 1.2.5 → 1.2.7

package/README.md

@@ -13,6 +13,18 @@ A lightweight, easy-to-use authentication SDK for integrating with the Auth back
 - Supports custom frontend base URLs for email verification links
 - **Embedded styling** - No separate CSS imports required!
 
+## Documentation
+
+📚 **Complete documentation is available at:** [https://ttf-auth-docs.netlify.app/](https://ttf-auth-docs.netlify.app/)
+
+The documentation includes:
+- Getting started guides
+- API reference
+- Component documentation
+- Architecture overview
+- Environment configuration
+- Integration examples for React, Next.js, and Node.js
+
 ## Installation
 
 ```bash

package/dist/index.components.d.ts

@@ -24,6 +24,15 @@ interface AuthConfig {
     localStorageKey?: string;
     token?: string;
     csrfEnabled?: boolean;
+    upfilesConfig?: UpfilesConfig;
+}
+interface UpfilesConfig {
+    baseUrl: string;
+    apiKey?: string;
+    apiKeyHeader?: 'authorization' | 'x-api-key' | 'x-up-api-key';
+    presignUrl?: string;
+    presignPath?: string;
+    folderPath?: string;
 }
 
 interface RegisterFormProps {
@@ -182,4 +191,46 @@ interface PhoneInputProps {
 }
 declare const PhoneInput: React.FC<PhoneInputProps>;
 
-export { AuthFlow, ChangePassword, EmailVerificationPage, ForgotPassword, LoginForm, OtpForm, PhoneInput, ProtectedRoute, PublicRoute, RegisterForm, RegisterFormProps, ResetPassword, SignIn, SignOut, SignUp, UserButton, UserProfile, VerifyEmail };
+interface AvatarUploaderProps {
+    onUploadComplete?: (avatarUrl: string) => void;
+    onError?: (error: Error) => void;
+    className?: string;
+    buttonClassName?: string;
+    dropzoneClassName?: string;
+    maxFileSize?: number;
+    accept?: string[];
+    upfilesConfig: {
+        baseUrl: string;
+        apiKey?: string;
+        apiKeyHeader?: 'authorization' | 'x-api-key' | 'x-up-api-key';
+        presignUrl?: string;
+        presignPath?: string;
+        folderPath?: string;
+    };
+}
+declare const AvatarUploader: React.FC<AvatarUploaderProps>;
+
+interface AvatarManagerProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onAvatarUpdated?: (avatarUrl: string) => void;
+    onError?: (error: Error) => void;
+    title?: string;
+    description?: string;
+    className?: string;
+    gridClassName?: string;
+    maxFileSize?: number;
+    mode?: 'full' | 'browse' | 'upload';
+    showDelete?: boolean;
+    upfilesConfig: {
+        baseUrl: string;
+        apiKey?: string;
+        apiKeyHeader?: 'authorization' | 'x-api-key' | 'x-up-api-key';
+        presignUrl?: string;
+        presignPath?: string;
+        folderPath?: string;
+    };
+}
+declare const AvatarManager: React.FC<AvatarManagerProps>;
+
+export { AuthFlow, AvatarManager, AvatarManagerProps, AvatarUploader, AvatarUploaderProps, ChangePassword, EmailVerificationPage, ForgotPassword, LoginForm, OtpForm, PhoneInput, ProtectedRoute, PublicRoute, RegisterForm, RegisterFormProps, ResetPassword, SignIn, SignOut, SignUp, UserButton, UserProfile, VerifyEmail };

package/dist/index.components.js

@@ -3,6 +3,7 @@
 
 var React2 = require('react');
 var axios = require('axios');
+var upfiles = require('@thetechfossil/upfiles');
 var jsxRuntime = require('react/jsx-runtime');
 var PhoneInputWithCountry = require('react-phone-number-input');
 require('react-phone-number-input/style.css');
@@ -119,11 +120,10 @@ var HttpClient = class {
     }
   }
 };
-
-// src/core/auth-service.ts
 var AuthService = class {
   constructor(config) {
     this.token = null;
+    this.upfilesClient = null;
     this.config = {
       localStorageKey: "auth_token",
       csrfEnabled: true,
@@ -131,6 +131,15 @@ var AuthService = class {
     };
     this.httpClient = new HttpClient(this.config.baseUrl);
     this.loadTokenFromStorage();
+    if (this.config.upfilesConfig) {
+      this.upfilesClient = new upfiles.UpfilesClient({
+        baseUrl: this.config.upfilesConfig.baseUrl,
+        apiKey: this.config.upfilesConfig.apiKey,
+        apiKeyHeader: this.config.upfilesConfig.apiKeyHeader,
+        presignUrl: this.config.upfilesConfig.presignUrl,
+        presignPath: this.config.upfilesConfig.presignPath
+      });
+    }
     if (typeof window !== "undefined") {
       const frontendBaseUrl = process.env.NEXT_PUBLIC_FRONTEND_BASE_URL || process.env.REACT_APP_FRONTEND_BASE_URL || process.env.NEXT_PUBLIC_APP_URL || window.location.origin;
       if (frontendBaseUrl) {
@@ -358,6 +367,28 @@ var AuthService = class {
     }
     return response;
   }
+  async uploadAndUpdateAvatar(file) {
+    if (!this.token) {
+      throw new Error("Not authenticated");
+    }
+    if (!this.upfilesClient) {
+      throw new Error("Upfiles configuration is required. Please provide upfilesConfig in AuthConfig.");
+    }
+    try {
+      const folderPath = this.config.upfilesConfig?.folderPath || "avatars/";
+      const uploadResult = await this.upfilesClient.upload(file, {
+        folderPath,
+        fetchThumbnails: true
+      });
+      const response = await this.updateAvatar(uploadResult.publicUrl);
+      return response;
+    } catch (error) {
+      throw new Error(`Failed to upload avatar: ${error.message || "Unknown error"}`);
+    }
+  }
+  getUpfilesClient() {
+    return this.upfilesClient;
+  }
   async requestEmailChange(newEmail) {
     if (!this.token) {
       throw new Error("Not authenticated");
@@ -590,6 +621,18 @@ var useAuth = (config) => {
       setLoading(false);
     }
   }, [authService]);
+  const uploadAndUpdateAvatar = React2.useCallback(async (file) => {
+    setLoading(true);
+    try {
+      const response = await authService.uploadAndUpdateAvatar(file);
+      if (response.success && response.user) {
+        setUser(response.user);
+      }
+      return response;
+    } finally {
+      setLoading(false);
+    }
+  }, [authService]);
   return {
     user,
     isAuthenticated,
@@ -602,7 +645,8 @@ var useAuth = (config) => {
     updateProfile,
     getProfile,
     getAllUsers,
-    getUserById
+    getUserById,
+    uploadAndUpdateAvatar
   };
 };
 var ThemeContext = React2.createContext({ theme: "light", mounted: false });
@@ -4357,8 +4401,126 @@ var UserProfile = ({
     ] })
   ] });
 };
+var AvatarUploader = ({
+  onUploadComplete,
+  onError,
+  className,
+  buttonClassName,
+  dropzoneClassName,
+  maxFileSize = 5 * 1024 * 1024,
+  // 5MB default
+  accept = ["image/*"],
+  upfilesConfig
+}) => {
+  const { uploadAndUpdateAvatar } = useAuth2();
+  const [uploading, setUploading] = React2.useState(false);
+  const handleUploadComplete = async (files) => {
+    if (files.length === 0)
+      return;
+    setUploading(true);
+    try {
+      const file = files[0];
+      const response = await uploadAndUpdateAvatar(file.file);
+      if (response.success && response.user?.avatar) {
+        onUploadComplete?.(response.user.avatar);
+      } else {
+        throw new Error(response.message || "Failed to update avatar");
+      }
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error("Upload failed");
+      onError?.(err);
+    } finally {
+      setUploading(false);
+    }
+  };
+  const handleError = (error) => {
+    onError?.(error);
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className, children: /* @__PURE__ */ jsxRuntime.jsx(
+    upfiles.Uploader,
+    {
+      clientOptions: {
+        baseUrl: upfilesConfig.baseUrl,
+        apiKey: upfilesConfig.apiKey,
+        apiKeyHeader: upfilesConfig.apiKeyHeader || "authorization",
+        presignUrl: upfilesConfig.presignUrl,
+        presignPath: upfilesConfig.presignPath
+      },
+      multiple: false,
+      accept,
+      maxFileSize,
+      maxFiles: 1,
+      onComplete: handleUploadComplete,
+      onError: handleError,
+      buttonClassName,
+      dropzoneClassName,
+      children: uploading ? "Uploading..." : "Upload Avatar"
+    }
+  ) });
+};
+var AvatarManager = ({
+  open,
+  onOpenChange,
+  onAvatarUpdated,
+  onError,
+  title = "Select Avatar",
+  description = "Choose an existing image or upload a new one",
+  className,
+  gridClassName,
+  maxFileSize = 5 * 1024 * 1024,
+  // 5MB default
+  mode = "full",
+  showDelete = false,
+  upfilesConfig
+}) => {
+  const { updateProfile } = useAuth2();
+  const [updating, setUpdating] = React2.useState(false);
+  const handleSelect = async (image) => {
+    setUpdating(true);
+    try {
+      const response = await updateProfile({ avatar: image.url });
+      if (response.success && response.user?.avatar) {
+        onAvatarUpdated?.(response.user.avatar);
+        onOpenChange(false);
+      } else {
+        throw new Error(response.message || "Failed to update avatar");
+      }
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error("Failed to update avatar");
+      onError?.(err);
+    } finally {
+      setUpdating(false);
+    }
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    upfiles.ImageManager,
+    {
+      open,
+      onOpenChange,
+      clientOptions: {
+        baseUrl: upfilesConfig.baseUrl,
+        apiKey: upfilesConfig.apiKey,
+        apiKeyHeader: upfilesConfig.apiKeyHeader || "authorization",
+        presignUrl: upfilesConfig.presignUrl,
+        presignPath: upfilesConfig.presignPath
+      },
+      folderPath: upfilesConfig.folderPath || "avatars/",
+      title,
+      description,
+      className,
+      gridClassName,
+      onSelect: handleSelect,
+      maxFileSize,
+      mode,
+      showDelete,
+      fetchThumbnails: true
+    }
+  );
+};
 
 exports.AuthFlow = AuthFlow;
+exports.AvatarManager = AvatarManager;
+exports.AvatarUploader = AvatarUploader;
 exports.ChangePassword = ChangePassword;
 exports.EmailVerificationPage = EmailVerificationPage;
 exports.ForgotPassword = ForgotPassword;