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

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

@@ -0,0 +1,306 @@
+import { CatalogGenerationError, catalogGenerationErrorCode } from './catalog-generation-error.js';
+import { readCatalogGenerationControlSnapshot } from './catalog-generation-control-snapshot.js';
+import { createCatalogStoreKey, publishCatalogStoreEntry, readCatalogSnapshotLogicalIdentity, readCatalogStoreEntry, } from './catalog-generation-store.js';
+import { readCatalogGenerationState, withCatalogGenerationStateTransaction, } from './catalog-generation-state.js';
+export { removeCatalogSourceGenerationState } from './catalog-generation-state.js';
+import { calculateCatalogSourceConfigFingerprint, calculateCatalogSourceIdentity, } from './catalog-source-identity.js';
+import { readCatalogSourcesConfigSnapshot } from './catalog-sources.js';
+import { catalogGitProviderInternal } from './git-catalog-provider.js';
+import { catalogPathProviderInternal } from './path-catalog-provider.js';
+function now(runtime) {
+    return (runtime?.now?.() ?? new Date()).toISOString();
+}
+async function resolveProvider(options) {
+    const providers = options.runtime?.providers ?? {
+        git: catalogGitProviderInternal.resolve,
+        path: catalogPathProviderInternal.resolve,
+    };
+    return providers[options.source.type](options.source, {
+        cliVersion: options.cliVersion,
+        env: options.env,
+        signal: options.signal,
+    });
+}
+function evidence(resolution, logicalIdentity) {
+    return {
+        sourceIdentity: resolution.sourceIdentity,
+        logicalIdentity,
+        catalogVersion: resolution.manifest.catalogVersion,
+        channel: resolution.manifest.channel,
+        requestedRef: resolution.requestedRef,
+        resolvedCommit: resolution.resolvedCommit,
+        manifestDigest: resolution.manifestDigest,
+        snapshotDigest: resolution.snapshotDigest,
+    };
+}
+function sameActive(active, next) {
+    return Boolean(active)
+        && active.sourceConfigFingerprint === next.sourceConfigFingerprint
+        && active.sourceIdentity === next.sourceIdentity
+        && active.requestedRef === next.requestedRef
+        && active.resolvedCommit === next.resolvedCommit
+        && active.logicalIdentity === next.logicalIdentity
+        && active.manifestDigest === next.manifestDigest
+        && active.snapshotDigest === next.snapshotDigest;
+}
+async function assertCurrentSource(options) {
+    const current = await readCatalogSourcesConfigSnapshot(options.env);
+    const source = current.config.sources.find((entry) => entry.id === options.sourceId);
+    if (!source)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationSourceMissing',
+            sourceId: options.sourceId,
+            message: `Catalog source "${options.sourceId}" was removed during sync.`,
+        });
+    if (calculateCatalogSourceConfigFingerprint(source) !== options.fingerprint) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationIdentityMismatch',
+            sourceId: options.sourceId,
+            message: `Catalog source "${options.sourceId}" changed during sync. Run sync again.`,
+        });
+    }
+}
+async function recordFailure(options) {
+    try {
+        await assertCurrentSource(options);
+        const lastSync = {
+            syncedAt: now(options.runtime),
+            mode: options.mode,
+            state: 'failed',
+            errorCode: options.errorCode,
+        };
+        await withCatalogGenerationStateTransaction({
+            env: options.env,
+            beforeReplace: () => assertCurrentSource(options),
+            action: async (current) => ({
+                state: {
+                    schemaVersion: 1,
+                    sources: {
+                        ...current.sources,
+                        [options.sourceId]: {
+                            ...current.sources[options.sourceId],
+                            lastSync,
+                        },
+                    },
+                },
+                result: undefined,
+            }),
+        });
+    }
+    catch {
+        // A concurrent source update or removal must not be undone by failure diagnostics.
+    }
+}
+function warnCleanupFailure(sourceId) {
+    try {
+        process.emitWarning(`Catalog provider staging cleanup failed for source "${sourceId}".`, { code: 'AW_CATALOG_PROVIDER_CLEANUP_FAILED' });
+    }
+    catch {
+        // Cleanup diagnostics cannot replace the sync result.
+    }
+}
+export async function syncCatalogSourceGeneration(options) {
+    const env = options.env ?? process.env;
+    const mode = options.check ? 'check' : 'sync';
+    const control = await readCatalogGenerationControlSnapshot({ env });
+    const source = control.configSnapshot.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.`,
+        });
+    const fingerprint = calculateCatalogSourceConfigFingerprint(source);
+    let resolution;
+    try {
+        resolution = await resolveProvider({
+            source,
+            cliVersion: options.cliVersion,
+            env,
+            signal: options.signal,
+            runtime: options.runtime,
+        });
+        const expectedIdentity = await calculateCatalogSourceIdentity(source);
+        if (resolution.sourceId !== source.id || resolution.sourceIdentity !== expectedIdentity) {
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationIdentityMismatch',
+                sourceId: source.id,
+                message: `Catalog provider returned mismatched identity for source "${source.id}".`,
+            });
+        }
+        const logicalIdentity = await readCatalogSnapshotLogicalIdentity(resolution.rootDir);
+        const syncEvidence = evidence(resolution, logicalIdentity);
+        if (options.check) {
+            await assertCurrentSource({ sourceId: source.id, fingerprint, env });
+            const lastSync = {
+                syncedAt: now(options.runtime),
+                mode,
+                state: 'succeeded',
+                resolvedCommit: resolution.resolvedCommit,
+            };
+            await withCatalogGenerationStateTransaction({
+                env,
+                beforeReplace: () => assertCurrentSource({ sourceId: source.id, fingerprint, env }),
+                action: async (current) => ({
+                    state: {
+                        schemaVersion: 1,
+                        sources: {
+                            ...current.sources,
+                            [source.id]: { ...current.sources[source.id], lastSync },
+                        },
+                    },
+                    result: undefined,
+                }),
+            });
+            return {
+                catalogGenerationSchemaVersion: 1,
+                sourceId: source.id,
+                mode,
+                outcome: 'checked',
+                activeChanged: false,
+                resolution: syncEvidence,
+                ...(control.generationState.sources[source.id]?.active
+                    ? { active: control.generationState.sources[source.id].active }
+                    : {}),
+                lastSync,
+            };
+        }
+        const store = await publishCatalogStoreEntry({ resolution, env, signal: options.signal });
+        const activeInput = {
+            sourceConfigFingerprint: fingerprint,
+            sourceIdentity: resolution.sourceIdentity,
+            requestedRef: resolution.requestedRef,
+            resolvedCommit: resolution.resolvedCommit,
+            logicalIdentity: store.metadata.logicalIdentity,
+            manifestDigest: store.metadata.manifestDigest,
+            snapshotDigest: store.metadata.snapshotDigest,
+        };
+        await assertCurrentSource({ sourceId: source.id, fingerprint, env });
+        const syncedAt = now(options.runtime);
+        return await withCatalogGenerationStateTransaction({
+            env,
+            beforeReplace: () => assertCurrentSource({ sourceId: source.id, fingerprint, env }),
+            action: async (current) => {
+                const previous = current.sources[source.id]?.active;
+                const unchanged = sameActive(previous, activeInput);
+                const active = unchanged
+                    ? previous
+                    : { ...activeInput, activatedAt: syncedAt };
+                const lastSync = {
+                    syncedAt,
+                    mode,
+                    state: 'succeeded',
+                    resolvedCommit: resolution.resolvedCommit,
+                };
+                return {
+                    state: {
+                        schemaVersion: 1,
+                        sources: { ...current.sources, [source.id]: { active, lastSync } },
+                    },
+                    result: {
+                        catalogGenerationSchemaVersion: 1,
+                        sourceId: source.id,
+                        mode,
+                        outcome: unchanged ? 'unchanged' : 'activated',
+                        activeChanged: !unchanged,
+                        resolution: syncEvidence,
+                        active,
+                        lastSync,
+                    },
+                };
+            },
+        });
+    }
+    catch (error) {
+        const code = error instanceof CatalogGenerationError
+            ? error.code
+            : 'catalogGenerationRefreshFailed';
+        await recordFailure({
+            sourceId: source.id,
+            fingerprint,
+            mode,
+            errorCode: code,
+            env,
+            runtime: options.runtime,
+        });
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationRefreshFailed',
+            sourceId: source.id,
+            message: `Cannot sync Catalog source "${source.id}". The previous Active snapshot is unchanged.`,
+            cause: error,
+        });
+    }
+    finally {
+        if (resolution)
+            await resolution.cleanup().catch(() => warnCleanupFailure(source.id));
+    }
+}
+export async function readCatalogGenerationStatus(options = {}) {
+    const env = options.env ?? process.env;
+    const config = await readCatalogSourcesConfigSnapshot(env);
+    const state = await readCatalogGenerationState(env);
+    const selected = options.sourceId
+        ? config.config.sources.filter((source) => source.id === options.sourceId)
+        : config.config.sources;
+    if (options.sourceId && selected.length === 0)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationSourceMissing',
+            sourceId: options.sourceId,
+            message: `Catalog source "${options.sourceId}" is not configured.`,
+        });
+    const sources = await Promise.all(selected.map(async (source) => {
+        const configuredSourceIdentity = await calculateCatalogSourceIdentity(source);
+        const sourceState = state.sources[source.id];
+        const active = sourceState?.active;
+        const configMatchesActive = Boolean(active)
+            && active.sourceIdentity === configuredSourceIdentity
+            && active.sourceConfigFingerprint === calculateCatalogSourceConfigFingerprint(source);
+        if (!active)
+            return {
+                sourceId: source.id,
+                configuredSourceIdentity,
+                activeReady: false,
+                configMatchesActive: false,
+                lastSync: sourceState?.lastSync,
+            };
+        try {
+            const entry = await readCatalogStoreEntry({
+                logicalIdentity: active.logicalIdentity,
+                snapshotDigest: active.snapshotDigest,
+                env,
+            });
+            if (entry.metadata.manifestDigest !== active.manifestDigest) {
+                throw new CatalogGenerationError({
+                    code: 'catalogGenerationIdentityMismatch',
+                    message: 'Active does not match store metadata.',
+                });
+            }
+            return {
+                sourceId: source.id,
+                configuredSourceIdentity,
+                active,
+                activeReady: configMatchesActive,
+                configMatchesActive,
+                catalogVersion: entry.metadata.catalogVersion,
+                channel: entry.metadata.channel,
+                storeKey: createCatalogStoreKey(active.logicalIdentity, active.snapshotDigest),
+                lastSync: sourceState?.lastSync,
+            };
+        }
+        catch (error) {
+            return {
+                sourceId: source.id,
+                configuredSourceIdentity,
+                active,
+                activeReady: false,
+                configMatchesActive,
+                lastSync: sourceState?.lastSync,
+                errorCode: catalogGenerationErrorCode(error),
+            };
+        }
+    }));
+    return { catalogGenerationStatusSchemaVersion: 1, sources };
+}
+//# sourceMappingURL=catalog-generation-service.js.map

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

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

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

@@ -0,0 +1,17 @@
+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>;
+export declare function removeCatalogSourceGenerationState(options: {
+    sourceId: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<boolean>;

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

@@ -0,0 +1,168 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CATALOG_STATE_FILE, CATALOG_STATE_SCHEMA_VERSION } from '../constants.js';
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { CATALOG_SOURCE_ID_PATTERN } from './catalog-sources.js';
+import { atomicReplaceConfigFile } from './plugin-config.js';
+import { resolveAwHome } from './state-paths.js';
+const DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/u;
+const 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-state.json, then run aw catalog source sync. This state never authorizes plugin deletion.`,
+        cause,
+    });
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function assertKeys(value, name, allowed) {
+    const unexpected = Object.keys(value).find((key) => !allowed.includes(key));
+    if (unexpected)
+        throw stateError(`Invalid ${name}: unknown field "${unexpected}".`);
+}
+function parseDate(value, name) {
+    if (typeof value !== 'string' || Number.isNaN(Date.parse(value))) {
+        throw stateError(`Invalid ${name}: expected an ISO date.`);
+    }
+    return value;
+}
+function parseActive(value, name) {
+    if (!isRecord(value))
+        throw stateError(`Invalid ${name}: expected an object.`);
+    assertKeys(value, name, [
+        'sourceConfigFingerprint', 'sourceIdentity', 'requestedRef', 'resolvedCommit',
+        'logicalIdentity', 'manifestDigest', 'snapshotDigest', 'activatedAt',
+    ]);
+    if (typeof value.sourceConfigFingerprint !== 'string'
+        || !DIGEST_PATTERN.test(value.sourceConfigFingerprint)
+        || typeof value.sourceIdentity !== 'string'
+        || !DIGEST_PATTERN.test(value.sourceIdentity)
+        || typeof value.requestedRef !== 'string'
+        || value.requestedRef.length === 0
+        || typeof value.resolvedCommit !== 'string'
+        || !COMMIT_PATTERN.test(value.resolvedCommit)
+        || typeof value.logicalIdentity !== 'string'
+        || value.logicalIdentity.trim() === ''
+        || value.logicalIdentity !== value.logicalIdentity.trim()
+        || typeof value.manifestDigest !== 'string'
+        || !DIGEST_PATTERN.test(value.manifestDigest)
+        || typeof value.snapshotDigest !== 'string'
+        || !DIGEST_PATTERN.test(value.snapshotDigest))
+        throw stateError(`Invalid ${name}.`);
+    return {
+        sourceConfigFingerprint: value.sourceConfigFingerprint,
+        sourceIdentity: value.sourceIdentity,
+        requestedRef: value.requestedRef,
+        resolvedCommit: value.resolvedCommit,
+        logicalIdentity: value.logicalIdentity,
+        manifestDigest: value.manifestDigest,
+        snapshotDigest: value.snapshotDigest,
+        activatedAt: parseDate(value.activatedAt, `${name}.activatedAt`),
+    };
+}
+function parseLastSync(value, name) {
+    if (!isRecord(value))
+        throw stateError(`Invalid ${name}: expected an object.`);
+    assertKeys(value, name, ['syncedAt', 'mode', 'state', 'resolvedCommit', 'errorCode']);
+    if ((value.mode !== 'check' && value.mode !== 'sync')
+        || (value.state !== 'succeeded' && value.state !== 'failed')
+        || (value.resolvedCommit !== undefined
+            && (typeof value.resolvedCommit !== 'string' || !COMMIT_PATTERN.test(value.resolvedCommit)))
+        || (value.errorCode !== undefined
+            && (typeof value.errorCode !== 'string' || value.errorCode.length === 0))
+        || (value.state === 'succeeded' && value.errorCode !== undefined)
+        || (value.state === 'failed' && value.errorCode === undefined))
+        throw stateError(`Invalid ${name}.`);
+    return {
+        syncedAt: parseDate(value.syncedAt, `${name}.syncedAt`),
+        mode: value.mode,
+        state: value.state,
+        ...(value.resolvedCommit === undefined ? {} : { resolvedCommit: value.resolvedCommit }),
+        ...(value.errorCode === undefined ? {} : { errorCode: value.errorCode }),
+    };
+}
+function parseSourceState(value, name) {
+    if (!isRecord(value))
+        throw stateError(`Invalid ${name}: expected an object.`);
+    assertKeys(value, name, ['active', 'lastSync']);
+    const active = value.active === undefined ? undefined : parseActive(value.active, `${name}.active`);
+    const lastSync = value.lastSync === undefined
+        ? undefined
+        : parseLastSync(value.lastSync, `${name}.lastSync`);
+    return { ...(active ? { active } : {}), ...(lastSync ? { lastSync } : {}) };
+}
+export function validateCatalogGenerationState(value) {
+    if (!isRecord(value))
+        throw stateError('Invalid Catalog state: expected an object.');
+    assertKeys(value, 'Catalog state', ['schemaVersion', 'sources']);
+    if (value.schemaVersion !== CATALOG_STATE_SCHEMA_VERSION || !isRecord(value.sources)) {
+        throw stateError('Invalid Catalog state schema.');
+    }
+    const sources = {};
+    for (const sourceId of Object.keys(value.sources).sort()) {
+        if (!CATALOG_SOURCE_ID_PATTERN.test(sourceId)) {
+            throw stateError(`Invalid Catalog state source ID "${sourceId}".`);
+        }
+        sources[sourceId] = parseSourceState(value.sources[sourceId], `Catalog 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_STATE_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 state path is unsafe.');
+    try {
+        return validateCatalogGenerationState(await fs.readJson(filePath));
+    }
+    catch (error) {
+        if (error instanceof CatalogGenerationError)
+            throw error;
+        throw stateError('Catalog 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 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: resolveAwHome(env),
+            content: `${JSON.stringify(next, null, 2)}\n`,
+        });
+    }
+    return output.result;
+}
+export async function removeCatalogSourceGenerationState(options) {
+    return withCatalogGenerationStateTransaction({
+        env: options.env,
+        action: async (current) => {
+            if (!current.sources[options.sourceId])
+                return { state: current, result: false };
+            const sources = { ...current.sources };
+            delete sources[options.sourceId];
+            return { state: { schemaVersion: 1, sources }, result: true };
+        },
+    });
+}
+//# 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,34 @@
+import type { CatalogGenerationMetadataV1, CatalogManifestV6, CatalogSourceResolution } from '../types.js';
+export interface CatalogStoreLocation {
+    awHomeDir: string;
+    storeRootDir: string;
+    logicalIdentityDirectory: string;
+    entryDir: string;
+    metadataPath: string;
+    snapshotRoot: string;
+    storeKey: string;
+}
+export interface CatalogStoreEntry {
+    entryDir: string;
+    snapshotRoot: string;
+    metadata: CatalogGenerationMetadataV1;
+    manifest: CatalogManifestV6;
+    reused: boolean;
+}
+export declare function createCatalogStoreKey(logicalIdentity: string, snapshotDigest: string): string;
+export declare function resolveCatalogStoreLocation(options: {
+    logicalIdentity: string;
+    snapshotDigest: string;
+    env?: NodeJS.ProcessEnv;
+}): CatalogStoreLocation;
+export declare function readCatalogSnapshotLogicalIdentity(snapshotRoot: string): Promise<string>;
+export declare function publishCatalogStoreEntry(options: {
+    resolution: CatalogSourceResolution;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+}): Promise<CatalogStoreEntry>;
+export declare function readCatalogStoreEntry(options: {
+    logicalIdentity: string;
+    snapshotDigest: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<CatalogStoreEntry>;