hazo_auth 1.0.5 → 1.1.0

package/src/lib/register_config.server.ts

@@ -1,6 +1,6 @@
 // file_description: server-only helper to read register layout configuration from hazo_auth_config.ini
 // section: imports
-import { get_config_boolean, read_config_section } from "./config/config_loader.server";
+import { get_config_boolean, get_config_value, read_config_section } from "./config/config_loader.server";
 import { get_password_requirements_config } from "./password_requirements_config.server";
 import { get_already_logged_in_config } from "./already_logged_in_config.server";
 import { get_user_fields_config } from "./user_fields_config.server";
@@ -20,6 +20,8 @@ export type RegisterConfig = {
   showReturnHomeButton: boolean;
   returnHomeButtonLabel: string;
   returnHomePath: string;
+  signInPath: string;
+  signInLabel: string;
 };
 
 // section: helpers
@@ -44,6 +46,18 @@ export function get_register_config(): RegisterConfig {
   // Get shared already logged in config
   const alreadyLoggedInConfig = get_already_logged_in_config();
 
+  // Read sign in link configuration
+  const signInPath = get_config_value(
+    "hazo_auth__register_layout",
+    "sign_in_path",
+    "/hazo_auth/login"
+  );
+  const signInLabel = get_config_value(
+    "hazo_auth__register_layout",
+    "sign_in_label",
+    "Sign in"
+  );
+
   return {
     showNameField,
     passwordRequirements,
@@ -52,6 +66,8 @@ export function get_register_config(): RegisterConfig {
     showReturnHomeButton: alreadyLoggedInConfig.showReturnHomeButton,
     returnHomeButtonLabel: alreadyLoggedInConfig.returnHomeButtonLabel,
     returnHomePath: alreadyLoggedInConfig.returnHomePath,
+    signInPath,
+    signInLabel,
   };
 }
 

package/src/lib/services/login_service.ts

@@ -3,6 +3,9 @@
 import type { HazoConnectAdapter } from "hazo_connect";
 import { createCrudService } from "hazo_connect/server";
 import argon2 from "argon2";
+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 LoginData = {
@@ -15,6 +18,7 @@ export type LoginResult = {
   user_id?: string;
   error?: string;
   email_not_verified?: boolean;
+  stored_url_on_logon?: string | null;
 };
 
 // section: helpers
@@ -98,20 +102,32 @@ export async function authenticate_user(
         last_logon: now,
         login_attempts: 0,
         changed_at: now,
+        url_on_logon: null, // Clear the stored redirect URL after successful login
       }
     );
 
     return {
       success: true,
       user_id: user.id as string,
+      stored_url_on_logon: user.url_on_logon as string | null | undefined,
     };
   } catch (error) {
-    const error_message =
-      error instanceof Error ? error.message : "Unknown error";
+    const logger = create_app_logger();
+    const user_friendly_error = sanitize_error_for_user(error, {
+      logToConsole: true,
+      logToLogger: true,
+      logger,
+      context: {
+        filename: "login_service.ts",
+        line_number: get_line_number(),
+        email: data.email,
+        operation: "authenticate_user",
+      },
+    });
 
     return {
       success: false,
-      error: error_message,
+      error: user_friendly_error,
     };
   }
 }

package/src/lib/services/registration_service.ts

@@ -10,12 +10,15 @@ import { get_profile_picture_config } from "../profile_picture_config.server";
 import { map_ui_source_to_db } from "./profile_picture_source_mapper";
 import { create_app_logger } from "../app_logger";
 import { send_template_email } from "./email_service";
+import { sanitize_error_for_user } from "../utils/error_sanitizer";
+import { get_filename, get_line_number } from "../utils/api_route_helpers";
 
 // section: types
 export type RegistrationData = {
   email: string;
   password: string;
   name?: string;
+  url_on_logon?: string;
 };
 
 export type RegistrationResult = {
@@ -36,7 +39,7 @@ export async function register_user(
   data: RegistrationData,
 ): Promise<RegistrationResult> {
   try {
-    const { email, password, name } = data;
+    const { email, password, name, url_on_logon } = data;
 
     // Create CRUD service for hazo_users table
     const users_service = createCrudService(adapter, "hazo_users");
@@ -77,6 +80,14 @@ export async function register_user(
       insert_data.name = name;
     }
 
+    // Validate and include url_on_logon if provided
+    if (url_on_logon) {
+      // Ensure it's a relative path starting with / but not //
+      if (url_on_logon.startsWith("/") && !url_on_logon.startsWith("//")) {
+        insert_data.url_on_logon = url_on_logon;
+      }
+    }
+
     // Set default profile picture if enabled
     const profile_picture_config = get_profile_picture_config();
     if (profile_picture_config.user_photo_default) {
@@ -151,12 +162,22 @@ export async function register_user(
       user_id,
     };
   } catch (error) {
-    const error_message =
-      error instanceof Error ? error.message : "Unknown error";
+    const logger = create_app_logger();
+    const user_friendly_error = sanitize_error_for_user(error, {
+      logToConsole: true,
+      logToLogger: true,
+      logger,
+      context: {
+        filename: "registration_service.ts",
+        line_number: get_line_number(),
+        email: data.email,
+        operation: "register_user",
+      },
+    });
 
     return {
       success: false,
-      error: error_message,
+      error: user_friendly_error,
     };
   }
 }

package/src/lib/services/user_update_service.ts

@@ -3,6 +3,9 @@
 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 = {
@@ -116,12 +119,22 @@ export async function update_user_profile(
       email_changed,
     };
   } catch (error) {
-    const error_message =
-      error instanceof Error ? error.message : "Unknown 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: error_message,
+      error: user_friendly_error,
     };
   }
 }

package/src/lib/ui_shell_config.server.ts

@@ -0,0 +1,73 @@
+// 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/utils/error_sanitizer.ts

@@ -0,0 +1,75 @@
+// 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;
+}
+
+