cdd-cli 4.0.0 → 4.1.0

package/src/hooks/useContainerCommandRouter.js

@@ -1,123 +0,0 @@
-import { useCallback } from 'react';
-
-/**
- * Hook responsible solely for routing Docker action keystrokes to the correct handler.
- * Has no domain state of its own — it delegates every side-effect to its dependencies.
- *
- * Handled keys:
- *   i  — start container
- *   p  — stop container
- *   r  — restart container
- *   e  — request erase confirmation
- *   l  — open logs viewer and start log stream
- *   c  — open container creation wizard (reset + activate)
- *   d  — toggle debug log panel
- *
- * @param {Object} params
- * @param {Object} params.actions       - API from useContainerActions
- * @param {Array<Object>} params.containers - Current list of Docker containers
- * @param {number} params.selected      - Index of the currently selected container
- * @param {Object} params.creation      - API from useContainerCreation (must expose resetCreation)
- * @param {Object} params.logsViewer    - API from useLogsViewer
- * @param {Function} params.startLogsStream - Starts the log stream for a container id
- * @param {Function} params.onStartErase    - Callback: activates confirmErase state
- * @param {Function} params.onToggleDebug   - Callback: toggles showDebugLogs state
- * @param {Function} params.onStartCreate   - Callback: sets creatingContainer = true
- * @returns {{ handleDockerCommands: Function }}
- */
-export function useContainerCommandRouter({
-  actions,
-  containers,
-  selected,
-  creation,
-  logsViewer,
-  startLogsStream,
-  onStartErase,
-  onToggleDebug,
-  onStartCreate,
-}) {
-  const handleDockerCommands = useCallback(
-    (input) => {
-      const container = containers[selected];
-
-      if (input === 'i') {
-        actions.handleAction({
-          actionFn: async (id) => await actions.startContainer(id),
-          actionLabel: 'Starting',
-          selected,
-          stateCheck: (c) =>
-            (c.state === 'running' || c.status === 'running') &&
-            'Container is already running.',
-        });
-        return true;
-      }
-
-      if (input === 'p') {
-        actions.handleAction({
-          actionFn: async (id) => await actions.stopContainer(id),
-          actionLabel: 'Stopping',
-          selected,
-          stateCheck: (c) =>
-            (c.state === 'exited' ||
-              c.status === 'exited' ||
-              c.state === 'stopped' ||
-              c.status === 'stopped') &&
-            'Container is already stopped.',
-        });
-        return true;
-      }
-
-      if (input === 'r') {
-        actions.handleAction({
-          actionFn: async (id) => await actions.restartContainer(id),
-          actionLabel: 'Restarting',
-          selected,
-        });
-        return true;
-      }
-
-      if (input === 'e') {
-        if (!container) {
-          return true;
-        }
-        onStartErase();
-        return true;
-      }
-
-      if (input === 'l') {
-        if (!container) {
-          return true;
-        }
-        logsViewer.openLogs();
-        startLogsStream(container.id);
-        return true;
-      }
-
-      if (input === 'c') {
-        creation.resetCreation();
-        onStartCreate();
-        return true;
-      }
-
-      if (input === 'd') {
-        onToggleDebug();
-        return true;
-      }
-
-      return false;
-    },
-    [
-      actions,
-      containers,
-      creation,
-      logsViewer,
-      onStartCreate,
-      onStartErase,
-      onToggleDebug,
-      selected,
-      startLogsStream,
-    ]
-  );
-
-  return { handleDockerCommands };
-}

package/src/hooks/useContainerStats.js

@@ -1,44 +0,0 @@
-import { useState, useEffect } from 'react';
-import { getStats } from '../helpers/dockerService/serviceComponents/containerStats.js';
-import { REFRESH_INTERVALS } from '../helpers/constants.js';
-
-const DEFAULT_STATS = { cpuPercent: 0, memPercent: 0, netIO: { rx: 0, tx: 0 } };
-
-export function useContainerStats(id, state) {
-  const [stats, setStats] = useState(DEFAULT_STATS);
-  const [statsError, setStatsError] = useState('');
-
-  useEffect(() => {
-    if (state !== 'running') {
-      setStats(DEFAULT_STATS);
-      setStatsError('');
-      return;
-    }
-
-    let isMounted = true;
-
-    const fetchStats = async () => {
-      try {
-        const s = await getStats(id);
-        if (isMounted) {
-          setStats(s);
-          setStatsError('');
-        }
-      } catch (err) {
-        if (isMounted) {
-          setStats(DEFAULT_STATS);
-          setStatsError('Error fetching stats');
-        }
-      }
-    };
-
-    fetchStats();
-    const timer = setInterval(fetchStats, REFRESH_INTERVALS.CONTAINER_STATS);
-    return () => {
-      isMounted = false;
-      clearInterval(timer);
-    };
-  }, [id, state]);
-
-  return { stats, statsError };
-}

package/src/hooks/useContainers.js

@@ -1,26 +0,0 @@
-/**
- * React hook to manage Docker containers state.
- *
- * @returns {{containers: Array<Object>}} An object containing the current
- * containers array. The hook starts a periodic refresh and fetches the
- * container list immediately on mount.
- * @example
- * // Use in a component
- * const { containers } = useContainers();
- */
-import React, { useState, useEffect } from 'react';
-import { getContainers } from '../helpers/dockerService/serviceComponents/containerList';
-import { REFRESH_INTERVALS } from '../helpers/constants.js';
-
-export function useContainers() {
-  const [containers, setContainers] = useState([]);
-
-  useEffect(() => {
-    const fetch = async () => setContainers(await getContainers());
-    fetch();
-    const timer = setInterval(fetch, REFRESH_INTERVALS.CONTAINER_LIST);
-    return () => clearInterval(timer);
-  }, []);
-
-  return { containers };
-}

package/src/hooks/useControls.js

@@ -1,263 +0,0 @@
-import React from 'react';
-import { useInput } from 'ink';
-import { useContainerActions } from './creation/useContainerActions';
-import { useContainerCreation } from './creation/useContainerCreation';
-import { useLogsViewer } from './creation/useLogsViewer';
-import { useContainerSelection } from './navigation/useContainerSelection';
-import { useDebugLogs } from './debug/useDebugLogs';
-import { useEraseConfirmation } from './useEraseConfirmation';
-import { useExitHandler } from './useExitHandler';
-import { useContainerCommandRouter } from './useContainerCommandRouter';
-import { getLogsStream } from '../helpers/dockerService/serviceComponents/containerLogs.js';
-import { createContainer as svcCreateContainer } from '../helpers/dockerService/serviceComponents/containerActions.js';
-import { buildContainerOptions } from '../helpers/containerOptionsBuilder.js';
-import { DB_IMAGES } from '../helpers/constants.js';
-
-// Principal hook to manage user inputs and control the app state
-/**
- * Main hook that wires user input, creation, actions and logs viewing.
- * It coordinates the modular hooks and exposes a compact API consumed by the App.
- *
- * @param {Array<Object>} containers - Current list of Docker containers
- * @returns {Object} controls - API for the App component
- */
-export function useControls(containers = [], overrides = {}) {
-  const [creatingContainer, setCreatingContainer] = React.useState(false);
-
-  // — Modular hooks —
-  const actions = useContainerActions({ containers });
-
-  const creation = useContainerCreation({
-    onCreate: async ({ imageName, containerName, portInput, envInput }) => {
-      const options = buildContainerOptions({
-        imageName,
-        containerName,
-        portInput,
-        envInput,
-      });
-      actions.setTimedMessage(`Creating container ${imageName}...`, 'yellow');
-      try {
-        const { id, ports } = await svcCreateContainer(imageName, options);
-        let portMsg = '';
-        if (ports && ports.length) {
-          portMsg =
-            ' | Ports: ' +
-            ports
-              .map((p) => `${p.hostPort}→${p.containerPort}/${p.protocol}`)
-              .join(', ');
-        }
-        actions.setTimedMessage(`Created container ${id}${portMsg}`, 'green');
-      } catch (err) {
-        actions.setTimedMessage(`Error creating container: ${err.message}`, 'red');
-      } finally {
-        setCreatingContainer(false);
-      }
-    },
-    onCancel: () => setCreatingContainer(false),
-    dbImages: DB_IMAGES,
-  });
-
-  const logsViewer = useLogsViewer();
-  const selection = useContainerSelection(containers.length);
-  const debugLogs = useDebugLogs();
-
-  // Allow overrides for testability (e.g. injecting a mock triggerHubSearch)
-  const triggerHubSearch = overrides.triggerHubSearch ?? creation.triggerHubSearch;
-  const isSearchingHub = overrides.isSearchingHub ?? creation.isSearchingHub;
-  const insertNextSuggestedEnv = overrides.insertNextSuggestedEnv !== undefined
-    ? overrides.insertNextSuggestedEnv
-    : creation.insertNextSuggestedEnv;
-
-  const eraseConfirmation = useEraseConfirmation({
-    onConfirm: () => {
-      actions.handleAction({
-        actionFn: async (id) => await actions.removeContainer(id),
-        actionLabel: 'Erasing',
-        selected: selection.selected,
-      });
-      actions.setMessageColor('yellow');
-    },
-    onCancel: () => {
-      actions.setMessage('');
-      actions.setMessageColor('');
-    },
-  });
-
-  /**
-   * Pipe container logs into the viewer while applying a hard limit.
-   * @param {string} containerId - Container identifier used by Docker.
-   */
-  const startLogsStream = React.useCallback(
-    (containerId) => {
-      getLogsStream(
-        containerId,
-        (data) =>
-          logsViewer.setLogs((prev) => {
-            const newLogs = [...prev, ...data.split('\n').filter(Boolean)];
-            return newLogs.slice(-1000);
-          }),
-        () => {},
-        (err) =>
-          logsViewer.setLogs((prev) => [...prev, `Error: ${err.message}`])
-      );
-    },
-    [logsViewer]
-  );
-
-  const commandRouter = useContainerCommandRouter({
-    actions,
-    containers,
-    selected: selection.selected,
-    creation,
-    logsViewer,
-    startLogsStream,
-    onStartErase: () => {
-      eraseConfirmation.startErase();
-      actions.setMessage(
-        'Are you sure you want to erase this container? (y/n)'
-      );
-      actions.setMessageColor('yellow');
-    },
-    onToggleDebug: () => debugLogs.setShowDebugLogs((prev) => !prev),
-    onStartCreate: () => setCreatingContainer(true),
-  });
-
-  const exitHandler = useExitHandler({
-    onBeforeExit: () => {
-      actions.setMessage('Exiting...');
-      actions.setMessageColor('yellow');
-      logsViewer.closeLogs();
-      debugLogs.setShowDebugLogs(false);
-    },
-  });
-
-  /**
-   * Route keystrokes to the container creation wizard.
-   */
-  const processCreationInput = React.useCallback(
-    (input, key) => {
-      const step = creation.step;
-
-      const removeLastChar = (setter) =>
-        setter((value) => (value || '').slice(0, -1));
-      const appendChar = (setter, current, ch) => setter((current || '') + ch);
-
-      if (key.escape) {
-        creation.cancelCreation();
-        setCreatingContainer(false);
-        return;
-      }
-
-      if (input === '\r' || input === '\n') {
-        // If on step 0 with a focused suggestion, apply it instead of advancing
-        if (step === 0 && creation.selectedSuggestionIndex >= 0) {
-          creation.applyFocusedSuggestion();
-          return;
-        }
-        creation.nextStep();
-        return;
-      }
-
-      // Tab on step 0: trigger Docker Hub search (with guards)
-      if (key.tab) {
-        if (step === 0) {
-          if (!isSearchingHub && (creation.imageName || '').trim() !== '') {
-            triggerHubSearch();
-          }
-        } else if (step === 3) {
-          insertNextSuggestedEnv?.();
-        }
-        return;
-      }
-
-      // Arrow keys on step 0: navigate suggestion list
-      if (step === 0 && creation.suggestions.length > 0) {
-        if (key.upArrow) {
-          creation.moveSuggestionSelection(-1);
-          return;
-        }
-        if (key.downArrow) {
-          creation.moveSuggestionSelection(1);
-          return;
-        }
-      }
-
-      if (key.backspace || key.delete) {
-        if (step === 0) {
-          const newValue = (creation.imageName || '').slice(0, -1);
-          creation.updateImageInput(newValue);
-        }
-        if (step === 1) removeLastChar(creation.setContainerName);
-        if (step === 2) removeLastChar(creation.setPortInput);
-        if (step === 3) removeLastChar(creation.setEnvInput);
-        return;
-      }
-
-      if (input && input.length === 1 && !key.ctrl && !key.meta) {
-        if (step === 0) {
-          creation.updateImageInput((creation.imageName || '') + input);
-        }
-        if (step === 1)
-          appendChar(creation.setContainerName, creation.containerName, input);
-        if (step === 2)
-          appendChar(creation.setPortInput, creation.portInput, input);
-        if (step === 3)
-          appendChar(creation.setEnvInput, creation.envInput, input);
-      }
-    },
-    [creation, setCreatingContainer, triggerHubSearch, isSearchingHub, insertNextSuggestedEnv]
-  );
-
-  // Single keyboard entry point
-  useInput((input, key) => {
-    if (eraseConfirmation.confirmErase) {
-      eraseConfirmation.processEraseConfirmation(input, key);
-      return;
-    }
-
-    if (logsViewer.showLogs) {
-      if (input === 'q' || key.escape) {
-        logsViewer.closeLogs();
-      }
-      return;
-    }
-
-    if (creatingContainer) {
-      processCreationInput(input, key);
-      return;
-    }
-
-    if (debugLogs.showDebugLogs && key.escape) {
-      debugLogs.setShowDebugLogs(false);
-      return;
-    }
-
-    commandRouter.handleDockerCommands(input);
-    exitHandler.handleExitCommand(input);
-    selection.handleNavigation(input, key);
-  });
-
-  return {
-    selected: selection.selected,
-    setSelected: selection.setSelected,
-    message: creatingContainer ? creation.message : actions.message,
-    messageColor: creatingContainer
-      ? creation.messageColor
-      : actions.messageColor,
-    showLogs: logsViewer.showLogs,
-    logs: logsViewer.logs,
-    exitLogs: logsViewer.closeLogs,
-    creatingContainer,
-    creationStep: creation.step,
-    imageNameInput: creation.imageName,
-    containerNameInput: creation.containerName,
-    portInput: creation.portInput,
-    envInput: creation.envInput,
-    creation,
-    actions,
-    logsViewer,
-    confirmErase: eraseConfirmation.confirmErase,
-    showDebugLogs: debugLogs.showDebugLogs,
-    debugLogs: debugLogs.debugLogs,
-  };
-}

package/src/hooks/useEraseConfirmation.js

@@ -1,39 +0,0 @@
-import { useState, useCallback } from 'react';
-
-/**
- * Hook to manage the erase confirmation dialog flow.
- *
- * Encapsulates the `confirmErase` state and the input handler that resolves it.
- * The caller is responsible for what happens on confirm/cancel via the callbacks.
- *
- * @param {Object} params
- * @param {Function} params.onConfirm - Called when the user presses y/Y. Should trigger the erase action.
- * @param {Function} params.onCancel  - Called when the user presses n/N or Escape. Should clean up messages.
- * @returns {{ confirmErase: boolean, startErase: Function, processEraseConfirmation: Function }}
- */
-export function useEraseConfirmation({ onConfirm, onCancel }) {
-  const [confirmErase, setConfirmErase] = useState(false);
-
-  const startErase = useCallback(() => {
-    setConfirmErase(true);
-  }, []);
-
-  const processEraseConfirmation = useCallback(
-    (input, key) => {
-      if (input === 'y' || input === 'Y') {
-        onConfirm();
-        setConfirmErase(false);
-        return;
-      }
-
-      if (input === 'n' || input === 'N' || key.escape) {
-        setConfirmErase(false);
-        onCancel();
-        return;
-      }
-    },
-    [onConfirm, onCancel]
-  );
-
-  return { confirmErase, startErase, processEraseConfirmation };
-}

package/src/hooks/useExitHandler.js

@@ -1,69 +0,0 @@
-import { useCallback } from 'react';
-import { useApp } from 'ink';
-import { EXIT_DELAY } from '../helpers/constants.js';
-
-/**
- * Hook that encapsulates the application exit sequence triggered by pressing `q`.
- *
- * Responsibilities:
- * - Detect the `q` keypress
- * - Invoke an optional `onBeforeExit` callback for resource cleanup (e.g. closing logs)
- * - Clear the terminal after a short delay
- * - Call Ink's `exit()` and, outside of test environments, `process.exit(0)`
- *
- * @param {Object} [options]
- * @param {Function} [options.onBeforeExit] - Optional callback invoked synchronously
- *   before the exit delay starts. Use it to close logs, reset UI state, etc.
- * @returns {{ handleExitCommand: Function }}
- */
-export function useExitHandler({ onBeforeExit } = {}) {
-  const { exit } = useApp();
-
-  /**
-   * Handle the quit command.
-   *
-   * Mirrors the exact logic of `handleExitCommand` in `useControls.js`:
-   * 1. Guard: return false if input is not 'q'
-   * 2. Call onBeforeExit (replaces inline logsViewer.closeLogs + setShowDebugLogs(false))
-   * 3. After EXIT_DELAY: clear terminal, call exit(), then process.exit(0) outside tests
-   *
-   * @param {string} input - Raw character input from Ink's useInput
-   * @returns {boolean} True when the input was consumed, false otherwise
-   */
-  const handleExitCommand = useCallback(
-    (input) => {
-      if (input !== 'q') {
-        return false;
-      }
-
-      if (typeof onBeforeExit === 'function') {
-        onBeforeExit();
-      }
-
-      const clearTerminal = () => {
-        try {
-          if (process.stdout && process.stdout.isTTY) {
-            process.stdout.write('\u001Bc');
-          } else {
-            console.clear();
-          }
-        } catch (err) {
-          // Ignore clear errors to avoid blocking exit.
-        }
-      };
-
-      setTimeout(() => {
-        clearTerminal();
-        exit();
-        if (process.env.NODE_ENV !== 'test') {
-          setTimeout(() => process.exit(0), 50);
-        }
-      }, EXIT_DELAY);
-
-      return true;
-    },
-    [exit, onBeforeExit]
-  );
-
-  return { handleExitCommand };
-}

package/src/index.js

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-/**
- * Entry point for the CDD CLI application.
- *
- * @module index
- * @example
- * // Run the CLI
- * node index.js
- */
-
-import React from 'react';
-import { render } from 'ink';
-import App from './App.jsx';
-import { logger } from './helpers/logger.js';
-
-process.on('uncaughtException', (err) => logger.error('Uncaught exception', err));
-process.on('unhandledRejection', (reason) => logger.error('Unhandled rejection', reason));
-
-console.clear();
-render(<App />);