@jahia/jahia-cli 0.1.4 → 0.3.0

package/dist/lib/tests/build-image.js

@@ -0,0 +1,59 @@
+import { resolveEnvVars } from '../config/resolve-env-vars.js';
+/**
+ * Default Dockerfile path relative to the working directory.
+ */
+export const DEFAULT_DOCKERFILE = 'docker/Dockerfile.local';
+/**
+ * Default image name prefix for built test images.
+ */
+export const DEFAULT_IMAGE_NAME = 'jahia-tests';
+/**
+ * Resolves the image tag for the test image build.
+ * Uses the scaffolding version from config, with env var substitution.
+ */
+export const resolveImageTag = (imageName, version) => `${imageName}:${version}`;
+/**
+ * Parses a repeatable `KEY=VALUE` flag into a record.
+ * Applies `${VAR:-default}` env var resolution to values for consistency
+ * with the config system.
+ */
+export const parseKeyValueArgs = (args) => Object.fromEntries(args.map((arg) => {
+    const eqIndex = arg.indexOf('=');
+    if (eqIndex === -1) {
+        throw new Error(`Invalid KEY=VALUE argument: "${arg}". Expected format: KEY=VALUE`);
+    }
+    return [arg.slice(0, eqIndex), resolveEnvVars(arg.slice(eqIndex + 1))];
+}));
+/**
+ * Builds the argument list for `docker buildx build`.
+ *
+ * Pure function — all inputs explicit, no side effects.
+ */
+export const buildBuildxArgs = (params) => {
+    const args = [
+        'buildx', 'build',
+        '-f', params.dockerfile,
+        '-t', params.tag,
+        '--build-arg', `BASE_VERSION=${params.baseVersion}`,
+    ];
+    if (params.extraBuildArgs !== undefined) {
+        Object.entries(params.extraBuildArgs).forEach(([key, value]) => {
+            args.push('--build-arg', `${key}=${value}`);
+        });
+    }
+    if (params.platform !== undefined) {
+        args.push('--platform', params.platform);
+    }
+    if (params.noCache === true) {
+        args.push('--no-cache');
+    }
+    // --load makes the image available in the local Docker daemon
+    args.push('--load');
+    // Build context is the directory containing the Dockerfile
+    const contextDir = params.dockerfile.includes('/')
+        ? params.dockerfile.slice(0, params.dockerfile.lastIndexOf('/'))
+        : '.';
+    args.push(contextDir);
+    return args;
+};
+//# sourceMappingURL=build-image.js.map

package/dist/lib/tests/build-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-image.js","sourceRoot":"","sources":["../../../src/lib/tests/build-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,SAAiB,EACjB,OAAe,EACP,EAAE,CAAC,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAuB,EACW,EAAE,CACpC,MAAM,CAAC,WAAW,CAChB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,gCAAgC,GAAG,+BAA+B,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC,CAAC,CACH,CAAC;AAEJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAO/B,EAAqB,EAAE;IACtB,MAAM,IAAI,GAAa;QACrB,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,MAAM,CAAC,UAAU;QACvB,IAAI,EAAE,MAAM,CAAC,GAAG;QAChB,aAAa,EAAE,gBAAgB,MAAM,CAAC,WAAW,EAAE;KACpD,CAAC;IAEF,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC7D,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IAED,8DAA8D;IAC9D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEpB,2DAA2D;IAC3D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QAChD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC,CAAC,GAAG,CAAC;IACR,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEtB,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/lib/tests/clone-scaffolding.d.ts

@@ -0,0 +1,16 @@
+import type { ScaffoldingCloneResult } from './types.js';
+export declare const DEFAULT_CYPRESS_REPOSITORY = "https://github.com/Jahia/jahia-cypress.git";
+export declare const buildCloneArgs: (params: {
+    readonly version: string;
+    readonly repositoryUrl: string;
+    readonly checkoutDir: string;
+}) => readonly string[];
+export declare const parseLatestTagFromLsRemote: (stdout: string, repositoryUrl: string) => string;
+export declare const resolveLatestTag: (repositoryUrl?: string) => Promise<string>;
+export declare const cloneScaffolding: (params: {
+    readonly version?: string | undefined;
+    readonly workDir: string;
+    readonly repositoryUrl?: string | undefined;
+    readonly scaffoldingPath?: string | undefined;
+}) => Promise<ScaffoldingCloneResult>;
+//# sourceMappingURL=clone-scaffolding.d.ts.map

package/dist/lib/tests/clone-scaffolding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-scaffolding.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/clone-scaffolding.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,eAAO,MAAM,0BAA0B,+CAA+C,CAAC;AAMvF,eAAO,MAAM,cAAc,GAAI,QAAQ;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,KAAG,SAAS,MAAM,EAQlB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,QAAQ,MAAM,EAAE,eAAe,MAAM,KAAG,MAgBlF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,gBAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,CAW7E,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,QAAQ;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C,KAAG,OAAO,CAAC,sBAAsB,CAyBjC,CAAC"}

package/dist/lib/tests/clone-scaffolding.js

@@ -0,0 +1,64 @@
+import { execFile } from 'node:child_process';
+import { access, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+export const DEFAULT_CYPRESS_REPOSITORY = 'https://github.com/Jahia/jahia-cypress.git';
+const DEFAULT_CHECKOUT_DIRNAME = 'jahia-cypress';
+const TAG_PREFIX = 'refs/tags/';
+const execFileAsync = promisify(execFile);
+export const buildCloneArgs = (params) => [
+    'clone',
+    '--depth',
+    '1',
+    '--branch',
+    params.version,
+    params.repositoryUrl,
+    params.checkoutDir,
+];
+export const parseLatestTagFromLsRemote = (stdout, repositoryUrl) => {
+    const firstLine = stdout
+        .split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (!firstLine) {
+        throw new Error(`No tags found for ${repositoryUrl}.`);
+    }
+    const ref = firstLine.split(/\s+/)[1];
+    if (!ref?.startsWith(TAG_PREFIX)) {
+        throw new Error(`Unable to resolve latest tag from git output for ${repositoryUrl}.`);
+    }
+    return ref.slice(TAG_PREFIX.length);
+};
+export const resolveLatestTag = async (repositoryUrl) => {
+    const url = repositoryUrl ?? DEFAULT_CYPRESS_REPOSITORY;
+    const { stdout } = await execFileAsync('git', [
+        'ls-remote',
+        '--tags',
+        '--refs',
+        '--sort=-v:refname',
+        url,
+    ]);
+    return parseLatestTagFromLsRemote(stdout, url);
+};
+export const cloneScaffolding = async (params) => {
+    const repositoryUrl = params.repositoryUrl ?? DEFAULT_CYPRESS_REPOSITORY;
+    const version = params.version ?? (await resolveLatestTag(repositoryUrl));
+    const checkoutDir = join(params.workDir, DEFAULT_CHECKOUT_DIRNAME);
+    const subPath = params.scaffoldingPath ?? 'scaffolding';
+    const scaffoldingDir = join(checkoutDir, subPath);
+    await mkdir(params.workDir, { recursive: true });
+    await execFileAsync('git', [...buildCloneArgs({ version, repositoryUrl, checkoutDir })], {
+        cwd: params.workDir,
+    });
+    await access(scaffoldingDir).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Scaffolding directory not found at "${scaffoldingDir}" after cloning ${repositoryUrl}@${version}: ${message}`);
+    });
+    return {
+        version,
+        repositoryUrl,
+        checkoutDir,
+        scaffoldingDir,
+    };
+};
+//# sourceMappingURL=clone-scaffolding.js.map

package/dist/lib/tests/clone-scaffolding.js.map

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

package/dist/lib/tests/exclusion-list.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Files and patterns that should never be synced from the remote scaffolding.
+ * These are files that could alter local git behavior or conflict with local config.
+ */
+export declare const DEFAULT_EXCLUSION_PATTERNS: readonly string[];
+/**
+ * Returns true if the given relative path should be excluded from sync.
+ * Checks if the filename (last segment) matches any exclusion pattern.
+ */
+export declare const isExcluded: (relativePath: string, exclusionPatterns?: readonly string[]) => boolean;
+//# sourceMappingURL=exclusion-list.d.ts.map

package/dist/lib/tests/exclusion-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusion-list.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/exclusion-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAIvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,cAAc,MAAM,EACpB,oBAAmB,SAAS,MAAM,EAA+B,KAChE,OAKC,CAAC"}

package/dist/lib/tests/exclusion-list.js

@@ -0,0 +1,19 @@
+/**
+ * Files and patterns that should never be synced from the remote scaffolding.
+ * These are files that could alter local git behavior or conflict with local config.
+ */
+export const DEFAULT_EXCLUSION_PATTERNS = [
+    '.gitignore',
+    '.gitattributes',
+    '.gitmodules',
+];
+/**
+ * Returns true if the given relative path should be excluded from sync.
+ * Checks if the filename (last segment) matches any exclusion pattern.
+ */
+export const isExcluded = (relativePath, exclusionPatterns = DEFAULT_EXCLUSION_PATTERNS) => exclusionPatterns.some((pattern) => {
+    const segments = relativePath.split('/');
+    const fileName = segments[segments.length - 1] ?? '';
+    return fileName === pattern;
+});
+//# sourceMappingURL=exclusion-list.js.map

package/dist/lib/tests/exclusion-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusion-list.js","sourceRoot":"","sources":["../../../src/lib/tests/exclusion-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D,YAAY;IACZ,gBAAgB;IAChB,aAAa;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,YAAoB,EACpB,oBAAuC,0BAA0B,EACxD,EAAE,CACX,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;IACjC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,OAAO,QAAQ,KAAK,OAAO,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/lib/tests/gitignore-manager.d.ts

@@ -0,0 +1,21 @@
+export interface GitignoreUpdateResult {
+    readonly path: string;
+    readonly entriesAdded: number;
+    readonly created: boolean;
+}
+/**
+ * Builds the managed section content from a list of file paths.
+ */
+export declare const buildManagedSection: (entries: readonly string[]) => string;
+/**
+ * Replaces or appends the managed section in existing gitignore content.
+ * Preserves all user-owned content outside the markers.
+ */
+export declare const replaceManagedSection: (existingContent: string, entries: readonly string[]) => string;
+/**
+ * Updates (or creates) the local .gitignore file with a managed section
+ * containing the specified file entries.
+ * Returns the result including how many entries were added.
+ */
+export declare const updateGitignore: (gitignorePath: string, entries: readonly string[]) => Promise<GitignoreUpdateResult>;
+//# sourceMappingURL=gitignore-manager.d.ts.map

package/dist/lib/tests/gitignore-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/gitignore-manager.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAGhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,iBAAiB,MAAM,EACvB,SAAS,SAAS,MAAM,EAAE,KACzB,MAgBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,EACrB,SAAS,SAAS,MAAM,EAAE,KACzB,OAAO,CAAC,qBAAqB,CAY/B,CAAC"}

package/dist/lib/tests/gitignore-manager.js

@@ -0,0 +1,47 @@
+import { readFile, writeFile } from 'node:fs/promises';
+const MANAGED_START = '# --- jahia-cli:managed-start ---';
+const MANAGED_END = '# --- jahia-cli:managed-end ---';
+const MANAGED_HEADER = '# Files below are managed by jahia-cli tests init.\n' +
+    '# They are sourced from the remote scaffolding repository.\n' +
+    '# Remove a line to "own" that file and stop syncing it from remote.';
+/**
+ * Builds the managed section content from a list of file paths.
+ */
+export const buildManagedSection = (entries) => {
+    const sorted = [...entries].sort((a, b) => a.localeCompare(b));
+    return [MANAGED_START, MANAGED_HEADER, ...sorted, MANAGED_END].join('\n');
+};
+/**
+ * Replaces or appends the managed section in existing gitignore content.
+ * Preserves all user-owned content outside the markers.
+ */
+export const replaceManagedSection = (existingContent, entries) => {
+    const managedBlock = buildManagedSection(entries);
+    const startIdx = existingContent.indexOf(MANAGED_START);
+    const endIdx = existingContent.indexOf(MANAGED_END);
+    if (startIdx === -1 || endIdx === -1) {
+        const separator = existingContent.length > 0 && !existingContent.endsWith('\n') ? '\n\n' : '\n';
+        const prefix = existingContent.length === 0 ? '' : existingContent.trimEnd() + separator;
+        return prefix + managedBlock + '\n';
+    }
+    const before = existingContent.slice(0, startIdx);
+    const after = existingContent.slice(endIdx + MANAGED_END.length);
+    return before + managedBlock + after;
+};
+/**
+ * Updates (or creates) the local .gitignore file with a managed section
+ * containing the specified file entries.
+ * Returns the result including how many entries were added.
+ */
+export const updateGitignore = async (gitignorePath, entries) => {
+    const existing = await readFile(gitignorePath, 'utf-8').catch(() => '');
+    const created = existing === '';
+    const updated = replaceManagedSection(existing, entries);
+    await writeFile(gitignorePath, updated, 'utf-8');
+    return {
+        path: gitignorePath,
+        entriesAdded: entries.length,
+        created,
+    };
+};
+//# sourceMappingURL=gitignore-manager.js.map

package/dist/lib/tests/gitignore-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-manager.js","sourceRoot":"","sources":["../../../src/lib/tests/gitignore-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,aAAa,GAAG,mCAAmC,CAAC;AAC1D,MAAM,WAAW,GAAG,iCAAiC,CAAC;AACtD,MAAM,cAAc,GAClB,sDAAsD;IACtD,8DAA8D;IAC9D,qEAAqE,CAAC;AAQxE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAA0B,EAAU,EAAE;IACxE,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,CAAC,aAAa,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,eAAuB,EACvB,OAA0B,EAClB,EAAE;IACV,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC;QACzF,OAAO,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEjE,OAAO,MAAM,GAAG,YAAY,GAAG,KAAK,CAAC;AACvC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,aAAqB,EACrB,OAA0B,EACM,EAAE;IAClC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,QAAQ,KAAK,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzD,MAAM,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,OAAO;KACR,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,6 @@
+export type { ScaffoldingCloneResult, SyncAction, SyncedFileEntry, SyncLogger, SyncMissingFilesParams, SyncMissingFilesResult } from './types.js';
+export { cloneScaffolding, buildCloneArgs, DEFAULT_CYPRESS_REPOSITORY, resolveLatestTag, parseLatestTagFromLsRemote, } from './clone-scaffolding.js';
+export { syncMissingFiles } from './sync-missing-files.js';
+export { isExcluded, DEFAULT_EXCLUSION_PATTERNS } from './exclusion-list.js';
+export { updateGitignore, buildManagedSection, replaceManagedSection } from './gitignore-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAClJ,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/tests/index.js

@@ -0,0 +1,5 @@
+export { cloneScaffolding, buildCloneArgs, DEFAULT_CYPRESS_REPOSITORY, resolveLatestTag, parseLatestTagFromLsRemote, } from './clone-scaffolding.js';
+export { syncMissingFiles } from './sync-missing-files.js';
+export { isExcluded, DEFAULT_EXCLUSION_PATTERNS } from './exclusion-list.js';
+export { updateGitignore, buildManagedSection, replaceManagedSection } from './gitignore-manager.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/tests/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/tests/sync-missing-files.d.ts

@@ -0,0 +1,3 @@
+import type { SyncMissingFilesParams, SyncMissingFilesResult } from './types.js';
+export declare const syncMissingFiles: (params: SyncMissingFilesParams) => Promise<SyncMissingFilesResult>;
+//# sourceMappingURL=sync-missing-files.d.ts.map

package/dist/lib/tests/sync-missing-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-missing-files.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/sync-missing-files.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA+B,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAoE9G,eAAO,MAAM,gBAAgB,GAAU,QAAQ,sBAAsB,KAAG,OAAO,CAAC,sBAAsB,CAqBrG,CAAC"}

package/dist/lib/tests/sync-missing-files.js

@@ -0,0 +1,65 @@
+import { access, copyFile, mkdir, readdir } from 'node:fs/promises';
+import { dirname, join, relative, sep } from 'node:path';
+import { isExcluded, DEFAULT_EXCLUSION_PATTERNS } from './exclusion-list.js';
+const toPortablePath = (pathValue) => pathValue.split(sep).join('/');
+const destinationFileExists = async (destinationPath) => access(destinationPath)
+    .then(() => true)
+    .catch(() => false);
+const sortEntriesByPath = (entries) => [...entries].sort((left, right) => left.path.localeCompare(right.path));
+const noopLogger = () => undefined;
+const walkAndSync = async (params) => {
+    const entries = await readdir(params.sourceDir, { withFileTypes: true });
+    const nestedResults = await Promise.all(entries.map(async (entry) => {
+        const sourcePath = join(params.sourceDir, entry.name);
+        const destinationPath = join(params.destinationDir, entry.name);
+        if (entry.isDirectory()) {
+            await mkdir(destinationPath, { recursive: true });
+            return walkAndSync({
+                sourceDir: sourcePath,
+                destinationDir: destinationPath,
+                sourceRoot: params.sourceRoot,
+                exclusionPatterns: params.exclusionPatterns,
+                logger: params.logger,
+            });
+        }
+        if (!entry.isFile()) {
+            return [];
+        }
+        const relativePath = toPortablePath(relative(params.sourceRoot, sourcePath));
+        if (isExcluded(relativePath, params.exclusionPatterns)) {
+            const reason = 'excluded by policy';
+            params.logger('ignored', relativePath, reason);
+            return [{ path: relativePath, action: 'ignored', reason }];
+        }
+        if (await destinationFileExists(destinationPath)) {
+            const reason = 'already exists locally';
+            params.logger('kept', relativePath, reason);
+            return [{ path: relativePath, action: 'kept', reason }];
+        }
+        await mkdir(dirname(destinationPath), { recursive: true });
+        await copyFile(sourcePath, destinationPath);
+        const reason = 'imported from remote';
+        params.logger('copied', relativePath, reason);
+        return [{ path: relativePath, action: 'copied', reason }];
+    }));
+    return nestedResults.flatMap((value) => value);
+};
+export const syncMissingFiles = async (params) => {
+    const exclusionPatterns = params.exclusionPatterns ?? DEFAULT_EXCLUSION_PATTERNS;
+    const logger = params.logger ?? noopLogger;
+    await mkdir(params.destinationDir, { recursive: true });
+    const entries = sortEntriesByPath(await walkAndSync({
+        sourceDir: params.sourceDir,
+        destinationDir: params.destinationDir,
+        sourceRoot: params.sourceDir,
+        exclusionPatterns,
+        logger,
+    }));
+    return {
+        entries,
+        copied: entries.filter((entry) => entry.action === 'copied').map((entry) => entry.path),
+        kept: entries.filter((entry) => entry.action === 'kept').map((entry) => entry.path),
+        ignored: entries.filter((entry) => entry.action === 'ignored').map((entry) => entry.path),
+    };
+};
+//# sourceMappingURL=sync-missing-files.js.map

package/dist/lib/tests/sync-missing-files.js.map

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

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

@@ -0,0 +1,26 @@
+export interface ScaffoldingCloneResult {
+    readonly version: string;
+    readonly repositoryUrl: string;
+    readonly checkoutDir: string;
+    readonly scaffoldingDir: string;
+}
+export type SyncAction = 'copied' | 'kept' | 'ignored';
+export interface SyncedFileEntry {
+    readonly path: string;
+    readonly action: SyncAction;
+    readonly reason?: string | undefined;
+}
+export type SyncLogger = (action: SyncAction, relativePath: string, reason: string) => void;
+export interface SyncMissingFilesParams {
+    readonly sourceDir: string;
+    readonly destinationDir: string;
+    readonly exclusionPatterns?: readonly string[] | undefined;
+    readonly logger?: SyncLogger | undefined;
+}
+export interface SyncMissingFilesResult {
+    readonly entries: readonly SyncedFileEntry[];
+    readonly copied: readonly string[];
+    readonly kept: readonly string[];
+    readonly ignored: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC"}

package/dist/lib/tests/types.js

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

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

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

package/dist/lib/workflow/build-sample-workflow.d.ts

@@ -0,0 +1,8 @@
+import type { WorkflowsMap } from '../config/types.js';
+/**
+ * Builds a sample workflows configuration with representative steps
+ * to help users get started quickly. Returns a named workflows map
+ * with a single "main" workflow marked as default.
+ */
+export declare const buildSampleWorkflows: () => WorkflowsMap;
+//# sourceMappingURL=build-sample-workflow.d.ts.map

package/dist/lib/workflow/build-sample-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-sample-workflow.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/build-sample-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,YAgCtC,CAAC"}

package/dist/lib/workflow/build-sample-workflow.js

@@ -0,0 +1,39 @@
+/**
+ * Builds a sample workflows configuration with representative steps
+ * to help users get started quickly. Returns a named workflows map
+ * with a single "main" workflow marked as default.
+ */
+export const buildSampleWorkflows = () => ({
+    main: {
+        default: true,
+        steps: [
+            {
+                name: 'Initialize test scaffolding',
+                uses: 'tests:init',
+            },
+            {
+                name: 'Create Jahia environment',
+                uses: 'environment:create',
+                with: { force: 'true' },
+            },
+            {
+                name: 'Wait for Jahia to be healthy',
+                uses: 'environment:alive',
+                with: { timeout: '300' },
+            },
+            {
+                name: 'Install test dependencies',
+                run: 'yarn',
+            },
+            {
+                name: 'Run tests',
+                run: 'yarn run e2e:ci',
+            },
+            {
+                name: 'Cleanup environment',
+                uses: 'environment:delete',
+            },
+        ],
+    },
+});
+//# sourceMappingURL=build-sample-workflow.js.map

package/dist/lib/workflow/build-sample-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-sample-workflow.js","sourceRoot":"","sources":["../../../src/lib/workflow/build-sample-workflow.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAiB,EAAE,CAAC,CAAC;IACvD,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,6BAA6B;gBACnC,IAAI,EAAE,YAAY;aACnB;YACD;gBACE,IAAI,EAAE,0BAA0B;gBAChC,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;aACxB;YACD;gBACE,IAAI,EAAE,8BAA8B;gBACpC,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;aACzB;YACD;gBACE,IAAI,EAAE,2BAA2B;gBACjC,GAAG,EAAE,MAAM;aACZ;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,GAAG,EAAE,iBAAiB;aACvB;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,oBAAoB;aAC3B;SACF;KACuB;CAC3B,CAAC,CAAC"}

package/dist/lib/workflow/executor.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowStep, WorkflowsMap } from '../config/types.js';
+import type { StepResult, WorkflowResult } from './types.js';
+/**
+ * Options for executing a workflow.
+ */
+export interface ExecuteWorkflowOptions {
+    readonly steps: readonly WorkflowStep[];
+    readonly configPath: string;
+    readonly statePath?: string | undefined;
+    readonly cwd: string;
+    readonly onStepStart?: ((name: string, index: number) => void) | undefined;
+    readonly onStepComplete?: ((result: StepResult, index: number) => void) | undefined;
+    readonly cliEntryPoint: string;
+    readonly workflows?: WorkflowsMap | undefined;
+    readonly callStack?: readonly string[] | undefined;
+}
+/**
+ * Executes a workflow's steps sequentially.
+ * Each step's environment is accumulated and passed to subsequent steps.
+ * Stops on first failure.
+ */
+export declare const executeWorkflow: (options: ExecuteWorkflowOptions) => Promise<WorkflowResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/lib/workflow/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/lib/workflow/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACpD;AAyKD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,sBAAsB,KAAG,OAAO,CAAC,cAAc,CAqB7F,CAAC"}