@chuckcchen/vite-plugin 0.0.2

package/dist/core.js

@@ -0,0 +1,384 @@
+/**
+ * EdgeOne Vite Plugin Adapter - 核心插件模块
+ *
+ * 本模块是整个适配器系统的核心，负责：
+ * - 构建产物检测：自动识别客户端和服务端的构建输出
+ * - 静态资源复制：将客户端构建产物复制到部署目录
+ * - 服务端代码打包：将服务端代码打包成单文件
+ * - 路由配置生成：根据框架特性生成路由信息
+ * - Meta.json 生成：生成 EdgeOne 部署所需的配置文件
+ */
+import path from "path";
+import { createLogger, pathExists, copyDirectory, ensureDirectory, writeFile, } from "./utils.js";
+import { bundleServerCode, createServerWrapper, cleanupWrapper, } from "./bundler.js";
+import fs from "fs/promises";
+/**
+ * 创建 EdgeOne 核心适配器插件
+ *
+ * 这是创建适配器的主要入口函数，返回一个 Vite 插件实例。
+ * 该插件会在 Vite 构建完成后执行，处理构建产物并生成部署配置。
+ *
+ * @param options - 适配器配置选项
+ * @returns Vite 插件实例
+ *
+ * @example
+ * // 基本用法
+ * createCoreAdapter({ verbose: true })
+ *
+ * @example
+ * // 使用框架适配器
+ * createCoreAdapter({
+ *   adapter: myFrameworkAdapter,
+ *   outputDir: '.edgeone'
+ * })
+ */
+export function createCoreAdapter(options = {}) {
+    // 解构配置选项，设置默认值
+    const { verbose = false, // 是否启用详细日志
+    outputDir = ".edgeone", // 输出目录
+    cleanOutput = true, // 是否在构建前清理输出目录
+    adapter, // 框架适配器实例
+    hooks = {}, // 自定义钩子函数
+    ssr: ssrOption, // SSR 模式配置
+     } = options;
+    // 创建日志记录器
+    const logger = createLogger(verbose);
+    // 插件状态变量
+    let projectRoot; // 项目根目录
+    let viteConfig; // Vite 解析后的配置
+    let isSSR = false; // 是否为 SSR 模式
+    let isBuildingForSSR = false; // 当前是否正在构建 SSR
+    return {
+        // 插件名称，用于调试和日志
+        name: "vite-plugin-edgeone-adapter",
+        // 仅在构建时应用此插件
+        apply: "build",
+        // 在其他插件之后执行（post 阶段）
+        enforce: "post",
+        /**
+         * Vite 配置解析完成后的钩子
+         * 在这里获取项目配置并检测 SSR 模式
+         */
+        configResolved(config) {
+            projectRoot = config.root;
+            viteConfig = config;
+            // 检测当前构建是否为 SSR 构建
+            // Vite 在 SSR 模式下会设置 build.ssr
+            isBuildingForSSR =
+                config.build.ssr !== false && config.build.ssr !== undefined;
+            // 确定最终的 SSR 状态
+            // 优先使用显式配置，否则从 Vite 配置自动检测
+            if (ssrOption !== undefined) {
+                isSSR = ssrOption;
+            }
+            else {
+                isSSR = isBuildingForSSR;
+            }
+            // 输出调试信息
+            logger.verbose("项目根目录:", projectRoot);
+            logger.verbose("构建类型:", isBuildingForSSR ? "SSR" : "客户端");
+            logger.verbose("SSR 模式:", isSSR);
+        },
+        /**
+         * 构建产物写入完成后的钩子
+         * 这是适配器的主要处理逻辑所在
+         */
+        async writeBundle() {
+            // 如果是 SSR 模式但当前正在构建客户端，则跳过
+            // 等待 SSR 构建完成后再处理
+            // 这是因为 Vite SSR 构建会先构建客户端，再构建服务端
+            if (isSSR && !isBuildingForSSR) {
+                logger.verbose("跳过处理（等待 SSR 构建完成）");
+                return;
+            }
+            // 短暂延迟，确保所有文件都已写入磁盘
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            try {
+                // 创建构建上下文对象
+                // 该对象会传递给所有钩子函数和适配器方法
+                const context = {
+                    projectRoot,
+                    outputDir,
+                    isSSR,
+                    viteConfig,
+                    logger,
+                };
+                // 调用构建前钩子
+                if (hooks.beforeBuild) {
+                    await hooks.beforeBuild(context);
+                }
+                // 检测构建产物
+                let artifacts;
+                if (adapter) {
+                    // 使用框架适配器检测
+                    const shouldUse = await adapter.detect(context);
+                    if (!shouldUse) {
+                        logger.warn(`适配器 ${adapter.name} 检测失败，使用默认配置`);
+                    }
+                    artifacts = await adapter.getBuildArtifacts(context);
+                }
+                else {
+                    // 使用默认检测逻辑
+                    artifacts = await detectBuildArtifacts(context);
+                }
+                // 调用构建后钩子
+                if (hooks.afterBuild) {
+                    await hooks.afterBuild(context, artifacts);
+                }
+                // 清理输出目录
+                if (cleanOutput) {
+                    await cleanOutputDir(context);
+                }
+                // 复制静态资源
+                if (artifacts.clientDir) {
+                    await copyStaticAssets(context, artifacts.clientDir);
+                }
+                // 打包服务端代码（仅 SSR 模式）
+                if (isSSR && artifacts.serverEntry) {
+                    await bundleServer(context, artifacts, adapter);
+                }
+                // 生成 meta.json 配置文件
+                await generateMetaJson(context, adapter);
+                logger.verbose("EdgeOne 适配器处理完成");
+            }
+            catch (error) {
+                logger.error("EdgeOne 适配器处理失败:", error);
+                throw error;
+            }
+        },
+    };
+}
+/**
+ * 使用默认路径检测构建产物
+ *
+ * 当没有提供框架适配器时，使用此函数自动检测常见的构建输出路径。
+ * 支持检测 dist、build 等常见目录结构。
+ *
+ * @param context - 构建上下文
+ * @returns 检测到的构建产物信息
+ */
+async function detectBuildArtifacts(context) {
+    const { projectRoot, logger } = context;
+    // 常见的客户端构建输出路径（按优先级排序）
+    const clientPaths = [
+        path.join(projectRoot, "dist"), // Vite 默认
+        path.join(projectRoot, "build/client"), // React Router 等框架
+        path.join(projectRoot, "build"), // Create React App 等
+    ];
+    // 常见的服务端构建输出路径
+    const serverPaths = [
+        path.join(projectRoot, "dist/server"),
+        path.join(projectRoot, "build/server"),
+    ];
+    // 常见的服务端入口文件路径
+    const serverEntryPaths = [
+        path.join(projectRoot, "dist/server/index.js"),
+        path.join(projectRoot, "build/server/index.js"),
+    ];
+    let clientDir = null;
+    let serverDir = null;
+    let serverEntry = null;
+    // 查找客户端构建目录
+    for (const p of clientPaths) {
+        if (await pathExists(p)) {
+            clientDir = p;
+            logger.verbose(`找到客户端构建目录: ${p}`);
+            break;
+        }
+    }
+    // 查找服务端构建目录
+    for (const p of serverPaths) {
+        if (await pathExists(p)) {
+            serverDir = p;
+            logger.verbose(`找到服务端构建目录: ${p}`);
+            break;
+        }
+    }
+    // 查找服务端入口文件
+    for (const p of serverEntryPaths) {
+        if (await pathExists(p)) {
+            serverEntry = p;
+            logger.verbose(`找到服务端入口文件: ${p}`);
+            break;
+        }
+    }
+    return {
+        clientDir,
+        serverDir,
+        serverEntry,
+        assetsDir: clientDir, // 静态资源目录通常与客户端目录相同
+    };
+}
+/**
+ * 清理输出目录
+ *
+ * 在每次构建前清理之前的输出，确保输出目录是干净的。
+ * 只清理特定的子目录，不会删除整个输出目录。
+ *
+ * @param context - 构建上下文
+ */
+async function cleanOutputDir(context) {
+    const { projectRoot, outputDir, logger } = context;
+    const outputPath = path.join(projectRoot, outputDir);
+    // 需要清理的路径列表
+    const pathsToClean = [
+        path.join(outputPath, "assets"), // 静态资源目录
+        path.join(outputPath, "server-handler"), // 服务端处理器目录
+        path.join(outputPath, "meta.json"), // 元数据配置文件
+    ];
+    // 逐个删除
+    for (const p of pathsToClean) {
+        try {
+            await fs.rm(p, { recursive: true, force: true });
+        }
+        catch {
+            // 忽略删除错误（如路径不存在）
+        }
+    }
+    // 确保输出目录存在
+    await ensureDirectory(outputPath);
+    logger.verbose("已清理输出目录");
+}
+/**
+ * 复制静态资源到输出目录
+ *
+ * 将客户端构建产物（HTML、CSS、JS、图片等）复制到部署目录。
+ * 这些资源将由 EdgeOne CDN 直接提供服务。
+ *
+ * @param context - 构建上下文
+ * @param clientDir - 客户端构建目录路径
+ */
+async function copyStaticAssets(context, clientDir) {
+    const { projectRoot, outputDir, logger } = context;
+    // 目标路径：.edgeone/assets
+    const targetPath = path.join(projectRoot, outputDir, "assets");
+    await copyDirectory(clientDir, targetPath);
+    logger.verbose(`已复制静态资源到 ${outputDir}/assets`);
+}
+/**
+ * 打包服务端代码
+ *
+ * 将框架的服务端构建产物打包成单个 JavaScript 文件，
+ * 以便在 EdgeOne 边缘函数环境中运行。
+ *
+ * 处理流程：
+ * 1. 创建服务端包装器（处理请求转换）
+ * 2. 使用 esbuild 打包
+ * 3. 清理临时文件
+ *
+ * @param context - 构建上下文
+ * @param artifacts - 构建产物信息
+ * @param adapter - 框架适配器（可选）
+ */
+async function bundleServer(context, artifacts, adapter) {
+    const { projectRoot, outputDir, logger } = context;
+    // 检查服务端入口是否存在
+    if (!artifacts.serverEntry) {
+        logger.warn("未找到服务端入口文件，跳过服务端打包");
+        return;
+    }
+    // 输出路径配置
+    const outputPath = path.join(projectRoot, outputDir, "server-handler");
+    const outputFile = path.join(outputPath, "handler.js");
+    // 获取适配器钩子
+    const adapterHooks = adapter?.hooks || {};
+    // 包装器配置
+    const wrapperConfig = {
+        serverEntryPath: artifacts.serverEntry,
+    };
+    // 创建服务端包装器
+    let wrapperPath;
+    if (adapterHooks.generateServerWrapper) {
+        // 使用适配器提供的自定义包装器生成逻辑
+        const wrapperContent = await adapterHooks.generateServerWrapper(context, wrapperConfig);
+        wrapperPath = path.join(projectRoot, "server-wrapper.temp.js");
+        await writeFile(wrapperPath, wrapperContent);
+    }
+    else {
+        // 使用默认包装器
+        wrapperPath = await createServerWrapper(context, wrapperConfig);
+    }
+    // 准备打包配置
+    let bundleConfig = {
+        entryPoints: [wrapperPath],
+        outfile: outputFile,
+    };
+    // 调用打包前钩子，允许修改配置
+    if (context.viteConfig && adapterHooks.beforeBundle) {
+        bundleConfig = await adapterHooks.beforeBundle(context, bundleConfig);
+    }
+    // 执行打包
+    await bundleServerCode(context, bundleConfig);
+    // 清理临时包装器文件
+    await cleanupWrapper(wrapperPath);
+    // 调用打包后钩子
+    if (adapterHooks.afterBundle) {
+        await adapterHooks.afterBundle(context, outputFile);
+    }
+    logger.verbose(`服务端代码已打包到 ${outputDir}/server-handler/handler.js`);
+}
+/**
+ * 生成 meta.json 配置文件
+ *
+ * meta.json 是 EdgeOne 部署的核心配置文件，包含：
+ * - 路由信息：告诉 EdgeOne 哪些路径需要 SSR，哪些是静态资源
+ * - HTTP 配置：响应头、重定向、重写、缓存规则
+ * - 404 处理配置
+ *
+ * @param context - 构建上下文
+ * @param adapter - 框架适配器（可选）
+ */
+async function generateMetaJson(context, adapter) {
+    const { projectRoot, outputDir, isSSR, logger } = context;
+    // 生成路由信息
+    let routes = [];
+    const adapterHooks = adapter?.hooks || {};
+    if (adapterHooks.generateRoutes) {
+        // 使用适配器提供的路由生成逻辑
+        routes = await adapterHooks.generateRoutes(context);
+    }
+    else {
+        // 默认：单个根路由
+        routes = [
+            {
+                path: "/",
+                isStatic: !isSSR, // SSR 模式下不是静态路由
+                srcRoute: "/",
+            },
+        ];
+    }
+    // 生成元数据配置
+    let metaConfig;
+    if (adapterHooks.generateMeta) {
+        // 使用适配器提供的元数据生成逻辑
+        metaConfig = await adapterHooks.generateMeta(context, routes);
+    }
+    else {
+        // 使用默认配置
+        metaConfig = {
+            conf: {
+                headers: [], // HTTP 响应头规则
+                redirects: [], // 重定向规则
+                rewrites: [], // URL 重写规则
+                caches: [], // 缓存规则
+                has404: false, // 是否有自定义 404 页面
+                ssr404: isSSR, // 404 是否使用 SSR
+            },
+            has404: false,
+            frameworkRoutes: routes,
+        };
+    }
+    // 将配置转换为 JSON 字符串
+    const metaContent = JSON.stringify(metaConfig, null, 2);
+    // SSR 模式下，在 server-handler 目录也写入一份
+    if (isSSR) {
+        const serverMetaPath = path.join(projectRoot, outputDir, "server-handler", "meta.json");
+        await writeFile(serverMetaPath, metaContent);
+    }
+    // 在输出根目录写入 meta.json
+    const rootMetaPath = path.join(projectRoot, outputDir, "meta.json");
+    await writeFile(rootMetaPath, metaContent);
+    logger.verbose(`meta.json 已生成，包含 ${routes.length} 个路由`);
+}
+export default createCoreAdapter;
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @edgeone/vite-plugin-adapter
+ *
+ * EdgeOne 平台的核心适配器插件
+ *
+ * 本包为构建框架特定适配器提供基础设施，主要功能包括：
+ * - 构建产物检测和处理
+ * - 使用 esbuild 打包服务端代码
+ * - 静态资源管理
+ * - 路由配置生成
+ * - 生成 EdgeOne 部署所需的 meta.json 配置文件
+ *
+ * 使用场景：
+ * 1. 直接使用核心适配器构建自定义适配器
+ * 2. 作为其他框架适配器（如 React Router、TanStack Start）的基础依赖
+ *
+ * @example
+ * ```ts
+ * // 直接使用核心适配器创建自定义适配器
+ * import { createCoreAdapter } from '@edgeone/vite-plugin-adapter';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     createCoreAdapter({
+ *       verbose: true,  // 启用详细日志
+ *       hooks: {
+ *         // 自定义路由生成逻辑
+ *         generateRoutes: async (ctx) => [...],
+ *         // 自定义服务端包装器生成逻辑
+ *         generateServerWrapper: async (ctx, config) => '...',
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+export { createCoreAdapter, default } from "./core.js";
+export { bundleServerCode, // 使用 esbuild 打包服务端代码
+createServerWrapper, // 创建服务端包装器文件
+cleanupWrapper, // 清理临时包装器文件
+getBundleSize, } from "./bundler.js";
+export { createLogger, // 创建日志记录器
+pathExists, // 检查路径是否存在
+findExistingPath, // 从候选列表中找到第一个存在的路径
+copyDirectory, // 递归复制目录
+cleanDirectory, // 清理目录（删除后重建）
+ensureDirectory, // 确保目录存在
+readFile, // 读取文件内容
+writeFile, // 写入文件内容
+deleteFile, // 删除文件
+formatSize, // 格式化文件大小
+waitFor, // 等待条件满足（带重试）
+listFiles, // 列出目录内容
+countFiles, } from "./utils.js";
+export type { RouteInfo, // 路由信息
+MetaConfig, // 元数据配置
+HeaderRule, // HTTP 响应头规则
+RedirectRule, // 重定向规则
+RewriteRule, // URL 重写规则
+CacheRule, // 缓存规则
+BuildContext, // 构建上下文
+Logger, // 日志接口
+BuildArtifacts, // 构建产物信息
+ServerWrapperConfig, // 服务端包装器配置
+ServerBundleConfig, // esbuild 打包配置
+BeforeBuildHook, // 构建前钩子
+AfterBuildHook, // 构建后钩子
+BeforeBundleHook, // 打包前钩子
+AfterBundleHook, // 打包后钩子
+GenerateRoutesHook, // 路由生成钩子
+GenerateMetaHook, // 元数据生成钩子
+GenerateServerWrapperHook, // 服务端包装器生成钩子
+AdapterHooks, // 适配器钩子集合
+FrameworkAdapter, // 框架适配器接口
+CoreAdapterOptions, // 核心适配器选项
+ViteAdapterOptions, // Vite 适配器选项
+ReactRouterAdapterOptions, // React Router 适配器选项
+TanStackStartAdapterOptions, // TanStack Start 适配器选项
+CreateAdapterPlugin, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EACL,gBAAgB,EAAO,qBAAqB;AAC5C,mBAAmB,EAAI,aAAa;AACpC,cAAc,EAAS,YAAY;AACnC,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EAAW,UAAU;AACjC,UAAU,EAAa,WAAW;AAClC,gBAAgB,EAAO,mBAAmB;AAC1C,aAAa,EAAU,SAAS;AAChC,cAAc,EAAS,cAAc;AACrC,eAAe,EAAQ,SAAS;AAChC,QAAQ,EAAe,SAAS;AAChC,SAAS,EAAc,SAAS;AAChC,UAAU,EAAa,OAAO;AAC9B,UAAU,EAAa,UAAU;AACjC,OAAO,EAAgB,cAAc;AACrC,SAAS,EAAc,SAAS;AAChC,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EAEV,SAAS,EAAc,OAAO;AAC9B,UAAU,EAAa,QAAQ;AAC/B,UAAU,EAAa,aAAa;AACpC,YAAY,EAAW,QAAQ;AAC/B,WAAW,EAAY,WAAW;AAClC,SAAS,EAAc,OAAO;AAC9B,YAAY,EAAW,QAAQ;AAC/B,MAAM,EAAiB,OAAO;AAC9B,cAAc,EAAS,SAAS;AAGhC,mBAAmB,EAAI,WAAW;AAClC,kBAAkB,EAAK,eAAe;AAGtC,eAAe,EAAQ,QAAQ;AAC/B,cAAc,EAAS,QAAQ;AAC/B,gBAAgB,EAAO,QAAQ;AAC/B,eAAe,EAAQ,QAAQ;AAC/B,kBAAkB,EAAK,SAAS;AAChC,gBAAgB,EAAO,UAAU;AACjC,yBAAyB,EAAG,aAAa;AACzC,YAAY,EAAW,UAAU;AAGjC,gBAAgB,EAAO,UAAU;AACjC,kBAAkB,EAAK,UAAU;AACjC,kBAAkB,EAAK,aAAa;AACpC,yBAAyB,EAAM,qBAAqB;AACpD,2BAA2B,EAAI,uBAAuB;AACtD,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,61 @@
+/**
+ * @edgeone/vite-plugin-adapter
+ *
+ * EdgeOne 平台的核心适配器插件
+ *
+ * 本包为构建框架特定适配器提供基础设施，主要功能包括：
+ * - 构建产物检测和处理
+ * - 使用 esbuild 打包服务端代码
+ * - 静态资源管理
+ * - 路由配置生成
+ * - 生成 EdgeOne 部署所需的 meta.json 配置文件
+ *
+ * 使用场景：
+ * 1. 直接使用核心适配器构建自定义适配器
+ * 2. 作为其他框架适配器（如 React Router、TanStack Start）的基础依赖
+ *
+ * @example
+ * ```ts
+ * // 直接使用核心适配器创建自定义适配器
+ * import { createCoreAdapter } from '@edgeone/vite-plugin-adapter';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     createCoreAdapter({
+ *       verbose: true,  // 启用详细日志
+ *       hooks: {
+ *         // 自定义路由生成逻辑
+ *         generateRoutes: async (ctx) => [...],
+ *         // 自定义服务端包装器生成逻辑
+ *         generateServerWrapper: async (ctx, config) => '...',
+ *       }
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+// ==================== 核心插件导出 ====================
+// createCoreAdapter: 创建核心适配器插件的工厂函数
+export { createCoreAdapter, default } from "./core.js";
+// ==================== 打包工具导出 ====================
+export { bundleServerCode, // 使用 esbuild 打包服务端代码
+createServerWrapper, // 创建服务端包装器文件
+cleanupWrapper, // 清理临时包装器文件
+getBundleSize, // 获取打包结果的文件大小
+ } from "./bundler.js";
+// ==================== 工具函数导出 ====================
+export { createLogger, // 创建日志记录器
+pathExists, // 检查路径是否存在
+findExistingPath, // 从候选列表中找到第一个存在的路径
+copyDirectory, // 递归复制目录
+cleanDirectory, // 清理目录（删除后重建）
+ensureDirectory, // 确保目录存在
+readFile, // 读取文件内容
+writeFile, // 写入文件内容
+deleteFile, // 删除文件
+formatSize, // 格式化文件大小
+waitFor, // 等待条件满足（带重试）
+listFiles, // 列出目录内容
+countFiles, // 递归统计文件数量
+ } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,mDAAmD;AACnD,oCAAoC;AACpC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEvD,mDAAmD;AACnD,OAAO,EACL,gBAAgB,EAAO,qBAAqB;AAC5C,mBAAmB,EAAI,aAAa;AACpC,cAAc,EAAS,YAAY;AACnC,aAAa,EAAU,cAAc;EACtC,MAAM,cAAc,CAAC;AAEtB,mDAAmD;AACnD,OAAO,EACL,YAAY,EAAW,UAAU;AACjC,UAAU,EAAa,WAAW;AAClC,gBAAgB,EAAO,mBAAmB;AAC1C,aAAa,EAAU,SAAS;AAChC,cAAc,EAAS,cAAc;AACrC,eAAe,EAAQ,SAAS;AAChC,QAAQ,EAAe,SAAS;AAChC,SAAS,EAAc,SAAS;AAChC,UAAU,EAAa,OAAO;AAC9B,UAAU,EAAa,UAAU;AACjC,OAAO,EAAgB,cAAc;AACrC,SAAS,EAAc,SAAS;AAChC,UAAU,EAAa,WAAW;EACnC,MAAM,YAAY,CAAC"}