hazo_auth 1.4.1 → 1.6.0

package/src/server/logging/logger_service.ts

@@ -1,56 +0,0 @@
-// file_description: expose the logging facade used across the hazo_auth backend
-// section: imports
-import type { logger_method, logger_service } from "hazo_auth/server/types/app_types";
-
-// section: helper_functions
-const create_console_logger = (namespace: string): logger_service => {
-  const write = (level: string, message: string, data?: Record<string, unknown>) => {
-    const timestamp = new Date().toISOString();
-    // eslint-disable-next-line no-console
-    console.log(
-      JSON.stringify({
-        namespace,
-        level,
-        message,
-        data,
-        timestamp,
-      })
-    );
-  };
-
-  return {
-    debug: (message, data) => write("debug", message, data),
-    info: (message, data) => write("info", message, data),
-    warn: (message, data) => write("warn", message, data),
-    error: (message, data) => write("error", message, data),
-  };
-};
-
-// section: factory
-export const create_logger_service = (
-  namespace: string,
-  external_logger?: Partial<logger_service>
-): logger_service => {
-  const console_logger = create_console_logger(namespace);
-
-  const safe_bind = (
-    level: keyof logger_service,
-    fallback: logger_method
-  ): logger_method => {
-    const candidate = external_logger?.[level];
-    if (typeof candidate === "function") {
-      return (message, data) => candidate(message, data);
-    }
-    return fallback;
-  };
-
-  type logger_method = (message: string, data?: Record<string, unknown>) => void;
-
-  return {
-    debug: safe_bind("debug", console_logger.debug),
-    info: safe_bind("info", console_logger.info),
-    warn: safe_bind("warn", console_logger.warn),
-    error: safe_bind("error", console_logger.error),
-  };
-};
-

package/src/server/routes/root_router.ts

@@ -1,16 +0,0 @@
-// file_description: declares the primary express router for the hazo_auth backend
-// section: imports
-import { Router } from "express";
-
-// section: router_factory
-export const create_root_router = (): Router => {
-  const root_router = Router();
-  // section: health_endpoint
-  root_router.get("/health", (_request, response) => {
-    response.status(200).json({
-      status: "ok",
-    });
-  });
-  return root_router;
-};
-

package/src/server/server.ts

@@ -1,28 +0,0 @@
-// file_description: configure and export the express application for hazo_auth
-// section: imports
-import express from "express";
-import helmet from "helmet";
-import cors from "cors";
-import cookie_parser from "cookie-parser";
-import compression from "compression";
-import type { Application } from "express";
-import { create_root_router } from "hazo_auth/server/routes/root_router";
-import { create_app_context } from "hazo_auth/server/config/config_loader";
-
-// section: app_factory
-export const create_server_app = (): Application => {
-  const server_app = express();
-  server_app.use(helmet({ crossOriginResourcePolicy: false }));
-  server_app.use(cors({ credentials: true, origin: true }));
-  server_app.use(express.json({ limit: "1mb" }));
-  server_app.use(express.urlencoded({ extended: true }));
-  server_app.use(cookie_parser());
-  server_app.use(compression());
-  server_app.use((request, _response, next) => {
-    request.context = create_app_context();
-    next();
-  });
-  server_app.use(create_root_router());
-  return server_app;
-};
-

package/src/server/types/app_types.ts

@@ -1,74 +0,0 @@
-// file_description: define shared application level types for the hazo_auth server
-// section: request_context_types
-import type { Request } from "express";
-
-// section: logger_interface_definition
-export type logger_method = (
-  message: string,
-  data?: Record<string, unknown>
-) => void;
-
-export type logger_service = {
-  debug: logger_method;
-  info: logger_method;
-  warn: logger_method;
-  error: logger_method;
-};
-
-// section: configuration_types
-export type emailer_client = {
-  send_message: (
-    payload: Record<string, unknown>
-  ) => Promise<{ success: boolean }>;
-};
-
-export type handlebars_templates = Record<string, string>;
-
-export type password_policy = {
-  min_length: number;
-  requires_uppercase: boolean;
-  requires_lowercase: boolean;
-  requires_number: boolean;
-  requires_symbol: boolean;
-};
-
-export type token_settings = {
-  access_token_ttl_seconds: number;
-  refresh_token_ttl_seconds: number;
-};
-
-export type rate_limit_settings = {
-  max_attempts: number;
-  window_minutes: number;
-};
-
-export type captcha_settings =
-  | {
-      provider: "recaptcha_v2" | "recaptcha_v3" | "hcaptcha";
-      secret_key: string;
-    }
-  | undefined;
-
-export type runtime_configuration = {
-  permission_names: string[];
-  logger: logger_service;
-  emailer: emailer_client;
-  templates: handlebars_templates;
-  labels: Record<string, string>;
-  styles: Record<string, string>;
-  password_policy: password_policy;
-  token_settings: token_settings;
-  rate_limit: rate_limit_settings;
-  captcha: captcha_settings;
-};
-
-export type app_context = {
-  config: runtime_configuration;
-};
-
-// section: typed_request_wrapper
-export type context_request<T = unknown> = Request & {
-  body: T;
-  context: app_context;
-};
-

package/src/server/types/express.d.ts

@@ -1,16 +0,0 @@
-// file_description: augment express request with hazo_auth context
-import type { app_context } from "hazo_auth/server/types/app_types";
-
-declare global {
-  namespace Express {
-    interface Request {
-      context: app_context;
-    }
-  }
-}
-
-export {};
-
-
-
-

package/src/stories/email_verification_layout.stories.tsx

@@ -1,137 +0,0 @@
-// file_description: showcase the email_verification_layout component within storybook for review and testing
-// section: imports
-import type { Meta, StoryObj } from "@storybook/react";
-import EmailVerificationLayout from "../components/layouts/email_verification";
-import { createLayoutDataClient } from "../components/layouts/shared/data/layout_data_client";
-
-// section: metadata
-const meta: Meta<typeof EmailVerificationLayout> = {
-  title: "layouts/email_verification_layout",
-  id: "forms-email-verification-form",
-  component: EmailVerificationLayout,
-  parameters: {
-    layout: "centered",
-  },
-};
-
-export default meta;
-
-// section: helpers
-// Create mock hazo_connect instance for Storybook (browser environment)
-// Note: Real SQLite database cannot be used in browser/Storybook context
-// This mock satisfies the LayoutDataClient interface requirements
-const create_storybook_hazo_connect = () => {
-  return {
-    healthCheck: async () => {
-      // Mock health check for Storybook - no-op in browser context
-      return Promise.resolve();
-    },
-  };
-};
-
-// section: stories
-type story = StoryObj<typeof EmailVerificationLayout>;
-
-// section: verifying_state_story
-export const verifying_state: story = {
-  name: "verifying_state",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#e2e8f0",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Loading state shown while verifying the email verification token. Note: In Storybook, this will attempt to verify a token from the URL query string.",
-      },
-    },
-  },
-};
-
-// section: success_state_story
-export const success_state: story = {
-  name: "success_state",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#e2e8f0",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Success state shown after email verification is complete, with redirect countdown.",
-      },
-    },
-  },
-};
-
-// section: error_state_story
-export const error_state: story = {
-  name: "error_state",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#e2e8f0",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Error state shown when verification fails, with form to resend verification email.",
-      },
-    },
-  },
-};
-
-// section: custom_configuration_story
-export const custom_configuration: story = {
-  name: "custom_configuration",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#dbeafe",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-    labels: {
-      heading: "Verify your email",
-      subHeading: "Please wait while we verify your email address.",
-      submitButton: "Resend email",
-      cancelButton: "Back to login",
-    },
-    success_labels: {
-      heading: "Email confirmed!",
-      message: "Your email address has been successfully verified.",
-      redirectMessage: "You will be redirected in",
-      goToLoginButton: "Continue to login",
-    },
-    error_labels: {
-      heading: "Verification link expired",
-      message: "The verification link is no longer valid.",
-      resendFormHeading: "Get a new verification link",
-    },
-    button_colors: {
-      submitBackground: "#5b21b6",
-      submitText: "#ffffff",
-      cancelBorder: "#7c3aed",
-      cancelText: "#5b21b6",
-    },
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Demonstrates how teams can customise labels, button styling, and background images for alternative email verification flows.",
-      },
-    },
-  },
-};
-

package/src/stories/forgot_password_layout.stories.tsx

@@ -1,85 +0,0 @@
-// file_description: showcase the forgot_password_layout component within storybook for review and testing
-// section: imports
-import type { Meta, StoryObj } from "@storybook/react";
-import ForgotPasswordLayout from "../components/layouts/forgot_password";
-import { createLayoutDataClient } from "../components/layouts/shared/data/layout_data_client";
-
-// section: metadata
-const meta: Meta<typeof ForgotPasswordLayout> = {
-  title: "layouts/forgot_password_layout",
-  id: "forms-forgot-password-form",
-  component: ForgotPasswordLayout,
-  parameters: {
-    layout: "centered",
-  },
-};
-
-export default meta;
-
-// section: helpers
-// Create mock hazo_connect instance for Storybook (browser environment)
-// Note: Real SQLite database cannot be used in browser/Storybook context
-// This mock satisfies the LayoutDataClient interface requirements
-const create_storybook_hazo_connect = () => {
-  return {
-    healthCheck: async () => {
-      // Mock health check for Storybook - no-op in browser context
-      return Promise.resolve();
-    },
-  };
-};
-
-// section: stories
-type story = StoryObj<typeof ForgotPasswordLayout>;
-
-// section: default_story
-export const default_state: story = {
-  name: "default_state",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#e2e8f0",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Default presentation of the forgot password layout with email field.",
-      },
-    },
-  },
-};
-
-export const custom_configuration: story = {
-  name: "custom_configuration",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#dbeafe",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-    labels: {
-      heading: "Reset your password",
-      subHeading: "We'll send you a secure link to reset your password.",
-      submitButton: "Send reset email",
-      cancelButton: "Back to login",
-    },
-    button_colors: {
-      submitBackground: "#5b21b6",
-      submitText: "#ffffff",
-      cancelBorder: "#7c3aed",
-      cancelText: "#5b21b6",
-    },
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Demonstrates how teams can customise labels, button styling, and background images for alternative forgot password flows.",
-      },
-    },
-  },
-};
-

package/src/stories/login_layout.stories.tsx

@@ -1,85 +0,0 @@
-// file_description: showcase the login_layout component within storybook for review and testing
-// section: imports
-import type { Meta, StoryObj } from "@storybook/react";
-import LoginLayout from "../components/layouts/login";
-import { createLayoutDataClient } from "../components/layouts/shared/data/layout_data_client";
-
-// section: metadata
-const meta: Meta<typeof LoginLayout> = {
-  title: "layouts/login_layout",
-  id: "forms-login-form",
-  component: LoginLayout,
-  parameters: {
-    layout: "centered",
-  },
-};
-
-export default meta;
-
-// section: helpers
-// Create mock hazo_connect instance for Storybook (browser environment)
-// Note: Real SQLite database cannot be used in browser/Storybook context
-// This mock satisfies the LayoutDataClient interface requirements
-const create_storybook_hazo_connect = () => {
-  return {
-    healthCheck: async () => {
-      // Mock health check for Storybook - no-op in browser context
-      return Promise.resolve();
-    },
-  };
-};
-
-// section: stories
-type story = StoryObj<typeof LoginLayout>;
-
-// section: default_story
-export const default_state: story = {
-  name: "default_state",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#e2e8f0",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Default presentation of the login layout with email and password fields.",
-      },
-    },
-  },
-};
-
-export const custom_configuration: story = {
-  name: "custom_configuration",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#dbeafe",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-    labels: {
-      heading: "Welcome back to hazo",
-      subHeading: "Sign in to continue to your secure workspace.",
-      submitButton: "Sign in",
-      cancelButton: "Cancel",
-    },
-    button_colors: {
-      submitBackground: "#5b21b6",
-      submitText: "#ffffff",
-      cancelBorder: "#7c3aed",
-      cancelText: "#5b21b6",
-    },
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Demonstrates how teams can customise labels, button styling, and background images for alternative login flows.",
-      },
-    },
-  },
-};
-

package/src/stories/project_overview.stories.tsx

@@ -1,33 +0,0 @@
-// file_description: provide a high level story describing the purpose of the hazo_auth workspace
-import type { Meta, StoryObj } from "@storybook/nextjs";
-
-// section: story_configuration
-const story_meta: Meta = {
-  title: "foundations/project_overview",
-  parameters: {
-    layout: "centered",
-  },
-};
-
-export default story_meta;
-
-type Story = StoryObj;
-
-// section: story_definitions
-export const DefaultView: Story = {
-  name: "workspace overview",
-  render: () => (
-    <div className="cls_story_overview flex max-w-xl flex-col items-center justify-center gap-4 rounded-lg border border-slate-200 bg-white p-8 text-center shadow-sm">
-      <h2 className="cls_story_heading text-2xl font-semibold text-slate-900">
-        build reusable components with confidence
-      </h2>
-      <p className="cls_story_body text-base leading-relaxed text-slate-600">
-        This Storybook workspace pairs shadcn primitives with hazo_config and
-        hazo_connect so the design system can stay aligned with platform
-        standards. Add new stories to document upcoming components as
-        requirements arrive.
-      </p>
-    </div>
-  ),
-};
-

package/src/stories/register_layout.stories.tsx

@@ -1,107 +0,0 @@
-// file_description: showcase the register_layout component within storybook for review and testing
-// section: imports
-import type { Meta, StoryObj } from "@storybook/react";
-import RegisterLayout from "../components/layouts/register";
-import { createLayoutDataClient } from "../components/layouts/shared/data/layout_data_client";
-
-// section: metadata
-const meta: Meta<typeof RegisterLayout> = {
-  title: "layouts/register_layout",
-  id: "forms-register-form",
-  component: RegisterLayout,
-  parameters: {
-    layout: "centered",
-  },
-};
-
-export default meta;
-
-// section: helpers
-// Create mock hazo_connect instance for Storybook (browser environment)
-// Note: Real SQLite database cannot be used in browser/Storybook context
-// This mock satisfies the LayoutDataClient interface requirements
-const create_storybook_hazo_connect = () => {
-  return {
-    healthCheck: async () => {
-      // Mock health check for Storybook - no-op in browser context
-      return Promise.resolve();
-    },
-  };
-};
-
-// section: stories
-type story = StoryObj<typeof RegisterLayout>;
-
-// section: default_story
-export const default_state: story = {
-  name: "default_state",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#e2e8f0",
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Default presentation of the register layout with all fields locked until edited with the pencil toggles.",
-      },
-    },
-  },
-};
-
-export const custom_configuration: story = {
-  name: "custom_configuration",
-  args: {
-    image_src: "/globe.svg",
-    image_alt:
-      "Decorative globe illustrating the global reach of the hazo authentication platform",
-    image_background_color: "#dbeafe",
-    show_name_field: false,
-    data_client: createLayoutDataClient(create_storybook_hazo_connect()),
-    labels: {
-      heading: "Join the hazo beta now",
-      subHeading: "Configure your secure workspace credentials in minutes.",
-      submitButton: "Create account",
-      cancelButton: "Cancel setup",
-    },
-    field_overrides: {
-      email_address: {
-        label: "Work email",
-        placeholder: "Enter your work email",
-      },
-      password: {
-        label: "Create password",
-        placeholder: "Choose a strong password now",
-      },
-      confirm_password: {
-        label: "Confirm password",
-        placeholder: "Re-enter the password",
-      },
-    },
-    password_requirements: {
-      minimum_length: 12,
-      require_uppercase: true,
-      require_lowercase: true,
-      require_number: true,
-      require_special: true,
-    },
-    button_colors: {
-      submitBackground: "#5b21b6",
-      submitText: "#ffffff",
-      cancelBorder: "#7c3aed",
-      cancelText: "#5b21b6",
-    },
-  },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Demonstrates how teams can toggle the full name field, customise button styling, and adjust password policy messaging for alternative onboarding flows.",
-      },
-    },
-  },
-};
-