Enhance configuration management with comprehensive environment setup

- Added detailed .env.example with extensive configuration options
- Created centralized configuration module with type-safe environment variable loading
- Implemented configuration validation and default value handling
- Added support for different environment modes (development, production, test)
- Introduced interfaces for robust type definitions across the project
- Implemented middleware for request validation, security, and input sanitization

src/interfaces/index.ts

@@ -0,0 +1,181 @@
+import { z } from 'zod';
+
+// Tool interfaces
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: z.ZodType<any>;
+    execute: (params: any) => Promise<any>;
+}
+
+// Command interfaces
+export interface CommandParams {
+    command: string;
+    entity_id: string;
+    // Common parameters
+    state?: string;
+    // Light parameters
+    brightness?: number;
+    color_temp?: number;
+    rgb_color?: [number, number, number];
+    // Cover parameters
+    position?: number;
+    tilt_position?: number;
+    // Climate parameters
+    temperature?: number;
+    target_temp_high?: number;
+    target_temp_low?: number;
+    hvac_mode?: string;
+    fan_mode?: string;
+    humidity?: number;
+}
+
+// Home Assistant interfaces
+export interface HassEntity {
+    entity_id: string;
+    state: string;
+    attributes: Record<string, any>;
+    last_changed?: string;
+    last_updated?: string;
+    context?: {
+        id: string;
+        parent_id?: string;
+        user_id?: string;
+    };
+}
+
+export interface HassState {
+    entity_id: string;
+    state: string;
+    attributes: {
+        friendly_name?: string;
+        description?: string;
+        [key: string]: any;
+    };
+}
+
+export interface HassAddon {
+    name: string;
+    slug: string;
+    description: string;
+    version: string;
+    installed: boolean;
+    available: boolean;
+    state: string;
+}
+
+export interface HassAddonResponse {
+    data: {
+        addons: HassAddon[];
+    };
+}
+
+export interface HassAddonInfoResponse {
+    data: {
+        name: string;
+        slug: string;
+        description: string;
+        version: string;
+        state: string;
+        status: string;
+        options: Record<string, any>;
+        [key: string]: any;
+    };
+}
+
+// HACS interfaces
+export interface HacsRepository {
+    name: string;
+    description: string;
+    category: string;
+    installed: boolean;
+    version_installed: string;
+    available_version: string;
+    authors: string[];
+    domain: string;
+}
+
+export interface HacsResponse {
+    repositories: HacsRepository[];
+}
+
+// Automation interfaces
+export interface AutomationConfig {
+    alias: string;
+    description?: string;
+    mode?: 'single' | 'parallel' | 'queued' | 'restart';
+    trigger: any[];
+    condition?: any[];
+    action: any[];
+}
+
+export interface AutomationResponse {
+    automation_id: string;
+}
+
+// SSE interfaces
+export interface SSEHeaders {
+    onAbort?: () => void;
+}
+
+export interface SSEParams {
+    token: string;
+    events?: string[];
+    entity_id?: string;
+    domain?: string;
+}
+
+// History interfaces
+export interface HistoryParams {
+    entity_id: string;
+    start_time?: string;
+    end_time?: string;
+    minimal_response?: boolean;
+    significant_changes_only?: boolean;
+}
+
+// Scene interfaces
+export interface SceneParams {
+    action: 'list' | 'activate';
+    scene_id?: string;
+}
+
+// Notification interfaces
+export interface NotifyParams {
+    message: string;
+    title?: string;
+    target?: string;
+    data?: Record<string, any>;
+}
+
+// Automation parameter interfaces
+export interface AutomationParams {
+    action: 'list' | 'toggle' | 'trigger';
+    automation_id?: string;
+}
+
+export interface AddonParams {
+    action: 'list' | 'info' | 'install' | 'uninstall' | 'start' | 'stop' | 'restart';
+    slug?: string;
+    version?: string;
+}
+
+export interface PackageParams {
+    action: 'list' | 'install' | 'uninstall' | 'update';
+    category: 'integration' | 'plugin' | 'theme' | 'python_script' | 'appdaemon' | 'netdaemon';
+    repository?: string;
+    version?: string;
+}
+
+export interface AutomationConfigParams {
+    action: 'create' | 'update' | 'delete' | 'duplicate';
+    automation_id?: string;
+    config?: {
+        alias: string;
+        description?: string;
+        mode?: 'single' | 'parallel' | 'queued' | 'restart';
+        trigger: any[];
+        condition?: any[];
+        action: any[];
+    };
+}