page2pdf_server 1.1.0 → 1.1.2

package/jest.config.js

@@ -1,35 +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"],
-};
+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

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

package/package.json

@@ -1,20 +1,26 @@
 {
   "name": "page2pdf_server",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "文书打印转换器",
   "private": false,
   "authors": "herzhang",
   "repository": "https://gitee.com/heerzhang/page2pdf-server",
   "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/types.d.ts",
   "scripts": {
     "yarn": "yarn",
     "yarn命令行": "yarn add nodemon -D",
     "注意2": "运行prettify来修复代码，免去到处是标记红色的，太严格了",
-    "prettify": "prettier --write \"src/**/*.{ts,js,json}\" \"__tests__/**/*.{ts,js,json}\"",
+    "prettify": "prettier --write \"src/**/*.{ts,js,json}\" \"src/__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",
+    "build": "rimraf dist && tsc && rimraf dist/types && ncp src/types.d.ts dist/types",
+    "手动管理 .d.ts 文件的完整流程": "确保以下路径存源文件：src/types.d.ts 目标目录：dist/types/",
+    "build3": "rimraf dist && tsc --emitDeclarationOnly && dts-bundle --name 'types' --main dist/types/index.d.ts --out 'dist/types.d.ts'",
+    "build2": "rimraf dist && tsc --emitDeclarationOnly && ncp src/types.d.ts dist/types",
+    "build1": "cross-env NODE_ENV=production run-s prettify clean transpile",
+    "lint": "eslint 'src/**/*.{ts,js}' 'src/__tests__/**/*.{ts,js}'",
+    "lint:fix": "eslint --fix 'src/**/*.{ts,js}' 'src/__tests__/**/*.{ts,js}' --quiet",
     "有些隐藏错误": "需要运行watch才发现",
     "watch": "tsc --watch",
     "clean": "rimraf dist",
@@ -30,7 +36,7 @@
     "service:delete": "pm2 delete ecosystem.config.js",
     "service:logs": "pm2 logs",
     "hook主动运行": "操作系统缘故，将单引号改成双引号，加转义符，提交代码会自动执行;git提交给它勾掉吧,yarn会自动运行prepare",
-    "prepare": "husky install"
+    "安装生产依赖在服务器上执行": "工程npm prune --production 然后目标机npm ci --only=production"
   },
   "keywords": [
     "dynamic page pdf generator",
@@ -43,10 +49,13 @@
     "server"
   ],
   "dependencies": {
-    "chrome-remote-interface": "^0.32.2",
+    "@types/bcrypt": "^5.0.0",
+    "@types/cors": "^2.8.13",
+    "@types/express-pino-logger": "^4.0.3",
+    "@types/jsonwebtoken": "^9.0.2",
+    "chrome-remote-interface": "^0.33.3",
     "config": "^3.3.9",
     "connect-timeout": "^1.9.0",
-    "@types/cors": "^2.8.13",
     "cors": "^2.8.5",
     "cross-env": "^7.0.3",
     "dotenv": "^16.3.1",
@@ -61,24 +70,22 @@
     "pdf-lib": "^1.17.1",
     "pino-http": "^8.3.3",
     "pino-pretty": "^10.0.0",
-    "rimraf": "^5.0.1",
-    "@types/node": "^20.3.1",
-    "@types/jsonwebtoken": "^9.0.2",
-    "@types/express": "^4.17.17",
-    "@types/express-pino-logger": "^4.0.3",
-    "@types/bcrypt": "^5.0.0",
+    "rimraf": "^6.0.1",
     "save-dev": "^0.0.1-security"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.22.5",
     "@babel/preset-typescript": "^7.22.5",
     "@types/connect-timeout": "^0.0.37",
+    "@types/express": "^4.17.22",
     "@types/jest": "^29.5.2",
     "@types/lodash-es": "^4.17.7",
     "@types/morgan": "^1.9.4",
+    "@types/node": "^22.15.21",
     "@types/supertest": "^2.0.12",
     "@typescript-eslint/eslint-plugin": "^5.59.11",
     "@typescript-eslint/parser": "^5.59.11",
+    "dts-bundle": "^0.7.3",
     "eslint": "^8.43.0",
     "eslint-config-prettier": "^8.8.0",
     "eslint-plugin-import": "^2.27.5",
@@ -86,6 +93,7 @@
     "husky": "^8.0.3",
     "jest": "^29.5.0",
     "jest-watch-typeahead": "^2.2.2",
+    "ncp": "^2.0.0",
     "nodemon": "^3.0.1",
     "npm-run-all": "^4.1.5",
     "pm2": "^5.3.0",
@@ -94,7 +102,7 @@
     "ts-jest": "^29.1.0",
     "ts-node": "^10.9.1",
     "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.1.6"
+    "typescript": "^5.8.3"
   },
   "engines": {
     "node": ">= 20.0.0"

package/src/__tests__/UrltoPdf/generatePdf.test.d.ts

@@ -0,0 +1 @@
+export {};

package/{__tests__ → src/__tests__}/UrltoPdf/generatePdf.test.ts

@@ -1,6 +1,6 @@
 import { SuperAgentTest } from "supertest";
 import { OK } from "http-status/lib";
-import { initAgent } from "../helpers";
+import { initAgent } from "../helpers/index";
 
 //prettify真叼： 每个地方都给您报出 红色
 const TIMEOUT = 260000; //设置超时，避免单步歇菜

package/src/__tests__/UrltoPdf/pdfSplit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/{__tests__ → src/__tests__}/UrltoPdf/pdfSplit.test.ts

@@ -1,6 +1,6 @@
 import { SuperAgentTest } from "supertest";
 import { OK } from "http-status/lib";
-import { initAgent } from "../helpers";
+import { initAgent } from "../helpers/index";
 // import CONFIG from "../../src/configEnv";
 
 //prettify真叼： 每个地方都给您报出 红色

package/src/__tests__/helpers/index.d.ts

@@ -0,0 +1,2 @@
+import { SuperAgentTest } from "supertest";
+export declare const initAgent: () => Promise<SuperAgentTest>;

package/src/__tests__/home.test.d.ts

@@ -0,0 +1 @@
+export {};

package/{__tests__ → src/__tests__}/home.test.ts

@@ -1,6 +1,6 @@
 import { SuperAgentTest } from "supertest";
 import HttpStatus, { OK, BAD_REQUEST } from "http-status/lib";
-import { initAgent } from "./helpers";
+import { initAgent } from "./helpers/index";
 import CONFIG from "@/configEnv";
 
 //prettify真叼： 每个地方都给您报出 红色

package/src/app.ts

@@ -30,6 +30,7 @@ export const createApp = (): express.Application => {
     app.use(expressPinoLogger());
   }
 
+  // @ts-ignore
   app.use(timeout(CONFIG.SERVER.TIMEOUT));
 
   // API Routes

package/src/components/home/controller.ts

@@ -1,7 +1,8 @@
 import { OK } from "http-status/lib";
-import { HomeServices } from "./services";
+import { Request, Response, NextFunction } from "express";
 import { getAppInfoQuery } from "../../types/request/home";
 import { apiResponse } from "../../helpers/apiResponse";
+import { HomeServices } from "./services";
 
 /**
  * 为何为了保证单步模式调试运行"test:watchAll": "cross-env NODE_ENV=development jest --watchAll --runInBand --detectOpenHandles",
@@ -13,7 +14,11 @@ export class HomeController {
    * @param {Req} req
    * @param {Res} res
    */
-  static getAppInfo = async (req: Req, res: Res, next: NextFn) => {
+  static getAppInfo = async (
+    req: Request,
+    res: Response,
+    next: NextFunction,
+  ) => {
     try {
       const appInfoKey = req.query.key as getAppInfoQuery;
       const homeServices = new HomeServices();

package/src/components/home/pdfController.ts

@@ -1,12 +1,10 @@
 import { OK } from "http-status/lib";
-import {
-  ConfigRoot,
-  FileTransform,
-  HeadFooter,
-} from "../../types/request/config";
+import { NextFunction, Request, Response } from "express";
+import { HeadFooter } from "../../types/request/config";
 import { apiResponse } from "../../helpers/apiResponse";
 import { RenderPDF } from "../../utils/pdfgen";
 import CONFIG from "../../configEnv";
+import { ConfigRoot, FileTransform } from "../../types";
 
 export class PdfController {
   /** node.js对比前端App 太严格了，一点小毛病页不行啊。
@@ -16,7 +14,11 @@ export class PdfController {
    * 正常分解成两大步：task.files每一个文件生成，最后才是task.merge合并(包括页码生成)。
    * @param next
    */
-  static postMakePdf = async (req: Req, res: Res, next: NextFn) => {
+  static postMakePdf = async (
+    req: Request,
+    res: Response,
+    next: NextFunction,
+  ) => {
     try {
       // const appInfoKey1 = req.query.key as getAppInfoQuery; 所有打印都走ConfigRoot配置包=task：可能有多个URL合并输出的。
       const task = req.body as ConfigRoot<FileTransform>;

package/src/components/home/splitController.ts

@@ -1,15 +1,13 @@
 import fs from "fs";
 import { OK } from "http-status/lib";
-import {
-  ConfigRoot,
-  FileTransform,
-  HeadFooter,
-} from "../../types/request/config";
+import { NextFunction, Request, Response } from "express";
+import { HeadFooter } from "../../types/request/config";
 import { apiResponse } from "../../helpers/apiResponse";
 
 import { RenderPDF } from "../../utils/pdfgen";
 import CONFIG from "../../configEnv";
 import { SplitConfig, SplitPdfFile } from "../../types/request/split";
+import { ConfigRoot, FileTransform } from "../../types";
 // import CONFIG from "@/configEnv";
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const { PDFDocument } = require("pdf-lib");
@@ -27,7 +25,11 @@ export class SplitController {
    * @param next
    */
   //仅仅测试的
-  static postMakePdf = async (req: Req, res: Res, next: NextFn) => {
+  static postMakePdf = async (
+    req: Request,
+    res: Response,
+    next: NextFunction,
+  ) => {
     try {
       // const appInfoKey1 = req.query.key as getAppInfoQuery;
       const task = req.body as ConfigRoot<FileTransform>;
@@ -76,7 +78,11 @@ export class SplitController {
   };
 
   /**拆分需要：支持pdf源文件的，抽取部分纸张页生成新文件*/
-  static postSplitPdf = async (req: Req, res: Res, next: NextFn) => {
+  static postSplitPdf = async (
+    req: Request,
+    res: Response,
+    next: NextFunction,
+  ) => {
     try {
       //也可能?用CDP:printPDF()来进行部分打印的后保存，就等于拆分pdf；
       const task = req.body as SplitConfig;

package/src/helpers/dataSanitizers.ts

@@ -1,12 +1,14 @@
 import { Result, ValidationChain, validationResult } from "express-validator";
+// @ts-ignore
 import { Middleware as ValidatorMiddleware } from "express-validator/src/base";
+import { NextFunction, Request, Response } from "express";
 import ValidationError from "./error/ValidationError";
 
 type MultiValidatorChain = ValidatorMiddleware & {
   run: (req: Request) => Promise<Result>;
 };
 
-const catchValidatorError = (req: Req, _: Res, next: NextFn): void => {
+const catchValidatorError = (req: Request, _: Response, next: NextFunction): void => {
   const errors = validationResult(req);
   if (!errors.isEmpty()) {
     const validationErrors = errors

package/src/helpers/loggers.ts

@@ -2,7 +2,7 @@ import httpStatus from "http-status/lib";
 import expressPino from "express-pino-logger";
 import { hidePassword } from "../utils/auth";
 
-const { OK, BAD_REQUEST, SERVER_ERROR } = httpStatus;
+const { OK, BAD_REQUEST } = httpStatus;
 
 // More info: https://github.com/pinojs/express-pino-logger
 export const expressPinoLogger = () =>
@@ -28,10 +28,12 @@ export const expressPinoLogger = () =>
     customSuccessMessage(res) {
       const status = res.statusCode!;
       if (status >= 400 && status < 500) {
+        // @ts-ignore
         return `${status || BAD_REQUEST} : ${httpStatus[status || 400]}`;
       }
       if (status >= 500) {
-        return `${status || SERVER_ERROR} : ${httpStatus[status || 500]}`;
+        // @ts-ignore
+        return `${status} : ${httpStatus[status || 500]}`;
       }
       return `${OK} : ${httpStatus[200].toUpperCase()}`;
     },

package/src/index.ts

@@ -14,3 +14,5 @@ if (process.env.NODE_ENV !== "test") {
 
 //关键文档Chrome DevTools Protocol资料， https://chromedevtools.github.io/devtools-protocol/tot/Page
 export * from "./types/request/config";
+export { FileTransform } from "./types";
+export { ConfigRoot } from "./types";

package/src/types/request/config.ts

@@ -1,98 +1,3 @@
-/**一次作业的模型配置；
- * 若本对象为空{}的话：默认是按照修改时间的顺序简易模式地合并当前工作目录的所有pdf文件。
- * 若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
- * */
-export interface ConfigRoot<T> {
-  //是否生成合并的pdf：正常情况下， 默认=true进行files输出pdf全部做合并的。 除非files[]也是空的情形。
-  //但若需对任一个URL叠加新页眉页脚的，merge就不能=false的。
-  merge?: boolean;
-  //重定义 合并的pdf文件名, 否则默认名。不需要加 .pdf结尾的
-  name: string;
-  //双面打印的合并输出pdf， 默认=true, 表示合并输出的pdf考虑到双面打印的页眉页脚的布局差异化情况了。
-  doubleSide?: boolean;
-  //统一一整份应该用的页眉页脚
-  //假如files[]里面有些url自己也定义了lay{localSumNo=false}的页眉页脚输出配置，只能忽略掉它们，页码总数不算他们的，页码连续编号也不算它们的占坑:最好都挪到最后面。
-  lay?: HeadFooter;
-  //每一个独立的pdf生成：
-  files: [T];
-
-  //共用一个浏览器窗口 默认=true
-  singleTab?: boolean;
-  //自动关闭浏览器窗口 默认=false
-  closeTab?: boolean;
-
-  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
-  headerTemplate?: string;
-  footerTemplate?: string;
-  headerTemplateL?: string;
-  footerTemplateL?: string;
-  //第二阶段页眉页脚生成的浏览器执行窗口的targetId,不可配置。
-  CDPtab?: string;
-}
-
-/**等待输出的每个独立文件:URL，这些文件可能要合并。
- * @前提条件 是：每个url独立文件生成的PDF，它的纸张大小必须保证同一个大小尺寸， size: 必须唯一，但是纸张方向在某些约束条件中可以横屏竖屏混合的。
- * 物理打印机：纸张适配，横竖方向还好能自动调节，size 真实打印纸张尺寸就不好自动处理, 不一样的尺寸?最好拆解pdf。
- * 标准纸张大小的：静态html内CSS定义横竖纸张方向混合的：用reverseRanges参数设置部分纸张反转纸张方向，pageRanges=''的前提下：配置比如'1-5, 8, 11-13'和landscape参数设置相反方向。
- * */
-export interface FileTransform {
-  //[必须配置的] 特殊的前缀是 http:// https:// 没有这俩个的都是本地工作目录的文件全名(含文件类型后缀 *.pdf *.*)。
-  //任意的本地文件类型，只要可以被Chrome装载并能够支持打印预览的都可以。http打头的网页必须确保已经登录了，也就是遗留cockies token,不能要求交互登录。本地文件不能要求输入口令。
-  //不支持*.xls *.doc文件；不支持的格式实际在浏览器拖拽窗口后会蜕变成了下载形式的。被加密的文件必须提前解密,网站登录需提前解决。
-  //【特殊问题】若URL网页动态化太离谱，周期性地不间断地更新页面,没法触发加载结束事件的，只能手动在浏览器查看打印另存pdf，然后把手动生成pdf合并进来。Tab切换会主动刷新的也不触发。
-  url: string;
-  //输出本地工作目录的文件名， 不需要加 .pdf结尾的 【注意】如果out为空表示url是pdf的没必要转换的要直接进入合并步骤。
-  //【特别】必须配置唯一性 的本地 工作目录的文件名，同名的被直接覆盖了。
-  out: string;
-
-  //是否汇总合并阶段省略本url，不合并进去，那就是单独独立的pdf输出了。默认=true是合并进去。 和是否打印页眉页脚或页眉统计页数没有绝对关系的。
-  merge?: boolean;
-
-  //默认取值都是=true; 第一阶段不会生成页眉页脚的，汇总第二阶段这个参数才会生效！
-  //这里配置displayHeaderFooter优先级最高。
-  //页眉页脚如何分开控制是否打印的： 可以把lay{head，foot}其中一个配置串给设置为null,null就代表不输出。例如head=null就不输出页眉，但是页脚照旧打印的。本url的配置优先于汇总pdf配置。
-  //若ConfigRoot<T>.merge=false那么必然导致FileTransform.merge强制=false，每个独立pdf页码独立的独立都从1开始编号吗还需要打印吗，页眉页脚需要打印吗？这个情况页眉页脚打印的默认值改成false;
-  displayHeaderFooter: boolean;
-
-  //【特别注意】frNo 可能和 headFrom 配置矛盾。
-  //本url打印：从第几页才开始页眉页脚的打印，#页码同样也是在这之后才可能计数和编号!。默认值headFrom=1：就是第一页就开始打印页眉页脚的。
-  //书本封面页情况的。这个参数有最高优先级。 【注意】和frNo设置相互影响, 没有页眉页脚就失去页码意义了。若真的违反了可能页码不能连续输出的，被隐藏了页码缘故。
-  headFrom?: number;
-  //本url打印后，从本URL输出的第几页开始才进行的页码序号的顺序输出的，前面几页不打印页码(但是页眉页脚要打印)。默认值=1全部都打页码。若frNo=0全部不打页码的。
-  //假如displayHeaderFooter=false也即页码无法显示出来的情况：请申明frNo=0; 不然默认是连续页码的，不打印的也有占用页码的隐藏的连续数字啊。
-  //注意若有配置 headFrom 的要协调好。
-  frNo?: number;
-
-  //是否对页码支持连续编号：  Continuous numbering 是跟随汇总合并的页码 基数合计。【注意】本配置单个url范围，单个url不能混合本地页码和全局页面两种！
-  //统计页数是否本URL独立自己范围之内进行的汇总计数。比如书本目录有多页的可以独立统计页码序号以及总页数的。默认=false;
-  localSumNo?: boolean;
-  //本url对应的部分应该用的页眉页脚，覆盖掉合并pdf的相对应设置。页面上只能支持输出一次页眉页脚，不重叠做输出。
-  //若lay{localSumNo=false}只能固定支持本url自己内部的页码统计顺序编号，不考虑合并pdf总页数带来的影响的。 还是？预设其它部分的页数统计总数之后？再做偏移页码编写？
-  lay: PartHeadFooter;
-  //前端声明本url在第一阶段打印输出后，生成的pdf应该有几页。 count没有设置的救不会做异常检查的。不是第二阶段的计数：双面情况可能增加空白页
-  count?: number;
-  //双面打印的 默认=true, 表示独立分开输出的pdf文件的：考虑到双面打印的页眉页脚的布局差异化情况了。
-  //合并输出merge=true的情况：该参数无效，要看汇总配置的哪一个 # ConfigRoot<T>{ doubleSide： }字段。
-  doubleSide: boolean;
-  //双面打印的情形：必须确保本URL的第一个页是正好右手边(书本翻页的奇数号页码)开始的位置页。正常第一个URL首页面就是双面打印的右手边位置页；默认值=false不必确保.
-  rightHand: boolean;
-
-  //页码是罗马数字；论文目录需要的；默认=false阿拉伯数字。"I","II","III","IV","V","VI","VII","VIII","IX" "X"XI"XII"表盘符号
-  //roman只能针对本URL启用；数字转换范围最大支持1到12，超过了便改阿拉伯数字，且只针对pageNumber有效, totalPages不会采用。
-  roman?: boolean;
-
-  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
-  headerTemplate?: string;
-  footerTemplate?: string;
-  headerTemplateL?: string;
-  footerTemplateL?: string;
-  //这针对：可能由于动态布局导致的浏览器打印预览和实际URL纯粹js网页动态布局的真实内容页数不一致的毛病。
-  //开启的浏览器窗口宽度。默认最大化的。
-  brwidth?: number;
-  //第一阶段Url转pdf的浏览器执行窗口的targetId,不可配置。
-  CDPtab?: string;
-}
-
 /*看 Page.printToPDF（）文档说明的： 可以使用的注入参数:
   date: formatted print date
   title: document title

package/src/types.d.ts

@@ -0,0 +1,97 @@
+import { HeadFooter, PartHeadFooter } from "@/types/request/config";
+
+/**一次作业的模型配置；
+ * 若本对象为空{}的话：默认是按照修改时间的顺序简易模式地合并当前工作目录的所有pdf文件。
+ * 若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
+ * */
+export interface ConfigRoot<T> {
+  //是否生成合并的pdf：正常情况下， 默认=true进行files输出pdf全部做合并的。 除非files[]也是空的情形。
+  //但若需对任一个URL叠加新页眉页脚的，merge就不能=false的。
+  merge?: boolean;
+  //重定义 合并的pdf文件名, 否则默认名。不需要加 .pdf结尾的
+  name: string;
+  //双面打印的合并输出pdf， 默认=true, 表示合并输出的pdf考虑到双面打印的页眉页脚的布局差异化情况了。
+  doubleSide?: boolean;
+  //统一一整份应该用的页眉页脚
+  //假如files[]里面有些url自己也定义了lay{localSumNo=false}的页眉页脚输出配置，只能忽略掉它们，页码总数不算他们的，页码连续编号也不算它们的占坑:最好都挪到最后面。
+  lay?: HeadFooter;
+  //每一个独立的pdf生成：
+  files: [T];
+
+  //共用一个浏览器窗口 默认=true
+  singleTab?: boolean;
+  //自动关闭浏览器窗口 默认=false
+  closeTab?: boolean;
+
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  headerTemplateL?: string;
+  footerTemplateL?: string;
+  //第二阶段页眉页脚生成的浏览器执行窗口的targetId,不可配置。
+  CDPtab?: string;
+}
+
+// types.d.ts
+/**等待输出的每个独立文件:URL，这些文件可能要合并。
+ * @前提条件 是：每个url独立文件生成的PDF，它的纸张大小必须保证同一个大小尺寸， size: 必须唯一，但是纸张方向在某些约束条件中可以横屏竖屏混合的。
+ * 物理打印机：纸张适配，横竖方向还好能自动调节，size 真实打印纸张尺寸就不好自动处理, 不一样的尺寸?最好拆解pdf。
+ * 标准纸张大小的：静态html内CSS定义横竖纸张方向混合的：用reverseRanges参数设置部分纸张反转纸张方向，pageRanges=''的前提下：配置比如'1-5, 8, 11-13'和landscape参数设置相反方向。
+ * */
+export interface FileTransform {
+  //[必须配置的] 特殊的前缀是 http:// https:// 没有这俩个的都是本地工作目录的文件全名(含文件类型后缀 *.pdf *.*)。
+  //任意的本地文件类型，只要可以被Chrome装载并能够支持打印预览的都可以。http打头的网页必须确保已经登录了，也就是遗留cockies token,不能要求交互登录。本地文件不能要求输入口令。
+  //不支持*.xls *.doc文件；不支持的格式实际在浏览器拖拽窗口后会蜕变成了下载形式的。被加密的文件必须提前解密,网站登录需提前解决。
+  //【特殊问题】若URL网页动态化太离谱，周期性地不间断地更新页面,没法触发加载结束事件的，只能手动在浏览器查看打印另存pdf，然后把手动生成pdf合并进来。Tab切换会主动刷新的也不触发。
+  url: string;
+  //输出本地工作目录的文件名， 不需要加 .pdf结尾的 【注意】如果out为空表示url是pdf的没必要转换的要直接进入合并步骤。
+  //【特别】必须配置唯一性 的本地 工作目录的文件名，同名的被直接覆盖了。
+  out: string;
+
+  //是否汇总合并阶段省略本url，不合并进去，那就是单独独立的pdf输出了。默认=true是合并进去。 和是否打印页眉页脚或页眉统计页数没有绝对关系的。
+  merge?: boolean;
+
+  //默认取值都是=true; 第一阶段不会生成页眉页脚的，汇总第二阶段这个参数才会生效！
+  //这里配置displayHeaderFooter优先级最高。
+  //页眉页脚如何分开控制是否打印的： 可以把lay{head，foot}其中一个配置串给设置为null,null就代表不输出。例如head=null就不输出页眉，但是页脚照旧打印的。本url的配置优先于汇总pdf配置。
+  //若ConfigRoot<T>.merge=false那么必然导致FileTransform.merge强制=false，每个独立pdf页码独立的独立都从1开始编号吗还需要打印吗，页眉页脚需要打印吗？这个情况页眉页脚打印的默认值改成false;
+  displayHeaderFooter: boolean;
+
+  //【特别注意】frNo 可能和 headFrom 配置矛盾。
+  //本url打印：从第几页才开始页眉页脚的打印，#页码同样也是在这之后才可能计数和编号!。默认值headFrom=1：就是第一页就开始打印页眉页脚的。
+  //书本封面页情况的。这个参数有最高优先级。 【注意】和frNo设置相互影响, 没有页眉页脚就失去页码意义了。若真的违反了可能页码不能连续输出的，被隐藏了页码缘故。
+  headFrom?: number;
+  //本url打印后，从本URL输出的第几页开始才进行的页码序号的顺序输出的，前面几页不打印页码(但是页眉页脚要打印)。默认值=1全部都打页码。若frNo=0全部不打页码的。
+  //假如displayHeaderFooter=false也即页码无法显示出来的情况：请申明frNo=0; 不然默认是连续页码的，不打印的也有占用页码的隐藏的连续数字啊。
+  //注意若有配置 headFrom 的要协调好。
+  frNo?: number;
+
+  //是否对页码支持连续编号：  Continuous numbering 是跟随汇总合并的页码 基数合计。【注意】本配置单个url范围，单个url不能混合本地页码和全局页面两种！
+  //统计页数是否本URL独立自己范围之内进行的汇总计数。比如书本目录有多页的可以独立统计页码序号以及总页数的。默认=false;
+  localSumNo?: boolean;
+  //本url对应的部分应该用的页眉页脚，覆盖掉合并pdf的相对应设置。页面上只能支持输出一次页眉页脚，不重叠做输出。
+  //若lay{localSumNo=false}只能固定支持本url自己内部的页码统计顺序编号，不考虑合并pdf总页数带来的影响的。 还是？预设其它部分的页数统计总数之后？再做偏移页码编写？
+  lay: PartHeadFooter;
+  //前端声明本url在第一阶段打印输出后，生成的pdf应该有几页。 count没有设置的救不会做异常检查的。不是第二阶段的计数：双面情况可能增加空白页
+  count?: number;
+  //双面打印的 默认=true, 表示独立分开输出的pdf文件的：考虑到双面打印的页眉页脚的布局差异化情况了。
+  //合并输出merge=true的情况：该参数无效，要看汇总配置的哪一个 # ConfigRoot<T>{ doubleSide： }字段。
+  doubleSide: boolean;
+  //双面打印的情形：必须确保本URL的第一个页是正好右手边(书本翻页的奇数号页码)开始的位置页。正常第一个URL首页面就是双面打印的右手边位置页；默认值=false不必确保.
+  rightHand: boolean;
+
+  //页码是罗马数字；论文目录需要的；默认=false阿拉伯数字。"I","II","III","IV","V","VI","VII","VIII","IX" "X"XI"XII"表盘符号
+  //roman只能针对本URL启用；数字转换范围最大支持1到12，超过了便改阿拉伯数字，且只针对pageNumber有效, totalPages不会采用。
+  roman?: boolean;
+
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  headerTemplateL?: string;
+  footerTemplateL?: string;
+  //这针对：可能由于动态布局导致的浏览器打印预览和实际URL纯粹js网页动态布局的真实内容页数不一致的毛病。
+  //开启的浏览器窗口宽度。默认最大化的。
+  brwidth?: number;
+  //第一阶段Url转pdf的浏览器执行窗口的targetId,不可配置。
+  CDPtab?: string;
+}

package/src/utils/pdfgen.ts

@@ -6,12 +6,9 @@ import _ from "lodash";
 // @ts-ignore
 import config from "config";
 import CONFIG from "../configEnv";
-import {
-  ConfigRoot,
-  FileTransform,
-  MyPaperSize,
-} from "../types/request/config";
+import { MyPaperSize } from "../types/request/config";
 import { filePathToUrl } from "../utils/url";
+import { ConfigRoot, FileTransform } from "../types";
 
 //自定义纸张系列的：
 const paperSZs = config.get("size") as MyPaperSize[];
@@ -164,7 +161,7 @@ export class RenderPDF {
       url: url,
       //frameId: targetId, 不能加上： 本地pdf情形实际会有webview/iframe,实际会看到pdf之外的浏览控件框框的。
     });
-    if (errorText) throw new Error(errorText); //若是访问失败应该抛异常的！
+    if (errorText) throw new Error(errorText + " URL=" + url); //若是访问失败应该抛异常的！
     frameId;
     await Emulation.setVirtualTimePolicy({
       policy: "pauseIfNetworkFetchesPending",