cdd-cli 3.1.4 → 3.1.6

package/dist/hooks/useControls.js

@@ -16,9 +16,11 @@ import React from "react";
 import { useContainerActions } from "./creation/useContainerActions.js";
 import { useContainerCreation } from "./creation/useContainerCreation.js";
 import { useLogsViewer } from "./creation/useLogsViewer.js";
-import { useInput } from "ink";
+import { useInput, useApp } from "ink";
 import { getLogsStream } from "../helpers/dockerService/serviceComponents/containerLogs.js";
+import { EXIT_DELAY } from "../helpers/constants.js";
 import { createContainer as svcCreateContainer } from "../helpers/dockerService/serviceComponents/containerActions.js";
+import { logger } from "../helpers/logger.js";
 
 // Principal hook to manage user inputs and control the app state
 /**
@@ -43,6 +45,9 @@ import { createContainer as svcCreateContainer } from "../helpers/dockerService/
  * @property {Object} creation - The creation hook API (setters and helpers)
  * @property {Object} actions - The actions hook API (helpers to start/stop/remove)
  * @property {Object} logsViewer - The logs viewer hook API
+ * @property {boolean} showDebugLogs - Whether the debug log panel is visible
+ * @property {Array<string>} debugLogs - Buffered log lines captured from the shared logger
+ * @property {boolean} confirmErase - Whether the erase confirmation dialog is active
  */
 export function useControls() {
   var containers = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
@@ -58,7 +63,17 @@ export function useControls() {
     _React$useState6 = _slicedToArray(_React$useState5, 2),
     confirmErase = _React$useState6[0],
     setConfirmErase = _React$useState6[1];
+  var _React$useState7 = React.useState(false),
+    _React$useState8 = _slicedToArray(_React$useState7, 2),
+    showDebugLogs = _React$useState8[0],
+    setShowDebugLogs = _React$useState8[1];
+  var _React$useState9 = React.useState([]),
+    _React$useState0 = _slicedToArray(_React$useState9, 2),
+    debugLogs = _React$useState0[0],
+    setDebugLogs = _React$useState0[1];
   var total = containers.length;
+  var _useApp = useApp(),
+    exit = _useApp.exit;
 
   // Modular hooks
   var actions = useContainerActions({
@@ -142,120 +157,174 @@ export function useControls() {
 
   // Handler to exit logs (delegated to logsViewer)
   var exitLogs = logsViewer.closeLogs;
-  useInput(function (input, key) {
-    // Erase confirmation
-    if (confirmErase) {
-      if (input === "y" || input === "Y") {
-        actions.handleAction({
-          actionFn: function () {
-            var _actionFn = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(id) {
-              return _regenerator().w(function (_context2) {
-                while (1) switch (_context2.n) {
-                  case 0:
-                    _context2.n = 1;
-                    return actions.removeContainer(id);
-                  case 1:
-                    return _context2.a(2, _context2.v);
-                }
-              }, _callee2);
-            }));
-            function actionFn(_x2) {
-              return _actionFn.apply(this, arguments);
-            }
-            return actionFn;
-          }(),
-          actionLabel: "Erasing",
-          selected: selected
-        });
-        setConfirmErase(false);
-        actions.setMessageColor("yellow");
-        return;
-      } else if (input === "n" || input === "N" || key.escape) {
-        setConfirmErase(false);
-        actions.setMessage("");
-        actions.setMessageColor("");
-        return;
-      } else {
-        actions.setMessage("Are you sure you want to erase this container? (y/n)");
-        actions.setMessageColor("yellow");
-        return;
-      }
-    }
 
-    // Logs viewer
-    if (logsViewer.showLogs) {
-      if (input === "q" || key.escape) {
-        logsViewer.closeLogs();
-      }
+  /**
+   * Pipe container logs into the viewer while applying a hard limit.
+   * @param {string} containerId - Container identifier used by Docker.
+   */
+  var startLogsStream = React.useCallback(function (containerId) {
+    getLogsStream(containerId, function (data) {
+      return logsViewer.setLogs(function (prev) {
+        var newLogs = [].concat(_toConsumableArray(prev), _toConsumableArray(data.split("\n").filter(Boolean)));
+        return newLogs.slice(-1000);
+      });
+    }, function () {}, function (err) {
+      return logsViewer.setLogs(function (prev) {
+        return [].concat(_toConsumableArray(prev), ["Error: ".concat(err.message)]);
+      });
+    });
+  }, [logsViewer]);
+
+  /**
+   * Manage the erase confirmation short-circuit flow.
+   */
+  var processEraseConfirmation = React.useCallback(function (input, key) {
+    if (input === "y" || input === "Y") {
+      actions.handleAction({
+        actionFn: function () {
+          var _actionFn = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(id) {
+            return _regenerator().w(function (_context2) {
+              while (1) switch (_context2.n) {
+                case 0:
+                  _context2.n = 1;
+                  return actions.removeContainer(id);
+                case 1:
+                  return _context2.a(2, _context2.v);
+              }
+            }, _callee2);
+          }));
+          function actionFn(_x2) {
+            return _actionFn.apply(this, arguments);
+          }
+          return actionFn;
+        }(),
+        actionLabel: "Erasing",
+        selected: selected
+      });
+      setConfirmErase(false);
+      actions.setMessageColor("yellow");
       return;
     }
-
-    // Container creation flow: delegate input to creation hook
-    if (creatingContainer) {
-      var step = creation.step;
-      var appendCharToField = function appendCharToField(setter, value, ch) {
-        setter((value || "") + ch);
-      };
-      // Escape -> cancel
-      if (key.escape) {
-        creation.cancelCreation();
-        setCreatingContainer(false);
-        return;
-      }
-      // Enter -> next step
-      if (input === "\r" || input === "\n") {
-        creation.nextStep();
-        return;
-      }
-      // Backspace/Delete support
-      if (key.backspace || key["delete"]) {
-        if (step === 0) creation.setImageName(function (v) {
-          return (v || "").slice(0, -1);
-        });
-        if (step === 1) creation.setContainerName(function (v) {
-          return (v || "").slice(0, -1);
-        });
-        if (step === 2) creation.setPortInput(function (v) {
-          return (v || "").slice(0, -1);
-        });
-        if (step === 3) creation.setEnvInput(function (v) {
-          return (v || "").slice(0, -1);
-        });
-        return;
-      }
-      // Printable character input (append)
-      if (input && input.length === 1 && !key.ctrl && !key.meta) {
-        if (step === 0) appendCharToField(creation.setImageName, creation.imageName, input);
-        if (step === 1) appendCharToField(creation.setContainerName, creation.containerName, input);
-        if (step === 2) appendCharToField(creation.setPortInput, creation.portInput, input);
-        if (step === 3) appendCharToField(creation.setEnvInput, creation.envInput, input);
-        return;
-      }
-      // Otherwise ignore
+    if (input === "n" || input === "N" || key.escape) {
+      setConfirmErase(false);
+      actions.setMessage("");
+      actions.setMessageColor("");
       return;
     }
+    actions.setMessage("Are you sure you want to erase this container? (y/n)");
+    actions.setMessageColor("yellow");
+  }, [actions, selected]);
 
-    //==========================================================
-    // Menu Navigation
-    //==========================================================
-    if (key.upArrow && total > 0) setSelected(function (i) {
-      return i === 0 ? total - 1 : i - 1;
-    });
-    if (key.downArrow && total > 0) setSelected(function (i) {
-      return i === total - 1 ? 0 : i + 1;
-    });
-    if (input === "q") {
-      actions.setMessage("Exiting...");
-      actions.setMessageColor("yellow");
-      setTimeout(function () {
-        return process.exit(0);
-      }, 500);
+  /**
+   * Handle inputs while the logs viewer is active.
+   */
+  var processLogsInput = React.useCallback(function (input, key) {
+    if (input === "q" || key.escape) {
+      logsViewer.closeLogs();
+    }
+  }, [logsViewer]);
+
+  /**
+   * Route keystrokes to the container creation wizard.
+   */
+  var processCreationInput = React.useCallback(function (input, key) {
+    var step = creation.step;
+    var removeLastChar = function removeLastChar(setter) {
+      return setter(function (value) {
+        return (value || "").slice(0, -1);
+      });
+    };
+    var appendChar = function appendChar(setter, current, ch) {
+      return setter((current || "") + ch);
+    };
+    if (key.escape) {
+      creation.cancelCreation();
+      setCreatingContainer(false);
       return;
     }
+    if (input === "\r" || input === "\n") {
+      creation.nextStep();
+      return;
+    }
+    if (key.backspace || key["delete"]) {
+      if (step === 0) removeLastChar(creation.setImageName);
+      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) appendChar(creation.setImageName, 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]);
 
-    //==========================================================
-    // Docker commands
-    //==========================================================
+  /**
+   * Navigate the container list using arrow keys.
+   * @returns {boolean} True when the input was consumed.
+   */
+  var handleNavigation = React.useCallback(function (input, key) {
+    if (total === 0) {
+      return false;
+    }
+    if (key.upArrow) {
+      setSelected(function (i) {
+        return i === 0 ? total - 1 : i - 1;
+      });
+      return true;
+    }
+    if (key.downArrow) {
+      setSelected(function (i) {
+        return i === total - 1 ? 0 : i + 1;
+      });
+      return true;
+    }
+    return false;
+  }, [total]);
+
+  /**
+   * Handle the quit command.
+   * @returns {boolean} True when the input was consumed.
+   */
+  var handleExitCommand = React.useCallback(function (input) {
+    if (input !== "q") {
+      return false;
+    }
+    actions.setMessage("Exiting...");
+    actions.setMessageColor("yellow");
+    logsViewer.closeLogs();
+    setShowDebugLogs(false);
+    var clearTerminal = function clearTerminal() {
+      try {
+        if (process.stdout && process.stdout.isTTY) {
+          process.stdout.write("\x1Bc");
+        } else {
+          console.clear();
+        }
+      } catch (err) {
+        // Ignore clear errors to avoid blocking exit.
+      }
+    };
+    setTimeout(function () {
+      clearTerminal();
+      exit();
+      if (process.env.NODE_ENV !== "test") {
+        setTimeout(function () {
+          return process.exit(0);
+        }, 50);
+      }
+    }, EXIT_DELAY);
+    return true;
+  }, [actions, exit, logsViewer]);
+
+  /**
+   * Execute Docker-related commands and prompt transitions.
+   * @returns {boolean} True when the input was consumed.
+   */
+  var handleDockerCommands = React.useCallback(function (input) {
+    var container = containers[selected];
     if (input === "i") {
       actions.handleAction({
         actionFn: function () {
@@ -281,6 +350,7 @@ export function useControls() {
           return (c.state === "running" || c.status === "running") && "Container is already running.";
         }
       });
+      return true;
     }
     if (input === "p") {
       actions.handleAction({
@@ -307,6 +377,7 @@ export function useControls() {
           return (c.state === "exited" || c.status === "exited" || c.state === "stopped" || c.status === "stopped") && "Container is already stopped.";
         }
       });
+      return true;
     }
     if (input === "r") {
       actions.handleAction({
@@ -330,27 +401,24 @@ export function useControls() {
         actionLabel: "Restarting",
         selected: selected
       });
+      return true;
     }
-    if (input === "e" && containers[selected]) {
+    if (input === "e") {
+      if (!container) {
+        return true;
+      }
       setConfirmErase(true);
       actions.setMessage("Are you sure you want to erase this container? (y/n)");
       actions.setMessageColor("yellow");
-      return;
+      return true;
     }
-    if (input === "l" && containers[selected]) {
+    if (input === "l") {
+      if (!container) {
+        return true;
+      }
       logsViewer.openLogs();
-      getLogsStream(containers[selected].id, function (data) {
-        return logsViewer.setLogs(function (prev) {
-          var newLogs = [].concat(_toConsumableArray(prev), _toConsumableArray(data.split("\n").filter(Boolean)));
-          // Limit to last 1000 lines to prevent memory leak
-          return newLogs.slice(-1000);
-        });
-      }, function () {}, function (err) {
-        return logsViewer.setLogs(function (prev) {
-          return [].concat(_toConsumableArray(prev), ["Error: ".concat(err.message)]);
-        });
-      });
-      return;
+      startLogsStream(container.id);
+      return true;
     }
     if (input === "c") {
       setCreatingContainer(true);
@@ -361,8 +429,69 @@ export function useControls() {
       creation.setEnvInput("");
       creation.setMessage("Insert the name of the image to create: ");
       creation.setMessageColor("yellow");
+      return true;
+    }
+    if (input === "d") {
+      setShowDebugLogs(function (prev) {
+        return !prev;
+      });
+      return true;
     }
+    return false;
+  }, [actions, containers, creation, logsViewer, selected, setConfirmErase, setCreatingContainer, startLogsStream, setShowDebugLogs]);
+
+  /**
+   * Default handler executed when no special mode is active.
+   */
+  var processGlobalInput = React.useCallback(function (input, key) {
+    if (handleNavigation(input, key)) {
+      return;
+    }
+    if (handleExitCommand(input)) {
+      return;
+    }
+    handleDockerCommands(input);
+  }, [handleDockerCommands, handleExitCommand, handleNavigation]);
+  useInput(function (input, key) {
+    if (confirmErase) {
+      processEraseConfirmation(input, key);
+      return;
+    }
+    if (logsViewer.showLogs) {
+      processLogsInput(input, key);
+      return;
+    }
+    if (creatingContainer) {
+      processCreationInput(input, key);
+      return;
+    }
+    if (showDebugLogs && key.escape) {
+      setShowDebugLogs(false);
+      return;
+    }
+    processGlobalInput(input, key);
   });
+
+  // Mirror global logger entries so the D shortcut can surface them without leaving the CLI.
+  React.useEffect(function () {
+    var unsubscribe = logger.subscribe(function (entry) {
+      setDebugLogs(function (prev) {
+        var extras = (entry.args || []).map(function (arg) {
+          if (typeof arg === "string") return arg;
+          if (typeof arg === "number" || typeof arg === "boolean") return String(arg);
+          try {
+            return JSON.stringify(arg);
+          } catch (err) {
+            return "[unserializable]";
+          }
+        }).filter(Boolean);
+        var line = extras.length ? "".concat(entry.formatted, " ").concat(extras.join(" ")) : entry.formatted;
+        var next = [].concat(_toConsumableArray(prev), [line]);
+        return next.slice(-200);
+      });
+    });
+    return unsubscribe;
+  }, []);
   return {
     selected: selected,
     setSelected: setSelected,
@@ -382,6 +511,8 @@ export function useControls() {
     creation: creation,
     actions: actions,
     logsViewer: logsViewer,
-    confirmErase: confirmErase
+    confirmErase: confirmErase,
+    showDebugLogs: showDebugLogs,
+    debugLogs: debugLogs
   };
 }

package/dist/hooks/useLogsStream.js

@@ -6,6 +6,7 @@ function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 import React, { useRef, useCallback } from "react";
 import { getLogsStream } from "../helpers/dockerService/serviceComponents/containerLogs.js";
+import { safeCall } from "../helpers/safeCall.js";
 
 /**
  * Hook that manages opening and closing a logs stream for a container.
@@ -28,8 +29,8 @@ export function useLogsStream() {
   }, []);
   var closeLogs = useCallback(function () {
     if (logsStreamRef.current) {
-      var _logsStreamRef$curren, _logsStreamRef$curren2;
-      (_logsStreamRef$curren = (_logsStreamRef$curren2 = logsStreamRef.current).destroy) === null || _logsStreamRef$curren === void 0 || _logsStreamRef$curren.call(_logsStreamRef$curren2);
+      var _logsStreamRef$curren;
+      safeCall((_logsStreamRef$curren = logsStreamRef.current.destroy) === null || _logsStreamRef$curren === void 0 ? void 0 : _logsStreamRef$curren.bind(logsStreamRef.current));
       logsStreamRef.current = null;
     }
   }, []);

package/dist/index.js

@@ -10,4 +10,5 @@
 import React from "react";
 import { render } from "ink";
 import App from './App.js';
+console.clear();
 render(/*#__PURE__*/React.createElement(App, null));

package/docs/_config.yml

@@ -0,0 +1,13 @@
+title: CDD Documentation
+# Disable the default GitHub Pages theme so Jekyll just copies our static output
+# (the static HTML is generated by JSDoc and already styled).
+theme: null
+
+# Explicitly include asset folders that Jekyll might otherwise ignore.
+include:
+  - fonts
+  - scripts
+  - styles
+
+# No Jekyll plugins are required for this pre-rendered site.
+plugins: []

package/docs/components_ContainerCreationPrompt.jsx.html

@@ -0,0 +1,114 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>JSDoc: Source: components/ContainerCreationPrompt.jsx</title>
+
+    <script src="scripts/prettify/prettify.js"> </script>
+    <script src="scripts/prettify/lang-css.js"> </script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+
+<body>
+
+<div id="main">
+
+    <h1 class="page-title">Source: components/ContainerCreationPrompt.jsx</h1>
+
+    
+
+
+
+    
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>import React from "react";
+import { Box, Text } from "ink";
+import { PromptField, PromptMessage } from "./PromptField.jsx";
+import PropTypes from 'prop-types';
+
+/**
+ * Prompt UI shown when creating a new container.
+ * Presents a step-by-step form (image, name, ports, env) and displays
+ * a contextual message provided by the creation hook.
+ *
+ * @param {Object} props
+ * @param {number} props.step - Current step index (0..3)
+ * @param {string} props.imageName - Value for the image name field
+ * @param {string} props.containerName - Value for the container name field
+ * @param {string} props.portInput - Value for the ports input field
+ * @param {string} props.envInput - Value for the environment variables field
+ * @param {string} props.message - Contextual message to display (errors/hints)
+ * @param {string} props.messageColor - Color for the contextual message
+ * @returns {JSX.Element}
+ */
+export default function ContainerCreationPrompt(props) {
+  const { step, imageName, containerName, portInput, envInput, message, messageColor } = props;
+  const prompts = [
+    {
+      label: "Name of the image to create (e.g., nginx:latest):",
+      value: imageName,
+      required: true,
+    },
+    {
+      label: "Name of the container (optional):",
+      value: containerName,
+      required: false,
+    },
+    {
+      label: "Ports (optional, format 8080:80,443:443):",
+      value: portInput,
+      required: false,
+    },
+    {
+      label: "Environment variables (optional, format VAR1=val1,VAR2=val2):",
+      value: envInput,
+      required: false,
+    },
+  ];
+  const { label, value, required } = prompts[step] || {};
+  return (
+    &lt;Box flexDirection="column" borderStyle="round" borderColor="yellow" padding={1}>
+      &lt;PromptField label={label} value={value} required={required} />
+      &lt;PromptMessage message={message} color={messageColor} />
+      &lt;Text dimColor>Press Enter to continue, Escape to cancel&lt;/Text>
+    &lt;/Box>
+  );
+}
+
+ContainerCreationPrompt.propTypes = {
+  step: PropTypes.number.isRequired,
+  imageName: PropTypes.string,
+  containerName: PropTypes.string,
+  portInput: PropTypes.string,
+  envInput: PropTypes.string,
+  message: PropTypes.string,
+  messageColor: PropTypes.string,
+};
+</code></pre>
+        </article>
+    </section>
+
+
+
+
+</div>
+
+<nav>
+    <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-index.html">index</a></li></ul><h3>Global</h3><ul><li><a href="global.html#EXIT_DELAY">EXIT_DELAY</a></li><li><a href="global.html#MESSAGE_TIMEOUTS">MESSAGE_TIMEOUTS</a></li><li><a href="global.html#PromptField">PromptField</a></li><li><a href="global.html#PromptMessage">PromptMessage</a></li><li><a href="global.html#REFRESH_INTERVALS">REFRESH_INTERVALS</a></li><li><a href="global.html#TIMEOUTS">TIMEOUTS</a></li><li><a href="global.html#colorize">colorize</a></li><li><a href="global.html#createContainer">createContainer</a></li><li><a href="global.html#docker">docker</a></li><li><a href="global.html#exitWithMessage">exitWithMessage</a></li><li><a href="global.html#getContainers">getContainers</a></li><li><a href="global.html#getLogsStream">getLogsStream</a></li><li><a href="global.html#getStats">getStats</a></li><li><a href="global.html#handleAction">handleAction</a></li><li><a href="global.html#imageExists">imageExists</a></li><li><a href="global.html#makeBar">makeBar</a></li><li><a href="global.html#pullImage">pullImage</a></li><li><a href="global.html#removeContainer">removeContainer</a></li><li><a href="global.html#restartContainer">restartContainer</a></li><li><a href="global.html#safeCall">safeCall</a></li><li><a href="global.html#startContainer">startContainer</a></li><li><a href="global.html#stopContainer">stopContainer</a></li><li><a href="global.html#useContainerActions">useContainerActions</a></li><li><a href="global.html#useContainerCreation">useContainerCreation</a></li><li><a href="global.html#useControls">useControls</a></li><li><a href="global.html#useLogsStream">useLogsStream</a></li><li><a href="global.html#useLogsViewer">useLogsViewer</a></li><li><a href="global.html#validateEnvVars">validateEnvVars</a></li><li><a href="global.html#validatePorts">validatePorts</a></li><li><a href="global.html#withTimeout">withTimeout</a></li></ul>
+</nav>
+
+<br class="clear">
+
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.5</a> on Fri Oct 17 2025 16:07:18 GMT-0500 (hora estándar de Colombia)
+</footer>
+
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>