@arcaelas/dynamite 1.0.25 → 2.1.0

package/build/esm/utils/relations.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file relations.ts
+ * @description Sistema de carga de relaciones con batch loading
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+/**
+ * @description Opciones para include de relaciones
+ */
+interface IncludeOptions {
+    where?: Record<string, any>;
+    attributes?: string[];
+    limit?: number;
+    offset?: number;
+    skip?: number;
+    order?: 'asc' | 'desc';
+    include?: Record<string, IncludeOptions | boolean>;
+}
+/**
+ * @description Procesa includes recursivamente para cargar relaciones con caché
+ * @param items Array de instancias a poblar
+ * @param include Objeto con relaciones a incluir
+ * @param TableClass Clase de la tabla actual
+ * @param depth Profundidad actual (máximo 5 para prevenir deep nesting)
+ * @param queryCache Caché de queries para evitar duplicados (opcional)
+ * @returns Items con relaciones pobladas
+ * @example
+ * ```typescript
+ * // Uso interno en Table.where()
+ * await processIncludes(users, {
+ *   posts: {
+ *     where: { published: true },
+ *     limit: 5,
+ *     include: {
+ *       comments: true
+ *     }
+ *   }
+ * }, User);
+ * ```
+ */
+export declare const processIncludes: (items: any[], include: Record<string, IncludeOptions | boolean>, TableClass: any, depth?: number, queryCache?: Map<string, Map<string, any>>) => Promise<any[]>;
+export {};

package/build/esm/utils/relations.js

@@ -0,0 +1,207 @@
+/**
+ * @file relations.ts
+ * @description Sistema de carga de relaciones con batch loading
+ * @autor Miguel Alejandro
+ * @fecha 2025-01-28
+ */
+import { ScanCommand } from "@aws-sdk/client-dynamodb";
+import { marshall, unmarshall } from "@aws-sdk/util-dynamodb";
+import { requireClient } from "../core/client.js";
+import { SCHEMA } from "../core/decorator.js";
+/**
+ * @description Batch load para HasMany/HasOne
+ * Obtiene items relacionados donde foreignKey IN parent_ids
+ */
+const batchLoadHasMany = async (items, relation, options = {}) => {
+    const parent_ids = items.map(i => i[relation.localKey]).filter(Boolean);
+    if (!parent_ids.length)
+        return new Map();
+    // Obtener clase del modelo relacionado
+    const RelatedModel = relation.model();
+    // Construir filtros combinados
+    const filters = {
+        [relation.foreignKey]: { $in: parent_ids },
+        ...options.where
+    };
+    // Query con todas las opciones aplicadas
+    const related = await RelatedModel.where(filters, {
+        attributes: options.attributes,
+        order: options.order?.toUpperCase(),
+        limit: undefined, // Se aplica después de agrupar
+        offset: undefined,
+    });
+    // Agrupar por foreignKey
+    const grouped = new Map();
+    for (const item of related) {
+        const key = String(item[relation.foreignKey]);
+        if (!grouped.has(key))
+            grouped.set(key, []);
+        grouped.get(key).push(item);
+    }
+    // Aplicar limit por grupo
+    if (options.limit) {
+        const offset = options.skip ?? options.offset ?? 0;
+        for (const [key, groupItems] of grouped) {
+            grouped.set(key, groupItems.slice(offset, offset + options.limit));
+        }
+    }
+    return grouped;
+};
+/**
+ * @description Batch load para BelongsTo
+ * Obtiene items donde id IN local_keys
+ */
+const batchLoadBelongsTo = async (items, relation, options = {}) => {
+    const local_keys = items.map(i => i[relation.localKey]).filter(Boolean);
+    if (!local_keys.length)
+        return new Map();
+    const RelatedModel = relation.model();
+    // Query con opciones aplicadas
+    const related = await RelatedModel.where({ [relation.foreignKey]: { $in: local_keys } }, { attributes: options.attributes });
+    const result = new Map();
+    for (const item of related) {
+        result.set(String(item[relation.foreignKey]), item);
+    }
+    return result;
+};
+/**
+ * @description Batch load para ManyToMany
+ * Obtiene items relacionados usando tabla pivot
+ */
+const batchLoadManyToMany = async (items, relation, options = {}) => {
+    const parent_ids = items.map(i => i[relation.localKey]).filter(Boolean);
+    if (!parent_ids.length)
+        return new Map();
+    const client = requireClient();
+    // [1] Query pivot table usando OR chain (DynamoDB no soporta IN nativo)
+    const or_conditions = parent_ids.map((_, i) => `#fk = :id${i}`).join(' OR ');
+    const pivot_result = await client.send(new ScanCommand({
+        TableName: relation.pivotTable,
+        FilterExpression: parent_ids.length > 0 ? `(${or_conditions})` : undefined,
+        ExpressionAttributeNames: { '#fk': relation.foreignKey },
+        ExpressionAttributeValues: marshall(parent_ids.reduce((acc, id, i) => ({ ...acc, [`:id${i}`]: id }), {}))
+    }));
+    const pivot_rows = (pivot_result.Items ?? []).map(item => unmarshall(item));
+    if (pivot_rows.length === 0)
+        return new Map();
+    // [2] Extract unique related IDs
+    const related_ids = [...new Set(pivot_rows.map(row => row[relation.relatedKey]))];
+    // [3] Batch load related models con opciones aplicadas
+    const RelatedModel = relation.model();
+    // Construir filtros combinados
+    const filters = {
+        [relation.relatedPK]: { $in: related_ids },
+        ...options.where
+    };
+    const related_items = await RelatedModel.where(filters, {
+        attributes: options.attributes,
+        order: options.order?.toUpperCase(),
+    });
+    // [5] Map related items by ID
+    const related_map = new Map(related_items.map((item) => [String(item[relation.relatedPK]), item]));
+    // [6] Group by parent ID using pivot as bridge
+    const grouped = new Map();
+    for (const pivot of pivot_rows) {
+        const parent_id = String(pivot[relation.foreignKey]);
+        const related_id = String(pivot[relation.relatedKey]);
+        const related_item = related_map.get(related_id);
+        if (related_item) {
+            if (!grouped.has(parent_id))
+                grouped.set(parent_id, []);
+            grouped.get(parent_id).push(related_item);
+        }
+    }
+    // [7] Apply limit per group
+    if (options.limit) {
+        const offset = options.skip ?? options.offset ?? 0;
+        for (const [key, items_arr] of grouped) {
+            grouped.set(key, items_arr.slice(offset, offset + options.limit));
+        }
+    }
+    return grouped;
+};
+/**
+ * @description Procesa includes recursivamente para cargar relaciones con caché
+ * @param items Array de instancias a poblar
+ * @param include Objeto con relaciones a incluir
+ * @param TableClass Clase de la tabla actual
+ * @param depth Profundidad actual (máximo 5 para prevenir deep nesting)
+ * @param queryCache Caché de queries para evitar duplicados (opcional)
+ * @returns Items con relaciones pobladas
+ * @example
+ * ```typescript
+ * // Uso interno en Table.where()
+ * await processIncludes(users, {
+ *   posts: {
+ *     where: { published: true },
+ *     limit: 5,
+ *     include: {
+ *       comments: true
+ *     }
+ *   }
+ * }, User);
+ * ```
+ */
+export const processIncludes = async (items, include, TableClass, depth = 0, queryCache = new Map()) => {
+    // Límite reducido de 10 a 5 para mejor performance
+    if (!include || depth > 5 || !items.length)
+        return items;
+    const schema = TableClass[SCHEMA];
+    if (!schema)
+        return items;
+    const promises = Object.entries(include)
+        .filter(([key]) => Object.prototype.hasOwnProperty.call(schema.columns, key))
+        .map(async ([relation_key, options]) => {
+        const column = schema.columns[relation_key];
+        if (!column?.store?.relation)
+            return;
+        const relation = column.store.relation;
+        const opts = typeof options === 'boolean' ? {} : options;
+        // Generar clave de caché basada en tipo de relación y IDs de padres
+        const parent_ids = items.map(i => i[relation.localKey]).filter(Boolean);
+        const cache_key = `${relation.type}:${relation.model().name}:${JSON.stringify(parent_ids.sort())}:${JSON.stringify(opts.where || {})}`;
+        // Batch load según tipo con caché
+        let data;
+        // Verificar caché primero
+        if (queryCache.has(cache_key)) {
+            data = queryCache.get(cache_key);
+        }
+        else {
+            if (relation.type === 'HasMany') {
+                data = await batchLoadHasMany(items, relation, opts);
+            }
+            else if (relation.type === 'HasOne') {
+                const hasMany = await batchLoadHasMany(items, relation, { ...opts, limit: 1 });
+                data = new Map();
+                for (const [k, v] of hasMany) {
+                    data.set(k, v[0] ?? null);
+                }
+            }
+            else if (relation.type === 'ManyToMany') {
+                data = await batchLoadManyToMany(items, relation, opts);
+            }
+            else {
+                // BelongsTo
+                data = await batchLoadBelongsTo(items, relation, opts);
+            }
+            // Guardar en caché
+            queryCache.set(cache_key, data);
+        }
+        for (const item of items) {
+            const key = String(item[relation.localKey]);
+            item[relation_key] = (relation.type === 'HasMany' || relation.type === 'ManyToMany')
+                ? data.get(key) ?? []
+                : data.get(key) ?? null;
+        }
+        // Recursión para includes anidados con caché propagado
+        if (opts.include && data.size) {
+            const all_related = Array.from(data.values()).flat().filter(Boolean);
+            if (all_related.length) {
+                await processIncludes(all_related, opts.include, relation.model(), depth + 1, queryCache);
+            }
+        }
+    });
+    await Promise.all(promises);
+    return items;
+};
+//# sourceMappingURL=relations.js.map

package/build/esm/utils/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../../src/utils/relations.ts"],"names":[],"mappings":"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"}

package/build/esm/utils/ulid.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description ULID (Universally Unique Lexicographically Sortable Identifier) generator.
+ * @description Generador de ULID (Identificador Único Lexicográficamente Ordenable).
+ *
+ * 48 bits timestamp (ms) + 80 bits random, Crockford Base32 encoding.
+ * Monotonic within the same millisecond: sequential calls in the same ms produce incrementing IDs.
+ *
+ * Monotónico dentro del mismo milisegundo: llamadas secuenciales en el mismo ms producen IDs incrementales.
+ */
+export declare function ulid(): string;

package/build/esm/utils/ulid.js

@@ -0,0 +1,52 @@
+/**
+ * @description ULID (Universally Unique Lexicographically Sortable Identifier) generator.
+ * @description Generador de ULID (Identificador Único Lexicográficamente Ordenable).
+ *
+ * 48 bits timestamp (ms) + 80 bits random, Crockford Base32 encoding.
+ * Monotonic within the same millisecond: sequential calls in the same ms produce incrementing IDs.
+ *
+ * Monotónico dentro del mismo milisegundo: llamadas secuenciales en el mismo ms producen IDs incrementales.
+ */
+const CHARS = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+let last_time = 0;
+let last_random_hi = 0;
+let last_random_lo = 0;
+function encode_time(time, len) {
+    let str = '';
+    for (let i = len; i > 0; i--) {
+        str = CHARS[time % 32] + str;
+        time = Math.floor(time / 32);
+    }
+    return str;
+}
+function encode_random() {
+    let str = '';
+    let hi = last_random_hi;
+    let lo = last_random_lo;
+    for (let i = 0; i < 8; i++) {
+        str = CHARS[lo % 32] + str;
+        lo = Math.floor(lo / 32);
+    }
+    for (let i = 0; i < 8; i++) {
+        str = CHARS[hi % 32] + str;
+        hi = Math.floor(hi / 32);
+    }
+    return str;
+}
+export function ulid() {
+    let now = Date.now();
+    if (now === last_time) {
+        last_random_lo++;
+        if (last_random_lo > 0xFFFFFFFFFF) {
+            last_random_lo = 0;
+            last_random_hi++;
+        }
+    }
+    else {
+        last_time = now;
+        last_random_hi = Math.floor(Math.random() * 0xFFFFFFFFFF);
+        last_random_lo = Math.floor(Math.random() * 0xFFFFFFFFFF);
+    }
+    return encode_time(now, 10) + encode_random();
+}
+//# sourceMappingURL=ulid.js.map

package/build/esm/utils/ulid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.js","sourceRoot":"","sources":["../../../src/utils/ulid.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,KAAK,GAAG,kCAAkC,CAAC;AAEjD,IAAI,SAAS,GAAG,CAAC,CAAC;AAClB,IAAI,cAAc,GAAG,CAAC,CAAC;AACvB,IAAI,cAAc,GAAG,CAAC,CAAC;AAEvB,SAAS,WAAW,CAAC,IAAY,EAAE,GAAW;IAC5C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,GAAG,GAAG,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;QAC7B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,EAAE,GAAG,cAAc,CAAC;IACxB,IAAI,EAAE,GAAG,cAAc,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,GAAG,GAAG,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;QAC3B,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,GAAG,GAAG,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;QAC3B,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAErB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,cAAc,EAAE,CAAC;QACjB,IAAI,cAAc,GAAG,YAAY,EAAE,CAAC;YAClC,cAAc,GAAG,CAAC,CAAC;YACnB,cAAc,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,GAAG,CAAC;QAChB,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC;QAC1D,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC;AAChD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "author": {
-    "email": "comunity@arcaelas.com",
+    "email": "community@arcaelas.com",
     "name": "Arcaelas Insiders",
     "url": "https://github.com/arcaelas"
   },
@@ -15,6 +15,7 @@
     "pluralize": "^8.0.0",
     "uuid": "^11.1.0"
   },
+  "description": "Modern decorator-first ORM for AWS DynamoDB with TypeScript support. Type-safe models, relationships, validations, and transactions.",
   "devDependencies": {
     "@eslint/js": "^9.39.1",
     "@types/node": "^24.0.6",
@@ -24,13 +25,31 @@
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.49.0"
   },
+  "exports": {
+    ".": {
+      "import": "./build/esm/index.js",
+      "require": "./build/cjs/index.js",
+      "types": "./build/esm/index.d.ts"
+    }
+  },
   "files": [
-    "src/**/*.js",
-    "src/**/*.d.ts"
+    "build"
   ],
   "homepage": "https://github.com/arcaelas/dynamite",
+  "keywords": [
+    "dynamodb",
+    "orm",
+    "aws",
+    "dynamodb-orm",
+    "typescript",
+    "decorators",
+    "arcaelas",
+    "arcaelas insiders",
+    "arcaelas-insiders"
+  ],
   "license": "ISC",
-  "main": "src/index.js",
+  "main": "./build/cjs/index.js",
+  "module": "./build/esm/index.js",
   "name": "@arcaelas/dynamite",
   "publishConfig": {
     "access": "public",
@@ -41,11 +60,14 @@
     "url": "https://github.com/arcaelas/dynamite.git"
   },
   "scripts": {
-    "build": "tsc && tsc-alias",
+    "build": "yarn build:esm && yarn build:cjs",
+    "build:cjs": "tsc --module commonjs --moduleResolution node --outDir build/cjs && tsc-alias --outDir build/cjs && echo '{\"type\":\"commonjs\"}' > build/cjs/package.json",
+    "build:esm": "tsc --module ESNext --moduleResolution bundler --outDir build/esm && tsc-alias --resolve-full-paths --outDir build/esm && echo '{\"type\":\"module\"}' > build/esm/package.json",
     "docs": "mkdocs gh-deploy --force",
-    "deploy": "npm version patch && npm publish --access=public",
-    "prepublishOnly": "yarn build",
-    "postpublish": "find src -type f \\( -name '*.js' -o -name '*.d.ts' -o -name '*.map' \\) -delete"
+    "lint": "eslint src/ --fix",
+    "prepublishOnly": "rm -rf build && npm version minor && yarn build",
+    "release": "npm publish --access public"
   },
-  "version": "1.0.25"
+  "types": "./build/esm/index.d.ts",
+  "version": "2.1.0"
 }