s3db.js 13.0.0 → 13.2.1

package/src/plugins/api/server.js

@@ -4,9 +4,6 @@
  * Manages HTTP server lifecycle and routing
  */
 
-import { Hono } from 'hono';
-import { serve } from '@hono/node-server';
-import { swaggerUI } from '@hono/swagger-ui';
 import { createResourceRoutes, createRelationalRoutes } from './routes/resource-routes.js';
 import { errorHandler } from './utils/error-handler.js';
 import * as formatter from './utils/response-formatter.js';
@@ -46,17 +43,18 @@ export class ApiServer {
       }
     };
 
-    this.app = new Hono();
+    this.app = null; // Will be initialized in start() with dynamic import
     this.server = null;
     this.isRunning = false;
     this.openAPISpec = null;
+    this.initialized = false;
 
     // Detect if RelationPlugin is installed
     this.relationsPlugin = this.options.database?.plugins?.relation ||
                           this.options.database?.plugins?.RelationPlugin ||
                           null;
 
-    this._setupRoutes();
+    // Routes will be setup in start() after dynamic import
   }
 
   /**
@@ -170,7 +168,7 @@ export class ApiServer {
 
       // API Documentation UI endpoint
       if (this.options.docsUI === 'swagger') {
-        this.app.get('/docs', swaggerUI({
+        this.app.get('/docs', this.swaggerUI({
           url: '/openapi.json'
         }));
       } else {
@@ -254,7 +252,7 @@ export class ApiServer {
         methods: config.methods,
         customMiddleware: config.customMiddleware || [],
         enableValidation: config.validation !== false
-      });
+      }, this.Hono);
 
       // Mount resource routes
       this.app.route(`/${version}/${name}`, resourceApp);
@@ -317,7 +315,8 @@ export class ApiServer {
           resource,
           relationName,
           relationConfig,
-          version
+          version,
+          this.Hono
         );
 
         // Mount relational routes at /{version}/{resource}/:id/{relation}
@@ -343,11 +342,32 @@ export class ApiServer {
       return;
     }
 
+    // Dynamic import of Hono dependencies (peer dependencies)
+    // This ensures hono is only loaded when server actually starts
+    if (!this.initialized) {
+      const { Hono } = await import('hono');
+      const { serve } = await import('@hono/node-server');
+      const { swaggerUI } = await import('@hono/swagger-ui');
+
+      // Store for use in _setupRoutes
+      this.Hono = Hono;
+      this.serve = serve;
+      this.swaggerUI = swaggerUI;
+
+      // Initialize app
+      this.app = new Hono();
+
+      // Setup all routes
+      this._setupRoutes();
+
+      this.initialized = true;
+    }
+
     const { port, host } = this.options;
 
     return new Promise((resolve, reject) => {
       try {
-        this.server = serve({
+        this.server = this.serve({
           fetch: this.app.fetch,
           port,
           hostname: host

package/src/plugins/audit.plugin.js

@@ -1,4 +1,4 @@
-import Plugin from "./plugin.class.js";
+import { Plugin } from "./plugin.class.js";
 import tryFn from "../concerns/try-fn.js";
 
 export class AuditPlugin extends Plugin {
@@ -420,6 +420,4 @@ export class AuditPlugin extends Plugin {
 
     return deletedCount;
   }
-}
-
-export default AuditPlugin; 
+} 

package/src/plugins/backup.plugin.js

@@ -1,4 +1,4 @@
-import Plugin from "./plugin.class.js";
+import { Plugin } from "./plugin.class.js";
 import tryFn from "../concerns/try-fn.js";
 import { createBackupDriver, validateBackupConfig } from "./backup/index.js";
 import { StreamingExporter } from "./backup/streaming-exporter.js";
@@ -149,7 +149,7 @@ export class BackupPlugin extends Plugin {
       console.log(`[BackupPlugin] Initialized with driver: ${storageInfo.type}`);
     }
 
-    this.emit('initialized', {
+    this.emit('db:plugin:initialized', {
       driver: this.driver.getType(),
       config: this.driver.getStorageInfo()
     });
@@ -205,7 +205,7 @@ export class BackupPlugin extends Plugin {
         await this._executeHook(this.config.onBackupStart, type, { backupId });
       }
       
-      this.emit('backup_start', { id: backupId, type });
+      this.emit('plg:backup:start', { id: backupId, type });
       
       // Create backup metadata
       const metadata = await this._createBackupMetadata(backupId, type);
@@ -262,7 +262,7 @@ export class BackupPlugin extends Plugin {
           await this._executeHook(this.config.onBackupComplete, type, stats);
         }
         
-        this.emit('backup_complete', { 
+        this.emit('plg:backup:complete', { 
           id: backupId, 
           type, 
           size: totalSize, 
@@ -300,7 +300,7 @@ export class BackupPlugin extends Plugin {
         duration: Date.now() - startTime
       });
       
-      this.emit('backup_error', { id: backupId, type, error: error.message });
+      this.emit('plg:backup:error', { id: backupId, type, error: error.message });
       throw error;
       
     } finally {
@@ -579,7 +579,7 @@ export class BackupPlugin extends Plugin {
         await this._executeHook(this.config.onRestoreStart, backupId, options);
       }
       
-      this.emit('restore_start', { id: backupId, options });
+      this.emit('plg:backup:restore-start', { id: backupId, options });
       
       // Get backup metadata
       const backup = await this.getBackupStatus(backupId);
@@ -616,7 +616,7 @@ export class BackupPlugin extends Plugin {
           await this._executeHook(this.config.onRestoreComplete, backupId, { restored: restoredResources });
         }
         
-        this.emit('restore_complete', { 
+        this.emit('plg:backup:restore-complete', { 
           id: backupId, 
           restored: restoredResources 
         });
@@ -637,7 +637,7 @@ export class BackupPlugin extends Plugin {
         await this._executeHook(this.config.onRestoreError, backupId, { error });
       }
       
-      this.emit('restore_error', { id: backupId, error: error.message });
+      this.emit('plg:backup:restore-error', { id: backupId, error: error.message });
       throw error;
     }
   }
@@ -973,7 +973,7 @@ export class BackupPlugin extends Plugin {
   async stop() {
     // Cancel any active backups
     for (const backupId of this.activeBackups) {
-      this.emit('backup_cancelled', { id: backupId });
+      this.emit('plg:backup:cancelled', { id: backupId });
     }
     this.activeBackups.clear();
     
@@ -982,6 +982,4 @@ export class BackupPlugin extends Plugin {
       await this.driver.cleanup();
     }
   }
-}
-
-export default BackupPlugin;
+}

package/src/plugins/cache.plugin.js

@@ -2,7 +2,7 @@ import { join } from "path";
 import jsonStableStringify from "json-stable-stringify";
 import crypto from 'crypto';
 
-import Plugin from "./plugin.class.js";
+import { Plugin } from "./plugin.class.js";
 import S3Cache from "./cache/s3-cache.class.js";
 import MemoryCache from "./cache/memory-cache.class.js";
 import { FilesystemCache } from "./cache/filesystem-cache.class.js";
@@ -434,7 +434,7 @@ export class CachePlugin extends Plugin {
         const [ok, err] = await this.clearCacheWithRetry(resource.cache, specificKey);
 
         if (!ok) {
-          this.emit('cache_clear_error', {
+          this.emit('plg:cache:clear-error', {
             resource: resource.name,
             method,
             id: data.id,
@@ -456,7 +456,7 @@ export class CachePlugin extends Plugin {
             const [ok, err] = await this.clearCacheWithRetry(resource.cache, partitionKeyPrefix);
 
             if (!ok) {
-              this.emit('cache_clear_error', {
+              this.emit('plg:cache:clear-error', {
                 resource: resource.name,
                 partition: partitionName,
                 error: err.message
@@ -475,7 +475,7 @@ export class CachePlugin extends Plugin {
     const [ok, err] = await this.clearCacheWithRetry(resource.cache, keyPrefix);
 
     if (!ok) {
-      this.emit('cache_clear_error', {
+      this.emit('plg:cache:clear-error', {
         resource: resource.name,
         type: 'broad',
         error: err.message
@@ -781,5 +781,3 @@ export class CachePlugin extends Plugin {
     return parts.join(' ');
   }
 }
-
-export default CachePlugin;

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

@@ -109,6 +109,18 @@ export const PLUGIN_DEPENDENCIES = {
         npmUrl: 'https://www.npmjs.com/package/@hono/swagger-ui'
       }
     }
+  },
+  'ml-plugin': {
+    name: 'ML Plugin',
+    docsUrl: 'https://github.com/forattini-dev/s3db.js/blob/main/docs/plugins/ml-plugin.md',
+    dependencies: {
+      '@tensorflow/tfjs-node': {
+        version: '^4.0.0',
+        description: 'TensorFlow.js for Node.js with native bindings',
+        installCommand: 'pnpm add @tensorflow/tfjs-node',
+        npmUrl: 'https://www.npmjs.com/package/@tensorflow/tfjs-node'
+      }
+    }
   }
 };
 

package/src/plugins/costs.plugin.js

@@ -299,5 +299,3 @@ export class CostsPlugin extends Plugin {
     }
   }
 }
-
-export default CostsPlugin;

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

@@ -4,7 +4,7 @@
  * @module eventual-consistency
  */
 
-import Plugin from "../plugin.class.js";
+import { Plugin } from "../plugin.class.js";
 import { createConfig, validateResourcesConfig, logConfigWarnings, logInitialization } from "./config.js";
 import { detectTimezone, getCohortInfo, createFieldHandler } from "./utils.js";
 import { createPartitionConfig } from "./partitions.js";
@@ -733,5 +733,3 @@ export class EventualConsistencyPlugin extends Plugin {
     return diagnostics;
   }
 }
-
-export default EventualConsistencyPlugin;

package/src/plugins/fulltext.plugin.js

@@ -1,4 +1,4 @@
-import Plugin from "./plugin.class.js";
+import { Plugin } from "./plugin.class.js";
 import tryFn from "../concerns/try-fn.js";
 import { FulltextError } from "./fulltext.errors.js";
 
@@ -554,6 +554,4 @@ export class FullTextPlugin extends Plugin {
     // Save changes
     await this.saveIndexes();
   }
-}
-
-export default FullTextPlugin; 
+} 

package/src/plugins/geo.plugin.js

@@ -1,4 +1,4 @@
-import Plugin from "./plugin.class.js";
+import { Plugin } from "./plugin.class.js";
 import tryFn from "../concerns/try-fn.js";
 
 /**
@@ -109,7 +109,7 @@ export class GeoPlugin extends Plugin {
       console.log(`[GeoPlugin] Installed with ${Object.keys(this.resources).length} resources`);
     }
 
-    this.emit('installed', {
+    this.emit('db:plugin:installed', {
       plugin: 'GeoPlugin',
       resources: Object.keys(this.resources)
     });
@@ -861,12 +861,10 @@ export class GeoPlugin extends Plugin {
       console.log('[GeoPlugin] Uninstalled');
     }
 
-    this.emit('uninstalled', {
+    this.emit('db:plugin:uninstalled', {
       plugin: 'GeoPlugin'
     });
 
     await super.uninstall();
   }
 }
-
-export default GeoPlugin;

package/src/plugins/importer/index.js

@@ -1016,5 +1016,3 @@ export const Transformers = {
     return String(value).trim();
   }
 };
-
-export default ImporterPlugin;

package/src/plugins/index.js

@@ -1,6 +1,5 @@
 export * from './plugin.class.js'
 export * from './plugin.obj.js'
-export { default as Plugin } from './plugin.class.js'
 
 // plugins:
 // ApiPlugin is exported separately to avoid bundling hono dependencies

package/src/plugins/metrics.plugin.js

@@ -1,4 +1,4 @@
-import Plugin from "./plugin.class.js";
+import { Plugin } from "./plugin.class.js";
 import tryFn from "../concerns/try-fn.js";
 
 export class MetricsPlugin extends Plugin {
@@ -831,6 +831,4 @@ export class MetricsPlugin extends Plugin {
       console.error('[Metrics Plugin] Standalone metrics server error:', err);
     });
   }
-}
-
-export default MetricsPlugin; 
+}