@fnndsc/salsa 4.4.3 → 4.5.0

package/dist/plugins/pool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @file Run a list of tasks a few at a time.
+ *
+ * Plugin uploads and registry lookups each run four at a time: enough to
+ * finish 175 in seconds, few enough not to hammer a CUBE or a registry. Each
+ * task's failure stays its own; the pool never stops early.
+ *
+ * Key components:
+ * - POOL_WIDTH: the number of tasks run at once.
+ * - items_mapPooled: map items through an async function, a few at a time, in order.
+ *
+ * Typical usage:
+ * ```ts
+ * const sizes: number[] = await items_mapPooled(urls, POOL_WIDTH, async (url: string): Promise<number> => size_get(url));
+ * ```
+ *
+ * Dependencies: none.
+ *
+ * @module
+ */
+/** Tasks run at once by the plugin verbs. */
+export declare const POOL_WIDTH: number;
+/**
+ * Maps items through an async function, at most `width` at a time.
+ *
+ * Results come back in the items' order, whatever order the tasks finish in.
+ * A task that throws is not caught here: map to a value that records the
+ * failure when each failure must stay its own.
+ *
+ * A stop (the signal aborting) lets the tasks already running finish and
+ * starts no more, so what was sent is all accounted for; the items never
+ * started have no result.
+ *
+ * @param items - The items.
+ * @param width - Tasks run at once; at least 1.
+ * @param task - The work for one item.
+ * @param signal - Stops the map; absent, it runs to the end.
+ * @returns The started items' results, in the items' order: every item's
+ *   unless stopped.
+ *
+ * @example
+ * ```ts
+ * await items_mapPooled([1, 2, 3], 2, async (n: number): Promise<number> => n * 2); // [2, 4, 6]
+ * ```
+ */
+export declare function items_mapPooled<T, R>(items: readonly T[], width: number, task: (item: T, index: number) => Promise<R>, signal?: AbortSignal): Promise<R[]>;

package/dist/plugins/pool.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * @file Run a list of tasks a few at a time.
+ *
+ * Plugin uploads and registry lookups each run four at a time: enough to
+ * finish 175 in seconds, few enough not to hammer a CUBE or a registry. Each
+ * task's failure stays its own; the pool never stops early.
+ *
+ * Key components:
+ * - POOL_WIDTH: the number of tasks run at once.
+ * - items_mapPooled: map items through an async function, a few at a time, in order.
+ *
+ * Typical usage:
+ * ```ts
+ * const sizes: number[] = await items_mapPooled(urls, POOL_WIDTH, async (url: string): Promise<number> => size_get(url));
+ * ```
+ *
+ * Dependencies: none.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POOL_WIDTH = void 0;
+exports.items_mapPooled = items_mapPooled;
+/** Tasks run at once by the plugin verbs. */
+exports.POOL_WIDTH = 4;
+/**
+ * Maps items through an async function, at most `width` at a time.
+ *
+ * Results come back in the items' order, whatever order the tasks finish in.
+ * A task that throws is not caught here: map to a value that records the
+ * failure when each failure must stay its own.
+ *
+ * A stop (the signal aborting) lets the tasks already running finish and
+ * starts no more, so what was sent is all accounted for; the items never
+ * started have no result.
+ *
+ * @param items - The items.
+ * @param width - Tasks run at once; at least 1.
+ * @param task - The work for one item.
+ * @param signal - Stops the map; absent, it runs to the end.
+ * @returns The started items' results, in the items' order: every item's
+ *   unless stopped.
+ *
+ * @example
+ * ```ts
+ * await items_mapPooled([1, 2, 3], 2, async (n: number): Promise<number> => n * 2); // [2, 4, 6]
+ * ```
+ */
+async function items_mapPooled(items, width, task, signal) {
+    const results = new Array(items.length);
+    let next = 0;
+    const worker = async () => {
+        while (next < items.length && signal?.aborted !== true) {
+            const index = next;
+            next += 1;
+            results[index] = await task(items[index], index);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.max(1, Math.min(width, items.length)) }, worker));
+    return results.slice(0, next);
+}
+//# sourceMappingURL=pool.js.map

package/dist/plugins/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/plugins/pool.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AA4BH,0CAiBC;AA3CD,6CAA6C;AAChC,QAAA,UAAU,GAAW,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,KAAK,UAAU,eAAe,CACnC,KAAmB,EACnB,KAAa,EACb,IAA4C,EAC5C,MAAoB;IAEpB,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,IAAI,GAAW,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YACvD,MAAM,KAAK,GAAW,IAAI,CAAC;YAC3B,IAAI,IAAI,CAAC,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9F,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/plugins/tar_read.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @file A small reader for ustar archives, gzipped or not.
+ *
+ * A plugin index arrives as GitHub's archive of a ref (a gzipped ustar file
+ * with a pax global header naming the commit) or as a `.tar.gz` an operator
+ * uploaded. Both need only regular files and pax headers read, so this is a
+ * reader for that much of the format and no more: no links, no devices, no
+ * sparse files. Entries are returned in archive order with their paths as
+ * the archive names them.
+ *
+ * A path that climbs out of the archive (`..`) or starts at the root is
+ * refused outright rather than skipped: an archive that carries one is not
+ * one this reader should be trusted to have read correctly.
+ *
+ * Key components:
+ * - TarFile: one regular file of the archive, its path and bytes.
+ * - TarArchive: the files and the pax global header's records.
+ * - tarArchive_read: read an archive's regular files and global header.
+ *
+ * Typical usage:
+ * ```ts
+ * const archive: TarArchive = tarArchive_read(bytes);
+ * const commit: string | undefined = archive.globals['comment'];
+ * ```
+ *
+ * Dependencies: Node.js built-ins only (`node:zlib` for gzip).
+ *
+ * @module
+ */
+/**
+ * One regular file read from an archive.
+ *
+ * @example
+ * ```ts
+ * const file: TarFile = { path: 'repo-abc/plugins/pl-x.json', content: Buffer.from('{}') };
+ * ```
+ */
+export interface TarFile {
+    /** The file's path as the archive names it, prefix and pax `path` applied. */
+    readonly path: string;
+    /** The file's bytes. */
+    readonly content: Buffer;
+}
+/**
+ * What an archive holds that a reader of plugin indexes needs.
+ *
+ * @example
+ * ```ts
+ * const archive: TarArchive = tarArchive_read(bytes);
+ * archive.files.length;
+ * ```
+ */
+export interface TarArchive {
+    /** Every regular file, in archive order. */
+    readonly files: TarFile[];
+    /** The pax global header's records (GitHub writes the commit under `comment`). */
+    readonly globals: Record<string, string>;
+}
+/**
+ * Reads an archive's regular files and its pax global header.
+ *
+ * @param bytes - The archive, gzipped or plain ustar.
+ * @returns The regular files in archive order and the global records.
+ * @throws {Error} When the bytes are not a readable archive, or an entry's
+ *   path is absolute or climbs out with `..`.
+ *
+ * @example
+ * ```ts
+ * const archive: TarArchive = tarArchive_read(readFileSync('index.tar.gz'));
+ * archive.files.map((file: TarFile): string => file.path);
+ * ```
+ */
+export declare function tarArchive_read(bytes: Buffer): TarArchive;

package/dist/plugins/tar_read.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * @file A small reader for ustar archives, gzipped or not.
+ *
+ * A plugin index arrives as GitHub's archive of a ref (a gzipped ustar file
+ * with a pax global header naming the commit) or as a `.tar.gz` an operator
+ * uploaded. Both need only regular files and pax headers read, so this is a
+ * reader for that much of the format and no more: no links, no devices, no
+ * sparse files. Entries are returned in archive order with their paths as
+ * the archive names them.
+ *
+ * A path that climbs out of the archive (`..`) or starts at the root is
+ * refused outright rather than skipped: an archive that carries one is not
+ * one this reader should be trusted to have read correctly.
+ *
+ * Key components:
+ * - TarFile: one regular file of the archive, its path and bytes.
+ * - TarArchive: the files and the pax global header's records.
+ * - tarArchive_read: read an archive's regular files and global header.
+ *
+ * Typical usage:
+ * ```ts
+ * const archive: TarArchive = tarArchive_read(bytes);
+ * const commit: string | undefined = archive.globals['comment'];
+ * ```
+ *
+ * Dependencies: Node.js built-ins only (`node:zlib` for gzip).
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tarArchive_read = tarArchive_read;
+const node_zlib_1 = require("node:zlib");
+/** The tar block size: headers and padded data both come in these. */
+const BLOCK_BYTES = 512;
+/** The first two bytes of a gzip stream. */
+const GZIP_MAGIC = [0x1f, 0x8b];
+/** Header field offsets and widths, as the ustar format fixes them. */
+const FIELD = {
+    name: [0, 100],
+    size: [124, 12],
+    typeflag: [156, 1],
+    magic: [257, 6],
+    prefix: [345, 155],
+};
+/**
+ * Reads an archive's regular files and its pax global header.
+ *
+ * @param bytes - The archive, gzipped or plain ustar.
+ * @returns The regular files in archive order and the global records.
+ * @throws {Error} When the bytes are not a readable archive, or an entry's
+ *   path is absolute or climbs out with `..`.
+ *
+ * @example
+ * ```ts
+ * const archive: TarArchive = tarArchive_read(readFileSync('index.tar.gz'));
+ * archive.files.map((file: TarFile): string => file.path);
+ * ```
+ */
+function tarArchive_read(bytes) {
+    const tar = gzip_is(bytes) ? (0, node_zlib_1.gunzipSync)(bytes) : bytes;
+    const files = [];
+    const globals = {};
+    let pending = {};
+    let offset = 0;
+    while (offset + BLOCK_BYTES <= tar.length) {
+        const header = tar.subarray(offset, offset + BLOCK_BYTES);
+        if (block_isZero(header))
+            break;
+        if (!header.subarray(FIELD.magic[0], FIELD.magic[0] + 5).equals(Buffer.from('ustar'))) {
+            throw new Error(`not a ustar archive (no ustar magic at byte ${offset})`);
+        }
+        const size = headerSize_parse(header);
+        const type = field_read(header, FIELD.typeflag);
+        const body = tar.subarray(offset + BLOCK_BYTES, offset + BLOCK_BYTES + size);
+        if (body.length < size)
+            throw new Error('archive ends inside an entry');
+        offset += BLOCK_BYTES + Math.ceil(size / BLOCK_BYTES) * BLOCK_BYTES;
+        if (type === 'g') {
+            Object.assign(globals, paxRecords_parse(body));
+        }
+        else if (type === 'x') {
+            pending = paxRecords_parse(body);
+        }
+        else {
+            const named = headerPath_read(header);
+            const path = pending['path'] ?? named;
+            pending = {};
+            path_check(path);
+            if (type === '0' || type === '' || type === '\0')
+                files.push({ path, content: Buffer.from(body) });
+        }
+    }
+    return { files, globals };
+}
+/**
+ * Reports whether bytes start a gzip stream.
+ *
+ * @param bytes - The candidate bytes.
+ * @returns True on the gzip magic number.
+ */
+function gzip_is(bytes) {
+    return bytes[0] === GZIP_MAGIC[0] && bytes[1] === GZIP_MAGIC[1];
+}
+/**
+ * Reports whether a block is all zero bytes (the archive's end marker).
+ *
+ * @param block - One 512-byte block.
+ * @returns True when every byte is zero.
+ */
+function block_isZero(block) {
+    return block.every((byte) => byte === 0);
+}
+/**
+ * Reads a NUL-terminated header field as text.
+ *
+ * @param header - The header block.
+ * @param field - The field's offset and width.
+ * @returns The field's text, up to its first NUL.
+ */
+function field_read(header, field) {
+    const raw = header.subarray(field[0], field[0] + field[1]).toString('utf8');
+    const nul = raw.indexOf('\0');
+    return nul === -1 ? raw : raw.slice(0, nul);
+}
+/**
+ * Reads an entry's size from its octal header field.
+ *
+ * @param header - The header block.
+ * @returns The size in bytes.
+ * @throws {Error} When the field is not octal (base-256 sizes are not read).
+ */
+function headerSize_parse(header) {
+    const text = field_read(header, FIELD.size).trim();
+    if (!/^[0-7]*$/.test(text))
+        throw new Error(`unreadable entry size '${text}'`);
+    return text === '' ? 0 : parseInt(text, 8);
+}
+/**
+ * Reads an entry's path from the header's prefix and name fields.
+ *
+ * @param header - The header block.
+ * @returns The joined path.
+ */
+function headerPath_read(header) {
+    const name = field_read(header, FIELD.name);
+    const prefix = field_read(header, FIELD.prefix);
+    return prefix === '' ? name : `${prefix}/${name}`;
+}
+/**
+ * Parses pax extended-header records (`<len> <key>=<value>\n`).
+ *
+ * @param body - The header's data.
+ * @returns The records by key.
+ * @throws {Error} When a record's length does not fit the data.
+ */
+function paxRecords_parse(body) {
+    const records = {};
+    let at = 0;
+    while (at < body.length) {
+        const space = body.indexOf(0x20, at);
+        if (space === -1)
+            break;
+        const length = parseInt(body.subarray(at, space).toString('utf8'), 10);
+        if (!Number.isInteger(length) || length <= 0 || at + length > body.length) {
+            throw new Error('unreadable pax header record');
+        }
+        const record = body.subarray(space + 1, at + length - 1).toString('utf8');
+        const equals = record.indexOf('=');
+        if (equals !== -1)
+            records[record.slice(0, equals)] = record.slice(equals + 1);
+        at += length;
+    }
+    return records;
+}
+/**
+ * Refuses a path that is absolute or climbs out of the archive.
+ *
+ * @param path - The entry's path.
+ * @throws {Error} When the path starts at the root or holds a `..` segment.
+ */
+function path_check(path) {
+    if (path.startsWith('/') || /^[A-Za-z]:[\\/]/.test(path)) {
+        throw new Error(`archive entry '${path}' is an absolute path`);
+    }
+    if (path.split(/[\\/]/).includes('..')) {
+        throw new Error(`archive entry '${path}' climbs out of the archive`);
+    }
+}
+//# sourceMappingURL=tar_read.js.map

package/dist/plugins/tar_read.js.map

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

package/dist/vfs/providers/proc.js

@@ -219,6 +219,35 @@ async function cache_ensure() {
         await procCache_build();
     }
 }
+/**
+ * Ensures what one path needs. `/proc/jobs` itself needs the whole index. A
+ * path naming one feed needs that feed alone: its row is read and kept while
+ * the index builds on behind, so a fresh session's `ls /proc/jobs/feed_N` (or
+ * a `cd` into its `data`) answers in that feed's time, not every feed's
+ * (#1364: minutes before the first line, with the index warming).
+ *
+ * @param pathStr - The path asked for.
+ */
+async function cacheFor_ensure(pathStr) {
+    const cache = (0, cumin_1.procCache_get)();
+    if (cache.built)
+        return;
+    const { feedID } = procPath_parse(pathStr.replace(/\/$/, ''));
+    if (feedID === null) {
+        await cache_ensure();
+        return;
+    }
+    // The index lands behind the prompt; this read does not wait for it.
+    procCache_build().catch(() => { });
+    if (cache.feed_get(feedID) !== undefined)
+        return;
+    const client = await cumin_1.chrisConnection.client_get();
+    if (!client)
+        return;
+    const row = await feedRow_fetch(client, feedID);
+    if (row !== null)
+        cache.feed_add(procFeed_create(row.feed));
+}
 /**
  * Loads instance topology for a single feed.
  * Uses in-flight map to prevent duplicate API calls.
@@ -494,7 +523,10 @@ function outputPath_normalize(value) {
  * @param remainder - The path below `data`, '' for the link itself.
  * @returns The absolute CFS path, or Err when the job has no output space.
  */
-async function dataTarget_resolve(instanceID, remainder) {
+async function dataTarget_resolve(instanceID, remainder, feedID = null) {
+    // A fresh session knows no job until its feed's topology is read: read it, as a listing of the node would.
+    if (feedID !== null && (0, cumin_1.procCache_get)().instance_get(instanceID) === undefined)
+        await feedInstances_ensureLoaded(feedID);
     const outputPath = await instanceOutputPath_ensure(instanceID);
     if (!outputPath) {
         cumin_1.errorStack.stack_push('error', `No CFS output path is available for job ${instanceID}`);
@@ -567,18 +599,16 @@ class ProcVfsProvider {
      * @returns The authoritative CFS output path, or an error when absent.
      */
     async linkTarget_resolve(pathStr) {
-        await cache_ensure();
+        await cacheFor_ensure(pathStr);
         const clean = pathStr.replace(/\/$/, '');
         const { feedID, instanceID, virtualFile } = procPath_parse(clean);
         if (feedID === null || instanceID === null || virtualFile !== 'data') {
             cumin_1.errorStack.stack_push('error', `Not a /proc job data link: ${pathStr}`);
             return (0, cumin_1.Err)();
         }
-        const outputPath = await instanceOutputPath_ensure(instanceID);
-        if (outputPath)
-            return (0, cumin_1.Ok)(outputPath);
-        cumin_1.errorStack.stack_push('error', `No CFS output path is available for job ${instanceID}`);
-        return (0, cumin_1.Err)();
+        // The link's target: the job's output, its feed read first when this session has not (#1364: `download` of
+        // the link on a fresh session found no job and said the file could not be opened).
+        return dataTarget_resolve(instanceID, '', feedID);
     }
     /**
      * Everything beneath a `/proc/jobs` path from the cache, in the order its
@@ -673,7 +703,7 @@ class ProcVfsProvider {
         return { entries, unanswered };
     }
     async list(pathStr, _options) {
-        await cache_ensure();
+        await cacheFor_ensure(pathStr);
         const cache = (0, cumin_1.procCache_get)();
         const clean = pathStr.replace(/\/$/, '');
         // /proc/jobs — list all feeds with aggregate status from counters
@@ -699,7 +729,7 @@ class ProcVfsProvider {
         // target: resolve and delegate, so `ls .../data` (and deeper) shows the
         // target's real contents instead of silently re-listing the instance.
         if (instanceID !== null && virtualFile === 'data' && dataRemainder !== null) {
-            const target = await dataTarget_resolve(instanceID, dataRemainder);
+            const target = await dataTarget_resolve(instanceID, dataRemainder, feedID);
             if (!target.ok)
                 return (0, cumin_1.Err)();
             const { vfsDispatcher } = await import('../dispatcher.js');
@@ -796,11 +826,11 @@ class ProcVfsProvider {
      * @returns The file's bytes.
      */
     async bytes_read(pathStr) {
-        await cache_ensure();
+        await cacheFor_ensure(pathStr);
         const clean = pathStr.replace(/\/$/, '');
-        const { instanceID, virtualFile, dataRemainder } = procPath_parse(clean);
+        const { feedID, instanceID, virtualFile, dataRemainder } = procPath_parse(clean);
         if (instanceID !== null && virtualFile === 'data' && dataRemainder !== null && dataRemainder !== '') {
-            const target = await dataTarget_resolve(instanceID, dataRemainder);
+            const target = await dataTarget_resolve(instanceID, dataRemainder, feedID);
             if (!target.ok)
                 return (0, cumin_1.Err)();
             // The target is a CFS file, and the dispatcher's default provider is
@@ -818,13 +848,13 @@ class ProcVfsProvider {
         return (0, fond_1.vfsOutcome_convertFromResult)(await this.text_read(pathStr), 'ENOENT');
     }
     async text_read(pathStr) {
-        await cache_ensure();
+        await cacheFor_ensure(pathStr);
         const cache = (0, cumin_1.procCache_get)();
         const clean = pathStr.replace(/\/$/, '');
         const { feedID, instanceID, virtualFile, dataRemainder } = procPath_parse(clean);
         // A file under the `data` link is the CFS target's file.
         if (instanceID !== null && virtualFile === 'data' && dataRemainder !== null && dataRemainder !== '') {
-            const target = await dataTarget_resolve(instanceID, dataRemainder);
+            const target = await dataTarget_resolve(instanceID, dataRemainder, feedID);
             if (!target.ok)
                 return (0, cumin_1.Err)();
             const { fileContent_get } = await import('../../files/index.js');