@maiyunnet/kebab 3.1.7 → 3.1.8

package/index.d.ts

@@ -8,7 +8,7 @@
  * ------------------------
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "3.1.7";
+export declare const VER = "3.1.8";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 export declare const LIB_PATH: string;

package/index.js

@@ -9,9 +9,9 @@
  * ------------------------
  */
 /** --- 当前系统版本号 --- */
-export const VER = '3.1.7';
+export const VER = '3.1.8';
 // --- 服务端用的路径 ---
-const imu = import.meta.url.replace('file://', '').replace(/^\/(\w:)/, '$1').replace(/\\/g, '/');
+const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */
 const dirname = imu.slice(0, imu.lastIndexOf('/'));
 /** --- 框架根目录，以 / 结尾  --- */

package/lib/core.d.ts

@@ -225,7 +225,7 @@ export declare function ls(opt: {
     'name': string;
 }>>;
 /**
- * --- 完整的克隆一份数组/对象，Kebab: yes, Mutton: no ---
+ * --- 完整的克隆一份数组/对象 ---
  * @param obj 要克隆的对象
  */
 export declare function clone<T>(obj: T): T;

package/lib/core.js

@@ -304,7 +304,6 @@ export function realIP(ctr, name = '') {
     const req = ctr.getPrototype('_req');
     return req.socket.remoteAddress ?? '';
 }
-// --- 以下 Mutton 没有 ---
 /**
  * --- 间隔一段时间 ---
  * @param ms 间隔毫秒
@@ -711,7 +710,7 @@ export async function ls(opt) {
     return j.data;
 }
 /**
- * --- 完整的克隆一份数组/对象，Kebab: yes, Mutton: no ---
+ * --- 完整的克隆一份数组/对象 ---
  * @param obj 要克隆的对象
  */
 export function clone(obj) {

package/lib/net.d.ts

@@ -70,7 +70,7 @@ export declare function buildCookieQuery(cookie: Record<string, ICookie>, uri: k
  */
 export declare function resetCookieSession(cookie: Record<string, ICookie>): void;
 /**
- * --- 创建 FormData 对象, Mutton: false, Kebab: true ---
+ * --- 创建 FormData 对象 ---
  */
 export declare function getFormData(): fd.FormData;
 /**
@@ -80,7 +80,7 @@ export declare function getFormData(): fd.FormData;
  */
 export declare function filterProxyHeaders(headers: http.IncomingHttpHeaders | http2.IncomingHttpHeaders | THttpHeaders, res?: http2.Http2ServerResponse | http.ServerResponse): Record<string, string | string[]>;
 /**
- * --- 正向 mproxy 代理，读取 get 的 url 为实际请求地址 ---
+ * --- 正向 mproxy 代理，注意提前处理不要自动处理 post 数据，读取 get 的 url 为实际请求地址 ---
  * --- get: url, auth ---
  * @param ctr 当前控制器
  * @param auth 校验字符串，读取 get 的 auth 和本参数做比对
@@ -93,7 +93,7 @@ export declare function mproxy(ctr: sCtr.Ctr, auth: string, opt?: IMproxyOptions
  */
 export declare function mproxyData(ctr: sCtr.Ctr): any;
 /**
- * --- 反向代理，将本服务器的某个路由反代到其他网址 ---
+ * --- 反向代理，注意提前处理不要自动处理 post 数据，将本服务器的某个路由反代到其他网址 ---
  * @param ctr 当前控制器
  * @param route 要反代的路由
  * @param opt 参数

package/lib/net.js

@@ -423,7 +423,7 @@ export function resetCookieSession(cookie) {
     }
 }
 /**
- * --- 创建 FormData 对象, Mutton: false, Kebab: true ---
+ * --- 创建 FormData 对象 ---
  */
 export function getFormData() {
     return new fd.FormData();
@@ -457,7 +457,7 @@ export function filterProxyHeaders(headers, res) {
     return heads;
 }
 /**
- * --- 正向 mproxy 代理，读取 get 的 url 为实际请求地址 ---
+ * --- 正向 mproxy 代理，注意提前处理不要自动处理 post 数据，读取 get 的 url 为实际请求地址 ---
  * --- get: url, auth ---
  * @param ctr 当前控制器
  * @param auth 校验字符串，读取 get 的 auth 和本参数做比对
@@ -466,7 +466,6 @@ export function filterProxyHeaders(headers, res) {
 export async function mproxy(ctr, auth, opt = {}) {
     const req = ctr.getPrototype('_req');
     const res = ctr.getPrototype('_res');
-    const input = ctr.getPrototype('_input');
     /** --- 客户端请求中的 get 的数据 --- */
     const get = ctr.getPrototype('_get');
     if (get['auth'] !== auth) {
@@ -479,7 +478,7 @@ export async function mproxy(ctr, auth, opt = {}) {
     opt.headers ??= {};
     Object.assign(opt.headers, filterProxyHeaders(req.headers));
     // --- 发起请求 ---
-    const rres = await request(get['url'], req.headers['content-type']?.includes('form-data') ? req : input, opt);
+    const rres = await request(get['url'], req, opt);
     if (rres.error) {
         return -2;
     }
@@ -510,7 +509,7 @@ export function mproxyData(ctr) {
     return data;
 }
 /**
- * --- 反向代理，将本服务器的某个路由反代到其他网址 ---
+ * --- 反向代理，注意提前处理不要自动处理 post 数据，将本服务器的某个路由反代到其他网址 ---
  * @param ctr 当前控制器
  * @param route 要反代的路由
  * @param opt 参数
@@ -519,7 +518,6 @@ export async function rproxy(ctr, route, opt = {}) {
     const req = ctr.getPrototype('_req');
     const res = ctr.getPrototype('_res');
     const config = ctr.getPrototype('_config');
-    const input = ctr.getPrototype('_input');
     const path = config.const.path + (config.const.qs ? '?' + config.const.qs : '');
     for (const key in route) {
         if (!path.startsWith(key)) {
@@ -534,7 +532,7 @@ export async function rproxy(ctr, route, opt = {}) {
         opt.headers ??= {};
         Object.assign(opt.headers, filterProxyHeaders(req.headers));
         // --- 发起请求 ---
-        const rres = await request(route[key] + lpath, req.headers['content-type']?.includes('form-data') ? req : input, opt);
+        const rres = await request(route[key] + lpath, req, opt);
         if (rres.error) {
             return false;
         }

package/lib/text.d.ts

@@ -118,17 +118,17 @@ export declare function isRealPath(path: string): boolean;
  */
 export declare function getFilename(path: string): string;
 /**
- * --- 将普通的返回 JSON 对象序列化为字符串，Mutton 不能使用 ---
+ * --- 将普通的返回 JSON 对象序列化为字符串 ---
  * @param o 返回 JSON 对象
  */
 export declare function stringifyResult(rtn: kebab.Json): string;
 /**
- * --- 将字符串解析为对象，返回 false 代表解析失败，支持 BigInt，Kebab true, Mutton false ---
+ * --- 将字符串解析为对象，返回 false 代表解析失败，支持 BigInt ---
  * @param str 要解析的 json 字符串
  */
 export declare function parseJson(str: string): any;
 /**
- * --- 将对象转换为 json 字符串，返回 false 代表解析失败，支持 BigInt，Kebab true, Mutton false ---
+ * --- 将对象转换为 json 字符串，返回 false 代表解析失败，支持 BigInt ---
  * @param obj 要转换的 json 对象
  * @param space 美化方式
  */
@@ -138,6 +138,10 @@ export declare function stringifyJson(obj: kebab.Json, space?: string | number):
  * @param buf 原始 buffer
  */
 export declare function stringifyBuffer(buf: Buffer): string;
+/**
+ * --- 递归删除 json 中的字符串首尾空格，会返回一个新的对象 ---
+ */
+export declare function trimJson(json: kebab.Json): kebab.Json;
 type TFalsy = false | '' | 0 | null | undefined | typeof NaN;
 /**
  * --- 判断一个值是否是虚假的（为 null/undefined/空字符串/false/0） ---

package/lib/text.js

@@ -339,7 +339,6 @@ export function isIdCardCN(idcard) {
         return false;
     }
 }
-// --- 以下 Mutton: false, Kebab: true ---
 /**
  * --- 将对象转换为 query string ---
  * @param query 要转换的对象
@@ -430,7 +429,7 @@ export function getFilename(path) {
     return path.slice(lio + 1);
 }
 /**
- * --- 将普通的返回 JSON 对象序列化为字符串，Mutton 不能使用 ---
+ * --- 将普通的返回 JSON 对象序列化为字符串 ---
  * @param o 返回 JSON 对象
  */
 export function stringifyResult(rtn) {
@@ -469,7 +468,7 @@ export function stringifyResult(rtn) {
     return JSON.stringify(rtn);
 }
 /**
- * --- 将字符串解析为对象，返回 false 代表解析失败，支持 BigInt，Kebab true, Mutton false ---
+ * --- 将字符串解析为对象，返回 false 代表解析失败，支持 BigInt ---
  * @param str 要解析的 json 字符串
  */
 export function parseJson(str) {
@@ -497,7 +496,7 @@ export function parseJson(str) {
     }
 }
 /**
- * --- 将对象转换为 json 字符串，返回 false 代表解析失败，支持 BigInt，Kebab true, Mutton false ---
+ * --- 将对象转换为 json 字符串，返回 false 代表解析失败，支持 BigInt ---
  * @param obj 要转换的 json 对象
  * @param space 美化方式
  */
@@ -517,6 +516,25 @@ export function stringifyBuffer(buf) {
     const arr = buf.toString('hex').match(/.{1,2}/g);
     return `<Buffer ${arr ? arr.join(' ') : ''}>`;
 }
+/**
+ * --- 递归删除 json 中的字符串首尾空格，会返回一个新的对象 ---
+ */
+export function trimJson(json) {
+    json = Object.assign({}, json);
+    trimJsonRecursion(json);
+    return json;
+}
+function trimJsonRecursion(json) {
+    for (const key in json) {
+        const val = json[key];
+        if (typeof val === 'string') {
+            json[key] = val.trim();
+        }
+        else if (typeof val === 'object') {
+            trimJsonRecursion(val);
+        }
+    }
+}
 /**
  * --- 判断一个值是否是虚假的（为 null/undefined/空字符串/false/0） ---
  * @param val 要判断的值

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.1.7",
+  "version": "3.1.8",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [

package/sys/ctr.d.ts

@@ -124,6 +124,8 @@ export declare class Ctr {
      * --- WebSocket 下连接被终止后会自动被调用的事件，可重写此方法 ---
      */
     onClose(): void | Promise<void>;
+    /** --- 请求发送开始时调用，返回 false 则框架不会自动获取任何 post 内容（仅会在 middle 内触发） --- */
+    onReqStart(): boolean | Promise<boolean>;
     /**
      * --- 获取截止当前时间的总运行时间 ---
      * @param ms 为 true 为毫秒，否则为秒

package/sys/ctr.js

@@ -47,7 +47,6 @@ export class Ctr {
         this._xsrf = '';
         /** --- 自定义 http code --- */
         this._httpCode = 0;
-        // --- Kebab: true，Mutton: false，全局常量等对象 ---
         /** --- 当前语言名 --- */
         this._locale = 'en';
         /** --- 本 ctr 已加载的语言文件列表 --- */
@@ -164,6 +163,10 @@ export class Ctr {
     onClose() {
         return;
     }
+    /** --- 请求发送开始时调用，返回 false 则框架不会自动获取任何 post 内容（仅会在 middle 内触发） --- */
+    onReqStart() {
+        return true;
+    }
     /**
      * --- 获取截止当前时间的总运行时间 ---
      * @param ms 为 true 为毫秒，否则为秒
@@ -658,7 +661,6 @@ export class Ctr {
         }
         return true;
     }
-    // --- 以下：Mutton: false, Kebab: true ---
     /**
      * --- 获取语言包值 ---
      * @param key

package/sys/mod.d.ts

@@ -1,5 +1,5 @@
 /**
- * Project: Mutton, User: JianSuoQiYue
+ * Project: Kebab, User: JianSuoQiYue
  * Date: 2019-6-4 21:35
  * Last: 2020-4-14 13:33:51, 2022-07-23 16:01:34, 2022-09-06 22:59:26, 2023-5-24 19:11:37, 2023-6-13 21:47:58, 2023-7-10 18:54:03, 2023-8-23 17:03:16, 2023-12-11 15:21:22, 2023-12-20 23:12:03, 2024-3-8 16:05:29, 2024-3-20 19:58:15, 2024-8-11 21:14:54, 2024-10-5 14:00:22, 2024-12-14 19:58:34, 2025-9-23 11:01:36
  */
@@ -58,7 +58,7 @@ export default class Mod {
     protected _db: lDb.Pool | lDb.Transaction;
     /** --- Sql 对象 --- */
     protected _sql: lSql.Sql;
-    /** --- ctr 对象, Mutton: false, Kebab: true --- */
+    /** --- ctr 对象 --- */
     protected _ctr?: sCtr.Ctr;
     /**
      * --- 构造函数 ---

package/sys/mod.js

@@ -1,5 +1,5 @@
 /**
- * Project: Mutton, User: JianSuoQiYue
+ * Project: Kebab, User: JianSuoQiYue
  * Date: 2019-6-4 21:35
  * Last: 2020-4-14 13:33:51, 2022-07-23 16:01:34, 2022-09-06 22:59:26, 2023-5-24 19:11:37, 2023-6-13 21:47:58, 2023-7-10 18:54:03, 2023-8-23 17:03:16, 2023-12-11 15:21:22, 2023-12-20 23:12:03, 2024-3-8 16:05:29, 2024-3-20 19:58:15, 2024-8-11 21:14:54, 2024-10-5 14:00:22, 2024-12-14 19:58:34, 2025-9-23 11:01:36
  */
@@ -89,7 +89,7 @@ class Mod {
         this._contain = null;
         /** --- 已算出的 total --- */
         this._total = [];
-        /** --- ctr 对象, Mutton: false, Kebab: true --- */
+        /** --- ctr 对象 --- */
         this._ctr = undefined;
         /** --- 设置的 limit --- */
         this._limit = [0, 0];

package/sys/route.d.ts

@@ -35,7 +35,7 @@ export declare function run(data: {
     };
 }): Promise<boolean>;
 /**
- * --- 删除本次请求所有已上传的临时文件, Mutton: false, Kebab: true ---
+ * --- 删除本次请求所有已上传的临时文件 ---
  * @param cctr Ctr 对象 或 files
  */
 export declare function unlinkUploadFiles(cctr: sCtr.Ctr | Record<string, kebab.IPostFile | kebab.IPostFile[]>): Promise<void>;
@@ -46,10 +46,14 @@ export declare function unlinkUploadFiles(cctr: sCtr.Ctr | Record<string, kebab.
  */
 export declare function waitCtr(cctr: sCtr.Ctr): Promise<void>;
 /**
- * --- 将 POST 数据的值执行 trim ---
- * @param post
+ * --- 获取 post 对象（通常已自动获取），如果是文件上传（formdata）的情况则不获取 ---
+ * @param req 请求对象
  */
-export declare function trimPost(post: Record<string, kebab.Json>): void;
+export declare function getPost(req: http2.Http2ServerRequest | http.IncomingMessage): Promise<{
+    'input': string;
+    'raw': Record<string, any>;
+    'post': Record<string, any>;
+}>;
 /**
  * --- 获取 formdata 的 post ---
  * @param req 请求头

package/sys/route.js

@@ -365,18 +365,18 @@ export async function run(data) {
     middle.setPrototype('_action', pathRight);
     middle.setPrototype('_headers', headers);
     middle.setPrototype('_get', get);
-    const rawPost = await getPost(data.req);
-    // --- 原始 POST ---
-    middle.setPrototype('_rawPost', rawPost[1]);
-    // --- 原始 input ---
-    middle.setPrototype('_input', rawPost[0]);
-    // --- 处理 POST 的值 JSON 上面就同时处理了 ---
-    // --- 格式化 post 数据 ---
-    // --- assign 是为了创建一份拷贝 ---
-    const post = Object.assign({}, rawPost[1]);
-    trimPost(post);
-    middle.setPrototype('_post', post);
-    // --- form data 格式交由用户自行获取，可以直接获取文件流，然后做他想做的事情 ---
+    /** --- 是否让框架自动获取 post，true 为自动（默认） --- */
+    const reqStartRtn = await middle.onReqStart();
+    if (reqStartRtn) {
+        const rawPost = await getPost(data.req);
+        // --- 原始 POST ---
+        middle.setPrototype('_rawPost', rawPost.raw);
+        // --- 原始 input ---
+        middle.setPrototype('_input', rawPost.input);
+        // --- 处理后的 post ---
+        middle.setPrototype('_post', rawPost.post);
+        // --- form data 格式交由用户自行获取，可以直接获取文件流，然后做他想做的事情 ---
+    }
     // --- 执行中间控制器的 onLoad ---
     try {
         rtn = await middle.onLoad();
@@ -717,7 +717,7 @@ function getPathLeftRight(path) {
     return [path.slice(0, pathLio), right === '' ? 'index' : right];
 }
 /**
- * --- 根据 path 获取 ws 的控制器类名, Mutton: false, Kebab: true ---
+ * --- 根据 path 获取 ws 的控制器类名 ---
  * @param path 路径
  */
 function getWsCtrName(path) {
@@ -728,7 +728,7 @@ function getWsCtrName(path) {
     return path.slice(pathLio + 1).toLowerCase();
 }
 /**
- * --- 删除本次请求所有已上传的临时文件, Mutton: false, Kebab: true ---
+ * --- 删除本次请求所有已上传的临时文件 ---
  * @param cctr Ctr 对象 或 files
  */
 export async function unlinkUploadFiles(cctr) {
@@ -765,29 +765,18 @@ export async function waitCtr(cctr) {
     await unlinkUploadFiles(cctr);
 }
 /**
- * --- 将 POST 数据的值执行 trim ---
- * @param post
- */
-export function trimPost(post) {
-    for (const key in post) {
-        const val = post[key];
-        if (typeof val === 'string') {
-            post[key] = post[key].trim();
-        }
-        else if (typeof val === 'object') {
-            trimPost(post[key]);
-        }
-    }
-}
-/**
- * --- 内部使用，获取 post 对象，如果是文件上传（formdata）的情况则不获取 ---
+ * --- 获取 post 对象（通常已自动获取），如果是文件上传（formdata）的情况则不获取 ---
  * @param req 请求对象
  */
-function getPost(req) {
+export function getPost(req) {
     return new Promise(function (resolve) {
         const ct = req.headers['content-type'] ?? '';
         if (ct.includes('form-data')) {
-            resolve(['', {}]);
+            resolve({
+                'input': '',
+                'raw': {},
+                'post': {},
+            });
             return;
         }
         // --- json 或普通 post ---
@@ -798,20 +787,38 @@ function getPost(req) {
         req.on('end', function () {
             const s = buffer.toString();
             if (!s) {
-                resolve(['', {}]);
+                resolve({
+                    'input': '',
+                    'raw': {},
+                    'post': {},
+                });
                 return;
             }
             // --- 判断 json 还是普通 ---
             if (ct.includes('json')) {
                 try {
-                    resolve([s, lText.parseJson(s)]);
+                    const raw = lText.parseJson(s);
+                    resolve({
+                        'input': s,
+                        'raw': raw,
+                        'post': lText.trimJson(raw),
+                    });
                 }
                 catch {
-                    resolve(['', {}]);
+                    resolve({
+                        'input': '',
+                        'raw': {},
+                        'post': {},
+                    });
                 }
                 return;
             }
-            resolve([s, lText.queryParse(s)]);
+            const raw = lText.queryParse(s);
+            resolve({
+                'input': s,
+                'raw': raw,
+                'post': lText.trimJson(raw),
+            });
         });
     });
 }

package/www/example/ctr/middle.d.ts

@@ -1,6 +1,7 @@
 import * as kebab from '#kebab/index.js';
 import * as sCtr from '#kebab/sys/ctr.js';
 export default class extends sCtr.Ctr {
+    onReqStart(): boolean;
     onLoad(): string | boolean;
     onUnload(rtn: string | boolean | kebab.DbValue[]): string | boolean | kebab.DbValue[];
 }

package/www/example/ctr/middle.js

@@ -1,5 +1,14 @@
 import * as sCtr from '#kebab/sys/ctr.js';
 export default class extends sCtr.Ctr {
+    onReqStart() {
+        if (this._config.const.path === 'test/net-mproxy1') {
+            return false;
+        }
+        if (this._config.const.path.startsWith('test/net-rproxy/')) {
+            return false;
+        }
+        return true;
+    }
     onLoad() {
         if (this._config.const.path !== 'test/middle') {
             return true;

package/www/example/ctr/test.js

@@ -1785,14 +1785,14 @@ error: <pre>${JSON.stringify(res.error, null, 4)}</pre>`);
             'mproxy': {
                 'url': this._internalUrl + 'test/net-mproxy1',
                 'auth': '123456',
-                'data': { 'test': '123' }
+                'data': { 'test': '123' },
             }
         });
         echo.push(`<pre>lNet.get('https://cdn.jsdelivr.net/npm/deskrt@2.0.10/package.json', {
     'mproxy': {
         'url': '${this._internalUrl}test/net-mproxy1',
         'auth': '123456',
-        'data': { 'test': '123' }
+        'data': { 'test': '123' },
     }
 });</pre>
         headers: <pre>${JSON.stringify(res.headers, null, 4)}</pre>

package/tsconfig.json

@@ -1,26 +0,0 @@
-{
-    "compilerOptions": {
-        "module": "esnext",
-        "removeComments": false,
-        "preserveConstEnums": true, // 保留 const 和 enum 声明
-        "outDir": "./",
-        "sourceMap": false,
-        "target": "ES2021",
-        "strict": true,             // 严格模式
-        "declaration": true,        // d.ts
-        "declarationMap": false,    // d.ts 的 map
-        "newLine": "LF",
-        "paths": {
-            "#kebab/*": ["./*"]
-        },
-        "moduleResolution": "node",
-        "resolveJsonModule": true,
-        "esModuleInterop": true
-    },
-    "include": [
-        "./**/*.ts"
-    ],
-    "exclude": [
-        "node_modules"
-    ]
-}