s3db.js 7.3.4 → 7.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s3db.js",
-  "version": "7.3.4",
+  "version": "7.3.6",
   "description": "Use AWS S3, the world's most reliable document storage, as a database with this ORM.",
   "main": "dist/s3db.cjs.js",
   "module": "dist/s3db.es.js",
@@ -10,6 +10,9 @@
   "jsdelivr": "dist/s3db.iife.min.js",
   "author": "@stone/martech",
   "license": "UNLICENSED",
+  "bin": {
+    "s3db-mcp": "./mcp/server.js"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/forattini-dev/s3db.js.git"
@@ -26,6 +29,9 @@
   "type": "module",
   "sideEffects": false,
   "imports": {
+    "#mcp/*": "./mcp/*",
+    "#dist/*": "./dist/*",
+    "#examples/*": "./examples/*",
     "#src/*": "./src/*",
     "#tests/*": "./tests/*"
   },
@@ -43,27 +49,6 @@
     "PLUGINS.md",
     "UNLICENSE"
   ],
-  "scripts": {
-    "build": "rollup -c",
-    "dev": "rollup -c -w",
-    "test": "npm run test:js && npm run test:ts",
-    "test:js": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand",
-    "test:ts": "tsc --noEmit --project tests/typescript/tsconfig.json",
-    "test:js-converage": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --detectOpenHandles --coverage --runInBand",
-    "test:js-ai": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --detectOpenHandles --runInBand",
-    "test:full": "npm run test:js && npm run test:ts",
-    "test:cache": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/plugin-cache*.test.js --runInBand",
-    "test:quick": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand --testTimeout=10000",
-    "test:batch": "./test-batch.sh",
-    "test:plugins": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/ --runInBand --testTimeout=60000",
-    "test:plugins:fast": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/ --runInBand --testTimeout=15000 --testPathIgnorePatterns='plugin-audit.test.js|plugin-replicator-s3db.test.js|plugin-fulltext.test.js'",
-    "test:slow": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/plugin-audit.test.js tests/plugins/plugin-replicator-s3db.test.js tests/plugins/plugin-fulltext.test.js --runInBand --testTimeout=120000",
-    "test:types": "tsc --noEmit --project tests/typescript/tsconfig.json",
-    "test:types:basic": "tsc --noEmit tests/typescript/basic-usage.test.ts",
-    "test:types:direct": "tsc --noEmit tests/typescript/direct-type-test.ts",
-    "test:types:watch": "tsc --noEmit --watch --project tests/typescript/tsconfig.json",
-    "validate:types": "npm run test:types && echo 'TypeScript definitions are valid!'"
-  },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.848.0",
     "@supercharge/promise-pool": "^3.2.0",
@@ -115,5 +100,26 @@
   },
   "funding": [
     "https://github.com/sponsors/forattini-dev"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "npm run test:js && npm run test:ts",
+    "test:js": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand",
+    "test:ts": "tsc --noEmit --project tests/typescript/tsconfig.json",
+    "test:js-converage": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --detectOpenHandles --coverage --runInBand",
+    "test:js-ai": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --detectOpenHandles --runInBand",
+    "test:full": "npm run test:js && npm run test:ts",
+    "test:cache": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/plugin-cache*.test.js --runInBand",
+    "test:quick": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand --testTimeout=10000",
+    "test:batch": "./test-batch.sh",
+    "test:plugins": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/ --runInBand --testTimeout=60000",
+    "test:plugins:fast": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/ --runInBand --testTimeout=15000 --testPathIgnorePatterns='plugin-audit.test.js|plugin-replicator-s3db.test.js|plugin-fulltext.test.js'",
+    "test:slow": "node --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/plugin-audit.test.js tests/plugins/plugin-replicator-s3db.test.js tests/plugins/plugin-fulltext.test.js --runInBand --testTimeout=120000",
+    "test:types": "tsc --noEmit --project tests/typescript/tsconfig.json",
+    "test:types:basic": "tsc --noEmit tests/typescript/basic-usage.test.ts",
+    "test:types:direct": "tsc --noEmit tests/typescript/direct-type-test.ts",
+    "test:types:watch": "tsc --noEmit --watch --project tests/typescript/tsconfig.json",
+    "validate:types": "npm run test:types && echo 'TypeScript definitions are valid!'"
+  }
+}

package/src/database.class.js

@@ -74,15 +74,17 @@ export class Database extends EventEmitter {
     // Add process exit listener for cleanup
     if (!this._exitListenerRegistered) {
       this._exitListenerRegistered = true;
-      process.on('exit', async () => {
-        if (this.isConnected()) {
-          try {
-            await this.disconnect();
-          } catch (err) {
-            // Silently ignore errors on exit
+      if (typeof process !== 'undefined') {
+        process.on('exit', async () => {
+          if (this.isConnected()) {
+            try {
+              await this.disconnect();
+            } catch (err) {
+              // Silently ignore errors on exit
+            }
           }
-        }
-      });
+        });
+      }
     }
   }
   

package/src/plugins/cache/filesystem-cache.class.js

@@ -428,6 +428,15 @@ export class FilesystemCache extends Cache {
 
   async _clear(prefix) {
     try {
+      // Check if directory exists before trying to read it
+      if (!await this._fileExists(this.directory)) {
+        // Directory doesn't exist, nothing to clear
+        if (this.enableStats) {
+          this.stats.clears++;
+        }
+        return true;
+      }
+      
       const files = await readdir(this.directory);
       const cacheFiles = files.filter(file => {
         if (!file.startsWith(this.prefix)) return false;

package/src/plugins/metrics.plugin.js

@@ -33,7 +33,7 @@ export class MetricsPlugin extends Plugin {
 
   async setup(database) {
     this.database = database;
-    if (process.env.NODE_ENV === 'test') return;
+    if (typeof process !== 'undefined' && process.env.NODE_ENV === 'test') return;
 
     const [ok, err] = await tryFn(async () => {
       const [ok1, err1, metricsResource] = await tryFn(() => database.createResource({
@@ -90,7 +90,7 @@ export class MetricsPlugin extends Plugin {
     this.installMetricsHooks();
     
     // Disable flush timer during tests to avoid side effects
-    if (process.env.NODE_ENV !== 'test') {
+    if (typeof process !== 'undefined' && process.env.NODE_ENV !== 'test') {
       this.startFlushTimer();
     }
   }
@@ -107,7 +107,7 @@ export class MetricsPlugin extends Plugin {
     }
     
     // Don't flush metrics during tests
-    if (process.env.NODE_ENV !== 'test') {
+    if (typeof process !== 'undefined' && process.env.NODE_ENV !== 'test') {
       await this.flushMetrics();
     }
   }
@@ -328,11 +328,21 @@ export class MetricsPlugin extends Plugin {
     if (!this.metricsResource) return;
 
     const [ok, err] = await tryFn(async () => {
-      // Use empty metadata during tests to avoid header issues
-      const metadata = process.env.NODE_ENV === 'test' ? {} : { global: 'true' };
-      const perfMetadata = process.env.NODE_ENV === 'test' ? {} : { perf: 'true' };
-      const errorMetadata = process.env.NODE_ENV === 'test' ? {} : { error: 'true' };
-      const resourceMetadata = process.env.NODE_ENV === 'test' ? {} : { resource: 'true' };
+      let metadata, perfMetadata, errorMetadata, resourceMetadata;
+      
+      if (typeof process !== 'undefined' && process.env.NODE_ENV === 'test') {
+        // Use empty metadata during tests to avoid header issues
+        metadata = {};
+        perfMetadata = {};
+        errorMetadata = {};
+        resourceMetadata = {};
+      } else {
+        // Use empty metadata during tests to avoid header issues
+        metadata = { global: 'true' };
+        perfMetadata = { perf: 'true' };
+        errorMetadata = { error: 'true' };
+        resourceMetadata = { resource: 'true' };
+      }
 
       // Flush operation metrics
       for (const [operation, data] of Object.entries(this.metrics.operations)) {

package/src/plugins/replicator.plugin.js

@@ -1,5 +1,3 @@
-import { isPlainObject } from 'lodash-es';
-
 import Plugin from "./plugin.class.js";
 import tryFn from "../concerns/try-fn.js";
 import { createReplicator, validateReplicatorConfig } from "./replicators/index.js";
@@ -63,19 +61,13 @@ function normalizeResourceName(name) {
  *   2. Map: source resource → destination resource name:
  *        resources: { users: 'people' }
  *
- *   3. Map: source resource → [destination, transformer]:
- *        resources: { users: ['people', (el) => ({ ...el, fullName: el.name })] }
- *
- *   4. Map: source resource → { resource, transformer }:
- *        resources: { users: { resource: 'people', transformer: fn } }
- *
- *   5. Map: source resource → array of objects (multi-destination):
- *        resources: { users: [ { resource: 'people', transformer: fn } ] }
+ *   3. Map: source resource → { resource, transform }:
+ *        resources: { users: { resource: 'people', transform: fn } }
  *
- *   6. Map: source resource → function (transformer only):
+ *   4. Map: source resource → function (transformer only):
  *        resources: { users: (el) => ({ ...el, fullName: el.name }) }
  *
- * All forms can be mixed and matched. The transformer is always available (default: identity function).
+ * The transform function is optional and applies to data before replication.
  *
  * === Example Plugin Configurations ===
  *
@@ -95,10 +87,10 @@ function normalizeResourceName(name) {
  *     ]
  *   });
  *
- *   // Advanced mapping with transformer
+ *   // Advanced mapping with transform
  *   new ReplicatorPlugin({
  *     replicators: [
- *       { driver: 's3db', client: dbB, config: { resources: { users: ['people', (el) => ({ ...el, fullName: el.name })] } } }
+ *       { driver: 's3db', client: dbB, config: { resources: { users: { resource: 'people', transform: (el) => ({ ...el, fullName: el.name }) } } } }
  *     ]
  *   });
  *
@@ -179,27 +171,42 @@ export class ReplicatorPlugin extends Plugin {
     }
 
     resource.on('insert', async (data) => {
-      try {
+      const [ok, error] = await tryFn(async () => {
         const completeData = { ...data, createdAt: new Date().toISOString() };
         await plugin.processReplicatorEvent('insert', resource.name, completeData.id, completeData);
-      } catch (error) {
+      });
+      
+      if (!ok) {
+        if (this.config.verbose) {
+          console.warn(`[ReplicatorPlugin] Insert event failed for resource ${resource.name}: ${error.message}`);
+        }
         this.emit('error', { operation: 'insert', error: error.message, resource: resource.name });
       }
     });
 
     resource.on('update', async (data, beforeData) => {
-      try {
+      const [ok, error] = await tryFn(async () => {
         const completeData = { ...data, updatedAt: new Date().toISOString() };
         await plugin.processReplicatorEvent('update', resource.name, completeData.id, completeData, beforeData);
-      } catch (error) {
+      });
+      
+      if (!ok) {
+        if (this.config.verbose) {
+          console.warn(`[ReplicatorPlugin] Update event failed for resource ${resource.name}: ${error.message}`);
+        }
         this.emit('error', { operation: 'update', error: error.message, resource: resource.name });
       }
     });
 
     resource.on('delete', async (data) => {
-      try {
+      const [ok, error] = await tryFn(async () => {
         await plugin.processReplicatorEvent('delete', resource.name, data.id, data);
-      } catch (error) {
+      });
+      
+      if (!ok) {
+        if (this.config.verbose) {
+          console.warn(`[ReplicatorPlugin] Delete event failed for resource ${resource.name}: ${error.message}`);
+        }
         this.emit('error', { operation: 'delete', error: error.message, resource: resource.name });
       }
     });
@@ -221,14 +228,19 @@ export class ReplicatorPlugin extends Plugin {
   async setup(database) {
     this.database = database;
 
-    try {
+    const [initOk, initError] = await tryFn(async () => {
       await this.initializeReplicators(database);
-    } catch (error) {
-      this.emit('error', { operation: 'setup', error: error.message });
-      throw error;
+    });
+    
+    if (!initOk) {
+      if (this.config.verbose) {
+        console.warn(`[ReplicatorPlugin] Replicator initialization failed: ${initError.message}`);
+      }
+      this.emit('error', { operation: 'setup', error: initError.message });
+      throw initError;
     }
 
-    try {
+    const [logOk, logError] = await tryFn(async () => {
       if (this.config.replicatorLogResource) {
         const logRes = await database.createResource({
           name: this.config.replicatorLogResource,
@@ -245,8 +257,16 @@ export class ReplicatorPlugin extends Plugin {
           }
         });
       }
-    } catch (error) {
-      // Log resource creation failed, continue without it
+    });
+    
+    if (!logOk) {
+      if (this.config.verbose) {
+        console.warn(`[ReplicatorPlugin] Failed to create log resource ${this.config.replicatorLogResource}: ${logError.message}`);
+      }
+      this.emit('replicator_log_resource_creation_error', {
+        resourceName: this.config.replicatorLogResource,
+        error: logError.message
+      });
     }
 
     await this.uploadMetadataFile(database);
@@ -300,48 +320,33 @@ export class ReplicatorPlugin extends Plugin {
     // await this.processQueue(); // Removed as per edit hint
   }
 
-  filterInternalFields(data) {
-    if (!data || typeof data !== 'object') return data;
-    const filtered = {};
-    for (const [key, value] of Object.entries(data)) {
-      // Filter out internal fields that start with _ or $
-      if (!key.startsWith('_') && !key.startsWith('$')) {
-        filtered[key] = value;
-      }
-    }
-    return filtered;
-  }
-
   async uploadMetadataFile(database) {
     if (typeof database.uploadMetadataFile === 'function') {
       await database.uploadMetadataFile();
     }
   }
 
-  async getCompleteData(resource, data) {
-    try {
-      const [ok, err, record] = await tryFn(() => resource.get(data.id));
-      if (ok && record) {
-        return record;
-      }
-    } catch (error) {
-      // Fallback to provided data
-    }
-    return data;
-  }
-
   async retryWithBackoff(operation, maxRetries = 3) {
     let lastError;
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
-      try {
-        return await operation();
-      } catch (error) {
+      const [ok, error] = await tryFn(operation);
+      
+      if (ok) {
+        return ok;
+      } else {
         lastError = error;
+        if (this.config.verbose) {
+          console.warn(`[ReplicatorPlugin] Retry attempt ${attempt}/${maxRetries} failed: ${error.message}`);
+        }
+        
         if (attempt === maxRetries) {
           throw error;
         }
         // Simple backoff: wait 1s, 2s, 4s...
         const delay = Math.pow(2, attempt - 1) * 1000;
+        if (this.config.verbose) {
+          console.warn(`[ReplicatorPlugin] Waiting ${delay}ms before retry...`);
+        }
         await new Promise(resolve => setTimeout(resolve, delay));
       }
     }
@@ -349,7 +354,7 @@ export class ReplicatorPlugin extends Plugin {
   }
 
   async logError(replicator, resourceName, operation, recordId, data, error) {
-    try {
+    const [ok, logError] = await tryFn(async () => {
       const logResourceName = this.config.replicatorLogResource;
       if (this.database && this.database.resources && this.database.resources[logResourceName]) {
         const logResource = this.database.resources[logResourceName];
@@ -364,8 +369,20 @@ export class ReplicatorPlugin extends Plugin {
           status: 'error'
         });
       }
-    } catch (logError) {
-      // Silent log errors
+    });
+    
+    if (!ok) {
+      if (this.config.verbose) {
+        console.warn(`[ReplicatorPlugin] Failed to log error for ${resourceName}: ${logError.message}`);
+      }
+      this.emit('replicator_log_error', {
+        replicator: replicator.name || replicator.id,
+        resourceName,
+        operation,
+        recordId,
+        originalError: error.message,
+        logError: logError.message
+      });
     }
   }
 
@@ -382,7 +399,7 @@ export class ReplicatorPlugin extends Plugin {
     }
 
     const promises = applicableReplicators.map(async (replicator) => {
-      try {
+      const [ok, error, result] = await tryFn(async () => {
         const result = await this.retryWithBackoff(
           () => replicator.replicate(resourceName, operation, data, recordId, beforeData),
           this.config.maxRetries
@@ -398,7 +415,15 @@ export class ReplicatorPlugin extends Plugin {
         });
 
         return result;
-      } catch (error) {
+      });
+      
+      if (ok) {
+        return result;
+      } else {
+        if (this.config.verbose) {
+          console.warn(`[ReplicatorPlugin] Replication failed for ${replicator.name || replicator.id} on ${resourceName}: ${error.message}`);
+        }
+        
         this.emit('replicator_error', {
           replicator: replicator.name || replicator.id,
           resourceName,
@@ -429,12 +454,16 @@ export class ReplicatorPlugin extends Plugin {
     }
 
     const promises = applicableReplicators.map(async (replicator) => {
-      try {
+      const [wrapperOk, wrapperError] = await tryFn(async () => {
         const [ok, err, result] = await tryFn(() => 
           replicator.replicate(item.resourceName, item.operation, item.data, item.recordId, item.beforeData)
         );
 
         if (!ok) {
+          if (this.config.verbose) {
+            console.warn(`[ReplicatorPlugin] Replicator item processing failed for ${replicator.name || replicator.id} on ${item.resourceName}: ${err.message}`);
+          }
+          
           this.emit('replicator_error', {
             replicator: replicator.name || replicator.id,
             resourceName: item.resourceName,
@@ -460,20 +489,28 @@ export class ReplicatorPlugin extends Plugin {
         });
 
         return { success: true, result };
-      } catch (error) {
+      });
+      
+      if (wrapperOk) {
+        return wrapperOk;
+      } else {
+        if (this.config.verbose) {
+          console.warn(`[ReplicatorPlugin] Wrapper processing failed for ${replicator.name || replicator.id} on ${item.resourceName}: ${wrapperError.message}`);
+        }
+        
         this.emit('replicator_error', {
           replicator: replicator.name || replicator.id,
           resourceName: item.resourceName,
           operation: item.operation,
           recordId: item.recordId,
-          error: error.message
+          error: wrapperError.message
         });
 
         if (this.config.logErrors && this.database) {
-          await this.logError(replicator, item.resourceName, item.operation, item.recordId, item.data, error);
+          await this.logError(replicator, item.resourceName, item.operation, item.recordId, item.data, wrapperError);
         }
 
-        return { success: false, error: error.message };
+        return { success: false, error: wrapperError.message };
       }
     });
 
@@ -500,9 +537,14 @@ export class ReplicatorPlugin extends Plugin {
       timestamp: typeof item.timestamp === 'number' ? item.timestamp : Date.now(),
       createdAt: item.createdAt || new Date().toISOString().slice(0, 10),
     };
-    try {
+    const [ok, err] = await tryFn(async () => {
       await logRes.insert(logItem);
-    } catch (err) {
+    });
+    
+    if (!ok) {
+      if (this.config.verbose) {
+        console.warn(`[ReplicatorPlugin] Failed to log replicator item: ${err.message}`);
+      }
       this.emit('replicator.log.failed', { error: err, item });
     }
   }
@@ -637,15 +679,24 @@ export class ReplicatorPlugin extends Plugin {
   }
 
   async cleanup() {
-    try {
+    const [ok, error] = await tryFn(async () => {
       if (this.replicators && this.replicators.length > 0) {
         const cleanupPromises = this.replicators.map(async (replicator) => {
-          try {
+          const [replicatorOk, replicatorError] = await tryFn(async () => {
             if (replicator && typeof replicator.cleanup === 'function') {
               await replicator.cleanup();
             }
-          } catch (error) {
-            // Silent cleanup errors
+          });
+          
+          if (!replicatorOk) {
+            if (this.config.verbose) {
+              console.warn(`[ReplicatorPlugin] Failed to cleanup replicator ${replicator.name || replicator.id}: ${replicatorError.message}`);
+            }
+            this.emit('replicator_cleanup_error', {
+              replicator: replicator.name || replicator.id || 'unknown',
+              driver: replicator.driver || 'unknown',
+              error: replicatorError.message
+            });
           }
         });
         
@@ -657,8 +708,15 @@ export class ReplicatorPlugin extends Plugin {
       this.eventListenersInstalled.clear();
       
       this.removeAllListeners();
-    } catch (error) {
-      // Silent cleanup errors
+    });
+    
+    if (!ok) {
+      if (this.config.verbose) {
+        console.warn(`[ReplicatorPlugin] Failed to cleanup plugin: ${error.message}`);
+      }
+      this.emit('replicator_plugin_cleanup_error', {
+        error: error.message
+      });
     }
   }
 }

package/src/plugins/replicators/bigquery-replicator.class.js

@@ -115,6 +115,9 @@ class BigqueryReplicator extends BaseReplicator {
     await super.initialize(database);
     const [ok, err, sdk] = await tryFn(() => import('@google-cloud/bigquery'));
     if (!ok) {
+      if (this.config.verbose) {
+        console.warn(`[BigqueryReplicator] Failed to import BigQuery SDK: ${err.message}`);
+      }
       this.emit('initialization_error', { replicator: this.name, error: err.message });
       throw err;
     }
@@ -206,21 +209,32 @@ class BigqueryReplicator extends BaseReplicator {
             let lastError = null;
             
             for (let attempt = 1; attempt <= maxRetries; attempt++) {
-              try {
+              const [ok, error] = await tryFn(async () => {
                 const [updateJob] = await this.bigqueryClient.createQueryJob({
                   query,
                   params,
                   location: this.location
                 });
                 await updateJob.getQueryResults();
-                job = [updateJob];
+                return [updateJob];
+              });
+              
+              if (ok) {
+                job = ok;
                 break;
-              } catch (error) {
+              } else {
                 lastError = error;
                 
+                if (this.config.verbose) {
+                  console.warn(`[BigqueryReplicator] Update attempt ${attempt} failed: ${error.message}`);
+                }
+                
                 // If it's streaming buffer error and not the last attempt
                 if (error?.message?.includes('streaming buffer') && attempt < maxRetries) {
                   const delaySeconds = 30;
+                  if (this.config.verbose) {
+                    console.warn(`[BigqueryReplicator] Retrying in ${delaySeconds} seconds due to streaming buffer issue`);
+                  }
                   await new Promise(resolve => setTimeout(resolve, delaySeconds * 1000));
                   continue;
                 }
@@ -298,6 +312,9 @@ class BigqueryReplicator extends BaseReplicator {
     
     if (ok) return result;
     
+    if (this.config.verbose) {
+      console.warn(`[BigqueryReplicator] Replication failed for ${resourceName}: ${err.message}`);
+    }
     this.emit('replicator_error', {
       replicator: this.name,
       resourceName,
@@ -321,8 +338,14 @@ class BigqueryReplicator extends BaseReplicator {
         record.id, 
         record.beforeData
       ));
-      if (ok) results.push(res);
-      else errors.push({ id: record.id, error: err.message });
+      if (ok) {
+        results.push(res);
+      } else {
+        if (this.config.verbose) {
+          console.warn(`[BigqueryReplicator] Batch replication failed for record ${record.id}: ${err.message}`);
+        }
+        errors.push({ id: record.id, error: err.message });
+      }
     }
     
     return { 
@@ -340,6 +363,9 @@ class BigqueryReplicator extends BaseReplicator {
       return true;
     });
     if (ok) return true;
+    if (this.config.verbose) {
+      console.warn(`[BigqueryReplicator] Connection test failed: ${err.message}`);
+    }
     this.emit('connection_error', { replicator: this.name, error: err.message });
     return false;
   }

package/src/plugins/replicators/postgres-replicator.class.js

@@ -113,6 +113,9 @@ class PostgresReplicator extends BaseReplicator {
     await super.initialize(database);
     const [ok, err, sdk] = await tryFn(() => import('pg'));
     if (!ok) {
+      if (this.config.verbose) {
+        console.warn(`[PostgresReplicator] Failed to import pg SDK: ${err.message}`);
+      }
       this.emit('initialization_error', {
         replicator: this.name,
         error: err.message
@@ -276,6 +279,9 @@ class PostgresReplicator extends BaseReplicator {
       };
     });
     if (ok) return result;
+    if (this.config.verbose) {
+      console.warn(`[PostgresReplicator] Replication failed for ${resourceName}: ${err.message}`);
+    }
     this.emit('replicator_error', {
       replicator: this.name,
       resourceName,
@@ -298,8 +304,14 @@ class PostgresReplicator extends BaseReplicator {
         record.id, 
         record.beforeData
       ));
-      if (ok) results.push(res);
-      else errors.push({ id: record.id, error: err.message });
+      if (ok) {
+        results.push(res);
+      } else {
+        if (this.config.verbose) {
+          console.warn(`[PostgresReplicator] Batch replication failed for record ${record.id}: ${err.message}`);
+        }
+        errors.push({ id: record.id, error: err.message });
+      }
     }
     
     return { 
@@ -316,6 +328,9 @@ class PostgresReplicator extends BaseReplicator {
       return true;
     });
     if (ok) return true;
+    if (this.config.verbose) {
+      console.warn(`[PostgresReplicator] Connection test failed: ${err.message}`);
+    }
     this.emit('connection_error', { replicator: this.name, error: err.message });
     return false;
   }