imodel 0.19.0 → 0.19.1

package/index.d.mts

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.19.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;
 }
 
@@ -2587,4 +2674,4 @@ declare function toBool(v: any): boolean;
 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, toBool, 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.19.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();

package/migrate.d.mts

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

package/migrate.mjs

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

package/package.json

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