mirror of
https://github.com/getpaseo/paseo.git
synced 2026-10-23 09:42:53 +00:00
Mohamed Boudra
047f40e623
* feat(plugins): unify source installation and simplify plugin settings * feat(plugins): install npm sources and review CLI updates Treat install selectors as one-time choices. Keep source identity separate from the installed revision, and resolve ordinary updates from the current upstream default. npm only acquires directories; plugin loading remains independent of npm. * fix(plugins): preserve CLI diagnostics and exercise reviewed updates Move new source capability coverage to real browser journeys. Update the requirements regression to exercise preview and apply, and preserve the existing duplicate-selector diagnostic across positional option scopes. * test(plugins): remove unused pending helper * test(plugins): pack registry fixtures with the Windows command runner * test(plugins): assert failed client contribution setup * docs(plugins): consolidate guides and document npm publishing * docs(plugins): introduce publishing choices before npm instructions * test(plugins): own browser journey cleanup in a fixture * feat(plugins): prepare scaffolded packages for publishing
42 lines
1.9 KiB
TypeScript
42 lines
1.9 KiB
TypeScript
import type { PluginRequirements } from "./messages.js";
|
|
import parse from "semver/functions/parse.js";
|
|
import validRange from "semver/ranges/valid.js";
|
|
import satisfies from "semver/functions/satisfies.js";
|
|
|
|
export function validatePluginRequirements(requirements: PluginRequirements | undefined): void {
|
|
const range = requirements?.paseo;
|
|
if (range !== undefined && (!range.trim() || validRange(range) === null)) {
|
|
throw new Error(
|
|
`Invalid requirements.paseo: ${JSON.stringify(range)}. Use an npm semver range such as ">=0.8.0".`,
|
|
);
|
|
}
|
|
}
|
|
|
|
interface PluginCompatibilityInput {
|
|
id: string;
|
|
requirements?: PluginRequirements;
|
|
version: string | null;
|
|
runtime: "daemon" | "app";
|
|
}
|
|
|
|
export function assertPluginCompatibility(input: PluginCompatibilityInput): void {
|
|
validatePluginRequirements(input.requirements);
|
|
// COMPAT(plugin-requirements): added in v0.8.0-beta.1; remove after 2027-03-07 once pre-0.8 plugins and catalogs are unsupported. The legacy range excludes 0.8 prereleases and their stable core.
|
|
const range = input.requirements?.paseo ?? "<0.8.0";
|
|
const version = input.version ? parse(input.version) : null;
|
|
if (!version) {
|
|
throw new Error(
|
|
`Cannot check plugin "${input.id}" requirements: Paseo ${input.runtime} version is unknown. Update the ${input.runtime}.`,
|
|
);
|
|
}
|
|
const stableCore = `${version.major}.${version.minor}.${version.patch}`;
|
|
if (satisfies(version, range) || satisfies(stableCore, range)) return;
|
|
const action =
|
|
input.requirements?.paseo === undefined
|
|
? "This plugin has no requirements.paseo and targets Paseo before 0.8. Ask its author to migrate it: https://paseo.sh/docs/plugins/migration"
|
|
: `Use a compatible plugin version or update the ${input.runtime}.`;
|
|
throw new Error(
|
|
`Plugin "${input.id}" requires Paseo ${range}. Your ${input.runtime} is ${input.version}. ${action}`,
|
|
);
|
|
}
|