hazo_llm_api 1.0.4 → 1.0.6

package/dist/lib/config/provider_loader.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Provider Loader Factory
+ *
+ * Generic factory for loading LLM providers from configuration.
+ * Reduces duplication by providing a unified approach to provider loading.
+ */
+import type { LLMProvider, ServiceType } from '../providers/types.js';
+import type { Logger } from '../llm_api/types.js';
+import { type ParameterMapping } from './config_parser.js';
+/**
+ * Base configuration that all providers share
+ */
+export interface BaseProviderConfig {
+    api_key: string;
+    api_url?: string;
+    capabilities?: ServiceType[];
+    logger: Logger;
+}
+/**
+ * Provider factory definition
+ * Used to register how to load a specific provider type
+ */
+export interface ProviderFactory<TConfig extends BaseProviderConfig> {
+    /** Provider name (lowercase) */
+    name: string;
+    /** INI section name (e.g., "llm_gemini") */
+    config_section: string;
+    /** Parameter mappings for text generation config */
+    text_param_mappings: ParameterMapping[];
+    /** Parameter mappings for image generation config */
+    image_param_mappings: ParameterMapping[];
+    /**
+     * Build provider-specific config from INI section
+     *
+     * @param section - The parsed INI section
+     * @param api_key - The API key loaded from environment
+     * @param text_config - Parsed text generation config
+     * @param image_config - Parsed image generation config
+     * @param capabilities - Parsed capabilities
+     * @param logger - Logger instance
+     * @returns Provider-specific config object
+     */
+    build_config(section: Record<string, string>, api_key: string, text_config: unknown, image_config: unknown, capabilities: ServiceType[], logger: Logger): TConfig;
+    /**
+     * Create provider instance from config
+     *
+     * @param config - Provider-specific config object
+     * @returns Provider instance
+     */
+    create_provider(config: TConfig): LLMProvider;
+}
+/**
+ * Result of loading a provider
+ */
+export type ProviderLoadResult = {
+    success: true;
+    provider: LLMProvider;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Register a provider factory
+ *
+ * @param factory - Provider factory to register
+ *
+ * @example
+ * ```typescript
+ * register_provider_factory({
+ *   name: 'gemini',
+ *   config_section: 'llm_gemini',
+ *   text_param_mappings: GEMINI_PARAM_MAPPINGS,
+ *   image_param_mappings: GEMINI_PARAM_MAPPINGS,
+ *   build_config: (section, api_key, text_config, image_config, capabilities, logger) => ({
+ *     api_key,
+ *     api_url: section.api_url,
+ *     // ... other gemini-specific fields
+ *   }),
+ *   create_provider: (config) => new GeminiProvider(config),
+ * });
+ * ```
+ */
+export declare function register_provider_factory<TConfig extends BaseProviderConfig>(factory: ProviderFactory<TConfig>): void;
+/**
+ * Get a registered provider factory by name
+ *
+ * @param name - Provider name (case-insensitive)
+ * @returns Provider factory or undefined
+ */
+export declare function get_provider_factory(name: string): ProviderFactory<BaseProviderConfig> | undefined;
+/**
+ * Get all registered provider factory names
+ *
+ * @returns Array of provider names
+ */
+export declare function get_registered_factory_names(): string[];
+/**
+ * Load a provider from config using its registered factory
+ *
+ * @param provider_name - Name of the provider to load
+ * @param logger - Logger instance
+ * @returns Provider instance or error result
+ */
+export declare function load_provider_from_config(provider_name: string, logger: Logger): ProviderLoadResult;
+/**
+ * Load all enabled providers from config
+ *
+ * @param enabled_llms - List of enabled LLM names
+ * @param logger - Logger instance
+ * @returns Map of successfully loaded providers
+ */
+export declare function load_all_providers(enabled_llms: string[], logger: Logger): Map<string, LLMProvider>;
+//# sourceMappingURL=provider_loader.d.ts.map

package/dist/lib/config/provider_loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider_loader.d.ts","sourceRoot":"","sources":["../../../src/lib/config/provider_loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAM5B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,kBAAkB;IACjE,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IAEvB,oDAAoD;IACpD,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;IAExC,qDAAqD;IACrD,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,WAAW,EAAE,EAC3B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAEX;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,GACxC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAWtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,SAAS,kBAAkB,EAC1E,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,GAChC,IAAI,CAKN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GACX,eAAe,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,kBAAkB,CAmGpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAsB1B"}

package/dist/lib/config/provider_loader.js

@@ -0,0 +1,169 @@
+/**
+ * Provider Loader Factory
+ *
+ * Generic factory for loading LLM providers from configuration.
+ * Reduces duplication by providing a unified approach to provider loading.
+ */
+import { find_config_file, read_config_file, parse_generation_config, parse_capabilities, load_api_key_from_env, get_api_key_env_var_name, } from './config_parser.js';
+// =============================================================================
+// Provider Registry
+// =============================================================================
+/**
+ * Map of registered provider factories by name
+ */
+const provider_factories = new Map();
+/**
+ * Register a provider factory
+ *
+ * @param factory - Provider factory to register
+ *
+ * @example
+ * ```typescript
+ * register_provider_factory({
+ *   name: 'gemini',
+ *   config_section: 'llm_gemini',
+ *   text_param_mappings: GEMINI_PARAM_MAPPINGS,
+ *   image_param_mappings: GEMINI_PARAM_MAPPINGS,
+ *   build_config: (section, api_key, text_config, image_config, capabilities, logger) => ({
+ *     api_key,
+ *     api_url: section.api_url,
+ *     // ... other gemini-specific fields
+ *   }),
+ *   create_provider: (config) => new GeminiProvider(config),
+ * });
+ * ```
+ */
+export function register_provider_factory(factory) {
+    provider_factories.set(factory.name.toLowerCase(), factory);
+}
+/**
+ * Get a registered provider factory by name
+ *
+ * @param name - Provider name (case-insensitive)
+ * @returns Provider factory or undefined
+ */
+export function get_provider_factory(name) {
+    return provider_factories.get(name.toLowerCase());
+}
+/**
+ * Get all registered provider factory names
+ *
+ * @returns Array of provider names
+ */
+export function get_registered_factory_names() {
+    return Array.from(provider_factories.keys());
+}
+// =============================================================================
+// Provider Loading
+// =============================================================================
+/**
+ * Load a provider from config using its registered factory
+ *
+ * @param provider_name - Name of the provider to load
+ * @param logger - Logger instance
+ * @returns Provider instance or error result
+ */
+export function load_provider_from_config(provider_name, logger) {
+    const file_name = 'provider_loader.ts';
+    const name_lower = provider_name.toLowerCase();
+    // Get the factory for this provider
+    const factory = provider_factories.get(name_lower);
+    if (!factory) {
+        return {
+            success: false,
+            error: `No factory registered for provider "${provider_name}". Available: ${get_registered_factory_names().join(', ')}`,
+        };
+    }
+    // Find and read config file
+    const config_path = find_config_file();
+    if (!config_path) {
+        logger.warn('Config file not found', {
+            file: file_name,
+            data: { provider: provider_name },
+        });
+        return {
+            success: false,
+            error: 'Config file config/hazo_llm_api_config.ini not found',
+        };
+    }
+    const config = read_config_file(config_path);
+    if (!config) {
+        return {
+            success: false,
+            error: `Failed to read config file: ${config_path}`,
+        };
+    }
+    // Get the provider's section
+    const section = config[factory.config_section] || {};
+    // Load API key from environment
+    const api_key = load_api_key_from_env(name_lower);
+    if (!api_key) {
+        const env_var = get_api_key_env_var_name(name_lower);
+        logger.error(`${env_var} not found in environment variables`, {
+            file: file_name,
+            data: { provider: provider_name, config_path },
+        });
+        return {
+            success: false,
+            error: `${env_var} not found in environment variables. Add it to your .env.local file.`,
+        };
+    }
+    try {
+        // Parse generation configs
+        const text_config = parse_generation_config(section, factory.text_param_mappings, 'text_');
+        const image_config = parse_generation_config(section, factory.image_param_mappings, 'image_');
+        // Parse capabilities
+        const capabilities = parse_capabilities(section.capabilities);
+        // Build provider config
+        const provider_config = factory.build_config(section, api_key, text_config, image_config, capabilities, logger);
+        // Create provider instance
+        const provider = factory.create_provider(provider_config);
+        logger.info(`Loaded ${provider_name} provider`, {
+            file: file_name,
+            data: {
+                capabilities: Array.from(provider.get_capabilities()),
+            },
+        });
+        return { success: true, provider };
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to load ${provider_name} provider`, {
+            file: file_name,
+            data: { error: error_message, config_path },
+        });
+        return {
+            success: false,
+            error: `Failed to create ${provider_name} provider: ${error_message}`,
+        };
+    }
+}
+/**
+ * Load all enabled providers from config
+ *
+ * @param enabled_llms - List of enabled LLM names
+ * @param logger - Logger instance
+ * @returns Map of successfully loaded providers
+ */
+export function load_all_providers(enabled_llms, logger) {
+    const file_name = 'provider_loader.ts';
+    const providers = new Map();
+    for (const llm_name of enabled_llms) {
+        const result = load_provider_from_config(llm_name, logger);
+        if (result.success) {
+            providers.set(llm_name.toLowerCase(), result.provider);
+        }
+        else {
+            logger.warn(`${llm_name} provider is enabled but failed to load`, {
+                file: file_name,
+                data: {
+                    llm_name,
+                    error: result.error,
+                    hint: `Check ${get_api_key_env_var_name(llm_name)} in environment variables and [llm_${llm_name.toLowerCase()}] section in config.`,
+                },
+            });
+        }
+    }
+    return providers;
+}
+//# sourceMappingURL=provider_loader.js.map

package/dist/lib/config/provider_loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider_loader.js","sourceRoot":"","sources":["../../../src/lib/config/provider_loader.ts"],"names":[],"mappings":"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"}

package/dist/lib/database/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Database Module Exports
+ *
+ * Export all database-related functions from this module
+ */
+export { initialize_database, get_database, close_database, insert_prompt, update_prompt, delete_prompt, get_default_sqlite_path, expand_path, resolve_sqlite_path, } from './init_database.js';
+export { row_to_prompt_record, PROMPT_COLUMNS, PROMPT_COLUMN_NAMES, get_prompt_select_clause, } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EAEb,uBAAuB,EACvB,WAAW,EACX,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/lib/database/index.js

@@ -0,0 +1,10 @@
+/**
+ * Database Module Exports
+ *
+ * Export all database-related functions from this module
+ */
+export { initialize_database, get_database, close_database, insert_prompt, update_prompt, delete_prompt, 
+// Path helpers
+get_default_sqlite_path, expand_path, resolve_sqlite_path, } from './init_database.js';
+export { row_to_prompt_record, PROMPT_COLUMNS, PROMPT_COLUMN_NAMES, get_prompt_select_clause, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa;AACb,eAAe;AACf,uBAAuB,EACvB,WAAW,EACX,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/lib/database/init_database.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Database Initialization Module
+ *
+ * Initializes and manages the SQLite database for prompt storage.
+ * Uses sql.js for database operations (pure JavaScript SQLite).
+ * Creates the prompts_library table if it doesn't exist.
+ */
+import { Database as SqlJsDatabase } from 'sql.js';
+import type { Logger, PromptRecord } from '../llm_api/types.js';
+/**
+ * Get the default SQLite database path
+ * Returns an absolute path relative to the current working directory
+ *
+ * @returns Default database path: "{process.cwd()}/prompt_library.sqlite"
+ *
+ * @example
+ * ```typescript
+ * import { get_default_sqlite_path } from 'hazo_llm_api/server';
+ *
+ * const path = get_default_sqlite_path();
+ * // Returns: "/path/to/your/app/prompt_library.sqlite"
+ * ```
+ */
+export declare function get_default_sqlite_path(): string;
+/**
+ * Expand tilde (~) in path to user's home directory
+ * Also supports environment variables in the format ${VAR_NAME}
+ *
+ * @param file_path - Path that may contain ~ or environment variables
+ * @returns Expanded path
+ *
+ * @example
+ * ```typescript
+ * import { expand_path } from 'hazo_llm_api/server';
+ *
+ * expand_path('~/data/prompts.db');
+ * // Returns: "/Users/username/data/prompts.db"
+ *
+ * expand_path('${HOME}/data/prompts.db');
+ * // Returns: "/Users/username/data/prompts.db"
+ * ```
+ */
+export declare function expand_path(file_path: string): string;
+/**
+ * Resolve a database path to an absolute path
+ * Handles tilde expansion, environment variables, and relative paths
+ *
+ * @param sqlite_path - Path to resolve (can be relative, absolute, or contain ~/$VAR)
+ * @returns Absolute path to the database file
+ *
+ * @example
+ * ```typescript
+ * import { resolve_sqlite_path } from 'hazo_llm_api/server';
+ *
+ * resolve_sqlite_path('prompt_library.sqlite');
+ * // Returns: "/path/to/cwd/prompt_library.sqlite"
+ *
+ * resolve_sqlite_path('~/data/prompts.db');
+ * // Returns: "/Users/username/data/prompts.db"
+ *
+ * resolve_sqlite_path('/absolute/path/prompts.db');
+ * // Returns: "/absolute/path/prompts.db"
+ * ```
+ */
+export declare function resolve_sqlite_path(sqlite_path: string): string;
+/**
+ * Initialize the SQLite database connection and create tables if needed
+ * @param sqlite_path - Path to the SQLite database file (relative to app root)
+ * @param logger - Logger instance for logging operations
+ * @returns Database instance
+ */
+export declare function initialize_database(sqlite_path: string, logger: Logger): Promise<SqlJsDatabase>;
+/**
+ * Initialize database synchronously (for use in already async contexts)
+ * Note: This should only be called after initialize_database has been called once
+ */
+export declare function initialize_database_sync(sqlite_path: string, logger: Logger): SqlJsDatabase | null;
+/**
+ * Get the current database instance
+ * @returns Database instance or null if not initialized
+ */
+export declare function get_database(): SqlJsDatabase | null;
+/**
+ * Save the database to file
+ * @param logger - Logger instance
+ */
+export declare function save_database(logger: Logger): void;
+/**
+ * Close the database connection
+ * @param logger - Logger instance
+ */
+export declare function close_database(logger: Logger): void;
+/**
+ * Insert a new prompt into the database
+ * @param db - Database instance
+ * @param prompt - Prompt data to insert
+ * @param logger - Logger instance
+ * @returns The inserted prompt record
+ */
+export declare function insert_prompt(db: SqlJsDatabase, prompt: Omit<PromptRecord, 'uuid' | 'created_at' | 'changed_by'>, logger: Logger): PromptRecord;
+/**
+ * Update an existing prompt in the database
+ * @param db - Database instance
+ * @param uuid - UUID of the prompt to update
+ * @param updates - Fields to update
+ * @param logger - Logger instance
+ * @returns The updated prompt record
+ */
+export declare function update_prompt(db: SqlJsDatabase, uuid: string, updates: Partial<Omit<PromptRecord, 'uuid' | 'created_at' | 'changed_by'>>, logger: Logger): PromptRecord | null;
+/**
+ * Delete a prompt from the database
+ * @param db - Database instance
+ * @param uuid - UUID of the prompt to delete
+ * @param logger - Logger instance
+ * @returns True if deleted successfully, false if not found
+ */
+export declare function delete_prompt(db: SqlJsDatabase, uuid: string, logger: Logger): boolean;
+//# sourceMappingURL=init_database.d.ts.map

package/dist/lib/database/init_database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init_database.d.ts","sourceRoot":"","sources":["../../../src/lib/database/init_database.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAkB,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AAK9D,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYhE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAmBrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAcD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAgFxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CAatB;AA+GD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,aAAa,GAAG,IAAI,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoClD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAyBnD;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC,EAChE,MAAM,EAAE,MAAM,GACb,YAAY,CAqEd;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,EAC1E,MAAM,EAAE,MAAM,GACb,YAAY,GAAG,IAAI,CA2GrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAgDT"}