@jahia/jahia-cli 0.1.4 → 0.2.0

package/dist/lib/config/build-blank-config.d.ts

@@ -0,0 +1,6 @@
+import type { JahiaCliConfig } from './types.js';
+/**
+ * Builds a blank Jahia CLI configuration scaffold.
+ */
+export declare const buildBlankConfig: () => JahiaCliConfig;
+//# sourceMappingURL=build-blank-config.d.ts.map

package/dist/lib/config/build-blank-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-blank-config.d.ts","sourceRoot":"","sources":["../../../src/lib/config/build-blank-config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,cAalC,CAAC"}

package/dist/lib/config/build-blank-config.js

@@ -0,0 +1,19 @@
+import { DEFAULT_PROVIDER, DEFAULT_SCAFFOLDING_PATH, DEFAULT_SCAFFOLDING_REPOSITORY, DEFAULT_SCAFFOLDING_VERSION, generateEnvName, } from './defaults.js';
+/**
+ * Builds a blank Jahia CLI configuration scaffold.
+ */
+export const buildBlankConfig = () => ({
+    environment: {
+        name: generateEnvName(),
+        provider: DEFAULT_PROVIDER,
+        components: [],
+    },
+    tests: {
+        scaffolding: {
+            repository: DEFAULT_SCAFFOLDING_REPOSITORY,
+            path: DEFAULT_SCAFFOLDING_PATH,
+            version: DEFAULT_SCAFFOLDING_VERSION,
+        },
+    },
+});
+//# sourceMappingURL=build-blank-config.js.map

package/dist/lib/config/build-blank-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-blank-config.js","sourceRoot":"","sources":["../../../src/lib/config/build-blank-config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,EAC3B,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAmB,EAAE,CAAC,CAAC;IACrD,WAAW,EAAE;QACX,IAAI,EAAE,eAAe,EAAE;QACvB,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,EAAE;KACf;IACD,KAAK,EAAE;QACL,WAAW,EAAE;YACX,UAAU,EAAE,8BAA8B;YAC1C,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,2BAA2B;SACrC;KACF;CACF,CAAC,CAAC"}

package/dist/lib/config/config-to-yaml-with-comments.d.ts

@@ -0,0 +1,11 @@
+import type { JahiaCliConfig } from './types.js';
+/**
+ * Takes the plain YAML output from configToYaml and inserts section-level
+ * comment headers above each top-level section (environment, tests, workflow).
+ */
+export declare const insertSectionComments: (yamlContent: string) => string;
+/**
+ * Serializes JahiaCliConfig to YAML with section-level documentation comments.
+ */
+export declare const configToYamlWithComments: (config: JahiaCliConfig) => string;
+//# sourceMappingURL=config-to-yaml-with-comments.d.ts.map

package/dist/lib/config/config-to-yaml-with-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-to-yaml-with-comments.d.ts","sourceRoot":"","sources":["../../../src/lib/config/config-to-yaml-with-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmDjD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,MAAM,KAAG,MA2B3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,cAAc,KAAG,MACrB,CAAC"}

package/dist/lib/config/config-to-yaml-with-comments.js

@@ -0,0 +1,75 @@
+import { configToYaml } from './config-to-yaml.js';
+/**
+ * Section-level comment headers for the config file.
+ * Provides lightweight documentation embedded directly in the generated YAML.
+ */
+const ENVIRONMENT_COMMENT = `# ── Environment ──────────────────────────────────────────────────────────
+# Defines the Jahia environment to create via Docker.
+# - name: unique identifier for the environment (auto-generated if omitted)
+# - provider: "docker" (default) or "jahiacloudv1" (future)
+# - components: list of services to start (e.g. jahia, smtp-server)
+#   Each component can be a plain string or an object with overrides:
+#     - jahia                          # uses default image and tag
+#     - { name: jahia, overrides: { tag: "8.3.0.0" } }  # custom version
+#     - { name: jahia, overrides: { image: "jahia/jahia-ee:8.3.0.0" } }
+#     - { name: jahia, overrides: { image: "my-registry.example.com/jahia/jahia-ee:8.3.0.0" } }
+#     - smtp-server                    # Mailpit for email testing
+#
+#   The "image" override accepts the full image:tag format in a single value.
+#   A separate "tag" override takes precedence over the tag embedded in "image".
+#
+#   Overrides support environment variable substitution (resolved at parse time):
+#     \${VAR}            — resolves from process.env; errors if not set
+#     \${VAR:-default}   — resolves from process.env, falls back to default
+#
+#   Example — parameterize the full image reference for CI/CD pipelines:
+#     - name: jahia
+#       overrides:
+#         image: "\${JAHIA_IMAGE:-jahia/jahia-ee:8.2.1.0}"
+#
+#   Env vars are the same ones available in workflow "run:" steps.
+#   Set them in your shell before running jahia-cli:
+#     export JAHIA_IMAGE=jahia/jahia-ee:8.3.0.0 && jahia-cli environment create --config this-file.yml`;
+const TESTS_COMMENT = `# ── Tests ────────────────────────────────────────────────────────────────
+# Configures test scaffolding pulled from a remote Git repository.
+# - scaffolding.repository: Git URL of the test scaffolding source
+# - scaffolding.path: subdirectory within the repo containing scaffolding files
+# - scaffolding.version: Git ref to checkout ("latest" resolves to newest tag)`;
+const WORKFLOW_COMMENT = `# ── Workflow ─────────────────────────────────────────────────────────────
+# Sequential steps executed by "jahia-cli workflow run".
+# Each step is either a shell command (run:) or a jahia-cli command (uses:).
+# - name: human-readable label (optional)
+# - run: shell command executed via execa
+# - uses: jahia-cli command name (e.g. "environment:create")
+# - with: flags passed to the command (e.g. { timeout: "300" })
+# - working_dir: override the working directory for this step
+# Steps run in order; the workflow stops on the first failure.`;
+/**
+ * Takes the plain YAML output from configToYaml and inserts section-level
+ * comment headers above each top-level section (environment, tests, workflow).
+ */
+export const insertSectionComments = (yamlContent) => {
+    const commentMap = {
+        'environment:': ENVIRONMENT_COMMENT,
+        'tests:': TESTS_COMMENT,
+        'workflow:': WORKFLOW_COMMENT,
+    };
+    const lines = yamlContent.split('\n');
+    const result = [];
+    lines.forEach((line) => {
+        const matchedKey = Object.keys(commentMap).find((key) => line.startsWith(key));
+        if (matchedKey !== undefined) {
+            if (result.length > 0) {
+                result.push('');
+            }
+            result.push(commentMap[matchedKey] ?? '');
+        }
+        result.push(line);
+    });
+    return result.join('\n');
+};
+/**
+ * Serializes JahiaCliConfig to YAML with section-level documentation comments.
+ */
+export const configToYamlWithComments = (config) => insertSectionComments(configToYaml(config));
+//# sourceMappingURL=config-to-yaml-with-comments.js.map

package/dist/lib/config/config-to-yaml-with-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-to-yaml-with-comments.js","sourceRoot":"","sources":["../../../src/lib/config/config-to-yaml-with-comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;GAGG;AACH,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;uGA0B2E,CAAC;AAExG,MAAM,aAAa,GAAG;;;;+EAIyD,CAAC;AAEhF,MAAM,gBAAgB,GAAG;;;;;;;;+DAQsC,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,WAAmB,EAAU,EAAE;IACnE,MAAM,UAAU,GAAqC;QACnD,cAAc,EAAE,mBAAmB;QACnC,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,gBAAgB;KAC9B,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAC7C,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAC9B,CAAC;QAEF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAsB,EAAU,EAAE,CACzE,qBAAqB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/lib/config/config-to-yaml.d.ts

@@ -0,0 +1,7 @@
+import type { JahiaCliConfig } from './types.js';
+/**
+ * Serializes JahiaCliConfig to YAML.
+ * Components without overrides are emitted as plain strings for readability.
+ */
+export declare const configToYaml: (config: JahiaCliConfig) => string;
+//# sourceMappingURL=config-to-yaml.d.ts.map

package/dist/lib/config/config-to-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-to-yaml.d.ts","sourceRoot":"","sources":["../../../src/lib/config/config-to-yaml.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,cAAc,KAAG,MAyBnD,CAAC"}

package/dist/lib/config/config-to-yaml.js

@@ -0,0 +1,26 @@
+import yaml from 'js-yaml';
+/**
+ * Serializes JahiaCliConfig to YAML.
+ * Components without overrides are emitted as plain strings for readability.
+ */
+export const configToYaml = (config) => yaml.dump({
+    ...(config.environment === undefined
+        ? {}
+        : {
+            environment: {
+                ...config.environment,
+                components: config.environment.components.map((component) => component.overrides === undefined
+                    ? component.name
+                    : {
+                        name: component.name,
+                        overrides: component.overrides,
+                    }),
+            },
+        }),
+    ...(config.tests === undefined ? {} : { tests: config.tests }),
+    ...(config.workflow === undefined ? {} : { workflow: config.workflow }),
+}, {
+    lineWidth: -1,
+    noRefs: true,
+});
+//# sourceMappingURL=config-to-yaml.js.map

package/dist/lib/config/config-to-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-to-yaml.js","sourceRoot":"","sources":["../../../src/lib/config/config-to-yaml.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAI3B;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAsB,EAAU,EAAE,CAC7D,IAAI,CAAC,IAAI,CACP;IACE,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;QAClC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE,WAAW,EAAE;gBACX,GAAG,MAAM,CAAC,WAAW;gBACrB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAC1D,SAAS,CAAC,SAAS,KAAK,SAAS;oBAC/B,CAAC,CAAC,SAAS,CAAC,IAAI;oBAChB,CAAC,CAAC;wBACE,IAAI,EAAE,SAAS,CAAC,IAAI;wBACpB,SAAS,EAAE,SAAS,CAAC,SAAS;qBAC/B,CACN;aACF;SACF,CAAC;IACN,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9D,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;CACxE,EACD;IACE,SAAS,EAAE,CAAC,CAAC;IACb,MAAM,EAAE,IAAI;CACb,CACF,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Generates a default environment name using a short random suffix.
+ */
+export declare const generateEnvName: () => string;
+/**
+ * Default provider when none is specified.
+ */
+export declare const DEFAULT_PROVIDER = "docker";
+/**
+ * Default scaffolding configuration for tests.
+ */
+export declare const DEFAULT_SCAFFOLDING_REPOSITORY = "https://github.com/Jahia/jahia-cypress";
+export declare const DEFAULT_SCAFFOLDING_PATH = "scaffolding/";
+export declare const DEFAULT_SCAFFOLDING_VERSION = "latest";
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/lib/config/defaults.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,MAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,8BAA8B,2CAA2C,CAAC;AACvF,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AACvD,eAAO,MAAM,2BAA2B,WAAW,CAAC"}

package/dist/lib/config/defaults.js

@@ -0,0 +1,19 @@
+import { randomBytes } from 'node:crypto';
+/**
+ * Generates a default environment name using a short random suffix.
+ */
+export const generateEnvName = () => {
+    const suffix = randomBytes(4).toString('hex');
+    return `env-${suffix}`;
+};
+/**
+ * Default provider when none is specified.
+ */
+export const DEFAULT_PROVIDER = 'docker';
+/**
+ * Default scaffolding configuration for tests.
+ */
+export const DEFAULT_SCAFFOLDING_REPOSITORY = 'https://github.com/Jahia/jahia-cypress';
+export const DEFAULT_SCAFFOLDING_PATH = 'scaffolding/';
+export const DEFAULT_SCAFFOLDING_VERSION = 'latest';
+//# sourceMappingURL=defaults.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/lib/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAW,EAAE;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,OAAO,MAAM,EAAE,CAAC;AACzB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,wCAAwC,CAAC;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC"}

package/dist/lib/config/export-config.d.ts

@@ -0,0 +1,15 @@
+import type { PersistedEnvironment } from '../state/types.js';
+import type { EnvironmentConfig, JahiaCliConfig } from './types.js';
+/**
+ * Extracts an exportable EnvironmentConfig from a persisted environment.
+ * Strips runtime data (container IDs, timestamps, network names) and
+ * excludes transparent infrastructure components (e.g., VictoriaLogs).
+ * The result is a minimal spec that can recreate the environment.
+ */
+export declare const extractExportableConfig: (environment: PersistedEnvironment) => EnvironmentConfig;
+/**
+ * Merges an exported environment config into an existing JahiaCliConfig,
+ * replacing only the environment section and preserving all other properties.
+ */
+export declare const mergeEnvironmentIntoConfig: (existing: JahiaCliConfig, environmentConfig: EnvironmentConfig) => JahiaCliConfig;
+//# sourceMappingURL=export-config.d.ts.map

package/dist/lib/config/export-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-config.d.ts","sourceRoot":"","sources":["../../../src/lib/config/export-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC;AAGrF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,aAAa,oBAAoB,KAAG,iBAa3E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,cAAc,EACxB,mBAAmB,iBAAiB,KACnC,cAGD,CAAC"}

package/dist/lib/config/export-config.js

@@ -0,0 +1,27 @@
+import { getComponent } from '../components/index.js';
+/**
+ * Extracts an exportable EnvironmentConfig from a persisted environment.
+ * Strips runtime data (container IDs, timestamps, network names) and
+ * excludes transparent infrastructure components (e.g., VictoriaLogs).
+ * The result is a minimal spec that can recreate the environment.
+ */
+export const extractExportableConfig = (environment) => {
+    const filteredComponents = environment.config.components.filter((component) => {
+        const definition = getComponent(component.name);
+        return definition !== undefined && !definition.isTransparent;
+    });
+    return {
+        name: environment.config.name,
+        provider: environment.config.provider,
+        components: filteredComponents,
+    };
+};
+/**
+ * Merges an exported environment config into an existing JahiaCliConfig,
+ * replacing only the environment section and preserving all other properties.
+ */
+export const mergeEnvironmentIntoConfig = (existing, environmentConfig) => ({
+    ...existing,
+    environment: environmentConfig,
+});
+//# sourceMappingURL=export-config.js.map

package/dist/lib/config/export-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-config.js","sourceRoot":"","sources":["../../../src/lib/config/export-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,WAAiC,EAAqB,EAAE;IAC9F,MAAM,kBAAkB,GAA+B,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CACzF,CAAC,SAAS,EAAE,EAAE;QACZ,MAAM,UAAU,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;IAC/D,CAAC,CACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI;QAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ;QACrC,UAAU,EAAE,kBAAkB;KAC/B,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,QAAwB,EACxB,iBAAoC,EACpB,EAAE,CAAC,CAAC;IACpB,GAAG,QAAQ;IACX,WAAW,EAAE,iBAAiB;CAC/B,CAAC,CAAC"}

package/dist/lib/config/initialize-config-file.d.ts

@@ -0,0 +1,12 @@
+import type { JahiaCliConfig } from './types.js';
+export interface InitializeConfigFileParams {
+    readonly outputFile: string;
+    readonly config: JahiaCliConfig;
+    readonly force: boolean;
+}
+export interface InitializeConfigFileResult {
+    readonly written: boolean;
+    readonly outputFile: string;
+}
+export declare const initializeConfigFile: (params: InitializeConfigFileParams) => Promise<InitializeConfigFileResult>;
+//# sourceMappingURL=initialize-config-file.d.ts.map

package/dist/lib/config/initialize-config-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-config-file.d.ts","sourceRoot":"","sources":["../../../src/lib/config/initialize-config-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,0BAA0B,KACjC,OAAO,CAAC,0BAA0B,CAcpC,CAAC"}

package/dist/lib/config/initialize-config-file.js

@@ -0,0 +1,16 @@
+import { access, mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { configToYaml } from './config-to-yaml.js';
+export const initializeConfigFile = async (params) => {
+    const outputExists = await access(params.outputFile)
+        .then(() => true)
+        .catch(() => false);
+    if (outputExists && !params.force) {
+        return { written: false, outputFile: params.outputFile };
+    }
+    const yamlContent = configToYaml(params.config);
+    await mkdir(dirname(params.outputFile), { recursive: true });
+    await writeFile(params.outputFile, yamlContent, 'utf-8');
+    return { written: true, outputFile: params.outputFile };
+};
+//# sourceMappingURL=initialize-config-file.js.map

package/dist/lib/config/initialize-config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-config-file.js","sourceRoot":"","sources":["../../../src/lib/config/initialize-config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAkC,EACG,EAAE;IACvC,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;SACjD,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAEtB,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AAC1D,CAAC,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { ResolvedComponent } from '../components/types.js';
+import type { EnvironmentConfig, JahiaCliConfig, RawConfig, RawEnvironmentConfig, ScaffoldingConfig, TestsConfig, WorkflowConfig, WorkflowStep } from './types.js';
+/**
+ * Parses and validates the optional scaffolding section within tests.
+ */
+export declare const parseScaffoldingConfig: (rawScaffolding: unknown) => ScaffoldingConfig;
+/**
+ * Parses and validates the optional tests section.
+ */
+export declare const parseTestsConfig: (rawTests: unknown) => TestsConfig | undefined;
+/**
+ * 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 declare const resolveComponentOverrides: (rawOverrides: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+/**
+ * Validates and parses a raw environment section into a typed EnvironmentConfig.
+ * Throws descriptive errors for invalid configurations.
+ */
+export declare const validateEnvironmentConfig: (raw: RawEnvironmentConfig) => EnvironmentConfig;
+/**
+ * Validates a single workflow step entry.
+ * Each step must have either `run` (shell command) or `uses` (CLI command), not both.
+ */
+export declare const validateWorkflowStep: (raw: unknown, index: number) => WorkflowStep;
+/**
+ * Parses and validates the optional workflow section.
+ */
+export declare const parseWorkflowConfig: (rawWorkflow: unknown) => WorkflowConfig | undefined;
+/**
+ * Validates and parses a raw YAML object into a typed JahiaCliConfig.
+ * All sections (environment, tests, workflow) are optional — commands validate
+ * the presence of the sections they need.
+ */
+export declare const validateConfig: (raw: RawConfig) => JahiaCliConfig;
+/**
+ * Loads and parses a YAML config file from disk.
+ */
+export declare const loadConfigFile: (filePath: string) => Promise<JahiaCliConfig>;
+/**
+ * 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 declare const resolveConfigComponents: (config: EnvironmentConfig) => readonly ResolvedComponent[];
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/lib/config/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAUhE,OAAO,KAAK,EAEV,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,gBAAgB,OAAO,KAAG,iBAsBhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,OAAO,KAAG,WAAW,GAAG,SAyBlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,cAAc,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAqBxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,oBAAoB,KAAG,iBAkCrE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,OAAO,EAAE,OAAO,MAAM,KAAG,YAmClE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,aAAa,OAAO,KAAG,cAAc,GAAG,SAwB3E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,SAAS,KAAG,cAqB/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,cAAc,CAI7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,iBAAiB,KAAG,SAAS,iBAAiB,EAS1F,CAAC"}

package/dist/lib/config/parser.js

@@ -0,0 +1,196 @@
+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 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;
+    return {
+        ...(jahiaCypress === undefined ? {} : { 'jahia-cypress': jahiaCypress }),
+        ...(scaffolding === undefined ? {} : { scaffolding }),
+    };
+};
+/**
+ * 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 the optional workflow section.
+ */
+export const parseWorkflowConfig = (rawWorkflow) => {
+    if (rawWorkflow === undefined) {
+        return undefined;
+    }
+    if (typeof rawWorkflow !== 'object' || rawWorkflow === null || Array.isArray(rawWorkflow)) {
+        throw new Error('Configuration "workflow" field must be an object when provided.');
+    }
+    const record = rawWorkflow;
+    if (!Array.isArray(record['steps'])) {
+        throw new Error('Configuration "workflow" must include a "steps" array.');
+    }
+    if (record['steps'].length === 0) {
+        throw new Error('Configuration "workflow.steps" must contain at least one step.');
+    }
+    const steps = record['steps'].map((entry, index) => validateWorkflowStep(entry, index));
+    return { steps };
+};
+/**
+ * Validates and parses a raw YAML object into a typed JahiaCliConfig.
+ * All sections (environment, tests, workflow) are optional — commands validate
+ * the presence of the sections they need.
+ */
+export const validateConfig = (raw) => {
+    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 workflow = parseWorkflowConfig(raw.workflow);
+    return {
+        ...(environment === undefined ? {} : { environment }),
+        ...(tests === undefined ? {} : { tests }),
+        ...(workflow === undefined ? {} : { workflow }),
+    };
+};
+/**
+ * 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"}