@maiyunnet/kebab 6.0.0 → 6.2.0

package/index.d.ts

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

package/index.js

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

package/lib/kv.d.ts

@@ -6,6 +6,27 @@
 import * as redis from '@litert/redis';
 import * as kebab from '#kebab/index.js';
 import * as sCtr from '#kebab/sys/ctr.js';
+export interface IZRangeOptions {
+    /**
+     * Range query type.
+     *
+     * - SCORE: Query by score range
+     * - LEX: Query by lexicographical range
+     */
+    'by'?: 'SCORE' | 'LEX';
+    /**
+     * Whether to return results in reverse order.
+     */
+    'rev'?: boolean;
+    /**
+     * Pagination offset. Must be used together with count.
+     */
+    'offset'?: number;
+    /**
+     * Pagination count. Must be used together with offset.
+     */
+    'count'?: number;
+}
 /**
  * --- 键值存储操作类 ---
  *
@@ -209,6 +230,48 @@ export declare class Kv {
     bRPop(key: string | string[], timeout: number): Promise<Record<string, string> | false>;
     lRange(key: string, start: number, stop: number): Promise<string[] | false>;
     lLen(key: string): Promise<number | false>;
+    /**
+     * --- 添加有序集合元素（单个元素） ---
+     * @param key key 名
+     * @param score 分数
+     * @param member 成员
+     */
+    zAdd(key: string, score: number, member: string | Buffer): Promise<boolean>;
+    /**
+     * --- 添加有序集合元素（多个元素，含 INCR 选项） ---
+     * @param key key 名
+     * @param elements 元素数组
+     * @param options 选项，需要 INCR
+     */
+    zAdd(key: string, elements: Array<{
+        'score': number;
+        'member': string | Buffer;
+    }>, options: redis.IZAddOptionsIncr): Promise<number | false>;
+    /**
+     * --- 添加有序集合元素（多个元素，含 INCR 选项，可空） ---
+     * @param key key 名
+     * @param elements 元素数组
+     * @param options 选项，需要 INCR Nullable
+     */
+    zAdd(key: string, elements: Array<{
+        'score': number;
+        'member': string | Buffer;
+    }>, options: redis.IZAddOptionsIncrNullable): Promise<number | null | false>;
+    /**
+     * --- 添加有序集合元素（多个元素） ---
+     * @param key key 名
+     * @param elements 元素数组
+     * @param options 选项
+     */
+    zAdd(key: string, elements: Array<{
+        'score': number;
+        'member': string | Buffer;
+    }>, options?: redis.IZAddOptions): Promise<number | false>;
+    zRangeWithScores(key: string, start: number, stop: number, options?: IZRangeOptions): Promise<Array<{
+        member: string;
+        score: number;
+    }> | false>;
+    zRem(key: string, members: Array<string | Buffer>): Promise<number | false>;
     /**
      * --- 从连接池中获取一个符合要求的连接 ---
      */

package/lib/kv.js

@@ -728,6 +728,50 @@ end`;
             return false;
         }
     }
+    /**
+     * --- 添加有序集合元素 ---
+     */
+    async zAdd(key, scoreOrItems, memberOrOptions) {
+        const conn = await this._getConnection();
+        if (!conn) {
+            return false;
+        }
+        try {
+            return await conn.zAdd(this._etc.pre + key, scoreOrItems, memberOrOptions);
+        }
+        catch {
+            return false;
+        }
+    }
+    async zRangeWithScores(key, start, stop, options) {
+        const conn = await this._getConnection();
+        if (!conn) {
+            return false;
+        }
+        try {
+            return await conn.zRangeWithScores(this._etc.pre + key, start, stop, {
+                'by': options?.by,
+                'reverse': options?.rev,
+                'offset': options?.offset,
+                'count': options?.count,
+            });
+        }
+        catch {
+            return false;
+        }
+    }
+    async zRem(key, members) {
+        const conn = await this._getConnection();
+        if (!conn) {
+            return false;
+        }
+        try {
+            return await conn.zRem(this._etc.pre + key, members);
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * --- 从连接池中获取一个符合要求的连接 ---
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "6.0.0",
+  "version": "6.2.0",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [
@@ -22,28 +22,28 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.927.0",
-    "@aws-sdk/lib-storage": "^3.927.0",
+    "@aws-sdk/client-s3": "^3.940.0",
+    "@aws-sdk/lib-storage": "^3.940.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
-    "@litert/redis": "^3.0.5",
+    "@litert/redis": "^3.1.0",
     "@litert/websocket": "^0.2.8",
     "@types/ssh2": "^1.15.5",
-    "@zilliz/milvus2-sdk-node": "^2.6.4",
+    "@zilliz/milvus2-sdk-node": "^2.6.5",
     "ejs": "^3.1.10",
     "jszip": "^3.10.1",
     "mysql2": "^3.15.3",
     "node-cron": "^4.2.1",
-    "openai": "^6.8.1",
+    "openai": "^6.9.1",
     "pg": "^8.16.3",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
-    "tencentcloud-sdk-nodejs": "^4.1.140"
+    "tencentcloud-sdk-nodejs": "^4.1.149"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^24.10.0",
+    "@types/node": "^24.10.1",
     "@types/pg": "^8.15.6",
     "typedoc": "^0.28.14",
     "typedoc-plugin-markdown": "^4.9.0",