@deorta-dev/nestjs-repository-core 0.1.0

package/dist/schema/sync-checkpoint.schema.d.ts

@@ -0,0 +1,22 @@
+import { Schema } from 'mongoose';
+/**
+ * Guarda hasta qué `updatedTime` de `main` ya se sincronizó con los backups,
+ * para que cada corrida de sincronización solo procese lo nuevo.
+ */
+export declare const syncCheckpointSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, {
+    versionKey: false;
+}, {
+    key: string;
+    value: NativeDate;
+}, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
+    key: string;
+    value: NativeDate;
+}>, {}, import("mongoose").MergeType<import("mongoose").DefaultSchemaOptions, {
+    versionKey: false;
+}>> & import("mongoose").FlatRecord<{
+    key: string;
+    value: NativeDate;
+}> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;
+//# sourceMappingURL=sync-checkpoint.schema.d.ts.map

package/dist/schema/sync-checkpoint.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-checkpoint.schema.d.ts","sourceRoot":"","sources":["../../src/schema/sync-checkpoint.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAMhC,CAAC"}

package/dist/schema/sync-checkpoint.schema.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncCheckpointSchema = void 0;
+const mongoose_1 = require("mongoose");
+/**
+ * Guarda hasta qué `updatedTime` de `main` ya se sincronizó con los backups,
+ * para que cada corrida de sincronización solo procese lo nuevo.
+ */
+exports.syncCheckpointSchema = new mongoose_1.Schema({
+    key: { type: String, required: true, unique: true },
+    value: { type: Date, required: true },
+}, { versionKey: false });
+//# sourceMappingURL=sync-checkpoint.schema.js.map

package/dist/schema/sync-checkpoint.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-checkpoint.schema.js","sourceRoot":"","sources":["../../src/schema/sync-checkpoint.schema.ts"],"names":[],"mappings":";;;AAAA,uCAAkC;AAElC;;;GAGG;AACU,QAAA,oBAAoB,GAAG,IAAI,iBAAM,CAC1C;IACI,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACnD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;CACxC,EACD,EAAE,UAAU,EAAE,KAAK,EAAE,CACxB,CAAC"}

package/dist/schema/tombstone.schema.d.ts

@@ -0,0 +1,24 @@
+import { Schema } from 'mongoose';
+/**
+ * Cada vez que se borra un documento en `main` (y existen backups
+ * configurados), guardamos aquí su _id y la fecha de borrado. El
+ * BackupSyncService lee estos registros para saber qué borrar en los
+ * backups, sin tener que comparar el set completo de _ids contra main.
+ */
+export declare const tombstoneSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, {
+    versionKey: false;
+}, {
+    docId: any;
+    deletedAt: NativeDate;
+}, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
+    docId: any;
+    deletedAt: NativeDate;
+}>, {}, import("mongoose").MergeType<import("mongoose").DefaultSchemaOptions, {
+    versionKey: false;
+}>> & import("mongoose").FlatRecord<{
+    docId: any;
+    deletedAt: NativeDate;
+}> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;
+//# sourceMappingURL=tombstone.schema.d.ts.map

package/dist/schema/tombstone.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone.schema.d.ts","sourceRoot":"","sources":["../../src/schema/tombstone.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,MAAM,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAM3B,CAAC"}

package/dist/schema/tombstone.schema.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tombstoneSchema = void 0;
+const mongoose_1 = require("mongoose");
+/**
+ * Cada vez que se borra un documento en `main` (y existen backups
+ * configurados), guardamos aquí su _id y la fecha de borrado. El
+ * BackupSyncService lee estos registros para saber qué borrar en los
+ * backups, sin tener que comparar el set completo de _ids contra main.
+ */
+exports.tombstoneSchema = new mongoose_1.Schema({
+    docId: { type: mongoose_1.SchemaTypes.Mixed, required: true, index: true },
+    deletedAt: { type: Date, default: () => new Date(), index: true },
+}, { versionKey: false });
+//# sourceMappingURL=tombstone.schema.js.map

package/dist/schema/tombstone.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone.schema.js","sourceRoot":"","sources":["../../src/schema/tombstone.schema.ts"],"names":[],"mappings":";;;AAAA,uCAA+C;AAE/C;;;;;GAKG;AACU,QAAA,eAAe,GAAG,IAAI,iBAAM,CACrC;IACI,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;IAC/D,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;CACpE,EACD,EAAE,UAAU,EAAE,KAAK,EAAE,CACxB,CAAC"}

package/dist/schema/with-cache-ttl.d.ts

@@ -0,0 +1,14 @@
+import { Schema } from 'mongoose';
+/** Campo interno usado para el índice TTL en la conexión de caché. */
+export declare const CACHE_EXPIRES_AT_FIELD = "_cacheExpiresAt";
+/**
+ * Clona el schema original y le agrega un campo + índice TTL para que Mongo
+ * expire automáticamente los documentos de la conexión de caché.
+ *
+ * Usamos un índice TTL "a fecha exacta" (expireAfterSeconds: 0 sobre un campo
+ * Date) en vez del clásico "expira N segundos después de creado", porque así
+ * cada escritura puede definir su propio vencimiento (this.ttlSeconds) sin
+ * depender de cuándo se creó el índice.
+ */
+export declare function withCacheTtl(originalSchema: Schema, _ttlSeconds: number): Schema;
+//# sourceMappingURL=with-cache-ttl.d.ts.map

package/dist/schema/with-cache-ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-cache-ttl.d.ts","sourceRoot":"","sources":["../../src/schema/with-cache-ttl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOhF"}

package/dist/schema/with-cache-ttl.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CACHE_EXPIRES_AT_FIELD = void 0;
+exports.withCacheTtl = withCacheTtl;
+/** Campo interno usado para el índice TTL en la conexión de caché. */
+exports.CACHE_EXPIRES_AT_FIELD = '_cacheExpiresAt';
+/**
+ * Clona el schema original y le agrega un campo + índice TTL para que Mongo
+ * expire automáticamente los documentos de la conexión de caché.
+ *
+ * Usamos un índice TTL "a fecha exacta" (expireAfterSeconds: 0 sobre un campo
+ * Date) en vez del clásico "expira N segundos después de creado", porque así
+ * cada escritura puede definir su propio vencimiento (this.ttlSeconds) sin
+ * depender de cuándo se creó el índice.
+ */
+function withCacheTtl(originalSchema, _ttlSeconds) {
+    const cacheSchema = originalSchema.clone();
+    cacheSchema.add({
+        [exports.CACHE_EXPIRES_AT_FIELD]: { type: Date },
+    });
+    cacheSchema.index({ [exports.CACHE_EXPIRES_AT_FIELD]: 1 }, { expireAfterSeconds: 0 });
+    return cacheSchema;
+}
+//# sourceMappingURL=with-cache-ttl.js.map

package/dist/schema/with-cache-ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-cache-ttl.js","sourceRoot":"","sources":["../../src/schema/with-cache-ttl.ts"],"names":[],"mappings":";;;AAcA,oCAOC;AAnBD,sEAAsE;AACzD,QAAA,sBAAsB,GAAG,iBAAiB,CAAC;AAExD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,cAAsB,EAAE,WAAmB;IACpE,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC;IAC3C,WAAW,CAAC,GAAG,CAAC;QACZ,CAAC,8BAAsB,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;KACpC,CAAC,CAAC;IACV,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,8BAAsB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9E,OAAO,WAAW,CAAC;AACvB,CAAC"}

package/dist/sync/backup-sync.service.d.ts

@@ -0,0 +1,61 @@
+import { Logger, OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import { Model } from 'mongoose';
+import { BackupSyncConfig } from '../types';
+interface SyncOutcome {
+    upserted: number;
+    deleted: number;
+}
+/**
+ * Revisa periódicamente qué le falta a cada conexión de backup respecto a
+ * `main` y la pone al día:
+ *   - Inserts/updates: documentos de `main` con `updatedTime` > checkpoint (uno por backup).
+ *   - Deletes: usa la colección de tombstones (ver schema/tombstone.schema.ts), también con
+ *     un checkpoint independiente por backup.
+ *
+ * Cada conexión de backup se sincroniza de forma INDEPENDIENTE: si una está
+ * caída o falla, las demás igual avanzan, y la caída simplemente se pondrá
+ * al día sola en una próxima corrida (no hay un único checkpoint compartido
+ * que se bloquee por una conexión problemática).
+ *
+ * Si `backupSync.enabled` es `false`, este servicio no arranca ningún
+ * temporizador interno: en ese caso eres tú (o un microservicio externo de
+ * bajo esfuerzo) quien debe llamar `syncNow()` cuando le convenga.
+ */
+export declare class BackupSyncService implements OnModuleInit, OnModuleDestroy {
+    protected readonly entityName: string;
+    protected readonly mainModel: Model<any>;
+    protected readonly backupModels: Model<any>[];
+    protected readonly backupLabels: string[];
+    protected readonly tombstoneModel: Model<any>;
+    protected readonly checkpointModel: Model<any>;
+    protected readonly config: BackupSyncConfig;
+    protected readonly logger: Logger;
+    protected timer?: NodeJS.Timeout;
+    protected running: boolean;
+    constructor(entityName: string, mainModel: Model<any>, backupModels: Model<any>[], backupLabels: string[], tombstoneModel: Model<any>, checkpointModel: Model<any>, config: BackupSyncConfig);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    /**
+     * Dispara una verificación/actualización manual de TODOS los backups
+     * configurados. Útil si prefieres que un microservicio externo (de bajo
+     * esfuerzo) decida cuándo sincronizar, en vez del temporizador interno.
+     */
+    syncNow(): Promise<SyncOutcome>;
+    /** Sincroniza un backup específico. Si no está listo, falla rápido sin tocar `main`. */
+    protected syncBackup(backup: Model<any>, label: string, batchSize: number): Promise<SyncOutcome>;
+    protected syncUpsertsFor(backup: Model<any>, label: string, batchSize: number): Promise<number>;
+    protected syncDeletesFor(backup: Model<any>, label: string, batchSize: number): Promise<number>;
+    /**
+     * Un tombstone solo se borra de la colección una vez que TODOS los
+     * backups configurados ya lo aplicaron (su checkpoint de deletes ya lo
+     * superó). Así, un backup que estuvo caído puede ponerse al día más
+     * tarde sin que el tombstone que necesitaba ya haya sido eliminado.
+     */
+    protected purgeFullyAppliedTombstones(): Promise<void>;
+    protected upsertCheckpointKey(label: string): string;
+    protected deleteCheckpointKey(label: string): string;
+    protected getCheckpoint(key: string): Promise<Date>;
+    protected setCheckpoint(key: string, value: Date): Promise<void>;
+}
+export {};
+//# sourceMappingURL=backup-sync.service.d.ts.map

package/dist/sync/backup-sync.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-sync.service.d.ts","sourceRoot":"","sources":["../../src/sync/backup-sync.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,UAAU,WAAW;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,YAAW,YAAY,EAAE,eAAe;IAM/D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM;IACrC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC;IACxC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE;IAC7C,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;IACzC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IAX/C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACjC,SAAS,CAAC,OAAO,UAAS;gBAGH,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EACrB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAC1B,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,EAC1B,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,EAC3B,MAAM,EAAE,gBAAgB;IAK/C,YAAY,IAAI,IAAI;IAapB,eAAe,IAAI,IAAI;IAIvB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAkCrC,wFAAwF;cACxE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;cAUtF,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAyBrF,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBrG;;;;;OAKG;cACa,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5D,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpD,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;cAIpC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAKzC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAKzE"}

package/dist/sync/backup-sync.service.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackupSyncService = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Revisa periódicamente qué le falta a cada conexión de backup respecto a
+ * `main` y la pone al día:
+ *   - Inserts/updates: documentos de `main` con `updatedTime` > checkpoint (uno por backup).
+ *   - Deletes: usa la colección de tombstones (ver schema/tombstone.schema.ts), también con
+ *     un checkpoint independiente por backup.
+ *
+ * Cada conexión de backup se sincroniza de forma INDEPENDIENTE: si una está
+ * caída o falla, las demás igual avanzan, y la caída simplemente se pondrá
+ * al día sola en una próxima corrida (no hay un único checkpoint compartido
+ * que se bloquee por una conexión problemática).
+ *
+ * Si `backupSync.enabled` es `false`, este servicio no arranca ningún
+ * temporizador interno: en ese caso eres tú (o un microservicio externo de
+ * bajo esfuerzo) quien debe llamar `syncNow()` cuando le convenga.
+ */
+class BackupSyncService {
+    constructor(entityName, mainModel, backupModels, backupLabels, tombstoneModel, checkpointModel, config) {
+        this.entityName = entityName;
+        this.mainModel = mainModel;
+        this.backupModels = backupModels;
+        this.backupLabels = backupLabels;
+        this.tombstoneModel = tombstoneModel;
+        this.checkpointModel = checkpointModel;
+        this.config = config;
+        this.running = false;
+        this.logger = new common_1.Logger(`BackupSync:${entityName}`);
+    }
+    onModuleInit() {
+        if (!this.config?.enabled || !this.backupModels.length)
+            return;
+        const interval = this.config.intervalMs ?? 60_000;
+        this.timer = setInterval(() => {
+            this.syncNow().catch((err) => this.logger.error(err));
+        }, interval);
+        if (this.config.runOnStart) {
+            this.syncNow().catch((err) => this.logger.error(err));
+        }
+    }
+    onModuleDestroy() {
+        if (this.timer)
+            clearInterval(this.timer);
+    }
+    /**
+     * Dispara una verificación/actualización manual de TODOS los backups
+     * configurados. Útil si prefieres que un microservicio externo (de bajo
+     * esfuerzo) decida cuándo sincronizar, en vez del temporizador interno.
+     */
+    async syncNow() {
+        if (this.running)
+            return { upserted: 0, deleted: 0 }; // evita solapamientos
+        this.running = true;
+        try {
+            const batchSize = this.config?.batchSize ?? 500;
+            const results = await Promise.allSettled(this.backupModels.map((backup, i) => this.syncBackup(backup, this.backupLabels[i], batchSize)));
+            const totals = { upserted: 0, deleted: 0 };
+            results.forEach((result, i) => {
+                if (result.status === 'fulfilled') {
+                    totals.upserted += result.value.upserted;
+                    totals.deleted += result.value.deleted;
+                }
+                else {
+                    this.logger.warn(`[${this.backupLabels[i]}] no se pudo sincronizar, se reintentará en la próxima corrida: ${result.reason?.message ?? result.reason}`);
+                }
+            });
+            // Solo borra tombstones que YA fueron aplicados en todos los backups (ver método).
+            await this.purgeFullyAppliedTombstones();
+            return totals;
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /** Sincroniza un backup específico. Si no está listo, falla rápido sin tocar `main`. */
+    async syncBackup(backup, label, batchSize) {
+        if (backup.db.readyState !== 1) {
+            throw new Error(`conexión "${label}" no está lista (readyState=${backup.db.readyState})`);
+        }
+        const upserted = await this.syncUpsertsFor(backup, label, batchSize);
+        const deleted = await this.syncDeletesFor(backup, label, batchSize);
+        return { upserted, deleted };
+    }
+    async syncUpsertsFor(backup, label, batchSize) {
+        const checkpointKey = this.upsertCheckpointKey(label);
+        const checkpoint = await this.getCheckpoint(checkpointKey);
+        const pending = await this.mainModel
+            .find({ updatedTime: { $gt: checkpoint } })
+            .sort({ updatedTime: 1 })
+            .limit(batchSize)
+            .lean()
+            .exec();
+        if (!pending.length)
+            return 0;
+        await backup.bulkWrite(pending.map((doc) => ({
+            replaceOne: { filter: { _id: doc._id }, replacement: doc, upsert: true },
+        })));
+        const newCheckpoint = pending[pending.length - 1].updatedTime;
+        await this.setCheckpoint(checkpointKey, newCheckpoint);
+        return pending.length;
+    }
+    async syncDeletesFor(backup, label, batchSize) {
+        if (!this.tombstoneModel)
+            return 0;
+        const checkpointKey = this.deleteCheckpointKey(label);
+        const checkpoint = await this.getCheckpoint(checkpointKey);
+        const tombstones = await this.tombstoneModel
+            .find({ deletedAt: { $gt: checkpoint } })
+            .sort({ deletedAt: 1 })
+            .limit(batchSize)
+            .lean()
+            .exec();
+        if (!tombstones.length)
+            return 0;
+        const ids = tombstones.map((t) => t.docId);
+        await backup.deleteMany({ _id: { $in: ids } }).exec();
+        const newCheckpoint = tombstones[tombstones.length - 1].deletedAt;
+        await this.setCheckpoint(checkpointKey, newCheckpoint);
+        return tombstones.length;
+    }
+    /**
+     * Un tombstone solo se borra de la colección una vez que TODOS los
+     * backups configurados ya lo aplicaron (su checkpoint de deletes ya lo
+     * superó). Así, un backup que estuvo caído puede ponerse al día más
+     * tarde sin que el tombstone que necesitaba ya haya sido eliminado.
+     */
+    async purgeFullyAppliedTombstones() {
+        if (!this.tombstoneModel || !this.backupLabels.length)
+            return;
+        const checkpoints = await Promise.all(this.backupLabels.map((label) => this.getCheckpoint(this.deleteCheckpointKey(label))));
+        const minCheckpoint = checkpoints.reduce((min, c) => (c.getTime() < min.getTime() ? c : min), checkpoints[0]);
+        if (!minCheckpoint || minCheckpoint.getTime() === 0)
+            return;
+        await this.tombstoneModel.deleteMany({ deletedAt: { $lte: minCheckpoint } }).exec();
+    }
+    upsertCheckpointKey(label) {
+        return `${this.entityName}:${label}:upsert`;
+    }
+    deleteCheckpointKey(label) {
+        return `${this.entityName}:${label}:delete`;
+    }
+    async getCheckpoint(key) {
+        const doc = await this.checkpointModel.findOne({ key }).lean().exec();
+        return doc?.value ?? new Date(0);
+    }
+    async setCheckpoint(key, value) {
+        await this.checkpointModel
+            .replaceOne({ key }, { key, value }, { upsert: true })
+            .exec();
+    }
+}
+exports.BackupSyncService = BackupSyncService;
+//# sourceMappingURL=backup-sync.service.js.map

package/dist/sync/backup-sync.service.js.map

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

package/dist/sync/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./backup-sync.service";
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./backup-sync.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC"}

package/dist/types.d.ts

@@ -0,0 +1,122 @@
+import { DynamicModule, Type } from '@nestjs/common';
+import { FilterQuery, Schema, UpdateQuery } from 'mongoose';
+import { Observable } from 'rxjs';
+/**
+ * Reemplaza esta interfaz por tu BaseOrmOptions real (la que ya tienes en
+ * `../../../types`) si quieres tipado estricto. La dejamos abierta para que
+ * la librería no dependa de tu monorepo.
+ */
+export interface BaseOrmOptions {
+    [key: string]: any;
+}
+export type RepositoryQueryTarget = 'main' | 'cache';
+export interface CacheConnectionConfig {
+    /** Nombre de la conexión de caché (igual que usas hoy con ConnectionNames). */
+    connectionName: string;
+    /** Segundos que un documento debe vivir en la conexión de caché (índice TTL). */
+    ttlSeconds: number;
+}
+export interface BackupConnectionConfig {
+    /** Nombre de la conexión de respaldo (solo-escritura). */
+    connectionName: string;
+}
+export interface BackupSyncConfig {
+    /** Si en false, nadie sincroniza automáticamente (puedes llamar syncNow() tú mismo desde un microservicio). */
+    enabled: boolean;
+    /** Cada cuánto (ms) se revisa main vs backups. Default: 60000 (1 min). */
+    intervalMs?: number;
+    /** Si debe correr una verificación inmediatamente al arrancar el módulo. Default: false. */
+    runOnStart?: boolean;
+    /** Cuántos documentos procesar por lote en cada verificación. Default: 500. */
+    batchSize?: number;
+}
+export interface PendingOpsConfig {
+    /** Cada cuánto (ms) se reintentan las escrituras pendientes hacia cache/backups. Default: 5000. */
+    retryIntervalMs?: number;
+    /** Máximo de operaciones pendientes en memoria por conexión secundaria antes de descartar la más vieja. Default: 1000. */
+    maxQueueSize?: number;
+}
+export interface FindOptions {
+    /**
+     * 'cache' | 'main'. Si no se especifica:
+     *  - Si hay conexión de caché configurada -> intenta caché, si no encuentra (o si la caché
+     *    está caída) cae a main.
+     *  - Si no hay caché -> consulta main directamente.
+     * Si se especifica explícitamente, NO hace fallback ni repuebla caché.
+     */
+    target?: RepositoryQueryTarget;
+    sort?: Record<string, 1 | -1>;
+    limit?: number;
+    skip?: number;
+    projection?: Record<string, 0 | 1>;
+}
+export interface UpdateManyResult {
+    matched: number;
+    modified: number;
+}
+/**
+ * Contrato público que debe cumplir cualquier servicio de repositorio:
+ * tanto `BaseRepositoryService` (el que se usa por defecto) como cualquier
+ * servicio personalizado que pases en `RepositoryModuleOptions.customService`.
+ *
+ * Si decides implementar tu propio servicio en vez de usar
+ * `BaseRepositoryService`, esta es la interfaz que tu clase tiene que
+ * cumplir — TypeScript te lo exige apenas la asignas a `customService`.
+ */
+export interface IBaseRepositoryService<T = any> {
+    findOne(filter: FilterQuery<T>, opts?: FindOptions): Observable<T | null>;
+    find(filter?: FilterQuery<T>, opts?: FindOptions): Observable<T[]>;
+    create(dto: Partial<T>): Observable<T>;
+    insertMany(dtos: Partial<T>[]): Observable<T[]>;
+    updateOne(filter: FilterQuery<T>, update: UpdateQuery<T>): Observable<T | null>;
+    updateMany(filter: FilterQuery<T>, update: UpdateQuery<T>): Observable<UpdateManyResult>;
+    deleteOne(filter: FilterQuery<T>): Observable<boolean>;
+    deleteMany(filter: FilterQuery<T>): Observable<number>;
+    count(filter?: FilterQuery<T>): Observable<number>;
+    aggregate<R = any>(pipeline: any[]): Observable<R[]>;
+    updateObject(object: any): Observable<T | null>;
+    upsertBulk(bulkData: any[]): Observable<any>;
+    updateBulk(bulkData: any[]): Observable<any>;
+}
+export interface RepositoryModuleOptions<T> {
+    /** Clase de la entidad (la misma que hoy pasas a `super(model, Position, options)`). */
+    entity: Type<T>;
+    /** Schema de mongoose de la entidad. */
+    schema: Schema;
+    /** Conexión principal (ej. ConnectionNames.OPERATION_MDB). */
+    connectionName: string;
+    /** Opciones equivalentes a tu BaseOrmOptions actual. */
+    options?: BaseOrmOptions;
+    /** Conexión de caché opcional, con su propio TTL. */
+    cache?: CacheConnectionConfig;
+    /** Conexiones de respaldo, solo-escritura (réplicas completas de main). */
+    backups?: BackupConnectionConfig[];
+    /** Configuración de la verificación periódica de los backups contra main. */
+    backupSync?: BackupSyncConfig;
+    /**
+     * Configuración de la cola de reintentos para cache/backups. Si una de
+     * estas conexiones está caída o no lista, las escrituras quedan
+     * pendientes aquí en vez de fallar, y se reintentan solas.
+     */
+    pendingOps?: PendingOpsConfig;
+    /**
+     * Servicio personalizado a usar en vez de `BaseRepositoryService`. Debe
+     * ser una clase que, al instanciarla, cumpla `IBaseRepositoryService<T>`
+     * (TypeScript te lo exige al asignarla aquí). Si no la pasas, se usa
+     * `BaseRepositoryService` por defecto.
+     *
+     * Recomendado: extiende `BaseRepositoryService<T>` y llama `super(...)`
+     * con los mismos argumentos que recibe tu constructor — así heredas toda
+     * la resiliencia de caché/backups y solo sobreescribes lo que te
+     * interese. Ver `examples/custom-repository-service.example.ts`.
+     */
+    customService?: Type<IBaseRepositoryService<T>>;
+}
+/**
+ * Lo que retorna RepositoryOrmModule.register(...). Es un DynamicModule normal
+ * de Nest + el atributo REPOSITORY_SERVICE_KEY que necesita @RepositoryInject().
+ */
+export interface RepositoryDynamicModule extends DynamicModule {
+    REPOSITORY_SERVICE_KEY: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./pending-ops-queue";
+export * from "./repository-token.util";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./pending-ops-queue"), exports);
+__exportStar(require("./repository-token.util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,0DAAwC"}

package/dist/utils/pending-ops-queue.d.ts

@@ -0,0 +1,44 @@
+import { Logger } from '@nestjs/common';
+import { Connection } from 'mongoose';
+export type PendingOperation = () => Promise<void>;
+interface QueueItem {
+    label: string;
+    run: PendingOperation;
+    attempts: number;
+    enqueuedAt: Date;
+}
+/**
+ * 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.
+ */
+export declare class PendingOpsQueue {
+    protected readonly label: string;
+    protected readonly intervalMs: number;
+    protected readonly maxQueueSize: number;
+    protected readonly logger: Logger;
+    protected queue: QueueItem[];
+    protected flushing: boolean;
+    protected timer?: NodeJS.Timeout;
+    constructor(label: string, intervalMs?: number, maxQueueSize?: number);
+    size(): number;
+    enqueue(run: PendingOperation, opLabel?: string): void;
+    start(): void;
+    stop(): void;
+    /** Reintenta de inmediato apenas la conexión vuelve a estar disponible, sin esperar al siguiente tick del timer. */
+    watchConnection(connection: Connection): void;
+    flush(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=pending-ops-queue.d.ts.map

package/dist/utils/pending-ops-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-ops-queue.d.ts","sourceRoot":"","sources":["../../src/utils/pending-ops-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnD,UAAU,SAAS;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IAOpB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAChC,SAAS,CAAC,QAAQ,CAAC,UAAU;IAC7B,SAAS,CAAC,QAAQ,CAAC,YAAY;IARnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,CAAM;IAClC,SAAS,CAAC,QAAQ,UAAS;IAC3B,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;gBAGV,KAAK,EAAE,MAAM,EACb,UAAU,SAAO,EACjB,YAAY,SAAO;IAK1C,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,SAAa,GAAG,IAAI;IAU1D,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAKZ,oHAAoH;IACpH,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAMvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB/B"}