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

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

@@ -0,0 +1,129 @@
+import crypto from 'node:crypto';
+import { IMPLEMENTED_AW_CAPABILITIES } from '../commands/aw-capabilities.js';
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { CatalogProviderCompatibilityError } from './catalog-public-error.js';
+import { readCatalogGenerationState } from './catalog-generation-state.js';
+import { readCatalogGeneration } from './catalog-generation-store.js';
+import { calculateCatalogSourceConfigFingerprint } from './catalog-source-identity.js';
+import { readCatalogSourcesConfigSnapshot } from './catalog-sources.js';
+import { checkAwCapabilitySupport } from './manifest.js';
+async function resolveFromState(options) {
+    const selected = options.state.sources[options.source.id];
+    if (!selected?.active) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationUnavailable',
+            sourceId: options.source.id,
+            message: `Catalog source "${options.source.id}" has no Active generation. Run aw catalog source refresh ${options.source.id}.`,
+        });
+    }
+    if (selected.active.sourceConfigFingerprint
+        !== calculateCatalogSourceConfigFingerprint(options.source)) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationIdentityMismatch',
+            sourceId: options.source.id,
+            message: `Active Catalog generation for source "${options.source.id}" does not match the current source configuration. Run aw catalog source refresh ${options.source.id}, activate the Candidate with aw catalog source activate-candidate ${options.source.id}, then reload and retry.`,
+        });
+    }
+    const generation = await readCatalogGeneration({
+        logicalIdentity: selected.logicalIdentity,
+        snapshotDigest: selected.active.snapshotDigest,
+        env: options.env,
+    });
+    const requiredCapabilities = generation.metadata.requiredAwCapabilities;
+    const support = checkAwCapabilitySupport(requiredCapabilities, IMPLEMENTED_AW_CAPABILITIES);
+    if (!support.supported) {
+        throw new CatalogProviderCompatibilityError({
+            sourceId: options.source.id,
+            requiredCapabilities,
+            missingCapabilities: support.missing,
+            availableCapabilities: IMPLEMENTED_AW_CAPABILITIES,
+        });
+    }
+    if (generation.metadata.logicalIdentity !== selected.logicalIdentity
+        || generation.metadata.catalogVersion !== selected.active.catalogVersion
+        || generation.metadata.channel !== selected.active.channel
+        || generation.metadata.manifestDigest !== selected.active.manifestDigest
+        || generation.metadata.snapshotDigest !== selected.active.snapshotDigest
+        || generation.metadata.generationKey !== selected.active.generationKey) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationIdentityMismatch',
+            sourceId: options.source.id,
+            message: `Active Catalog generation for source "${options.source.id}" does not match its immutable metadata. Refresh the source after repairing catalog-generations.json.`,
+        });
+    }
+    return {
+        sourceId: options.source.id,
+        sourceConfigFingerprint: selected.active.sourceConfigFingerprint,
+        logicalIdentity: selected.logicalIdentity,
+        catalogVersion: selected.active.catalogVersion,
+        resolvedCommit: selected.active.resolvedCommit,
+        manifestDigest: selected.active.manifestDigest,
+        snapshotDigest: selected.active.snapshotDigest,
+        generationKey: selected.active.generationKey,
+        snapshotPath: generation.snapshotRoot,
+        pointer: selected.active,
+    };
+}
+export async function resolveActiveCatalogGeneration(options) {
+    const env = options.env ?? process.env;
+    const [config, state] = await Promise.all([
+        readCatalogSourcesConfigSnapshot(env),
+        readCatalogGenerationState(env),
+    ]);
+    const source = config.config.sources.find((entry) => entry.id === options.sourceId);
+    if (!source) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationSourceMissing',
+            sourceId: options.sourceId,
+            message: `Catalog source "${options.sourceId}" is not configured.`,
+        });
+    }
+    return resolveFromState({ source, state, env });
+}
+export function calculateCatalogGenerationSetDigest(primarySourceId, sources) {
+    const input = {
+        primarySourceId,
+        sources: sources.map((source) => ({
+            sourceId: source.sourceId,
+            sourceConfigFingerprint: source.sourceConfigFingerprint,
+            logicalIdentity: source.logicalIdentity,
+            catalogVersion: source.catalogVersion,
+            resolvedCommit: source.resolvedCommit,
+            manifestDigest: source.manifestDigest,
+            snapshotDigest: source.snapshotDigest,
+            generationKey: source.generationKey,
+        })),
+    };
+    return `sha256:${crypto.createHash('sha256').update(JSON.stringify(input)).digest('hex')}`;
+}
+export async function resolveCatalogGenerationSet(options = {}) {
+    const env = options.env ?? process.env;
+    const [config, state] = await Promise.all([
+        readCatalogSourcesConfigSnapshot(env),
+        readCatalogGenerationState(env),
+    ]);
+    const requested = options.sourceIds ? new Set(options.sourceIds) : null;
+    if (requested) {
+        const configured = new Set(config.config.sources.map((source) => source.id));
+        const missing = [...requested].find((sourceId) => !configured.has(sourceId));
+        if (missing) {
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationSourceMissing',
+                sourceId: missing,
+                message: `Catalog source "${missing}" is not configured.`,
+            });
+        }
+    }
+    const configuredSources = config.config.sources
+        .filter((source) => !requested || requested.has(source.id))
+        .sort((left, right) => left.id < right.id ? -1 : left.id > right.id ? 1 : 0);
+    const resolved = await Promise.all(configuredSources.map((source) => resolveFromState({ source, state, env })));
+    const sources = resolved.map(({ pointer: _pointer, ...source }) => source);
+    const primarySourceId = config.config.sources.find((source) => source.primary).id;
+    return {
+        generationSetDigest: calculateCatalogGenerationSetDigest(primarySourceId, sources),
+        primarySourceId,
+        sources,
+    };
+}
+//# sourceMappingURL=catalog-generation-resolver.js.map

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

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

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

@@ -0,0 +1,52 @@
+import type { CatalogGenerationActivationResult, CatalogGenerationCandidateV1, CatalogGenerationLastCheckV1, CatalogGenerationPointerV1, CatalogGenerationRefreshResult, CatalogSource } from '../types.js';
+import { type AwHomeMutationToken } from './aw-home-mutation-lock.js';
+import type { CatalogSourceProviderSet } from './multi-source-catalog.js';
+export interface CatalogGenerationServiceRuntime {
+    providers?: CatalogSourceProviderSet;
+    now?: () => Date;
+    onProgress?: (event: {
+        sourceId: string;
+        state: 'checking' | 'validating';
+    }) => void | Promise<void>;
+}
+export interface CatalogGenerationStatusEntry {
+    sourceId: string;
+    sourceType: CatalogSource['type'];
+    logicalIdentity?: string;
+    refreshPolicy: 'startup' | 'manual';
+    active?: CatalogGenerationPointerV1;
+    candidate?: CatalogGenerationCandidateV1;
+    lastCheck?: CatalogGenerationLastCheckV1;
+}
+export interface CatalogGenerationStatusPayload {
+    catalogGenerationStatusSchemaVersion: 1;
+    sources: CatalogGenerationStatusEntry[];
+}
+export declare function refreshCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+    awHomeMutationToken?: AwHomeMutationToken;
+}): Promise<CatalogGenerationRefreshResult>;
+export declare function activateCatalogSourceCandidate(options: {
+    sourceId: string;
+    expectedCandidateGenerationKey?: string;
+    env?: NodeJS.ProcessEnv;
+    awHomeMutationToken?: AwHomeMutationToken;
+    runtime?: Pick<CatalogGenerationServiceRuntime, 'now'>;
+}): Promise<CatalogGenerationActivationResult>;
+export declare function setCatalogSourceRefreshPolicy(options: {
+    sourceId: string;
+    refreshPolicy: 'startup' | 'manual';
+    env?: NodeJS.ProcessEnv;
+}): Promise<CatalogGenerationStatusEntry>;
+export declare function removeCatalogSourceGenerationState(options: {
+    sourceId: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<boolean>;
+export declare function readCatalogGenerationStatus(options?: {
+    sourceId?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<CatalogGenerationStatusPayload>;