s3db.js 7.3.10 → 7.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s3db.js",
-  "version": "7.3.10",
+  "version": "7.4.0",
   "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",

package/src/database.class.js

@@ -471,7 +471,8 @@ export class Database extends EventEmitter {
       versioningEnabled: this.versioningEnabled,
       map: config.map,
       idGenerator: config.idGenerator,
-      idSize: config.idSize
+      idSize: config.idSize,
+      events: config.events || {}
     });
     resource.database = this;
     this.resources[name] = resource;

package/src/resource.class.js

@@ -40,6 +40,7 @@ export class Resource extends EventEmitter {
    * @param {Function} [config.idGenerator] - Custom ID generator function
    * @param {number} [config.idSize=22] - Size for auto-generated IDs
    * @param {boolean} [config.versioningEnabled=false] - Enable versioning for this resource
+   * @param {Object} [config.events={}] - Event listeners to automatically add
    * @example
    * const users = new Resource({
    *   name: 'users',
@@ -61,6 +62,14 @@ export class Resource extends EventEmitter {
    *     beforeInsert: [async (data) => {
       *       return data;
    *     }]
+   *   },
+   *   events: {
+   *     insert: (ev) => console.log('Inserted:', ev.id),
+   *     update: [
+   *       (ev) => console.warn('Update detected'),
+   *       (ev) => console.log('Updated:', ev.id)
+   *     ],
+   *     delete: (ev) => console.log('Deleted:', ev.id)
    *   }
    * });
    * 
@@ -117,7 +126,8 @@ export class Resource extends EventEmitter {
       hooks = {},
       idGenerator: customIdGenerator,
       idSize = 22,
-      versioningEnabled = false
+      versioningEnabled = false,
+      events = {}
     } = config;
 
     // Set instance properties
@@ -177,6 +187,23 @@ export class Resource extends EventEmitter {
       }
     }
 
+    // Setup event listeners
+    if (events && Object.keys(events).length > 0) {
+      for (const [eventName, listeners] of Object.entries(events)) {
+        if (Array.isArray(listeners)) {
+          // Multiple listeners for this event
+          for (const listener of listeners) {
+            if (typeof listener === 'function') {
+              this.on(eventName, listener);
+            }
+          }
+        } else if (typeof listeners === 'function') {
+          // Single listener for this event
+          this.on(eventName, listeners);
+        }
+      }
+    }
+
     // --- MIDDLEWARE SYSTEM ---
     this._initMiddleware();
     // Debug: print method names and typeof update at construction
@@ -2617,6 +2644,27 @@ function validateResourceConfig(config) {
     }
   }
 
+  // Validate events
+  if (config.events !== undefined) {
+    if (typeof config.events !== 'object' || Array.isArray(config.events)) {
+      errors.push("Resource 'events' must be an object");
+    } else {
+      for (const [eventName, listeners] of Object.entries(config.events)) {
+        if (Array.isArray(listeners)) {
+          // Multiple listeners for this event
+          for (let i = 0; i < listeners.length; i++) {
+            const listener = listeners[i];
+            if (typeof listener !== 'function') {
+              errors.push(`Resource 'events.${eventName}[${i}]' must be a function`);
+            }
+          }
+        } else if (typeof listeners !== 'function') {
+          errors.push(`Resource 'events.${eventName}' must be a function or array of functions`);
+        }
+      }
+    }
+  }
+
   return {
     isValid: errors.length === 0,
     errors

package/src/s3db.d.ts

@@ -47,6 +47,7 @@ declare module 's3db.js' {
     idSize?: number;
     versioningEnabled?: boolean;
     map?: any;
+    events?: EventListenerConfig;
   }
 
   /** Partition configuration */
@@ -65,6 +66,11 @@ declare module 's3db.js' {
     afterDelete?: Function[];
   }
 
+  /** Event listener configuration */
+  export interface EventListenerConfig {
+    [eventName: string]: Function | Function[];
+  }
+
   /** Query options */
   export interface QueryOptions {
     limit?: number;