@zhin.js/database 1.0.4 → 1.0.6

package/lib/base/model.js

@@ -1,13 +1,129 @@
+/** 默认软删除字段名 */
+const DEFAULT_DELETED_AT = 'deletedAt';
+/** 默认创建时间字段名 */
+const DEFAULT_CREATED_AT = 'createdAt';
+/** 默认更新时间字段名 */
+const DEFAULT_UPDATED_AT = 'updatedAt';
 /**
  * 基础模型抽象类
  * 定义所有模型类型的通用接口和行为
+ * 支持软删除、自动时间戳和生命周期钩子
  */
 export class Model {
     database;
     name;
-    constructor(database, name) {
+    /** 模型配置选项 */
+    options;
+    /** 生命周期钩子注册表 */
+    hooks = new Map();
+    constructor(database, name, options) {
         this.database = database;
         this.name = name;
+        this.options = options ?? {};
+    }
+    // ============================================================================
+    // Lifecycle Hooks
+    // ============================================================================
+    /**
+     * 注册生命周期钩子
+     * @param hookName 钩子名称
+     * @param fn 钩子函数
+     * @returns this（支持链式调用）
+     *
+     * @example
+     * ```ts
+     * userModel
+     *   .addHook('beforeCreate', (ctx) => {
+     *     ctx.data.createdBy = 'system';
+     *   })
+     *   .addHook('afterDelete', async (ctx) => {
+     *     await logService.log('User deleted', ctx.result);
+     *   });
+     * ```
+     */
+    addHook(hookName, fn) {
+        const fns = this.hooks.get(hookName) ?? [];
+        fns.push(fn);
+        this.hooks.set(hookName, fns);
+        return this;
+    }
+    /**
+     * addHook 的别名
+     */
+    on(hookName, fn) {
+        return this.addHook(hookName, fn);
+    }
+    /**
+     * 批量注册钩子
+     * @example
+     * ```ts
+     * userModel.registerHooks({
+     *   beforeCreate: (ctx) => { ... },
+     *   afterUpdate: [(ctx) => { ... }, (ctx) => { ... }]
+     * });
+     * ```
+     */
+    registerHooks(hooks) {
+        for (const [name, fn] of Object.entries(hooks)) {
+            if (Array.isArray(fn)) {
+                fn.forEach(f => this.addHook(name, f));
+            }
+            else if (fn) {
+                this.addHook(name, fn);
+            }
+        }
+        return this;
+    }
+    /**
+     * 移除指定钩子
+     */
+    removeHook(hookName, fn) {
+        if (!fn) {
+            this.hooks.delete(hookName);
+        }
+        else {
+            const fns = this.hooks.get(hookName);
+            if (fns) {
+                const index = fns.indexOf(fn);
+                if (index > -1) {
+                    fns.splice(index, 1);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * 清除所有钩子
+     */
+    clearHooks() {
+        this.hooks.clear();
+        return this;
+    }
+    /**
+     * 触发钩子
+     * @returns 如果任何 before 钩子返回 false，则返回 false
+     */
+    async runHooks(hookName, context) {
+        const fns = this.hooks.get(hookName);
+        if (!fns || fns.length === 0)
+            return true;
+        for (const fn of fns) {
+            const result = await fn(context);
+            // before 钩子返回 false 可以取消操作
+            if (hookName.startsWith('before') && result === false) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 创建钩子上下文
+     */
+    createHookContext(options = {}) {
+        return {
+            modelName: String(this.name),
+            ...options
+        };
     }
     /**
      * 获取数据库方言
@@ -27,21 +143,126 @@ export class Model {
     get modelName() {
         return this.name;
     }
+    /**
+     * 是否启用软删除
+     */
+    get isSoftDelete() {
+        return this.options.softDelete === true;
+    }
+    /**
+     * 软删除字段名
+     */
+    get deletedAtField() {
+        return this.options.deletedAtField ?? DEFAULT_DELETED_AT;
+    }
     alter(alterations) {
         return this.database.alter(this.name, alterations);
     }
+    /**
+     * 查询（软删除模式下自动排除已删除记录）
+     */
     select(...fields) {
+        const selection = this.database.select(this.name, fields);
+        // 软删除模式下自动添加条件
+        if (this.isSoftDelete) {
+            selection.where({ [this.deletedAtField]: null });
+        }
+        return selection;
+    }
+    /**
+     * 查询（包含已删除的记录）
+     */
+    selectWithTrashed(...fields) {
         return this.database.select(this.name, fields);
     }
+    /**
+     * 仅查询已删除的记录
+     */
+    selectOnlyTrashed(...fields) {
+        const selection = this.database.select(this.name, fields);
+        selection.where({ [this.deletedAtField]: { $ne: null } });
+        return selection;
+    }
     insert(data) {
+        // 自动添加时间戳
+        if (this.options.timestamps) {
+            const now = new Date();
+            const createdAtField = this.options.createdAtField ?? DEFAULT_CREATED_AT;
+            const updatedAtField = this.options.updatedAtField ?? DEFAULT_UPDATED_AT;
+            data[createdAtField] = now;
+            data[updatedAtField] = now;
+        }
         return this.database.insert(this.name, data);
     }
     update(update) {
-        return this.database.update(this.name, update);
+        // 自动更新时间戳
+        if (this.options.timestamps) {
+            const updatedAtField = this.options.updatedAtField ?? DEFAULT_UPDATED_AT;
+            update[updatedAtField] = new Date();
+        }
+        const updation = this.database.update(this.name, update);
+        // 软删除模式下只更新未删除的记录
+        if (this.isSoftDelete) {
+            updation.where({ [this.deletedAtField]: null });
+        }
+        return updation;
     }
+    /**
+     * 删除（软删除模式下执行软删除）
+     */
     delete(condition) {
+        if (this.isSoftDelete) {
+            // 软删除：UPDATE SET deletedAt = NOW()
+            return this.database.update(this.name, {
+                [this.deletedAtField]: new Date()
+            }).where(condition);
+        }
         return this.database.delete(this.name, condition);
     }
+    /**
+     * 强制删除（忽略软删除，直接物理删除）
+     */
+    forceDelete(condition) {
+        return this.database.delete(this.name, condition);
+    }
+    /**
+     * 恢复软删除的记录
+     */
+    restore(condition) {
+        if (!this.isSoftDelete) {
+            throw new Error(`Model ${String(this.name)} does not have soft delete enabled`);
+        }
+        return this.database.update(this.name, {
+            [this.deletedAtField]: null
+        }).where(condition);
+    }
+    /**
+     * 批量插入
+     */
+    insertMany(data) {
+        // 自动添加时间戳
+        if (this.options.timestamps) {
+            const now = new Date();
+            const createdAtField = this.options.createdAtField ?? DEFAULT_CREATED_AT;
+            const updatedAtField = this.options.updatedAtField ?? DEFAULT_UPDATED_AT;
+            data.forEach(item => {
+                item[createdAtField] = now;
+                item[updatedAtField] = now;
+            });
+        }
+        return this.database.insertMany(this.name, data);
+    }
+    /**
+     * 聚合查询
+     */
+    aggregate() {
+        const agg = this.database.aggregate(this.name);
+        // 软删除模式下自动排除已删除记录
+        if (this.isSoftDelete) {
+            agg.where({ [this.deletedAtField]: null });
+        }
+        return agg;
+    }
     /**
      * 验证查询条件
      */
@@ -58,7 +279,7 @@ export class Model {
      * 处理错误
      */
     handleError(error, operation) {
-        const message = `Model ${this.name} ${operation} failed: ${error.message}`;
+        const message = `Model ${String(this.name)} ${operation} failed: ${error.message}`;
         throw new Error(message);
     }
 }

package/lib/base/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/base/model.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,OAAgB,KAAK;IAEP;IACA;IAFlB,YACkB,QAA6B,EAC7B,IAAY;QADZ,aAAQ,GAAR,QAAQ,CAAqB;QAC7B,SAAI,GAAJ,IAAI,CAAQ;IAC3B,CAAC;IAEJ;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,WAA+B;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAI,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,CAAoB,GAAG,MAAgB;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAO,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,IAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,MAAkB;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,SAAuB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IACD;;OAEG;IACO,aAAa,CAAC,KAAU;QAChC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;IAC/C,CAAC;IAED;;OAEG;IACO,YAAY,CAAC,IAAS;QAC9B,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,CAAC;IAC7C,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,KAAY,EAAE,SAAiB;QACnD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,IAAI,IAAI,SAAS,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/base/model.ts"],"names":[],"mappings":"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"}

package/lib/base/query-classes.d.ts

@@ -1,68 +1,239 @@
 import type { Database } from './database.js';
 import { ThenableQuery } from './thenable.js';
-import { QueryParams, AlterDefinition, Condition, Definition } from '../types.js';
-export declare class Alteration<T extends object, C = any, D = string> extends ThenableQuery<void, C, D> {
+import { QueryParams, AlterDefinition, Condition, Ordering, Definition, Subquery, JoinType } from '../types.js';
+/** 软删除查询模式 */
+export type SoftDeleteMode = 'default' | 'withTrashed' | 'onlyTrashed';
+export declare class Alteration<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<void, S, T, C, D> {
     private readonly tableName;
     private readonly alterations;
-    constructor(database: Database<C, Record<string, object>, D>, tableName: string, alterations: AlterDefinition<T>);
-    protected getQueryParams(): QueryParams<T>;
+    constructor(database: Database<C, S, D>, tableName: T, alterations: AlterDefinition<S[T]>);
+    protected getQueryParams(): QueryParams<S, T>;
 }
-export declare class DroppingTable<T extends object = any, C = any, D = string> extends ThenableQuery<number, C, D> {
+export declare class DroppingTable<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<number, S, T, C, D> {
     private readonly tableName;
     private conditions;
-    constructor(database: Database<C, Record<string, object>, any>, tableName: string);
-    where(query: Condition<T>): this;
-    protected getQueryParams(): QueryParams<T>;
+    constructor(database: Database<C, S, any>, tableName: T);
+    where(query: Condition<S[T]>): this;
+    protected getQueryParams(): QueryParams<S, T>;
 }
-export declare class DroppingIndex<C = any, D = string> extends ThenableQuery<number, C, D> {
+export declare class DroppingIndex<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<number, S, T, C, D> {
     private readonly indexName;
     private readonly tableName;
     private conditions;
-    constructor(database: Database<C, Record<string, object>, D>, indexName: string, tableName: string);
-    where(query: Condition<any>): this;
-    protected getQueryParams(): QueryParams<any>;
+    constructor(database: Database<C, S, D>, indexName: string, tableName: T);
+    where(query: Condition<S[T]>): this;
+    protected getQueryParams(): QueryParams<S, T>;
 }
-export declare class Creation<T extends object, C = any, D = string> extends ThenableQuery<void, C, D> {
+export declare class Creation<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<void, S, T, C, D> {
     private readonly tableName;
     private readonly definition;
-    constructor(database: Database<C, Record<string, object>, D>, tableName: string, definition: Definition<T>);
-    protected getQueryParams(): QueryParams<T>;
+    constructor(database: Database<C, S, D>, tableName: T, definition: Definition<S[T]>);
+    protected getQueryParams(): QueryParams<S, T>;
 }
-export declare class Selection<T extends object, K extends keyof T, C = any, D = string> extends ThenableQuery<Pick<T, K>[], C, D> {
+/**
+ * SELECT 查询类
+ * 实现 Subquery<S[T][K]> 以支持类型安全的子查询
+ *
+ * @template S Schema 类型
+ * @template T 表名
+ * @template K 选择的字段
+ * @template C 连接类型
+ * @template D 方言类型
+ *
+ * @example
+ * ```ts
+ * // 子查询类型推断示例
+ * interface Schema {
+ *   users: { id: number; name: string };
+ *   orders: { id: number; userId: number; amount: number };
+ * }
+ *
+ * // ✅ 正确：userId 是 number，匹配 users.id
+ * db.select('users', ['id']).where({
+ *   id: { $in: db.select('orders', ['userId']) }
+ * });
+ *
+ * // ❌ 类型错误：name 是 string，不能与 number 的 id 匹配
+ * db.select('users', ['id']).where({
+ *   id: { $in: db.select('users', ['name']) }  // Type error!
+ * });
+ * ```
+ */
+export declare class Selection<S extends Record<string, object>, T extends keyof S, K extends keyof S[T], C = any, D = string> extends ThenableQuery<Pick<S[T], K>[], S, T, C, D> implements Subquery<S[T][K]> {
+    protected readonly modelName: T;
+    protected readonly fields: Array<K>;
+    readonly __isSubquery: true;
+    readonly __returnType?: S[T][K];
+    protected conditions: Condition<S[T]>;
+    protected groupings: (keyof S[T])[];
+    protected orderings: Ordering<S[T]>[];
+    protected limitCount?: number;
+    protected offsetCount?: number;
+    constructor(database: Database<C, S, D>, modelName: T, fields: Array<K>);
+    where(query: Condition<S[T]>): this;
+    groupBy(...fields: (keyof S[T])[]): this;
+    orderBy(field: keyof S[T], direction?: "ASC" | "DESC"): this;
+    limit(count: number): this;
+    offset(count: number): this;
+    /**
+     * INNER JOIN - 只返回两表都有匹配的行
+     * 返回类型扩展为包含关联表字段
+     *
+     * @example
+     * ```ts
+     * const result = await db.select('users', ['id', 'name'])
+     *   .join('orders', 'id', 'userId');
+     * // result 类型: { users: { id, name }, orders: { id, userId, amount } }[]
+     * ```
+     */
+    join<J extends keyof S>(table: J, leftField: keyof S[T], rightField: keyof S[J]): JoinedSelection<S, T, K, J, C, D>;
+    /**
+     * LEFT JOIN - 返回左表所有行，右表无匹配则为 NULL
+     */
+    leftJoin<J extends keyof S>(table: J, leftField: keyof S[T], rightField: keyof S[J]): JoinedSelection<S, T, K, J, C, D, true>;
+    /**
+     * RIGHT JOIN - 返回右表所有行，左表无匹配则为 NULL
+     */
+    rightJoin<J extends keyof S>(table: J, leftField: keyof S[T], rightField: keyof S[J]): JoinedSelection<S, T, K, J, C, D, false, true>;
+    /**
+     * 转换为子查询 SQL
+     * 用于 $in / $nin 等操作符中嵌套查询
+     */
+    toSQL(): {
+        sql: string;
+        params: any[];
+    };
+    protected getQueryParams(): QueryParams<S, T>;
+}
+/**
+ * JOIN 结果类型 - 根据表名命名空间化
+ */
+type JoinResult<S extends Record<string, object>, T extends keyof S, K extends keyof S[T], J extends keyof S, LeftNullable extends boolean = false, RightNullable extends boolean = false> = {
+    [P in T]: LeftNullable extends true ? Partial<Pick<S[T], K>> : Pick<S[T], K>;
+} & {
+    [P in J]: RightNullable extends true ? Partial<S[J]> | null : S[J];
+};
+/**
+ * JOIN 查询类 - 支持类型安全的关联查询
+ *
+ * @template S Schema 类型
+ * @template T 主表名
+ * @template K 主表选择的字段
+ * @template J 关联表名
+ * @template LeftNullable LEFT JOIN 时主表可能为 null
+ * @template RightNullable RIGHT JOIN 时关联表可能为 null
+ */
+export declare class JoinedSelection<S extends Record<string, object>, T extends keyof S, K extends keyof S[T], J extends keyof S, C = any, D = string, LeftNullable extends boolean = false, RightNullable extends boolean = false> extends ThenableQuery<JoinResult<S, T, K, J, LeftNullable, RightNullable>[], S, T, C, D> {
     private readonly modelName;
     private readonly fields;
     private conditions;
-    private groupings;
     private orderings;
+    private groupings;
     private limitCount?;
     private offsetCount?;
-    constructor(database: Database<C, Record<string, object>, D>, modelName: string, fields: Array<K>);
-    where(query: Condition<T>): this;
-    groupBy(...fields: (keyof T)[]): this;
-    orderBy(field: keyof T, direction?: "ASC" | "DESC"): this;
+    private joinClauses;
+    constructor(database: Database<C, S, D>, modelName: T, fields: Array<K>, joinTable: J, joinType: JoinType, leftField: keyof S[T], rightField: keyof S[J], conditions?: Condition<S[T]>, orderings?: Ordering<S[T]>[], groupings?: (keyof S[T])[], limitCount?: number | undefined, offsetCount?: number | undefined);
+    where(query: Condition<S[T]>): this;
+    orderBy(field: keyof S[T], direction?: "ASC" | "DESC"): this;
     limit(count: number): this;
     offset(count: number): this;
-    protected getQueryParams(): QueryParams<T>;
+    /**
+     * 继续 JOIN 更多表
+     */
+    join<J2 extends keyof S>(table: J2, leftField: keyof S[T], rightField: keyof S[J2]): this;
+    leftJoin<J2 extends keyof S>(table: J2, leftField: keyof S[T], rightField: keyof S[J2]): this;
+    rightJoin<J2 extends keyof S>(table: J2, leftField: keyof S[T], rightField: keyof S[J2]): this;
+    protected getQueryParams(): QueryParams<S, T>;
 }
-export declare class Insertion<T extends object, C = any, D = string> extends ThenableQuery<T, C, D> {
+export declare class Insertion<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<S[T], S, T, C, D> {
     private readonly modelName;
     private readonly data;
-    constructor(database: Database<C, Record<string, object>, D>, modelName: string, data: T);
-    protected getQueryParams(): QueryParams<T>;
+    constructor(database: Database<C, S, D>, modelName: T, data: S[T]);
+    protected getQueryParams(): QueryParams<S, T>;
 }
-export declare class Updation<T extends object, C = any, D = string> extends ThenableQuery<number, C, D> {
+export declare class Updation<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<number, S, T, C, D> {
     private readonly modelName;
     private readonly update;
     private conditions;
-    constructor(database: Database<C, Record<string, object>, D>, modelName: string, update: Partial<T>);
-    where(query: Condition<T>): this;
-    protected getQueryParams(): QueryParams<T>;
+    constructor(database: Database<C, S, D>, modelName: T, update: Partial<S[T]>);
+    where(query: Condition<S[T]>): this;
+    protected getQueryParams(): QueryParams<S, T>;
 }
-export declare class Deletion<T extends object = any, C = any, D = string> extends ThenableQuery<number, C, D> {
+export declare class Deletion<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<S[T][], S, T, C, D> {
     private readonly modelName;
     private conditions;
-    constructor(database: Database<C, Record<string, object>, D>, modelName: string);
-    where(query: Condition<T>): this;
-    protected getQueryParams(): QueryParams<T>;
+    constructor(database: Database<C, S, D>, modelName: T);
+    where(query: Condition<S[T]>): this;
+    protected getQueryParams(): QueryParams<S, T>;
+}
+/**
+ * 批量插入查询类
+ */
+export declare class BatchInsertion<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<{
+    affectedRows: number;
+    insertIds?: (number | string)[];
+}, S, T, C, D> {
+    private readonly modelName;
+    private readonly data;
+    constructor(database: Database<C, S, D>, modelName: T, data: S[T][]);
+    then<TResult1 = {
+        affectedRows: number;
+        insertIds?: (number | string)[];
+    }, TResult2 = never>(onfulfilled?: ((value: {
+        affectedRows: number;
+        insertIds?: (number | string)[];
+    }) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+    protected getQueryParams(): QueryParams<S, T>;
+}
+/**
+ * 聚合查询结果类型
+ */
+export interface AggregateResult {
+    [key: string]: number | string | null;
+}
+/**
+ * 聚合查询类
+ */
+export declare class Aggregation<S extends Record<string, object>, T extends keyof S, C = any, D = string> extends ThenableQuery<AggregateResult[], S, T, C, D> {
+    private readonly modelName;
+    private conditions;
+    private groupings;
+    private havingConditions;
+    private aggregates;
+    constructor(database: Database<C, S, D>, modelName: T);
+    /**
+     * COUNT 聚合
+     */
+    count(field?: keyof S[T] | '*', alias?: string): this;
+    /**
+     * SUM 聚合
+     */
+    sum(field: keyof S[T], alias?: string): this;
+    /**
+     * AVG 聚合
+     */
+    avg(field: keyof S[T], alias?: string): this;
+    /**
+     * MIN 聚合
+     */
+    min(field: keyof S[T], alias?: string): this;
+    /**
+     * MAX 聚合
+     */
+    max(field: keyof S[T], alias?: string): this;
+    /**
+     * WHERE 条件
+     */
+    where(query: Condition<S[T]>): this;
+    /**
+     * GROUP BY
+     */
+    groupBy(...fields: (keyof S[T])[]): this;
+    /**
+     * HAVING 条件（用于聚合后的过滤）
+     */
+    having(query: Condition<S[T]>): this;
+    protected getQueryParams(): QueryParams<S, T>;
 }
+export {};
 //# sourceMappingURL=query-classes.d.ts.map

package/lib/base/query-classes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-classes.d.ts","sourceRoot":"","sources":["../../src/base/query-classes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query-classes.d.ts","sourceRoot":"","sources":["../../src/base/query-classes.ts"],"names":[],"mappings":"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"}