s3db.js 12.0.1 → 12.2.0

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)

package/src/plugins/tfstate/errors.js

@@ -20,7 +20,7 @@ export class TfStateError extends Error {
  */
 export class InvalidStateFileError extends TfStateError {
   constructor(filePath, reason, context = {}) {
-    super(`Invalid Terraform state file "${filePath}": ${reason}`, context);
+    super(`Invalid Tfstate file "${filePath}": ${reason}`, context);
     this.name = 'InvalidStateFileError';
     this.filePath = filePath;
     this.reason = reason;
@@ -33,7 +33,7 @@ export class InvalidStateFileError extends TfStateError {
 export class UnsupportedStateVersionError extends TfStateError {
   constructor(version, supportedVersions, context = {}) {
     super(
-      `Terraform state version ${version} is not supported. Supported versions: ${supportedVersions.join(', ')}`,
+      `Tfstate version ${version} is not supported. Supported versions: ${supportedVersions.join(', ')}`,
       context
     );
     this.name = 'UnsupportedStateVersionError';
@@ -47,7 +47,7 @@ export class UnsupportedStateVersionError extends TfStateError {
  */
 export class StateFileNotFoundError extends TfStateError {
   constructor(filePath, context = {}) {
-    super(`Terraform state file not found: ${filePath}`, context);
+    super(`Tfstate file not found: ${filePath}`, context);
     this.name = 'StateFileNotFoundError';
     this.filePath = filePath;
   }

package/src/plugins/tfstate/index.js

@@ -8,7 +8,7 @@
  * OpenTofu maintains backward compatibility with Terraform's state file format, so this plugin works seamlessly with both.
  *
  * === 🚀 Key Features ===
- * ✅ **Multi-version support**: Terraform state v3 and v4
+ * ✅ **Multi-version support**: Tfstate v3 and v4
  * ✅ **Multiple sources**: Local files, S3 buckets, remote backends
  * ✅ **SHA256 deduplication**: Prevent duplicate state imports automatically
  * ✅ **Historical tracking**: Full audit trail of infrastructure changes
@@ -16,7 +16,7 @@
  * ✅ **Batch import**: Process multiple state files with controlled parallelism
  * ✅ **Resource filtering**: Include/exclude resources by type or pattern
  * ✅ **Auto-sync**: File watching and cron-based monitoring (optional)
- * ✅ **Export capability**: Convert back to Terraform state format
+ * ✅ **Export capability**: Convert back to Tfstate format
  * ✅ **Automatic partition optimization**: 10-100x faster queries with zero configuration
  *
  * === ⚡ Performance Optimizations (Auto-Applied) ===
@@ -266,59 +266,36 @@ export class TfStatePlugin extends Plugin {
   constructor(config = {}) {
     super(config);
 
-    // Detect new config format (driver-based) vs legacy
-    const isNewFormat = config.driver !== undefined;
-
-    if (isNewFormat) {
-      // New driver-based configuration
-      this.driverType = config.driver || 's3';
-      this.driverConfig = config.config || {};
-
-      // Resource names
-      const resources = config.resources || {};
-      this.resourceName = resources.resources || 'plg_tfstate_resources';
-      this.stateFilesName = resources.stateFiles || 'plg_tfstate_state_files';
-      this.diffsName = resources.diffs || 'plg_tfstate_state_diffs';
-
-      // Monitoring configuration
-      const monitor = config.monitor || {};
-      this.monitorEnabled = monitor.enabled || false;
-      this.monitorCron = monitor.cron || '*/5 * * * *'; // Default: every 5 minutes
-
-      // Diff configuration
-      const diffs = config.diffs || {};
-      this.trackDiffs = diffs.enabled !== undefined ? diffs.enabled : true;
-      this.diffsLookback = diffs.lookback || 10; // How many previous states to compare
-
-      // Partition configuration
-      this.asyncPartitions = config.asyncPartitions !== undefined ? config.asyncPartitions : true;
-
-      // Legacy fields for backward compatibility
-      this.autoSync = false;
-      this.watchPaths = [];
-      this.filters = config.filters || {};
-      this.verbose = config.verbose || false;
-    } else {
-      // Legacy configuration (backward compatible)
-      this.driverType = null; // Will use legacy methods
-      this.driverConfig = {};
-      this.resourceName = config.resourceName || 'plg_tfstate_resources';
-      this.stateFilesName = config.stateFilesName || 'plg_tfstate_state_files';
-      // Support both 'diffsName' and 'stateHistoryName' (legacy) for backward compatibility
-      this.diffsName = config.diffsName || config.stateHistoryName || 'plg_tfstate_state_diffs';
-      this.stateHistoryName = this.diffsName; // Alias for backward compatibility
-      this.autoSync = config.autoSync || false;
-      this.watchPaths = Array.isArray(config.watchPaths) ? config.watchPaths : [];
-      this.filters = config.filters || {};
-      this.trackDiffs = config.trackDiffs !== undefined ? config.trackDiffs : true;
-      this.diffsLookback = 10;
-      this.asyncPartitions = config.asyncPartitions !== undefined ? config.asyncPartitions : true;
-      this.verbose = config.verbose || false;
-      this.monitorEnabled = false;
-      this.monitorCron = '*/5 * * * *';
-    }
-
-    // Supported Terraform state versions
+    // Driver-based configuration
+    this.driverType = config.driver || null;
+    this.driverConfig = config.config || {};
+
+    // Resource names
+    const resources = config.resources || {};
+    this.resourceName = resources.resources || config.resourceName || 'plg_tfstate_resources';
+    this.stateFilesName = resources.stateFiles || config.stateFilesName || 'plg_tfstate_state_files';
+    this.diffsName = resources.diffs || config.diffsName || 'plg_tfstate_state_diffs';
+
+    // Monitoring configuration
+    const monitor = config.monitor || {};
+    this.monitorEnabled = monitor.enabled || false;
+    this.monitorCron = monitor.cron || '*/5 * * * *';
+
+    // Diff configuration
+    const diffs = config.diffs || {};
+    this.trackDiffs = diffs.enabled !== undefined ? diffs.enabled : (config.trackDiffs !== undefined ? config.trackDiffs : true);
+    this.diffsLookback = diffs.lookback || 10;
+
+    // Partition configuration
+    this.asyncPartitions = config.asyncPartitions !== undefined ? config.asyncPartitions : true;
+
+    // Other config
+    this.autoSync = config.autoSync || false;
+    this.watchPaths = config.watchPaths || [];
+    this.filters = config.filters || {};
+    this.verbose = config.verbose || false;
+
+    // Supported Tfstate versions
     this.supportedVersions = [3, 4];
 
     // Internal state
@@ -377,12 +354,12 @@ export class TfStatePlugin extends Plugin {
     }
 
     // Resource 0: Terraform Lineages (Master tracking resource)
-    // NEW: Tracks unique Terraform state lineages for efficient diff tracking
+    // NEW: Tracks unique Tfstate lineages for efficient diff tracking
     this.lineagesName = 'plg_tfstate_lineages';
     this.lineagesResource = await this.database.createResource({
       name: this.lineagesName,
       attributes: {
-        id: 'string|required',           // = lineage UUID from Terraform state
+        id: 'string|required',           // = lineage UUID from Tfstate
         latestSerial: 'number',           // Track latest for quick access
         latestStateId: 'string',          // FK to stateFilesResource
         totalStates: 'number',            // Counter
@@ -396,7 +373,7 @@ export class TfStatePlugin extends Plugin {
       createdBy: 'TfStatePlugin'
     });
 
-    // Resource 1: Terraform State Files Metadata
+    // Resource 1: Tfstate Files Metadata
     // Dedicated to tracking state file metadata with SHA256 hash for deduplication
     this.stateFilesResource = await this.database.createResource({
       name: this.stateFilesName,
@@ -460,7 +437,7 @@ export class TfStatePlugin extends Plugin {
       createdBy: 'TfStatePlugin'
     });
 
-    // Resource 3: Terraform State Diffs
+    // Resource 3: Tfstate Diffs
     // Track changes between state versions (if diff tracking enabled)
     if (this.trackDiffs) {
       this.diffsResource = await this.database.createResource({
@@ -511,12 +488,10 @@ export class TfStatePlugin extends Plugin {
       console.log(`[TfStatePlugin] Created resources: ${resourcesCreated.join(', ')}`);
     }
 
-    // Setup file watchers if autoSync is enabled (legacy mode)
     if (this.autoSync && this.watchPaths.length > 0) {
       await this._setupFileWatchers();
     }
 
-    // Setup cron monitoring if enabled (new driver mode)
     if (this.monitorEnabled && this.driver) {
       await this._setupCronMonitoring();
     }
@@ -556,7 +531,6 @@ export class TfStatePlugin extends Plugin {
       }
     }
 
-    // Stop all file watchers (legacy mode)
     for (const watcher of this.watchers) {
       try {
         // fs.promises.watch returns an AsyncIterator with a return() method
@@ -1281,7 +1255,7 @@ export class TfStatePlugin extends Plugin {
   }
 
   /**
-   * Read and parse Terraform state file
+   * Read and parse Tfstate file
    * @private
    */
   async _readStateFile(filePath) {
@@ -1327,7 +1301,7 @@ export class TfStatePlugin extends Plugin {
   }
 
   /**
-   * Validate Terraform state version
+   * Validate Tfstate version
    * @private
    */
   _validateStateVersion(state) {
@@ -1343,7 +1317,7 @@ export class TfStatePlugin extends Plugin {
   }
 
   /**
-   * Extract resources from Terraform state
+   * Extract resources from Tfstate
    * @private
    */
   async _extractResources(state, filePath, stateFileId, lineageId) {
@@ -2065,14 +2039,14 @@ export class TfStatePlugin extends Plugin {
   }
 
   /**
-   * Export resources to Terraform state format
+   * Export resources to Tfstate format
    * @param {Object} options - Export options
    * @param {number} options.serial - Specific serial to export (default: latest)
    * @param {string[]} options.resourceTypes - Filter by resource types
    * @param {string} options.terraformVersion - Terraform version for output (default: '1.5.0')
    * @param {string} options.lineage - State lineage (default: auto-generated)
    * @param {Object} options.outputs - Terraform outputs to include
-   * @returns {Promise<Object>} Terraform state object
+   * @returns {Promise<Object>} Tfstate object
    *
    * @example
    * // Export latest state