hysteria-orm 11.0.6 → 11.0.8

package/lib/index.d.cts

@@ -2072,15 +2072,15 @@ declare class ModelManager<T extends Model> {
     /**
      * @description Finds all records that match the input
      */
-    find<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input?: FindType<T, S, R>): Promise<ModelWithoutRelations<T>[]>;
+    find<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input?: FindType<T, S, R>): Promise<FindReturnType<T, S, R>[]>;
     /**
      * @description Finds the first record that matches the input
      */
-    findOne<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<ModelWithoutRelations<T> | null>;
+    findOne<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<FindReturnType<T, S, R> | null>;
     /**
      * @description Finds the first record that matches the input or throws an error
      */
-    findOneOrFail<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<ModelWithoutRelations<T>>;
+    findOneOrFail<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<FindReturnType<T, S, R>>;
     /**
      * @description Finds a record by its primary key
      * @description Ignores all model hooks
@@ -3287,6 +3287,16 @@ type ColumnOptions = {
      * @description Per-column validators applied on insert/update
      */
     validate?: Validator | Validator[];
+    /**
+     * @description MySQL/MariaDB only: declare the numeric column as UNSIGNED
+     * @migration Only affects auto-generated migrations
+     */
+    unsigned?: boolean;
+    /**
+     * @description MySQL/MariaDB only: declare the numeric column with ZEROFILL display attribute
+     * @migration Only affects auto-generated migrations
+     */
+    zerofill?: boolean;
 } & 
 /**
  * @description The data type of the column
@@ -3312,6 +3322,7 @@ type ColumnType = {
     withTimezone?: boolean;
     unsigned?: boolean;
     zerofill?: boolean;
+    stringMode?: boolean;
     constraints?: {
         nullable?: boolean;
         default?: string | number | null | boolean;
@@ -4680,6 +4691,7 @@ type TableColumnInfo = {
     enumValues?: string[] | null;
     unsigned?: boolean | null;
     zerofill?: boolean | null;
+    stringMode?: boolean | null;
 };
 type TableIndexInfo = {
     name: string;
@@ -4870,6 +4882,7 @@ declare const SQL_DATA_SOURCE_SYMBOL: unique symbol;
 declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}> extends DataSource {
     private readonly [SQL_DATA_SOURCE_SYMBOL];
     private globalTransaction;
+    private globalTransactionLock;
     private sqlType;
     private ownsPool;
     static isSqlDataSource(value: unknown): value is SqlDataSource;
@@ -4907,10 +4920,18 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      */
     inputDetails: SqlDataSourceInput<D, T, C>;
     /**
-     * @description Unique identifier shared across all clones of the same logical data source.
-     * Used to verify ALS transactions belong to this instance.
+     * @description Per-construction UUID. May be shared with clones produced by
+     * clone() (legacy behavior, preserved for backward compatibility).
+     * For ALS scope checks, use logicalSourceId.
      */
     id: string;
+    /**
+     * Shared across all clones of the same logical data source.
+     * Used by the ALS transaction guard to verify that a propagated
+     * transaction belongs to the same logical source as the calling
+     * instance (not necessarily the same instance).
+     */
+    logicalSourceId: string;
     /**
      * @description Whether AsyncLocalStorage (CLS) transaction auto-propagation is enabled.
      */
@@ -5144,6 +5165,9 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
     /**
      * @description Starts a global transaction on the database
      * @description Intended for testing purposes - wraps all operations in a transaction that can be rolled back
+     * @description Concurrent calls serialize: the second caller waits for the
+     * @description first to settle, then rejects with GLOBAL_TRANSACTION_ALREADY_STARTED
+     * @description if a global transaction is still active.
      */
     startGlobalTransaction(options?: StartTransactionOptions): Promise<Transaction>;
     /**
@@ -6169,15 +6193,15 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     /**
      * @description Finds multiple records.
      */
-    find<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input?: FindType<T, MK, MR>): Promise<ModelWithoutRelations<T>[]>;
+    find<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input?: FindType<T, MK, MR>): Promise<FindReturnType<T, MK, MR>[]>;
     /**
      * @description Finds a single record.
      */
-    findOne<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<ModelWithoutRelations<T> | null>;
+    findOne<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<FindReturnType<T, MK, MR> | null>;
     /**
      * @description Finds a single record or throws.
      */
-    findOneOrFail<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<ModelWithoutRelations<T>>;
+    findOneOrFail<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<FindReturnType<T, MK, MR>>;
     /**
      * @description Finds a single record by primary key.
      */

package/lib/index.d.ts

@@ -2072,15 +2072,15 @@ declare class ModelManager<T extends Model> {
     /**
      * @description Finds all records that match the input
      */
-    find<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input?: FindType<T, S, R>): Promise<ModelWithoutRelations<T>[]>;
+    find<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input?: FindType<T, S, R>): Promise<FindReturnType<T, S, R>[]>;
     /**
      * @description Finds the first record that matches the input
      */
-    findOne<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<ModelWithoutRelations<T> | null>;
+    findOne<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<FindReturnType<T, S, R> | null>;
     /**
      * @description Finds the first record that matches the input or throws an error
      */
-    findOneOrFail<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<ModelWithoutRelations<T>>;
+    findOneOrFail<S extends ModelKey<T>[] = never[], R extends ModelRelation<T>[] = never[]>(input: FindOneType<T, S, R>): Promise<FindReturnType<T, S, R>>;
     /**
      * @description Finds a record by its primary key
      * @description Ignores all model hooks
@@ -3287,6 +3287,16 @@ type ColumnOptions = {
      * @description Per-column validators applied on insert/update
      */
     validate?: Validator | Validator[];
+    /**
+     * @description MySQL/MariaDB only: declare the numeric column as UNSIGNED
+     * @migration Only affects auto-generated migrations
+     */
+    unsigned?: boolean;
+    /**
+     * @description MySQL/MariaDB only: declare the numeric column with ZEROFILL display attribute
+     * @migration Only affects auto-generated migrations
+     */
+    zerofill?: boolean;
 } & 
 /**
  * @description The data type of the column
@@ -3312,6 +3322,7 @@ type ColumnType = {
     withTimezone?: boolean;
     unsigned?: boolean;
     zerofill?: boolean;
+    stringMode?: boolean;
     constraints?: {
         nullable?: boolean;
         default?: string | number | null | boolean;
@@ -4680,6 +4691,7 @@ type TableColumnInfo = {
     enumValues?: string[] | null;
     unsigned?: boolean | null;
     zerofill?: boolean | null;
+    stringMode?: boolean | null;
 };
 type TableIndexInfo = {
     name: string;
@@ -4870,6 +4882,7 @@ declare const SQL_DATA_SOURCE_SYMBOL: unique symbol;
 declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}> extends DataSource {
     private readonly [SQL_DATA_SOURCE_SYMBOL];
     private globalTransaction;
+    private globalTransactionLock;
     private sqlType;
     private ownsPool;
     static isSqlDataSource(value: unknown): value is SqlDataSource;
@@ -4907,10 +4920,18 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      */
     inputDetails: SqlDataSourceInput<D, T, C>;
     /**
-     * @description Unique identifier shared across all clones of the same logical data source.
-     * Used to verify ALS transactions belong to this instance.
+     * @description Per-construction UUID. May be shared with clones produced by
+     * clone() (legacy behavior, preserved for backward compatibility).
+     * For ALS scope checks, use logicalSourceId.
      */
     id: string;
+    /**
+     * Shared across all clones of the same logical data source.
+     * Used by the ALS transaction guard to verify that a propagated
+     * transaction belongs to the same logical source as the calling
+     * instance (not necessarily the same instance).
+     */
+    logicalSourceId: string;
     /**
      * @description Whether AsyncLocalStorage (CLS) transaction auto-propagation is enabled.
      */
@@ -5144,6 +5165,9 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
     /**
      * @description Starts a global transaction on the database
      * @description Intended for testing purposes - wraps all operations in a transaction that can be rolled back
+     * @description Concurrent calls serialize: the second caller waits for the
+     * @description first to settle, then rejects with GLOBAL_TRANSACTION_ALREADY_STARTED
+     * @description if a global transaction is still active.
      */
     startGlobalTransaction(options?: StartTransactionOptions): Promise<Transaction>;
     /**
@@ -6169,15 +6193,15 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     /**
      * @description Finds multiple records.
      */
-    find<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input?: FindType<T, MK, MR>): Promise<ModelWithoutRelations<T>[]>;
+    find<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input?: FindType<T, MK, MR>): Promise<FindReturnType<T, MK, MR>[]>;
     /**
      * @description Finds a single record.
      */
-    findOne<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<ModelWithoutRelations<T> | null>;
+    findOne<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<FindReturnType<T, MK, MR> | null>;
     /**
      * @description Finds a single record or throws.
      */
-    findOneOrFail<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<ModelWithoutRelations<T>>;
+    findOneOrFail<MK extends ModelKey<T>[] = never[], MR extends ModelRelation<T>[] = never[]>(input: FindOneType<T, MK, MR>): Promise<FindReturnType<T, MK, MR>>;
     /**
      * @description Finds a single record by primary key.
      */