@fnndsc/salsa 4.4.3 → 4.5.0

package/dist/plugins/plugin_validate.d.ts

@@ -0,0 +1,224 @@
+/**
+ * @file Checking plugin descriptors before any CUBE sees them.
+ *
+ * Five rules, cheapest first, each failure naming the file and the rule:
+ *
+ * 1. the index's own JSON Schema (`schema/plugin.schema.json`), so the
+ *    schema has one home and this check follows it without a release;
+ * 2. CUBE's administrative upload rules (ChRIS_ultron_backEnd
+ *    `plugins/admin.py`): a JSON object, required descriptors, a dotted-number version,
+ *    the upload's parameter types (`str|int|float|bool|path|unextpath`,
+ *    not the read API's `string|integer|boolean`), an optional parameter
+ *    carries a default and is never a path, a required one is exposed;
+ * 3. the file is named for the plugin (`<name>.json`);
+ * 4. no two names differ only in case;
+ * 5. every `dock_image` resolves anonymously on its registry, digests too.
+ *
+ * Rules 1–4 read nothing but the descriptors. Rule 5 asks registries, four
+ * at a time; a registry that cannot be reached is a failure, never a pass.
+ * A rule that was not run says so (`not checked, no schema`; `not checked,
+ * --offline`), so a clean report never hides an unchecked rule.
+ *
+ * Key components:
+ * - ValidateFinding: one failure, its file, rule and reason.
+ * - ValidateRuleState: whether a rule ran, and how many files it failed.
+ * - ValidateReport: the findings and the rules' states for an index.
+ * - DescriptorChecked: one descriptor, parsed, with its local findings.
+ * - descriptors_checkLocal: rules 1–4 over an index's descriptors.
+ * - pluginIndex_validate: all five rules over an index.
+ * - imageReference_parse / image_resolve: rule 5's registry lookup.
+ *
+ * Typical usage:
+ * ```ts
+ * const report: ValidateReport = await pluginIndex_validate(index, { offline: false });
+ * if (!report.ok) report.findings.forEach((f: ValidateFinding): void => console.log(f.file, f.message));
+ * ```
+ *
+ * Dependencies: `ajv` (draft 2020-12 build) for rule 1; `fetch` for rule 5.
+ *
+ * @module
+ */
+import type { PluginIndex } from './plugin_index.js';
+/** The rules, by number, as the report names them. */
+export declare const VALIDATE_RULES: Readonly<Record<ValidateRuleNumber, string>>;
+/** A rule's number. */
+export type ValidateRuleNumber = 1 | 2 | 3 | 4 | 5;
+/**
+ * One failure.
+ *
+ * @example
+ * ```ts
+ * const finding: ValidateFinding = { file: 'pl-x.json', rule: 3, message: "named 'pl-y'" };
+ * ```
+ */
+export interface ValidateFinding {
+    /** The descriptor file. */
+    readonly file: string;
+    /** The rule it fails. */
+    readonly rule: ValidateRuleNumber;
+    /** Why, in a line. */
+    readonly message: string;
+}
+/**
+ * What one rule did.
+ *
+ * @example
+ * ```ts
+ * const state: ValidateRuleState = { rule: 5, title: 'images resolve', checked: false, note: '--offline', failed: 0 };
+ * ```
+ */
+export interface ValidateRuleState {
+    /** The rule. */
+    readonly rule: ValidateRuleNumber;
+    /** Its title. */
+    readonly title: string;
+    /** Whether it ran. */
+    readonly checked: boolean;
+    /** Why it did not run, when it did not. */
+    readonly note?: string;
+    /** How many files it failed. */
+    readonly failed: number;
+}
+/**
+ * The report on an index.
+ *
+ * @example
+ * ```ts
+ * const report: ValidateReport = await pluginIndex_validate(index, { offline: true });
+ * report.ok;
+ * ```
+ */
+export interface ValidateReport {
+    /** The index's short name. */
+    readonly label: string;
+    /** The commit read, when known. */
+    readonly commit: string | null;
+    /** How many descriptor files were read. */
+    readonly descriptors: number;
+    /** Every failure, by file then rule. */
+    readonly findings: ValidateFinding[];
+    /** Each rule's state, in order. */
+    readonly rules: ValidateRuleState[];
+    /** True when no rule that ran failed a file. */
+    readonly ok: boolean;
+}
+/**
+ * One descriptor, parsed, with what rules 1–4 found in it.
+ *
+ * @example
+ * ```ts
+ * const [checked] = descriptors_checkLocal(index).descriptors;
+ * checked.findings.length === 0;
+ * ```
+ */
+export interface DescriptorChecked {
+    /** The file. */
+    readonly file: string;
+    /** The file's text. */
+    readonly text: string;
+    /** The parsed descriptor, or null when the file is not a JSON object. */
+    readonly data: Record<string, unknown> | null;
+    /** Rules 1–4's failures for this file. */
+    readonly findings: ValidateFinding[];
+}
+/**
+ * Rules 1–4 over an index.
+ *
+ * @example
+ * ```ts
+ * const local: LocalCheck = descriptors_checkLocal(index);
+ * local.schemaChecked;
+ * ```
+ */
+export interface LocalCheck {
+    /** Each descriptor with its findings, in file order. */
+    readonly descriptors: DescriptorChecked[];
+    /** Whether rule 1 ran (the index carried a schema). */
+    readonly schemaChecked: boolean;
+}
+/**
+ * What rule 5 needs to know.
+ *
+ * @example
+ * ```ts
+ * const options: ValidateOptions = { offline: false };
+ * ```
+ */
+export interface ValidateOptions {
+    /** Skip rule 5, saying so. */
+    readonly offline: boolean;
+    /** The fetch rule 5 uses; the global one by default. */
+    readonly fetcher?: typeof fetch;
+}
+/**
+ * A parsed image reference.
+ *
+ * @example
+ * ```ts
+ * imageReference_parse('fnndsc/pl-dircopy:2.1.1');
+ * // { registry: 'registry-1.docker.io', repository: 'fnndsc/pl-dircopy', reference: '2.1.1' }
+ * ```
+ */
+export interface ImageReference {
+    /** The registry host to ask. */
+    readonly registry: string;
+    /** The repository path on it. */
+    readonly repository: string;
+    /** The digest when the reference pins one, else the tag. */
+    readonly reference: string;
+}
+/**
+ * Runs rules 1–4 over an index's descriptors.
+ *
+ * @param index - The index.
+ * @returns Each descriptor parsed, with its findings, and whether rule 1 ran.
+ * @throws {Error} When the index's schema does not compile.
+ *
+ * @example
+ * ```ts
+ * const local: LocalCheck = descriptors_checkLocal(index);
+ * local.descriptors.filter((d: DescriptorChecked): boolean => d.findings.length > 0);
+ * ```
+ */
+export declare function descriptors_checkLocal(index: PluginIndex): LocalCheck;
+/**
+ * Runs all five rules over an index.
+ *
+ * @param index - The index.
+ * @param options - Whether to skip rule 5, and the fetch it uses.
+ * @returns The report.
+ * @throws {Error} When the index's schema does not compile.
+ *
+ * @example
+ * ```ts
+ * const report: ValidateReport = await pluginIndex_validate(index, { offline: false });
+ * ```
+ */
+export declare function pluginIndex_validate(index: PluginIndex, options: ValidateOptions): Promise<ValidateReport>;
+/**
+ * Parses an image reference into what a registry lookup needs.
+ *
+ * @param image - The reference (`[registry/]repo[:tag][@sha256:…]`).
+ * @returns The registry host, repository and reference; null when unreadable.
+ *
+ * @example
+ * ```ts
+ * imageReference_parse('ghcr.io/fnndsc/pl-x:1.0@sha256:ab…'); // reference is the digest
+ * ```
+ */
+export declare function imageReference_parse(image: string): ImageReference | null;
+/**
+ * Asks an image's registry, anonymously, whether its manifest is there.
+ *
+ * Follows the registry's anonymous bearer-token challenge when it sends one.
+ *
+ * @param image - The image reference.
+ * @param fetcher - The fetch to use.
+ * @returns Null when the manifest resolves; else why not, in a few words.
+ *
+ * @example
+ * ```ts
+ * await image_resolve('docker.io/library/alpine:3.20', fetch); // null
+ * ```
+ */
+export declare function image_resolve(image: string, fetcher: typeof fetch): Promise<string | null>;

package/dist/plugins/plugin_validate.js

@@ -0,0 +1,395 @@
+"use strict";
+/**
+ * @file Checking plugin descriptors before any CUBE sees them.
+ *
+ * Five rules, cheapest first, each failure naming the file and the rule:
+ *
+ * 1. the index's own JSON Schema (`schema/plugin.schema.json`), so the
+ *    schema has one home and this check follows it without a release;
+ * 2. CUBE's administrative upload rules (ChRIS_ultron_backEnd
+ *    `plugins/admin.py`): a JSON object, required descriptors, a dotted-number version,
+ *    the upload's parameter types (`str|int|float|bool|path|unextpath`,
+ *    not the read API's `string|integer|boolean`), an optional parameter
+ *    carries a default and is never a path, a required one is exposed;
+ * 3. the file is named for the plugin (`<name>.json`);
+ * 4. no two names differ only in case;
+ * 5. every `dock_image` resolves anonymously on its registry, digests too.
+ *
+ * Rules 1–4 read nothing but the descriptors. Rule 5 asks registries, four
+ * at a time; a registry that cannot be reached is a failure, never a pass.
+ * A rule that was not run says so (`not checked, no schema`; `not checked,
+ * --offline`), so a clean report never hides an unchecked rule.
+ *
+ * Key components:
+ * - ValidateFinding: one failure, its file, rule and reason.
+ * - ValidateRuleState: whether a rule ran, and how many files it failed.
+ * - ValidateReport: the findings and the rules' states for an index.
+ * - DescriptorChecked: one descriptor, parsed, with its local findings.
+ * - descriptors_checkLocal: rules 1–4 over an index's descriptors.
+ * - pluginIndex_validate: all five rules over an index.
+ * - imageReference_parse / image_resolve: rule 5's registry lookup.
+ *
+ * Typical usage:
+ * ```ts
+ * const report: ValidateReport = await pluginIndex_validate(index, { offline: false });
+ * if (!report.ok) report.findings.forEach((f: ValidateFinding): void => console.log(f.file, f.message));
+ * ```
+ *
+ * Dependencies: `ajv` (draft 2020-12 build) for rule 1; `fetch` for rule 5.
+ *
+ * @module
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALIDATE_RULES = void 0;
+exports.descriptors_checkLocal = descriptors_checkLocal;
+exports.pluginIndex_validate = pluginIndex_validate;
+exports.imageReference_parse = imageReference_parse;
+exports.image_resolve = image_resolve;
+const _2020_1 = __importDefault(require("ajv/dist/2020"));
+const pool_js_1 = require("./pool.js");
+/** The rules, by number, as the report names them. */
+exports.VALIDATE_RULES = {
+    1: 'schema',
+    2: "CUBE's upload rules",
+    3: 'file name equals name',
+    4: 'no names differ only in case',
+    5: 'images resolve',
+};
+/** Descriptors CUBE's upload refuses a file without. */
+const REQUIRED_DESCRIPTORS = ['name', 'version', 'dock_image', 'execshell', 'selfpath', 'selfexec', 'parameters'];
+/** Parameter types CUBE's upload takes (its front-end spellings). */
+const UPLOAD_PARAMETER_TYPES = ['str', 'int', 'float', 'bool', 'path', 'unextpath'];
+/** Parameter types that may never be optional. */
+const PATH_TYPES = ['path', 'unextpath'];
+/** Docker Hub's registry, as image references name it and as it is reached. */
+const DOCKER_HUB = { named: 'docker.io', host: 'registry-1.docker.io' };
+/** Manifest media types a registry may answer a manifest lookup with. */
+const MANIFEST_ACCEPT = [
+    'application/vnd.oci.image.index.v1+json',
+    'application/vnd.oci.image.manifest.v1+json',
+    'application/vnd.docker.distribution.manifest.list.v2+json',
+    'application/vnd.docker.distribution.manifest.v2+json',
+].join(', ');
+/**
+ * Runs rules 1–4 over an index's descriptors.
+ *
+ * @param index - The index.
+ * @returns Each descriptor parsed, with its findings, and whether rule 1 ran.
+ * @throws {Error} When the index's schema does not compile.
+ *
+ * @example
+ * ```ts
+ * const local: LocalCheck = descriptors_checkLocal(index);
+ * local.descriptors.filter((d: DescriptorChecked): boolean => d.findings.length > 0);
+ * ```
+ */
+function descriptors_checkLocal(index) {
+    const schemaValidate = index.schema === null ? null : schema_compile(index.schema);
+    const checked = index.descriptors.map((descriptor) => descriptor_checkAlone(descriptor, schemaValidate));
+    const byLower = new Map();
+    for (const entry of checked) {
+        const name = entry.data?.['name'];
+        if (typeof name !== 'string')
+            continue;
+        byLower.set(name.toLowerCase(), [...(byLower.get(name.toLowerCase()) ?? []), name]);
+    }
+    const descriptors = checked.map((entry) => {
+        const name = entry.data?.['name'];
+        if (typeof name !== 'string')
+            return entry;
+        const others = (byLower.get(name.toLowerCase()) ?? []).filter((other) => other !== name);
+        if (others.length === 0)
+            return entry;
+        return { ...entry, findings: [...entry.findings, { file: entry.file, rule: 4, message: `'${name}' differs only in case from ${others.map((o) => `'${o}'`).join(', ')}` }] };
+    });
+    return { descriptors, schemaChecked: schemaValidate !== null };
+}
+/**
+ * Runs all five rules over an index.
+ *
+ * @param index - The index.
+ * @param options - Whether to skip rule 5, and the fetch it uses.
+ * @returns The report.
+ * @throws {Error} When the index's schema does not compile.
+ *
+ * @example
+ * ```ts
+ * const report: ValidateReport = await pluginIndex_validate(index, { offline: false });
+ * ```
+ */
+async function pluginIndex_validate(index, options) {
+    const local = descriptors_checkLocal(index);
+    const findings = local.descriptors.flatMap((entry) => entry.findings);
+    if (!options.offline) {
+        const fetcher = options.fetcher ?? fetch;
+        const images = local.descriptors.flatMap((entry) => {
+            const image = entry.data?.['dock_image'];
+            return typeof image === 'string' && image !== '' ? [{ file: entry.file, image }] : [];
+        });
+        const failures = await (0, pool_js_1.items_mapPooled)(images, pool_js_1.POOL_WIDTH, (item) => image_resolve(item.image, fetcher));
+        images.forEach((item, at) => {
+            const failure = failures[at];
+            if (failure)
+                findings.push({ file: item.file, rule: 5, message: `${item.image}: ${failure}` });
+        });
+    }
+    findings.sort((a, b) => a.file.localeCompare(b.file) || a.rule - b.rule);
+    const rules = [1, 2, 3, 4, 5].map((rule) => {
+        const failed = new Set(findings.filter((f) => f.rule === rule).map((f) => f.file)).size;
+        if (rule === 1 && !local.schemaChecked)
+            return { rule, title: exports.VALIDATE_RULES[rule], checked: false, note: 'no schema', failed };
+        if (rule === 5 && options.offline)
+            return { rule, title: exports.VALIDATE_RULES[rule], checked: false, note: '--offline', failed };
+        return { rule, title: exports.VALIDATE_RULES[rule], checked: true, failed };
+    });
+    return {
+        label: index.label,
+        commit: index.commit,
+        descriptors: index.descriptors.length,
+        findings,
+        rules,
+        ok: findings.length === 0,
+    };
+}
+/**
+ * Parses an image reference into what a registry lookup needs.
+ *
+ * @param image - The reference (`[registry/]repo[:tag][@sha256:…]`).
+ * @returns The registry host, repository and reference; null when unreadable.
+ *
+ * @example
+ * ```ts
+ * imageReference_parse('ghcr.io/fnndsc/pl-x:1.0@sha256:ab…'); // reference is the digest
+ * ```
+ */
+function imageReference_parse(image) {
+    const at = image.indexOf('@');
+    const digest = at === -1 ? null : image.slice(at + 1);
+    const named = at === -1 ? image : image.slice(0, at);
+    const slash = named.indexOf('/');
+    const first = slash === -1 ? '' : named.slice(0, slash);
+    const hasRegistry = first.includes('.') || first.includes(':') || first === 'localhost';
+    const registryNamed = hasRegistry ? first : DOCKER_HUB.named;
+    let rest = hasRegistry ? named.slice(slash + 1) : named;
+    const colon = rest.lastIndexOf(':');
+    const tag = colon === -1 ? 'latest' : rest.slice(colon + 1);
+    if (colon !== -1)
+        rest = rest.slice(0, colon);
+    if (rest === '' || /\s/.test(image))
+        return null;
+    const registry = registryNamed === DOCKER_HUB.named ? DOCKER_HUB.host : registryNamed;
+    const repository = registry === DOCKER_HUB.host && !rest.includes('/') ? `library/${rest}` : rest;
+    return { registry, repository, reference: digest ?? tag };
+}
+/**
+ * Asks an image's registry, anonymously, whether its manifest is there.
+ *
+ * Follows the registry's anonymous bearer-token challenge when it sends one.
+ *
+ * @param image - The image reference.
+ * @param fetcher - The fetch to use.
+ * @returns Null when the manifest resolves; else why not, in a few words.
+ *
+ * @example
+ * ```ts
+ * await image_resolve('docker.io/library/alpine:3.20', fetch); // null
+ * ```
+ */
+async function image_resolve(image, fetcher) {
+    const reference = imageReference_parse(image);
+    if (reference === null)
+        return 'not an image reference';
+    const url = `https://${reference.registry}/v2/${reference.repository}/manifests/${reference.reference}`;
+    try {
+        let response = await fetcher(url, { method: 'HEAD', headers: { Accept: MANIFEST_ACCEPT } });
+        if (response.status === 401) {
+            const token = await registryToken_get(response.headers.get('www-authenticate'), fetcher);
+            if (token === null)
+                return `${reference.registry} refuses anonymous reads`;
+            response = await fetcher(url, { method: 'HEAD', headers: { Accept: MANIFEST_ACCEPT, Authorization: `Bearer ${token}` } });
+        }
+        if (response.ok)
+            return null;
+        if (response.status === 404)
+            return `not found on ${reference.registry}`;
+        if (response.status === 401 || response.status === 403)
+            return `${reference.registry} refuses anonymous reads (HTTP ${response.status})`;
+        return `${reference.registry} answered HTTP ${response.status}`;
+    }
+    catch (error) {
+        return `${reference.registry} could not be reached (${error instanceof Error ? error.message : String(error)})`;
+    }
+}
+/**
+ * Gets an anonymous token from a registry's bearer challenge.
+ *
+ * @param challenge - The `WWW-Authenticate` header, when sent.
+ * @param fetcher - The fetch to use.
+ * @returns The token, or null when there is no bearer challenge or no token.
+ */
+async function registryToken_get(challenge, fetcher) {
+    if (challenge === null || !/^bearer\s/i.test(challenge))
+        return null;
+    const fields = {};
+    for (const match of challenge.matchAll(/(\w+)="([^"]*)"/g)) {
+        if (match[1] !== undefined && match[2] !== undefined)
+            fields[match[1]] = match[2];
+    }
+    const realm = fields['realm'];
+    if (realm === undefined)
+        return null;
+    const query = new URLSearchParams();
+    if (fields['service'] !== undefined)
+        query.set('service', fields['service']);
+    if (fields['scope'] !== undefined)
+        query.set('scope', fields['scope']);
+    const response = await fetcher(`${realm}?${query.toString()}`);
+    if (!response.ok)
+        return null;
+    const body = (await response.json());
+    const token = body.token ?? body.access_token;
+    return typeof token === 'string' ? token : null;
+}
+/**
+ * Compiles the index's schema.
+ *
+ * @param schema - The parsed schema.
+ * @returns The validator.
+ * @throws {Error} When the schema does not compile.
+ */
+function schema_compile(schema) {
+    // Strict mode refuses keywords it does not know; the schema belongs to the
+    // index and may grow annotations this check has no business refusing.
+    const ajv = new _2020_1.default({ allErrors: true, strict: false });
+    try {
+        return ajv.compile(schema);
+    }
+    catch (error) {
+        throw new Error(`the index's schema does not compile: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Runs rules 1–3 over one descriptor.
+ *
+ * @param descriptor - The file.
+ * @param schemaValidate - Rule 1's validator, or null when there is no schema.
+ * @returns The descriptor parsed, with its findings.
+ */
+function descriptor_checkAlone(descriptor, schemaValidate) {
+    let parsed;
+    try {
+        parsed = JSON.parse(descriptor.text);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        return { file: descriptor.file, text: descriptor.text, data: null, findings: [{ file: descriptor.file, rule: 2, message: `not JSON: ${reason}` }] };
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return { file: descriptor.file, text: descriptor.text, data: null, findings: [{ file: descriptor.file, rule: 2, message: 'not a JSON object' }] };
+    }
+    const data = parsed;
+    const findings = [];
+    if (schemaValidate !== null && !schemaValidate(data)) {
+        for (const problem of schemaValidate.errors ?? []) {
+            findings.push({ file: descriptor.file, rule: 1, message: schemaError_render(problem) });
+        }
+    }
+    for (const message of uploadRules_check(data))
+        findings.push({ file: descriptor.file, rule: 2, message });
+    const name = data['name'];
+    if (typeof name === 'string' && descriptor.file !== `${name}.json`) {
+        findings.push({ file: descriptor.file, rule: 3, message: `names the plugin '${name}': the file should be ${name}.json` });
+    }
+    return { file: descriptor.file, text: descriptor.text, data, findings };
+}
+/**
+ * Renders one schema error as a line.
+ *
+ * @param problem - The ajv error.
+ * @returns `<where> <what>` (`/parameters/0 must have required property 'type'`).
+ */
+function schemaError_render(problem) {
+    const where = problem.instancePath === '' ? 'the descriptor' : problem.instancePath;
+    const extra = problem.keyword === 'additionalProperties'
+        ? ` ('${String(problem.params.additionalProperty)}')`
+        : '';
+    return `${where} ${problem.message ?? 'is invalid'}${extra}`;
+}
+/**
+ * Checks CUBE's administrative upload rules (rule 2).
+ *
+ * @param data - The parsed descriptor.
+ * @returns One line per rule broken; empty when CUBE's upload would take it.
+ */
+function uploadRules_check(data) {
+    const problems = [];
+    for (const required of REQUIRED_DESCRIPTORS) {
+        if (!(required in data))
+            problems.push(`descriptor ${required} is required`);
+    }
+    const version = data['version'];
+    if ('version' in data && (typeof version !== 'string' || !/^[0-9.]+$/.test(version))) {
+        problems.push(`version ${JSON.stringify(version)} is not a dotted number`);
+    }
+    for (const field of ['min_number_of_workers', 'max_number_of_workers']) {
+        if (field in data && data[field] !== '' && !integer_isAtLeast(data[field], 1))
+            problems.push(`${field} must be a positive integer`);
+    }
+    for (const field of ['min_gpu_limit', 'max_gpu_limit']) {
+        if (field in data && data[field] !== '' && !integer_isAtLeast(data[field], 0))
+            problems.push(`${field} must be a non-negative integer`);
+    }
+    const parameters = data['parameters'];
+    if ('parameters' in data && !Array.isArray(parameters))
+        problems.push('parameters must be a list');
+    if (Array.isArray(parameters)) {
+        parameters.forEach((parameter, at) => {
+            problems.push(...parameterRules_check(parameter, at));
+        });
+    }
+    return problems;
+}
+/**
+ * Checks one parameter against CUBE's upload rules.
+ *
+ * @param parameter - The parameter as declared.
+ * @param at - Its position, for the message.
+ * @returns One line per rule broken.
+ */
+function parameterRules_check(parameter, at) {
+    if (parameter === null || typeof parameter !== 'object')
+        return [`parameter ${at} is not an object`];
+    const declared = parameter;
+    const label = typeof declared['name'] === 'string' ? `parameter '${declared['name']}'` : `parameter ${at}`;
+    const type = declared['type'];
+    if (type === undefined)
+        return [`${label}: type is required`];
+    if (typeof type !== 'string' || !UPLOAD_PARAMETER_TYPES.includes(type)) {
+        return [`${label}: type ${JSON.stringify(type)} is not one the upload takes (${UPLOAD_PARAMETER_TYPES.join('|')})`];
+    }
+    if (declared['optional'] === true) {
+        if (PATH_TYPES.includes(type))
+            return [`${label}: a ${type} parameter cannot be optional`];
+        if (declared['default'] === undefined || declared['default'] === null)
+            return [`${label}: an optional parameter needs a default`];
+        return [];
+    }
+    if (declared['ui_exposed'] === false)
+        return [`${label}: a required parameter must be exposed to the UI`];
+    return [];
+}
+/**
+ * Reports whether a value is an integer no smaller than a floor.
+ *
+ * @param value - The value.
+ * @param floor - The least integer allowed.
+ * @returns True for an integer (or an integer string) at or above the floor.
+ */
+function integer_isAtLeast(value, floor) {
+    const number = typeof value === 'string' && /^-?\d+$/.test(value) ? Number(value) : typeof value === 'number' ? value : Number.NaN;
+    return Number.isInteger(number) && number >= floor;
+}
+//# sourceMappingURL=plugin_validate.js.map

package/dist/plugins/plugin_validate.js.map

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