@ceschiatti/redistail 0.0.1 → 0.0.3

package/src/cli/config-service.ts

@@ -0,0 +1,455 @@
+/**
+ * CLI Configuration Service for redistail utility.
+ *
+ * This module provides services for parsing command-line arguments,
+ * loading environment configuration, and displaying help/version information.
+ * Built using Effect-TS patterns with proper error handling and dependency injection.
+ */
+
+import { Context, Effect, Layer, Config, Console } from 'effect';
+import { BUILD_COMMIT, BUILD_VERSION } from './version-generated.js';
+import {
+  CLIConfig,
+  RedistailConfig,
+  isValidConnectionType,
+  isValidTopicName,
+  createInvalidArgumentError,
+  createMissingArgumentError,
+  createEnvironmentError,
+  createDefaultRedistailConfig,
+  DEFAULT_CLI_REDIS_CONFIG,
+  DEFAULT_DISPLAY_CONFIG,
+  DEFAULT_MONITORING_CONFIG,
+} from './types.js';
+import type { CLIError, ConfigError } from './types.js';
+
+// ============================================================================
+// Service Interface
+// ============================================================================
+
+/**
+ * CLI Configuration Service interface
+ */
+export interface CLIConfigService {
+  readonly parseArgs: (args: string[]) => Effect.Effect<CLIConfig, CLIError>;
+  readonly loadConfig: () => Effect.Effect<RedistailConfig, ConfigError>;
+  readonly showHelp: () => Effect.Effect<void, never>;
+  readonly showVersion: () => Effect.Effect<void, never>;
+}
+
+/**
+ * Service tag for dependency injection
+ */
+export const CLIConfigService =
+  Context.GenericTag<CLIConfigService>('CLIConfigService');
+
+// ============================================================================
+// Environment Configuration Schema
+// ============================================================================
+
+/**
+ * Redis configuration from environment variables
+ */
+const redisHost = Config.withDefault(
+  Config.string('REDIS_HOST'),
+  DEFAULT_CLI_REDIS_CONFIG.host,
+);
+const redisPort = Config.withDefault(
+  Config.integer('REDIS_PORT'),
+  DEFAULT_CLI_REDIS_CONFIG.port,
+);
+const redisUrl = Config.option(Config.string('REDIS_URL'));
+const redisTimeout = Config.withDefault(
+  Config.integer('REDIS_TIMEOUT'),
+  DEFAULT_CLI_REDIS_CONFIG.timeout,
+);
+const redisRetryAttempts = Config.withDefault(
+  Config.integer('REDIS_RETRY_ATTEMPTS'),
+  DEFAULT_CLI_REDIS_CONFIG.retryAttempts,
+);
+const redisRetryDelay = Config.withDefault(
+  Config.integer('REDIS_RETRY_DELAY'),
+  DEFAULT_CLI_REDIS_CONFIG.retryDelay,
+);
+
+/**
+ * Display configuration from environment variables
+ */
+const redistailColors = Config.withDefault(
+  Config.boolean('REDISTAIL_COLORS'),
+  DEFAULT_DISPLAY_CONFIG.colors,
+);
+const redistailTimestamps = Config.withDefault(
+  Config.boolean('REDISTAIL_TIMESTAMPS'),
+  DEFAULT_DISPLAY_CONFIG.timestamps,
+);
+const redistailPrettyJson = Config.withDefault(
+  Config.boolean('REDISTAIL_PRETTY_JSON'),
+  DEFAULT_DISPLAY_CONFIG.prettyJson,
+);
+
+/**
+ * Monitoring configuration from environment variables
+ */
+const redistailBlockTimeout = Config.withDefault(
+  Config.integer('REDISTAIL_BLOCK_TIMEOUT'),
+  DEFAULT_MONITORING_CONFIG.blockTimeout,
+);
+const redistailMaxReconnectAttempts = Config.withDefault(
+  Config.integer('REDISTAIL_MAX_RECONNECT_ATTEMPTS'),
+  DEFAULT_MONITORING_CONFIG.maxReconnectAttempts,
+);
+
+// ============================================================================
+// Implementation Functions
+// ============================================================================
+
+/**
+ * Parse command line arguments into CLIConfig
+ */
+const parseCommandLineArgs = (
+  args: string[],
+): Effect.Effect<CLIConfig, CLIError> =>
+  Effect.gen(function* () {
+    // Handle help flags
+    if (args.includes('--help') || args.includes('-h')) {
+      return CLIConfig({
+        connectionType: 'pubsub',
+        topicName: '',
+        help: true,
+      });
+    }
+
+    // Handle version flags
+    if (args.includes('--version') || args.includes('-v')) {
+      return CLIConfig({
+        connectionType: 'pubsub',
+        topicName: '',
+        version: true,
+      });
+    }
+
+    // Check for minimum required arguments
+    if (args.length < 2) {
+      return yield* Effect.fail(
+        createMissingArgumentError(
+          'Missing required arguments. Usage: redistail <pubsub|stream> <topic-name>',
+          'ARGUMENT_PARSING',
+        ),
+      );
+    }
+
+    const [connectionType, topicName, ...extraArgs] = args;
+
+    // Validate connection type
+    if (!isValidConnectionType(connectionType)) {
+      return yield* Effect.fail(
+        createInvalidArgumentError(
+          `Invalid connection type: ${connectionType}. Must be 'pubsub' or 'stream'`,
+          'ARGUMENT_PARSING',
+        ),
+      );
+    }
+
+    // Validate topic name
+    if (!isValidTopicName(topicName)) {
+      return yield* Effect.fail(
+        createInvalidArgumentError(
+          'Topic name cannot be empty',
+          'ARGUMENT_PARSING',
+        ),
+      );
+    }
+
+    // Check for unexpected extra arguments
+    if (extraArgs.length > 0) {
+      return yield* Effect.fail(
+        createInvalidArgumentError(
+          `Unexpected arguments: ${extraArgs.join(', ')}. Usage: redistail <pubsub|stream> <topic-name>`,
+          'ARGUMENT_PARSING',
+        ),
+      );
+    }
+
+    return CLIConfig({
+      connectionType,
+      topicName: topicName.trim(),
+    });
+  });
+
+/**
+ * Load configuration from environment variables
+ */
+const loadRedistailConfig = (): Effect.Effect<RedistailConfig, ConfigError> =>
+  Effect.gen(function* () {
+    const config = yield* Effect.all({
+      redisHost,
+      redisPort,
+      redisUrl,
+      redisTimeout,
+      redisRetryAttempts,
+      redisRetryDelay,
+      redistailColors,
+      redistailTimestamps,
+      redistailPrettyJson,
+      redistailBlockTimeout,
+      redistailMaxReconnectAttempts,
+    }).pipe(
+      Effect.mapError((configError) =>
+        createEnvironmentError(
+          'Failed to load configuration from environment',
+          configError,
+          'CONFIG_LOADING',
+        ),
+      ),
+    );
+
+    // Validate configuration values
+    if (config.redisPort < 1 || config.redisPort > 65535) {
+      return yield* Effect.fail(
+        createEnvironmentError(
+          `Invalid REDIS_PORT: ${config.redisPort}. Must be between 1 and 65535`,
+          undefined,
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    if (config.redisTimeout < 0) {
+      return yield* Effect.fail(
+        createEnvironmentError(
+          `Invalid REDIS_TIMEOUT: ${config.redisTimeout}. Must be non-negative`,
+          undefined,
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    if (config.redisRetryAttempts < 0) {
+      return yield* Effect.fail(
+        createEnvironmentError(
+          `Invalid REDIS_RETRY_ATTEMPTS: ${config.redisRetryAttempts}. Must be non-negative`,
+          undefined,
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    if (config.redisRetryDelay < 0) {
+      return yield* Effect.fail(
+        createEnvironmentError(
+          `Invalid REDIS_RETRY_DELAY: ${config.redisRetryDelay}. Must be non-negative`,
+          undefined,
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    if (config.redistailBlockTimeout < 0) {
+      return yield* Effect.fail(
+        createEnvironmentError(
+          `Invalid REDISTAIL_BLOCK_TIMEOUT: ${config.redistailBlockTimeout}. Must be non-negative`,
+          undefined,
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    if (config.redistailMaxReconnectAttempts < 0) {
+      return yield* Effect.fail(
+        createEnvironmentError(
+          `Invalid REDISTAIL_MAX_RECONNECT_ATTEMPTS: ${config.redistailMaxReconnectAttempts}. Must be non-negative`,
+          undefined,
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    return RedistailConfig({
+      redis: {
+        host: config.redisHost,
+        port: config.redisPort,
+        url:
+          config.redisUrl._tag === 'Some' ? config.redisUrl.value : undefined,
+        timeout: config.redisTimeout,
+        retryAttempts: config.redisRetryAttempts,
+        retryDelay: config.redisRetryDelay,
+      },
+      display: {
+        colors: config.redistailColors,
+        timestamps: config.redistailTimestamps,
+        prettyJson: config.redistailPrettyJson,
+      },
+      monitoring: {
+        blockTimeout: config.redistailBlockTimeout,
+        maxReconnectAttempts: config.redistailMaxReconnectAttempts,
+      },
+    });
+  });
+
+/**
+ * Display help information
+ */
+const showHelp = (): Effect.Effect<void, never> =>
+  Console.log(`
+redistail - Redis message monitoring utility
+
+USAGE:
+    redistail <CONNECTION_TYPE> <TOPIC_NAME>
+
+ARGUMENTS:
+    CONNECTION_TYPE    Type of Redis connection: 'pubsub' or 'stream'
+    TOPIC_NAME         Name of the channel (pubsub) or stream key (stream) to monitor
+
+OPTIONS:
+    -h, --help         Show this help message
+    -v, --version      Show version information
+
+ENVIRONMENT VARIABLES:
+    REDIS_HOST                      Redis hostname (default: ${DEFAULT_CLI_REDIS_CONFIG.host})
+    REDIS_PORT                      Redis port (default: ${DEFAULT_CLI_REDIS_CONFIG.port})
+    REDIS_URL                       Complete Redis connection URL (overrides host/port)
+    REDIS_TIMEOUT                   Connection timeout in ms (default: ${DEFAULT_CLI_REDIS_CONFIG.timeout})
+    REDIS_RETRY_ATTEMPTS            Number of retry attempts (default: ${DEFAULT_CLI_REDIS_CONFIG.retryAttempts})
+    REDIS_RETRY_DELAY               Delay between retries in ms (default: ${DEFAULT_CLI_REDIS_CONFIG.retryDelay})
+    REDISTAIL_COLORS                Enable colored output (default: ${DEFAULT_DISPLAY_CONFIG.colors})
+    REDISTAIL_TIMESTAMPS            Enable timestamps (default: ${DEFAULT_DISPLAY_CONFIG.timestamps})
+    REDISTAIL_PRETTY_JSON           Pretty-print JSON content (default: ${DEFAULT_DISPLAY_CONFIG.prettyJson})
+    REDISTAIL_BLOCK_TIMEOUT         Block timeout for streams in ms (default: ${DEFAULT_MONITORING_CONFIG.blockTimeout})
+    REDISTAIL_MAX_RECONNECT_ATTEMPTS Maximum reconnection attempts (default: ${DEFAULT_MONITORING_CONFIG.maxReconnectAttempts})
+
+EXAMPLES:
+    redistail pubsub my-channel
+    redistail stream my-stream
+    REDIS_HOST=redis.example.com redistail pubsub notifications
+    REDIS_URL=redis://user:pass@redis.example.com:6380 redistail stream events
+`);
+
+/**
+ * Display version information
+ */
+const showVersion = (): Effect.Effect<void, never> =>
+  Console.log(`redistail ${BUILD_VERSION}\nBuild: ${BUILD_COMMIT}`);
+
+// ============================================================================
+// Service Implementation
+// ============================================================================
+
+/**
+ * CLI Configuration Service implementation
+ */
+const cliConfigServiceImpl: CLIConfigService = {
+  parseArgs: parseCommandLineArgs,
+  loadConfig: loadRedistailConfig,
+  showHelp,
+  showVersion,
+};
+
+/**
+ * Live layer for CLI Configuration Service
+ */
+export const CLIConfigServiceLive: Layer.Layer<CLIConfigService> =
+  Layer.succeed(CLIConfigService, cliConfigServiceImpl);
+
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+
+/**
+ * Parse arguments and load configuration in one operation
+ */
+export const parseArgsAndLoadConfig = (
+  args: string[],
+): Effect.Effect<
+  { cli: CLIConfig; config: RedistailConfig },
+  CLIError | ConfigError,
+  CLIConfigService
+> =>
+  Effect.gen(function* () {
+    const cliConfigService = yield* CLIConfigService;
+    const cli = yield* cliConfigService.parseArgs(args);
+    const config = yield* cliConfigService.loadConfig();
+    return { cli, config };
+  });
+
+/**
+ * Handle help and version flags, returning true if handled
+ */
+export const handleHelpAndVersion = (
+  cliConfig: CLIConfig,
+): Effect.Effect<boolean, never, CLIConfigService> =>
+  Effect.gen(function* () {
+    const cliConfigService = yield* CLIConfigService;
+
+    if (cliConfig.help) {
+      yield* cliConfigService.showHelp();
+      return true;
+    }
+
+    if (cliConfig.version) {
+      yield* cliConfigService.showVersion();
+      return true;
+    }
+
+    return false;
+  });
+
+/**
+ * Validate CLI configuration for runtime use
+ */
+export const validateCLIConfig = (
+  cliConfig: CLIConfig,
+): Effect.Effect<CLIConfig, CLIError> =>
+  Effect.gen(function* () {
+    if (cliConfig.help || cliConfig.version) {
+      return cliConfig;
+    }
+
+    if (!isValidConnectionType(cliConfig.connectionType)) {
+      return yield* Effect.fail(
+        createInvalidArgumentError(
+          `Invalid connection type: ${cliConfig.connectionType}`,
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    if (!isValidTopicName(cliConfig.topicName)) {
+      return yield* Effect.fail(
+        createInvalidArgumentError(
+          'Topic name cannot be empty',
+          'CONFIG_VALIDATION',
+        ),
+      );
+    }
+
+    return cliConfig;
+  });
+
+/**
+ * Create a complete configuration for the redistail application
+ */
+export const createCompleteConfig = (
+  args: string[],
+): Effect.Effect<
+  { cli: CLIConfig; config: RedistailConfig; shouldExit: boolean },
+  CLIError | ConfigError,
+  CLIConfigService
+> =>
+  Effect.gen(function* () {
+    const cliConfigService = yield* CLIConfigService;
+    const cli = yield* cliConfigService.parseArgs(args);
+
+    // Handle help and version early
+    if (cli.help || cli.version) {
+      const shouldExit = yield* handleHelpAndVersion(cli);
+      const config = createDefaultRedistailConfig();
+      return { cli, config, shouldExit };
+    }
+
+    // Load full configuration for normal operation
+    const config = yield* cliConfigService.loadConfig();
+    const validatedCli = yield* validateCLIConfig(cli);
+
+    return { cli: validatedCli, config, shouldExit: false };
+  });