@maiyunnet/kebab 9.1.2 → 9.1.3

package/index.d.ts

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

package/index.js

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

package/lib/sql.d.ts

@@ -28,7 +28,7 @@ export declare enum EJSON {
 export declare class Sql {
     /** --- ctr 对象 --- */
     private readonly _ctr?;
-    /** --- 前置 --- */
+    /** --- 前置：MySQL 时为表前缀（如 prefix_），PostgreSQL 时为 Schema 名 --- */
     private readonly _pre;
     /** --- 服务商 --- */
     private readonly _service;
@@ -45,6 +45,7 @@ export declare class Sql {
     constructor(opt: {
         'service': ESERVICE;
         'ctr'?: ctr.Ctr;
+        /** --- 表前缀/Schema 名：MySQL 中作为表前缀（如 prefix_），PostgreSQL 中作为 Schema 名 --- */
         'pre'?: string;
         'data'?: kebab.DbValue[];
         'sql'?: string[];
@@ -103,7 +104,7 @@ export declare class Sql {
      * @param s ON 信息
      * @param type 类型
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     join(f: string, s?: kebab.Json, type?: string, suf?: string, pre?: string): this;
     /**
@@ -111,7 +112,7 @@ export declare class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     leftJoin(f: string, s?: kebab.Json, suf?: string, pre?: string): this;
     /**
@@ -119,7 +120,7 @@ export declare class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     rightJoin(f: string, s?: kebab.Json, suf?: string, pre?: string): this;
     /**
@@ -127,7 +128,7 @@ export declare class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     innerJoin(f: string, s?: kebab.Json, suf?: string, pre?: string): this;
     /**
@@ -135,7 +136,7 @@ export declare class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     fullJoin(f: string, s?: kebab.Json, suf?: string, pre?: string): this;
     /**
@@ -143,7 +144,7 @@ export declare class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     crossJoin(f: string, s?: kebab.Json, suf?: string, pre?: string): this;
     /**
@@ -220,7 +221,7 @@ export declare class Sql {
     /**
      * --- 对字段进行包裹 ---
      * @param str
-     * @param pre 表前缀，仅请在 field 表名时倒入前缀
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅请在 field 表名时倒入前缀/Schema
      * @param suf 表后缀，仅请在 field 表名时倒入后缀，前面加 # 代表要强制 AS，可能是分表查询时用
      */
     field(str: string | number | [string, string[]], pre?: string, suf?: string): string;
@@ -240,6 +241,7 @@ export declare class Sql {
 /**
  * --- 创建 sql 对象 ---
  * @param opt 参数
+ * @param opt.pre MySQL 时作为表前缀（如 prefix_），PostgreSQL 时作为 Schema 名。MySQL 会自动补充末尾下划线
  */
 export declare function get(opt: {
     'service': ESERVICE;

package/lib/sql.js

@@ -29,7 +29,7 @@ let columnToken = '';
 export class Sql {
     /** --- ctr 对象 --- */
     _ctr;
-    /** --- 前置 --- */
+    /** --- 前置：MySQL 时为表前缀（如 prefix_），PostgreSQL 时为 Schema 名 --- */
     _pre = '';
     /** --- 服务商 --- */
     _service;
@@ -312,7 +312,7 @@ export class Sql {
      * @param s ON 信息
      * @param type 类型
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     join(f, s = [], type = 'INNER', suf = '', pre = '') {
         let field = this.field(f, pre || this._pre, suf ? ('#' + suf) : '');
@@ -337,7 +337,7 @@ export class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     leftJoin(f, s = [], suf = '', pre = '') {
         return this.join(f, s, 'LEFT', suf, pre);
@@ -347,7 +347,7 @@ export class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     rightJoin(f, s = [], suf = '', pre = '') {
         return this.join(f, s, 'RIGHT', suf, pre);
@@ -357,7 +357,7 @@ export class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     innerJoin(f, s = [], suf = '', pre = '') {
         return this.join(f, s, 'INNER', suf, pre);
@@ -367,7 +367,7 @@ export class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     fullJoin(f, s = [], suf = '', pre = '') {
         return this.join(f, s, 'FULL', suf, pre);
@@ -377,7 +377,7 @@ export class Sql {
      * @param f 表名
      * @param s ON 信息
      * @param suf 表后缀
-     * @param pre 表前缀，仅在 join 非默认表前缀时填写
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅在 join 非默认前缀时填写
      */
     crossJoin(f, s = [], suf = '', pre = '') {
         return this.join(f, s, 'CROSS', suf, pre);
@@ -843,7 +843,7 @@ export class Sql {
     /**
      * --- 对字段进行包裹 ---
      * @param str
-     * @param pre 表前缀，仅请在 field 表名时倒入前缀
+     * @param pre MySQL 时为表前缀，PostgreSQL 时为 Schema 名，仅请在 field 表名时倒入前缀/Schema
      * @param suf 表后缀，仅请在 field 表名时倒入后缀，前面加 # 代表要强制 AS，可能是分表查询时用
      */
     field(str, pre = '', suf = '') {
@@ -1083,6 +1083,7 @@ export class Sql {
 /**
  * --- 创建 sql 对象 ---
  * @param opt 参数
+ * @param opt.pre MySQL 时作为表前缀（如 prefix_），PostgreSQL 时作为 Schema 名。MySQL 会自动补充末尾下划线
  */
 export function get(opt) {
     let pre = opt.pre ?? opt.ctr?.getPrototype('_config').sql.pre;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.1.2",
+  "version": "9.1.3",
   "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/cmd.js

@@ -394,18 +394,24 @@ async function run() {
             }
         }
         else {
-            // --- 未指定目录：递归扫描所有站点的 www/*/stc/ ---
-            const wwwItems = await lFs.readDir(kebab.WWW_CWD);
-            for (const wwwItem of wwwItems) {
-                if (wwwItem.name === '.' || wwwItem.name === '..' || !wwwItem.isDirectory()) {
-                    continue;
-                }
-                const stcPath = `${kebab.WWW_CWD}${wwwItem.name}/stc`;
-                if (!await lFs.isDir(stcPath)) {
-                    continue;
+            // --- 未指定目录：递归在 www/ 下找所有 stc/ 目录并扫描（支持任意深度，如 www/*/stc、www/*/*/stc）---
+            const findStcDirs = async (dir) => {
+                const items = await lFs.readDir(dir);
+                for (const item of items) {
+                    if (item.name === '.' || item.name === '..' || !item.isDirectory()) {
+                        continue;
+                    }
+                    const sub = `${dir}/${item.name}`;
+                    if (item.name === 'stc') {
+                        await scanDir(sub);
+                    }
+                    else {
+                        await findStcDirs(sub);
+                    }
                 }
-                await scanDir(stcPath);
-            }
+            };
+            // --- kebab.WWW_CWD 末尾含 /，去掉再传入保持路径格式统一 ---
+            await findStcDirs(kebab.WWW_CWD.replace(/\/$/, ''));
         }
         if (entryPoints.length === 0) {
             lCore.display('KEBAB', 'BUILD', 'No .tsx files found.');

package/sys/mod.d.ts

@@ -40,7 +40,7 @@ export default class Mod {
     protected static _$key: string;
     /** --- 若使用 _$key 并且有多个 unique 索引，这里指定 _$key 的索引名 --- */
     protected static _$index: string;
-    /** --- 前缀，顺序：选项前缀 -> 本前缀 -> 配置文件前缀 --- */
+    /** --- 前缀，MySQL 时为表前缀（如 prefix_），PostgreSQL 时为 Schema 名。顺序：选项前缀 -> 本前缀 -> 配置文件前缀 --- */
     protected static _$pre?: string;
     /** --- 要 update 的内容 --- */
     protected _updates: Record<string, boolean>;
@@ -80,6 +80,7 @@ export default class Mod {
             'key': string;
             'list': string[];
         };
+        /** --- MySQL 表前缀或 PostgreSQL Schema 名，优先级：选项 > 类属性 > 配置 --- */
         'pre'?: string;
     });
     /** --- 创建字段对象 --- */
@@ -95,7 +96,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param cs 字段列表
      * @param vs 数据列表
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static insert(db: lDb.Pool | lDb.Transaction, cs: string[] | Record<string, any>, vs?: any[] | any[][], opt?: {
         'pre'?: string;
@@ -108,7 +109,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param cs 字段列表
      * @param vs 数据列表
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static insertSql(db: lDb.Pool | lDb.Transaction, cs: string[] | Record<string, any>, vs?: any[] | any[][], opt?: {
         'pre'?: string;
@@ -120,7 +121,7 @@ export default class Mod {
      * --- 根据条件移除条目 ---
      * @param db 数据库对象
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static removeByWhere(db: lDb.Pool | lDb.Transaction, where: string | kebab.Json, opt?: {
         'pre'?: string;
@@ -133,7 +134,7 @@ export default class Mod {
      * --- 根据条件移除条目（仅获取 SQL 对象） ---
      * @param db 数据库对象
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static removeByWhereSql(db: lDb.Pool | lDb.Transaction, where: string | kebab.Json, opt?: {
         'pre'?: string;
@@ -147,7 +148,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param data 要更新的数据
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static updateByWhere(db: lDb.Pool | lDb.Transaction, data: kebab.Json, where: string | kebab.Json, opt?: {
         'pre'?: string;
@@ -161,7 +162,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param data 要更新的数据
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static updateByWhereSql(db: lDb.Pool | lDb.Transaction, data: kebab.Json, where: string | kebab.Json, opt?: {
         'pre'?: string;
@@ -175,7 +176,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param data 数据列表
      * @param key 用于定位的主键或唯一键字段名
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static updateList(db: lDb.Pool | lDb.Transaction, data: Array<Record<string, any>>, key: string, opt?: {
         'ctr'?: sCtr.Ctr;
@@ -186,7 +187,7 @@ export default class Mod {
      * --- select 自定字段 ---
      * @param db 数据库对象
      * @param c 字段字符串或字段数组
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static select<T extends Mod>(db: lDb.Pool | lDb.Transaction, c: string | string[], opt?: {
         'ctr'?: sCtr.Ctr;
@@ -202,7 +203,7 @@ export default class Mod {
      * --- 通过 where 条件获取模型 ---
      * @param db 数据库对象
      * @param s 筛选条件数组或字符串
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static where<T extends Mod>(db: lDb.Pool | lDb.Transaction, s?: string | kebab.Json, opt?: {
         'ctr'?: sCtr.Ctr;
@@ -217,7 +218,7 @@ export default class Mod {
     /**
      * --- 获取创建对象，通常用于新建数据库条目 ---
      * @param db 数据库对象
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static getCreate<T extends Mod>(db: lDb.Pool | lDb.Transaction, opt?: {
         'ctr'?: sCtr.Ctr;
@@ -228,7 +229,7 @@ export default class Mod {
      * --- 根据主键（或 key 字段）获取对象 ---
      * @param db 数据库对象
      * @param val 主键值
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static find<T extends Mod>(db: lDb.Pool | lDb.Transaction, val: string | number | null, opt?: {
         'ctr'?: sCtr.Ctr;
@@ -260,7 +261,7 @@ export default class Mod {
      * --- 通过 where 条件筛选单条数据返回原生对象 ---
      * @param db 数据库对象
      * @param s 筛选条件数组或字符串
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static oneArray(db: lDb.Pool | lDb.Transaction, s: string | kebab.Json, opt?: {
         'ctr'?: sCtr.Ctr;
@@ -273,7 +274,7 @@ export default class Mod {
      * --- 根据 where 条件获取主键值列表 ---
      * @param db 数据库对象
      * @param where where 条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static primarys(db: lDb.Pool | lDb.Transaction, where?: string | kebab.Json, opt?: {
         'ctr'?: sCtr.Ctr;

package/sys/mod.js

@@ -54,7 +54,7 @@ export default class Mod {
     static _$key = '';
     /** --- 若使用 _$key 并且有多个 unique 索引，这里指定 _$key 的索引名 --- */
     static _$index = '';
-    /** --- 前缀，顺序：选项前缀 -> 本前缀 -> 配置文件前缀 --- */
+    /** --- 前缀，MySQL 时为表前缀（如 prefix_），PostgreSQL 时为 Schema 名。顺序：选项前缀 -> 本前缀 -> 配置文件前缀 --- */
     static _$pre;
     /** --- 要 update 的内容 --- */
     _updates = {};
@@ -128,7 +128,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param cs 字段列表
      * @param vs 数据列表
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static async insert(db, cs, vs, opt = {}) {
         const sq = lSql.get({
@@ -177,7 +177,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param cs 字段列表
      * @param vs 数据列表
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static insertSql(db, cs, vs, opt = {}) {
         const sq = lSql.get({
@@ -192,7 +192,7 @@ export default class Mod {
      * --- 根据条件移除条目 ---
      * @param db 数据库对象
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static async removeByWhere(db, where, opt = {}) {
         const indexs = opt.index ? (typeof opt.index === 'string' ? [opt.index] : [...new Set(opt.index)]) : [''];
@@ -225,7 +225,7 @@ export default class Mod {
      * --- 根据条件移除条目（仅获取 SQL 对象） ---
      * @param db 数据库对象
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static removeByWhereSql(db, where, opt = {}) {
         const sq = lSql.get({
@@ -247,7 +247,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param data 要更新的数据
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static async updateByWhere(db, data, where, opt = {}) {
         const indexs = opt.index ? (typeof opt.index === 'string' ? [opt.index] : [...new Set(opt.index)]) : [''];
@@ -281,7 +281,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param data 要更新的数据
      * @param where 筛选条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static updateByWhereSql(db, data, where, opt = {}) {
         const sq = lSql.get({
@@ -303,7 +303,7 @@ export default class Mod {
      * @param db 数据库对象
      * @param data 数据列表
      * @param key 用于定位的主键或唯一键字段名
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static async updateList(db, data, key, opt = {}) {
         if (!data.length) {
@@ -376,7 +376,7 @@ export default class Mod {
      * --- select 自定字段 ---
      * @param db 数据库对象
      * @param c 字段字符串或字段数组
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static select(db, c, opt = {}) {
         return new this({
@@ -393,7 +393,7 @@ export default class Mod {
      * --- 通过 where 条件获取模型 ---
      * @param db 数据库对象
      * @param s 筛选条件数组或字符串
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static where(db, s = '', opt = {}) {
         return new this({
@@ -409,7 +409,7 @@ export default class Mod {
     /**
      * --- 获取创建对象，通常用于新建数据库条目 ---
      * @param db 数据库对象
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static getCreate(db, opt = {}) {
         return new this({
@@ -423,7 +423,7 @@ export default class Mod {
      * --- 根据主键（或 key 字段）获取对象 ---
      * @param db 数据库对象
      * @param val 主键值
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static async find(db, val, opt = {}) {
         if (opt.key && !this._$key) {
@@ -444,7 +444,7 @@ export default class Mod {
      * --- 通过 where 条件筛选单条数据 ---
      * @param db 数据库对象
      * @param s 筛选条件数组或字符串
-     * @param opt 选项，lock 需确保 where 条件命中索引，否则可能退化为表锁
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名；lock 需确保 where 条件命中索引，否则可能退化为表锁）
      */
     static async one(db, s, opt = {}) {
         if (!opt.index) {
@@ -489,7 +489,7 @@ export default class Mod {
      * --- 通过 where 条件筛选单条数据返回原生对象 ---
      * @param db 数据库对象
      * @param s 筛选条件数组或字符串
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static async oneArray(db, s, opt = {}) {
         opt.array = true;
@@ -499,7 +499,7 @@ export default class Mod {
      * --- 根据 where 条件获取主键值列表 ---
      * @param db 数据库对象
      * @param where where 条件
-     * @param opt 选项
+     * @param opt 选项（opt.pre: MySQL 表前缀/PostgreSQL Schema 名）
      */
     static async primarys(db, where = '', opt = {}) {
         const sq = lSql.get({