@roit/roit-data-firestore 1.2.48 → 1.2.50

package/dist/archive/ArchivePluginRegistry.js

@@ -38,8 +38,8 @@ class NoOpArchivePlugin {
     markerKey() {
         return undefined;
     }
-    getConfig() {
-        return undefined;
+    debugEnabled() {
+        return false;
     }
 }
 /**

package/dist/archive/ArchiveService.d.ts

@@ -17,9 +17,6 @@ export declare class ArchiveService {
     private static instance;
     private static readonly lock;
     private static isInitializing;
-    private config;
-    /** ProjectId of the Firestore being archived (for path organization) */
-    private projectId;
     private isInitialized;
     private logger;
     /**
@@ -34,7 +31,6 @@ export declare class ArchiveService {
      * Requires the firestore-archive plugin to be registered
      */
     isEnabled(): boolean;
-    static isEnabled(): boolean;
     /**
      * Checks if a document is archived
      */
@@ -44,9 +40,9 @@ export declare class ArchiveService {
      *
      * Returns the trimmed string or undefined when missing/invalid.
      */
-    static getArchivePath(documentData: any): string | undefined;
-    static getArchiveHash(documentData: any): string | undefined;
-    static markerKey(): string | undefined;
+    getArchivePath(documentData: any): string | undefined;
+    getArchiveHash(documentData: any): string | undefined;
+    markerKey(): string | undefined;
     /**
      * Checks if a document is archived and retrieves its complete data
      */
@@ -90,10 +86,5 @@ export declare class ArchiveService {
      * Delegates to the firestore-archive plugin
      */
     clearArchivedCache(collectionName?: string, docId?: string): Promise<void>;
-    /**
-     * Returns the projectId of the Firestore being archived
-     * (used for path organization in Storage)
-     */
-    getProjectId(): string;
 }
 export {};

package/dist/archive/ArchiveService.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArchiveService = void 0;
-const ArchiveConfig_1 = require("../config/ArchiveConfig");
 const index_1 = require("./index");
 /**
  * Logger for ArchiveService
@@ -33,6 +32,7 @@ class ArchiveService {
      * Private constructor to prevent direct instantiation
      */
     constructor() {
+        // Instance properties
         this.isInitialized = false;
         // Empty constructor - initialization will be done in initialize()
     }
@@ -63,21 +63,12 @@ class ArchiveService {
         if (this.isInitialized) {
             return;
         }
-        this.config = ArchiveConfig_1.ArchiveConfig.getConfig();
-        this.logger = new ArchiveLogger(this.config.debug);
-        // ProjectId of the Firestore being archived (used for paths in Storage)
-        this.projectId = this.config.projectId;
-        if (!this.projectId) {
-            this.logger.warn('projectId not configured - using environment variable');
-            this.projectId = process.env.FIRESTORE_PROJECTID || process.env.GCP_PROJECT || '';
-        }
-        this.logger.debug(`Configuração: projectId=${this.projectId}, enabled=${this.config.enabled}`);
-        if (!this.config.enabled) {
-            this.logger.info('Archive disabled via configuration');
-            this.isInitialized = true;
-            return;
+        const debug = ['true', true].includes(process.env.FIRESTORE_DEBUG || '') || (0, index_1.getArchivePlugin)().debugEnabled();
+        this.logger = new ArchiveLogger(debug);
+        if ((0, index_1.hasArchivePlugin)()) {
+            this.logger.debug(`Plugin firestore-archive registered: enabled=${(0, index_1.getArchivePlugin)().isEnabled()}`);
         }
-        if (!(0, index_1.hasArchivePlugin)()) {
+        else {
             this.logger.warn('Plugin firestore-archive not registered - archive disabled');
         }
         this.isInitialized = true;
@@ -94,10 +85,6 @@ class ArchiveService {
         // Archive only works with registered plugin
         return (0, index_1.hasArchivePlugin)() && (0, index_1.getArchivePlugin)().isEnabled();
     }
-    static isEnabled() {
-        // Archive only works with registered plugin
-        return (0, index_1.hasArchivePlugin)() && (0, index_1.getArchivePlugin)().isEnabled();
-    }
     /**
      * Checks if a document is archived
      */
@@ -112,19 +99,19 @@ class ArchiveService {
      *
      * Returns the trimmed string or undefined when missing/invalid.
      */
-    static getArchivePath(documentData) {
+    getArchivePath(documentData) {
         if (!this.isEnabled()) {
             return undefined;
         }
         return (0, index_1.getArchivePlugin)().getArchivePath(documentData);
     }
-    static getArchiveHash(documentData) {
+    getArchiveHash(documentData) {
         if (!this.isEnabled()) {
             return undefined;
         }
         return (0, index_1.getArchivePlugin)().getArchiveHash(documentData);
     }
-    static markerKey() {
+    markerKey() {
         if (!this.isEnabled()) {
             return undefined;
         }
@@ -138,18 +125,17 @@ class ArchiveService {
             return null;
         }
         const docId = doc.id;
-        const archivePath = ArchiveService.getArchivePath(doc) || '';
+        const archivePath = this.getArchivePath(doc) || '';
         if (!archivePath) {
             throw new Error(`ArchiveService.getArchivedDocument: ${(0, index_1.getArchivePlugin)().markerKey() || ''} archive path is required. collection=${collectionName} docId=${docId}`);
         }
         // Extract hash from stub for integrity verification
-        const expectedHash = ArchiveService.getArchiveHash(doc);
+        const expectedHash = this.getArchiveHash(doc);
         // Delegate to plugin (isEnabled already ensures it exists)
         return (0, index_1.getArchivePlugin)().getArchivedDocument({
             collection: collectionName,
             docId,
             archivePath,
-            projectId: this.projectId,
             expectedHash,
         });
     }
@@ -177,7 +163,6 @@ class ArchiveService {
             docId,
             newData,
             options,
-            projectId: this.projectId,
             archivePath,
         });
     }
@@ -201,7 +186,6 @@ class ArchiveService {
         return (0, index_1.getArchivePlugin)().deleteArchivedDocument({
             collection: collectionName,
             docId,
-            projectId: this.projectId,
             archivePath,
         });
     }
@@ -219,7 +203,7 @@ class ArchiveService {
         }
         const archivedData = await this.getArchivedDocument(collectionName, stubData);
         if (!archivedData) {
-            this.logger.warn(`Archived data not found for document: ${collectionName}/${stubData.id}`);
+            this.logger.warn(`Archived data not found for document: ${collectionName}/${stubData?.id || ''}`);
             return stubData; // Return stub if archived data is not found
         }
         // Merge: storage data overwrites the stub, except the marker key
@@ -236,13 +220,6 @@ class ArchiveService {
         }
         await (0, index_1.getArchivePlugin)().invalidateCache(collectionName, docId);
     }
-    /**
-     * Returns the projectId of the Firestore being archived
-     * (used for path organization in Storage)
-     */
-    getProjectId() {
-        return this.projectId;
-    }
 }
 exports.ArchiveService = ArchiveService;
 // Singleton instance

package/dist/archive/IArchivePlugin.d.ts

@@ -28,7 +28,6 @@ export interface IArchivePlugin {
      * @param collection - Collection name
      * @param docId - Document ID
      * @param archivePath - Full object path in Storage
-     * @param projectId - Project ID (optional)
      * @param expectedHash - Expected hash from Firestore stub for integrity verification (optional)
      * @returns Operation result
      */
@@ -36,7 +35,6 @@ export interface IArchivePlugin {
         collection: string;
         docId: string;
         archivePath: string;
-        projectId?: string;
         expectedHash?: string;
     }): Promise<Record<string, unknown> | null>;
     /**
@@ -46,7 +44,6 @@ export interface IArchivePlugin {
      * @param docId - Document ID
      * @param newData - New data to merge
      * @param options - Options (unarchive: true to remove from Storage)
-     * @param projectId - Project ID (optional)
      * @param archivePath - Full object path in Storage. Required when unarchive=true
      * @returns Merged data
      */
@@ -57,7 +54,6 @@ export interface IArchivePlugin {
         options?: {
             unarchive?: boolean;
         };
-        projectId?: string;
         archivePath: string;
     }): Promise<{
         result: {
@@ -72,14 +68,13 @@ export interface IArchivePlugin {
      *
      * @param collection - Collection name
      * @param docId - Document ID
-     * @param projectId - Project ID (optional)
+     * @param archivePath - Full object path in Storage
      * @returns Operation result
      */
     deleteArchivedDocument(params: {
         collection: string;
         docId: string;
         archivePath: string;
-        projectId?: string;
     }): Promise<{
         success: boolean;
         message?: string;
@@ -96,9 +91,5 @@ export interface IArchivePlugin {
     getArchivePath(doc: Record<string, unknown> | null | undefined): string | undefined;
     isArchived(doc: Record<string, unknown> | null | undefined): boolean;
     markerKey(): string | undefined;
-    /**
-     * Returns the current configuration (for debugging/inspection)
-     * Added in firestore-archive v1.1.0
-     */
-    getConfig?(): Record<string, unknown> | undefined;
+    debugEnabled(): boolean;
 }

package/dist/config/BaseRepository.js

@@ -33,9 +33,13 @@ class BaseRepository {
      */
     async clearArchivedCache(collectionName, docId) {
         const archiveService = await ArchiveService_1.ArchiveService.getInstance();
+        if (!archiveService.isEnabled()) {
+            return Promise.resolve();
+        }
         await archiveService.clearArchivedCache(collectionName, docId);
     }
 }
+exports.BaseRepository = BaseRepository;
 __decorate([
     (0, Query_1.Query)(),
     __metadata("design:type", Function)
@@ -84,4 +88,3 @@ __decorate([
     (0, Query_1.Query)(),
     __metadata("design:type", Function)
 ], BaseRepository.prototype, "aggregation", void 0);
-exports.BaseRepository = BaseRepository;

package/dist/config/ReadonlyRepository.js

@@ -22,6 +22,7 @@ class ReadonlyRepository {
         return ManualQueryHelper_1.ManualQueryHelper.executeQueryManualPaginated(className, config);
     }
 }
+exports.ReadonlyRepository = ReadonlyRepository;
 __decorate([
     (0, Query_1.Query)(),
     __metadata("design:type", Function)
@@ -30,4 +31,3 @@ __decorate([
     (0, Query_1.Query)(),
     __metadata("design:type", Function)
 ], ReadonlyRepository.prototype, "findById", void 0);
-exports.ReadonlyRepository = ReadonlyRepository;

package/dist/exception/RepositoryException.js

@@ -20,4 +20,4 @@ var ErrorType;
 (function (ErrorType) {
     ErrorType["SYSTEM"] = "system";
     ErrorType["BUSINESS"] = "business";
-})(ErrorType = exports.ErrorType || (exports.ErrorType = {}));
+})(ErrorType || (exports.ErrorType = ErrorType = {}));

package/dist/index.d.ts

@@ -11,7 +11,6 @@ export { Cacheable } from "./decorators/Cacheable";
 export { BaseRepository } from "./config/BaseRepository";
 export { ReadonlyRepository } from "./config/ReadonlyRepository";
 export { GenericRepository } from "./config/GenericRepository";
-export { ArchiveConfig } from "./config/ArchiveConfig";
 export { CacheProviders } from "./model/CacheProviders";
 export { FirestoreInstance } from "./config/FirestoreInstance";
 /**

package/dist/index.js

@@ -14,7 +14,7 @@ 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 });
-exports.resetArchivePlugin = exports.hasArchivePlugin = exports.getArchivePlugin = exports.registerArchivePlugin = exports.FirestoreInstance = exports.CacheProviders = exports.ArchiveConfig = exports.GenericRepository = exports.ReadonlyRepository = exports.BaseRepository = exports.Cacheable = exports.Query = exports.Repository = void 0;
+exports.resetArchivePlugin = exports.hasArchivePlugin = exports.getArchivePlugin = exports.registerArchivePlugin = exports.FirestoreInstance = exports.CacheProviders = exports.GenericRepository = exports.ReadonlyRepository = exports.BaseRepository = exports.Cacheable = exports.Query = exports.Repository = void 0;
 require("reflect-metadata");
 /**
  * decorators
@@ -34,8 +34,6 @@ var ReadonlyRepository_1 = require("./config/ReadonlyRepository");
 Object.defineProperty(exports, "ReadonlyRepository", { enumerable: true, get: function () { return ReadonlyRepository_1.ReadonlyRepository; } });
 var GenericRepository_1 = require("./config/GenericRepository");
 Object.defineProperty(exports, "GenericRepository", { enumerable: true, get: function () { return GenericRepository_1.GenericRepository; } });
-var ArchiveConfig_1 = require("./config/ArchiveConfig");
-Object.defineProperty(exports, "ArchiveConfig", { enumerable: true, get: function () { return ArchiveConfig_1.ArchiveConfig; } });
 var CacheProviders_1 = require("./model/CacheProviders");
 Object.defineProperty(exports, "CacheProviders", { enumerable: true, get: function () { return CacheProviders_1.CacheProviders; } });
 var FirestoreInstance_1 = require("./config/FirestoreInstance");

package/dist/model/CacheProviders.js

@@ -5,4 +5,4 @@ var CacheProviders;
 (function (CacheProviders) {
     CacheProviders["LOCAL"] = "LOCAL";
     CacheProviders["REDIS"] = "REDIS";
-})(CacheProviders = exports.CacheProviders || (exports.CacheProviders = {}));
+})(CacheProviders || (exports.CacheProviders = CacheProviders = {}));

package/dist/query/ManualQueryHelper.js

@@ -37,7 +37,7 @@ class ManualQueryHelper {
             try {
                 // The ArchiveService now manages the cache internally based on the configuration
                 const archivedData = await archiveService.getArchivedDocument(collectionName, doc);
-                const markerKey = ArchiveService_1.ArchiveService.markerKey();
+                const markerKey = archiveService.markerKey();
                 if (archivedData && markerKey) {
                     // Merges the stub data with the archived data
                     // Preserve the marker from stub to prevent archivedData from overwriting it

package/dist/query/QueryPredicateFunctionTransform.js

@@ -80,9 +80,7 @@ class QueryPredicateFunctionTransform {
             aggregateSum: firestore_1.AggregateField.sum,
             aggregateCount: firestore_1.AggregateField.count,
             startTracer: Tracer_1.startTracer,
-            archiveService: ArchiveService_1.ArchiveService.getInstance(),
-            getArchivePath: ArchiveService_1.ArchiveService.getArchivePath,
-            markerKey: ArchiveService_1.ArchiveService.markerKey,
+            archiveService: ArchiveService_1.ArchiveService.getInstance()
         };
         if (!options?.collection) {
             throw new Error(`Collection is required`);

package/dist/template/FunctionCreateOrUpdateTemplate.txt

@@ -27,9 +27,11 @@ createOrUpdate(items) {
                     if (!item.id) item.id = uuid();
                     return item;
                 });
+
+                const archiveIsEnabled = archiveService.isEnabled()
                 
                 const docRefs = itemsWithIds.map(item => collection.doc(item.id));
-                const existingDocs = (archiveService.isEnabled() && docRefs.length > 0)
+                const existingDocs = (archiveIsEnabled && docRefs.length > 0)
                     ? yield db.getAll(...docRefs)
                     : [];
                 
@@ -41,9 +43,9 @@ createOrUpdate(items) {
                     let shouldUnarchive = false;
                     
                     // VERIFICAÇÃO DE DOCUMENTO ARQUIVADO
-                    if (archiveService.isEnabled() && existingDocs[i]?.exists) {
+                    if (archiveIsEnabled && existingDocs[i]?.exists) {
                         const currentData = existingDocs[i].data();
-                        const archivePath = global.instances.getArchivePath(currentData);
+                        const archivePath = archiveService.getArchivePath(currentData);
                         if (currentData && archivePath) {
                             const updateResult = yield archiveService.updateArchivedDocument(
                                 '<COLLECTION_REPLACE>',
@@ -81,9 +83,9 @@ createOrUpdate(items) {
                         itemData.ttlExpirationAt = getTtlTimestamp(ttlExpirationIn, ttlUnit);
                     }
 
-                    if (shouldUnarchive && global.instances.markerKey()) {
+                    if (shouldUnarchive && archiveService.markerKey()) {
                         const FieldValue = global.instances.FieldValue;
-                        itemData[global.instances.markerKey()] = FieldValue.delete();
+                        itemData[archiveService.markerKey()] = FieldValue.delete();
                     }
 
                     batch.set(docRef, itemData, { merge: true });

package/dist/template/FunctionDeleteTemplate.txt

@@ -16,17 +16,18 @@ delete(ids) {
                 const archiveService = yield global.instances.archiveService;
                 const batch = db.batch();
                 const collection = db.collection('<COLLECTION_REPLACE>');
+
+                const archiveIsEnabled = archiveService.isEnabled();
                 
-                // Verificar quais documentos estão arquivados antes de deletar
                 const archivedDocs = [];
-                if (archiveService.isEnabled()) {
+                if (archiveIsEnabled) {
                     const docRefs = ids.map(id => collection.doc(id));
                     const docs = docRefs.length > 0 ? yield db.getAll(...docRefs) : [];
                     for (let i = 0; i < docs.length; i++) {
                         const doc = docs[i];
                         if (doc && doc.exists) {
                             const data = doc.data();
-                            const archivePath = global.instances.getArchivePath(data);
+                            const archivePath = archiveService.getArchivePath(data);
                             if (data && archivePath) {
                                 archivedDocs.push({ id: ids[i], archivePath });
                             }
@@ -42,7 +43,7 @@ delete(ids) {
                     yield batch.commit();
                     
                     // Deletar arquivos do Storage para documentos arquivados
-                    if (archiveService.isEnabled() && archivedDocs.length > 0) {
+                    if (archiveIsEnabled && archivedDocs.length > 0) {
                         const deletePromises = archivedDocs.map(({ id: docId, archivePath }) => 
                             archiveService.deleteArchivedDocument('<COLLECTION_REPLACE>', docId, archivePath)
                                 .catch(err => {

package/dist/template/FunctionFindAllTemplate.txt

@@ -25,7 +25,6 @@ findAll(paging) {
                     items.push({ ...doc.data(), id: doc.id });
                 });
                 
-                // VERIFICAÇÃO DE ARQUIVAMENTO PARA MÚLTIPLOS DOCUMENTOS
                 if (archiveService.isEnabled()) {
                     const archivedIndexes = [];
                     items.forEach((item, index) => {

package/dist/template/FunctionUpdatePartialTemplate.txt

@@ -12,14 +12,14 @@ updatePartial(id, item) {
                 const document = db.collection('<COLLECTION_REPLACE>').doc(id);
                 
                 let shouldUnarchive = false;
+                const archiveIsEnabled = archiveService.isEnabled()
                 
-                // VERIFICAÇÃO DE DOCUMENTO ARQUIVADO
-                if (archiveService.isEnabled()) {
+                if (archiveIsEnabled) {
                     const currentDoc = yield document.get();
                     
                     if (currentDoc.exists) {
                         const currentData = currentDoc.data();
-                        const archivePath = global.instances.getArchivePath(currentData);
+                        const archivePath = archiveService.getArchivePath(currentData);
 
                         if (currentData && archivePath) {
                             const updateResult = yield archiveService.updateArchivedDocument(
@@ -48,9 +48,9 @@ updatePartial(id, item) {
                         updateTimestampAt
                     };
 
-                    if (shouldUnarchive && global.instances.markerKey()) {
+                    if (shouldUnarchive && archiveService.markerKey()) {
                         const FieldValue = global.instances.FieldValue;
-                        itemData[global.instances.markerKey()] = FieldValue.delete();
+                        itemData[archiveService.markerKey()] = FieldValue.delete();
                     }
 
                     yield document.set(itemData, { merge: true });

package/dist/template/FunctionUpdateTemplate.txt

@@ -29,9 +29,10 @@ update(items) {
                     }
                 }
                 
+                const archiveIsEnabled = archiveService.isEnabled()
                 // Buscar documentos existentes em lote (otimização)
                 const docRefs = items.map(item => collection.doc(item.id));
-                const existingDocs = (archiveService.isEnabled() && docRefs.length > 0)
+                const existingDocs = (archiveIsEnabled && docRefs.length > 0)
                     ? yield db.getAll(...docRefs)
                     : [];
                 
@@ -42,10 +43,9 @@ update(items) {
                     const docRef = docRefs[i];
                     let shouldUnarchive = false;
                     
-                    // VERIFICAÇÃO DE DOCUMENTO ARQUIVADO
-                    if (archiveService.isEnabled() && existingDocs[i]?.exists) {
+                    if (archiveIsEnabled && existingDocs[i]?.exists) {
                         const currentData = existingDocs[i].data();
-                        const archivePath = global.instances.getArchivePath(currentData);
+                        const archivePath = archiveService.getArchivePath(currentData);
 
                         if (currentData && archivePath) {
                             const updateResult = yield archiveService.updateArchivedDocument(
@@ -76,9 +76,9 @@ update(items) {
                         itemData.ttlExpirationAt = getTtlTimestamp(ttlExpirationIn, ttlUnit);
                     }
 
-                    if (shouldUnarchive && global.instances.markerKey()) {
+                    if (shouldUnarchive && archiveService.markerKey()) {
                         const FieldValue = global.instances.FieldValue;
-                        itemData[global.instances.markerKey()] = FieldValue.delete();
+                        itemData[archiveService.markerKey()] = FieldValue.delete();
                     }
 
                     batch.set(docRef, itemData, { merge: true });