@arcaelas/dynamite 1.0.29 → 3.1.0

package/build/cjs/core/decorator.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @file decorator.ts
+ * @description Minimal decorator system with Symbol storage
+ * @description Sistema de decoradores minimalista con Symbol storage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA = void 0;
+exports.getSchema = getSchema;
+exports.decorator = decorator;
+exports.SCHEMA = Symbol('dynamite:schema');
+function toSnakePlural(str) {
+    const snake = str
+        .replace(/([A-Z])/g, "_$1")
+        .toLowerCase()
+        .replace(/^_/, "");
+    return snake.endsWith("s") ? snake : snake + "s";
+}
+/**
+ * @description Get (or lazily create) the Schema bound to a model class, with columns and hooks initialized.
+ * @description Obtiene (o crea perezosamente) el Schema asociado a una clase de modelo, con columns y hooks inicializados.
+ * @param ctor Model class constructor / Constructor de la clase del modelo
+ */
+function getSchema(ctor) {
+    if (!Object.prototype.hasOwnProperty.call(ctor, exports.SCHEMA)) {
+        ctor[exports.SCHEMA] = {
+            name: toSnakePlural(ctor.name),
+            primary_key: 'id',
+            gsis: new Set(),
+            hooks: { beforeCreate: [], afterCreate: [], beforeUpdate: [], afterUpdate: [], beforeDestroy: [], afterDestroy: [] },
+            columns: {},
+        };
+    }
+    return ctor[exports.SCHEMA];
+}
+function resolve(target, propertyKey) {
+    const schema = getSchema(target.constructor);
+    const key = String(propertyKey);
+    schema.columns[key] ||= { name: key, get: [], set: [], store: {} };
+    return [schema, schema.columns[key]];
+}
+/**
+ * @description Factory to create decorators with argument support and composition
+ * @description Factory para crear decoradores con soporte de argumentos y composición
+ */
+function decorator(callback) {
+    return (...params) => (target, propertyKey) => {
+        const [, col] = resolve(target, propertyKey);
+        callback(target.constructor, col, params);
+    };
+}
+//# sourceMappingURL=decorator.js.map

package/build/cjs/core/decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.js","sourceRoot":"","sources":["../../../src/core/decorator.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAuDH,8BAWC;AAaD,8BAKC;AAlFY,QAAA,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAwChD,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,KAAK,GAAG,GAAG;SACd,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,IAAS;IACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,cAAM,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,cAAM,CAAC,GAAG;YACb,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,WAAW,EAAE,IAAI;YACjB,IAAI,EAAE,IAAI,GAAG,EAAU;YACvB,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;YACpH,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,cAAM,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,OAAO,CAAC,MAAW,EAAE,WAA4B;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAChC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,QAAmF;IAC3G,OAAO,CAAC,GAAG,MAAa,EAAE,EAAE,CAAC,CAAC,MAAW,EAAE,WAA4B,EAAE,EAAE;QACzE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7C,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC"}

package/build/cjs/core/table.d.ts

@@ -0,0 +1,73 @@
+import type { InferAttributes, PickByType, QueryOperator, WhereOptions } from "../@types/index";
+import { TransactionContext } from "./client";
+import type { Schema } from "./decorator";
+import { SCHEMA } from "./decorator";
+type WhereFilters<M> = {
+    [K in keyof InferAttributes<M>]?: InferAttributes<M>[K] | {
+        [N in QueryOperator]?: InferAttributes<M>[K];
+    };
+};
+/**
+ * @description Lifecycle hook signature. `this` is the model instance; update hooks receive the changes delta.
+ * @description Firma de un hook de ciclo de vida. `this` es la instancia del modelo; los hooks de update reciben el delta de cambios.
+ */
+export type HookFn<T = any> = (this: T, changes?: Partial<InferAttributes<T>>) => void | Promise<void>;
+/**
+ * @description Options for mutation operations. `hook` is opt-in (default false); `tx` runs the operation inside a transaction.
+ * @description Opciones para operaciones de mutación. `hook` es opt-in (default false); `tx` ejecuta la operación dentro de una transacción.
+ */
+export interface MutationOptions {
+    hook?: boolean;
+    tx?: TransactionContext;
+}
+export default class Table<T = any> {
+    static [SCHEMA]: Schema;
+    constructor(props?: Partial<T>);
+    toJSON(): Record<string, unknown>;
+    /**
+     * @description Convierte la instancia a un payload listo para DynamoDB
+     * @returns Objeto con nombres de columnas de DB y valores apropiados
+     */
+    private _toDBPayload;
+    toString(): string;
+    save(options?: MutationOptions): Promise<boolean>;
+    update(data: Partial<InferAttributes<T>>, options?: MutationOptions): Promise<boolean>;
+    destroy(options?: MutationOptions): Promise<null>;
+    forceDestroy(options?: MutationOptions): Promise<null>;
+    attach<R>(RelatedModel: new () => R, related_id: string, pivot_data?: Record<string, any>): Promise<void>;
+    detach<R>(RelatedModel: new () => R, related_id: string): Promise<void>;
+    /**
+     * Sincronizar relación ManyToMany reemplazando todas las relaciones existentes
+     * @param RelatedModel Modelo relacionado
+     * @param related_ids Array de IDs a sincronizar
+     */
+    sync<R>(RelatedModel: new () => R, related_ids: string[]): Promise<void>;
+    /**
+     * @description Run the registered hooks of a given type on an instance, in declaration order.
+     * @description Ejecuta los hooks registrados de un tipo dado sobre una instancia, en orden de declaración.
+     */
+    private static _run_hooks;
+    static create<M extends Table>(this: new (data: any) => M, data: Partial<InferAttributes<M>>, options?: MutationOptions): Promise<M>;
+    /**
+     * @description Extract PK value from filters if the filter is a simple PK equality. Returns null otherwise.
+     * @description Extrae el valor de PK de los filtros si es una igualdad simple por PK. Retorna null en otro caso.
+     */
+    private static _extractPK;
+    static update<M extends Table>(this: new (data: any) => M, updates: Partial<InferAttributes<M>>, filters: Partial<InferAttributes<M>>, options?: MutationOptions): Promise<number>;
+    static delete<M extends Table>(this: new (data: any) => M, filters: Partial<InferAttributes<M>>, options?: MutationOptions): Promise<number>;
+    /**
+     * @description Atomically increment a numeric field by amount. Uses DynamoDB SET expression.
+     * @description Incrementa atómicamente un campo numérico. Usa expresión SET de DynamoDB.
+     */
+    private static _atomicAdd;
+    static increment<M extends Table>(this: new (data: any) => M, field: keyof PickByType<InferAttributes<M>, number>, amount: number, filters: WhereFilters<M>, options?: MutationOptions): Promise<number>;
+    static decrement<M extends Table>(this: new (data: any) => M, field: keyof PickByType<InferAttributes<M>, number>, amount: number, filters: WhereFilters<M>, options?: MutationOptions): Promise<number>;
+    increment<K extends keyof PickByType<InferAttributes<T>, number>>(field: K, amount?: number): Promise<void>;
+    decrement<K extends keyof PickByType<InferAttributes<T>, number>>(field: K, amount?: number): Promise<void>;
+    static where<M extends Table>(this: new (props?: any) => M, key: keyof InferAttributes<M>, value: InferAttributes<M>[typeof key], options?: WhereOptions<M>): Promise<M[]>;
+    static where<M extends Table>(this: new (props?: any) => M, key: keyof InferAttributes<M>, operator: QueryOperator, value: any, options?: WhereOptions<M>): Promise<M[]>;
+    static where<M extends Table>(this: new (props?: any) => M, filters: WhereFilters<M>, options?: WhereOptions<M>): Promise<M[]>;
+    static first<M extends Table>(this: new (props?: any) => M, filters: WhereFilters<M>, options?: WhereOptions<M>): Promise<M | undefined>;
+    static last<M extends Table>(this: new (props?: any) => M, filters?: WhereFilters<M>, options?: WhereOptions<M>): Promise<M | undefined>;
+}
+export {};