@analogjs/vite-plugin-nitro 2.0.0-beta.8 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@analogjs/vite-plugin-nitro",
-  "version": "2.0.0-beta.8",
+  "version": "2.0.0",
   "description": "A Vite plugin for adding a nitro API server",
   "type": "module",
   "author": "Brandon Roberts <robertsbt@gmail.com>",

package/src/lib/utils/get-content-files.d.ts

@@ -1,2 +1,56 @@
 import { PrerenderContentFile } from '../options';
+/**
+ * Discovers content files with front matter and extracts metadata for prerendering.
+ *
+ * This function:
+ * 1. Discovers all content files matching the specified glob pattern
+ * 2. Reads each file and parses front matter metadata
+ * 3. Extracts file name, extension, and path information
+ * 4. Returns structured data for prerendering content pages
+ *
+ * @param workspaceRoot The workspace root directory path
+ * @param rootDir The project root directory relative to workspace
+ * @param glob The glob pattern to match content files (e.g., 'content/blog')
+ * @returns Array of PrerenderContentFile objects with metadata and front matter
+ *
+ * Example usage:
+ * const contentFiles = getMatchingContentFilesWithFrontMatter(
+ *   '/workspace',
+ *   'apps/my-app',
+ *   'content/blog'
+ * );
+ *
+ * Sample discovered file paths:
+ * - /workspace/apps/my-app/content/blog/first-post.md
+ * - /workspace/apps/my-app/content/blog/2024/01/hello-world.md
+ * - /workspace/apps/my-app/content/blog/tech/angular-v17.mdx
+ * - /workspace/apps/my-app/content/blog/about/index.md
+ *
+ * Sample output structure:
+ * {
+ *   name: 'first-post',
+ *   extension: 'md',
+ *   path: 'content/blog',
+ *   attributes: { title: 'My First Post', date: '2024-01-01', tags: ['intro'] }
+ * }
+ *
+ * tinyglobby vs fast-glob comparison:
+ * - Both support the same glob patterns for file discovery
+ * - Both are efficient for finding content files
+ * - tinyglobby is now used instead of fast-glob
+ * - tinyglobby provides similar functionality with smaller bundle size
+ * - tinyglobby's globSync returns absolute paths when absolute: true is set
+ *
+ * Front matter parsing:
+ * - Uses front-matter library to parse YAML/TOML front matter
+ * - Extracts metadata like title, date, tags, author, etc.
+ * - Supports both YAML (---) and TOML (+++) delimiters
+ * - Returns structured attributes for prerendering
+ *
+ * File path processing:
+ * - Normalizes paths for cross-platform compatibility
+ * - Extracts file name without extension
+ * - Determines file extension for content type handling
+ * - Maintains relative path structure for routing
+ */
 export declare function getMatchingContentFilesWithFrontMatter(workspaceRoot: string, rootDir: string, glob: string): PrerenderContentFile[];

package/src/lib/utils/get-content-files.js

@@ -2,28 +2,94 @@ import { readFileSync } from 'node:fs';
 import { join, relative, resolve } from 'node:path';
 import { normalizePath } from 'vite';
 import { createRequire } from 'node:module';
+import { globSync } from 'tinyglobby';
 const require = createRequire(import.meta.url);
+/**
+ * Discovers content files with front matter and extracts metadata for prerendering.
+ *
+ * This function:
+ * 1. Discovers all content files matching the specified glob pattern
+ * 2. Reads each file and parses front matter metadata
+ * 3. Extracts file name, extension, and path information
+ * 4. Returns structured data for prerendering content pages
+ *
+ * @param workspaceRoot The workspace root directory path
+ * @param rootDir The project root directory relative to workspace
+ * @param glob The glob pattern to match content files (e.g., 'content/blog')
+ * @returns Array of PrerenderContentFile objects with metadata and front matter
+ *
+ * Example usage:
+ * const contentFiles = getMatchingContentFilesWithFrontMatter(
+ *   '/workspace',
+ *   'apps/my-app',
+ *   'content/blog'
+ * );
+ *
+ * Sample discovered file paths:
+ * - /workspace/apps/my-app/content/blog/first-post.md
+ * - /workspace/apps/my-app/content/blog/2024/01/hello-world.md
+ * - /workspace/apps/my-app/content/blog/tech/angular-v17.mdx
+ * - /workspace/apps/my-app/content/blog/about/index.md
+ *
+ * Sample output structure:
+ * {
+ *   name: 'first-post',
+ *   extension: 'md',
+ *   path: 'content/blog',
+ *   attributes: { title: 'My First Post', date: '2024-01-01', tags: ['intro'] }
+ * }
+ *
+ * tinyglobby vs fast-glob comparison:
+ * - Both support the same glob patterns for file discovery
+ * - Both are efficient for finding content files
+ * - tinyglobby is now used instead of fast-glob
+ * - tinyglobby provides similar functionality with smaller bundle size
+ * - tinyglobby's globSync returns absolute paths when absolute: true is set
+ *
+ * Front matter parsing:
+ * - Uses front-matter library to parse YAML/TOML front matter
+ * - Extracts metadata like title, date, tags, author, etc.
+ * - Supports both YAML (---) and TOML (+++) delimiters
+ * - Returns structured attributes for prerendering
+ *
+ * File path processing:
+ * - Normalizes paths for cross-platform compatibility
+ * - Extracts file name without extension
+ * - Determines file extension for content type handling
+ * - Maintains relative path structure for routing
+ */
 export function getMatchingContentFilesWithFrontMatter(workspaceRoot, rootDir, glob) {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    const fg = require('fast-glob');
+    // Dynamically require front-matter library
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     const fm = require('front-matter');
+    // Normalize the project root path for consistent path handling
     const root = normalizePath(resolve(workspaceRoot, rootDir));
+    // Resolve the content directory path relative to the project root
     const resolvedDir = normalizePath(relative(root, join(root, glob)));
-    const contentFiles = fg.sync([`${root}/${resolvedDir}/*`], {
+    // Discover all content files in the specified directory
+    // Pattern: looks for any files in the resolved directory
+    const contentFiles = globSync([`${root}/${resolvedDir}/*`], {
         dot: true,
+        absolute: true,
     });
+    // Process each discovered content file to extract metadata and front matter
     const mappedFilesWithFm = contentFiles.map((f) => {
+        // Read the file contents as UTF-8 text
         const fileContents = readFileSync(f, 'utf8');
+        // Parse front matter from the file content
         const raw = fm(fileContents);
+        // Get the relative file path by removing the root directory
         const filepath = f.replace(root, '');
+        // Extract file name and extension using regex
+        // Matches: /filename.ext or /filename (with optional extension)
         const match = filepath.match(/\/([^/.]+)(\.([^/.]+))?$/);
         let name = '';
         let extension = '';
         if (match) {
-            name = match[1];
-            extension = match[3] || ''; // Using an empty string if there's no extension
+            name = match[1]; // File name without extension
+            extension = match[3] || ''; // File extension or empty string if no extension
         }
+        // Return structured content file data for prerendering
         return {
             name,
             extension,

package/src/lib/utils/get-content-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-content-files.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/get-content-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,UAAU,sCAAsC,CACpD,aAAqB,EACrB,OAAe,EACf,IAAY;IAEZ,8DAA8D;IAC9D,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,8DAA8D;IAC9D,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,YAAY,GAAa,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,WAAW,IAAI,CAAC,EAAE;QACnE,GAAG,EAAE,IAAI;KACV,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAA2B,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvE,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACzD,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAChB,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,gDAAgD;QAC9E,CAAC;QAED,OAAO;YACL,IAAI;YACJ,SAAS;YACT,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,GAAG,CAAC,UAAiD;SAClE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"get-content-files.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/get-content-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,sCAAsC,CACpD,aAAqB,EACrB,OAAe,EACf,IAAY;IAEZ,2CAA2C;IAC3C,8DAA8D;IAC9D,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnC,+DAA+D;IAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,kEAAkE;IAClE,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpE,wDAAwD;IACxD,yDAAyD;IACzD,MAAM,YAAY,GAAa,QAAQ,CAAC,CAAC,GAAG,IAAI,IAAI,WAAW,IAAI,CAAC,EAAE;QACpE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,4EAA4E;IAC5E,MAAM,iBAAiB,GAA2B,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvE,uCAAuC;QACvC,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAE7C,2CAA2C;QAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;QAE7B,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAErC,8CAA8C;QAC9C,gEAAgE;QAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACzD,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;YAC/C,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,iDAAiD;QAC/E,CAAC;QAED,uDAAuD;QACvD,OAAO;YACL,IAAI;YACJ,SAAS;YACT,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,GAAG,CAAC,UAAiD;SAClE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/src/lib/utils/get-page-handlers.d.ts

@@ -6,5 +6,57 @@ type GetHandlersArgs = {
     additionalPagesDirs?: string[];
     hasAPIDir?: boolean;
 };
+/**
+ * Discovers and generates Nitro event handlers for server-side page routes.
+ *
+ * This function:
+ * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
+ * 2. Converts file paths to route patterns using Angular-style route syntax
+ * 3. Generates Nitro event handlers with proper route mapping and lazy loading
+ * 4. Handles dynamic route parameters and catch-all routes
+ *
+ * @param workspaceRoot The workspace root directory path
+ * @param sourceRoot The source directory path (e.g., 'src')
+ * @param rootDir The project root directory relative to workspace
+ * @param additionalPagesDirs Optional array of additional pages directories to scan
+ * @param hasAPIDir Whether the project has an API directory (affects route prefixing)
+ * @returns Array of NitroEventHandler objects with handler paths and route patterns
+ *
+ * Example usage:
+ * const handlers = getPageHandlers({
+ *   workspaceRoot: '/workspace',
+ *   sourceRoot: 'src',
+ *   rootDir: 'apps/my-app',
+ *   additionalPagesDirs: ['/libs/shared/pages'],
+ *   hasAPIDir: true
+ * });
+ *
+ * Sample discovered file paths:
+ * - /workspace/apps/my-app/src/app/pages/index.server.ts
+ * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
+ * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
+ * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
+ *
+ * Route transformation examples:
+ * - index.server.ts → /_analog/pages/index
+ * - users/[id].server.ts → /_analog/pages/users/:id
+ * - products/[...slug].server.ts → /_analog/pages/products/**:slug
+ * - (auth)/login.server.ts → /_analog/pages/-auth-/login
+ *
+ * tinyglobby vs fast-glob comparison:
+ * - Both support the same glob patterns for file discovery
+ * - Both are efficient for finding server-side page files
+ * - tinyglobby is now used instead of fast-glob
+ * - tinyglobby provides similar functionality with smaller bundle size
+ * - tinyglobby's globSync returns absolute paths when absolute: true is set
+ *
+ * Route transformation rules:
+ * 1. Removes .server.ts extension
+ * 2. Converts [param] to :param for dynamic routes
+ * 3. Converts [...param] to **:param for catch-all routes
+ * 4. Converts (group) to -group- for route groups
+ * 5. Converts dots to forward slashes
+ * 6. Prefixes with /_analog/pages and optionally /api
+ */
 export declare function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir, }: GetHandlersArgs): NitroEventHandler[];
 export {};

package/src/lib/utils/get-page-handlers.js

@@ -1,21 +1,79 @@
 import { resolve } from 'node:path';
-import fg from 'fast-glob';
+import { globSync } from 'tinyglobby';
 import { normalizePath } from 'vite';
+/**
+ * Discovers and generates Nitro event handlers for server-side page routes.
+ *
+ * This function:
+ * 1. Discovers all .server.ts files in the app/pages directory and additional pages directories
+ * 2. Converts file paths to route patterns using Angular-style route syntax
+ * 3. Generates Nitro event handlers with proper route mapping and lazy loading
+ * 4. Handles dynamic route parameters and catch-all routes
+ *
+ * @param workspaceRoot The workspace root directory path
+ * @param sourceRoot The source directory path (e.g., 'src')
+ * @param rootDir The project root directory relative to workspace
+ * @param additionalPagesDirs Optional array of additional pages directories to scan
+ * @param hasAPIDir Whether the project has an API directory (affects route prefixing)
+ * @returns Array of NitroEventHandler objects with handler paths and route patterns
+ *
+ * Example usage:
+ * const handlers = getPageHandlers({
+ *   workspaceRoot: '/workspace',
+ *   sourceRoot: 'src',
+ *   rootDir: 'apps/my-app',
+ *   additionalPagesDirs: ['/libs/shared/pages'],
+ *   hasAPIDir: true
+ * });
+ *
+ * Sample discovered file paths:
+ * - /workspace/apps/my-app/src/app/pages/index.server.ts
+ * - /workspace/apps/my-app/src/app/pages/users/[id].server.ts
+ * - /workspace/apps/my-app/src/app/pages/products/[...slug].server.ts
+ * - /workspace/apps/my-app/src/app/pages/(auth)/login.server.ts
+ *
+ * Route transformation examples:
+ * - index.server.ts → /_analog/pages/index
+ * - users/[id].server.ts → /_analog/pages/users/:id
+ * - products/[...slug].server.ts → /_analog/pages/products/**:slug
+ * - (auth)/login.server.ts → /_analog/pages/-auth-/login
+ *
+ * tinyglobby vs fast-glob comparison:
+ * - Both support the same glob patterns for file discovery
+ * - Both are efficient for finding server-side page files
+ * - tinyglobby is now used instead of fast-glob
+ * - tinyglobby provides similar functionality with smaller bundle size
+ * - tinyglobby's globSync returns absolute paths when absolute: true is set
+ *
+ * Route transformation rules:
+ * 1. Removes .server.ts extension
+ * 2. Converts [param] to :param for dynamic routes
+ * 3. Converts [...param] to **:param for catch-all routes
+ * 4. Converts (group) to -group- for route groups
+ * 5. Converts dots to forward slashes
+ * 6. Prefixes with /_analog/pages and optionally /api
+ */
 export function getPageHandlers({ workspaceRoot, sourceRoot, rootDir, additionalPagesDirs, hasAPIDir, }) {
+    // Normalize the project root path for consistent path handling
     const root = normalizePath(resolve(workspaceRoot, rootDir));
-    const endpointFiles = fg.sync([
+    // Discover all .server.ts files in the app/pages directory and additional pages directories
+    // Pattern: looks for any .server.ts files in app/pages/**/*.server.ts and additional directories
+    const endpointFiles = globSync([
         `${root}/${sourceRoot}/app/pages/**/*.server.ts`,
         ...(additionalPagesDirs || []).map((dir) => `${workspaceRoot}${dir}/**/*.server.ts`),
-    ], { dot: true });
+    ], { dot: true, absolute: true });
+    // Transform each discovered file into a Nitro event handler
     const handlers = endpointFiles.map((endpointFile) => {
+        // Convert file path to route pattern using Angular-style route syntax
         const route = endpointFile
-            .replace(/^(.*?)\/pages/, '/pages')
-            .replace(/\.server\.ts$/, '')
-            .replace(/\[\.{3}(.+)\]/g, '**:$1')
-            .replace(/\[\.{3}(\w+)\]/g, '**:$1')
-            .replace(/\/\((.*?)\)$/, '/-$1-')
-            .replace(/\[(\w+)\]/g, ':$1')
-            .replace(/\./g, '/');
+            .replace(/^(.*?)\/pages/, '/pages') // Remove everything before /pages
+            .replace(/\.server\.ts$/, '') // Remove .server.ts extension
+            .replace(/\[\.{3}(.+)\]/g, '**:$1') // Convert [...param] to **:param (catch-all routes)
+            .replace(/\[\.{3}(\w+)\]/g, '**:$1') // Alternative catch-all pattern
+            .replace(/\/\((.*?)\)$/, '/-$1-') // Convert (group) to -group- (route groups)
+            .replace(/\[(\w+)\]/g, ':$1') // Convert [param] to :param (dynamic routes)
+            .replace(/\./g, '/'); // Convert dots to forward slashes
+        // Return Nitro event handler with absolute handler path and transformed route
         return {
             handler: endpointFile,
             route: `${hasAPIDir ? '/api' : ''}/_analog${route}`,

package/src/lib/utils/get-page-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-page-handlers.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/get-page-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,WAAW,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAUrC,MAAM,UAAU,eAAe,CAAC,EAC9B,aAAa,EACb,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,SAAS,GACO;IAChB,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,MAAM,aAAa,GAAa,EAAE,CAAC,IAAI,CACrC;QACE,GAAG,IAAI,IAAI,UAAU,2BAA2B;QAChD,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAChC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,aAAa,GAAG,GAAG,iBAAiB,CACjD;KACF,EACD,EAAE,GAAG,EAAE,IAAI,EAAE,CACd,CAAC;IAEF,MAAM,QAAQ,GAAwB,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;QACvE,MAAM,KAAK,GAAG,YAAY;aACvB,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC;aAClC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;aAC5B,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC;aAClC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;aACnC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC;aAChC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC;aAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEvB,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,KAAK,EAAE;YACnD,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"get-page-handlers.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/get-page-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAUrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,aAAa,EACb,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,SAAS,GACO;IAChB,+DAA+D;IAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,4FAA4F;IAC5F,iGAAiG;IACjG,MAAM,aAAa,GAAa,QAAQ,CACtC;QACE,GAAG,IAAI,IAAI,UAAU,2BAA2B;QAChD,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAChC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,aAAa,GAAG,GAAG,iBAAiB,CACjD;KACF,EACD,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC9B,CAAC;IAEF,4DAA4D;IAC5D,MAAM,QAAQ,GAAwB,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;QACvE,sEAAsE;QACtE,MAAM,KAAK,GAAG,YAAY;aACvB,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,kCAAkC;aACrE,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,8BAA8B;aAC3D,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,oDAAoD;aACvF,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,gCAAgC;aACpE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,4CAA4C;aAC7E,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,6CAA6C;aAC1E,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,kCAAkC;QAE1D,8EAA8E;QAC9E,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,KAAK,EAAE;YACnD,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/src/lib/utils/register-dev-middleware.d.ts

@@ -1,2 +1,42 @@
 import { ViteDevServer } from 'vite';
+/**
+ * Registers development server middleware by discovering and loading middleware files.
+ *
+ * This function:
+ * 1. Discovers all TypeScript middleware files in the server/middleware directory
+ * 2. Dynamically loads each middleware module using Vite's SSR module loader
+ * 3. Registers each middleware handler with the Vite development server
+ * 4. Handles middleware execution flow and error handling
+ *
+ * @param root The project root directory path
+ * @param sourceRoot The source directory path (e.g., 'src')
+ * @param viteServer The Vite development server instance
+ *
+ * Example usage:
+ * await registerDevServerMiddleware('/workspace/my-app', 'src', viteServer);
+ *
+ * Sample middleware file paths that would be discovered:
+ * - /workspace/my-app/src/server/middleware/auth.ts
+ * - /workspace/my-app/src/server/middleware/cors.ts
+ * - /workspace/my-app/src/server/middleware/logging.ts
+ * - /workspace/my-app/src/server/middleware/validation.ts
+ *
+ * tinyglobby vs fast-glob comparison:
+ * - Both support the same glob patterns for file discovery
+ * - Both are efficient for finding middleware files
+ * - tinyglobby is now used instead of fast-glob
+ * - tinyglobby provides similar functionality with smaller bundle size
+ * - tinyglobby's globSync returns absolute paths when absolute: true is set
+ *
+ * globSync options explained:
+ * - dot: true - Includes files/directories that start with a dot (e.g., .env.middleware)
+ * - absolute: true - Returns absolute file paths instead of relative paths
+ *
+ * Middleware execution flow:
+ * 1. Request comes to Vite dev server
+ * 2. Each registered middleware is executed in order
+ * 3. If middleware returns a result, request processing stops
+ * 4. If middleware returns no result, next middleware is called
+ * 5. If no middleware handles the request, it continues to normal Vite processing
+ */
 export declare function registerDevServerMiddleware(root: string, sourceRoot: string, viteServer: ViteDevServer): Promise<void>;

package/src/lib/utils/register-dev-middleware.js

@@ -1,15 +1,64 @@
 import { createEvent } from 'h3';
-import fg from 'fast-glob';
+import { globSync } from 'tinyglobby';
+/**
+ * Registers development server middleware by discovering and loading middleware files.
+ *
+ * This function:
+ * 1. Discovers all TypeScript middleware files in the server/middleware directory
+ * 2. Dynamically loads each middleware module using Vite's SSR module loader
+ * 3. Registers each middleware handler with the Vite development server
+ * 4. Handles middleware execution flow and error handling
+ *
+ * @param root The project root directory path
+ * @param sourceRoot The source directory path (e.g., 'src')
+ * @param viteServer The Vite development server instance
+ *
+ * Example usage:
+ * await registerDevServerMiddleware('/workspace/my-app', 'src', viteServer);
+ *
+ * Sample middleware file paths that would be discovered:
+ * - /workspace/my-app/src/server/middleware/auth.ts
+ * - /workspace/my-app/src/server/middleware/cors.ts
+ * - /workspace/my-app/src/server/middleware/logging.ts
+ * - /workspace/my-app/src/server/middleware/validation.ts
+ *
+ * tinyglobby vs fast-glob comparison:
+ * - Both support the same glob patterns for file discovery
+ * - Both are efficient for finding middleware files
+ * - tinyglobby is now used instead of fast-glob
+ * - tinyglobby provides similar functionality with smaller bundle size
+ * - tinyglobby's globSync returns absolute paths when absolute: true is set
+ *
+ * globSync options explained:
+ * - dot: true - Includes files/directories that start with a dot (e.g., .env.middleware)
+ * - absolute: true - Returns absolute file paths instead of relative paths
+ *
+ * Middleware execution flow:
+ * 1. Request comes to Vite dev server
+ * 2. Each registered middleware is executed in order
+ * 3. If middleware returns a result, request processing stops
+ * 4. If middleware returns no result, next middleware is called
+ * 5. If no middleware handles the request, it continues to normal Vite processing
+ */
 export async function registerDevServerMiddleware(root, sourceRoot, viteServer) {
-    const middlewareFiles = fg.sync([
-        `${root}/${sourceRoot}/server/middleware/**/*.ts`,
-    ]);
+    // Discover all TypeScript middleware files in the server/middleware directory
+    // Pattern: looks for any .ts files in server/middleware/**/*.ts
+    const middlewareFiles = globSync([`${root}/${sourceRoot}/server/middleware/**/*.ts`], {
+        dot: true,
+        absolute: true,
+    });
+    // Register each discovered middleware file with the Vite dev server
     middlewareFiles.forEach((file) => {
         viteServer.middlewares.use(async (req, res, next) => {
+            // Dynamically load the middleware module using Vite's SSR module loader
+            // This allows for hot module replacement during development
             const middlewareHandler = await viteServer
                 .ssrLoadModule(file)
                 .then((m) => m.default);
+            // Execute the middleware handler with the request/response event
             const result = await middlewareHandler(createEvent(req, res));
+            // If middleware doesn't return a result, continue to next middleware
+            // If middleware returns a result, stop processing (middleware handled the request)
             if (!result) {
                 next();
             }

package/src/lib/utils/register-dev-middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-dev-middleware.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/register-dev-middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,MAAM,WAAW,CAAC;AAE3B,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAY,EACZ,UAAkB,EAClB,UAAyB;IAEzB,MAAM,eAAe,GAAG,EAAE,CAAC,IAAI,CAAC;QAC9B,GAAG,IAAI,IAAI,UAAU,4BAA4B;KAClD,CAAC,CAAC;IAEH,eAAe,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/B,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAClD,MAAM,iBAAiB,GAAiB,MAAM,UAAU;iBACrD,aAAa,CAAC,IAAI,CAAC;iBACnB,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE,CAAE,CAA+B,CAAC,OAAO,CAAC,CAAC;YAElE,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAE9D,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,EAAE,CAAC;YACT,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"register-dev-middleware.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-nitro/src/lib/utils/register-dev-middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAY,EACZ,UAAkB,EAClB,UAAyB;IAEzB,8EAA8E;IAC9E,gEAAgE;IAChE,MAAM,eAAe,GAAG,QAAQ,CAC9B,CAAC,GAAG,IAAI,IAAI,UAAU,4BAA4B,CAAC,EACnD;QACE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,IAAI;KACf,CACF,CAAC;IAEF,oEAAoE;IACpE,eAAe,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/B,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAClD,wEAAwE;YACxE,4DAA4D;YAC5D,MAAM,iBAAiB,GAAiB,MAAM,UAAU;iBACrD,aAAa,CAAC,IAAI,CAAC;iBACnB,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE,CAAE,CAA+B,CAAC,OAAO,CAAC,CAAC;YAElE,iEAAiE;YACjE,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAE9D,qEAAqE;YACrE,mFAAmF;YACnF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,EAAE,CAAC;YACT,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}