hazo_auth 1.4.2 → 1.6.0

package/src/lib/services/user_profiles_service.ts

@@ -1,143 +0,0 @@
-// file_description: service for batch retrieval of basic user profile information for chat applications and similar use cases
-// section: imports
-import type { HazoConnectAdapter } from "hazo_connect";
-import { createCrudService } from "hazo_connect/server";
-import { differenceInDays } from "date-fns";
-import { create_app_logger } from "../app_logger";
-import { sanitize_error_for_user } from "../utils/error_sanitizer";
-
-// section: types
-/**
- * Basic user profile information returned by get_profiles
- * Contains resolved profile picture URL, email, name, and account age
- */
-export type UserProfileInfo = {
-  user_id: string;
-  profile_picture_url: string | null;
-  email: string;
-  name: string | null;
-  days_since_created: number;
-};
-
-/**
- * Result type for get_profiles function
- * Includes found profiles and list of IDs that were not found
- */
-export type GetProfilesResult = {
-  success: boolean;
-  profiles: UserProfileInfo[];
-  not_found_ids: string[];
-  error?: string;
-};
-
-// section: helpers
-/**
- * Retrieves basic profile information for multiple users in a single batch call
- * Useful for chat applications and similar use cases where basic user info is needed
- * @param adapter - The hazo_connect adapter instance
- * @param user_ids - Array of user IDs to retrieve profiles for
- * @returns GetProfilesResult with found profiles and list of not found IDs
- */
-export async function hazo_get_user_profiles(
-  adapter: HazoConnectAdapter,
-  user_ids: string[],
-): Promise<GetProfilesResult> {
-  const logger = create_app_logger();
-
-  try {
-    // Handle empty input
-    if (!user_ids || user_ids.length === 0) {
-      return {
-        success: true,
-        profiles: [],
-        not_found_ids: [],
-      };
-    }
-
-    // Remove duplicates from input
-    const unique_user_ids = [...new Set(user_ids)];
-
-    // Create CRUD service for hazo_users table
-    const users_service = createCrudService(adapter, "hazo_users");
-
-    // Query users by IDs using the 'in' filter
-    // PostgREST supports 'in' filter syntax: id=in.(id1,id2,id3)
-    const users = await users_service.findBy({
-      id: `in.(${unique_user_ids.join(",")})`,
-    });
-
-    // Handle case where no users are found
-    if (!Array.isArray(users)) {
-    logger.warn("hazo_get_user_profiles_unexpected_response", {
-      filename: "user_profiles_service.ts",
-      line_number: 70,
-      message: "Unexpected response format from database query",
-      user_ids: unique_user_ids,
-    });
-
-      return {
-        success: true,
-        profiles: [],
-        not_found_ids: unique_user_ids,
-      };
-    }
-
-    // Build set of found user IDs for quick lookup
-    const found_user_ids = new Set(users.map((user) => user.id as string));
-
-    // Determine which user IDs were not found
-    const not_found_ids = unique_user_ids.filter((id) => !found_user_ids.has(id));
-
-    // Transform database records to UserProfileInfo
-    const now = new Date();
-    const profiles: UserProfileInfo[] = users.map((user) => {
-      const created_at = user.created_at as string;
-      const created_date = new Date(created_at);
-      const days_since_created = differenceInDays(now, created_date);
-
-      return {
-        user_id: user.id as string,
-        profile_picture_url: (user.profile_picture_url as string) || null,
-        email: user.email_address as string,
-        name: (user.name as string) || null,
-        days_since_created,
-      };
-    });
-
-    // Log successful retrieval
-    logger.info("hazo_get_user_profiles_success", {
-      filename: "user_profiles_service.ts",
-      line_number: 105,
-      message: "Successfully retrieved user profiles",
-      requested_count: unique_user_ids.length,
-      found_count: profiles.length,
-      not_found_count: not_found_ids.length,
-    });
-
-    return {
-      success: true,
-      profiles,
-      not_found_ids,
-    };
-  } catch (error) {
-    const user_friendly_error = sanitize_error_for_user(error, {
-      logToConsole: true,
-      logToLogger: true,
-      logger,
-      context: {
-        filename: "user_profiles_service.ts",
-        line_number: 122,
-        operation: "hazo_get_user_profiles",
-        user_ids_count: user_ids?.length || 0,
-      },
-    });
-
-    return {
-      success: false,
-      profiles: [],
-      not_found_ids: [],
-      error: user_friendly_error,
-    };
-  }
-}
-

package/src/lib/services/user_update_service.ts

@@ -1,141 +0,0 @@
-// file_description: service for updating user profile information using hazo_connect
-// section: imports
-import type { HazoConnectAdapter } from "hazo_connect";
-import { createCrudService } from "hazo_connect/server";
-import { map_ui_source_to_db, type ProfilePictureSourceUI } from "./profile_picture_source_mapper";
-import { create_app_logger } from "../app_logger";
-import { sanitize_error_for_user } from "../utils/error_sanitizer";
-import { get_filename, get_line_number } from "../utils/api_route_helpers";
-
-// section: types
-export type UserUpdateData = {
-  name?: string;
-  email?: string;
-  profile_picture_url?: string;
-  profile_source?: ProfilePictureSourceUI;
-};
-
-export type UserUpdateResult = {
-  success: boolean;
-  email_changed?: boolean;
-  error?: string;
-};
-
-// section: helpers
-/**
- * Updates user profile information (name, email)
- * If email is changed, sets email_verified to false
- * @param adapter - The hazo_connect adapter instance
- * @param user_id - The user ID to update
- * @param data - User update data (name, email)
- * @returns User update result with success status, email_changed flag, or error
- */
-export async function update_user_profile(
-  adapter: HazoConnectAdapter,
-  user_id: string,
-  data: UserUpdateData,
-): Promise<UserUpdateResult> {
-  try {
-    const { name, email } = data;
-
-    // Create CRUD service for hazo_users table
-    const users_service = createCrudService(adapter, "hazo_users");
-
-    // Get current user data
-    const users = await users_service.findBy({
-      id: user_id,
-    });
-
-    if (!Array.isArray(users) || users.length === 0) {
-      return {
-        success: false,
-        error: "User not found",
-      };
-    }
-
-    const current_user = users[0];
-    const current_email = current_user.email_address as string;
-    const email_changed = email !== undefined && email !== current_email;
-
-    // If email is being changed, check if new email already exists
-    if (email_changed) {
-      const existing_users = await users_service.findBy({
-        email_address: email,
-      });
-
-      if (Array.isArray(existing_users) && existing_users.length > 0) {
-        // Check if it's the same user
-        const existing_user = existing_users[0];
-        if (existing_user.id !== user_id) {
-          return {
-            success: false,
-            error: "Email address already registered",
-          };
-        }
-      }
-
-      // Validate email format
-      const email_regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-      if (!email_regex.test(email)) {
-        return {
-          success: false,
-          error: "Invalid email address format",
-        };
-      }
-    }
-
-    // Prepare update data
-    const update_data: Record<string, unknown> = {
-      changed_at: new Date().toISOString(),
-    };
-
-    if (name !== undefined) {
-      update_data.name = name;
-    }
-
-    if (email !== undefined) {
-      update_data.email_address = email;
-    }
-
-    if (data.profile_picture_url !== undefined) {
-      update_data.profile_picture_url = data.profile_picture_url;
-    }
-
-    if (data.profile_source !== undefined) {
-      // Map UI source value to database enum value
-      update_data.profile_source = map_ui_source_to_db(data.profile_source);
-    }
-
-    // If email changed, set email_verified to false
-    if (email_changed) {
-      update_data.email_verified = false;
-    }
-
-    // Update user in database
-    await users_service.updateById(user_id, update_data);
-
-    return {
-      success: true,
-      email_changed,
-    };
-  } catch (error) {
-    const logger = create_app_logger();
-    const user_friendly_error = sanitize_error_for_user(error, {
-      logToConsole: true,
-      logToLogger: true,
-      logger,
-      context: {
-        filename: "user_update_service.ts",
-        line_number: get_line_number(),
-        user_id,
-        operation: "update_user_profile",
-      },
-    });
-
-    return {
-      success: false,
-      error: user_friendly_error,
-    };
-  }
-}
-

package/src/lib/ui_shell_config.server.ts

@@ -1,73 +0,0 @@
-// file_description: load ui shell layout settings from hazo_auth_config.ini
-// section: imports
-import { get_config_value } from "./config/config_loader.server";
-
-// section: types
-export type UiShellLayoutMode = "test_sidebar" | "standalone";
-
-export type UiShellConfig = {
-  layout_mode: UiShellLayoutMode;
-  standalone_heading: string;
-  standalone_description: string;
-  standalone_wrapper_class: string;
-  standalone_content_class: string;
-  standalone_show_heading: boolean;
-  standalone_show_description: boolean;
-};
-
-// section: helpers
-/**
- * Reads ui shell configuration controlling whether pages use the sidebar test shell
- * or a clean standalone wrapper that inherits consumer project styling.
- */
-export function get_ui_shell_config(): UiShellConfig {
-  const section = "hazo_auth__ui_shell";
-
-  const layoutModeValue = get_config_value(section, "layout_mode", "test_sidebar").toLowerCase();
-  const layout_mode: UiShellLayoutMode =
-    layoutModeValue === "standalone" ? "standalone" : "test_sidebar";
-
-  const standalone_heading = get_config_value(
-    section,
-    "standalone_heading",
-    "Welcome to hazo auth"
-  );
-  const standalone_description = get_config_value(
-    section,
-    "standalone_description",
-    "Reuse the packaged authentication flows while inheriting your existing app shell styles."
-  );
-  const standalone_wrapper_class = get_config_value(
-    section,
-    "standalone_wrapper_class",
-    "cls_standalone_shell flex min-h-screen w-full items-center justify-center bg-background px-4 py-10"
-  );
-  const standalone_content_class = get_config_value(
-    section,
-    "standalone_content_class",
-    "cls_standalone_shell_content w-full max-w-5xl shadow-xl rounded-2xl border bg-card"
-  );
-  const standalone_show_heading = get_config_value(
-    section,
-    "standalone_show_heading",
-    "true"
-  ).toLowerCase() === "true";
-  const standalone_show_description = get_config_value(
-    section,
-    "standalone_show_description",
-    "true"
-  ).toLowerCase() === "true";
-
-  return {
-    layout_mode,
-    standalone_heading,
-    standalone_description,
-    standalone_wrapper_class,
-    standalone_content_class,
-    standalone_show_heading,
-    standalone_show_description,
-  };
-}
-
-
-

package/src/lib/ui_sizes_config.server.ts

@@ -1,37 +0,0 @@
-// file_description: server-only helper to read UI size configuration from hazo_auth_config.ini
-// section: imports
-import { get_config_number } from "./config/config_loader.server";
-
-// section: types
-export type UISizesConfig = {
-  gravatar_size: number;
-  profile_picture_size: number;
-  tooltip_icon_size_default: number;
-  tooltip_icon_size_small: number;
-  library_photo_grid_columns: number;
-  library_photo_preview_size: number;
-  image_compression_max_dimension: number;
-  upload_file_hard_limit_bytes: number;
-};
-
-// section: helpers
-/**
- * Reads UI size configuration from hazo_auth_config.ini file
- * Falls back to defaults if hazo_auth_config.ini is not found or section is missing
- * @returns UI sizes configuration options
- */
-export function get_ui_sizes_config(): UISizesConfig {
-  const section = "hazo_auth__ui_sizes";
-
-  return {
-    gravatar_size: get_config_number(section, "gravatar_size", 200),
-    profile_picture_size: get_config_number(section, "profile_picture_size", 200),
-    tooltip_icon_size_default: get_config_number(section, "tooltip_icon_size_default", 16),
-    tooltip_icon_size_small: get_config_number(section, "tooltip_icon_size_small", 14),
-    library_photo_grid_columns: get_config_number(section, "library_photo_grid_columns", 4),
-    library_photo_preview_size: get_config_number(section, "library_photo_preview_size", 200),
-    image_compression_max_dimension: get_config_number(section, "image_compression_max_dimension", 200),
-    upload_file_hard_limit_bytes: get_config_number(section, "upload_file_hard_limit_bytes", 10485760), // 10MB
-  };
-}
-

package/src/lib/user_fields_config.server.ts

@@ -1,31 +0,0 @@
-// file_description: server-only helper to read shared user fields configuration from hazo_auth_config.ini
-// section: imports
-import { get_config_boolean } from "./config/config_loader.server";
-
-// section: types
-export type UserFieldsConfig = {
-  show_name_field: boolean;
-  show_email_field: boolean;
-  show_password_field: boolean;
-};
-
-// section: helpers
-/**
- * Reads shared user fields configuration from hazo_auth_config.ini file
- * Falls back to defaults if hazo_auth_config.ini is not found or section is missing
- * This configuration is used by register and my_settings layouts
- * @returns User fields configuration options
- */
-export function get_user_fields_config(): UserFieldsConfig {
-  // Read field visibility with defaults (all true by default)
-  const show_name_field = get_config_boolean("hazo_auth__user_fields", "show_name_field", true);
-  const show_email_field = get_config_boolean("hazo_auth__user_fields", "show_email_field", true);
-  const show_password_field = get_config_boolean("hazo_auth__user_fields", "show_password_field", true);
-
-  return {
-    show_name_field,
-    show_email_field,
-    show_password_field,
-  };
-}
-

package/src/lib/user_management_config.server.ts

@@ -1,39 +0,0 @@
-// file_description: server-only helper to read user management configuration from hazo_auth_config.ini
-// section: imports
-import { get_config_value, get_config_array, read_config_section } from "./config/config_loader.server";
-
-// section: types
-export type UserManagementConfig = {
-  application_permission_list_defaults: string[];
-};
-
-// section: helpers
-/**
- * Reads user management configuration from hazo_auth_config.ini file
- * Falls back to defaults if hazo_auth_config.ini is not found or section is missing
- * @returns User management configuration options
- */
-export function get_user_management_config(): UserManagementConfig {
-  // Try to read from hazo_auth__user_management section first
-  const user_management_section = read_config_section("hazo_auth__user_management");
-  const permissions_section = read_config_section("permissions");
-
-  // Try application_permission_list_defaults from user_management section
-  let permission_list: string[] = [];
-  
-  if (user_management_section?.application_permission_list_defaults) {
-    permission_list = get_config_array(
-      "hazo_auth__user_management",
-      "application_permission_list_defaults",
-      []
-    );
-  } else if (permissions_section?.list) {
-    // Fallback to permissions section list key
-    permission_list = get_config_array("permissions", "list", []);
-  }
-
-  return {
-    application_permission_list_defaults: permission_list,
-  };
-}
-

package/src/lib/utils/api_route_helpers.ts

@@ -1,60 +0,0 @@
-// file_description: shared helper functions for API routes to get filename and line number
-// section: helpers
-/**
- * Gets the filename from the call stack
- * This is a simplified version that extracts the filename from the error stack
- * @returns Filename or "route.ts" as default
- */
-export function get_filename(): string {
-  try {
-    const stack = new Error().stack;
-    if (!stack) {
-      return "route.ts";
-    }
-
-    // Parse stack trace to find the caller's file
-    const lines = stack.split("\n");
-    // Skip Error line and get_filename line, get the actual caller
-    for (let i = 2; i < lines.length; i++) {
-      const line = lines[i];
-      // Match file paths in stack trace (e.g., "at /path/to/file.ts:123:45")
-      const match = line.match(/([^/\\]+\.tsx?):(\d+):(\d+)/);
-      if (match) {
-        return match[1];
-      }
-    }
-    return "route.ts";
-  } catch {
-    return "route.ts";
-  }
-}
-
-/**
- * Gets the line number from the call stack
- * This is a simplified version that extracts the line number from the error stack
- * @returns Line number or 0
- */
-export function get_line_number(): number {
-  try {
-    const stack = new Error().stack;
-    if (!stack) {
-      return 0;
-    }
-
-    // Parse stack trace to find the caller's line number
-    const lines = stack.split("\n");
-    // Skip Error line and get_line_number line, get the actual caller
-    for (let i = 2; i < lines.length; i++) {
-      const line = lines[i];
-      // Match line numbers in stack trace (e.g., "at /path/to/file.ts:123:45")
-      const match = line.match(/([^/\\]+\.tsx?):(\d+):(\d+)/);
-      if (match) {
-        return parseInt(match[2], 10) || 0;
-      }
-    }
-    return 0;
-  } catch {
-    return 0;
-  }
-}
-

package/src/lib/utils/error_sanitizer.ts

@@ -1,75 +0,0 @@
-// file_description: utility functions for sanitizing error messages for user display
-// section: imports
-import { create_app_logger } from "../app_logger";
-
-// section: constants
-const USER_FRIENDLY_ERROR_MESSAGE = "We are facing some issues in our system, please try again later.";
-
-// section: types
-export type ErrorSanitizationOptions = {
-  logToConsole?: boolean;
-  logToLogger?: boolean;
-  logger?: ReturnType<typeof create_app_logger>;
-  context?: Record<string, unknown>;
-};
-
-// section: helpers
-/**
- * Sanitizes error messages for user display
- * Replaces technical error messages with user-friendly ones
- * @param error - The error object or message
- * @param options - Options for logging and context
- * @returns User-friendly error message
- */
-export function sanitize_error_for_user(
-  error: unknown,
-  options: ErrorSanitizationOptions = {}
-): string {
-  const { logToConsole = true, logToLogger = true, logger, context = {} } = options;
-
-  // Extract detailed error message
-  const detailed_error_message =
-    error instanceof Error ? error.message : String(error);
-  const error_stack = error instanceof Error ? error.stack : undefined;
-
-  // Log detailed error to console
-  if (logToConsole) {
-    console.error("Detailed error:", {
-      message: detailed_error_message,
-      stack: error_stack,
-      ...context,
-    });
-  }
-
-  // Log detailed error to logger if provided
-  if (logToLogger && logger) {
-    logger.error("error_occurred", {
-      filename: context.filename as string || "unknown",
-      line_number: context.line_number as number || 0,
-      error_message: detailed_error_message,
-      error_stack,
-      ...context,
-    });
-  }
-
-  // Check if error is a PostgREST or database-related error
-  const is_database_error =
-    detailed_error_message.includes("PostgREST") ||
-    detailed_error_message.includes("403 Forbidden") ||
-    detailed_error_message.includes("404 Not Found") ||
-    detailed_error_message.includes("500 Internal Server Error") ||
-    detailed_error_message.includes("database") ||
-    detailed_error_message.includes("connection") ||
-    detailed_error_message.includes("timeout");
-
-  // Return user-friendly message for database/API errors
-  if (is_database_error) {
-    return USER_FRIENDLY_ERROR_MESSAGE;
-  }
-
-  // For other errors, return the original message (could be user-friendly already)
-  // But still log the detailed error
-  return detailed_error_message;
-}
-
-

package/src/lib/utils.ts

@@ -1,11 +0,0 @@
-// file_description: provide shared utility helpers for the hazo_auth project
-import { clsx, type ClassValue } from "clsx";
-import { twMerge } from "tailwind-merge";
-
-// section: tailwind_merge_helper
-export function merge_class_names(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
-}
-
-// section: shadcn_compatibility_helper
-export const cn = (...inputs: ClassValue[]) => merge_class_names(...inputs);