@simplysf/simply-cicd-core 0.2.2 → 0.4.0

package/lib/build/testScratch.js

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { logger } from '../logger.js';
+import { runApexTests as runApexTestsCommon } from '../sfApex.js';
+import { ensureScratchOrgSession } from './scratchOrgAuth.js';
+import { readScratchOrgInfo } from './scratchOrgInfo.js';
+/**
+ * Authenticates to the scratch org and runs its Apex tests.
+ *
+ * The original `--disable-apex-tests` flag was checked against the wrong option name internally
+ * (it re-checked the generic `--disabled` flag), making it a no-op. Here it actually gates the
+ * test run.
+ */
+export async function runScratchApexTests(options) {
+    if (options.disableApexTests) {
+        logger.warn('Apex tests are disabled via --disable-apex-tests. Skipping.');
+        return;
+    }
+    logger.info('Authenticating to scratch org for tests...');
+    const scratchOrgInfo = await readScratchOrgInfo();
+    await ensureScratchOrgSession(scratchOrgInfo.authFields, {
+        jwtKeyFile: options.jwtKeyFile,
+        setDefault: true,
+        debug: options.debug,
+    });
+    // A default org is now set, so no alias is needed.
+    await runApexTestsCommon({ testLevel: 'RunLocalTests', wait: '60' });
+}
+//# sourceMappingURL=testScratch.js.map

package/lib/build/testScratch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testScratch.js","sourceRoot":"","sources":["../../src/build/testScratch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAUzD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAmC;IAC3E,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAClD,MAAM,uBAAuB,CAAC,cAAc,CAAC,UAAU,EAAE;QACvD,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,mDAAmD;IACnD,MAAM,kBAAkB,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/lib/build/utamPageObjects.d.ts

@@ -0,0 +1,143 @@
+import { type SfdxProject } from '@simplysf/simply-core';
+import { VersionTagFormat } from './versionTagFormat.js';
+/** The dotenv key `create-package-version` and `create-fallback-tag` both write their `04t` under. */
+export declare const SUBSCRIBER_PACKAGE_VERSION_ID_KEY = "SUBSCRIBER_PACKAGE_VERSION_ID";
+/** The dotenv keys this feature writes, for a downstream UI-test job to install by. */
+export declare const UTAM_PACKAGE_KEY = "UTAM_PAGE_OBJECTS_PACKAGE";
+export declare const UTAM_VERSION_KEY = "UTAM_PAGE_OBJECTS_VERSION";
+/** The compiler's own default mask, restated so the generated config never depends on it drifting. */
+export declare const PAGE_OBJECTS_FILE_MASK: string[];
+/** `plugins.simply.utam` in `sfdx-project.json`. Every field is optional. */
+export type UtamPluginConfig = {
+    /** npm package name to publish under. Required unless `--npm-package-name` is passed. */
+    packageName?: string;
+    /** UTAM compiler type-alias map, passed through to the generated compiler config. */
+    alias?: Record<string, string>;
+    /** Peer dependencies to merge into the generated package, e.g. `salesforce-pageobjects`. */
+    peerDependencies?: Record<string, string>;
+    /** Path to a compiler config whose keys the command doesn't own (`profiles`, `lint`, …). */
+    compilerConfig?: string;
+};
+/** @returns `plugins.simply.utam`, or an empty object when the project declares none. */
+export declare function readUtamPluginConfig(project: SfdxProject): UtamPluginConfig;
+/**
+ * Reduce a git tag suffix to something semver accepts as a prerelease identifier.
+ *
+ * Semver's prerelease alphabet is `[0-9A-Za-z-]`; a branch name's `/` and `.` are the common
+ * offenders, so each run of anything else collapses to a single hyphen.
+ */
+export declare function sanitizePrereleaseId(raw: string): string;
+/** @returns The git tag `create-package-version` recorded this package version under. */
+export declare function toVersionTag(salesforceVersion: string, tagSuffix?: string, versionTagFormat?: VersionTagFormat): string;
+/**
+ * Map a Salesforce package version onto a semver version.
+ *
+ * The build number becomes the first prerelease identifier and the git tag's suffix, if any, the
+ * second — so `1.2.3.4` on a release branch is `1.2.3-4`, and the same version built from `beta`
+ * is `1.2.3-4.beta`. This is the transformation `sfdx-project.json` already uses for a dependency
+ * pin (`"package": "MyPackage@1.2.3-4"`), not a new convention.
+ *
+ * @throws {Error} If the version isn't `major.minor.patch.build`. Publishing a version derived
+ * from something unrecognised is worse than failing the job.
+ */
+export declare function toNpmVersion(salesforceVersion: string, tagSuffix?: string): string;
+/**
+ * The npm dist-tag for a build: `latest` for a release-branch build, else the sanitized tag suffix,
+ * so `npm install <pkg>@beta` reaches the newest build off the `beta` package branch.
+ */
+export declare function toDistTag(tagSuffix?: string): string;
+/**
+ * The `@utam/core` range the generated package declares as a peer, derived from the compiler that
+ * actually produced the output rather than hardcoded — generated page objects import `@utam/core`
+ * directly, and a consumer must resolve one copy of it across everything they load.
+ */
+export declare function toUtamCoreRange(utamVersion: string): string;
+/** The one line identifying which package version produced this output, used as both description and file header. */
+export declare function buildProvenanceLine(packageName: string, salesforceVersion: string, subscriberPackageVersionId: string): string;
+export type PackageManifestOptions = {
+    /** npm package name to publish under. */
+    npmPackageName: string;
+    /** The derived semver version. */
+    version: string;
+    /** The Salesforce package's name, for the provenance block. */
+    salesforcePackageName: string;
+    /** The Salesforce version, as `major.minor.patch.build`. */
+    salesforceVersion: string;
+    subscriberPackageVersionId: string;
+    /** The git tag `create-package-version` recorded this version under. */
+    versionTag: string;
+    /** The commit this package version was built from — the package version's `Tag` field. */
+    commitSha?: string;
+    /** The pipeline that built it — the package version's `Description` field. */
+    pipelineUrl?: string;
+    /** The `@utam/core` peer range, from {@link toUtamCoreRange}. */
+    utamCoreRange: string;
+    /** Extra peers from `plugins.simply.utam.peerDependencies`. */
+    projectPeerDependencies?: Record<string, string>;
+};
+/**
+ * The `package.json` for the published page-object package.
+ *
+ * Shaped after `salesforce-pageobjects`, which is what every UTAM consumer already imports from:
+ * ESM with a CJS fallback, page objects addressed by path (`<pkg>/pageObjects/<name>`), and the
+ * source JSON shipped alongside. The one deliberate difference is that `@utam/core` is declared as
+ * a peer here instead of being left to whatever the test's adapter drags in.
+ */
+export declare function buildPackageManifest(options: PackageManifestOptions): Record<string, unknown>;
+export type CompilerConfigOptions = {
+    /** Absolute path to the default package directory the page objects are authored under. */
+    pageObjectsRootDir: string;
+    /** Absolute path to the staging directory the compiler writes into. */
+    stagingDir: string;
+    npmPackageName: string;
+    version: string;
+    /** The provenance line, stamped as each generated file's header comment. */
+    copyright: string;
+    alias?: Record<string, string>;
+    /** Parsed `plugins.simply.utam.compilerConfig`, whose keys this command doesn't own. */
+    baseConfig?: Record<string, unknown>;
+};
+/**
+ * The `utam.config.json` the compiler is invoked with.
+ *
+ * Generated per build rather than read from the repo because the compiler has no flag for
+ * `version` — the only way to stamp the Salesforce version into the output is through the config
+ * file, so it cannot be a static artifact. A project's own config is merged underneath: the command
+ * owns the root, the masks, the output directories, `module`, `version`, and `copyright`; the
+ * project keeps everything else (`profiles`, `lint`, `interruptCompilerOnError`, …).
+ */
+export declare function buildCompilerConfig(options: CompilerConfigOptions): Record<string, unknown>;
+/**
+ * Every `.utam.json` authored under `rootDir`, matching the compiler's own `__utam__` convention.
+ *
+ * Walks the tree rather than globbing so this package takes on no glob dependency for one lookup.
+ *
+ * @returns Absolute paths, sorted. Empty when `rootDir` doesn't exist — a project that hasn't
+ * adopted UTAM is a skip, not an error.
+ */
+export declare function findPageObjectSources(rootDir: string): Promise<string[]>;
+/** @returns The last value assigned to `key` in dotenv-shaped `content`, or `undefined`. */
+export declare function readEnvFileValue(content: string, key: string): string | undefined;
+export type ResolveSubscriberPackageVersionIdOptions = {
+    /** `--subscriber-package-version-id`, if passed. */
+    flagValue?: string;
+    /** The environment to read `SUBSCRIBER_PACKAGE_VERSION_ID` from. Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Dotenv file to fall back to — the one `create-package-version` wrote earlier in this job. */
+    envFile: string;
+};
+/**
+ * Find the `04t` this run should publish page objects for.
+ *
+ * Three sources, because the command is useful from two pipeline shapes and they surface the value
+ * differently: an explicit flag; `SUBSCRIBER_PACKAGE_VERSION_ID` in the environment, which is how a
+ * *separate* job receives `create-package-version`'s dotenv report artifact; and the dotenv file
+ * itself, which is how the *same* job sees it, since a dotenv report only ever reaches other jobs.
+ *
+ * An explicit flag that isn't a `04t` throws — the caller asked for something specific and got it
+ * wrong. A malformed value discovered rather than passed only warns, and the search continues.
+ *
+ * @returns The ID, or `undefined` when no source has one.
+ * @throws {Error} If `flagValue` is not a subscriber package version ID.
+ */
+export declare function resolveSubscriberPackageVersionId(options: ResolveSubscriberPackageVersionIdOptions): Promise<string | undefined>;

package/lib/build/utamPageObjects.js

@@ -0,0 +1,258 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { getPluginConfig, isSubscriberPackageVersionId } from '@simplysf/simply-core';
+import { logger } from '../logger.js';
+import { DEFAULT_VERSION_TAG_FORMAT, VersionTagFormat } from './versionTagFormat.js';
+/** The dotenv key `create-package-version` and `create-fallback-tag` both write their `04t` under. */
+export const SUBSCRIBER_PACKAGE_VERSION_ID_KEY = 'SUBSCRIBER_PACKAGE_VERSION_ID';
+/** The dotenv keys this feature writes, for a downstream UI-test job to install by. */
+export const UTAM_PACKAGE_KEY = 'UTAM_PAGE_OBJECTS_PACKAGE';
+export const UTAM_VERSION_KEY = 'UTAM_PAGE_OBJECTS_VERSION';
+/** The compiler's own default mask, restated so the generated config never depends on it drifting. */
+export const PAGE_OBJECTS_FILE_MASK = ['**/__utam__/**/*.utam.json'];
+/** `sf package version report` returns `Version` as `major.minor.patch.build`, which is not semver. */
+const SALESFORCE_VERSION_PATTERN = /^(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)\.(?<build>\d+)$/;
+/** @returns `plugins.simply.utam`, or an empty object when the project declares none. */
+export function readUtamPluginConfig(project) {
+    return getPluginConfig(project, 'plugins.simply.utam') ?? {};
+}
+/**
+ * Strip leading and trailing hyphens. Done by index rather than `/^-+|-+$/`, whose trailing
+ * alternative backtracks quadratically on a long run of interior hyphens.
+ */
+function trimHyphens(value) {
+    let start = 0;
+    let end = value.length;
+    while (start < end && value[start] === '-')
+        start++;
+    while (end > start && value[end - 1] === '-')
+        end--;
+    return value.slice(start, end);
+}
+/**
+ * Reduce a git tag suffix to something semver accepts as a prerelease identifier.
+ *
+ * Semver's prerelease alphabet is `[0-9A-Za-z-]`; a branch name's `/` and `.` are the common
+ * offenders, so each run of anything else collapses to a single hyphen.
+ */
+export function sanitizePrereleaseId(raw) {
+    const cleaned = trimHyphens(raw.replace(/[^0-9A-Za-z-]+/g, '-'));
+    // Semver forbids leading zeros in an all-numeric identifier, so a branch literally named `007`
+    // would otherwise produce a version every registry rejects. Prefixing keeps it traceable.
+    return /^0\d+$/.test(cleaned) ? `v${cleaned}` : cleaned;
+}
+/** @returns The git tag `create-package-version` recorded this package version under. */
+export function toVersionTag(salesforceVersion, tagSuffix, versionTagFormat = VersionTagFormat.parse(DEFAULT_VERSION_TAG_FORMAT)) {
+    return versionTagFormat.render(salesforceVersion, tagSuffix);
+}
+/**
+ * Map a Salesforce package version onto a semver version.
+ *
+ * The build number becomes the first prerelease identifier and the git tag's suffix, if any, the
+ * second — so `1.2.3.4` on a release branch is `1.2.3-4`, and the same version built from `beta`
+ * is `1.2.3-4.beta`. This is the transformation `sfdx-project.json` already uses for a dependency
+ * pin (`"package": "MyPackage@1.2.3-4"`), not a new convention.
+ *
+ * @throws {Error} If the version isn't `major.minor.patch.build`. Publishing a version derived
+ * from something unrecognised is worse than failing the job.
+ */
+export function toNpmVersion(salesforceVersion, tagSuffix) {
+    const match = SALESFORCE_VERSION_PATTERN.exec(salesforceVersion.trim());
+    if (!match?.groups) {
+        throw new Error(`Cannot derive an npm version from Salesforce package version "${salesforceVersion}": expected major.minor.patch.build.`);
+    }
+    const { major, minor, patch, build } = match.groups;
+    const sanitizedSuffix = tagSuffix ? sanitizePrereleaseId(tagSuffix) : '';
+    const prerelease = sanitizedSuffix ? `${build}.${sanitizedSuffix}` : build;
+    return `${major}.${minor}.${patch}-${prerelease}`;
+}
+/**
+ * The npm dist-tag for a build: `latest` for a release-branch build, else the sanitized tag suffix,
+ * so `npm install <pkg>@beta` reaches the newest build off the `beta` package branch.
+ */
+export function toDistTag(tagSuffix) {
+    const sanitized = tagSuffix ? sanitizePrereleaseId(tagSuffix) : '';
+    return sanitized.length > 0 ? sanitized : 'latest';
+}
+/**
+ * The `@utam/core` range the generated package declares as a peer, derived from the compiler that
+ * actually produced the output rather than hardcoded — generated page objects import `@utam/core`
+ * directly, and a consumer must resolve one copy of it across everything they load.
+ */
+export function toUtamCoreRange(utamVersion) {
+    const match = /^(?<major>\d+)\.(?<minor>\d+)\./.exec(utamVersion.trim());
+    if (!match?.groups) {
+        throw new Error(`Could not read a major.minor version from the installed utam compiler: "${utamVersion}".`);
+    }
+    return `^${match.groups.major}.${match.groups.minor}.0`;
+}
+/** The one line identifying which package version produced this output, used as both description and file header. */
+export function buildProvenanceLine(packageName, salesforceVersion, subscriberPackageVersionId) {
+    return `UTAM page objects for ${packageName} ${salesforceVersion} (${subscriberPackageVersionId})`;
+}
+/**
+ * The `package.json` for the published page-object package.
+ *
+ * Shaped after `salesforce-pageobjects`, which is what every UTAM consumer already imports from:
+ * ESM with a CJS fallback, page objects addressed by path (`<pkg>/pageObjects/<name>`), and the
+ * source JSON shipped alongside. The one deliberate difference is that `@utam/core` is declared as
+ * a peer here instead of being left to whatever the test's adapter drags in.
+ */
+export function buildPackageManifest(options) {
+    return {
+        name: options.npmPackageName,
+        version: options.version,
+        description: buildProvenanceLine(options.salesforcePackageName, options.salesforceVersion, options.subscriberPackageVersionId),
+        type: 'module',
+        files: ['pageObjects', 'utils', 'source'],
+        exports: {
+            './package.json': './package.json',
+            './*': {
+                import: { types: './*.d.ts', default: './*.js' },
+                require: { types: './*.d.cts', default: './*.cjs' },
+            },
+        },
+        peerDependencies: {
+            '@utam/core': options.utamCoreRange,
+            ...options.projectPeerDependencies,
+        },
+        salesforce: {
+            package: options.salesforcePackageName,
+            versionNumber: options.salesforceVersion,
+            subscriberPackageVersionId: options.subscriberPackageVersionId,
+            tag: options.versionTag,
+            ...(options.commitSha ? { commitSha: options.commitSha } : {}),
+            ...(options.pipelineUrl ? { pipelineUrl: options.pipelineUrl } : {}),
+        },
+    };
+}
+/**
+ * The `utam.config.json` the compiler is invoked with.
+ *
+ * Generated per build rather than read from the repo because the compiler has no flag for
+ * `version` — the only way to stamp the Salesforce version into the output is through the config
+ * file, so it cannot be a static artifact. A project's own config is merged underneath: the command
+ * owns the root, the masks, the output directories, `module`, `version`, and `copyright`; the
+ * project keeps everything else (`profiles`, `lint`, `interruptCompilerOnError`, …).
+ */
+export function buildCompilerConfig(options) {
+    return {
+        ...options.baseConfig,
+        pageObjectsRootDir: options.pageObjectsRootDir,
+        pageObjectsFileMask: PAGE_OBJECTS_FILE_MASK,
+        pageObjectsOutputDir: path.join(options.stagingDir, 'pageObjects'),
+        extensionsOutputDir: path.join(options.stagingDir, 'utils'),
+        moduleTarget: 'module',
+        // The package's own name, so a page object can reference a sibling as
+        // `<npm name>/pageObjects/<name>` and have the generated import resolve once installed.
+        module: options.npmPackageName,
+        version: options.version,
+        copyright: [options.copyright],
+        ...(options.alias ? { alias: options.alias } : {}),
+    };
+}
+/**
+ * Every `.utam.json` authored under `rootDir`, matching the compiler's own `__utam__` convention.
+ *
+ * Walks the tree rather than globbing so this package takes on no glob dependency for one lookup.
+ *
+ * @returns Absolute paths, sorted. Empty when `rootDir` doesn't exist — a project that hasn't
+ * adopted UTAM is a skip, not an error.
+ */
+export async function findPageObjectSources(rootDir) {
+    let entries;
+    try {
+        entries = await fs.readdir(rootDir, { recursive: true, withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+    return entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith('.utam.json'))
+        .map((entry) => path.join(entry.parentPath, entry.name))
+        .filter((file) => path.relative(rootDir, file).split(/[\\/]/).includes('__utam__'))
+        .sort();
+}
+/** @returns The last value assigned to `key` in dotenv-shaped `content`, or `undefined`. */
+export function readEnvFileValue(content, key) {
+    let found;
+    for (const line of content.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0 || trimmed.startsWith('#')) {
+            continue;
+        }
+        const separator = trimmed.indexOf('=');
+        if (separator !== -1 && trimmed.slice(0, separator).trim() === key) {
+            // Last wins: the file is appended to, so a later line is the newer value.
+            found = trimmed.slice(separator + 1).trim();
+        }
+    }
+    return found;
+}
+/**
+ * Find the `04t` this run should publish page objects for.
+ *
+ * Three sources, because the command is useful from two pipeline shapes and they surface the value
+ * differently: an explicit flag; `SUBSCRIBER_PACKAGE_VERSION_ID` in the environment, which is how a
+ * *separate* job receives `create-package-version`'s dotenv report artifact; and the dotenv file
+ * itself, which is how the *same* job sees it, since a dotenv report only ever reaches other jobs.
+ *
+ * An explicit flag that isn't a `04t` throws — the caller asked for something specific and got it
+ * wrong. A malformed value discovered rather than passed only warns, and the search continues.
+ *
+ * @returns The ID, or `undefined` when no source has one.
+ * @throws {Error} If `flagValue` is not a subscriber package version ID.
+ */
+export async function resolveSubscriberPackageVersionId(options) {
+    const { flagValue, env = process.env, envFile } = options;
+    if (flagValue) {
+        if (!isSubscriberPackageVersionId(flagValue)) {
+            throw new Error(`--subscriber-package-version-id must be a subscriber package version ID (04t), got "${flagValue}".`);
+        }
+        return flagValue;
+    }
+    const fromEnv = env[SUBSCRIBER_PACKAGE_VERSION_ID_KEY];
+    if (fromEnv) {
+        if (isSubscriberPackageVersionId(fromEnv)) {
+            logger.info(`Using ${SUBSCRIBER_PACKAGE_VERSION_ID_KEY} from the environment: ${fromEnv}`);
+            return fromEnv;
+        }
+        logger.warn(`Ignoring ${SUBSCRIBER_PACKAGE_VERSION_ID_KEY}="${fromEnv}" from the environment: not a 04t ID.`);
+    }
+    let content;
+    try {
+        content = await fs.readFile(envFile, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    const fromFile = readEnvFileValue(content, SUBSCRIBER_PACKAGE_VERSION_ID_KEY);
+    if (!fromFile) {
+        return undefined;
+    }
+    if (!isSubscriberPackageVersionId(fromFile)) {
+        logger.warn(`Ignoring ${SUBSCRIBER_PACKAGE_VERSION_ID_KEY}="${fromFile}" in ${envFile}: not a 04t ID.`);
+        return undefined;
+    }
+    logger.info(`Using ${SUBSCRIBER_PACKAGE_VERSION_ID_KEY} from ${envFile}: ${fromFile}`);
+    return fromFile;
+}
+//# sourceMappingURL=utamPageObjects.js.map

package/lib/build/utamPageObjects.js.map

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

package/lib/build/versionTagFormat.d.ts

@@ -0,0 +1,57 @@
+import { type SfdxProject } from '@simplysf/simply-core';
+/** The tag shape every `simply cicd build` command used before the format was configurable. */
+export declare const DEFAULT_VERSION_TAG_FORMAT = "v{MAJOR}.{MINOR}.{PATCH}.{BUILD}";
+/** Where in `sfdx-project.json` a project declares its own format. */
+export declare const VERSION_TAG_FORMAT_CONFIG_PATH = "plugins.simply.versionTagFormat";
+/** Overrides the project's format, in every command that reads it, when set to a non-empty value. */
+export declare const VERSION_TAG_FORMAT_ENV_VAR = "SIMPLY_CICD_VERSION_TAG_FORMAT";
+declare const PLACEHOLDERS: readonly ["MAJOR", "MINOR", "PATCH", "BUILD"];
+type Placeholder = (typeof PLACEHOLDERS)[number];
+/** A Salesforce package version's four numeric parts. */
+export type VersionParts = Record<Lowercase<Placeholder>, string>;
+/** Thrown for a format that can't be used, so callers that otherwise swallow errors can let it through. */
+export declare class VersionTagFormatError extends Error {
+    constructor(format: string, problem: string, source?: string);
+}
+/** A tag split back into the version the format rendered and whatever was appended after it. */
+export type ParsedVersionTag = {
+    /** The rendered version, exactly as it appears at the start of the tag. */
+    versionTag: string;
+    version: VersionParts;
+    /** Everything after the rendered version, without its leading `-`; `''` when there is none. */
+    rest: string;
+};
+/**
+ * A validated version tag format. Every command that writes or reads a package version's git tag
+ * goes through one of these, so they agree on the tag's shape.
+ */
+export declare class VersionTagFormat {
+    readonly format: string;
+    private readonly segments;
+    private readonly tagPattern;
+    private constructor();
+    /** @throws {VersionTagFormatError} If the format can't produce distinct, parseable, legal tags. */
+    static parse(format: string): VersionTagFormat;
+    /**
+     * The format in `SIMPLY_CICD_VERSION_TAG_FORMAT` when it's set, otherwise the one declared under
+     * `plugins.simply.versionTagFormat`, otherwise the default.
+     *
+     * @throws {VersionTagFormatError} If the chosen format is invalid.
+     */
+    static fromProject(project: SfdxProject | undefined): VersionTagFormat;
+    /**
+     * The tag for `salesforceVersion` (`major.minor.patch.build`), with `-<suffix>` appended when given.
+     *
+     * @throws {Error} If the version isn't four numeric parts.
+     */
+    render(salesforceVersion: string, suffix?: string): string;
+    /**
+     * A `git describe --match` / `git tag --list` glob for tags of the `major.minor.patch` that
+     * `versionNumber` (e.g. `6.40.0.NEXT`) declares, with any build and suffix. Without a usable
+     * `versionNumber`, any tag starting the way the format starts.
+     */
+    matchPattern(versionNumber?: string): string;
+    /** Splits a tag this format rendered back into its version and suffix; `undefined` if it doesn't match. */
+    parseTag(tag: string): ParsedVersionTag | undefined;
+}
+export {};