@chuckcchen/vite-plugin 0.0.2

package/dist/bundler.d.ts

@@ -0,0 +1,66 @@
+/**
+ * EdgeOne Vite Plugin Adapter - 服务端打包模块
+ *
+ * 本模块负责使用 esbuild 打包服务端代码，主要功能包括：
+ * - 将框架的服务端构建产物打包成单个文件
+ * - 生成 HTTP 请求处理的包装器代码
+ * - 处理 Node.js 请求到 Web API Request 的转换
+ */
+import * as esbuild from "esbuild";
+import type { BuildContext, ServerBundleConfig, ServerWrapperConfig } from "./types.js";
+/**
+ * 使用 esbuild 打包服务端代码
+ *
+ * 将服务端入口文件及其所有依赖打包成单个 JavaScript 文件，
+ * 以便在 EdgeOne 边缘函数环境中运行
+ *
+ * @param context - 构建上下文，包含项目根目录和日志工具
+ * @param config - 打包配置，包含入口点、输出路径等
+ * @returns esbuild 的构建结果，包含元数据信息
+ *
+ * @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>;
+/**
+ * 创建服务端包装器文件
+ *
+ * 将框架的服务端构建产物包装成一个统一的 HTTP 请求处理器，
+ * 该包装器负责：
+ * 1. 将 Node.js 的 IncomingMessage 转换为 Web API 的 Request 对象
+ * 2. 调用框架的请求处理函数
+ * 3. 导出统一的请求处理接口
+ *
+ * @param context - 构建上下文
+ * @param config - 包装器配置
+ * @returns 生成的临时包装器文件路径
+ *
+ * @example
+ * const wrapperPath = await createServerWrapper(context, {
+ *   serverEntryPath: 'build/server/index.js'
+ * });
+ */
+export declare function createServerWrapper(context: BuildContext, config: ServerWrapperConfig): Promise<string>;
+/**
+ * 清理临时包装器文件
+ * 在打包完成后删除临时生成的包装器文件
+ *
+ * @param wrapperPath - 包装器文件路径
+ */
+export declare function cleanupWrapper(wrapperPath: string): Promise<void>;
+/**
+ * 获取打包结果的文件大小
+ *
+ * @param result - esbuild 的构建结果
+ * @returns 打包后的文件大小（字节），如果无法获取则返回 0
+ *
+ * @example
+ * const result = await bundleServerCode(context, config);
+ * const size = getBundleSize(result);
+ * console.log(`打包大小: ${formatSize(size)}`);
+ */
+export declare function getBundleSize(result: esbuild.BuildResult): number;
+//# sourceMappingURL=bundler.d.ts.map

package/dist/bundler.d.ts.map

@@ -0,0 +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"}

package/dist/bundler.js

@@ -0,0 +1,229 @@
+/**
+ * EdgeOne Vite Plugin Adapter - 服务端打包模块
+ *
+ * 本模块负责使用 esbuild 打包服务端代码，主要功能包括：
+ * - 将框架的服务端构建产物打包成单个文件
+ * - 生成 HTTP 请求处理的包装器代码
+ * - 处理 Node.js 请求到 Web API Request 的转换
+ */
+import * as esbuild from "esbuild";
+import path from "path";
+import { readFile, writeFile, deleteFile, ensureDirectory } from "./utils.js";
+/**
+ * 默认的 ESM 兼容性代码头
+ * 用于在 ESM 模块中提供 CommonJS 的 require、__filename、__dirname 支持
+ * 这是因为某些依赖可能仍然使用 CommonJS 语法
+ */
+const DEFAULT_BANNER = `import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const __filename = new URL('', import.meta.url).pathname;
+const __dirname = new URL('.', import.meta.url).pathname;`;
+/**
+ * 使用 esbuild 打包服务端代码
+ *
+ * 将服务端入口文件及其所有依赖打包成单个 JavaScript 文件，
+ * 以便在 EdgeOne 边缘函数环境中运行
+ *
+ * @param context - 构建上下文，包含项目根目录和日志工具
+ * @param config - 打包配置，包含入口点、输出路径等
+ * @returns esbuild 的构建结果，包含元数据信息
+ *
+ * @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("正在打包服务端代码...");
+    // 确保输出目录存在
+    await ensureDirectory(path.dirname(config.outfile));
+    // 使用 esbuild 进行打包
+    const result = await esbuild.build({
+        entryPoints: config.entryPoints, // 入口文件列表
+        bundle: true, // 启用打包模式，将所有依赖打包到一起
+        platform: "node", // 目标平台为 Node.js
+        target: "node18", // 目标 Node.js 版本
+        format: "esm", // 输出格式为 ESM
+        outfile: config.outfile, // 输出文件路径
+        minify: false, // 不压缩代码，便于调试
+        treeShaking: true, // 启用 Tree Shaking 移除未使用的代码
+        external: ["node:*", ...(config.external || [])], // 排除 Node.js 内置模块
+        metafile: true, // 生成元数据文件，用于分析打包结果
+        logLevel: "warning", // 日志级别
+        absWorkingDir: projectRoot, // 工作目录
+        banner: {
+            js: DEFAULT_BANNER, // 添加 ESM 兼容性代码头
+        },
+        ...config.esbuildOptions, // 合并额外的 esbuild 配置
+    });
+    logger.verbose(`服务端代码已打包到: ${config.outfile}`);
+    return result;
+}
+/**
+ * 创建服务端包装器文件
+ *
+ * 将框架的服务端构建产物包装成一个统一的 HTTP 请求处理器，
+ * 该包装器负责：
+ * 1. 将 Node.js 的 IncomingMessage 转换为 Web API 的 Request 对象
+ * 2. 调用框架的请求处理函数
+ * 3. 导出统一的请求处理接口
+ *
+ * @param context - 构建上下文
+ * @param config - 包装器配置
+ * @returns 生成的临时包装器文件路径
+ *
+ * @example
+ * const wrapperPath = await createServerWrapper(context, {
+ *   serverEntryPath: 'build/server/index.js'
+ * });
+ */
+export async function createServerWrapper(context, config) {
+    const { projectRoot, logger } = context;
+    logger.verbose("正在创建服务端包装器...");
+    // 读取原始服务端构建内容
+    const serverBuildContent = await readFile(config.serverEntryPath);
+    // 生成包装器内容
+    let wrapperContent;
+    if (config.wrapperTemplate) {
+        // 使用自定义模板，替换占位符
+        wrapperContent = config.wrapperTemplate.replace("{{SERVER_BUILD_CONTENT}}", serverBuildContent);
+    }
+    else {
+        // 使用默认包装器模板
+        wrapperContent = generateDefaultWrapper(serverBuildContent, config);
+    }
+    // 写入临时文件
+    const tempPath = path.join(projectRoot, "server-wrapper.temp.js");
+    await writeFile(tempPath, wrapperContent);
+    logger.verbose("服务端包装器创建完成");
+    return tempPath;
+}
+/**
+ * 清理临时包装器文件
+ * 在打包完成后删除临时生成的包装器文件
+ *
+ * @param wrapperPath - 包装器文件路径
+ */
+export async function cleanupWrapper(wrapperPath) {
+    try {
+        await deleteFile(wrapperPath);
+    }
+    catch {
+        // 忽略删除错误（文件可能不存在）
+    }
+}
+/**
+ * 生成默认的服务端包装器代码
+ *
+ * 包装器代码包含：
+ * 1. 原始服务端构建内容
+ * 2. Node.js 请求到 Web Request 的转换函数
+ * 3. 统一的请求处理器导出
+ *
+ * @param serverBuildContent - 服务端构建的原始代码内容
+ * @param config - 包装器配置
+ * @returns 生成的包装器代码字符串
+ */
+function generateDefaultWrapper(serverBuildContent, config) {
+    const banner = config.banner || "";
+    const exports = config.exports || [];
+    // 构建导出语句
+    const exportsStr = exports.length > 0
+        ? exports.join(", ")
+        : "default as handler";
+    return `// ========== 服务端构建内容 ==========
+${serverBuildContent}
+
+// ========== HTTP 服务端包装器 ==========
+${banner}
+
+/**
+ * 将 Node.js IncomingMessage 转换为 Web API Request
+ * 
+ * EdgeOne 边缘函数使用 Web API 标准的 Request/Response，
+ * 但某些框架的服务端构建可能期望 Node.js 风格的请求对象，
+ * 此函数负责进行转换
+ * 
+ * @param nodeReq - Node.js 的 IncomingMessage 对象
+ * @returns Web API 的 Request 对象
+ */
+function nodeRequestToWebRequest(nodeReq) {
+  // 构建完整的 URL
+  // 根据连接是否加密判断协议
+  const protocol = nodeReq.connection?.encrypted ? 'https' : 'http';
+  const host = nodeReq.headers.host || 'localhost';
+  const url = \`\${protocol}://\${host}\${nodeReq.url}\`;
+
+  // 转换请求头
+  // Node.js 的 headers 是普通对象，需要转换为 Headers 实例
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(nodeReq.headers)) {
+    if (value) {
+      if (Array.isArray(value)) {
+        // 多值头部（如 Set-Cookie）需要多次 append
+        value.forEach(v => headers.append(key, v));
+      } else {
+        headers.set(key, value);
+      }
+    }
+  }
+
+  // 构建 Request 初始化选项
+  const init = {
+    method: nodeReq.method,
+    headers: headers,
+  };
+
+  // 对于非 GET/HEAD 请求，添加请求体
+  // GET 和 HEAD 请求不应该有请求体
+  if (nodeReq.method !== 'GET' && nodeReq.method !== 'HEAD') {
+    init.body = nodeReq;
+  }
+
+  return new Request(url, init);
+}
+
+/**
+ * Node.js 请求处理器包装函数
+ * 
+ * 这是导出给 EdgeOne 边缘函数调用的主入口
+ * 负责将 Node.js 请求转换后传递给框架的处理函数
+ * 
+ * @param nodeReq - Node.js 的请求对象
+ * @param args - 其他参数（如环境变量、上下文等）
+ * @returns 框架处理函数的返回值（通常是 Response 对象）
+ */
+async function nodeRequestHandler(nodeReq, ...args) {
+  const webRequest = nodeRequestToWebRequest(nodeReq);
+  return handler(webRequest, ...args);
+}
+
+export default nodeRequestHandler;
+export { ${exportsStr} };
+`;
+}
+/**
+ * 获取打包结果的文件大小
+ *
+ * @param result - esbuild 的构建结果
+ * @returns 打包后的文件大小（字节），如果无法获取则返回 0
+ *
+ * @example
+ * const result = await bundleServerCode(context, config);
+ * const size = getBundleSize(result);
+ * console.log(`打包大小: ${formatSize(size)}`);
+ */
+export function getBundleSize(result) {
+    // 需要 metafile 才能获取大小信息
+    if (!result.metafile)
+        return 0;
+    const outputs = result.metafile.outputs;
+    const outputKeys = Object.keys(outputs);
+    if (outputKeys.length === 0)
+        return 0;
+    // 返回第一个输出文件的大小
+    return outputs[outputKeys[0]].bytes;
+}
+//# sourceMappingURL=bundler.js.map

package/dist/bundler.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,35 @@
+/**
+ * EdgeOne Vite Plugin Adapter - 核心插件模块
+ *
+ * 本模块是整个适配器系统的核心，负责：
+ * - 构建产物检测：自动识别客户端和服务端的构建输出
+ * - 静态资源复制：将客户端构建产物复制到部署目录
+ * - 服务端代码打包：将服务端代码打包成单文件
+ * - 路由配置生成：根据框架特性生成路由信息
+ * - Meta.json 生成：生成 EdgeOne 部署所需的配置文件
+ */
+import type { Plugin } from "vite";
+import type { CoreAdapterOptions } from "./types.js";
+/**
+ * 创建 EdgeOne 核心适配器插件
+ *
+ * 这是创建适配器的主要入口函数，返回一个 Vite 插件实例。
+ * 该插件会在 Vite 构建完成后执行，处理构建产物并生成部署配置。
+ *
+ * @param options - 适配器配置选项
+ * @returns Vite 插件实例
+ *
+ * @example
+ * // 基本用法
+ * createCoreAdapter({ verbose: true })
+ *
+ * @example
+ * // 使用框架适配器
+ * createCoreAdapter({
+ *   adapter: myFrameworkAdapter,
+ *   outputDir: '.edgeone'
+ * })
+ */
+export declare function createCoreAdapter(options?: CoreAdapterOptions): Plugin;
+export default createCoreAdapter;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,MAAM,CAAC;AAEnD,OAAO,KAAK,EACV,kBAAkB,EAOnB,MAAM,YAAY,CAAC;AAepB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAmI1E;AAyRD,eAAe,iBAAiB,CAAC"}