@lesliechan721/aw 0.1.0-beta.3

package/dist/src/types.js

@@ -0,0 +1,33 @@
+export class CommandWarningError extends Error {
+    warnings;
+    exitCode;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = 'CommandWarningError';
+        this.warnings = [...new Set(options.warnings ?? [])];
+        this.exitCode = options.exitCode ?? 1;
+    }
+}
+export function isCommandWarningError(error) {
+    return (error instanceof Error &&
+        error.name === 'CommandWarningError' &&
+        Array.isArray(error.warnings) &&
+        typeof error.exitCode === 'number');
+}
+export class AgentVersionGateError extends Error {
+    code = 'AGENT_VERSION_GATE_FAILED';
+    payload;
+    constructor(message, payload) {
+        super(message);
+        this.name = 'AgentVersionGateError';
+        this.payload = payload;
+    }
+}
+export function isAgentVersionGateError(error) {
+    return (error instanceof Error &&
+        error.name === 'AgentVersionGateError' &&
+        typeof error.code === 'string' &&
+        typeof error.payload === 'object' &&
+        Array.isArray(error.payload.failures));
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAuXA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,QAAQ,CAAW;IACnB,QAAQ,CAAS;IAE1B,YACE,OAAe,EACf,UAGI,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,KAAK,CAAC,IAAI,KAAK,qBAAqB;QACpC,KAAK,CAAC,OAAO,CAAE,KAA6B,CAAC,QAAQ,CAAC;QACtD,OAAQ,KAA6B,CAAC,QAAQ,KAAK,QAAQ,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,2BAA2B,CAAC;IACnC,OAAO,CAA+B;IAE/C,YACE,OAAe,EACf,OAAqC;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,KAAK,CAAC,IAAI,KAAK,uBAAuB;QACtC,OAAQ,KAA+B,CAAC,IAAI,KAAK,QAAQ;QACzD,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ;QAC5D,KAAK,CAAC,OAAO,CAAE,KAA+B,CAAC,OAAO,CAAC,QAAQ,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/dist/src/utils/active-marketplace-runtime-lock.d.ts

@@ -0,0 +1,12 @@
+import { type ProcessLockLease } from './process-lock.js';
+export declare function markActiveMarketplaceDurableCommit(): void;
+export declare function setActiveMarketplaceLifecycleBeforeAcquireHookForTests(hook: ((coordinationRoot: string) => Promise<void>) | undefined): void;
+export declare function setActiveMarketplaceCoordinationBeforeReleaseHookForTests(hook: ((lockPath: string, attempt: number) => Promise<void>) | undefined): void;
+export declare function resolveActiveMarketplaceRuntimeCoordinationRoot(env?: NodeJS.ProcessEnv): string;
+export declare function acquireActiveMarketplaceRuntimeLease(env?: NodeJS.ProcessEnv): Promise<ProcessLockLease>;
+export declare function acquireActiveMarketplaceRuntimeLeaseAtRoot(coordinationRoot: string): Promise<ProcessLockLease>;
+export declare function acquireActiveMarketplaceLifecycleLease(env?: NodeJS.ProcessEnv): Promise<ProcessLockLease>;
+export declare function acquireActiveMarketplaceLifecycleLeaseAtRoot(coordinationRoot: string): Promise<ProcessLockLease>;
+export declare function releaseActiveMarketplaceCoordinationLease(lease: ProcessLockLease): Promise<void>;
+export declare function withActiveMarketplaceRuntimeLease<T>(env: NodeJS.ProcessEnv | undefined, action: () => Promise<T>): Promise<T>;
+export declare function withActiveMarketplaceLifecycleLease<T>(env: NodeJS.ProcessEnv | undefined, action: () => Promise<T>): Promise<T>;

package/dist/src/utils/active-marketplace-runtime-lock.js

@@ -0,0 +1,133 @@
+import crypto from 'node:crypto';
+import { AsyncLocalStorage } from 'node:async_hooks';
+import path from 'node:path';
+import { acquireProcessLock } from './process-lock.js';
+import { canonicalizePathThroughExistingAncestorSync, ensureRegularDirectoryPath, resolveAwHome, } from './state-paths.js';
+import { assertTestWritablePath } from './test-path-fence.js';
+const ACTIVE_MARKETPLACE_RUNTIME_LOCK_TIMEOUT_MS = 600_000;
+const ACTIVE_MARKETPLACE_RUNTIME_LOCK_FILE = 'runtime-state.lock';
+const RETRYABLE_RELEASE_ERROR_CODES = new Set([
+    'EACCES',
+    'EBUSY',
+    'EINTR',
+    'EIO',
+    'ENOTEMPTY',
+    'EPERM',
+]);
+let activeMarketplaceLifecycleBeforeAcquireHookForTests;
+let activeMarketplaceCoordinationBeforeReleaseHookForTests;
+const coordinationCommitStorage = new AsyncLocalStorage();
+export function markActiveMarketplaceDurableCommit() {
+    let context = coordinationCommitStorage.getStore();
+    while (context) {
+        context.durableCommit = true;
+        context = context.parent;
+    }
+}
+export function setActiveMarketplaceLifecycleBeforeAcquireHookForTests(hook) {
+    activeMarketplaceLifecycleBeforeAcquireHookForTests = hook;
+}
+export function setActiveMarketplaceCoordinationBeforeReleaseHookForTests(hook) {
+    activeMarketplaceCoordinationBeforeReleaseHookForTests = hook;
+}
+export function resolveActiveMarketplaceRuntimeCoordinationRoot(env = process.env) {
+    const awHome = canonicalizePathThroughExistingAncestorSync(resolveAwHome(env));
+    const identity = crypto.createHash('sha256')
+        .update(awHome)
+        .digest('hex')
+        .slice(0, 16);
+    return assertTestWritablePath(path.join(path.dirname(awHome), '.aw-local-marketplace-staging', `.runtime-state-${identity}`), 'active marketplace runtime coordination root', '用 createIsolatedTestEnv() 生成默认 AW_HOME，或登记 AW_HOME 同盘 sibling lock 路径。');
+}
+export async function acquireActiveMarketplaceRuntimeLease(env = process.env) {
+    const coordinationRoot = resolveActiveMarketplaceRuntimeCoordinationRoot(env);
+    return acquireActiveMarketplaceRuntimeLeaseAtRoot(coordinationRoot);
+}
+export async function acquireActiveMarketplaceRuntimeLeaseAtRoot(coordinationRoot) {
+    await ensureRegularDirectoryPath(coordinationRoot, 'Active marketplace coordination root');
+    return acquireProcessLock({
+        lockPath: path.join(coordinationRoot, ACTIVE_MARKETPLACE_RUNTIME_LOCK_FILE),
+        timeoutMs: ACTIVE_MARKETPLACE_RUNTIME_LOCK_TIMEOUT_MS,
+    });
+}
+export async function acquireActiveMarketplaceLifecycleLease(env = process.env) {
+    const coordinationRoot = resolveActiveMarketplaceRuntimeCoordinationRoot(env);
+    return acquireActiveMarketplaceLifecycleLeaseAtRoot(coordinationRoot);
+}
+export async function acquireActiveMarketplaceLifecycleLeaseAtRoot(coordinationRoot) {
+    await ensureRegularDirectoryPath(coordinationRoot, 'Active marketplace coordination root');
+    await activeMarketplaceLifecycleBeforeAcquireHookForTests?.(coordinationRoot);
+    return acquireProcessLock({
+        lockPath: path.join(coordinationRoot, 'lifecycle-state.lock'),
+        timeoutMs: ACTIVE_MARKETPLACE_RUNTIME_LOCK_TIMEOUT_MS,
+    });
+}
+export async function releaseActiveMarketplaceCoordinationLease(lease) {
+    let lastError;
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+            await activeMarketplaceCoordinationBeforeReleaseHookForTests?.(lease.lockPath, attempt + 1);
+            await lease.release();
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            const code = error.code ?? '';
+            if (!RETRYABLE_RELEASE_ERROR_CODES.has(code))
+                throw error;
+        }
+    }
+    await lease.release().catch(() => undefined);
+    throw lastError;
+}
+async function withCoordinationLease(lease, label, action) {
+    let result;
+    let actionError;
+    let actionSucceeded = false;
+    const commitContext = {
+        parent: coordinationCommitStorage.getStore(),
+        durableCommit: false,
+    };
+    try {
+        result = await coordinationCommitStorage.run(commitContext, action);
+        actionSucceeded = true;
+    }
+    catch (error) {
+        actionError = error;
+    }
+    try {
+        await releaseActiveMarketplaceCoordinationLease(lease);
+    }
+    catch (releaseError) {
+        if (!actionSucceeded) {
+            try {
+                process.emitWarning(`${label} action failed, and its lease release also failed.`, { code: 'AW_COORDINATION_LOCK_RELEASE_FAILED' });
+            }
+            catch {
+                // Diagnostics cannot replace the primary action error.
+            }
+            throw actionError;
+        }
+        if (commitContext.durableCommit) {
+            try {
+                process.emitWarning(`${label} committed its durable result, but its lease release failed.`, { code: 'AW_COORDINATION_LOCK_RELEASE_FAILED' });
+            }
+            catch {
+                // Diagnostics cannot replace a durable result.
+            }
+            return result;
+        }
+        throw releaseError;
+    }
+    if (!actionSucceeded)
+        throw actionError;
+    return result;
+}
+export async function withActiveMarketplaceRuntimeLease(env, action) {
+    const lease = await acquireActiveMarketplaceRuntimeLease(env);
+    return withCoordinationLease(lease, 'Active marketplace runtime', action);
+}
+export async function withActiveMarketplaceLifecycleLease(env, action) {
+    const lease = await acquireActiveMarketplaceLifecycleLease(env);
+    return withCoordinationLease(lease, 'Active marketplace lifecycle', action);
+}
+//# sourceMappingURL=active-marketplace-runtime-lock.js.map

package/dist/src/utils/active-marketplace-runtime-lock.js.map

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

package/dist/src/utils/agent-version.d.ts

@@ -0,0 +1,13 @@
+import type { AgentVersionProbeResult, AgentVersionRequirement, PlatformName } from '../types.js';
+import { type NativeCliRunner } from './native-cli.js';
+export interface ProbeAgentVersionOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    runner?: NativeCliRunner;
+    timeoutMs?: number;
+}
+export declare function getMinimumAgentVersion(platform: PlatformName): string;
+export declare function getAgentVersionRequirement(platform: PlatformName): AgentVersionRequirement;
+export declare function extractStrictSemVerTokenFromVersionOutput(output: string): string | null;
+export declare function probeAgentVersion(platform: PlatformName, options?: ProbeAgentVersionOptions): Promise<AgentVersionProbeResult>;
+export declare function clearAgentVersionProbeCacheForTests(): void;

package/dist/src/utils/agent-version.js

@@ -0,0 +1,172 @@
+import crypto from 'node:crypto';
+import { AGENT_VERSION_DISPLAY_NAMES, AGENT_VERSION_PROBE_COMMANDS, DEFAULT_AGENT_VERSION_PROBE_TIMEOUT_MS, MINIMUM_AGENT_VERSIONS, } from '../constants.js';
+import { compareStrictSemVer, tryParseStrictSemVer } from './manifest.js';
+import { getDefaultNativeCliRunner, isNativeCliExecutableMissingError, runNativeCli, summarizeNativeCliFailure, } from './native-cli.js';
+const VERSION_ARGUMENTS = ['--version'];
+let probeCacheByRunner = new WeakMap();
+export function getMinimumAgentVersion(platform) {
+    return MINIMUM_AGENT_VERSIONS[platform];
+}
+export function getAgentVersionRequirement(platform) {
+    return {
+        platform,
+        command: AGENT_VERSION_PROBE_COMMANDS[platform],
+        displayName: AGENT_VERSION_DISPLAY_NAMES[platform],
+        minVersion: getMinimumAgentVersion(platform),
+    };
+}
+export function extractStrictSemVerTokenFromVersionOutput(output) {
+    for (const token of output.split(/\s+/u)) {
+        if (token && tryParseStrictSemVer(token)) {
+            return token;
+        }
+    }
+    return null;
+}
+function combineProbeOutput(stdout, stderr) {
+    return [stdout, stderr]
+        .filter((value) => value.length > 0)
+        .join('\n');
+}
+function createEnvFingerprint(env) {
+    const entries = Object.keys(env)
+        .sort()
+        .map((key) => [key, env[key] ?? '']);
+    return crypto
+        .createHash('sha256')
+        .update(JSON.stringify(entries))
+        .digest('hex');
+}
+function buildProbeCacheKey(platform, requirement, options) {
+    const env = options.env ?? process.env;
+    return JSON.stringify({
+        platform,
+        command: requirement.command,
+        args: VERSION_ARGUMENTS,
+        cwd: options.cwd ?? process.cwd(),
+        timeoutMs: options.timeoutMs ?? DEFAULT_AGENT_VERSION_PROBE_TIMEOUT_MS,
+        minVersion: requirement.minVersion,
+        envFingerprint: createEnvFingerprint(env),
+    });
+}
+function cloneProbeResult(result) {
+    return { ...result };
+}
+function createFailureProbeResult(requirement, status, options = {}) {
+    const reasonCode = {
+        missing: 'agentVersionMissing',
+        probeFailed: 'agentVersionProbeFailed',
+        unparseable: 'agentVersionUnparseable',
+        tooOld: 'agentVersionTooLow',
+    };
+    return {
+        platform: requirement.platform,
+        command: requirement.command,
+        status,
+        requiredMinVersion: requirement.minVersion,
+        detectedVersion: options.detectedVersion,
+        reasonCode: reasonCode[status],
+        stdout: options.stdout ?? '',
+        stderr: options.stderr ?? '',
+        rawOutput: options.rawOutput ?? '',
+        exitCode: options.exitCode,
+        details: options.details,
+    };
+}
+export async function probeAgentVersion(platform, options = {}) {
+    const requirement = getAgentVersionRequirement(platform);
+    const runner = options.runner ?? getDefaultNativeCliRunner();
+    const cacheKey = buildProbeCacheKey(platform, requirement, options);
+    let runnerCache = probeCacheByRunner.get(runner);
+    if (!runnerCache) {
+        runnerCache = new Map();
+        probeCacheByRunner.set(runner, runnerCache);
+    }
+    const cached = runnerCache.get(cacheKey);
+    if (cached) {
+        return cloneProbeResult(await cached);
+    }
+    const probe = probeAgentVersionUncached(requirement, runner, options)
+        .catch((error) => {
+        runnerCache.delete(cacheKey);
+        throw error;
+    });
+    runnerCache.set(cacheKey, probe);
+    return cloneProbeResult(await probe);
+}
+async function probeAgentVersionUncached(requirement, runner, options) {
+    try {
+        const result = await runNativeCli({
+            command: requirement.command,
+            args: VERSION_ARGUMENTS,
+            cwd: options.cwd,
+            env: options.env,
+            timeoutMs: options.timeoutMs ?? DEFAULT_AGENT_VERSION_PROBE_TIMEOUT_MS,
+        }, runner);
+        const rawOutput = combineProbeOutput(result.stdout, result.stderr);
+        if (result.exitCode !== 0) {
+            return createFailureProbeResult(requirement, 'probeFailed', {
+                exitCode: result.exitCode,
+                stdout: result.stdout,
+                stderr: result.stderr,
+                rawOutput,
+                details: rawOutput.trim() || `Command exited with code ${result.exitCode}.`,
+            });
+        }
+        const detectedVersion = extractStrictSemVerTokenFromVersionOutput(rawOutput);
+        if (!detectedVersion) {
+            return createFailureProbeResult(requirement, 'unparseable', {
+                stdout: result.stdout,
+                stderr: result.stderr,
+                rawOutput,
+                details: `Unable to parse a strict SemVer token from ${requirement.command} --version output.`,
+            });
+        }
+        if (compareStrictSemVer(detectedVersion, requirement.minVersion) < 0) {
+            return createFailureProbeResult(requirement, 'tooOld', {
+                detectedVersion,
+                stdout: result.stdout,
+                stderr: result.stderr,
+                rawOutput,
+                details: `${requirement.displayName} ${detectedVersion} is lower than required ${requirement.minVersion}.`,
+            });
+        }
+        return {
+            platform: requirement.platform,
+            command: requirement.command,
+            status: 'supported',
+            requiredMinVersion: requirement.minVersion,
+            detectedVersion,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            rawOutput,
+            exitCode: result.exitCode,
+        };
+    }
+    catch (error) {
+        const nativeError = error;
+        const stdout = typeof nativeError.stdout === 'string' ? nativeError.stdout : '';
+        const stderr = typeof nativeError.stderr === 'string' ? nativeError.stderr : '';
+        const rawOutput = combineProbeOutput(stdout, stderr);
+        if (isNativeCliExecutableMissingError(error)) {
+            return createFailureProbeResult(requirement, 'missing', {
+                exitCode: typeof nativeError.exitCode === 'number' ? nativeError.exitCode : undefined,
+                stdout,
+                stderr,
+                rawOutput,
+                details: summarizeNativeCliFailure(error),
+            });
+        }
+        return createFailureProbeResult(requirement, 'probeFailed', {
+            exitCode: typeof nativeError.exitCode === 'number' ? nativeError.exitCode : undefined,
+            stdout,
+            stderr,
+            rawOutput,
+            details: summarizeNativeCliFailure(error),
+        });
+    }
+}
+export function clearAgentVersionProbeCacheForTests() {
+    probeCacheByRunner = new WeakMap();
+}
+//# sourceMappingURL=agent-version.js.map

package/dist/src/utils/agent-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-version.js","sourceRoot":"","sources":["../../../src/utils/agent-version.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,sCAAsC,EACtC,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,YAAY,EACZ,yBAAyB,GAE1B,MAAM,iBAAiB,CAAC;AASzB,MAAM,iBAAiB,GAAG,CAAC,WAAW,CAAC,CAAC;AAExC,IAAI,kBAAkB,GAAG,IAAI,OAAO,EAAkE,CAAC;AAEvG,MAAM,UAAU,sBAAsB,CAAC,QAAsB;IAC3D,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAsB;IAC/D,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,4BAA4B,CAAC,QAAQ,CAAC;QAC/C,WAAW,EAAE,2BAA2B,CAAC,QAAQ,CAAC;QAClD,UAAU,EAAE,sBAAsB,CAAC,QAAQ,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,MAAc;IACtE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,KAAK,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc,EAAE,MAAc;IACxD,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;SACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACnC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAsB;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;SAC7B,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,OAAO,MAAM;SACV,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;SAC/B,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CACzB,QAAsB,EACtB,WAAoC,EACpC,OAAiC;IAEjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,QAAQ;QACR,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,sCAAsC;QACtE,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,cAAc,EAAE,oBAAoB,CAAC,GAAG,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA+B;IACvD,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,wBAAwB,CAC/B,WAAoC,EACpC,MAA4D,EAC5D,UAOI,EAAE;IAEN,MAAM,UAAU,GAAG;QACjB,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,yBAAyB;QACtC,WAAW,EAAE,yBAAyB;QACtC,MAAM,EAAE,oBAAoB;KACpB,CAAC;IAEX,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,MAAM;QACN,kBAAkB,EAAE,WAAW,CAAC,UAAU;QAC1C,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAsB,EACtB,UAAoC,EAAE;IAEtC,MAAM,WAAW,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,yBAAyB,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACpE,IAAI,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,gBAAgB,CAAC,MAAM,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC;SAClE,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxB,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACL,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,WAAoC,EACpC,MAAuB,EACvB,OAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B;YACE,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,IAAI,EAAE,iBAAiB;YACvB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,sCAAsC;SACvE,EACD,MAAM,CACP,CAAC;QAEF,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,wBAAwB,CAAC,WAAW,EAAE,aAAa,EAAE;gBAC1D,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS;gBACT,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,4BAA4B,MAAM,CAAC,QAAQ,GAAG;aAC5E,CAAC,CAAC;QACL,CAAC;QAED,MAAM,eAAe,GAAG,yCAAyC,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,wBAAwB,CAAC,WAAW,EAAE,aAAa,EAAE;gBAC1D,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS;gBACT,OAAO,EAAE,8CAA8C,WAAW,CAAC,OAAO,oBAAoB;aAC/F,CAAC,CAAC;QACL,CAAC;QAED,IAAI,mBAAmB,CAAC,eAAe,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrE,OAAO,wBAAwB,CAAC,WAAW,EAAE,QAAQ,EAAE;gBACrD,eAAe;gBACf,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS;gBACT,OAAO,EAAE,GAAG,WAAW,CAAC,WAAW,IAAI,eAAe,2BAA2B,WAAW,CAAC,UAAU,GAAG;aAC3G,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,MAAM,EAAE,WAAW;YACnB,kBAAkB,EAAE,WAAW,CAAC,UAAU;YAC1C,eAAe;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS;YACT,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,KAInB,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,MAAM,MAAM,GAAG,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAErD,IAAI,iCAAiC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,wBAAwB,CAAC,WAAW,EAAE,SAAS,EAAE;gBACtD,QAAQ,EAAE,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBACrF,MAAM;gBACN,MAAM;gBACN,SAAS;gBACT,OAAO,EAAE,yBAAyB,CAAC,KAAK,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;QAED,OAAO,wBAAwB,CAAC,WAAW,EAAE,aAAa,EAAE;YAC1D,QAAQ,EAAE,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACrF,MAAM;YACN,MAAM;YACN,SAAS;YACT,OAAO,EAAE,yBAAyB,CAAC,KAAK,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,kBAAkB,GAAG,IAAI,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/src/utils/artifact-plan.d.ts

@@ -0,0 +1,26 @@
+import type { ArtifactPlanArtifact, PlatformName, DistributionName, PluginArtifactTargetDefinition, PluginManifestSource, Scope } from '../types.js';
+import type { ResolvedArtifactRenderConfig } from './artifact-renderer.js';
+export type ValidatedArtifactPlanArtifact = ArtifactPlanArtifact & {
+    declaration: PluginArtifactTargetDefinition;
+    logicalIdentity: string;
+    configDigest: string;
+};
+export interface ValidatedArtifactPlan {
+    version: 2;
+    artifacts: ValidatedArtifactPlanArtifact[];
+}
+export declare function createArtifactConfigDigest(options: {
+    artifact: Pick<ArtifactPlanArtifact, 'id' | 'platform' | 'distribution' | 'target' | 'refreshKeys'>;
+    configValues: Record<string, unknown>;
+    digestSalt: string;
+}): string;
+export declare function validateArtifactPlan(options: {
+    pluginName?: string;
+    manifest: PluginManifestSource;
+    plan: unknown;
+    platform: PlatformName | DistributionName;
+    scope: Scope;
+    renderConfig: Pick<ResolvedArtifactRenderConfig, 'values'>;
+    rendererDigest?: string;
+    manifestDigest?: string;
+}): ValidatedArtifactPlan;