hazo_auth 1.6.0 → 1.6.2

package/dist/lib/services/user_profiles_service.js

@@ -2,16 +2,60 @@ 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";
+import { get_user_profiles_cache } from "./user_profiles_cache";
+import { get_user_profiles_cache_config } from "../user_profiles_config.server";
 // section: helpers
+/**
+ * Fetches profiles from database for given user IDs
+ * @param adapter - The hazo_connect adapter instance
+ * @param user_ids - Array of user IDs to fetch
+ * @returns Object with profiles and not found IDs
+ */
+async function fetch_profiles_from_db(adapter, user_ids) {
+    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.(${user_ids.join(",")})`,
+    });
+    // Handle case where no users are found
+    if (!Array.isArray(users)) {
+        return {
+            profiles: [],
+            not_found_ids: user_ids,
+        };
+    }
+    // Build set of found user IDs for quick lookup
+    const found_user_ids = new Set(users.map((user) => user.id));
+    // Determine which user IDs were not found
+    const not_found_ids = user_ids.filter((id) => !found_user_ids.has(id));
+    // Transform database records to UserProfileInfo
+    const now = new Date();
+    const profiles = users.map((user) => {
+        const created_at = user.created_at;
+        const created_date = new Date(created_at);
+        const days_since_created = differenceInDays(now, created_date);
+        return {
+            user_id: user.id,
+            profile_picture_url: user.profile_picture_url || null,
+            email: user.email_address,
+            name: user.name || null,
+            days_since_created,
+        };
+    });
+    return { profiles, not_found_ids };
+}
 /**
  * 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
+ * Uses LRU cache with configurable TTL for performance (default: 5 minutes)
  * @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, user_ids) {
     const logger = create_app_logger();
+    const config = get_user_profiles_cache_config();
     try {
         // Handle empty input
         if (!user_ids || user_ids.length === 0) {
@@ -19,62 +63,85 @@ export async function hazo_get_user_profiles(adapter, user_ids) {
                 success: true,
                 profiles: [],
                 not_found_ids: [],
+                cache_stats: {
+                    hits: 0,
+                    misses: 0,
+                    cache_enabled: config.cache_enabled,
+                },
             };
         }
         // 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,
-            };
+        // Initialize variables for cache tracking
+        let cache_hits = 0;
+        let cache_misses = 0;
+        let all_profiles = [];
+        let all_not_found_ids = [];
+        if (config.cache_enabled) {
+            // Get cache instance with config settings
+            const cache = get_user_profiles_cache(config.cache_max_entries, config.cache_ttl_minutes);
+            // Check cache first
+            const { cached, missing_ids } = cache.get_many(unique_user_ids);
+            cache_hits = cached.length;
+            cache_misses = missing_ids.length;
+            // If all profiles were cached, return immediately
+            if (missing_ids.length === 0) {
+                logger.info("hazo_get_user_profiles_cache_hit_all", {
+                    filename: "user_profiles_service.ts",
+                    line_number: 130,
+                    message: "All profiles served from cache",
+                    requested_count: unique_user_ids.length,
+                    cache_hits,
+                });
+                return {
+                    success: true,
+                    profiles: cached,
+                    not_found_ids: [],
+                    cache_stats: {
+                        hits: cache_hits,
+                        misses: 0,
+                        cache_enabled: true,
+                    },
+                };
+            }
+            // Fetch missing profiles from database
+            const db_result = await fetch_profiles_from_db(adapter, missing_ids);
+            // Cache the newly fetched profiles
+            if (db_result.profiles.length > 0) {
+                cache.set_many(db_result.profiles);
+            }
+            // Combine cached and freshly fetched profiles
+            all_profiles = [...cached, ...db_result.profiles];
+            all_not_found_ids = db_result.not_found_ids;
+        }
+        else {
+            // Cache disabled - fetch all from database
+            cache_misses = unique_user_ids.length;
+            const db_result = await fetch_profiles_from_db(adapter, unique_user_ids);
+            all_profiles = db_result.profiles;
+            all_not_found_ids = db_result.not_found_ids;
         }
-        // Build set of found user IDs for quick lookup
-        const found_user_ids = new Set(users.map((user) => user.id));
-        // 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 = users.map((user) => {
-            const created_at = user.created_at;
-            const created_date = new Date(created_at);
-            const days_since_created = differenceInDays(now, created_date);
-            return {
-                user_id: user.id,
-                profile_picture_url: user.profile_picture_url || null,
-                email: user.email_address,
-                name: user.name || null,
-                days_since_created,
-            };
-        });
         // Log successful retrieval
         logger.info("hazo_get_user_profiles_success", {
             filename: "user_profiles_service.ts",
-            line_number: 105,
+            line_number: 170,
             message: "Successfully retrieved user profiles",
             requested_count: unique_user_ids.length,
-            found_count: profiles.length,
-            not_found_count: not_found_ids.length,
+            found_count: all_profiles.length,
+            not_found_count: all_not_found_ids.length,
+            cache_hits,
+            cache_misses,
+            cache_enabled: config.cache_enabled,
         });
         return {
             success: true,
-            profiles,
-            not_found_ids,
+            profiles: all_profiles,
+            not_found_ids: all_not_found_ids,
+            cache_stats: {
+                hits: cache_hits,
+                misses: cache_misses,
+                cache_enabled: config.cache_enabled,
+            },
         };
     }
     catch (error) {
@@ -84,7 +151,7 @@ export async function hazo_get_user_profiles(adapter, user_ids) {
             logger,
             context: {
                 filename: "user_profiles_service.ts",
-                line_number: 122,
+                line_number: 195,
                 operation: "hazo_get_user_profiles",
                 user_ids_count: (user_ids === null || user_ids === void 0 ? void 0 : user_ids.length) || 0,
             },
@@ -97,3 +164,28 @@ export async function hazo_get_user_profiles(adapter, user_ids) {
         };
     }
 }
+/**
+ * Invalidates cache for specific user IDs
+ * Call this after user profile updates to ensure fresh data on next fetch
+ * @param user_ids - Array of user IDs to invalidate from cache
+ */
+export function invalidate_user_profiles_cache(user_ids) {
+    const config = get_user_profiles_cache_config();
+    if (!config.cache_enabled) {
+        return;
+    }
+    const cache = get_user_profiles_cache(config.cache_max_entries, config.cache_ttl_minutes);
+    cache.invalidate_users(user_ids);
+}
+/**
+ * Invalidates the entire user profiles cache
+ * Use sparingly - prefer invalidating specific users when possible
+ */
+export function invalidate_all_user_profiles_cache() {
+    const config = get_user_profiles_cache_config();
+    if (!config.cache_enabled) {
+        return;
+    }
+    const cache = get_user_profiles_cache(config.cache_max_entries, config.cache_ttl_minutes);
+    cache.invalidate_all();
+}

package/dist/lib/user_profiles_config.server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * User profiles cache configuration options
+ */
+export type UserProfilesCacheConfig = {
+    cache_enabled: boolean;
+    cache_max_entries: number;
+    cache_ttl_minutes: number;
+};
+/**
+ * Reads user profiles cache 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 profiles cache configuration options
+ */
+export declare function get_user_profiles_cache_config(): UserProfilesCacheConfig;
+//# sourceMappingURL=user_profiles_config.server.d.ts.map

package/dist/lib/user_profiles_config.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user_profiles_config.server.d.ts","sourceRoot":"","sources":["../../src/lib/user_profiles_config.server.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,uBAAuB,CA6BxE"}

package/dist/lib/user_profiles_config.server.js

@@ -0,0 +1,23 @@
+// file_description: server-only helper to read user profiles cache configuration from hazo_auth_config.ini
+// section: imports
+import { get_config_number, } from "./config/config_loader.server";
+// section: helpers
+/**
+ * Reads user profiles cache 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 profiles cache configuration options
+ */
+export function get_user_profiles_cache_config() {
+    const section_name = "hazo_auth__user_profiles";
+    // Cache settings
+    // cache_enabled: 0 = disabled, 1 = enabled (default: 1)
+    const cache_enabled_num = get_config_number(section_name, "cache_enabled", 1);
+    const cache_enabled = cache_enabled_num === 1;
+    const cache_max_entries = get_config_number(section_name, "cache_max_entries", 5000);
+    const cache_ttl_minutes = get_config_number(section_name, "cache_ttl_minutes", 5);
+    return {
+        cache_enabled,
+        cache_max_entries,
+        cache_ttl_minutes,
+    };
+}

package/dist/page_components/forgot_password.d.ts

@@ -0,0 +1,19 @@
+export type ForgotPasswordPageProps = {
+    alreadyLoggedInMessage?: string;
+    showLogoutButton?: boolean;
+    showReturnHomeButton?: boolean;
+    returnHomeButtonLabel?: string;
+    returnHomePath?: string;
+    imageSrc?: string;
+    imageAlt?: string;
+    imageBackgroundColor?: string;
+};
+/**
+ * Zero-config forgot password page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns Forgot password page component
+ */
+export declare function ForgotPasswordPage({ alreadyLoggedInMessage, showLogoutButton, showReturnHomeButton, returnHomeButtonLabel, returnHomePath, imageSrc, imageAlt, imageBackgroundColor, }?: ForgotPasswordPageProps): import("react/jsx-runtime").JSX.Element;
+export default ForgotPasswordPage;
+//# sourceMappingURL=forgot_password.d.ts.map

package/dist/page_components/forgot_password.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgot_password.d.ts","sourceRoot":"","sources":["../../src/page_components/forgot_password.tsx"],"names":[],"mappings":"AAiBA,MAAM,MAAM,uBAAuB,GAAG;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAGF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,sBAAoD,EACpD,gBAAuB,EACvB,oBAA4B,EAC5B,qBAAqC,EACrC,cAAoB,EACpB,QAA4B,EAC5B,QAA4B,EAC5B,oBAAuC,GACxC,GAAE,uBAA4B,2CAmC9B;AAED,eAAe,kBAAkB,CAAC"}

package/dist/page_components/forgot_password.js

@@ -0,0 +1,36 @@
+// file_description: zero-config forgot password page component for hazo_auth
+// Consumers can use this directly without needing to configure props
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+// section: imports
+import { useEffect, useState } from "react";
+import forgot_password_layout from "../components/layouts/forgot_password";
+import { createLayoutDataClient } from "../components/layouts/shared/data/layout_data_client";
+import { create_sqlite_hazo_connect } from "../lib/hazo_connect_setup";
+// section: constants
+const DEFAULT_IMAGE_SRC = "/globe.svg";
+const DEFAULT_IMAGE_ALT = "Illustration of a globe representing secure authentication workflows";
+const DEFAULT_IMAGE_BG = "#e2e8f0";
+// section: component
+/**
+ * Zero-config forgot password page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns Forgot password page component
+ */
+export function ForgotPasswordPage({ alreadyLoggedInMessage = "You are already logged in", showLogoutButton = true, showReturnHomeButton = false, returnHomeButtonLabel = "Return home", returnHomePath = "/", imageSrc = DEFAULT_IMAGE_SRC, imageAlt = DEFAULT_IMAGE_ALT, imageBackgroundColor = DEFAULT_IMAGE_BG, } = {}) {
+    const [dataClient, setDataClient] = useState(null);
+    useEffect(() => {
+        // Initialize hazo_connect on client side
+        const hazoConnect = create_sqlite_hazo_connect();
+        const client = createLayoutDataClient(hazoConnect);
+        setDataClient(client);
+    }, []);
+    // Show loading state while initializing
+    if (!dataClient) {
+        return (_jsx("div", { className: "cls_forgot_password_page_loading flex items-center justify-center min-h-screen", children: _jsx("div", { className: "text-slate-600 animate-pulse", children: "Loading..." }) }));
+    }
+    const ForgotPasswordLayout = forgot_password_layout;
+    return (_jsx(ForgotPasswordLayout, { image_src: imageSrc, image_alt: imageAlt, image_background_color: imageBackgroundColor, data_client: dataClient, alreadyLoggedInMessage: alreadyLoggedInMessage, showLogoutButton: showLogoutButton, showReturnHomeButton: showReturnHomeButton, returnHomeButtonLabel: returnHomeButtonLabel, returnHomePath: returnHomePath }));
+}
+export default ForgotPasswordPage;

package/dist/page_components/index.d.ts

@@ -0,0 +1,7 @@
+export { LoginPage, type LoginPageProps } from "./login.js";
+export { RegisterPage, type RegisterPageProps } from "./register.js";
+export { ForgotPasswordPage, type ForgotPasswordPageProps } from "./forgot_password.js";
+export { ResetPasswordPage, type ResetPasswordPageProps } from "./reset_password.js";
+export { VerifyEmailPage, type VerifyEmailPageProps } from "./verify_email.js";
+export { MySettingsPage, type MySettingsPageProps } from "./my_settings.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/page_components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/page_components/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/page_components/index.js

@@ -0,0 +1,9 @@
+// file_description: barrel export for zero-config page components
+// These components can be used directly by consumers with sensible defaults
+// section: page_exports
+export { LoginPage } from "./login.js";
+export { RegisterPage } from "./register.js";
+export { ForgotPasswordPage } from "./forgot_password.js";
+export { ResetPasswordPage } from "./reset_password.js";
+export { VerifyEmailPage } from "./verify_email.js";
+export { MySettingsPage } from "./my_settings.js";

package/dist/page_components/login.d.ts

@@ -0,0 +1,26 @@
+export type LoginPageProps = {
+    redirectRoute?: string;
+    successMessage?: string;
+    alreadyLoggedInMessage?: string;
+    showLogoutButton?: boolean;
+    showReturnHomeButton?: boolean;
+    returnHomeButtonLabel?: string;
+    returnHomePath?: string;
+    forgotPasswordPath?: string;
+    forgotPasswordLabel?: string;
+    createAccountPath?: string;
+    createAccountLabel?: string;
+    urlOnLogon?: string;
+    imageSrc?: string;
+    imageAlt?: string;
+    imageBackgroundColor?: string;
+};
+/**
+ * Zero-config login page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns Login page component
+ */
+export declare function LoginPage({ redirectRoute, successMessage, alreadyLoggedInMessage, showLogoutButton, showReturnHomeButton, returnHomeButtonLabel, returnHomePath, forgotPasswordPath, forgotPasswordLabel, createAccountPath, createAccountLabel, urlOnLogon, imageSrc, imageAlt, imageBackgroundColor, }?: LoginPageProps): import("react/jsx-runtime").JSX.Element;
+export default LoginPage;
+//# sourceMappingURL=login.d.ts.map

package/dist/page_components/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/page_components/login.tsx"],"names":[],"mappings":"AAkBA,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAGF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,aAAa,EACb,cAAyC,EACzC,sBAAoD,EACpD,gBAAuB,EACvB,oBAA4B,EAC5B,qBAAqC,EACrC,cAAoB,EACpB,kBAAiD,EACjD,mBAAwC,EACxC,iBAAyC,EACzC,kBAAqC,EACrC,UAAU,EACV,QAA4B,EAC5B,QAA4B,EAC5B,oBAAuC,GACxC,GAAE,cAAmB,2CA8CrB;AAED,eAAe,SAAS,CAAC"}

package/dist/page_components/login.js

@@ -0,0 +1,40 @@
+// file_description: zero-config login page component for hazo_auth
+// Consumers can use this directly without needing to configure props
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+// section: imports
+import { useEffect, useState } from "react";
+import login_layout from "../components/layouts/login";
+import { createLayoutDataClient } from "../components/layouts/shared/data/layout_data_client";
+import { create_sqlite_hazo_connect } from "../lib/hazo_connect_setup";
+import { create_app_logger } from "../lib/app_logger";
+// section: constants
+const DEFAULT_IMAGE_SRC = "/globe.svg";
+const DEFAULT_IMAGE_ALT = "Illustration of a globe representing secure authentication workflows";
+const DEFAULT_IMAGE_BG = "#e2e8f0";
+// section: component
+/**
+ * Zero-config login page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns Login page component
+ */
+export function LoginPage({ redirectRoute, successMessage = "Successfully logged in", alreadyLoggedInMessage = "You are already logged in", showLogoutButton = true, showReturnHomeButton = false, returnHomeButtonLabel = "Return home", returnHomePath = "/", forgotPasswordPath = "/hazo_auth/forgot_password", forgotPasswordLabel = "Forgot password?", createAccountPath = "/hazo_auth/register", createAccountLabel = "Create account", urlOnLogon, imageSrc = DEFAULT_IMAGE_SRC, imageAlt = DEFAULT_IMAGE_ALT, imageBackgroundColor = DEFAULT_IMAGE_BG, } = {}) {
+    const [dataClient, setDataClient] = useState(null);
+    const [logger, setLogger] = useState(null);
+    useEffect(() => {
+        // Initialize hazo_connect and logger on client side
+        const hazoConnect = create_sqlite_hazo_connect();
+        const client = createLayoutDataClient(hazoConnect);
+        const appLogger = create_app_logger();
+        setDataClient(client);
+        setLogger(appLogger);
+    }, []);
+    // Show loading state while initializing
+    if (!dataClient || !logger) {
+        return (_jsx("div", { className: "cls_login_page_loading flex items-center justify-center min-h-screen", children: _jsx("div", { className: "text-slate-600 animate-pulse", children: "Loading..." }) }));
+    }
+    const LoginLayout = login_layout;
+    return (_jsx(LoginLayout, { image_src: imageSrc, image_alt: imageAlt, image_background_color: imageBackgroundColor, data_client: dataClient, logger: logger, redirectRoute: redirectRoute, successMessage: successMessage, alreadyLoggedInMessage: alreadyLoggedInMessage, showLogoutButton: showLogoutButton, showReturnHomeButton: showReturnHomeButton, returnHomeButtonLabel: returnHomeButtonLabel, returnHomePath: returnHomePath, forgot_password_path: forgotPasswordPath, forgot_password_label: forgotPasswordLabel, create_account_path: createAccountPath, create_account_label: createAccountLabel, urlOnLogon: urlOnLogon }));
+}
+export default LoginPage;

package/dist/page_components/my_settings.d.ts

@@ -0,0 +1,64 @@
+import type { PasswordRequirementOptions } from "../components/layouts/shared/config/layout_customization";
+declare const DEFAULT_MESSAGES: {
+    photo_upload_disabled_message: string;
+    gravatar_setup_message: string;
+    gravatar_no_account_message: string;
+    library_tooltip_message: string;
+};
+declare const DEFAULT_UI_SIZES: {
+    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;
+};
+export type MySettingsPageProps = {
+    userFields?: {
+        show_name_field?: boolean;
+        show_email_field?: boolean;
+        show_password_field?: boolean;
+    };
+    passwordRequirements?: Partial<PasswordRequirementOptions>;
+    profilePicture?: {
+        allow_photo_upload?: boolean;
+        upload_photo_path?: string;
+        max_photo_size?: number;
+        user_photo_default?: boolean;
+        user_photo_default_priority1?: "gravatar" | "library";
+        user_photo_default_priority2?: "library" | "gravatar";
+        library_photo_path?: string;
+    };
+    heading?: string;
+    subHeading?: string;
+    profilePhotoLabel?: string;
+    profilePhotoRecommendation?: string;
+    uploadPhotoButtonLabel?: string;
+    removePhotoButtonLabel?: string;
+    profileInformationLabel?: string;
+    passwordLabel?: string;
+    currentPasswordLabel?: string;
+    newPasswordLabel?: string;
+    confirmPasswordLabel?: string;
+    savePasswordButtonLabel?: string;
+    unauthorizedMessage?: string;
+    loginButtonLabel?: string;
+    loginPath?: string;
+    messages?: Partial<typeof DEFAULT_MESSAGES>;
+    uiSizes?: Partial<typeof DEFAULT_UI_SIZES>;
+    fileTypes?: {
+        allowed_image_extensions?: string[];
+        allowed_image_mime_types?: string[];
+    };
+};
+/**
+ * Zero-config my settings page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns My settings page component
+ */
+export declare function MySettingsPage({ userFields, passwordRequirements, profilePicture, heading, subHeading, profilePhotoLabel, profilePhotoRecommendation, uploadPhotoButtonLabel, removePhotoButtonLabel, profileInformationLabel, passwordLabel, currentPasswordLabel, newPasswordLabel, confirmPasswordLabel, savePasswordButtonLabel, unauthorizedMessage, loginButtonLabel, loginPath, messages, uiSizes, fileTypes, }?: MySettingsPageProps): import("react/jsx-runtime").JSX.Element;
+export default MySettingsPage;
+//# sourceMappingURL=my_settings.d.ts.map

package/dist/page_components/my_settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"my_settings.d.ts","sourceRoot":"","sources":["../../src/page_components/my_settings.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0DAA0D,CAAC;AA2B3G,QAAA,MAAM,gBAAgB;;;;;CAKrB,CAAC;AAEF,QAAA,MAAM,gBAAgB;;;;;;;;;CASrB,CAAC;AAQF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE;QACX,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF,oBAAoB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE;QACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,4BAA4B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QACtD,4BAA4B,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;QACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE;QACV,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;QACpC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;KACrC,CAAC;CACH,CAAC;AAGF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,OAA4B,EAC5B,UAAoE,EACpE,iBAAmC,EACnC,0BAAiF,EACjF,sBAAuC,EACvC,sBAAiC,EACjC,uBAA+C,EAC/C,aAA0B,EAC1B,oBAAyC,EACzC,gBAAiC,EACjC,oBAAyC,EACzC,uBAA2C,EAC3C,mBAAkE,EAClE,gBAAgC,EAChC,SAA8B,EAC9B,QAAQ,EACR,OAAO,EACP,SAAS,GACV,GAAE,mBAAwB,2CA0D1B;AAED,eAAe,cAAc,CAAC"}

package/dist/page_components/my_settings.js

@@ -0,0 +1,67 @@
+// file_description: zero-config my settings page component for hazo_auth
+// Consumers can use this directly without needing to configure props
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+// section: imports
+import my_settings_layout from "../components/layouts/my_settings";
+// section: default_configuration
+const DEFAULT_USER_FIELDS = {
+    show_name_field: true,
+    show_email_field: true,
+    show_password_field: true,
+};
+const DEFAULT_PASSWORD_REQUIREMENTS = {
+    minimum_length: 8,
+    require_uppercase: true,
+    require_lowercase: true,
+    require_number: true,
+    require_special: false,
+};
+const DEFAULT_PROFILE_PICTURE = {
+    allow_photo_upload: true,
+    upload_photo_path: "/api/hazo_auth/upload_profile_picture",
+    max_photo_size: 5242880, // 5MB
+    user_photo_default: true,
+    user_photo_default_priority1: "gravatar",
+    user_photo_default_priority2: "library",
+    library_photo_path: "/profile_pictures/library",
+};
+const DEFAULT_MESSAGES = {
+    photo_upload_disabled_message: "Photo upload is currently disabled. Contact your administrator.",
+    gravatar_setup_message: "To use Gravatar, create a free account at gravatar.com with the same email address you use here.",
+    gravatar_no_account_message: "No Gravatar account found for your email. Using library photo instead.",
+    library_tooltip_message: "Choose from our library of profile pictures",
+};
+const DEFAULT_UI_SIZES = {
+    gravatar_size: 200,
+    profile_picture_size: 128,
+    tooltip_icon_size_default: 16,
+    tooltip_icon_size_small: 14,
+    library_photo_grid_columns: 4,
+    library_photo_preview_size: 80,
+    image_compression_max_dimension: 800,
+    upload_file_hard_limit_bytes: 10485760, // 10MB
+};
+const DEFAULT_FILE_TYPES = {
+    allowed_image_extensions: [".jpg", ".jpeg", ".png", ".gif", ".webp"],
+    allowed_image_mime_types: ["image/jpeg", "image/png", "image/gif", "image/webp"],
+};
+// section: component
+/**
+ * Zero-config my settings page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns My settings page component
+ */
+export function MySettingsPage({ userFields, passwordRequirements, profilePicture, heading = "Account Settings", subHeading = "Manage your profile, password, and email preferences.", profilePhotoLabel = "Profile Photo", profilePhotoRecommendation = "Recommended: Square image, at least 200x200 pixels", uploadPhotoButtonLabel = "Upload Photo", removePhotoButtonLabel = "Remove", profileInformationLabel = "Profile Information", passwordLabel = "Password", currentPasswordLabel = "Current Password", newPasswordLabel = "New Password", confirmPasswordLabel = "Confirm Password", savePasswordButtonLabel = "Update Password", unauthorizedMessage = "You must be logged in to access this page.", loginButtonLabel = "Go to login", loginPath = "/hazo_auth/login", messages, uiSizes, fileTypes, } = {}) {
+    // Merge provided props with defaults
+    const mergedUserFields = Object.assign(Object.assign({}, DEFAULT_USER_FIELDS), userFields);
+    const mergedPasswordRequirements = Object.assign(Object.assign({}, DEFAULT_PASSWORD_REQUIREMENTS), passwordRequirements);
+    const mergedProfilePicture = Object.assign(Object.assign({}, DEFAULT_PROFILE_PICTURE), profilePicture);
+    const mergedMessages = Object.assign(Object.assign({}, DEFAULT_MESSAGES), messages);
+    const mergedUiSizes = Object.assign(Object.assign({}, DEFAULT_UI_SIZES), uiSizes);
+    const mergedFileTypes = Object.assign(Object.assign({}, DEFAULT_FILE_TYPES), fileTypes);
+    const MySettingsLayout = my_settings_layout;
+    return (_jsx(MySettingsLayout, { userFields: mergedUserFields, password_requirements: mergedPasswordRequirements, profilePicture: mergedProfilePicture, heading: heading, subHeading: subHeading, profilePhotoLabel: profilePhotoLabel, profilePhotoRecommendation: profilePhotoRecommendation, uploadPhotoButtonLabel: uploadPhotoButtonLabel, removePhotoButtonLabel: removePhotoButtonLabel, profileInformationLabel: profileInformationLabel, passwordLabel: passwordLabel, currentPasswordLabel: currentPasswordLabel, newPasswordLabel: newPasswordLabel, confirmPasswordLabel: confirmPasswordLabel, unauthorizedMessage: unauthorizedMessage, loginButtonLabel: loginButtonLabel, loginPath: loginPath, messages: mergedMessages, uiSizes: mergedUiSizes, fileTypes: mergedFileTypes }));
+}
+export default MySettingsPage;

package/dist/page_components/register.d.ts

@@ -0,0 +1,25 @@
+import type { PasswordRequirementOverrides } from "../components/layouts/shared/config/layout_customization";
+export type RegisterPageProps = {
+    showNameField?: boolean;
+    passwordRequirements?: PasswordRequirementOverrides;
+    alreadyLoggedInMessage?: string;
+    showLogoutButton?: boolean;
+    showReturnHomeButton?: boolean;
+    returnHomeButtonLabel?: string;
+    returnHomePath?: string;
+    signInPath?: string;
+    signInLabel?: string;
+    urlOnLogon?: string;
+    imageSrc?: string;
+    imageAlt?: string;
+    imageBackgroundColor?: string;
+};
+/**
+ * Zero-config register page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns Register page component
+ */
+export declare function RegisterPage({ showNameField, passwordRequirements, alreadyLoggedInMessage, showLogoutButton, showReturnHomeButton, returnHomeButtonLabel, returnHomePath, signInPath, signInLabel, urlOnLogon, imageSrc, imageAlt, imageBackgroundColor, }?: RegisterPageProps): import("react/jsx-runtime").JSX.Element;
+export default RegisterPage;
+//# sourceMappingURL=register.d.ts.map

package/dist/page_components/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/page_components/register.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0DAA0D,CAAC;AAgB7G,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,4BAA4B,CAAC;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAGF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,aAAoB,EACpB,oBAAoD,EACpD,sBAAoD,EACpD,gBAAuB,EACvB,oBAA4B,EAC5B,qBAAqC,EACrC,cAAoB,EACpB,UAA+B,EAC/B,WAAuB,EACvB,UAAU,EACV,QAA4B,EAC5B,QAA4B,EAC5B,oBAAuC,GACxC,GAAE,iBAAsB,2CAwCxB;AAED,eAAe,YAAY,CAAC"}

package/dist/page_components/register.js

@@ -0,0 +1,43 @@
+// file_description: zero-config register page component for hazo_auth
+// Consumers can use this directly without needing to configure props
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+// section: imports
+import { useEffect, useState } from "react";
+import register_layout from "../components/layouts/register";
+import { createLayoutDataClient } from "../components/layouts/shared/data/layout_data_client";
+import { create_sqlite_hazo_connect } from "../lib/hazo_connect_setup";
+// section: constants
+const DEFAULT_IMAGE_SRC = "/globe.svg";
+const DEFAULT_IMAGE_ALT = "Illustration of a globe representing secure authentication workflows";
+const DEFAULT_IMAGE_BG = "#e2e8f0";
+const DEFAULT_PASSWORD_REQUIREMENTS = {
+    minimum_length: 8,
+    require_uppercase: true,
+    require_lowercase: true,
+    require_number: true,
+    require_special: false,
+};
+// section: component
+/**
+ * Zero-config register page component
+ * Uses sensible defaults and can be customized via props
+ * @param props - Optional configuration overrides
+ * @returns Register page component
+ */
+export function RegisterPage({ showNameField = true, passwordRequirements = DEFAULT_PASSWORD_REQUIREMENTS, alreadyLoggedInMessage = "You are already logged in", showLogoutButton = true, showReturnHomeButton = false, returnHomeButtonLabel = "Return home", returnHomePath = "/", signInPath = "/hazo_auth/login", signInLabel = "Sign in", urlOnLogon, imageSrc = DEFAULT_IMAGE_SRC, imageAlt = DEFAULT_IMAGE_ALT, imageBackgroundColor = DEFAULT_IMAGE_BG, } = {}) {
+    const [dataClient, setDataClient] = useState(null);
+    useEffect(() => {
+        // Initialize hazo_connect on client side
+        const hazoConnect = create_sqlite_hazo_connect();
+        const client = createLayoutDataClient(hazoConnect);
+        setDataClient(client);
+    }, []);
+    // Show loading state while initializing
+    if (!dataClient) {
+        return (_jsx("div", { className: "cls_register_page_loading flex items-center justify-center min-h-screen", children: _jsx("div", { className: "text-slate-600 animate-pulse", children: "Loading..." }) }));
+    }
+    const RegisterLayout = register_layout;
+    return (_jsx(RegisterLayout, { image_src: imageSrc, image_alt: imageAlt, image_background_color: imageBackgroundColor, password_requirements: passwordRequirements, show_name_field: showNameField, data_client: dataClient, alreadyLoggedInMessage: alreadyLoggedInMessage, showLogoutButton: showLogoutButton, showReturnHomeButton: showReturnHomeButton, returnHomeButtonLabel: returnHomeButtonLabel, returnHomePath: returnHomePath, signInPath: signInPath, signInLabel: signInLabel, urlOnLogon: urlOnLogon }));
+}
+export default RegisterPage;