@simplysf/simply-cicd-core 0.11.0 → 0.12.1

package/lib/build/publishAerPackage.js

@@ -0,0 +1,335 @@
+/*
+ * 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 { createHash } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execa } from 'execa';
+import { getDefaultPackageDirectory, isSubscriberPackageVersionId, readSfdxProject, } from '@simplysf/simply-core';
+import { appendToEnvFile } from '../env.js';
+import { logger } from '../logger.js';
+import { getPackage2Info, getPackageVersionReport, resolveDependencyVersionId, } from '../sfPackages.js';
+import { readAerVersion, resolveAerBinary } from './aerBinary.js';
+import { AER_PACKAGE_FILE_KEY, AER_PACKAGE_URL_KEY, AER_PACKAGE_VERSION_KEY, hasApexSources, parseRepositoryHeader, readAerPluginConfig, renderRepositoryUrl, toAerPackageFile, } from './aerPackage.js';
+import { resolveSubscriberPackageVersionId, toDistTag, toNpmVersion } from './packageVersionArtifact.js';
+import { getSkipReason } from './skipGuard.js';
+/** The default dotenv file, matching what `create-package-version`/`create-fallback-tag` write. */
+const DEFAULT_ENV_FILE = 'subscriberPackageVersionId.env';
+/** How much of a failed response's body goes into the error. */
+const RESPONSE_EXCERPT_LENGTH = 500;
+/** A run that did nothing, in the shape every guard returns. */
+function skip() {
+    return { skipped: true, published: false };
+}
+/**
+ * Where a package version lives in the repository.
+ *
+ * Producer and dependent both call this, so they always agree. Everything comes from the Dev Hub
+ * rather than either repo's checkout: the package's name and namespace from `Package2`, and the
+ * git tag suffix from the version's `Branch`, which `create-package-version` sets from the same
+ * decision it makes for the tag.
+ */
+function locate(package2, report, template) {
+    if (!report.Version) {
+        throw new Error(`Could not read a version number for ${package2.Name} from its package version report.`);
+    }
+    const { file, name, namespace } = toAerPackageFile(package2.Name, package2.NamespacePrefix);
+    const suffix = report.Branch ?? undefined;
+    const version = toNpmVersion(report.Version, suffix);
+    const url = renderRepositoryUrl(template, {
+        name,
+        version,
+        versionNumber: report.Version,
+        channel: toDistTag(suffix),
+        namespace,
+        file,
+    });
+    return { name, namespace, namespaceless: !package2.NamespacePrefix, file, version, url };
+}
+/** The URL without its query string, which for a presigned URL is the credential. */
+function forLog(url) {
+    const queryStart = url.indexOf('?');
+    return queryStart === -1 ? url : `${url.slice(0, queryStart)}?…`;
+}
+function requestHeaders(header) {
+    return header ? { [header.name]: header.value } : {};
+}
+async function responseExcerpt(response) {
+    try {
+        const body = (await response.text()).trim();
+        return body.length > 0 ? `: ${body.slice(0, RESPONSE_EXCERPT_LENGTH)}` : '';
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Whether `url` already holds a published package.
+ *
+ * Anything but a 2xx — including a network failure — is read as "not yet": the common cause is the
+ * 404 for a version that doesn't exist, and any real problem fails the upload right after with a
+ * better message than this check could give.
+ */
+async function isAlreadyPublished(url, header) {
+    try {
+        const response = await fetch(url, { method: 'HEAD', headers: requestHeaders(header) });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve every input the publish needs, or decide there is nothing to publish.
+ *
+ * @returns `undefined` when a guard says to skip, having already logged why.
+ */
+async function resolveTarget(options) {
+    const envFile = options.envFile ?? DEFAULT_ENV_FILE;
+    const subscriberPackageVersionId = await resolveSubscriberPackageVersionId({
+        flagValue: options.subscriberPackageVersionId,
+        envFile,
+    });
+    if (!subscriberPackageVersionId) {
+        logger.warn(`No package version ID given, in the environment, or in ${envFile}. ` +
+            'This build created no package version, so there is no aer package to publish. Skipping.');
+        return undefined;
+    }
+    const sfdxProjectJson = await readSfdxProject();
+    const defaultPackageDir = getDefaultPackageDirectory(sfdxProjectJson);
+    if (!defaultPackageDir?.path) {
+        throw new Error('A default package directory with a `path` must be specified in sfdx-project.json.');
+    }
+    const packageDir = path.resolve(defaultPackageDir.path);
+    if (!(await hasApexSources(packageDir))) {
+        logger.info(`No Apex classes or triggers found under ${defaultPackageDir.path}. Skipping.`);
+        return undefined;
+    }
+    const template = options.repositoryUrl ?? readAerPluginConfig(sfdxProjectJson).repositoryUrl;
+    if (!template) {
+        throw new Error('No repository to publish to. Pass --repository-url, or set `plugins.simply.aer.repositoryUrl` in sfdx-project.json.');
+    }
+    const header = options.repositoryHeader ? parseRepositoryHeader(options.repositoryHeader) : undefined;
+    const report = await getPackageVersionReport(subscriberPackageVersionId, options.packagingDevhub);
+    if (!report.Package2Id) {
+        throw new Error(`Could not read a package ID for ${subscriberPackageVersionId} from its package version report.`);
+    }
+    const package2 = await getPackage2Info(report.Package2Id, options.packagingDevhub);
+    return {
+        subscriberPackageVersionId,
+        packageDir,
+        dependencies: defaultPackageDir.dependencies ?? [],
+        packageAliases: sfdxProjectJson.packageAliases ?? {},
+        template,
+        header,
+        location: locate(package2, report, template),
+    };
+}
+/**
+ * The `04t` a declared dependency points at: its alias or ID directly, or a `package` +
+ * `versionNumber` pair resolved through the Dev Hub.
+ */
+async function dependencyVersionId(dependency, packageAliases, devHub) {
+    const declared = dependency.package ?? '';
+    const id = packageAliases[declared] ?? declared;
+    if (dependency.versionNumber) {
+        return resolveDependencyVersionId(id, dependency.versionNumber, devHub, dependency.branch);
+    }
+    if (!isSubscriberPackageVersionId(id)) {
+        throw new Error(`Dependency "${declared}" doesn't resolve to a subscriber package version ID (04t).`);
+    }
+    return id;
+}
+/**
+ * Download the `.pkg` of every dependency this Dev Hub owns into `targetDir`.
+ *
+ * A dependency the Dev Hub can't report on (a managed package, or one from another Dev Hub) isn't
+ * fetched; it's expected in a `--dependency-package-dir`. aer decides whether anything is missing.
+ */
+async function stageDependencies(target, targetDir, options) {
+    const staged = [];
+    const external = [];
+    for (const dependency of target.dependencies) {
+        const label = dependency.package ?? '(unnamed dependency)';
+        // eslint-disable-next-line no-await-in-loop -- a handful of dependencies; ordering keeps the log readable
+        const versionId = await dependencyVersionId(dependency, target.packageAliases, options.packagingDevhub);
+        let report;
+        try {
+            // eslint-disable-next-line no-await-in-loop -- as above
+            report = await getPackageVersionReport(versionId, options.packagingDevhub);
+        }
+        catch {
+            external.push(label);
+            continue;
+        }
+        if (!report.Package2Id) {
+            external.push(label);
+            continue;
+        }
+        // eslint-disable-next-line no-await-in-loop -- as above
+        const location = locate(await getPackage2Info(report.Package2Id, options.packagingDevhub), report, target.template);
+        // eslint-disable-next-line no-await-in-loop -- as above
+        const response = await fetch(location.url, { headers: requestHeaders(target.header) });
+        if (!response.ok) {
+            throw new Error(`Could not download the aer package for dependency ${label} from ${forLog(location.url)} ` +
+                // eslint-disable-next-line no-await-in-loop -- as above
+                `(HTTP ${response.status}${await responseExcerpt(response)}). Has its pipeline published it?`);
+        }
+        // eslint-disable-next-line no-await-in-loop -- as above
+        await fs.writeFile(path.join(targetDir, location.file), Buffer.from(await response.arrayBuffer()));
+        logger.info(`Downloaded ${location.file} ${location.version} for dependency ${label}.`);
+        staged.push({ label, location });
+    }
+    if (external.length > 0) {
+        logger.info(`Not owned by this Dev Hub, so expected in --dependency-package-dir: ${external.join(', ')}. ` +
+            'A managed package can be mocked with `aer package mock <namespace>`.');
+    }
+    return staged;
+}
+/** Run `aer package create`, turning a failure into an error that carries aer's own message. */
+async function buildPackage(aerBinary, outputFile, packageDirs, target, staged, debug) {
+    const args = ['package', 'create', '-o', outputFile];
+    for (const dir of packageDirs) {
+        args.push('--package-dir', dir);
+    }
+    args.push(target.packageDir);
+    // `.aerrc` files are ignored so that a developer's or a repo's test settings can't change what
+    // gets published, and auto-update is off so the pinned binary is the one that runs.
+    const result = await execa(aerBinary, args, {
+        env: { AER_NO_RC: '1', AER_AUTOUPDATE_DISABLED: '1' },
+        reject: false,
+        stdio: debug ? 'inherit' : 'pipe',
+    });
+    if (result.exitCode === 0) {
+        return;
+    }
+    const output = [result.stderr, result.stdout]
+        .filter((part) => typeof part === 'string' && part.trim().length > 0)
+        .join('\n')
+        .trim();
+    let message = `aer package create failed (exit ${String(result.exitCode)})${output ? `:\n${output}` : '.'}`;
+    // aer only resolves a reference into a .pkg when it's namespace-qualified, and `create` has no
+    // `--default-namespace`, so a namespaceless package calling a namespaceless dependency can't build.
+    const namespaceless = staged.filter((dependency) => dependency.location.namespaceless);
+    if (target.location.namespaceless && namespaceless.length > 0 && /type check/i.test(output)) {
+        message +=
+            `\n\nThis package and ${namespaceless.map((d) => d.label).join(', ')} have no namespace. aer resolves ` +
+                'references into a dependency package only when they are namespace-qualified, and `aer package create` ' +
+                'has no --default-namespace, so this package cannot be built as an aer package yet.';
+    }
+    throw new Error(message);
+}
+/** `PUT` the package, with a SHA-256 header Artifactory verifies and other repositories ignore. */
+async function upload(file, target) {
+    const body = await fs.readFile(file);
+    const response = await fetch(target.location.url, {
+        method: 'PUT',
+        headers: {
+            ...requestHeaders(target.header),
+            'Content-Type': 'application/octet-stream',
+            'X-Checksum-Sha256': createHash('sha256').update(body).digest('hex'),
+        },
+        body,
+    });
+    if (!response.ok) {
+        throw new Error(`Uploading ${target.location.file} to ${forLog(target.location.url)} failed ` +
+            `(HTTP ${response.status}${await responseExcerpt(response)}).`);
+    }
+}
+/**
+ * Build the project's aer package (`.pkg`) for one package version and upload it to an artifact
+ * repository, under a path derived from the Salesforce version number.
+ *
+ * Runs after `create-package-version`, whose `04t` it takes as input, so that every Unlocked
+ * Package version has a matching aer package a consumer can test against locally. See
+ * `docs/design/0059-aer-package-publish.md` in `simply-plugins` for the reasoning, particularly why
+ * the file name carries the namespace and the version lives only in the path.
+ *
+ * Skips (without failing) when the package didn't change, when the job is disabled, when no `04t`
+ * can be found, when the package has no Apex, or when this exact version is already uploaded.
+ * Everything past those guards throws on failure: a missing aer package would silently break every
+ * consumer pinned to that version.
+ */
+export async function publishAerPackage(options) {
+    const skipReason = getSkipReason('publish-aer-package');
+    if (skipReason) {
+        logger.warn(skipReason);
+        return skip();
+    }
+    if (options.disabled) {
+        logger.warn('publish-aer-package is disabled. Skipping.');
+        return skip();
+    }
+    const target = await resolveTarget(options);
+    if (!target) {
+        return skip();
+    }
+    const { location } = target;
+    const outFile = options.out ?? DEFAULT_ENV_FILE;
+    const publishedKeys = {
+        [AER_PACKAGE_URL_KEY]: location.url,
+        [AER_PACKAGE_FILE_KEY]: location.file,
+        [AER_PACKAGE_VERSION_KEY]: location.version,
+    };
+    const described = { packageName: location.name, namespace: location.namespace, version: location.version };
+    logger.info(`Publishing ${location.file} ${location.version} to ${forLog(location.url)}.`);
+    if (!options.dryRun && (await isAlreadyPublished(location.url, target.header))) {
+        logger.info(`${location.file} ${location.version} is already published. Skipping.`);
+        appendToEnvFile(outFile, publishedKeys);
+        return {
+            skipped: true,
+            published: false,
+            alreadyPublished: true,
+            ...described,
+            url: location.url,
+            file: location.file,
+        };
+    }
+    const aerBinary = await resolveAerBinary({ aerPath: options.aerPath });
+    const aerVersion = await readAerVersion(aerBinary);
+    logger.info(`Using aer ${aerVersion ?? '(unknown version)'} at ${aerBinary}.`);
+    // Never inside the repo: aer compiles the package directory, and nothing generated should land in it.
+    const stagingDir = await fs.mkdtemp(path.join(os.tmpdir(), 'simply-cicd-aer-'));
+    if (options.debug) {
+        logger.debug(`Staging directory: ${stagingDir}`);
+    }
+    try {
+        const dependenciesDir = path.join(stagingDir, 'dependencies');
+        await fs.mkdir(dependenciesDir);
+        const staged = await stageDependencies(target, dependenciesDir, options);
+        const outputFile = path.join(stagingDir, location.file);
+        await buildPackage(aerBinary, outputFile, [dependenciesDir, ...(options.dependencyPackageDirs ?? []).map((dir) => path.resolve(dir))], target, staged, options.debug ?? false);
+        if (options.dryRun) {
+            const destination = path.join(process.cwd(), location.file);
+            await fs.copyFile(outputFile, destination);
+            logger.success(`Dry run: built ${destination}. Nothing was uploaded.`);
+            return { skipped: false, published: false, ...described, url: location.url, file: destination, aerVersion };
+        }
+        await upload(outputFile, target);
+        logger.success(`Published ${location.file} ${location.version}.`);
+        appendToEnvFile(outFile, publishedKeys);
+        return { skipped: false, published: true, ...described, url: location.url, file: location.file, aerVersion };
+    }
+    finally {
+        if (options.debug) {
+            logger.debug(`Leaving the staging directory in place for inspection: ${stagingDir}`);
+        }
+        else {
+            await fs.rm(stagingDir, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=publishAerPackage.js.map

package/lib/build/publishAerPackage.js.map

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

package/lib/build/skipGuard.js

@@ -22,6 +22,7 @@ const PACKAGE_CHANGED_GATED_JOBS = new Set([
     'delete-scratch',
     'create-package-version',
     'publish-utam-page-objects',
+    'publish-aer-package',
 ]);
 /**
  * Returns a warning message (and thus "should skip") if `job` should be skipped given the current

package/lib/build/skipGuard.js.map

@@ -1 +1 @@
-{"version":3,"file":"skipGuard.js","sourceRoot":"","sources":["../../src/build/skipGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,0EAA0E;AAC1E,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,gBAAgB;IAChB,sBAAsB;IACtB,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,wBAAwB;IACxB,2BAA2B;CAC5B,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;QACnF,OAAO,sEAAsE,GAAG,EAAE,CAAC;IACrF,CAAC;IAED,IAAI,GAAG,KAAK,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;QAC5E,OAAO,kFAAkF,CAAC;IAC5F,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"skipGuard.js","sourceRoot":"","sources":["../../src/build/skipGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,0EAA0E;AAC1E,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,gBAAgB;IAChB,sBAAsB;IACtB,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,wBAAwB;IACxB,2BAA2B;IAC3B,qBAAqB;CACtB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;QACnF,OAAO,sEAAsE,GAAG,EAAE,CAAC;IACrF,CAAC;IAED,IAAI,GAAG,KAAK,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;QAC5E,OAAO,kFAAkF,CAAC;IAC5F,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/build/utamPageObjects.d.ts

@@ -1,7 +1,6 @@
 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";
+export { readEnvFileValue, resolveSubscriberPackageVersionId, type ResolveSubscriberPackageVersionIdOptions, sanitizePrereleaseId, SUBSCRIBER_PACKAGE_VERSION_ID_KEY, toDistTag, toNpmVersion, } from './packageVersionArtifact.js';
 /** 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";
@@ -30,32 +29,8 @@ export type UtamPluginConfig = {
 };
 /** @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`
@@ -146,28 +121,3 @@ export declare function findUtilitySources(rootDir: string): Promise<string[]>;
  * @returns One message per clashing name, naming every source behind it. Empty when none clash.
  */
 export declare function findOutputNameClashes(sources: string[], extension: string, rootDir: string): 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

@@ -15,11 +15,11 @@
  */
 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 { getPluginConfig } from '@simplysf/simply-core';
 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';
+// Moved to packageVersionArtifact.ts, which aer packages share. Re-exported so this module's
+// surface is unchanged.
+export { readEnvFileValue, resolveSubscriberPackageVersionId, sanitizePrereleaseId, SUBSCRIBER_PACKAGE_VERSION_ID_KEY, toDistTag, toNpmVersion, } from './packageVersionArtifact.js';
 /** 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';
@@ -35,70 +35,14 @@ export const STAGED_SOURCE_DIR = 'source';
  * `@scope/` folder; a fixed name gives every package the same, flat path.
  */
 export const PROFILES_CONFIG_FILE = 'profiles.config.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`
@@ -246,68 +190,4 @@ async function findUnderUtamFolders(rootDir, extension) {
         .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

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

package/lib/index.d.ts

@@ -10,6 +10,8 @@ export * from './sfDeploy.js';
 export * from './sfOrg.js';
 export * from './sfPackages.js';
 export * from './sfPlugins.js';
+export * from './build/aerBinary.js';
+export * from './build/aerPackage.js';
 export * from './build/checkPermissionSets.js';
 export * from './build/cleanupScratchOrgs.js';
 export * from './build/createFallbackTag.js';
@@ -23,6 +25,8 @@ export * from './build/flexipageDelta.js';
 export * from './build/flowDelta.js';
 export * from './build/installDependencies.js';
 export * from './build/lwcJest.js';
+export * from './build/packageVersionArtifact.js';
+export * from './build/publishAerPackage.js';
 export * from './build/publishUtamPageObjects.js';
 export * from './build/pushScratch.js';
 export * from './build/scratchOrgAuth.js';