@fnndsc/salsa 4.4.4 → 4.5.0

package/dist/plugins/plugin_docker.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * @file Reading a plugin's descriptor out of its container image.
+ *
+ * The last way `plugin add` finds a descriptor: pull the image (or use the
+ * local copy) and ask it, trying the three ways ChRIS plugins have printed
+ * one over the years, in chrisomatic's order — `chris_plugin_info` with the
+ * image named, `chris_plugin_info` bare, and the old chrisapp `<CMD> --json`.
+ *
+ * Every docker call is an argument vector run without a shell: an image
+ * reference is operator input and never reaches a command line as text.
+ *
+ * Key components:
+ * - DockerRun: the seam that runs one docker command (tests stub it).
+ * - docker_isAvailable: whether a docker daemon answers.
+ * - dockerImage_ensure: the image locally, pulled when absent.
+ * - descriptorFromImage_extract: the image's descriptor JSON, by the three ways.
+ *
+ * Typical usage:
+ * ```ts
+ * if (await docker_isAvailable() && await dockerImage_ensure(image)) {
+ *   const descriptor: Record<string, unknown> | null = await descriptorFromImage_extract(image);
+ * }
+ * ```
+ *
+ * Dependencies: Node.js `child_process`; a `docker` CLI on the host.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docker_run = void 0;
+exports.docker_isAvailable = docker_isAvailable;
+exports.dockerImage_ensure = dockerImage_ensure;
+exports.descriptorFromImage_extract = descriptorFromImage_extract;
+const node_child_process_1 = require("node:child_process");
+/** Longest a descriptor print may take: some images (TensorFlow, MINC) take minutes. */
+const DESCRIPTOR_TIMEOUT_MS = 10 * 60 * 1000;
+/** Largest output read from a docker command. */
+const OUTPUT_MAX_BYTES = 32 * 1024 * 1024;
+/**
+ * Runs `docker` with an argument vector, no shell.
+ *
+ * @param args - The arguments after `docker`.
+ * @returns What it answered; never throws.
+ *
+ * @example
+ * ```ts
+ * const answer: DockerAnswer = await docker_run(['image', 'inspect', 'alpine']);
+ * ```
+ */
+const docker_run = (args) => new Promise((resolve) => {
+    (0, node_child_process_1.execFile)('docker', [...args], { timeout: DESCRIPTOR_TIMEOUT_MS, maxBuffer: OUTPUT_MAX_BYTES }, (error, stdout, stderr) => {
+        resolve({ ok: error === null, stdout: String(stdout).trim(), stderr: String(stderr || error?.message || '').trim() });
+    });
+});
+exports.docker_run = docker_run;
+/**
+ * Reports whether a docker daemon answers.
+ *
+ * @param run - The docker seam.
+ * @returns True when `docker info` succeeds.
+ *
+ * @example
+ * ```ts
+ * await docker_isAvailable(); // false on a host without docker
+ * ```
+ */
+async function docker_isAvailable(run = exports.docker_run) {
+    return (await run(['info', '--format', '{{.ServerVersion}}'])).ok;
+}
+/**
+ * Makes sure an image is present locally, pulling it when it is not.
+ *
+ * @param image - The image reference.
+ * @param run - The docker seam.
+ * @returns Null when the image is present; else why it could not be had.
+ *
+ * @example
+ * ```ts
+ * await dockerImage_ensure('fnndsc/pl-dircopy:2.1.1'); // null
+ * ```
+ */
+async function dockerImage_ensure(image, run = exports.docker_run) {
+    if ((await run(['image', 'inspect', '--format', '{{.Id}}', image])).ok)
+        return null;
+    const pulled = await run(['pull', '--quiet', image]);
+    return pulled.ok ? null : `docker pull ${image} failed: ${pulled.stderr || 'no reason given'}`;
+}
+/**
+ * Reads a plugin's descriptor out of its image.
+ *
+ * @param image - The image reference.
+ * @param publicRepo - The plugin's repository, passed to `chris_plugin_info` when known.
+ * @param run - The docker seam.
+ * @returns The descriptor, or null when none of the three ways printed one.
+ *
+ * @example
+ * ```ts
+ * const descriptor: Record<string, unknown> | null = await descriptorFromImage_extract('fnndsc/pl-dircopy:2.1.1');
+ * ```
+ */
+async function descriptorFromImage_extract(image, publicRepo, run = exports.docker_run) {
+    const withArgs = ['run', '--rm', image, 'chris_plugin_info', '--dock-image', image];
+    if (publicRepo !== undefined)
+        withArgs.push('--public-repo', publicRepo);
+    const attempts = [
+        () => run(withArgs),
+        () => run(['run', '--rm', image, 'chris_plugin_info']),
+        async () => {
+            const command = await imageCommand_get(image, run);
+            return command === null ? null : run(['run', '--rm', image, command, '--json']);
+        },
+    ];
+    for (const attempt of attempts) {
+        const answer = await attempt();
+        if (answer === null || !answer.ok || answer.stdout === '')
+            continue;
+        const parsed = descriptorJson_parse(answer.stdout);
+        if (parsed !== null)
+            return parsed;
+    }
+    return null;
+}
+/**
+ * Reads an image's default command, for the old chrisapp `--json` way.
+ *
+ * @param image - The image reference.
+ * @param run - The docker seam.
+ * @returns The first word of the image's CMD, or null when it has none.
+ */
+async function imageCommand_get(image, run) {
+    const answer = await run(['image', 'inspect', '--format', '{{json .Config.Cmd}}', image]);
+    if (!answer.ok)
+        return null;
+    try {
+        const command = JSON.parse(answer.stdout);
+        return Array.isArray(command) && typeof command[0] === 'string' ? command[0] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parses a printed descriptor.
+ *
+ * @param text - What the image printed.
+ * @returns The descriptor object, or null when the text is not one.
+ */
+function descriptorJson_parse(text) {
+    try {
+        const parsed = JSON.parse(text);
+        return parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=plugin_docker.js.map

package/dist/plugins/plugin_docker.js.map

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

package/dist/plugins/plugin_index.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @file Plugin indexes: where descriptors come from, and reading them.
+ *
+ * A plugin index is a set of plugin descriptors, one JSON file per plugin at
+ * its latest version, in the form CUBE's administrative upload takes, with
+ * the JSON Schema they follow beside them. FNNDSC/chris-plugins is the one
+ * that matters; a directory of `.json` files or a `.tar.gz` holding one is
+ * an index too, on CUBE (how a surface with no host access syncs) or on the
+ * host.
+ *
+ * Every source reads to the same {@link PluginIndex}: its descriptors as
+ * text (so a later check can quote the file), the schema when one came with
+ * them, and the commit when the source can name one. GitHub's archive of a
+ * ref is fetched once, whole; its pax global header names the exact commit.
+ *
+ * Layout read from any source: descriptors are the `.json` files at the root
+ * or under `plugins/`; the schema is `schema/plugin.schema.json` at the root
+ * or one level up (a `plugins/` directory handed over on its own).
+ *
+ * Key components:
+ * - PluginIndexSource: a parsed source (GitHub repository at a ref, CUBE path, host path).
+ * - PluginIndex: the descriptors, schema and commit read from a source.
+ * - pluginIndexSource_parse: read a source word (`FNNDSC/chris-plugins@main`, `host:./plugins`).
+ * - pluginIndexArchive_read: read an index from archive bytes.
+ * - pluginIndex_load: read an index from any source.
+ *
+ * Typical usage:
+ * ```ts
+ * const source: PluginIndexSource | null = pluginIndexSource_parse('FNNDSC/chris-plugins@main', 'cube');
+ * const loaded: Result<PluginIndex> = source ? await pluginIndex_load(source) : Err();
+ * ```
+ *
+ * Dependencies: Node.js built-ins (`node:fs`, `node:path`), `fetch` for the
+ * GitHub archive, salsa's CUBE file reads for CUBE paths.
+ *
+ * @module
+ */
+import { type Result } from '@fnndsc/cumin';
+/**
+ * Where an index is read from.
+ *
+ * @example
+ * ```ts
+ * const source: PluginIndexSource = { kind: 'github', owner: 'FNNDSC', repo: 'chris-plugins', ref: 'main' };
+ * ```
+ */
+export type PluginIndexSource = {
+    readonly kind: 'github';
+    readonly owner: string;
+    readonly repo: string;
+    readonly ref: string;
+} | {
+    readonly kind: 'cube';
+    readonly path: string;
+} | {
+    readonly kind: 'host';
+    readonly path: string;
+};
+/**
+ * One descriptor file of an index.
+ *
+ * @example
+ * ```ts
+ * const descriptor: IndexDescriptor = { file: 'pl-dircopy.json', text: '{"name":"pl-dircopy"}' };
+ * ```
+ */
+export interface IndexDescriptor {
+    /** The file's name (`pl-dircopy.json`), which rule 3 holds to the plugin's name. */
+    readonly file: string;
+    /** The file's text, as read. */
+    readonly text: string;
+}
+/**
+ * An index, read.
+ *
+ * @example
+ * ```ts
+ * const index: PluginIndex = pluginIndexArchive_read(bytes, 'FNNDSC/chris-plugins@main');
+ * index.descriptors.length;
+ * ```
+ */
+export interface PluginIndex {
+    /** The source as the operator would write it. */
+    readonly source: string;
+    /** A short name for headers: `chris-plugins @ 8c9a1f6`. */
+    readonly label: string;
+    /** The full commit the descriptors were read at, when the source names one. */
+    readonly commit: string | null;
+    /** Every descriptor, sorted by file name. */
+    readonly descriptors: IndexDescriptor[];
+    /** The parsed JSON Schema, or null when none came with the descriptors. */
+    readonly schema: unknown;
+}
+/**
+ * Parses an index source word.
+ *
+ * `owner/repo[@ref]` is a GitHub repository; `host:<path>` a host path;
+ * `cube:<path>` a CUBE path. Any other word is a path, read where `bare`
+ * says: `plugin sync` reads a bare path on CUBE, `plugin validate` (which
+ * needs no CUBE) on the host.
+ *
+ * @param word - The source as typed.
+ * @param bare - Where a path with no prefix is read.
+ * @param ref - A ref overriding the word's own (`--ref`), for a GitHub source.
+ * @returns The parsed source, or null for an empty word.
+ *
+ * @example
+ * ```ts
+ * pluginIndexSource_parse('FNNDSC/chris-plugins@v1', 'cube'); // { kind: 'github', …, ref: 'v1' }
+ * pluginIndexSource_parse('host:./plugins', 'cube');          // { kind: 'host', path: './plugins' }
+ * ```
+ */
+export declare function pluginIndexSource_parse(word: string, bare: 'cube' | 'host', ref?: string): PluginIndexSource | null;
+/**
+ * Renders a source as the operator would write it.
+ *
+ * @param source - The parsed source.
+ * @returns The source word (`FNNDSC/chris-plugins@main`, `host:./plugins`, `cube:/home/u/plugins`).
+ *
+ * @example
+ * ```ts
+ * pluginIndexSource_format({ kind: 'host', path: './plugins' }); // 'host:./plugins'
+ * ```
+ */
+export declare function pluginIndexSource_format(source: PluginIndexSource): string;
+/**
+ * Reads an index from archive bytes.
+ *
+ * A single top folder (GitHub's `FNNDSC-chris-plugins-<sha>/`) is the root;
+ * the pax global header's `comment` is the commit.
+ *
+ * @param bytes - The archive, gzipped or plain.
+ * @param source - The source word, for the index's `source` and `label`.
+ * @returns The index.
+ * @throws {Error} When the archive is unreadable, an entry's path is unsafe,
+ *   or the schema it carries is not JSON.
+ *
+ * @example
+ * ```ts
+ * const index: PluginIndex = pluginIndexArchive_read(readFileSync('index.tar.gz'), 'FNNDSC/chris-plugins@main');
+ * ```
+ */
+export declare function pluginIndexArchive_read(bytes: Buffer, source: string): PluginIndex;
+/**
+ * Reads an index from its source.
+ *
+ * @param source - The parsed source.
+ * @param fetcher - The fetch used for GitHub; the global one by default.
+ * @returns The index, or an error on the error stack (the fetch failed, the
+ *   path is not there, the archive is unreadable).
+ *
+ * @example
+ * ```ts
+ * const loaded: Result<PluginIndex> = await pluginIndex_load({ kind: 'host', path: './plugins' });
+ * ```
+ */
+export declare function pluginIndex_load(source: PluginIndexSource, fetcher?: typeof fetch): Promise<Result<PluginIndex>>;

package/dist/plugins/plugin_index.js

@@ -0,0 +1,338 @@
+"use strict";
+/**
+ * @file Plugin indexes: where descriptors come from, and reading them.
+ *
+ * A plugin index is a set of plugin descriptors, one JSON file per plugin at
+ * its latest version, in the form CUBE's administrative upload takes, with
+ * the JSON Schema they follow beside them. FNNDSC/chris-plugins is the one
+ * that matters; a directory of `.json` files or a `.tar.gz` holding one is
+ * an index too, on CUBE (how a surface with no host access syncs) or on the
+ * host.
+ *
+ * Every source reads to the same {@link PluginIndex}: its descriptors as
+ * text (so a later check can quote the file), the schema when one came with
+ * them, and the commit when the source can name one. GitHub's archive of a
+ * ref is fetched once, whole; its pax global header names the exact commit.
+ *
+ * Layout read from any source: descriptors are the `.json` files at the root
+ * or under `plugins/`; the schema is `schema/plugin.schema.json` at the root
+ * or one level up (a `plugins/` directory handed over on its own).
+ *
+ * Key components:
+ * - PluginIndexSource: a parsed source (GitHub repository at a ref, CUBE path, host path).
+ * - PluginIndex: the descriptors, schema and commit read from a source.
+ * - pluginIndexSource_parse: read a source word (`FNNDSC/chris-plugins@main`, `host:./plugins`).
+ * - pluginIndexArchive_read: read an index from archive bytes.
+ * - pluginIndex_load: read an index from any source.
+ *
+ * Typical usage:
+ * ```ts
+ * const source: PluginIndexSource | null = pluginIndexSource_parse('FNNDSC/chris-plugins@main', 'cube');
+ * const loaded: Result<PluginIndex> = source ? await pluginIndex_load(source) : Err();
+ * ```
+ *
+ * Dependencies: Node.js built-ins (`node:fs`, `node:path`), `fetch` for the
+ * GitHub archive, salsa's CUBE file reads for CUBE paths.
+ *
+ * @module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluginIndexSource_parse = pluginIndexSource_parse;
+exports.pluginIndexSource_format = pluginIndexSource_format;
+exports.pluginIndexArchive_read = pluginIndexArchive_read;
+exports.pluginIndex_load = pluginIndex_load;
+const node_fs_1 = require("node:fs");
+const nodePath = __importStar(require("node:path"));
+const cumin_1 = require("@fnndsc/cumin");
+const index_js_1 = require("../files/index.js");
+const tar_read_js_1 = require("./tar_read.js");
+/** Where GitHub serves a repository's archive of a ref. */
+const GITHUB_TARBALL_URL = 'https://api.github.com/repos';
+/** The ref read when a GitHub source names none. */
+const DEFAULT_REF = 'main';
+/** File name of the index's JSON Schema. */
+const SCHEMA_FILE = 'plugin.schema.json';
+/** Archive extensions read as a single archive rather than a directory. */
+const ARCHIVE_PATTERN = /\.(tar\.gz|tgz|tar)$/i;
+/** A GitHub repository word: `owner/repo`, optionally `@ref`. */
+const GITHUB_PATTERN = /^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)(?:@(\S+))?$/;
+/**
+ * Parses an index source word.
+ *
+ * `owner/repo[@ref]` is a GitHub repository; `host:<path>` a host path;
+ * `cube:<path>` a CUBE path. Any other word is a path, read where `bare`
+ * says: `plugin sync` reads a bare path on CUBE, `plugin validate` (which
+ * needs no CUBE) on the host.
+ *
+ * @param word - The source as typed.
+ * @param bare - Where a path with no prefix is read.
+ * @param ref - A ref overriding the word's own (`--ref`), for a GitHub source.
+ * @returns The parsed source, or null for an empty word.
+ *
+ * @example
+ * ```ts
+ * pluginIndexSource_parse('FNNDSC/chris-plugins@v1', 'cube'); // { kind: 'github', …, ref: 'v1' }
+ * pluginIndexSource_parse('host:./plugins', 'cube');          // { kind: 'host', path: './plugins' }
+ * ```
+ */
+function pluginIndexSource_parse(word, bare, ref) {
+    const trimmed = word.trim();
+    if (trimmed === '')
+        return null;
+    if (trimmed.startsWith('host:'))
+        return { kind: 'host', path: trimmed.slice('host:'.length) };
+    if (trimmed.startsWith('cube:'))
+        return { kind: 'cube', path: trimmed.slice('cube:'.length) };
+    const github = trimmed.startsWith('.') ? null : GITHUB_PATTERN.exec(trimmed);
+    if (github !== null && github[1] !== undefined && github[2] !== undefined) {
+        return { kind: 'github', owner: github[1], repo: github[2], ref: ref ?? github[3] ?? DEFAULT_REF };
+    }
+    return { kind: bare, path: trimmed };
+}
+/**
+ * Renders a source as the operator would write it.
+ *
+ * @param source - The parsed source.
+ * @returns The source word (`FNNDSC/chris-plugins@main`, `host:./plugins`, `cube:/home/u/plugins`).
+ *
+ * @example
+ * ```ts
+ * pluginIndexSource_format({ kind: 'host', path: './plugins' }); // 'host:./plugins'
+ * ```
+ */
+function pluginIndexSource_format(source) {
+    if (source.kind === 'github')
+        return `${source.owner}/${source.repo}@${source.ref}`;
+    return `${source.kind}:${source.path}`;
+}
+/**
+ * Reads an index from archive bytes.
+ *
+ * A single top folder (GitHub's `FNNDSC-chris-plugins-<sha>/`) is the root;
+ * the pax global header's `comment` is the commit.
+ *
+ * @param bytes - The archive, gzipped or plain.
+ * @param source - The source word, for the index's `source` and `label`.
+ * @returns The index.
+ * @throws {Error} When the archive is unreadable, an entry's path is unsafe,
+ *   or the schema it carries is not JSON.
+ *
+ * @example
+ * ```ts
+ * const index: PluginIndex = pluginIndexArchive_read(readFileSync('index.tar.gz'), 'FNNDSC/chris-plugins@main');
+ * ```
+ */
+function pluginIndexArchive_read(bytes, source) {
+    const archive = (0, tar_read_js_1.tarArchive_read)(bytes);
+    const root = archiveRoot_find(archive.files);
+    const entries = archive.files
+        .filter((file) => file.path.startsWith(root))
+        .map((file) => ({ path: file.path.slice(root.length), text: file.content.toString('utf8') }));
+    const commit = archive.globals['comment'] ?? null;
+    return pluginIndex_assemble(source, commit, entries);
+}
+/**
+ * Reads an index from its source.
+ *
+ * @param source - The parsed source.
+ * @param fetcher - The fetch used for GitHub; the global one by default.
+ * @returns The index, or an error on the error stack (the fetch failed, the
+ *   path is not there, the archive is unreadable).
+ *
+ * @example
+ * ```ts
+ * const loaded: Result<PluginIndex> = await pluginIndex_load({ kind: 'host', path: './plugins' });
+ * ```
+ */
+async function pluginIndex_load(source, fetcher = fetch) {
+    const word = pluginIndexSource_format(source);
+    try {
+        if (source.kind === 'github')
+            return (0, cumin_1.Ok)(await pluginIndexGitHub_fetch(source, fetcher));
+        if (source.kind === 'host')
+            return (0, cumin_1.Ok)(await pluginIndexHost_read(source.path, word));
+        return await pluginIndexCube_read(source.path, word);
+    }
+    catch (error) {
+        cumin_1.errorStack.stack_push('error', `plugin index ${word}: ${error instanceof Error ? error.message : String(error)}`);
+        return (0, cumin_1.Err)();
+    }
+}
+/**
+ * Fetches a GitHub repository's archive of a ref and reads it.
+ *
+ * @param source - The GitHub source.
+ * @param fetcher - The fetch to use.
+ * @returns The index.
+ * @throws {Error} When GitHub does not answer with the archive.
+ */
+async function pluginIndexGitHub_fetch(source, fetcher) {
+    const url = `${GITHUB_TARBALL_URL}/${source.owner}/${source.repo}/tarball/${encodeURIComponent(source.ref)}`;
+    const response = await fetcher(url, { headers: { Accept: 'application/vnd.github+json' } });
+    if (!response.ok)
+        throw new Error(`GitHub answered HTTP ${response.status} for ${url}`);
+    const bytes = Buffer.from(await response.arrayBuffer());
+    return pluginIndexArchive_read(bytes, `${source.owner}/${source.repo}@${source.ref}`);
+}
+/**
+ * Reads an index from a host path: a directory or an archive.
+ *
+ * @param path - The host path.
+ * @param word - The source word.
+ * @returns The index.
+ * @throws {Error} When the path cannot be read.
+ */
+async function pluginIndexHost_read(path, word) {
+    if (ARCHIVE_PATTERN.test(path))
+        return pluginIndexArchive_read(await node_fs_1.promises.readFile(path), word);
+    const entries = [];
+    for (const [relative, directory] of [['', path], ['plugins/', nodePath.join(path, 'plugins')]]) {
+        const names = await directoryNames_read(directory);
+        for (const name of names.filter((candidate) => candidate.endsWith('.json'))) {
+            entries.push({ path: `${relative}${name}`, text: await node_fs_1.promises.readFile(nodePath.join(directory, name), 'utf8') });
+        }
+    }
+    for (const relative of [`schema/${SCHEMA_FILE}`, `../schema/${SCHEMA_FILE}`]) {
+        const text = await node_fs_1.promises.readFile(nodePath.join(path, relative), 'utf8').catch(() => null);
+        if (text !== null)
+            entries.push({ path: relative, text });
+    }
+    return pluginIndex_assemble(word, null, entries);
+}
+/**
+ * Lists a host directory's file names, or none when it is not there.
+ *
+ * @param directory - The host directory.
+ * @returns Its entries' names; empty when the directory does not exist.
+ * @throws {Error} On a read failure other than absence.
+ */
+async function directoryNames_read(directory) {
+    try {
+        return (await node_fs_1.promises.readdir(directory)).sort();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT' || error.code === 'ENOTDIR')
+            return [];
+        throw error;
+    }
+}
+/**
+ * Reads an index from a CUBE path: a directory or an uploaded archive.
+ *
+ * @param path - The CUBE path, absolute.
+ * @param word - The source word.
+ * @returns The index, or an error on the error stack.
+ */
+async function pluginIndexCube_read(path, word) {
+    if (ARCHIVE_PATTERN.test(path)) {
+        const bytes = await (0, index_js_1.fileContent_getBinary)(path);
+        return bytes.ok ? (0, cumin_1.Ok)(pluginIndexArchive_read(bytes.value, word)) : (0, cumin_1.Err)();
+    }
+    const root = path.replace(/\/+$/, '');
+    const items = await (0, index_js_1.files_listRecursive)(root);
+    const entries = [];
+    for (const item of items.filter((candidate) => candidate.type === 'file')) {
+        const relative = item.path.replace(/^\/+/, '').slice(root.replace(/^\/+/, '').length + 1);
+        if (!/^(plugins\/)?[^/]+\.json$/.test(relative) && relative !== `schema/${SCHEMA_FILE}`)
+            continue;
+        const text = await (0, index_js_1.fileContent_get)(`${root}/${relative}`);
+        if (!text.ok)
+            return (0, cumin_1.Err)();
+        entries.push({ path: relative, text: text.value });
+    }
+    if (!entries.some((entry) => entry.path.endsWith(SCHEMA_FILE))) {
+        const above = await (0, index_js_1.fileContent_get)(`${nodePath.posix.dirname(root)}/schema/${SCHEMA_FILE}`);
+        // An index handed over without its schema is still an index; rule 1
+        // then says it was not checked rather than this read failing.
+        if (above.ok)
+            entries.push({ path: `../schema/${SCHEMA_FILE}`, text: above.value });
+        else
+            cumin_1.errorStack.stack_pop();
+    }
+    return (0, cumin_1.Ok)(pluginIndex_assemble(word, null, entries));
+}
+/**
+ * Finds an archive's single top folder, the index's root.
+ *
+ * @param files - The archive's files.
+ * @returns The root with its trailing slash, or '' when the files share none.
+ */
+function archiveRoot_find(files) {
+    const tops = new Set(files.map((file) => file.path.split('/')[0] ?? ''));
+    const top = [...tops][0];
+    return tops.size === 1 && top !== undefined && files.every((file) => file.path.includes('/')) ? `${top}/` : '';
+}
+/**
+ * Builds an index from its files, by the layout every source shares.
+ *
+ * @param source - The source word.
+ * @param commit - The commit, when the source names one.
+ * @param entries - The files, relative to the root.
+ * @returns The index.
+ * @throws {Error} When the schema file is not JSON.
+ */
+function pluginIndex_assemble(source, commit, entries) {
+    const descriptors = entries
+        .filter((entry) => /^(plugins\/)?[^/]+\.json$/.test(entry.path) && !entry.path.endsWith(SCHEMA_FILE))
+        .map((entry) => ({ file: entry.path.replace(/^plugins\//, ''), text: entry.text }))
+        .sort((a, b) => a.file.localeCompare(b.file));
+    const schemaEntry = entries.find((entry) => entry.path === `schema/${SCHEMA_FILE}`)
+        ?? entries.find((entry) => entry.path === `../schema/${SCHEMA_FILE}`);
+    let schema = null;
+    if (schemaEntry !== undefined) {
+        try {
+            schema = JSON.parse(schemaEntry.text);
+        }
+        catch {
+            throw new Error(`${schemaEntry.path} is not JSON`);
+        }
+    }
+    return { source, label: indexLabel_build(source, commit), commit, descriptors, schema };
+}
+/**
+ * Builds an index's short name for headers.
+ *
+ * @param source - The source word.
+ * @param commit - The commit, when known.
+ * @returns `chris-plugins @ 8c9a1f6` for a repository, else the source word.
+ */
+function indexLabel_build(source, commit) {
+    const github = GITHUB_PATTERN.exec(source);
+    if (github === null || source.includes(':'))
+        return commit === null ? source : `${source} @ ${commit.slice(0, 7)}`;
+    return `${github[2] ?? source} @ ${commit === null ? (github[3] ?? DEFAULT_REF) : commit.slice(0, 7)}`;
+}
+//# sourceMappingURL=plugin_index.js.map

package/dist/plugins/plugin_index.js.map

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