cdd-cli 3.2.2 → 4.1.0

package/src/hooks/useControls.js

@@ -1,247 +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 = []) {
-  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.setMessage(`Creating container ${imageName}...`);
-      actions.setMessageColor('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.setMessage(`Created container ${id}${portMsg}`);
-        actions.setMessageColor('green');
-      } catch (err) {
-        actions.setMessage(`Error creating container: ${err.message}`);
-        actions.setMessageColor('red');
-      } finally {
-        setCreatingContainer(false);
-      }
-    },
-    onCancel: () => setCreatingContainer(false),
-    dbImages: DB_IMAGES,
-  });
-
-  const logsViewer = useLogsViewer();
-  const selection = useContainerSelection(containers.length);
-  const debugLogs = useDebugLogs();
-
-  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;
-      }
-
-      // 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]
-  );
-
-  // 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,16 +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';
-
-console.clear();
-render(<App />);

package/test/ContainerCreationPrompt.dom.test.js

@@ -1,68 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-import React from 'react';
-import { render } from '@testing-library/react';
-import { ContainerCreationPrompt } from '../src/components/ContainerCreationPrompt.jsx';
-
-describe('ContainerCreationPrompt — SuggestionPanel wiring', () => {
-  test('does NOT render SuggestionPanel when step > 0', () => {
-    const { queryByText } = render(
-      <ContainerCreationPrompt
-        step={1}
-        imageName="nginx"
-        containerName=""
-        portInput=""
-        envInput=""
-        message=""
-        messageColor="yellow"
-        suggestions={['nginx', 'node']}
-        selectedSuggestionIndex={-1}
-        visibleOffset={0}
-      />
-    );
-    // On step 1, the imageName field is not active — no suggestion panel
-    expect(queryByText(/^nginx$/)).toBeNull();
-  });
-
-  test('does NOT render SuggestionPanel on step 0 when suggestions is empty', () => {
-    const { queryByTestId } = render(
-      <ContainerCreationPrompt
-        step={0}
-        imageName="ng"
-        containerName=""
-        portInput=""
-        envInput=""
-        message=""
-        messageColor="yellow"
-        suggestions={[]}
-        selectedSuggestionIndex={-1}
-        visibleOffset={0}
-      />
-    );
-    // No suggestion panel should render when suggestions array is empty
-    expect(queryByTestId('suggestion-panel')).toBeNull();
-  });
-
-  test('renders SuggestionPanel items on step 0 when suggestions exist', () => {
-    const { getAllByText, getByText } = render(
-      <ContainerCreationPrompt
-        step={0}
-        imageName="ng"
-        containerName=""
-        portInput=""
-        envInput=""
-        message=""
-        messageColor="yellow"
-        suggestions={['nginx', 'golang']}
-        selectedSuggestionIndex={-1}
-        visibleOffset={0}
-      />
-    );
-    // golang is not in any label — appears only in suggestion panel
-    expect(getByText(/golang/)).toBeTruthy();
-    // nginx appears in suggestion panel (may also appear in label text, but it does appear)
-    const nginxEls = getAllByText(/nginx/);
-    expect(nginxEls.length).toBeGreaterThan(0);
-  });
-});

package/test/SuggestionPanel.dom.test.js

@@ -1,53 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-import React from 'react';
-import { render } from '@testing-library/react';
-import { SuggestionPanel } from '../src/components/SuggestionPanel.jsx';
-
-describe('SuggestionPanel', () => {
-  const items = ['caddy', 'elasticsearch', 'golang', 'httpd', 'kafka', 'mariadb', 'memcached', 'minio'];
-
-  test('renders nothing when items is empty', () => {
-    const { container } = render(
-      <SuggestionPanel items={[]} selectedIndex={-1} visibleOffset={0} maxVisible={5} />
-    );
-    expect(container.firstChild).toBeNull();
-  });
-
-  test('renders only maxVisible items from visibleOffset', () => {
-    const { getByText, queryByText } = render(
-      <SuggestionPanel items={items} selectedIndex={-1} visibleOffset={0} maxVisible={5} />
-    );
-    expect(getByText(/caddy/)).toBeTruthy();
-    expect(getByText(/elasticsearch/)).toBeTruthy();
-    expect(getByText(/kafka/)).toBeTruthy();
-    expect(queryByText(/mariadb/)).toBeNull();
-  });
-
-  test('respects visibleOffset by skipping early items', () => {
-    const { queryByText, getByText } = render(
-      <SuggestionPanel items={items} selectedIndex={-1} visibleOffset={2} maxVisible={3} />
-    );
-    expect(getByText(/golang/)).toBeTruthy();
-    expect(getByText(/httpd/)).toBeTruthy();
-    expect(getByText(/kafka/)).toBeTruthy();
-    expect(queryByText(/caddy/)).toBeNull();
-  });
-
-  test('focused row has › prefix marker', () => {
-    const { getByText } = render(
-      <SuggestionPanel items={items} selectedIndex={1} visibleOffset={0} maxVisible={5} />
-    );
-    const el = getByText(/› elasticsearch/);
-    expect(el).toBeTruthy();
-  });
-
-  test('non-focused rows do NOT have › prefix', () => {
-    const { getByText } = render(
-      <SuggestionPanel items={items} selectedIndex={1} visibleOffset={0} maxVisible={5} />
-    );
-    const el = getByText(/caddy/);
-    expect(el.textContent).not.toMatch(/›/);
-  });
-});

package/test/constants.test.js

@@ -1,34 +0,0 @@
-/**
- * @jest-environment node
- */
-import { IMAGE_PROFILES } from '../src/helpers/constants.js';
-
-describe('IMAGE_PROFILES', () => {
-  test('has ~20 entries', () => {
-    const count = Object.keys(IMAGE_PROFILES).length;
-    expect(count).toBeGreaterThanOrEqual(20);
-  });
-
-  test('every entry has requiredEnv (array), defaultPort (string), and suggestedEnv (array)', () => {
-    for (const [key, profile] of Object.entries(IMAGE_PROFILES)) {
-      expect(Array.isArray(profile.requiredEnv)).toBe(true);
-      expect(typeof profile.defaultPort).toBe('string');
-      expect(Array.isArray(profile.suggestedEnv)).toBe(true);
-    }
-  });
-
-  test('postgres has POSTGRES_PASSWORD in requiredEnv and suggestedEnv hints', () => {
-    expect(IMAGE_PROFILES.postgres.requiredEnv).toContain('POSTGRES_PASSWORD');
-    expect(IMAGE_PROFILES.postgres.suggestedEnv.length).toBeGreaterThan(0);
-  });
-
-  test('nginx has empty requiredEnv, defaultPort 80, and empty suggestedEnv', () => {
-    expect(IMAGE_PROFILES.nginx.requiredEnv).toEqual([]);
-    expect(IMAGE_PROFILES.nginx.defaultPort).toBe('80');
-    expect(IMAGE_PROFILES.nginx.suggestedEnv).toEqual([]);
-  });
-
-  test('node has suggestedEnv with NODE_ENV hint', () => {
-    expect(IMAGE_PROFILES.node.suggestedEnv).toContain('NODE_ENV=production');
-  });
-});