cdd-cli 2.0.3 → 3.0.1

package/dist/{dockerService.js → helpers/dockerService.js}

@@ -1,59 +1,147 @@
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+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; }
 function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
-import Docker from 'dockerode';
+import Docker from "dockerode";
 var docker = new Docker({
-  socketPath: '/var/run/docker.sock'
+  socketPath: "/var/run/docker.sock"
 });
+export function getLogsStream(containerId, onData, onEnd, onError) {
+  var container = docker.getContainer(containerId);
+  container.logs({
+    follow: true,
+    stdout: true,
+    stderr: true,
+    tail: 100
+  }, function (err, stream) {
+    if (err) {
+      onError === null || onError === void 0 || onError(err);
+      return;
+    }
+    stream.on('data', function (chunk) {
+      return onData === null || onData === void 0 ? void 0 : onData(chunk.toString());
+    });
+    stream.on('end', function () {
+      return onEnd === null || onEnd === void 0 ? void 0 : onEnd();
+    });
+    stream.on('error', function (err) {
+      return onError === null || onError === void 0 ? void 0 : onError(err);
+    });
+  });
+}
+export function startContainer(_x) {
+  return _startContainer.apply(this, arguments);
+}
+function _startContainer() {
+  _startContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(containerId) {
+    var container;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          container = docker.getContainer(containerId);
+          _context.n = 1;
+          return container.start();
+        case 1:
+          return _context.a(2);
+      }
+    }, _callee);
+  }));
+  return _startContainer.apply(this, arguments);
+}
+export function stopContainer(_x2) {
+  return _stopContainer.apply(this, arguments);
+}
+function _stopContainer() {
+  _stopContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(containerId) {
+    var container;
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
+        case 0:
+          container = docker.getContainer(containerId);
+          _context2.n = 1;
+          return container.stop();
+        case 1:
+          return _context2.a(2);
+      }
+    }, _callee2);
+  }));
+  return _stopContainer.apply(this, arguments);
+}
+export function restartContainer(_x3) {
+  return _restartContainer.apply(this, arguments);
+}
+function _restartContainer() {
+  _restartContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(containerId) {
+    var container;
+    return _regenerator().w(function (_context3) {
+      while (1) switch (_context3.n) {
+        case 0:
+          container = docker.getContainer(containerId);
+          _context3.n = 1;
+          return container.restart();
+        case 1:
+          return _context3.a(2);
+      }
+    }, _callee3);
+  }));
+  return _restartContainer.apply(this, arguments);
+}
 export function getContainers() {
   return _getContainers.apply(this, arguments);
 }
 function _getContainers() {
-  _getContainers = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+  _getContainers = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
     var containers;
-    return _regenerator().w(function (_context) {
-      while (1) switch (_context.n) {
+    return _regenerator().w(function (_context4) {
+      while (1) switch (_context4.n) {
         case 0:
-          _context.n = 1;
+          _context4.n = 1;
           return docker.listContainers({
             all: true
           });
         case 1:
-          containers = _context.v;
-          return _context.a(2, containers.map(function (container) {
+          containers = _context4.v;
+          return _context4.a(2, containers.map(function (container) {
             return {
               id: container.Id,
-              name: container.Names[0].replace('/', ''),
+              name: container.Names[0].replace("/", ""),
               image: container.Image,
               state: container.State,
               status: container.Status,
-              ports: container.Ports.map(function (port) {
-                return "".concat(port.PublicPort || '', ":").concat(port.PrivatePort);
-              }).join(', ') || '-'
+              ports: _toConsumableArray(new Set(container.Ports.filter(function (port) {
+                return port.PublicPort;
+              }).map(function (port) {
+                return "".concat(port.PublicPort, ":").concat(port.PrivatePort);
+              })))
             };
           }));
       }
-    }, _callee);
+    }, _callee4);
   }));
   return _getContainers.apply(this, arguments);
 }
-export function getStats(_x) {
+export function getStats(_x4) {
   return _getStats.apply(this, arguments);
 }
 function _getStats() {
-  _getStats = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(containerId) {
+  _getStats = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(containerId) {
     var container, stream, cpuDelta, systemDelta, cpuPercent, memUsage, memLimit, memPercent, rx, tx;
-    return _regenerator().w(function (_context2) {
-      while (1) switch (_context2.n) {
+    return _regenerator().w(function (_context5) {
+      while (1) switch (_context5.n) {
         case 0:
           container = docker.getContainer(containerId);
-          _context2.n = 1;
+          _context5.n = 1;
           return container.stats({
             stream: false
           });
         case 1:
-          stream = _context2.v;
+          stream = _context5.v;
           cpuDelta = stream.cpu_stats.cpu_usage.total_usage - stream.precpu_stats.cpu_usage.total_usage;
           systemDelta = stream.cpu_stats.system_cpu_usage - stream.precpu_stats.system_cpu_usage;
           cpuPercent = systemDelta > 0 ? cpuDelta / systemDelta * 100 : 0;
@@ -70,7 +158,7 @@ function _getStats() {
           }).reduce(function (a, b) {
             return a + b;
           }, 0) : 0;
-          return _context2.a(2, {
+          return _context5.a(2, {
             cpuPercent: cpuPercent.toFixed(1),
             memPercent: memPercent.toFixed(1),
             netIO: {
@@ -79,7 +167,7 @@ function _getStats() {
             }
           });
       }
-    }, _callee2);
+    }, _callee5);
   }));
   return _getStats.apply(this, arguments);
 }

package/dist/helpers/exitWithMessage.js

@@ -0,0 +1,26 @@
+import { spawn } from "child_process";
+export function exitWithMessage(_ref) {
+  var setMessage = _ref.setMessage,
+    setMessageColor = _ref.setMessageColor,
+    _ref$message = _ref.message,
+    message = _ref$message === void 0 ? "Exiting..." : _ref$message,
+    _ref$color = _ref.color,
+    color = _ref$color === void 0 ? "yellow" : _ref$color,
+    _ref$delay = _ref.delay,
+    delay = _ref$delay === void 0 ? 1500 : _ref$delay;
+  setMessage(message);
+  setMessageColor(color);
+  setTimeout(function () {
+    setMessage("");
+    if (process.platform === "win32") {
+      spawn("cmd", ["/c", "cls"], {
+        stdio: "inherit"
+      });
+    } else {
+      spawn("clear", [], {
+        stdio: "inherit"
+      });
+    }
+    process.exit();
+  }, delay);
+}

package/dist/hooks/useContainers.js

@@ -9,7 +9,7 @@ function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length)
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
 import React, { useState, useEffect } from "react";
-import { getContainers } from "../dockerService.js";
+import { getContainers } from "../helpers/dockerService.js";
 export function useContainers() {
   var _useState = useState([]),
     _useState2 = _slicedToArray(_useState, 2),

package/dist/hooks/useControls.js

@@ -0,0 +1,142 @@
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+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; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+import React, { useState, useRef } from "react";
+import { useInput } from "ink";
+import { startContainer, stopContainer, restartContainer, getLogsStream } from "../helpers/dockerService.js";
+import { handleAction } from "../helpers/actionHelpers.js";
+import { exitWithMessage } from "../helpers/exitWithMessage.js";
+export function useControls() {
+  var containers = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    selected = _useState2[0],
+    setSelected = _useState2[1];
+  var _useState3 = useState(""),
+    _useState4 = _slicedToArray(_useState3, 2),
+    message = _useState4[0],
+    setMessage = _useState4[1];
+  var _useState5 = useState("yellow"),
+    _useState6 = _slicedToArray(_useState5, 2),
+    messageColor = _useState6[0],
+    setMessageColor = _useState6[1];
+  var _useState7 = useState(false),
+    _useState8 = _slicedToArray(_useState7, 2),
+    showLogs = _useState8[0],
+    setShowLogs = _useState8[1];
+  var _useState9 = useState([]),
+    _useState0 = _slicedToArray(_useState9, 2),
+    logs = _useState0[0],
+    setLogs = _useState0[1];
+  var logsStreamRef = useRef(null);
+  var total = containers.length;
+
+  // Handler para salir de la vista de logs
+  var exitLogs = function exitLogs() {
+    setShowLogs(false);
+    setLogs([]);
+    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);
+      logsStreamRef.current = null;
+    }
+  };
+  useInput(function (input, key) {
+    if (showLogs) {
+      if (input === "q" || key.escape) {
+        exitLogs();
+      }
+      return;
+    }
+
+    //==========================================================
+    // 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") {
+      exitWithMessage({
+        setMessage: setMessage,
+        setMessageColor: setMessageColor
+      });
+      return;
+    }
+
+    //==========================================================
+    // Docker commands
+    //==========================================================
+    if (input === "i") {
+      handleAction({
+        containers: containers,
+        selected: selected,
+        actionFn: startContainer,
+        actionLabel: "Starting",
+        setMessage: setMessage,
+        setMessageColor: setMessageColor,
+        stateCheck: function stateCheck(c) {
+          return (c.state === "running" || c.status === "running") && "Container is already running.";
+        }
+      });
+    }
+    if (input === "p") {
+      handleAction({
+        containers: containers,
+        selected: selected,
+        actionFn: stopContainer,
+        actionLabel: "Stopping",
+        setMessage: setMessage,
+        setMessageColor: setMessageColor,
+        stateCheck: function stateCheck(c) {
+          return (c.state === "exited" || c.status === "exited" || c.state === "stopped" || c.status === "stopped") && "Container is already stopped.";
+        }
+      });
+    }
+    if (input === "r") {
+      handleAction({
+        containers: containers,
+        selected: selected,
+        actionFn: restartContainer,
+        actionLabel: "Restarting",
+        setMessage: setMessage,
+        setMessageColor: setMessageColor
+      });
+    }
+    if (input === "l" && containers[selected]) {
+      setShowLogs(true);
+      setLogs([]);
+      getLogsStream(containers[selected].id, function (data) {
+        return setLogs(function (prev) {
+          return [].concat(_toConsumableArray(prev), _toConsumableArray(data.split("\n").filter(Boolean)));
+        });
+      }, function () {}, function (err) {
+        return setLogs(function (prev) {
+          return [].concat(_toConsumableArray(prev), ["Error: ".concat(err.message)]);
+        });
+      });
+    }
+  });
+  return {
+    selected: selected,
+    setSelected: setSelected,
+    message: message,
+    messageColor: messageColor,
+    showLogs: showLogs,
+    logs: logs,
+    exitLogs: exitLogs
+  };
+}

package/dist/hooks/useLogsStream.js

@@ -0,0 +1,34 @@
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+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.js";
+export function useLogsStream() {
+  var logsStreamRef = useRef(null);
+  var openLogs = useCallback(function (containerId, setLogs) {
+    setLogs([]);
+    logsStreamRef.current = getLogsStream(containerId, function (data) {
+      return setLogs(function (prev) {
+        return [].concat(_toConsumableArray(prev), _toConsumableArray(data.split("\n").filter(Boolean)));
+      });
+    }, function () {}, function (err) {
+      return setLogs(function (prev) {
+        return [].concat(_toConsumableArray(prev), ["Error: ".concat(err.message)]);
+      });
+    });
+  }, []);
+  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);
+      logsStreamRef.current = null;
+    }
+  }, []);
+  return {
+    openLogs: openLogs,
+    closeLogs: closeLogs
+  };
+}

package/dist/hooks/useStatsPolling.js

@@ -0,0 +1,54 @@
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+import React, { useEffect } from "react";
+export function useStatsPolling(_ref) {
+  var showStats = _ref.showStats,
+    selected = _ref.selected,
+    containers = _ref.containers,
+    setStats = _ref.setStats;
+  useEffect(function () {
+    var intervalId;
+    var mounted = true;
+    function fetchStats() {
+      return _fetchStats.apply(this, arguments);
+    }
+    function _fetchStats() {
+      _fetchStats = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+        var _yield$import, getStats, statsData;
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              if (!(showStats && containers[selected])) {
+                _context.n = 3;
+                break;
+              }
+              _context.n = 1;
+              return import("../helpers/dockerService.js");
+            case 1:
+              _yield$import = _context.v;
+              getStats = _yield$import.getStats;
+              _context.n = 2;
+              return getStats(containers[selected].id);
+            case 2:
+              statsData = _context.v;
+              if (mounted) setStats(statsData);
+            case 3:
+              return _context.a(2);
+          }
+        }, _callee);
+      }));
+      return _fetchStats.apply(this, arguments);
+    }
+    if (showStats && containers[selected]) {
+      setStats(null);
+      fetchStats();
+      intervalId = setInterval(fetchStats, 2000);
+    }
+    return function () {
+      mounted = false;
+      if (intervalId) clearInterval(intervalId);
+    };
+  }, [showStats, selected, containers, setStats]);
+}

package/docs/en/README.md

@@ -0,0 +1,167 @@
+# README (ENGLISH)
+*Generated: 2025-10-13*
+
+## Table of Contents
+- [Project Scope](#project-scope)
+- [Objectives & Roadmap](#objectives--roadmap)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Use Cases](#use-cases)
+- [Technical Documentation](#technical-documentation)
+- [API Reference](#api-reference)
+- [License](#license)
+- [Contributing](#contributing)
+- [Code of Conduct](#code-of-conduct)
+- [Changelog](#changelog)
+- [FAQ](#faq)
+- [Publishing & Maintenance](#publishing--maintenance)
+
+---
+
+## Project Scope
+This project is a cross-platform CLI tool for managing Docker containers with real-time log streaming and keyboard shortcuts. It is designed for developers and DevOps engineers who need fast, scriptable, and interactive container management from the terminal.
+
+**What it does:**
+- Lists, starts, stops, and removes Docker containers.
+- Streams logs in real time.
+- Provides keyboard shortcuts for common actions.
+- Offers feedback and stats in the terminal.
+
+**What it does NOT do:**
+- Does not replace Docker Compose or advanced orchestration tools.
+- Does not manage images or networks directly.
+- No GUI; terminal only.
+
+## Objectives & Roadmap
+**Short-term (3 months):**
+- Polish CLI UX and error handling.
+- Add more keyboard shortcuts.
+- Improve documentation and add more use cases.
+
+**Medium-term (6 months):**
+- Add plugin system for custom actions.
+- Support for container stats export (JSON/CSV).
+- Integration with CI/CD pipelines.
+
+**Known limitations:**
+- Requires Docker daemon running locally.
+- Only supports local containers (no remote).
+- Limited to Node.js LTS versions.
+
+## Requirements
+| Requirement         | Minimum         | Recommended      |
+|--------------------|----------------|-----------------|
+| Node.js            | 16.x           | 18.x+           |
+| npm                | 7.x            | 8.x+            |
+| OS                 | Linux, macOS, Windows | Linux, macOS |
+| Docker             | 20.x           | Latest stable   |
+| Permissions        | Docker group or sudo | Docker group |
+
+**Development:**
+- ESLint, Prettier
+- Jest or Mocha for tests
+- GitHub Actions for CI
+
+**Production:**
+- Only Node.js and Docker required
+
+## Installation
+### Global install
+```bash
+npm install -g cdd-cli
+```
+
+### Update
+```bash
+npm update -g cdd-cli
+```
+
+### Uninstall
+```bash
+npm uninstall -g cdd-cli
+```
+
+### Check version
+```bash
+cdd -v
+cdd --version
+```
+
+#### Notes
+- On Linux/macOS, you may need `sudo` for global install.
+- Ensure your global npm bin is in your PATH.
+- On Windows, use an Administrator terminal if needed.
+
+## Quick Start
+```bash
+cdd list
+cdd logs <container>
+cdd start <container>
+cdd stop <container>
+cdd remove <container>
+```
+
+## Use Cases
+1. **List all containers**
+   - `cdd list`
+   - *Shows all containers with status.*
+2. **Start a container**
+   - `cdd start my_container`
+   - *Starts the specified container.*
+3. **Stop a container**
+   - `cdd stop my_container`
+   - *Stops the specified container.*
+4. **Stream logs in real time**
+   - `cdd logs my_container`
+   - *Shows live logs with color highlighting.*
+5. **Remove a container**
+   - `cdd remove my_container`
+   - *Deletes the container after confirmation.*
+6. **Use keyboard shortcuts**
+   - While viewing logs, press `q` to quit, `r` to restart, etc.
+
+## Technical Documentation
+See inline JSDoc comments in source files. Example:
+```js
+/**
+ * Start a Docker container by name.
+ * @param {string} name - Container name
+ * @returns {Promise<boolean>} True if started
+ * @throws {Error} If Docker is not running
+ * @example
+ * await startContainer('my_container');
+ */
+```
+
+## API Reference
+See [API Reference](./api.md) for all exported functions and CLI commands.
+
+## License
+MIT License. See [LICENSE](../../LICENSE).
+
+## Contributing
+See [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Code of Conduct
+See [CODE_OF_CONDUCT.md](../../CODE_OF_CONDUCT.md).
+
+## Changelog
+See [CHANGELOG.md](../../CHANGELOG.md).
+
+## FAQ
+- **Does it work with Docker Desktop?**
+  - Yes, as long as Docker CLI is available.
+- **Can I use it in CI?**
+  - Yes, see examples below.
+- **How do I add my own commands?**
+  - Plugin system coming soon.
+
+## Publishing & Maintenance
+To publish to npm:
+```bash
+npm login
+npm publish --access public
+```
+
+Keep documentation updated with every release. See CONTRIBUTING.md for details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdd-cli",
-  "version": "2.0.3",
+  "version": "3.0.1",
   "description": "CLI Docker Dashboard",
   "main": "index.js",
   "scripts": {