cdd-cli 3.0.0 → 3.1.0

package/dist/helpers/dockerService/serviceComponents/imageUtils.js

@@ -0,0 +1,52 @@
+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 "../dockerService.js";
+export function imageExists(_x) {
+  return _imageExists.apply(this, arguments);
+}
+function _imageExists() {
+  _imageExists = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(imageName) {
+    var images;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          _context.n = 1;
+          return docker.listImages();
+        case 1:
+          images = _context.v;
+          return _context.a(2, images.some(function (img) {
+            return (img.RepoTags || []).includes(imageName) || (img.RepoDigests || []).some(function (d) {
+              return d.includes(imageName);
+            });
+          }));
+      }
+    }, _callee);
+  }));
+  return _imageExists.apply(this, arguments);
+}
+export function pullImage(_x2) {
+  return _pullImage.apply(this, arguments);
+}
+function _pullImage() {
+  _pullImage = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(imageName) {
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
+        case 0:
+          _context2.n = 1;
+          return new Promise(function (resolve, reject) {
+            docker.pull(imageName, function (err, stream) {
+              if (err) return reject(new Error('Error pulling image: ' + err.message));
+              docker.modem.followProgress(stream, function (pullErr) {
+                if (pullErr) reject(new Error('Error during pull: ' + pullErr.message));else resolve();
+              });
+            });
+          });
+        case 1:
+          return _context2.a(2);
+      }
+    }, _callee2);
+  }));
+  return _pullImage.apply(this, arguments);
+}

package/dist/helpers/dockerService.js

@@ -1,3 +1,9 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 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; } }
@@ -8,6 +14,19 @@ function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present,
 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); }); }; }
+/**
+ * Utility to interact with Docker CLI.
+ * Utilidad para interactuar con el CLI de Docker.
+ *
+ * @param {string} cmd - Docker command / Comando Docker
+ * @returns {Promise<string>} Output from Docker / Salida de Docker
+ * @throws {Error} If command fails / Si el comando falla
+ * @example
+ * // EN: Run a Docker command
+ * // ES: Ejecutar un comando Docker
+ * await dockerService('ps -a');
+ */
+
 import Docker from "dockerode";
 var docker = new Docker({
   socketPath: "/var/run/docker.sock"
@@ -129,6 +148,17 @@ function _getContainers() {
 export function getStats(_x4) {
   return _getStats.apply(this, arguments);
 }
+
+/**
+ * Crea un contenedor Docker de forma robusta.
+ * - Valida si la imagen existe localmente, si no, la descarga (pull).
+ * - Permite opciones adicionales para el contenedor.
+ *
+ * @param {string} imageName - Nombre de la imagen Docker
+ * @param {object} [options] - Opciones adicionales para el contenedor
+ * @returns {Promise<string>} ID del contenedor creado
+ * @throws {Error} Si falla la creación o el pull de la imagen
+ */
 function _getStats() {
   _getStats = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(containerId) {
     var container, stream, cpuDelta, systemDelta, cpuPercent, memUsage, memLimit, memPercent, rx, tx;
@@ -170,4 +200,85 @@ function _getStats() {
     }, _callee5);
   }));
   return _getStats.apply(this, arguments);
+}
+export function createContainer(_x5) {
+  return _createContainer.apply(this, arguments);
+}
+function _createContainer() {
+  _createContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(imageName) {
+    var options,
+      imageExists,
+      images,
+      createOpts,
+      container,
+      _args6 = arguments,
+      _t,
+      _t2,
+      _t3;
+    return _regenerator().w(function (_context6) {
+      while (1) switch (_context6.p = _context6.n) {
+        case 0:
+          options = _args6.length > 1 && _args6[1] !== undefined ? _args6[1] : {};
+          // Verifica si la imagen existe localmente
+          imageExists = false;
+          _context6.p = 1;
+          _context6.n = 2;
+          return docker.listImages();
+        case 2:
+          images = _context6.v;
+          imageExists = images.some(function (img) {
+            return (img.RepoTags || []).includes(imageName) || (img.RepoDigests || []).some(function (d) {
+              return d.includes(imageName);
+            });
+          });
+          _context6.n = 4;
+          break;
+        case 3:
+          _context6.p = 3;
+          _t = _context6.v;
+          throw new Error('Error al listar imágenes locales: ' + _t.message);
+        case 4:
+          if (imageExists) {
+            _context6.n = 8;
+            break;
+          }
+          _context6.p = 5;
+          _context6.n = 6;
+          return new Promise(function (resolve, reject) {
+            docker.pull(imageName, function (err, stream) {
+              if (err) return reject(new Error('Error al hacer pull de la imagen: ' + err.message));
+              docker.modem.followProgress(stream, function (pullErr) {
+                if (pullErr) reject(new Error('Error durante el pull: ' + pullErr.message));else resolve();
+              });
+            });
+          });
+        case 6:
+          _context6.n = 8;
+          break;
+        case 7:
+          _context6.p = 7;
+          _t2 = _context6.v;
+          throw new Error('No se pudo descargar la imagen: ' + _t2.message);
+        case 8:
+          // Opciones por defecto y merge con las recibidas
+          createOpts = _objectSpread({
+            Image: imageName,
+            Tty: true
+          }, options);
+          _context6.p = 9;
+          _context6.n = 10;
+          return docker.createContainer(createOpts);
+        case 10:
+          container = _context6.v;
+          return _context6.a(2, container.id || container.Id);
+        case 11:
+          _context6.p = 11;
+          _t3 = _context6.v;
+          throw new Error('Error al crear el contenedor: ' + _t3.message);
+        case 12:
+          return _context6.a(2);
+      }
+    }, _callee6, null, [[9, 11], [5, 7], [1, 3]]);
+  }));
+  return _createContainer.apply(this, arguments);
 }

package/dist/helpers/validationHelpers.js

@@ -0,0 +1,26 @@
+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; }
+// Reusable validations for ports and environment variables
+
+export function validatePorts(portInput) {
+  var ports = portInput.split(",").map(function (p) {
+    return p.trim();
+  }).filter(Boolean);
+  if (ports.length === 0) return false;
+  var invalid = ports.find(function (pair) {
+    var _pair$split = pair.split(":"),
+      _pair$split2 = _slicedToArray(_pair$split, 2),
+      host = _pair$split2[0],
+      cont = _pair$split2[1];
+    return !host || !cont || isNaN(Number(host)) || isNaN(Number(cont));
+  });
+  return !invalid;
+}
+export function validateEnvVars(envInput) {
+  // Future specific validations
+  return true;
+}

package/dist/hooks/creation/useContainerActions.js

@@ -0,0 +1,171 @@
+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); }); }; }
+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 { useState } from "react";
+import { startContainer as svcStartContainer, stopContainer as svcStopContainer, restartContainer as svcRestartContainer, removeContainer as svcRemoveContainer } from "../../helpers/dockerService/serviceComponents/containerActions.js";
+
+/**
+ * Custom hook to manage container actions (start, stop, restart, remove).
+ * Handles feedback messages and exposes helpers for each action.
+ *
+ * @param {Object} params
+ * @param {Array} params.containers - List of containers
+ * @param {Function} params.onAction - Callback after action is performed
+ * @returns {Object} Action helpers and feedback state
+ */
+export function useContainerActions(_ref) {
+  var containers = _ref.containers,
+    onAction = _ref.onAction;
+  var _useState = useState(""),
+    _useState2 = _slicedToArray(_useState, 2),
+    message = _useState2[0],
+    setMessage = _useState2[1];
+  var _useState3 = useState("yellow"),
+    _useState4 = _slicedToArray(_useState3, 2),
+    messageColor = _useState4[0],
+    setMessageColor = _useState4[1];
+
+  /**
+   * Handles a generic container action and sets feedback.
+   * @param {Function} actionFn - The async action function (start, stop, etc)
+   * @param {string} actionLabel - Action label for feedback
+   * @param {number} selected - Index of selected container
+   * @param {Function} [stateCheck] - Optional function to check state before action
+   */
+  function handleAction(_x) {
+    return _handleAction.apply(this, arguments);
+  }
+  function _handleAction() {
+    _handleAction = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(_ref2) {
+      var actionFn, actionLabel, selected, stateCheck, container, checkMsg, _t;
+      return _regenerator().w(function (_context5) {
+        while (1) switch (_context5.p = _context5.n) {
+          case 0:
+            actionFn = _ref2.actionFn, actionLabel = _ref2.actionLabel, selected = _ref2.selected, stateCheck = _ref2.stateCheck;
+            container = containers[selected];
+            if (container) {
+              _context5.n = 1;
+              break;
+            }
+            return _context5.a(2);
+          case 1:
+            if (!stateCheck) {
+              _context5.n = 2;
+              break;
+            }
+            checkMsg = stateCheck(container);
+            if (!checkMsg) {
+              _context5.n = 2;
+              break;
+            }
+            setMessage(checkMsg);
+            setMessageColor("yellow");
+            return _context5.a(2);
+          case 2:
+            setMessage("".concat(actionLabel, " container..."));
+            setMessageColor("yellow");
+            _context5.p = 3;
+            _context5.n = 4;
+            return actionFn(container.id);
+          case 4:
+            setMessage("".concat(actionLabel, " container successful."));
+            setMessageColor("green");
+            if (onAction) onAction();
+            _context5.n = 6;
+            break;
+          case 5:
+            _context5.p = 5;
+            _t = _context5.v;
+            setMessage("Failed to ".concat(actionLabel.toLowerCase(), " container: ").concat(_t.message));
+            setMessageColor("red");
+          case 6:
+            return _context5.a(2);
+        }
+      }, _callee5, null, [[3, 5]]);
+    }));
+    return _handleAction.apply(this, arguments);
+  }
+  return {
+    message: message,
+    setMessage: setMessage,
+    messageColor: messageColor,
+    setMessageColor: setMessageColor,
+    handleAction: handleAction,
+    // Expose concrete actions so callers can use actions.startContainer(id)
+    startContainer: function () {
+      var _startContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(id) {
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              _context.n = 1;
+              return svcStartContainer(id);
+            case 1:
+              return _context.a(2, _context.v);
+          }
+        }, _callee);
+      }));
+      function startContainer(_x2) {
+        return _startContainer.apply(this, arguments);
+      }
+      return startContainer;
+    }(),
+    stopContainer: function () {
+      var _stopContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(id) {
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
+            case 0:
+              _context2.n = 1;
+              return svcStopContainer(id);
+            case 1:
+              return _context2.a(2, _context2.v);
+          }
+        }, _callee2);
+      }));
+      function stopContainer(_x3) {
+        return _stopContainer.apply(this, arguments);
+      }
+      return stopContainer;
+    }(),
+    restartContainer: function () {
+      var _restartContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(id) {
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
+            case 0:
+              _context3.n = 1;
+              return svcRestartContainer(id);
+            case 1:
+              return _context3.a(2, _context3.v);
+          }
+        }, _callee3);
+      }));
+      function restartContainer(_x4) {
+        return _restartContainer.apply(this, arguments);
+      }
+      return restartContainer;
+    }(),
+    removeContainer: function () {
+      var _removeContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(id) {
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.n) {
+            case 0:
+              _context4.n = 1;
+              return svcRemoveContainer(id);
+            case 1:
+              return _context4.a(2, _context4.v);
+          }
+        }, _callee4);
+      }));
+      function removeContainer(_x5) {
+        return _removeContainer.apply(this, arguments);
+      }
+      return removeContainer;
+    }()
+  };
+}

package/dist/hooks/creation/useContainerCreation.js

@@ -0,0 +1,141 @@
+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 { useState } from "react";
+import { validatePorts, validateEnvVars } from "../../helpers/validationHelpers.js";
+
+/**
+ * Custom hook to manage the container creation flow, step by step.
+ * Handles input, validation, and feedback for each creation step.
+ *
+ * @param {Object} params
+ * @param {Function} params.onCreate - Callback when creation is confirmed
+ * @param {Function} params.onCancel - Callback when creation is cancelled
+ * @param {Array<string>} params.dbImages - List of DB image names for env var warning
+ * @returns {Object} Creation state, setters, and helpers
+ */
+export function useContainerCreation(_ref) {
+  var onCreate = _ref.onCreate,
+    onCancel = _ref.onCancel,
+    _ref$dbImages = _ref.dbImages,
+    dbImages = _ref$dbImages === void 0 ? [] : _ref$dbImages;
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    step = _useState2[0],
+    setStep = _useState2[1]; // 0: image, 1: name, 2: ports, 3: env
+  var _useState3 = useState(""),
+    _useState4 = _slicedToArray(_useState3, 2),
+    imageName = _useState4[0],
+    setImageName = _useState4[1];
+  var _useState5 = useState(""),
+    _useState6 = _slicedToArray(_useState5, 2),
+    containerName = _useState6[0],
+    setContainerName = _useState6[1];
+  var _useState7 = useState(""),
+    _useState8 = _slicedToArray(_useState7, 2),
+    portInput = _useState8[0],
+    setPortInput = _useState8[1];
+  var _useState9 = useState(""),
+    _useState0 = _slicedToArray(_useState9, 2),
+    envInput = _useState0[0],
+    setEnvInput = _useState0[1];
+  var _useState1 = useState(""),
+    _useState10 = _slicedToArray(_useState1, 2),
+    message = _useState10[0],
+    setMessage = _useState10[1];
+  var _useState11 = useState("yellow"),
+    _useState12 = _slicedToArray(_useState11, 2),
+    messageColor = _useState12[0],
+    setMessageColor = _useState12[1];
+
+  /**
+   * Advances to the next step, with validation and feedback.
+   */
+  function nextStep() {
+    if (step === 0) {
+      if (!imageName.trim()) {
+        setMessage("Image name cannot be empty.");
+        setMessageColor("red");
+        return;
+      }
+      setStep(1);
+      setMessage("Optional: Enter container name or leave empty and press Enter");
+      setMessageColor("yellow");
+      return;
+    }
+    if (step === 1) {
+      setStep(2);
+      setMessage("Optional: Enter ports (format 8080:80,443:443) or leave empty and press Enter");
+      setMessageColor("yellow");
+      return;
+    }
+    if (step === 2) {
+      if (!portInput.trim()) {
+        setMessage("You must specify at least one port to expose (e.g. 8080:80)");
+        setMessageColor("red");
+        return;
+      }
+      if (!validatePorts(portInput)) {
+        setMessage("Port format must be host:container and both must be numbers (e.g. 8080:80)");
+        setMessageColor("red");
+        return;
+      }
+      setStep(3);
+      var isDb = dbImages.some(function (db) {
+        return imageName.trim().toLowerCase().includes(db);
+      });
+      if (isDb) {
+        setMessage("Warning: This image usually requires environment variables (e.g. MYSQL_ROOT_PASSWORD=my-secret-pw for MySQL, POSTGRES_PASSWORD=yourpassword for Postgres). Enter them as VAR=val,VAR2=val2 or leave empty and press Enter.");
+        setMessageColor("yellow");
+      } else {
+        setMessage("Optional: Enter environment variables (format VAR1=val1,VAR2=val2) or leave empty and press Enter");
+        setMessageColor("yellow");
+      }
+      return;
+    }
+    if (step === 3) {
+      // Final step: call onCreate with all data
+      onCreate({
+        imageName: imageName,
+        containerName: containerName,
+        portInput: portInput,
+        envInput: envInput
+      });
+    }
+  }
+
+  /**
+   * Cancels the creation process and resets state.
+   */
+  function cancelCreation() {
+    setStep(0);
+    setImageName("");
+    setContainerName("");
+    setPortInput("");
+    setEnvInput("");
+    setMessage("");
+    setMessageColor("yellow");
+    if (onCancel) onCancel();
+  }
+  return {
+    step: step,
+    setStep: setStep,
+    imageName: imageName,
+    setImageName: setImageName,
+    containerName: containerName,
+    setContainerName: setContainerName,
+    portInput: portInput,
+    setPortInput: setPortInput,
+    envInput: envInput,
+    setEnvInput: setEnvInput,
+    message: message,
+    setMessage: setMessage,
+    messageColor: messageColor,
+    setMessageColor: setMessageColor,
+    nextStep: nextStep,
+    cancelCreation: cancelCreation
+  };
+}

package/dist/hooks/creation/useLogsViewer.js

@@ -0,0 +1,62 @@
+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 { useState, useRef } from "react";
+
+/**
+ * Custom hook to manage the logs viewer state and stream reference.
+ * Handles showing/hiding logs and storing log lines.
+ *
+ * @returns {Object} Logs viewer state and helpers
+ * @property {boolean} showLogs - Whether the logs viewer is open
+ * @property {function} setShowLogs - Setter for showLogs
+ * @property {Array<string>} logs - Array of log lines
+ * @property {function} setLogs - Setter for logs
+ * @property {object} logsStreamRef - Ref to the logs stream (for cleanup)
+ * @property {function} openLogs - Helper to open logs for a container
+ * @property {function} closeLogs - Helper to close logs and cleanup
+ */
+export function useLogsViewer() {
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    showLogs = _useState2[0],
+    setShowLogs = _useState2[1];
+  var _useState3 = useState([]),
+    _useState4 = _slicedToArray(_useState3, 2),
+    logs = _useState4[0],
+    setLogs = _useState4[1];
+  var logsStreamRef = useRef(null);
+
+  /**
+   * Opens the logs viewer and resets logs.
+   */
+  function openLogs() {
+    setShowLogs(true);
+    setLogs([]);
+  }
+
+  /**
+   * Closes the logs viewer and cleans up the stream.
+   */
+  function closeLogs() {
+    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;
+    }
+  }
+  return {
+    showLogs: showLogs,
+    setShowLogs: setShowLogs,
+    logs: logs,
+    setLogs: setLogs,
+    logsStreamRef: logsStreamRef,
+    openLogs: openLogs,
+    closeLogs: closeLogs
+  };
+}

package/dist/hooks/useContainers.js

@@ -8,8 +8,18 @@ function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof 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 _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; }
+/**
+ * React hook to manage Docker containers state.
+ * Hook de React para gestionar el estado de contenedores Docker.
+ *
+ * @returns {[Array, Function]} [containers, refresh] / [contenedores, refrescar]
+ * @example
+ * // EN: Use in a component
+ * // ES: Usar en un componente
+ * const [containers, refresh] = useContainers();
+ */
 import React, { useState, useEffect } from "react";
-import { getContainers } from "../helpers/dockerService.js";
+import { getContainers } from "../helpers/dockerService/serviceComponents/containerList.js";
 export function useContainers() {
   var _useState = useState([]),
     _useState2 = _slicedToArray(_useState, 2),