@arcaelas/dynamite 1.0.15 → 1.0.18

package/src/decorators/indexes.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * @file indexes.ts
+ * @description Decoradores de índices con Symbol storage
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexSort = exports.Index = void 0;
+exports.PrimaryKey = PrimaryKey;
+const decorator_1 = require("../core/decorator");
+/**
+ * @description Decorador para marcar propiedad como Partition Key
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Index() id: string;
+ * }
+ * ```
+ */
+exports.Index = (0, decorator_1.decorator)((_schema, col) => {
+    col.store.index = true;
+    col.store.nullable = col.store.nullable ?? false;
+});
+/**
+ * @description Decorador para marcar propiedad como Sort Key
+ * @example
+ * ```typescript
+ * class Post extends Table<Post> {
+ *   @Index() user_id: string;
+ *   @IndexSort() created_at: string;
+ * }
+ * ```
+ */
+exports.IndexSort = (0, decorator_1.decorator)((_schema, col) => {
+    col.store.indexSort = true;
+    col.store.nullable = col.store.nullable ?? false;
+});
+/**
+ * @description Decorador para marcar una propiedad como clave primaria
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   name: string;
+ * }
+ * ```
+ */
+function PrimaryKey() {
+    return (target, prop) => {
+        const table_class = target.constructor;
+        const column_name = String(prop);
+        const schema = (0, decorator_1.ensureSchema)(table_class);
+        // Crear columna si no existe
+        if (!schema.columns[column_name]) {
+            schema.columns[column_name] = { name: column_name, get: [], set: [], store: {} };
+        }
+        // Configurar como primary key
+        Object.assign(schema.columns[column_name].store, {
+            index: true,
+            primaryKey: true,
+            nullable: false
+        });
+        schema.primary_key = column_name;
+    };
+}
+//# sourceMappingURL=indexes.js.map

package/src/decorators/relations.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @file relations.ts
+ * @description Decoradores de relaciones: @HasMany, @HasOne, @BelongsTo
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+/**
+ * @description Decorador para relaciones uno a muchos (1:N)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param foreignKey Clave foránea en el modelo relacionado
+ * @param localKey Clave local (por defecto 'id')
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *
+ *   @HasMany(() => Post, 'id_user', 'id')
+ *   declare posts: HasMany<Post>;
+ * }
+ * ```
+ */
+export declare const HasMany: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para relaciones uno a uno (1:1)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param foreignKey Clave foránea en el modelo relacionado
+ * @param localKey Clave local (por defecto 'id')
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *
+ *   @HasOne(() => Profile, 'id_user', 'id')
+ *   declare profile: HasOne<Profile>;
+ * }
+ * ```
+ */
+export declare const HasOne: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para relaciones muchos a uno (N:1)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param localKey Clave local que referencia al modelo padre
+ * @param foreignKey Clave en el modelo padre (por defecto 'id')
+ * @example
+ * ```typescript
+ * class Post extends Table<Post> {
+ *   @PrimaryKey() id: string;
+ *   id_user: string;
+ *
+ *   @BelongsTo(() => User, 'id_user', 'id')
+ *   declare author: BelongsTo<User>;
+ * }
+ * ```
+ */
+export declare const BelongsTo: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;

package/src/decorators/relations.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * @file relations.ts
+ * @description Decoradores de relaciones: @HasMany, @HasOne, @BelongsTo
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BelongsTo = exports.HasOne = exports.HasMany = void 0;
+const decorator_1 = require("../core/decorator");
+/**
+ * @description Decorador para relaciones uno a muchos (1:N)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param foreignKey Clave foránea en el modelo relacionado
+ * @param localKey Clave local (por defecto 'id')
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *
+ *   @HasMany(() => Post, 'id_user', 'id')
+ *   declare posts: HasMany<Post>;
+ * }
+ * ```
+ */
+exports.HasMany = (0, decorator_1.decorator)((_schema, col, params) => {
+    const [model, foreignKey, localKey = 'id'] = params;
+    col.store.relation = {
+        type: 'HasMany',
+        model,
+        foreignKey,
+        localKey
+    };
+});
+/**
+ * @description Decorador para relaciones uno a uno (1:1)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param foreignKey Clave foránea en el modelo relacionado
+ * @param localKey Clave local (por defecto 'id')
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *
+ *   @HasOne(() => Profile, 'id_user', 'id')
+ *   declare profile: HasOne<Profile>;
+ * }
+ * ```
+ */
+exports.HasOne = (0, decorator_1.decorator)((_schema, col, params) => {
+    const [model, foreignKey, localKey = 'id'] = params;
+    col.store.relation = {
+        type: 'HasOne',
+        model,
+        foreignKey,
+        localKey
+    };
+});
+/**
+ * @description Decorador para relaciones muchos a uno (N:1)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param localKey Clave local que referencia al modelo padre
+ * @param foreignKey Clave en el modelo padre (por defecto 'id')
+ * @example
+ * ```typescript
+ * class Post extends Table<Post> {
+ *   @PrimaryKey() id: string;
+ *   id_user: string;
+ *
+ *   @BelongsTo(() => User, 'id_user', 'id')
+ *   declare author: BelongsTo<User>;
+ * }
+ * ```
+ */
+exports.BelongsTo = (0, decorator_1.decorator)((_schema, col, params) => {
+    const [model, localKey, foreignKey = 'id'] = params;
+    col.store.relation = {
+        type: 'BelongsTo',
+        model,
+        foreignKey,
+        localKey
+    };
+});
+//# sourceMappingURL=relations.js.map

package/src/decorators/timestamps.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file timestamps.ts
+ * @description Decoradores de timestamps: @CreatedAt, @UpdatedAt, @DeleteAt
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+/**
+ * @description Decorador que establece automáticamente la fecha/hora de creación.
+ * El valor se genera solo si no existe uno previo.
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   @CreatedAt() created_at: string;
+ * }
+ * ```
+ */
+export declare const CreatedAt: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador que marca una propiedad para que se actualice automáticamente
+ * con la fecha/hora actual cada vez que se guarde el modelo.
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   name: string;
+ *   @UpdatedAt() updated_at: string;
+ * }
+ * ```
+ */
+export declare const UpdatedAt: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador que marca una propiedad como columna de soft delete.
+ * Cuando se llama destroy(), en lugar de eliminar el registro,
+ * se establece esta columna con la fecha/hora actual.
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   name: string;
+ *   @DeleteAt() deleted_at?: string;
+ * }
+ *
+ * // Soft delete (marca deleted_at con timestamp)
+ * await user.destroy();
+ *
+ * // Queries normales excluyen soft deleted
+ * await User.where({ status: "active" });
+ *
+ * // Incluir soft deleted
+ * await User.withTrashed({ status: "active" });
+ * ```
+ */
+export declare const DeleteAt: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;

package/src/decorators/timestamps.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * @file timestamps.ts
+ * @description Decoradores de timestamps: @CreatedAt, @UpdatedAt, @DeleteAt
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteAt = exports.UpdatedAt = exports.CreatedAt = void 0;
+const decorator_1 = require("../core/decorator");
+/**
+ * @description Decorador que establece automáticamente la fecha/hora de creación.
+ * El valor se genera solo si no existe uno previo.
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   @CreatedAt() created_at: string;
+ * }
+ * ```
+ */
+exports.CreatedAt = (0, decorator_1.decorator)((_schema, col) => {
+    col.store.createdAt = true;
+    col.get.push((value) => value ?? new Date().toISOString());
+});
+/**
+ * @description Decorador que marca una propiedad para que se actualice automáticamente
+ * con la fecha/hora actual cada vez que se guarde el modelo.
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   name: string;
+ *   @UpdatedAt() updated_at: string;
+ * }
+ * ```
+ */
+exports.UpdatedAt = (0, decorator_1.decorator)((_schema, col) => {
+    col.store.updatedAt = true;
+});
+/**
+ * @description Decorador que marca una propiedad como columna de soft delete.
+ * Cuando se llama destroy(), en lugar de eliminar el registro,
+ * se establece esta columna con la fecha/hora actual.
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   name: string;
+ *   @DeleteAt() deleted_at?: string;
+ * }
+ *
+ * // Soft delete (marca deleted_at con timestamp)
+ * await user.destroy();
+ *
+ * // Queries normales excluyen soft deleted
+ * await User.where({ status: "active" });
+ *
+ * // Incluir soft deleted
+ * await User.withTrashed({ status: "active" });
+ * ```
+ */
+exports.DeleteAt = (0, decorator_1.decorator)((_schema, col) => {
+    col.store.softDelete = true;
+    col.store.nullable = true;
+});
+//# sourceMappingURL=timestamps.js.map

package/src/decorators/transforms.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @file transforms.ts
+ * @description Decoradores de transformación con pipelines directas
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+/**
+ * @description Decorador para establecer valor por defecto
+ * @param factory Valor por defecto o función que lo genera
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Default(uuid)
+ *   declare id: string;
+ *
+ *   @Default(() => 0)
+ *   declare score: number;
+ * }
+ * ```
+ */
+export declare const Default: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para transformar valores en cada asignación
+ * @param fn Función de transformación
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Mutate((v) => v.toLowerCase())
+ *   declare email: string;
+ * }
+ * ```
+ */
+export declare const Mutate: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para validar valores
+ * @param validators Función o array de funciones validadoras
+ * @param options Opciones de validación (lazy: true para validar en save())
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Validate((v) => v.length > 0 || 'Email requerido')
+ *   declare email: string;
+ *
+ *   @Validate([isEmail, isNotEmpty], { lazy: true })
+ *   declare email2: string;
+ * }
+ * ```
+ */
+export declare const Validate: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para transformar valores entre DB y aplicación
+ * @param fromDB Función que transforma al leer de DB
+ * @param toDB Función que transforma al guardar en DB
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Serialize(JSON.parse, JSON.stringify)
+ *   declare metadata: Record<string, any>;
+ * }
+ * ```
+ */
+export declare const Serialize: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador que valida que el valor no sea null, undefined o string vacío
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @NotNull()
+ *   declare name: string;
+ * }
+ * ```
+ */
+export declare const NotNull: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador dual para renombrar tabla o columna
+ * @param label Nombre personalizado
+ * @example
+ * ```typescript
+ * @Name('usuarios')
+ * class User extends Table<User> {
+ *   @Name('user_email')
+ *   declare email: string;
+ * }
+ * ```
+ */
+export declare function Name(label: string): ClassDecorator & PropertyDecorator;

package/src/decorators/transforms.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * @file transforms.ts
+ * @description Decoradores de transformación con pipelines directas
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotNull = exports.Serialize = exports.Validate = exports.Mutate = exports.Default = void 0;
+exports.Name = Name;
+const decorator_1 = require("../core/decorator");
+/**
+ * @description Decorador para establecer valor por defecto
+ * @param factory Valor por defecto o función que lo genera
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Default(uuid)
+ *   declare id: string;
+ *
+ *   @Default(() => 0)
+ *   declare score: number;
+ * }
+ * ```
+ */
+exports.Default = (0, decorator_1.decorator)((_schema, col, params) => {
+    const fallback = params[0];
+    col.get.push((value) => value ?? (typeof fallback === 'function' ? fallback() : fallback));
+});
+/**
+ * @description Decorador para transformar valores en cada asignación
+ * @param fn Función de transformación
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Mutate((v) => v.toLowerCase())
+ *   declare email: string;
+ * }
+ * ```
+ */
+exports.Mutate = (0, decorator_1.decorator)((_schema, col, params) => {
+    const fn = params[0];
+    col.set.push((value) => fn(value));
+});
+/**
+ * @description Decorador para validar valores
+ * @param validators Función o array de funciones validadoras
+ * @param options Opciones de validación (lazy: true para validar en save())
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Validate((v) => v.length > 0 || 'Email requerido')
+ *   declare email: string;
+ *
+ *   @Validate([isEmail, isNotEmpty], { lazy: true })
+ *   declare email2: string;
+ * }
+ * ```
+ */
+exports.Validate = (0, decorator_1.decorator)((_schema, col, params) => {
+    const [validators, options] = params;
+    const list = Array.isArray(validators) ? validators : [validators];
+    const is_lazy = options?.lazy ?? false;
+    if (!list.length || list.some((v) => typeof v !== 'function')) {
+        throw new TypeError('@Validate requiere funciones');
+    }
+    if (is_lazy) {
+        col.store.lazy_validators = list;
+    }
+    else {
+        col.set.push((value) => {
+            for (const fn of list) {
+                const result = fn(value);
+                if (result !== true) {
+                    throw new Error(typeof result === 'string' ? result : 'Validación fallida');
+                }
+            }
+            return value;
+        });
+    }
+});
+/**
+ * @description Decorador para transformar valores entre DB y aplicación
+ * @param fromDB Función que transforma al leer de DB
+ * @param toDB Función que transforma al guardar en DB
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Serialize(JSON.parse, JSON.stringify)
+ *   declare metadata: Record<string, any>;
+ * }
+ * ```
+ */
+exports.Serialize = (0, decorator_1.decorator)((_schema, col, params) => {
+    const [fromDB, toDB] = params;
+    if (fromDB)
+        col.get.push((v) => v !== null && v !== undefined ? fromDB(v) : v);
+    if (toDB)
+        col.set.push((v) => v !== null && v !== undefined ? toDB(v) : v);
+});
+/**
+ * @description Decorador que valida que el valor no sea null, undefined o string vacío
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @NotNull()
+ *   declare name: string;
+ * }
+ * ```
+ */
+exports.NotNull = (0, decorator_1.decorator)((_schema, col) => {
+    col.store.nullable = false;
+    col.set.push((value) => {
+        const is_empty = value === null || value === undefined || (typeof value === 'string' && value.trim() === '');
+        if (is_empty) {
+            throw new Error(`El campo ${col.name} no puede estar vacío`);
+        }
+        return value;
+    });
+});
+/**
+ * @description Decorador dual para renombrar tabla o columna
+ * @param label Nombre personalizado
+ * @example
+ * ```typescript
+ * @Name('usuarios')
+ * class User extends Table<User> {
+ *   @Name('user_email')
+ *   declare email: string;
+ * }
+ * ```
+ */
+function Name(label) {
+    if (!label || typeof label !== 'string') {
+        throw new TypeError('@Name requiere una cadena no vacía');
+    }
+    return (target, prop) => {
+        const ctor = prop === undefined ? target : target.constructor;
+        const schema = (0, decorator_1.ensureSchema)(ctor);
+        if (prop === undefined) {
+            // @Name en clase - renombrar tabla
+            schema.name = label;
+        }
+        else {
+            // @Name en propiedad - renombrar columna
+            const column_name = String(prop);
+            if (!schema.columns[column_name]) {
+                schema.columns[column_name] = { name: column_name, get: [], set: [], store: {} };
+            }
+            schema.columns[column_name].name = label;
+        }
+    };
+}
+//# sourceMappingURL=transforms.js.map

package/src/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @file index.ts
+ * @description Punto de entrada público de la librería - Arquitectura Minimalista
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+export { Dynamite } from "./core/client";
+export { default as Table } from "./core/table";
+export { decorator, relationDecorator, SCHEMA, VALUES } from "./core/decorator";
+export { Index, IndexSort, PrimaryKey } from "./decorators/indexes";
+export { CreatedAt, UpdatedAt, DeleteAt } from "./decorators/timestamps";
+export { Default, Mutate, Validate, Serialize, NotNull, Name } from "./decorators/transforms";
+export { HasMany, BelongsTo, HasOne } from "./decorators/relations";
+export type { QueryOptions, IncludeRelationOptions, QueryOperator, } from "./core/table";
+export { TransactionContext } from "./core/client";

package/src/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * @file index.ts
+ * @description Punto de entrada público de la librería - Arquitectura Minimalista
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionContext = exports.HasOne = exports.BelongsTo = exports.HasMany = exports.Name = exports.NotNull = exports.Serialize = exports.Validate = exports.Mutate = exports.Default = exports.DeleteAt = exports.UpdatedAt = exports.CreatedAt = exports.PrimaryKey = exports.IndexSort = exports.Index = exports.VALUES = exports.SCHEMA = exports.relationDecorator = exports.decorator = exports.Table = exports.Dynamite = void 0;
+// Clases núcleo
+var client_1 = require("./core/client");
+Object.defineProperty(exports, "Dynamite", { enumerable: true, get: function () { return client_1.Dynamite; } });
+var table_1 = require("./core/table");
+Object.defineProperty(exports, "Table", { enumerable: true, get: function () { return __importDefault(table_1).default; } });
+// Factory para crear decoradores personalizados
+var decorator_1 = require("./core/decorator");
+Object.defineProperty(exports, "decorator", { enumerable: true, get: function () { return decorator_1.decorator; } });
+Object.defineProperty(exports, "relationDecorator", { enumerable: true, get: function () { return decorator_1.relationDecorator; } });
+Object.defineProperty(exports, "SCHEMA", { enumerable: true, get: function () { return decorator_1.SCHEMA; } });
+Object.defineProperty(exports, "VALUES", { enumerable: true, get: function () { return decorator_1.VALUES; } });
+// Decoradores - Índices
+var indexes_1 = require("./decorators/indexes");
+Object.defineProperty(exports, "Index", { enumerable: true, get: function () { return indexes_1.Index; } });
+Object.defineProperty(exports, "IndexSort", { enumerable: true, get: function () { return indexes_1.IndexSort; } });
+Object.defineProperty(exports, "PrimaryKey", { enumerable: true, get: function () { return indexes_1.PrimaryKey; } });
+// Decoradores - Timestamps
+var timestamps_1 = require("./decorators/timestamps");
+Object.defineProperty(exports, "CreatedAt", { enumerable: true, get: function () { return timestamps_1.CreatedAt; } });
+Object.defineProperty(exports, "UpdatedAt", { enumerable: true, get: function () { return timestamps_1.UpdatedAt; } });
+Object.defineProperty(exports, "DeleteAt", { enumerable: true, get: function () { return timestamps_1.DeleteAt; } });
+// Decoradores - Transformación
+var transforms_1 = require("./decorators/transforms");
+Object.defineProperty(exports, "Default", { enumerable: true, get: function () { return transforms_1.Default; } });
+Object.defineProperty(exports, "Mutate", { enumerable: true, get: function () { return transforms_1.Mutate; } });
+Object.defineProperty(exports, "Validate", { enumerable: true, get: function () { return transforms_1.Validate; } });
+Object.defineProperty(exports, "Serialize", { enumerable: true, get: function () { return transforms_1.Serialize; } });
+Object.defineProperty(exports, "NotNull", { enumerable: true, get: function () { return transforms_1.NotNull; } });
+Object.defineProperty(exports, "Name", { enumerable: true, get: function () { return transforms_1.Name; } });
+// Decoradores - Relaciones
+var relations_1 = require("./decorators/relations");
+Object.defineProperty(exports, "HasMany", { enumerable: true, get: function () { return relations_1.HasMany; } });
+Object.defineProperty(exports, "BelongsTo", { enumerable: true, get: function () { return relations_1.BelongsTo; } });
+Object.defineProperty(exports, "HasOne", { enumerable: true, get: function () { return relations_1.HasOne; } });
+// Re-exportar TransactionContext para compatibilidad
+var client_2 = require("./core/client");
+Object.defineProperty(exports, "TransactionContext", { enumerable: true, get: function () { return client_2.TransactionContext; } });
+//# sourceMappingURL=index.js.map

package/src/index.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file index.test.ts
+ * @description Suite de testing profesional para Dynamite ORM
+ * @features
+ *  - 12 fases de validación completa
+ *  - Métricas de performance
+ *  - Detección de memory leaks
+ *  - Tests de race conditions
+ *  - Validación de circular references
+ *  - Bulk operations
+ *  - Pipeline analysis
+ */
+import "reflect-metadata";