@jahia/jahia-cli 0.1.3 → 0.2.0

package/dist/commands/workflow/init.js

@@ -0,0 +1,83 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import yaml from 'js-yaml';
+import { configToYaml } from '../../lib/config/config-to-yaml.js';
+import { validateConfig } from '../../lib/config/parser.js';
+import { buildSampleWorkflow } from '../../lib/workflow/build-sample-workflow.js';
+import { mergeWorkflowIntoConfig } from '../../lib/workflow/merge-workflow-into-config.js';
+const DEFAULT_CONFIG_FILE = 'jahia-cli.config.yml';
+/**
+ * Loads an existing config file if it exists, returning an empty config if not found.
+ */
+export const loadExistingConfigForWorkflow = async (filePath) => {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const raw = yaml.load(content);
+        return validateConfig(raw);
+    }
+    catch {
+        return {};
+    }
+};
+/**
+ * Builds a human-readable success message for the workflow init command.
+ */
+export const buildWorkflowInitSuccessMessage = (outputPath) => `✓ Sample workflow added to ${outputPath}\n\n` +
+    '  Edit the workflow steps to match your needs, then run:\n' +
+    `  jahia-cli workflow run --config ${outputPath}`;
+export default class WorkflowInit extends Command {
+    static description = 'Add a sample workflow section to a configuration file. ' +
+        'Generates ~5 representative steps (init, create, alive, test, cleanup) ' +
+        'to help get started. Preserves existing environment and tests sections.';
+    static examples = [
+        '<%= config.bin %> workflow init',
+        '<%= config.bin %> workflow init --config ./my-config.yml',
+        '<%= config.bin %> workflow init --force',
+        '<%= config.bin %> workflow init --json',
+    ];
+    static flags = {
+        config: Flags.string({
+            char: 'c',
+            description: 'Path to the YAML configuration file',
+            default: DEFAULT_CONFIG_FILE,
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Overwrite existing workflow section if already present',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON (for AI agents and scripting)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowInit);
+        const configPath = resolve(flags.config);
+        const existingConfig = await loadExistingConfigForWorkflow(configPath);
+        if (existingConfig.workflow !== undefined && !flags.force) {
+            const msg = `Configuration file already has a workflow section.\n\n` +
+                `  File: ${configPath}\n\n` +
+                '  Use --force to overwrite the existing workflow.';
+            if (flags.json) {
+                this.log(JSON.stringify({ success: false, error: 'workflow_exists', file: configPath }));
+            }
+            else {
+                this.error(msg);
+            }
+            return;
+        }
+        const sampleWorkflow = buildSampleWorkflow();
+        const merged = mergeWorkflowIntoConfig(existingConfig, sampleWorkflow);
+        const yamlContent = configToYaml(merged);
+        await writeFile(configPath, yamlContent, 'utf-8');
+        if (flags.json) {
+            this.log(JSON.stringify({ success: true, file: configPath, workflow: sampleWorkflow }, undefined, 2));
+        }
+        else {
+            this.log(buildWorkflowInitSuccessMessage(configPath));
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/workflow/init.js.map

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

package/dist/commands/workflow/run.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+import type { StepResult } from '../../lib/workflow/types.js';
+/**
+ * Formats a duration in milliseconds to a human-readable string.
+ */
+export declare const formatDuration: (ms: number) => string;
+/**
+ * Builds a formatted summary of workflow execution for human-readable output.
+ */
+export declare const buildWorkflowSummary: (steps: readonly StepResult[], success: boolean, totalDurationMs: number) => string;
+export default class WorkflowRun extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        state: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/workflow/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAI7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAa3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,UAAU,EAAE,EAC5B,SAAS,OAAO,EAChB,iBAAiB,MAAM,KACtB,MAkBF,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,OAAgB,WAAW,SAGoC;IAE/D,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;;;MAcnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+ClC"}

package/dist/commands/workflow/run.js

@@ -0,0 +1,97 @@
+import { resolve } from 'node:path';
+import { Command, Flags } from '@oclif/core';
+import { loadConfigFile } from '../../lib/config/parser.js';
+import { executeWorkflow } from '../../lib/workflow/executor.js';
+/**
+ * Formats a duration in milliseconds to a human-readable string.
+ */
+export const formatDuration = (ms) => {
+    if (ms < 1000) {
+        return `${String(ms)}ms`;
+    }
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60) {
+        return `${String(seconds)}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${String(minutes)}m ${String(remainingSeconds)}s`;
+};
+/**
+ * Builds a formatted summary of workflow execution for human-readable output.
+ */
+export const buildWorkflowSummary = (steps, success, totalDurationMs) => {
+    const header = success ? '✓ Workflow completed successfully' : '✗ Workflow failed';
+    const stepLines = steps.map((step) => `  ${step.success ? '✓' : '✗'} ${step.name} (${formatDuration(step.durationMs)})${step.error !== undefined ? `\n    Error: ${step.error}` : ''}`);
+    return [
+        header,
+        '',
+        '  Steps:',
+        ...stepLines,
+        '',
+        `  Total time: ${formatDuration(totalDurationMs)}`,
+    ].join('\n');
+};
+export default class WorkflowRun extends Command {
+    static description = 'Execute a workflow defined in a configuration file. ' +
+        'Runs steps sequentially — shell commands via execa, ' +
+        'jahia-cli commands via subprocess. Stops on first failure.';
+    static examples = [
+        '<%= config.bin %> workflow run --config jahia-cli.config.yml',
+        '<%= config.bin %> workflow run --config ./my-config.yml --json',
+    ];
+    static flags = {
+        config: Flags.string({
+            char: 'c',
+            description: 'Path to the YAML configuration file',
+            required: true,
+        }),
+        json: Flags.boolean({
+            description: 'Output result as structured JSON (for AI agents and scripting)',
+            default: false,
+        }),
+        state: Flags.string({
+            char: 's',
+            description: 'Path to the state file (auto-passed to jahia-cli subcommands)',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowRun);
+        const configPath = resolve(flags.config);
+        const config = await loadConfigFile(configPath);
+        if (config.workflow === undefined) {
+            this.error('No workflow section found in configuration file.\n\n' +
+                '  Run "jahia-cli workflow init" to generate a sample workflow.');
+            return;
+        }
+        const { steps } = config.workflow;
+        if (!flags.json) {
+            this.log(`▶ Running workflow (${String(steps.length)} steps)\n`);
+        }
+        const cliEntryPoint = resolve(this.config.root, 'bin', 'run.js');
+        const result = await executeWorkflow({
+            steps,
+            configPath,
+            statePath: flags.state,
+            cwd: process.cwd(),
+            cliEntryPoint,
+            onStepStart: flags.json
+                ? undefined
+                : (name, index) => {
+                    this.log(`  [${String(index + 1)}/${String(steps.length)}] ${name}...`);
+                },
+            onStepComplete: undefined,
+        });
+        if (flags.json) {
+            this.log(JSON.stringify(result, undefined, 2));
+        }
+        else {
+            this.log('');
+            this.log(buildWorkflowSummary(result.steps, result.success, result.totalDurationMs));
+        }
+        if (!result.success) {
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/workflow/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/workflow/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAU,EAAU,EAAE;IACnD,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IACtC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC;AAC5D,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAA4B,EAC5B,OAAgB,EAChB,eAAuB,EACf,EAAE;IACV,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAEnF,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CACzB,CAAC,IAAI,EAAE,EAAE,CACP,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,IAC5E,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAC5D,EAAE,CACL,CAAC;IAEF,OAAO;QACL,MAAM;QACN,EAAE;QACF,UAAU;QACV,GAAG,SAAS;QACZ,EAAE;QACF,iBAAiB,cAAc,CAAC,eAAe,CAAC,EAAE;KACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,MAAM,CAAU,WAAW,GACzB,sDAAsD;QACtD,sDAAsD;QACtD,4DAA4D,CAAC;IAE/D,MAAM,CAAU,QAAQ,GAAG;QACzB,8DAA8D;QAC9D,gEAAgE;KACjE,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,qCAAqC;YAClD,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,WAAW,EAAE,gEAAgE;YAC7E,OAAO,EAAE,KAAK;SACf,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,+DAA+D;SAC7E,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;QAEhD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CACR,sDAAsD;gBACpD,gEAAgE,CACnE,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;QAElC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,KAAK;YACL,UAAU;YACV,SAAS,EAAE,KAAK,CAAC,KAAK;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,aAAa;YACb,WAAW,EAAE,KAAK,CAAC,IAAI;gBACrB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,CAAC,IAAY,EAAE,KAAa,EAAQ,EAAE;oBACpC,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;gBAC1E,CAAC;YACL,cAAc,EAAE,SAAS;SAC1B,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;IACH,CAAC"}

package/dist/lib/components/index.d.ts

@@ -0,0 +1,59 @@
+import type { ComponentCategory, ComponentDefinition, ComponentOverrides, ResolvedComponent } from './types.js';
+/**
+ * Registry of all available components.
+ * To add a new component: create a file, define the ComponentDefinition, import and add here.
+ */
+export declare const COMPONENT_REGISTRY: Readonly<Record<string, ComponentDefinition>>;
+/**
+ * Returns all registered component names.
+ */
+export declare const listComponentNames: () => readonly string[];
+/**
+ * Returns all registered component definitions.
+ */
+export declare const listComponents: () => readonly ComponentDefinition[];
+/**
+ * Returns components that are user-selectable (not transparent infrastructure).
+ */
+export declare const listUserSelectableComponents: () => readonly ComponentDefinition[];
+/**
+ * Returns transparent infrastructure components (auto-deployed).
+ */
+export declare const listTransparentComponents: () => readonly ComponentDefinition[];
+/**
+ * Returns components matching a specific category.
+ */
+export declare const listComponentsByCategory: (category: ComponentCategory) => readonly ComponentDefinition[];
+/**
+ * Retrieves a component definition by name.
+ * Returns undefined if the component is not found.
+ */
+export declare const getComponent: (name: string) => ComponentDefinition | undefined;
+/**
+ * Parses a Docker image reference that may include a tag (e.g. "jahia/jahia-ee:8.3.0.0").
+ * Returns the image name and optional embedded tag separately.
+ */
+export declare const parseImageReference: (ref: string) => {
+    readonly image: string;
+    readonly tag: string | undefined;
+};
+/**
+ * Resolves a component by merging its definition with user-provided overrides.
+ *
+ * The `image` override accepts the full `image:tag` format (e.g. "jahia/jahia-ee:8.3.0.0").
+ * When it contains a tag, that tag is used unless a separate `tag` override is also provided.
+ *
+ * Environment variables in both definition and override values support `${VAR}` and
+ * `${VAR:-default}` substitution from `process.env`, consistent with the workflow engine.
+ * This allows component definitions to reference host environment variables
+ * (e.g. `JAHIA_LICENSE: '${JAHIA_LICENSE:-}'`) that are resolved at container creation time.
+ */
+export declare const resolveComponent: (definition: ComponentDefinition, overrides?: ComponentOverrides) => ResolvedComponent;
+/**
+ * Applies envInjections from all selected components to their target components.
+ * Returns a new array of ResolvedComponents with injected env vars merged in.
+ * Dependencies are an implementation detail — callers just pass all selected components.
+ */
+export declare const applyEnvInjections: (components: readonly ResolvedComponent[]) => readonly ResolvedComponent[];
+export type { ComponentCategory, ComponentDefinition, ComponentOverrides, ResolvedComponent } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAI5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,SAAS,MAAM,EAAqC,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,SAAS,mBAAmB,EAC3B,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,4BAA4B,QAAO,SAAS,mBAAmB,EACT,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,SAAS,mBAAmB,EACP,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,iBAAiB,KAAG,SAAS,mBAAmB,EACzB,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,mBAAmB,GAAG,SACxC,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,KAAK,MAAM,KACV;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAgB5D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAC3B,YAAY,mBAAmB,EAC/B,YAAW,kBAAuB,KACjC,iBAeF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,SAAS,iBAAiB,EAAE,KACvC,SAAS,iBAAiB,EAsB5B,CAAC;AAEF,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/components/index.js

@@ -0,0 +1,111 @@
+import { resolveEnvVarsInRecord } from '../config/resolve-env-vars.js';
+import { jahia } from './jahia.js';
+import { smtpServer } from './smtp-server.js';
+import { victorialogs } from './victorialogs.js';
+/**
+ * Registry of all available components.
+ * To add a new component: create a file, define the ComponentDefinition, import and add here.
+ */
+export const COMPONENT_REGISTRY = {
+    jahia,
+    'smtp-server': smtpServer,
+    victorialogs,
+};
+/**
+ * Returns all registered component names.
+ */
+export const listComponentNames = () => Object.keys(COMPONENT_REGISTRY);
+/**
+ * Returns all registered component definitions.
+ */
+export const listComponents = () => Object.values(COMPONENT_REGISTRY);
+/**
+ * Returns components that are user-selectable (not transparent infrastructure).
+ */
+export const listUserSelectableComponents = () => Object.values(COMPONENT_REGISTRY).filter((c) => !c.isTransparent);
+/**
+ * Returns transparent infrastructure components (auto-deployed).
+ */
+export const listTransparentComponents = () => Object.values(COMPONENT_REGISTRY).filter((c) => c.isTransparent);
+/**
+ * Returns components matching a specific category.
+ */
+export const listComponentsByCategory = (category) => Object.values(COMPONENT_REGISTRY).filter((c) => c.category === category);
+/**
+ * Retrieves a component definition by name.
+ * Returns undefined if the component is not found.
+ */
+export const getComponent = (name) => COMPONENT_REGISTRY[name];
+/**
+ * Parses a Docker image reference that may include a tag (e.g. "jahia/jahia-ee:8.3.0.0").
+ * Returns the image name and optional embedded tag separately.
+ */
+export const parseImageReference = (ref) => {
+    // A colon after a slash-separated path segment indicates a tag.
+    // We split on the *last* colon that isn't part of a registry port (registry:port/repo).
+    // Simple heuristic: if the part after the last colon contains '/' it's not a tag.
+    const lastColon = ref.lastIndexOf(':');
+    if (lastColon === -1) {
+        return { image: ref, tag: undefined };
+    }
+    const afterColon = ref.slice(lastColon + 1);
+    // If afterColon contains '/' it's likely a registry:port/repo pattern, not a tag
+    if (afterColon.includes('/')) {
+        return { image: ref, tag: undefined };
+    }
+    return { image: ref.slice(0, lastColon), tag: afterColon };
+};
+/**
+ * Resolves a component by merging its definition with user-provided overrides.
+ *
+ * The `image` override accepts the full `image:tag` format (e.g. "jahia/jahia-ee:8.3.0.0").
+ * When it contains a tag, that tag is used unless a separate `tag` override is also provided.
+ *
+ * Environment variables in both definition and override values support `${VAR}` and
+ * `${VAR:-default}` substitution from `process.env`, consistent with the workflow engine.
+ * This allows component definitions to reference host environment variables
+ * (e.g. `JAHIA_LICENSE: '${JAHIA_LICENSE:-}'`) that are resolved at container creation time.
+ */
+export const resolveComponent = (definition, overrides = {}) => {
+    const parsed = overrides.image !== undefined
+        ? parseImageReference(overrides.image)
+        : undefined;
+    const mergedEnv = { ...definition.env, ...overrides.env };
+    return {
+        definition,
+        overrides,
+        effectiveImage: parsed?.image ?? definition.image,
+        effectiveTag: overrides.tag ?? parsed?.tag ?? definition.defaultTag,
+        effectiveEnv: resolveEnvVarsInRecord(mergedEnv),
+        effectivePorts: overrides.ports ?? definition.ports,
+    };
+};
+/**
+ * Applies envInjections from all selected components to their target components.
+ * Returns a new array of ResolvedComponents with injected env vars merged in.
+ * Dependencies are an implementation detail — callers just pass all selected components.
+ */
+export const applyEnvInjections = (components) => {
+    const injections = new Map();
+    // Collect all injections from selected components
+    components.forEach((c) => {
+        const envInjections = c.definition.envInjections;
+        if (envInjections === undefined)
+            return;
+        Object.entries(envInjections).forEach(([targetName, vars]) => {
+            const existing = injections.get(targetName) ?? {};
+            injections.set(targetName, { ...existing, ...vars });
+        });
+    });
+    // Apply injections to target components
+    return components.map((c) => {
+        const extra = injections.get(c.definition.name);
+        if (extra === undefined)
+            return c;
+        return {
+            ...c,
+            effectiveEnv: resolveEnvVarsInRecord({ ...c.effectiveEnv, ...extra }),
+        };
+    });
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/components/index.js.map

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

package/dist/lib/components/jahia.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentDefinition } from './types.js';
+export declare const jahia: ComponentDefinition;
+//# sourceMappingURL=jahia.d.ts.map

package/dist/lib/components/jahia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jahia.d.ts","sourceRoot":"","sources":["../../../src/lib/components/jahia.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,KAAK,EAAE,mBAmCnB,CAAC"}

package/dist/lib/components/jahia.js

@@ -0,0 +1,37 @@
+export const jahia = {
+    name: 'jahia',
+    description: 'Jahia DXM (Digital Experience Manager) processing server',
+    image: 'jahia/jahia-ee',
+    defaultTag: '8.2.1.0',
+    ports: [
+        { container: 8080, host: 8080 },
+        { container: 8101, host: 8101 },
+    ],
+    env: {
+        SUPER_USER_PASSWORD: '${SUPER_USER_PASSWORD:-root1234}',
+        MAX_RAM_PERCENTAGE: '${MAX_RAM_PERCENTAGE:-80}',
+        PROCESSING_SERVER: 'true',
+        JAHIA_LICENSE: '${JAHIA_LICENSE:-}',
+        JPDA: '${JPDA:-}',
+    },
+    volumes: [
+        { name: 'jahia-data', containerPath: '/var/jahia/repository' },
+    ],
+    healthcheck: {
+        command: [
+            'CMD-SHELL',
+            'curl -f http://localhost:8080/modules/healthcheck || exit 1',
+        ],
+        intervalSeconds: 30,
+        timeoutSeconds: 10,
+        retries: 10,
+        startPeriodSeconds: 120,
+    },
+    dependsOn: [],
+    networkAliases: ['jahia'],
+    category: 'core',
+    isTransparent: false,
+    multiInstance: false,
+    providerSupport: ['docker', 'jahiacloudv1'],
+};
+//# sourceMappingURL=jahia.js.map

package/dist/lib/components/jahia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jahia.js","sourceRoot":"","sources":["../../../src/lib/components/jahia.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAwB;IACxC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,0DAA0D;IACvE,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE;QACL,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAC/B,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;KAChC;IACD,GAAG,EAAE;QACH,mBAAmB,EAAE,kCAAkC;QACvD,kBAAkB,EAAE,2BAA2B;QAC/C,iBAAiB,EAAE,MAAM;QACzB,aAAa,EAAE,oBAAoB;QACnC,IAAI,EAAE,WAAW;KAClB;IACD,OAAO,EAAE;QACP,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE;KAC/D;IACD,WAAW,EAAE;QACX,OAAO,EAAE;YACP,WAAW;YACX,6DAA6D;SAC9D;QACD,eAAe,EAAE,EAAE;QACnB,cAAc,EAAE,EAAE;QAClB,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,GAAG;KACxB;IACD,SAAS,EAAE,EAAE;IACb,cAAc,EAAE,CAAC,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;CAC5C,CAAC"}

package/dist/lib/components/smtp-server.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentDefinition } from './types.js';
+export declare const smtpServer: ComponentDefinition;
+//# sourceMappingURL=smtp-server.d.ts.map

package/dist/lib/components/smtp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-server.d.ts","sourceRoot":"","sources":["../../../src/lib/components/smtp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,UAAU,EAAE,mBA2BxB,CAAC"}

package/dist/lib/components/smtp-server.js

@@ -0,0 +1,29 @@
+export const smtpServer = {
+    name: 'smtp-server',
+    description: 'Mailpit SMTP server for email testing',
+    image: 'axllent/mailpit',
+    defaultTag: 'v1.27',
+    ports: [
+        { container: 1025, host: 1025 },
+        { container: 8025, host: 8025 },
+    ],
+    env: {},
+    volumes: [],
+    healthcheck: {
+        command: ['CMD-SHELL', 'wget -qO- http://localhost:8025/api/v1/info || exit 1'],
+        intervalSeconds: 10,
+        timeoutSeconds: 3,
+        retries: 3,
+        startPeriodSeconds: 5,
+    },
+    dependsOn: [],
+    networkAliases: ['smtp-server'],
+    category: 'utility',
+    isTransparent: false,
+    multiInstance: false,
+    providerSupport: ['docker'],
+    envInjections: {
+        jahia: { SMTP_SERVER_URL: '${SMTP_SERVER_URL:-smtp://smtp-server:1025}' },
+    },
+};
+//# sourceMappingURL=smtp-server.js.map

package/dist/lib/components/smtp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-server.js","sourceRoot":"","sources":["../../../src/lib/components/smtp-server.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,uCAAuC;IACpD,KAAK,EAAE,iBAAiB;IACxB,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE;QACL,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAC/B,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;KAChC;IACD,GAAG,EAAE,EAAE;IACP,OAAO,EAAE,EAAE;IACX,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,WAAW,EAAE,uDAAuD,CAAC;QAC/E,eAAe,EAAE,EAAE;QACnB,cAAc,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;QACV,kBAAkB,EAAE,CAAC;KACtB;IACD,SAAS,EAAE,EAAE;IACb,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,QAAQ,EAAE,SAAS;IACnB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,CAAC,QAAQ,CAAC;IAC3B,aAAa,EAAE;QACb,KAAK,EAAE,EAAE,eAAe,EAAE,6CAA6C,EAAE;KAC1E;CACF,CAAC"}

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

@@ -0,0 +1,89 @@
+/**
+ * Defines a port mapping from container port to host port.
+ */
+export interface PortMapping {
+    readonly container: number;
+    readonly host: number;
+    readonly protocol?: 'tcp' | 'udp' | undefined;
+}
+/**
+ * Defines a named volume mount.
+ */
+export interface VolumeMount {
+    readonly name: string;
+    readonly containerPath: string;
+}
+/**
+ * Defines a container healthcheck configuration.
+ */
+export interface HealthcheckConfig {
+    readonly command: readonly string[];
+    readonly intervalSeconds: number;
+    readonly timeoutSeconds: number;
+    readonly retries: number;
+    readonly startPeriodSeconds: number;
+}
+/**
+ * Component categories for organizing the registry.
+ */
+export type ComponentCategory = 'core' | 'infrastructure' | 'database' | 'search' | 'application' | 'utility' | 'custom';
+/**
+ * Full definition of a component in the library.
+ * Contains all the information needed to start and manage a container.
+ */
+export interface ComponentDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly image: string;
+    readonly defaultTag: string;
+    readonly ports: readonly PortMapping[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly volumes: readonly VolumeMount[];
+    readonly healthcheck?: HealthcheckConfig | undefined;
+    readonly dependsOn: readonly string[];
+    readonly networkAliases: readonly string[];
+    readonly category: ComponentCategory;
+    readonly isTransparent: boolean;
+    readonly multiInstance: boolean;
+    readonly providerSupport: readonly ('docker' | 'jahiacloudv1')[];
+    readonly args?: readonly string[] | undefined;
+    /**
+     * Environment variables to inject into other components when this component is present.
+     * Keys are target component names, values are env var maps to merge into those components.
+     */
+    readonly envInjections?: Readonly<Record<string, Readonly<Record<string, string>>>> | undefined;
+}
+/**
+ * User-provided overrides for a component.
+ * Only the fields that differ from defaults need to be specified.
+ *
+ * The `image` field accepts the full Docker reference including tag
+ * (e.g. "jahia/jahia-ee:8.3.0.0" or "my-registry.example.com/jahia/jahia-ee:8.3.0.0").
+ * When `image` contains a tag, that tag is used unless a separate `tag` override
+ * is also provided — the explicit `tag` override always takes precedence.
+ *
+ * Both `image` and `tag` support environment variable substitution:
+ *   - `${VAR}` — resolves from process.env; errors if not set
+ *   - `${VAR:-default}` — resolves from process.env with a fallback
+ *
+ * Example:
+ *   image: "${JAHIA_IMAGE:-jahia/jahia-ee:8.2.1.0}"
+ */
+export interface ComponentOverrides {
+    readonly image?: string | undefined;
+    readonly tag?: string | undefined;
+    readonly env?: Readonly<Record<string, string>> | undefined;
+    readonly ports?: readonly PortMapping[] | undefined;
+}
+/**
+ * A component with its overrides applied, ready for deployment.
+ */
+export interface ResolvedComponent {
+    readonly definition: ComponentDefinition;
+    readonly overrides: ComponentOverrides;
+    readonly effectiveImage: string;
+    readonly effectiveTag: string;
+    readonly effectiveEnv: Readonly<Record<string, string>>;
+    readonly effectivePorts: readonly PortMapping[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/components/types.js

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

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

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

package/dist/lib/components/victorialogs.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentDefinition } from './types.js';
+export declare const victorialogs: ComponentDefinition;
+//# sourceMappingURL=victorialogs.d.ts.map

package/dist/lib/components/victorialogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"victorialogs.d.ts","sourceRoot":"","sources":["../../../src/lib/components/victorialogs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,YAAY,EAAE,mBA2B1B,CAAC"}

package/dist/lib/components/victorialogs.js

@@ -0,0 +1,29 @@
+export const victorialogs = {
+    name: 'victorialogs',
+    description: 'VictoriaLogs log aggregation for AI-friendly log consumption',
+    image: 'victoriametrics/victoria-logs',
+    defaultTag: 'v1.15.0-victorialogs',
+    ports: [
+        { container: 9428, host: 9428 },
+        { container: 5140, host: 5140 },
+    ],
+    env: {},
+    volumes: [
+        { name: 'victorialogs-data', containerPath: '/vlogs' },
+    ],
+    healthcheck: {
+        command: ['CMD-SHELL', 'wget -qO- http://0.0.0.0:9428/health || exit 1'],
+        intervalSeconds: 5,
+        timeoutSeconds: 3,
+        retries: 3,
+        startPeriodSeconds: 5,
+    },
+    dependsOn: [],
+    networkAliases: ['victorialogs', 'logs'],
+    category: 'infrastructure',
+    isTransparent: true,
+    multiInstance: false,
+    providerSupport: ['docker'],
+    args: ['-syslog.listenAddr.tcp=:5140', '-syslog.listenAddr.udp=:5140'],
+};
+//# sourceMappingURL=victorialogs.js.map

package/dist/lib/components/victorialogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"victorialogs.js","sourceRoot":"","sources":["../../../src/lib/components/victorialogs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAwB;IAC/C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,8DAA8D;IAC3E,KAAK,EAAE,+BAA+B;IACtC,UAAU,EAAE,sBAAsB;IAClC,KAAK,EAAE;QACL,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAC/B,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;KAChC;IACD,GAAG,EAAE,EAAE;IACP,OAAO,EAAE;QACP,EAAE,IAAI,EAAE,mBAAmB,EAAE,aAAa,EAAE,QAAQ,EAAE;KACvD;IACD,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,WAAW,EAAE,gDAAgD,CAAC;QACxE,eAAe,EAAE,CAAC;QAClB,cAAc,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;QACV,kBAAkB,EAAE,CAAC;KACtB;IACD,SAAS,EAAE,EAAE;IACb,cAAc,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;IACxC,QAAQ,EAAE,gBAAgB;IAC1B,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,CAAC,8BAA8B,EAAE,8BAA8B,CAAC;CACvE,CAAC"}