@stackmemoryai/stackmemory 0.5.0 → 0.5.2

package/dist/core/plugins/plugin-interface.js

@@ -0,0 +1,87 @@
+class BasePlugin {
+  dependencies;
+  context;
+  status = { state: "uninitialized" };
+  metrics = {
+    eventsEmitted: 0,
+    eventsReceived: 0,
+    errors: 0
+  };
+  startTime;
+  async initialize(context) {
+    this.context = context;
+    this.status = { state: "initialized" };
+    await this.onInitialize();
+  }
+  async start() {
+    this.status = { state: "starting" };
+    this.startTime = Date.now();
+    await this.onStart();
+    this.status = { state: "running", lastActivity: Date.now() };
+  }
+  async stop() {
+    this.status = { state: "stopping" };
+    await this.onStop();
+    this.status = { state: "stopped" };
+  }
+  async shutdown() {
+    if (this.status.state === "running") {
+      await this.stop();
+    }
+    await this.onShutdown();
+    this.status = { state: "uninitialized" };
+  }
+  getStatus() {
+    return { ...this.status };
+  }
+  getMetrics() {
+    return {
+      ...this.metrics,
+      startTime: this.startTime,
+      uptime: this.startTime ? Date.now() - this.startTime : 0
+    };
+  }
+  validateConfig(config) {
+    const errors = [];
+    const warnings = [];
+    if (config.name !== this.name) {
+      errors.push(`Config name '${config.name}' doesn't match plugin name '${this.name}'`);
+    }
+    const customValidation = this.onValidateConfig(config);
+    if (customValidation.errors) errors.push(...customValidation.errors);
+    if (customValidation.warnings) warnings.push(...customValidation.warnings);
+    return {
+      valid: errors.length === 0,
+      errors: errors.length > 0 ? errors : void 0,
+      warnings: warnings.length > 0 ? warnings : void 0
+    };
+  }
+  emit(eventType, data) {
+    if (!this.context) throw new Error("Plugin not initialized");
+    this.context.eventBus.emit({
+      type: eventType,
+      source: this.name,
+      data
+    });
+    this.metrics.eventsEmitted++;
+    this.status.lastActivity = Date.now();
+  }
+  on(eventType, handler) {
+    if (!this.context) throw new Error("Plugin not initialized");
+    this.context.eventBus.on(eventType, async (event) => {
+      this.metrics.eventsReceived++;
+      this.status.lastActivity = Date.now();
+      try {
+        await handler(event);
+      } catch (error) {
+        this.metrics.errors++;
+        this.status.error = error;
+        console.error(`Plugin ${this.name} error handling ${eventType}:`, error);
+      }
+    });
+  }
+}
+export {
+  BasePlugin
+};
+//# sourceMappingURL=plugin-interface.js.map

package/dist/core/plugins/plugin-interface.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/plugins/plugin-interface.ts"],
+  "sourcesContent": ["/**\n * Plugin Interface - Defines contract for all StackMemory plugins\n * Enables modular architecture with clear boundaries\n */\n\nimport { EventBus } from '../events/event-bus.js';\n\nexport interface PluginConfig {\n  name: string;\n  version: string;\n  enabled: boolean;\n  options?: Record<string, any>;\n}\n\nexport interface PluginContext {\n  eventBus: EventBus;\n  config: PluginConfig;\n  dataDir: string;\n  getRepository<T>(name: string): T;\n  registerRepository(name: string, repository: any): void;\n}\n\nexport interface Plugin {\n  readonly name: string;\n  readonly version: string;\n  readonly description: string;\n  readonly dependencies?: string[];\n\n  initialize(context: PluginContext): Promise<void>;\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  shutdown(): Promise<void>;\n  \n  getStatus(): PluginStatus;\n  getMetrics(): PluginMetrics;\n  validateConfig(config: PluginConfig): ValidationResult;\n}\n\nexport interface PluginStatus {\n  state: 'uninitialized' | 'initialized' | 'starting' | 'running' | 'stopping' | 'stopped' | 'error';\n  message?: string;\n  lastActivity?: number;\n  error?: Error;\n}\n\nexport interface PluginMetrics {\n  startTime?: number;\n  uptime?: number;\n  eventsEmitted: number;\n  eventsReceived: number;\n  errors: number;\n  custom?: Record<string, number>;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors?: string[];\n  warnings?: string[];\n}\n\nexport abstract class BasePlugin implements Plugin {\n  abstract readonly name: string;\n  abstract readonly version: string;\n  abstract readonly description: string;\n  readonly dependencies?: string[];\n\n  protected context?: PluginContext;\n  protected status: PluginStatus = { state: 'uninitialized' };\n  protected metrics: PluginMetrics = {\n    eventsEmitted: 0,\n    eventsReceived: 0,\n    errors: 0\n  };\n  protected startTime?: number;\n\n  async initialize(context: PluginContext): Promise<void> {\n    this.context = context;\n    this.status = { state: 'initialized' };\n    await this.onInitialize();\n  }\n\n  async start(): Promise<void> {\n    this.status = { state: 'starting' };\n    this.startTime = Date.now();\n    await this.onStart();\n    this.status = { state: 'running', lastActivity: Date.now() };\n  }\n\n  async stop(): Promise<void> {\n    this.status = { state: 'stopping' };\n    await this.onStop();\n    this.status = { state: 'stopped' };\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.status.state === 'running') {\n      await this.stop();\n    }\n    await this.onShutdown();\n    this.status = { state: 'uninitialized' };\n  }\n\n  getStatus(): PluginStatus {\n    return { ...this.status };\n  }\n\n  getMetrics(): PluginMetrics {\n    return {\n      ...this.metrics,\n      startTime: this.startTime,\n      uptime: this.startTime ? Date.now() - this.startTime : 0\n    };\n  }\n\n  validateConfig(config: PluginConfig): ValidationResult {\n    const errors: string[] = [];\n    const warnings: string[] = [];\n\n    if (config.name !== this.name) {\n      errors.push(`Config name '${config.name}' doesn't match plugin name '${this.name}'`);\n    }\n\n    const customValidation = this.onValidateConfig(config);\n    if (customValidation.errors) errors.push(...customValidation.errors);\n    if (customValidation.warnings) warnings.push(...customValidation.warnings);\n\n    return {\n      valid: errors.length === 0,\n      errors: errors.length > 0 ? errors : undefined,\n      warnings: warnings.length > 0 ? warnings : undefined\n    };\n  }\n\n  protected emit(eventType: string, data: Record<string, any>): void {\n    if (!this.context) throw new Error('Plugin not initialized');\n    \n    this.context.eventBus.emit({\n      type: eventType,\n      source: this.name,\n      data\n    });\n    this.metrics.eventsEmitted++;\n    this.status.lastActivity = Date.now();\n  }\n\n  protected on(eventType: string, handler: (event: any) => void | Promise<void>): void {\n    if (!this.context) throw new Error('Plugin not initialized');\n    \n    this.context.eventBus.on(eventType, async (event) => {\n      this.metrics.eventsReceived++;\n      this.status.lastActivity = Date.now();\n      try {\n        await handler(event);\n      } catch (error) {\n        this.metrics.errors++;\n        this.status.error = error as Error;\n        console.error(`Plugin ${this.name} error handling ${eventType}:`, error);\n      }\n    });\n  }\n\n  // Hooks for subclasses\n  protected abstract onInitialize(): Promise<void>;\n  protected abstract onStart(): Promise<void>;\n  protected abstract onStop(): Promise<void>;\n  protected abstract onShutdown(): Promise<void>;\n  protected abstract onValidateConfig(config: PluginConfig): ValidationResult;\n}"],
+  "mappings": "AA4DO,MAAe,WAA6B;AAAA,EAIxC;AAAA,EAEC;AAAA,EACA,SAAuB,EAAE,OAAO,gBAAgB;AAAA,EAChD,UAAyB;AAAA,IACjC,eAAe;AAAA,IACf,gBAAgB;AAAA,IAChB,QAAQ;AAAA,EACV;AAAA,EACU;AAAA,EAEV,MAAM,WAAW,SAAuC;AACtD,SAAK,UAAU;AACf,SAAK,SAAS,EAAE,OAAO,cAAc;AACrC,UAAM,KAAK,aAAa;AAAA,EAC1B;AAAA,EAEA,MAAM,QAAuB;AAC3B,SAAK,SAAS,EAAE,OAAO,WAAW;AAClC,SAAK,YAAY,KAAK,IAAI;AAC1B,UAAM,KAAK,QAAQ;AACnB,SAAK,SAAS,EAAE,OAAO,WAAW,cAAc,KAAK,IAAI,EAAE;AAAA,EAC7D;AAAA,EAEA,MAAM,OAAsB;AAC1B,SAAK,SAAS,EAAE,OAAO,WAAW;AAClC,UAAM,KAAK,OAAO;AAClB,SAAK,SAAS,EAAE,OAAO,UAAU;AAAA,EACnC;AAAA,EAEA,MAAM,WAA0B;AAC9B,QAAI,KAAK,OAAO,UAAU,WAAW;AACnC,YAAM,KAAK,KAAK;AAAA,IAClB;AACA,UAAM,KAAK,WAAW;AACtB,SAAK,SAAS,EAAE,OAAO,gBAAgB;AAAA,EACzC;AAAA,EAEA,YAA0B;AACxB,WAAO,EAAE,GAAG,KAAK,OAAO;AAAA,EAC1B;AAAA,EAEA,aAA4B;AAC1B,WAAO;AAAA,MACL,GAAG,KAAK;AAAA,MACR,WAAW,KAAK;AAAA,MAChB,QAAQ,KAAK,YAAY,KAAK,IAAI,IAAI,KAAK,YAAY;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,eAAe,QAAwC;AACrD,UAAM,SAAmB,CAAC;AAC1B,UAAM,WAAqB,CAAC;AAE5B,QAAI,OAAO,SAAS,KAAK,MAAM;AAC7B,aAAO,KAAK,gBAAgB,OAAO,IAAI,gCAAgC,KAAK,IAAI,GAAG;AAAA,IACrF;AAEA,UAAM,mBAAmB,KAAK,iBAAiB,MAAM;AACrD,QAAI,iBAAiB,OAAQ,QAAO,KAAK,GAAG,iBAAiB,MAAM;AACnE,QAAI,iBAAiB,SAAU,UAAS,KAAK,GAAG,iBAAiB,QAAQ;AAEzE,WAAO;AAAA,MACL,OAAO,OAAO,WAAW;AAAA,MACzB,QAAQ,OAAO,SAAS,IAAI,SAAS;AAAA,MACrC,UAAU,SAAS,SAAS,IAAI,WAAW;AAAA,IAC7C;AAAA,EACF;AAAA,EAEU,KAAK,WAAmB,MAAiC;AACjE,QAAI,CAAC,KAAK,QAAS,OAAM,IAAI,MAAM,wBAAwB;AAE3D,SAAK,QAAQ,SAAS,KAAK;AAAA,MACzB,MAAM;AAAA,MACN,QAAQ,KAAK;AAAA,MACb;AAAA,IACF,CAAC;AACD,SAAK,QAAQ;AACb,SAAK,OAAO,eAAe,KAAK,IAAI;AAAA,EACtC;AAAA,EAEU,GAAG,WAAmB,SAAqD;AACnF,QAAI,CAAC,KAAK,QAAS,OAAM,IAAI,MAAM,wBAAwB;AAE3D,SAAK,QAAQ,SAAS,GAAG,WAAW,OAAO,UAAU;AACnD,WAAK,QAAQ;AACb,WAAK,OAAO,eAAe,KAAK,IAAI;AACpC,UAAI;AACF,cAAM,QAAQ,KAAK;AAAA,MACrB,SAAS,OAAO;AACd,aAAK,QAAQ;AACb,aAAK,OAAO,QAAQ;AACpB,gBAAQ,MAAM,UAAU,KAAK,IAAI,mBAAmB,SAAS,KAAK,KAAK;AAAA,MACzE;AAAA,IACF,CAAC;AAAA,EACH;AAQF;",
+  "names": []
+}