@arcaelas/dynamite 1.0.17 → 1.0.19

package/src/decorators/indexes.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @file indexes.ts
+ * @description Decoradores de índices con Symbol storage
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+/**
+ * @description Decorador para marcar propiedad como Partition Key
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @Index() id: string;
+ * }
+ * ```
+ */
+export declare const Index: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para marcar propiedad como Sort Key
+ * @example
+ * ```typescript
+ * class Post extends Table<Post> {
+ *   @Index() user_id: string;
+ *   @IndexSort() created_at: string;
+ * }
+ * ```
+ */
+export declare const IndexSort: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
+/**
+ * @description Decorador para marcar una propiedad como clave primaria
+ * @example
+ * ```typescript
+ * class User extends Table<User> {
+ *   @PrimaryKey() id: string;
+ *   name: string;
+ * }
+ * ```
+ */
+export declare function PrimaryKey(): PropertyDecorator;

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

@@ -1,22 +1,16 @@
 /**
  * @file index.ts
- * @descripcion Punto de entrada público de la librería
+ * @description Punto de entrada público de la librería - Arquitectura Minimalista
  * @autor Miguel Alejandro
- * @fecha 2025-08-07
+ * @fecha 2025-01-28
  */
 export { Dynamite } from "./core/client";
 export { default as Table } from "./core/table";
-export { default as BelongsTo } from "./decorators/belongs_to";
-export { default as CreatedAt } from "./decorators/created_at";
-export { default as Default } from "./decorators/default";
-export { default as HasMany } from "./decorators/has_many";
-export { default as Index } from "./decorators/index";
-export { default as IndexSort } from "./decorators/index_sort";
-export { default as Mutate } from "./decorators/mutate";
-export { default as Name } from "./decorators/name";
-export { default as NotNull } from "./decorators/not_null";
-export { default as PrimaryKey } from "./decorators/primary_key";
-export { default as UpdatedAt } from "./decorators/updated_at";
-export { default as Validate } from "./decorators/validate";
-export { belongsTo, hasMany } from "./utils/relations";
-export type { BelongsTo as BelongsToType, CreationOptional, FilterableAttributes, HasMany as HasManyType, InferAttributes, NonAttribute, QueryOperator, QueryResult, WhereOptions, WhereOptionsWithoutWhere, } from "./@types/index";
+export { decorator, relationDecorator, SCHEMA, VALUES } from "./core/decorator";
+export { Index, IndexSort, PrimaryKey } from "./decorators/indexes";
+export { CreatedAt, DeleteAt, UpdatedAt } from "./decorators/timestamps";
+export { Default, Mutate, Name, NotNull, Serialize, Validate, } from "./decorators/transforms";
+export { BelongsTo, HasMany, HasOne } from "./decorators/relations";
+export type { IncludeRelationOptions, QueryOperator, QueryOptions, } from "./core/table";
+export * from "./@types/index";
+export { TransactionContext } from "./core/client";