@chuckcchen/vite-plugin 0.0.2

package/dist/utils.js

@@ -0,0 +1,262 @@
+/**
+ * EdgeOne Vite Plugin Adapter - 工具函数模块
+ *
+ * 本模块提供了一系列通用的工具函数，包括：
+ * - 日志记录
+ * - 文件系统操作（读写、复制、删除等）
+ * - 路径检测
+ * - 文件大小格式化
+ * - 条件等待等
+ */
+import fs from "fs/promises";
+import path from "path";
+/**
+ * 创建日志记录器实例
+ *
+ * @param verbose - 是否启用详细日志模式，默认为 false
+ * @returns 返回一个包含 log、verbose、warn、error 方法的日志对象
+ *
+ * @example
+ * const logger = createLogger(true);
+ * logger.verbose("这条消息只在 verbose 模式下显示");
+ * logger.warn("这是一条警告消息");
+ */
+export function createLogger(verbose = false) {
+    return {
+        // 普通日志，始终输出
+        log: (message, ...args) => {
+            console.log(`[EdgeOne Adapter] ${message}`, ...args);
+        },
+        // 详细日志，仅在 verbose 模式下输出
+        verbose: (message, ...args) => {
+            if (verbose) {
+                console.log(`[EdgeOne Adapter] ${message}`, ...args);
+            }
+        },
+        // 警告日志，带有警告图标
+        warn: (message, ...args) => {
+            console.warn(`[EdgeOne Adapter] ⚠️  ${message}`, ...args);
+        },
+        // 错误日志，带有错误图标
+        error: (message, ...args) => {
+            console.error(`[EdgeOne Adapter] ❌ ${message}`, ...args);
+        },
+    };
+}
+/**
+ * 检查指定路径是否存在
+ *
+ * @param filePath - 要检查的文件或目录路径
+ * @returns 如果路径存在返回 true，否则返回 false
+ *
+ * @example
+ * if (await pathExists('/path/to/file')) {
+ *   console.log('文件存在');
+ * }
+ */
+export async function pathExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 从候选路径列表中找到第一个存在的路径
+ *
+ * @param candidates - 候选路径数组，按优先级排序
+ * @returns 返回第一个存在的路径，如果都不存在则返回 null
+ *
+ * @example
+ * const buildDir = await findExistingPath([
+ *   '/project/dist',
+ *   '/project/build',
+ *   '/project/output'
+ * ]);
+ */
+export async function findExistingPath(candidates) {
+    for (const candidate of candidates) {
+        if (await pathExists(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * 递归复制目录
+ * 将源目录的所有内容复制到目标目录
+ *
+ * @param src - 源目录路径
+ * @param dest - 目标目录路径
+ *
+ * @example
+ * await copyDirectory('dist/client', '.edgeone/assets');
+ */
+export async function copyDirectory(src, dest) {
+    await fs.cp(src, dest, { recursive: true });
+}
+/**
+ * 清理目录（删除后重新创建）
+ * 用于确保目录为空的干净状态
+ *
+ * @param dir - 要清理的目录路径
+ *
+ * @example
+ * await cleanDirectory('.edgeone');
+ */
+export async function cleanDirectory(dir) {
+    await fs.rm(dir, { recursive: true, force: true });
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * 确保目录存在
+ * 如果目录不存在则递归创建
+ *
+ * @param dir - 目录路径
+ *
+ * @example
+ * await ensureDirectory('.edgeone/server-handler');
+ */
+export async function ensureDirectory(dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * 读取文件内容为字符串
+ *
+ * @param filePath - 文件路径
+ * @returns 文件内容字符串（UTF-8 编码）
+ *
+ * @example
+ * const content = await readFile('dist/server/index.js');
+ */
+export async function readFile(filePath) {
+    return fs.readFile(filePath, "utf-8");
+}
+/**
+ * 将内容写入文件
+ * 如果父目录不存在会自动创建
+ *
+ * @param filePath - 文件路径
+ * @param content - 要写入的内容
+ *
+ * @example
+ * await writeFile('.edgeone/meta.json', JSON.stringify(config));
+ */
+export async function writeFile(filePath, content) {
+    // 确保父目录存在
+    await ensureDirectory(path.dirname(filePath));
+    await fs.writeFile(filePath, content);
+}
+/**
+ * 删除文件
+ *
+ * @param filePath - 要删除的文件路径
+ *
+ * @example
+ * await deleteFile('server-wrapper.temp.js');
+ */
+export async function deleteFile(filePath) {
+    await fs.unlink(filePath);
+}
+/**
+ * 格式化文件大小为人类可读的字符串
+ *
+ * @param bytes - 字节数
+ * @returns 格式化后的字符串，如 "1.5 KB"、"2.3 MB"
+ *
+ * @example
+ * formatSize(1536);    // "1.5 KB"
+ * formatSize(2457600); // "2.34 MB"
+ */
+export function formatSize(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const k = 1024;
+    const sizes = ["B", "KB", "MB", "GB"];
+    // 计算适合的单位级别
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    // 转换并保留两位小数
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i];
+}
+/**
+ * 等待条件满足（带重试机制）
+ * 用于等待异步操作完成，如文件写入完成
+ *
+ * @param condition - 返回布尔值的异步条件函数
+ * @param options - 配置选项
+ * @param options.maxRetries - 最大重试次数，默认 15 次
+ * @param options.delay - 每次重试的间隔时间（毫秒），默认 300ms
+ * @returns 条件满足返回 true，超时返回 false
+ *
+ * @example
+ * const ready = await waitFor(
+ *   async () => await pathExists('dist/index.html'),
+ *   { maxRetries: 10, delay: 500 }
+ * );
+ */
+export async function waitFor(condition, options = {}) {
+    const { maxRetries = 15, delay = 300 } = options;
+    for (let i = 0; i < maxRetries; i++) {
+        // 检查条件是否满足
+        if (await condition()) {
+            return true;
+        }
+        // 如果不是最后一次尝试，则等待后重试
+        if (i < maxRetries - 1) {
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    return false;
+}
+/**
+ * 列出目录中的文件和子目录名称
+ *
+ * @param dir - 目录路径
+ * @returns 文件和目录名称数组，如果目录不存在则返回空数组
+ *
+ * @example
+ * const files = await listFiles('dist/client');
+ * // ['index.html', 'assets', 'favicon.ico']
+ */
+export async function listFiles(dir) {
+    try {
+        return await fs.readdir(dir);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 递归统计目录中的文件数量
+ *
+ * @param dir - 目录路径
+ * @returns 文件总数（不包括目录）
+ *
+ * @example
+ * const count = await countFiles('dist');
+ * console.log(`构建产物包含 ${count} 个文件`);
+ */
+export async function countFiles(dir) {
+    let count = 0;
+    try {
+        // 获取目录内容，包含类型信息
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                // 递归统计子目录
+                count += await countFiles(path.join(dir, entry.name));
+            }
+            else {
+                // 文件计数加一
+                count++;
+            }
+        }
+    }
+    catch {
+        // 忽略错误（如目录不存在）
+    }
+    return count;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@chuckcchen/vite-plugin",
+  "version": "0.0.2",
+  "description": "Core adapter plugin for EdgeOne platform - handles build artifacts, bundling, and deployment configuration",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "release": "npm run build && npm version patch && npm publish",
+    "release:minor": "npm run build && npm version minor && npm publish",
+    "release:major": "npm run build && npm version major && npm publish"
+  },
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "edgeone",
+    "adapter",
+    "core"
+  ],
+  "author": "chuckcchen",
+  "license": "MIT",
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  },
+  "dependencies": {
+    "esbuild": "^0.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.0",
+    "vite": "^7.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}