page2pdf_server 1.0.0

package/README.md

@@ -0,0 +1,238 @@
+<p align="center">
+    <img width="250px" src="https://user-images.githubusercontent.com/50701501/104827248-f88a1800-585b-11eb-985e-5e31dbb0b913.jpg"><br/>
+</p>
+<p align="center">
+  <a href="https://lerna.js.org/"><img src="https://img.shields.io/badge/PRs-Welcome-brightgreen.svg" alt="Maintained with Lerna"></a>
+  <a href="/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
+</p>
+
+# Overview
+
+**page2pdf_server** is a `Typescript` + `Express` + `Node` starter kit to develop `REST API` server apps.
+Nothing new under the sun, just a straight forward combo to make server development a little bit faster. And of course, this make my freelancing days more enjoyable 😎
+Comes with:
+
+- Everything typed with [Typescript](https://www.typescriptlang.org/)
+- [ES6](http://babeljs.io/learn-es2015/) features/modules
+- ES7 [async](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function) / [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
+- Run with [Nodemon](https://nodemon.io/) for automatic reload & watch
+- [ESLint](http://eslint.org/) for code linting
+- Code formatting using [Prettier](https://www.npmjs.com/package/prettier)
+- Configuration management using [dotenv](https://www.npmjs.com/package/dotenv)
+- Improved commits with [Husky](https://typicode.github.io/husky)
+- Manage production app proccess with [PM2](https://pm2.keymetrics.io/)
+
+  <br>
+  <br>
+
+---
+## 由来
+  目前动态生成的网页html在浏览器上直接打印时，不能支持纸张的横向或纵向方向的混合一次性的打印输出，当前做法只能拆开为多个的打印命令分别打印后再合并装订。
+浏览器不同版本打印网页的效果稍有一点点差距就会导致文书打印时的页码目录针对的页号出现预先设想的页号和实际打印结果不一致性，这对于有些要求苛刻的文书打印，
+动态网页直接打印明显处于不适应地位。为了缝合这个缺陷，特别地推出本软件功能。
+  原本猜想wkhtmltopdf可以，但是发现wkhtmltopdf对于动态生成的网页有js css的普通APP页面生成的效果不如谷歌浏览器好，常用的html2canvas+jsPDF,
+html2pdf.js方案以及更为原始的PDFKit方案都无法完美解决和浏览器的打印预览效果差异大的问题。chrome-remote-interface是比Puppeteer的API更底层的库。
+chrome-remote-interface不会为您启动Chrome。本来想用chrome-remote-interface在纯粹的浏览器客户机环境下实现，但发现可能权限的理由导致尝试失败，
+认定它和puppeteer一样都只能在node.js环境下有效,chrome-remote-interface比起puppeteer更为底层的。
+  本软件定名“文书打印转换器” page2pdf_server，本质是个node.js的web服务器，但实际只提供给本机使用，也不支持多个用户一起用的，web客户端也就是其它通用的
+前端APP浏览器客户使用http url访问本服务模块，最终在本地主机目录生成pdf文件以供进一步打印或发送邮件或移走pdf文件。可支持SPA APP动态生成的网页多个链接
+的合并输出，但前提要求这些网页URL在打印信号前必须安静下来亦即准备好视图，后续不会再执行脚本语言修改页面了。封面cover和目录TOC这些也需要应用层APP自己负责
+去生成和校订页码的，不支持pdf的内部点击链接跳转显示页的能力，目标是直接给打印机打印使用的过渡性质的pdf，若要此类能力请直接回到APP动态网页的前端浏览去。
+后续的真实打印机输出，请找ipp实现连接打印机后端静默打印html文件，pdf放入前端预览看react-file-preview-latest嵌入文档阅读器。
+  注意，动态网页在Chrome浏览器直接打印预览的效果应该和本软件转换输出的pdf一致效果，为打印设置的css必须在应用层中自己去添加的。
+纯粹静态html的打印转换pdf，且是标准纸张大小的横竖纸张方向掺杂的这种情况：考虑一次提取一部分pageRanges[]吗，分解多个的files[url,out]独立生成之后做合并。
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org) (`>= 18.0.0`)
+- [Yarn](https://yarnpkg.com/en/docs/install) or [NPM](https://docs.npmjs.com/getting-started/installing-node)
+- 谷歌浏览器，要配置端口号，启动命令设置 C:\Users\herzhang\AppData\Local\Google\Chrome\Application\chrome.exe --remote-debugging-port=9872
+
+## Install
+
+- Fork or Use [this](https://github.com/filoscoder/tenstack-starter/generate) template repository.
+- [Clone](https://github.com/git-guides/git-clone) the forked repository.
+- Install the dependencies with [yarn](https://yarnpkg.com/getting-started/usage) or [npm](https://docs.npmjs.com/cli/v7/commands/npm-install).
+
+> Make sure you already have [`node.js`](https://github.com/filoscoder/tenstack-starter#prerequisites) and [`npm`](https://github.com/filoscoder/tenstack-starter#prerequisites) or [`yarn`](https://github.com/filoscoder/tenstack-starter#prerequisites) installed in your system.
+
+- Set your `git remote add origin` path
+
+```bash
+ git remote add origin ${forked-and-cloned-path}
+```
+
+> [Update the url](https://docs.github.com/en/get-started/getting-started-with-git/managing-remote-repositories#changing-a-remote-repositorys-url) if you already have an `origin`
+
+<br>
+<br>
+
+## Config
+
+- Copy `.env.example` a file at the root of the application.
+- Add or modify specific variables and update it according to your need.
+
+```bash
+ cp .env.example .env
+```
+
+> Check the `config` folder to customize your settings (`/src/config`)
+
+<br>
+<br>
+
+## Alias @
+
+To make paths clean and ease to access `@` is setup up for `/src` path
+
+```javascript
+// BEFORE
+import config from './config';
+import routes from './routes';
+
+// NOW
+import config from '@/config';
+import routes from '@/routes';
+```
+
+> You can customize this setup:
+> `/tsconfig.json` > compilerOptions.paths
+> `/eslintrc.yml` > rules.settings.alias.map
+
+<br>
+<br>
+
+## Local Development
+
+Run the server locally. It will be run with Nodemon and ready to serve on port `8080` (unless you specify it on your `.env`)
+
+```bash
+ yarn start # or npm start
+```
+
+> Check [`package.json`](https://github.com/filoscoder/tenstack-starter/blob/master/package.json) to see more "scripts"
+
+<br>
+<br>
+
+## Production
+
+First, build the application.
+
+```bash
+ yarn build # or npm run build
+```
+
+Then, use [`pm2`](https://github.com/Unitech/pm2) to start the application as a service.
+
+```bash
+ yarn service:start # or npm run service:start
+```
+
+<br>
+<br>
+
+# Contribution
+
+This repository will be managed as an `open-source`. <br>
+Please feel free to open an `issue` or a `pull request` to suggest changes or additions.
+
+# Support & Contact
+
+If you have any question or suggestion, don't hesitate to contact me:
+
+✉️ [herzhang@163.com](mailto:herzhang@163.com)
+
+
+# Author & Credits
+
+<a src="https://gitee.com/heerzhang/page2pdf-server">
+<img width="60px" style="border-radius: 50%;" src="https://foruda.gitee.com/avatar/1677151822424320339/8832894_heerzhang_1616223106.png!avatar30">
+</a>
+
+# windows驻守长期运行本服务，纯粹服务端模式
+  node.js必须有安装。执行底下命令:
+  npm install pm2 -g
+  npm install pm2-windows-startup -g
+  若运行 pm2-startup install 报错的
+  在系统中搜索Windows PowerShell，用管理员身份打开
+  打开窗口输入命令行  set-ExecutionPolicy RemoteSigned 输入y回车确认，再回头运行pm2-startup install。
+  pm2 start D:\home\page2pdf-server\dist\src\index.js --name page2pdf-server
+  pm2 save	  #保证重启电脑可以自动跑
+  pm2 ls  #查看守护服务情况，自带进程node C:\Users\herzhang\AppData\Roaming\npm\node_modules\pm2\lib\Daemon.js
+  pm2 stop all    # 停止所有服务进程
+  pm2 delete 0    # 删除服务(pm2 delete  app_id)
+  要卸载服务，执行：pm2-service-uninstall   直接杀掉自带进程node；
+  pm2 logs — 从所有正在运行的应用中输出日志
+  pm2 logs page2pdf-server  — 只从指定的应用中输出日志
+  pm2 flush — 刷新所有日志数据，释放磁盘空间
+# 前台可看得见输出的运行模式,windows环境的
+  npm install -g nodemon
+  start  nodemon  D:\home\page2pdf-server\dist\src\index.js
+  桌面上整个 文书打印转换器.bat 双击运行。
+  文书打印转换器.bat 命令cmd窗口可能挂起，注意回撤继续。
+  cmd命令行窗口鼠标点击后挂起的原因和处理方法；https://blog.csdn.net/fanstering/article/details/116455669
+  注意Chrome浏览器启动cmd配置,chrome.exe --headless不能加，不然报错: No inspectable targets。
+
+# 前端对接和使用API
+  http://localhost:9389/api/pdf
+  前端发送请求后，可观察浏览器页面以及本地工作目录生成文件和本文书打印转换器的终端输出，前端APP最好发起打印转换指令以后等待结果完成，
+  当然也允许不等待的，直接从转换器来获得结果输出，前端继续干别的事，但是应该保证本转换器只会单用户单进程排他的运作，不要同时进行多个转换命令。
+  要测试，用IDEA的HTTP客户端发送如下：
+  POST http://localhost:9389/api/pdf
+  Content-Type: application/json
+
+{
+"merge": true,
+"name": "asjsak啊实打实",
+"lay": {
+"head": "address"
+},
+"files": [
+{
+"url": "ChromePage7.pdf",
+"out": "add_ChromePag"
+},
+{
+"url": "https://www.npmjs.com/search?q=chrome-remote-interface",
+"out": "横页脚的qa"
+}
+]
+}
+
+  注意，如果发送post请求的body底下的内容实际为空的话，本转换器默认执行：把工作目录的所有pdf文件按照修改时间顺序进行合并，默认输出文件名=配置好的名字。
+  假若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
+
+# 页眉页脚配置html脚本转为json后
+例子,用https://uutool.cn/html2json/ 工具可转换,转换才能通过api/pdf发送命令的。
+"lay": {
+  "head": [
+    "<div style=\\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\\"></span>",
+    "<div style=\\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\\"><span class=title></div>",
+    "<div style=\\\"position: absolute; text-align: right; bottom: 5px;right: 20px;\\\">version: 1.0</div>",
+    "</div>"
+  ] ,
+  "foot": [
+    "<div style=\\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\\">",
+    "<div style=\\\"position: absolute; text-align: left; top: 5px;left: 60px;\\\">YYYY-MM-DD</div>",
+    "<div style=\\\"position: absolute; width: 100%; text-align: center; top: 5px;\\\">&copy;2022 ABCD</div>",
+    "<div style=\\\"position: absolute; text-align: right;top: 5px;right: 20px;\\\"> <span class=pageNumber></span> / <span class=totalPages></span></div>",
+    "</div>"
+  ]
+}
+
+# 注意适用性
+  本文书打印转换器只能适用单用户在客户本机用，每次执行一个打印指令，不要并行发出指令，本机工作目录也是临时文件，针对当前指令适用的，不能存放无关文件。
+  本转换器console命令输出窗口可实时观察到当前打印转换指令的执行过程输出提示，同时目标浏览器也会新开启浏览窗口，这些由本转换器自动开启的浏览窗口实际上
+  就是转换读取页面的过程，若无法访问页面或没有登录目标url网站的就能体现在这些窗口中，每一个url转换生成了相应对应pdf之后就失去用处了。
+  本转换器内部使用了CDP协议Chrome DevTools Protocol连接的浏览器进程，暂时没发现安全性问题。
+# 配置文件
+ 本地较为固定的参数设置，在/config/default.json文件，例子如下的，注意自定义纸张没有方向的说法，"w"宽度,"h"高度,单位英寸。
+ {
+   "base_path": "E:\\临时\\web打印\\pdfs",
+   "default_file": "合并后的文档",
+   "size":[
+     {"name":"D8", "css": "4in 6in","w": 4,"h": 6},
+     {"name":"D4", "css": "10.4in 12.6in","w": 10.4,"h": 12.6}
+   ]
+ }

package/__tests__/UrltoPdf/generatePdf.test.ts

@@ -0,0 +1,207 @@
+import { SuperAgentTest } from "supertest";
+import { OK } from "http-status/lib";
+import { initAgent } from "../helpers";
+
+//prettify真叼： 每个地方都给您报出 红色
+const TIMEOUT = 260000; //设置超时，避免单步歇菜
+let agent: SuperAgentTest;
+
+beforeAll(async () => {
+  agent = await initAgent();
+});
+
+/**替代： 浏览器postman等工具发送包后，后端服务器Debug模式运行单步调试模式已经没能使用了。只好改为jest来对付了。
+后面的/${CONFIG.APP.VER} 就是加了/v1结尾的该服务工程的版本号;
+* */
+describe("[PDF] => Gen", () => {
+  describe("Post: '/api/pdf'", () => {
+    it(
+      "通用基本的",
+      async () => {
+        const response = await agent.post(`/api/pdf`).send({
+          name: "asjsak啊实打实",
+          lay: {
+            head: [
+              '<div style=\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\"></span>',
+              '<div style=\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\"><span class=title></div>',
+              '<div style=\\"position: absolute; text-align: right; bottom: 5px;right: 20px;\\">version: 1.0</div>',
+              "</div>",
+            ],
+            foot: [
+              '<div style=\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\">',
+              '<div style=\\"position: absolute; text-align: left; top: 5px;left: 60px;\\">YYYY-MM-DD</div>',
+              '<div style=\\"position: absolute; width: 100%; text-align: center; top: 5px;\\">&copy;2022 ABCD</div>',
+              '<div style=\\"position: absolute; text-align: right;top: 5px;right: 20px;\\"> <span>${pageNumber}</span> / <span>${totalPages}</span></div>',
+              "</div>",
+            ],
+          },
+          files: [
+            {
+              url: "testHtmlPrint.html",
+              out: "testHtmlPrint转",
+              headFrom: 4,
+              frNo: 0,
+            },
+            {
+              url: "横页脚的.pdf",
+              displayHeaderFooter: true,
+              rightHand: true,
+            },
+          ],
+        });
+        expect(response.status).toBe(OK);
+        expect(Object.keys(response.body.data)).toEqual(["result"]);
+      },
+      TIMEOUT,
+    );
+
+    it(
+      "汇总阶段第二个url独立pdf输出",
+      async () => {
+        const response = await agent.post(`/api/pdf`).send({
+          name: "asjsak啊实打实",
+          lay: {
+            head: [
+              '<div style=\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\"></span>',
+              '<div style=\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\"><span class=title></div>',
+              '<div style=\\"position: absolute; text-align: right; bottom: 5px;right: 20px;\\">version: 1.0</div>',
+              "</div>",
+            ],
+            foot: [
+              '<div style=\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\">',
+              '<div style=\\"position: absolute; text-align: left; top: 5px;left: 60px;\\">YYYY-MM-DD</div>',
+              '<div style=\\"position: absolute; width: 100%; text-align: center; top: 5px;\\">&copy;2022 ABCD</div>',
+              '<div style=\\"position: absolute; text-align: right;top: 5px;right: 20px;\\"> <span>${pageNumber}</span> / <span>${totalPages}</span></div>',
+              "</div>",
+            ],
+          },
+          files: [
+            {
+              url: "testHtmlPrint.html",
+              out: "testHtmlPrint转",
+              lay: {
+                marginTop: 0.55,
+                marginBottom: 0.45,
+              },
+            },
+            {
+              url: "横页脚的.pdf",
+              merge: false,
+              displayHeaderFooter: true,
+              rightHand: true,
+              lay: {
+                marginTop: 0.55,
+                marginBottom: 0.45,
+              },
+            },
+          ],
+        });
+        expect(response.status).toBe(OK);
+        expect(Object.keys(response.body.data)).toEqual(["result"]);
+      },
+      TIMEOUT,
+    );
+
+    it(
+      "双面打印的页码_总的",
+      async () => {
+        const response = await agent.post(`/api/pdf`).send({
+          name: "asjsak啊实打实",
+          lay: {
+            head: [
+              '<div style=\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\"></span>',
+              '<div style=\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\"><span id=\\"titlespan\\" class=title></div>',
+              '<div style=\\"-NOT_DISPLAY- position: absolute; text-align: right; bottom: 5px;right: 20px;\\">',
+              "<span>${pageNumber}</span> / <span>${totalPages}</span></div>",
+              "</div>",
+            ],
+            foot: [
+              '<div style=\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\">',
+              '<div style=\\"position: absolute; text-align: left; top: 5px;left: 60px;\\">YYYY-MM-DD</div>',
+              '<div style=\\"position: absolute; width: 100%; text-align: center; top: 5px;\\">&copy;2022 ABCD</div>',
+              '<div style=\\"position: absolute; text-align: right;top: 5px;right: 20px;\\"> <span>${pageNumber}</span> / <span>${totalPages}</span></div>',
+              "</div>",
+            ],
+          },
+          files: [
+            {
+              url: "testHtmlPrint.html",
+              out: "testHtmlPrint转",
+              headFrom: 4,
+              frNo: 5,
+            },
+            {
+              url: "横页脚的.pdf",
+              displayHeaderFooter: true,
+              rightHand: true,
+            },
+          ],
+        });
+        expect(response.status).toBe(OK);
+        expect(Object.keys(response.body.data)).toEqual(["result"]);
+      },
+      TIMEOUT,
+    );
+
+    it(
+      "双面打印的页码_单URL",
+      async () => {
+        const response = await agent.post(`/api/pdf`).send({
+          name: "asjsak啊实打实",
+          lay: {},
+          files: [
+            {
+              url: "report.pdf",
+              out: "热效率详细测试",
+              headFrom: 4,
+              frNo: 5,
+              localSumNo: true,
+              roman: true,
+              lay: {
+                head: [
+                  '<div style=\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\"></span>',
+                  '<div style=\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\"><span id=\\"titlespan\\" class=title></div>',
+                  '<div style=\\"-NOT_DISPLAY- position: absolute; text-align: right; bottom: 5px;right: 20px;\\">',
+                  "<span>${pageNumber}</span> / <span>${totalPages}</span></div>",
+                  "</div>",
+                ],
+                foot: [
+                  '<div style=\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\">',
+                  '<div style=\\"position: absolute; text-align: left; top: 5px;left: 60px;\\">YYYY-MM-DD</div>',
+                  '<div style=\\"position: absolute; width: 100%; text-align: center; top: 5px;\\">&copy;2022 ABCD</div>',
+                  '<div style=\\"-NOT_DISPLAY- position: absolute; text-align: right;top: 5px;right: 20px;\\"> <span>${pageNumber}</span> / <span>${totalPages}</span></div>',
+                  "</div>",
+                ],
+              },
+            },
+            {
+              url: "横页脚的.pdf",
+              displayHeaderFooter: true,
+              rightHand: true,
+              lay: {
+                head: [
+                  '<div style=\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\"></span>',
+                  '<div style=\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\"><span id=\\"titlespan\\" class=title></div>',
+                  '<div style=\\"-NOT_DISPLAY- position: absolute; text-align: right; bottom: 5px;right: 20px;\\">',
+                  "<span>${pageNumber}</span> / <span>${totalPages}</span></div>",
+                  "</div>",
+                ],
+                foot: [
+                  '<div style=\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\">',
+                  '<div style=\\"position: absolute; text-align: left; top: 5px;left: 60px;\\">YYYY-MM-DD</div>',
+                  '<div style=\\"position: absolute; width: 100%; text-align: center; top: 5px;\\">&copy;2022 ABCD</div>',
+                  '<div style=\\"-NOT_DISPLAY- position: absolute; text-align: right;top: 5px;right: 20px;\\"> <span>${pageNumber}</span> / <span>${totalPages}</span></div>',
+                  "</div>",
+                ],
+              },
+            },
+          ],
+        });
+        expect(response.status).toBe(OK);
+        expect(Object.keys(response.body.data)).toEqual(["result"]);
+        console.log("结果:", response.body.data);
+      },
+      TIMEOUT,
+    );
+  });
+});

package/__tests__/UrltoPdf/pdfSplit.test.ts

@@ -0,0 +1,69 @@
+import { SuperAgentTest } from "supertest";
+import { OK } from "http-status/lib";
+import { initAgent } from "../helpers";
+// import CONFIG from "../../src/configEnv";
+
+//prettify真叼： 每个地方都给您报出 红色
+const TIMEOUT = 260000; //设置超时，避免单步歇菜
+let agent: SuperAgentTest;
+
+beforeAll(async () => {
+  agent = await initAgent();
+});
+
+/**替代： 浏览器postman等工具发送包后，后端服务器Debug模式运行单步调试模式已经没能使用了。只好改为jest来对付了。
+后面的/${CONFIG.APP.VER} 就是加了/v1结尾的该服务工程的版本号;
+* */
+describe("[PDF] => Gen", () => {
+  describe("Post: '/api/pdf'", () => {
+    it(
+      "全部合并工作目录的所有pdf文件",
+      async () => {
+        const response = await agent.post(`/api/pdf`).send({});
+        expect(response.status).toBe(OK);
+        expect(Object.keys(response.body.data)).toEqual(["result"]);
+      },
+      TIMEOUT,
+    );
+
+    it(
+      "pdf建议拆分成多个pdf",
+      async () => {
+        const response = await agent.post(`/api/split`).send({
+          input: "产生的22.pdf",
+          files: [
+            {
+              pageRanges: "1-3,7-8",
+              out: "拆分achaRErint转",
+            },
+            {
+              pageRanges: "7,6,1",
+              out: "最小那3QWDS",
+            },
+          ],
+        });
+        expect(response.status).toBe(OK);
+        expect(Object.keys(response.body.data)).toEqual(["result"]);
+        expect(response.body.data).toEqual({ result: "成功！" });
+        console.log("结果:", response.body.data);
+      },
+      TIMEOUT,
+    );
+  });
+});
+
+/*这里发送的和IDEA工具发送差异： .post(`/api/split`).send({})是对象化的。
+{
+  "input": "产生的22.pdf",
+  "files": [
+    {
+      "pageRanges": "1-3,5,8",
+      "out": "ch拆分achaRErint转"
+    },
+    {
+      "pageRanges": "4,8",
+      "out": "tesrint2323QWDS"
+    }
+  ]
+}
+* */

package/__tests__/helpers/index.ts

@@ -0,0 +1,21 @@
+import supertest, { SuperAgentTest } from "supertest";
+
+import { createApp } from "@/app";
+
+// let dbConnection: Mongoose;
+
+export const initAgent = async (): Promise<SuperAgentTest> => {
+  const app = createApp();
+  const agent = supertest.agent(app);
+  // dbConnection = await mongoDbConnection();
+  // await agent.post("/api/v2/auth/signin").send({
+  //   email: testUser.email,
+  //   password: testUser.password,
+  // });
+
+  return agent;
+};
+
+// export const closeClients = async (): Promise<void> => {
+//   await dbConnection.disconnect();
+// };

package/__tests__/home.test.ts

@@ -0,0 +1,77 @@
+import { SuperAgentTest } from "supertest";
+import HttpStatus, { OK, BAD_REQUEST } from "http-status/lib";
+import { initAgent } from "./helpers";
+import CONFIG from "@/configEnv";
+
+//prettify真叼： 每个地方都给您报出 红色
+const TIMEOUT = 60000; //设置超时，避免单步歇菜
+let agent: SuperAgentTest;
+
+beforeAll(async () => {
+  agent = await initAgent();
+});
+
+describe("[UNIT] => HOME", () => {
+  describe("GET: '/'", () => {
+    it(
+      "Should return API app information",
+      async () => {
+        const response = await agent.get(`/api`);
+        // const response = await agent.get(`/api/${CONFIG.APP.VER}`);  框架例子原始的 版本号;
+        expect(response.status).toBe(OK);
+        expect(Object.keys(response.body.data)).toEqual([
+          "NAME",
+          "VERSION",
+          "VER",
+          "DESCRIPTION",
+          "AUTHORS",
+          "HOST",
+          "PORT",
+          "ENV",
+          "PATH",
+          "MERGE",
+        ]);
+      },
+      TIMEOUT,
+    );
+
+    it.each`
+      query            | field            | expectedStatus
+      ${"name"}        | ${"NAME"}        | ${OK}
+      ${"version"}     | ${"VERSION"}     | ${OK}
+      ${"description"} | ${"DESCRIPTION"} | ${OK}
+      ${"authors"}     | ${"AUTHORS"}     | ${OK}
+      ${"port"}        | ${"PORT"}        | ${OK}
+      ${"env"}         | ${"ENV"}         | ${OK}
+    `(
+      "Should return CONFIG.APP[$field] value when query.key is `$query`",
+      async ({
+        query,
+        field,
+        expectedStatus,
+      }: {
+        query: string;
+        field: keyof typeof CONFIG.APP;
+        expectedStatus: string;
+      }) => {
+        const response = await agent.get(`/api`).query({ key: query });
+
+        expect(response.body.status).toBe(expectedStatus);
+        expect(response.body.data[field]).toBe(CONFIG.APP[field]);
+      },
+      TIMEOUT,
+    );
+
+    it(
+      "Should return 400 status Validation Error",
+      async () => {
+        const invalidQuery = "invalid-field";
+        const response = await agent.get(`/api`).query({ key: invalidQuery });
+
+        expect(response.body.status).toBe(BAD_REQUEST);
+        expect(response.body.message).toBe(HttpStatus[BAD_REQUEST]);
+      },
+      TIMEOUT,
+    );
+  });
+});

package/config/default.json

@@ -0,0 +1,10 @@
+{
+  "base_path": "E:\\临时\\web打印\\pdfs",
+  "default_file": "合并后的文档",
+  "server_port": 9389,
+  "chrome_port": 9872,
+  "size":[
+    {"name":"D8", "css": "4in 6in","w": 4,"h": 6},
+    {"name":"D4", "css": "10.4in 12.6in","w": 10.4,"h": 12.6}
+  ]
+}

package/config/development.json

@@ -0,0 +1,3 @@
+{
+
+}

package/config/production.json

@@ -0,0 +1,3 @@
+{
+
+}

package/config/test.json

@@ -0,0 +1,3 @@
+{
+
+}