@maiyunnet/kebab 3.2.33 → 3.2.35

package/index.d.ts

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

package/index.js

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

package/lib/ai.d.ts

@@ -40,9 +40,9 @@ export declare class Ai {
     private readonly _ctr;
     constructor(ctr: sCtr.Ctr, opt: IOptions);
     /** --- 创建非流式对话 --- */
-    chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsNonStreaming): openai.APIPromise<openai.default.Chat.ChatCompletion> | false;
+    chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsNonStreaming): Promise<openai.APIPromise<openai.default.Chat.ChatCompletion> | false>;
     /** --- 创建流式对话 --- */
-    chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsStreaming): openai.APIPromise<streaming.Stream<openai.default.Chat.ChatCompletionChunk>> | false;
+    chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsStreaming): Promise<openai.APIPromise<streaming.Stream<openai.default.Chat.ChatCompletionChunk>> | false>;
 }
 /**
  * --- 创建一个 AI 对象 ---

package/lib/ai.js

@@ -73,9 +73,9 @@ export class Ai {
         });
     }
     /** --- 创建对话 --- */
-    chat(body) {
+    async chat(body) {
         try {
-            return this.link.chat.completions.create(body);
+            return await this.link.chat.completions.create(body);
         }
         catch (e) {
             lCore.debug('[AI][CHAT]', e);

package/lib/cron.d.ts

@@ -12,7 +12,7 @@ export declare function regular(task: IRegular, immediate?: string): Promise<boo
 export declare function run(): void;
 /** --- 定时任务 --- */
 export interface IRegular {
-    /** --- 任务名称 --- */
+    /** --- 任务名称，只能小写字母、数字、短横线、下划线，长度 1-32 --- */
     'name': string;
     /** --- 任务日期对象（系统时区） --- */
     'date': {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.2.33",
+  "version": "3.2.35",
   "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/mod.d.ts

@@ -1,7 +1,7 @@
 /**
  * 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
+ * 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, 2025-11-5 16:34:31
  */
 import * as lSql from '#kebab/lib/sql.js';
 import * as lDb from '#kebab/lib/db.js';
@@ -217,7 +217,7 @@ export default class Mod {
         'index'?: string;
     }): T;
     /**
-     * --- 根据主键获取对象 ---
+     * --- 根据主键（或 key 字段）获取对象 ---
      * @param db 数据库对象
      * @param val 主键值
      * @param lock 是否加锁
@@ -229,6 +229,8 @@ export default class Mod {
         'raw'?: boolean;
         'pre'?: string;
         'index'?: string | string[];
+        /** --- 通过 key 字段获取，默认为 false，即从主键获取 --- */
+        'key'?: boolean;
     }): Promise<false | null | (T & Record<string, any>)>;
     static one(db: lDb.Pool | lDb.Transaction, s: string | kebab.Json, opt: {
         'ctr'?: sCtr.Ctr;

package/sys/mod.js

@@ -1,7 +1,7 @@
 /**
  * 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
+ * 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, 2025-11-5 16:34:31
  */
 import * as lSql from '#kebab/lib/sql.js';
 import * as lTime from '#kebab/lib/time.js';
@@ -418,19 +418,23 @@ export default class Mod {
         });
     }
     /**
-     * --- 根据主键获取对象 ---
+     * --- 根据主键（或 key 字段）获取对象 ---
      * @param db 数据库对象
      * @param val 主键值
      * @param lock 是否加锁
      * @param opt 选项
      */
-    static find(db, val, opt = {}) {
+    static async find(db, val, opt = {}) {
+        if (opt.key && !this._$key) {
+            lCore.debug('[MOD][find] key not found');
+            return false;
+        }
         return new this({
             'db': db,
             'ctr': opt.ctr,
             'pre': opt.pre,
             'where': [{
-                    [this._$primary]: val
+                    [opt.key ? this._$key : this._$primary]: val,
                 }],
             'raw': opt.raw,
             'index': opt.index,