imodel 0.18.0 → 0.19.1

package/index.d.mts

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.18.0
+ * imodel v0.19.1
  * (c) 2019-2026 undefined
  * @license undefined
  */
@@ -620,6 +620,7 @@ interface Hook<T extends Hooks[keyof Hooks]> {
  */
 declare function toNot(items?: WhereValue[] | null): WhereValue[] | null;
 type WhereItem = {
+    exists?: false | null | undefined;
     where?: null | undefined;
     or?: null | undefined;
     field: string | {
@@ -634,7 +635,16 @@ type WhereItem = {
     not?: boolean | undefined;
     operator?: string | null | undefined;
 };
+type WhereExists = {
+    where?: null | undefined;
+    or?: null | undefined;
+    field?: null | undefined;
+    exists: true;
+    subquery: SelectItem[];
+    not?: boolean | undefined;
+};
 type WhereRaw = {
+    exists?: false | null | undefined;
     field?: null | undefined;
     or?: null | undefined;
     where: readonly string[];
@@ -642,12 +652,13 @@ type WhereRaw = {
     not?: boolean | undefined;
 };
 type WhereOr = {
+    exists?: false | null | undefined;
     where?: null | undefined;
     field?: null | undefined;
     or: WhereValue[][];
     not?: boolean | undefined;
 };
-type WhereValue = WhereItem | WhereRaw | WhereOr;
+type WhereValue = WhereItem | WhereExists | WhereRaw | WhereOr;
 type WhereLike = {
     toWhereValue(): WhereValue[][];
 };
@@ -738,6 +749,58 @@ declare class Where {
      * @returns {Where}
      */
     static and(items: [Wheres] | [TemplateStringsArray, ...any] | [string | string[], any] | [string | string[], string, any, boolean?]): Where;
+    /**
+     * @overload
+     * @param {Wheres} matches
+     * @returns {Where}
+     */
+    static where(matches: Wheres): Where;
+    /**
+     *
+     * @overload
+     * @param {TemplateStringsArray} where
+     * @param  {...any} values
+     * @returns {Where}
+     */
+    static where(where: TemplateStringsArray, ...values: any[]): Where;
+    /**
+     * @overload
+     * @param {string} field
+     * @param {any} value
+     * @returns {Where}
+     */
+    static where(field: string, value: any): Where;
+    /**
+     * @overload
+     * @param {string[]} field
+     * @param {any[]} value
+     * @returns {Where}
+     */
+    static where(field: string[], value: any[]): Where;
+    /**
+     * @overload
+     * @param {string} field
+     * @param {string} operator
+     * @param {any} value
+     * @param {boolean} [not]
+     * @returns {Where}
+     */
+    static where(field: string, operator: string, value: any, not?: boolean | undefined): Where;
+    /**
+     * @overload
+     * @param {string[]} field
+     * @param {string} operator
+     * @param {any[]} value
+     * @param {boolean} [not]
+     * @returns {Where}
+     */
+    static where(field: string[], operator: string, value: any[], not?: boolean | undefined): Where;
+    /**
+     * @overload
+     * @param {[Wheres] | [TemplateStringsArray, ...any] | [string | string[], any] | [string | string[], string, any, boolean?]} items
+     * @returns {Where}
+     */
+    static where(items: [Wheres] | [TemplateStringsArray, ...any] | [string | string[], any] | [string | string[], string, any, boolean?]): Where;
     /**
      * @overload
      * @param {Wheres} matches
@@ -894,6 +957,18 @@ declare class Where {
      * @returns {Where}
      */
     static orNot(items: [Wheres] | [TemplateStringsArray, ...any] | [string | string[], any] | [string | string[], string, any, boolean?]): Where;
+    /**
+     *
+     * @param  {...SelectItem} subquery
+     * @returns {Where}
+     */
+    static exists(...subquery: SelectItem[]): Where;
+    /**
+     *
+     * @param  {...SelectItem} subquery
+     * @returns {Where}
+     */
+    static notExists(...subquery: SelectItem[]): Where;
     toWhereValue(): WhereValue[][];
     /**
      * @overload
@@ -1103,6 +1178,18 @@ declare class Where {
      * @returns {this}
      */
     orNot(items: [Wheres] | [TemplateStringsArray, ...any] | [string | string[], any] | [string | string[], string, any, boolean?]): this;
+    /**
+     *
+     * @param  {...SelectItem} subquery
+     * @returns {this}
+     */
+    exists(...subquery: SelectItem[]): this;
+    /**
+     *
+     * @param  {...SelectItem} subquery
+     * @returns {this}
+     */
+    notExists(...subquery: SelectItem[]): this;
     #private;
 }
 
@@ -2118,10 +2205,10 @@ declare class Query<T extends Fields, TB extends unknown = any> extends Subquery
      */
     contains(text?: string): this;
     /**
-     * @param {any} [primary]
+     * @param {...any | any[]} primaries
      * @returns {this}
      */
-    primary(primary?: any, ...args: any[]): this;
+    primary(...primaries: (any | any[])[]): this;
     /**
      *
      * @param  {...string | string[]} groups
@@ -2180,6 +2267,15 @@ declare function bindHooks(hooks: Readonly<Partial<Hooks>>, that: any): Readonly
  */
 /** @import {FieldDefine, Fields, TableDefine,} from './types/table' */
 declare class Scene {
+    /**
+     * @template {TableDefine<Fields, string>} T
+     * @param {{scene?: Scene} | Scene} source
+     * @param {T} table
+     * @returns {T}
+     */
+    static table<T extends TableDefine<Fields, string>>(source: {
+        scene?: Scene;
+    } | Scene, table: T): T;
     /**
      *
      * @param {Map<string, Scene.Define>} map
@@ -2564,6 +2660,13 @@ declare function field<T extends MainFieldType>(type: T, options: {
     default?: ToType<T, boolean, boolean> | symbol;
 } & FieldDefineOption): FieldDefine<T, boolean, boolean>;
 
+/**
+ *
+ * @param {any} v
+ * @returns
+ */
+declare function toBool(v: any): boolean;
+
 /**
  *
  * @param {boolean} [d]
@@ -2571,4 +2674,4 @@ declare function field<T extends MainFieldType>(type: T, options: {
 declare function setDevelopment(d?: boolean): void;
 declare let isDevelopment: boolean;
 
-export { Build, type ClassDecorator, type Column, type ColumnOptions, Connection, type Constraint, Create, type DBColumn, type DBIndex, type DBTable, Destroy, type Environment, type FieldDecorator, type FieldDefine, type FieldDefineOption, type FieldDefineType, type FieldSpecific, type FieldSpecificValue, type FieldType, type FieldTypeDefine, type FieldValue, type Fields, type FindArg, type FindRange, type GetName, type Hook, type Hooks, type IConnection, type Index, type IndexInfo, type IndexOptions, type JOIN, type Join, type JoinType, type MainFieldType, type MaybePromise, type MethodDecorator, Model, type Options, PseudoDestroy, Query, type QueryOptions, type Queryable, Save, Scene, Select, type SelectItem, SetValue, type Skip, Submodel, type Support, type TableConnect, type TableConnection, type TableDefine, type TableType, type TableValue, type ToFieldType, type ToType, type TransactionFn, type VirtualTable, Where, type WhereItem, type WhereLike, type WhereOr, type WhereRaw, type WhereValue, type Wheres, afterCreate, afterCreateMany, afterDelete, afterUpdate, beforeCreate, beforeCreateMany, beforeDelete, beforeUpdate, bindHooks, coefficient, column, creating, decrement, defaultValue, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, hooks, immutable, increment, index, isDevelopment, isPseudo, mergeHooks, model, multiply, now, primary, prop, pseudo, setDevelopment, sort, model as submodel, toNot, toPrimaries, toPrimary, uncreatable, undeleted, updating, uuid, values, where, withDeleted };
+export { Build, type ClassDecorator, type Column, type ColumnOptions, Connection, type Constraint, Create, type DBColumn, type DBIndex, type DBTable, Destroy, type Environment, type FieldDecorator, type FieldDefine, type FieldDefineOption, type FieldDefineType, type FieldSpecific, type FieldSpecificValue, type FieldType, type FieldTypeDefine, type FieldValue, type Fields, type FindArg, type FindRange, type GetName, type Hook, type Hooks, type IConnection, type Index, type IndexInfo, type IndexOptions, type JOIN, type Join, type JoinType, type MainFieldType, type MaybePromise, type MethodDecorator, Model, type Options, PseudoDestroy, Query, type QueryOptions, type Queryable, Save, Scene, Select, type SelectItem, SetValue, type Skip, Submodel, type Support, type TableConnect, type TableConnection, type TableDefine, type TableType, type TableValue, type ToFieldType, type ToType, type TransactionFn, type VirtualTable, Where, type WhereExists, type WhereItem, type WhereLike, type WhereOr, type WhereRaw, type WhereValue, type Wheres, afterCreate, afterCreateMany, afterDelete, afterUpdate, beforeCreate, beforeCreateMany, beforeDelete, beforeUpdate, bindHooks, coefficient, column, creating, decrement, defaultValue, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, hooks, immutable, increment, index, isDevelopment, isPseudo, mergeHooks, model, multiply, now, primary, prop, pseudo, setDevelopment, sort, model as submodel, toBool, toNot, toPrimaries, toPrimary, uncreatable, undeleted, updating, uuid, values, where, withDeleted };

package/index.mjs

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.18.0
+ * imodel v0.19.1
  * (c) 2019-2026 undefined
  * @license undefined
  */
@@ -26,6 +26,7 @@ class Subquery {
 /** @typedef {WhereLike | Record<string, any> | (WhereLike | Record<string, any>)[]} Wheres */
 /**
  * @typedef {object} WhereItem
+ * @prop {false?} [exists]
  * @prop {null} [where]
  * @prop {null} [or]
  * @prop {string | {table?: string; field: string} | (string | {table?: string; field: string})[]} field
@@ -34,8 +35,18 @@ class Subquery {
  * @prop {boolean} [not]
  * @prop {string?} [operator]
  */
+/**
+ * @typedef {object} WhereExists
+ * @prop {null} [where]
+ * @prop {null} [or]
+ * @prop {null} [field]
+ * @prop {true} exists
+ * @prop {SelectItem[]} subquery
+ * @prop {boolean} [not]
+ */
 /**
  * @typedef {object} WhereRaw
+ * @prop {false?} [exists]
  * @prop {null} [field]
  * @prop {null} [or]
  * @prop {readonly string[]} where
@@ -44,12 +55,13 @@ class Subquery {
  */
 /**
  * @typedef {object} WhereOr
+ * @prop {false?} [exists]
  * @prop {null} [where]
  * @prop {null} [field]
  * @prop {WhereValue[][]} or
  * @prop {boolean} [not]
  */
-/** @typedef {WhereItem | WhereRaw | WhereOr} WhereValue */
+/** @typedef {WhereItem | WhereExists | WhereRaw | WhereOr} WhereValue */
 /**
  *
  * @param {*} v
@@ -317,6 +329,58 @@ class Where {
   static and(...items) {
     return new Where().#and(parse(items));
   }
+  /**
+   * @overload
+   * @param {Wheres} matches
+   * @returns {Where}
+   */
+  /**
+   *
+   * @overload
+   * @param {TemplateStringsArray} where
+   * @param  {...any} values
+   * @returns {Where}
+   */
+  /**
+   * @overload
+   * @param {string} field
+   * @param {any} value
+   * @returns {Where}
+   */
+  /**
+   * @overload
+   * @param {string[]} field
+   * @param {any[]} value
+   * @returns {Where}
+   */
+  /**
+   * @overload
+   * @param {string} field
+   * @param {string} operator
+   * @param {any} value
+   * @param {boolean} [not]
+   * @returns {Where}
+   */
+  /**
+   * @overload
+   * @param {string[]} field
+   * @param {string} operator
+   * @param {any[]} value
+   * @param {boolean} [not]
+   * @returns {Where}
+   */
+  /**
+   * @overload
+   * @param {[Wheres] | [TemplateStringsArray, ...any] | [string | string[], any] | [string | string[], string, any, boolean?]} items
+   * @returns {Where}
+   */
+  /**
+   * @param {[Wheres] | [TemplateStringsArray, ...any] | [string | string[], any] | [string | string[], string, any, boolean?]} items
+   * @returns {Where}
+   */
+  static where(...items) {
+    return new Where().#and(parse(items));
+  }
   /**
    * @overload
    * @param {Wheres} matches
@@ -629,6 +693,52 @@ class Where {
   static orNot(...items) {
     return new Where().#or(toNot(parse(items)));
   }
+  /**
+   *
+   * @param  {...SelectItem} subquery
+   * @returns {this}
+   */
+  exists(...subquery) {
+    return this.#and([{
+      exists: true,
+      subquery
+    }]);
+  }
+  /**
+   *
+   * @param  {...SelectItem} subquery
+   * @returns {Where}
+   */
+  static exists(...subquery) {
+    return new Where().#and([{
+      exists: true,
+      subquery
+    }]);
+  }
+  /**
+   *
+   * @param  {...SelectItem} subquery
+   * @returns {this}
+   */
+  notExists(...subquery) {
+    return this.#and([{
+      exists: true,
+      subquery,
+      not: true
+    }]);
+  }
+  /**
+   *
+   * @param  {...SelectItem} subquery
+   * @returns {Where}
+   */
+  static notExists(...subquery) {
+    return new Where().#and([{
+      exists: true,
+      subquery,
+      not: true
+    }]);
+  }
 }
 
 const deleted = Symbol();
@@ -4855,7 +4965,20 @@ function coefficient(...value) {
   };
 }
 
-/** @import { Fields, Options, Queryable, Select, TableConnect, VirtualTable } from './types' */
+const falseValues = new Set(['', '0', 'n', 'f', 'no', 'off', 'false', '否', '不', '假', '不是', '不行', '不可以']);
+/**
+ *
+ * @param {any} v
+ * @returns
+ */
+function toBool(v) {
+  if (typeof v !== 'string') {
+    return Boolean(v);
+  }
+  return !falseValues.has(v.toLowerCase());
+}
+
+/** @import { FieldDefine, Fields, Options, Queryable, Select, TableConnect, VirtualTable } from './types' */
 /** @import { WhereValue, Wheres } from './Where.mjs' */
 /**
  *
@@ -4953,7 +5076,7 @@ class Query extends Subquery {
   #options = {
     where: []
   };
-  /** @type {string[]} 主键字段 */
+  /** @type {[string, FieldDefine][]} 主键字段 */
   #primaryFields = [];
   get options() {
     return this.#options;
@@ -4977,7 +5100,6 @@ class Query extends Subquery {
         ...options.#options
       };
       this.#primaryFields = options.#primaryFields;
-      this.#primary = options.#primary;
     } else {
       const {
         connect,
@@ -4991,7 +5113,7 @@ class Query extends Subquery {
       this.fields = fields;
       this.pseudo = typeof pseudo === 'string' ? pseudo : '';
       this.#build = typeof build === 'function' ? build : null;
-      this.#primaryFields = Object.entries(fields).filter(([, v]) => v.primary).sort(([, a], [, b]) => Number(a.primary) - Number(b.primary)).map(([v]) => v);
+      this.#primaryFields = Object.entries(fields).filter(([, v]) => v.primary).sort(([, a], [, b]) => Number(a.primary) - Number(b.primary));
       if (noBuild) {
         this.#build = null;
       } else if (typeof options[Build] === 'function') {
@@ -5326,17 +5448,13 @@ class Query extends Subquery {
     this.#options.where = [...this.#options.where, ...matches];
     return this;
   }
-  /** @type {string | number | bigint | object | undefined} */
-  #primary;
   /**
-   * @param {any} [primary]
+   * @param {...any | any[]} primaries
    * @returns {this}
    */
-  primary(primary) {
-    if (this.#primary) {
-      return this;
-    }
-    if (!primary) {
+  primary(...primaries) {
+    const primary = primaries?.flat();
+    if (!primary.length) {
       return this;
     }
     const primaryFields = this.#primaryFields;
@@ -5344,27 +5462,26 @@ class Query extends Subquery {
       return this;
     }
     if (primaryFields.length === 1) {
-      const [field] = primaryFields;
-      const m = this.where(field, '=', primary);
-      m.#primary = primary;
-      return m;
+      const [[field]] = primaryFields;
+      return this.where(field, 'in', primary);
     }
-    if (typeof primary === 'object') {
-      let m = this;
-      for (const p of primaryFields) {
-        m = m.where(p, '=', primary[p]);
+    const list = primary.map(primary => {
+      if (typeof primary === 'object') {
+        return primaryFields.map(([p]) => primary[p]);
       }
-      m.#primary = primary;
-      return m;
-    }
-    const values = `${primary}`.split('$');
-    if (values.length !== primaryFields.length) ;
-    let m = this;
-    for (let i = 0; i < primaryFields.length; i++) {
-      m = m.where(primaryFields[i], '=', values[i]);
-    }
-    m.#primary = primary;
-    return m;
+      const values = `${primary}`.split('$');
+      if (values.length !== primaryFields.length) ;
+      return primaryFields.map(([, {
+        type
+      }], i) => {
+        const value = values[i] ?? null;
+        if (type !== 'bool' || value === null) {
+          return value;
+        }
+        return toBool(value);
+      });
+    });
+    return this.where(primaryFields.map(f => f[0]), 'in', list);
   }
   /**
    *
@@ -6510,7 +6627,8 @@ class Scene {
       return {
         ...table,
         table: tableMap.table,
-        fields: this.#cloneField(table.fields, tableMap)
+        fields: this.#cloneField(table.fields, tableMap),
+        scene: this
         // TODO: 索引？
       };
     }
@@ -6550,6 +6668,19 @@ class Scene {
   table(table) {
     return this.#getModel(table);
   }
+  /**
+   * @template {TableDefine<Fields, string>} T
+   * @param {{scene?: Scene} | Scene} source
+   * @param {T} table
+   * @returns {T}
+   */
+  static table(source, table) {
+    const scene = source instanceof Scene ? source : source?.scene;
+    if (!(scene instanceof Scene)) {
+      return table;
+    }
+    return scene.table(table);
+  }
 }
 
 /** @import { FieldDefine, FieldDefineOption, MainFieldType, ToType } from './types' */
@@ -6702,4 +6833,4 @@ function field(type, {
   };
 }
 
-export { Build, Connection, Create, Destroy, Model, PseudoDestroy, Query, Save, Scene, Submodel, Where, afterCreate, afterCreateMany, afterDelete, afterUpdate, beforeCreate, beforeCreateMany, beforeDelete, beforeUpdate, bindHooks, coefficient, column, creating, decrement, defaultValue, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, hooks, immutable, increment, index, isDevelopment, isPseudo, mergeHooks, model, multiply, now, primary, prop, pseudo, setDevelopment, sort, model as submodel, toNot, toPrimaries, toPrimary, uncreatable, undeleted, updating, uuid, values, where, withDeleted };
+export { Build, Connection, Create, Destroy, Model, PseudoDestroy, Query, Save, Scene, Submodel, Where, afterCreate, afterCreateMany, afterDelete, afterUpdate, beforeCreate, beforeCreateMany, beforeDelete, beforeUpdate, bindHooks, coefficient, column, creating, decrement, defaultValue, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, hooks, immutable, increment, index, isDevelopment, isPseudo, mergeHooks, model, multiply, now, primary, prop, pseudo, setDevelopment, sort, model as submodel, toBool, toNot, toPrimaries, toPrimary, uncreatable, undeleted, updating, uuid, values, where, withDeleted };

package/migrate.d.mts

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.18.0
+ * imodel v0.19.1
  * (c) 2019-2026 undefined
  * @license undefined
  */

package/migrate.mjs

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.18.0
+ * imodel v0.19.1
  * (c) 2019-2026 undefined
  * @license undefined
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imodel",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "main": "index.mjs",
   "type": "module",
   "repository": {