s3db.js 7.3.10 → 7.4.1

package/dist/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;

package/dist/s3db.es.js

@@ -9650,7 +9650,13 @@ class Client extends EventEmitter {
     if (metadata) {
       for (const [k, v] of Object.entries(metadata)) {
         const validKey = String(k).replace(/[^a-zA-Z0-9\-_]/g, "_");
-        stringMetadata[validKey] = String(v);
+        const stringValue = String(v);
+        const hasSpecialChars = /[^\x00-\x7F]/.test(stringValue);
+        if (hasSpecialChars) {
+          stringMetadata[validKey] = Buffer.from(stringValue, "utf8").toString("base64");
+        } else {
+          stringMetadata[validKey] = stringValue;
+        }
       }
     }
     const options = {
@@ -9687,6 +9693,28 @@ class Client extends EventEmitter {
     let response, error;
     try {
       response = await this.sendCommand(new GetObjectCommand(options));
+      if (response.Metadata) {
+        const decodedMetadata = {};
+        for (const [key2, value] of Object.entries(response.Metadata)) {
+          if (typeof value === "string") {
+            try {
+              const decoded = Buffer.from(value, "base64").toString("utf8");
+              const hasSpecialChars = /[^\x00-\x7F]/.test(decoded);
+              const isValidBase64 = Buffer.from(decoded, "utf8").toString("base64") === value;
+              if (isValidBase64 && hasSpecialChars && decoded !== value) {
+                decodedMetadata[key2] = decoded;
+              } else {
+                decodedMetadata[key2] = value;
+              }
+            } catch (decodeError) {
+              decodedMetadata[key2] = value;
+            }
+          } else {
+            decodedMetadata[key2] = value;
+          }
+        }
+        response.Metadata = decodedMetadata;
+      }
       return response;
     } catch (err) {
       error = err;
@@ -11070,6 +11098,7 @@ 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',
@@ -11091,6 +11120,14 @@ 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)
    *   }
    * });
    * 
@@ -11143,7 +11180,8 @@ class Resource extends EventEmitter {
       hooks = {},
       idGenerator: customIdGenerator,
       idSize = 22,
-      versioningEnabled = false
+      versioningEnabled = false,
+      events = {}
     } = config;
     this.name = name;
     this.client = client;
@@ -11185,6 +11223,19 @@ class Resource extends EventEmitter {
         }
       }
     }
+    if (events && Object.keys(events).length > 0) {
+      for (const [eventName, listeners] of Object.entries(events)) {
+        if (Array.isArray(listeners)) {
+          for (const listener of listeners) {
+            if (typeof listener === "function") {
+              this.on(eventName, listener);
+            }
+          }
+        } else if (typeof listeners === "function") {
+          this.on(eventName, listeners);
+        }
+      }
+    }
     this._initMiddleware();
   }
   /**
@@ -13224,6 +13275,24 @@ function validateResourceConfig(config) {
       }
     }
   }
+  if (config.events !== void 0) {
+    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)) {
+          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
@@ -13236,7 +13305,7 @@ class Database extends EventEmitter {
     super();
     this.version = "1";
     this.s3dbVersion = (() => {
-      const [ok, err, version] = try_fn_default(() => true ? "7.3.10" : "latest");
+      const [ok, err, version] = try_fn_default(() => true ? "7.4.1" : "latest");
       return ok ? version : "latest";
     })();
     this.resources = {};
@@ -13607,7 +13676,8 @@ 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;