@jahia/jahia-cli 0.1.4 → 0.3.0

package/dist/lib/config/parser.js

@@ -0,0 +1,281 @@
+import { readFile } from 'node:fs/promises';
+import yaml from 'js-yaml';
+import { getComponent, resolveComponent } from '../components/index.js';
+import { DEFAULT_PROVIDER, DEFAULT_SCAFFOLDING_PATH, DEFAULT_SCAFFOLDING_REPOSITORY, DEFAULT_SCAFFOLDING_VERSION, generateEnvName, } from './defaults.js';
+import { resolveEnvVars, resolveEnvVarsInRecord } from './resolve-env-vars.js';
+/**
+ * Parses and validates the optional scaffolding section within tests.
+ */
+export const parseScaffoldingConfig = (rawScaffolding) => {
+    if (typeof rawScaffolding !== 'object' || rawScaffolding === null || Array.isArray(rawScaffolding)) {
+        throw new Error('Configuration "tests.scaffolding" must be an object when provided.');
+    }
+    const record = rawScaffolding;
+    if (record['repository'] !== undefined && typeof record['repository'] !== 'string') {
+        throw new Error('Configuration "tests.scaffolding.repository" must be a string when provided.');
+    }
+    if (record['path'] !== undefined && typeof record['path'] !== 'string') {
+        throw new Error('Configuration "tests.scaffolding.path" must be a string when provided.');
+    }
+    if (record['version'] !== undefined && typeof record['version'] !== 'string') {
+        throw new Error('Configuration "tests.scaffolding.version" must be a string when provided.');
+    }
+    return {
+        repository: typeof record['repository'] === 'string' ? record['repository'] : DEFAULT_SCAFFOLDING_REPOSITORY,
+        path: typeof record['path'] === 'string' ? record['path'] : DEFAULT_SCAFFOLDING_PATH,
+        version: typeof record['version'] === 'string' ? record['version'] : DEFAULT_SCAFFOLDING_VERSION,
+    };
+};
+/**
+ * Parses and validates the optional tests.container section.
+ * All fields are optional — only provided values are included.
+ * String values support ${VAR:-default} env var resolution.
+ */
+export const parseTestContainerConfig = (rawContainer) => {
+    if (rawContainer === undefined) {
+        return undefined;
+    }
+    if (typeof rawContainer !== 'object' || rawContainer === null || Array.isArray(rawContainer)) {
+        throw new Error('Configuration "tests.container" must be an object when provided.');
+    }
+    const record = rawContainer;
+    if (record['dockerfile'] !== undefined && typeof record['dockerfile'] !== 'string') {
+        throw new Error('Configuration "tests.container.dockerfile" must be a string when provided.');
+    }
+    if (record['image'] !== undefined && typeof record['image'] !== 'string') {
+        throw new Error('Configuration "tests.container.image" must be a string when provided.');
+    }
+    if (record['tag'] !== undefined && typeof record['tag'] !== 'string') {
+        throw new Error('Configuration "tests.container.tag" must be a string when provided.');
+    }
+    if (record['platform'] !== undefined && typeof record['platform'] !== 'string') {
+        throw new Error('Configuration "tests.container.platform" must be a string when provided.');
+    }
+    if (record['buildArgs'] !== undefined) {
+        if (typeof record['buildArgs'] !== 'object' || record['buildArgs'] === null || Array.isArray(record['buildArgs'])) {
+            throw new Error('Configuration "tests.container.buildArgs" must be an object when provided.');
+        }
+    }
+    const config = {
+        ...(record['dockerfile'] !== undefined ? { dockerfile: record['dockerfile'] } : {}),
+        ...(record['image'] !== undefined ? { image: resolveEnvVars(record['image']) } : {}),
+        ...(record['tag'] !== undefined ? { tag: resolveEnvVars(record['tag']) } : {}),
+        ...(record['platform'] !== undefined ? { platform: record['platform'] } : {}),
+        ...(record['buildArgs'] !== undefined ? { buildArgs: resolveEnvVarsInRecord(record['buildArgs']) } : {}),
+    };
+    return Object.keys(config).length > 0 ? config : undefined;
+};
+/**
+ * Parses and validates the optional tests section.
+ */
+export const parseTestsConfig = (rawTests) => {
+    if (rawTests === undefined) {
+        return undefined;
+    }
+    if (typeof rawTests !== 'object' || rawTests === null || Array.isArray(rawTests)) {
+        throw new Error('Configuration "tests" field must be an object when provided.');
+    }
+    const testsRecord = rawTests;
+    const jahiaCypress = testsRecord['jahia-cypress'];
+    if (jahiaCypress !== undefined && typeof jahiaCypress !== 'string') {
+        throw new Error('Configuration "tests.jahia-cypress" must be a string when provided.');
+    }
+    const scaffolding = testsRecord['scaffolding'] !== undefined
+        ? parseScaffoldingConfig(testsRecord['scaffolding'])
+        : undefined;
+    const container = parseTestContainerConfig(testsRecord['container']);
+    return {
+        ...(jahiaCypress === undefined ? {} : { 'jahia-cypress': jahiaCypress }),
+        ...(scaffolding === undefined ? {} : { scaffolding }),
+        ...(container === undefined ? {} : { container }),
+    };
+};
+/**
+ * Resolves environment variable substitution in component overrides.
+ * Applies `${VAR}` and `${VAR:-default}` resolution to `image`, `tag`,
+ * and `env` values — the same env vars available in workflow `run:` steps.
+ */
+export const resolveComponentOverrides = (rawOverrides) => {
+    const result = { ...rawOverrides };
+    if (typeof result['image'] === 'string') {
+        result['image'] = resolveEnvVars(result['image']);
+    }
+    if (typeof result['tag'] === 'string') {
+        result['tag'] = resolveEnvVars(result['tag']);
+    }
+    if (result['env'] !== undefined &&
+        typeof result['env'] === 'object' &&
+        result['env'] !== null &&
+        !Array.isArray(result['env'])) {
+        result['env'] = resolveEnvVarsInRecord(result['env']);
+    }
+    return result;
+};
+/**
+ * Validates and parses a raw environment section into a typed EnvironmentConfig.
+ * Throws descriptive errors for invalid configurations.
+ */
+export const validateEnvironmentConfig = (raw) => {
+    const name = typeof raw.name === 'string' ? raw.name : generateEnvName();
+    const provider = typeof raw.provider === 'string' ? raw.provider : DEFAULT_PROVIDER;
+    if (!Array.isArray(raw.components) || raw.components.length === 0) {
+        throw new Error('Configuration "environment" must include at least one component in the "components" array.');
+    }
+    const components = raw.components.map((entry, index) => {
+        if (typeof entry === 'string') {
+            return { name: entry };
+        }
+        if (typeof entry === 'object' && entry !== null && 'name' in entry) {
+            const obj = entry;
+            if (typeof obj['name'] !== 'string') {
+                throw new Error(`Component at index ${String(index)} must have a string "name" field.`);
+            }
+            const rawOverrides = obj['overrides'];
+            const resolvedOverrides = rawOverrides !== undefined
+                ? resolveComponentOverrides(rawOverrides)
+                : undefined;
+            return {
+                name: obj['name'],
+                overrides: resolvedOverrides,
+            };
+        }
+        throw new Error(`Component at index ${String(index)} must be a string or an object with a "name" field.`);
+    });
+    return { name, provider, components };
+};
+/**
+ * Validates a single workflow step entry.
+ * Each step must have either `run` (shell command) or `uses` (CLI command), not both.
+ */
+export const validateWorkflowStep = (raw, index) => {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new Error(`Workflow step at index ${String(index)} must be an object.`);
+    }
+    const record = raw;
+    const name = typeof record['name'] === 'string' ? record['name'] : undefined;
+    const run = typeof record['run'] === 'string' ? record['run'] : undefined;
+    const uses = typeof record['uses'] === 'string' ? record['uses'] : undefined;
+    const workingDir = typeof record['working_dir'] === 'string' ? record['working_dir'] : undefined;
+    if (run === undefined && uses === undefined) {
+        throw new Error(`Workflow step at index ${String(index)} must have either "run" (shell command) or "uses" (CLI command).`);
+    }
+    if (run !== undefined && uses !== undefined) {
+        throw new Error(`Workflow step at index ${String(index)} must have either "run" or "uses", not both.`);
+    }
+    const withRecord = record['with'] !== undefined && typeof record['with'] === 'object' && record['with'] !== null && !Array.isArray(record['with'])
+        ? record['with']
+        : undefined;
+    return {
+        ...(name === undefined ? {} : { name }),
+        ...(run === undefined ? {} : { run }),
+        ...(uses === undefined ? {} : { uses }),
+        ...(withRecord === undefined ? {} : { with: withRecord }),
+        ...(workingDir === undefined ? {} : { working_dir: workingDir }),
+    };
+};
+/**
+ * Parses and validates a single named workflow entry (the value under a workflow name key).
+ */
+export const parseSingleWorkflow = (rawWorkflow, name) => {
+    if (typeof rawWorkflow !== 'object' || rawWorkflow === null || Array.isArray(rawWorkflow)) {
+        throw new Error(`Workflow "${name}" must be an object.`);
+    }
+    const record = rawWorkflow;
+    if (!Array.isArray(record['steps'])) {
+        throw new Error(`Workflow "${name}" must include a "steps" array.`);
+    }
+    if (record['steps'].length === 0) {
+        throw new Error(`Workflow "${name}.steps" must contain at least one step.`);
+    }
+    const steps = record['steps'].map((entry, index) => validateWorkflowStep(entry, index));
+    const isDefault = record['default'] === true ? true : undefined;
+    return {
+        ...(isDefault === undefined ? {} : { default: isDefault }),
+        steps,
+    };
+};
+/**
+ * Parses and validates the optional workflows section.
+ * Expects a map of named workflows. At most one may have `default: true`.
+ */
+export const parseWorkflowsConfig = (rawWorkflows) => {
+    if (rawWorkflows === undefined) {
+        return undefined;
+    }
+    if (typeof rawWorkflows !== 'object' || rawWorkflows === null || Array.isArray(rawWorkflows)) {
+        throw new Error('Configuration "workflows" field must be a map of named workflows.');
+    }
+    const entries = Object.entries(rawWorkflows);
+    if (entries.length === 0) {
+        throw new Error('Configuration "workflows" must contain at least one named workflow.');
+    }
+    const workflows = {};
+    const defaultNames = [];
+    entries.forEach(([name, value]) => {
+        const workflow = parseSingleWorkflow(value, name);
+        workflows[name] = workflow;
+        if (workflow.default === true) {
+            defaultNames.push(name);
+        }
+    });
+    if (defaultNames.length > 1) {
+        throw new Error(`Only one workflow may have "default: true". Found ${String(defaultNames.length)}: ${defaultNames.join(', ')}`);
+    }
+    return workflows;
+};
+/**
+ * Validates and parses a raw YAML object into a typed JahiaCliConfig.
+ * All sections (environment, tests, workflows) are optional — commands validate
+ * the presence of the sections they need.
+ *
+ * Detects the legacy `workflow:` key and provides a migration error.
+ */
+export const validateConfig = (raw) => {
+    if (raw.workflow !== undefined) {
+        throw new Error('Configuration uses the deprecated "workflow:" key.\n' +
+            'Rename it to "workflows:" and wrap your workflow in a named entry.\n\n' +
+            '  Before:\n' +
+            '    workflow:\n' +
+            '      steps: [...]\n\n' +
+            '  After:\n' +
+            '    workflows:\n' +
+            '      main:\n' +
+            '        default: true\n' +
+            '        steps: [...]');
+    }
+    const rawEnv = raw.environment !== undefined && typeof raw.environment === 'object' && raw.environment !== null
+        ? raw.environment
+        : undefined;
+    // Only validate environment if it has a non-empty components array.
+    // Commands that require environment will check for its presence themselves.
+    const environment = rawEnv !== undefined && Array.isArray(rawEnv.components) && rawEnv.components.length > 0
+        ? validateEnvironmentConfig(rawEnv)
+        : undefined;
+    const tests = parseTestsConfig(raw.tests);
+    const workflows = parseWorkflowsConfig(raw.workflows);
+    return {
+        ...(environment === undefined ? {} : { environment }),
+        ...(tests === undefined ? {} : { tests }),
+        ...(workflows === undefined ? {} : { workflows }),
+    };
+};
+/**
+ * Loads and parses a YAML config file from disk.
+ */
+export const loadConfigFile = async (filePath) => {
+    const content = await readFile(filePath, 'utf-8');
+    const raw = yaml.load(content);
+    return validateConfig(raw);
+};
+/**
+ * Resolves all components in a config to their full definitions with overrides applied.
+ * Throws if any component name is not found in the registry.
+ */
+export const resolveConfigComponents = (config) => config.components.map((entry) => {
+    const definition = getComponent(entry.name);
+    if (!definition) {
+        throw new Error(`Unknown component "${entry.name}". Use "jahia-cli environment create --help" to see available components.`);
+    }
+    return resolveComponent(definition, entry.overrides);
+});
+//# sourceMappingURL=parser.js.map

package/dist/lib/config/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/lib/config/parser.ts"],"names":[],"mappings":"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"}

package/dist/lib/config/resolve-env-vars.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Environment variable substitution for config values.
+ *
+ * Supports two patterns:
+ *   - `${VAR}` — resolves to the value of VAR; throws if VAR is not set
+ *   - `${VAR:-default}` — resolves to VAR if set, otherwise uses the default value
+ *
+ * This is consistent with bash variable expansion and with how the workflow
+ * engine passes environment variables to `run:` steps via `process.env`.
+ * All env vars come from the same source: the shell session's environment.
+ *
+ * Bare `$` characters and malformed patterns are left as-is.
+ */
+/**
+ * Resolves `${VAR}` and `${VAR:-default}` patterns in a string
+ * using `process.env`.
+ *
+ * - `${VAR}` with no default throws if VAR is not defined in the environment.
+ * - `${VAR:-default}` falls back to `default` when VAR is not defined.
+ * - Patterns are resolved in a single pass (no nested resolution).
+ * - Bare `$` characters and malformed patterns are left unchanged.
+ */
+export declare const resolveEnvVars: (value: string) => string;
+/**
+ * Applies `resolveEnvVars` to every value in a string record.
+ * Returns a new record with all values resolved.
+ */
+export declare const resolveEnvVarsInRecord: (record: Readonly<Record<string, string>>) => Readonly<Record<string, string>>;
+//# sourceMappingURL=resolve-env-vars.d.ts.map

package/dist/lib/config/resolve-env-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-env-vars.d.ts","sourceRoot":"","sources":["../../../src/lib/config/resolve-env-vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAiB3C,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACvC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG/B,CAAC"}

package/dist/lib/config/resolve-env-vars.js

@@ -0,0 +1,47 @@
+/**
+ * Environment variable substitution for config values.
+ *
+ * Supports two patterns:
+ *   - `${VAR}` — resolves to the value of VAR; throws if VAR is not set
+ *   - `${VAR:-default}` — resolves to VAR if set, otherwise uses the default value
+ *
+ * This is consistent with bash variable expansion and with how the workflow
+ * engine passes environment variables to `run:` steps via `process.env`.
+ * All env vars come from the same source: the shell session's environment.
+ *
+ * Bare `$` characters and malformed patterns are left as-is.
+ */
+/**
+ * Regex matching `${VAR}` and `${VAR:-default}` patterns.
+ * Captures:
+ *   [1] = variable name (letters, digits, underscores)
+ *   [2] = default value (everything after `:-`, may be empty string)
+ */
+const ENV_VAR_PATTERN = /\$\{([A-Za-z_]\w*)(?::-(.*?))?\}/g;
+/**
+ * Resolves `${VAR}` and `${VAR:-default}` patterns in a string
+ * using `process.env`.
+ *
+ * - `${VAR}` with no default throws if VAR is not defined in the environment.
+ * - `${VAR:-default}` falls back to `default` when VAR is not defined.
+ * - Patterns are resolved in a single pass (no nested resolution).
+ * - Bare `$` characters and malformed patterns are left unchanged.
+ */
+export const resolveEnvVars = (value) => value.replace(ENV_VAR_PATTERN, (match, varName, defaultValue) => {
+    const envValue = process.env[varName];
+    if (envValue !== undefined) {
+        return envValue;
+    }
+    if (defaultValue !== undefined) {
+        return defaultValue;
+    }
+    throw new Error(`Environment variable "${varName}" is not set and no default was provided. ` +
+        `Use \${${varName}:-default_value} to provide a fallback, ` +
+        `or set the variable in your shell: export ${varName}=value`);
+});
+/**
+ * Applies `resolveEnvVars` to every value in a string record.
+ * Returns a new record with all values resolved.
+ */
+export const resolveEnvVarsInRecord = (record) => Object.fromEntries(Object.entries(record).map(([key, value]) => [key, resolveEnvVars(value)]));
+//# sourceMappingURL=resolve-env-vars.js.map

package/dist/lib/config/resolve-env-vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-env-vars.js","sourceRoot":"","sources":["../../../src/lib/config/resolve-env-vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE,CACtD,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,YAAgC,EAAE,EAAE;IAC1F,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yBAAyB,OAAO,4CAA4C;QAC5E,UAAU,OAAO,0CAA0C;QAC3D,6CAA6C,OAAO,QAAQ,CAC7D,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAwC,EACN,EAAE,CACpC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAC3E,CAAC"}

package/dist/lib/config/types.d.ts

@@ -0,0 +1,120 @@
+import type { ComponentOverrides } from '../components/types.js';
+/**
+ * A component entry in a YAML config file.
+ */
+export interface ConfigComponent {
+    readonly name: string;
+    readonly overrides?: ComponentOverrides | undefined;
+}
+/**
+ * Scaffolding source configuration for test initialization.
+ */
+export interface ScaffoldingConfig {
+    readonly repository: string;
+    readonly path: string;
+    readonly version: string;
+}
+/**
+ * Test framework configuration metadata.
+ */
+export interface TestsConfig {
+    readonly 'jahia-cypress'?: string | undefined;
+    readonly scaffolding?: ScaffoldingConfig | undefined;
+    /**
+     * Test container build and run configuration.
+     *
+     * All fields are optional — sensible defaults are used when omitted.
+     * This keeps config files minimal while allowing full control when needed.
+     *
+     * Available options:
+     *   dockerfile  — Path to the Dockerfile (default: "docker/Dockerfile.local")
+     *   image       — Image name for the built test image (default: "jahia-tests")
+     *                 Supports ${VAR:-default} env var substitution.
+     *   tag         — Image tag (default: scaffolding version from tests.scaffolding.version)
+     *                 Supports ${VAR:-default} env var substitution.
+     *   platform    — Target platform for buildx (e.g. "linux/amd64").
+     *                 Defaults to current platform when omitted.
+     *   buildArgs   — Extra Docker build args as key-value pairs.
+     *                 Values support ${VAR:-default} env var substitution.
+     *
+     * Example in YAML:
+     *   tests:
+     *     container:
+     *       image: "${TEST_IMAGE:-jahia-tests}"
+     *       tag: "${TEST_TAG:-latest}"
+     *       platform: linux/amd64
+     *       buildArgs:
+     *         CYPRESS_VERSION: "13.0.0"
+     */
+    readonly container?: TestContainerConfig | undefined;
+}
+/**
+ * Configuration for the test container image build and execution.
+ * All fields are optional — defaults from the cypress component and
+ * build-image module are used when omitted.
+ */
+export interface TestContainerConfig {
+    readonly dockerfile?: string | undefined;
+    readonly image?: string | undefined;
+    readonly tag?: string | undefined;
+    readonly platform?: string | undefined;
+    readonly buildArgs?: Readonly<Record<string, string>> | undefined;
+}
+/**
+ * The environment section of the configuration file.
+ */
+export interface EnvironmentConfig {
+    readonly name: string;
+    readonly provider: string;
+    readonly components: readonly ConfigComponent[];
+}
+/**
+ * A single step in a workflow.
+ * Either `run` (shell command) or `uses` (jahia-cli command) must be provided.
+ */
+export interface WorkflowStep {
+    readonly name?: string | undefined;
+    readonly run?: string | undefined;
+    readonly uses?: string | undefined;
+    readonly with?: Readonly<Record<string, string>> | undefined;
+    readonly working_dir?: string | undefined;
+}
+/**
+ * A single named workflow in the configuration file.
+ * May be marked as the default workflow to run when --name is omitted.
+ */
+export interface WorkflowConfig {
+    readonly default?: boolean | undefined;
+    readonly steps: readonly WorkflowStep[];
+}
+/**
+ * A map of named workflows keyed by workflow name.
+ */
+export type WorkflowsMap = Readonly<Record<string, WorkflowConfig>>;
+/**
+ * The top-level Jahia CLI configuration file structure.
+ * Contains `environment`, `tests`, and `workflows` as distinct top-level sections.
+ */
+export interface JahiaCliConfig {
+    readonly environment?: EnvironmentConfig | undefined;
+    readonly tests?: TestsConfig | undefined;
+    readonly workflows?: WorkflowsMap | undefined;
+}
+/**
+ * Raw YAML structure before validation (loose types for parsing).
+ */
+export interface RawConfig {
+    readonly environment?: unknown;
+    readonly tests?: unknown;
+    readonly workflows?: unknown;
+    readonly workflow?: unknown;
+}
+/**
+ * Raw environment section before validation.
+ */
+export interface RawEnvironmentConfig {
+    readonly name?: unknown;
+    readonly provider?: unknown;
+    readonly components?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/config/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/config/types.ts"],"names":[],"mappings":""}

package/dist/lib/config/with-tests-version.d.ts

@@ -0,0 +1,6 @@
+import type { JahiaCliConfig } from './types.js';
+/**
+ * Returns a config enriched with the jahia-cypress tests version metadata.
+ */
+export declare const withTestsVersion: (config: JahiaCliConfig, version: string) => JahiaCliConfig;
+//# sourceMappingURL=with-tests-version.d.ts.map

package/dist/lib/config/with-tests-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-tests-version.d.ts","sourceRoot":"","sources":["../../../src/lib/config/with-tests-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,cAAc,EAAE,SAAS,MAAM,KAAG,cAMzE,CAAC"}

package/dist/lib/config/with-tests-version.js

@@ -0,0 +1,11 @@
+/**
+ * Returns a config enriched with the jahia-cypress tests version metadata.
+ */
+export const withTestsVersion = (config, version) => ({
+    ...config,
+    tests: {
+        ...(config.tests ?? {}),
+        'jahia-cypress': version,
+    },
+});
+//# sourceMappingURL=with-tests-version.js.map

package/dist/lib/config/with-tests-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-tests-version.js","sourceRoot":"","sources":["../../../src/lib/config/with-tests-version.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAsB,EAAE,OAAe,EAAkB,EAAE,CAAC,CAAC;IAC5F,GAAG,MAAM;IACT,KAAK,EAAE;QACL,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACvB,eAAe,EAAE,OAAO;KACzB;CACF,CAAC,CAAC"}

package/dist/lib/output/formatter.d.ts

@@ -0,0 +1,38 @@
+import type { CreateResult, HealthCheckResult } from '../providers/types.js';
+/**
+ * Formats a create result for human-readable terminal output.
+ */
+export declare const formatCreateResultHuman: (result: CreateResult) => string;
+/**
+ * Formats a create result as structured JSON for AI agent consumption.
+ * Includes stateFile path when provided.
+ */
+export declare const formatCreateResultJson: (result: CreateResult, stateFile?: string) => string;
+/**
+ * Formats a health check result for human-readable terminal output.
+ */
+export declare const formatHealthCheckHuman: (result: HealthCheckResult) => string;
+/**
+ * Formats a health check result as structured JSON for AI agent consumption.
+ * Includes stateFile path when provided.
+ */
+export declare const formatHealthCheckJson: (result: HealthCheckResult, stateFile?: string) => string;
+/**
+ * Formats a list of reconciled components for human-readable terminal output.
+ * Used by the `environment list` command.
+ */
+export declare const formatEnvironmentListHuman: (params: {
+    readonly name: string;
+    readonly provider: string;
+    readonly network: string;
+    readonly createdAt: string;
+    readonly status: string;
+    readonly components: readonly {
+        readonly name: string;
+        readonly image: string;
+        readonly tag: string;
+        readonly containerId: string;
+        readonly liveStatus: string;
+    }[];
+}) => string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/lib/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/lib/output/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AA+E9F;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,YAAY,KAAG,MAiD9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,YAAY,EAAE,YAAY,MAAM,KAAG,MAsBjF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,iBAAiB,KAAG,MAwBlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,iBAAiB,EAAE,YAAY,MAAM,KAAG,MAUnF,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS;QAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,EAAE,CAAC;CACL,KAAG,MAmBH,CAAC"}