hazo_llm_api 1.0.3 → 1.0.4

package/dist/lib/config/provider_loader.js

@@ -1,169 +0,0 @@
-/**
- * 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 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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,10 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,118 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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;AAwDD;;;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,CA+Dd;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,CA+FrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAgDT"}