@useavalon/avalon 0.1.13 → 0.1.14

package/src/middleware/types.ts

@@ -1,99 +0,0 @@
-/**
- * Nitro-Aligned Middleware Types
- *
- * This module defines types for Avalon's middleware system that align with
- * Nitro's conventions while preserving route-scoped middleware features.
- *
- * Key differences from old middleware system:
- * - Handler signature: (event: H3Event) => void | Response | Promise<void | Response>
- * - Return void to continue, return Response to terminate
- * - Uses event.context for data passing instead of custom state/locals
- *
- * Requirements: 1.1
- */
-
-import type { H3Event } from 'h3';
-
-/**
- * Nitro-aligned middleware handler signature
- *
- * This signature matches Nitro's middleware conventions:
- * - Return nothing (void/undefined) to continue to next middleware
- * - Return a Response to terminate the chain and send that response
- * - Throw an error to trigger Nitro's error handling
- *
- * @example
- * ```ts
- * const handler: MiddlewareHandler = async (event) => {
- *   // Check auth
- *   if (!event.context.user) {
- *     return new Response('Unauthorized', { status: 401 });
- *   }
- *   // Continue to next middleware
- * };
- * ```
- */
-export type MiddlewareHandler = (
-  event: H3Event
-) => void | Response | Promise<void | Response>;
-
-/**
- * Route-scoped middleware file export interface
- *
- * Middleware files should export a default function matching the MiddlewareHandler signature.
- *
- * @example
- * ```ts
- * // src/pages/admin/_middleware.ts
- * export default async (event) => {
- *   // middleware logic
- * };
- * ```
- */
-export interface MiddlewareFileExport {
-  /** Default export must be a MiddlewareHandler function */
-  default: MiddlewareHandler;
-}
-
-/**
- * Discovered middleware route configuration
- *
- * Represents a middleware file discovered during scanning, with its
- * URL pattern, file path, execution priority, and type.
- */
-export interface MiddlewareRoute {
-  /** URL pattern for matching requests */
-  pattern: URLPattern;
-  /** Absolute path to the middleware file */
-  filePath: string;
-  /** Execution priority (lower numbers execute first) */
-  priority: number;
-  /** Middleware type - determines which routes it applies to */
-  type: 'global' | 'pages';
-}
-
-/**
- * Middleware discovery options
- */
-export interface MiddlewareDiscoveryOptions {
-  /** Base directory to scan (e.g., 'src') */
-  baseDir: string;
-  /** File pattern to match (default: '_middleware.ts') */
-  filePattern?: string;
-  /** Directories to exclude from scanning */
-  excludeDirs?: string[];
-  /** Enable development mode logging */
-  devMode?: boolean;
-}
-
-/**
- * Middleware execution options
- */
-export interface MiddlewareExecutorOptions {
-  /** Enable development mode logging */
-  devMode?: boolean;
-  /** Timeout for middleware execution in milliseconds */
-  timeout?: number;
-}
-
-

package/src/nitro/build-config.ts

@@ -1,576 +0,0 @@
-/**
- * Nitro Build Configuration Module for Avalon
- *
- * This module provides build configuration utilities for integrating Nitro
- * with Avalon's Vite-based build pipeline. It handles:
- * - Vite client build configuration
- * - Nitro server build configuration
- * - Preset-specific output configuration
- * - Source map generation
- *
- * @module nitro/build-config
- */
-
-import type { Plugin, UserConfig, BuildOptions } from "vite";
-import type { ResolvedAvalonConfig } from "../vite-plugin/types.ts";
-import type { AvalonNitroConfig } from "./config.ts";
-import { DEFAULT_NITRO_CONFIG, VALID_V3_PRESETS } from "./config.ts";
-
-/**
- * Build mode for the Avalon application
- */
-export type BuildMode = "client" | "server" | "both";
-
-/**
- * Sourcemap option type
- */
-export type SourcemapOption = boolean | "inline" | "hidden";
-
-/**
- * Minify option type
- */
-export type MinifyOption = boolean | "oxc" | "esbuild" | "terser";
-
-/**
- * Preset-specific build output configuration
- */
-export interface PresetOutputConfig {
-  /** Output directory for the preset */
-  outputDir: string;
-  /** Server entry file name */
-  serverEntry: string;
-  /** Whether the preset supports streaming */
-  supportsStreaming: boolean;
-  /** Whether the preset requires bundled dependencies */
-  bundleDependencies: boolean;
-  /** Additional files to include in output */
-  additionalFiles?: string[];
-  /** Environment-specific configuration */
-  env?: Record<string, string>;
-}
-
-/**
- * Avalon build configuration options
- */
-export interface AvalonBuildConfig {
-  /** Build mode: client, server, or both */
-  mode: BuildMode;
-  /** Output directory for client assets */
-  clientOutDir: string;
-  /** Output directory for server bundle */
-  serverOutDir: string;
-  /** Enable source maps */
-  sourcemap: SourcemapOption;
-  /** Minify output */
-  minify: MinifyOption;
-  /** Target environment */
-  target: string | string[];
-  /** Enable SSR build */
-  ssr: boolean;
-  /** Nitro preset for deployment */
-  preset: string;
-  /** Enable verbose logging */
-  verbose: boolean;
-  /** Nitro v3: Compatibility date for preset features (YYYY-MM-DD) */
-  compatibilityDate?: string;
-  /** Nitro v3: Dependencies to trace instead of bundle */
-  traceDeps?: string[];
-  /** Nitro v3: Rolldown-specific configuration */
-  rolldownConfig?: Record<string, unknown>;
-  /** Nitro v3: Custom server entry point */
-  serverEntry?: string;
-}
-
-/**
- * Default build configuration values
- */
-export const DEFAULT_BUILD_CONFIG: AvalonBuildConfig = {
-  mode: "both",
-  clientOutDir: "dist/client",
-  serverOutDir: "dist/server",
-  sourcemap: true,
-  minify: "oxc",
-  target: "es2020",
-  ssr: true,
-  preset: "node_server",
-  verbose: false,
-};
-
-/**
- * Preset-specific output configurations
- */
-export const PRESET_OUTPUT_CONFIGS: Record<string, PresetOutputConfig> = {
-  "node_server": {
-    outputDir: ".output",
-    serverEntry: "server/index.mjs",
-    supportsStreaming: true,
-    bundleDependencies: false,
-  },
-  "node_middleware": {
-    outputDir: ".output",
-    serverEntry: "server/index.mjs",
-    supportsStreaming: true,
-    bundleDependencies: false,
-  },
-  "vercel": {
-    outputDir: ".vercel/output",
-    serverEntry: "functions/render.func/index.mjs",
-    supportsStreaming: true,
-    bundleDependencies: true,
-    additionalFiles: ["config.json"],
-  },
-  "cloudflare_module": {
-    outputDir: "dist",
-    serverEntry: "server/index.mjs",
-    supportsStreaming: false,
-    bundleDependencies: true,
-  },
-  "cloudflare_pages": {
-    outputDir: "dist",
-    serverEntry: "_worker.js",
-    supportsStreaming: false,
-    bundleDependencies: true,
-    additionalFiles: ["_routes.json"],
-  },
-  "deno_deploy": {
-    outputDir: ".output",
-    serverEntry: "server/index.ts",
-    supportsStreaming: true,
-    bundleDependencies: false,
-  },
-  "deno_server": {
-    outputDir: ".output",
-    serverEntry: "server/index.ts",
-    supportsStreaming: true,
-    bundleDependencies: false,
-  },
-  "netlify_functions": {
-    outputDir: ".netlify",
-    serverEntry: "functions-internal/render.mjs",
-    supportsStreaming: true,
-    bundleDependencies: true,
-  },
-  "netlify_edge": {
-    outputDir: ".netlify/edge-functions",
-    serverEntry: "render.js",
-    supportsStreaming: true,
-    bundleDependencies: true,
-  },
-  "aws_lambda": {
-    outputDir: ".output",
-    serverEntry: "server/index.mjs",
-    supportsStreaming: false,
-    bundleDependencies: true,
-  },
-  "azure_swa": {
-    outputDir: ".output",
-    serverEntry: "server/index.mjs",
-    supportsStreaming: false,
-    bundleDependencies: true,
-  },
-  "firebase_functions": {
-    outputDir: ".output",
-    serverEntry: "server/index.mjs",
-    supportsStreaming: true,
-    bundleDependencies: true,
-  },
-  "render_com": {
-    outputDir: ".output",
-    serverEntry: "server/index.mjs",
-    supportsStreaming: true,
-    bundleDependencies: false,
-  },
-  "static": {
-    outputDir: "dist",
-    serverEntry: "",
-    supportsStreaming: false,
-    bundleDependencies: false,
-  },
-  "browser": {
-    outputDir: "dist",
-    serverEntry: "",
-    supportsStreaming: false,
-    bundleDependencies: true,
-  },
-};
-
-/**
- * Creates the Vite client build configuration
- *
- * @param avalonConfig - Resolved Avalon configuration
- * @param buildConfig - Build configuration options
- * @returns Vite build options for client build
- */
-export function createClientBuildConfig(
-  avalonConfig: ResolvedAvalonConfig,
-  buildConfig: Partial<AvalonBuildConfig> = {}
-): BuildOptions {
-  const config = { ...DEFAULT_BUILD_CONFIG, ...buildConfig };
-
-  return {
-    outDir: config.clientOutDir,
-    emptyOutDir: true,
-    sourcemap: config.sourcemap,
-    minify: config.minify,
-    target: config.target,
-    rolldownOptions: {
-      output: {
-        entryFileNames: "[name].[hash].js",
-        chunkFileNames: "chunks/[name].[hash].js",
-        assetFileNames: "assets/[name].[hash].[ext]",
-        codeSplitting: {
-          groups: [
-            { name: "vendor-react", test: /node_modules\/(react|react-dom)/ },
-            { name: "vendor-vue", test: /node_modules\/(vue|@vue)/ },
-            { name: "vendor-svelte", test: /node_modules\/svelte/ },
-            { name: "vendor-preact", test: /node_modules\/preact/ },
-            { name: "vendor-solid", test: /node_modules\/solid-js/ },
-            { name: "vendor-lit", test: /node_modules\/(lit|@lit)/ },
-            { name: "vendor", test: /node_modules/ },
-            { name: "islands", test: /\/islands\// },
-          ],
-        },
-      },
-    },
-    reportCompressedSize: !avalonConfig.isDev,
-    cssCodeSplit: true,
-  };
-}
-
-/**
- * Creates the Vite server build configuration for Nitro
- *
- * @param avalonConfig - Resolved Avalon configuration
- * @param nitroConfig - Nitro configuration
- * @param buildConfig - Build configuration options
- * @returns Vite build options for server build
- */
-export function createServerBuildConfig(
-  avalonConfig: ResolvedAvalonConfig,
-  nitroConfig: AvalonNitroConfig,
-  buildConfig: Partial<AvalonBuildConfig> = {}
-): BuildOptions {
-  const config = { ...DEFAULT_BUILD_CONFIG, ...buildConfig };
-  const preset = nitroConfig.preset ?? DEFAULT_NITRO_CONFIG.preset;
-  const presetConfig = PRESET_OUTPUT_CONFIGS[preset] ?? PRESET_OUTPUT_CONFIGS["node_server"];
-
-  return {
-    outDir: config.serverOutDir,
-    emptyOutDir: true,
-    sourcemap: config.sourcemap,
-    minify: config.minify,
-    target: config.target,
-    ssr: true,
-    rolldownOptions: {
-      input: {
-        index: "./server/index.ts",
-      },
-      output: {
-        format: "esm",
-        entryFileNames: "[name].mjs",
-        chunkFileNames: "chunks/[name].[hash].mjs",
-        preserveModules: !presetConfig.bundleDependencies,
-      },
-      external: presetConfig.bundleDependencies
-        ? []
-        : getServerExternals(preset),
-    },
-  };
-}
-
-/**
- * Gets external dependencies for server build based on preset
- *
- * @param preset - Nitro preset name
- * @returns Array of external dependency patterns
- */
-function getServerExternals(preset: string): (string | RegExp)[] {
-  const baseExternals: (string | RegExp)[] = [
-    /^node:/,
-    /^deno:/,
-  ];
-
-  switch (preset) {
-    case "deno_deploy":
-    case "deno_server":
-      return [...baseExternals];
-
-    case "node_server":
-      return [
-        ...baseExternals,
-        /^[a-z@]/i,
-      ];
-
-    default:
-      return baseExternals;
-  }
-}
-
-/**
- * Gets the preset output configuration
- *
- * @param preset - Nitro preset name
- * @returns Preset output configuration
- */
-export function getPresetOutputConfig(preset: string): PresetOutputConfig {
-  return PRESET_OUTPUT_CONFIGS[preset] ?? PRESET_OUTPUT_CONFIGS["node_server"];
-}
-
-/**
- * Checks if a preset supports streaming SSR
- *
- * @param preset - Nitro preset name
- * @returns True if the preset supports streaming
- */
-export function presetSupportsStreaming(preset: string): boolean {
-  const config = getPresetOutputConfig(preset);
-  return config.supportsStreaming;
-}
-
-/**
- * Creates the combined build configuration for both client and server
- *
- * @param avalonConfig - Resolved Avalon configuration
- * @param nitroConfig - Nitro configuration
- * @param buildConfig - Build configuration options
- * @returns Combined Vite user config
- */
-export function createCombinedBuildConfig(
-  avalonConfig: ResolvedAvalonConfig,
-  nitroConfig: AvalonNitroConfig,
-  buildConfig: Partial<AvalonBuildConfig> = {}
-): Partial<UserConfig> {
-  const preset = nitroConfig.preset ?? DEFAULT_NITRO_CONFIG.preset;
-  const presetConfig = getPresetOutputConfig(preset);
-
-  return {
-    build: {
-      ...createClientBuildConfig(avalonConfig, buildConfig),
-      outDir: presetConfig.outputDir,
-    },
-    define: {
-      __DEV__: false,
-      __PROD__: true,
-      "process.env.NODE_ENV": JSON.stringify("production"),
-      ...createPresetDefines(preset, presetConfig),
-    },
-  };
-}
-
-/**
- * Creates preset-specific define constants
- */
-function createPresetDefines(
-  preset: string,
-  presetConfig: PresetOutputConfig
-): Record<string, string> {
-  const defines: Record<string, string> = {
-    __NITRO_PRESET__: JSON.stringify(preset),
-    __SUPPORTS_STREAMING__: JSON.stringify(presetConfig.supportsStreaming),
-  };
-
-  if (presetConfig.env) {
-    for (const [key, value] of Object.entries(presetConfig.env)) {
-      defines[`process.env.${key}`] = JSON.stringify(value);
-    }
-  }
-
-  return defines;
-}
-
-/**
- * Creates a Vite plugin for Nitro build integration
- */
-export function createNitroBuildPlugin(
-  avalonConfig: ResolvedAvalonConfig,
-  nitroConfig: AvalonNitroConfig
-): Plugin {
-  const preset = nitroConfig.preset ?? DEFAULT_NITRO_CONFIG.preset;
-  const presetConfig = getPresetOutputConfig(preset);
-
-  return {
-    name: "avalon:nitro-build",
-    enforce: "post",
-
-    config(_config: UserConfig, { command }: { command: string }) {
-      if (command !== "build") {
-        return;
-      }
-
-      return createCombinedBuildConfig(avalonConfig, nitroConfig, {
-        sourcemap: true,
-        verbose: avalonConfig.verbose,
-      });
-    },
-
-    buildStart() {
-      if (avalonConfig.verbose) {
-        console.log("🚀 Avalon Nitro build starting...");
-        console.log(`   Preset: ${preset}`);
-        console.log(`   Output: ${presetConfig.outputDir}`);
-        console.log(`   Streaming: ${presetConfig.supportsStreaming}`);
-      }
-    },
-
-    writeBundle() {
-      if (avalonConfig.verbose) {
-        console.log("✅ Avalon client build complete");
-      }
-    },
-
-    closeBundle() {
-      if (avalonConfig.verbose) {
-        console.log("📦 Avalon build finished");
-        console.log(`   Output directory: ${presetConfig.outputDir}`);
-      }
-    },
-  };
-}
-
-/**
- * Validates build configuration
- */
-export function validateBuildConfig(
-  config: Partial<AvalonBuildConfig>
-): { valid: boolean; errors: string[] } {
-  const errors: string[] = [];
-
-  if (config.preset) {
-    if (!VALID_V3_PRESETS.includes(config.preset)) {
-      errors.push(
-        `Unknown preset: ${config.preset}. Valid presets: ${VALID_V3_PRESETS.join(", ")}`
-      );
-    }
-  }
-
-  if (config.mode && !["client", "server", "both"].includes(config.mode)) {
-    errors.push(`Invalid build mode: ${config.mode}. Must be 'client', 'server', or 'both'`);
-  }
-
-  if (
-    config.sourcemap !== undefined &&
-    typeof config.sourcemap !== "boolean" &&
-    !["inline", "hidden"].includes(config.sourcemap as string)
-  ) {
-    errors.push(`Invalid sourcemap option: ${config.sourcemap}`);
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors,
-  };
-}
-
-/**
- * Source map configuration options
- */
-export interface SourceMapConfig {
-  /** Enable source maps */
-  enabled: boolean;
-  /** Source map type: true for external, 'inline' for inline, 'hidden' for hidden */
-  type: SourcemapOption;
-  /** Include source content in source maps */
-  includeContent: boolean;
-  /** Source map URL prefix */
-  sourceRoot?: string;
-}
-
-/**
- * Default source map configuration
- */
-export const DEFAULT_SOURCEMAP_CONFIG: SourceMapConfig = {
-  enabled: true,
-  type: true,
-  includeContent: true,
-};
-
-/**
- * Creates source map configuration based on environment and preset
- */
-export function createSourceMapConfig(
-  preset: string,
-  isDev: boolean
-): SourceMapConfig {
-  if (isDev) {
-    return {
-      enabled: true,
-      type: true,
-      includeContent: true,
-    };
-  }
-
-  if (
-    preset.includes("edge") ||
-    preset.includes("cloudflare") ||
-    preset.includes("lambda")
-  ) {
-    return {
-      enabled: true,
-      type: "hidden",
-      includeContent: false,
-    };
-  }
-
-  return {
-    enabled: true,
-    type: true,
-    includeContent: true,
-  };
-}
-
-/**
- * Gets the Vite sourcemap option from SourceMapConfig
- */
-export function getViteSourceMapOption(
-  config: SourceMapConfig
-): SourcemapOption {
-  if (!config.enabled) {
-    return false;
-  }
-  return config.type;
-}
-
-/**
- * Creates a Vite plugin for source map handling
- */
-export function createSourceMapPlugin(config: SourceMapConfig): Plugin {
-  return {
-    name: "avalon:sourcemap",
-    enforce: "post",
-
-    config(_viteConfig: UserConfig, { command }: { command: string }) {
-      if (command !== "build") {
-        return;
-      }
-
-      return {
-        build: {
-          sourcemap: getViteSourceMapOption(config),
-        },
-        ...(config.sourceRoot && {
-          rolldownOptions: {
-            output: {
-              sourcemapPathTransform: (relativeSourcePath: string) => {
-                return `${config.sourceRoot}/${relativeSourcePath}`;
-              },
-            },
-          },
-        }),
-      };
-    },
-
-    generateBundle(_options: unknown, bundle: Record<string, unknown>) {
-      if (!config.enabled) {
-        return;
-      }
-
-      const sourceMapCount = Object.keys(bundle).filter(
-        (key) => key.endsWith(".map")
-      ).length;
-
-      if (sourceMapCount > 0 && globalThis.__avalonConfig?.verbose) {
-        console.log(`📍 Generated ${sourceMapCount} source map(s)`);
-      }
-    },
-  };
-}