@maiyunnet/kebab 3.2.13 → 3.2.15

package/index.d.ts

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

package/index.js

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

package/lib/net.d.ts

@@ -34,11 +34,19 @@ export declare function get(u: string, opt?: IRequestOptions): Promise<lResponse
 export declare function post(u: string, data: Record<string, kebab.Json> | Buffer | string | stream.Readable, opt?: IRequestOptions): Promise<lResponse.Response>;
 /**
  * --- 发起 JSON 请求 ---
- * @param u
- * @param data
- * @param opt
+ * @param u 网址
+ * @param data 数据
+ * @param opt选项
  */
 export declare function postJson(u: string, data: kebab.Json[] | Record<string, kebab.Json>, opt?: IRequestOptions): Promise<lResponse.Response>;
+/**
+ * --- 发起 JSON 请求并解析 JSON 响应 ---
+ * @param url 网址
+ * @param data 数据
+ * @param init 选项
+ * @returns JSON 数据，失败时返回 null
+ */
+export declare function postJsonResponseJson(u: string, data: kebab.Json[] | Record<string, kebab.Json>, opt?: IRequestOptions): Promise<any | null>;
 /**
  * --- 发起一个请求 ---
  * @param opt 配置项

package/lib/net.js

@@ -57,15 +57,36 @@ export async function post(u, data, opt = {}) {
 }
 /**
  * --- 发起 JSON 请求 ---
- * @param u
- * @param data
- * @param opt
+ * @param u 网址
+ * @param data 数据
+ * @param opt选项
  */
 export async function postJson(u, data, opt = {}) {
     opt.method = 'POST';
     opt.type = 'json';
     return request(u, data, opt);
 }
+/**
+ * --- 发起 JSON 请求并解析 JSON 响应 ---
+ * @param url 网址
+ * @param data 数据
+ * @param init 选项
+ * @returns JSON 数据，失败时返回 null
+ */
+export async function postJsonResponseJson(u, data, opt = {}) {
+    opt.method = 'POST';
+    opt.type = 'json';
+    const res = await request(u, data, opt);
+    const rtn = await res.getContent();
+    if (!rtn) {
+        return null;
+    }
+    const json = lText.parseJson(rtn.toString());
+    if (!json) {
+        return null;
+    }
+    return json;
+}
 /**
  * --- 发起一个请求 ---
  * @param opt 配置项

package/lib/s3.d.ts

@@ -60,7 +60,7 @@ export declare class S3 {
      * @param key 对象路径
      * @param bucket bucket 名
      */
-    getObject(key: string, bucket?: string): Promise<false | (stream.Readable & import("@smithy/types").SdkStreamMixin) | (Blob & import("@smithy/types").SdkStreamMixin) | (ReadableStream<any> & import("@smithy/types").SdkStreamMixin) | undefined>;
+    getObject(key: string, bucket?: string): Promise<any>;
     /**
      * --- 删除对象 ---
      * @param key 对象路径

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.2.13",
+  "version": "3.2.15",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [
@@ -19,8 +19,8 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.908.0",
-    "@aws-sdk/lib-storage": "^3.908.0",
+    "@aws-sdk/client-s3": "^3.913.0",
+    "@aws-sdk/lib-storage": "^3.913.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
     "@litert/redis": "^3.0.5",
@@ -31,12 +31,12 @@
     "mysql2": "^3.15.2",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
-    "tencentcloud-sdk-nodejs": "^4.1.128"
+    "tencentcloud-sdk-nodejs": "^4.1.133"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^24.7.2",
+    "@types/node": "^24.9.1",
     "tsc-alias": "^1.8.16",
     "typescript": "^5.9.3"
   }

package/sys/child.js

@@ -294,7 +294,7 @@ async function requestHandler(req, res, https) {
                             'cookie': {},
                             'headers': {}
                         }, '[CHILD][requestHandler][E0]' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
-                        const content = '<h1>500 Server Error</h1><hr>Kebabb';
+                        const content = '<h1>500 Server Error</h1><hr>Kebab';
                         res.setHeader('content-type', 'text/html; charset=utf-8');
                         res.setHeader('content-length', Buffer.byteLength(content));
                         res.writeHead(500);
@@ -333,7 +333,7 @@ async function requestHandler(req, res, https) {
                 }
                 catch (e) {
                     lCore.log({}, '[CHILD][requestHandler][E1]' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
-                    const content = '<h1>500 Server Error</h1><hr>Kebabb';
+                    const content = '<h1>500 Server Error</h1><hr>Kebab';
                     res.setHeader('content-type', 'text/html; charset=utf-8');
                     res.setHeader('content-length', Buffer.byteLength(content));
                     res.writeHead(500);

package/sys/mod.d.ts

@@ -12,7 +12,7 @@ type TOnlyProperties<T> = {
     [K in keyof T as T[K] extends (...args: any[]) => any ? never : K]: T[K];
 };
 /** --- 条数列表 --- */
-declare class Rows<T extends Mod> implements CRows<T> {
+declare class Rows<T extends Mod> implements IRows<T> {
     private readonly _items;
     constructor(initialItems?: T[]);
     /** --- 总行数 --- */
@@ -24,8 +24,9 @@ declare class Rows<T extends Mod> implements CRows<T> {
     /** --- 根据规则筛掉项，predicate 返回 true 代表保留 --- */
     filter(predicate: (value: T, index: number) => boolean): Rows<T>;
     /** --- 重塑对象内容 --- */
-    map<TU>(allbackfn: (value: T, index: number) => TU): TU[];
-    [Symbol.iterator](): Iterator<T>;
+    map<TU extends Mod>(fn: (v: T, i: number) => TU): Rows<TU>;
+    /** --- for of --- */
+    [Symbol.iterator](): IterableIterator<T>;
 }
 /**
  * --- 开启软更需要在表添加字段：ALTER TABLE `table_name` ADD `time_remove` bigint NOT NULL DEFAULT '0' AFTER `xxx`; ---
@@ -127,7 +128,7 @@ export default class Mod {
     static removeByWhere(db: lDb.Pool | lDb.Transaction, where: string | kebab.Json, opt?: {
         'raw'?: boolean;
         'pre'?: sCtr.Ctr | string;
-        'index'?: string;
+        'index'?: string | string[];
         'by'?: [string | string[], 'DESC' | 'ASC'];
         'limit'?: [number, number?];
     }): Promise<number | false | null>;
@@ -226,7 +227,7 @@ export default class Mod {
         'lock'?: boolean;
         'raw'?: boolean;
         'pre'?: string;
-        'index'?: string;
+        'index'?: string | string[];
     }): Promise<false | null | (T & Record<string, any>)>;
     static one(db: lDb.Pool | lDb.Transaction, s: string | kebab.Json, opt: {
         'ctr'?: sCtr.Ctr;
@@ -475,15 +476,10 @@ export default class Mod {
      */
     protected _keyGenerator(): string;
 }
-/** --- mod ls 对象 --- */
-export declare class CRows<T> implements Iterable<T> {
-    /** --- 总行数 --- */
-    get length(): number;
-    /** --- 通过索引获取一个对象 --- */
+export interface IRows<T> extends Iterable<T> {
+    readonly length: number;
     item(index: number): T;
-    /** --- 转换为数组对象，获取的是新创建的数组 --- */
-    toArray(): Array<Record<string, kebab.DbValue>>;
-    [Symbol.iterator](): Iterator<T>;
+    toArray(): Array<Record<string, any>>;
 }
 export interface IModUnionItem {
     'field': string;

package/sys/mod.js

@@ -11,7 +11,6 @@ import * as sCtr from '#kebab/sys/ctr.js';
 /** --- 条数列表 --- */
 class Rows {
     constructor(initialItems = []) {
-        this._items = [];
         this._items = initialItems;
     }
     /** --- 总行数 --- */
@@ -24,49 +23,19 @@ class Rows {
     }
     /** --- 转换为数组对象，获取的是新创建的数组 --- */
     toArray() {
-        const arr = [];
-        for (const item of this._items) {
-            arr.push(item.toArray());
-        }
-        return arr;
+        return this._items.map(i => i.toArray());
     }
     /** --- 根据规则筛掉项，predicate 返回 true 代表保留 --- */
     filter(predicate) {
-        const items = [];
-        for (let i = 0; i < this._items.length; ++i) {
-            if (!predicate(this._items[i], i)) {
-                continue;
-            }
-            items.push(this._items[i]);
-        }
-        return new Rows(items);
+        return new Rows(this._items.filter(predicate));
     }
     /** --- 重塑对象内容 --- */
-    map(allbackfn) {
-        const items = [];
-        for (let i = 0; i < this._items.length; ++i) {
-            items.push(allbackfn(this._items[i], i));
-        }
-        return items;
+    map(fn) {
+        return new Rows(this._items.map(fn));
     }
+    /** --- for of --- */
     [Symbol.iterator]() {
-        let index = 0;
-        return {
-            next: () => {
-                if (index < this._items.length) {
-                    return {
-                        value: this._items[index++],
-                        done: false
-                    };
-                }
-                else {
-                    return {
-                        value: undefined,
-                        done: true
-                    };
-                }
-            }
-        };
+        return this._items[Symbol.iterator]();
     }
 }
 /**
@@ -226,12 +195,9 @@ class Mod {
      */
     static async removeByWhere(db, where, opt = {}) {
         const tim = lTime.stamp();
-        const sq = lSql.get(opt.pre);
+        const indexs = opt.index ? (typeof opt.index === 'string' ? [opt.index] : [...new Set(opt.index)]) : [''];
         if (this._$soft && !opt.raw) {
             // --- 软删除 ---
-            sq.update(this._$table + (opt.index ? ('_' + opt.index) : ''), [{
-                    'time_remove': tim
-                }]);
             if (typeof where === 'string') {
                 where = '(' + where + ') AND `time_remove` = 0';
             }
@@ -244,26 +210,36 @@ class Mod {
                 where['time_remove'] = 0;
             }
         }
-        else {
-            // --- 真删除 ---
-            sq.delete(this._$table + (opt.index ? ('_' + opt.index) : ''));
-        }
-        sq.where(where);
-        if (opt.by) {
-            sq.by(opt.by[0], opt.by[1]);
-        }
-        if (opt.limit) {
-            sq.limit(opt.limit[0], opt.limit[1]);
-        }
-        const r = await db.execute(sq.getSql(), sq.getData());
-        if (r.packet === null) {
-            lCore.log(opt.pre instanceof sCtr.Ctr ? opt.pre : {}, '[removeByWhere, mod] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
-            return false;
-        }
-        if (r.packet.affectedRows > 0) {
-            return r.packet.affectedRows;
+        let ar = 0;
+        for (const index of indexs) {
+            const sq = lSql.get(opt.pre);
+            if (this._$soft && !opt.raw) {
+                // --- 软删除 ---
+                sq.update(this._$table + (index ? ('_' + index) : ''), [{
+                        'time_remove': tim,
+                    }]);
+            }
+            else {
+                // --- 真删除 ---
+                sq.delete(this._$table + (index ? ('_' + index) : ''));
+            }
+            sq.where(where);
+            if (opt.by) {
+                sq.by(opt.by[0], opt.by[1]);
+            }
+            if (opt.limit) {
+                sq.limit(opt.limit[0], opt.limit[1]);
+            }
+            const r = await db.execute(sq.getSql(), sq.getData());
+            if (r.packet === null) {
+                lCore.log(opt.pre instanceof sCtr.Ctr ? opt.pre : {}, '[removeByWhere, mod] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');
+                return false;
+            }
+            if (r.packet.affectedRows > 0) {
+                ar += r.packet.affectedRows;
+            }
         }
-        return null;
+        return ar ? ar : null;
     }
     /**
      * --- 根据条件移除条目（仅获取 SQL 对象） ---
@@ -312,12 +288,7 @@ class Mod {
      * @param opt 选项
      */
     static async updateByWhere(db, data, where, opt = {}) {
-        if (typeof opt.index === 'string') {
-            opt.index = [opt.index];
-        }
-        else {
-            opt.index ??= [''];
-        }
+        const indexs = opt.index ? (typeof opt.index === 'string' ? [opt.index] : [...new Set(opt.index)]) : [''];
         if (this._$soft && !opt.raw) {
             if (typeof where === 'string') {
                 where = '(' + where + ') AND `time_remove` = 0';
@@ -332,7 +303,7 @@ class Mod {
             }
         }
         let ar = 0;
-        for (const index of opt.index) {
+        for (const index of indexs) {
             const sq = lSql.get(opt.pre);
             sq.update(this._$table + (index ? ('_' + index) : ''), data);
             sq.where(where);
@@ -448,7 +419,7 @@ class Mod {
                     [this._$primary]: val
                 }],
             'raw': opt.raw,
-            'index': opt.index
+            'index': opt.index,
         }).first(opt.lock);
     }
     /**
@@ -459,6 +430,7 @@ class Mod {
      */
     static async one(db, s, opt = {}) {
         if (!opt.index) {
+            // --- 无 index ---
             const o = new this({
                 'select': opt.select,
                 'db': db,
@@ -472,8 +444,8 @@ class Mod {
             }
             return opt.array ? o.firstArray() : o.first();
         }
-        opt.index = typeof opt.index === 'string' ? [opt.index] : [...new Set(opt.index)];
-        for (const item of opt.index) {
+        const indexs = (typeof opt.index === 'string') ? [opt.index] : [...new Set(opt.index)];
+        for (const item of indexs) {
             const row = new this({
                 'select': opt.select,
                 'db': db,
@@ -481,7 +453,7 @@ class Mod {
                 'pre': opt.pre,
                 'where': s,
                 'raw': opt.raw,
-                'index': item
+                'index': item,
             });
             if (opt.by) {
                 row.by(opt.by[0], opt.by[1]);
@@ -638,6 +610,8 @@ class Mod {
                         // --- 确实重复了 ---
                         continue;
                     }
+                    // --- 1062 非 index 冲突，那需要用户自行处理（可能不允许重复的邮箱） ---
+                    return false;
                 }
                 // --- 未处理的错误 ---
                 lCore.log(this._ctr ?? {}, '[create0, mod] [' + table + '] ' + lText.stringifyJson(r.error?.message ?? '').slice(1, -1).replace(/"/g, '""'), '-error');