@objectstack/core 2.0.5 → 2.0.7

package/dist/index.d.cts

@@ -133,6 +133,12 @@ declare class PluginLoader {
      * Register a static service instance (legacy support)
      */
     registerService(name: string, service: any): void;
+    /**
+     * Replace an existing service instance.
+     * Used by optimization plugins to swap kernel internals.
+     * @throws Error if service does not exist
+     */
+    replaceService(name: string, service: any): void;
     /**
      * Check if a service is registered (either as instance or factory)
      */
@@ -300,6 +306,16 @@ interface PluginContext {
      * @throws Error if service not found
      */
     getService<T>(name: string): T;
+    /**
+     * Replace an existing service with a new implementation.
+     * Useful for optimization plugins that wrap or swap kernel internals
+     * (e.g., metadata registry, connection pooling).
+     *
+     * @param name - Service name to replace
+     * @param implementation - New service implementation
+     * @throws Error if the service does not exist
+     */
+    replaceService<T>(name: string, implementation: T): void;
     /**
      * Get all registered services
      */
@@ -1252,6 +1268,7 @@ declare class SecurePluginContext implements PluginContext {
     constructor(pluginName: string, permissionEnforcer: PluginPermissionEnforcer, baseContext: PluginContext);
     registerService(name: string, service: any): void;
     getService<T>(name: string): T;
+    replaceService<T>(name: string, implementation: T): void;
     getServices(): Map<string, any>;
     hook(name: string, handler: (...args: any[]) => void | Promise<void>): void;
     trigger(name: string, ...args: any[]): Promise<void>;

package/dist/index.d.ts

@@ -133,6 +133,12 @@ declare class PluginLoader {
      * Register a static service instance (legacy support)
      */
     registerService(name: string, service: any): void;
+    /**
+     * Replace an existing service instance.
+     * Used by optimization plugins to swap kernel internals.
+     * @throws Error if service does not exist
+     */
+    replaceService(name: string, service: any): void;
     /**
      * Check if a service is registered (either as instance or factory)
      */
@@ -300,6 +306,16 @@ interface PluginContext {
      * @throws Error if service not found
      */
     getService<T>(name: string): T;
+    /**
+     * Replace an existing service with a new implementation.
+     * Useful for optimization plugins that wrap or swap kernel internals
+     * (e.g., metadata registry, connection pooling).
+     *
+     * @param name - Service name to replace
+     * @param implementation - New service implementation
+     * @throws Error if the service does not exist
+     */
+    replaceService<T>(name: string, implementation: T): void;
     /**
      * Get all registered services
      */
@@ -1252,6 +1268,7 @@ declare class SecurePluginContext implements PluginContext {
     constructor(pluginName: string, permissionEnforcer: PluginPermissionEnforcer, baseContext: PluginContext);
     registerService(name: string, service: any): void;
     getService<T>(name: string): T;
+    replaceService<T>(name: string, implementation: T): void;
     getServices(): Map<string, any>;
     hook(name: string, handler: (...args: any[]) => void | Promise<void>): void;
     trigger(name: string, ...args: any[]): Promise<void>;

package/dist/index.js

@@ -61,6 +61,20 @@ var ObjectKernelBase = class {
           return this.services.get(name);
         }
       },
+      replaceService: (name, implementation) => {
+        if (this.services instanceof Map) {
+          if (!this.services.has(name)) {
+            throw new Error(`[Kernel] Service '${name}' not found. Use registerService() to add new services.`);
+          }
+          this.services.set(name, implementation);
+        } else {
+          if (!this.services.has(name)) {
+            throw new Error(`[Kernel] Service '${name}' not found. Use registerService() to add new services.`);
+          }
+          this.services.register(name, implementation);
+        }
+        this.logger.info(`Service '${name}' replaced`, { service: name });
+      },
       hook: (name, handler) => {
         if (!this.hooks.has(name)) {
           this.hooks.set(name, []);
@@ -735,6 +749,17 @@ var PluginLoader = class {
     }
     this.serviceInstances.set(name, service);
   }
+  /**
+   * Replace an existing service instance.
+   * Used by optimization plugins to swap kernel internals.
+   * @throws Error if service does not exist
+   */
+  replaceService(name, service) {
+    if (!this.hasService(name)) {
+      throw new Error(`Service '${name}' not found`);
+    }
+    this.serviceInstances.set(name, service);
+  }
   /**
    * Check if a service is registered (either as instance or factory)
    */
@@ -970,6 +995,15 @@ var ObjectKernel = class {
           throw new Error(`[Kernel] Service '${name}' not found`);
         }
       },
+      replaceService: (name, implementation) => {
+        const hasService = this.services.has(name) || this.pluginLoader.hasService(name);
+        if (!hasService) {
+          throw new Error(`[Kernel] Service '${name}' not found. Use registerService() to add new services.`);
+        }
+        this.services.set(name, implementation);
+        this.pluginLoader.replaceService(name, implementation);
+        this.logger.info(`Service '${name}' replaced`, { service: name });
+      },
       hook: (name, handler) => {
         if (!this.hooks.has(name)) {
           this.hooks.set(name, []);
@@ -2738,6 +2772,10 @@ var SecurePluginContext = class {
     this.permissionEnforcer.enforceServiceAccess(this.pluginName, name);
     return this.baseContext.getService(name);
   }
+  replaceService(name, implementation) {
+    this.permissionEnforcer.enforceServiceAccess(this.pluginName, name);
+    this.baseContext.replaceService(name, implementation);
+  }
   getServices() {
     return this.baseContext.getServices();
   }