@lesliechan721/aw 0.1.0-beta.10

package/dist/src/utils/catalog-operation-context.js

@@ -0,0 +1,141 @@
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { calculateCatalogGenerationSetDigest, resolveCatalogGenerationSet, } from './catalog-generation-resolver.js';
+import { readCatalogGenerationControlSnapshot, } from './catalog-generation-control-snapshot.js';
+export function selectCatalogOperationContext(context, sourceIds) {
+    const requested = new Set(sourceIds);
+    const missing = sourceIds.find((sourceId) => !context.generationSet.sources.some((source) => source.sourceId === sourceId));
+    if (missing)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationUnavailable',
+            sourceId: missing,
+            message: `Catalog source "${missing}" was unavailable when this operation context was bound. Run aw catalog source sync ${missing}, then retry.`,
+        });
+    const sources = context.generationSet.sources.filter((source) => requested.has(source.sourceId));
+    const generationSetDigest = calculateCatalogGenerationSetDigest(context.generationSet.configDigest, context.generationSet.primarySourceId, sources);
+    return {
+        generationSet: { ...context.generationSet, sources, generationSetDigest },
+        generationSetDigest,
+        catalog: {
+            ...context.catalog,
+            sources: context.catalog.sources.filter((source) => requested.has(source.sourceId)),
+            compositeDigest: generationSetDigest,
+        },
+    };
+}
+function selectedSourceIds(snapshot, sourceIds) {
+    if (!sourceIds)
+        return snapshot.config.sources.map((source) => source.id);
+    const configured = new Set(snapshot.config.sources.map((source) => source.id));
+    const unknown = sourceIds.find((sourceId) => !configured.has(sourceId));
+    if (unknown)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationSourceMissing',
+            sourceId: unknown,
+            message: `Catalog source "${unknown}" is not configured.`,
+        });
+    const requested = new Set(sourceIds);
+    return snapshot.config.sources.filter((source) => requested.has(source.id)).map((source) => source.id);
+}
+async function createContext(options) {
+    const configured = new Map(options.control.configSnapshot.config.sources.map((source) => [source.id, source]));
+    const sources = options.generationSet.sources.map((generation) => {
+        options.signal?.throwIfAborted();
+        const source = configured.get(generation.sourceId);
+        const active = options.control.generationState.sources[generation.sourceId]?.active;
+        if (!source || !active
+            || active.snapshotDigest !== generation.snapshotDigest
+            || active.sourceIdentity !== generation.sourceIdentity) {
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationIdentityMismatch',
+                sourceId: generation.sourceId,
+                message: `Active Catalog snapshot for source "${generation.sourceId}" changed while the operation context was being resolved. Retry the operation.`,
+            });
+        }
+        const resolution = {
+            sourceId: generation.sourceId,
+            sourceIdentity: generation.sourceIdentity,
+            requestedRef: active.requestedRef,
+            resolvedCommit: generation.resolvedCommit,
+            rootDir: generation.snapshotPath,
+            manifest: generation.manifest,
+            manifestDigest: generation.manifestDigest,
+            snapshotDigest: generation.snapshotDigest,
+            transport: source.type,
+            async cleanup() { },
+        };
+        return { sourceId: generation.sourceId, resolution };
+    });
+    return {
+        generationSet: options.generationSet,
+        generationSetDigest: options.generationSet.generationSetDigest,
+        catalog: {
+            sources,
+            primarySourceId: options.generationSet.primarySourceId,
+            configDigest: options.generationSet.configDigest,
+            compositeDigest: options.generationSet.generationSetDigest,
+        },
+    };
+}
+export async function resolveCatalogOperationContext(options = {}) {
+    const env = options.env ?? process.env;
+    options.signal?.throwIfAborted();
+    const control = await readCatalogGenerationControlSnapshot({
+        env,
+        configSnapshot: options.configSnapshot,
+    });
+    const generationSet = await resolveCatalogGenerationSet({
+        sourceIds: selectedSourceIds(control.configSnapshot, options.sourceIds),
+        env,
+        controlSnapshot: control,
+        validatedStoreEntries: options.validatedStoreEntries,
+        validatingStoreEntries: options.validatingStoreEntries,
+    });
+    return createContext({ generationSet, control, signal: options.signal });
+}
+export async function resolvePartialCatalogOperationContext(options = {}) {
+    const env = options.env ?? process.env;
+    const control = await readCatalogGenerationControlSnapshot({
+        env,
+        configSnapshot: options.configSnapshot,
+    });
+    const sourceIds = selectedSourceIds(control.configSnapshot, options.sourceIds);
+    const results = await Promise.all(sourceIds.map(async (sourceId) => {
+        try {
+            const generationSet = await resolveCatalogGenerationSet({
+                sourceIds: [sourceId],
+                env,
+                controlSnapshot: control,
+                validatedStoreEntries: options.validatedStoreEntries,
+                validatingStoreEntries: options.validatingStoreEntries,
+            });
+            return { sourceId, context: await createContext({ generationSet, control, signal: options.signal }) };
+        }
+        catch (error) {
+            if (options.signal?.aborted)
+                throw error;
+            return { sourceId, error: error };
+        }
+    }));
+    const sources = results.flatMap((result) => result.context?.generationSet.sources ?? [])
+        .sort((left, right) => left.sourceId.localeCompare(right.sourceId));
+    const primarySourceId = control.configSnapshot.config.sources.find((source) => source.primary).id;
+    const generationSetDigest = calculateCatalogGenerationSetDigest(control.configSnapshot.digest, primarySourceId, sources);
+    return {
+        generationSet: {
+            generationSetDigest,
+            configDigest: control.configSnapshot.digest,
+            primarySourceId,
+            sources,
+        },
+        generationSetDigest,
+        catalog: {
+            sources: results.map((result) => result.context
+                ? result.context.catalog.sources[0]
+                : { sourceId: result.sourceId, error: result.error }),
+            primarySourceId,
+            configDigest: control.configSnapshot.digest,
+            compositeDigest: generationSetDigest,
+        },
+    };
+}
+//# sourceMappingURL=catalog-operation-context.js.map

package/dist/src/utils/catalog-operation-context.js.map

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

package/dist/src/utils/catalog-public-error.d.ts

@@ -0,0 +1,19 @@
+export type CatalogProviderCompatibilityErrorCode = 'awCapabilityUnsupported';
+export declare class CatalogProviderCompatibilityError extends Error {
+    readonly sourceId: string;
+    readonly code: CatalogProviderCompatibilityErrorCode;
+    readonly requiredCapabilities: string[];
+    readonly missingCapabilities: string[];
+    readonly availableCapabilities: string[];
+    constructor(options: {
+        sourceId: string;
+        requiredCapabilities: readonly string[];
+        missingCapabilities: readonly string[];
+        availableCapabilities: readonly string[];
+    });
+}
+export declare function sanitizeCatalogSourceErrorMessage(message: string, env?: NodeJS.ProcessEnv, sensitiveRoots?: readonly string[]): string;
+export declare function catalogSourceErrorCode(error: unknown): string;
+export declare function sanitizeCatalogSourceError(error: unknown, env?: NodeJS.ProcessEnv, sensitiveRoots?: readonly string[]): Error & {
+    code: string;
+};

package/dist/src/utils/catalog-public-error.js

@@ -0,0 +1,100 @@
+import os from 'node:os';
+import path from 'node:path';
+import { resolveAwHome } from './state-paths.js';
+const DEFAULT_ERROR_CODE = 'catalogSourceResolutionFailed';
+export class CatalogProviderCompatibilityError extends Error {
+    sourceId;
+    code;
+    requiredCapabilities;
+    missingCapabilities;
+    availableCapabilities;
+    constructor(options) {
+        super(`Catalog source "${options.sourceId}" requires unsupported AW capabilities: ${options.missingCapabilities.join(', ')}.`);
+        this.name = 'CatalogProviderCompatibilityError';
+        this.sourceId = options.sourceId;
+        this.code = 'awCapabilityUnsupported';
+        this.requiredCapabilities = [...options.requiredCapabilities];
+        this.missingCapabilities = [...options.missingCapabilities];
+        this.availableCapabilities = [...options.availableCapabilities];
+    }
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function replaceRoot(message, root, replacement) {
+    const normalized = path.resolve(root);
+    const variants = new Set([
+        normalized,
+        normalized.replaceAll('\\', '/'),
+        ...(normalized.startsWith('/var/') ? [`/private${normalized}`] : []),
+        ...(normalized.startsWith('/private/var/') ? [normalized.slice('/private'.length)] : []),
+    ]);
+    let output = message;
+    for (const variant of variants) {
+        output = output.replace(new RegExp(escapeRegExp(variant), 'g'), replacement);
+    }
+    return output;
+}
+export function sanitizeCatalogSourceErrorMessage(message, env = process.env, sensitiveRoots = []) {
+    const awHome = path.resolve(resolveAwHome(env));
+    let output = message;
+    for (const root of sensitiveRoots) {
+        if (root.trim() !== '')
+            output = replaceRoot(output, root, '[catalog-source]');
+    }
+    for (const [root, replacement] of [
+        [path.join(path.dirname(awHome), '.aw-local-marketplace-staging'), '[catalog-staging]'],
+        [awHome, '[aw-state]'],
+    ]) {
+        output = replaceRoot(output, root, replacement);
+    }
+    for (const tempRoot of new Set([
+        env.TMPDIR,
+        env.TEMP,
+        env.TMP,
+        os.tmpdir(),
+        '/private/tmp',
+        '/tmp',
+    ].filter((value) => Boolean(value)))) {
+        output = replaceRoot(output, tempRoot, '[temporary]');
+    }
+    return output.replace(/\.(?:materialize|path)-[^/\\\s"']+\.tmp/gu, '[catalog-materialization]');
+}
+export function catalogSourceErrorCode(error) {
+    const code = error.code;
+    return typeof code === 'string' && code.length > 0 ? code : DEFAULT_ERROR_CODE;
+}
+export function sanitizeCatalogSourceError(error, env = process.env, sensitiveRoots = []) {
+    const original = error instanceof Error ? error : new Error(String(error));
+    const sanitized = new Error(sanitizeCatalogSourceErrorMessage(original.message, env, sensitiveRoots), {
+        ...(original.cause === undefined
+            ? {}
+            : { cause: sanitizeCatalogSourceError(original.cause, env, sensitiveRoots) }),
+    });
+    sanitized.name = original.name;
+    sanitized.code = catalogSourceErrorCode(original);
+    const sourceId = original.sourceId;
+    if (typeof sourceId === 'string') {
+        sanitized.sourceId = sourceId;
+    }
+    if ('inventory' in original) {
+        sanitized.inventory = original.inventory;
+    }
+    if ('impact' in original) {
+        sanitized.impact = original.impact;
+    }
+    const originalCapabilities = original;
+    const sanitizedCapabilities = sanitized;
+    for (const field of [
+        'requiredCapabilities',
+        'missingCapabilities',
+        'availableCapabilities',
+    ]) {
+        const value = originalCapabilities[field];
+        if (Array.isArray(value) && value.every((entry) => typeof entry === 'string')) {
+            sanitizedCapabilities[field] = [...value];
+        }
+    }
+    return sanitized;
+}
+//# sourceMappingURL=catalog-public-error.js.map

package/dist/src/utils/catalog-public-error.js.map

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

package/dist/src/utils/catalog-runtime-projection.d.ts

@@ -0,0 +1,33 @@
+import { type CanonicalRuntimeSourceIdentity } from '@lesliechan721/aw-plugin-core/manifest';
+import type { BuildConfigImportReference, PlatformName, PluginMeta } from '../types.js';
+export { resolveCanonicalRuntimeSourceIdentity, } from '@lesliechan721/aw-plugin-core/manifest';
+export type { CanonicalRuntimeSourceIdentity } from '@lesliechan721/aw-plugin-core/manifest';
+export type CatalogRuntimeImportPurpose = 'build' | 'skill-runtime-file' | 'artifact-runtime';
+export interface CatalogRuntimeExportResolution {
+    provider: string;
+    providerVersion: string;
+    name: string;
+    source: string;
+    sourcePath: string;
+    sourceDigest: string;
+    requiredCapabilities: string[];
+    capabilitySetDigest: string;
+    canonicalSource: CanonicalRuntimeSourceIdentity;
+    supportedPlatforms: ReadonlySet<PlatformName>;
+    virtual: boolean;
+}
+export interface CatalogRuntimeImportResolver {
+    resolve(options: {
+        consumer: PluginMeta;
+        reference: BuildConfigImportReference;
+        purpose: CatalogRuntimeImportPurpose;
+        platform?: PlatformName;
+    }): Promise<CatalogRuntimeExportResolution>;
+}
+export declare function resolveRuntimeExportSource(options: {
+    plugin: PluginMeta;
+    name: string;
+    source: string;
+    requiredCapabilities: readonly unknown[];
+}): Promise<CatalogRuntimeExportResolution>;
+export declare function createCatalogRuntimeImportResolver(plugins: readonly PluginMeta[]): CatalogRuntimeImportResolver;

package/dist/src/utils/catalog-runtime-projection.js

@@ -0,0 +1,77 @@
+import { computeAwCapabilitySetDigest, normalizeAwCapabilities, validateRuntimeExportSource, } from '@lesliechan721/aw-plugin-core/manifest';
+import { calculateFileDigest } from './bundle-integrity.js';
+import { resolveSupportedPlatforms } from './platform-support.js';
+export { resolveCanonicalRuntimeSourceIdentity, } from '@lesliechan721/aw-plugin-core/manifest';
+export async function resolveRuntimeExportSource(options) {
+    const canonicalSource = await validateRuntimeExportSource({
+        pluginRoot: options.plugin.rootDir,
+        name: options.name,
+        source: options.source,
+    });
+    const requiredCapabilities = normalizeAwCapabilities(options.requiredCapabilities, `buildConfig.runtimeExports export "${options.name}" requires.aw.capabilities`);
+    return {
+        provider: options.plugin.manifest.name,
+        providerVersion: options.plugin.manifest.version,
+        name: options.name,
+        source: options.source,
+        sourcePath: canonicalSource.sourceRealPath,
+        sourceDigest: await calculateFileDigest(canonicalSource.sourceRealPath),
+        requiredCapabilities,
+        capabilitySetDigest: computeAwCapabilitySetDigest(requiredCapabilities),
+        canonicalSource,
+        supportedPlatforms: resolveSupportedPlatforms(options.plugin.manifest),
+        virtual: false,
+    };
+}
+export function createCatalogRuntimeImportResolver(plugins) {
+    const pluginsByName = new Map();
+    for (const plugin of plugins) {
+        const matches = pluginsByName.get(plugin.manifest.name) ?? [];
+        matches.push(plugin);
+        pluginsByName.set(plugin.manifest.name, matches);
+    }
+    return {
+        async resolve({ consumer, reference, purpose, platform }) {
+            if (reference.plugin.startsWith('@aw/')) {
+                throw new Error(`Invalid catalog runtime import: unknown reserved provider "${reference.plugin}".`);
+            }
+            if (reference.plugin === consumer.manifest.name) {
+                throw new Error(`Invalid catalog runtime import: plugin "${consumer.manifest.name}" cannot import itself.`);
+            }
+            const providers = pluginsByName.get(reference.plugin) ?? [];
+            if (providers.length === 0) {
+                throw new Error(`Invalid catalog runtime import: provider plugin "${reference.plugin}" is unavailable.`);
+            }
+            if (providers.length !== 1) {
+                throw new Error(`Invalid catalog runtime import: provider plugin "${reference.plugin}" is ambiguous.`);
+            }
+            const provider = providers[0];
+            const exports = (provider.manifest.buildConfig?.runtimeExports ?? [])
+                .filter((entry) => entry.name === reference.export);
+            if (exports.length === 0) {
+                throw new Error(`Invalid catalog runtime import: provider "${reference.plugin}" does not export "${reference.export}".`);
+            }
+            if (exports.length !== 1) {
+                throw new Error(`Invalid catalog runtime import: provider "${reference.plugin}" export "${reference.export}" is ambiguous.`);
+            }
+            const resolution = await resolveRuntimeExportSource({
+                plugin: provider,
+                name: exports[0].name,
+                source: exports[0].source,
+                requiredCapabilities: exports[0].requires.aw.capabilities,
+            });
+            if (platform && !resolution.supportedPlatforms.has(platform)) {
+                throw new Error(`Invalid catalog runtime import: provider "${reference.plugin}" is unavailable for platform "${platform}".`);
+            }
+            if (purpose === 'build') {
+                const unsupportedPlatform = [...resolveSupportedPlatforms(consumer.manifest)]
+                    .find((consumerPlatform) => !resolution.supportedPlatforms.has(consumerPlatform));
+                if (unsupportedPlatform) {
+                    throw new Error(`Invalid catalog runtime import: provider "${reference.plugin}" is unavailable for consumer platform "${unsupportedPlatform}".`);
+                }
+            }
+            return resolution;
+        },
+    };
+}
+//# sourceMappingURL=catalog-runtime-projection.js.map

package/dist/src/utils/catalog-runtime-projection.js.map

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

package/dist/src/utils/catalog-snapshot.d.ts

@@ -0,0 +1,10 @@
+import type { CatalogManifestV7 } from '../types.js';
+export interface CatalogSnapshotValidation {
+    rootDir: string;
+    manifest: CatalogManifestV7;
+    manifestDigest: string;
+    snapshotDigest: string;
+}
+export declare function validateCatalogSnapshotTransport(rootDir: string): Promise<CatalogSnapshotValidation>;
+export declare function validateCatalogSnapshotComplete(rootDir: string): Promise<CatalogSnapshotValidation>;
+export declare function validateCatalogSnapshotPluginEntriesComplete(rootDir: string, pluginNames: readonly string[]): Promise<CatalogSnapshotValidation>;

package/dist/src/utils/catalog-snapshot.js

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import { validateCatalogSnapshotComplete as validateCoreCatalogSnapshotComplete, validateCatalogSnapshotPluginEntriesComplete as validateCoreCatalogSnapshotPluginEntriesComplete, validateCatalogSnapshotTransport as validateCoreCatalogSnapshotTransport, } from '@lesliechan721/aw-plugin-core';
+import { CURRENT_CATALOG_MANIFEST_FILE } from '../constants.js';
+import { calculateFileDigest } from './bundle-integrity.js';
+async function withManifestDigest(validation) {
+    return {
+        ...validation,
+        manifestDigest: await calculateFileDigest(path.join(validation.rootDir, CURRENT_CATALOG_MANIFEST_FILE)),
+    };
+}
+export async function validateCatalogSnapshotTransport(rootDir) {
+    return withManifestDigest(await validateCoreCatalogSnapshotTransport(rootDir));
+}
+export async function validateCatalogSnapshotComplete(rootDir) {
+    return withManifestDigest(await validateCoreCatalogSnapshotComplete(rootDir));
+}
+export async function validateCatalogSnapshotPluginEntriesComplete(rootDir, pluginNames) {
+    return withManifestDigest(await validateCoreCatalogSnapshotPluginEntriesComplete(rootDir, pluginNames));
+}
+//# sourceMappingURL=catalog-snapshot.js.map

package/dist/src/utils/catalog-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-snapshot.js","sourceRoot":"","sources":["../../../src/utils/catalog-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,+BAA+B,IAAI,mCAAmC,EACtE,4CAA4C,IAAI,gDAAgD,EAChG,gCAAgC,IAAI,oCAAoC,GACzE,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAS5D,KAAK,UAAU,kBAAkB,CAC/B,UAA6D;IAE7D,OAAO;QACL,GAAG,UAAU;QACb,cAAc,EAAE,MAAM,mBAAmB,CACvC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAC7D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,OAAe;IACpE,OAAO,kBAAkB,CAAC,MAAM,oCAAoC,CAAC,OAAO,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAAe;IACnE,OAAO,kBAAkB,CAAC,MAAM,mCAAmC,CAAC,OAAO,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4CAA4C,CAChE,OAAe,EACf,WAA8B;IAE9B,OAAO,kBAAkB,CAAC,MAAM,gDAAgD,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAC1G,CAAC"}

package/dist/src/utils/catalog-source-identity.d.ts

@@ -0,0 +1,5 @@
+import type { CatalogSource, SourceIdentity } from '../types.js';
+export declare function canonicalizeCatalogGitUrl(value: string): string;
+export declare function canonicalizeCatalogPath(value: string, cwd: string): Promise<string>;
+export declare function calculateCatalogSourceIdentity(source: CatalogSource): Promise<SourceIdentity>;
+export declare function calculateCatalogSourceConfigFingerprint(source: CatalogSource): string;

package/dist/src/utils/catalog-source-identity.js

@@ -0,0 +1,137 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import fs from 'fs-extra';
+import { CATALOG_SOURCE_IDENTITY_VERSION, OFFICIAL_CATALOG_SOURCE_SSH_URL, OFFICIAL_CATALOG_SOURCE_URL, } from '../constants.js';
+const SCP_GIT_URL_PATTERN = /^([^@/:\s]+)@([^/:\s]+):(.+)$/;
+const ALLOWED_GIT_URL_PROTOCOLS = new Set(['file:', 'https:', 'ssh:']);
+function normalizeGitPath(pathname) {
+    const normalized = pathname.replace(/\/+$/, '');
+    if (normalized === '' || normalized === '.') {
+        throw new Error('Invalid catalog Git URL: expected a repository path.');
+    }
+    return normalized;
+}
+export function canonicalizeCatalogGitUrl(value) {
+    if (typeof value !== 'string' || value.trim() === '' || value !== value.trim()) {
+        throw new Error('Invalid catalog Git URL: expected a non-empty canonical URL.');
+    }
+    const scpMatch = SCP_GIT_URL_PATTERN.exec(value);
+    if (scpMatch) {
+        const [, username, hostname, pathname] = scpMatch;
+        const hostUrl = new URL(`ssh://${hostname}/`);
+        const pathKind = pathname.startsWith('/') ? 'absolute' : 'relative';
+        return `scp-${pathKind}:${username}@${hostUrl.hostname.toLowerCase()}:${normalizeGitPath(pathname)}`;
+    }
+    if (path.isAbsolute(value)) {
+        const normalized = path.normalize(value).replace(/[\\/]+$/, '');
+        if (!normalized)
+            throw new Error('Invalid catalog Git path: expected a repository path.');
+        return normalized;
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error('Invalid catalog Git URL: expected an absolute URL.');
+    }
+    if (!ALLOWED_GIT_URL_PROTOCOLS.has(url.protocol)) {
+        throw new Error(`Invalid catalog Git URL protocol "${url.protocol}".`);
+    }
+    if ((url.protocol !== 'file:' && !url.hostname)
+        || (url.protocol === 'file:' && url.hostname !== '')
+        || url.password
+        || (url.username && url.protocol !== 'ssh:')) {
+        throw new Error('Invalid catalog Git URL: embedded credentials are not allowed.');
+    }
+    if (url.search || url.hash) {
+        throw new Error('Invalid catalog Git URL: query strings and fragments are not allowed.');
+    }
+    if (url.protocol === 'https:' && url.username) {
+        throw new Error('Invalid catalog Git URL: embedded credentials are not allowed.');
+    }
+    if (url.protocol === 'file:') {
+        const filePath = fileURLToPath(url);
+        if (!path.isAbsolute(filePath))
+            throw new Error('Invalid catalog Git file URL: expected an absolute path.');
+        return pathToFileURL(normalizeGitPath(filePath)).href;
+    }
+    const username = url.username ? `${url.username}@` : '';
+    const port = url.port ? `:${url.port}` : '';
+    return `${url.protocol}//${username}${url.hostname.toLowerCase()}${port}${normalizeGitPath(url.pathname)}`;
+}
+function logicalCatalogGitIdentityLocation(value) {
+    if (value === OFFICIAL_CATALOG_SOURCE_URL || value === OFFICIAL_CATALOG_SOURCE_SSH_URL) {
+        return canonicalizeCatalogGitUrl(OFFICIAL_CATALOG_SOURCE_URL);
+    }
+    return canonicalizeCatalogGitUrl(value);
+}
+function normalizeIdentitySubdir(subdir) {
+    if (subdir === undefined)
+        return null;
+    if (typeof subdir !== 'string' || subdir.trim() === '' || subdir.includes('\\')) {
+        throw new Error('Invalid catalog source subdir: expected a relative POSIX path.');
+    }
+    const normalized = path.posix.normalize(subdir);
+    if (path.posix.isAbsolute(subdir)
+        || normalized === '.'
+        || normalized === '..'
+        || normalized.startsWith('../')) {
+        throw new Error('Invalid catalog source subdir: path must stay inside the source.');
+    }
+    return normalized.replace(/^\.\//, '').replace(/\/$/, '');
+}
+async function realpathCatalogDirectory(value) {
+    const location = await fs.realpath(value);
+    const stat = await fs.stat(location);
+    if (!stat.isDirectory()) {
+        throw new Error('Invalid catalog path source: expected a directory.');
+    }
+    return location;
+}
+export async function canonicalizeCatalogPath(value, cwd) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error('Invalid catalog path source: expected a non-empty path.');
+    }
+    if (typeof cwd !== 'string' || cwd.trim() === '' || !path.isAbsolute(cwd)) {
+        throw new Error('Invalid catalog path source cwd: expected an absolute path.');
+    }
+    return realpathCatalogDirectory(path.resolve(cwd, value));
+}
+export async function calculateCatalogSourceIdentity(source) {
+    let location;
+    if (source.type === 'git') {
+        location = logicalCatalogGitIdentityLocation(source.url);
+    }
+    else if (source.type === 'path') {
+        if (!path.isAbsolute(source.path)) {
+            throw new Error('Invalid catalog path source: expected a canonical absolute path.');
+        }
+        location = path.normalize(source.path);
+    }
+    else {
+        throw new Error('Invalid catalog source type: expected "git" or "path".');
+    }
+    const input = JSON.stringify({
+        version: CATALOG_SOURCE_IDENTITY_VERSION,
+        type: source.type,
+        location,
+        subdir: normalizeIdentitySubdir(source.type === 'git' ? source.subdir : undefined),
+    });
+    return `sha256:${crypto.createHash('sha256').update(input).digest('hex')}`;
+}
+export function calculateCatalogSourceConfigFingerprint(source) {
+    const location = source.type === 'git'
+        ? canonicalizeCatalogGitUrl(source.url)
+        : path.normalize(source.path);
+    const input = JSON.stringify({
+        version: 1,
+        type: source.type,
+        location,
+        refPolicy: source.type === 'git' ? source.refPolicy : null,
+        subdir: normalizeIdentitySubdir(source.type === 'git' ? source.subdir : undefined),
+    });
+    return `sha256:${crypto.createHash('sha256').update(input).digest('hex')}`;
+}
+//# sourceMappingURL=catalog-source-identity.js.map

package/dist/src/utils/catalog-source-identity.js.map

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

package/dist/src/utils/catalog-source-impact.d.ts

@@ -0,0 +1,20 @@
+import type { CatalogManifestV7, CatalogSourceImpact, CatalogSourcePluginChanges } from '../types.js';
+import { type CatalogSourceReferenceInventory } from './catalog-source-references.js';
+export type { CatalogSourceImpact, CatalogSourceImpactCategory, CatalogSourceImpactError, CatalogSourceImpactReference, CatalogSourcePluginChanges, } from '../types.js';
+export declare function compareCatalogSourcePluginChanges(options: {
+    sourceId: string;
+    currentManifest: CatalogManifestV7;
+    candidateManifest: CatalogManifestV7;
+}): CatalogSourcePluginChanges;
+export declare function inspectCatalogSourceImpact(options: {
+    sourceId: string;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    sourcePrimary?: boolean;
+    mode: 'none' | 'remove' | 'identityChange' | 'generation';
+    currentManifest?: CatalogManifestV7;
+    candidateManifest?: CatalogManifestV7;
+    inventory?: CatalogSourceReferenceInventory;
+}): Promise<CatalogSourceImpact>;
+export declare function catalogSourceImpactRequiresConfirmation(impact: CatalogSourceImpact): boolean;
+export declare function calculateCatalogSourceImpactDigest(impact: CatalogSourceImpact): string;