@private.me/xbind 3.0.1 → 3.0.2

package/dist-standalone/cjs/plugin-system.js

@@ -1 +1,264 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.PluginBuilder=exports.MiddlewareChain=void 0,exports.createPluginContext=createPluginContext,exports.createPlugin=createPlugin;const shared_1=require("../_deps/shared/index.js");class MiddlewareChain{plugins=[];initialized=!1;constructor(e=[]){this.plugins=[...e].sort((e,r)=>(e.priority??100)-(r.priority??100))}register(e){return this.plugins.some(r=>r.name===e.name)?(0,shared_1.err)(`PLUGIN_ALREADY_REGISTERED:${e.name}`):(this.plugins.push(e),this.plugins.sort((e,r)=>(e.priority??100)-(r.priority??100)),(0,shared_1.ok)(void 0))}unregister(e){const r=this.plugins.findIndex(r=>r.name===e);return-1===r?(0,shared_1.err)(`PLUGIN_NOT_FOUND:${e}`):(this.plugins.splice(r,1),(0,shared_1.ok)(void 0))}getPlugins(){return[...this.plugins]}async initialize(){if(this.initialized)return(0,shared_1.ok)(void 0);for(const e of this.plugins)if(e.onInit){const r=await e.onInit();if(!1===r.ok)return(0,shared_1.err)(`PLUGIN_INIT_FAILED:${e.name}:${r.error}`)}return this.initialized=!0,(0,shared_1.ok)(void 0)}async destroy(){const e=[];for(const r of this.plugins)if(r.onDestroy){const t=await r.onDestroy();!1===t.ok&&e.push(`${r.name}:${t.error}`)}return this.initialized=!1,e.length>0?(0,shared_1.err)(`PLUGIN_DESTROY_FAILED:${e.join(",")}`):(0,shared_1.ok)(void 0)}async executeSend(e,r){if(!this.initialized)return(0,shared_1.err)("MIDDLEWARE_NOT_INITIALIZED");let t=e;for(const e of this.plugins)if(e.onSend){const i=await e.onSend(t,r);if(!1===i.ok)return(0,shared_1.err)(`PLUGIN_HOOK_FAILED:${e.name}:${i.error}`);const n=i.value;if(n.abort)return(0,shared_1.err)(`PLUGIN_ABORTED:${e.name}:${n.reason??"no reason"}`);t=n.payload,n.metadata&&Object.assign(r.metadata,n.metadata)}return(0,shared_1.ok)(t)}async executeReceive(e,r){if(!this.initialized)return(0,shared_1.err)("MIDDLEWARE_NOT_INITIALIZED");let t=e;for(const e of this.plugins)if(e.onReceive){const i=await e.onReceive(t,r);if(!1===i.ok)return(0,shared_1.err)(`PLUGIN_HOOK_FAILED:${e.name}:${i.error}`);const n=i.value;if(n.abort)return(0,shared_1.err)(`PLUGIN_ABORTED:${e.name}:${n.reason??"no reason"}`);t=n.payload,n.metadata&&Object.assign(r.metadata,n.metadata)}return(0,shared_1.ok)(t)}async executeEncrypt(e,r){if(!this.initialized)return(0,shared_1.err)("MIDDLEWARE_NOT_INITIALIZED");let t=e;for(const e of this.plugins)if(e.onEncrypt){const i=await e.onEncrypt(t,r);if(!1===i.ok)return(0,shared_1.err)(`PLUGIN_HOOK_FAILED:${e.name}:${i.error}`);const n=i.value;if(n.abort)return(0,shared_1.err)(`PLUGIN_ABORTED:${e.name}:${n.reason??"no reason"}`);t=n.payload,n.metadata&&Object.assign(r.metadata,n.metadata)}return(0,shared_1.ok)(t)}async executeDecrypt(e,r){if(!this.initialized)return(0,shared_1.err)("MIDDLEWARE_NOT_INITIALIZED");let t=e;for(const e of this.plugins)if(e.onDecrypt){const i=await e.onDecrypt(t,r);if(!1===i.ok)return(0,shared_1.err)(`PLUGIN_HOOK_FAILED:${e.name}:${i.error}`);const n=i.value;if(n.abort)return(0,shared_1.err)(`PLUGIN_ABORTED:${e.name}:${n.reason??"no reason"}`);t=n.payload,n.metadata&&Object.assign(r.metadata,n.metadata)}return(0,shared_1.ok)(t)}}function createPluginContext(e,r={}){return{agent:e,recipient:r.recipient,scope:r.scope,timestamp:r.timestamp??Date.now(),state:r.state??new Map,metadata:r.metadata??{}}}exports.MiddlewareChain=MiddlewareChain;class PluginBuilder{plugin={};constructor(e,r){this.plugin.name=e,this.plugin.version=r}description(e){return this.plugin.description=e,this}priority(e){return this.plugin.priority=e,this}onSend(e){return this.plugin.onSend=e,this}onReceive(e){return this.plugin.onReceive=e,this}onEncrypt(e){return this.plugin.onEncrypt=e,this}onDecrypt(e){return this.plugin.onDecrypt=e,this}onInit(e){return this.plugin.onInit=e,this}onDestroy(e){return this.plugin.onDestroy=e,this}build(){if(!this.plugin.name||!this.plugin.version)throw new Error("Plugin name and version are required");return this.plugin}}function createPlugin(e,r){return new PluginBuilder(e,r)}exports.PluginBuilder=PluginBuilder;
+"use strict";
+/**
+ * @module plugin-system
+ * Extensible plugin and middleware architecture for xBind
+ *
+ * Provides hooks for message processing, encryption, decryption, and custom logic.
+ * Supports both synchronous and asynchronous plugin execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginBuilder = exports.MiddlewareChain = void 0;
+exports.createPluginContext = createPluginContext;
+exports.createPlugin = createPlugin;
+const shared_1 = require("../_deps/shared/index.js");
+/**
+ * Middleware chain executor.
+ * Runs plugins in priority order and handles errors.
+ */
+class MiddlewareChain {
+    plugins = [];
+    initialized = false;
+    constructor(plugins = []) {
+        this.plugins = [...plugins].sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+    }
+    /**
+     * Register a plugin.
+     * Plugins are automatically sorted by priority after registration.
+     */
+    register(plugin) {
+        if (this.plugins.some((p) => p.name === plugin.name)) {
+            return (0, shared_1.err)(`PLUGIN_ALREADY_REGISTERED:${plugin.name}`);
+        }
+        this.plugins.push(plugin);
+        this.plugins.sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+        return (0, shared_1.ok)(undefined);
+    }
+    /**
+     * Unregister a plugin by name.
+     */
+    unregister(name) {
+        const index = this.plugins.findIndex((p) => p.name === name);
+        if (index === -1) {
+            return (0, shared_1.err)(`PLUGIN_NOT_FOUND:${name}`);
+        }
+        this.plugins.splice(index, 1);
+        return (0, shared_1.ok)(undefined);
+    }
+    /**
+     * Get all registered plugins.
+     */
+    getPlugins() {
+        return [...this.plugins];
+    }
+    /**
+     * Initialize all plugins.
+     * Must be called before executing hooks.
+     */
+    async initialize() {
+        if (this.initialized) {
+            return (0, shared_1.ok)(undefined);
+        }
+        for (const plugin of this.plugins) {
+            if (plugin.onInit) {
+                const result = await plugin.onInit();
+                if (result.ok === false) {
+                    return (0, shared_1.err)(`PLUGIN_INIT_FAILED:${plugin.name}:${result.error}`);
+                }
+            }
+        }
+        this.initialized = true;
+        return (0, shared_1.ok)(undefined);
+    }
+    /**
+     * Destroy all plugins and cleanup resources.
+     */
+    async destroy() {
+        const errors = [];
+        for (const plugin of this.plugins) {
+            if (plugin.onDestroy) {
+                const result = await plugin.onDestroy();
+                if (result.ok === false) {
+                    errors.push(`${plugin.name}:${result.error}`);
+                }
+            }
+        }
+        this.initialized = false;
+        if (errors.length > 0) {
+            return (0, shared_1.err)(`PLUGIN_DESTROY_FAILED:${errors.join(',')}`);
+        }
+        return (0, shared_1.ok)(undefined);
+    }
+    /**
+     * Execute onSend hooks.
+     */
+    async executeSend(payload, context) {
+        if (!this.initialized) {
+            return (0, shared_1.err)('MIDDLEWARE_NOT_INITIALIZED');
+        }
+        let currentPayload = payload;
+        for (const plugin of this.plugins) {
+            if (plugin.onSend) {
+                const result = await plugin.onSend(currentPayload, context);
+                if (result.ok === false) {
+                    return (0, shared_1.err)(`PLUGIN_HOOK_FAILED:${plugin.name}:${result.error}`);
+                }
+                const hookResult = result.value;
+                if (hookResult.abort) {
+                    return (0, shared_1.err)(`PLUGIN_ABORTED:${plugin.name}:${hookResult.reason ?? 'no reason'}`);
+                }
+                currentPayload = hookResult.payload;
+                if (hookResult.metadata) {
+                    Object.assign(context.metadata, hookResult.metadata);
+                }
+            }
+        }
+        return (0, shared_1.ok)(currentPayload);
+    }
+    /**
+     * Execute onReceive hooks.
+     */
+    async executeReceive(envelope, context) {
+        if (!this.initialized) {
+            return (0, shared_1.err)('MIDDLEWARE_NOT_INITIALIZED');
+        }
+        let currentEnvelope = envelope;
+        for (const plugin of this.plugins) {
+            if (plugin.onReceive) {
+                const result = await plugin.onReceive(currentEnvelope, context);
+                if (result.ok === false) {
+                    return (0, shared_1.err)(`PLUGIN_HOOK_FAILED:${plugin.name}:${result.error}`);
+                }
+                const hookResult = result.value;
+                if (hookResult.abort) {
+                    return (0, shared_1.err)(`PLUGIN_ABORTED:${plugin.name}:${hookResult.reason ?? 'no reason'}`);
+                }
+                currentEnvelope = hookResult.payload;
+                if (hookResult.metadata) {
+                    Object.assign(context.metadata, hookResult.metadata);
+                }
+            }
+        }
+        return (0, shared_1.ok)(currentEnvelope);
+    }
+    /**
+     * Execute onEncrypt hooks.
+     */
+    async executeEncrypt(plaintext, context) {
+        if (!this.initialized) {
+            return (0, shared_1.err)('MIDDLEWARE_NOT_INITIALIZED');
+        }
+        let currentPlaintext = plaintext;
+        for (const plugin of this.plugins) {
+            if (plugin.onEncrypt) {
+                const result = await plugin.onEncrypt(currentPlaintext, context);
+                if (result.ok === false) {
+                    return (0, shared_1.err)(`PLUGIN_HOOK_FAILED:${plugin.name}:${result.error}`);
+                }
+                const hookResult = result.value;
+                if (hookResult.abort) {
+                    return (0, shared_1.err)(`PLUGIN_ABORTED:${plugin.name}:${hookResult.reason ?? 'no reason'}`);
+                }
+                currentPlaintext = hookResult.payload;
+                if (hookResult.metadata) {
+                    Object.assign(context.metadata, hookResult.metadata);
+                }
+            }
+        }
+        return (0, shared_1.ok)(currentPlaintext);
+    }
+    /**
+     * Execute onDecrypt hooks.
+     */
+    async executeDecrypt(plaintext, context) {
+        if (!this.initialized) {
+            return (0, shared_1.err)('MIDDLEWARE_NOT_INITIALIZED');
+        }
+        let currentPlaintext = plaintext;
+        for (const plugin of this.plugins) {
+            if (plugin.onDecrypt) {
+                const result = await plugin.onDecrypt(currentPlaintext, context);
+                if (result.ok === false) {
+                    return (0, shared_1.err)(`PLUGIN_HOOK_FAILED:${plugin.name}:${result.error}`);
+                }
+                const hookResult = result.value;
+                if (hookResult.abort) {
+                    return (0, shared_1.err)(`PLUGIN_ABORTED:${plugin.name}:${hookResult.reason ?? 'no reason'}`);
+                }
+                currentPlaintext = hookResult.payload;
+                if (hookResult.metadata) {
+                    Object.assign(context.metadata, hookResult.metadata);
+                }
+            }
+        }
+        return (0, shared_1.ok)(currentPlaintext);
+    }
+}
+exports.MiddlewareChain = MiddlewareChain;
+/**
+ * Create a plugin context.
+ */
+function createPluginContext(agent, options = {}) {
+    return {
+        agent,
+        recipient: options.recipient,
+        scope: options.scope,
+        timestamp: options.timestamp ?? Date.now(),
+        state: options.state ?? new Map(),
+        metadata: options.metadata ?? {},
+    };
+}
+/**
+ * Plugin builder for creating plugins with a fluent API.
+ */
+class PluginBuilder {
+    plugin = {};
+    constructor(name, version) {
+        this.plugin.name = name;
+        this.plugin.version = version;
+    }
+    description(desc) {
+        this.plugin.description = desc;
+        return this;
+    }
+    priority(p) {
+        this.plugin.priority = p;
+        return this;
+    }
+    onSend(hook) {
+        this.plugin.onSend = hook;
+        return this;
+    }
+    onReceive(hook) {
+        this.plugin.onReceive = hook;
+        return this;
+    }
+    onEncrypt(hook) {
+        this.plugin.onEncrypt = hook;
+        return this;
+    }
+    onDecrypt(hook) {
+        this.plugin.onDecrypt = hook;
+        return this;
+    }
+    onInit(hook) {
+        this.plugin.onInit = hook;
+        return this;
+    }
+    onDestroy(hook) {
+        this.plugin.onDestroy = hook;
+        return this;
+    }
+    build() {
+        if (!this.plugin.name || !this.plugin.version) {
+            throw new Error('Plugin name and version are required');
+        }
+        return this.plugin;
+    }
+}
+exports.PluginBuilder = PluginBuilder;
+/**
+ * Create a plugin builder.
+ */
+function createPlugin(name, version) {
+    return new PluginBuilder(name, version);
+}

package/dist-standalone/cjs/plugins/logging.js

@@ -1 +1,168 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.LoggingPlugin=exports.LogLevel=void 0,exports.createLoggingPlugin=createLoggingPlugin;const shared_1=require("../../_deps/shared/index.js");var LogLevel;!function(e){e.DEBUG="debug",e.INFO="info",e.WARN="warn",e.ERROR="error"}(LogLevel||(exports.LogLevel=LogLevel={}));class LoggingPlugin{name="logging";version="1.0.0";description="Captures message processing events for debugging and audit trails";priority=10;options;logs=[];constructor(e={}){this.options={level:e.level??LogLevel.INFO,includeSize:e.includeSize??!0,includeMetadata:e.includeMetadata??!1,logHandler:e.logHandler??(e=>console.log(JSON.stringify(e))),filter:e.filter??(()=>!0)}}onInit(){return this.log({timestamp:(new Date).toISOString(),level:LogLevel.INFO,event:"send",agent:"system",metadata:{message:"Logging plugin initialized"}}),(0,shared_1.ok)(void 0)}onDestroy(){return this.log({timestamp:(new Date).toISOString(),level:LogLevel.INFO,event:"send",agent:"system",metadata:{message:"Logging plugin destroyed",totalLogs:this.logs.length}}),this.logs=[],(0,shared_1.ok)(void 0)}onSend(e,t){const i=this.options.includeSize?this.estimateSize(e):void 0;return this.log({timestamp:(new Date).toISOString(),level:LogLevel.INFO,event:"send",agent:t.agent.did,recipient:t.recipient,scope:t.scope,payloadSize:i,metadata:this.options.includeMetadata?t.metadata:void 0}),(0,shared_1.ok)({payload:e})}onReceive(e,t){const i=this.options.includeSize?this.estimateSize(e):void 0;return this.log({timestamp:(new Date).toISOString(),level:LogLevel.INFO,event:"receive",agent:t.agent.did,recipient:e.sender,scope:t.scope,payloadSize:i,metadata:this.options.includeMetadata?t.metadata:void 0}),(0,shared_1.ok)({payload:e})}onEncrypt(e,t){return this.log({timestamp:(new Date).toISOString(),level:LogLevel.DEBUG,event:"encrypt",agent:t.agent.did,recipient:t.recipient,scope:t.scope,payloadSize:this.options.includeSize?e.length:void 0,metadata:this.options.includeMetadata?t.metadata:void 0}),(0,shared_1.ok)({payload:e})}onDecrypt(e,t){return this.log({timestamp:(new Date).toISOString(),level:LogLevel.DEBUG,event:"decrypt",agent:t.agent.did,scope:t.scope,payloadSize:this.options.includeSize?e.length:void 0,metadata:this.options.includeMetadata?t.metadata:void 0}),(0,shared_1.ok)({payload:e})}getLogs(){return[...this.logs]}clearLogs(){this.logs=[]}getFilteredLogs(e){return this.logs.filter(e)}log(e){this.shouldLog(e.level)&&this.options.filter(e)&&(this.logs.push(e),this.options.logHandler(e))}shouldLog(e){const t=[LogLevel.DEBUG,LogLevel.INFO,LogLevel.WARN,LogLevel.ERROR],i=t.indexOf(this.options.level);return t.indexOf(e)>=i}estimateSize(e){if(e instanceof Uint8Array)return e.length;try{return JSON.stringify(e).length}catch{return 0}}}function createLoggingPlugin(e){return new LoggingPlugin(e)}exports.LoggingPlugin=LoggingPlugin;
+"use strict";
+/**
+ * @module plugins/logging
+ * Logging plugin for xBind plugin system
+ *
+ * Captures send, receive, encrypt, and decrypt events for debugging and audit trails.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggingPlugin = exports.LogLevel = void 0;
+exports.createLoggingPlugin = createLoggingPlugin;
+const shared_1 = require("../../_deps/shared/index.js");
+/**
+ * Log level enum.
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Logging plugin implementation.
+ * Captures all message processing events and outputs structured logs.
+ */
+class LoggingPlugin {
+    name = 'logging';
+    version = '1.0.0';
+    description = 'Captures message processing events for debugging and audit trails';
+    priority = 10; // Execute early
+    options;
+    logs = [];
+    constructor(options = {}) {
+        this.options = {
+            level: options.level ?? LogLevel.INFO,
+            includeSize: options.includeSize ?? true,
+            includeMetadata: options.includeMetadata ?? false,
+            logHandler: options.logHandler ?? ((entry) => console.log(JSON.stringify(entry))),
+            filter: options.filter ?? (() => true),
+        };
+    }
+    onInit() {
+        this.log({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            event: 'send',
+            agent: 'system',
+            metadata: { message: 'Logging plugin initialized' },
+        });
+        return (0, shared_1.ok)(undefined);
+    }
+    onDestroy() {
+        this.log({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            event: 'send',
+            agent: 'system',
+            metadata: { message: 'Logging plugin destroyed', totalLogs: this.logs.length },
+        });
+        this.logs = [];
+        return (0, shared_1.ok)(undefined);
+    }
+    onSend(payload, context) {
+        const size = this.options.includeSize ? this.estimateSize(payload) : undefined;
+        this.log({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            event: 'send',
+            agent: context.agent.did,
+            recipient: context.recipient,
+            scope: context.scope,
+            payloadSize: size,
+            metadata: this.options.includeMetadata ? context.metadata : undefined,
+        });
+        return (0, shared_1.ok)({ payload });
+    }
+    onReceive(envelope, context) {
+        const size = this.options.includeSize ? this.estimateSize(envelope) : undefined;
+        this.log({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            event: 'receive',
+            agent: context.agent.did,
+            recipient: envelope.sender,
+            scope: context.scope,
+            payloadSize: size,
+            metadata: this.options.includeMetadata ? context.metadata : undefined,
+        });
+        return (0, shared_1.ok)({ payload: envelope });
+    }
+    onEncrypt(plaintext, context) {
+        this.log({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.DEBUG,
+            event: 'encrypt',
+            agent: context.agent.did,
+            recipient: context.recipient,
+            scope: context.scope,
+            payloadSize: this.options.includeSize ? plaintext.length : undefined,
+            metadata: this.options.includeMetadata ? context.metadata : undefined,
+        });
+        return (0, shared_1.ok)({ payload: plaintext });
+    }
+    onDecrypt(plaintext, context) {
+        this.log({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.DEBUG,
+            event: 'decrypt',
+            agent: context.agent.did,
+            scope: context.scope,
+            payloadSize: this.options.includeSize ? plaintext.length : undefined,
+            metadata: this.options.includeMetadata ? context.metadata : undefined,
+        });
+        return (0, shared_1.ok)({ payload: plaintext });
+    }
+    /**
+     * Get all captured logs.
+     */
+    getLogs() {
+        return [...this.logs];
+    }
+    /**
+     * Clear all logs.
+     */
+    clearLogs() {
+        this.logs = [];
+    }
+    /**
+     * Get logs filtered by criteria.
+     */
+    getFilteredLogs(filter) {
+        return this.logs.filter(filter);
+    }
+    log(entry) {
+        if (!this.shouldLog(entry.level)) {
+            return;
+        }
+        if (!this.options.filter(entry)) {
+            return;
+        }
+        this.logs.push(entry);
+        this.options.logHandler(entry);
+    }
+    shouldLog(level) {
+        const levels = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];
+        const thresholdIndex = levels.indexOf(this.options.level);
+        const currentIndex = levels.indexOf(level);
+        return currentIndex >= thresholdIndex;
+    }
+    estimateSize(value) {
+        if (value instanceof Uint8Array) {
+            return value.length;
+        }
+        try {
+            return JSON.stringify(value).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+exports.LoggingPlugin = LoggingPlugin;
+/**
+ * Create a logging plugin with options.
+ */
+function createLoggingPlugin(options) {
+    return new LoggingPlugin(options);
+}

package/dist-standalone/cjs/plugins/metrics.js

@@ -1 +1,181 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.MetricsPlugin=void 0,exports.createMetricsPlugin=createMetricsPlugin;const shared_1=require("../../_deps/shared/index.js");class MetricsPlugin{name="metrics";version="1.0.0";description="Tracks performance metrics, message counts, and error rates";priority=20;options;metrics=[];startTime=Date.now();exportTimer;constructor(t={}){this.options={highResolution:t.highResolution??!0,maxMetrics:t.maxMetrics??1e4,onExport:t.onExport??(()=>{}),exportInterval:t.exportInterval??6e4}}onInit(){return this.startTime=Date.now(),this.options.exportInterval>0&&(this.exportTimer=setInterval(()=>{this.export()},this.options.exportInterval)),(0,shared_1.ok)(void 0)}onDestroy(){return this.exportTimer&&(clearInterval(this.exportTimer),this.exportTimer=void 0),this.export(),this.metrics=[],(0,shared_1.ok)(void 0)}onSend(t,e){const r=this.now(),s=this.now();return this.record({timestamp:Date.now(),event:"send",duration:s-r,success:!0}),(0,shared_1.ok)({payload:t})}onReceive(t,e){const r=this.now(),s=this.now();return this.record({timestamp:Date.now(),event:"receive",duration:s-r,success:!0}),(0,shared_1.ok)({payload:t})}onEncrypt(t,e){const r=this.now(),s=this.now();return this.record({timestamp:Date.now(),event:"encrypt",duration:s-r,success:!0}),(0,shared_1.ok)({payload:t})}onDecrypt(t,e){const r=this.now(),s=this.now();return this.record({timestamp:Date.now(),event:"decrypt",duration:s-r,success:!0}),(0,shared_1.ok)({payload:t})}getMetrics(){return[...this.metrics]}getAggregatedMetrics(){const t=this.metrics.filter(t=>"send"===t.event),e=this.metrics.filter(t=>"receive"===t.event),r=this.metrics.filter(t=>"encrypt"===t.event),s=this.metrics.filter(t=>"decrypt"===t.event),i=this.metrics.filter(t=>!t.success),n=t=>0===t.length?0:t.reduce((t,e)=>t+e.duration,0)/t.length,o=this.metrics.length;return{totalSends:t.length,totalReceives:e.length,totalEncrypts:r.length,totalDecrypts:s.length,avgSendDuration:n(t),avgReceiveDuration:n(e),avgEncryptDuration:n(r),avgDecryptDuration:n(s),totalErrors:i.length,errorRate:o>0?i.length/o:0,uptime:Date.now()-this.startTime}}clearMetrics(){this.metrics=[],this.startTime=Date.now()}export(){this.metrics.length>0&&this.options.onExport([...this.metrics])}getMetricsInRange(t,e){return this.metrics.filter(r=>r.timestamp>=t&&r.timestamp<=e)}getMetricsByEvent(t){return this.metrics.filter(e=>e.event===t)}record(t){this.metrics.push(t),this.metrics.length>this.options.maxMetrics&&this.metrics.shift()}now(){return this.options.highResolution&&"undefined"!=typeof performance?performance.now():Date.now()}}function createMetricsPlugin(t){return new MetricsPlugin(t)}exports.MetricsPlugin=MetricsPlugin;
+"use strict";
+/**
+ * @module plugins/metrics
+ * Metrics plugin for xBind plugin system
+ *
+ * Tracks performance metrics, message counts, and error rates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsPlugin = void 0;
+exports.createMetricsPlugin = createMetricsPlugin;
+const shared_1 = require("../../_deps/shared/index.js");
+/**
+ * Metrics plugin implementation.
+ * Tracks performance and usage statistics for all operations.
+ */
+class MetricsPlugin {
+    name = 'metrics';
+    version = '1.0.0';
+    description = 'Tracks performance metrics, message counts, and error rates';
+    priority = 20; // Execute after logging
+    options;
+    metrics = [];
+    startTime = Date.now();
+    exportTimer;
+    constructor(options = {}) {
+        this.options = {
+            highResolution: options.highResolution ?? true,
+            maxMetrics: options.maxMetrics ?? 10000,
+            onExport: options.onExport ?? (() => { }),
+            exportInterval: options.exportInterval ?? 60000,
+        };
+    }
+    onInit() {
+        this.startTime = Date.now();
+        if (this.options.exportInterval > 0) {
+            this.exportTimer = setInterval(() => {
+                this.export();
+            }, this.options.exportInterval);
+        }
+        return (0, shared_1.ok)(undefined);
+    }
+    onDestroy() {
+        if (this.exportTimer) {
+            clearInterval(this.exportTimer);
+            this.exportTimer = undefined;
+        }
+        this.export();
+        this.metrics = [];
+        return (0, shared_1.ok)(undefined);
+    }
+    onSend(payload, context) {
+        const start = this.now();
+        // Simulate processing
+        const end = this.now();
+        this.record({
+            timestamp: Date.now(),
+            event: 'send',
+            duration: end - start,
+            success: true,
+        });
+        return (0, shared_1.ok)({ payload });
+    }
+    onReceive(envelope, context) {
+        const start = this.now();
+        // Simulate processing
+        const end = this.now();
+        this.record({
+            timestamp: Date.now(),
+            event: 'receive',
+            duration: end - start,
+            success: true,
+        });
+        return (0, shared_1.ok)({ payload: envelope });
+    }
+    onEncrypt(plaintext, context) {
+        const start = this.now();
+        // Simulate processing
+        const end = this.now();
+        this.record({
+            timestamp: Date.now(),
+            event: 'encrypt',
+            duration: end - start,
+            success: true,
+        });
+        return (0, shared_1.ok)({ payload: plaintext });
+    }
+    onDecrypt(plaintext, context) {
+        const start = this.now();
+        // Simulate processing
+        const end = this.now();
+        this.record({
+            timestamp: Date.now(),
+            event: 'decrypt',
+            duration: end - start,
+            success: true,
+        });
+        return (0, shared_1.ok)({ payload: plaintext });
+    }
+    /**
+     * Get all captured metrics.
+     */
+    getMetrics() {
+        return [...this.metrics];
+    }
+    /**
+     * Get aggregated metrics summary.
+     */
+    getAggregatedMetrics() {
+        const sends = this.metrics.filter((m) => m.event === 'send');
+        const receives = this.metrics.filter((m) => m.event === 'receive');
+        const encrypts = this.metrics.filter((m) => m.event === 'encrypt');
+        const decrypts = this.metrics.filter((m) => m.event === 'decrypt');
+        const errors = this.metrics.filter((m) => !m.success);
+        const avgDuration = (items) => {
+            if (items.length === 0)
+                return 0;
+            return items.reduce((sum, m) => sum + m.duration, 0) / items.length;
+        };
+        const total = this.metrics.length;
+        return {
+            totalSends: sends.length,
+            totalReceives: receives.length,
+            totalEncrypts: encrypts.length,
+            totalDecrypts: decrypts.length,
+            avgSendDuration: avgDuration(sends),
+            avgReceiveDuration: avgDuration(receives),
+            avgEncryptDuration: avgDuration(encrypts),
+            avgDecryptDuration: avgDuration(decrypts),
+            totalErrors: errors.length,
+            errorRate: total > 0 ? errors.length / total : 0,
+            uptime: Date.now() - this.startTime,
+        };
+    }
+    /**
+     * Clear all metrics.
+     */
+    clearMetrics() {
+        this.metrics = [];
+        this.startTime = Date.now();
+    }
+    /**
+     * Export metrics using the configured callback.
+     */
+    export() {
+        if (this.metrics.length > 0) {
+            this.options.onExport([...this.metrics]);
+        }
+    }
+    /**
+     * Get metrics for a specific time range.
+     */
+    getMetricsInRange(startTime, endTime) {
+        return this.metrics.filter((m) => m.timestamp >= startTime && m.timestamp <= endTime);
+    }
+    /**
+     * Get metrics for a specific event type.
+     */
+    getMetricsByEvent(event) {
+        return this.metrics.filter((m) => m.event === event);
+    }
+    record(entry) {
+        this.metrics.push(entry);
+        // Enforce max metrics limit
+        if (this.metrics.length > this.options.maxMetrics) {
+            this.metrics.shift(); // Remove oldest
+        }
+    }
+    now() {
+        if (this.options.highResolution && typeof performance !== 'undefined') {
+            return performance.now();
+        }
+        return Date.now();
+    }
+}
+exports.MetricsPlugin = MetricsPlugin;
+/**
+ * Create a metrics plugin with options.
+ */
+function createMetricsPlugin(options) {
+    return new MetricsPlugin(options);
+}