@simplens/onboard 1.0.0

package/dist/services.js

@@ -0,0 +1,158 @@
+import inquirer from 'inquirer';
+import { execa } from 'execa';
+import ora from 'ora';
+import { logInfo, logWarning } from './utils.js';
+import chalk from 'chalk';
+import { HEALTH_CHECK, getServiceURL } from './config/constants.js';
+/**
+ * Prompts user whether to start the services immediately after setup.
+ *
+ * @returns `true` if user wants to start services, `false` otherwise
+ *
+ * @example
+ * ```ts
+ * if (await promptStartServices()) {
+ *   await startInfraServices(targetDir);
+ * }
+ * ```
+ */
+export async function promptStartServices() {
+    const answer = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'start',
+            message: 'Do you want to start the services now?',
+            default: true,
+        },
+    ]);
+    return answer.start;
+}
+/**
+ * Starts infrastructure services using docker-compose.
+ * Runs `docker-compose -f docker-compose.infra.yaml up -d` in the target directory.
+ *
+ * @param targetDir - Directory containing docker-compose.infra.yaml
+ * @throws Error if docker-compose command fails
+ *
+ * @example
+ * ```ts
+ * await startInfraServices('/opt/simplens');
+ * ```
+ */
+export async function startInfraServices(targetDir) {
+    logInfo('Starting infrastructure services...');
+    const spinner = ora('Starting docker-compose.infra.yaml...').start();
+    try {
+        await execa('docker-compose', ['-f', 'docker-compose.infra.yaml', 'up', '-d'], { cwd: targetDir });
+        spinner.succeed('Infrastructure services started');
+    }
+    catch (error) {
+        spinner.fail('Failed to start infrastructure services');
+        throw error;
+    }
+}
+/**
+ * Waits for infrastructure services to become healthy.
+ * Polls Docker health checks for up to 60 seconds (30 retries × 2s).
+ *
+ * @param targetDir - Directory where services are running
+ *
+ * @remarks
+ * Checks for healthy containers running MongoDB or Redis.
+ * Configuration: 30 max retries, 2000ms delay between retries.
+ *
+ * @example
+ * ```ts
+ * await startInfraServices(targetDir);
+ * await waitForInfraHealth(targetDir); // Wait for services to be ready
+ * ```
+ */
+export async function waitForInfraHealth(targetDir) {
+    logInfo('Waiting for infrastructure services to be healthy...');
+    const spinner = ora('Checking service health...').start();
+    // Wait for mongo, redis health checks
+    const maxRetries = HEALTH_CHECK.MAX_RETRIES;
+    const retryDelay = HEALTH_CHECK.RETRY_DELAY_MS;
+    for (let i = 0; i < maxRetries; i++) {
+        try {
+            // Check if containers are healthy
+            const { stdout } = await execa('docker', ['ps', '--filter', 'health=healthy', '--format', '{{.Names}}']);
+            const healthyContainers = stdout.split('\n').filter(Boolean);
+            // Check for critical services
+            const hasMongoOrRedis = healthyContainers.some(name => name.includes('mongo') || name.includes('redis'));
+            if (hasMongoOrRedis) {
+                spinner.succeed('Infrastructure services are healthy');
+                return;
+            }
+            spinner.text = `Waiting for services... (${i + 1}/${maxRetries})`;
+            await sleep(retryDelay);
+        }
+        catch (error) {
+            spinner.text = `Checking health... (${i + 1}/${maxRetries})`;
+            await sleep(retryDelay);
+        }
+    }
+    spinner.warn('Health check timed out, but services may still be starting');
+    logWarning('You may need to wait a bit longer for all services to be ready.');
+}
+/**
+ * Start application services
+ */
+export async function startAppServices(targetDir) {
+    logInfo('Starting application services...');
+    const spinner = ora('Starting docker-compose.yaml...').start();
+    try {
+        await execa('docker-compose', ['up', '-d'], { cwd: targetDir });
+        spinner.succeed('Application services started');
+    }
+    catch (error) {
+        spinner.fail('Failed to start application services');
+        throw error;
+    }
+}
+/**
+ * Display service status and URLs
+ */
+export async function displayServiceStatus() {
+    console.log('\n' + chalk.green('═'.repeat(60)));
+    console.log(chalk.green.bold('  ✅ Services Started Successfully!'));
+    console.log(chalk.green('═'.repeat(60)) + '\n');
+    try {
+        // Get running containers
+        const { stdout } = await execa('docker', ['ps', '--format', '{{.Names}}']);
+        const containers = stdout.split('\n').filter(Boolean);
+        console.log(chalk.cyan.bold('🔗 Access URLs:\n'));
+        // Display URLs for known services
+        if (containers.some(c => c.includes('api'))) {
+            console.log(`  ${chalk.bold('API Server:')}      ${chalk.underline(getServiceURL('API'))}`);
+            console.log(`  ${chalk.bold('API Health:')}     ${chalk.underline(getServiceURL('API') + '/health')}\n`);
+        }
+        if (containers.some(c => c.includes('dashboard'))) {
+            console.log(`  ${chalk.bold('Dashboard:')}      ${chalk.underline(getServiceURL('DASHBOARD'))}\n`);
+        }
+        if (containers.some(c => c.includes('kafka-ui'))) {
+            console.log(`  ${chalk.bold('Kafka UI:')}       ${chalk.underline(getServiceURL('KAFKA_UI'))}\n`);
+        }
+        if (containers.some(c => c.includes('grafana'))) {
+            console.log(`  ${chalk.bold('Grafana:')}        ${chalk.underline(getServiceURL('GRAFANA'))}`);
+            console.log(`  ${chalk.gray('(default login: admin/admin)')}\n`);
+        }
+        console.log(chalk.cyan.bold('📦 Running Containers:\n'));
+        for (const container of containers) {
+            console.log(`  ${chalk.green('✓')} ${container}`);
+        }
+        console.log('\n' + chalk.cyan('To view logs:') + ' docker-compose logs -f');
+        console.log(chalk.cyan('To stop services:') + ' docker-compose down\n');
+        console.log(chalk.green('═'.repeat(60)) + '\n');
+    }
+    catch (error) {
+        logWarning('Could not fetch container status');
+    }
+}
+/**
+ * Helper: Sleep for specified milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=services.js.map

package/dist/services.js.map

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

package/dist/templates.d.ts

@@ -0,0 +1,3 @@
+export declare const INFRA_COMPOSE_TEMPLATE = "# ============================================\n# INFRA_HOST: Set this in .env to your machine's IP/hostname when running\n#             infrastructure on a separate system from application services.\n#             Default: host.docker.internal (for same-system deployment)\n# ============================================\n\nservices:\n  # ============================================\n  # Infrastructure Services\n  # ============================================\n  mongo:\n    image: mongo:7.0\n    container_name: mongo\n    command: [ \"--replSet\", \"rs0\", \"--bind_ip_all\", \"--port\", \"27017\" ]\n    ports:\n      - 27017:27017\n    extra_hosts:\n      - \"host.docker.internal:host-gateway\"\n    healthcheck:\n      test: echo \"try { rs.status() } catch (err) { rs.initiate({_id:'rs0',members:[{_id:0,host:'{{INFRA_HOST}}:27017'}]}) }\" | mongosh --port 27017 --quiet\n      interval: 5s\n      timeout: 30s\n      start_period: 0s\n      start_interval: 1s\n      retries: 30\n    volumes:\n      - \"mongo_data:/data/db\"\n      - \"mongo_config:/data/configdb\"\n\n  kafka:\n    image: apache/kafka-native\n    container_name: kafka\n    ports:\n      - \"9092:9092\"\n    environment:\n      # Configure listeners for both docker and host communication\n      KAFKA_LISTENERS: CONTROLLER://localhost:9091,HOST://0.0.0.0:9092,DOCKER://0.0.0.0:9093\n      KAFKA_ADVERTISED_LISTENERS: HOST://{{INFRA_HOST}}:9092,DOCKER://kafka:9093\n      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: CONTROLLER:PLAINTEXT,DOCKER:PLAINTEXT,HOST:PLAINTEXT\n\n      # Settings required for KRaft mode\n      KAFKA_NODE_ID: 1\n      KAFKA_PROCESS_ROLES: broker,controller\n      KAFKA_CONTROLLER_LISTENER_NAMES: CONTROLLER\n      KAFKA_CONTROLLER_QUORUM_VOTERS: 1@localhost:9091\n\n      # Listener to use for broker-to-broker communication\n      KAFKA_INTER_BROKER_LISTENER_NAME: DOCKER\n\n      # Required for a single node cluster\n      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1\n\n      # Disable auto-topic creation - API server will create topics with correct partitions\n      KAFKA_AUTO_CREATE_TOPICS_ENABLE: \"false\"\n    volumes:\n      - \"kafka_data:/var/lib/kafka/data\"\n\n  kafka-ui:\n    image: kafbat/kafka-ui:main\n    container_name: kafka-ui\n    ports:\n      - 8080:8080\n    environment:\n      DYNAMIC_CONFIG_ENABLED: \"true\"\n      KAFKA_CLUSTERS_0_NAME: local\n      KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:9093\n    depends_on:\n      - kafka\n\n  redis:\n    image: redis:7-alpine\n    container_name: redis\n    ports:\n      - \"6379:6379\"\n    command: redis-server --appendonly yes\n    volumes:\n      - \"redis_data:/data\"\n    healthcheck:\n      test: [ \"CMD\", \"redis-cli\", \"ping\" ]\n      interval: 5s\n      timeout: 3s\n      retries: 5\n\n  # ============================================\n  # Observability Services\n  # ============================================\n\n  loki:\n    image: grafana/loki:2.9.0\n    container_name: loki\n    ports:\n      - \"3100:3100\"\n    command: -config.file=/etc/loki/local-config.yaml\n    volumes:\n      - \"loki_data:/loki\"\n    healthcheck:\n      test: [ \"CMD-SHELL\", \"wget --no-verbose --tries=1 --spider http://localhost:3100/ready || exit 1\" ]\n      interval: 10s\n      timeout: 5s\n      retries: 5\n\n  grafana:\n    image: grafana/grafana:10.2.0\n    container_name: grafana\n    ports:\n      - \"3001:3000\"\n    environment:\n      - GF_PATHS_PROVISIONING=/etc/grafana/provisioning\n      - GF_AUTH_ANONYMOUS_ENABLED=true\n      - GF_AUTH_ANONYMOUS_ORG_ROLE=Admin\n      - GF_SECURITY_ADMIN_PASSWORD=admin\n    volumes:\n      - \"grafana_data:/var/lib/grafana\"\n    depends_on:\n      loki:\n        condition: service_healthy\n\nvolumes:\n  mongo_data:\n  mongo_config:\n  kafka_data:\n  redis_data:\n  loki_data:\n  grafana_data:\n";
+export declare const APP_COMPOSE_TEMPLATE = "services:\n  api:\n    image: ghcr.io/simplenotificationsystem/simplens-core:latest\n    container_name: api\n    ports:\n      - 3000:3000\n    env_file:\n      - .env\n    volumes:\n      - plugin-data:/app/.plugins\n      - ./simplens.config.yaml:/app/simplens.config.yaml:ro\n    command: [ \"node\", \"dist/api/server.js\" ]\n    restart: unless-stopped\n    healthcheck:\n      test: [ \"CMD\", \"node\", \"-e\", \"require('http').get('http://localhost:3000/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1)).on('error', () => process.exit(1))\" ]\n      interval: 30s\n      timeout: 10s\n      retries: 3\n      start_period: 10s\n\n  worker:\n    image: ghcr.io/simplenotificationsystem/simplens-core:latest\n    env_file:\n      - .env\n    command: [ \"node\", \"dist/workers/worker.js\" ]\n    restart: unless-stopped\n\n  notification_processor:\n    image: ghcr.io/simplenotificationsystem/simplens-core:latest\n    env_file:\n      - .env\n    volumes:\n      - plugin-data:/app/.plugins\n      - ./simplens.config.yaml:/app/simplens.config.yaml:ro\n    command: [ \"node\", \"dist/processors/unified/unified.processor.js\" ]\n    depends_on:\n      api:\n        condition: service_healthy\n    restart: unless-stopped\n\n  delayed_processor:\n    image: ghcr.io/simplenotificationsystem/simplens-core:latest\n    env_file:\n      - .env\n    command: [ \"node\", \"dist/processors/delayed/delayed.processor.js\" ]\n    restart: unless-stopped\n\n  recovery:\n    image: ghcr.io/simplenotificationsystem/simplens-core:latest\n    env_file:\n      - .env\n    command: [ \"node\", \"dist/workers/recovery/recovery.service.js\" ]\n    restart: unless-stopped\n\n  dashboard:\n    image: ghcr.io/simplenotificationsystem/simplens-dashboard:latest\n    ports:\n      - 3002:3002\n    container_name: dashboard\n    env_file:\n      - .env\n    environment:\n      PORT: ${DASHBOARD_PORT:-3002}\n      API_BASE_URL: http://api:${PORT:-3000}\n      WEBHOOK_HOST: dashboard\n      WEBHOOK_PORT: ${DASHBOARD_PORT:-3002}\n    restart: unless-stopped\n\nvolumes:\n  plugin-data:\n\nnetworks:\n  default:\n    name: simplens\n";
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,gwHA4HlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,imEA0EhC,CAAC"}

package/dist/templates.js

@@ -0,0 +1,202 @@
+// Docker Compose templates as constants
+export const INFRA_COMPOSE_TEMPLATE = `# ============================================
+# INFRA_HOST: Set this in .env to your machine's IP/hostname when running
+#             infrastructure on a separate system from application services.
+#             Default: host.docker.internal (for same-system deployment)
+# ============================================
+
+services:
+  # ============================================
+  # Infrastructure Services
+  # ============================================
+  mongo:
+    image: mongo:7.0
+    container_name: mongo
+    command: [ "--replSet", "rs0", "--bind_ip_all", "--port", "27017" ]
+    ports:
+      - 27017:27017
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    healthcheck:
+      test: echo "try { rs.status() } catch (err) { rs.initiate({_id:'rs0',members:[{_id:0,host:'{{INFRA_HOST}}:27017'}]}) }" | mongosh --port 27017 --quiet
+      interval: 5s
+      timeout: 30s
+      start_period: 0s
+      start_interval: 1s
+      retries: 30
+    volumes:
+      - "mongo_data:/data/db"
+      - "mongo_config:/data/configdb"
+
+  kafka:
+    image: apache/kafka-native
+    container_name: kafka
+    ports:
+      - "9092:9092"
+    environment:
+      # Configure listeners for both docker and host communication
+      KAFKA_LISTENERS: CONTROLLER://localhost:9091,HOST://0.0.0.0:9092,DOCKER://0.0.0.0:9093
+      KAFKA_ADVERTISED_LISTENERS: HOST://{{INFRA_HOST}}:9092,DOCKER://kafka:9093
+      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: CONTROLLER:PLAINTEXT,DOCKER:PLAINTEXT,HOST:PLAINTEXT
+
+      # Settings required for KRaft mode
+      KAFKA_NODE_ID: 1
+      KAFKA_PROCESS_ROLES: broker,controller
+      KAFKA_CONTROLLER_LISTENER_NAMES: CONTROLLER
+      KAFKA_CONTROLLER_QUORUM_VOTERS: 1@localhost:9091
+
+      # Listener to use for broker-to-broker communication
+      KAFKA_INTER_BROKER_LISTENER_NAME: DOCKER
+
+      # Required for a single node cluster
+      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
+
+      # Disable auto-topic creation - API server will create topics with correct partitions
+      KAFKA_AUTO_CREATE_TOPICS_ENABLE: "false"
+    volumes:
+      - "kafka_data:/var/lib/kafka/data"
+
+  kafka-ui:
+    image: kafbat/kafka-ui:main
+    container_name: kafka-ui
+    ports:
+      - 8080:8080
+    environment:
+      DYNAMIC_CONFIG_ENABLED: "true"
+      KAFKA_CLUSTERS_0_NAME: local
+      KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:9093
+    depends_on:
+      - kafka
+
+  redis:
+    image: redis:7-alpine
+    container_name: redis
+    ports:
+      - "6379:6379"
+    command: redis-server --appendonly yes
+    volumes:
+      - "redis_data:/data"
+    healthcheck:
+      test: [ "CMD", "redis-cli", "ping" ]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
+  # ============================================
+  # Observability Services
+  # ============================================
+
+  loki:
+    image: grafana/loki:2.9.0
+    container_name: loki
+    ports:
+      - "3100:3100"
+    command: -config.file=/etc/loki/local-config.yaml
+    volumes:
+      - "loki_data:/loki"
+    healthcheck:
+      test: [ "CMD-SHELL", "wget --no-verbose --tries=1 --spider http://localhost:3100/ready || exit 1" ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  grafana:
+    image: grafana/grafana:10.2.0
+    container_name: grafana
+    ports:
+      - "3001:3000"
+    environment:
+      - GF_PATHS_PROVISIONING=/etc/grafana/provisioning
+      - GF_AUTH_ANONYMOUS_ENABLED=true
+      - GF_AUTH_ANONYMOUS_ORG_ROLE=Admin
+      - GF_SECURITY_ADMIN_PASSWORD=admin
+    volumes:
+      - "grafana_data:/var/lib/grafana"
+    depends_on:
+      loki:
+        condition: service_healthy
+
+volumes:
+  mongo_data:
+  mongo_config:
+  kafka_data:
+  redis_data:
+  loki_data:
+  grafana_data:
+`;
+export const APP_COMPOSE_TEMPLATE = `services:
+  api:
+    image: ghcr.io/simplenotificationsystem/simplens-core:latest
+    container_name: api
+    ports:
+      - 3000:3000
+    env_file:
+      - .env
+    volumes:
+      - plugin-data:/app/.plugins
+      - ./simplens.config.yaml:/app/simplens.config.yaml:ro
+    command: [ "node", "dist/api/server.js" ]
+    restart: unless-stopped
+    healthcheck:
+      test: [ "CMD", "node", "-e", "require('http').get('http://localhost:3000/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1)).on('error', () => process.exit(1))" ]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  worker:
+    image: ghcr.io/simplenotificationsystem/simplens-core:latest
+    env_file:
+      - .env
+    command: [ "node", "dist/workers/worker.js" ]
+    restart: unless-stopped
+
+  notification_processor:
+    image: ghcr.io/simplenotificationsystem/simplens-core:latest
+    env_file:
+      - .env
+    volumes:
+      - plugin-data:/app/.plugins
+      - ./simplens.config.yaml:/app/simplens.config.yaml:ro
+    command: [ "node", "dist/processors/unified/unified.processor.js" ]
+    depends_on:
+      api:
+        condition: service_healthy
+    restart: unless-stopped
+
+  delayed_processor:
+    image: ghcr.io/simplenotificationsystem/simplens-core:latest
+    env_file:
+      - .env
+    command: [ "node", "dist/processors/delayed/delayed.processor.js" ]
+    restart: unless-stopped
+
+  recovery:
+    image: ghcr.io/simplenotificationsystem/simplens-core:latest
+    env_file:
+      - .env
+    command: [ "node", "dist/workers/recovery/recovery.service.js" ]
+    restart: unless-stopped
+
+  dashboard:
+    image: ghcr.io/simplenotificationsystem/simplens-dashboard:latest
+    ports:
+      - 3002:3002
+    container_name: dashboard
+    env_file:
+      - .env
+    environment:
+      PORT: \${DASHBOARD_PORT:-3002}
+      API_BASE_URL: http://api:\${PORT:-3000}
+      WEBHOOK_HOST: dashboard
+      WEBHOOK_PORT: \${DASHBOARD_PORT:-3002}
+    restart: unless-stopped
+
+volumes:
+  plugin-data:
+
+networks:
+  default:
+    name: simplens
+`;
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4HrC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0EnC,CAAC"}

package/dist/types/domain.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Domain type definitions for the onboarding system
+ */
+/**
+ * Plugin information returned by config-gen
+ */
+export interface PluginInfo {
+    /** Package name (e.g., '@simplens/nodemailer-gmail') */
+    package: string;
+    /** Display name */
+    name: string;
+    /** Description of what the plugin does */
+    description: string;
+}
+/**
+ * Infrastructure service option
+ */
+export interface InfraService {
+    /** Display name (e.g., 'MongoDB (Database)') */
+    name: string;
+    /** Service identifier (e.g., 'mongo') */
+    value: string;
+    /** Whether checked by default */
+    checked: boolean;
+}
+/**
+ * Environment variable definition
+ */
+export interface EnvVariable {
+    /** Environment variable key */
+    key: string;
+    /** Current or default value */
+    value: string;
+    /** Optional description/comment */
+    description?: string;
+    /** Whether this variable is required */
+    required: boolean;
+}
+/**
+ * Setup options provided via CLI or prompts
+ */
+export interface SetupOptions {
+    /** Whether to setup infrastructure services */
+    infra: boolean;
+    /** Environment configuration mode */
+    envMode: 'default' | 'interactive';
+    /** Target directory for setup */
+    targetDir: string;
+}
+/**
+ * Service definition for docker-compose generation
+ */
+export interface ServiceDefinition {
+    /** Service identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Docker compose YAML block */
+    dockerCompose: string;
+    /** Required volumes */
+    volumes: string[];
+    /** Service dependencies */
+    dependencies?: string[];
+    /** Whether service has health check */
+    healthCheck?: boolean;
+}
+/**
+ * SimplensConfig YAML structure
+ */
+export interface SimplensConfig {
+    providers: ProviderConfig[];
+}
+/**
+ * Provider configuration in simplens.config.yaml
+ */
+export interface ProviderConfig {
+    /** Package name */
+    package: string;
+    /** Provider ID */
+    id: string;
+    /** Required credentials as key-value pairs */
+    credentials: Record<string, string>;
+    /** Optional configuration */
+    optionalConfig?: Record<string, string | number | boolean>;
+}
+/**
+ * Docker compose file structure (simplified)
+ */
+export interface DockerComposeFile {
+    services: Record<string, DockerService>;
+    volumes?: Record<string, DockerVolume>;
+    networks?: Record<string, DockerNetwork>;
+}
+export interface DockerService {
+    image: string;
+    container_name?: string;
+    ports?: string[];
+    environment?: Record<string, string> | string[];
+    volumes?: string[];
+    command?: string | string[];
+    depends_on?: string[] | Record<string, {
+        condition: string;
+    }>;
+    healthcheck?: {
+        test: string | string[];
+        interval?: string;
+        timeout?: string;
+        retries?: number;
+        start_period?: string;
+    };
+}
+export interface DockerVolume {
+    driver?: string;
+    driver_opts?: Record<string, string>;
+}
+export interface DockerNetwork {
+    driver?: string;
+}
+//# sourceMappingURL=domain.d.ts.map

package/dist/types/domain.d.ts.map

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

package/dist/types/domain.js

@@ -0,0 +1,5 @@
+/**
+ * Domain type definitions for the onboarding system
+ */
+export {};
+//# sourceMappingURL=domain.js.map

package/dist/types/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/types/domain.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/errors.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Custom error types for better error handling and troubleshooting
+ */
+/**
+ * Base error class for all onboarding errors
+ */
+export declare class OnboardingError extends Error {
+    readonly code: string;
+    readonly troubleshooting?: string | undefined;
+    constructor(code: string, message: string, troubleshooting?: string | undefined);
+}
+/**
+ * Docker-related errors
+ */
+export declare class DockerError extends OnboardingError {
+    constructor(message: string, troubleshooting?: string);
+}
+export declare class DockerNotInstalledError extends DockerError {
+    constructor();
+}
+export declare class DockerNotRunningError extends DockerError {
+    constructor();
+}
+export declare class DockerPermissionError extends DockerError {
+    constructor();
+}
+export declare class DockerComposeError extends DockerError {
+    constructor(operation: string, details?: string);
+}
+/**
+ * File system errors
+ */
+export declare class FileSystemError extends OnboardingError {
+    readonly path: string;
+    constructor(message: string, path: string, troubleshooting?: string);
+}
+export declare class DirectoryNotWritableError extends FileSystemError {
+    constructor(path: string);
+}
+export declare class FileNotFoundError extends FileSystemError {
+    constructor(path: string);
+}
+/**
+ * Configuration errors
+ */
+export declare class ConfigurationError extends OnboardingError {
+    constructor(message: string, troubleshooting?: string);
+}
+export declare class InvalidEnvironmentValueError extends ConfigurationError {
+    constructor(key: string, value: string, expectedFormat: string);
+}
+export declare class PluginConfigurationError extends ConfigurationError {
+    constructor(pluginName: string, details: string);
+}
+/**
+ * Service health errors
+ */
+export declare class ServiceHealthError extends OnboardingError {
+    constructor(serviceName: string, timeout: number);
+}
+/**
+ * Type guard to check if an error is an OnboardingError
+ */
+export declare function isOnboardingError(error: unknown): error is OnboardingError;
+/**
+ * Format error for user display
+ */
+export declare function formatErrorForUser(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAElB,IAAI,EAAE,MAAM;aAEZ,eAAe,CAAC,EAAE,MAAM;gBAFxB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,eAAe,CAAC,EAAE,MAAM,YAAA;CAM/C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,eAAe;gBAChC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM;CAIxD;AAED,qBAAa,uBAAwB,SAAQ,WAAW;;CAQvD;AAED,qBAAa,qBAAsB,SAAQ,WAAW;;CAQrD;AAED,qBAAa,qBAAsB,SAAQ,WAAW;;CAUrD;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACnC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAOlD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,eAAe;aACH,IAAI,EAAE,MAAM;gBAA7C,OAAO,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM;CAItF;AAED,qBAAa,yBAA0B,SAAQ,eAAe;gBAC9C,IAAI,EAAE,MAAM;CAQ3B;AAED,qBAAa,iBAAkB,SAAQ,eAAe;gBACtC,IAAI,EAAE,MAAM;CAQ3B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;gBACvC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM;CAIxD;AAED,qBAAa,4BAA6B,SAAQ,kBAAkB;gBACpD,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAOjE;AAED,qBAAa,wBAAyB,SAAQ,kBAAkB;gBAChD,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAOlD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;gBACvC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CASnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAczD"}