@deorta-dev/nestjs-repository-core 0.1.0

package/dist/utils/pending-ops-queue.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingOpsQueue = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Cola en memoria de operaciones que no se pudieron aplicar de inmediato en
+ * una conexión secundaria (caché o backup) porque la conexión no estaba
+ * lista o la operación falló. Se reintenta periódicamente y, además,
+ * apenas la conexión emite el evento `connected`.
+ *
+ * Las operaciones que se encolan aquí son siempre upserts/deletes por `_id`
+ * (idempotentes), así que reintentarlas en orden FIFO, incluso varias
+ * veces, es seguro.
+ *
+ * Nota: esta cola vive en memoria del proceso. Si el proceso se reinicia
+ * mientras hay operaciones pendientes, se pierden — pero no hay pérdida de
+ * datos real, porque `BackupSyncService` (para backups) vuelve a poner al
+ * día cualquier backup comparando contra `main` en su próxima corrida. Para
+ * la caché, un siguiente `find`/`findOne` simplemente la repuebla.
+ */
+class PendingOpsQueue {
+    constructor(label, intervalMs = 5000, maxQueueSize = 1000) {
+        this.label = label;
+        this.intervalMs = intervalMs;
+        this.maxQueueSize = maxQueueSize;
+        this.queue = [];
+        this.flushing = false;
+        this.logger = new common_1.Logger(`PendingOps:${label}`);
+    }
+    size() {
+        return this.queue.length;
+    }
+    enqueue(run, opLabel = this.label) {
+        if (this.queue.length >= this.maxQueueSize) {
+            const dropped = this.queue.shift();
+            this.logger.warn(`Cola llena (${this.maxQueueSize}), se descarta la operación pendiente más antigua (${dropped?.label}).`);
+        }
+        this.queue.push({ label: opLabel, run, attempts: 0, enqueuedAt: new Date() });
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            this.flush().catch((err) => this.logger.error(err));
+        }, this.intervalMs);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    /** Reintenta de inmediato apenas la conexión vuelve a estar disponible, sin esperar al siguiente tick del timer. */
+    watchConnection(connection) {
+        connection.on('connected', () => {
+            this.flush().catch((err) => this.logger.error(err));
+        });
+    }
+    async flush() {
+        if (this.flushing || !this.queue.length)
+            return;
+        this.flushing = true;
+        try {
+            const pending = this.queue;
+            this.queue = [];
+            for (const item of pending) {
+                try {
+                    await item.run();
+                }
+                catch (err) {
+                    item.attempts += 1;
+                    this.queue.push(item); // se reintenta en la próxima pasada
+                    this.logger.debug(`Reintento fallido (#${item.attempts}) para "${item.label}": ${err?.message}`);
+                }
+            }
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+}
+exports.PendingOpsQueue = PendingOpsQueue;
+//# sourceMappingURL=pending-ops-queue.js.map

package/dist/utils/pending-ops-queue.js.map

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

package/dist/utils/repository-token.util.d.ts

@@ -0,0 +1,7 @@
+import { Type } from '@nestjs/common';
+/** Ej: getRepositoryToken(Position) -> "PositionRepositoryService" */
+export declare function getRepositoryToken<T>(entity: Type<T>): string;
+export declare function getBackupSyncToken<T>(entity: Type<T>): string;
+export declare function getTombstoneModelName<T>(entity: Type<T>): string;
+export declare function getSyncCheckpointModelName<T>(entity: Type<T>): string;
+//# sourceMappingURL=repository-token.util.d.ts.map

package/dist/utils/repository-token.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-token.util.d.ts","sourceRoot":"","sources":["../../src/utils/repository-token.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAItC,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAE7D;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAEhE;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAErE"}

package/dist/utils/repository-token.util.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRepositoryToken = getRepositoryToken;
+exports.getBackupSyncToken = getBackupSyncToken;
+exports.getTombstoneModelName = getTombstoneModelName;
+exports.getSyncCheckpointModelName = getSyncCheckpointModelName;
+const SERVICE_SUFFIX = 'RepositoryService';
+/** Ej: getRepositoryToken(Position) -> "PositionRepositoryService" */
+function getRepositoryToken(entity) {
+    return `${entity.name}${SERVICE_SUFFIX}`;
+}
+function getBackupSyncToken(entity) {
+    return `${entity.name}BackupSyncService`;
+}
+function getTombstoneModelName(entity) {
+    return `${entity.name}Tombstone`;
+}
+function getSyncCheckpointModelName(entity) {
+    return `${entity.name}SyncCheckpoint`;
+}
+//# sourceMappingURL=repository-token.util.js.map

package/dist/utils/repository-token.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-token.util.js","sourceRoot":"","sources":["../../src/utils/repository-token.util.ts"],"names":[],"mappings":";;AAKA,gDAEC;AAED,gDAEC;AAED,sDAEC;AAED,gEAEC;AAjBD,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C,sEAAsE;AACtE,SAAgB,kBAAkB,CAAI,MAAe;IACjD,OAAO,GAAG,MAAM,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;AAC7C,CAAC;AAED,SAAgB,kBAAkB,CAAI,MAAe;IACjD,OAAO,GAAG,MAAM,CAAC,IAAI,mBAAmB,CAAC;AAC7C,CAAC;AAED,SAAgB,qBAAqB,CAAI,MAAe;IACpD,OAAO,GAAG,MAAM,CAAC,IAAI,WAAW,CAAC;AACrC,CAAC;AAED,SAAgB,0BAA0B,CAAI,MAAe;IACzD,OAAO,GAAG,MAAM,CAAC,IAAI,gBAAgB,CAAC;AAC1C,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@deorta-dev/nestjs-repository-core",
+  "version": "0.1.0",
+  "description": "Genera repositorios genéricos para NestJS + Mongoose por entidad (sin crear una clase por entidad), con caché read-through con TTL y backups de solo-escritura resilientes a desconexiones.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nestjs",
+    "mongoose",
+    "repository",
+    "orm",
+    "cache",
+    "backup",
+    "ttl"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@nestjs/common": "^9.0.0 || ^10.0.0 || ^11.0.0",
+    "@nestjs/mongoose": "^9.0.0 || ^10.0.0 || ^11.0.0",
+    "mongoose": "^7.0.0 || ^8.0.0",
+    "class-transformer": "^0.5.0",
+    "reflect-metadata": "^0.1.13 || ^0.2.0",
+    "rxjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.4.15",
+    "@nestjs/mongoose": "^10.1.0",
+    "@types/node": "^20.17.9",
+    "class-transformer": "^0.5.1",
+    "mongoose": "^8.9.2",
+    "reflect-metadata": "^0.1.14",
+    "rxjs": "^7.8.1",
+    "typescript": "^5.7.2"
+  }
+}