@lesliechan721/aw 0.1.0-beta.7 → 0.1.0-beta.8

package/dist/src/utils/catalog-generation-state.d.ts

@@ -0,0 +1,13 @@
+import type { CatalogGenerationStateFileV1 } from '../types.js';
+export declare function validateCatalogGenerationState(value: unknown): CatalogGenerationStateFileV1;
+export declare function createEmptyCatalogGenerationState(): CatalogGenerationStateFileV1;
+export declare function resolveCatalogGenerationStatePath(env?: NodeJS.ProcessEnv): string;
+export declare function readCatalogGenerationState(env?: NodeJS.ProcessEnv): Promise<CatalogGenerationStateFileV1>;
+export declare function withCatalogGenerationStateTransaction<T>(options: {
+    env?: NodeJS.ProcessEnv;
+    beforeReplace?: (next: CatalogGenerationStateFileV1) => Promise<void> | void;
+    action: (current: CatalogGenerationStateFileV1) => Promise<{
+        state: CatalogGenerationStateFileV1;
+        result: T;
+    }>;
+}): Promise<T>;

package/dist/src/utils/catalog-generation-state.js

@@ -0,0 +1,201 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CATALOG_GENERATIONS_FILE, CATALOG_GENERATIONS_SCHEMA_VERSION, } from '../constants.js';
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { createCatalogGenerationKey } from './catalog-generation-store.js';
+import { CATALOG_SOURCE_ID_PATTERN } from './catalog-sources.js';
+import { parseStrictSemVer } from './manifest.js';
+import { atomicReplaceConfigFile } from './plugin-config.js';
+import { resolveAwHome } from './state-paths.js';
+const SHA256_DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/u;
+const RESOLVED_COMMIT_PATTERN = /^(?:[0-9a-f]{40}|[0-9a-f]{64}|path:sha256:[0-9a-f]{64})$/u;
+function stateError(message, cause) {
+    return new CatalogGenerationError({
+        code: 'catalogGenerationStateInvalid',
+        message: `${message} Repair or remove catalog-generations.json, then refresh configured sources. This state never authorizes plugin deletion.`,
+        cause,
+    });
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function assertAllowedKeys(value, fieldName, allowed) {
+    const unexpected = Object.keys(value).find((key) => !allowed.includes(key));
+    if (unexpected)
+        throw stateError(`Invalid ${fieldName}: unknown field "${unexpected}".`);
+}
+function parseDate(value, fieldName) {
+    if (typeof value !== 'string' || Number.isNaN(Date.parse(value))) {
+        throw stateError(`Invalid ${fieldName}: expected an ISO date.`);
+    }
+    return value;
+}
+function parsePointer(value, fieldName, candidate) {
+    if (!isRecord(value))
+        throw stateError(`Invalid ${fieldName}: expected an object.`);
+    const baseKeys = [
+        'sourceConfigFingerprint', 'catalogVersion', 'channel', 'requestedRef', 'resolvedCommit', 'manifestDigest',
+        'snapshotDigest', 'generationKey', 'activatedAt',
+    ];
+    assertAllowedKeys(value, fieldName, candidate ? [...baseKeys, 'candidateKind', 'downloadedAt'] : baseKeys);
+    if (typeof value.sourceConfigFingerprint !== 'string'
+        || !SHA256_DIGEST_PATTERN.test(value.sourceConfigFingerprint)
+        || typeof value.catalogVersion !== 'string'
+        || (value.channel !== 'latest' && value.channel !== 'beta')
+        || typeof value.requestedRef !== 'string'
+        || value.requestedRef.length === 0
+        || typeof value.resolvedCommit !== 'string'
+        || !RESOLVED_COMMIT_PATTERN.test(value.resolvedCommit)
+        || typeof value.manifestDigest !== 'string'
+        || !SHA256_DIGEST_PATTERN.test(value.manifestDigest)
+        || typeof value.snapshotDigest !== 'string'
+        || !SHA256_DIGEST_PATTERN.test(value.snapshotDigest)
+        || typeof value.generationKey !== 'string'
+        || !/^[0-9a-f]{64}\/[0-9a-f]{64}$/u.test(value.generationKey))
+        throw stateError(`Invalid ${fieldName}.`);
+    try {
+        parseStrictSemVer(value.catalogVersion, `${fieldName}.catalogVersion`);
+    }
+    catch (error) {
+        throw stateError(`Invalid ${fieldName}.catalogVersion.`, error);
+    }
+    const pointer = {
+        sourceConfigFingerprint: value.sourceConfigFingerprint,
+        catalogVersion: value.catalogVersion,
+        channel: value.channel,
+        requestedRef: value.requestedRef,
+        resolvedCommit: value.resolvedCommit,
+        manifestDigest: value.manifestDigest,
+        snapshotDigest: value.snapshotDigest,
+        generationKey: value.generationKey,
+        ...(value.activatedAt === undefined
+            ? {}
+            : { activatedAt: parseDate(value.activatedAt, `${fieldName}.activatedAt`) }),
+    };
+    if (!candidate)
+        return pointer;
+    if ((value.candidateKind !== 'upgrade' && value.candidateKind !== 'refChange')
+        || value.activatedAt !== undefined)
+        throw stateError(`Invalid ${fieldName} candidate fields.`);
+    return {
+        ...pointer,
+        candidateKind: value.candidateKind,
+        downloadedAt: parseDate(value.downloadedAt, `${fieldName}.downloadedAt`),
+    };
+}
+function parseLastCheck(value, fieldName) {
+    if (!isRecord(value))
+        throw stateError(`Invalid ${fieldName}: expected an object.`);
+    assertAllowedKeys(value, fieldName, ['checkedAt', 'state', 'remoteCommit', 'errorCode']);
+    const states = new Set([
+        'upToDate', 'activeReady', 'candidateReady', 'failed',
+        'immutableViolation', 'channelRollback',
+    ]);
+    if (typeof value.state !== 'string'
+        || !states.has(value.state)
+        || (value.remoteCommit !== undefined
+            && (typeof value.remoteCommit !== 'string'
+                || !RESOLVED_COMMIT_PATTERN.test(value.remoteCommit)))
+        || (value.errorCode !== undefined
+            && (typeof value.errorCode !== 'string' || value.errorCode.length === 0)))
+        throw stateError(`Invalid ${fieldName}.`);
+    return {
+        checkedAt: parseDate(value.checkedAt, `${fieldName}.checkedAt`),
+        state: value.state,
+        ...(value.remoteCommit ? { remoteCommit: value.remoteCommit } : {}),
+        ...(value.errorCode ? { errorCode: value.errorCode } : {}),
+    };
+}
+function parseSourceState(value, fieldName) {
+    if (!isRecord(value))
+        throw stateError(`Invalid ${fieldName}: expected an object.`);
+    assertAllowedKeys(value, fieldName, [
+        'logicalIdentity', 'refreshPolicy', 'active', 'candidate', 'lastCheck',
+    ]);
+    if (typeof value.logicalIdentity !== 'string'
+        || value.logicalIdentity.trim() === ''
+        || (value.refreshPolicy !== 'startup' && value.refreshPolicy !== 'manual'))
+        throw stateError(`Invalid ${fieldName} identity or refresh policy.`);
+    const active = value.active === undefined
+        ? undefined
+        : parsePointer(value.active, `${fieldName}.active`, false);
+    const candidate = value.candidate === undefined
+        ? undefined
+        : parsePointer(value.candidate, `${fieldName}.candidate`, true);
+    for (const [pointerName, pointer] of [['active', active], ['candidate', candidate]]) {
+        if (pointer && pointer.generationKey !== createCatalogGenerationKey(value.logicalIdentity, pointer.snapshotDigest))
+            throw stateError(`Invalid ${fieldName}.${pointerName} generation identity.`);
+    }
+    return {
+        logicalIdentity: value.logicalIdentity,
+        refreshPolicy: value.refreshPolicy,
+        ...(active ? { active } : {}),
+        ...(candidate ? { candidate } : {}),
+        ...(value.lastCheck === undefined
+            ? {}
+            : { lastCheck: parseLastCheck(value.lastCheck, `${fieldName}.lastCheck`) }),
+    };
+}
+export function validateCatalogGenerationState(value) {
+    if (!isRecord(value))
+        throw stateError('Invalid Catalog generation state: expected an object.');
+    assertAllowedKeys(value, 'Catalog generation state', ['schemaVersion', 'sources']);
+    if (value.schemaVersion !== CATALOG_GENERATIONS_SCHEMA_VERSION || !isRecord(value.sources)) {
+        throw stateError('Invalid Catalog generation state schema.');
+    }
+    const sources = {};
+    for (const sourceId of Object.keys(value.sources).sort()) {
+        if (!CATALOG_SOURCE_ID_PATTERN.test(sourceId)) {
+            throw stateError(`Invalid Catalog generation source ID "${sourceId}".`);
+        }
+        sources[sourceId] = parseSourceState(value.sources[sourceId], `Catalog generation state.sources.${sourceId}`);
+    }
+    return { schemaVersion: 1, sources };
+}
+export function createEmptyCatalogGenerationState() {
+    return { schemaVersion: 1, sources: {} };
+}
+export function resolveCatalogGenerationStatePath(env = process.env) {
+    return path.join(resolveAwHome(env), CATALOG_GENERATIONS_FILE);
+}
+async function readStateAt(filePath) {
+    const stat = await fs.lstat(filePath).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!stat)
+        return createEmptyCatalogGenerationState();
+    if (!stat.isFile() || stat.isSymbolicLink()) {
+        throw stateError('Catalog generation state path is not a regular file.');
+    }
+    try {
+        return validateCatalogGenerationState(await fs.readJson(filePath));
+    }
+    catch (error) {
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw stateError('Catalog generation state is unreadable.', error);
+    }
+}
+export async function readCatalogGenerationState(env = process.env) {
+    return readStateAt(resolveCatalogGenerationStatePath(env));
+}
+export async function withCatalogGenerationStateTransaction(options) {
+    const env = options.env ?? process.env;
+    const awHome = resolveAwHome(env);
+    const filePath = resolveCatalogGenerationStatePath(env);
+    const current = await readStateAt(filePath);
+    const output = await options.action(current);
+    const next = validateCatalogGenerationState(output.state);
+    if (JSON.stringify(next) !== JSON.stringify(current)) {
+        await options.beforeReplace?.(next);
+        await atomicReplaceConfigFile({
+            filePath,
+            allowedRoot: awHome,
+            content: `${JSON.stringify(next, null, 2)}\n`,
+        });
+    }
+    return output.result;
+}
+//# sourceMappingURL=catalog-generation-state.js.map

package/dist/src/utils/catalog-generation-state.js.map

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

package/dist/src/utils/catalog-generation-store.d.ts

@@ -0,0 +1,44 @@
+import type { CatalogGenerationMetadataV1, CatalogSourceResolution } from '../types.js';
+export interface CatalogGenerationLocation {
+    awHomeDir: string;
+    storeRootDir: string;
+    logicalIdentityDirectory: string;
+    generationDir: string;
+    metadataPath: string;
+    snapshotRoot: string;
+    generationKey: string;
+}
+export interface PreparedCatalogGeneration {
+    stagingDir: string;
+    location: CatalogGenerationLocation;
+    metadata: CatalogGenerationMetadataV1;
+}
+export interface PublishedCatalogGeneration {
+    generationDir: string;
+    snapshotRoot: string;
+    metadata: CatalogGenerationMetadataV1;
+}
+export declare function createCatalogGenerationKey(logicalIdentity: string, snapshotDigest: string): string;
+export declare function resolveCatalogGenerationLocation(options: {
+    logicalIdentity: string;
+    snapshotDigest: string;
+    env?: NodeJS.ProcessEnv;
+}): CatalogGenerationLocation;
+export declare function prepareCatalogGeneration(options: {
+    resolution: CatalogSourceResolution;
+    cliVersion: string;
+    env?: NodeJS.ProcessEnv;
+    now?: () => Date;
+    signal?: AbortSignal;
+}): Promise<PreparedCatalogGeneration>;
+export declare function publishPreparedCatalogGeneration(prepared: PreparedCatalogGeneration): Promise<PublishedCatalogGeneration>;
+export declare function discardPreparedCatalogGeneration(prepared: PreparedCatalogGeneration): Promise<void>;
+export declare function readCatalogGeneration(options: {
+    logicalIdentity: string;
+    snapshotDigest: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<PublishedCatalogGeneration>;
+export declare function listCatalogGenerationsForIdentity(options: {
+    logicalIdentity: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<PublishedCatalogGeneration[]>;

package/dist/src/utils/catalog-generation-store.js

@@ -0,0 +1,387 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CATALOG_GENERATION_METADATA_FILE, CATALOG_GENERATIONS_DIRECTORY, } from '../constants.js';
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { validateCatalogSnapshotTransport } from './catalog-snapshot.js';
+import { normalizeAwCapabilities, parseStrictSemVer } from './manifest.js';
+import { canonicalizePathThroughExistingAncestorSync, ensureRegularDirectoryPath, resolveAwHome, } from './state-paths.js';
+const SHA256_DIGEST_PATTERN = /^sha256:([0-9a-f]{64})$/u;
+const HEX_DIGEST_PATTERN = /^[0-9a-f]{64}$/u;
+function sha256Hex(value) {
+    return crypto.createHash('sha256').update(value).digest('hex');
+}
+function digestHex(value, fieldName) {
+    const match = SHA256_DIGEST_PATTERN.exec(value);
+    if (!match) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: `Invalid ${fieldName}: expected a SHA-256 digest. Remove the damaged generation and refresh the source.`,
+        });
+    }
+    return match[1];
+}
+export function createCatalogGenerationKey(logicalIdentity, snapshotDigest) {
+    if (typeof logicalIdentity !== 'string' || logicalIdentity.trim() === '') {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Invalid Catalog logical identity. Rebuild or republish the Catalog snapshot, then refresh the source.',
+        });
+    }
+    return `${sha256Hex(logicalIdentity)}/${digestHex(snapshotDigest, 'Catalog snapshot digest')}`;
+}
+export function resolveCatalogGenerationLocation(options) {
+    const awHomeDir = canonicalizePathThroughExistingAncestorSync(resolveAwHome(options.env ?? process.env));
+    const storeRootDir = path.join(awHomeDir, CATALOG_GENERATIONS_DIRECTORY);
+    const generationKey = createCatalogGenerationKey(options.logicalIdentity, options.snapshotDigest);
+    const [logicalIdentityHex, snapshotDigestHex] = generationKey.split('/');
+    const logicalIdentityDirectory = path.join(storeRootDir, logicalIdentityHex);
+    const generationDir = path.join(logicalIdentityDirectory, snapshotDigestHex);
+    return {
+        awHomeDir,
+        storeRootDir,
+        logicalIdentityDirectory,
+        generationDir,
+        metadataPath: path.join(generationDir, CATALOG_GENERATION_METADATA_FILE),
+        snapshotRoot: path.join(generationDir, 'snapshot'),
+        generationKey,
+    };
+}
+function isStrictObject(value, keys) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const actual = Object.keys(value).sort();
+    const expected = [...keys].sort();
+    return actual.length === expected.length
+        && actual.every((key, index) => key === expected[index]);
+}
+function parseGenerationMetadata(value) {
+    if (!isStrictObject(value, [
+        'schemaVersion',
+        'logicalIdentity',
+        'catalogVersion',
+        'channel',
+        'manifestDigest',
+        'snapshotDigest',
+        'generationKey',
+        'requiredAwCapabilities',
+        'publishedAt',
+    ])) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Invalid Catalog generation metadata. Remove the damaged generation and refresh the source.',
+        });
+    }
+    if (value.schemaVersion !== 1
+        || typeof value.logicalIdentity !== 'string'
+        || value.logicalIdentity.trim() === ''
+        || typeof value.catalogVersion !== 'string'
+        || !Array.isArray(value.requiredAwCapabilities)
+        || value.requiredAwCapabilities.some((capability) => typeof capability !== 'string')
+        || (value.channel !== 'latest' && value.channel !== 'beta')
+        || typeof value.manifestDigest !== 'string'
+        || !SHA256_DIGEST_PATTERN.test(value.manifestDigest)
+        || typeof value.snapshotDigest !== 'string'
+        || !SHA256_DIGEST_PATTERN.test(value.snapshotDigest)
+        || typeof value.generationKey !== 'string'
+        || !/^[0-9a-f]{64}\/[0-9a-f]{64}$/u.test(value.generationKey)
+        || typeof value.publishedAt !== 'string'
+        || Number.isNaN(Date.parse(value.publishedAt))) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Invalid Catalog generation metadata. Remove the damaged generation and refresh the source.',
+        });
+    }
+    try {
+        parseStrictSemVer(value.catalogVersion, 'Catalog generation catalogVersion');
+        if (JSON.stringify(normalizeAwCapabilities(value.requiredAwCapabilities))
+            !== JSON.stringify(value.requiredAwCapabilities)) {
+            throw new Error('Catalog generation required capabilities are not normalized.');
+        }
+    }
+    catch (error) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Invalid Catalog generation version metadata. Remove the damaged generation and refresh the source.',
+            cause: error,
+        });
+    }
+    if (value.generationKey !== createCatalogGenerationKey(value.logicalIdentity, value.snapshotDigest)) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog generation metadata does not match its content identity. Remove the damaged generation and refresh the source.',
+        });
+    }
+    return value;
+}
+async function readCatalogLogicalIdentity(snapshotRoot) {
+    const markerPath = path.join(snapshotRoot, '.aw-generated.json');
+    const stat = await fs.lstat(markerPath).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!stat?.isFile() || stat.isSymbolicLink()) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog snapshot has no valid generated marker. Rebuild or republish the Catalog, then refresh the source.',
+        });
+    }
+    const marker = await fs.readJson(markerPath);
+    if (!isStrictObject(marker, ['schemaVersion', 'kind', 'workspaceIdentity', 'sourceIdentity'])
+        || marker.schemaVersion !== 1
+        || marker.kind !== 'catalog'
+        || typeof marker.workspaceIdentity !== 'string'
+        || marker.workspaceIdentity.trim() === ''
+        || typeof marker.sourceIdentity !== 'string'
+        || !SHA256_DIGEST_PATTERN.test(marker.sourceIdentity)) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog snapshot generated marker is invalid. Rebuild or republish the Catalog, then refresh the source.',
+        });
+    }
+    return marker.workspaceIdentity;
+}
+async function assertRegularGenerationDirectory(directory) {
+    const stat = await fs.lstat(directory).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!stat?.isDirectory() || stat.isSymbolicLink()) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog generation directory is missing or unsafe. Refresh the source after repairing the generation store.',
+        });
+    }
+}
+async function validateGenerationDirectory(options) {
+    const metadata = await readGenerationMetadataAt(options);
+    const snapshotRoot = path.join(options.generationDir, 'snapshot');
+    let validation;
+    try {
+        validation = await validateCatalogSnapshotTransport(snapshotRoot);
+    }
+    catch (error) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog generation snapshot is damaged. Remove the damaged generation and refresh the source.',
+            cause: error,
+        });
+    }
+    if (validation.manifest.catalogVersion !== metadata.catalogVersion
+        || validation.manifest.channel !== metadata.channel
+        || JSON.stringify(validation.manifest.requires.aw.capabilities ?? [])
+            !== JSON.stringify(metadata.requiredAwCapabilities)
+        || validation.manifestDigest !== metadata.manifestDigest
+        || validation.snapshotDigest !== metadata.snapshotDigest
+        || await readCatalogLogicalIdentity(snapshotRoot) !== metadata.logicalIdentity) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationIdentityMismatch',
+            message: 'Catalog generation snapshot does not match its immutable metadata. Remove the damaged generation and refresh the source.',
+        });
+    }
+    return { generationDir: options.generationDir, snapshotRoot, metadata };
+}
+async function readGenerationMetadataAt(options) {
+    await assertRegularGenerationDirectory(options.generationDir);
+    const metadataPath = path.join(options.generationDir, CATALOG_GENERATION_METADATA_FILE);
+    const metadataStat = await fs.lstat(metadataPath).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!metadataStat?.isFile() || metadataStat.isSymbolicLink()) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog generation metadata file is missing or unsafe. Remove the damaged generation and refresh the source.',
+        });
+    }
+    let metadata;
+    try {
+        metadata = parseGenerationMetadata(await fs.readJson(metadataPath));
+    }
+    catch (error) {
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog generation metadata is unreadable. Remove the damaged generation and refresh the source.',
+            cause: error,
+        });
+    }
+    if (metadata.logicalIdentity !== options.logicalIdentity
+        || metadata.snapshotDigest !== options.snapshotDigest) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationIdentityMismatch',
+            message: 'Catalog generation directory identity does not match its metadata. Remove the damaged generation and refresh the source.',
+        });
+    }
+    return metadata;
+}
+export async function prepareCatalogGeneration(options) {
+    options.signal?.throwIfAborted();
+    const awHomeDir = canonicalizePathThroughExistingAncestorSync(resolveAwHome(options.env ?? process.env));
+    const storeRootDir = path.join(awHomeDir, CATALOG_GENERATIONS_DIRECTORY);
+    await ensureRegularDirectoryPath(storeRootDir, 'Catalog generation store');
+    const stagingDir = path.join(storeRootDir, `.staging-${crypto.randomUUID()}.tmp`);
+    try {
+        await fs.mkdir(stagingDir);
+        const snapshotRoot = path.join(stagingDir, 'snapshot');
+        await fs.copy(options.resolution.rootDir, snapshotRoot, {
+            dereference: false,
+            preserveTimestamps: true,
+            filter: () => {
+                options.signal?.throwIfAborted();
+                return true;
+            },
+        });
+        options.signal?.throwIfAborted();
+        const validation = await validateCatalogSnapshotTransport(snapshotRoot);
+        options.signal?.throwIfAborted();
+        if (validation.manifestDigest !== options.resolution.manifestDigest
+            || validation.snapshotDigest !== options.resolution.snapshotDigest
+            || validation.manifest.catalogVersion !== options.resolution.manifest.catalogVersion
+            || validation.manifest.channel !== options.resolution.manifest.channel) {
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationPublishFailed',
+                sourceId: options.resolution.sourceId,
+                message: `Catalog source "${options.resolution.sourceId}" changed before generation publication. Refresh the source again.`,
+            });
+        }
+        const logicalIdentity = await readCatalogLogicalIdentity(snapshotRoot);
+        const location = resolveCatalogGenerationLocation({
+            logicalIdentity,
+            snapshotDigest: validation.snapshotDigest,
+            env: options.env,
+        });
+        const metadata = {
+            schemaVersion: 1,
+            logicalIdentity,
+            catalogVersion: validation.manifest.catalogVersion,
+            channel: validation.manifest.channel,
+            manifestDigest: validation.manifestDigest,
+            snapshotDigest: validation.snapshotDigest,
+            generationKey: location.generationKey,
+            requiredAwCapabilities: normalizeAwCapabilities(validation.manifest.requires.aw.capabilities ?? []),
+            publishedAt: (options.now?.() ?? new Date()).toISOString(),
+        };
+        await fs.writeFile(path.join(stagingDir, CATALOG_GENERATION_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
+        options.signal?.throwIfAborted();
+        await validateGenerationDirectory({
+            generationDir: stagingDir,
+            logicalIdentity,
+            snapshotDigest: validation.snapshotDigest,
+        });
+        options.signal?.throwIfAborted();
+        return { stagingDir, location, metadata };
+    }
+    catch (error) {
+        await fs.remove(stagingDir).catch(() => undefined);
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationPublishFailed',
+            sourceId: options.resolution.sourceId,
+            message: `Cannot prepare Catalog generation for source "${options.resolution.sourceId}". Refresh the source again after repairing the snapshot.`,
+            cause: error,
+        });
+    }
+}
+export async function publishPreparedCatalogGeneration(prepared) {
+    await ensureRegularDirectoryPath(prepared.location.logicalIdentityDirectory, 'Catalog logical identity directory');
+    const existing = await fs.lstat(prepared.location.generationDir).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (existing) {
+        const published = await validateGenerationDirectory({
+            generationDir: prepared.location.generationDir,
+            logicalIdentity: prepared.metadata.logicalIdentity,
+            snapshotDigest: prepared.metadata.snapshotDigest,
+        });
+        await fs.remove(prepared.stagingDir).catch(() => undefined);
+        return published;
+    }
+    try {
+        await fs.rename(prepared.stagingDir, prepared.location.generationDir);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'EEXIST' || code === 'ENOTEMPTY') {
+            const published = await validateGenerationDirectory({
+                generationDir: prepared.location.generationDir,
+                logicalIdentity: prepared.metadata.logicalIdentity,
+                snapshotDigest: prepared.metadata.snapshotDigest,
+            });
+            await fs.remove(prepared.stagingDir).catch(() => undefined);
+            return published;
+        }
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationPublishFailed',
+            message: 'Cannot atomically publish the prepared Catalog generation. The previous Active generation is unchanged; refresh the source again.',
+            cause: error,
+        });
+    }
+    return {
+        generationDir: prepared.location.generationDir,
+        snapshotRoot: prepared.location.snapshotRoot,
+        metadata: prepared.metadata,
+    };
+}
+export async function discardPreparedCatalogGeneration(prepared) {
+    await fs.remove(prepared.stagingDir).catch(() => undefined);
+}
+export async function readCatalogGeneration(options) {
+    const location = resolveCatalogGenerationLocation(options);
+    return validateGenerationDirectory({
+        generationDir: location.generationDir,
+        logicalIdentity: options.logicalIdentity,
+        snapshotDigest: options.snapshotDigest,
+    });
+}
+export async function listCatalogGenerationsForIdentity(options) {
+    const placeholderDigest = `sha256:${'0'.repeat(64)}`;
+    const location = resolveCatalogGenerationLocation({
+        logicalIdentity: options.logicalIdentity,
+        snapshotDigest: placeholderDigest,
+        env: options.env,
+    });
+    const directoryStat = await fs.lstat(location.logicalIdentityDirectory).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!directoryStat)
+        return [];
+    if (!directoryStat.isDirectory() || directoryStat.isSymbolicLink()) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationMetadataInvalid',
+            message: 'Catalog logical identity store is unsafe. Repair it before refreshing the source.',
+        });
+    }
+    const names = (await fs.readdir(location.logicalIdentityDirectory)).sort();
+    const generations = [];
+    for (const name of names) {
+        if (!HEX_DIGEST_PATTERN.test(name)) {
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationMetadataInvalid',
+                message: 'Catalog logical identity store contains an invalid entry. Remove the damaged entry before refreshing the source.',
+            });
+        }
+        const generationDir = path.join(location.logicalIdentityDirectory, name);
+        const metadata = await readGenerationMetadataAt({
+            generationDir,
+            logicalIdentity: options.logicalIdentity,
+            snapshotDigest: `sha256:${name}`,
+        });
+        generations.push({
+            generationDir,
+            snapshotRoot: path.join(generationDir, 'snapshot'),
+            metadata,
+        });
+    }
+    return generations;
+}
+//# sourceMappingURL=catalog-generation-store.js.map