cdd-cli 4.0.0 → 4.1.0

package/src/components/StatsBar.jsx

@@ -1,70 +0,0 @@
-import React from 'react';
-import { Text } from 'ink';
-import chalk from 'chalk';
-import PropTypes from 'prop-types';
-
-const BAR_WIDTH = 8;
-
-/**
- * Small visual bar that shows CPU and memory usage percentages.
- *
- * @param {Object} props
- * @param {number} props.cpu - CPU percentage (values outside 0-100 are clamped)
- * @param {number} props.mem - Memory percentage (values outside 0-100 are clamped)
- * @returns {JSX.Element}
- */
-export default function StatsBar({ cpu, mem }) {
-  const cpuBar = makeBar(cpu, BAR_WIDTH);
-  const memBar = makeBar(mem, BAR_WIDTH);
-
-  return (
-    <Text>
-      CPU:{cpuBar}
-      {colorize(cpu, ` ${formatPercent(cpu)}%`)} MEM:{memBar}
-      {colorize(mem, ` ${formatPercent(mem)}%`)}
-    </Text>
-  );
-}
-
-StatsBar.propTypes = {
-  cpu: PropTypes.number.isRequired,
-  mem: PropTypes.number.isRequired,
-};
-
-/**
- * Build a fixed-width bar representation from a numeric percentage.
- *
- * @param {number} value - Percentage value (values outside 0-100 are clamped)
- * @param {number} width - Desired bar width in characters
- * @returns {string} Colored bar string
- */
-function makeBar(value, width) {
-  const safeWidth = Math.max(1, Math.round(width));
-  const normalized = Number.isFinite(value)
-    ? Math.min(Math.max(value, 0), 100)
-    : 0;
-  const filled = Math.round((normalized / 100) * safeWidth);
-  const empty = Math.max(0, safeWidth - filled);
-  const bar = '█'.repeat(filled) + '░'.repeat(empty);
-  return colorize(normalized, bar);
-}
-
-function formatPercent(value) {
-  if (!Number.isFinite(value)) return 0;
-  const normalized = Math.min(Math.max(value, 0), 100);
-  if (normalized >= 10) return Math.round(normalized);
-  return normalized.toFixed(1).replace(/\.0$/, '');
-}
-
-/**
- * Colorize a value or text depending on thresholds.
- *
- * @param {number} value - Numeric value used to pick color; receives clamped percentage
- * @param {string} [text] - Text to colorize, defaults to the numeric string
- * @returns {string}
- */
-function colorize(value, text = value.toString()) {
-  if (value < 50) return chalk.greenBright(text);
-  if (value < 80) return chalk.yellowBright(text);
-  return chalk.redBright(text);
-}

package/src/components/SuggestionPanel.jsx

@@ -1,61 +0,0 @@
-import React from 'react';
-import { Box, Text } from 'ink';
-import PropTypes from 'prop-types';
-
-/**
- * Renders an autocomplete suggestion panel as a boxed list below the image input.
- * Displays a window of `maxVisible` items starting at `visibleOffset`.
- * The focused row (selectedIndex) is highlighted cyan with a › prefix.
- *
- * @param {Object} props
- * @param {string[]} props.items - Full list of suggestion strings
- * @param {number} props.selectedIndex - Currently focused index (-1 = none)
- * @param {number} props.visibleOffset - First item index of the visible window
- * @param {number} [props.maxVisible=6] - Maximum number of items visible at once
- * @returns {JSX.Element|null}
- */
-export function SuggestionPanel({
-  items,
-  selectedIndex,
-  visibleOffset,
-  maxVisible = 6,
-  isLoading = false,
-}) {
-  const hasItems = items && items.length > 0;
-  if (!hasItems && !isLoading) return null;
-
-  const visible = hasItems ? items.slice(visibleOffset, visibleOffset + maxVisible) : [];
-
-  return (
-    <Box
-      flexDirection="column"
-      borderStyle="single"
-      borderColor="cyan"
-      paddingX={1}
-      data-testid="suggestion-panel"
-    >
-      {visible.map((item, localIdx) => {
-        const globalIdx = visibleOffset + localIdx;
-        const isFocused = globalIdx === selectedIndex;
-        return (
-          <Text key={item} color={isFocused ? 'cyan' : undefined} dimColor={!isFocused}>
-            {isFocused ? `› ${item}` : `  ${item}`}
-          </Text>
-        );
-      })}
-      {isLoading && (
-        <Text dimColor color="gray">
-          {'  [searching Docker Hub...]'}
-        </Text>
-      )}
-    </Box>
-  );
-}
-
-SuggestionPanel.propTypes = {
-  items: PropTypes.arrayOf(PropTypes.string).isRequired,
-  selectedIndex: PropTypes.number.isRequired,
-  visibleOffset: PropTypes.number.isRequired,
-  maxVisible: PropTypes.number,
-  isLoading: PropTypes.bool,
-};

package/src/components/UsageMenu.jsx

@@ -1,52 +0,0 @@
-import React from 'react';
-import { Box, Text } from 'ink';
-
-const SHORTCUTS = [
-  'Use ↑/↓ for navigation',
-  'I to initiate selected container',
-  'P to stop selected container',
-  'R to restart selected container',
-  'C to create a container',
-  'L to view logs of selected container',
-  'D to toggle debug log panel',
-  'E to remove selected container',
-  'Q to quit',
-];
-
-const GRID_COLUMNS = 3;
-
-/**
- * Small usage menu that explains available keybindings to the user.
- * Renders entries in a responsive grid to avoid an excessively long column.
- *
- * @returns {JSX.Element}
- */
-export default function UsageMenu() {
-  const rowsPerColumn = Math.ceil(SHORTCUTS.length / GRID_COLUMNS);
-  const columns = Array.from({ length: GRID_COLUMNS }, (_, columnIndex) =>
-    SHORTCUTS.slice(
-      columnIndex * rowsPerColumn,
-      (columnIndex + 1) * rowsPerColumn
-    )
-  ).filter((column) => column.length > 0);
-
-  return (
-    <Box flexDirection="column" marginTop={1}>
-      <Box flexDirection="row">
-        {columns.map((column, columnIndex) => (
-          <Box
-            key={`shortcut-column-${columnIndex}`}
-            flexDirection="column"
-            marginRight={columnIndex === columns.length - 1 ? 0 : 3}
-          >
-            {column.map((shortcut, rowIndex) => (
-              <Text key={`shortcut-${columnIndex}-${rowIndex}`}>
-                {shortcut}
-              </Text>
-            ))}
-          </Box>
-        ))}
-      </Box>
-    </Box>
-  );
-}

package/src/helpers/appInfo.js

@@ -1,23 +0,0 @@
-import { readFileSync } from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-let cachedVersion;
-
-export function getAppVersion() {
-  if (cachedVersion) {
-    return cachedVersion;
-  }
-
-  try {
-    const __filename = fileURLToPath(import.meta.url);
-    const moduleDir = path.dirname(__filename);
-    const packageJsonPath = path.resolve(moduleDir, '../../package.json');
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-    cachedVersion = packageJson.version ?? 'unknown';
-    return cachedVersion;
-  } catch (error) {
-    cachedVersion = 'unknown';
-    return cachedVersion;
-  }
-}

package/src/helpers/constants.js

@@ -1,89 +0,0 @@
-/**
- * Time intervals used across the app (milliseconds).
- * - CONTAINER_LIST: how often to refresh the list of containers
- * - CONTAINER_STATS: how often to fetch stats for running containers
- */
-export const REFRESH_INTERVALS = {
-  CONTAINER_LIST: 3000,
-  CONTAINER_STATS: 1500,
-};
-
-/**
- * Timeout values for UI messages before they disappear.
- */
-export const MESSAGE_TIMEOUTS = {
-  SHORT: 2000,
-  DEFAULT: 3000,
-};
-
-/**
- * Delay used before exiting the process when showing an exit message.
- */
-export const EXIT_DELAY = 500;
-
-/**
- * Operational timeouts for Docker operations and image pulls.
- */
-export const TIMEOUTS = {
-  CONTAINER_OP: 30000,
-  PULL_IMAGE: 300000,
-};
-
-/**
- * List of well-known database image names (without tags or registry prefixes).
- */
-export const DB_IMAGES = [
-  'mysql',
-  'mariadb',
-  'postgres',
-  'mongo',
-  'mssql',
-  'redis',
-];
-
-/**
- * Per-image profiles with required env vars, default exposed port, and suggested env vars.
- * Keys are normalized image names (no tag, no registry prefix).
- *
- * @type {Record<string, { requiredEnv: string[], defaultPort: string, suggestedEnv: string[] }>}
- */
-export const IMAGE_PROFILES = {
-  nginx:         { requiredEnv: [], defaultPort: '80',    suggestedEnv: [],                                                                                                                  defaultTag: '1.27-alpine' },
-  httpd:         { requiredEnv: [], defaultPort: '80',    suggestedEnv: [],                                                                                                                  defaultTag: '2.4-alpine' },
-  caddy:         { requiredEnv: [], defaultPort: '80',    suggestedEnv: [],                                                                                                                  defaultTag: '2-alpine' },
-  node:          { requiredEnv: [], defaultPort: '3000',  suggestedEnv: ['NODE_ENV=production'],                                                                                              defaultTag: '22-alpine' },
-  python:        { requiredEnv: [], defaultPort: '8000',  suggestedEnv: ['PYTHONUNBUFFERED=1'],                                                                                               defaultTag: '3.12-slim' },
-  openjdk:       { requiredEnv: [], defaultPort: '8080',  suggestedEnv: ['JAVA_OPTS=-Xms256m -Xmx512m'],                                                                                     defaultTag: '21-slim' },
-  golang:        { requiredEnv: [], defaultPort: '8080',  suggestedEnv: ['GOMAXPROCS=2'],                                                                                                     defaultTag: '1.22-alpine' },
-  redis:         { requiredEnv: [], defaultPort: '6379',  suggestedEnv: ['REDIS_PASSWORD=change-me'],                                                                                         defaultTag: '7-alpine' },
-  memcached:     { requiredEnv: [], defaultPort: '11211', suggestedEnv: [],                                                                                                                  defaultTag: '1.6-alpine' },
-  postgres:      { requiredEnv: ['POSTGRES_PASSWORD'], defaultPort: '5432', suggestedEnv: ['POSTGRES_PASSWORD=secret', 'POSTGRES_USER=postgres', 'POSTGRES_DB=app'],                        defaultTag: '17-alpine' },
-  mysql:         { requiredEnv: ['MYSQL_ROOT_PASSWORD'], defaultPort: '3306', suggestedEnv: ['MYSQL_ROOT_PASSWORD=secret', 'MYSQL_DATABASE=app', 'MYSQL_USER=app', 'MYSQL_PASSWORD=app123'], defaultTag: '8.0' },
-  mariadb:       { requiredEnv: ['MARIADB_ROOT_PASSWORD'], defaultPort: '3306', suggestedEnv: ['MARIADB_ROOT_PASSWORD=secret', 'MARIADB_DATABASE=app', 'MARIADB_USER=app', 'MARIADB_PASSWORD=app123'], defaultTag: '11-alpine' },
-  mongo:         { requiredEnv: [], defaultPort: '27017', suggestedEnv: ['MONGO_INITDB_ROOT_USERNAME=admin', 'MONGO_INITDB_ROOT_PASSWORD=secret'],                                           defaultTag: '7.0' },
-  mssql:         { requiredEnv: ['ACCEPT_EULA', 'SA_PASSWORD'], defaultPort: '1433', suggestedEnv: ['ACCEPT_EULA=Y', 'SA_PASSWORD=Strong!Passw0rd', 'MSSQL_PID=Developer'],                  defaultTag: '2022-latest' },
-  rabbitmq:      { requiredEnv: [], defaultPort: '5672',  suggestedEnv: ['RABBITMQ_DEFAULT_USER=guest', 'RABBITMQ_DEFAULT_PASS=guest'],                                                      defaultTag: '3-management-alpine' },
-  kafka:         { requiredEnv: [], defaultPort: '9092',  suggestedEnv: ['KAFKA_CFG_LISTENERS=PLAINTEXT://:9092', 'KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092'],              defaultTag: '3.7' },
-  zookeeper:     { requiredEnv: [], defaultPort: '2181',  suggestedEnv: ['ALLOW_ANONYMOUS_LOGIN=yes'],                                                                                        defaultTag: '3.9' },
-  elasticsearch: { requiredEnv: [], defaultPort: '9200',  suggestedEnv: ['discovery.type=single-node', 'xpack.security.enabled=false'],                                                      defaultTag: '8.13.0' },
-  minio:         { requiredEnv: ['MINIO_ROOT_USER', 'MINIO_ROOT_PASSWORD'], defaultPort: '9000', suggestedEnv: ['MINIO_ROOT_USER=admin', 'MINIO_ROOT_PASSWORD=secret', 'MINIO_CONSOLE_ADDRESS=:9001'], defaultTag: 'latest' },
-  wordpress:     { requiredEnv: ['WORDPRESS_DB_HOST', 'WORDPRESS_DB_USER', 'WORDPRESS_DB_PASSWORD', 'WORDPRESS_DB_NAME'], defaultPort: '8080', suggestedEnv: ['WORDPRESS_DB_HOST=db', 'WORDPRESS_DB_USER=wp', 'WORDPRESS_DB_PASSWORD=secret', 'WORDPRESS_DB_NAME=wordpress', 'WORDPRESS_TABLE_PREFIX=wp_'], defaultTag: '6.5-apache' },
-};
-
-/**
- * Given an image name (with or without tag), returns the image name with a
- * default tag appended when the image matches a known profile and has no
- * explicit tag. Returns the input unchanged otherwise.
- *
- * @param {string} imageName - e.g. 'postgres', 'postgres:15', 'unknownimage'
- * @param {Record<string, { defaultTag: string }>} profiles
- * @returns {string}
- */
-export function resolveImageTag(imageName, profiles = IMAGE_PROFILES) {
-  if (!imageName) return imageName;
-  if (imageName.includes(':')) return imageName;
-  const baseName = imageName.trim().toLowerCase().split('/').pop();
-  const profile = profiles[baseName];
-  if (!profile?.defaultTag) return imageName;
-  return `${imageName}:${profile.defaultTag}`;
-}

package/src/helpers/containerOptionsBuilder.js

@@ -1,53 +0,0 @@
-/**
- * Builds Docker container creation options from raw user inputs.
- *
- * This is a pure function — it has no side effects and calls no services.
- * It mirrors exactly the option-building logic in useControls.js onCreate callback.
- *
- * @param {object} params
- * @param {string} params.imageName          - Docker image name (e.g. "nginx:alpine")
- * @param {string} [params.containerName]    - Optional container name
- * @param {string} [params.portInput]        - Comma-separated host:container port pairs
- *                                            (e.g. "8080:80,3000:3000")
- * @param {string} [params.envInput]         - Comma-separated KEY=VALUE pairs
- *                                            (e.g. "NODE_ENV=production,PORT=3000")
- * @returns {object} Docker container options ready to pass to createContainer
- */
-export function buildContainerOptions({
-  imageName: _imageName,
-  containerName,
-  portInput,
-  envInput,
-}) {
-  const env = (envInput || '')
-    .split(',')
-    .map((s) => s.trim())
-    .filter(Boolean);
-  const ports = (portInput || '')
-    .split(',')
-    .map((s) => s.trim())
-    .filter(Boolean);
-
-  const ExposedPorts = {};
-  const PortBindings = {};
-
-  ports.forEach((pair) => {
-    const [host, cont] = pair.split(':');
-    if (!host || !cont) return;
-    const key = `${cont}/tcp`;
-    ExposedPorts[key] = {};
-    PortBindings[key] = PortBindings[key] || [];
-    PortBindings[key].push({ HostPort: `${host}` });
-  });
-
-  const options = {
-    Tty: true,
-  };
-
-  if (Object.keys(ExposedPorts).length) options.ExposedPorts = ExposedPorts;
-  if (Object.keys(PortBindings).length) options.HostConfig = { PortBindings };
-  if (env.length) options.Env = env;
-  if (containerName) options.name = containerName;
-
-  return options;
-}

package/src/helpers/dockerHubService.js

@@ -1,75 +0,0 @@
-/**
- * Docker Hub search helper.
- * Pure function — no side effects beyond HTTP. All state management
- * lives in the calling hook (useContainerCreation).
- */
-
-const DOCKER_HUB_SEARCH_URL =
-  'https://hub.docker.com/v2/search/repositories/';
-
-/**
- * Format a Docker Hub search result object into a display string.
- *
- * Format rules:
- *   - Official: "name [★ official] [Npulls+]" (if pullCount > 0)
- *   - Non-official with pulls: "name [Npulls+]"
- *   - Otherwise: "name"
- *
- * Pull count suffixes: ≥1B → "1B+", ≥1M → "1M+", ≥1K → "1K+", else raw number
- *
- * @param {{ name: string, isOfficial: boolean, pullCount: number }} result
- * @returns {string}
- */
-export function formatHubResult(result) {
-  const { name, isOfficial, pullCount } = result;
-
-  let pullSuffix = '';
-  if (pullCount >= 1e9) {
-    pullSuffix = ` [1B+ pulls]`;
-  } else if (pullCount >= 1e6) {
-    pullSuffix = ` [${Math.floor(pullCount / 1e6)}M+ pulls]`;
-  } else if (pullCount >= 1e3) {
-    pullSuffix = ` [${Math.floor(pullCount / 1e3)}K+ pulls]`;
-  } else if (pullCount > 0) {
-    pullSuffix = ` [${pullCount} pulls]`;
-  }
-
-  if (isOfficial) {
-    return `${name} [★ official]${pullSuffix}`;
-  }
-
-  return `${name}${pullSuffix}`;
-}
-
-/**
- * Search Docker Hub for images matching the given query.
- *
- * @param {string} query - Search term (will be trimmed and encoded)
- * @param {Object} [options]
- * @param {AbortSignal} [options.signal] - Abort signal; defaults to AbortSignal.timeout(5000)
- * @returns {Promise<Array<{ name: string, isOfficial: boolean, pullCount: number, description: string }>>}
- * @throws {Error} If response.ok is false or the network call rejects
- */
-export async function searchDockerHub(query, options = {}) {
-  const q = query.trim();
-  if (!q) return [];
-
-  const url = `${DOCKER_HUB_SEARCH_URL}?query=${encodeURIComponent(q)}&page_size=10`;
-  const signal = options.signal ?? AbortSignal.timeout(5000);
-
-  const response = await fetch(url, { signal });
-
-  if (!response.ok) {
-    throw new Error(`Docker Hub search failed: ${response.status}`);
-  }
-
-  const data = await response.json();
-  const results = data.results ?? [];
-
-  return results.map((item) => ({
-    name: item.repo_name,
-    isOfficial: item.is_official,
-    pullCount: item.pull_count,
-    description: item.short_description,
-  }));
-}

package/src/helpers/dockerService/dockerService.js

@@ -1,28 +0,0 @@
-import Docker from 'dockerode';
-
-// Use default dockerode configuration which automatically handles:
-// - /var/run/docker.sock on Linux/Mac
-// - //./pipe/docker_engine on Windows
-// - Environment variables DOCKER_HOST, DOCKER_CERT_PATH, etc.
-
-/**
- * Typedef for the docker client used in this project.
- * Use a generic object shape so JSDoc can render a meaningful type.
- *
- * @typedef {Object} DockerClient
- * @property {Function} listContainers
- * @property {Function} getContainer
- * @property {Function} listImages
- * @property {Function} createContainer
- * @property {Function} pull
- */
-
-/**
- * Shared Docker client instance (dockerode). Consumers import { docker }
- * and use it to list/create/start/stop containers and images.
- *
- * @type {DockerClient}
- */
-const docker = new Docker();
-
-export { docker };