@aifabrix/builder 2.42.1 → 2.44.0

package/lib/utils/compose-generator.js

@@ -10,18 +10,28 @@
  */
 
 const fsSync = require('fs');
-const fs = require('fs').promises;
 const path = require('path');
 const handlebars = require('handlebars');
 const config = require('../core/config');
-const buildCopy = require('./build-copy');
-const { formatMissingDbPasswordError } = require('./error-formatter');
+const { readDatabasePasswords } = require('./compose-db-passwords');
 const { getContainerPort } = require('./port-resolver');
 const { parseImageOverride } = require('./parse-image-ref');
+const { resolveComposeImageOverrideString } = require('./resolve-docker-image-ref');
 const { registerComposeHelpers } = require('./compose-handlebars-helpers');
 const { isVectorDatabaseName } = require('./compose-vector-helper');
-const paths = require('./paths');
-const { getInfraDirName } = require('../infrastructure/helpers');
+const { resolveMisoEnvironment } = require('./compose-miso-env');
+const {
+  buildScopedLocalContainerName,
+  composeTraefikServiceKey
+} = require('./environment-scoped-resources');
+const {
+  derivePathFromPattern,
+  buildDevUsernameForFrontDoorHost,
+  expandFrontDoorHostPlaceholders,
+  buildTraefikIngressBase,
+  computeTraefikStripPathPrefix
+} = require('./compose-traefik-ingress-base');
+const { parseDeveloperIdNum } = require('./declarative-url-ports');
 
 registerComposeHelpers();
 /**
@@ -71,9 +81,9 @@ function getImageName(config, appName) {
  * @param {Object} config - Application configuration
  * @returns {Object} App configuration
  */
-function buildAppConfig(appName, config) {
+function buildAppConfig(appName, config, composeKeyOverride = null) {
   return {
-    key: appName,
+    key: composeKeyOverride || appName,
     name: config.displayName || appName
   };
 }
@@ -98,33 +108,102 @@ function buildImageConfig(config, appName, imageOverride) {
 }
 
 /**
- * Builds health check configuration section
- * @param {Object} config - Application configuration
- * @returns {Object} Health check configuration
+ * Docker/local readiness path: same Traefik PathPrefix as url://vdir-public (frontDoorRouting + Plan 117 scope) + suffix.
+ * @param {Object} config - Application configuration (application.yaml shape)
+ * @param {string|number} devId - Developer id for host expansion
+ * @param {Object|null} scopeOpts - Env-scoped Traefik path (effectiveEnvironmentScopedResources, runEnvKey)
+ * @param {string|null|undefined} remoteServer - For ${REMOTE_HOST}
+ * @param {string|null|undefined} [readinessSuffix] - Path after vdir (default /health/ready or healthCheck.readinessPathSuffix)
+ * @returns {string} Absolute path starting with /
  */
-function buildHealthCheckConfig(config) {
-  return {
-    path: config.healthCheck?.path || '/health',
-    interval: config.healthCheck?.interval || 30
-  };
+function computeAlignedHealthCheckPath(config, devId, scopeOpts, remoteServer, readinessSuffix) {
+  const hc = config.healthCheck || {};
+  let suffix = '/health/ready';
+  if (
+    readinessSuffix !== undefined &&
+    readinessSuffix !== null &&
+    String(readinessSuffix).trim().startsWith('/')
+  ) {
+    suffix = String(readinessSuffix).trim();
+  } else if (typeof hc.readinessPathSuffix === 'string' && hc.readinessPathSuffix.startsWith('/')) {
+    suffix = hc.readinessPathSuffix;
+  }
+  const traefik = buildTraefikIngressBase(config, devId, scopeOpts, remoteServer);
+  if (traefik.enabled === true) {
+    const p = traefik.path;
+    if (!p || p === '/') {
+      return suffix;
+    }
+    return `${String(p).replace(/\/+$/, '')}${suffix}`;
+  }
+  const fd = config.frontDoorRouting;
+  if (!fd || fd.enabled !== true) {
+    return suffix;
+  }
+  const base = derivePathFromPattern(fd.pattern);
+  if (!base || base === '/') {
+    return suffix;
+  }
+  return `${String(base).replace(/\/+$/, '')}${suffix}`;
 }
 
 /**
- * Derives base path from routing pattern by removing trailing wildcards
- * @param {string} pattern - URL pattern (e.g., '/app/*', '/api/v1/*')
- * @returns {string} Base path for routing
+ * When `frontDoorRouting.enabled` is true, resolves the same vdir as Traefik labels / url://vdir-public
+ * (pattern + optional /dev|/tst from scopeOpts) and prepends it to healthCheck.path unless path already starts with that vdir.
+ *
+ * @param {Object} config - Application configuration (application.yaml shape)
+ * @param {string|number} devId - Developer id
+ * @param {Object|null} scopeOpts - Env-scoped Traefik path (effectiveEnvironmentScopedResources, runEnvKey)
+ * @param {string|null|undefined} remoteServer - For ${REMOTE_HOST}
+ * @param {{ skipVdirMergeWhenPathIsBareHealth?: boolean }} [opts] - When `skipVdirMergeWhenPathIsBareHealth`, path `/health` is left as-is (in-container probe; ingress strips vdir for miso/dataplane). Deployment JSON health paths do **not** use this helper — see `buildHealthCheck` in `builders.js` (YAML paths only).
+ * @returns {string} Absolute path starting with /
  */
-function derivePathFromPattern(pattern) {
-  if (!pattern || typeof pattern !== 'string') {
-    return '/';
+function resolveHealthCheckPathWithFrontDoorVdir(config, devId, scopeOpts, remoteServer, opts) {
+  const hc = config.healthCheck || {};
+  const raw = typeof hc.path === 'string' && hc.path.startsWith('/') ? hc.path : '/health';
+  const fd = config.frontDoorRouting;
+  if (!fd || fd.enabled !== true) {
+    return raw;
+  }
+  if (opts && opts.skipVdirMergeWhenPathIsBareHealth === true && raw === '/health') {
+    return raw;
+  }
+  const traefik = buildTraefikIngressBase(config, devId, scopeOpts, remoteServer);
+  if (traefik.enabled !== true) {
+    return raw;
   }
-  const trimmed = pattern.trim();
-  if (trimmed === '/' || trimmed === '') {
-    return '/';
+  const vdirRaw = traefik.path;
+  const vdir =
+    !vdirRaw || vdirRaw === '/'
+      ? ''
+      : String(vdirRaw).replace(/\/+$/, '');
+  if (!vdir) {
+    return computeAlignedHealthCheckPath(config, devId, scopeOpts, remoteServer, raw);
   }
-  const withoutWildcards = trimmed.replace(/\*+$/g, '');
-  const withoutTrailingSlashes = withoutWildcards.replace(/\/+$/g, '');
-  return withoutTrailingSlashes || '/';
+  if (raw === vdir || raw.startsWith(`${vdir}/`)) {
+    return raw;
+  }
+  return `${vdir}${raw}`;
+}
+
+/**
+ * Builds health check configuration section
+ * @param {Object} config - Application configuration
+ * @param {string|number} devId - Developer id
+ * @param {Object|null} scopeOpts - Env-scoped compose options
+ * @param {string|null|undefined} remoteServer - Remote server URL
+ * @returns {Object} Health check configuration
+ */
+function buildHealthCheckConfig(config, devId, scopeOpts, remoteServer) {
+  const hc = config.healthCheck || {};
+  const path = resolveHealthCheckPathWithFrontDoorVdir(config, devId, scopeOpts, remoteServer, {
+    skipVdirMergeWhenPathIsBareHealth: true
+  });
+  return {
+    path,
+    interval: hc.interval || 30,
+    bashProbe: hc.bashProbe === true
+  };
 }
 
 /**
@@ -146,31 +225,36 @@ function buildDevUsername(devId) {
 
 /**
  * Builds Traefik ingress configuration from frontDoorRouting
- * Resolves ${DEV_USERNAME} variable interpolation in host field
  * @param {Object} config - Application configuration
  * @param {string|number} devId - Developer ID
+ * @param {Object|null} scopeOpts - Env-scoped Traefik path
+ * @param {string|null|undefined} remoteServer - From config (for ${REMOTE_HOST})
+ * @param {string|undefined} [resolvedHealthPathForStrip] - Compose health path; when omitted, derived via resolveHealthCheckPathWithFrontDoorVdir (same as probe)
  * @returns {Object} Traefik configuration object
  */
-function buildTraefikConfig(config, devId) {
-  const frontDoor = config.frontDoorRouting;
-  if (!frontDoor || frontDoor.enabled !== true) {
+function buildTraefikConfig(config, devId, scopeOpts = null, remoteServer = null, resolvedHealthPathForStrip) {
+  const base = buildTraefikIngressBase(config, devId, scopeOpts, remoteServer);
+  if (!base.enabled) {
     return { enabled: false };
   }
-
-  if (!frontDoor.host || typeof frontDoor.host !== 'string') {
-    throw new Error('frontDoorRouting.host is required when frontDoorRouting.enabled is true');
-  }
-
-  const devUsername = buildDevUsername(devId);
-  const host = frontDoor.host.replace(/\$\{DEV_USERNAME\}/g, devUsername);
-  const path = derivePathFromPattern(frontDoor.pattern);
-
+  const resolvedHealth =
+    resolvedHealthPathForStrip !== undefined && resolvedHealthPathForStrip !== null
+      ? String(resolvedHealthPathForStrip)
+      : resolveHealthCheckPathWithFrontDoorVdir(config, devId, scopeOpts, remoteServer, {
+        skipVdirMergeWhenPathIsBareHealth: true
+      });
+  const devNum = parseDeveloperIdNum(devId);
+  // Shared builder host: nginx terminates TLS on :443 and proxies HTTP to per-dev Traefik :80 (e.g. 280).
+  // Traefik must only attach routers to `web` for developer-id > 0; `websecure`+tls labels without
+  // matching certs break routing on Traefik 3.6+ for HTTP traffic (404 on PathPrefix).
+  const terminateTlsAtTraefik = base.tls === true && devNum === 0;
   return {
     enabled: true,
-    host,
-    path,
-    tls: frontDoor.tls !== false,
-    certStore: frontDoor.certStore || null
+    host: base.host,
+    path: base.path,
+    tls: terminateTlsAtTraefik,
+    certStore: terminateTlsAtTraefik ? base.certStore || null : null,
+    stripPathPrefix: computeTraefikStripPathPrefix(base.path, resolvedHealth)
   };
 }
 
@@ -194,20 +278,40 @@ function buildRequiresConfig(config) {
  * @param {Object} config - Application configuration
  * @param {number} port - Application port
  * @param {string|number} devId - Developer ID
- * @param {string} [imageOverride] - Optional full image reference for run (e.g. from --image)
+ * @param {Object} [runExtras] - Optional compose run fields
+ * @param {string} [runExtras.imageOverride] - Full image reference for run (e.g. from --image)
+ * @param {Object|null} [runExtras.scopeOpts] - Traefik / scoped compose options
+ * @param {string|null|undefined} [runExtras.remoteServer] - For ${REMOTE_HOST} in frontDoorRouting.host
  * @returns {Object} Service configuration
  */
-function buildServiceConfig(appName, config, port, devId, imageOverride) {
+function buildServiceConfig(appName, config, port, devId, runExtras = {}) {
+  const { imageOverride = null, scopeOpts = null, remoteServer = null } = runExtras;
   const containerPortValue = getContainerPort(config, 3000);
   const hostPort = port;
+  const useTraefikScope =
+    scopeOpts &&
+    scopeOpts.effectiveEnvironmentScopedResources &&
+    scopeOpts.runEnvKey &&
+    (scopeOpts.runEnvKey === 'dev' || scopeOpts.runEnvKey === 'tst');
+  const composeAppKey = useTraefikScope
+    ? composeTraefikServiceKey(appName, scopeOpts.runEnvKey)
+    : null;
+  const scopeForHealthAndTraefik = useTraefikScope ? scopeOpts : null;
+  const healthCheck = buildHealthCheckConfig(config, devId, scopeForHealthAndTraefik, remoteServer);
   return {
-    app: buildAppConfig(appName, config),
+    app: buildAppConfig(appName, config, composeAppKey),
     image: buildImageConfig(config, appName, imageOverride),
     port: containerPortValue, // Container port (for health check and template)
     containerPort: containerPortValue, // Container port (always set, equals containerPort if exists, else port)
     hostPort: hostPort, // Host port (options.port if provided, else config.port)
-    healthCheck: buildHealthCheckConfig(config),
-    traefik: buildTraefikConfig(config, devId),
+    healthCheck,
+    traefik: buildTraefikConfig(
+      config,
+      devId,
+      scopeForHealthAndTraefik,
+      remoteServer,
+      healthCheck.path
+    ),
     ...buildRequiresConfig(config)
   };
 }
@@ -230,127 +334,6 @@ function buildNetworksConfig(config) {
   return { databases: config.requires?.databases || config.databases || [] };
 }
 
-/** Reads and parses .env file. @param {string} envPath - Path to .env file. @returns {Promise<Object>} env vars. @throws {Error} If file not found. */
-async function readEnvFile(envPath) {
-  if (!fsSync.existsSync(envPath)) {
-    throw new Error(`.env file not found: ${envPath}`);
-  }
-
-  try {
-    const envContent = await fs.readFile(envPath, 'utf8');
-    if (envContent === undefined || envContent === null) {
-      throw new Error('Failed to read .env file: file content is empty or undefined');
-    }
-    const lines = envContent.split('\n');
-    const envVars = {};
-
-    for (const line of lines) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith('#')) {
-        continue;
-      }
-
-      const equalIndex = trimmed.indexOf('=');
-      if (equalIndex > 0) {
-        const key = trimmed.substring(0, equalIndex).trim();
-        const value = trimmed.substring(equalIndex + 1).trim();
-        envVars[key] = value;
-      }
-    }
-
-    return envVars;
-  } catch (error) {
-    throw new Error(`Failed to read .env file: ${error.message}`);
-  }
-}
-
-/**
- * Validates and extracts password from environment variables
- * @function extractPassword
- * @param {Object} envVars - Environment variables
- * @param {string} passwordKey - Password key to look up
- * @param {Object} [context] - Optional: { appKey, multi } for clearer error messages
- * @returns {string} Password value
- * @throws {Error} If password is missing or empty
- */
-function extractPassword(envVars, passwordKey, context = {}) {
-  const { appKey, multi } = context;
-  const appSuffix = appKey ? ` for application '${appKey}'` : '';
-
-  if (!(passwordKey in envVars)) {
-    throw new Error(multi && appKey ? formatMissingDbPasswordError(appKey, { multiDb: true, passwordKey }) : 'Missing required password variable ' + passwordKey + ' in .env file' + appSuffix + '. Add ' + passwordKey + '=your_secret to your .env file.');
-  }
-
-  const password = envVars[passwordKey].trim();
-  if (!password || password.length === 0) {
-    throw new Error('Password variable ' + passwordKey + ' is empty in .env file' + appSuffix + '. Set a non-empty value.');
-  }
-
-  return password;
-}
-
-/**
- * Processes multiple databases
- * @function processMultipleDatabases
- * @param {Array} databases - Array of database configurations
- * @param {Object} envVars - Environment variables
- * @param {string} appKey - Application key
- * @returns {Object} Object with passwords map and array
- */
-function processMultipleDatabases(databases, envVars, appKey) {
-  const passwords = {};
-  const passwordsArray = [];
-  for (let i = 0; i < databases.length; i++) {
-    const db = databases[i];
-    const dbName = db.name || appKey;
-    const passwordKey = `DB_${i}_PASSWORD`;
-    const password = extractPassword(envVars, passwordKey, { appKey, multi: true });
-    passwords[dbName] = password;
-    passwordsArray.push(password);
-  }
-  return { passwords, passwordsArray };
-}
-
-/**
- * Processes single database case
- * @function processSingleDatabase
- * @param {Object} envVars - Environment variables
- * @param {string} appKey - Application key
- * @returns {Object} Object with passwords map and array
- */
-function processSingleDatabase(envVars, appKey) {
-  const passwords = {};
-  const passwordsArray = [];
-  const passwordKey = ('DB_0_PASSWORD' in envVars) ? 'DB_0_PASSWORD' : 'DB_PASSWORD';
-  if (!(passwordKey in envVars)) {
-    throw new Error(formatMissingDbPasswordError(appKey));
-  }
-  const password = extractPassword(envVars, passwordKey, { appKey });
-  passwords[appKey] = password;
-  passwordsArray.push(password);
-  return { passwords, passwordsArray };
-}
-
-/**
- * Reads database passwords from .env file
- * @async
- * @function readDatabasePasswords
- * @param {string} envPath - Path to .env file
- * @param {Array<Object>} databases - Array of database configurations
- * @param {string} appKey - Application key (fallback for single database)
- * @returns {Promise<Object>} Object with passwords map and array
- * @throws {Error} If required password variables are missing
- */
-async function readDatabasePasswords(envPath, databases, appKey) {
-  const envVars = await readEnvFile(envPath);
-  if (databases && databases.length > 0) {
-    const { passwords, passwordsArray } = processMultipleDatabases(databases, envVars, appKey);
-    return { map: passwords, array: passwordsArray };
-  }
-  const { passwords, passwordsArray } = processSingleDatabase(envVars, appKey);
-  return { map: passwords, array: passwordsArray };
-}
-
 /**
  * Gets developer ID and calculates numeric ID
  * @async
@@ -370,131 +353,54 @@ async function getDeveloperIdAndNumeric() {
  * @param {number} idNum - Numeric developer ID
  * @returns {Object} Object with networkName and containerName
  */
-function buildNetworkAndContainerNames(appName, devId, idNum) {
+function buildNetworkAndContainerNames(appName, devId, idNum, scopeOpts = null) {
   const networkName = idNum === 0 ? 'infra-aifabrix-network' : `infra-dev${devId}-aifabrix-network`;
-  const containerName = idNum === 0 ? `aifabrix-${appName}` : `aifabrix-dev${devId}-${appName}`;
+  let containerName;
+  if (
+    scopeOpts &&
+    scopeOpts.effectiveEnvironmentScopedResources &&
+    scopeOpts.runEnvKey &&
+    (scopeOpts.runEnvKey === 'dev' || scopeOpts.runEnvKey === 'tst')
+  ) {
+    containerName = buildScopedLocalContainerName(appName, devId, idNum, scopeOpts.runEnvKey);
+  } else {
+    containerName = idNum === 0 ? `aifabrix-${appName}` : `aifabrix-dev${devId}-${appName}`;
+  }
   return { networkName, containerName };
 }
 
-/**
- * Reads database passwords if needed
- * @async
- * @function readDatabasePasswordsIfNeeded
- * @param {boolean} requiresDatabase - Whether database is required
- * @param {Array} databases - Array of databases
- * @param {string} envFilePath - Environment file path
- * @param {string} appName - Application name
- * @returns {Promise<Object>} Database passwords object
- */
-async function readDatabasePasswordsIfNeeded(requiresDatabase, databases, envFilePath, appName) {
-  if (requiresDatabase || databases.length > 0) {
-    return await readDatabasePasswords(envFilePath, databases, appName);
+const { createGenerateDockerCompose } = require('./compose-generate-docker-compose');
+async function getRemoteServerForCompose() {
+  try {
+    const rs = await config.getRemoteServer();
+    return rs && String(rs).trim() ? String(rs).trim() : null;
+  } catch {
+    return null;
   }
-  return { map: {}, array: [] };
-}
-
-/**
- * Resolves image override from options (--image, --tag, or null).
- * @param {Object} options - Run options
- * @param {Object} appConfig - Application configuration
- * @param {string} appName - Application name
- * @returns {string|null} Full image reference or null
- */
-function resolveImageOverride(options, appConfig, appName) {
-  if (options.image) return options.image;
-  if (options.imageOverride) return options.imageOverride;
-  if (options.tag) return `${getImageName(appConfig, appName)}:${options.tag}`;
-  return null;
-}
-
-/**
- * Resolves Miso environment from options (tst, pro, or dev).
- * @param {Object} options - Run options
- * @returns {string} 'dev' | 'tst' | 'pro'
- */
-function resolveMisoEnvironment(options) {
-  const env = (options.env && typeof options.env === 'string') ? options.env.toLowerCase() : 'dev';
-  return (env === 'tst' || env === 'pro') ? env : 'dev';
 }
 
-/**
- * Resolves dev mount path from options.
- * @param {Object} options - Run options
- * @returns {string|null} Trimmed path or null
- */
-function resolveDevMountPath(options) {
-  return (options.devMountPath && typeof options.devMountPath === 'string') ? options.devMountPath.trim() : null;
-}
-
-/**
- * Resolves env file path from options or default dev dir (forward slashes).
- * @param {Object} options - Run options
- * @param {string} devDir - Default dev directory
- * @returns {string} Absolute env file path
- */
-function resolveEnvFilePath(options, devDir) {
-  const envFilePath = (options.envFilePath && typeof options.envFilePath === 'string')
-    ? path.resolve(options.envFilePath)
-    : path.join(devDir, '.env');
-  return envFilePath.replace(/\\/g, '/');
-}
-
-/**
- * Generates Docker Compose configuration from template
- * @async
- * @function generateDockerCompose
- * @param {string} appName - Application name
- * @param {Object} appConfig - Application configuration
- * @param {Object} options - Run options
- * @returns {Promise<string>} Generated compose content
- */
-async function generateDockerCompose(appName, appConfig, options) {
-  const language = appConfig.build?.language || appConfig.language || 'typescript';
-  const template = loadDockerComposeTemplate(language);
-  const port = options.port || appConfig.port || 3000;
-  const imageOverride = resolveImageOverride(options, appConfig, appName);
-  const { devId, idNum } = await getDeveloperIdAndNumeric();
-  const { networkName, containerName } = buildNetworkAndContainerNames(appName, devId, idNum);
-  const serviceConfig = buildServiceConfig(appName, appConfig, port, devId, imageOverride);
-  const volumesConfig = buildVolumesConfig(appName);
-  const networksConfig = buildNetworksConfig(appConfig);
-
-  const devDir = buildCopy.getDevDirectory(appName, devId);
-  const envFileAbsolutePath = resolveEnvFilePath(options, devDir);
-  const dbInitEnvFileAbsolutePath = (options.dbInitEnvFilePath && typeof options.dbInitEnvFilePath === 'string')
-    ? path.resolve(options.dbInitEnvFilePath).replace(/\\/g, '/')
-    : null;
-
-  const databasePasswords = await readDatabasePasswordsIfNeeded(
-    serviceConfig.requiresDatabase || false,
-    networksConfig.databases || [],
-    envFileAbsolutePath,
-    appName
-  );
-  const devMountPath = resolveDevMountPath(options);
-  const reloadStartRaw = appConfig.build?.reloadStart;
-  const reloadStartCommand =
-    devMountPath && typeof reloadStartRaw === 'string' && reloadStartRaw.trim().length > 0
-      ? reloadStartRaw.trim()
-      : null;
-
-  const infraPgpassPath = path.join(paths.getAifabrixHome(), getInfraDirName(devId), 'pgpass');
-  const useInfraPgpass = serviceConfig.requiresDatabase && fsSync.existsSync(infraPgpassPath);
-  return template({
-    ...serviceConfig,
-    ...volumesConfig,
-    ...networksConfig,
-    envFile: envFileAbsolutePath,
-    dbInitEnvFile: dbInitEnvFileAbsolutePath,
-    databasePasswords,
-    devId: idNum,
-    networkName,
-    containerName,
-    misoEnvironment: resolveMisoEnvironment(options),
-    devMountPath,
-    reloadStartCommand,
-    infraPgpassPath: useInfraPgpass ? infraPgpassPath : null,
-    useInfraPgpass: !!useInfraPgpass
-  });
-}
-module.exports = { generateDockerCompose, getImageName, derivePathFromPattern, buildTraefikConfig, buildDevUsername, isVectorDatabaseName };
+const generateDockerCompose = createGenerateDockerCompose({
+  loadDockerComposeTemplate,
+  resolveComposeImageOverrideString,
+  getDeveloperIdAndNumeric,
+  getRemoteServerForCompose,
+  buildNetworkAndContainerNames,
+  buildServiceConfig,
+  buildVolumesConfig,
+  buildNetworksConfig,
+  readDatabasePasswords
+});
+
+module.exports = {
+  generateDockerCompose,
+  getImageName,
+  derivePathFromPattern,
+  buildTraefikConfig,
+  computeAlignedHealthCheckPath,
+  resolveHealthCheckPathWithFrontDoorVdir,
+  buildDevUsername,
+  buildDevUsernameForFrontDoorHost,
+  expandFrontDoorHostPlaceholders,
+  isVectorDatabaseName,
+  resolveMisoEnvironment
+};

package/lib/utils/compose-miso-env.js

@@ -0,0 +1,18 @@
+/**
+ * MISO_ENVIRONMENT value for generated compose / docker run.
+ *
+ * @fileoverview Extracted from compose-generator to respect max-lines
+ */
+
+'use strict';
+
+/**
+ * @param {Object} options - Run options
+ * @returns {'dev'|'tst'|'pro'}
+ */
+function resolveMisoEnvironment(options) {
+  const env = (options.env && typeof options.env === 'string') ? options.env.toLowerCase() : 'dev';
+  return (env === 'tst' || env === 'pro') ? env : 'dev';
+}
+
+module.exports = { resolveMisoEnvironment };