s3db.js 8.0.0 → 8.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s3db.js",
-  "version": "8.0.0",
+  "version": "8.0.2",
   "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",
@@ -49,28 +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 --testPathIgnorePatterns=\"plugin-audit.test.js|tests/typescript/\" --testTimeout=10000",
-    "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 --max-old-space-size=4096 --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand --testPathIgnorePatterns=\"plugin-audit.test.js|tests/typescript/\"",
-    "test:full": "npm run test:js-ai && npm run test:ts",
-    "test:audit": "node --max-old-space-size=8192 --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/plugin-audit.test.js --runInBand --testTimeout=60000",
-    "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.850.0",
     "@smithy/node-http-handler": "^4.1.0",
@@ -123,5 +101,27 @@
   },
   "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 --testPathIgnorePatterns=\"plugin-audit.test.js|tests/typescript/\" --testTimeout=10000",
+    "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 --max-old-space-size=4096 --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand --testPathIgnorePatterns=\"plugin-audit.test.js|tests/typescript/\"",
+    "test:full": "npm run test:js-ai && npm run test:ts",
+    "test:audit": "node --max-old-space-size=8192 --no-warnings --experimental-vm-modules node_modules/jest/bin/jest.js tests/plugins/plugin-audit.test.js --runInBand --testTimeout=60000",
+    "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/client.class.js

@@ -38,10 +38,11 @@ export class Client extends EventEmitter {
     this.parallelism = parallelism;
     this.config = new ConnectionString(connectionString);
     this.httpClientOptions = {
-      keepAlive: false, // Disabled for maximum creation speed
-      maxSockets: 10, // Minimal sockets
-      maxFreeSockets: 2, // Minimal pool
-      timeout: 15000, // Short timeout
+      keepAlive: true, // Enabled for better performance
+      keepAliveMsecs: 1000, // 1 second keep-alive
+      maxSockets: 50, // Balanced for most applications
+      maxFreeSockets: 10, // Good connection reuse
+      timeout: 60000, // 60 second timeout
       ...httpClientOptions,
     };
     this.client = AwsS3Client || this.createClient()

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

@@ -91,8 +91,8 @@ export class MemoryCache extends Cache {
     super(config);
     this.cache = {};
     this.meta = {};
-    this.maxSize = config.maxSize || 0;
-    this.ttl = config.ttl || 0;
+    this.maxSize = config.maxSize !== undefined ? config.maxSize : 1000;
+    this.ttl = config.ttl !== undefined ? config.ttl : 300000;
   }
 
   async _set(key, data) {

package/src/plugins/cache.plugin.js

@@ -11,14 +11,26 @@ import tryFn from "../concerns/try-fn.js";
 export class CachePlugin extends Plugin {
   constructor(options = {}) {
     super(options);
-    this.driver = options.driver;
-    this.config = {
-      includePartitions: options.includePartitions !== false,
-      partitionStrategy: options.partitionStrategy || 'hierarchical',
-      partitionAware: options.partitionAware !== false,
-      trackUsage: options.trackUsage !== false,
-      preloadRelated: options.preloadRelated !== false,
-      ...options
+    
+    // Extract primary configuration
+    this.driverName = options.driver || 's3';
+    this.ttl = options.ttl;
+    this.maxSize = options.maxSize;
+    this.config = options.config || {};
+    
+    // Plugin-level settings
+    this.includePartitions = options.includePartitions !== false;
+    this.partitionStrategy = options.partitionStrategy || 'hierarchical';
+    this.partitionAware = options.partitionAware !== false;
+    this.trackUsage = options.trackUsage !== false;
+    this.preloadRelated = options.preloadRelated !== false;
+    
+    // Legacy support - keep the old options for backward compatibility
+    this.legacyConfig = {
+      memoryOptions: options.memoryOptions,
+      filesystemOptions: options.filesystemOptions,
+      s3Options: options.s3Options,
+      driver: options.driver
     };
   }
 
@@ -28,26 +40,68 @@ export class CachePlugin extends Plugin {
 
   async onSetup() {
     // Initialize cache driver
-    if (this.config.driver && typeof this.config.driver === 'object') {
+    if (this.driverName && typeof this.driverName === 'object') {
       // Use custom driver instance if provided
-      this.driver = this.config.driver;
-    } else if (this.config.driver === 'memory') {
-      this.driver = new MemoryCache(this.config.memoryOptions || {});
-    } else if (this.config.driver === 'filesystem') {
+      this.driver = this.driverName;
+    } else if (this.driverName === 'memory') {
+      // Build driver configuration with proper precedence
+      const driverConfig = {
+        ...this.legacyConfig.memoryOptions, // Legacy support (lowest priority)
+        ...this.config, // New config format (medium priority)
+      };
+      
+      // Add global settings if defined (highest priority)
+      if (this.ttl !== undefined) {
+        driverConfig.ttl = this.ttl;
+      }
+      if (this.maxSize !== undefined) {
+        driverConfig.maxSize = this.maxSize;
+      }
+      
+      this.driver = new MemoryCache(driverConfig);
+    } else if (this.driverName === 'filesystem') {
+      // Build driver configuration with proper precedence
+      const driverConfig = {
+        ...this.legacyConfig.filesystemOptions, // Legacy support (lowest priority)
+        ...this.config, // New config format (medium priority)
+      };
+      
+      // Add global settings if defined (highest priority)
+      if (this.ttl !== undefined) {
+        driverConfig.ttl = this.ttl;
+      }
+      if (this.maxSize !== undefined) {
+        driverConfig.maxSize = this.maxSize;
+      }
+      
       // Use partition-aware filesystem cache if enabled
-      if (this.config.partitionAware) {
+      if (this.partitionAware) {
         this.driver = new PartitionAwareFilesystemCache({
-          partitionStrategy: this.config.partitionStrategy,
-          trackUsage: this.config.trackUsage,
-          preloadRelated: this.config.preloadRelated,
-          ...this.config.filesystemOptions
+          partitionStrategy: this.partitionStrategy,
+          trackUsage: this.trackUsage,
+          preloadRelated: this.preloadRelated,
+          ...driverConfig
         });
       } else {
-        this.driver = new FilesystemCache(this.config.filesystemOptions || {});
+        this.driver = new FilesystemCache(driverConfig);
       }
     } else {
-      // Default to S3Cache, sempre passa o client do database
-      this.driver = new S3Cache({ client: this.database.client, ...(this.config.s3Options || {}) });
+      // Default to S3Cache - build driver configuration with proper precedence
+      const driverConfig = {
+        client: this.database.client, // Required for S3Cache
+        ...this.legacyConfig.s3Options, // Legacy support (lowest priority)
+        ...this.config, // New config format (medium priority)
+      };
+      
+      // Add global settings if defined (highest priority)
+      if (this.ttl !== undefined) {
+        driverConfig.ttl = this.ttl;
+      }
+      if (this.maxSize !== undefined) {
+        driverConfig.maxSize = this.maxSize;
+      }
+      
+      this.driver = new S3Cache(driverConfig);
     }
 
     // Use database hooks instead of method overwriting

package/src/s3db.d.ts

@@ -8,10 +8,15 @@ declare module 's3db.js' {
 
   /** HTTP Client configuration for keep-alive and connection pooling */
   export interface HttpClientOptions {
+    /** Enable keep-alive for better performance (default: true) */
     keepAlive?: boolean;
+    /** Keep-alive duration in milliseconds (default: 1000) */
     keepAliveMsecs?: number;
+    /** Maximum number of sockets (default: 50) */
     maxSockets?: number;
+    /** Maximum number of free sockets in pool (default: 10) */
     maxFreeSockets?: number;
+    /** Request timeout in milliseconds (default: 60000) */
     timeout?: number;
   }