@lesliechan721/aw-plugin-core 0.1.0-beta.1

package/dist/plugin-release.js

@@ -0,0 +1,187 @@
+import { assertStrictSemVer, compareStrictSemVer, parseStrictSemVer, } from './manifest-contract.js';
+export const PLUGIN_RELEASE_LEDGER_FILENAME = 'plugin-release-ledger.json';
+export const PLUGIN_RELEASE_LEDGER_SCHEMA_VERSION = 2;
+const PLUGIN_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+const SHA256_DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/u;
+function assertPlainObject(value, fieldName) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Invalid ${fieldName}: expected a JSON object.`);
+    }
+    return value;
+}
+function assertAllowedKeys(value, fieldName, allowedKeys) {
+    const allowed = new Set(allowedKeys);
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key))
+            throw new Error(`Invalid ${fieldName}: unknown field ${JSON.stringify(key)}.`);
+    }
+}
+function assertPluginName(value, fieldName) {
+    if (typeof value !== 'string' || !PLUGIN_NAME_PATTERN.test(value)) {
+        throw new Error(`Invalid ${fieldName}: expected lowercase hyphen-case.`);
+    }
+    return value;
+}
+function assertDigest(value, fieldName) {
+    if (typeof value !== 'string' || !SHA256_DIGEST_PATTERN.test(value)) {
+        throw new Error(`Invalid ${fieldName}: expected a canonical sha256 digest.`);
+    }
+    return value;
+}
+export function assertStablePluginVersion(version, fieldName = 'plugin version') {
+    const parsed = parseStrictSemVer(version, fieldName);
+    if (parsed.prerelease.length > 0 || parsed.build.length > 0) {
+        throw new Error(`Invalid ${fieldName}: expected a stable SemVer without prerelease or build metadata.`);
+    }
+    return version;
+}
+function identityKey(record) {
+    return `${record.plugin}@${record.version}`;
+}
+function recordKey(record) {
+    return JSON.stringify([record.channel, record.catalogVersion, record.plugin, record.version]);
+}
+function sameDigests(left, right) {
+    return left.artifactDigest === right.artifactDigest
+        && left.manifestDigest === right.manifestDigest
+        && left.contentDigest === right.contentDigest;
+}
+function validateRecord(rawValue, index) {
+    const raw = assertPlainObject(rawValue, `plugin release ledger.records[${index}]`);
+    assertAllowedKeys(raw, `plugin release ledger.records[${index}]`, [
+        'plugin', 'version', 'contentDigest', 'artifactDigest', 'manifestDigest', 'channel', 'catalogVersion',
+    ]);
+    if (raw.channel !== 'latest' && raw.channel !== 'beta') {
+        throw new Error(`Invalid plugin release ledger.records[${index}].channel.`);
+    }
+    return {
+        plugin: assertPluginName(raw.plugin, `plugin release ledger.records[${index}].plugin`),
+        version: assertStrictSemVer(raw.version, `plugin release ledger.records[${index}].version`),
+        contentDigest: raw.contentDigest === null ? null : assertDigest(raw.contentDigest, `plugin release ledger.records[${index}].contentDigest`),
+        artifactDigest: assertDigest(raw.artifactDigest, `plugin release ledger.records[${index}].artifactDigest`),
+        manifestDigest: assertDigest(raw.manifestDigest, `plugin release ledger.records[${index}].manifestDigest`),
+        channel: raw.channel,
+        catalogVersion: assertStrictSemVer(raw.catalogVersion, `plugin release ledger.records[${index}].catalogVersion`),
+    };
+}
+export function validatePluginReleaseLedger(rawValue) {
+    const raw = assertPlainObject(rawValue, 'plugin release ledger');
+    assertAllowedKeys(raw, 'plugin release ledger', ['schemaVersion', 'records']);
+    if (raw.schemaVersion !== 2 || !Array.isArray(raw.records)) {
+        throw new Error('Invalid plugin release ledger: expected schemaVersion 2 and records array.');
+    }
+    const byRecord = new Map();
+    const byIdentity = new Map();
+    for (const record of raw.records.map(validateRecord)) {
+        const duplicate = byRecord.get(recordKey(record));
+        if (duplicate) {
+            if (!sameDigests(duplicate, record))
+                throw new Error(`Plugin publication record for ${identityKey(record)} contains conflicting digests.`);
+            continue;
+        }
+        const identity = byIdentity.get(identityKey(record));
+        if (identity && !sameDigests(identity, record))
+            throw new Error(`Plugin release identity ${identityKey(record)} maps to different digests.`);
+        byRecord.set(recordKey(record), record);
+        byIdentity.set(identityKey(record), record);
+    }
+    return {
+        schemaVersion: 2,
+        records: [...byRecord.values()].sort((left, right) => left.plugin.localeCompare(right.plugin)
+            || compareStrictSemVer(left.version, right.version)
+            || left.channel.localeCompare(right.channel)
+            || compareStrictSemVer(left.catalogVersion, right.catalogVersion)),
+    };
+}
+export function validatePluginReleaseLedgerAgainstManifest(rawLedger, manifest) {
+    const ledger = validatePluginReleaseLedger(rawLedger);
+    for (const entry of manifest.entries) {
+        const records = ledger.records.filter((record) => record.plugin === entry.name
+            && record.version === entry.version
+            && record.channel === manifest.channel
+            && record.catalogVersion === manifest.catalogVersion);
+        if (records.length !== 1
+            || records[0].artifactDigest !== entry.artifactDigest
+            || records[0].manifestDigest !== entry.manifestDigest
+            || records[0].contentDigest !== entry.contentDigest) {
+            throw new Error(`Plugin release ledger does not match catalog entry ${entry.name}@${entry.version}.`);
+        }
+    }
+    const current = ledger.records.filter((record) => record.channel === manifest.channel
+        && record.catalogVersion === manifest.catalogVersion);
+    if (current.length !== manifest.entries.length) {
+        throw new Error('Plugin release ledger contains unexpected records for the current catalog.');
+    }
+    return ledger;
+}
+export function mergePluginReleaseLedgers(...ledgers) {
+    return validatePluginReleaseLedger({
+        schemaVersion: PLUGIN_RELEASE_LEDGER_SCHEMA_VERSION,
+        records: ledgers.flatMap((ledger) => ledger?.records ?? []),
+    });
+}
+export function resolveBetaPluginVersionOverrides(options) {
+    const ledger = validatePluginReleaseLedger(options.ledger);
+    const overrides = {};
+    for (const plugin of options.plugins) {
+        const name = plugin.manifest.name;
+        const target = assertStablePluginVersion(plugin.manifest.version, `${name} source version`);
+        const contentDigest = options.contentDigests.get(name);
+        if (!contentDigest)
+            throw new Error(`Missing release content digest for plugin ${JSON.stringify(name)}.`);
+        const stable = ledger.records.find((record) => record.plugin === name && record.version === target);
+        if (stable) {
+            if (stable.contentDigest !== contentDigest) {
+                throw new Error(`Plugin release identity ${name}@${target} maps to different content. Increase the source plugin version.`);
+            }
+            continue;
+        }
+        const prefix = `${target}-beta.`;
+        const betas = ledger.records.filter((record) => record.plugin === name && record.version.startsWith(prefix)
+            && /^\d+$/u.test(record.version.slice(prefix.length)));
+        const highest = betas.reduce((value, record) => Math.max(value, Number(record.version.slice(prefix.length))), 0);
+        const latest = betas.find((record) => Number(record.version.slice(prefix.length)) === highest);
+        overrides[name] = latest?.contentDigest === contentDigest ? latest.version : `${prefix}${highest + 1}`;
+    }
+    return overrides;
+}
+export function appendCatalogToPluginReleaseLedger(options) {
+    const previous = validatePluginReleaseLedger(options.previous);
+    const records = [...previous.records];
+    for (const entry of options.manifest.entries) {
+        const contentDigest = options.contentDigests.get(entry.name);
+        if (!contentDigest)
+            throw new Error(`Missing release content digest for plugin ${JSON.stringify(entry.name)}.`);
+        const candidate = {
+            plugin: entry.name,
+            version: entry.version,
+            contentDigest,
+            artifactDigest: entry.artifactDigest,
+            manifestDigest: entry.manifestDigest,
+            channel: options.manifest.channel,
+            catalogVersion: options.manifest.catalogVersion,
+        };
+        const exact = records.find((record) => recordKey(record) === recordKey(candidate));
+        const identity = records.find((record) => identityKey(record) === identityKey(candidate));
+        const highest = records.filter((record) => record.plugin === candidate.plugin)
+            .reduce((current, record) => !current
+            || compareStrictSemVer(record.version, current.version) > 0 ? record : current, null);
+        if (exact) {
+            if (!sameDigests(exact, candidate))
+                throw new Error(`Plugin publication record for ${identityKey(candidate)} contains conflicting digests.`);
+            continue;
+        }
+        if (identity && !sameDigests(identity, candidate))
+            throw new Error(`Plugin release identity ${identityKey(candidate)} maps to different digests.`);
+        if (highest && (identity
+            ? compareStrictSemVer(candidate.version, highest.version) < 0
+            : compareStrictSemVer(candidate.version, highest.version) <= 0)) {
+            throw new Error(identity
+                ? `Plugin ${candidate.plugin} version ${candidate.version} must not be lower than published ${highest.version}.`
+                : `Plugin ${candidate.plugin} version ${candidate.version} must be higher than published ${highest.version}.`);
+        }
+        records.push(candidate);
+    }
+    return validatePluginReleaseLedger({ schemaVersion: 2, records });
+}
+//# sourceMappingURL=plugin-release.js.map

package/dist/plugin-release.js.map

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

package/dist/plugin-script-contract.d.ts

@@ -0,0 +1,33 @@
+import type { PluginLifecycleRuntimeOs, PluginLifecycleScriptEntry, PluginLifecycleScriptRunner, PluginLifecycleScriptSelector } from './types.js';
+export declare const PLUGIN_LIFECYCLE_EVENTS: readonly ["install", "upgrade", "uninstall"];
+export declare const PLUGIN_LIFECYCLE_OS_SELECTORS: readonly ["default", "unix", "windows", "linux", "darwin", "win32"];
+export declare const PLUGIN_SCRIPT_RUNNERS: readonly ["node", "sh", "bash", "pwsh", "powershell", "cmd", "auto"];
+export declare const PLUGIN_AUTO_RUNNER_EXTENSIONS: readonly [".js", ".mjs", ".cjs", ".sh", ".ps1", ".cmd", ".bat"];
+export declare const PLUGIN_SCRIPT_TIMEOUT_DEFAULT_MS = 30000;
+export declare const PLUGIN_SCRIPT_TIMEOUT_MIN_MS = 1000;
+export declare const PLUGIN_SCRIPT_TIMEOUT_MAX_MS = 300000;
+export declare function isPluginLifecycleOsSelector(value: string): boolean;
+export declare function isPluginScriptRunner(value: string): value is PluginLifecycleScriptRunner;
+export declare function getLifecycleSelectorOrder(os: PluginLifecycleRuntimeOs): readonly string[];
+export declare function resolveLifecycleScriptForOs(selector: PluginLifecycleScriptSelector, os: PluginLifecycleRuntimeOs): PluginLifecycleScriptEntry | undefined;
+export declare function inferLifecycleScriptRunnerFromPath(scriptPath: string): Exclude<PluginLifecycleScriptRunner, 'auto'> | undefined;
+export interface ImportSpecifierReference {
+    specifier: string;
+    kind: 'import' | 'export' | 'require' | 'require-resolve' | 'dynamic-import';
+    dynamic?: true;
+}
+export declare function scanJavaScriptImportSpecifiers(source: string): ImportSpecifierReference[];
+export interface NodeImportContractScanOptions {
+    files: Record<string, string>;
+    filePaths?: readonly string[];
+    entryFiles: string[];
+    dependencies?: readonly string[];
+    devDependencies?: readonly string[];
+    allowDevDependencies?: boolean;
+}
+export interface NodeImportContractScanResult {
+    files: string[];
+    bareSpecifiers: string[];
+    errors: string[];
+}
+export declare function scanNodeImportContract(options: NodeImportContractScanOptions): NodeImportContractScanResult;