paperkite 0.1.3 → 0.2.0

package/dist/src/extensions/manifest.js

@@ -0,0 +1,272 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { CORE_POLICY, evaluateCompatibility, sdkDeclarations } from "./abi.js";
+import { compareVersions, isStableVersion, satisfiesRange } from "./semver.js";
+import { paperkiteHome } from "../config/paths.js";
+import { coreRoot } from "./loader.js";
+export const defaultFetch = (url, init) => fetch(url, init);
+/** core 随包携带的离线快照；读取失败按空清单处理。 */
+export async function readSnapshot(file = join(coreRoot(), "bundles.json")) {
+    try {
+        const document = JSON.parse(await readFile(file, "utf8"));
+        const parsed = parseManifestDocument(document);
+        return { ...parsed, origin: "snapshot", warnings: [] };
+    }
+    catch (error) {
+        return {
+            name: "",
+            origin: "snapshot",
+            dependencies: {},
+            warnings: ["built-in bundle snapshot is unreadable: " + detailOf(error)]
+        };
+    }
+}
+export function parseManifestDocument(document) {
+    if (!isRecord(document))
+        throw new Error("bundle manifest is not an object");
+    const name = typeof document.name === "string" ? document.name : "";
+    const version = typeof document.version === "string" ? document.version : undefined;
+    const dependencies = parseDependencyRecord(document.dependencies);
+    if (!Object.keys(dependencies).length)
+        throw new Error("bundle manifest declares no dependencies");
+    return { name, version, dependencies };
+}
+export async function readBundleManifest(options) {
+    const settings = options.settings;
+    const source = settings.manifest.trim();
+    const snapshot = await readSnapshot();
+    if (!source) {
+        return { ...snapshot, warnings: ["no bundle manifest configured; using the built-in snapshot"] };
+    }
+    const cacheFile = join(cacheDirectory(options), "bundle-manifest.json");
+    const cached = await readJson(cacheFile);
+    const usable = cached && cached.source === source ? cached : undefined;
+    if (options.offline) {
+        return usable
+            ? { ...usable, origin: "cache", warnings: [] }
+            : { ...snapshot, warnings: ["offline: using the built-in snapshot for " + source] };
+    }
+    if (usable && !options.refresh && fresh(usable.fetchedAt, settings.manifestTtlHours, options.now)) {
+        return { ...usable, origin: "cache", warnings: [] };
+    }
+    try {
+        const response = await request(source, settings, usable?.etag, options.fetch ?? defaultFetch);
+        if (response.status === 304 && usable) {
+            const refreshed = { ...usable, fetchedAt: new Date().toISOString() };
+            await writeJson(cacheFile, refreshed);
+            return { ...refreshed, origin: "cache", warnings: [] };
+        }
+        if (!response.ok)
+            throw new Error("HTTP " + response.status);
+        const parsed = parseManifestDocument(response.document);
+        await writeJson(cacheFile, {
+            source,
+            etag: response.etag,
+            fetchedAt: new Date().toISOString(),
+            name: parsed.name,
+            version: parsed.version,
+            dependencies: parsed.dependencies
+        });
+        return { ...parsed, origin: "online", warnings: [] };
+    }
+    catch (error) {
+        const detail = detailOf(error);
+        if (usable) {
+            return {
+                ...usable,
+                origin: "cache",
+                warnings: ["bundle manifest refresh failed (" + detail + "); using the cached manifest"]
+            };
+        }
+        return {
+            ...snapshot,
+            warnings: ["bundle manifest unavailable (" + detail + "); using the built-in snapshot"]
+        };
+    }
+}
+async function request(source, settings, etag, fetcher) {
+    const headers = etag ? { "if-none-match": etag } : {};
+    if (isHttpSource(source)) {
+        const response = await fetcher(source, { headers: { ...headers, accept: "application/json" } });
+        return {
+            ok: response.ok,
+            status: response.status,
+            etag: response.headers.get("etag") ?? undefined,
+            document: response.ok ? await response.json() : undefined
+        };
+    }
+    const response = await fetcher(registryUrl(settings.registry, source), {
+        headers: { ...headers, accept: "application/vnd.npm.install-v1+json" }
+    });
+    if (response.status === 304)
+        return { ok: false, status: 304, etag };
+    if (!response.ok)
+        return { ok: false, status: response.status };
+    return {
+        ok: true,
+        status: response.status,
+        etag: response.headers.get("etag") ?? undefined,
+        document: latestRelease(parsePackument(await response.json()))
+    };
+}
+/** 插件版本的 packument；离线时只读缓存。 */
+export async function readPackument(name, options) {
+    const cacheFile = join(cacheDirectory(options), "packuments", safeName(name) + ".json");
+    const cached = await readJson(cacheFile);
+    if (options.offline) {
+        if (cached)
+            return cached.packument;
+        throw new Error("offline: no cached packument for " + name);
+    }
+    if (cached && !options.refresh && fresh(cached.fetchedAt, options.settings.manifestTtlHours, options.now)) {
+        return cached.packument;
+    }
+    const fetcher = options.fetch ?? defaultFetch;
+    const full = (options.release?.minimumReleaseAgeMinutes ?? 0) > 0;
+    const response = await fetcher(registryUrl(options.settings.registry, name), {
+        headers: { accept: full ? "application/json" : "application/vnd.npm.install-v1+json" }
+    });
+    if (!response.ok)
+        throw new Error("HTTP " + response.status + " for " + name);
+    const packument = parsePackument(await response.json());
+    await writeJson(cacheFile, { fetchedAt: new Date().toISOString(), packument });
+    return packument;
+}
+/** 范围内满足 ABI 的最高稳定版；被 core 拒绝的版本排除。 */
+export function selectPluginVersion(packument, range, options = {}) {
+    const policy = options.policy ?? CORE_POLICY;
+    const release = options.release;
+    const now = (options.now ?? Date.now)();
+    const candidates = Object.entries(packument.versions)
+        .filter(([version]) => isStableVersion(version) && satisfiesRange(version, range))
+        .sort(([left], [right]) => compareVersions(right, left));
+    for (const [version, manifest] of candidates) {
+        if (release && excludedByAge(version, options.name, packument, release, now))
+            continue;
+        const verdict = evaluateCompatibility(sdkDeclarations(manifest), policy);
+        if (verdict.verdict === "reject")
+            continue;
+        return { version, verdict };
+    }
+    return undefined;
+}
+function excludedByAge(version, name, packument, release, now) {
+    if (!release.minimumReleaseAgeMinutes)
+        return false;
+    if (name && release.exclude.includes(name))
+        return false;
+    const published = packument.time[version];
+    if (!published)
+        return true;
+    const at = Date.parse(published);
+    if (!Number.isFinite(at))
+        return true;
+    return now - at < release.minimumReleaseAgeMinutes * 60_000;
+}
+/** 清单 scope 之外的名字跳过；默认只接受 `@paperkite/`。 */
+export function filterScopes(dependencies, scopes) {
+    const accepted = {};
+    const skipped = [];
+    for (const [name, range] of Object.entries(dependencies)) {
+        if (scopes.some((scope) => name.startsWith(scope)))
+            accepted[name] = range;
+        else
+            skipped.push(name);
+    }
+    return { accepted, skipped };
+}
+/** 与 pnpm 对齐的供应链延迟设置，取自 profile 的 pnpm-workspace.yaml。 */
+export async function readReleasePolicy(directory) {
+    try {
+        const data = parseYaml(await readFile(join(directory, "pnpm-workspace.yaml"), "utf8"));
+        if (!isRecord(data))
+            return { minimumReleaseAgeMinutes: 0, exclude: [] };
+        const age = Number(data.minimumReleaseAge ?? 0);
+        const exclude = Array.isArray(data.minimumReleaseAgeExclude)
+            ? data.minimumReleaseAgeExclude.filter((item) => typeof item === "string")
+            : [];
+        return {
+            minimumReleaseAgeMinutes: Number.isFinite(age) && age > 0 ? age : 0,
+            exclude
+        };
+    }
+    catch {
+        return { minimumReleaseAgeMinutes: 0, exclude: [] };
+    }
+}
+export function cacheDirectory(options = {}) {
+    return options.cacheDir ?? join(paperkiteHome(), "cache");
+}
+function registryUrl(registry, name) {
+    const base = (registry.trim() || "https://registry.npmjs.org").replace(/\/+$/, "");
+    return base + "/" + encodeURIComponent(name);
+}
+function isHttpSource(source) {
+    return /^https?:\/\//i.test(source);
+}
+function parsePackument(document) {
+    if (!isRecord(document))
+        throw new Error("packument is not an object");
+    const versions = isRecord(document.versions) ? document.versions : {};
+    const distTags = isRecord(document["dist-tags"])
+        ? Object.fromEntries(Object.entries(document["dist-tags"]).filter((entry) => typeof entry[1] === "string"))
+        : {};
+    const time = isRecord(document.time)
+        ? Object.fromEntries(Object.entries(document.time).filter((entry) => typeof entry[1] === "string"))
+        : {};
+    return {
+        name: typeof document.name === "string" ? document.name : undefined,
+        versions,
+        distTags,
+        time
+    };
+}
+function latestRelease(packument) {
+    const latest = packument.distTags.latest;
+    const entry = latest ? packument.versions[latest] : undefined;
+    if (!entry)
+        throw new Error("packument declares no latest release");
+    const dependencies = parseDependencyRecord(entry.dependencies);
+    if (!Object.keys(dependencies).length)
+        throw new Error("latest release declares no dependencies");
+    return { name: packument.name ?? "", version: entry.version ?? latest, dependencies };
+}
+function parseDependencyRecord(value) {
+    if (!isRecord(value))
+        return {};
+    const dependencies = {};
+    for (const [name, range] of Object.entries(value)) {
+        if (typeof range === "string" && range.trim())
+            dependencies[name] = range.trim();
+    }
+    return dependencies;
+}
+function fresh(fetchedAt, ttlHours, now = Date.now) {
+    const at = Date.parse(fetchedAt);
+    if (!Number.isFinite(at))
+        return false;
+    return now() - at < Math.max(0, ttlHours) * 3_600_000;
+}
+async function readJson(file) {
+    try {
+        return JSON.parse(await readFile(file, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeJson(file, value) {
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(file, JSON.stringify(value, null, 2) + "\n", "utf8");
+}
+function safeName(name) {
+    return name.replace(/[^0-9A-Za-z._-]+/g, "-");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function detailOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/src/extensions/manifest.js.map

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

package/dist/src/extensions/profile.d.ts

@@ -8,9 +8,14 @@ export interface ProfileManifest {
     readonly paperkite?: {
         readonly profile?: {
             readonly plugins?: readonly string[];
+            readonly bundles?: Readonly<Record<string, string>>;
         };
     };
     [key: string]: unknown;
 }
+/** 由清单管理的插件与范围；sync 只管理这一段。 */
+export declare function bundleRanges(manifest: ProfileManifest): Record<string, string>;
+/** 用户显式安装的插件名，清单接管的同名条目不再计入。 */
+export declare function userPlugins(manifest: ProfileManifest): readonly string[];
 export declare function readProfile(directory: string): Promise<ProfileManifest>;
 export declare function writeProfile(directory: string, value: ProfileManifest): Promise<void>;

package/dist/src/extensions/profile.js

@@ -9,7 +9,7 @@ export function defaultProfileManifest(profile) {
         private: true,
         type: "module",
         dependencies: {},
-        paperkite: { profile: { plugins: [] } }
+        paperkite: { profile: { plugins: [], bundles: {} } }
     };
 }
 export function profileDirectory(profile = "default") {
@@ -30,6 +30,26 @@ export async function ensureProfile(profile = "default") {
     }
     return directory;
 }
+/** 由清单管理的插件与范围；sync 只管理这一段。 */
+export function bundleRanges(manifest) {
+    const bundles = manifest.paperkite?.profile?.bundles;
+    if (typeof bundles !== "object" || bundles === null || Array.isArray(bundles))
+        return {};
+    const ranges = {};
+    for (const [name, range] of Object.entries(bundles)) {
+        if (typeof range === "string" && range.trim())
+            ranges[name] = range.trim();
+    }
+    return ranges;
+}
+/** 用户显式安装的插件名，清单接管的同名条目不再计入。 */
+export function userPlugins(manifest) {
+    const declared = manifest.paperkite?.profile?.plugins;
+    if (!Array.isArray(declared))
+        return [];
+    const managed = new Set(Object.keys(bundleRanges(manifest)));
+    return declared.filter((name) => typeof name === "string" && Boolean(name.trim()) && !managed.has(name));
+}
 export async function readProfile(directory) {
     try {
         const data = JSON.parse(await readFile(join(directory, "package.json"), "utf8"));

package/dist/src/extensions/profile.js.map

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

package/dist/src/extensions/semver.d.ts

@@ -0,0 +1,25 @@
+export interface Version {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly prerelease: readonly (number | string)[];
+}
+export type Operator = ">" | ">=" | "<" | "<=" | "=";
+export interface Comparator {
+    readonly op: Operator;
+    readonly version: Version;
+}
+export type ComparatorSet = readonly Comparator[];
+export type Range = readonly ComparatorSet[];
+export declare function parseVersion(text: string): Version | undefined;
+export declare function parseRange(text: string): Range | undefined;
+export declare function satisfies(range: Range, current: Version): boolean;
+export declare function compare(left: Version, right: Version): number;
+/** 范围为插件接受的 ABI 代际上限；无上限时取所需的最低代际。 */
+export declare function rangeAbi(range: Range): number;
+/** 版本是否落在范围内；任一侧无法解析都视为不满足。 */
+export declare function satisfiesRange(version: string, range: string): boolean;
+export declare function compareVersions(left: string, right: string): number;
+/** 预发布版本不参与选择。 */
+export declare function isStableVersion(version: string): boolean;
+export declare function maxSatisfying(versions: readonly string[], range: string): string | undefined;

package/dist/src/extensions/semver.js

@@ -0,0 +1,260 @@
+const VERSION_PATTERN = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+const PARTIAL_PATTERN = /^v?(\d+|[xX*])(?:\.(\d+|[xX*]))?(?:\.(\d+|[xX*]))?(?:-([0-9A-Za-z.-]+))?$/;
+const COMPARATOR_PATTERN = /^(>=|<=|>|<|=|\^|~>|~)?(.+)$/;
+export function parseVersion(text) {
+    const match = VERSION_PATTERN.exec(text);
+    if (!match?.[1] || !match[2] || !match[3])
+        return undefined;
+    return version(Number(match[1]), Number(match[2]), Number(match[3]), identifiers(match[4]));
+}
+function version(major, minor, patch, prerelease = []) {
+    return { major, minor, patch, prerelease };
+}
+function identifiers(text) {
+    if (!text)
+        return [];
+    return text.split(".").map((part) => (/^\d+$/.test(part) ? Number(part) : part));
+}
+function component(token) {
+    if (token === undefined)
+        return undefined;
+    if (token === "*" || token === "x" || token === "X")
+        return "*";
+    return /^\d+$/.test(token) ? Number(token) : undefined;
+}
+function parsePartial(text) {
+    const match = PARTIAL_PATTERN.exec(text);
+    if (!match)
+        return undefined;
+    const major = component(match[1]);
+    const minor = component(match[2]);
+    const patch = component(match[3]);
+    if (typeof major !== "number")
+        return undefined;
+    if (minor === undefined && match[2] !== undefined)
+        return undefined;
+    if (patch === undefined && match[3] !== undefined)
+        return undefined;
+    if (minor === "*" && typeof patch === "number")
+        return undefined;
+    const prerelease = identifiers(match[4]);
+    if (prerelease.length && typeof patch !== "number")
+        return undefined;
+    return {
+        major,
+        minor: minor === "*" ? undefined : minor,
+        patch: patch === "*" ? undefined : patch,
+        prerelease
+    };
+}
+function expand(op, partial) {
+    const { major, minor, patch, prerelease } = partial;
+    const atLeast = () => ({
+        op: ">=",
+        version: version(major, minor ?? 0, patch ?? 0, prerelease)
+    });
+    const below = (value, middle = 0, last = 0) => ({
+        op: "<",
+        version: version(value, middle, last)
+    });
+    const at = (value, middle = 0, last = 0) => ({
+        op: ">=",
+        version: version(value, middle, last)
+    });
+    const exact = (operator) => [
+        { op: operator, version: version(major, minor ?? 0, patch ?? 0, prerelease) }
+    ];
+    switch (op) {
+        case ">":
+            if (patch !== undefined)
+                return exact(">");
+            if (minor !== undefined)
+                return [at(major, minor + 1)];
+            return [at(major + 1)];
+        case ">=":
+            return [atLeast()];
+        case "<":
+            if (patch !== undefined)
+                return exact("<");
+            return [below(major, minor ?? 0)];
+        case "<=":
+            if (patch !== undefined)
+                return exact("<=");
+            if (minor !== undefined)
+                return [below(major, minor + 1)];
+            return [below(major + 1)];
+        case "^":
+            if (major > 0)
+                return [atLeast(), below(major + 1)];
+            if (minor === undefined)
+                return [atLeast(), below(1)];
+            if (minor > 0)
+                return [atLeast(), below(0, minor + 1)];
+            if (patch !== undefined)
+                return [atLeast(), below(0, 0, patch + 1)];
+            return [atLeast(), below(0, 1)];
+        case "~":
+        case "~>":
+            if (minor === undefined)
+                return [atLeast(), below(major + 1)];
+            return [atLeast(), below(major, minor + 1)];
+        case "=":
+        case undefined:
+            if (patch !== undefined)
+                return exact("=");
+            if (minor !== undefined)
+                return [atLeast(), below(major, minor + 1)];
+            return [atLeast(), below(major + 1)];
+        default:
+            return undefined;
+    }
+}
+export function parseRange(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return undefined;
+    const sets = [];
+    for (const clause of trimmed.split("||")) {
+        const hyphen = /^(.+?)\s+-\s+(.+)$/.exec(clause.trim());
+        if (hyphen?.[1] && hyphen[2]) {
+            const from = parsePartial(hyphen[1]);
+            const to = parsePartial(hyphen[2]);
+            if (!from || !to)
+                return undefined;
+            const lower = expand(">=", from);
+            const upper = expand("<=", to);
+            if (!lower || !upper)
+                return undefined;
+            sets.push([...lower, ...upper]);
+            continue;
+        }
+        const comparators = [];
+        const normalized = clause.trim().replace(/(>=|<=|>|<|=|\^|~>|~)\s+/g, "$1");
+        for (const token of normalized.split(/\s+/)) {
+            if (!token)
+                continue;
+            const match = COMPARATOR_PATTERN.exec(token);
+            if (!match?.[2])
+                return undefined;
+            const partial = parsePartial(match[2]);
+            if (!partial)
+                return undefined;
+            const expanded = expand(match[1], partial);
+            if (!expanded)
+                return undefined;
+            comparators.push(...expanded);
+        }
+        if (!comparators.length)
+            return undefined;
+        sets.push(comparators);
+    }
+    return sets.length ? sets : undefined;
+}
+export function satisfies(range, current) {
+    return range.some((set) => set.every((comparator) => holds(comparator, current)));
+}
+function holds(comparator, current) {
+    const order = compare(current, comparator.version);
+    switch (comparator.op) {
+        case "=":
+            return order === 0;
+        case ">":
+            return order > 0;
+        case ">=":
+            return order >= 0;
+        case "<":
+            return order < 0;
+        case "<=":
+            return order <= 0;
+    }
+}
+export function compare(left, right) {
+    if (left.major !== right.major)
+        return left.major < right.major ? -1 : 1;
+    if (left.minor !== right.minor)
+        return left.minor < right.minor ? -1 : 1;
+    if (left.patch !== right.patch)
+        return left.patch < right.patch ? -1 : 1;
+    return comparePrerelease(left.prerelease, right.prerelease);
+}
+function comparePrerelease(left, right) {
+    if (!left.length || !right.length)
+        return left.length === right.length ? 0 : left.length ? -1 : 1;
+    const length = Math.max(left.length, right.length);
+    for (let index = 0; index < length; index += 1) {
+        const a = left[index];
+        const b = right[index];
+        if (a === undefined)
+            return -1;
+        if (b === undefined)
+            return 1;
+        if (a === b)
+            continue;
+        if (typeof a === "number" && typeof b === "number")
+            return a < b ? -1 : 1;
+        if (typeof a === "number")
+            return -1;
+        if (typeof b === "number")
+            return 1;
+        return a < b ? -1 : 1;
+    }
+    return 0;
+}
+/** 范围为插件接受的 ABI 代际上限；无上限时取所需的最低代际。 */
+export function rangeAbi(range) {
+    let abi = 0;
+    for (const set of range) {
+        let lowest = 0;
+        let highest;
+        for (const comparator of set) {
+            if (comparator.op === "<") {
+                highest = Math.min(highest ?? Number.POSITIVE_INFINITY, majorBelow(comparator.version));
+            }
+            else if (comparator.op === "<=") {
+                highest = Math.min(highest ?? Number.POSITIVE_INFINITY, comparator.version.major);
+            }
+            else {
+                lowest = Math.max(lowest, comparator.version.major);
+            }
+        }
+        abi = Math.max(abi, highest ?? lowest);
+    }
+    return abi;
+}
+function majorBelow(version) {
+    return version.minor === 0 && version.patch === 0 ? Math.max(0, version.major - 1) : version.major;
+}
+/** 版本是否落在范围内；任一侧无法解析都视为不满足。 */
+export function satisfiesRange(version, range) {
+    const current = parseVersion(version);
+    const parsed = parseRange(range);
+    if (!current || !parsed)
+        return false;
+    return satisfies(parsed, current);
+}
+export function compareVersions(left, right) {
+    const a = parseVersion(left);
+    const b = parseVersion(right);
+    if (!a || !b)
+        return 0;
+    return compare(a, b);
+}
+/** 预发布版本不参与选择。 */
+export function isStableVersion(version) {
+    const parsed = parseVersion(version);
+    return parsed !== undefined && parsed.prerelease.length === 0;
+}
+export function maxSatisfying(versions, range) {
+    const parsed = parseRange(range);
+    if (!parsed)
+        return undefined;
+    const candidates = [];
+    for (const text of versions) {
+        const current = parseVersion(text);
+        if (current && !current.prerelease.length && satisfies(parsed, current))
+            candidates.push({ text, version: current });
+    }
+    candidates.sort((left, right) => compare(right.version, left.version));
+    return candidates[0]?.text;
+}
+//# sourceMappingURL=semver.js.map