@fnndsc/brasa 0.29.1 → 0.31.0

package/dist/builtins/fs/rmdir.js

@@ -0,0 +1,110 @@
+/**
+ * @file Builtin rmdir: removes empty folders, as on Linux.
+ *
+ * Inside a projection that holds folders a user makes (a tag under
+ * /proc/tags) the projection removes it, and a tag still worn by a feed is
+ * "Directory not empty". On the CUBE store a folder that holds anything is
+ * refused by name and an empty one is removed; a projection that removes
+ * no folders refuses by name.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { envelope_ok, envelope_error, errorStack, listCache_get } from '@fnndsc/cumin';
+import { vfsDispatcher } from '@fnndsc/salsa';
+import { path_resolve, error_stripDebugPrefix } from '../utils.js';
+import { folder_checkExists } from './folderExists.js';
+import { rm_run } from './rm.js';
+/**
+ * Parses rmdir's arguments: paths only; any flag is refused by name.
+ *
+ * @param args - Raw argument tokens.
+ * @returns The paths, or the refusal.
+ */
+export function rmdirArgs_parse(args) {
+    const paths = [];
+    let endOfOptions = false;
+    for (const arg of args) {
+        if (endOfOptions || arg === '-' || !arg.startsWith('-')) {
+            paths.push(arg);
+            continue;
+        }
+        if (arg === '--') {
+            endOfOptions = true;
+            continue;
+        }
+        return { refused: arg.startsWith('--') ? `rmdir: unrecognized option '${arg}'` : `rmdir: invalid option -- '${arg.slice(1, 2)}'` };
+    }
+    return { paths };
+}
+/**
+ * The reason on the stack, worded as rmdir words it.
+ *
+ * @param pathArg - The operand as typed.
+ * @returns `rmdir: failed to remove '<path>': <reason>`.
+ */
+function reason_said(pathArg) {
+    const reason = errorStack.stack_pop();
+    const said = reason === undefined ? 'failed' : error_stripDebugPrefix(reason.message);
+    if (said.startsWith('rmdir:'))
+        return said;
+    return `rmdir: failed to remove '${pathArg}': ${said.replace(/^[^:]*: /, '')}`;
+}
+/**
+ * Removes one empty folder on the CUBE store: one that holds anything is
+ * refused, an empty one goes through rm's own removal.
+ *
+ * @param targetPath - The resolved path.
+ * @param pathArg - The operand as typed.
+ * @returns Null when removed, or the refusal's words.
+ */
+async function storeFolder_remove(targetPath, pathArg) {
+    if (!(await folder_checkExists(targetPath)))
+        return `rmdir: failed to remove '${pathArg}': No such file or directory`;
+    const held = await vfsDispatcher.list(targetPath);
+    if (!held.ok)
+        return reason_said(pathArg);
+    if (held.value.length > 0)
+        return `rmdir: failed to remove '${pathArg}': Directory not empty`;
+    const removed = await rm_run({ recursive: true, force: false, interactive: false, once: false, paths: [targetPath] });
+    return removed.status === 'ok' ? null : `rmdir: failed to remove '${pathArg}'`;
+}
+/**
+ * Removes empty folders.
+ *
+ * @param args - The folders.
+ * @returns An envelope whose model lists each folder's outcome; silent on success.
+ */
+export async function builtin_rmdir(args) {
+    const parsed = rmdirArgs_parse(args);
+    if ('refused' in parsed)
+        return envelope_error('', undefined, `${chalk.red(parsed.refused)}\n`);
+    if (parsed.paths.length === 0)
+        return envelope_error('', undefined, `${chalk.red('Usage: rmdir <directory> [directory...]')}\n`);
+    let renderedErr = '';
+    const outcomes = [];
+    for (const pathArg of parsed.paths) {
+        const targetPath = await path_resolve(pathArg);
+        let refusal;
+        if (vfsDispatcher.path_isVirtual(targetPath)) {
+            refusal = (await vfsDispatcher.rmdir(targetPath)) ? null : reason_said(pathArg);
+        }
+        else {
+            refusal = await storeFolder_remove(targetPath, pathArg);
+        }
+        if (refusal !== null)
+            renderedErr += `${chalk.red(refusal)}\n`;
+        else
+            listCache_get().cache_invalidate(targetPath.slice(0, targetPath.lastIndexOf('/')) || '/');
+        outcomes.push({ path: targetPath, removed: refusal === null });
+    }
+    const model = { kind: 'fs.rmdir', data: outcomes };
+    if (renderedErr !== '') {
+        process.exitCode = 1;
+        const envelope = envelope_error('', undefined, renderedErr);
+        envelope.model = model;
+        return envelope;
+    }
+    return envelope_ok('', model);
+}
+//# sourceMappingURL=rmdir.js.map

package/dist/builtins/fs/rmdir.js.map

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

package/dist/builtins/fs/touch.js

@@ -22,14 +22,15 @@ export async function touch_run(runOptions) {
         return envelope_error('', undefined, `${chalk.red('Usage: touch [--withContents <string>] [--withContentsFromFile <file>] <file>')}\n`);
     }
     const options = {};
-    if (runOptions.contents) {
+    // Empty text is text: `--withContents ''` writes an empty file.
+    if (runOptions.contents !== undefined) {
         options.withContents = runOptions.contents;
     }
     if (runOptions.contentsFromFile) {
         options.withContentsFromFile = runOptions.contentsFromFile;
     }
     // Only process the first file argument when injecting content
-    const filesToTouch = (options.withContents || options.withContentsFromFile)
+    const filesToTouch = (options.withContents !== undefined || options.withContentsFromFile)
         ? [pathArgs[0]]
         : pathArgs;
     let rendered = '';

package/dist/builtins/fs/touch.js.map

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

package/dist/builtins/fs/xattr.args.d.ts

@@ -0,0 +1,52 @@
+/** The one attribute a feed carries. */
+export declare const XATTR_TAG: string;
+/** How `setfattr` is spelled. */
+export declare const SETFATTR_USAGE: string;
+/** How `getfattr` is spelled. */
+export declare const GETFATTR_USAGE: string;
+/** A parsed `setfattr` invocation. */
+export interface SetfattrArgs {
+    /** Set a value (`-n`), or remove (`-x`). */
+    mode: 'set' | 'remove';
+    /** The value to set or remove; null removes every value (`-x` alone). */
+    value: string | null;
+    paths: string[];
+    error: string | null;
+}
+/** A parsed `getfattr` invocation. */
+export interface GetfattrArgs {
+    paths: string[];
+    error: string | null;
+}
+/**
+ * Reads a `setfattr` invocation. Unknown flags and attributes are refused by name.
+ *
+ * @param args - The tokens after the verb.
+ * @returns The parsed invocation, its error set when it is wrong.
+ */
+export declare function setfattrArgs_parse(args: ReadonlyArray<string>): SetfattrArgs;
+/**
+ * Reads a `getfattr` invocation. `-n tag` is accepted (it is the only
+ * attribute); `-d` (dump all) reads the same.
+ *
+ * @param args - The tokens after the verb.
+ * @returns The parsed invocation, its error set when it is wrong.
+ */
+export declare function getfattrArgs_parse(args: ReadonlyArray<string>): GetfattrArgs;
+/**
+ * The feed a path names: an id, a `feed_N`, a path through `/feeds/` as
+ * setfacl reads it, or the projection `/proc/jobs/feed_N`.
+ *
+ * @param target - The path as typed.
+ * @returns The feed id, or null.
+ */
+export declare function xattrTarget_resolve(target: string): number | null;
+/**
+ * Renders a feed's tags the way `getfattr` dumps attributes: a `# file:`
+ * line, then one `tag="…"` line per value; nothing under it when bare.
+ *
+ * @param path - The path as named.
+ * @param tags - The tag names.
+ * @returns The block.
+ */
+export declare function xattr_render(path: string, tags: ReadonlyArray<string>): string;

package/dist/builtins/fs/xattr.args.js

@@ -0,0 +1,134 @@
+/**
+ * @file Shared `setfattr` / `getfattr` command-line grammar.
+ *
+ * A feed's tags are, in POSIX terms, an extended attribute: `setfattr -n
+ * tag -v urgent feed_12` hangs one, `getfattr feed_12` reads them. One
+ * attribute exists, `tag` (also spelled `user.tag`), and it holds many
+ * values — CUBE's tags on the feed.
+ *
+ * Dependency-free, as `acl.args.ts` is: the engine graph cannot be loaded
+ * under jest, so a grammar inside the builtin is a grammar nothing tests.
+ *
+ * @module
+ */
+import { aclTarget_resolve } from './acl.args.js';
+/** The one attribute a feed carries. */
+export const XATTR_TAG = 'tag';
+/** How `setfattr` is spelled. */
+export const SETFATTR_USAGE = 'setfattr: usage: setfattr -n tag -v <value> <path>... | setfattr -x tag [-v <value>] <path>...';
+/** How `getfattr` is spelled. */
+export const GETFATTR_USAGE = 'getfattr: usage: getfattr [-n tag] <path>...';
+/**
+ * Whether an attribute name is the one a feed carries.
+ *
+ * @param name - The name as typed.
+ * @returns True for `tag` and `user.tag`.
+ */
+function name_isTag(name) {
+    return name === XATTR_TAG || name === `user.${XATTR_TAG}`;
+}
+/**
+ * Reads a `setfattr` invocation. Unknown flags and attributes are refused by name.
+ *
+ * @param args - The tokens after the verb.
+ * @returns The parsed invocation, its error set when it is wrong.
+ */
+export function setfattrArgs_parse(args) {
+    let mode = null;
+    let name = null;
+    let value = null;
+    const paths = [];
+    const fail = (error) => ({ mode: 'set', value: null, paths: [], error });
+    for (let i = 0; i < args.length; i += 1) {
+        const token = args[i] ?? '';
+        if (token === '-n' || token === '--name' || token === '-x' || token === '--remove') {
+            const given = args[i + 1];
+            if (given === undefined)
+                return fail(`setfattr: option '${token}' requires an argument\n${SETFATTR_USAGE}`);
+            mode = token === '-n' || token === '--name' ? 'set' : 'remove';
+            name = given;
+            i += 1;
+        }
+        else if (token === '-v' || token === '--value') {
+            const given = args[i + 1];
+            if (given === undefined)
+                return fail(`setfattr: option '${token}' requires an argument\n${SETFATTR_USAGE}`);
+            value = given;
+            i += 1;
+        }
+        else if (token.startsWith('-')) {
+            return fail(`setfattr: invalid option -- '${token.replace(/^-+/, '')}'\n${SETFATTR_USAGE}`);
+        }
+        else {
+            paths.push(token);
+        }
+    }
+    if (mode === null || name === null)
+        return fail(SETFATTR_USAGE);
+    if (!name_isTag(name))
+        return fail(`setfattr: ${name}: Operation not supported (a feed carries one attribute, tag)`);
+    if (mode === 'set' && (value === null || value.trim() === ''))
+        return fail(`setfattr: -n ${name} needs -v <value>\n${SETFATTR_USAGE}`);
+    if (paths.length === 0)
+        return fail(SETFATTR_USAGE);
+    return { mode, value: value === null ? null : value.trim(), paths, error: null };
+}
+/**
+ * Reads a `getfattr` invocation. `-n tag` is accepted (it is the only
+ * attribute); `-d` (dump all) reads the same.
+ *
+ * @param args - The tokens after the verb.
+ * @returns The parsed invocation, its error set when it is wrong.
+ */
+export function getfattrArgs_parse(args) {
+    const paths = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const token = args[i] ?? '';
+        if (token === '-n' || token === '--name') {
+            const given = args[i + 1];
+            if (given === undefined)
+                return { paths: [], error: `getfattr: option '${token}' requires an argument\n${GETFATTR_USAGE}` };
+            if (!name_isTag(given))
+                return { paths: [], error: `getfattr: ${given}: No such attribute (a feed carries one attribute, tag)` };
+            i += 1;
+        }
+        else if (token === '-d' || token === '--dump') {
+            continue;
+        }
+        else if (token.startsWith('-')) {
+            return { paths: [], error: `getfattr: invalid option -- '${token.replace(/^-+/, '')}'\n${GETFATTR_USAGE}` };
+        }
+        else {
+            paths.push(token);
+        }
+    }
+    if (paths.length === 0)
+        return { paths: [], error: GETFATTR_USAGE };
+    return { paths, error: null };
+}
+/**
+ * The feed a path names: an id, a `feed_N`, a path through `/feeds/` as
+ * setfacl reads it, or the projection `/proc/jobs/feed_N`.
+ *
+ * @param target - The path as typed.
+ * @returns The feed id, or null.
+ */
+export function xattrTarget_resolve(target) {
+    const held = aclTarget_resolve(target);
+    if (held !== null)
+        return held;
+    const projected = target.match(/\/jobs\/feed_(\d+)(?:\/|$)/);
+    return projected !== null ? Number(projected[1]) : null;
+}
+/**
+ * Renders a feed's tags the way `getfattr` dumps attributes: a `# file:`
+ * line, then one `tag="…"` line per value; nothing under it when bare.
+ *
+ * @param path - The path as named.
+ * @param tags - The tag names.
+ * @returns The block.
+ */
+export function xattr_render(path, tags) {
+    return [`# file: ${path}`, ...tags.map((tag) => `${XATTR_TAG}="${tag.replace(/"/g, '\\"')}"`)].join('\n');
+}
+//# sourceMappingURL=xattr.args.js.map

package/dist/builtins/fs/xattr.args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xattr.args.js","sourceRoot":"","sources":["../../../src/builtins/fs/xattr.args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,wCAAwC;AACxC,MAAM,CAAC,MAAM,SAAS,GAAW,KAAK,CAAC;AAEvC,iCAAiC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAW,gGAAgG,CAAC;AAEvI,iCAAiC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAW,8CAA8C,CAAC;AAkBrF;;;;;GAKG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,SAAS,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA2B;IAC5D,IAAI,IAAI,GAA4B,IAAI,CAAC;IACzC,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,KAAa,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAW,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACnF,MAAM,KAAK,GAAuB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,qBAAqB,KAAK,2BAA2B,cAAc,EAAE,CAAC,CAAC;YAC5G,IAAI,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/D,IAAI,GAAG,KAAK,CAAC;YACb,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,KAAK,GAAuB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,qBAAqB,KAAK,2BAA2B,cAAc,EAAE,CAAC,CAAC;YAC5G,KAAK,GAAG,KAAK,CAAC;YACd,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,gCAAgC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,aAAa,IAAI,+DAA+D,CAAC,CAAC;IACrH,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC,gBAAgB,IAAI,sBAAsB,cAAc,EAAE,CAAC,CAAC;IACvI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA2B;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAW,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,KAAK,GAAuB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,qBAAqB,KAAK,2BAA2B,cAAc,EAAE,EAAE,CAAC;YAC5H,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,KAAK,yDAAyD,EAAE,CAAC;YACjI,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,SAAS;QACX,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,gCAAgC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,cAAc,EAAE,EAAE,CAAC;QAC9G,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACpE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,IAAI,GAAkB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,SAAS,GAA4B,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtF,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAA2B;IACpE,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,SAAS,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5H,CAAC"}

package/dist/builtins/fs/xattr.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @file `setfattr` and `getfattr` — a feed's tags.
+ *
+ * CUBE's freeform tags on a feed are, in POSIX terms, the values of one
+ * extended attribute, `tag`. The capability lives in the kernel
+ * (`feedTags_list`, `feedTag_add`, `feedTag_remove`); this is its shell face.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/**
+ * Reads the tags a feed wears, in `getfattr`'s dump shape.
+ *
+ * @param args - Raw argument tokens.
+ * @returns An envelope carrying the rendered blocks and a model of them.
+ */
+export declare function builtin_getfattr(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Hangs a tag on feeds (`-n tag -v <value>`), or takes one off (`-x tag -v
+ * <value>`), or takes every tag off (`-x tag`, as setfattr removes the
+ * whole attribute). Silent on success, as setfattr is; a refusal is named.
+ *
+ * @param args - Raw argument tokens.
+ * @returns An envelope, empty on success.
+ */
+export declare function builtin_setfattr(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/fs/xattr.js

@@ -0,0 +1,98 @@
+/**
+ * @file `setfattr` and `getfattr` — a feed's tags.
+ *
+ * CUBE's freeform tags on a feed are, in POSIX terms, the values of one
+ * extended attribute, `tag`. The capability lives in the kernel
+ * (`feedTags_list`, `feedTag_add`, `feedTag_remove`); this is its shell face.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error, errorStack, feedTags_list, feedTag_add, feedTag_remove, } from '@fnndsc/cumin';
+import { getfattrArgs_parse, setfattrArgs_parse, xattrTarget_resolve, xattr_render, } from './xattr.args.js';
+import { error_stripDebugPrefix } from '../utils.js';
+/**
+ * A refusal, on a line of its own.
+ *
+ * @param message - What was refused, and why.
+ * @returns The error envelope.
+ */
+function refusal(message) {
+    return envelope_error(`${message}\n`);
+}
+/**
+ * The kernel's last word, or a fallback.
+ *
+ * @param fallback - What to say when the kernel said nothing.
+ * @returns The message.
+ */
+function error_said(fallback) {
+    const error = errorStack.stack_pop();
+    return error?.message ?? fallback;
+}
+/**
+ * Reads the tags a feed wears, in `getfattr`'s dump shape.
+ *
+ * @param args - Raw argument tokens.
+ * @returns An envelope carrying the rendered blocks and a model of them.
+ */
+export async function builtin_getfattr(args) {
+    const parsed = getfattrArgs_parse(args);
+    if (parsed.error !== null)
+        return refusal(parsed.error);
+    const blocks = [];
+    const model = [];
+    for (const path of parsed.paths) {
+        const feedId = xattrTarget_resolve(path);
+        if (feedId === null)
+            return refusal(`getfattr: '${path}' does not name a feed`);
+        const held = await feedTags_list(feedId);
+        if (!held.ok)
+            return refusal(error_said(`getfattr: could not read the tags of feed ${feedId}`));
+        const tags = held.value.map((tag) => tag.name);
+        blocks.push(xattr_render(path, tags));
+        model.push({ path, feedId, tags });
+    }
+    return envelope_ok(`${blocks.join('\n\n')}\n`, { kind: 'fs.xattr', data: model });
+}
+/**
+ * Hangs a tag on feeds (`-n tag -v <value>`), or takes one off (`-x tag -v
+ * <value>`), or takes every tag off (`-x tag`, as setfattr removes the
+ * whole attribute). Silent on success, as setfattr is; a refusal is named.
+ *
+ * @param args - Raw argument tokens.
+ * @returns An envelope, empty on success.
+ */
+export async function builtin_setfattr(args) {
+    const parsed = setfattrArgs_parse(args);
+    if (parsed.error !== null)
+        return refusal(parsed.error);
+    const changed = [];
+    for (const path of parsed.paths) {
+        const feedId = xattrTarget_resolve(path);
+        if (feedId === null)
+            return refusal(`setfattr: '${path}' does not name a feed`);
+        let names;
+        if (parsed.mode === 'remove' && parsed.value === null) {
+            const held = await feedTags_list(feedId);
+            if (!held.ok)
+                return refusal(error_said(`setfattr: could not read the tags of feed ${feedId}`));
+            names = held.value.map((tag) => tag.name);
+        }
+        else {
+            names = [parsed.value ?? ''];
+        }
+        for (const name of names) {
+            const done = parsed.mode === 'set' ? await feedTag_add(feedId, name) : await feedTag_remove(feedId, name);
+            if (!done.ok) {
+                const said = error_stripDebugPrefix(error_said(`could not ${parsed.mode === 'set' ? 'add' : 'remove'} tag ${name}`));
+                return refusal(`setfattr: ${path}: ${said}`);
+            }
+            if (parsed.mode === 'remove' && parsed.value !== null && !done.value) {
+                return refusal(`setfattr: ${path}: tag="${name}": No such attribute value`);
+            }
+            changed.push({ feedId, tag: name, done: done.value });
+        }
+    }
+    return envelope_ok('', { kind: 'fs.xattr.changed', data: { mode: parsed.mode, changed } });
+}
+//# sourceMappingURL=xattr.js.map

package/dist/builtins/fs/xattr.js.map

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