@taole/deploy-helper 1.1.6 → 1.1.8-beta.1

package/lib/archive.mjs

@@ -20,42 +20,128 @@ export function archiveToBuffer(setupArchive) {
   });
 }
 
-function appendDirToArchive(archive, dir, zipPrefix) {
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = path.join(dir, entry.name);
-    const entryZipPath = zipPrefix
-      ? path.posix.join(zipPrefix, entry.name)
-      : entry.name;
-    if (entry.isDirectory()) {
-      appendDirToArchive(archive, fullPath, entryZipPath);
-    } else {
-      archive.file(fullPath, { name: entryZipPath });
+function toPosixRelativePath(distPath, filePath) {
+  return path.relative(distPath, filePath).split(path.sep).join("/");
+}
+
+function matchDistFileFilter(relativePath, filterItem) {
+  if (typeof filterItem === "string") {
+    return relativePath === filterItem;
+  }
+  if (filterItem && typeof filterItem.regex === "string") {
+    return new RegExp(filterItem.regex).test(relativePath);
+  }
+  throw new Error(`无效的 distFileFilters 规则: ${JSON.stringify(filterItem)}`);
+}
+
+function shouldIncludeDistFile(relativePath, distFileFilters) {
+  if (!distFileFilters) {
+    return true;
+  }
+
+  const includeList = distFileFilters.include || [];
+  const excludeList = distFileFilters.exclude || [];
+
+  if (includeList.length > 0) {
+    const included = includeList.some((item) =>
+      matchDistFileFilter(relativePath, item)
+    );
+    if (!included) {
+      return false;
     }
   }
+
+  if (excludeList.length > 0) {
+    const excluded = excludeList.some((item) =>
+      matchDistFileFilter(relativePath, item)
+    );
+    if (excluded) {
+      return false;
+    }
+  }
+
+  return true;
 }
 
-export function genProjectArchiveBuffer(distPath) {
+function collectDistFiles(distPath, distFileFilters) {
+  const files = [];
+
+  function walk(dir) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(fullPath);
+        continue;
+      }
+
+      const relativePath = toPosixRelativePath(distPath, fullPath);
+      if (shouldIncludeDistFile(relativePath, distFileFilters)) {
+        files.push({ fullPath, relativePath });
+      }
+    }
+  }
+
+  walk(distPath);
+  return files;
+}
+
+function appendFilesToArchive(archive, files, zipPrefix) {
+  for (const { fullPath, relativePath } of files) {
+    const zipPath = zipPrefix
+      ? path.posix.join(zipPrefix, relativePath)
+      : relativePath;
+    archive.file(fullPath, { name: zipPath });
+  }
+}
+
+export function validateDistFileFilters(distFileFilters) {
+  if (distFileFilters == null) {
+    return;
+  }
+  if (typeof distFileFilters !== "object" || Array.isArray(distFileFilters)) {
+    throw new Error("distFileFilters 必须是包含 include/exclude 的对象");
+  }
+
+  for (const key of ["include", "exclude"]) {
+    const list = distFileFilters[key];
+    if (list == null) {
+      continue;
+    }
+    if (!Array.isArray(list)) {
+      throw new Error(`distFileFilters.${key} 必须是数组`);
+    }
+    for (const item of list) {
+      if (typeof item === "string") {
+        continue;
+      }
+      if (item && typeof item.regex === "string") {
+        continue;
+      }
+      throw new Error(`无效的 distFileFilters.${key} 规则: ${JSON.stringify(item)}`);
+    }
+  }
+}
+
+export function genProjectArchiveBuffer(distPath, distFileFilters) {
   return archiveToBuffer((archive) => {
-    archive.directory(distPath, false);
+    const files = collectDistFiles(distPath, distFileFilters);
+    appendFilesToArchive(archive, files);
   });
 }
 
 /**
  * lib 类型 CDN 打包：若 dist 内仅有名为 version 的子目录则原样打包；
- * 若无子目录则为 zip 内所有文件加上 version 前缀。
+ * 否则为 zip 内所有文件加上 version 前缀。
  */
-export function genLibArchiveBuffer(distPath, version) {
+export function genLibArchiveBuffer(distPath, version, distFileFilters) {
   const subdirs = fs
     .readdirSync(distPath, { withFileTypes: true })
     .filter((entry) => entry.isDirectory());
 
   return archiveToBuffer((archive) => {
-    if (subdirs.length === 1 && subdirs[0].name === version) {
-      archive.directory(distPath, false);
-    } else if (subdirs.length === 0) {
-      appendDirToArchive(archive, distPath, version);
-    } else {
-      archive.directory(distPath, false);
-    }
+    const files = collectDistFiles(distPath, distFileFilters);
+    const zipPrefix =
+      subdirs.length === 1 && subdirs[0].name === version ? "" : version;
+    appendFilesToArchive(archive, files, zipPrefix);
   });
 }

package/lib/lightDeploy.mjs

@@ -5,6 +5,7 @@ import { getCache as getLoginCache } from "./login.mjs";
 import {
   genLibArchiveBuffer,
   genProjectArchiveBuffer,
+  validateDistFileFilters,
 } from "./archive.mjs";
 
 const isDev = false;
@@ -102,6 +103,8 @@ export async function lightDeploy(config, mode) {
   const workDir = process.cwd();
   const distDir = config.distDir || "dist";
   const distPath = path.join(workDir, distDir);
+  const distFileFilters = config.distFileFilters;
+  validateDistFileFilters(distFileFilters);
   if (!fs.existsSync(distPath)) {
     throw new Error(`${distPath} 不存在，请先执行构建`);
   }
@@ -109,8 +112,8 @@ export async function lightDeploy(config, mode) {
   log(`开始打包 ${distPath}`);
   const distZipBuffer =
     cdnType === "lib"
-      ? await genLibArchiveBuffer(distPath, version)
-      : await genProjectArchiveBuffer(distPath);
+      ? await genLibArchiveBuffer(distPath, version, distFileFilters)
+      : await genProjectArchiveBuffer(distPath, distFileFilters);
   log(`打包完成，大小 ${distZipBuffer.length} 字节`);
 
   const includeHtml = config.includeHtml === true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taole/deploy-helper",
-  "version": "1.1.6",
+  "version": "1.1.8-beta.1",
   "description": "脚本部署工具，用于将项目部署到测试环境或生产环境",
   "main": "index.mjs",
   "type": "module",