@arcaelas/dynamite 1.0.29 → 2.1.0

package/src/decorators/indexes.d.ts

@@ -1,38 +0,0 @@
-/**
- * @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 const PrimaryKey: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;

package/src/decorators/indexes.js

@@ -1,59 +0,0 @@
-"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.PrimaryKey = exports.IndexSort = exports.Index = void 0;
-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;
- * }
- * ```
- */
-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/timestamps.d.ts

@@ -1,54 +0,0 @@
-/**
- * @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 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> {
- *   @PrimaryKey() id: string;
- *   @CreatedAt() created_at: string;
- * }
- * ```
- */
-export declare const CreatedAt: (...params: any[]) => (target: any, propertyKey: string | symbol) => void;
-/**
- * @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> {
- *   @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

@@ -1,72 +0,0 @@
-"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 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> {
- *   @PrimaryKey() id: string;
- *   @CreatedAt() created_at: string;
- * }
- * ```
- */
-exports.CreatedAt = (0, decorator_1.decorator)((_schema, col) => {
-    // 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 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> {
- *   @PrimaryKey() id: string;
- *   name: string;
- *   @UpdatedAt() updated_at: string;
- * }
- * ```
- */
-exports.UpdatedAt = (0, decorator_1.decorator)((_schema, col) => {
-    // 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.
- * 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

@@ -1,99 +0,0 @@
-/**
- * @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 usando pipeline de getter
- * @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 (se ejecuta en el setter)
- * @param validators Función o array de funciones validadoras
- * @example
- * ```typescript
- * class User extends Table<User> {
- *   @Validate((v) => v.length > 0 || 'Email requerido')
- *   declare email: string;
- *
- *   @Validate([isEmail, isNotEmpty])
- *   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;
-/**
- * @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/transforms.js

@@ -1,166 +0,0 @@
-"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.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 usando pipeline de getter
- * @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];
-    // Usar pipeline de getter con ?? para valores nullish
-    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((current, next) => fn(next));
-});
-/**
- * @description Decorador para validar valores (se ejecuta en el setter)
- * @param validators Función o array de funciones validadoras
- * @example
- * ```typescript
- * class User extends Table<User> {
- *   @Validate((v) => v.length > 0 || 'Email requerido')
- *   declare email: string;
- *
- *   @Validate([isEmail, isNotEmpty])
- *   declare email2: string;
- * }
- * ```
- */
-exports.Validate = (0, decorator_1.decorator)((_schema, col, params) => {
-    const validators = params[0];
-    const list = Array.isArray(validators) ? validators : [validators];
-    if (!list.length || list.some((v) => typeof v !== 'function')) {
-        throw new TypeError('@Validate requiere funciones');
-    }
-    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 next;
-    });
-});
-/**
- * @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((current, next) => next !== null && next !== undefined ? toDB(next) : next);
-});
-/**
- * @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, params) => {
-    const custom_message = params[0];
-    col.store.nullable = false;
-    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(custom_message || `El campo ${col.name} no puede estar vacío`);
-        }
-        return next;
-    });
-});
-/**
- * @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 = ctor[decorator_1.SCHEMA];
-        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;
-        }
-    };
-}
-/**
- * @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.test.js

@@ -1,37 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("./index");
-class User extends index_1.Table {
-}
-__decorate([
-    (0, index_1.PrimaryKey)(),
-    (0, index_1.Default)(() => crypto.randomUUID()),
-    __metadata("design:type", Object)
-], User.prototype, "id", void 0);
-__decorate([
-    (0, index_1.Default)(() => "customer"),
-    __metadata("design:type", Object)
-], User.prototype, "role", void 0);
-__decorate([
-    (0, index_1.CreatedAt)(),
-    __metadata("design:type", Object)
-], User.prototype, "created_at", void 0);
-__decorate([
-    (0, index_1.UpdatedAt)(),
-    __metadata("design:type", Object)
-], User.prototype, "updated_at", void 0);
-(async function () {
-    const dynamite = new index_1.Dynamite({ tables: [User] });
-    await dynamite.connect();
-    console.log("Connected successfully");
-})();
-//# sourceMappingURL=index.test.js.map