hazo_auth 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 pub12
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+## hazo_auth - Authentication UI Component Package
+
+A reusable authentication UI component package powered by Next.js, TailwindCSS, and shadcn. It integrates `hazo_config` for configuration management and `hazo_connect` for data access, enabling future components to stay aligned with platform conventions.
+
+### Installation
+
+```bash
+npm install hazo_auth
+```
+
+### Configuration Setup
+
+After installing the package, you need to set up configuration files in your project root:
+
+1. **Copy the example config files to your project root:**
+   ```bash
+   cp node_modules/hazo_auth/hazo_auth_config.example.ini ./hazo_auth_config.ini
+   cp node_modules/hazo_auth/hazo_notify_config.example.ini ./hazo_notify_config.ini
+   ```
+
+2. **Customize the configuration files:**
+   - Edit `hazo_auth_config.ini` to configure authentication settings, database connection, UI labels, and more
+   - Edit `hazo_notify_config.ini` to configure email service settings (Zeptomail, SMTP, etc.)
+
+3. **Set up environment variables (recommended for sensitive data):**
+   - Create a `.env.local` file in your project root
+   - Add `ZEPTOMAIL_API_KEY=your_api_key_here` (if using Zeptomail)
+   - Add other sensitive configuration values as needed
+
+**Important:** The configuration files must be located in your project root directory (where `process.cwd()` points to), not inside `node_modules`. The package reads configuration from `process.cwd()` at runtime.
+
+### Local Development (for package contributors)
+
+- `npm install` to install dependencies.
+- `npm run dev` launches the Next.js app at `http://localhost:3000`.
+- `npm run storybook` launches Storybook at `http://localhost:6006`.
+
+### Project Structure
+
+- `src/app` contains the application shell and route composition.
+- `src/stories` holds Storybook stories for documenting components.
+- `src/lib` is the home for shared utilities.
+
+### Next Steps
+
+- Use `npx shadcn@latest add <component>` to scaffold new UI primitives.
+- Centralize configurable values through `hazo_config`.
+- Access backend resources exclusively via `hazo_connect`.

package/components.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "registries": {}
+}

package/hazo_auth_config.example.ini

@@ -0,0 +1,414 @@
+# file_description: example configuration file for hazo_auth
+# This file contains all configurable parameters for the application
+# Copy this file to your project root as hazo_auth_config.ini and customize the values
+# Commented values indicate defaults that are being used
+
+[hazo_connect]
+# Database type: sqlite, postgrest, supabase, or file
+type = sqlite
+
+# SQLite database configuration
+# Path to SQLite database file (relative to process.cwd() or absolute)
+sqlite_path = ./data/hazo_auth.sqlite
+
+# Enable SQLite admin UI (true/false)
+enable_admin_ui = true
+
+# SQLite read-only mode (true/false)
+# read_only = false
+
+# PostgREST configuration (uncomment if using postgrest type)
+# postgrest_url = 
+# postgrest_api_key = 
+
+[hazo_auth__register_layout]
+# Image configuration
+# image_src = /globe.svg
+# image_alt = Illustration of a globe representing secure authentication workflows
+# image_background_color = #e2e8f0
+
+# Labels
+# heading = Create your hazo account
+# sub_heading = Secure your access with editable fields powered by shadcn components.
+# submit_button = Register
+# cancel_button = Cancel
+
+# Field labels (defaults shown, uncomment to override)
+# name_label = Full name
+# name_placeholder = Enter your full name
+# email_label = Email address
+# email_placeholder = Enter your email address
+# password_label = Password
+# password_placeholder = Enter your password
+# confirm_password_label = Re-enter password
+# confirm_password_placeholder = Re-enter your password
+
+# Button colors
+# submit_background = #0f172a
+# submit_text = #ffffff
+# cancel_border = #cbd5f5
+# cancel_text = #0f172a
+
+# Show name field (true/false)
+# Note: This is now deprecated, use hazo_auth__user_fields section instead
+# show_name_field = false
+
+[hazo_auth__user_fields]
+# Shared user fields configuration used by register and my_settings layouts
+# Show name field (true/false, default: true)
+# show_name_field = true
+
+# Show email field (true/false, default: true)
+# show_email_field = true
+
+# Show password field (true/false, default: true)
+# show_password_field = true
+
+[hazo_auth__password_requirements]
+# Shared password requirements used by register and reset password layouts
+# minimum_length = 8
+# require_uppercase = false
+# require_lowercase = false
+# require_number = false
+# require_special = false
+
+[hazo_auth__login_layout]
+# Image configuration
+# image_src = /globe.svg
+# image_alt = Illustration of a globe representing secure authentication workflows
+# image_background_color = #e2e8f0
+
+# Labels
+# heading = Sign in to your account
+# sub_heading = Enter your credentials to access your secure workspace.
+# submit_button = Login
+# cancel_button = Cancel
+
+# Field labels (defaults shown, uncomment to override)
+# email_label = Email address
+# email_placeholder = Enter your email address
+# password_label = Password
+# password_placeholder = Enter your password
+
+# Button colors
+# submit_background = #0f172a
+# submit_text = #ffffff
+# cancel_border = #cbd5f5
+# cancel_text = #0f172a
+
+# Redirect on successful login (leave empty to show success message instead)
+# redirect_route_on_successful_login = /
+
+# Success message (shown when no redirect route is provided)
+# success_message = Successfully logged in
+
+[hazo_auth__forgot_password_layout]
+# Image configuration
+# image_src = /globe.svg
+# image_alt = Illustration of a globe representing secure authentication workflows
+# image_background_color = #e2e8f0
+
+# Labels
+# heading = Forgot your password?
+# sub_heading = Enter your email address and we'll send you a link to reset your password.
+# submit_button = Send reset link
+# cancel_button = Cancel
+
+[hazo_auth__reset_password_layout]
+# Image configuration
+# image_src = /globe.svg
+# image_alt = Illustration of a globe representing secure authentication workflows
+# image_background_color = #e2e8f0
+
+# Labels
+# heading = Reset your password
+# sub_heading = Enter your new password below.
+# submit_button = Reset password
+# cancel_button = Cancel
+
+# Field labels (defaults shown, uncomment to override)
+# password_label = New password
+# password_placeholder = Enter your new password
+# confirm_password_label = Confirm new password
+# confirm_password_placeholder = Re-enter your new password
+
+# Button colors
+# submit_background = #0f172a
+# submit_text = #ffffff
+# cancel_border = #cbd5f5
+# cancel_text = #0f172a
+
+# Error message (shown when token is invalid or missing)
+# error_message = Reset password link invalid or has expired. Please go to Reset Password page to get a new link.
+
+# Success message (shown after successful password reset)
+# success_message = Password reset successfully. Redirecting to login...
+
+# Login path (redirect target after successful reset)
+# login_path = /login
+
+# Forgot password path (link shown in error state)
+# forgot_password_path = /forgot_password
+
+[hazo_auth__email_verification_layout]
+# Image configuration
+# image_src = /globe.svg
+# image_alt = Illustration of a globe representing secure authentication workflows
+# image_background_color = #e2e8f0
+
+# Labels (verifying state)
+# heading = Email verification
+# sub_heading = Verifying your email address...
+# submit_button = Resend verification email
+# cancel_button = Cancel
+
+# Success labels
+# success_heading = Email verified successfully
+# success_message = Your email address has been verified. You can now log in to your account.
+# success_redirect_message = Redirecting to login page in
+# success_go_to_login_button = Go to login
+
+# Error labels
+# error_heading = Verification failed
+# error_message = The verification link is invalid or has expired.
+# error_resend_form_heading = Resend verification email
+
+# Field labels (defaults shown, uncomment to override)
+# email_label = Email address
+# email_placeholder = Enter your email address
+
+# Button colors
+# submit_background = #0f172a
+# submit_text = #ffffff
+# cancel_border = #cbd5f5
+# cancel_text = #0f172a
+
+# Redirect delay in seconds (default: 5)
+# redirect_delay = 5
+
+# Login path for redirect (default: /login)
+# login_path = /login
+
+[hazo_auth__already_logged_in]
+# Message shown when user is already logged in (used across all auth pages)
+# message = You're already logged in.
+
+# Show logout button (true/false)
+# show_logout_button = true
+
+# Show return home button (true/false)
+# show_return_home_button = false
+
+# Return home button label
+# return_home_button_label = Return home
+
+# Return home path
+# return_home_path = /
+
+[hazo_auth__my_settings_layout]
+# My Settings layout configuration
+
+# Note: This layout uses shared configuration from:
+# - [hazo_auth__user_fields] for field visibility (show_name_field, show_email_field, show_password_field)
+# - [hazo_auth__password_requirements] for password validation rules
+# - [hazo_auth__profile_picture] for profile picture settings and prioritization
+
+# Heading
+# heading = Account Settings
+
+# Sub heading
+# sub_heading = Manage your profile, password, and email preferences.
+
+# Profile Photo section
+# profile_photo_label = Profile Photo
+# profile_photo_recommendation = Recommended size: 200x200px. JPG, PNG.
+# Note: profile_photo_recommendation is currently not displayed in the UI (removed per user request)
+# upload_photo_button_label = Upload New Photo
+# remove_photo_button_label = Remove
+
+# Profile Information section
+# profile_information_label = Profile Information
+# Note: Field visibility is controlled by [hazo_auth__user_fields] section:
+#   - show_name_field (controls Full Name field visibility)
+#   - show_email_field (controls Email Address field visibility)
+# Note: Name and email field labels are currently hardcoded in the component
+
+# Password section
+# password_label = Password
+# current_password_label = Current Password
+# new_password_label = New Password
+# confirm_password_label = Confirm Password
+# save_password_button_label = Save Password
+# Note: Field visibility is controlled by [hazo_auth__user_fields] show_password_field
+# Note: Password requirements are controlled by [hazo_auth__password_requirements]
+
+# Unauthorized message (shown when user is not logged in)
+# unauthorized_message = You must be logged in to access this page.
+
+# Login button label (shown in unauthorized message)
+# login_button_label = Go to login
+
+# Login path (redirect target in unauthorized message)
+# login_path = /login
+
+[hazo_auth__profile_picture]
+# Profile picture configuration
+# This configuration is used by:
+# - Registration service (for default photo assignment)
+# - My Settings layout (for profile picture management)
+
+# Allow photo upload (true/false, default: false)
+# When enabled, users can upload their own profile pictures
+# allow_photo_upload = false
+
+# Upload photo path (required if allow_photo_upload is true)
+# Path should be outside the component package (e.g., ./uploads/profile_pictures/)
+# Can be relative to process.cwd() or absolute path
+# upload_photo_path = ./uploads/profile_pictures
+
+# Maximum photo size in bytes (default: 51200 = 50kb)
+# Photos larger than this will be compressed automatically
+# max_photo_size = 51200
+
+# Enable default photo assignment on user creation (true/false, default: true)
+# When enabled, new users will automatically get a profile picture based on priority settings
+# user_photo_default = true
+
+# Default photo priority 1 (gravatar or library, default: gravatar)
+# This is the first source tried when assigning a default profile picture
+# Options: "gravatar" or "library"
+# user_photo_default_priority1 = gravatar
+
+# Default photo priority 2 (library or gravatar, optional)
+# This is the fallback source if priority 1 fails or is not available
+# Options: "library" or "gravatar"
+# Leave commented to disable fallback (only priority 1 will be tried)
+# user_photo_default_priority2 = library
+
+# Library photo path relative to public directory (default: /profile_pictures/library)
+# Photos should be organized in category subdirectories (e.g., /profile_pictures/library/Cars/)
+# library_photo_path = /profile_pictures/library
+
+[hazo_auth__tokens]
+# Token expiry configuration (in hours)
+# Default expiry times:
+# - refresh: 720 hours (30 days)
+# - password_reset: 0.167 hours (10 minutes)
+# - email_verification: 48 hours
+
+# Refresh token expiry (hours)
+# refresh_expiry_hours = 720
+
+# Password reset token expiry (hours, default: 10 minutes = 0.167 hours)
+# password_reset_expiry_hours = 0.167
+
+# Email verification token expiry (hours)
+# email_verification_expiry_hours = 48
+
+[hazo_auth__messages]
+# User-facing messages used across the application
+# Photo upload disabled message
+# photo_upload_disabled_message = Photo upload is not enabled. Please contact your administrator.
+
+# Gravatar messages
+# gravatar_setup_message = To set up your Gravatar:
+# gravatar_no_account_message = You don't have a Gravatar account set up for this email address.
+
+# Library tooltip message
+# library_tooltip_message = Select another tab image style to remove this image
+
+[hazo_auth__ui_sizes]
+# UI size configuration (in pixels)
+# Gravatar image size (default: 200)
+# gravatar_size = 200
+
+# Profile picture size (default: 200)
+# profile_picture_size = 200
+
+# Tooltip icon sizes
+# tooltip_icon_size_default = 16
+# tooltip_icon_size_small = 14
+
+# Library photo grid configuration
+# library_photo_grid_columns = 4
+# library_photo_preview_size = 200
+
+# Image compression max width/height (default: 200)
+# image_compression_max_dimension = 200
+
+# Upload file hard limit in bytes (default: 10485760 = 10MB)
+# upload_file_hard_limit_bytes = 10485760
+
+[hazo_auth__file_types]
+# Allowed file extensions and MIME types
+# Allowed image extensions (comma-separated, default: jpg,jpeg,png)
+# allowed_image_extensions = jpg,jpeg,png
+
+# Allowed image MIME types (comma-separated, default: image/jpeg,image/jpg,image/png)
+# allowed_image_mime_types = image/jpeg,image/jpg,image/png
+
+[hazo_auth__email]
+# Email configuration for verification, password reset, and password changed notification emails
+# Emails are sent using hazo_notify (configured in hazo_notify_config.ini)
+
+# Email from address (optional: overrides hazo_notify_config.ini from_email setting)
+# Priority: 1. hazo_auth__email.from_email, 2. hazo_notify_config.ini from_email
+# If not set, uses hazo_notify_config.ini from_email setting
+# from_email = noreply@example.com
+# from_name = Your App Name
+
+# Base URL for email links (default: empty, uses relative URLs)
+# If provided, this will be used to construct absolute URLs for verification and password reset links
+# Priority: 1. hazo_auth__email.base_url, 2. APP_DOMAIN_NAME env var, 3. NEXT_PUBLIC_APP_URL/APP_URL env vars
+# Example: https://example.com
+# base_url = https://example.com
+
+# Email template main directory (default: ./email_templates)
+# This directory should contain email template files (HTML and text)
+# Template files should be named: <template_type>.html and <template_type>.txt
+# Example: email_verification.html, email_verification.txt, forgot_password.html, forgot_password.txt
+# email_template_main_directory = ./email_templates
+
+### Email Template: Email Verification ###
+# Email template configuration for email verification
+# This config key enables custom templates for email verification emails
+# If set, the service will look for email_verification.html and email_verification.txt in the template directory
+# email_template__email_verification = email_verification
+
+# Email subject for email verification (default: "Verify Your Email Address")
+# email_template__email_verification__subject = Verify Your Email Address
+
+# Template variables available in email_verification template:
+# - {{token}} - The verification token
+# - {{verification_url}} - Full URL for email verification
+# - {{user_email}} - User's email address
+# - {{user_name}} - User's name (if available)
+
+### Email Template: Forgot Password ###
+# Email template configuration for forgot password
+# This config key enables custom templates for forgot password emails
+# If set, the service will look for forgot_password.html and forgot_password.txt in the template directory
+# email_template__forgot_password = forgot_password
+
+# Email subject for forgot password (default: "Reset Your Password")
+# email_template__forgot_password__subject = Reset Your Password
+
+# Template variables available in forgot_password template:
+# - {{token}} - The password reset token
+# - {{reset_url}} - Full URL for password reset
+# - {{user_email}} - User's email address
+# - {{user_name}} - User's name (if available)
+
+### Email Template: Password Changed ###
+# Email template configuration for password changed notification
+# This config key enables custom templates for password changed notification emails
+# If set, the service will look for password_changed.html and password_changed.txt in the template directory
+# email_template__password_changed = password_changed
+
+# Email subject for password changed notification (default: "Password Changed Successfully")
+# email_template__password_changed__subject = Password Changed Successfully
+
+# Template variables available in password_changed template:
+# - {{user_email}} - User's email address
+# - {{user_name}} - User's name (if available)
+

package/hazo_notify_config.example.ini

@@ -0,0 +1,159 @@
+# file_description: example configuration file for hazo_notify email service
+# This file contains all configurable parameters for the hazo_notify email service
+# Copy this file to your project root as hazo_notify_config.ini and customize the values
+# Commented values indicate defaults that are being used
+
+[emailer]
+# Emailer module: zeptoemail_api, smtp, pop3
+# Required: Yes
+# Default: zeptoemail_api
+# Description: Select the emailer module to use
+# emailer_module=zeptoemail_api
+
+# Zeptomail API Provider Configuration
+# Required when emailer_module=zeptoemail_api
+# Description: API endpoint for Zeptomail email service
+# zeptomail_api_endpoint=https://api.zeptomail.com.au/v1.1/email
+
+# Required when emailer_module=zeptoemail_api
+# Description: Zeptomail API key for authentication
+# SECURITY: Store this in .env.local file as ZEPTOMAIL_API_KEY (recommended)
+# Get this from your Zeptomail account dashboard
+# If not set in .env.local, you can set it here (not recommended for production)
+# zeptomail_api_key=your_zeptomail_api_key
+
+# Required: Yes
+# Description: Default sender email address
+# This email must be verified in your Zeptomail account
+# from_email=noreply@example.com
+
+# Required: Yes
+# Description: Default sender name displayed in email clients
+# from_name=Your App Name
+
+# Optional: Reply-to email address
+# Description: Email address to use for replies (if different from from_email)
+# Default: Uses from_email if not specified
+# reply_to_email=support@example.com
+
+# Optional: Bounce handling email
+# Description: Email address to receive bounce notifications
+# bounce_email=bounce@example.com
+
+# Optional: Return path email
+# Description: Email address to use for return path
+# return_path_email=returns@example.com
+
+# SMTP Provider Configuration (placeholder - not yet implemented)
+# Required when emailer_module=smtp
+# Description: SMTP server hostname
+# smtp_host=smtp.example.com
+
+# Required when emailer_module=smtp
+# Description: SMTP server port (typically 587 for TLS, 465 for SSL, 25 for non-secure)
+# smtp_port=587
+
+# Required when emailer_module=smtp
+# Description: Use secure connection (true for SSL/TLS, false for non-secure)
+# smtp_secure=false
+
+# Required when emailer_module=smtp
+# Description: SMTP authentication username (usually your email address)
+# smtp_auth_user=your_email@example.com
+
+# Required when emailer_module=smtp
+# Description: SMTP authentication password or app-specific password
+# smtp_auth_pass=your_password
+
+# Optional: SMTP connection timeout in milliseconds
+# Description: Timeout for SMTP connection attempts
+# Default: 5000
+# smtp_timeout=5000
+
+# Optional: SMTP pool configuration
+# Description: Enable connection pooling for better performance
+# Default: false
+# smtp_pool=false
+
+# POP3 Provider Configuration (placeholder - not yet implemented)
+# Required when emailer_module=pop3
+# Description: POP3 server hostname
+# pop3_host=pop3.example.com
+
+# Required when emailer_module=pop3
+# Description: POP3 server port (typically 995 for SSL, 110 for non-secure)
+# pop3_port=995
+
+# Required when emailer_module=pop3
+# Description: Use secure connection (true for SSL, false for non-secure)
+# pop3_secure=true
+
+# Required when emailer_module=pop3
+# Description: POP3 authentication username (usually your email address)
+# pop3_auth_user=your_email@example.com
+
+# Required when emailer_module=pop3
+# Description: POP3 authentication password
+# pop3_auth_pass=your_password
+
+# Optional: POP3 connection timeout in milliseconds
+# Description: Timeout for POP3 connection attempts
+# Default: 5000
+# pop3_timeout=5000
+
+# Rate Limiting Configuration
+# Optional: Rate limit requests per minute
+# Description: Maximum number of requests allowed per minute per IP address
+# Default: 10
+# Recommended: 10-60 for production
+# rate_limit_requests=10
+
+# Optional: Rate limit window in seconds
+# Description: Time window for rate limiting
+# Default: 60 (1 minute)
+# rate_limit_window=60
+
+# Attachment Limits
+# Optional: Maximum attachment size in bytes
+# Description: Maximum size allowed per attachment (in bytes)
+# Default: 10485760 (10MB)
+# Recommended: 10MB for most use cases
+# max_attachment_size=10485760
+
+# Optional: Maximum number of attachments
+# Description: Maximum number of attachments allowed per email
+# Default: 10
+# max_attachments=10
+
+# Request Timeout
+# Optional: Request timeout in milliseconds
+# Description: Timeout for API requests to email providers
+# Default: 30000 (30 seconds)
+# request_timeout=30000
+
+# Input Length Limits
+# Optional: Maximum subject length in characters
+# Description: Maximum length for email subject line
+# Default: 255 (RFC 5322 standard)
+# max_subject_length=255
+
+# Optional: Maximum body length in bytes
+# Description: Maximum size for email body content (text or HTML)
+# Default: 1048576 (1MB)
+# max_body_length=1048576
+
+# CORS Configuration
+# Optional: CORS allowed origins
+# Description: Comma-separated list of allowed origins for CORS
+# Default: empty (same-origin only)
+# Use "*" to allow all origins (not recommended for production)
+# cors_allowed_origins=
+
+[ui]
+# Enable UI component and all routes (e.g., /hazo_notify/emailer_test)
+# Required: No
+# Default: false
+# Description: Enable the entire UI component and all routes for testing services
+# Set to true to enable the UI, false to disable it
+# enable_ui=false
+

package/instrumentation.ts

@@ -0,0 +1,32 @@
+// file_description: Next.js instrumentation file - runs once when server starts
+// Initializes hazo_notify email service and passes it to hazo_auth email service
+// section: instrumentation
+export async function register() {
+  // Only run in server environment
+  if (typeof window === "undefined") {
+    try {
+      // Step 1: Import hazo_notify package
+      const hazo_notify_module = await import("hazo_notify");
+      
+      // Step 2: Load hazo_notify emailer configuration
+      // This reads from hazo_notify_config.ini in the ui_component directory (same location as hazo_auth_config.ini)
+      const { load_emailer_config } = hazo_notify_module;
+      const notify_config = load_emailer_config();
+      
+      // Step 3: Pass the initialized configuration to hazo_auth email service
+      // This allows the email service to reuse the same configuration instance
+      const { set_hazo_notify_instance } = await import("@/lib/services/email_service");
+      set_hazo_notify_instance(notify_config);
+      
+      // Log successful initialization
+      console.log("hazo_notify initialized successfully");
+    } catch (error) {
+      // Log error but don't crash - allows app to run without email functionality
+      // The email service will attempt to load config on first use as fallback
+      const error_message = error instanceof Error ? error.message : "Unknown error";
+      console.warn("Failed to initialize hazo_notify:", error_message);
+      console.warn("Email service will attempt to load config on first use as fallback");
+    }
+  }
+}
+