@maiyunnet/kebab 4.1.0 → 5.0.1

package/lib/sql.d.ts

@@ -1,55 +1,50 @@
 /**
  * Project: Kebab, User: JianSuoQiYue
  * Date: 2019-5-27 20:18:50
- * Last: 2020-3-29 19:37:25, 2022-07-24 22:38:11, 2023-5-24 18:49:18, 2023-6-13 22:20:21, 2023-12-11 13:58:54, 2023-12-14 13:14:40, 2023-12-21 00:04:40, 2024-4-11 19:29:29, 2024-9-2 17:15:28, 2025-8-3 21:28:18
+ * Last: 2020-3-29 19:37:25, 2022-07-24 22:38:11, 2023-5-24 18:49:18, 2023-6-13 22:20:21, 2023-12-11 13:58:54, 2023-12-14 13:14:40, 2023-12-21 00:04:40, 2024-4-11 19:29:29, 2024-9-2 17:15:28, 2025-8-3 21:28:18, 2025-11-9 16:20:23
  */
 import * as kebab from '#kebab/index.js';
 import * as ctr from '#kebab/sys/ctr.js';
+/** --- 服务商定义 --- */
+export declare enum ESERVICE {
+    'MYSQL' = 0,
+    'PGSQL' = 1
+}
 export declare class Sql {
     /** --- 前置 --- */
     private readonly _pre;
+    /** --- 服务商 --- */
+    private readonly _service;
     /** --- 预拼装 Sql 数组 --- */
     private _sql;
     /** --- 所有 data 数据 --- */
     private _data;
+    /** --- 表别名列表 --- */
+    private readonly _alias;
+    /** --- PostgreSQL 占位符计数器 --- */
+    private _placeholder;
     constructor(pre?: string, opt?: {
         'data'?: kebab.DbValue[];
         'sql'?: string[];
+        'service'?: ESERVICE;
     });
     /**
      * --- 插入数据前导 ---
      * @param table 表名
      */
     insert(table: string): this;
-    /**
-     * --- 替换已经存在的唯一索引数据，不存在则插入 ---
-     * @param table 表名
-     */
-    replace(table: string): this;
     /**
      * --- 实际插入数据的数据 ---
      * @param cs [] 数据列或字段列
      * @param vs [] | [][] 数据
      */
     values(cs: string[] | Record<string, kebab.DbValue>, vs?: kebab.DbValue[] | kebab.DbValue[][]): this;
-    /**
-     * --- 不存在则插入，衔接在 insert 之后 ---
-     * @param table 表名
-     * @param insert {'xx': 'xx', 'xx': 'xx'}
-     * @param where [{'xx': 'xx', 'xx': 'xx'}], {'xx': 'xx'}
-     */
-    notExists(table: string, insert: Record<string, kebab.DbValue>, where: string | kebab.Json): this;
-    /**
-     * --- 当不能 insert 时，update（仅能配合 insert 方法用） ---
-     * @param s 更新数据
-     */
-    duplicate(s: kebab.Json): this;
     /**
      * --- '*', 'xx' ---
      * @param c 字段字符串或字段数组
      * @param f 表，允许多张表
      */
-    select(c: string | Array<string | Array<string | string[]>>, f: string | string[]): this;
+    select(c: string | Array<string | any[]>, f: string | string[]): this;
     /**
      * --- UPDATE SQL 方法 ---
      * @param f 表名
@@ -153,9 +148,9 @@ export declare class Sql {
      */
     group(c: string | string[]): this;
     /**
-     * --- LIMIT ---
-     * @param a 起始
-     * @param b 长度
+     * --- LIMIT（limit、offset, limit） ---
+     * @param a 起始（offset）
+     * @param b 长度（limit）
      */
     limit(a: number, b?: number): this;
     /**
@@ -192,11 +187,13 @@ export declare class Sql {
      * @param sql
      */
     append(sql: string): this;
+    /** --- 获取占位符 --- */
+    placeholder(): string;
     /**
      * --- 对字段进行包裹 ---
      * @param str
      * @param pre 表前缀，仅请在 field 表名时倒入前缀
-     * @param suf 表后缀，仅请在 field 表名时倒入后缀，前面加 # 代表要强制 AS
+     * @param suf 表后缀，仅请在 field 表名时倒入后缀，前面加 # 代表要强制 AS，可能是分表查询时用
      */
     field(str: string | number | Array<string | string[]>, pre?: string, suf?: string): string;
     /**
@@ -213,13 +210,15 @@ export declare class Sql {
 export declare function get(ctrPre?: ctr.Ctr | string, opt?: {
     'data'?: kebab.DbValue[];
     'sql'?: string[];
+    'service'?: ESERVICE;
 }): Sql;
 /**
- * --- 返回代入后的完整 SQL 字符串 ---
+ * --- 返回代入后的完整 SQL 字符串，这并不安全不能直接执行，只是用来调试打印 sql 语句 ---
  * @param sql SQL 字符串
  * @param data DATA 数据
+ * @param service 服务商，默认 MySQL
  */
-export declare function format(sql: string, data: kebab.DbValue[]): string;
+export declare function format(sql: string, data: kebab.DbValue[], service?: ESERVICE): string;
 /**
  * --- 将数组兑换为组合的对象（Array/Object mix） ---
  * @param arr 要转换的数组