s3db.js 12.1.0 → 12.2.0

package/src/plugins/concerns/plugin-dependencies.js

@@ -16,81 +16,97 @@
 export const PLUGIN_DEPENDENCIES = {
   'postgresql-replicator': {
     name: 'PostgreSQL Replicator',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/replicator.md',
     dependencies: {
       'pg': {
         version: '^8.0.0',
         description: 'PostgreSQL client for Node.js',
-        installCommand: 'pnpm add pg'
+        installCommand: 'pnpm add pg',
+        npmUrl: 'https://www.npmjs.com/package/pg'
       }
     }
   },
   'bigquery-replicator': {
     name: 'BigQuery Replicator',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/replicator.md',
     dependencies: {
       '@google-cloud/bigquery': {
         version: '^7.0.0',
         description: 'Google Cloud BigQuery SDK',
-        installCommand: 'pnpm add @google-cloud/bigquery'
+        installCommand: 'pnpm add @google-cloud/bigquery',
+        npmUrl: 'https://www.npmjs.com/package/@google-cloud/bigquery'
       }
     }
   },
   'sqs-replicator': {
     name: 'SQS Replicator',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/replicator.md',
     dependencies: {
       '@aws-sdk/client-sqs': {
         version: '^3.0.0',
         description: 'AWS SDK for SQS',
-        installCommand: 'pnpm add @aws-sdk/client-sqs'
+        installCommand: 'pnpm add @aws-sdk/client-sqs',
+        npmUrl: 'https://www.npmjs.com/package/@aws-sdk/client-sqs'
       }
     }
   },
   'sqs-consumer': {
     name: 'SQS Queue Consumer',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/queue-consumer.md',
     dependencies: {
       '@aws-sdk/client-sqs': {
         version: '^3.0.0',
         description: 'AWS SDK for SQS',
-        installCommand: 'pnpm add @aws-sdk/client-sqs'
+        installCommand: 'pnpm add @aws-sdk/client-sqs',
+        npmUrl: 'https://www.npmjs.com/package/@aws-sdk/client-sqs'
       }
     }
   },
   'rabbitmq-consumer': {
     name: 'RabbitMQ Queue Consumer',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/queue-consumer.md',
     dependencies: {
       'amqplib': {
         version: '^0.10.0',
         description: 'AMQP 0-9-1 library for RabbitMQ',
-        installCommand: 'pnpm add amqplib'
+        installCommand: 'pnpm add amqplib',
+        npmUrl: 'https://www.npmjs.com/package/amqplib'
       }
     }
   },
   'tfstate-plugin': {
-    name: 'Terraform State Plugin',
+    name: 'Tfstate Plugin',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/tfstate.md',
     dependencies: {
       'node-cron': {
         version: '^4.0.0',
         description: 'Cron job scheduler for auto-sync functionality',
-        installCommand: 'pnpm add node-cron'
+        installCommand: 'pnpm add node-cron',
+        npmUrl: 'https://www.npmjs.com/package/node-cron'
       }
     }
   },
   'api-plugin': {
     name: 'API Plugin',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/api.md',
     dependencies: {
       'hono': {
         version: '^4.0.0',
         description: 'Ultra-light HTTP server framework',
-        installCommand: 'pnpm add hono'
+        installCommand: 'pnpm add hono',
+        npmUrl: 'https://www.npmjs.com/package/hono'
       },
       '@hono/node-server': {
         version: '^1.0.0',
         description: 'Node.js adapter for Hono',
-        installCommand: 'pnpm add @hono/node-server'
+        installCommand: 'pnpm add @hono/node-server',
+        npmUrl: 'https://www.npmjs.com/package/@hono/node-server'
       },
       '@hono/swagger-ui': {
         version: '^0.4.0',
         description: 'Swagger UI integration for Hono',
-        installCommand: 'pnpm add @hono/swagger-ui'
+        installCommand: 'pnpm add @hono/swagger-ui',
+        npmUrl: 'https://www.npmjs.com/package/@hono/swagger-ui'
       }
     }
   }
@@ -229,22 +245,60 @@ export async function requirePluginDependency(pluginId, options = {}) {
 
   // Throw comprehensive error if validation failed
   if (!valid && throwOnError) {
+    const depCount = Object.keys(pluginDef.dependencies).length;
+    const missingCount = missing.length;
+    const incompatCount = incompatible.length;
+
     const errorMsg = [
-      `\n${pluginDef.name} - Missing dependencies detected!\n`,
-      `Plugin ID: ${pluginId}`,
       '',
+      '╔══════════════════════════════════════════════════════════════════════╗',
+      `║  ❌ ${pluginDef.name} - Missing Dependencies  ║`,
+      '╚══════════════════════════════════════════════════════════════════════╝',
+      '',
+      `📦 Plugin: ${pluginId}`,
+      `📊 Status: ${depCount - missingCount - incompatCount}/${depCount} dependencies satisfied`,
+      '',
+      '🔍 Dependency Status:',
+      '─────────────────────────────────────────────────────────────────────',
       ...messages,
       '',
-      'Quick fix - Run all install commands:',
-      Object.values(pluginDef.dependencies)
-        .map(dep => `  ${dep.installCommand}`)
-        .join('\n'),
+      '🚀 Quick Fix - Install Missing Dependencies:',
+      '─────────────────────────────────────────────────────────────────────',
+      '',
+      '  Option 1: Install individually',
+      ...Object.entries(pluginDef.dependencies)
+        .filter(([pkg]) => missing.includes(pkg) || incompatible.includes(pkg))
+        .map(([pkg, info]) => `    ${info.installCommand}`),
+      '',
+      '  Option 2: Install all at once',
+      `    pnpm add ${Object.keys(pluginDef.dependencies).join(' ')}`,
       '',
-      'Or install all peer dependencies at once:',
-      `  pnpm add ${Object.keys(pluginDef.dependencies).join(' ')}`
+      '📚 Documentation:',
+      `    ${pluginDef.docsUrl}`,
+      '',
+      '💡 Troubleshooting:',
+      '  • If packages are installed but not detected, try:',
+      '    1. Delete node_modules and reinstall: rm -rf node_modules && pnpm install',
+      '    2. Check Node.js version: node --version (requires Node 18+)',
+      '    3. Verify pnpm version: pnpm --version (requires pnpm 8+)',
+      '',
+      '  • Still having issues? Check:',
+      '    - Package.json has correct dependencies listed',
+      '    - No conflicting versions in pnpm-lock.yaml',
+      '    - File permissions (especially in node_modules/)',
+      '',
+      '═══════════════════════════════════════════════════════════════════════',
+      ''
     ].join('\n');
 
-    throw new Error(errorMsg);
+    const error = new Error(errorMsg);
+    error.pluginId = pluginId;
+    error.pluginName = pluginDef.name;
+    error.missing = missing;
+    error.incompatible = incompatible;
+    error.docsUrl = pluginDef.docsUrl;
+
+    throw error;
   }
 
   return { valid, missing, incompatible, messages };

package/src/plugins/eventual-consistency/analytics.js

@@ -559,8 +559,6 @@ async function getAnalyticsForRecord(resourceName, field, recordId, options, han
     return [];
   }
 
-  // ✅ FIX BUG #2: Ensure all transactions have cohortHour calculated
-  // This handles legacy data that may be missing cohortHour
   allTransactions = ensureCohortHours(allTransactions, handler.config?.cohort?.timezone || 'UTC', false);
 
   // Filter transactions by temporal range

package/src/plugins/eventual-consistency/consolidation.js

@@ -286,9 +286,7 @@ export async function consolidateRecord(
 
         if (!hasSetInApplied) {
           // No 'set' operation in applied transactions means we're missing the base value
-          // This can only happen if:
-          // 1. Record had an initial value before first transaction
-          // 2. First consolidation didn't create an anchor transaction (legacy behavior)
+          // This can happen if record had an initial value before first transaction
           // Solution: Get the current record value and create an anchor transaction now
           const recordValue = recordExists[config.field] || 0;
 
@@ -525,7 +523,6 @@ export async function consolidateRecord(
       updateResult = result[2];
     }
 
-    // For backward compatibility, return the value of the main field
     const consolidatedValue = consolidatedValues[config.field] ||
                              (record ? lodash.get(record, config.field, 0) : 0);
 
@@ -610,13 +607,10 @@ export async function consolidateRecord(
 
       const { results, errors } = await PromisePool
         .for(transactionsToUpdate)
-        .withConcurrency(markAppliedConcurrency) // ✅ Configurável e maior!
+        .withConcurrency(markAppliedConcurrency)
         .process(async (txn) => {
-          // ✅ FIX BUG #3: Ensure cohort fields exist before marking as applied
-          // This handles legacy transactions missing cohortHour, cohortDate, etc.
           const txnWithCohorts = ensureCohortHour(txn, config.cohort.timezone, false);
 
-          // Build update data with applied flag
           const updateData = { applied: true };
 
           // Add missing cohort fields if they were calculated
@@ -633,11 +627,6 @@ export async function consolidateRecord(
             updateData.cohortMonth = txnWithCohorts.cohortMonth;
           }
 
-          // Handle null value field (legacy data might have null)
-          if (txn.value === null || txn.value === undefined) {
-            updateData.value = 1; // Default to 1 for backward compatibility
-          }
-
           const [ok, err] = await tryFn(() =>
             transactionResource.update(txn.id, updateData)
           );

package/src/plugins/eventual-consistency/index.js

@@ -183,7 +183,6 @@ export class EventualConsistencyPlugin extends Plugin {
    * @private
    */
   async _syncModeConsolidate(handler, id, field) {
-    // Temporarily set config for legacy methods
     const oldResource = this.config.resource;
     const oldField = this.config.field;
     const oldTransactionResource = this.transactionResource;

package/src/plugins/eventual-consistency/install.js

@@ -100,7 +100,7 @@ export async function completeFieldSetup(handler, database, config, plugin) {
         operation: 'string|required',
         timestamp: 'string|required',
         cohortDate: 'string|required',
-        cohortHour: 'string|optional',  // ✅ FIX BUG #2: Changed from required to optional for migration compatibility
+        cohortHour: 'string|required',
         cohortWeek: 'string|optional',
         cohortMonth: 'string|optional',
         source: 'string|optional',

package/src/plugins/geo.plugin.js

@@ -127,7 +127,7 @@ class GeoPlugin extends Plugin {
       return;
     }
 
-    const resource = this.database.resource(resourceName);
+    const resource = this.database.resources[resourceName];
     if (!resource || typeof resource.addHook !== 'function') {
       if (this.verbose) {
         console.warn(`[GeoPlugin] Resource "${resourceName}" not found or invalid`);
@@ -325,14 +325,13 @@ class GeoPlugin extends Plugin {
      * Find nearby locations within radius
      * Automatically selects optimal zoom level if multi-zoom enabled
      */
-    resource.findNearby = async function({ lat, lon, lng, radius = 10, limit = 100 }) {
-      // Support both 'lon' and 'lng' for backward compatibility
-      const longitude = lon !== undefined ? lon : lng;
-
-      if (lat === undefined || longitude === undefined) {
+    resource.findNearby = async function({ lat, lon, radius = 10, limit = 100 }) {
+      if (lat === undefined || lon === undefined) {
         throw new Error('lat and lon are required for findNearby');
       }
 
+      const longitude = lon; // Alias for internal use
+
       let allRecords = [];
 
       // Use partitions if enabled for efficient queries

package/src/plugins/importer/index.js

@@ -739,7 +739,7 @@ export class ImporterPlugin extends Plugin {
   async onInstall() {
     // Get resource - database.resource() returns a rejected Promise if not found
     try {
-      this.resource = this.database.resource(this.resourceName);
+      this.resource = this.database.resources[this.resourceName];
       // If resource() returns a Promise, await it
       if (this.resource && typeof this.resource.then === 'function') {
         this.resource = await this.resource;

package/src/plugins/relation.plugin.js

@@ -416,7 +416,7 @@ class RelationPlugin extends Plugin {
    * @private
    */
   async _setupResourceRelations(resourceName, relationsDef) {
-    const resource = this.database.resource(resourceName);
+    const resource = this.database.resources[resourceName];
     if (!resource) {
       if (this.verbose) {
         console.warn(`[RelationPlugin] Resource "${resourceName}" not found, will setup when created`);
@@ -572,7 +572,7 @@ class RelationPlugin extends Plugin {
         for (const record of records) {
           const relatedData = record[relationName];
           if (relatedData) {
-            const relatedResource = this.database.resource(config.resource);
+            const relatedResource = this.database.resources[config.resource];
             const relatedArray = Array.isArray(relatedData) ? relatedData : [relatedData];
 
             if (relatedArray.length > 0) {
@@ -635,7 +635,7 @@ class RelationPlugin extends Plugin {
    * @private
    */
   async _loadHasOne(records, relationName, config, sourceResource) {
-    const relatedResource = this.database.resource(config.resource);
+    const relatedResource = this.database.resources[config.resource];
     if (!relatedResource) {
       throw new RelatedResourceNotFoundError(config.resource, {
         sourceResource: sourceResource.name,
@@ -689,7 +689,7 @@ class RelationPlugin extends Plugin {
    * @private
    */
   async _loadHasMany(records, relationName, config, sourceResource) {
-    const relatedResource = this.database.resource(config.resource);
+    const relatedResource = this.database.resources[config.resource];
     if (!relatedResource) {
       throw new RelatedResourceNotFoundError(config.resource, {
         sourceResource: sourceResource.name,
@@ -751,7 +751,7 @@ class RelationPlugin extends Plugin {
    * @private
    */
   async _loadBelongsTo(records, relationName, config, sourceResource) {
-    const relatedResource = this.database.resource(config.resource);
+    const relatedResource = this.database.resources[config.resource];
     if (!relatedResource) {
       throw new RelatedResourceNotFoundError(config.resource, {
         sourceResource: sourceResource.name,
@@ -818,7 +818,7 @@ class RelationPlugin extends Plugin {
    * @private
    */
   async _loadBelongsToMany(records, relationName, config, sourceResource) {
-    const relatedResource = this.database.resource(config.resource);
+    const relatedResource = this.database.resources[config.resource];
     if (!relatedResource) {
       throw new RelatedResourceNotFoundError(config.resource, {
         sourceResource: sourceResource.name,
@@ -826,7 +826,7 @@ class RelationPlugin extends Plugin {
       });
     }
 
-    const junctionResource = this.database.resource(config.through);
+    const junctionResource = this.database.resources[config.through];
     if (!junctionResource) {
       throw new JunctionTableNotFoundError(config.through, {
         sourceResource: sourceResource.name,
@@ -1077,7 +1077,7 @@ class RelationPlugin extends Plugin {
   async _cascadeDelete(record, resource, relationName, config) {
     this.stats.cascadeOperations++;
 
-    const relatedResource = this.database.resource(config.resource);
+    const relatedResource = this.database.resources[config.resource];
     if (!relatedResource) {
       throw new RelatedResourceNotFoundError(config.resource, {
         sourceResource: resource.name,
@@ -1087,7 +1087,7 @@ class RelationPlugin extends Plugin {
 
     // Track deleted records for rollback (if transactions enabled)
     const deletedRecords = [];
-    const junctionResource = config.type === 'belongsToMany' ? this.database.resource(config.through) : null;
+    const junctionResource = config.type === 'belongsToMany' ? this.database.resources[config.through] : null;
 
     try {
       if (config.type === 'hasMany') {
@@ -1156,7 +1156,7 @@ class RelationPlugin extends Plugin {
         }
       } else if (config.type === 'belongsToMany') {
         // Delete junction table entries - use partition if available
-        const junctionResource = this.database.resource(config.through);
+        const junctionResource = this.database.resources[config.through];
         if (junctionResource) {
           let junctionRecords;
           const partitionName = this._findPartitionByField(junctionResource, config.foreignKey);
@@ -1240,7 +1240,7 @@ class RelationPlugin extends Plugin {
   async _cascadeUpdate(record, changes, resource, relationName, config) {
     this.stats.cascadeOperations++;
 
-    const relatedResource = this.database.resource(config.resource);
+    const relatedResource = this.database.resources[config.resource];
     if (!relatedResource) {
       return;
     }

package/src/plugins/replicator.plugin.js

@@ -306,18 +306,6 @@ export class ReplicatorPlugin extends Plugin {
     // Plugin is ready
   }
 
-  async stop() {
-    // Stop all replicators
-    for (const replicator of this.replicators || []) {
-      if (replicator && typeof replicator.cleanup === 'function') {
-        await replicator.cleanup();
-      }
-    }
-    
-    // Remove database hooks
-    this.removeDatabaseHooks();
-  }
-
   installDatabaseHooks() {
     // Store hook reference for later removal
     this._afterCreateResourceHook = (resource) => {
@@ -730,21 +718,21 @@ export class ReplicatorPlugin extends Plugin {
     this.emit('replicator.sync.completed', { replicatorId, stats: this.stats });
   }
 
-  async cleanup() {
+  async stop() {
     const [ok, error] = await tryFn(async () => {
       if (this.replicators && this.replicators.length > 0) {
         const cleanupPromises = this.replicators.map(async (replicator) => {
           const [replicatorOk, replicatorError] = await tryFn(async () => {
-            if (replicator && typeof replicator.cleanup === 'function') {
-              await replicator.cleanup();
+            if (replicator && typeof replicator.stop === 'function') {
+              await replicator.stop();
             }
           });
-          
+
           if (!replicatorOk) {
             if (this.config.verbose) {
-              console.warn(`[ReplicatorPlugin] Failed to cleanup replicator ${replicator.name || replicator.id}: ${replicatorError.message}`);
+              console.warn(`[ReplicatorPlugin] Failed to stop replicator ${replicator.name || replicator.id}: ${replicatorError.message}`);
             }
-            this.emit('replicator_cleanup_error', {
+            this.emit('replicator_stop_error', {
               replicator: replicator.name || replicator.id || 'unknown',
               driver: replicator.driver || 'unknown',
               error: replicatorError.message
@@ -754,7 +742,10 @@ export class ReplicatorPlugin extends Plugin {
         
         await Promise.allSettled(cleanupPromises);
       }
-      
+
+      // Remove database hooks
+      this.removeDatabaseHooks();
+
       // Remove event listeners from resources to prevent memory leaks
       if (this.database && this.database.resources) {
         for (const resourceName of this.eventListenersInstalled) {
@@ -779,9 +770,9 @@ export class ReplicatorPlugin extends Plugin {
     
     if (!ok) {
       if (this.config.verbose) {
-        console.warn(`[ReplicatorPlugin] Failed to cleanup plugin: ${error.message}`);
+        console.warn(`[ReplicatorPlugin] Failed to stop plugin: ${error.message}`);
       }
-      this.emit('replicator_plugin_cleanup_error', {
+      this.emit('replicator_plugin_stop_error', {
         error: error.message
       });
     }

package/src/plugins/s3-queue.plugin.js

@@ -42,22 +42,22 @@ import { idGenerator } from "../concerns/id.js";
  * === Usage ===
  *
  * // Enqueue a message
- * await db.resource('emails').enqueue({
+ * await db.resources.emails.enqueue({
  *   to: 'user@example.com',
  *   subject: 'Hello',
  *   body: 'World'
  * });
  *
  * // Start processing (if not auto-started)
- * await db.resource('emails').startProcessing(async (email) => {
+ * await db.resources.emails.startProcessing(async (email) => {
  *   await sendEmail(email);
  * }, { concurrency: 10 });
  *
  * // Stop processing
- * await db.resource('emails').stopProcessing();
+ * await db.resources.emails.stopProcessing();
  *
  * // Get queue statistics
- * const stats = await db.resource('emails').queueStats();
+ * const stats = await db.resources.emails.queueStats();
  * // { total: 100, pending: 50, processing: 20, completed: 25, failed: 5, dead: 0 }
  */
 export class S3QueuePlugin extends Plugin {

package/src/plugins/scheduler.plugin.js

@@ -30,11 +30,11 @@ import { SchedulerError } from "./scheduler.errors.js";
  *       schedule: '0 3 * * *',
  *       description: 'Clean up expired records',
  *       action: async (database, context) => {
- *         const expired = await this.database.resource('sessions')
+ *         const expired = await this.database.resources['sessions')
  *           .list({ where: { expiresAt: { $lt: new Date() } } });
  *         
  *         for (const record of expired) {
- *           await this.database.resource('sessions').delete(record.id);
+ *           await this.database.resources['sessions').delete(record.id);
  *         }
  *         
  *         return { deleted: expired.length };
@@ -49,8 +49,8 @@ import { SchedulerError } from "./scheduler.errors.js";
  *       schedule: '0 9 * * MON',
  *       description: 'Generate weekly analytics report',
  *       action: async (database, context) => {
- *         const users = await this.database.resource('users').count();
- *         const orders = await this.database.resource('orders').count({
+ *         const users = await this.database.resources['users').count();
+ *         const orders = await this.database.resources['orders').count({
  *           where: { 
  *             createdAt: { 
  *               $gte: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000) 
@@ -65,7 +65,7 @@ import { SchedulerError } from "./scheduler.errors.js";
  *           createdAt: new Date().toISOString()
  *         };
  *         
- *         await this.database.resource('reports').insert(report);
+ *         await this.database.resources['reports').insert(report);
  *         return report;
  *       }
  *     },
@@ -107,7 +107,7 @@ import { SchedulerError } from "./scheduler.errors.js";
  *         const hourAgo = new Date(now.getTime() - 60 * 60 * 1000);
  *         
  *         // Aggregate metrics from the last hour
- *         const events = await this.database.resource('events').list({
+ *         const events = await this.database.resources['events').list({
  *           where: { 
  *             timestamp: { 
  *               $gte: hourAgo.getTime(),
@@ -121,7 +121,7 @@ import { SchedulerError } from "./scheduler.errors.js";
  *           return acc;
  *         }, {});
  *         
- *         await this.database.resource('hourly_metrics').insert({
+ *         await this.database.resources['hourly_metrics').insert({
  *           hour: hourAgo.toISOString().slice(0, 13),
  *           metrics: aggregated,
  *           total: events.length,
@@ -577,7 +577,7 @@ export class SchedulerPlugin extends Plugin {
 
   async _persistJobExecution(jobName, executionId, startTime, endTime, duration, status, result, error, retryCount) {
     const [ok, err] = await tryFn(() => 
-      this.database.resource(this.config.jobHistoryResource).insert({
+      this.database.resources[this.config.jobHistoryResource].insert({
         id: executionId,
         jobName,
         status,
@@ -741,7 +741,7 @@ export class SchedulerPlugin extends Plugin {
 
     // Use query() to leverage partitions instead of list() + filter
     const [ok, err, history] = await tryFn(() =>
-      this.database.resource(this.config.jobHistoryResource).query(queryParams)
+      this.database.resources[this.config.jobHistoryResource].query(queryParams)
     );
 
     if (!ok) {
@@ -914,10 +914,8 @@ export class SchedulerPlugin extends Plugin {
     if (this._isTestEnvironment()) {
       this.activeJobs.clear();
     }
-  }
 
-  async cleanup() {
-    await this.stop();
+    // Cleanup resources
     this.jobs.clear();
     this.statistics.clear();
     this.activeJobs.clear();

package/src/plugins/state-machine.plugin.js

@@ -62,7 +62,7 @@ import { StateMachineError } from "./state-machine.errors.js";
  *   
  *   actions: {
  *     onConfirmed: async (context, event, machine) => {
- *       await machine.this.database.resource('inventory').update(context.productId, {
+ *       await machine.this.database.resources['inventory'].update(context.productId, {
  *         quantity: { $decrement: context.quantity }
  *       });
  *       await machine.sendNotification(context.customerEmail, 'order_confirmed');
@@ -74,7 +74,7 @@ import { StateMachineError } from "./state-machine.errors.js";
  *   
  *   guards: {
  *     canShip: async (context, event, machine) => {
- *       const inventory = await machine.this.database.resource('inventory').get(context.productId);
+ *       const inventory = await machine.this.database.resources['inventory'].get(context.productId);
  *       return inventory.quantity >= context.quantity;
  *     }
  *   },
@@ -352,7 +352,7 @@ export class StateMachinePlugin extends Plugin {
 
       for (let attempt = 0; attempt < this.config.retryAttempts; attempt++) {
         const [ok, err] = await tryFn(() =>
-          this.database.resource(this.config.transitionLogResource).insert({
+          this.database.resources[this.config.transitionLogResource].insert({
             id: transitionId,
             machineId,
             entityId,
@@ -395,13 +395,13 @@ export class StateMachinePlugin extends Plugin {
 
       // Try update first (most common case), fallback to insert if doesn't exist
       const [updateOk] = await tryFn(() =>
-        this.database.resource(this.config.stateResource).update(stateId, stateData)
+        this.database.resources[this.config.stateResource].update(stateId, stateData)
       );
 
       if (!updateOk) {
         // Record doesn't exist, insert it
         const [insertOk, insertErr] = await tryFn(() =>
-          this.database.resource(this.config.stateResource).insert({ id: stateId, ...stateData })
+          this.database.resources[this.config.stateResource].insert({ id: stateId, ...stateData })
         );
 
         if (!insertOk && this.config.verbose) {
@@ -476,7 +476,7 @@ export class StateMachinePlugin extends Plugin {
     if (this.config.persistTransitions) {
       const stateId = `${machineId}_${entityId}`;
       const [ok, err, stateRecord] = await tryFn(() => 
-        this.database.resource(this.config.stateResource).get(stateId)
+        this.database.resources[this.config.stateResource].get(stateId)
       );
       
       if (ok && stateRecord) {
@@ -530,7 +530,7 @@ export class StateMachinePlugin extends Plugin {
     const { limit = 50, offset = 0 } = options;
 
     const [ok, err, transitions] = await tryFn(() =>
-      this.database.resource(this.config.transitionLogResource).query({
+      this.database.resources[this.config.transitionLogResource].query({
         machineId,
         entityId
       }, {
@@ -581,7 +581,7 @@ export class StateMachinePlugin extends Plugin {
 
       // Try to insert, ignore if already exists (idempotent)
       const [ok, err] = await tryFn(() =>
-        this.database.resource(this.config.stateResource).insert({
+        this.database.resources[this.config.stateResource].insert({
           id: stateId,
           machineId,
           entityId,
@@ -682,10 +682,6 @@ export class StateMachinePlugin extends Plugin {
 
   async stop() {
     this.machines.clear();
-  }
-
-  async cleanup() {
-    await this.stop();
     this.removeAllListeners();
   }
 }

package/src/plugins/tfstate/README.md

@@ -740,6 +740,6 @@ Verificar que partitions são rápidas:
 
 ## 📚 References
 
-- [Terraform State Format](https://www.terraform.io/internals/json-format)
+- [Tfstate Format](https://www.terraform.io/internals/json-format)
 - [s3db Partitioning Guide](../../docs/partitioning.md)
 - [Plugin Development](../../docs/plugins.md)