@maiyunnet/kebab 9.13.3 → 9.13.5

package/doc/kebab-rag.md

@@ -1360,7 +1360,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.13.3"` = `'9.13.3'`
+> `const` **VER**: `"9.13.5"` = `'9.13.5'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -22762,9 +22762,9 @@ Defined in: [sys/ctr.ts:571](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 ### \_checkXInput()
 
-> `protected` **\_checkXInput**(`input`, `rule`, `rtn`): `boolean`
+> `protected` **\_checkXInput**(`input`, `rule`, `rtn`, `ignore?`): `boolean`
 
-Defined in: [sys/ctr.ts:749](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L749)
+Defined in: [sys/ctr.ts:750](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L750)
 
 检测提交的数据类型（会检测 XSRF）
 
@@ -22788,6 +22788,12 @@ Defined in: [sys/ctr.ts:749](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 返回值
 
+##### ignore?
+
+`boolean` = `false`
+
+忽略 xsrf 判断
+
 #### Returns
 
 `boolean`
@@ -22798,7 +22804,7 @@ Defined in: [sys/ctr.ts:749](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_cross**(`opt?`): `boolean`
 
-Defined in: [sys/ctr.ts:978](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L978)
+Defined in: [sys/ctr.ts:985](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L985)
 
 开启跨域请求
 
@@ -22843,7 +22849,7 @@ Defined in: [sys/ctr.ts:978](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_device**(): `"unknown"` \| `"android"` \| `"linux"` \| `"windows"` \| `"macintosh"` \| `"ipad"`
 
-Defined in: [sys/ctr.ts:791](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L791)
+Defined in: [sys/ctr.ts:795](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L795)
 
 根据用户 ua 获取当前用户的设备类型
 
@@ -22857,7 +22863,7 @@ Defined in: [sys/ctr.ts:791](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_enabledXsrf**(`opt?`): `void`
 
-Defined in: [sys/ctr.ts:760](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L760)
+Defined in: [sys/ctr.ts:764](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L764)
 
 当前页面开启 XSRF 支持（主要检测 cookie 是否存在）
 如果当前页面有 CDN，请不要使用
@@ -22880,7 +22886,7 @@ Defined in: [sys/ctr.ts:760](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_end**(): `void`
 
-Defined in: [sys/ctr.ts:1086](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1086)
+Defined in: [sys/ctr.ts:1093](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1093)
 
 主动关闭当前 socket 连接
 
@@ -22894,7 +22900,7 @@ Defined in: [sys/ctr.ts:1086](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_getBasicAuth**(`user`, `pwd`): `string`
 
-Defined in: [sys/ctr.ts:784](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L784)
+Defined in: [sys/ctr.ts:788](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L788)
 
 获取 Auth 字符串，用于客户端提交
 
@@ -22922,7 +22928,7 @@ Defined in: [sys/ctr.ts:784](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_getLocale**(): `string`
 
-Defined in: [sys/ctr.ts:969](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L969)
+Defined in: [sys/ctr.ts:976](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L976)
 
 获取当前语言名
 
@@ -22936,7 +22942,7 @@ Defined in: [sys/ctr.ts:969](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_getLocaleJsonString**(): `string`
 
-Defined in: [sys/ctr.ts:957](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L957)
+Defined in: [sys/ctr.ts:964](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L964)
 
 根据当前后台语言包设置情况获取 JSON 字符串传输到前台
 
@@ -22988,7 +22994,7 @@ Defined in: [sys/ctr.ts:315](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_handleFormData**(`events?`, `limits?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:1095](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1095)
+Defined in: [sys/ctr.ts:1102](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1102)
 
 获取 formdata 的信息
 
@@ -23036,7 +23042,7 @@ Defined in: [sys/ctr.ts:1095](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **\_l**(`key`, `data?`): `string`
 
-Defined in: [sys/ctr.ts:1021](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1021)
+Defined in: [sys/ctr.ts:1028](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1028)
 
 获取语言包值
 
@@ -23060,11 +23066,17 @@ Defined in: [sys/ctr.ts:1021](https://github.com/maiyunnet/kebab/blob/master/sys
 
 ### \_loadData()
 
-> `protected` **\_loadData**(`path`): `Promise`\<`Record`\<`string`, `string`\> \| `null`\>
+> `protected` **\_loadData**\<`T`\>(`path`): `Promise`\<`false` \| `T` \| `null`\>
 
-Defined in: [sys/ctr.ts:860](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L860)
+Defined in: [sys/ctr.ts:864](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L864)
 
-获取 data 数据
+获取 data JSON 数据
+
+#### Type Parameters
+
+##### T
+
+`T`
 
 #### Parameters
 
@@ -23076,7 +23088,7 @@ Defined in: [sys/ctr.ts:860](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 #### Returns
 
-`Promise`\<`Record`\<`string`, `string`\> \| `null`\>
+`Promise`\<`false` \| `T` \| `null`\>
 
 ***
 
@@ -23084,7 +23096,7 @@ Defined in: [sys/ctr.ts:860](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_loadLocale**(`loc`, `pkg?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:908](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L908)
+Defined in: [sys/ctr.ts:915](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L915)
 
 设定语言并加载语言包
 
@@ -23205,7 +23217,7 @@ Defined in: [sys/ctr.ts:332](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_location**(`location`): `false`
 
-Defined in: [sys/ctr.ts:878](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L878)
+Defined in: [sys/ctr.ts:885](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L885)
 
 跳转（302临时跳转），支持相对本项目根路径的路径或绝对路径
 
@@ -23227,7 +23239,7 @@ Defined in: [sys/ctr.ts:878](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_ping**(`data?`): `boolean`
 
-Defined in: [sys/ctr.ts:1071](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1071)
+Defined in: [sys/ctr.ts:1078](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1078)
 
 发送 socket ping
 
@@ -23249,7 +23261,7 @@ Defined in: [sys/ctr.ts:1071](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_pong**(`data?`): `boolean`
 
-Defined in: [sys/ctr.ts:1079](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1079)
+Defined in: [sys/ctr.ts:1086](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1086)
 
 发送 socket pong
 
@@ -23271,7 +23283,7 @@ Defined in: [sys/ctr.ts:1079](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_startSession**(`link`, `auth?`, `opt?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:892](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L892)
+Defined in: [sys/ctr.ts:899](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L899)
 
 开启 Session
 
@@ -23305,7 +23317,7 @@ Kv 或 Db 实例
 
 > `protected` **\_writeBinary**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:1063](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1063)
+Defined in: [sys/ctr.ts:1070](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1070)
 
 发送 socket 二进制
 
@@ -23327,7 +23339,7 @@ Defined in: [sys/ctr.ts:1063](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_writeResult**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:1055](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1055)
+Defined in: [sys/ctr.ts:1062](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1062)
 
 发送结果对象文本
 
@@ -23349,7 +23361,7 @@ Defined in: [sys/ctr.ts:1055](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_writeText**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:1047](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1047)
+Defined in: [sys/ctr.ts:1054](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1054)
 
 发送 socket 文本
 
@@ -23371,7 +23383,7 @@ Defined in: [sys/ctr.ts:1047](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **getAuthorization**(): `false` \| \{ `pwd`: `string`; `type`: `"basic"`; `user`: `string`; \} \| \{ `token`: `string`; `type`: `"bearer"`; \}
 
-Defined in: [sys/ctr.ts:812](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L812)
+Defined in: [sys/ctr.ts:816](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L816)
 
 通过 header 或 _auth 获取鉴权信息，支持 Basic Auth 和 Bearer Token
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "9.13.3";
+export declare const VER = "9.13.5";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '9.13.3';
+export const VER = '9.13.5';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.13.3",
+  "version": "9.13.5",
   "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

@@ -212,8 +212,9 @@ export declare class Ctr {
      * @param input 要校验的输入项
      * @param rule 规则, int, double, num(可字符串), array, bool, string, ascii
      * @param rtn 返回值
+     * @param ignore 忽略 xsrf 判断
      */
-    protected _checkXInput(input: Record<string, kebab.Json>, rule: Record<string, kebab.Json[]>, rtn: kebab.Json[]): boolean;
+    protected _checkXInput(input: Record<string, kebab.Json>, rule: Record<string, kebab.Json[]>, rtn: kebab.Json[], ignore?: boolean): boolean;
     /**
      * --- 当前页面开启 XSRF 支持（主要检测 cookie 是否存在） ---
      * --- 如果当前页面有 CDN，请不要使用 ---
@@ -245,10 +246,10 @@ export declare class Ctr {
         'token': string;
     } | false;
     /**
-     * --- 获取 data 数据 ---
+     * --- 获取 data JSON 数据 ---
      * @param path 文件路径（不含扩展名）
      */
-    protected _loadData(path: string): Promise<Record<string, string> | null>;
+    protected _loadData<T>(path: string): Promise<T | false | null>;
     /**
      * --- 跳转（302临时跳转），支持相对本项目根路径的路径或绝对路径 ---
      * @param location 相对或绝对网址

package/sys/ctr.js

@@ -595,9 +595,12 @@ export class Ctr {
      * @param input 要校验的输入项
      * @param rule 规则, int, double, num(可字符串), array, bool, string, ascii
      * @param rtn 返回值
+     * @param ignore 忽略 xsrf 判断
      */
-    _checkXInput(input, rule, rtn) {
-        rule['_xsrf'] ??= ['require', this._cookie['XSRF-TOKEN'], [0, 'Bad request, no permission.']];
+    _checkXInput(input, rule, rtn, ignore = false) {
+        if (!ignore) {
+            rule['_xsrf'] ??= ['require', this._cookie['XSRF-TOKEN'], [0, 'Bad request, no permission.']];
+        }
         return this._checkInput(input, rule, rtn);
     }
     /**
@@ -692,7 +695,7 @@ export class Ctr {
         return this._authorization;
     }
     /**
-     * --- 获取 data 数据 ---
+     * --- 获取 data JSON 数据 ---
      * @param path 文件路径（不含扩展名）
      */
     async _loadData(path) {
@@ -705,6 +708,9 @@ export class Ctr {
             return null;
         }
         const json = lText.parseJson(content);
+        if (!json) {
+            return false;
+        }
         loadedData[realPath] = json;
         return json;
     }
@@ -744,7 +750,7 @@ export class Ctr {
             if (!localeFiles.includes(lPath)) {
                 // --- 全局缓存没有，先加载全局缓存 ---
                 const locData = await this._loadData('locale/' + lName);
-                if (locData === null) {
+                if (!locData) {
                     return false;
                 }
                 this._locale = loc;