cdd-cli 3.2.2 → 4.1.0

package/CHANGELOG.md

@@ -1,165 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
-
-## [Unreleased]
-- Nothing yet.
-
-## [3.2.2] - 2026-04-27
-
-### Added
-
-- Interactive suggestion panel in container creation wizard (step 0) — shows filtered image suggestions below the input as the user types, navigable with ↑↓ and selectable with Enter
-- `IMAGE_PROFILES` expanded from 6 to 20 curated images (nginx, node, python, postgres, mysql, mongo, redis, kafka, elasticsearch, minio, wordpress, and more) each with `requiredEnv`, `defaultPort`, and `suggestedEnv`
-- `SuggestionPanel` component (`src/components/SuggestionPanel.jsx`) — offline, non-overlay panel with scrollable window and focused-row highlight
-- Contextual env var hints in step 3 — when a known image is selected, suggested variables (e.g. `POSTGRES_USER`, `POSTGRES_DB`) are shown as guidance
-- `updateImageInput()`, `moveSuggestionSelection()`, `applyFocusedSuggestion()` functions in `useContainerCreation` hook for autocomplete state management
-- Ink mock infrastructure (`__mocks__/ink.cjs`) with `triggerInput` helper for reliable keyboard routing tests
-
-### Changed
-
-- `useControls.js` keyboard routing — ↑↓ and Enter are conditionally intercepted for suggestion navigation only on step 0 when suggestions are visible; all other steps preserve existing behavior
-- `ContainerCreationPrompt.jsx` — renders `SuggestionPanel` below the image input field on step 0
-
-## [3.2.1] - 2026-04-27
-
-### Changed
-
-- Unified `normalizeImageName` into a single `src/helpers/imageNameUtils.js` module; removed duplicate definitions from `validationHelpers.js` and `containerActions.js`.
-- Added Prettier and EditorConfig for automatic code formatting enforcement; 37 source files reformatted to consistent style (single quotes, 2-space indent, trailing commas ES5).
-- Added `eslint-config-prettier` to disable ESLint rules that conflict with Prettier.
-- Added `format` and `format:check` npm scripts.
-
-### Fixed
-
-- Missing `.jsx` extension on `import App from './App'` in `src/index.js` (ESM correctness).
-
-## [3.2.0] - 2026-04-25
-
-### Added
-
-- `IMAGE_PROFILES` map in `src/helpers/constants.js` — defines `requiredEnv` and `defaultPort` per image type (mysql, mariadb, postgres, mongo, mssql, redis).
-- `DB_IMAGES` constant exported from `src/helpers/constants.js`.
-- Contextual validation in wizard: if image matches a known profile, required env vars are enforced before creation.
-- Auto-assigned port feedback: after successful container creation, the success message shows which ports were mapped (e.g. `Ports: 3306→3306/tcp`).
-- Image name normalization: tags and registry prefixes are stripped before profile lookup (`mysql:8`, `docker.io/library/postgres:16` → `mysql`, `postgres`).
-- New test files: `test/containerOptionsBuilder.test.js`, `test/useControls.dom.test.js`.
-
-### Fixed
-
-- `validateEnvVars()` was never called in the container creation wizard step 3 — now connected and blocks on invalid input.
-- Env var parsing split on all `=` characters — fixed to split only on the first `=`, preserving values like `JWT=abc=def`.
-- `dbImages` was hardcoded in `useControls.js` — now imports `DB_IMAGES` from constants.
-
-## [3.1.9] - 2026-04-11
-
-### Changed
-
-- CI: added lint step to the test-and-build job; docs deploy now waits for CI to pass successfully via `workflow_run` trigger.
-
-## [3.1.8] - 2026-04-11
-
-### Refactored
-
-- Removed dead code: `actionHelpers`, `useLogsStream`, and esbuild-related artifacts that were no longer in use.
-- Consolidated Babel configuration into a single env-aware file, eliminating duplicate/split config files.
-- Decomposed `useControls` god hook into focused single-responsibility hooks, each owning one concern.
-- Extracted `useContainerStats` hook from `ContainerRow` to separate data-fetching from rendering.
-- Set Jest default environment to `node`; `jsdom` is now opt-in per test file, reducing unnecessary DOM overhead.
-
-### Changed
-
-- Removed generated JSDoc output from the repository; added the generated docs directory to `.gitignore`.
-- Enabled `react/prop-types` ESLint rule project-wide and resolved all resulting warnings.
-- Rewrote `README.md` and `CONTRIBUTING.md`: consolidated overlapping content, removed duplication, and updated both for accuracy.
-- Various `docs(style)` and `docs` commits between v3.1.5 and the refactor wave: dark theme, sticky nav, landing page rewrite, CSS consolidation, and English translation for the JSDoc home (GitHub Pages site).
-
-## [3.1.5] - 2025-10-18
-_Note: I'm sorry about the issues you've run into; this is a brand-new app and I'm still learning, but I'm moving as quickly as I can to deliver a quality experience._
-
-### Added
-
-- `safeCall` utility to safely invoke optional callbacks and avoid uncaught errors from consumer callbacks.
-- PropTypes added to core React components for runtime prop validation (ContainerRow, ContainerList, LogViewer, StatsBar, ContainerCreationPrompt, PromptField, MessageFeedback, Header, ContainerSection).
-
-### Changed
-
-- Container creation now inspects image `EXPOSE` declarations and auto-binds ports when the user leaves the ports step empty, reusing the next free host port to avoid conflicts (e.g. second `nginx` gets `81:80`).
-- CLI clears the terminal when starting and again after exiting with `q` for a cleaner shell experience.
-- Replaced direct optional callback invocations and stream destruction calls with `safeCall` in several modules (`containerLogs`, `useLogsStream`, `useLogsViewer`, `useContainerCreation`, `useContainerActions`, `LogViewer`).
-- ESLint config updated to include `jest` env and allow keeping `import React` for build compatibility.
-- Extracted common magic numbers into `src/helpers/constants.js` and replaced hardcoded values across the codebase:
-	- `REFRESH_INTERVALS.CONTAINER_LIST` (3000)
-	- `REFRESH_INTERVALS.CONTAINER_STATS` (1500)
-	- `MESSAGE_TIMEOUTS.SHORT` (2000) and `MESSAGE_TIMEOUTS.DEFAULT` (3000)
-	- `EXIT_DELAY` (500)
-	- `TIMEOUTS.CONTAINER_OP` (30000) and `TIMEOUTS.PULL_IMAGE` (300000)
-- Files updated to use constants: `useContainers`, `ContainerRow`, `actionHelpers`, `useControls`, `exitWithMessage`, `containerActions`.
-
-### Fixed
-
-- Added unit tests for `safeCall` and adjusted several components to silence lint warnings (unused variables).
-- Clamp `StatsBar` CPU/memory percentages to avoid negative repeat errors when streaming container stats (also refreshed component JSDoc to note the clamping).
-
-### Testing
-
-- Added additional unit tests for Docker service functions and hooks. All tests pass locally (5 suites, 26 tests).
-- Removed generated `dist/` artifacts and deleted obsolete test files that referenced incompatible test helpers.
-
-Incoming fixes and smaller tests / docs updates
-
-## [3.1.4] - 2025-10-17
-
-### Changed
-
-- Documentation cleanup: translate `FIXES_APPLIED.md` to English, remove Spanish duplicate and references to internal audit doc.
-- No functional code changes.
-
-## [3.1.3] - 2025-10-17
-
-### Fixed
-
-- Addressed critical security and stability issues identified in internal audit.
-- Improved Docker service components robustness (`containerActions`, `containerList`, `containerLogs`, `containerStats`).
-- Strengthened validation helpers and extended unit tests.
-
-### Added
-
-- Documentation: `FIXES_APPLIED.md` summarizing analysis and mitigations.
-
-### Changed
-
-- Minor code refactors and clarifications across components and hooks.
-
-## [3.1.2] - 2025-10-16
-
-### Changed
-
-- Docs cleanup: remove Spanish inline comments; add English JSDoc across source files.
-
-## [3.1.0] - 2025-10-16
-
-### Added
-
-- Modularized hooks: `useContainerCreation`, `useContainerActions`, `useLogsViewer`.
-- Validation helpers and unit tests for port validation.
-- CI workflow (GitHub Actions) and README improvements.
-
-### Changed
-
-- Container creation UX: English feedback messages, mandatory/validated port input, DB image warnings.
-- Added erase action (key `E`) with confirmation to delete containers.
-- Normalized source imports to include explicit `.js`/`.jsx` extensions for ESM compatibility.
-
-### Fixed
-
-- Various runtime & build issues after modularization (import fixes, exposing container action functions, creation flow wiring).
-
-## [3.1.1] - 2025-10-16
-
-### Fixed
-
-- Minor docs typo fixes and README global install note added.
-

package/CODE_OF_CONDUCT.md

@@ -1,12 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-This project follows the Contributor Covenant Code of Conduct. By participating, you agree to abide by its terms.
-
-Please see https://www.contributor-covenant.org/ for the full text.
-## Code of Conduct
-
-This project follows the [Contributor Covenant](https://www.contributor-covenant.org/).
-
-Be respectful, inclusive, and kind. Harassment, discrimination, or abusive language will not be tolerated.
-
-If you experience or witness unacceptable behavior, please contact the maintainers.

package/CONTRIBUTING.md

@@ -1,35 +0,0 @@
-# Contributing to CDD-CLI
-
-Thanks for your interest in contributing! Here are the guidelines to make collaboration smooth.
-
-## Getting started
-
-1. Fork the repo and create a branch for your feature or fix:
-
-```bash
-git checkout -b feat/my-feature
-```
-
-2. Install dependencies and verify everything works before making changes:
-
-```bash
-npm install
-npm test
-npm run build
-```
-
-## Guidelines
-
-- Keep changes small and focused — one concern per PR.
-- Write tests for any new behavior and ensure existing tests pass (`npm test`).
-- Run `npm run build` and verify the CLI starts (`node dist/index.js`) before opening a PR.
-- Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.
-- For large or design-changing contributions, open an issue first to discuss the approach.
-
-## Opening a Pull Request
-
-- Describe the motivation and what changed.
-- Link any related issues.
-- Tag reviewers if applicable.
-
-We appreciate clear, well-tested contributions.

package/SECURITY.md

@@ -1,5 +0,0 @@
-# Security
-
-If you discover a security vulnerability, please report it privately to the repository owner.
-
-Do not disclose vulnerabilities publicly until they are resolved.

package/__mocks__/ink.cjs

@@ -1,17 +0,0 @@
-const React = require('react');
-exports.Box = ({ children, ...props }) =>
-  React.createElement('div', { ...props }, children);
-exports.Text = ({ children, color }) =>
-  React.createElement('span', { 'data-color': color }, children);
-
-// Capture the last registered useInput handler so tests can simulate keypresses.
-let _inputHandler = null;
-exports.useInput = (fn) => { _inputHandler = fn; };
-/** Simulate a keypress through the last registered useInput handler. */
-exports.__triggerInput = (input, key = {}) => {
-  if (_inputHandler) _inputHandler(input, key);
-};
-/** Reset captured handler between tests. */
-exports.__resetInput = () => { _inputHandler = null; };
-
-exports.useApp = () => ({ exit: () => {} });

package/_config.yml

@@ -1,13 +0,0 @@
-# Configure GitHub Pages to treat the generated docs as a static site.
-source: docs
-# Disable the default theme so Jekyll does not expect its SCSS assets.
-theme: null
-
-# Allow Jekyll to copy across these asset folders untouched.
-include:
-  - fonts
-  - scripts
-  - styles
-
-# We do not rely on any Jekyll plugins for this site.
-plugins: []

package/babel.config.cjs

@@ -1,23 +0,0 @@
-module.exports = {
-  env: {
-    test: {
-      // Jest necesita CJS (transpila módulos) + React
-      presets: [
-        ['@babel/preset-env', { targets: { node: 'current' } }],
-        '@babel/preset-react'
-      ]
-    },
-    // build (NODE_ENV != 'test') → mantiene ESM para el output final
-    production: {
-      presets: [
-        ['@babel/preset-env', { modules: false }],
-        '@babel/preset-react'
-      ]
-    }
-  },
-  // Fallback para cualquier otro entorno (desarrollo local, etc.)
-  presets: [
-    ['@babel/preset-env', { modules: false }],
-    '@babel/preset-react'
-  ]
-};