@arcaelas/dynamite 1.0.18 → 1.0.23

package/src/{decorators → src/decorators}/indexes.d.ts

@@ -35,4 +35,4 @@ export declare const IndexSort: (...params: any[]) => (target: any, propertyKey:
  * }
  * ```
  */
-export declare function PrimaryKey(): PropertyDecorator;
+export declare const PrimaryKey: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;

package/src/{decorators → src/decorators}/indexes.js

@@ -6,8 +6,7 @@
  * @fecha 2025-01-28
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IndexSort = exports.Index = void 0;
-exports.PrimaryKey = PrimaryKey;
+exports.PrimaryKey = exports.IndexSort = exports.Index = void 0;
 const decorator_1 = require("../core/decorator");
 /**
  * @description Decorador para marcar propiedad como Partition Key
@@ -46,22 +45,15 @@ exports.IndexSort = (0, decorator_1.decorator)((_schema, col) => {
  * }
  * ```
  */
-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;
-    };
-}
+exports.PrimaryKey = (0, decorator_1.decorator)((table_class, col) => {
+    const schema = table_class[decorator_1.SCHEMA];
+    // Configurar como primary key
+    Object.assign(col.store, {
+        index: true,
+        primaryKey: true,
+        nullable: false
+    });
+    // Obtener nombre de columna desde col.name
+    schema.primary_key = col.name;
+});
 //# sourceMappingURL=indexes.js.map

package/src/{decorators → src/decorators}/relations.d.ts

@@ -1,6 +1,6 @@
 /**
  * @file relations.ts
- * @description Decoradores de relaciones: @HasMany, @HasOne, @BelongsTo
+ * @description Decoradores de relaciones: @HasMany, @HasOne, @BelongsTo, @ManyToMany
  * @autor Miguel Alejandro
  * @fecha 2025-01-28
  */
@@ -53,3 +53,22 @@ export declare const HasOne: (...params: any[]) => (target: any, propertyKey: st
  * ```
  */
 export declare const BelongsTo: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para relaciones muchos a muchos (N:M)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param pivotTable Nombre de la tabla pivot
+ * @param foreignKey Clave foránea en la tabla pivot que apunta al modelo actual
+ * @param relatedKey Clave foránea en la tabla pivot que apunta al modelo relacionado
+ * @param localKey Clave local (por defecto 'id')
+ * @param relatedPK Clave primaria del modelo relacionado (por defecto 'id')
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *
+ *   @ManyToMany(() => Role, 'users_roles', 'user_id', 'role_id')
+ *   declare roles: NonAttribute<Role[]>;
+ * }
+ * ```
+ */
+export declare const ManyToMany: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;

package/src/{decorators → src/decorators}/relations.js

@@ -1,12 +1,12 @@
 "use strict";
 /**
  * @file relations.ts
- * @description Decoradores de relaciones: @HasMany, @HasOne, @BelongsTo
+ * @description Decoradores de relaciones: @HasMany, @HasOne, @BelongsTo, @ManyToMany
  * @autor Miguel Alejandro
  * @fecha 2025-01-28
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BelongsTo = exports.HasOne = exports.HasMany = void 0;
+exports.ManyToMany = exports.BelongsTo = exports.HasOne = exports.HasMany = void 0;
 const decorator_1 = require("../core/decorator");
 /**
  * @description Decorador para relaciones uno a muchos (1:N)
@@ -81,4 +81,34 @@ exports.BelongsTo = (0, decorator_1.decorator)((_schema, col, params) => {
         localKey
     };
 });
+/**
+ * @description Decorador para relaciones muchos a muchos (N:M)
+ * @param model Función que retorna la clase del modelo relacionado
+ * @param pivotTable Nombre de la tabla pivot
+ * @param foreignKey Clave foránea en la tabla pivot que apunta al modelo actual
+ * @param relatedKey Clave foránea en la tabla pivot que apunta al modelo relacionado
+ * @param localKey Clave local (por defecto 'id')
+ * @param relatedPK Clave primaria del modelo relacionado (por defecto 'id')
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *
+ *   @ManyToMany(() => Role, 'users_roles', 'user_id', 'role_id')
+ *   declare roles: NonAttribute<Role[]>;
+ * }
+ * ```
+ */
+exports.ManyToMany = (0, decorator_1.decorator)((_schema, col, params) => {
+    const [model, pivotTable, foreignKey, relatedKey, localKey = 'id', relatedPK = 'id'] = params;
+    col.store.relation = {
+        type: 'ManyToMany',
+        model,
+        foreignKey,
+        relatedKey,
+        pivotTable,
+        localKey,
+        relatedPK
+    };
+});
 //# sourceMappingURL=relations.js.map

package/src/{decorators → src/decorators}/timestamps.d.ts

@@ -5,8 +5,8 @@
  * @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.
+ * @description Decorador que establece automáticamente la fecha/hora de creación usando pipelines.
+ * El valor se genera en el getter si no existe, y se preserva en el setter.
  * @example
  * ```typescript
  * class User extends Table<User> {
@@ -17,8 +17,8 @@
  */
 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.
+ * @description Decorador que actualiza automáticamente la fecha/hora en cada asignación usando pipelines.
+ * El timestamp se actualiza cada vez que se escribe en la propiedad.
  * @example
  * ```typescript
  * class User extends Table<User> {

package/src/{decorators → src/decorators}/timestamps.js

@@ -9,8 +9,8 @@ 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.
+ * @description Decorador que establece automáticamente la fecha/hora de creación usando pipelines.
+ * El valor se genera en el getter si no existe, y se preserva en el setter.
  * @example
  * ```typescript
  * class User extends Table<User> {
@@ -20,12 +20,14 @@ const decorator_1 = require("../core/decorator");
  * ```
  */
 exports.CreatedAt = (0, decorator_1.decorator)((_schema, col) => {
-    col.store.createdAt = true;
+    // Getter: asignar timestamp si no existe (solo primera vez)
     col.get.push((value) => value ?? new Date().toISOString());
+    // Setter: preservar valor si ya existe, ignorar intentos de cambio
+    col.set.push((current, next) => current ?? next ?? 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.
+ * @description Decorador que actualiza automáticamente la fecha/hora en cada asignación usando pipelines.
+ * El timestamp se actualiza cada vez que se escribe en la propiedad.
  * @example
  * ```typescript
  * class User extends Table<User> {
@@ -36,7 +38,10 @@ exports.CreatedAt = (0, decorator_1.decorator)((_schema, col) => {
  * ```
  */
 exports.UpdatedAt = (0, decorator_1.decorator)((_schema, col) => {
-    col.store.updatedAt = true;
+    // Getter: retornar valor actual o timestamp si no existe
+    col.get.push((value) => value ?? new Date().toISOString());
+    // Setter: siempre actualizar con nuevo timestamp (ignora el valor pasado)
+    col.set.push((_current, _next) => new Date().toISOString());
 });
 /**
  * @description Decorador que marca una propiedad como columna de soft delete.

package/src/{decorators → src/decorators}/transforms.d.ts

@@ -5,7 +5,7 @@
  * @fecha 2025-01-28
  */
 /**
- * @description Decorador para establecer valor por defecto
+ * @description Decorador para establecer valor por defecto usando pipeline de getter
  * @param factory Valor por defecto o función que lo genera
  * @example
  * ```typescript
@@ -32,16 +32,15 @@ export declare const Default: (...params: any[]) => (target: any, propertyKey: s
  */
 export declare const Mutate: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
 /**
- * @description Decorador para validar valores
+ * @description Decorador para validar valores (se ejecuta en el setter)
  * @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 })
+ *   @Validate([isEmail, isNotEmpty])
  *   declare email2: string;
  * }
  * ```
@@ -84,3 +83,17 @@ export declare const NotNull: (...params: any[]) => (target: any, propertyKey: s
  * ```
  */
 export declare function Name(label: string): ClassDecorator & PropertyDecorator;
+/**
+ * @description Decorador para marcar una propiedad como columna sin agregar comportamiento especial
+ * @example
+ * ```typescript
+ * class Product extends Table<Product> {
+ *   @Column()
+ *   price!: number;
+ *
+ *   @Column()
+ *   category_id!: string;
+ * }
+ * ```
+ */
+export declare const Column: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;

package/src/{decorators → src/decorators}/transforms.js

@@ -6,11 +6,11 @@
  * @fecha 2025-01-28
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotNull = exports.Serialize = exports.Validate = exports.Mutate = exports.Default = void 0;
+exports.Column = 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
+ * @description Decorador para establecer valor por defecto usando pipeline de getter
  * @param factory Valor por defecto o función que lo genera
  * @example
  * ```typescript
@@ -25,6 +25,7 @@ const decorator_1 = require("../core/decorator");
  */
 exports.Default = (0, decorator_1.decorator)((_schema, col, params) => {
     const fallback = params[0];
+    // Usar pipeline de getter con ?? para valores nullish
     col.get.push((value) => value ?? (typeof fallback === 'function' ? fallback() : fallback));
 });
 /**
@@ -40,44 +41,37 @@ exports.Default = (0, decorator_1.decorator)((_schema, col, params) => {
  */
 exports.Mutate = (0, decorator_1.decorator)((_schema, col, params) => {
     const fn = params[0];
-    col.set.push((value) => fn(value));
+    col.set.push((current, next) => fn(next));
 });
 /**
- * @description Decorador para validar valores
+ * @description Decorador para validar valores (se ejecuta en el setter)
  * @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 })
+ *   @Validate([isEmail, isNotEmpty])
  *   declare email2: string;
  * }
  * ```
  */
 exports.Validate = (0, decorator_1.decorator)((_schema, col, params) => {
-    const [validators, options] = params;
+    const validators = params[0];
     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');
-                }
+    col.set.push((current, next) => {
+        for (const fn of list) {
+            const result = fn(next);
+            if (result !== true) {
+                throw new Error(typeof result === 'string' ? result : 'Validación fallida');
             }
-            return value;
-        });
-    }
+        }
+        return next;
+    });
 });
 /**
  * @description Decorador para transformar valores entre DB y aplicación
@@ -96,7 +90,7 @@ exports.Serialize = (0, decorator_1.decorator)((_schema, col, 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);
+        col.set.push((current, next) => next !== null && next !== undefined ? toDB(next) : next);
 });
 /**
  * @description Decorador que valida que el valor no sea null, undefined o string vacío
@@ -108,14 +102,16 @@ exports.Serialize = (0, decorator_1.decorator)((_schema, col, params) => {
  * }
  * ```
  */
-exports.NotNull = (0, decorator_1.decorator)((_schema, col) => {
+exports.NotNull = (0, decorator_1.decorator)((_schema, col, params) => {
+    const custom_message = params[0];
     col.store.nullable = false;
-    col.set.push((value) => {
-        const is_empty = value === null || value === undefined || (typeof value === 'string' && value.trim() === '');
+    col.store.notNullMessage = custom_message;
+    col.set.push((current, next) => {
+        const is_empty = next === null || next === undefined || (typeof next === 'string' && next.trim() === '');
         if (is_empty) {
-            throw new Error(`El campo ${col.name} no puede estar vacío`);
+            throw new Error(custom_message || `El campo ${col.name} no puede estar vacío`);
         }
-        return value;
+        return next;
     });
 });
 /**
@@ -136,7 +132,7 @@ function Name(label) {
     }
     return (target, prop) => {
         const ctor = prop === undefined ? target : target.constructor;
-        const schema = (0, decorator_1.ensureSchema)(ctor);
+        const schema = ctor[decorator_1.SCHEMA];
         if (prop === undefined) {
             // @Name en clase - renombrar tabla
             schema.name = label;
@@ -151,4 +147,20 @@ function Name(label) {
         }
     };
 }
+/**
+ * @description Decorador para marcar una propiedad como columna sin agregar comportamiento especial
+ * @example
+ * ```typescript
+ * class Product extends Table<Product> {
+ *   @Column()
+ *   price!: number;
+ *
+ *   @Column()
+ *   category_id!: string;
+ * }
+ * ```
+ */
+exports.Column = (0, decorator_1.decorator)((_schema, _col) => {
+    // No hace nada, solo marca la propiedad como columna en schema.columns
+});
 //# sourceMappingURL=transforms.js.map

package/src/{index.d.ts → src/index.d.ts}

@@ -6,10 +6,10 @@
  */
 export { Dynamite } from "./core/client";
 export { default as Table } from "./core/table";
-export { decorator, relationDecorator, SCHEMA, VALUES } from "./core/decorator";
+export { decorator, relationDecorator, SCHEMA } 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 { Default, Mutate, Validate, Serialize, NotNull, Name, Column } from "./decorators/transforms";
+export { HasMany, BelongsTo, HasOne, ManyToMany } from "./decorators/relations";
+export type { NonAttribute, CreationOptional, InferAttributes, InferRelations, WhereOptions, QueryOperator, CreateInput, UpdateInput, PickRelations, } from "./@types/index";
 export { TransactionContext } from "./core/client";

package/src/{index.js → src/index.js}

@@ -9,7 +9,7 @@ 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;
+exports.TransactionContext = exports.ManyToMany = exports.HasOne = exports.BelongsTo = exports.HasMany = exports.Column = 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.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; } });
@@ -20,7 +20,6 @@ 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; } });
@@ -39,11 +38,13 @@ Object.defineProperty(exports, "Validate", { enumerable: true, get: function ()
 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; } });
+Object.defineProperty(exports, "Column", { enumerable: true, get: function () { return transforms_1.Column; } });
 // 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; } });
+Object.defineProperty(exports, "ManyToMany", { enumerable: true, get: function () { return relations_1.ManyToMany; } });
 // Re-exportar TransactionContext para compatibilidad
 var client_2 = require("./core/client");
 Object.defineProperty(exports, "TransactionContext", { enumerable: true, get: function () { return client_2.TransactionContext; } });

package/src/src/index.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file index.test.ts
+ * @description Test suite para Dynamite ORM
+ * @run tsx --tsconfig tsx.config.json src/index.test.ts
+ */
+export {};