@maiyunnet/kebab 5.0.4 → 5.1.0

package/index.d.ts

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

package/index.js

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

package/lib/ai.d.ts

@@ -43,6 +43,8 @@ export declare class Ai {
     chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsNonStreaming): Promise<openai.APIPromise<openai.default.Chat.ChatCompletion> | false>;
     /** --- 创建流式对话 --- */
     chat(body: openai.default.Chat.Completions.ChatCompletionCreateParamsStreaming): Promise<openai.APIPromise<streaming.Stream<openai.default.Chat.ChatCompletionChunk>> | false>;
+    /** --- 创建向量 --- */
+    embedding(body: openai.default.EmbeddingCreateParams): Promise<openai.APIPromise<openai.default.CreateEmbeddingResponse> | false>;
 }
 /**
  * --- 创建一个 AI 对象 ---

package/lib/ai.js

@@ -83,6 +83,17 @@ export class Ai {
             return false;
         }
     }
+    /** --- 创建向量 --- */
+    async embedding(body) {
+        try {
+            return await this.link.embeddings.create(body);
+        }
+        catch (e) {
+            lCore.debug('[AI][EMBEDDING]', e);
+            lCore.log(this._ctr, `[AI][EMBEDDING] ${e.message}`, '-error');
+            return false;
+        }
+    }
 }
 /**
  * --- 创建一个 AI 对象 ---

package/lib/crypto.d.ts

@@ -24,6 +24,13 @@ export declare function generateKeyPair(type: string, options?: {
     'public': string | Buffer;
     'private': string | Buffer;
 }>;
+/**
+ * --- 非对称加签 ---
+ * @param data 数据
+ * @param privateKey 私钥
+ * @param format 输出格式
+ * @param algorithm 哈希方式
+ */
 export declare function sign(data: crypto.BinaryLike, privateKey: crypto.KeyLike | crypto.SignKeyObjectInput | crypto.SignPrivateKeyInput | crypto.SignJsonWebKeyInput, format: 'hex' | 'base64' | 'binary', algorithm?: string): string;
 export declare function sign(data: crypto.BinaryLike, privateKey: crypto.KeyLike | crypto.SignKeyObjectInput | crypto.SignPrivateKeyInput | crypto.SignJsonWebKeyInput, format?: 'buffer', algorithm?: string): Buffer;
 /**
@@ -77,10 +84,31 @@ export declare const SM4_CFB = "sm4-cfb";
  * @param method 加密方法
  */
 export declare function cipherEncrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64' | 'buffer'): string | Buffer | false;
+/**
+ * --- AES 加密 ---
+ * @param original 原始字符串
+ * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
+ * @param method 加密方法
+ * @param output 输出类型
+ */
 export declare function aesEncrypt(original: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function aesEncrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64'): string | false;
+/**
+ * --- AES GCM 托管加密 ---
+ * @param original 原始字符串
+ * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
+ * @param output 输出类型
+ */
 export declare function gcmEncrypt(original: string | Buffer, key: crypto.CipherKey, output: 'buffer'): Buffer | false;
 export declare function gcmEncrypt(original: string | Buffer, key: crypto.CipherKey, output?: 'base64'): string | false;
+/**
+ * --- SM4 加密 ---
+ * @param original 原始字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16 个英文字母和数字
+ * @param method 加密方法
+ */
 export declare function sm4Encrypt(original: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function sm4Encrypt(original: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'base64'): string | false;
 /**
@@ -91,12 +119,39 @@ export declare function sm4Encrypt(original: string | Buffer, key: crypto.Cipher
  * @param method 加密方法
  */
 export declare function cipherDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary' | 'buffer'): string | Buffer | false;
+/**
+ * --- AES 解密 ---
+ * @param encrypt 需解密的字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
+ * @param method 加密方法
+ */
 export declare function aesDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function aesDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary'): string | false;
+/**
+ * --- AES 解密 ---
+ * @param encrypt 需解密的字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16 个英文字母和数字
+ * @param method 加密方法
+ */
 export declare function gcmDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, output: 'buffer'): Buffer | false;
 export declare function gcmDecrypt(encrypt: string | Buffer, key: crypto.CipherKey, output?: 'binary'): string | false;
+/**
+ * --- SM4 解密 ---
+ * @param encrypt 需解密的字符串
+ * @param key 密钥 32 个英文字母和数字
+ * @param iv 向量 16 个英文字母和数字
+ * @param method 加密方法
+ */
 export declare function sm4Decrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv: string, method: string, output: 'buffer'): Buffer | false;
 export declare function sm4Decrypt(encrypt: string | Buffer, key: crypto.CipherKey, iv?: string, method?: string, output?: 'binary'): string | false;
+/**
+ * --- hash 或 hmac 加密 ---
+ * @param algorithm 哈希方式
+ * @param data 源数据
+ * @param key 设置则采用 hmac 加密
+ */
 export declare function hashHmac(algorithm: string, data: Buffer | string, key?: crypto.CipherKey, format?: 'hex' | 'base64'): string;
 export declare function hashHmac(algorithm: string, data: Buffer | string, key: crypto.CipherKey | undefined, format: 'buffer'): Buffer;
 export declare function hashHmacFile(algorithm: string, path: string, key?: crypto.CipherKey, encoding?: 'hex' | 'base64' | 'base64url'): Promise<string | false>;

package/lib/crypto.js

@@ -39,13 +39,6 @@ export function generateKeyPair(type, options = {}) {
         });
     });
 }
-/**
- * --- 非对称加签 ---
- * @param data 数据
- * @param privateKey 私钥
- * @param format 输出格式
- * @param algorithm 哈希方式
- */
 export function sign(data, privateKey, format = 'buffer', algorithm = 'sha256') {
     const sign = crypto.createSign(algorithm);
     sign.update(data);
@@ -165,26 +158,12 @@ export function cipherEncrypt(original, key, iv = '', method = AES_256_ECB, outp
         return false;
     }
 }
-/**
- * --- AES 加密 ---
- * @param original 原始字符串
- * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
- * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
- * @param method 加密方法
- * @param output 输出类型
- */
 export function aesEncrypt(original, key, iv = '', method = AES_256_ECB, output = 'base64') {
     if (iv !== '') {
         method = method === AES_256_ECB ? AES_256_CTR : method;
     }
     return cipherEncrypt(original, key, iv, method, output);
 }
-/**
- * --- AES GCM 托管加密 ---
- * @param original 原始字符串
- * @param key 密钥尽量 32 个英文字母和数字，不是 32 个系统会自动处理
- * @param output 输出类型
- */
 export function gcmEncrypt(original, key, output = 'base64') {
     const iv = lCore.random(12, lCore.RANDOM_LUNS);
     const rtn = cipherEncrypt(original, key, iv, AES_256_GCM, output);
@@ -193,13 +172,6 @@ export function gcmEncrypt(original, key, output = 'base64') {
     }
     return typeof rtn === 'string' ? iv + rtn : Buffer.concat([Buffer.from(iv), rtn]);
 }
-/**
- * --- SM4 加密 ---
- * @param original 原始字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
- * @param method 加密方法
- */
 export function sm4Encrypt(original, key, iv = '', method = SM4_ECB, output = 'base64') {
     if (iv !== '') {
         method = method === SM4_ECB ? SM4_CFB : method;
@@ -268,48 +240,21 @@ export function cipherDecrypt(encrypt, key, iv = '', method = AES_256_ECB, outpu
         return false;
     }
 }
-/**
- * --- AES 解密 ---
- * @param encrypt 需解密的字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16(CTR) 或 12(GCM) 个英文字母和数字
- * @param method 加密方法
- */
 export function aesDecrypt(encrypt, key, iv = '', method = AES_256_ECB, output = 'binary') {
     if (iv !== '') {
         method = method === AES_256_ECB ? AES_256_CTR : method;
     }
     return cipherDecrypt(encrypt, key, iv, method, output);
 }
-/**
- * --- AES 解密 ---
- * @param encrypt 需解密的字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
- * @param method 加密方法
- */
 export function gcmDecrypt(encrypt, key, output = 'binary') {
     return cipherDecrypt(typeof encrypt === 'string' ? encrypt.slice(12) : encrypt.subarray(12), key, typeof encrypt === 'string' ? encrypt.slice(0, 12) : encrypt.subarray(0, 12).toString(), AES_256_GCM, output);
 }
-/**
- * --- SM4 解密 ---
- * @param encrypt 需解密的字符串
- * @param key 密钥 32 个英文字母和数字
- * @param iv 向量 16 个英文字母和数字
- * @param method 加密方法
- */
 export function sm4Decrypt(encrypt, key, iv = '', method = SM4_ECB, output = 'binary') {
     if (iv !== '') {
         method = method === SM4_ECB ? SM4_CFB : method;
     }
     return cipherDecrypt(encrypt, key, iv, method, output);
 }
-/**
- * --- hash 或 hmac 加密 ---
- * @param algorithm 哈希方式
- * @param data 源数据
- * @param key 设置则采用 hmac 加密
- */
 export function hashHmac(algorithm, data, key, format = 'hex') {
     const cry = key ? crypto.createHmac(algorithm, key) : crypto.createHash(algorithm);
     cry.update(data);

package/lib/sql.js

@@ -474,7 +474,12 @@ export class Sql {
         let field = this.field(f, pre || this._pre, suf ? ('#' + suf) : '');
         if (pre) {
             // --- 处理不同 pre 的 as 前缀问题 ---
-            field = field.replace(new RegExp(`AS \`${pre}(.+?)\``), `AS \`${this._pre}$1\``);
+            if (this._service === ESERVICE.MYSQL) {
+                field = field.replace(new RegExp(`AS \`${pre}(.+?)\``), `AS \`${this._pre}$1\``);
+            }
+            else {
+                field = field.replace(new RegExp(`AS "${pre}"."(.+?)"`), `AS "${this._pre}"."$1"`);
+            }
         }
         let sql = ' ' + type + ' JOIN ' + field;
         if (Array.isArray(s) ? s.length : Object.keys(s).length) {

package/package.json

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

@@ -335,7 +335,7 @@ export default class Mod {
      * @param s ON 信息
      * @param type 类型
      * @param index 给本表增加 index 分表项
-     * @param pre 前缀
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     join(f: string, s?: kebab.Json, type?: string, index?: string, pre?: string): this;
     /**
@@ -343,6 +343,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     leftJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -350,6 +351,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     rightJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -357,6 +359,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     innerJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -364,6 +367,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     fullJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**
@@ -371,6 +375,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     crossJoin(f: string, s: kebab.Json, index?: string, pre?: string): this;
     /**

package/sys/mod.js

@@ -435,7 +435,7 @@ export default class Mod {
         return rtn;
     }
     /**
-     * --- 设置一个/多个属性 ---
+     * --- 设置一个/多个属性，值为 underfind 则不会被更新 ---
      * @param n 字符串或键/值
      * @param v 可能是数字
      */
@@ -1085,7 +1085,7 @@ export default class Mod {
      * @param s ON 信息
      * @param type 类型
      * @param index 给本表增加 index 分表项
-     * @param pre 前缀
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     join(f, s = [], type = 'INNER', index = '', pre = '') {
         this._sql.join(f, s, type, index ? '_' + index : '', pre);
@@ -1096,6 +1096,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     leftJoin(f, s, index = '', pre = '') {
         this._sql.leftJoin(f, s, index ? '_' + index : '', pre);
@@ -1106,6 +1107,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     rightJoin(f, s, index = '', pre = '') {
         this._sql.rightJoin(f, s, index ? '_' + index : '', pre);
@@ -1116,6 +1118,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     innerJoin(f, s, index = '', pre = '') {
         this._sql.innerJoin(f, s, index ? '_' + index : '', pre);
@@ -1126,6 +1129,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     fullJoin(f, s, index = '', pre = '') {
         this._sql.fullJoin(f, s, index ? '_' + index : '', pre);
@@ -1136,6 +1140,7 @@ export default class Mod {
      * @param f 表名
      * @param s ON 信息
      * @param index 给本表增加 index 分表项
+     * @param pre 前缀，仅与主表的 pre 不同时传入
      */
     crossJoin(f, s, index = '', pre = '') {
         this._sql.crossJoin(f, s, index ? '_' + index : '', pre);