@maiyunnet/kebab 7.7.1 → 7.8.0

package/doc/kebab-rag.md

@@ -1385,7 +1385,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"7.7.1"` = `'7.7.1'`
+> `const` **VER**: `"7.8.0"` = `'7.8.0'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -12728,7 +12728,7 @@ lib/sql/classes/Sql.md
 
 # Class: Sql
 
-Defined in: [lib/sql.ts:37](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L37)
+Defined in: [lib/sql.ts:39](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L39)
 
 ## Constructors
 
@@ -12736,7 +12736,7 @@ Defined in: [lib/sql.ts:37](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **new Sql**(`opt`): `Sql`
 
-Defined in: [lib/sql.ts:64](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L64)
+Defined in: [lib/sql.ts:66](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L66)
 
 #### Parameters
 
@@ -12772,7 +12772,7 @@ Defined in: [lib/sql.ts:64](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **append**(`sql`): `this`
 
-Defined in: [lib/sql.ts:848](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L848)
+Defined in: [lib/sql.ts:860](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L860)
 
 在 sql 最后追加字符串
 
@@ -12792,7 +12792,7 @@ Defined in: [lib/sql.ts:848](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **by**(`c`, `d`): `this`
 
-Defined in: [lib/sql.ts:649](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L649)
+Defined in: [lib/sql.ts:661](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L661)
 
 ORDER BY
 
@@ -12820,7 +12820,7 @@ ORDER BY
 
 > **copy**(`f?`, `opt?`): `Sql`
 
-Defined in: [lib/sql.ts:717](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L717)
+Defined in: [lib/sql.ts:729](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L729)
 
 创建一个本对象的一个新的 sql 对象拷贝
 
@@ -12848,7 +12848,7 @@ Defined in: [lib/sql.ts:717](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **crossJoin**(`f`, `s`, `suf`, `pre`): `this`
 
-Defined in: [lib/sql.ts:414](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L414)
+Defined in: [lib/sql.ts:416](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L416)
 
 cross join 方法
 
@@ -12888,7 +12888,7 @@ ON 信息
 
 > **delete**(`f`): `this`
 
-Defined in: [lib/sql.ts:309](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L309)
+Defined in: [lib/sql.ts:311](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L311)
 
 'xx'
 
@@ -12910,7 +12910,7 @@ Defined in: [lib/sql.ts:309](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **field**(`str`, `pre`, `suf`): `string`
 
-Defined in: [lib/sql.ts:859](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L859)
+Defined in: [lib/sql.ts:871](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L871)
 
 对字段进行包裹
 
@@ -12942,7 +12942,7 @@ Defined in: [lib/sql.ts:859](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **format**(`sql?`, `data?`): `string`
 
-Defined in: [lib/sql.ts:838](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L838)
+Defined in: [lib/sql.ts:850](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L850)
 
 获取带 data 的 sql 语句
 
@@ -12966,7 +12966,7 @@ Defined in: [lib/sql.ts:838](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **fullJoin**(`f`, `s`, `suf`, `pre`): `this`
 
-Defined in: [lib/sql.ts:403](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L403)
+Defined in: [lib/sql.ts:405](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L405)
 
 full join 方法
 
@@ -13006,7 +13006,7 @@ ON 信息
 
 > **getData**(): [`DbValue`](../../../index/type-aliases/DbValue.md)[]
 
-Defined in: [lib/sql.ts:822](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L822)
+Defined in: [lib/sql.ts:834](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L834)
 
 获取全部 data
 
@@ -13020,7 +13020,7 @@ Defined in: [lib/sql.ts:822](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **getPre**(): `string`
 
-Defined in: [lib/sql.ts:829](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L829)
+Defined in: [lib/sql.ts:841](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L841)
 
 获取定义的 pre
 
@@ -13034,7 +13034,7 @@ Defined in: [lib/sql.ts:829](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **getSql**(): `string`
 
-Defined in: [lib/sql.ts:806](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L806)
+Defined in: [lib/sql.ts:818](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L818)
 
 获取 sql 语句
 
@@ -13048,7 +13048,7 @@ Defined in: [lib/sql.ts:806](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **group**(`c`): `this`
 
-Defined in: [lib/sql.ts:673](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L673)
+Defined in: [lib/sql.ts:685](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L685)
 
 GROUP BY
 
@@ -13070,7 +13070,7 @@ GROUP BY
 
 > **having**(`s`): `this`
 
-Defined in: [lib/sql.ts:421](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L421)
+Defined in: [lib/sql.ts:423](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L423)
 
 having 后置筛选器，用法类似 where
 
@@ -13090,7 +13090,7 @@ having 后置筛选器，用法类似 where
 
 > **innerJoin**(`f`, `s`, `suf`, `pre`): `this`
 
-Defined in: [lib/sql.ts:392](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L392)
+Defined in: [lib/sql.ts:394](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L394)
 
 inner join 方法
 
@@ -13130,7 +13130,7 @@ ON 信息
 
 > **insert**(`table`, `ignore`): `this`
 
-Defined in: [lib/sql.ts:89](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L89)
+Defined in: [lib/sql.ts:91](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L91)
 
 插入数据前导
 
@@ -13158,7 +13158,7 @@ Defined in: [lib/sql.ts:89](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 > **join**(`f`, `s`, `type`, `suf`, `pre`): `this`
 
-Defined in: [lib/sql.ts:344](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L344)
+Defined in: [lib/sql.ts:346](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L346)
 
 join 方法
 
@@ -13204,7 +13204,7 @@ ON 信息
 
 > **leftJoin**(`f`, `s`, `suf`, `pre`): `this`
 
-Defined in: [lib/sql.ts:370](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L370)
+Defined in: [lib/sql.ts:372](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L372)
 
 left join 方法
 
@@ -13244,7 +13244,7 @@ ON 信息
 
 > **limit**(`a`, `b`): `this`
 
-Defined in: [lib/sql.ts:693](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L693)
+Defined in: [lib/sql.ts:705](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L705)
 
 LIMIT（limit、offset, limit）
 
@@ -13272,7 +13272,7 @@ LIMIT（limit、offset, limit）
 
 > **lock**(): `this`
 
-Defined in: [lib/sql.ts:708](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L708)
+Defined in: [lib/sql.ts:720](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L720)
 
 追加消极锁，通常不建议使用
 
@@ -13286,7 +13286,7 @@ Defined in: [lib/sql.ts:708](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **rightJoin**(`f`, `s`, `suf`, `pre`): `this`
 
-Defined in: [lib/sql.ts:381](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L381)
+Defined in: [lib/sql.ts:383](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L383)
 
 right join 方法
 
@@ -13326,7 +13326,7 @@ ON 信息
 
 > **select**(`c`, `f`): `this`
 
-Defined in: [lib/sql.ts:200](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L200)
+Defined in: [lib/sql.ts:202](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L202)
 
 '*', 'xx'
 
@@ -13354,7 +13354,7 @@ Defined in: [lib/sql.ts:200](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **union**(`lsql`, `type`): `this`
 
-Defined in: [lib/sql.ts:321](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L321)
+Defined in: [lib/sql.ts:323](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L323)
 
 联查另一个 sql 对象
 
@@ -13382,7 +13382,7 @@ sql 对象
 
 > **unionAll**(`lsql`): `this`
 
-Defined in: [lib/sql.ts:332](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L332)
+Defined in: [lib/sql.ts:334](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L334)
 
 所有联查另一个 sql 对象
 
@@ -13404,7 +13404,7 @@ sql 对象
 
 > **update**(`f`, `s`): `this`
 
-Defined in: [lib/sql.ts:241](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L241)
+Defined in: [lib/sql.ts:243](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L243)
 
 UPDATE SQL 方法
 
@@ -13432,7 +13432,7 @@ UPDATE SQL 方法
 
 > **upsert**(`data`, `conflict?`): `this`
 
-Defined in: [lib/sql.ts:166](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L166)
+Defined in: [lib/sql.ts:168](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L168)
 
 如果存在则更新不存在则插入（UPSERT）
 
@@ -13460,7 +13460,7 @@ Defined in: [lib/sql.ts:166](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **values**(`cs`, `vs`): `this`
 
-Defined in: [lib/sql.ts:108](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L108)
+Defined in: [lib/sql.ts:110](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L110)
 
 实际插入数据的数据
 
@@ -13488,7 +13488,7 @@ Defined in: [lib/sql.ts:108](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **where**(`s`): `this`
 
-Defined in: [lib/sql.ts:455](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L455)
+Defined in: [lib/sql.ts:457](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L457)
 
 筛选器
 1. 'city': 'bj', 'type': '2'
@@ -13535,7 +13535,7 @@ JSON 查询操作符
 
 Defined in: [lib/sql.ts:25](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L25)
 
-被包含 (MySQL: JSON_CONTAINS, PG: <@)
+被包含值 (MySQL: JSON_CONTAINS, PG: <@)
 
 ***
 
@@ -13545,7 +13545,7 @@ Defined in: [lib/sql.ts:25](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 Defined in: [lib/sql.ts:23](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L23)
 
-包含 (MySQL: JSON_CONTAINS, PG: @>)
+包含值 (MySQL: JSON_CONTAINS, PG: @>)
 
 ***
 
@@ -13555,7 +13555,7 @@ Defined in: [lib/sql.ts:23](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 Defined in: [lib/sql.ts:31](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L31)
 
-存在所有 Key (MySQL: JSON_CONTAINS_PATH all, PG: ?&)
+存在所有 Key 不含值 (MySQL: JSON_CONTAINS_PATH all, PG: ?&)
 
 ***
 
@@ -13565,7 +13565,7 @@ Defined in: [lib/sql.ts:31](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 Defined in: [lib/sql.ts:29](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L29)
 
-存在任意 Key (MySQL: JSON_CONTAINS_PATH one, PG: ?|)
+存在任意 Key 不含值 (MySQL: JSON_CONTAINS_PATH one, PG: ?|)
 
 ***
 
@@ -13575,7 +13575,17 @@ Defined in: [lib/sql.ts:29](https://github.com/maiyunnet/kebab/blob/master/lib/s
 
 Defined in: [lib/sql.ts:27](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L27)
 
-存在 Key (MySQL: JSON_CONTAINS_PATH one, PG: ?)
+存在 Key 不含值 (MySQL: JSON_CONTAINS_PATH one, PG: ?)
+
+***
+
+### OVERLAPS
+
+> **OVERLAPS**: `"json_overlaps"`
+
+Defined in: [lib/sql.ts:33](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L33)
+
+简单数组重叠 (MySQL: JSON_OVERLAPS, PG: &&)
 
 lib/sql/enumerations/ESERVICE.md
 ---
@@ -13621,7 +13631,7 @@ lib/sql/functions/aoMix.md
 
 > **aoMix**(`arr`): `Record`\<`string`, `string` \| `number` \| [`Json`](../../../index/type-aliases/Json.md)\>
 
-Defined in: [lib/sql.ts:1180](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1180)
+Defined in: [lib/sql.ts:1192](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1192)
 
 将数组兑换为组合的对象（Array/Object mix）
 
@@ -13650,7 +13660,7 @@ lib/sql/functions/column.md
 
 > **column**(`field`): `object`
 
-Defined in: [lib/sql.ts:1201](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1201)
+Defined in: [lib/sql.ts:1213](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1213)
 
 创建字段对象
 
@@ -13689,7 +13699,7 @@ lib/sql/functions/format.md
 
 > **format**(`sql`, `data`, `service`): `string`
 
-Defined in: [lib/sql.ts:1142](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1142)
+Defined in: [lib/sql.ts:1154](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1154)
 
 返回代入后的完整 SQL 字符串，这并不安全不能直接执行，只是用来调试打印 sql 语句
 
@@ -13730,7 +13740,7 @@ lib/sql/functions/get.md
 
 > **get**(`opt`): [`Sql`](../classes/Sql.md)
 
-Defined in: [lib/sql.ts:1115](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1115)
+Defined in: [lib/sql.ts:1127](https://github.com/maiyunnet/kebab/blob/master/lib/sql.ts#L1127)
 
 创建 sql 对象
 

package/index.d.ts

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

package/index.js

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

package/lib/sql.d.ts

@@ -12,16 +12,18 @@ export declare enum ESERVICE {
 }
 /** --- JSON 查询操作符 --- */
 export declare enum EJSON {
-    /** --- 包含 (MySQL: JSON_CONTAINS, PG: @>) --- */
+    /** --- 包含值 (MySQL: JSON_CONTAINS, PG: @>) --- */
     'CONTAINS' = "json",
-    /** --- 被包含 (MySQL: JSON_CONTAINS, PG: <@) --- */
+    /** --- 被包含值 (MySQL: JSON_CONTAINS, PG: <@) --- */
     'CONTAINED_BY' = "json_in",
-    /** --- 存在 Key (MySQL: JSON_CONTAINS_PATH one, PG: ?) --- */
+    /** --- 存在 Key 不含值 (MySQL: JSON_CONTAINS_PATH one, PG: ?) --- */
     'HAS_KEY' = "json_key",
-    /** --- 存在任意 Key (MySQL: JSON_CONTAINS_PATH one, PG: ?|) --- */
+    /** --- 存在任意 Key 不含值 (MySQL: JSON_CONTAINS_PATH one, PG: ?|) --- */
     'HAS_ANY_KEYS' = "json_any",
-    /** --- 存在所有 Key (MySQL: JSON_CONTAINS_PATH all, PG: ?&) --- */
-    'HAS_ALL_KEYS' = "json_all"
+    /** --- 存在所有 Key 不含值 (MySQL: JSON_CONTAINS_PATH all, PG: ?&) --- */
+    'HAS_ALL_KEYS' = "json_all",
+    /** --- 简单数组重叠 (MySQL: JSON_OVERLAPS, PG: &&) --- */
+    'OVERLAPS' = "json_overlaps"
 }
 export declare class Sql {
     /** --- ctr 对象 --- */

package/lib/sql.js

@@ -11,16 +11,18 @@ export var ESERVICE;
 /** --- JSON 查询操作符 --- */
 export var EJSON;
 (function (EJSON) {
-    /** --- 包含 (MySQL: JSON_CONTAINS, PG: @>) --- */
+    /** --- 包含值 (MySQL: JSON_CONTAINS, PG: @>) --- */
     EJSON["CONTAINS"] = "json";
-    /** --- 被包含 (MySQL: JSON_CONTAINS, PG: <@) --- */
+    /** --- 被包含值 (MySQL: JSON_CONTAINS, PG: <@) --- */
     EJSON["CONTAINED_BY"] = "json_in";
-    /** --- 存在 Key (MySQL: JSON_CONTAINS_PATH one, PG: ?) --- */
+    /** --- 存在 Key 不含值 (MySQL: JSON_CONTAINS_PATH one, PG: ?) --- */
     EJSON["HAS_KEY"] = "json_key";
-    /** --- 存在任意 Key (MySQL: JSON_CONTAINS_PATH one, PG: ?|) --- */
+    /** --- 存在任意 Key 不含值 (MySQL: JSON_CONTAINS_PATH one, PG: ?|) --- */
     EJSON["HAS_ANY_KEYS"] = "json_any";
-    /** --- 存在所有 Key (MySQL: JSON_CONTAINS_PATH all, PG: ?&) --- */
+    /** --- 存在所有 Key 不含值 (MySQL: JSON_CONTAINS_PATH all, PG: ?&) --- */
     EJSON["HAS_ALL_KEYS"] = "json_all";
+    /** --- 简单数组重叠 (MySQL: JSON_OVERLAPS, PG: &&) --- */
+    EJSON["OVERLAPS"] = "json_overlaps";
 })(EJSON || (EJSON = {}));
 /** --- field 用 token --- */
 let columnToken = '';
@@ -452,7 +454,7 @@ export class Sql {
                         data.push(...v[1]);
                     }
                 }
-                else if (typeof v[1] === 'string' && ['json', 'json_in', 'json_key', 'json_any', 'json_all'].includes(v[1].toLowerCase())) {
+                else if (typeof v[1] === 'string' && ['json', 'json_in', 'json_key', 'json_any', 'json_all', 'json_overlaps'].includes(v[1].toLowerCase())) {
                     // --- json ---
                     const op = v[1].toLowerCase();
                     const nv = v[2];
@@ -476,6 +478,16 @@ export class Sql {
                             data.push(lText.stringifyJson(nv));
                         }
                     }
+                    else if (op === 'json_overlaps') {
+                        if (this._service === ESERVICE.MYSQL) {
+                            sql += `JSON_OVERLAPS(${this.field(v[0])}, ${this._placeholder()}) AND `;
+                            data.push(lText.stringifyJson(nv));
+                        }
+                        else {
+                            sql += `${this.field(v[0])} && ${this._placeholder()} AND `;
+                            data.push(nv);
+                        }
+                    }
                     else {
                         // --- json_key, json_any, json_all ---
                         const keys = Array.isArray(nv) ? nv : [nv];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "7.7.1",
+  "version": "7.8.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,8 +22,8 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.971.0",
-    "@aws-sdk/lib-storage": "^3.971.0",
+    "@aws-sdk/client-s3": "^3.975.0",
+    "@aws-sdk/lib-storage": "^3.975.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
     "@litert/redis": "^3.1.0",
@@ -35,15 +35,15 @@
     "mysql2": "^3.16.1",
     "node-cron": "^4.2.1",
     "openai": "^6.16.0",
-    "pg": "^8.17.1",
+    "pg": "^8.17.2",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
-    "tencentcloud-sdk-nodejs": "^4.1.172"
+    "tencentcloud-sdk-nodejs": "^4.1.175"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.0.10",
     "@types/pg": "^8.16.0",
     "typedoc": "^0.28.16",
     "typedoc-plugin-markdown": "^4.9.0",

package/www/example/ctr/test.js

@@ -2601,6 +2601,13 @@ Result:<pre id="result">Nothing.</pre>`);
                 echo.push(`<pre>sql.select('*', 'user').where([['info', lSql.EJSON.HAS_ALL_KEYS, ['age', 'name']]]);</pre>
 <b>getSql() :</b> ${s}<br>
 <b>getData():</b> <pre>${JSON.stringify(sd, undefined, 4)}</pre>
+<b>format() :</b> ${sql.format(s, sd)}<hr>`);
+                // --- overlaps ---
+                s = sql.select('*', 'test').where([['tags', lSql.EJSON.OVERLAPS, ['a', 'b']]]).getSql();
+                sd = sql.getData();
+                echo.push(`<pre>sql.select('*', 'test').where([['tags', lSql.EJSON.OVERLAPS, ['a', 'b']]]);</pre>
+<b>getSql() :</b> ${s}<br>
+<b>getData():</b> <pre>${JSON.stringify(sd, undefined, 4)}</pre>
 <b>format() :</b> ${sql.format(s, sd)}`);
                 break;
             }