@omnicross/core 0.1.0

package/dist/transformer/TransformerService.d.cts

@@ -0,0 +1,138 @@
+import { TransformerLogger, Transformer, TransformerConstructor, TransformerChainConfig, ResolvedTransformerChain, TransformerReference } from './types.cjs';
+
+/**
+ * TransformerService - Core service for managing transformer lifecycle
+ *
+ * Handles transformer registration, retrieval, and initialization.
+ *
+ * Adapted from the `musistudio/llms` project (MIT, © 2025 musistudio) — the
+ * transformer IR upstream — for the Electron environment. See the package
+ * `NOTICE` for full third-party attribution.
+ *
+ * @module transformer/TransformerService
+ */
+
+/**
+ * TransformerService manages the lifecycle of all transformers.
+ *
+ * Features:
+ * - Register transformers by name
+ * - Get transformer by name
+ * - Initialize default transformers
+ * - Resolve transformer chains from configuration
+ */
+declare class TransformerService {
+    private transformers;
+    private logger;
+    private instanceCache;
+    private endpointTransformersCache;
+    private noEndpointTransformersCache;
+    constructor(logger?: TransformerLogger);
+    /**
+     * Clear instance caches
+     */
+    clearInstanceCache(): void;
+    /**
+     * Get cache statistics for diagnostics
+     */
+    getCacheStats(): {
+        instanceCacheSize: number;
+        hasEndpointCache: boolean;
+    };
+    /**
+     * Register a transformer by name
+     * @param name - Unique transformer name
+     * @param transformer - Transformer instance or constructor
+     */
+    registerTransformer(name: string, transformer: Transformer | TransformerConstructor): void;
+    /**
+     * Get a transformer by name
+     * @param name - Transformer name
+     * @returns Transformer instance/constructor or undefined
+     */
+    getTransformer(name: string): Transformer | TransformerConstructor | undefined;
+    /**
+     * Get all registered transformers
+     * @returns Map of all transformers
+     */
+    getAllTransformers(): Map<string, Transformer | TransformerConstructor>;
+    /**
+     * Get transformers that have an endpoint defined
+     * Uses cache to avoid redundant traversal
+     * @returns Array of transformers with endpoints
+     */
+    getTransformersWithEndpoint(): {
+        name: string;
+        transformer: Transformer;
+    }[];
+    /**
+     * Get transformers without endpoints
+     * Uses cache to avoid redundant traversal
+     * @returns Array of transformers without endpoints
+     */
+    getTransformersWithoutEndpoint(): {
+        name: string;
+        transformer: Transformer;
+    }[];
+    /**
+     * Remove a transformer by name
+     * @param name - Transformer name
+     * @returns true if removed, false if not found
+     */
+    removeTransformer(name: string): boolean;
+    /**
+     * Check if a transformer is registered
+     * @param name - Transformer name
+     * @returns true if registered
+     */
+    hasTransformer(name: string): boolean;
+    /**
+     * Initialize the service with default transformers
+     * @param defaultTransformers - Map or object of default transformers
+     */
+    initialize(defaultTransformers?: Record<string, Transformer | TransformerConstructor>): Promise<void>;
+    /**
+     * Register default transformers from a map
+     * @param transformers - Map of transformer name to transformer
+     */
+    private registerDefaultTransformers;
+    /**
+     * Resolve a transformer chain configuration to actual transformer instances
+     * @param chainConfig - Transformer chain configuration
+     * @param modelName - Model name for model-specific transformers
+     * @returns Resolved transformer chain with instances
+     */
+    resolveTransformerChain(chainConfig: TransformerChainConfig | undefined, modelName?: string): ResolvedTransformerChain;
+    /**
+     * Resolve an array of transformer references to instances
+     * @param refs - Array of transformer references
+     * @returns Array of transformer instances
+     */
+    resolveTransformerReferences(refs: TransformerReference[]): Transformer[];
+    /**
+     * Instantiate a transformer if it's a constructor
+     * Uses instance cache to avoid redundant instantiation
+     *
+     * @param transformer - Transformer instance or constructor
+     * @param options - Options to pass to constructor
+     * @returns Transformer instance
+     */
+    private instantiateIfNeeded;
+    /**
+     * Check if a value is a transformer constructor
+     * @param value - Value to check
+     * @returns true if it's a constructor
+     */
+    private isTransformerConstructor;
+    /**
+     * Get list of all registered transformer names
+     * @returns Array of transformer names
+     */
+    getTransformerNames(): string[];
+    /**
+     * Clear all registered transformers
+     */
+    clear(): void;
+}
+
+export { TransformerService };

package/dist/transformer/TransformerService.d.ts

@@ -0,0 +1,138 @@
+import { TransformerLogger, Transformer, TransformerConstructor, TransformerChainConfig, ResolvedTransformerChain, TransformerReference } from './types.js';
+
+/**
+ * TransformerService - Core service for managing transformer lifecycle
+ *
+ * Handles transformer registration, retrieval, and initialization.
+ *
+ * Adapted from the `musistudio/llms` project (MIT, © 2025 musistudio) — the
+ * transformer IR upstream — for the Electron environment. See the package
+ * `NOTICE` for full third-party attribution.
+ *
+ * @module transformer/TransformerService
+ */
+
+/**
+ * TransformerService manages the lifecycle of all transformers.
+ *
+ * Features:
+ * - Register transformers by name
+ * - Get transformer by name
+ * - Initialize default transformers
+ * - Resolve transformer chains from configuration
+ */
+declare class TransformerService {
+    private transformers;
+    private logger;
+    private instanceCache;
+    private endpointTransformersCache;
+    private noEndpointTransformersCache;
+    constructor(logger?: TransformerLogger);
+    /**
+     * Clear instance caches
+     */
+    clearInstanceCache(): void;
+    /**
+     * Get cache statistics for diagnostics
+     */
+    getCacheStats(): {
+        instanceCacheSize: number;
+        hasEndpointCache: boolean;
+    };
+    /**
+     * Register a transformer by name
+     * @param name - Unique transformer name
+     * @param transformer - Transformer instance or constructor
+     */
+    registerTransformer(name: string, transformer: Transformer | TransformerConstructor): void;
+    /**
+     * Get a transformer by name
+     * @param name - Transformer name
+     * @returns Transformer instance/constructor or undefined
+     */
+    getTransformer(name: string): Transformer | TransformerConstructor | undefined;
+    /**
+     * Get all registered transformers
+     * @returns Map of all transformers
+     */
+    getAllTransformers(): Map<string, Transformer | TransformerConstructor>;
+    /**
+     * Get transformers that have an endpoint defined
+     * Uses cache to avoid redundant traversal
+     * @returns Array of transformers with endpoints
+     */
+    getTransformersWithEndpoint(): {
+        name: string;
+        transformer: Transformer;
+    }[];
+    /**
+     * Get transformers without endpoints
+     * Uses cache to avoid redundant traversal
+     * @returns Array of transformers without endpoints
+     */
+    getTransformersWithoutEndpoint(): {
+        name: string;
+        transformer: Transformer;
+    }[];
+    /**
+     * Remove a transformer by name
+     * @param name - Transformer name
+     * @returns true if removed, false if not found
+     */
+    removeTransformer(name: string): boolean;
+    /**
+     * Check if a transformer is registered
+     * @param name - Transformer name
+     * @returns true if registered
+     */
+    hasTransformer(name: string): boolean;
+    /**
+     * Initialize the service with default transformers
+     * @param defaultTransformers - Map or object of default transformers
+     */
+    initialize(defaultTransformers?: Record<string, Transformer | TransformerConstructor>): Promise<void>;
+    /**
+     * Register default transformers from a map
+     * @param transformers - Map of transformer name to transformer
+     */
+    private registerDefaultTransformers;
+    /**
+     * Resolve a transformer chain configuration to actual transformer instances
+     * @param chainConfig - Transformer chain configuration
+     * @param modelName - Model name for model-specific transformers
+     * @returns Resolved transformer chain with instances
+     */
+    resolveTransformerChain(chainConfig: TransformerChainConfig | undefined, modelName?: string): ResolvedTransformerChain;
+    /**
+     * Resolve an array of transformer references to instances
+     * @param refs - Array of transformer references
+     * @returns Array of transformer instances
+     */
+    resolveTransformerReferences(refs: TransformerReference[]): Transformer[];
+    /**
+     * Instantiate a transformer if it's a constructor
+     * Uses instance cache to avoid redundant instantiation
+     *
+     * @param transformer - Transformer instance or constructor
+     * @param options - Options to pass to constructor
+     * @returns Transformer instance
+     */
+    private instantiateIfNeeded;
+    /**
+     * Check if a value is a transformer constructor
+     * @param value - Value to check
+     * @returns true if it's a constructor
+     */
+    private isTransformerConstructor;
+    /**
+     * Get list of all registered transformer names
+     * @returns Array of transformer names
+     */
+    getTransformerNames(): string[];
+    /**
+     * Clear all registered transformers
+     */
+    clear(): void;
+}
+
+export { TransformerService };

package/dist/transformer/TransformerService.js

@@ -0,0 +1,265 @@
+// src/transformer/TransformerService.ts
+var defaultLogger = {
+  debug: (msg, ...args) => console.debug(`[TransformerService] ${msg}`, ...args),
+  info: (msg, ...args) => console.info(`[TransformerService] ${msg}`, ...args),
+  warn: (msg, ...args) => console.warn(`[TransformerService] ${msg}`, ...args),
+  error: (msg, ...args) => console.error(`[TransformerService] ${msg}`, ...args)
+};
+var TransformerService = class {
+  transformers = /* @__PURE__ */ new Map();
+  logger;
+  // Performance optimization: Cache instantiated transformers
+  instanceCache = /* @__PURE__ */ new Map();
+  // Performance optimization: Cache endpoint transformer results
+  endpointTransformersCache = null;
+  noEndpointTransformersCache = null;
+  constructor(logger) {
+    this.logger = logger ?? defaultLogger;
+  }
+  /**
+   * Clear instance caches
+   */
+  clearInstanceCache() {
+    this.instanceCache.clear();
+    this.endpointTransformersCache = null;
+    this.noEndpointTransformersCache = null;
+  }
+  /**
+   * Get cache statistics for diagnostics
+   */
+  getCacheStats() {
+    return {
+      instanceCacheSize: this.instanceCache.size,
+      hasEndpointCache: this.endpointTransformersCache !== null
+    };
+  }
+  /**
+   * Register a transformer by name
+   * @param name - Unique transformer name
+   * @param transformer - Transformer instance or constructor
+   */
+  registerTransformer(name, transformer) {
+    this.transformers.set(name, transformer);
+    this.clearInstanceCache();
+    const endpoint = "endPoint" in transformer ? transformer.endPoint : "prototype" in transformer && transformer.prototype?.endPoint ? transformer.prototype.endPoint : void 0;
+    this.logger.info(
+      `Registered transformer: ${name}${endpoint ? ` (endpoint: ${endpoint})` : " (no endpoint)"}`
+    );
+  }
+  /**
+   * Get a transformer by name
+   * @param name - Transformer name
+   * @returns Transformer instance/constructor or undefined
+   */
+  getTransformer(name) {
+    return this.transformers.get(name);
+  }
+  /**
+   * Get all registered transformers
+   * @returns Map of all transformers
+   */
+  getAllTransformers() {
+    return new Map(this.transformers);
+  }
+  /**
+   * Get transformers that have an endpoint defined
+   * Uses cache to avoid redundant traversal
+   * @returns Array of transformers with endpoints
+   */
+  getTransformersWithEndpoint() {
+    if (this.endpointTransformersCache) {
+      return this.endpointTransformersCache;
+    }
+    const result = [];
+    this.transformers.forEach((transformer, name) => {
+      const instance = this.instantiateIfNeeded(transformer);
+      if (instance?.endPoint) {
+        result.push({ name, transformer: instance });
+      }
+    });
+    this.endpointTransformersCache = result;
+    return result;
+  }
+  /**
+   * Get transformers without endpoints
+   * Uses cache to avoid redundant traversal
+   * @returns Array of transformers without endpoints
+   */
+  getTransformersWithoutEndpoint() {
+    if (this.noEndpointTransformersCache) {
+      return this.noEndpointTransformersCache;
+    }
+    const result = [];
+    this.transformers.forEach((transformer, name) => {
+      const instance = this.instantiateIfNeeded(transformer);
+      if (instance && !instance.endPoint) {
+        result.push({ name, transformer: instance });
+      }
+    });
+    this.noEndpointTransformersCache = result;
+    return result;
+  }
+  /**
+   * Remove a transformer by name
+   * @param name - Transformer name
+   * @returns true if removed, false if not found
+   */
+  removeTransformer(name) {
+    const removed = this.transformers.delete(name);
+    if (removed) {
+      this.clearInstanceCache();
+    }
+    return removed;
+  }
+  /**
+   * Check if a transformer is registered
+   * @param name - Transformer name
+   * @returns true if registered
+   */
+  hasTransformer(name) {
+    return this.transformers.has(name);
+  }
+  /**
+   * Initialize the service with default transformers
+   * @param defaultTransformers - Map or object of default transformers
+   */
+  async initialize(defaultTransformers) {
+    try {
+      if (defaultTransformers) {
+        await this.registerDefaultTransformers(defaultTransformers);
+      }
+      this.logger.info(
+        `TransformerService initialized with ${this.transformers.size} transformers`
+      );
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logger.error(`TransformerService init error: ${errorMessage}`);
+      throw error;
+    }
+  }
+  /**
+   * Register default transformers from a map
+   * @param transformers - Map of transformer name to transformer
+   */
+  async registerDefaultTransformers(transformers) {
+    for (const [key, TransformerClass] of Object.entries(transformers)) {
+      try {
+        if (this.isTransformerConstructor(TransformerClass)) {
+          const staticName = TransformerClass.TransformerName ?? key;
+          this.registerTransformer(staticName, TransformerClass);
+        } else {
+          const name = TransformerClass.name ?? key;
+          TransformerClass.logger = this.logger;
+          this.registerTransformer(name, TransformerClass);
+        }
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.logger.error(`Failed to register transformer ${key}: ${errorMessage}`);
+      }
+    }
+  }
+  /**
+   * Resolve a transformer chain configuration to actual transformer instances
+   * @param chainConfig - Transformer chain configuration
+   * @param modelName - Model name for model-specific transformers
+   * @returns Resolved transformer chain with instances
+   */
+  resolveTransformerChain(chainConfig, modelName) {
+    const result = {
+      providerTransformers: [],
+      modelTransformers: []
+    };
+    if (!chainConfig) {
+      return result;
+    }
+    if (chainConfig.use) {
+      result.providerTransformers = this.resolveTransformerReferences(chainConfig.use);
+    }
+    if (modelName && chainConfig[modelName]) {
+      const modelConfig = chainConfig[modelName];
+      if (Array.isArray(modelConfig)) {
+        result.modelTransformers = this.resolveTransformerReferences(modelConfig);
+      } else if (modelConfig && typeof modelConfig === "object" && "use" in modelConfig) {
+        result.modelTransformers = this.resolveTransformerReferences(modelConfig.use ?? []);
+      }
+    }
+    return result;
+  }
+  /**
+   * Resolve an array of transformer references to instances
+   * @param refs - Array of transformer references
+   * @returns Array of transformer instances
+   */
+  resolveTransformerReferences(refs) {
+    const instances = [];
+    for (const ref of refs) {
+      const [name, options] = Array.isArray(ref) ? ref : [ref, void 0];
+      const transformer = this.getTransformer(name);
+      if (!transformer) {
+        this.logger.warn(`Transformer not found: ${name}`);
+        continue;
+      }
+      const instance = this.instantiateIfNeeded(transformer, options);
+      if (instance) {
+        instance.logger = this.logger;
+        instances.push(instance);
+      }
+    }
+    return instances;
+  }
+  /**
+   * Instantiate a transformer if it's a constructor
+   * Uses instance cache to avoid redundant instantiation
+   *
+   * @param transformer - Transformer instance or constructor
+   * @param options - Options to pass to constructor
+   * @returns Transformer instance
+   */
+  instantiateIfNeeded(transformer, options) {
+    if (!this.isTransformerConstructor(transformer)) {
+      return transformer;
+    }
+    const constructorName = transformer.TransformerName || transformer.name || "anonymous";
+    const optionsHash = options ? JSON.stringify(options) : "";
+    const cacheKey = `${constructorName}:${optionsHash}`;
+    if (this.instanceCache.has(cacheKey)) {
+      return this.instanceCache.get(cacheKey);
+    }
+    try {
+      const instance = new transformer(options);
+      instance.logger = this.logger;
+      this.instanceCache.set(cacheKey, instance);
+      return instance;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logger.error(`Failed to instantiate transformer: ${errorMessage}`);
+      return void 0;
+    }
+  }
+  /**
+   * Check if a value is a transformer constructor
+   * @param value - Value to check
+   * @returns true if it's a constructor
+   */
+  isTransformerConstructor(value) {
+    return typeof value === "function" && value.prototype && (typeof value.prototype.transformRequestIn === "function" || typeof value.prototype.transformRequestOut === "function" || typeof value.prototype.transformResponseIn === "function" || typeof value.prototype.transformResponseOut === "function" || "TransformerName" in value);
+  }
+  /**
+   * Get list of all registered transformer names
+   * @returns Array of transformer names
+   */
+  getTransformerNames() {
+    return Array.from(this.transformers.keys());
+  }
+  /**
+   * Clear all registered transformers
+   */
+  clear() {
+    this.transformers.clear();
+    this.clearInstanceCache();
+    this.logger.info("All transformers cleared");
+  }
+};
+export {
+  TransformerService
+};