cdd-cli 3.2.0 → 4.0.0

package/dist/helpers/constants.js

@@ -27,4 +27,157 @@ export var EXIT_DELAY = 500;
 export var TIMEOUTS = {
   CONTAINER_OP: 30000,
   PULL_IMAGE: 300000
-};
+};
+
+/**
+ * List of well-known database image names (without tags or registry prefixes).
+ */
+export var DB_IMAGES = ['mysql', 'mariadb', 'postgres', 'mongo', 'mssql', 'redis'];
+
+/**
+ * Per-image profiles with required env vars, default exposed port, and suggested env vars.
+ * Keys are normalized image names (no tag, no registry prefix).
+ *
+ * @type {Record<string, { requiredEnv: string[], defaultPort: string, suggestedEnv: string[] }>}
+ */
+export var IMAGE_PROFILES = {
+  nginx: {
+    requiredEnv: [],
+    defaultPort: '80',
+    suggestedEnv: [],
+    defaultTag: '1.27-alpine'
+  },
+  httpd: {
+    requiredEnv: [],
+    defaultPort: '80',
+    suggestedEnv: [],
+    defaultTag: '2.4-alpine'
+  },
+  caddy: {
+    requiredEnv: [],
+    defaultPort: '80',
+    suggestedEnv: [],
+    defaultTag: '2-alpine'
+  },
+  node: {
+    requiredEnv: [],
+    defaultPort: '3000',
+    suggestedEnv: ['NODE_ENV=production'],
+    defaultTag: '22-alpine'
+  },
+  python: {
+    requiredEnv: [],
+    defaultPort: '8000',
+    suggestedEnv: ['PYTHONUNBUFFERED=1'],
+    defaultTag: '3.12-slim'
+  },
+  openjdk: {
+    requiredEnv: [],
+    defaultPort: '8080',
+    suggestedEnv: ['JAVA_OPTS=-Xms256m -Xmx512m'],
+    defaultTag: '21-slim'
+  },
+  golang: {
+    requiredEnv: [],
+    defaultPort: '8080',
+    suggestedEnv: ['GOMAXPROCS=2'],
+    defaultTag: '1.22-alpine'
+  },
+  redis: {
+    requiredEnv: [],
+    defaultPort: '6379',
+    suggestedEnv: ['REDIS_PASSWORD=change-me'],
+    defaultTag: '7-alpine'
+  },
+  memcached: {
+    requiredEnv: [],
+    defaultPort: '11211',
+    suggestedEnv: [],
+    defaultTag: '1.6-alpine'
+  },
+  postgres: {
+    requiredEnv: ['POSTGRES_PASSWORD'],
+    defaultPort: '5432',
+    suggestedEnv: ['POSTGRES_PASSWORD=secret', 'POSTGRES_USER=postgres', 'POSTGRES_DB=app'],
+    defaultTag: '17-alpine'
+  },
+  mysql: {
+    requiredEnv: ['MYSQL_ROOT_PASSWORD'],
+    defaultPort: '3306',
+    suggestedEnv: ['MYSQL_ROOT_PASSWORD=secret', 'MYSQL_DATABASE=app', 'MYSQL_USER=app', 'MYSQL_PASSWORD=app123'],
+    defaultTag: '8.0'
+  },
+  mariadb: {
+    requiredEnv: ['MARIADB_ROOT_PASSWORD'],
+    defaultPort: '3306',
+    suggestedEnv: ['MARIADB_ROOT_PASSWORD=secret', 'MARIADB_DATABASE=app', 'MARIADB_USER=app', 'MARIADB_PASSWORD=app123'],
+    defaultTag: '11-alpine'
+  },
+  mongo: {
+    requiredEnv: [],
+    defaultPort: '27017',
+    suggestedEnv: ['MONGO_INITDB_ROOT_USERNAME=admin', 'MONGO_INITDB_ROOT_PASSWORD=secret'],
+    defaultTag: '7.0'
+  },
+  mssql: {
+    requiredEnv: ['ACCEPT_EULA', 'SA_PASSWORD'],
+    defaultPort: '1433',
+    suggestedEnv: ['ACCEPT_EULA=Y', 'SA_PASSWORD=Strong!Passw0rd', 'MSSQL_PID=Developer'],
+    defaultTag: '2022-latest'
+  },
+  rabbitmq: {
+    requiredEnv: [],
+    defaultPort: '5672',
+    suggestedEnv: ['RABBITMQ_DEFAULT_USER=guest', 'RABBITMQ_DEFAULT_PASS=guest'],
+    defaultTag: '3-management-alpine'
+  },
+  kafka: {
+    requiredEnv: [],
+    defaultPort: '9092',
+    suggestedEnv: ['KAFKA_CFG_LISTENERS=PLAINTEXT://:9092', 'KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092'],
+    defaultTag: '3.7'
+  },
+  zookeeper: {
+    requiredEnv: [],
+    defaultPort: '2181',
+    suggestedEnv: ['ALLOW_ANONYMOUS_LOGIN=yes'],
+    defaultTag: '3.9'
+  },
+  elasticsearch: {
+    requiredEnv: [],
+    defaultPort: '9200',
+    suggestedEnv: ['discovery.type=single-node', 'xpack.security.enabled=false'],
+    defaultTag: '8.13.0'
+  },
+  minio: {
+    requiredEnv: ['MINIO_ROOT_USER', 'MINIO_ROOT_PASSWORD'],
+    defaultPort: '9000',
+    suggestedEnv: ['MINIO_ROOT_USER=admin', 'MINIO_ROOT_PASSWORD=secret', 'MINIO_CONSOLE_ADDRESS=:9001'],
+    defaultTag: 'latest'
+  },
+  wordpress: {
+    requiredEnv: ['WORDPRESS_DB_HOST', 'WORDPRESS_DB_USER', 'WORDPRESS_DB_PASSWORD', 'WORDPRESS_DB_NAME'],
+    defaultPort: '8080',
+    suggestedEnv: ['WORDPRESS_DB_HOST=db', 'WORDPRESS_DB_USER=wp', 'WORDPRESS_DB_PASSWORD=secret', 'WORDPRESS_DB_NAME=wordpress', 'WORDPRESS_TABLE_PREFIX=wp_'],
+    defaultTag: '6.5-apache'
+  }
+};
+
+/**
+ * Given an image name (with or without tag), returns the image name with a
+ * default tag appended when the image matches a known profile and has no
+ * explicit tag. Returns the input unchanged otherwise.
+ *
+ * @param {string} imageName - e.g. 'postgres', 'postgres:15', 'unknownimage'
+ * @param {Record<string, { defaultTag: string }>} profiles
+ * @returns {string}
+ */
+export function resolveImageTag(imageName) {
+  var profiles = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : IMAGE_PROFILES;
+  if (!imageName) return imageName;
+  if (imageName.includes(':')) return imageName;
+  var baseName = imageName.trim().toLowerCase().split('/').pop();
+  var profile = profiles[baseName];
+  if (!(profile !== null && profile !== void 0 && profile.defaultTag)) return imageName;
+  return "".concat(imageName, ":").concat(profile.defaultTag);
+}

package/dist/helpers/containerOptionsBuilder.js

@@ -24,16 +24,16 @@ export function buildContainerOptions(_ref) {
     containerName = _ref.containerName,
     portInput = _ref.portInput,
     envInput = _ref.envInput;
-  var env = (envInput || "").split(",").map(function (s) {
+  var env = (envInput || '').split(',').map(function (s) {
     return s.trim();
   }).filter(Boolean);
-  var ports = (portInput || "").split(",").map(function (s) {
+  var ports = (portInput || '').split(',').map(function (s) {
     return s.trim();
   }).filter(Boolean);
   var ExposedPorts = {};
   var PortBindings = {};
   ports.forEach(function (pair) {
-    var _pair$split = pair.split(":"),
+    var _pair$split = pair.split(':'),
       _pair$split2 = _slicedToArray(_pair$split, 2),
       host = _pair$split2[0],
       cont = _pair$split2[1];

package/dist/helpers/dockerHubService.js

@@ -0,0 +1,111 @@
+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); }); }; }
+/**
+ * Docker Hub search helper.
+ * Pure function — no side effects beyond HTTP. All state management
+ * lives in the calling hook (useContainerCreation).
+ */
+
+var DOCKER_HUB_SEARCH_URL = 'https://hub.docker.com/v2/search/repositories/';
+
+/**
+ * Format a Docker Hub search result object into a display string.
+ *
+ * Format rules:
+ *   - Official: "name [★ official] [Npulls+]" (if pullCount > 0)
+ *   - Non-official with pulls: "name [Npulls+]"
+ *   - Otherwise: "name"
+ *
+ * Pull count suffixes: ≥1B → "1B+", ≥1M → "1M+", ≥1K → "1K+", else raw number
+ *
+ * @param {{ name: string, isOfficial: boolean, pullCount: number }} result
+ * @returns {string}
+ */
+export function formatHubResult(result) {
+  var name = result.name,
+    isOfficial = result.isOfficial,
+    pullCount = result.pullCount;
+  var pullSuffix = '';
+  if (pullCount >= 1e9) {
+    pullSuffix = " [1B+ pulls]";
+  } else if (pullCount >= 1e6) {
+    pullSuffix = " [".concat(Math.floor(pullCount / 1e6), "M+ pulls]");
+  } else if (pullCount >= 1e3) {
+    pullSuffix = " [".concat(Math.floor(pullCount / 1e3), "K+ pulls]");
+  } else if (pullCount > 0) {
+    pullSuffix = " [".concat(pullCount, " pulls]");
+  }
+  if (isOfficial) {
+    return "".concat(name, " [\u2605 official]").concat(pullSuffix);
+  }
+  return "".concat(name).concat(pullSuffix);
+}
+
+/**
+ * Search Docker Hub for images matching the given query.
+ *
+ * @param {string} query - Search term (will be trimmed and encoded)
+ * @param {Object} [options]
+ * @param {AbortSignal} [options.signal] - Abort signal; defaults to AbortSignal.timeout(5000)
+ * @returns {Promise<Array<{ name: string, isOfficial: boolean, pullCount: number, description: string }>>}
+ * @throws {Error} If response.ok is false or the network call rejects
+ */
+export function searchDockerHub(_x) {
+  return _searchDockerHub.apply(this, arguments);
+}
+function _searchDockerHub() {
+  _searchDockerHub = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(query) {
+    var _options$signal, _data$results;
+    var options,
+      q,
+      url,
+      signal,
+      response,
+      data,
+      results,
+      _args = arguments;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          options = _args.length > 1 && _args[1] !== undefined ? _args[1] : {};
+          q = query.trim();
+          if (q) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2, []);
+        case 1:
+          url = "".concat(DOCKER_HUB_SEARCH_URL, "?query=").concat(encodeURIComponent(q), "&page_size=10");
+          signal = (_options$signal = options.signal) !== null && _options$signal !== void 0 ? _options$signal : AbortSignal.timeout(5000);
+          _context.n = 2;
+          return fetch(url, {
+            signal: signal
+          });
+        case 2:
+          response = _context.v;
+          if (response.ok) {
+            _context.n = 3;
+            break;
+          }
+          throw new Error("Docker Hub search failed: ".concat(response.status));
+        case 3:
+          _context.n = 4;
+          return response.json();
+        case 4:
+          data = _context.v;
+          results = (_data$results = data.results) !== null && _data$results !== void 0 ? _data$results : [];
+          return _context.a(2, results.map(function (item) {
+            return {
+              name: item.repo_name,
+              isOfficial: item.is_official,
+              pullCount: item.pull_count,
+              description: item.short_description
+            };
+          }));
+      }
+    }, _callee);
+  }));
+  return _searchDockerHub.apply(this, arguments);
+}

package/dist/helpers/dockerService/dockerService.js

@@ -1,4 +1,4 @@
-import Docker from "dockerode";
+import Docker from 'dockerode';
 
 // Use default dockerode configuration which automatically handles:
 // - /var/run/docker.sock on Linux/Mac

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

@@ -1,4 +1,10 @@
 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 _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; }
 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; }
@@ -8,10 +14,11 @@ 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); }); }; }
-import { docker } from "../dockerService.js";
-import { imageExists, pullImage } from "./imageUtils.js";
-import { TIMEOUTS } from "../../constants.js";
-import { logger } from "../../logger.js";
+import { docker } from '../dockerService.js';
+import { imageExists, pullImage } from './imageUtils.js';
+import { TIMEOUTS, IMAGE_PROFILES } from '../../constants.js';
+import { logger } from '../../logger.js';
+import { normalizeImageName } from '../../imageNameUtils.js';
 
 /**
  * Helper to add timeout to promises. If the provided promise does not settle
@@ -47,7 +54,8 @@ export function removeContainer(_x) {
  *
  * @param {string} imageName - Image name (e.g. 'nginx:alpine')
  * @param {Object} [options] - Docker create options (Env, ExposedPorts, HostConfig, name, etc.)
- * @returns {Promise<string>} The created container id
+ * @param {Object} [imageProfiles] - Image profiles map for defaultPort fallback
+ * @returns {Promise<{id: string, ports: Array<{containerPort: string, hostPort: string, protocol: string, source: string}>}>}
  * @throws {Error} If image listing/pull or creation fails
  */
 function _removeContainer() {
@@ -56,7 +64,7 @@ function _removeContainer() {
     return _regenerator().w(function (_context) {
       while (1) switch (_context.p = _context.n) {
         case 0:
-          logger.debug("Removing container %s", containerId);
+          logger.debug('Removing container %s', containerId);
           container = docker.getContainer(containerId);
           _context.p = 1;
           _context.n = 2;
@@ -64,13 +72,13 @@ function _removeContainer() {
             force: true
           }), TIMEOUTS.CONTAINER_OP);
         case 2:
-          logger.info("Removed container %s", containerId);
+          logger.info('Removed container %s', containerId);
           _context.n = 4;
           break;
         case 3:
           _context.p = 3;
           _t = _context.v;
-          logger.error("Failed to remove container %s", containerId, _t);
+          logger.error('Failed to remove container %s', containerId, _t);
           throw new Error('Error removing container: ' + _t.message);
         case 4:
           return _context.a(2);
@@ -91,9 +99,11 @@ export function createContainer(_x2) {
 function _createContainer() {
   _createContainer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(imageName) {
     var options,
+      imageProfiles,
       exists,
       createOpts,
       hasUserDefinedPorts,
+      assignedPorts,
       image,
       _inspectData$Config,
       _inspectData$Containe,
@@ -104,6 +114,11 @@ function _createContainer() {
       inspectData,
       exposed,
       exposedKeys,
+      baseName,
+      profile,
+      fallbackKey,
+      _createOpts$HostConfi,
+      portBindings,
       container,
       containerId,
       _args2 = arguments,
@@ -116,7 +131,8 @@ function _createContainer() {
       while (1) switch (_context2.p = _context2.n) {
         case 0:
           options = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : {};
-          logger.info("Creating container from image %s", imageName);
+          imageProfiles = _args2.length > 2 && _args2[2] !== undefined ? _args2[2] : IMAGE_PROFILES;
+          logger.info('Creating container from image %s', imageName);
           _context2.p = 1;
           _context2.n = 2;
           return withTimeout(imageExists(imageName), 10000);
@@ -127,25 +143,25 @@ function _createContainer() {
         case 3:
           _context2.p = 3;
           _t2 = _context2.v;
-          logger.error("Could not check local images for %s", imageName, _t2);
+          logger.error('Could not check local images for %s', imageName, _t2);
           throw new Error('Error listing local images: ' + _t2.message);
         case 4:
           if (exists) {
             _context2.n = 8;
             break;
           }
-          logger.info("Image %s not found locally, pulling", imageName);
+          logger.info('Image %s not found locally, pulling', imageName);
           _context2.p = 5;
           _context2.n = 6;
           return withTimeout(pullImage(imageName), TIMEOUTS.PULL_IMAGE);
         case 6:
-          logger.info("Pulled image %s", imageName);
+          logger.info('Pulled image %s', imageName);
           _context2.n = 8;
           break;
         case 7:
           _context2.p = 7;
           _t3 = _context2.v;
-          logger.error("Failed to pull image %s", imageName, _t3);
+          logger.error('Failed to pull image %s', imageName, _t3);
           throw new Error('Could not pull image: ' + _t3.message);
         case 8:
           createOpts = _objectSpread({
@@ -153,18 +169,20 @@ function _createContainer() {
             Tty: true
           }, options);
           hasUserDefinedPorts = Boolean(createOpts.ExposedPorts && Object.keys(createOpts.ExposedPorts).length);
+          /** @type {Array<{containerPort: string, hostPort: string, protocol: string, source: string}>} */
+          assignedPorts = [];
           if (hasUserDefinedPorts) {
-            _context2.n = 17;
+            _context2.n = 18;
             break;
           }
           _context2.p = 9;
           image = docker.getImage(imageName);
-          if (!(image && typeof image.inspect === "function")) {
+          if (!(image && typeof image.inspect === 'function')) {
             _context2.n = 15;
             break;
           }
           usedHostPorts = new Set();
-          if (!(typeof docker.listContainers === "function")) {
+          if (!(typeof docker.listContainers === 'function')) {
             _context2.n = 13;
             break;
           }
@@ -187,7 +205,7 @@ function _createContainer() {
         case 12:
           _context2.p = 12;
           _t4 = _context2.v;
-          logger.warn("Could not inspect existing containers to auto-map ports", _t4);
+          logger.warn('Could not inspect existing containers to auto-map ports', _t4);
         case 13:
           reservePort = function reservePort(port) {
             var portStr = String(port);
@@ -196,7 +214,6 @@ function _createContainer() {
           pickNextAvailablePort = function pickNextAvailablePort(base) {
             var numericBase = Number.parseInt(base, 10);
             if (Number.isNaN(numericBase)) {
-              // If the base port is non-numeric, just return the base.
               if (!usedHostPorts.has(base)) {
                 usedHostPorts.add(base);
                 return base;
@@ -222,7 +239,16 @@ function _createContainer() {
         case 14:
           inspectData = _context2.v;
           exposed = (inspectData === null || inspectData === void 0 || (_inspectData$Config = inspectData.Config) === null || _inspectData$Config === void 0 ? void 0 : _inspectData$Config.ExposedPorts) || (inspectData === null || inspectData === void 0 || (_inspectData$Containe = inspectData.ContainerConfig) === null || _inspectData$Containe === void 0 ? void 0 : _inspectData$Containe.ExposedPorts) || {};
-          exposedKeys = Object.keys(exposed || {});
+          exposedKeys = Object.keys(exposed || {}); // If no ExposedPorts in image, fall back to IMAGE_PROFILES defaultPort
+          if (!exposedKeys.length) {
+            baseName = normalizeImageName(imageName);
+            profile = imageProfiles[baseName];
+            if (profile && profile.defaultPort) {
+              fallbackKey = "".concat(profile.defaultPort, "/tcp");
+              exposed = _defineProperty({}, fallbackKey, {});
+              exposedKeys = [fallbackKey];
+            }
+          }
           if (exposedKeys.length) {
             createOpts.ExposedPorts = createOpts.ExposedPorts || {};
             createOpts.HostConfig = _objectSpread({}, createOpts.HostConfig || {});
@@ -232,11 +258,19 @@ function _createContainer() {
                 createOpts.ExposedPorts[portKey] = exposed[portKey] || {};
               }
               if (!createOpts.HostConfig.PortBindings[portKey] || !createOpts.HostConfig.PortBindings[portKey].length) {
-                var containerPort = portKey.split("/")[0];
+                var parts = portKey.split('/');
+                var containerPort = parts[0];
+                var protocol = parts[1] || 'tcp';
                 var hostPort = pickNextAvailablePort(containerPort);
                 createOpts.HostConfig.PortBindings[portKey] = [{
                   HostPort: hostPort
                 }];
+                assignedPorts.push({
+                  containerPort: containerPort,
+                  hostPort: hostPort,
+                  protocol: protocol,
+                  source: 'auto'
+                });
               }
             });
           }
@@ -246,25 +280,50 @@ function _createContainer() {
         case 16:
           _context2.p = 16;
           _t5 = _context2.v;
-          logger.warn("Could not inspect image %s for default ports", imageName, _t5);
+          logger.warn('Could not inspect image %s for default ports', imageName, _t5);
         case 17:
-          _context2.p = 17;
-          _context2.n = 18;
-          return withTimeout(docker.createContainer(createOpts), TIMEOUTS.CONTAINER_OP);
+          _context2.n = 19;
+          break;
         case 18:
-          container = _context2.v;
-          containerId = container.id || container.Id;
-          logger.info("Created container %s from image %s", containerId, imageName);
-          return _context2.a(2, container.id || container.Id);
+          // User-defined ports: collect them with source: "user"
+          portBindings = ((_createOpts$HostConfi = createOpts.HostConfig) === null || _createOpts$HostConfi === void 0 ? void 0 : _createOpts$HostConfi.PortBindings) || {};
+          Object.entries(portBindings).forEach(function (_ref) {
+            var _ref2 = _slicedToArray(_ref, 2),
+              portKey = _ref2[0],
+              bindings = _ref2[1];
+            var parts = portKey.split('/');
+            var containerPort = parts[0];
+            var protocol = parts[1] || 'tcp';
+            (bindings || []).forEach(function (b) {
+              assignedPorts.push({
+                containerPort: containerPort,
+                hostPort: b.HostPort,
+                protocol: protocol,
+                source: 'user'
+              });
+            });
+          });
         case 19:
           _context2.p = 19;
+          _context2.n = 20;
+          return withTimeout(docker.createContainer(createOpts), TIMEOUTS.CONTAINER_OP);
+        case 20:
+          container = _context2.v;
+          containerId = container.id || container.Id;
+          logger.info('Created container %s from image %s', containerId, imageName);
+          return _context2.a(2, {
+            id: containerId,
+            ports: assignedPorts
+          });
+        case 21:
+          _context2.p = 21;
           _t6 = _context2.v;
-          logger.error("Failed to create container from image %s", imageName, _t6);
+          logger.error('Failed to create container from image %s', imageName, _t6);
           throw new Error('Error creating container: ' + _t6.message);
-        case 20:
+        case 22:
           return _context2.a(2);
       }
-    }, _callee2, null, [[17, 19], [10, 12], [9, 16], [5, 7], [1, 3]]);
+    }, _callee2, null, [[19, 21], [10, 12], [9, 16], [5, 7], [1, 3]]);
   }));
   return _createContainer.apply(this, arguments);
 }
@@ -284,18 +343,18 @@ function _startContainer() {
       while (1) switch (_context3.p = _context3.n) {
         case 0:
           container = docker.getContainer(containerId);
-          logger.debug("Starting container %s", containerId);
+          logger.debug('Starting container %s', containerId);
           _context3.p = 1;
           _context3.n = 2;
           return withTimeout(container.start(), TIMEOUTS.CONTAINER_OP);
         case 2:
-          logger.info("Started container %s", containerId);
+          logger.info('Started container %s', containerId);
           _context3.n = 4;
           break;
         case 3:
           _context3.p = 3;
           _t7 = _context3.v;
-          logger.error("Failed to start container %s", containerId, _t7);
+          logger.error('Failed to start container %s', containerId, _t7);
           throw _t7;
         case 4:
           return _context3.a(2);
@@ -320,18 +379,18 @@ function _stopContainer() {
       while (1) switch (_context4.p = _context4.n) {
         case 0:
           container = docker.getContainer(containerId);
-          logger.debug("Stopping container %s", containerId);
+          logger.debug('Stopping container %s', containerId);
           _context4.p = 1;
           _context4.n = 2;
           return withTimeout(container.stop(), TIMEOUTS.CONTAINER_OP);
         case 2:
-          logger.info("Stopped container %s", containerId);
+          logger.info('Stopped container %s', containerId);
           _context4.n = 4;
           break;
         case 3:
           _context4.p = 3;
           _t8 = _context4.v;
-          logger.error("Failed to stop container %s", containerId, _t8);
+          logger.error('Failed to stop container %s', containerId, _t8);
           throw _t8;
         case 4:
           return _context4.a(2);
@@ -350,18 +409,18 @@ function _restartContainer() {
       while (1) switch (_context5.p = _context5.n) {
         case 0:
           container = docker.getContainer(containerId);
-          logger.debug("Restarting container %s", containerId);
+          logger.debug('Restarting container %s', containerId);
           _context5.p = 1;
           _context5.n = 2;
           return withTimeout(container.restart(), TIMEOUTS.CONTAINER_OP);
         case 2:
-          logger.info("Restarted container %s", containerId);
+          logger.info('Restarted container %s', containerId);
           _context5.n = 4;
           break;
         case 3:
           _context5.p = 3;
           _t9 = _context5.v;
-          logger.error("Failed to restart container %s", containerId, _t9);
+          logger.error('Failed to restart container %s', containerId, _t9);
           throw _t9;
         case 4:
           return _context5.a(2);