npm - hazo_auth - Versions diffs - 0.1.0 - Mend

hazo_auth 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (162) hide show

package/LICENSE +21 -0
package/README.md +48 -0
package/components.json +22 -0
package/hazo_auth_config.example.ini +414 -0
package/hazo_notify_config.example.ini +159 -0
package/instrumentation.ts +32 -0
package/migrations/001_add_token_type_to_refresh_tokens.sql +14 -0
package/migrations/002_add_name_to_hazo_users.sql +7 -0
package/next.config.mjs +55 -0
package/package.json +114 -0
package/postcss.config.mjs +8 -0
package/public/file.svg +1 -0
package/public/globe.svg +1 -0
package/public/next.svg +1 -0
package/public/vercel.svg +1 -0
package/public/window.svg +1 -0
package/scripts/apply_migration.ts +118 -0
package/src/app/api/auth/change_password/route.ts +109 -0
package/src/app/api/auth/forgot_password/route.ts +107 -0
package/src/app/api/auth/library_photos/route.ts +70 -0
package/src/app/api/auth/login/route.ts +155 -0
package/src/app/api/auth/logout/route.ts +62 -0
package/src/app/api/auth/me/route.ts +47 -0
package/src/app/api/auth/profile_picture/[filename]/route.ts +67 -0
package/src/app/api/auth/register/route.ts +106 -0
package/src/app/api/auth/remove_profile_picture/route.ts +86 -0
package/src/app/api/auth/resend_verification/route.ts +107 -0
package/src/app/api/auth/reset_password/route.ts +107 -0
package/src/app/api/auth/update_user/route.ts +126 -0
package/src/app/api/auth/upload_profile_picture/route.ts +268 -0
package/src/app/api/auth/validate_reset_token/route.ts +80 -0
package/src/app/api/auth/verify_email/route.ts +85 -0
package/src/app/api/migrations/apply/route.ts +91 -0
package/src/app/favicon.ico +0 -0
package/src/app/fonts/GeistMonoVF.woff +0 -0
package/src/app/fonts/GeistVF.woff +0 -0
package/src/app/forgot_password/forgot_password_page_client.tsx +60 -0
package/src/app/forgot_password/page.tsx +24 -0
package/src/app/globals.css +89 -0
package/src/app/hazo_connect/api/sqlite/data/route.ts +197 -0
package/src/app/hazo_connect/api/sqlite/schema/route.ts +35 -0
package/src/app/hazo_connect/api/sqlite/tables/route.ts +26 -0
package/src/app/hazo_connect/sqlite_admin/page.tsx +51 -0
package/src/app/hazo_connect/sqlite_admin/sqlite-admin-client.tsx +947 -0
package/src/app/layout.tsx +43 -0
package/src/app/login/login_page_client.tsx +71 -0
package/src/app/login/page.tsx +26 -0
package/src/app/my_settings/my_settings_page_client.tsx +120 -0
package/src/app/my_settings/page.tsx +40 -0
package/src/app/page.tsx +170 -0
package/src/app/register/page.tsx +26 -0
package/src/app/register/register_page_client.tsx +72 -0
package/src/app/reset_password/page.tsx +29 -0
package/src/app/reset_password/reset_password_page_client.tsx +81 -0
package/src/app/verify_email/page.tsx +24 -0
package/src/app/verify_email/verify_email_page_client.tsx +60 -0
package/src/components/layouts/email_verification/config/email_verification_field_config.ts +86 -0
package/src/components/layouts/email_verification/hooks/use_email_verification.ts +291 -0
package/src/components/layouts/email_verification/index.tsx +297 -0
package/src/components/layouts/forgot_password/config/forgot_password_field_config.ts +58 -0
package/src/components/layouts/forgot_password/hooks/use_forgot_password_form.ts +179 -0
package/src/components/layouts/forgot_password/index.tsx +168 -0
package/src/components/layouts/login/config/login_field_config.ts +67 -0
package/src/components/layouts/login/hooks/use_login_form.ts +281 -0
package/src/components/layouts/login/index.tsx +224 -0
package/src/components/layouts/my_settings/components/editable_field.tsx +177 -0
package/src/components/layouts/my_settings/components/password_change_dialog.tsx +301 -0
package/src/components/layouts/my_settings/components/profile_picture_dialog.tsx +385 -0
package/src/components/layouts/my_settings/components/profile_picture_display.tsx +66 -0
package/src/components/layouts/my_settings/components/profile_picture_gravatar_tab.tsx +143 -0
package/src/components/layouts/my_settings/components/profile_picture_library_tab.tsx +282 -0
package/src/components/layouts/my_settings/components/profile_picture_upload_tab.tsx +341 -0
package/src/components/layouts/my_settings/config/my_settings_field_config.ts +61 -0
package/src/components/layouts/my_settings/hooks/use_my_settings.ts +458 -0
package/src/components/layouts/my_settings/index.tsx +351 -0
package/src/components/layouts/register/config/register_field_config.ts +101 -0
package/src/components/layouts/register/hooks/use_register_form.ts +272 -0
package/src/components/layouts/register/index.tsx +208 -0
package/src/components/layouts/reset_password/config/reset_password_field_config.ts +86 -0
package/src/components/layouts/reset_password/hooks/use_reset_password_form.ts +276 -0
package/src/components/layouts/reset_password/index.tsx +294 -0
package/src/components/layouts/shared/components/already_logged_in_guard.tsx +95 -0
package/src/components/layouts/shared/components/field_error_message.tsx +29 -0
package/src/components/layouts/shared/components/form_action_buttons.tsx +64 -0
package/src/components/layouts/shared/components/form_field_wrapper.tsx +44 -0
package/src/components/layouts/shared/components/form_header.tsx +36 -0
package/src/components/layouts/shared/components/logout_button.tsx +76 -0
package/src/components/layouts/shared/components/password_field.tsx +72 -0
package/src/components/layouts/shared/components/sidebar_layout_wrapper.tsx +264 -0
package/src/components/layouts/shared/components/two_column_auth_layout.tsx +44 -0
package/src/components/layouts/shared/components/unauthorized_guard.tsx +78 -0
package/src/components/layouts/shared/components/visual_panel.tsx +41 -0
package/src/components/layouts/shared/config/layout_customization.ts +95 -0
package/src/components/layouts/shared/data/layout_data_client.ts +19 -0
package/src/components/layouts/shared/hooks/use_auth_status.ts +103 -0
package/src/components/layouts/shared/utils/ip_address.ts +37 -0
package/src/components/layouts/shared/utils/validation.ts +66 -0
package/src/components/ui/avatar.tsx +50 -0
package/src/components/ui/button.tsx +57 -0
package/src/components/ui/dialog.tsx +122 -0
package/src/components/ui/hazo_ui_tooltip.tsx +67 -0
package/src/components/ui/input.tsx +22 -0
package/src/components/ui/label.tsx +26 -0
package/src/components/ui/separator.tsx +31 -0
package/src/components/ui/sheet.tsx +139 -0
package/src/components/ui/sidebar.tsx +773 -0
package/src/components/ui/skeleton.tsx +15 -0
package/src/components/ui/sonner.tsx +31 -0
package/src/components/ui/switch.tsx +29 -0
package/src/components/ui/tabs.tsx +55 -0
package/src/components/ui/tooltip.tsx +32 -0
package/src/components/ui/vertical-tabs.tsx +59 -0
package/src/hooks/use-mobile.tsx +19 -0
package/src/lib/already_logged_in_config.server.ts +46 -0
package/src/lib/app_logger.ts +24 -0
package/src/lib/auth/auth_utils.server.ts +196 -0
package/src/lib/auth/server_auth.ts +88 -0
package/src/lib/config/config_loader.server.ts +149 -0
package/src/lib/email_verification_config.server.ts +32 -0
package/src/lib/file_types_config.server.ts +25 -0
package/src/lib/forgot_password_config.server.ts +32 -0
package/src/lib/hazo_connect_instance.server.ts +77 -0
package/src/lib/hazo_connect_setup.server.ts +181 -0
package/src/lib/hazo_connect_setup.ts +54 -0
package/src/lib/login_config.server.ts +46 -0
package/src/lib/messages_config.server.ts +45 -0
package/src/lib/migrations/apply_migration.ts +105 -0
package/src/lib/my_settings_config.server.ts +135 -0
package/src/lib/password_requirements_config.server.ts +39 -0
package/src/lib/profile_picture_config.server.ts +56 -0
package/src/lib/register_config.server.ts +57 -0
package/src/lib/reset_password_config.server.ts +75 -0
package/src/lib/services/email_service.ts +581 -0
package/src/lib/services/email_verification_service.ts +264 -0
package/src/lib/services/login_service.ts +118 -0
package/src/lib/services/password_change_service.ts +154 -0
package/src/lib/services/password_reset_service.ts +405 -0
package/src/lib/services/profile_picture_remove_service.ts +120 -0
package/src/lib/services/profile_picture_service.ts +215 -0
package/src/lib/services/profile_picture_source_mapper.ts +62 -0
package/src/lib/services/registration_service.ts +163 -0
package/src/lib/services/token_service.ts +240 -0
package/src/lib/services/user_update_service.ts +128 -0
package/src/lib/ui_sizes_config.server.ts +37 -0
package/src/lib/user_fields_config.server.ts +31 -0
package/src/lib/utils/api_route_helpers.ts +60 -0
package/src/lib/utils.ts +11 -0
package/src/middleware.ts +91 -0
package/src/server/config/config_loader.ts +496 -0
package/src/server/index.ts +38 -0
package/src/server/logging/logger_service.ts +56 -0
package/src/server/routes/root_router.ts +16 -0
package/src/server/server.ts +28 -0
package/src/server/types/app_types.ts +74 -0
package/src/server/types/express.d.ts +15 -0
package/src/stories/email_verification_layout.stories.tsx +137 -0
package/src/stories/forgot_password_layout.stories.tsx +85 -0
package/src/stories/login_layout.stories.tsx +85 -0
package/src/stories/project_overview.stories.tsx +33 -0
package/src/stories/register_layout.stories.tsx +107 -0
package/tailwind.config.ts +77 -0
package/tsconfig.json +27 -0

package/src/app/layout.tsx ADDED Viewed

@@ -0,0 +1,43 @@
+// file_description: define the root layout wrapper for the ui_component project
+import type { Metadata } from "next";
+import local_font from "next/font/local";
+import { Toaster } from "@/components/ui/sonner";
+import "./globals.css";
+// section: typography_setup
+const geist_sans = local_font({
+  src: "./fonts/GeistVF.woff",
+  variable: "--font-geist-sans",
+  weight: "100 900",
+});
+const geist_mono = local_font({
+  src: "./fonts/GeistMonoVF.woff",
+  variable: "--font-geist-mono",
+  weight: "100 900",
+});
+// section: metadata_definition
+export const metadata: Metadata = {
+  title: "hazo reusable ui components",
+  description:
+    "Storybook-ready Next.js workspace for building reusable components powered by shadcn.",
+};
+// section: root_layout_component
+export default function root_layout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body
+        className={`${geist_sans.variable} ${geist_mono.variable} antialiased`}
+      >
+        {children}
+        <Toaster />
+      </body>
+    </html>
+  );
+}

package/src/app/login/login_page_client.tsx ADDED Viewed

@@ -0,0 +1,71 @@
+// file_description: client component for login page that initializes hazo_connect and renders login layout
+// section: client_directive
+"use client";
+// 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";
+import type { LayoutDataClient } from "@/components/layouts/shared/data/layout_data_client";
+// section: types
+type LoginPageClientProps = {
+  redirectRoute?: string;
+  successMessage?: string;
+  alreadyLoggedInMessage?: string;
+  showLogoutButton?: boolean;
+  showReturnHomeButton?: boolean;
+  returnHomeButtonLabel?: string;
+  returnHomePath?: string;
+};
+// section: component
+export function LoginPageClient({
+  redirectRoute,
+  successMessage,
+  alreadyLoggedInMessage,
+  showLogoutButton,
+  showReturnHomeButton,
+  returnHomeButtonLabel,
+  returnHomePath,
+}: LoginPageClientProps) {
+  const [dataClient, setDataClient] = useState<LayoutDataClient<unknown> | null>(null);
+  const [logger, setLogger] = useState<ReturnType<typeof create_app_logger> | null>(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 <div className="cls_login_page_loading text-slate-600">Loading...</div>;
+  }
+  const LoginLayout = login_layout;
+  return (
+    <LoginLayout
+      image_src="/globe.svg"
+      image_alt="Illustration of a globe representing secure authentication workflows"
+      image_background_color="#e2e8f0"
+      data_client={dataClient}
+      logger={logger}
+      redirectRoute={redirectRoute}
+      successMessage={successMessage}
+      alreadyLoggedInMessage={alreadyLoggedInMessage}
+      showLogoutButton={showLogoutButton}
+      showReturnHomeButton={showReturnHomeButton}
+      returnHomeButtonLabel={returnHomeButtonLabel}
+      returnHomePath={returnHomePath}
+    />
+  );
+}

package/src/app/login/page.tsx ADDED Viewed

@@ -0,0 +1,26 @@
+// file_description: render the login page shell and mount the login layout component within sidebar
+// section: imports
+import { SidebarLayoutWrapper } from "@/components/layouts/shared/components/sidebar_layout_wrapper";
+import { LoginPageClient } from "./login_page_client";
+import { get_login_config } from "@/lib/login_config.server";
+// section: component
+export default function login_page() {
+  // Read login configuration from hazo_auth_config.ini (server-side)
+  const loginConfig = get_login_config();
+  return (
+    <SidebarLayoutWrapper>
+      <LoginPageClient
+        redirectRoute={loginConfig.redirectRoute}
+        successMessage={loginConfig.successMessage}
+        alreadyLoggedInMessage={loginConfig.alreadyLoggedInMessage}
+        showLogoutButton={loginConfig.showLogoutButton}
+        showReturnHomeButton={loginConfig.showReturnHomeButton}
+        returnHomeButtonLabel={loginConfig.returnHomeButtonLabel}
+        returnHomePath={loginConfig.returnHomePath}
+      />
+    </SidebarLayoutWrapper>
+  );
+}

package/src/app/my_settings/my_settings_page_client.tsx ADDED Viewed

@@ -0,0 +1,120 @@
+// file_description: client component for my settings page that initializes hazo_connect and renders my settings layout
+// section: client_directive
+"use client";
+// section: imports
+import { useEffect, useState } from "react";
+import my_settings_layout from "@/components/layouts/my_settings";
+import type { LayoutDataClient } from "@/components/layouts/shared/data/layout_data_client";
+import type { PasswordRequirementOptions } from "@/components/layouts/shared/config/layout_customization";
+// section: types
+type MySettingsPageClientProps = {
+  userFields: {
+    show_name_field: boolean;
+    show_email_field: boolean;
+    show_password_field: boolean;
+  };
+  passwordRequirements: 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: {
+    photo_upload_disabled_message: string;
+    gravatar_setup_message: string;
+    gravatar_no_account_message: string;
+    library_tooltip_message: string;
+  };
+  uiSizes: {
+    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;
+  };
+  fileTypes: {
+    allowed_image_extensions: string[];
+    allowed_image_mime_types: string[];
+  };
+};
+// section: component
+export function MySettingsPageClient({
+  userFields,
+  passwordRequirements,
+  profilePicture,
+  heading,
+  subHeading,
+  profilePhotoLabel,
+  profilePhotoRecommendation,
+  uploadPhotoButtonLabel,
+  removePhotoButtonLabel,
+  profileInformationLabel,
+  passwordLabel,
+  currentPasswordLabel,
+  newPasswordLabel,
+  confirmPasswordLabel,
+  savePasswordButtonLabel,
+  unauthorizedMessage,
+  loginButtonLabel,
+  loginPath,
+  messages,
+  uiSizes,
+  fileTypes,
+}: MySettingsPageClientProps) {
+  // Note: hazo_connect is not needed for this component as it's a self-service feature
+  // All data is fetched via API routes using cookies for authentication
+  // The layout component uses use_auth_status hook which calls /api/auth/me
+  const MySettingsLayout = my_settings_layout;
+  return (
+    <MySettingsLayout
+      userFields={userFields}
+      password_requirements={passwordRequirements}
+      profilePicture={profilePicture}
+      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={messages}
+      uiSizes={uiSizes}
+      fileTypes={fileTypes}
+    />
+  );
+}

package/src/app/my_settings/page.tsx ADDED Viewed

@@ -0,0 +1,40 @@
+// file_description: render the my settings page shell and mount the my settings layout component within sidebar
+// section: imports
+import { SidebarLayoutWrapper } from "@/components/layouts/shared/components/sidebar_layout_wrapper";
+import { MySettingsPageClient } from "./my_settings_page_client";
+import { get_my_settings_config } from "@/lib/my_settings_config.server";
+// section: component
+export default function my_settings_page() {
+  // Read my settings configuration from hazo_auth_config.ini (server-side)
+  const mySettingsConfig = get_my_settings_config();
+  return (
+    <SidebarLayoutWrapper>
+      <MySettingsPageClient
+        userFields={mySettingsConfig.userFields}
+        passwordRequirements={mySettingsConfig.passwordRequirements}
+        profilePicture={mySettingsConfig.profilePicture}
+        heading={mySettingsConfig.heading}
+        subHeading={mySettingsConfig.subHeading}
+        profilePhotoLabel={mySettingsConfig.profilePhotoLabel}
+        profilePhotoRecommendation={mySettingsConfig.profilePhotoRecommendation}
+        uploadPhotoButtonLabel={mySettingsConfig.uploadPhotoButtonLabel}
+        removePhotoButtonLabel={mySettingsConfig.removePhotoButtonLabel}
+        profileInformationLabel={mySettingsConfig.profileInformationLabel}
+        passwordLabel={mySettingsConfig.passwordLabel}
+        currentPasswordLabel={mySettingsConfig.currentPasswordLabel}
+        newPasswordLabel={mySettingsConfig.newPasswordLabel}
+        confirmPasswordLabel={mySettingsConfig.confirmPasswordLabel}
+        savePasswordButtonLabel={mySettingsConfig.savePasswordButtonLabel}
+        unauthorizedMessage={mySettingsConfig.unauthorizedMessage}
+        loginButtonLabel={mySettingsConfig.loginButtonLabel}
+        loginPath={mySettingsConfig.loginPath}
+        messages={mySettingsConfig.messages}
+        uiSizes={mySettingsConfig.uiSizes}
+        fileTypes={mySettingsConfig.fileTypes}
+      />
+    </SidebarLayoutWrapper>
+  );
+}

package/src/app/page.tsx ADDED Viewed

@@ -0,0 +1,170 @@
+// file_description: render the default landing page with sidebar navigation to test components
+// section: client_directive
+"use client";
+// section: imports
+import Link from "next/link";
+import {
+  Sidebar,
+  SidebarContent,
+  SidebarGroup,
+  SidebarGroupLabel,
+  SidebarHeader,
+  SidebarMenu,
+  SidebarMenuButton,
+  SidebarMenuItem,
+  SidebarProvider,
+  SidebarTrigger,
+  SidebarInset,
+} from "@/components/ui/sidebar";
+import { LogIn, UserPlus, BookOpen, ExternalLink, Database, KeyRound, MailCheck } from "lucide-react";
+// section: page_component
+export default function home_page() {
+  return (
+    <SidebarProvider>
+      <div className="cls_home_wrapper flex min-h-screen w-full">
+        <Sidebar>
+          <SidebarHeader className="cls_home_sidebar_header">
+            <div className="cls_home_sidebar_title flex items-center gap-2 px-2 py-4">
+              <h1 className="cls_home_sidebar_title_text text-lg font-semibold text-sidebar-foreground">
+                hazo auth
+              </h1>
+            </div>
+          </SidebarHeader>
+          <SidebarContent className="cls_home_sidebar_content">
+            <SidebarGroup className="cls_home_sidebar_test_group">
+              <SidebarGroupLabel className="cls_home_sidebar_group_label">
+                Test components
+              </SidebarGroupLabel>
+              <SidebarMenu className="cls_home_sidebar_test_menu">
+                <SidebarMenuItem className="cls_home_sidebar_test_login_item">
+                  <SidebarMenuButton asChild>
+                    <Link
+                      href="/login"
+                      className="cls_home_sidebar_test_login_link flex items-center gap-2"
+                      aria-label="Test login layout component"
+                    >
+                      <LogIn className="h-4 w-4" aria-hidden="true" />
+                      <span>Test login</span>
+                    </Link>
+                  </SidebarMenuButton>
+                </SidebarMenuItem>
+                <SidebarMenuItem className="cls_home_sidebar_test_register_item">
+                  <SidebarMenuButton asChild>
+                    <Link
+                      href="/register"
+                      className="cls_home_sidebar_test_register_link flex items-center gap-2"
+                      aria-label="Test register layout component"
+                    >
+                      <UserPlus className="h-4 w-4" aria-hidden="true" />
+                      <span>Test register</span>
+                    </Link>
+                  </SidebarMenuButton>
+                </SidebarMenuItem>
+                <SidebarMenuItem className="cls_home_sidebar_test_forgot_password_item">
+                  <SidebarMenuButton asChild>
+                    <Link
+                      href="/forgot_password"
+                      className="cls_home_sidebar_test_forgot_password_link flex items-center gap-2"
+                      aria-label="Test forgot password layout component"
+                    >
+                      <KeyRound className="h-4 w-4" aria-hidden="true" />
+                      <span>Test forgot password</span>
+                    </Link>
+                  </SidebarMenuButton>
+                </SidebarMenuItem>
+                <SidebarMenuItem className="cls_home_sidebar_test_email_verification_item">
+                  <SidebarMenuButton asChild>
+                    <Link
+                      href="/verify_email"
+                      className="cls_home_sidebar_test_email_verification_link flex items-center gap-2"
+                      aria-label="Test email verification layout component"
+                    >
+                      <MailCheck className="h-4 w-4" aria-hidden="true" />
+                      <span>Test email verification</span>
+                    </Link>
+                  </SidebarMenuButton>
+                </SidebarMenuItem>
+                <SidebarMenuItem className="cls_home_sidebar_sqlite_admin_item">
+                  <SidebarMenuButton asChild>
+                    <Link
+                      href="/hazo_connect/sqlite_admin"
+                      className="cls_home_sidebar_sqlite_admin_link flex items-center gap-2"
+                      aria-label="Open SQLite admin UI to browse and edit database"
+                    >
+                      <Database className="h-4 w-4" aria-hidden="true" />
+                      <span>SQLite Admin</span>
+                    </Link>
+                  </SidebarMenuButton>
+                </SidebarMenuItem>
+              </SidebarMenu>
+            </SidebarGroup>
+            <SidebarGroup className="cls_home_sidebar_resources_group">
+              <SidebarGroupLabel className="cls_home_sidebar_group_label">
+                Resources
+              </SidebarGroupLabel>
+              <SidebarMenu className="cls_home_sidebar_resources_menu">
+                <SidebarMenuItem className="cls_home_sidebar_storybook_item">
+                  <SidebarMenuButton asChild>
+                    <a
+                      href="http://localhost:6006"
+                      target="_blank"
+                      rel="noopener noreferrer"
+                      className="cls_home_sidebar_storybook_link flex items-center gap-2"
+                      aria-label="Open Storybook preview for reusable components"
+                    >
+                      <BookOpen className="h-4 w-4" aria-hidden="true" />
+                      <span>Storybook</span>
+                      <ExternalLink className="ml-auto h-3 w-3" aria-hidden="true" />
+                    </a>
+                  </SidebarMenuButton>
+                </SidebarMenuItem>
+                <SidebarMenuItem className="cls_home_sidebar_docs_item">
+                  <SidebarMenuButton asChild>
+                    <a
+                      href="https://ui.shadcn.com/docs"
+                      target="_blank"
+                      rel="noopener noreferrer"
+                      className="cls_home_sidebar_docs_link flex items-center gap-2"
+                      aria-label="Review shadcn documentation for styling guidance"
+                    >
+                      <BookOpen className="h-4 w-4" aria-hidden="true" />
+                      <span>Shadcn docs</span>
+                      <ExternalLink className="ml-auto h-3 w-3" aria-hidden="true" />
+                    </a>
+                  </SidebarMenuButton>
+                </SidebarMenuItem>
+              </SidebarMenu>
+            </SidebarGroup>
+          </SidebarContent>
+        </Sidebar>
+        <SidebarInset className="cls_home_sidebar_inset">
+          <header className="cls_home_main_header flex h-16 shrink-0 items-center gap-2 border-b px-4">
+            <SidebarTrigger className="cls_home_sidebar_trigger" />
+            <div className="cls_home_main_header_content flex flex-1 items-center gap-2">
+              <h2 className="cls_home_main_title text-lg font-semibold text-foreground">
+                hazo reusable ui library workspace
+              </h2>
+            </div>
+          </header>
+          <main className="cls_home_main_content flex flex-1 flex-col items-center justify-center gap-6 p-8 text-center">
+            <div className="cls_home_welcome_content flex w-full max-w-3xl flex-col items-center justify-center gap-6">
+              <h1 className="cls_home_welcome_title text-3xl font-semibold tracking-tight text-foreground md:text-4xl">
+                Welcome to hazo auth
+              </h1>
+              <p className="cls_home_welcome_summary text-base leading-relaxed text-muted-foreground md:text-lg">
+                Start shaping accessible, shadcn-powered components with integrated
+                hazo_config and hazo_connect support. Storybook is pre-installed so
+                you can document and iterate on each piece with confidence.
+              </p>
+              <p className="cls_home_welcome_instruction text-sm text-muted-foreground">
+                Use the sidebar to navigate to test components or access resources.
+              </p>
+            </div>
+          </main>
+        </SidebarInset>
+      </div>
+    </SidebarProvider>
+  );
+}

package/src/app/register/page.tsx ADDED Viewed

@@ -0,0 +1,26 @@
+// file_description: render the register page shell and mount the register layout component within sidebar
+// section: imports
+import { SidebarLayoutWrapper } from "@/components/layouts/shared/components/sidebar_layout_wrapper";
+import { RegisterPageClient } from "./register_page_client";
+import { get_register_config } from "@/lib/register_config.server";
+// section: component
+export default function register_page() {
+  // Read register configuration from hazo_auth_config.ini (server-side)
+  const registerConfig = get_register_config();
+  return (
+    <SidebarLayoutWrapper>
+      <RegisterPageClient
+        showNameField={registerConfig.showNameField}
+        passwordRequirements={registerConfig.passwordRequirements}
+        alreadyLoggedInMessage={registerConfig.alreadyLoggedInMessage}
+        showLogoutButton={registerConfig.showLogoutButton}
+        showReturnHomeButton={registerConfig.showReturnHomeButton}
+        returnHomeButtonLabel={registerConfig.returnHomeButtonLabel}
+        returnHomePath={registerConfig.returnHomePath}
+      />
+    </SidebarLayoutWrapper>
+  );
+}

package/src/app/register/register_page_client.tsx ADDED Viewed

@@ -0,0 +1,72 @@
+// file_description: client component for register page that initializes hazo_connect and renders register layout
+// section: client_directive
+"use client";
+// 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";
+import type { LayoutDataClient } from "@/components/layouts/shared/data/layout_data_client";
+// section: types
+type RegisterPageClientProps = {
+  showNameField?: boolean;
+  passwordRequirements?: {
+    minimum_length: number;
+    require_uppercase: boolean;
+    require_lowercase: boolean;
+    require_number: boolean;
+    require_special: boolean;
+  };
+  alreadyLoggedInMessage?: string;
+  showLogoutButton?: boolean;
+  showReturnHomeButton?: boolean;
+  returnHomeButtonLabel?: string;
+  returnHomePath?: string;
+};
+// section: component
+export function RegisterPageClient({
+  showNameField,
+  passwordRequirements,
+  alreadyLoggedInMessage,
+  showLogoutButton,
+  showReturnHomeButton,
+  returnHomeButtonLabel,
+  returnHomePath,
+}: RegisterPageClientProps) {
+  const [dataClient, setDataClient] = useState<LayoutDataClient<unknown> | null>(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 <div className="cls_register_page_loading text-slate-600">Loading...</div>;
+  }
+  const RegisterLayout = register_layout;
+  return (
+    <RegisterLayout
+      image_src="/globe.svg"
+      image_alt="Illustration of a globe representing secure authentication workflows"
+      image_background_color="#e2e8f0"
+      password_requirements={passwordRequirements}
+      show_name_field={showNameField}
+      data_client={dataClient}
+      alreadyLoggedInMessage={alreadyLoggedInMessage}
+      showLogoutButton={showLogoutButton}
+      showReturnHomeButton={showReturnHomeButton}
+      returnHomeButtonLabel={returnHomeButtonLabel}
+      returnHomePath={returnHomePath}
+    />
+  );
+}

package/src/app/reset_password/page.tsx ADDED Viewed

@@ -0,0 +1,29 @@
+// file_description: render the reset password page shell and mount the reset password layout component within sidebar
+// section: imports
+import { SidebarLayoutWrapper } from "@/components/layouts/shared/components/sidebar_layout_wrapper";
+import { ResetPasswordPageClient } from "./reset_password_page_client";
+import { get_reset_password_config } from "@/lib/reset_password_config.server";
+// section: component
+export default function reset_password_page() {
+  // Read reset password configuration from hazo_auth_config.ini (server-side)
+  const resetPasswordConfig = get_reset_password_config();
+  return (
+    <SidebarLayoutWrapper>
+      <ResetPasswordPageClient
+        errorMessage={resetPasswordConfig.errorMessage}
+        successMessage={resetPasswordConfig.successMessage}
+        loginPath={resetPasswordConfig.loginPath}
+        forgotPasswordPath={resetPasswordConfig.forgotPasswordPath}
+        alreadyLoggedInMessage={resetPasswordConfig.alreadyLoggedInMessage}
+        showLogoutButton={resetPasswordConfig.showLogoutButton}
+        showReturnHomeButton={resetPasswordConfig.showReturnHomeButton}
+        returnHomeButtonLabel={resetPasswordConfig.returnHomeButtonLabel}
+        returnHomePath={resetPasswordConfig.returnHomePath}
+        passwordRequirements={resetPasswordConfig.passwordRequirements}
+      />
+    </SidebarLayoutWrapper>
+  );
+}