page2pdf_server 1.0.0

package/ecosystem.config.js

@@ -0,0 +1,41 @@
+module.exports = {
+  apps: [
+    {
+      name: '<app-name>',
+      script: 'dist/src/index.js',
+      // Options reference: https://pm2.keymetrics.io/docs/usage/application-declaration/
+      exec_mode: 'cluster',
+      instances: 2,
+      kill_timeout: 5000,
+      autorestart: true,
+      max_restarts: 10,
+      watch: true,
+      watch_options: {
+        followSymlinks: false,
+      },
+      max_memory_restart: '1G',
+      env: {
+        NODE_ENV: 'development',
+      },
+      env_production: {
+        NODE_ENV: 'production',
+        port: 8080,
+      },
+      merge_logs: true,
+      log_date_format: 'YYYY-MM-DDTHH:mm:ss.sssZ',
+    },
+  ],
+  // https://pm2.keymetrics.io/docs/usage/deployment/
+  deploy: {
+    production: {
+      key: process.env.EC2_PEM_PATH,
+      host: process.env.EC2_HOST,
+      user: 'ubuntu',
+      ref: 'origin/main',
+      repo: 'git@github.com:<username>/<repo-name>.git',
+      path: '/home/ubuntu',
+      'post-deploy':
+        'yarn && yarn clean && yarn build && pm2 startOrRestart ecosystem.config.js --env production && pm2 set pm2:autodump true && pm2 save',
+    },
+  },
+};

package/eslintrc.json

@@ -0,0 +1,14 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2018,
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "rules": {
+    "semi": "off"
+  }
+}

package/jest.config.js

@@ -0,0 +1,35 @@
+const { defaults: tsjPreset } = require("ts-jest/presets");
+
+module.exports = {
+  preset: "ts-jest",
+  moduleFileExtensions: ["ts", "js", "json"],
+  transform: {
+    "^.+\\.(ts|tsx)$": [
+      "ts-jest",
+      {
+        tsconfig: "tsconfig.json",
+        diagnostics: false,
+      },
+    ],
+    ...tsjPreset.transform,
+  },
+  testPathIgnorePatterns: ["dist"],
+  testMatch: ["**/__tests__/**/*.test.(ts|js)"],
+  testEnvironment: "node",
+  moduleNameMapper: {
+    "@/(.*)": "<rootDir>/src/$1",
+  },
+  watchPlugins: [
+    "jest-watch-typeahead/filename",
+    "jest-watch-typeahead/testname",
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 1,
+      functions: 1,
+      lines: 1,
+      statements: 1,
+    },
+  },
+  coverageReporters: ["json", "lcov", "text", "clover"],
+};

package/nodemon.json

@@ -0,0 +1,6 @@
+{
+  "watch": ["src/**/*.ts", ".env"],
+  "ext": "ts,js,.env",
+  "verbose": false,
+  "exec": "ts-node -r tsconfig-paths/register --files src/index.ts"
+}

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "page2pdf_server",
+  "version": "1.0.0",
+  "description": "文书打印转换器",
+  "private": false,
+  "authors": "herzhang",
+  "repository": "https://gitee.com/heerzhang/page2pdf-server",
+  "license": "MIT",
+  "scripts": {
+    "yarn": "yarn",
+    "yarn命令行": "yarn add nodemon -D",
+    "注意2": "运行prettify来修复代码，免去到处是标记红色的，太严格了",
+    "prettify": "prettier --write \"src/**/*.{ts,js,json}\" \"__tests__/**/*.{ts,js,json}\"",
+    "start": "NODE_ENV=development run-s prettify lint & nodemon",
+    "build": "cross-env NODE_ENV=production run-s prettify clean transpile",
+    "lint": "eslint 'src/**/*.{ts,js}' '__tests__/**/*.{ts,js}'",
+    "lint:fix": "eslint --fix 'src/**/*.{ts,js}' '__tests__/**/*.{ts,js}' --quiet",
+    "有些隐藏错误": "需要运行watch才发现",
+    "watch": "tsc --watch",
+    "clean": "rimraf dist",
+    "test": "cross-env NODE_ENV=test jest --coverage --runInBand --detectOpenHandles",
+    "单步调试": "不必运行test，直接到__test__目录文件直接挑选修改测试项并调试",
+    "test:watchAll": "cross-env NODE_ENV=test jest --watchAll --runInBand --detectOpenHandles",
+    "transpile": "tsc",
+    "service:start": "pm2 start ecosystem.config.js",
+    "service:reload": "pm2 reload ecosystem.config.js",
+    "service:startup": "pm2 startup",
+    "service:stop": "pm2 stop ecosystem.config.js",
+    "service:list": "pm2 list ecosystem.config.js",
+    "service:delete": "pm2 delete ecosystem.config.js",
+    "service:logs": "pm2 logs",
+    "hook主动运行": "操作系统缘故，将单引号改成双引号，加转义符，提交代码会自动执行;git提交给它勾掉吧,yarn会自动运行prepare",
+    "prepare": "husky install"
+  },
+  "keywords": [
+    "dynamic page pdf generator",
+    "html to pdf",
+    "app url to pdf",
+    "pdf generation",
+    "node.js",
+    "express",
+    "print",
+    "server"
+  ],
+  "dependencies": {
+    "bcrypt": "^5.1.0",
+    "chrome-remote-interface": "^0.32.2",
+    "config": "^3.3.9",
+    "connect-timeout": "^1.9.0",
+    "cors": "^2.8.5",
+    "cross-env": "^7.0.3",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-pino-logger": "^7.0.0",
+    "express-validator": "^7.0.1",
+    "helmet": "^7.0.0",
+    "http-status": "^1.6.2",
+    "jsonwebtoken": "^9.0.0",
+    "lodash-es": "^4.17.21",
+    "morgan": "^1.10.0",
+    "pdf-lib": "^1.17.1",
+    "pino-http": "^8.3.3",
+    "pino-pretty": "^10.0.0",
+    "rimraf": "^5.0.1",
+    "save-dev": "^0.0.1-security"
+  },
+  "devDependencies": {
+    "@babel/preset-env": "^7.22.5",
+    "@babel/preset-typescript": "^7.22.5",
+    "@types/bcrypt": "^5.0.0",
+    "@types/connect-timeout": "^0.0.37",
+    "@types/cors": "^2.8.13",
+    "@types/express": "^4.17.17",
+    "@types/express-pino-logger": "^4.0.3",
+    "@types/jest": "^29.5.2",
+    "@types/jsonwebtoken": "^9.0.2",
+    "@types/lodash-es": "^4.17.7",
+    "@types/module-alias": "^2.0.1",
+    "@types/morgan": "^1.9.4",
+    "@types/node": "^20.3.1",
+    "@types/supertest": "^2.0.12",
+    "@typescript-eslint/eslint-plugin": "^5.59.11",
+    "@typescript-eslint/parser": "^5.59.11",
+    "eslint": "^8.43.0",
+    "eslint-config-prettier": "^8.8.0",
+    "eslint-plugin-import": "^2.27.5",
+    "eslint-plugin-prettier": "^4.2.1",
+    "husky": "^8.0.3",
+    "jest": "^29.5.0",
+    "jest-watch-typeahead": "^2.2.2",
+    "module-alias": "^2.2.3",
+    "nodemon": "^3.0.1",
+    "npm-run-all": "^4.1.5",
+    "pm2": "^5.3.0",
+    "prettier": "^2.8.8",
+    "supertest": "^6.3.3",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.1",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.1.6"
+  },
+  "engines": {
+    "node": ">= 18.0.0"
+  }
+}

package/src/CSS/345/205/274/345/256/271/346/200/247.txt

@@ -0,0 +1,56 @@
+CSS内容层次可以输出页脚页眉留白的，浏览器打印给pdf也能输出页脚页眉左右上下留白，最终打印环节真实打印机还可以设置装订线尺寸占用区以及页脚页码输出区域的。
+Chrome浏览器已经 可支持的有这些：
+ <style>
+      @page :left {         #偶数页的 右边流出装订线尺寸位置的
+        margin-right: 7cm;
+      }
+      @page :right {        ##封面，奇数页;
+        margin-left: 7cm;
+      }
+      @page :first {
+        margin-top: 5cm;
+      }
+ </style>
+
+
+目前浏览器Chrome还不支持的有这些： ! !
+ @page:right{
+     @bottom-left {
+       content: "Our Cats";
+    }
+     @bottom-right {
+       content: counter(page);
+     }
+     @top-right {
+      content: string(doctitle);
+     }
+ }
+ @bottom-center {
+         content: "asdaqq7q";
+       }
+ @page :right {
+    @bottom-center {
+      content: "aEdaqq7q";
+    }
+ }
+
+
+【局限】 尝试在CDP打印命令Page.printToPDF，往参数headerTemplate footerTemplate加入脚本，可加了脚本<script>全都不会运行啊。
+ 也就是说页眉页脚<span class=pageNumber></span>/<span class=totalPages></span>这两个数字Page.printToPDF({生成的话我没法改动它。
+ 它只会武断的1/3 2/3 3/3的编号，甚至不会省略掉首页页码的，每一页都要计入总页数的。也没法适应双面打印把输出的位置左右对调一下，左右边上位置如何处置。
+
+[后续]  正因为Page.printToPDF()不能支持多个url一次性生成pdf的， @page :right @bottom-right，，
+    这些CSS3标准在这里需要合并多个文档的打印要求中，实际这些都变得没有意义了。
+    奇数页偶数页的不是针对部分某一个url来讲的，右边流出装订线尺寸位置的，双面打印也需要挪到真实物理打印机最后环节去设置才合适。
+    所以，打印靠css不能解决复杂问题。
+    printToPDF()追溯上去依赖的Page.navigate（{url}），这个操作实际和打印预览完全没一点关系，这个函数完全就是普通网页导航进入一个链接<a/>;
+    还有追溯上去另外一种是Page.setDocumentContent({ frameId, html: html })设置 Page 的 html 内容的，
+    而该操作的html这个参数也不可能随意合并多页面（应用层的事情）文档DOM还有层次结构的, Iframe标签?。终归无法合并多个url内容打印。
+    Page.close 可以关闭页面Tab ,Page实际就是浏览器的单一网站窗口；  通过 CDP 来和 chromium 通信。
+    连续2次setDocumentContent（html）只能显示最后一次操作的html内容的;
+    如果是setDocumentContent({html:html1+html2})内容的可能混乱：脚本css以及DOM的id都可能交叉影响了，最终强制合并输出效果可能不是预期的网页内容。
+    连续两次Page.navigate（{url}）? 明显无法合并输出的。
+    .navigate和.setDocumentContent交叉顺序的，也都是会被最后的操作冲掉覆盖前面的url或html的，肯定无法合并后给.printToPDF()搞一次合并打印的。
+    CDP({})前后两次CDP打开新的Page若前面没有close(),那么旧Page.printToPDF也会被后面新Page.navigate所覆盖的，浏览器不支持合并打印的！
+    Page.printToPDF({}）实际也只能类似Chrome打印预览菜单一致，只能打印当前页面，动态内容页面也是随着鼠标用户操作有可能不一样的打印结果。
+

package/src/app.ts

@@ -0,0 +1,41 @@
+import cors from "cors";
+import express from "express";
+import helmet from "helmet";
+import morgan from "morgan";
+import timeout from "connect-timeout";
+import CONFIG from "./configEnv";
+import { expressPinoLogger } from "./helpers";
+import * as errorHandler from "@/middlewares/errorHandler";
+import routes from "@/routes";
+
+export const createApp = (): express.Application => {
+  const app = express();
+
+  app.use(cors());
+  app.use(helmet());
+  app.use(express.json());
+  app.use(
+    express.urlencoded({
+      extended: true,
+    }),
+  );
+
+  if (CONFIG.APP.ENV !== "test") {
+    app.use(morgan("dev"));
+    app.use(expressPinoLogger());
+  }
+
+  app.use(timeout(CONFIG.SERVER.TIMEOUT));
+
+  // API Routes
+  // API Routes 如果代码非常简单，完全可以 app.get('/',....),如果路由比较复杂，需要路由的嵌套分层拆解模式：使用 express.Router() 更合适。
+  app.use(`/api`, routes);
+  //框架例子有：版本号的插入的。
+  //app.use(`/api/${CONFIG.APP.VER}`, routes);
+
+  // Error Middleware
+  app.use(errorHandler.genericErrorHandler);
+  app.use(errorHandler.notFoundError);
+
+  return app;
+};

package/src/components/home/controller.ts

@@ -0,0 +1,27 @@
+import { OK } from "http-status/lib";
+import { HomeServices } from "./services";
+import { getAppInfoQuery } from "@/types/request/home";
+import { apiResponse } from "@/helpers/apiResponse";
+
+/**
+ * 为何为了保证单步模式调试运行"test:watchAll": "cross-env NODE_ENV=development jest --watchAll --runInBand --detectOpenHandles",
+ * 只能单独创建一个文件和类PdfController了，不能和HomeController合并在一个类class的俩个并行api处理函数啊？
+ * */
+export class HomeController {
+  /**
+   * @description Gets the API information.
+   * @param {Req} req
+   * @param {Res} res
+   */
+  static getAppInfo = async (req: Req, res: Res, next: NextFn) => {
+    try {
+      const appInfoKey = req.query.key as getAppInfoQuery;
+      const homeServices = new HomeServices();
+      const result = await homeServices.getAppInfo(appInfoKey);
+
+      res.status(OK).json(apiResponse(result));
+    } catch (error) {
+      next(error);
+    }
+  };
+}

package/src/components/home/index.ts

@@ -0,0 +1,4 @@
+export { HomeController } from "./controller";
+export { PdfController } from "./pdfController";
+export { appKeyValidator } from "./validators";
+export { SplitController } from "./splitController";

package/src/components/home/pdfController.ts

@@ -0,0 +1,112 @@
+import { OK } from "http-status/lib";
+import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/home";
+import { apiResponse } from "@/helpers/apiResponse";
+import { RenderPDF } from "@/utils/pdfgen";
+import CONFIG from "@/configEnv";
+
+export class PdfController {
+  /** node.js对比前端App 太严格了，一点小毛病页不行啊。
+   * @description 生成pdf.
+   * @param {Req} req
+   * @param {Res} res
+   * 正常分解成两大步：task.files每一个文件生成，最后才是task.merge合并(包括页码生成)。
+   * @param next
+   */
+  static postMakePdf = async (req: Req, res: Res, next: NextFn) => {
+    try {
+      // const appInfoKey1 = req.query.key as getAppInfoQuery;
+      const task = req.body as ConfigRoot<FileTransform>;
+      task.lay as HeadFooter;
+      //预处理汇总输出的pdf页眉页脚, 转换页眉页脚的html存储
+      if (task.lay) {
+        const newfoot = "";
+        const formfoot =
+          task.lay.foot &&
+          newfoot.concat(...task.lay.foot).replaceAll(`\\"`, '"');
+        task.footerTemplate = formfoot ?? undefined;
+        const formhead =
+          task.lay.head &&
+          newfoot.concat(...task.lay.head).replaceAll(`\\"`, '"');
+        task.headerTemplate = formhead ?? undefined;
+        const formfootL =
+          task.lay.footL &&
+          newfoot.concat(...task.lay.footL).replaceAll(`\\"`, '"');
+        task.footerTemplateL = formfootL ?? undefined;
+        const formheadL =
+          task.lay.headL &&
+          newfoot.concat(...task.lay.headL).replaceAll(`\\"`, '"');
+        task.headerTemplateL = formheadL ?? undefined;
+      }
+      //const homeServices = new HomeServices();
+      //let result = { ["文件名"]: "产生的.pdf" };
+      let result;
+      //若是用RenderPDF.generateSinglePdf(会导致没有等待该函数执行结果就会去执行下一步了，应答res,客户端立刻获得http回答，无等待=异步模式的。还是由客户端主动取消等待为佳。这里死等的；
+      try {
+        //const jobs = generateJobList(urls, pdfs);  分解成多个URL文件多个步骤的情况，可能还有个汇总步骤的：
+        // generateSinglePdf  mergePdfs  pageNoForPdf yeMeiyeJiaoPdf
+        if (
+          (task.merge === undefined || task.merge) &&
+          task.files === undefined &&
+          !task.lay
+        ) {
+          await RenderPDF.mergeAllPdfto(); //特殊的特殊？ 没有涉及到CDP()函数：
+          result = `简易合并输出是: ${CONFIG.APP.MERGE}`;
+        } else {
+          //有涉及到CDP()函数：
+          const renderer = new RenderPDF({}); //提升上来：复用全局的
+          if (!task.files || task.files?.length <= 0) {
+            console.error("没配置files输入");
+            res.status(OK).json(apiResponse({ result: "没配置files输入" }));
+            return;
+          } else {
+            for (const meta of task.files) {
+              if (!meta.out) {
+                if (meta.url.endsWith(".pdf") && !meta.url.startsWith("http"))
+                  continue;
+                else {
+                  res
+                    .status(OK)
+                    .json(apiResponse({ result: meta.url + " 没配置out" }));
+                  return;
+                }
+              } else {
+                //本地pdf情形实际会有webview/iframe的？跳转?,实际会看到pdf之外的浏览控件框框的。 避免再次转换pdf实际捕获窗口并非pdf自身内容；
+                if (meta.url.endsWith(".pdf") && !meta.url.startsWith("http"))
+                  throw new Error(
+                    "url是本地的pdf文件，不应该设置out参数:" + meta.url,
+                  );
+              }
+              try {
+                result = await renderer.generateSinglePdf(meta, task, {});
+              } catch (e) {
+                result = "算url失败:" + meta.url;
+                console.error(e);
+              }
+              if (result) {
+                result = "URL:" + meta.url + " > " + result;
+                break; //说明有某种报错
+              }
+            }
+          }
+          //正常的合并阶段的事情： 前一阶段页眉页脚也不打印了。也要放这里了
+          if (!result && (task.merge === undefined || task.merge))
+            result = await RenderPDF.MergeAllPdfs(task, {});
+          //关闭多余窗口
+          if (task.closeTab)
+            await renderer.closeAllTab(renderer.getCDPhostPort(), task);
+        }
+      } catch (e) {
+        result = "算失败了" + e;
+        console.error(e);
+      }
+
+      if (!result || result === "") {
+        result = "成功！";
+        console.log(result, "输出是:", task.name ?? CONFIG.APP.MERGE);
+      }
+      res.status(OK).json(apiResponse({ result: result }));
+    } catch (error) {
+      next(error);
+    }
+  };
+}

package/src/components/home/services.ts

@@ -0,0 +1,31 @@
+import AppInformation from "@/types/response/AppInformation";
+import { HomeDAO } from "@/db/home";
+import { getAppInfoQuery } from "@/types/request/home";
+
+export class HomeServices {
+  homeDAO!: HomeDAO;
+  constructor() {
+    this.homeDAO = new HomeDAO();
+  }
+  // NAME: pkg.name,
+  // VERSION: pkg.version,
+  // VER: `v${pkg.version[0]}`,
+  // DESCRIPTION: pkg.description,
+  // AUTHORS: pkg.authors,
+  // HOST: process.env.APP_HOST,
+  // BASE_URL: process.env.API_BASE_URL,
+  // PORT: process.env.NODE_ENV === "test" ? 8888 : process.env.PORT || 8080,
+  // ENV: process.env.NODE_ENV,
+
+  /**
+   * @description Get application information.
+   * @returns AppInformation
+   */
+  getAppInfo = async (
+    appInfoKey?: getAppInfoQuery,
+  ): Promise<AppInformation> => {
+    const result = await this.homeDAO.get(appInfoKey);
+
+    return result;
+  };
+}

package/src/components/home/splitController.ts

@@ -0,0 +1,124 @@
+import fs from "fs";
+import { OK } from "http-status/lib";
+import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/home";
+import { apiResponse } from "@/helpers/apiResponse";
+
+import { RenderPDF } from "@/utils/pdfgen";
+import CONFIG from "@/configEnv";
+import { SplitConfig, SplitPdfFile } from "@/types/request/split";
+// import CONFIG from "@/configEnv";
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { PDFDocument } = require("pdf-lib");
+
+/**只好拆分多个文件：就为了能够jest运行于单步调试模式啊。
+ * __test__/./generatePdf.test.ts问题：jest用Run模式正常，可是若Debug模式单步调试的，.post(`/api/pdf`).send就会提前中止！原因xxxController容不下多个接口函数？
+ *  ?估计同一个.ts文件引入的包有动态编译的问题？非得拆分两个文件。
+ * */
+export class SplitController {
+  /** node.js对比前端App 太严格了，一点小毛病页不行啊。
+   * @description 生成pdf.
+   * @param {Req} req
+   * @param {Res} res
+   * 正常分解成两大步：task.files每一个文件生成，最后才是task.merge合并(包括页码生成)。
+   * @param next
+   */
+  //仅仅测试的
+  static postMakePdf = async (req: Req, res: Res, next: NextFn) => {
+    try {
+      // const appInfoKey1 = req.query.key as getAppInfoQuery;
+      const task = req.body as ConfigRoot<FileTransform>;
+      task.lay as HeadFooter;
+      //预处理汇总输出的pdf页眉页脚
+      if (task.lay) {
+        const newfoot = "";
+        const formfoot =
+          task.lay.foot &&
+          newfoot.concat(...task.lay.foot).replaceAll(`\\"`, '"');
+        task.footerTemplate = formfoot ?? undefined;
+        const formhead =
+          task.lay.head &&
+          newfoot.concat(...task.lay.head).replaceAll(`\\"`, '"');
+        task.headerTemplate = formhead ?? undefined;
+      }
+      //const homeServices = new HomeServices();
+      //let result = { ["文件名"]: "产生的.pdf" };
+      let result;
+      //若是用RenderPDF.generateSinglePdf(会导致没有等待该函数执行结果就会去执行下一步了，应答res,客户端立刻获得http回答，无等待=异步模式的。还是由客户端主动取消等待为佳。这里死等的；
+      try {
+        //const jobs = generateJobList(urls, pdfs);  分解成多个URL文件多个步骤的情况，可能还有个汇总步骤的：
+        // generateSinglePdf  mergePdfs  pageNoForPdf yeMeiyeJiaoPdf
+        if (
+          (task.merge === undefined || task.merge) &&
+          task.files === undefined &&
+          !task.lay
+        ) {
+          await RenderPDF.mergeAllPdfto(); //特殊的特殊？
+          result = `简易合并输出是: ${CONFIG.APP.MERGE}`;
+        } else {
+          //正常的合并阶段的事情： 前一阶段页眉页脚也不打印了。也要放这里了
+          //if(task.merge===undefined || task.merge)
+          result = await RenderPDF.MergeAllPdfs(task, {});
+        }
+      } catch (e) {
+        result = "算失败了" + e;
+        console.error(e);
+      }
+
+      if (!result || result === "") result = "成功！";
+      res.status(OK).json(apiResponse({ result: result }));
+    } catch (error) {
+      next(error);
+    }
+  };
+
+  /**拆分需要：支持pdf源文件的，抽取部分纸张页生成新文件*/
+  static postSplitPdf = async (req: Req, res: Res, next: NextFn) => {
+    try {
+      //也可能?用CDP:printPDF()来进行部分打印的后保存，就等于拆分pdf；
+      const task = req.body as SplitConfig;
+      task.files as SplitPdfFile[];
+      //输入文件 都是pdf了
+      const srcDoc = await PDFDocument.load(
+        fs.readFileSync(CONFIG.APP.PATH + "/" + task.input),
+      );
+      let result;
+      const allpagesum = await srcDoc.getPages().length;
+      //若是用RenderPDF.generateSinglePdf(会导致没有等待该函数执行结果就会去执行下一步了，应答res,客户端立刻获得http回答，无等待=异步模式的。还是由客户端主动取消等待为佳。这里死等的；
+      try {
+        for (const fileone of task.files) {
+          const oneDoc = await PDFDocument.create();
+          //可能出现例子是 '1-5, 8, 11-13' 类似打印机常见的选择页码范围。
+          const ofstr = fileone.pageRanges;
+          const ranges = ofstr.split(",");
+          for (const range of ranges) {
+            const bgend = range.split("-");
+            const beginp = bgend[0];
+            let endp = bgend[1];
+            if (!endp) {
+              endp = beginp;
+            }
+            //逗号分割开的某一区域 , , 被选定的： 页序数号是从开始的。
+            let i = Number(beginp);
+            const endpage = Number(endp);
+            if (i < 1 || i > allpagesum || endpage < i || endpage > allpagesum)
+              throw new Error("选定的页序号超范围:[" + i + "-" + endpage + "]");
+            for (; i <= endpage; i++) {
+              const [aPage] = await oneDoc.copyPages(srcDoc, [i - 1]);
+              oneDoc.addPage(aPage);
+            }
+          }
+          const name = CONFIG.APP.PATH + "/" + fileone.out + ".pdf";
+          fs.writeFileSync(name, await oneDoc.save());
+        }
+      } catch (e) {
+        result = "算失败了" + e;
+        console.error(e); //这个在最终服务端cmd窗口可输出
+      }
+
+      if (!result || result === "") result = "成功！";
+      res.status(OK).json(apiResponse({ result: result }));
+    } catch (error) {
+      next(error);
+    }
+  };
+}

package/src/components/home/validators.ts

@@ -0,0 +1,12 @@
+import { query } from "express-validator";
+import CONFIG from "@/configEnv";
+
+const appKeys = Object.keys(CONFIG.APP).map((key) => key.toLocaleLowerCase());
+
+export const appKeyValidator = [
+  query("key")
+    .optional()
+    .isString()
+    .isIn(appKeys)
+    .withMessage("`name` should be string type"),
+];