cadenlane-cli-2 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Cadenlane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,333 @@
+# 🚀 Cadenlane CLI - Multi-Instance File Download System
+
+> A production-ready, cross-platform TypeScript CLI application that processes file downloads from a Supabase PGMQ queue using event-driven architecture. Supports multiple distributed instances across Windows, macOS, and Linux with comprehensive monitoring, health tracking, and real-time observability.
+
+**✅ 324+ Tests Passing | ⚡ Event-Driven | 🌐 Cross-Platform | 🔄 Multi-Instance | 🏗️ Clean Architecture | 🔒 Type-Safe | 📊 92.4% Coverage | 🤖 CI/CD Automated**
+
+[![npm version](https://img.shields.io/npm/v/cadenlane-cli-2.svg)](https://www.npmjs.com/package/cadenlane-cli-2)
+[![npm downloads](https://img.shields.io/npm/dm/cadenlane-cli-2.svg)](https://www.npmjs.com/package/cadenlane-cli-2)
+[![CI](https://github.com/Shiphero-Yolo/cadenlane-cli-2/workflows/CI/badge.svg)](https://github.com/Shiphero-Yolo/cadenlane-cli-2/actions)
+[![Tests](https://img.shields.io/badge/tests-324%20passing-brightgreen)]()
+[![Coverage](https://img.shields.io/badge/coverage-92.4%25-brightgreen)]()
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)]()
+[![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-blue)]()
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+---
+
+## 🚀 Quick Navigation
+
+| Task | Section |
+|------|---------|
+| **Install the CLI** | [Installation & Setup](#-installation--setup) |
+| **Complete setup guide** | [ONBOARDING.md](docs/ONBOARDING.md) |
+| **Run with PM2** | [PM2_GUIDE.md](docs/PM2_GUIDE.md) |
+| **Deploy to production** | [DEPLOYMENT.md](docs/DEPLOYMENT.md) |
+| **View all features** | [Features](#-features) |
+| **Read documentation** | [Documentation](#-documentation) |
+| **Visual diagrams** | [DIAGRAMS.md](docs/diagrams/DIAGRAMS.md) |
+
+---
+
+## 📦 Installation & Setup
+
+```bash
+# Install globally via npm
+npm install -g cadenlane-cli-2
+
+# Or use directly with npx
+npx cadenlane-cli-2 start
+```
+
+**📖 Complete Setup Guide**: [ONBOARDING.md](docs/ONBOARDING.md)
+- Install from npm (for users)
+- Local development setup (for developers)
+- Configuration and environment setup
+- Platform-specific instructions
+
+**🔄 Production Deployment**: [PM2_GUIDE.md](docs/PM2_GUIDE.md)
+- PM2 process manager setup
+- Auto-start on system boot
+- Monitoring and log management
+
+## ✨ Features
+
+### 🌐 Cross-Platform Support
+- **Windows, macOS, Linux**: Single codebase runs on all platforms
+- **Platform-Aware Paths**: Automatic validation for drive letters (Windows) and Unix paths
+- **Path Resolution**: Home directory expansion (`~`, `%USERPROFILE%`), environment variables
+- **Absolute Paths Only**: Clear, unambiguous file locations
+- **Reserved Name Detection**: Windows reserved names (CON, PRN, etc.) automatically blocked
+
+### 🔄 Multi-Instance Architecture
+- **Distributed Processing**: Run multiple CLI instances across different computers
+- **Instance Registration**: Automatic registration with unique identity
+- **Health Monitoring**: Heartbeat system tracks instance health (5-minute intervals)
+- **Workload Tracking**: Per-instance statistics (jobs processed, failures, bytes downloaded)
+- **Configuration Hierarchy**: Global config with instance-specific overrides
+- **Platform Distribution**: Track workload across Windows, Mac, and Linux instances
+
+### Core Functionality
+- 📥 **File Download**: Downloads files from any public URL to specified folders
+- 📬 **Queue-Based Processing**: Uses Supabase PGMQ for reliable, scalable message handling
+- ⚡ **Event-Driven**: Blocking reads eliminate polling - instant message processing
+- 🚀 **Fail-Fast Design**: No retry mechanism - immediate, clear failure handling
+- 📊 **Complete Observability**: All logs and metrics stored in Supabase
+- 🎯 **Single Processing**: Each message processed exactly once with ACID guarantees
+
+### Architecture & Quality
+- 🏗️ **Clean Architecture**: SOLID principles with clear layer separation (Domain, Application, Infrastructure)
+- 💉 **Dependency Injection**: TSyringe IoC container for testability
+- 🧪 **Test-Driven Development**: 324+ tests with 92.4% coverage
+- 🔒 **Type-Safe**: Full TypeScript with strict mode
+- 🛡️ **Security**: Path traversal protection, input validation, RLS policies
+- 📐 **Interface-Driven Design**: All adapters implement domain interfaces (IPgmqAdapter, IHttpAdapter, etc.)
+
+### Admin UI
+- 🎨 **Web Dashboard**: Real-time monitoring and management interface
+- 📈 **Live Statistics**: Track completed, processing, and failed jobs
+- 📝 **Detailed Logs**: View execution logs with expandable data and stack traces
+- 🔄 **Auto-Refresh**: Real-time updates every 3 seconds
+- ✉️ **Queue Management**: Send test messages directly from the UI
+
+## 📚 Documentation
+
+Welcome to the CLI Base documentation! This streamlined index helps you find exactly what you need.
+
+### 🚀 Getting Started
+
+**New to the project?** Follow this path:
+
+1. **[README](README.md)** - Project overview and quick start (you are here!)
+2. **[ONBOARDING.md](docs/ONBOARDING.md)** - Complete setup and first-time guide
+3. **[ADMIN_UI_GUIDE.md](docs/ADMIN_UI_GUIDE.md)** - Using the web dashboard
+
+### 📖 Core Documentation
+
+#### For Developers
+
+**[ONBOARDING.md](docs/ONBOARDING.md)** - Your first stop
+- Prerequisites and installation
+- Local development setup
+- Configuration guide
+- Running the application
+- Verification and testing
+
+**[DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md)** - Deep dive into the codebase
+- Clean Architecture principles
+- Core components and services
+- Design patterns
+- Testing strategy (291 tests)
+- Debugging techniques
+- Contributing guidelines
+
+#### For Operators
+
+**[OPERATIONS.md](docs/OPERATIONS.md)** - Running in production
+- Multi-instance architecture
+- Cross-platform support (Windows, Mac, Linux)
+- Monitoring and health checks
+- Troubleshooting guide
+- Performance tuning
+
+**[DEPLOYMENT.md](docs/DEPLOYMENT.md)** - Production deployment
+- Supabase deployment
+- Worker deployment (PM2, Docker, Systemd)
+- CI/CD setup (GitHub Actions, GitLab CI)
+- Publishing to npm
+- Migration guide
+
+**[PM2_GUIDE.md](docs/PM2_GUIDE.md)** - PM2 process manager
+- Complete PM2 setup for Windows, macOS, and Linux
+- Auto-start on system boot configuration
+- Process management and monitoring
+- Log management and rotation
+- Troubleshooting guide
+
+#### Reference
+
+**[ADMIN_UI_GUIDE.md](docs/ADMIN_UI_GUIDE.md)** - Web interface guide
+- Sending messages to queue
+- Viewing messages and logs
+- Dashboard statistics
+- API endpoints
+
+**[PRD-CLI-BASE.md](docs/PRD-CLI-BASE.md)** - Product requirements
+- Full feature specifications
+- Technical requirements
+- Use cases
+
+**[DIAGRAMS.md](docs/diagrams/DIAGRAMS.md)** - Visual diagrams
+- Architecture diagrams (Clean Architecture, System Context, Multi-Instance)
+- Component diagrams (Services, Repositories, Adapters)
+- Sequence diagrams (Message processing, Configuration, Path resolution)
+- E2E flow diagrams (Complete workflows, Admin UI, Monitoring)
+- Database schema (ERD, PGMQ structure)
+
+### 📋 Quick Reference
+
+#### Common Tasks
+
+| Task | Documentation |
+|------|---------------|
+| **First-time setup** | [ONBOARDING.md](docs/ONBOARDING.md) |
+| **Understand architecture** | [DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md) |
+| **Run tests** | [DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md#testing) |
+| **Deploy to production** | [DEPLOYMENT.md](docs/DEPLOYMENT.md) |
+| **Troubleshoot issues** | [OPERATIONS.md](docs/OPERATIONS.md#troubleshooting) |
+| **Multi-instance setup** | [OPERATIONS.md](docs/OPERATIONS.md#multi-instance-architecture) |
+| **Use Admin UI** | [ADMIN_UI_GUIDE.md](docs/ADMIN_UI_GUIDE.md) |
+
+#### Learning Path
+
+**Week 1: Basics**
+1. Read [ONBOARDING.md](docs/ONBOARDING.md)
+2. Complete local setup
+3. Run the application
+4. Send test messages via Admin UI
+
+**Week 2: Development**
+1. Read [DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md)
+2. Explore the codebase
+3. Run tests: `npm test`
+4. Make a small code change
+
+**Week 3: Production**
+1. Read [OPERATIONS.md](docs/OPERATIONS.md)
+2. Read [DEPLOYMENT.md](docs/DEPLOYMENT.md)
+3. Set up multi-instance deployment
+4. Configure monitoring
+
+#### By Role
+
+**New Developer:**
+1. [ONBOARDING.md](docs/ONBOARDING.md) - Get started
+2. [DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md) - Learn the codebase
+3. [ADMIN_UI_GUIDE.md](docs/ADMIN_UI_GUIDE.md) - Test your changes
+
+**DevOps Engineer:**
+1. [DEPLOYMENT.md](docs/DEPLOYMENT.md) - Deploy to production
+2. [OPERATIONS.md](docs/OPERATIONS.md) - Monitor and maintain
+3. [ONBOARDING.md](docs/ONBOARDING.md#configuration) - Configuration reference
+
+**Product Manager:**
+1. [README](README.md) - Feature overview (you are here!)
+2. [PRD-CLI-BASE.md](docs/PRD-CLI-BASE.md) - Full requirements
+3. [ADMIN_UI_GUIDE.md](docs/ADMIN_UI_GUIDE.md) - User interface
+
+### 🔍 What's New
+
+**Version 2.0.0 Documentation Consolidation**:
+- ✅ Streamlined from 23 files to 6 core documents
+- ✅ Removed redundancy and overlap
+- ✅ Clear learning path for new developers
+- ✅ Comprehensive coverage of all features
+- ✅ Better organization by role and task
+
+### 🆘 Need Help?
+
+**Quick Troubleshooting**:
+1. Check [OPERATIONS.md - Troubleshooting](docs/OPERATIONS.md#troubleshooting)
+2. Review logs in Admin UI or Supabase Studio
+3. Verify setup in [ONBOARDING.md](docs/ONBOARDING.md)
+
+**Common Issues**:
+- Worker not processing? → [OPERATIONS.md](docs/OPERATIONS.md#issue-worker-not-processing-messages)
+- Database connection issues? → [OPERATIONS.md](docs/OPERATIONS.md#issue-database-connection-terminated)
+- Path validation errors? → [OPERATIONS.md](docs/OPERATIONS.md#issue-path-validation-fails)
+- Deployment problems? → [DEPLOYMENT.md](docs/DEPLOYMENT.md)
+
+## 🏗️ Architecture
+
+Built with **Clean Architecture** principles:
+- **Domain Layer**: Business entities and rules
+- **Application Layer**: Use cases and services
+- **Infrastructure Layer**: External integrations (Supabase, PGMQ, File System)
+- **CLI Layer**: Command-line interface
+
+**📊 Visual Diagrams**: [DIAGRAMS.md](docs/diagrams/DIAGRAMS.md)
+- System architecture and component diagrams
+- Sequence diagrams for key workflows
+- Database schema (ERD)
+
+**📖 Detailed Architecture**: [DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md)
+
+## 🧪 Development & Testing
+
+**Testing**: 324+ tests with 92.4% coverage
+```bash
+npm test              # Run all tests
+npm run test:coverage # Coverage report
+```
+
+**Code Quality**:
+```bash
+npm run lint         # Lint code
+npm run format       # Format code
+npm run type-check   # TypeScript checks
+```
+
+**📖 Development Guide**: [DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md)
+- Testing strategy and best practices
+- Debugging techniques
+- Contributing guidelines
+
+## 📝 Usage
+
+**Sending Messages**: Use the Admin UI or API
+- **Admin UI**: http://127.0.0.1:54321/functions/v1/admin-ui
+- **API Examples**: See [ADMIN_UI_GUIDE.md](docs/ADMIN_UI_GUIDE.md)
+
+**Monitoring**: View logs in Supabase Studio or Admin UI
+- **Studio**: http://127.0.0.1:54323
+- **Tables**: `messages`, `job_logs`, `cli_instances`
+
+**Configuration**: Environment variables and database config
+- **Setup Guide**: [ONBOARDING.md](docs/ONBOARDING.md#configuration)
+- **Config Priority**: Instance > Global > ENV > Default
+
+## 🔧 Troubleshooting
+
+**Common Issues**:
+- Worker not processing? → [OPERATIONS.md](docs/OPERATIONS.md#troubleshooting)
+- Database connection issues? → [OPERATIONS.md](docs/OPERATIONS.md#issue-database-connection-terminated)
+- Path validation errors? → [OPERATIONS.md](docs/OPERATIONS.md#issue-path-validation-fails)
+- Windows command not recognized? → [ONBOARDING.md](docs/ONBOARDING.md)
+
+**📖 Complete Guide**: [OPERATIONS.md](docs/OPERATIONS.md#troubleshooting)
+
+## 📦 Deployment
+
+**Production Deployment**: [DEPLOYMENT.md](docs/DEPLOYMENT.md)
+- Supabase deployment
+- Worker deployment (PM2, Docker, Systemd)
+- CI/CD setup
+- Publishing to npm
+
+**Process Management**: [PM2_GUIDE.md](docs/PM2_GUIDE.md)
+- PM2 setup and auto-start
+- Monitoring and logs
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [DEVELOPER_GUIDE.md](docs/DEVELOPER_GUIDE.md) for:
+- Development setup
+- Testing requirements
+- Code quality standards
+- Contributing guidelines
+
+## 📄 License
+
+MIT License - see LICENSE file for details
+
+## 🆘 Support
+
+**Documentation**: See [Documentation](#-documentation) section above for complete guides
+
+**Issues**: Check [OPERATIONS.md](docs/OPERATIONS.md#troubleshooting) for troubleshooting
+
+**npm Package**: https://www.npmjs.com/package/cadenlane-cli-2
+
+---
+
+**Built with ❤️ using TypeScript, Supabase, and Clean Architecture principles**

package/bin.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('./dist/cli/index.js');

package/dist/application/config/config.manager.d.ts

@@ -0,0 +1,62 @@
+import { ConfigRepository } from '../../infrastructure/repositories/config.repository';
+/**
+ * Application Configuration
+ */
+export interface AppConfig {
+    supabase: {
+        url: string;
+        serviceRoleKey: string;
+    };
+    queue: {
+        name: string;
+        visibilityTimeoutSeconds: number;
+        pollIntervalMs: number;
+    };
+    download: {
+        timeoutMs: number;
+        maxRetries: number;
+        defaultPath: string;
+        fallbackPath?: string;
+    };
+    platform: {
+        name: string;
+        isWindows: boolean;
+        isMac: boolean;
+        isLinux: boolean;
+        separator: string;
+    };
+    instance: {
+        id: string;
+        name: string;
+    };
+}
+/**
+ * Configuration Manager
+ * Loads and validates application configuration
+ */
+export declare class ConfigManager {
+    private configRepository;
+    private config;
+    constructor(configRepository: ConfigRepository);
+    /**
+     * Loads configuration from database with fallback to environment variables
+     * @param instanceId - Optional instance ID (for testing or pre-registered instances)
+     * @throws Error if required variables are missing
+     */
+    load(instanceId?: string): Promise<AppConfig>;
+    /**
+     * Gets the current configuration
+     * @throws Error if configuration not loaded
+     */
+    get(): AppConfig;
+    /**
+     * Validates that all required environment variables are present
+     * @throws Error if any required variable is missing
+     */
+    private validateRequiredEnvVars;
+    /**
+     * Get configuration value with priority: DB > ENV > Default
+     */
+    private getConfigValue;
+}
+//# sourceMappingURL=config.manager.d.ts.map

package/dist/application/config/config.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.manager.d.ts","sourceRoot":"","sources":["../../../src/application/config/config.manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,wBAAwB,EAAE,MAAM,CAAC;QACjC,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,qBACa,aAAa;IAII,OAAO,CAAC,gBAAgB;IAHpD,OAAO,CAAC,MAAM,CAA0B;gBAGJ,gBAAgB,EAAE,gBAAgB;IAGtE;;;;OAIG;IACG,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAiGnD;;;OAGG;IACH,GAAG,IAAI,SAAS;IAOhB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,cAAc;CA2BvB"}

package/dist/application/config/config.manager.js

@@ -0,0 +1,146 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigManager = void 0;
+const tsyringe_1 = require("tsyringe");
+const os_1 = require("os");
+const config_constants_1 = require("../../domain/constants/config.constants");
+const config_repository_1 = require("../../infrastructure/repositories/config.repository");
+/**
+ * Configuration Manager
+ * Loads and validates application configuration
+ */
+let ConfigManager = class ConfigManager {
+    configRepository;
+    config = null;
+    constructor(configRepository) {
+        this.configRepository = configRepository;
+    }
+    /**
+     * Loads configuration from database with fallback to environment variables
+     * @param instanceId - Optional instance ID (for testing or pre-registered instances)
+     * @throws Error if required variables are missing
+     */
+    async load(instanceId) {
+        this.validateRequiredEnvVars();
+        // Load configuration from database
+        const dbConfig = await this.configRepository.getAll();
+        // Get platform information
+        const platformInfo = config_constants_1.PLATFORM_DEFAULTS.getPlatformInfo();
+        // Get default download path (DB > ENV > Platform Default)
+        const defaultDownloadPath = this.getConfigValue(dbConfig, config_constants_1.CONFIG_KEYS.DOWNLOAD_DEFAULT_PATH, process.env.DOWNLOAD_DEFAULT_PATH, config_constants_1.PLATFORM_DEFAULTS.getDefaultDownloadPath());
+        // Get fallback download path (optional)
+        const fallbackDownloadPath = this.getConfigValue(dbConfig, config_constants_1.CONFIG_KEYS.DOWNLOAD_FALLBACK_PATH, process.env.DOWNLOAD_FALLBACK_PATH, undefined);
+        // Get instance ID from ENV (CLI_INSTANCE_ID)
+        // Fallback: provided instanceId param > hostname-platform
+        const finalInstanceId = instanceId ||
+            process.env.CLI_INSTANCE_ID ||
+            `${(0, os_1.hostname)()}-${platformInfo.platform}`;
+        // Use instance ID for both identification and display
+        const instanceName = finalInstanceId;
+        // Sanitize instance ID for use as queue name (PostgreSQL identifier rules)
+        // Replace spaces and special chars with underscores, lowercase
+        const sanitizedInstanceId = finalInstanceId
+            .toLowerCase()
+            .replace(/[^a-z0-9_-]/g, '_')
+            .replace(/_+/g, '_')
+            .replace(/^_|_$/g, '');
+        // Use CLI_INSTANCE_ID directly as the queue name
+        const instanceQueueName = sanitizedInstanceId;
+        this.config = {
+            supabase: {
+                url: process.env.SUPABASE_URL,
+                serviceRoleKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
+            },
+            queue: {
+                name: instanceQueueName,
+                visibilityTimeoutSeconds: this.getConfigValue(dbConfig, 'queue.visibility_timeout_seconds', process.env.QUEUE_VISIBILITY_TIMEOUT_SECONDS, config_constants_1.CONFIG_CONSTANTS.DEFAULT_VISIBILITY_TIMEOUT_SECONDS),
+                pollIntervalMs: this.getConfigValue(dbConfig, 'queue.poll_interval_ms', process.env.QUEUE_POLL_INTERVAL_MS, config_constants_1.CONFIG_CONSTANTS.DEFAULT_POLL_INTERVAL_MS),
+            },
+            download: {
+                timeoutMs: this.getConfigValue(dbConfig, 'download.timeout_ms', process.env.DOWNLOAD_TIMEOUT_MS, config_constants_1.CONFIG_CONSTANTS.DEFAULT_DOWNLOAD_TIMEOUT_MS),
+                maxRetries: this.getConfigValue(dbConfig, 'download.max_retries', process.env.MAX_RETRIES, config_constants_1.CONFIG_CONSTANTS.DEFAULT_MAX_RETRIES),
+                defaultPath: defaultDownloadPath,
+                fallbackPath: fallbackDownloadPath,
+            },
+            platform: {
+                name: platformInfo.platform,
+                isWindows: platformInfo.isWindows,
+                isMac: platformInfo.isMac,
+                isLinux: platformInfo.isLinux,
+                separator: platformInfo.separator,
+            },
+            instance: {
+                id: finalInstanceId,
+                name: instanceName,
+            },
+        };
+        return this.config;
+    }
+    /**
+     * Gets the current configuration
+     * @throws Error if configuration not loaded
+     */
+    get() {
+        if (!this.config) {
+            throw new Error('Configuration not loaded. Call load() first.');
+        }
+        return this.config;
+    }
+    /**
+     * Validates that all required environment variables are present
+     * @throws Error if any required variable is missing
+     */
+    validateRequiredEnvVars() {
+        const missing = [];
+        for (const varName of config_constants_1.REQUIRED_ENV_VARS) {
+            if (!process.env[varName]) {
+                missing.push(varName);
+            }
+        }
+        if (missing.length > 0) {
+            throw new Error(`Missing required environment variables: ${missing.join(', ')}`);
+        }
+    }
+    /**
+     * Get configuration value with priority: DB > ENV > Default
+     */
+    getConfigValue(dbConfig, dbKey, envValue, defaultValue) {
+        // Priority 1: Database
+        if (dbConfig[dbKey] !== undefined) {
+            const dbValue = dbConfig[dbKey];
+            // Ensure we return string or number, not boolean
+            if (typeof dbValue === 'boolean') {
+                return dbValue ? 1 : 0;
+            }
+            return dbValue;
+        }
+        // Priority 2: Environment variable
+        if (envValue !== undefined && envValue !== '') {
+            if (defaultValue === undefined) {
+                return envValue;
+            }
+            return typeof defaultValue === 'number' ? parseInt(envValue, 10) : envValue;
+        }
+        // Priority 3: Default value
+        return defaultValue;
+    }
+};
+exports.ConfigManager = ConfigManager;
+exports.ConfigManager = ConfigManager = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(config_repository_1.ConfigRepository)),
+    __metadata("design:paramtypes", [config_repository_1.ConfigRepository])
+], ConfigManager);
+//# sourceMappingURL=config.manager.js.map

package/dist/application/config/config.manager.js.map

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

package/dist/application/services/application.service.d.ts

@@ -0,0 +1,35 @@
+import { QueueService } from './queue.service';
+import { DownloadService } from './download.service';
+import { MessageRepository } from '../../infrastructure/repositories/message.repository';
+import { LogRepository } from '../../infrastructure/repositories/log.repository';
+/**
+ * Application Service
+ * Main orchestrator for message processing workflow
+ */
+export declare class ApplicationService {
+    private queueService;
+    private downloadService;
+    private messageRepository;
+    private logRepository;
+    constructor(queueService: QueueService, downloadService: DownloadService, messageRepository: MessageRepository, logRepository: LogRepository);
+    /**
+     * Processes the next message from the queue
+     * @returns true if a message was processed, false if queue is empty
+     */
+    processNextMessage(): Promise<boolean>;
+    /**
+     * Processes a specific message (used when message is pre-fetched)
+     * @param queueMessage - The PGMQ message to process
+     * @returns true if processed successfully
+     */
+    processMessage(queueMessage: any): Promise<boolean>;
+    /**
+     * Logs an info message
+     */
+    private logInfo;
+    /**
+     * Logs an error message
+     */
+    private logError;
+}
+//# sourceMappingURL=application.service.d.ts.map

package/dist/application/services/application.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.service.d.ts","sourceRoot":"","sources":["../../../src/application/services/application.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAI7E;;;GAGG;AACH,qBACa,kBAAkB;IAEL,OAAO,CAAC,YAAY;IACjB,OAAO,CAAC,eAAe;IACrB,OAAO,CAAC,iBAAiB;IAC7B,OAAO,CAAC,aAAa;gBAHd,YAAY,EAAE,YAAY,EACvB,eAAe,EAAE,eAAe,EAC9B,iBAAiB,EAAE,iBAAiB,EACxC,aAAa,EAAE,aAAa;IAG7D;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB5C;;;;OAIG;IACG,cAAc,CAAC,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IA2GzD;;OAEG;YACW,OAAO;IASrB;;OAEG;YACW,QAAQ;CAavB"}