imodel 0.19.2 → 0.19.3

package/index.d.mts

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.19.2
+ * imodel v0.19.3
  * (c) 2019-2026 undefined
  * @license undefined
  */
@@ -508,10 +508,126 @@ type FieldDecorator<T> = (val: {
 }, ctx: ClassAccessorDecoratorContext) => any;
 type MethodDecorator<T extends Function> = (val: T, ctx: ClassMethodDecoratorContext<any, T>) => any;
 
+declare class ConnectionError extends Error {
+    /**
+     * @param {string} code - 自定义通用错误码 (例如 constraint:unique)
+     * @param {string} message - 原始错误信息或自定义信息
+     */
+    constructor(code: string, message: string);
+    /** @type {string} */
+    code: string;
+}
+/**
+ * 非空约束违规
+ * 对应 PG 23502 / MySQL 1048
+ * 场景：插入数据时，必填字段为空
+ */
+declare class NotNullViolationError extends ConnectionError {
+    /** @type {string} */
+    table: string;
+    /** @type {string} */
+    column: string;
+}
+/**
+ * 唯一性约束违规
+ * 对应 PG 23505 / MySQL 1062
+ * 支持单字段和多字段组合冲突
+ */
+declare class UniqueViolationError extends ConnectionError {
+    /**
+     * @param {string} table - 表名
+     * @param {string | string[]} columns - 冲突的列名（可以是字符串或字符串数组）
+     * @param {any} [values] - 导致冲突的值（可选，多字段时为对象或数组）
+     */
+    constructor(table: string, columns: string | string[], values?: any);
+    /** @type {string} */
+    table: string;
+    /** @type {string[]} */
+    columns: string[];
+    /** @type {any} */
+    values: any;
+}
+/**
+ * 外键约束违规
+ * 对应 PG 23503 / MySQL 1452
+ * 场景：插入了一个不存在的 user_id
+ */
+declare class ForeignKeyViolationError extends ConnectionError {
+    /**
+     * @param {string} table - 当前操作的表
+     * @param {string | string[]} columns - 当前操作的外键列
+     * @param {string} [referencedTable] - 被引用的父表
+     */
+    constructor(table: string, columns: string | string[], referencedTable?: string);
+    /** @type {string} */
+    table: string;
+    /** @type {string[]} */
+    columns: string[];
+    /** @type {string} */
+    referencedTable: string;
+}
+/**
+ * 检查约束违规
+ * 对应 PG 23514
+ * 场景：年龄字段要求 > 0，但插入了 -5
+ */
+declare class CheckViolationError extends ConnectionError {
+    /**
+     * @param {string} table - 当前操作的表
+     * @param {string} [constraint] - 当前操作的外键列
+     */
+    constructor(table: string, constraint?: string);
+    /** @type {string} */
+    table: string;
+    /** @type {string} */
+    constraint: string;
+}
+/**
+ * 无效的类型输入语法错误
+ * 对应 PG 22P02
+ * 场景：无效的 UUID、日期格式错误等
+ */
+declare class InvalidInputSyntaxError extends ConnectionError {
+    /**
+     * @param {string} message - 目标数据类型
+     */
+    constructor(message: string);
+}
+/**
+ * 操作符不匹配错误
+ * 对应 PG 42883
+ * 场景：uuid = integer 等类型不兼容的操作
+ */
+declare class OperatorMismatchError extends ConnectionError {
+    /**
+     * @param {string} message
+     */
+    constructor(message: string);
+}
+
+type errors_CheckViolationError = CheckViolationError;
+declare const errors_CheckViolationError: typeof CheckViolationError;
+type errors_ConnectionError = ConnectionError;
+declare const errors_ConnectionError: typeof ConnectionError;
+type errors_ForeignKeyViolationError = ForeignKeyViolationError;
+declare const errors_ForeignKeyViolationError: typeof ForeignKeyViolationError;
+type errors_InvalidInputSyntaxError = InvalidInputSyntaxError;
+declare const errors_InvalidInputSyntaxError: typeof InvalidInputSyntaxError;
+type errors_NotNullViolationError = NotNullViolationError;
+declare const errors_NotNullViolationError: typeof NotNullViolationError;
+type errors_OperatorMismatchError = OperatorMismatchError;
+declare const errors_OperatorMismatchError: typeof OperatorMismatchError;
+type errors_UniqueViolationError = UniqueViolationError;
+declare const errors_UniqueViolationError: typeof UniqueViolationError;
+declare namespace errors {
+  export { errors_CheckViolationError as CheckViolationError, errors_ConnectionError as ConnectionError, errors_ForeignKeyViolationError as ForeignKeyViolationError, errors_InvalidInputSyntaxError as InvalidInputSyntaxError, errors_NotNullViolationError as NotNullViolationError, errors_OperatorMismatchError as OperatorMismatchError, errors_UniqueViolationError as UniqueViolationError };
+}
+
 interface Environment<T extends object> {
     transaction: T | null;
     isDevelopment: boolean;
     values: typeof values;
+    errors: typeof errors;
 }
 
 /** 特性支持情况 */
@@ -2698,4 +2814,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 LockType, 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 TransactionHandler, type TransactionHandlerArray, 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 };
+export { Build, CheckViolationError, type ClassDecorator, type Column, type ColumnOptions, Connection, ConnectionError, 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, ForeignKeyViolationError, type GetName, type Hook, type Hooks, type IConnection, type Index, type IndexInfo, type IndexOptions, InvalidInputSyntaxError, type JOIN, type Join, type JoinType, type LockType, type MainFieldType, type MaybePromise, type MethodDecorator, Model, NotNullViolationError, OperatorMismatchError, 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 TransactionHandler, type TransactionHandlerArray, UniqueViolationError, 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.2
+ * imodel v0.19.3
  * (c) 2019-2026 undefined
  * @license undefined
  */
@@ -804,6 +804,162 @@ var values = /*#__PURE__*/Object.freeze({
     uuid: uuid
 });
 
+class ConnectionError extends Error {
+  /** @type {string} */
+
+  /**
+   * @param {string} code - 自定义通用错误码 (例如 constraint:unique)
+   * @param {string} message - 原始错误信息或自定义信息
+   */
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+}
+/**
+ * 非空约束违规
+ * 对应 PG 23502 / MySQL 1048
+ * 场景：插入数据时，必填字段为空
+ */
+class NotNullViolationError extends ConnectionError {
+  /** @type {string} */
+
+  /** @type {string} */
+
+  /**
+   * @param {string} table - 表名
+   * @param {string} column - 列名
+   */
+  constructor(table, column) {
+    const msg = `Column '${column}' in table '${table}' cannot be null`;
+    super('constraint:notNull', msg);
+    this.table = table;
+    this.column = column;
+  }
+}
+/**
+ * 唯一性约束违规
+ * 对应 PG 23505 / MySQL 1062
+ * 支持单字段和多字段组合冲突
+ */
+class UniqueViolationError extends ConnectionError {
+  /** @type {string} */
+
+  /** @type {string[]} */
+
+  /** @type {any} */
+
+  /**
+   * @param {string} table - 表名
+   * @param {string | string[]} columns - 冲突的列名（可以是字符串或字符串数组）
+   * @param {any} [values] - 导致冲突的值（可选，多字段时为对象或数组）
+   */
+  constructor(table, columns, values = undefined) {
+    // 确保 columns 始终是数组，方便后续处理
+    const cols = Array.isArray(columns) ? columns : [columns];
+    let msg = `Duplicate value for ${cols.join(', ')} in table '${table}'`;
+    if (values !== undefined) {
+      msg += ` (values: ${JSON.stringify(values)})`;
+    }
+    super('constraint:unique', msg);
+    this.table = table;
+    this.columns = cols;
+    this.values = values;
+  }
+}
+/**
+ * 外键约束违规
+ * 对应 PG 23503 / MySQL 1452
+ * 场景：插入了一个不存在的 user_id
+ */
+class ForeignKeyViolationError extends ConnectionError {
+  /** @type {string} */
+
+  /** @type {string[]} */
+
+  /** @type {string} */
+
+  /**
+   * @param {string} table - 当前操作的表
+   * @param {string | string[]} columns - 当前操作的外键列
+   * @param {string} [referencedTable] - 被引用的父表
+   */
+  constructor(table, columns, referencedTable) {
+    // 确保 columns 始终是数组，方便后续处理
+    const cols = Array.isArray(columns) ? columns : [columns];
+    let msg = `Foreign key constraint failed for column ${cols.join(', ')}`;
+    msg += ` in table '${table}'`;
+    if (referencedTable) {
+      msg += ` (references '${referencedTable}')`;
+    }
+    super('constraint:foreignKey', msg);
+    this.table = table;
+    this.columns = cols;
+    this.referencedTable = referencedTable || '';
+  }
+}
+/**
+ * 检查约束违规
+ * 对应 PG 23514
+ * 场景：年龄字段要求 > 0，但插入了 -5
+ */
+class CheckViolationError extends ConnectionError {
+  /** @type {string} */
+
+  /** @type {string} */
+
+  /**
+   * @param {string} table - 当前操作的表
+   * @param {string} [constraint] - 当前操作的外键列
+   */
+  constructor(table, constraint) {
+    let msg = `Check constraint failed in table '${table}'`;
+    if (constraint) {
+      msg += ` (${constraint})`;
+    }
+    super('constraint:check', msg);
+    this.table = table;
+    this.constraint = constraint || '';
+  }
+}
+/**
+ * 无效的类型输入语法错误
+ * 对应 PG 22P02
+ * 场景：无效的 UUID、日期格式错误等
+ */
+class InvalidInputSyntaxError extends ConnectionError {
+  /**
+   * @param {string} message - 目标数据类型
+   */
+  constructor(message) {
+    super('data:type:invalidInputSyntax', message);
+  }
+}
+/**
+ * 操作符不匹配错误
+ * 对应 PG 42883
+ * 场景：uuid = integer 等类型不兼容的操作
+ */
+class OperatorMismatchError extends ConnectionError {
+  /**
+   * @param {string} message
+   */
+  constructor(message) {
+    super('syntax:operator:mismatch', message);
+  }
+}
+
+var errors = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    CheckViolationError: CheckViolationError,
+    ConnectionError: ConnectionError,
+    ForeignKeyViolationError: ForeignKeyViolationError,
+    InvalidInputSyntaxError: InvalidInputSyntaxError,
+    NotNullViolationError: NotNullViolationError,
+    OperatorMismatchError: OperatorMismatchError,
+    UniqueViolationError: UniqueViolationError
+});
+
 /** @import { Options, Queryable } from '../types' */
 /**
  *
@@ -2638,6 +2794,13 @@ function toSelect(queryable, lockable) {
 
 /* eslint-disable max-lines */
 /* eslint-disable max-len */
+/** @import { Wheres } from '../Where.mjs' */
+/** @import { SetValue } from '../set.mjs' */
+/** @import { Environment, TableConnection, TableValue } from '../types' */
+/** @import { Fields, FieldType, FieldValue, IndexOptions, MainFieldType, TableDefine } from '../types/table' */
+/** @import { Queryable } from '../types/options' */
+/** @import { Column, ColumnOptions } from '../types/column' */
+/** @import { DBTable, IConnection, Skip, TableConnect, TableType, TransactionHandler } from '../types/connection' */
 /**
  *
  * @param {Fields<keyof FieldType>} fields
@@ -2696,7 +2859,8 @@ class Connection {
     this.#env = {
       isDevelopment,
       values,
-      transaction
+      transaction,
+      errors
     };
   }
   /**
@@ -3323,11 +3487,11 @@ class Connection {
   }, data, keys, conflictKeys, conflictSet) {
     const [columns, fieldColumns, baseFields] = toColumns(fields);
     const isArray = Array.isArray(data);
-    const insertValues = (isArray ? data : [data]
+    const insertValues = await Promise.all((isArray ? data : [data]
     // @ts-ignore
     ).map(d => getInsertValue(d, columns, fieldColumns, {
       uncreatable: true
-    }));
+    })));
     if (!insertValues.length) {
       throw new Error();
     }
@@ -6894,4 +7058,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, toBool, toNot, toPrimaries, toPrimary, uncreatable, undeleted, updating, uuid, values, where, withDeleted };
+export { Build, CheckViolationError, Connection, ConnectionError, Create, Destroy, ForeignKeyViolationError, InvalidInputSyntaxError, Model, NotNullViolationError, OperatorMismatchError, PseudoDestroy, Query, Save, Scene, Submodel, UniqueViolationError, 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.19.2
+ * imodel v0.19.3
  * (c) 2019-2026 undefined
  * @license undefined
  */

package/migrate.mjs

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

package/package.json

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