hazo_llm_api 1.0.4 → 1.0.6

package/dist/lib/providers/registry.js

@@ -0,0 +1,158 @@
+/**
+ * LLM Provider Registry
+ *
+ * Central registry for managing and accessing LLM providers.
+ * Handles provider registration, capability validation, and enabled LLM tracking.
+ */
+// =============================================================================
+// Provider Registry
+// =============================================================================
+/**
+ * Map of registered providers by name
+ */
+const provider_map = new Map();
+/**
+ * Set of enabled LLM provider names
+ */
+let enabled_llms = new Set();
+/**
+ * Primary/default LLM provider name
+ */
+let primary_llm = null;
+// =============================================================================
+// Registry Management
+// =============================================================================
+/**
+ * Register a provider in the registry
+ * @param provider - The provider instance to register
+ */
+export function register_provider(provider) {
+    const name = provider.get_name().toLowerCase();
+    provider_map.set(name, provider);
+}
+/**
+ * Set which LLMs are enabled
+ * @param enabled_names - Array of LLM names that are enabled
+ */
+export function set_enabled_llms(enabled_names) {
+    enabled_llms = new Set(enabled_names.map(name => name.toLowerCase()));
+}
+/**
+ * Set the primary/default LLM
+ * @param name - Name of the primary LLM
+ */
+export function set_primary_llm(name) {
+    primary_llm = name.toLowerCase();
+}
+/**
+ * Get the primary/default LLM name
+ * @returns Primary LLM name or null if not set
+ */
+export function get_primary_llm() {
+    return primary_llm;
+}
+/**
+ * Check if an LLM is enabled
+ * @param name - LLM name to check
+ * @returns True if the LLM is enabled
+ */
+export function is_llm_enabled(name) {
+    return enabled_llms.has(name.toLowerCase());
+}
+/**
+ * Get a provider by name
+ * @param name - Provider name (case-insensitive). Use LLM_PROVIDERS constants for type safety.
+ * @param logger - Logger instance for error logging
+ * @returns Provider instance or null if not found
+ */
+export function get_provider(name, logger) {
+    // Use primary LLM if name not specified
+    const provider_name = (name || primary_llm || '').toLowerCase();
+    if (!provider_name) {
+        logger.error('No LLM provider specified and no primary LLM configured', {
+            file: 'registry.ts',
+            line: 88,
+            data: { requested_name: name, primary_llm },
+        });
+        return null;
+    }
+    // Check if LLM is enabled
+    if (!is_llm_enabled(provider_name)) {
+        logger.error('Requested LLM is not enabled', {
+            file: 'registry.ts',
+            line: 96,
+            data: {
+                requested_llm: provider_name,
+                enabled_llms: Array.from(enabled_llms),
+            },
+        });
+        return null;
+    }
+    // Get provider
+    const provider = provider_map.get(provider_name);
+    if (!provider) {
+        // Provider is enabled but not registered - likely missing API key or config issue
+        const env_var_name = `${provider_name.toUpperCase()}_API_KEY`;
+        logger.error('LLM provider is enabled but not registered', {
+            file: 'registry.ts',
+            line: 108,
+            data: {
+                requested_llm: provider_name,
+                available_providers: Array.from(provider_map.keys()),
+                enabled_llms: Array.from(enabled_llms),
+                hint: `Provider "${provider_name}" is enabled in config but not loaded. Check ${env_var_name} in environment variables and provider configuration.`,
+            },
+        });
+        return null;
+    }
+    return provider;
+}
+/**
+ * Check if a provider supports a specific service type
+ * @param provider - Provider instance
+ * @param service_type - Service type to check
+ * @returns True if the provider supports the service
+ */
+export function has_capability(provider, service_type) {
+    const capabilities = provider.get_capabilities();
+    return capabilities.has(service_type);
+}
+/**
+ * Validate that a provider supports a service before calling it
+ * @param provider - Provider instance
+ * @param service_type - Service type to validate
+ * @param logger - Logger instance
+ * @returns True if capability is supported, false otherwise
+ */
+export function validate_capability(provider, service_type, logger) {
+    if (!has_capability(provider, service_type)) {
+        const provider_name = provider.get_name();
+        logger.error('Provider does not support requested service', {
+            file: 'registry.ts',
+            line: 142,
+            data: {
+                provider: provider_name,
+                service_type,
+                supported_capabilities: Array.from(provider.get_capabilities()),
+            },
+        });
+        return false;
+    }
+    return true;
+}
+/**
+ * Get all registered provider names
+ * @returns Array of provider names
+ */
+export function get_registered_providers() {
+    return Array.from(provider_map.keys());
+}
+/**
+ * Clear all registered providers (useful for testing)
+ */
+export function clear_registry() {
+    provider_map.clear();
+    enabled_llms.clear();
+    primary_llm = null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/providers/registry.js.map

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

package/dist/lib/providers/types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * LLM Provider Types
+ *
+ * Defines the interface that all LLM providers must implement.
+ * This ensures consistent behavior across different LLM implementations.
+ */
+import type { LLMResponse, LLMStreamResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, Logger } from '../llm_api/types.js';
+/**
+ * Provider name constants for type-safe LLM provider selection
+ * Use these constants instead of string literals for autocomplete and type safety
+ *
+ * @example
+ * ```typescript
+ * import { LLM_PROVIDERS } from 'hazo_llm_api/server';
+ *
+ * const response = await hazo_llm_text_text(params, LLM_PROVIDERS.GEMINI);
+ * ```
+ */
+export declare const LLM_PROVIDERS: {
+    readonly GEMINI: "gemini";
+    readonly QWEN: "qwen";
+};
+/**
+ * Type for provider name - union of all valid provider names
+ * Accepts both constants and string literals for backward compatibility
+ *
+ * @example
+ * ```typescript
+ * // Using constant (recommended)
+ * const provider: ProviderName = LLM_PROVIDERS.GEMINI;
+ *
+ * // Using string literal (still works)
+ * const provider: ProviderName = 'gemini';
+ *
+ * // Custom provider (also valid)
+ * const provider: ProviderName = 'my-custom-provider';
+ * ```
+ */
+export type ProviderName = typeof LLM_PROVIDERS[keyof typeof LLM_PROVIDERS] | (string & {});
+/**
+ * Service type identifiers for LLM capabilities
+ */
+export declare const SERVICE_TYPES: {
+    readonly TEXT_TEXT: "text_text";
+    readonly IMAGE_TEXT: "image_text";
+    readonly TEXT_IMAGE: "text_image";
+    readonly IMAGE_IMAGE: "image_image";
+};
+/**
+ * Service type string literal union
+ */
+export type ServiceType = typeof SERVICE_TYPES[keyof typeof SERVICE_TYPES];
+/**
+ * Set of capabilities that a provider supports
+ */
+export type LLMCapabilities = Set<ServiceType>;
+/**
+ * Interface that all LLM providers must implement
+ * Providers handle the specific API calls and transformations for their LLM service
+ */
+export interface LLMProvider {
+    /**
+     * Get the name/identifier of this provider (e.g., "gemini", "openai")
+     */
+    get_name(): string;
+    /**
+     * Get the capabilities this provider supports
+     * @returns Set of supported service types
+     */
+    get_capabilities(): LLMCapabilities;
+    /**
+     * Get the model name configured for a specific service type
+     * @param service_type - The service type to get the model for
+     * @returns Model name/identifier or undefined if not configured for this service
+     */
+    get_model_for_service(service_type: ServiceType): string | undefined;
+    /**
+     * Text input → Text output
+     * Generate text from a text prompt
+     *
+     * @param params - Text input parameters
+     * @param logger - Logger instance
+     * @returns LLM response with generated text
+     */
+    text_text(params: TextTextParams, logger: Logger): Promise<LLMResponse>;
+    /**
+     * Image input → Text output
+     * Analyze an image and generate text description
+     *
+     * @param params - Image input parameters
+     * @param logger - Logger instance
+     * @returns LLM response with generated text
+     */
+    image_text(params: ImageTextParams, logger: Logger): Promise<LLMResponse>;
+    /**
+     * Text input → Image output
+     * Generate an image from a text prompt
+     *
+     * @param params - Text input parameters for image generation
+     * @param logger - Logger instance
+     * @returns LLM response with generated image
+     */
+    text_image(params: TextImageParams, logger: Logger): Promise<LLMResponse>;
+    /**
+     * Image input → Image output
+     * Transform/edit an image based on instructions
+     *
+     * @param params - Image input parameters with transformation instructions
+     * @param logger - Logger instance
+     * @returns LLM response with transformed image
+     */
+    image_image(params: ImageImageParams, logger: Logger): Promise<LLMResponse>;
+    /**
+     * Text input → Text output (streaming)
+     * Generate text from a text prompt with streaming response
+     *
+     * @param params - Text input parameters
+     * @param logger - Logger instance
+     * @returns Async generator yielding text chunks
+     */
+    text_text_stream?(params: TextTextParams, logger: Logger): Promise<LLMStreamResponse>;
+    /**
+     * Image input → Text output (streaming)
+     * Analyze an image and generate text description with streaming response
+     *
+     * @param params - Image input parameters
+     * @param logger - Logger instance
+     * @returns Async generator yielding text chunks
+     */
+    image_text_stream?(params: ImageTextParams, logger: Logger): Promise<LLMStreamResponse>;
+}
+/**
+ * Base configuration for initializing an LLM provider
+ */
+export interface LLMProviderConfig {
+    /** Provider name/identifier (e.g., "gemini", "openai") */
+    name: string;
+    /** API key - should be read from .env.local (e.g., GEMINI_API_KEY) */
+    api_key?: string;
+    /** Logger instance */
+    logger: Logger;
+    /** Additional provider-specific configuration */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,MAAM,EACP,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAM5F;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;AAM/C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;OAGG;IACH,gBAAgB,IAAI,eAAe,CAAC;IAEpC;;;;OAIG;IACH,qBAAqB,CAAC,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAErE;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAExE;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1E;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1E;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAM5E;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEtF;;;;;;;OAOG;IACH,iBAAiB,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACzF;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/lib/providers/types.js

@@ -0,0 +1,37 @@
+/**
+ * LLM Provider Types
+ *
+ * Defines the interface that all LLM providers must implement.
+ * This ensures consistent behavior across different LLM implementations.
+ */
+// =============================================================================
+// Provider Name Constants
+// =============================================================================
+/**
+ * Provider name constants for type-safe LLM provider selection
+ * Use these constants instead of string literals for autocomplete and type safety
+ *
+ * @example
+ * ```typescript
+ * import { LLM_PROVIDERS } from 'hazo_llm_api/server';
+ *
+ * const response = await hazo_llm_text_text(params, LLM_PROVIDERS.GEMINI);
+ * ```
+ */
+export const LLM_PROVIDERS = {
+    GEMINI: 'gemini',
+    QWEN: 'qwen',
+};
+// =============================================================================
+// Service Type Constants
+// =============================================================================
+/**
+ * Service type identifiers for LLM capabilities
+ */
+export const SERVICE_TYPES = {
+    TEXT_TEXT: 'text_text',
+    IMAGE_TEXT: 'image_text',
+    TEXT_IMAGE: 'text_image',
+    IMAGE_IMAGE: 'image_image',
+};
+//# sourceMappingURL=types.js.map

package/dist/lib/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAoBX,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,27 @@
+/**
+ * hazo_llm_api Server-Side Exports
+ *
+ * This file exports server-side only functions for LLM API operations.
+ * These should ONLY be imported in server components, API routes, or server actions.
+ *
+ * Usage: import { initialize_llm_api, hazo_llm_text_text } from 'hazo_llm_api/server'
+ *
+ * Available functions:
+ * - hazo_llm_text_text: Text input → Text output
+ * - hazo_llm_image_text: Image input → Text output
+ * - hazo_llm_text_image: Text input → Image output
+ * - hazo_llm_image_image: Image input → Image output
+ * - hazo_llm_text_image_text: Text → Image → Text (chained)
+ * - hazo_llm_prompt_chain: Chain multiple prompts with dynamic value resolution
+ */
+export { initialize_llm_api, hazo_llm_text_text, hazo_llm_image_text, hazo_llm_text_image, hazo_llm_image_image, hazo_llm_text_image_text, hazo_llm_image_image_text, hazo_llm_prompt_chain, hazo_llm_text_text_stream, hazo_llm_image_text_stream, is_initialized, get_current_config, default_logger, get_logger, set_logger, get_hooks, set_hooks, } from './lib/llm_api/index.js';
+export { initialize_database, get_database, close_database, insert_prompt, update_prompt, delete_prompt, get_default_sqlite_path, expand_path, resolve_sqlite_path, } from './lib/database/index.js';
+export { get_prompt_by_area_and_key, get_prompt_by_area_key_and_locals, get_prompt_text, get_prompts_by_area, get_prompt_by_uuid, get_all_prompts, substitute_variables, parse_prompt_variables, validate_variables, type LocalFilterOptions, } from './lib/prompts/index.js';
+export { call_gemini_api, get_gemini_api_url, } from './lib/providers/index.js';
+export { LLM_PROVIDERS, SERVICE_TYPES } from './lib/providers/types.js';
+export type { ProviderName, ServiceType } from './lib/providers/types.js';
+export { LLM_ERROR_CODES } from './lib/llm_api/types.js';
+export { build_error_response } from './lib/llm_api/provider_helper.js';
+export type { LLMErrorCode, LLMError } from './lib/llm_api/types.js';
+export type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams, ChainImage, Logger, PromptVariable, PromptVariables, Base64Data, PromptTextMode, PromptRecord, CallLLMParams, LLMHooks, LLMRequestContext, LLMResponseContext, LLMErrorContext, BeforeRequestHook, AfterResponseHook, OnErrorHook, LLMStreamChunk, LLMStreamResponse, ChainMatchType, ChainFieldDefinition, ChainVariableDefinition, ChainCallDefinition, ChainCallResult, PromptChainParams, PromptChainResponse, } from './lib/llm_api/types.js';
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EAErB,yBAAyB,EACzB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,EAElB,cAAc,EACd,UAAU,EACV,UAAU,EAEV,SAAS,EACT,SAAS,GACV,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EAEb,uBAAuB,EACvB,WAAW,EACX,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAKrE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,MAAM,EACN,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EAEb,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EAEX,cAAc,EACd,iBAAiB,EAEjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/server.js

@@ -0,0 +1,50 @@
+/**
+ * hazo_llm_api Server-Side Exports
+ *
+ * This file exports server-side only functions for LLM API operations.
+ * These should ONLY be imported in server components, API routes, or server actions.
+ *
+ * Usage: import { initialize_llm_api, hazo_llm_text_text } from 'hazo_llm_api/server'
+ *
+ * Available functions:
+ * - hazo_llm_text_text: Text input → Text output
+ * - hazo_llm_image_text: Image input → Text output
+ * - hazo_llm_text_image: Text input → Image output
+ * - hazo_llm_image_image: Image input → Image output
+ * - hazo_llm_text_image_text: Text → Image → Text (chained)
+ * - hazo_llm_prompt_chain: Chain multiple prompts with dynamic value resolution
+ */
+// =============================================================================
+// LLM API Exports (Server-side ONLY)
+// =============================================================================
+export { initialize_llm_api, hazo_llm_text_text, hazo_llm_image_text, hazo_llm_text_image, hazo_llm_image_image, hazo_llm_text_image_text, hazo_llm_image_image_text, hazo_llm_prompt_chain, 
+// Streaming functions
+hazo_llm_text_text_stream, hazo_llm_image_text_stream, is_initialized, get_current_config, 
+// Logger utilities
+default_logger, get_logger, set_logger, 
+// Hooks utilities
+get_hooks, set_hooks, } from './lib/llm_api/index.js';
+// =============================================================================
+// Database Exports (Server-side ONLY)
+// =============================================================================
+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 './lib/database/index.js';
+// =============================================================================
+// Prompt Utility Exports (Server-side ONLY)
+// =============================================================================
+export { get_prompt_by_area_and_key, get_prompt_by_area_key_and_locals, get_prompt_text, get_prompts_by_area, get_prompt_by_uuid, get_all_prompts, substitute_variables, parse_prompt_variables, validate_variables, } from './lib/prompts/index.js';
+// =============================================================================
+// Provider Exports (Server-side ONLY)
+// =============================================================================
+export { call_gemini_api, get_gemini_api_url, } from './lib/providers/index.js';
+// =============================================================================
+// Provider Constants (Type-safe provider names)
+// =============================================================================
+export { LLM_PROVIDERS, SERVICE_TYPES } from './lib/providers/types.js';
+// =============================================================================
+// Error Handling Exports
+// =============================================================================
+export { LLM_ERROR_CODES } from './lib/llm_api/types.js';
+export { build_error_response } from './lib/llm_api/provider_helper.js';
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB;AACrB,sBAAsB;AACtB,yBAAyB,EACzB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB;AAClB,mBAAmB;AACnB,cAAc,EACd,UAAU,EACV,UAAU;AACV,kBAAkB;AAClB,SAAS,EACT,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAChF,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa;AACb,eAAe;AACf,uBAAuB,EACvB,WAAW,EACX,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAChF,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC;AAEhC,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAChF,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAChF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGxE,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_llm_api",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Wrapper to call different LLMs and includes prompt management",
   "keywords": [
     "LLM",
@@ -53,10 +53,21 @@
     "ini": "^6.0.0",
     "sql.js": "^1.10.0"
   },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "peerDependencies": {
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
   },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/ini": "^4.1.1",
     "@types/node": "^20.0.0",