@chuckcchen/vite-plugin 1.0.2 → 1.0.4

package/dist/bundler.d.ts

@@ -1,66 +1,24 @@
 /**
  * EdgeOne Vite Plugin Adapter - Server Bundling Module
  *
- * This module handles server-side code bundling using esbuild, main features include:
+ * Handles server-side code bundling using esbuild:
  * - Bundle framework's server build artifacts into a single file
  * - Generate HTTP request handling wrapper code
- * - Handle Node.js request to Web API Request conversion
  */
 import * as esbuild from "esbuild";
 import type { BuildContext, ServerBundleConfig, ServerWrapperConfig } from "./types.js";
 /**
  * Bundle server code using esbuild
- *
- * Bundle server entry file and all dependencies into a single JavaScript file
- * for running in EdgeOne edge function environment
- *
- * @param context - Build context containing project root and logger
- * @param config - Bundle configuration including entry points, output path, etc.
- * @returns esbuild build result containing metadata info
- *
- * @example
- * await bundleServerCode(context, {
- *   entryPoints: ['server-wrapper.temp.js'],
- *   outfile: '.edgeone/server-handler/handler.js'
- * });
  */
 export declare function bundleServerCode(context: BuildContext, config: ServerBundleConfig): Promise<esbuild.BuildResult>;
 /**
  * Create server wrapper file
  *
- * Wrap framework's server build artifacts into a unified HTTP request handler.
- * The wrapper is responsible for:
- * 1. Converting Node.js IncomingMessage to Web API Request object
- * 2. Calling framework's request handler function
- * 3. Exporting unified request handling interface
- *
- * @param context - Build context
- * @param config - Wrapper configuration
- * @returns Path to generated temporary wrapper file
- *
- * @example
- * const wrapperPath = await createServerWrapper(context, {
- *   serverEntryPath: 'build/server/index.js'
- * });
+ * Wraps framework's server build into a unified HTTP request handler.
  */
 export declare function createServerWrapper(context: BuildContext, config: ServerWrapperConfig): Promise<string>;
 /**
  * Cleanup temporary wrapper file
- * Delete temporarily generated wrapper file after bundling completes
- *
- * @param wrapperPath - Wrapper file path
  */
 export declare function cleanupWrapper(wrapperPath: string): Promise<void>;
-/**
- * Get bundle result file size
- *
- * @param result - esbuild build result
- * @returns Bundled file size in bytes, returns 0 if unavailable
- *
- * @example
- * const result = await bundleServerCode(context, config);
- * const size = getBundleSize(result);
- * console.log(`Bundle size: ${formatSize(size)}`);
- */
-export declare function getBundleSize(result: esbuild.BuildResult): number;
 //# sourceMappingURL=bundler.d.ts.map

package/dist/bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAaxF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CA+B9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;AAkGD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,GAAG,MAAM,CAWjE"}
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAYxF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CA6B9B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE"}

package/dist/bundler.js

@@ -1,18 +1,16 @@
 /**
  * EdgeOne Vite Plugin Adapter - Server Bundling Module
  *
- * This module handles server-side code bundling using esbuild, main features include:
+ * Handles server-side code bundling using esbuild:
  * - Bundle framework's server build artifacts into a single file
  * - Generate HTTP request handling wrapper code
- * - Handle Node.js request to Web API Request conversion
  */
 import * as esbuild from "esbuild";
 import path from "path";
-import { readFile, writeFile, deleteFile, ensureDirectory } from "./utils.js";
+import { writeFile, deleteFile, ensureDirectory, generateServerWrapperCode } from "./utils.js";
 /**
  * Default ESM compatibility banner code
  * Provides CommonJS require, __filename, __dirname support in ESM modules
- * This is because some dependencies may still use CommonJS syntax
  */
 const DEFAULT_BANNER = `import { createRequire } from 'node:module';
 const require = createRequire(import.meta.url);
@@ -20,43 +18,28 @@ const __filename = new URL('', import.meta.url).pathname;
 const __dirname = new URL('.', import.meta.url).pathname;`;
 /**
  * Bundle server code using esbuild
- *
- * Bundle server entry file and all dependencies into a single JavaScript file
- * for running in EdgeOne edge function environment
- *
- * @param context - Build context containing project root and logger
- * @param config - Bundle configuration including entry points, output path, etc.
- * @returns esbuild build result containing metadata info
- *
- * @example
- * await bundleServerCode(context, {
- *   entryPoints: ['server-wrapper.temp.js'],
- *   outfile: '.edgeone/server-handler/handler.js'
- * });
  */
 export async function bundleServerCode(context, config) {
     const { projectRoot, logger } = context;
     logger.verbose("Bundling server code...");
-    // Ensure output directory exists
     await ensureDirectory(path.dirname(config.outfile));
-    // Bundle using esbuild
     const result = await esbuild.build({
-        entryPoints: config.entryPoints, // Entry file list
-        bundle: true, // Enable bundling, pack all dependencies together
-        platform: "node", // Target platform is Node.js
-        target: "node18", // Target Node.js version
-        format: "esm", // Output format is ESM
-        outfile: config.outfile, // Output file path
-        minify: false, // Don't minify for easier debugging
-        treeShaking: true, // Enable tree shaking to remove unused code
-        external: ["node:*", ...(config.external || [])], // Exclude Node.js built-in modules
-        metafile: true, // Generate metafile for bundle analysis
-        logLevel: "warning", // Log level
-        absWorkingDir: projectRoot, // Working directory
+        entryPoints: config.entryPoints,
+        bundle: true,
+        platform: "node",
+        target: "node18",
+        format: "esm",
+        outfile: config.outfile,
+        minify: false,
+        treeShaking: true,
+        external: ["node:*", ...(config.external || [])],
+        metafile: true,
+        logLevel: "warning",
+        absWorkingDir: projectRoot,
         banner: {
-            js: DEFAULT_BANNER, // Add ESM compatibility banner
+            js: DEFAULT_BANNER,
         },
-        ...config.esbuildOptions, // Merge additional esbuild options
+        ...config.esbuildOptions,
     });
     logger.verbose(`Server code bundled to: ${config.outfile}`);
     return result;
@@ -64,37 +47,28 @@ export async function bundleServerCode(context, config) {
 /**
  * Create server wrapper file
  *
- * Wrap framework's server build artifacts into a unified HTTP request handler.
- * The wrapper is responsible for:
- * 1. Converting Node.js IncomingMessage to Web API Request object
- * 2. Calling framework's request handler function
- * 3. Exporting unified request handling interface
- *
- * @param context - Build context
- * @param config - Wrapper configuration
- * @returns Path to generated temporary wrapper file
- *
- * @example
- * const wrapperPath = await createServerWrapper(context, {
- *   serverEntryPath: 'build/server/index.js'
- * });
+ * Wraps framework's server build into a unified HTTP request handler.
  */
 export async function createServerWrapper(context, config) {
     const { projectRoot, logger } = context;
     logger.verbose("Creating server wrapper...");
-    // Read original server build content
-    const serverBuildContent = await readFile(config.serverEntryPath);
-    // Generate wrapper content
     let wrapperContent;
     if (config.wrapperTemplate) {
-        // Use custom template, replace placeholders
+        // Use custom template
+        const { readFile } = await import("./utils.js");
+        const serverBuildContent = await readFile(config.serverEntryPath);
         wrapperContent = config.wrapperTemplate.replace("{{SERVER_BUILD_CONTENT}}", serverBuildContent);
     }
     else {
-        // Use default wrapper template
-        wrapperContent = generateDefaultWrapper(serverBuildContent, config);
+        // Use generateServerWrapperCode from utils
+        wrapperContent = await generateServerWrapperCode({
+            serverEntryPath: config.serverEntryPath,
+            handlerSetup: config.banner || "",
+            handlerCall: "handler(webRequest, ...args)",
+            mode: "inline",
+            additionalExports: config.exports,
+        });
     }
-    // Write to temporary file
     const tempPath = path.join(projectRoot, "server-wrapper.temp.js");
     await writeFile(tempPath, wrapperContent);
     logger.verbose("Server wrapper created");
@@ -102,128 +76,13 @@ export async function createServerWrapper(context, config) {
 }
 /**
  * Cleanup temporary wrapper file
- * Delete temporarily generated wrapper file after bundling completes
- *
- * @param wrapperPath - Wrapper file path
  */
 export async function cleanupWrapper(wrapperPath) {
     try {
         await deleteFile(wrapperPath);
     }
     catch {
-        // Ignore delete errors (file may not exist)
+        // Ignore delete errors
     }
 }
-/**
- * Generate default server wrapper code
- *
- * Wrapper code contains:
- * 1. Original server build content
- * 2. Node.js request to Web Request conversion function
- * 3. Unified request handler export
- *
- * @param serverBuildContent - Original server build code content
- * @param config - Wrapper configuration
- * @returns Generated wrapper code string
- */
-function generateDefaultWrapper(serverBuildContent, config) {
-    const banner = config.banner || "";
-    const exports = config.exports || [];
-    // Build export statement
-    const exportsStr = exports.length > 0
-        ? exports.join(", ")
-        : "default as handler";
-    return `// ========== Server Build Content ==========
-${serverBuildContent}
-
-// ========== HTTP Server Wrapper ==========
-${banner}
-
-/**
- * Convert Node.js IncomingMessage to Web API Request
- * 
- * EdgeOne edge functions use Web API standard Request/Response,
- * but some framework server builds may expect Node.js style request objects.
- * This function handles the conversion.
- * 
- * @param nodeReq - Node.js IncomingMessage object
- * @returns Web API Request object
- */
-function nodeRequestToWebRequest(nodeReq) {
-  // Build complete URL
-  // Determine protocol based on whether connection is encrypted
-  const protocol = nodeReq.connection?.encrypted ? 'https' : 'http';
-  const host = nodeReq.headers.host || 'localhost';
-  const url = \`\${protocol}://\${host}\${nodeReq.url}\`;
-
-  // Convert request headers
-  // Node.js headers are plain objects, need to convert to Headers instance
-  const headers = new Headers();
-  for (const [key, value] of Object.entries(nodeReq.headers)) {
-    if (value) {
-      if (Array.isArray(value)) {
-        // Multi-value headers (like Set-Cookie) need multiple appends
-        value.forEach(v => headers.append(key, v));
-      } else {
-        headers.set(key, value);
-      }
-    }
-  }
-
-  // Build Request init options
-  const init = {
-    method: nodeReq.method,
-    headers: headers,
-  };
-
-  // Add request body for non-GET/HEAD requests
-  // GET and HEAD requests should not have body
-  if (nodeReq.method !== 'GET' && nodeReq.method !== 'HEAD') {
-    init.body = nodeReq;
-  }
-
-  return new Request(url, init);
-}
-
-/**
- * Node.js request handler wrapper function
- * 
- * This is the main entry exported for EdgeOne edge functions to call.
- * Responsible for converting Node.js request before passing to framework handler.
- * 
- * @param nodeReq - Node.js request object
- * @param args - Other arguments (e.g. env variables, context, etc.)
- * @returns Framework handler return value (usually Response object)
- */
-async function nodeRequestHandler(nodeReq, ...args) {
-  const webRequest = nodeRequestToWebRequest(nodeReq);
-  return handler(webRequest, ...args);
-}
-
-export default nodeRequestHandler;
-export { ${exportsStr} };
-`;
-}
-/**
- * Get bundle result file size
- *
- * @param result - esbuild build result
- * @returns Bundled file size in bytes, returns 0 if unavailable
- *
- * @example
- * const result = await bundleServerCode(context, config);
- * const size = getBundleSize(result);
- * console.log(`Bundle size: ${formatSize(size)}`);
- */
-export function getBundleSize(result) {
-    // Need metafile to get size info
-    if (!result.metafile)
-        return 0;
-    const outputs = result.metafile.outputs;
-    const outputKeys = Object.keys(outputs);
-    if (outputKeys.length === 0)
-        return 0;
-    // Return size of first output file
-    return outputs[outputKeys[0]].bytes;
-}
 //# sourceMappingURL=bundler.js.map

package/dist/bundler.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"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"}

package/dist/factory.d.ts

@@ -1,19 +1,17 @@
 /**
  * Adapter Factory - Simplifies the creation of framework adapters
  *
- * Provides factory functions and preset configurations to reduce boilerplate code in adapter development
+ * Provides factory functions and preset configurations to reduce boilerplate code
  */
-import type { BuildContext, FrameworkAdapter, AdapterHooks } from "./types.js";
+import type { BuildContext, FrameworkAdapter } from "./types.js";
 /**
  * Server wrapper preset configuration
  */
 export interface ServerWrapperPreset {
-    /** Additional import statements */
     imports?: string;
-    /** Handler initialization code */
     handlerSetup: string;
-    /** Handler call expression */
     handlerCall: string;
+    requiresHtmlTemplate?: boolean;
 }
 /**
  * Built-in server wrapper presets
@@ -35,90 +33,65 @@ export declare const SERVER_WRAPPER_PRESETS: {
         readonly handlerSetup: string;
         readonly handlerCall: "requestHandler(webRequest, ...args)";
     };
+    /** Vite SSR - standard Vite SSR with render function */
+    readonly viteSSR: {
+        readonly requiresHtmlTemplate: true;
+        readonly handlerSetup: string;
+        readonly handlerCall: "handleSSRRequest(webRequest)";
+    };
 };
 /**
  * Build directory configuration
  */
 export interface BuildDirConfig {
-    /** Client directory candidates */
     client: string[];
-    /** Server directory candidates (SSR mode) */
     server?: string[];
 }
 /**
  * Adapter factory configuration
  */
 export interface AdapterFactoryConfig {
-    /** Adapter name */
     name: string;
-    /** Config file detection list */
     configFiles: string[];
-    /** Build directory candidates configuration */
     buildDirs: BuildDirConfig;
-    /** Server entry file candidates */
     serverEntryFiles?: string[];
-    /** Server wrapper configuration (use preset name or custom config) */
     serverWrapper?: keyof typeof SERVER_WRAPPER_PRESETS | ServerWrapperPreset;
-    /** Default routes list */
     defaultRoutes?: string[];
-    /** Extra routes for SSR mode */
     ssrExtraRoutes?: string[];
-    /** Custom ssr404 handling */
     ssr404?: boolean | ((isSSR: boolean) => boolean);
+    htmlTemplatePaths?: string[];
 }
 /**
  * Adapter factory runtime options
  */
 export interface AdapterFactoryOptions {
-    /** User-specified client directory */
     clientBuildDir?: string;
-    /** User-specified server directory */
     serverBuildDir?: string;
-    /** User-specified server entry */
     serverEntry?: string;
-    /** User-specified routes */
     routes?: string[];
 }
 /**
  * Create a framework adapter
- *
- * @example
- * ```ts
- * const adapter = createFrameworkAdapter({
- *   name: "my-framework",
- *   configFiles: ["my-framework.config.ts", "my-framework.config.js"],
- *   buildDirs: {
- *     client: ["dist/client", "dist"],
- *     server: ["dist/server"],
- *   },
- *   serverWrapper: "generic",
- * });
- * ```
  */
 export declare function createFrameworkAdapter(config: AdapterFactoryConfig, options?: AdapterFactoryOptions, overrides?: Partial<FrameworkAdapter>): FrameworkAdapter;
 /**
- * Create a stateful adapter
- * Used for complex adapters that need to share state between different hooks
+ * Create a stateful adapter (for complex adapters needing shared state)
  */
 export declare function createStatefulAdapter<TState extends object>(initialState: TState, factory: (state: TState) => FrameworkAdapter): FrameworkAdapter;
 /**
- * Compose multiple hooks
+ * Combine multiple detector functions (returns true if any matches)
  */
-export declare function composeHooks(...hooksList: (AdapterHooks | undefined)[]): AdapterHooks;
+export declare function combineDetectors(...detectors: ((context: BuildContext) => Promise<boolean> | boolean)[]): (context: BuildContext) => Promise<boolean>;
 /**
- * Create a detector function - based on config files
+ * Create detector based on config files
  */
 export declare function createConfigDetector(configFiles: string[]): (context: BuildContext) => Promise<boolean>;
 /**
- * Create a detector function - based on build directories
+ * Create detector based on build directories
  */
 export declare function createBuildDirDetector(buildDirs: string[]): (context: BuildContext) => Promise<boolean>;
 /**
- * Create a detector function - based on package.json dependencies
+ * Create detector based on package.json dependencies
  */
 export declare function createDependencyDetector(dependencies: string[]): (context: BuildContext) => Promise<boolean>;
-/**
- * Combine multiple detector functions (returns true if any matches)
- */
-export declare function combineDetectors(...detectors: ((context: BuildContext) => Promise<boolean> | boolean)[]): (context: BuildContext) => Promise<boolean>;
 //# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,YAAY,EAIZ,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,0DAA0D;;;;;IAa1D,sCAAsC;;;;;IAatC,+CAA+C;;;;;;IAqB/C,wDAAwD;;;;;;CAoChD,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,OAAO,sBAAsB,GAAG,mBAAmB,CAAC;IAC1E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,qBAA0B,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CA0JlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,SAAS,MAAM,EACzD,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAC3C,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,EAAE,IAEzD,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAQvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAC1C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAC1C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,IAC/C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAavD"}