npm - hazo_auth - Versions diffs - 1.4.1 → 1.6.0 - Mend

hazo_auth 1.4.1 → 1.6.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 (478) hide show

package/src/app/layout.tsx DELETED Viewed

@@ -1,43 +0,0 @@
-// file_description: define the root layout wrapper for the hazo_auth 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/page.tsx DELETED Viewed

@@ -1,170 +0,0 @@
-// 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="/hazo_auth/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="/hazo_auth/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="/hazo_auth/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="/hazo_auth/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/components/index.ts DELETED Viewed

@@ -1,7 +0,0 @@
-// file_description: barrel export for all components (UI and layouts)
-// section: ui_exports
-export * from "./ui/index";
-// section: layout_exports
-export * from "./layouts/index";

package/src/components/layouts/email_verification/config/email_verification_field_config.ts DELETED Viewed

@@ -1,86 +0,0 @@
-// file_description: email verification layout specific configuration helpers
-// section: imports
-import type { LayoutFieldMap, LayoutFieldMapOverrides } from "hazo_auth/components/layouts/shared/config/layout_customization";
-import {
-  resolveButtonPalette,
-  resolveFieldDefinitions,
-  resolveLabels,
-  type ButtonPaletteDefaults,
-  type ButtonPaletteOverrides,
-  type LayoutLabelDefaults,
-  type LayoutLabelOverrides,
-} from "hazo_auth/components/layouts/shared/config/layout_customization";
-// section: field_identifiers
-export const EMAIL_VERIFICATION_FIELD_IDS = {
-  EMAIL: "email_address",
-} as const;
-export type EmailVerificationFieldId = (typeof EMAIL_VERIFICATION_FIELD_IDS)[keyof typeof EMAIL_VERIFICATION_FIELD_IDS];
-// section: field_definitions
-const EMAIL_VERIFICATION_FIELD_DEFINITIONS: LayoutFieldMap = {
-  [EMAIL_VERIFICATION_FIELD_IDS.EMAIL]: {
-    id: EMAIL_VERIFICATION_FIELD_IDS.EMAIL,
-    label: "Email address",
-    type: "email",
-    autoComplete: "email",
-    placeholder: "Enter your email address",
-    ariaLabel: "Email address input field",
-  },
-};
-export const createEmailVerificationFieldDefinitions = (
-  overrides?: LayoutFieldMapOverrides,
-) => resolveFieldDefinitions(EMAIL_VERIFICATION_FIELD_DEFINITIONS, overrides);
-// section: label_defaults
-const EMAIL_VERIFICATION_LABEL_DEFAULTS: LayoutLabelDefaults = {
-  heading: "Email verification",
-  subHeading: "Verifying your email address...",
-  submitButton: "Resend verification email",
-  cancelButton: "Cancel",
-};
-export const resolveEmailVerificationLabels = (overrides?: LayoutLabelOverrides) =>
-  resolveLabels(EMAIL_VERIFICATION_LABEL_DEFAULTS, overrides);
-// section: button_palette_defaults
-const EMAIL_VERIFICATION_BUTTON_PALETTE_DEFAULTS: ButtonPaletteDefaults = {
-  submitBackground: "#0f172a",
-  submitText: "#ffffff",
-  cancelBorder: "#cbd5f5",
-  cancelText: "#0f172a",
-};
-export const resolveEmailVerificationButtonPalette = (overrides?: ButtonPaletteOverrides) =>
-  resolveButtonPalette(EMAIL_VERIFICATION_BUTTON_PALETTE_DEFAULTS, overrides);
-// section: success_labels
-export type EmailVerificationSuccessLabels = {
-  heading: string;
-  message: string;
-  redirectMessage: string;
-  goToLoginButton: string;
-};
-export const EMAIL_VERIFICATION_SUCCESS_LABEL_DEFAULTS: EmailVerificationSuccessLabels = {
-  heading: "Email verified successfully",
-  message: "Your email address has been verified. You can now log in to your account.",
-  redirectMessage: "Redirecting to login page in",
-  goToLoginButton: "Go to login",
-};
-// section: error_labels
-export type EmailVerificationErrorLabels = {
-  heading: string;
-  message: string;
-  resendFormHeading: string;
-};
-export const EMAIL_VERIFICATION_ERROR_LABEL_DEFAULTS: EmailVerificationErrorLabels = {
-  heading: "Verification failed",
-  message: "The verification link is invalid or has expired.",
-  resendFormHeading: "Resend verification email",
-};

package/src/components/layouts/email_verification/hooks/use_email_verification.ts DELETED Viewed

@@ -1,297 +0,0 @@
-// file_description: encapsulate email verification state, validation, and data interactions
-// section: imports
-import { useCallback, useEffect, useMemo, useState } from "react";
-import { useRouter, useSearchParams } from "next/navigation";
-import { toast } from "sonner";
-import type { LayoutDataClient } from "hazo_auth/components/layouts/shared/data/layout_data_client";
-import { EMAIL_VERIFICATION_FIELD_IDS, type EmailVerificationFieldId } from "hazo_auth/components/layouts/email_verification/config/email_verification_field_config";
-import { validateEmail } from "hazo_auth/components/layouts/shared/utils/validation";
-// section: types
-export type EmailVerificationFormValues = Record<EmailVerificationFieldId, string>;
-export type EmailVerificationFormErrors = Partial<Record<EmailVerificationFieldId, string>> & {
-  submit?: string;
-};
-export type UseEmailVerificationParams<TClient = unknown> = {
-  dataClient: LayoutDataClient<TClient>;
-  redirectDelay?: number; // Delay in seconds before redirecting to login
-  loginPath?: string; // Path to redirect to after successful verification
-};
-export type UseEmailVerificationResult = {
-  isVerifying: boolean;
-  isVerified: boolean;
-  isError: boolean;
-  errorMessage?: string;
-  email?: string; // Email from token if available
-  values: EmailVerificationFormValues;
-  errors: EmailVerificationFormErrors;
-  isSubmitDisabled: boolean;
-  isSubmitting: boolean;
-  emailTouched: boolean;
-  redirectCountdown: number;
-  handleFieldChange: (fieldId: EmailVerificationFieldId, value: string) => void;
-  handleEmailBlur: () => void;
-  handleResendSubmit: (event: React.FormEvent<HTMLFormElement>) => void;
-  handleCancel: () => void;
-  handleGoToLogin: () => void;
-};
-// section: helpers
-const buildInitialValues = (initialEmail?: string): EmailVerificationFormValues => ({
-  [EMAIL_VERIFICATION_FIELD_IDS.EMAIL]: initialEmail || "",
-});
-// section: hook
-export const use_email_verification = <TClient,>({
-  dataClient,
-  redirectDelay = 5,
-  loginPath = "/hazo_auth/login",
-}: UseEmailVerificationParams<TClient>): UseEmailVerificationResult => {
-  const router = useRouter();
-  const searchParams = useSearchParams();
-  const token = searchParams.get("token");
-  const emailParam = searchParams.get("email");
-  const messageParam = searchParams.get("message");
-  const [isVerifying, setIsVerifying] = useState<boolean>(false);
-  const [isVerified, setIsVerified] = useState<boolean>(false);
-  const [isError, setIsError] = useState<boolean>(false);
-  const [errorMessage, setErrorMessage] = useState<string | undefined>(messageParam || undefined);
-  const [email, setEmail] = useState<string | undefined>(emailParam || undefined);
-  const [values, setValues] = useState<EmailVerificationFormValues>(buildInitialValues(emailParam || undefined));
-  const [errors, setErrors] = useState<EmailVerificationFormErrors>({});
-  const [emailTouched, setEmailTouched] = useState<boolean>(false);
-  const [isSubmitting, setIsSubmitting] = useState<boolean>(false);
-  const [redirectCountdown, setRedirectCountdown] = useState<number>(redirectDelay);
-  // Verify token on mount if token exists, or show error if message is provided
-  useEffect(() => {
-    // If message is provided (from login redirect), show error state immediately
-    if (messageParam && !token) {
-      setIsError(true);
-      setErrorMessage(messageParam);
-      if (emailParam) {
-        setEmail(emailParam);
-        setValues(buildInitialValues(emailParam));
-      }
-      return;
-    }
-    if (!token) {
-      setIsError(true);
-      setErrorMessage("No verification token provided");
-      return;
-    }
-    const verifyToken = async () => {
-      setIsVerifying(true);
-      setIsError(false);
-      setErrorMessage(undefined);
-      try {
-        const response = await fetch(`/api/hazo_auth/verify_email?token=${encodeURIComponent(token)}`, {
-          method: "GET",
-        });
-        const data = await response.json();
-        if (!response.ok) {
-          throw new Error(data.error || "Email verification failed");
-        }
-        // Success
-        setIsVerified(true);
-        setEmail(data.email);
-        setValues(buildInitialValues(data.email));
-        // Start countdown for redirect
-        let countdown = redirectDelay;
-        setRedirectCountdown(countdown);
-        const countdownInterval = setInterval(() => {
-          countdown -= 1;
-          setRedirectCountdown(countdown);
-          if (countdown <= 0) {
-            clearInterval(countdownInterval);
-            router.push(loginPath);
-          }
-        }, 1000);
-        // Cleanup interval on unmount
-        return () => clearInterval(countdownInterval);
-      } catch (error) {
-        const errorMessage =
-          error instanceof Error ? error.message : "Email verification failed. Please try again.";
-        setIsError(true);
-        setErrorMessage(errorMessage);
-        // Try to extract email from error response if available
-        try {
-          const response = await fetch(`/api/hazo_auth/verify_email?token=${encodeURIComponent(token)}`, {
-            method: "GET",
-          });
-          const data = await response.json();
-          if (data.email) {
-            setEmail(data.email);
-            setValues(buildInitialValues(data.email));
-          }
-        } catch {
-          // Ignore errors when trying to get email
-        }
-      } finally {
-        setIsVerifying(false);
-      }
-    };
-    void verifyToken();
-  }, [token, redirectDelay, loginPath, router]);
-  const isSubmitDisabled = useMemo(() => {
-    if (isSubmitting) {
-      return true;
-    }
-    // Only disable if there are active errors
-    const hasErrors = !!errors[EMAIL_VERIFICATION_FIELD_IDS.EMAIL];
-    return hasErrors;
-  }, [errors, isSubmitting]);
-  const handleFieldChange = useCallback((fieldId: EmailVerificationFieldId, value: string) => {
-    setValues((previousValues) => {
-      const nextValues: EmailVerificationFormValues = {
-        ...previousValues,
-        [fieldId]: value,
-      };
-      setErrors((previousErrors) => {
-        const updatedErrors: EmailVerificationFormErrors = { ...previousErrors };
-        // Only validate email on change if it has been touched (blurred)
-        if (fieldId === EMAIL_VERIFICATION_FIELD_IDS.EMAIL && emailTouched) {
-          const emailError = validateEmail(value);
-          if (emailError) {
-            updatedErrors[EMAIL_VERIFICATION_FIELD_IDS.EMAIL] = emailError;
-          } else {
-            delete updatedErrors[EMAIL_VERIFICATION_FIELD_IDS.EMAIL];
-          }
-        }
-        return updatedErrors;
-      });
-      return nextValues;
-    });
-  }, [emailTouched]);
-  const handleEmailBlur = useCallback(() => {
-    setEmailTouched(true);
-    // Validate email on blur
-    setErrors((previousErrors) => {
-      const updatedErrors: EmailVerificationFormErrors = { ...previousErrors };
-      const emailValue = values[EMAIL_VERIFICATION_FIELD_IDS.EMAIL];
-      const emailError = validateEmail(emailValue);
-      if (emailError) {
-        updatedErrors[EMAIL_VERIFICATION_FIELD_IDS.EMAIL] = emailError;
-      } else {
-        delete updatedErrors[EMAIL_VERIFICATION_FIELD_IDS.EMAIL];
-      }
-      return updatedErrors;
-    });
-  }, [values]);
-  const handleResendSubmit = useCallback(
-    async (event: React.FormEvent<HTMLFormElement>) => {
-      event.preventDefault();
-      // Final validation
-      const emailError = validateEmail(values[EMAIL_VERIFICATION_FIELD_IDS.EMAIL]);
-      if (emailError) {
-        setErrors({
-          [EMAIL_VERIFICATION_FIELD_IDS.EMAIL]: emailError,
-        });
-        return;
-      }
-      setIsSubmitting(true);
-      setErrors({});
-      try {
-        const response = await fetch("/api/hazo_auth/resend_verification", {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-          },
-          body: JSON.stringify({
-            email: values[EMAIL_VERIFICATION_FIELD_IDS.EMAIL],
-          }),
-        });
-        let data;
-        try {
-          data = await response.json();
-        } catch (jsonError) {
-          // If JSON parsing fails, the response is likely HTML (e.g., error page)
-          throw new Error("Server returned an invalid response. Please try again later.");
-        }
-        if (!response.ok) {
-          throw new Error(data.error || "Failed to resend verification email");
-        }
-        // Show success notification
-        toast.success("Verification email sent", {
-          description: data.message || "If an account with that email exists and is not verified, a verification link has been sent.",
-        });
-      } catch (error) {
-        const errorMessage =
-          error instanceof Error ? error.message : "Failed to resend verification email. Please try again.";
-        // Show error notification
-        toast.error("Failed to resend verification email", {
-          description: errorMessage,
-        });
-        // Set error state
-        setErrors({
-          submit: errorMessage,
-        });
-      } finally {
-        setIsSubmitting(false);
-      }
-    },
-    [values, dataClient],
-  );
-  const handleCancel = useCallback(() => {
-    router.push(loginPath);
-  }, [router, loginPath]);
-  const handleGoToLogin = useCallback(() => {
-    router.push(loginPath);
-  }, [router, loginPath]);
-  return {
-    isVerifying,
-    isVerified,
-    isError,
-    errorMessage,
-    email,
-    values,
-    errors,
-    isSubmitDisabled,
-    isSubmitting,
-    emailTouched,
-    redirectCountdown,
-    handleFieldChange,
-    handleEmailBlur,
-    handleResendSubmit,
-    handleCancel,
-    handleGoToLogin,
-  };
-};