@fnndsc/salsa 3.2.4

package/dist/tags/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file Tag resource operations.
+ * @module
+ */
+import { FilteredResourceData, ListOptions } from '@fnndsc/cumin';
+/**
+ * Lists tags (single page).
+ *
+ * @param options - Search and pagination options.
+ */
+export declare function tags_list(options: ListOptions): Promise<FilteredResourceData | null>;
+/**
+ * Lists all tags across all pages.
+ *
+ * @param options - Search options (limit/offset managed internally).
+ */
+export declare function tags_listAll(options?: Partial<ListOptions>): Promise<FilteredResourceData | null>;
+/**
+ * Returns available field names for tags.
+ */
+export declare function tagFields_get(): Promise<string[] | null>;

package/dist/tags/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @file Tag resource operations.
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags_list = tags_list;
+exports.tags_listAll = tags_listAll;
+exports.tagFields_get = tagFields_get;
+const cumin_1 = require("@fnndsc/cumin");
+/**
+ * Lists tags (single page).
+ *
+ * @param options - Search and pagination options.
+ */
+async function tags_list(options) {
+    const group = new cumin_1.ChRISTagGroup();
+    return await group.asset.resources_listAndFilterByOptions(options);
+}
+/**
+ * Lists all tags across all pages.
+ *
+ * @param options - Search options (limit/offset managed internally).
+ */
+async function tags_listAll(options = {}) {
+    const group = new cumin_1.ChRISTagGroup();
+    return await group.asset.resources_getAll(options);
+}
+/**
+ * Returns available field names for tags.
+ */
+async function tagFields_get() {
+    const group = new cumin_1.ChRISTagGroup();
+    const result = await group.asset.resourceFields_get();
+    return result ? result.fields : null;
+}
+//# sourceMappingURL=index.js.map

package/dist/tags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tags/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AASH,8BAGC;AAOD,oCAGC;AAKD,sCAIC;AA7BD,yCAAiF;AAEjF;;;;GAIG;AACI,KAAK,UAAU,SAAS,CAAC,OAAoB;IAClD,MAAM,KAAK,GAAkB,IAAI,qBAAa,EAAE,CAAC;IACjD,OAAO,MAAM,KAAK,CAAC,KAAK,CAAC,gCAAgC,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAAC,UAAgC,EAAE;IACnE,MAAM,KAAK,GAAkB,IAAI,qBAAa,EAAE,CAAC;IACjD,OAAO,MAAM,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,aAAa;IACjC,MAAM,KAAK,GAAkB,IAAI,qBAAa,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;IACtD,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC"}

package/dist/vfs/dispatcher.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @file VFS Dispatcher Registry.
+ *
+ * Directs filesystem requests to the matched VFSProvider instance.
+ * Matches specific prefix paths first, falling back to Native.
+ *
+ * @module
+ */
+import { Result } from "@fnndsc/cumin";
+import { VFSProvider, VFSItem, CpOptions } from "./provider.js";
+/**
+ * Registry and dispatcher routing filesystem commands to matched VFS providers.
+ */
+export declare class VFSDispatcher {
+    private providers;
+    private defaultProvider;
+    private pathResolver?;
+    /**
+     * Initializes dispatcher and registers standard providers.
+     */
+    constructor();
+    /**
+     * Registers a path resolution hook that maps logical paths to physical paths.
+     *
+     * @param resolver - The resolver function mapping a logical path to a physical path.
+     */
+    pathResolver_register(resolver: (path: string) => Promise<string>): void;
+    /**
+     * Registers a new VFS Provider.
+     *
+     * @param provider - The provider instance to register.
+     */
+    provider_register(provider: VFSProvider): void;
+    /**
+     * Returns all registered providers (excluding the default native provider).
+     * Used by callers that need to detect parent-of-prefix paths.
+     */
+    providers_get(): VFSProvider[];
+    /**
+     * Resolves the matching provider for a given virtual path.
+     *
+     * @param pathStr - The absolute virtual path.
+     * @returns The matching VFSProvider or the default native provider.
+     */
+    provider_get(pathStr: string): VFSProvider;
+    /**
+     * Dispatches directory listing to matched provider.
+     * Supports dynamic intermediate parent path synthesis for virtual prefixes.
+     *
+     * @param pathStr - The absolute virtual path to list.
+     * @param options - Sort controls.
+     * @returns Promise resolving to Result<VFSItem[]>.
+     */
+    list(pathStr: string, options?: {
+        sort?: "name" | "size" | "date" | "owner";
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /**
+     * Dispatches copy operation to matched provider.
+     *
+     * @param src - Source path.
+     * @param dest - Destination path.
+     * @param options - Copy options.
+     * @returns Promise resolving to success boolean.
+     */
+    cp(src: string, dest: string, options: CpOptions): Promise<boolean>;
+    /**
+     * Dispatches file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a string.
+     */
+    read(pathStr: string): Promise<Result<string>>;
+    /**
+     * Dispatches binary file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    readBinary(pathStr: string): Promise<Result<Buffer>>;
+}
+/** Global instance of VFSDispatcher singleton. */
+export declare const vfsDispatcher: VFSDispatcher;

package/dist/vfs/dispatcher.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * @file VFS Dispatcher Registry.
+ *
+ * Directs filesystem requests to the matched VFSProvider instance.
+ * Matches specific prefix paths first, falling back to Native.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vfsDispatcher = exports.VFSDispatcher = void 0;
+const cumin_1 = require("@fnndsc/cumin");
+const native_js_1 = require("./providers/native.js");
+const pacs_js_1 = require("./providers/pacs.js");
+const etc_js_1 = require("./providers/etc.js");
+const proc_js_1 = require("./providers/proc.js");
+/**
+ * Registry and dispatcher routing filesystem commands to matched VFS providers.
+ */
+class VFSDispatcher {
+    providers = [];
+    defaultProvider;
+    pathResolver;
+    /**
+     * Initializes dispatcher and registers standard providers.
+     */
+    constructor() {
+        this.defaultProvider = new native_js_1.NativeVfsProvider();
+        this.provider_register(new pacs_js_1.PacsVfsProvider());
+        this.provider_register(new etc_js_1.EtcVfsProvider());
+        this.provider_register(new proc_js_1.ProcVfsProvider());
+    }
+    /**
+     * Registers a path resolution hook that maps logical paths to physical paths.
+     *
+     * @param resolver - The resolver function mapping a logical path to a physical path.
+     */
+    pathResolver_register(resolver) {
+        this.pathResolver = resolver;
+    }
+    /**
+     * Registers a new VFS Provider.
+     *
+     * @param provider - The provider instance to register.
+     */
+    provider_register(provider) {
+        this.providers.push(provider);
+        // Sort by prefix length descending to match most specific prefix first
+        this.providers.sort((a, b) => b.prefix.length - a.prefix.length);
+    }
+    /**
+     * Returns all registered providers (excluding the default native provider).
+     * Used by callers that need to detect parent-of-prefix paths.
+     */
+    providers_get() {
+        return [...this.providers];
+    }
+    /**
+     * Resolves the matching provider for a given virtual path.
+     *
+     * @param pathStr - The absolute virtual path.
+     * @returns The matching VFSProvider or the default native provider.
+     */
+    provider_get(pathStr) {
+        const absolutePath = pathStr.startsWith("/") ? pathStr : "/" + pathStr;
+        const match = this.providers.find((p) => absolutePath === p.prefix || absolutePath.startsWith(p.prefix + "/"));
+        return match || this.defaultProvider;
+    }
+    /**
+     * Dispatches directory listing to matched provider.
+     * Supports dynamic intermediate parent path synthesis for virtual prefixes.
+     *
+     * @param pathStr - The absolute virtual path to list.
+     * @param options - Sort controls.
+     * @returns Promise resolving to Result<VFSItem[]>.
+     */
+    async list(pathStr, options) {
+        const absolutePath = pathStr.startsWith("/") ? pathStr : "/" + pathStr;
+        const cleanPath = absolutePath.endsWith("/") && absolutePath.length > 1 ? absolutePath.slice(0, -1) : absolutePath;
+        // Check if cleanPath is a parent of any registered provider's prefix
+        const prefixParent = cleanPath === "/" ? "/" : cleanPath + "/";
+        const children = this.providers.filter((p) => p.prefix.startsWith(prefixParent));
+        if (children.length > 0) {
+            const segmentIndex = cleanPath === "/" ? 1 : cleanPath.split("/").length;
+            const virtualSubdirs = new Set();
+            for (const p of children) {
+                const segments = p.prefix.split("/");
+                const nextSegment = segments[segmentIndex];
+                if (nextSegment) {
+                    virtualSubdirs.add(nextSegment);
+                }
+            }
+            if (virtualSubdirs.size > 0) {
+                const vfsItems = Array.from(virtualSubdirs).map((name) => ({
+                    name,
+                    type: "vfs",
+                    size: 0,
+                    owner: "root",
+                    date: new Date().toISOString(),
+                }));
+                // Query the default provider to see if there are any native items in this folder
+                let resolvedPathStr = pathStr;
+                if (this.pathResolver) {
+                    try {
+                        resolvedPathStr = await this.pathResolver(pathStr);
+                    }
+                    catch (e) {
+                        // Fall back cleanly to the original path on failure
+                    }
+                }
+                const nativeResult = await this.defaultProvider.list(resolvedPathStr, options);
+                if (nativeResult.ok && nativeResult.value) {
+                    const nativeItems = nativeResult.value;
+                    for (const item of nativeItems) {
+                        if (!virtualSubdirs.has(item.name)) {
+                            vfsItems.push(item);
+                        }
+                    }
+                }
+                return (0, cumin_1.Ok)(vfsItems);
+            }
+        }
+        const provider = this.provider_get(pathStr);
+        if (provider === this.defaultProvider && this.pathResolver) {
+            try {
+                const resolvedPath = await this.pathResolver(pathStr);
+                return provider.list(resolvedPath, options);
+            }
+            catch (e) {
+                // Fall back cleanly to the original path on failure
+            }
+        }
+        return provider.list(pathStr, options);
+    }
+    /**
+     * Dispatches copy operation to matched provider.
+     *
+     * @param src - Source path.
+     * @param dest - Destination path.
+     * @param options - Copy options.
+     * @returns Promise resolving to success boolean.
+     */
+    async cp(src, dest, options) {
+        const provider = this.provider_get(src);
+        if (provider === this.defaultProvider && this.pathResolver) {
+            let resolvedSrc = src;
+            let resolvedDest = dest;
+            try {
+                resolvedSrc = await this.pathResolver(src);
+            }
+            catch (e) { }
+            try {
+                resolvedDest = await this.pathResolver(dest);
+            }
+            catch (e) { }
+            return provider.cp(resolvedSrc, resolvedDest, options);
+        }
+        return provider.cp(src, dest, options);
+    }
+    /**
+     * Dispatches file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a string.
+     */
+    async read(pathStr) {
+        const provider = this.provider_get(pathStr);
+        if (provider !== this.defaultProvider && provider.read) {
+            return provider.read(pathStr);
+        }
+        cumin_1.errorStack.stack_push("error", `File read not supported for path: ${pathStr}`);
+        return (0, cumin_1.Err)();
+    }
+    /**
+     * Dispatches binary file read operation to the matched provider.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    async readBinary(pathStr) {
+        const provider = this.provider_get(pathStr);
+        if (provider !== this.defaultProvider && provider.readBinary) {
+            return provider.readBinary(pathStr);
+        }
+        cumin_1.errorStack.stack_push("error", `Binary file read not supported for path: ${pathStr}`);
+        return (0, cumin_1.Err)();
+    }
+}
+exports.VFSDispatcher = VFSDispatcher;
+/** Global instance of VFSDispatcher singleton. */
+exports.vfsDispatcher = new VFSDispatcher();
+//# sourceMappingURL=dispatcher.js.map

package/dist/vfs/dispatcher.js.map

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

package/dist/vfs/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file VFS module exports.
+ * @module
+ */
+export * from "./provider.js";
+export * from "./dispatcher.js";
+export * from "./providers/native.js";
+export * from "./providers/pacs.js";
+export * from "./providers/etc.js";

package/dist/vfs/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * @file VFS module exports.
+ * @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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./provider.js"), exports);
+__exportStar(require("./dispatcher.js"), exports);
+__exportStar(require("./providers/native.js"), exports);
+__exportStar(require("./providers/pacs.js"), exports);
+__exportStar(require("./providers/etc.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/vfs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vfs/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,kDAAgC;AAChC,wDAAsC;AACtC,sDAAoC;AACpC,qDAAmC"}

package/dist/vfs/provider.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @file VFS Provider contracts and item interfaces.
+ *
+ * Defines the standard VFSItem, CpOptions, and VFSProvider interfaces
+ * to support extensible virtual file systems.
+ *
+ * @module
+ */
+import { Result } from "@fnndsc/cumin";
+/**
+ * Standard interface representing a virtual file system item.
+ */
+export interface VFSItem {
+    /** The display name of the item. */
+    name: string;
+    /** The type of the item. */
+    type: "dir" | "file" | "link" | "plugin" | "pipeline" | "vfs" | "job";
+    /** Size in bytes. */
+    size: number;
+    /** Username of the owner. */
+    owner: string;
+    /** Creation date (ISO string). */
+    date: string;
+    /** Target path (for links). */
+    target?: string;
+    /** Version string (for plugins). */
+    version?: string;
+    /** Title or description (for feeds, queries). */
+    title?: string;
+    /** Execution status (for job type items). */
+    status?: string;
+}
+/**
+ * Options for VFS copy operations.
+ */
+export interface CpOptions {
+    /** Recursively copy subdirectories. */
+    recursive?: boolean;
+}
+/**
+ * Base contract that every Virtual File System Provider must implement.
+ */
+export interface VFSProvider {
+    /** The path prefix this provider matches (e.g. '/pacs', '/bin', '/'). */
+    prefix: string;
+    /**
+     * Lists the contents of a directory matching this provider.
+     *
+     * @param path - The absolute virtual directory path.
+     * @param options - Optional sorting controls.
+     * @returns A Promise resolving to a Result containing VFSItems.
+     */
+    list(path: string, options?: {
+        sort?: "name" | "size" | "date" | "owner";
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /**
+     * Copies files or folders from/to paths under this provider.
+     *
+     * @param src - The absolute source path.
+     * @param dest - The absolute destination path.
+     * @param options - Copy flags like recursive.
+     * @returns A Promise resolving to true on successful copy execution.
+     */
+    cp(src: string, dest: string, options: CpOptions): Promise<boolean>;
+    /**
+     * Reads the content of a virtual file under this provider as a string.
+     *
+     * @param path - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a string.
+     */
+    read?(path: string): Promise<Result<string>>;
+    /**
+     * Reads the content of a virtual file under this provider as a binary Buffer.
+     *
+     * @param path - The absolute virtual path of the file to read.
+     * @returns A Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    readBinary?(path: string): Promise<Result<Buffer>>;
+}

package/dist/vfs/provider.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * @file VFS Provider contracts and item interfaces.
+ *
+ * Defines the standard VFSItem, CpOptions, and VFSProvider interfaces
+ * to support extensible virtual file systems.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=provider.js.map

package/dist/vfs/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/vfs/provider.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/vfs/providers/etc.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @file /etc virtual filesystem provider.
+ *
+ * Exposes ChRIS resources as Unix-style /etc files:
+ *   /etc/compute.yaml  — compute resources (YAML)
+ *   /etc/group         — groups (/etc/group format)
+ *   /etc/passwd        — current user (/etc/passwd format)
+ *   /etc/cube          — CUBE connection info (YAML)
+ *
+ * @module
+ */
+import { Result } from '@fnndsc/cumin';
+import { VFSProvider, VFSItem, CpOptions } from '../provider.js';
+/**
+ * VFS provider for /etc — maps ChRIS API resources to Unix-style config files.
+ */
+export declare class EtcVfsProvider implements VFSProvider {
+    prefix: string;
+    /**
+     * Lists contents of /etc — the four virtual config files.
+     *
+     * @param path - Must be '/etc'.
+     * @returns VFSItems for each /etc file.
+     */
+    list(_path: string, _options?: {
+        sort?: 'name' | 'size' | 'date' | 'owner';
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /**
+     * Read is not supported for /etc as a directory — individual files via read().
+     */
+    cp(_src: string, _dest: string, _options: CpOptions): Promise<boolean>;
+    /**
+     * Reads a virtual /etc file and returns its content as a string.
+     *
+     * @param path - Absolute path like /etc/compute.yaml.
+     * @returns File content string or Err.
+     */
+    read(path: string): Promise<Result<string>>;
+    private computeYaml_render;
+    private group_render;
+    private passwd_render;
+    private cube_render;
+}

package/dist/vfs/providers/etc.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * @file /etc virtual filesystem provider.
+ *
+ * Exposes ChRIS resources as Unix-style /etc files:
+ *   /etc/compute.yaml  — compute resources (YAML)
+ *   /etc/group         — groups (/etc/group format)
+ *   /etc/passwd        — current user (/etc/passwd format)
+ *   /etc/cube          — CUBE connection info (YAML)
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EtcVfsProvider = void 0;
+const cumin_1 = require("@fnndsc/cumin");
+const cumin_2 = require("@fnndsc/cumin");
+/** Virtual files exposed under /etc. */
+const ETC_FILES = ['compute.yaml', 'group', 'passwd', 'cube'];
+/**
+ * VFS provider for /etc — maps ChRIS API resources to Unix-style config files.
+ */
+class EtcVfsProvider {
+    prefix = '/etc';
+    /**
+     * Lists contents of /etc — the four virtual config files.
+     *
+     * @param path - Must be '/etc'.
+     * @returns VFSItems for each /etc file.
+     */
+    async list(_path, _options) {
+        const now = new Date().toISOString();
+        const items = ETC_FILES.map((name) => ({
+            name,
+            type: 'file',
+            size: 0,
+            owner: 'root',
+            date: now,
+        }));
+        return (0, cumin_1.Ok)(items);
+    }
+    /**
+     * Read is not supported for /etc as a directory — individual files via read().
+     */
+    async cp(_src, _dest, _options) {
+        cumin_1.errorStack.stack_push('error', 'cp: /etc is a read-only virtual directory');
+        return false;
+    }
+    /**
+     * Reads a virtual /etc file and returns its content as a string.
+     *
+     * @param path - Absolute path like /etc/compute.yaml.
+     * @returns File content string or Err.
+     */
+    async read(path) {
+        const filename = path.split('/').pop() ?? '';
+        switch (filename) {
+            case 'compute.yaml':
+                return this.computeYaml_render();
+            case 'group':
+                return this.group_render();
+            case 'passwd':
+                return this.passwd_render();
+            case 'cube':
+                return this.cube_render();
+            default:
+                cumin_1.errorStack.stack_push('error', `${path}: No such file`);
+                return (0, cumin_1.Err)();
+        }
+    }
+    async computeYaml_render() {
+        const result = await (0, cumin_2.computeResources_getAll)();
+        if (!result.ok)
+            return (0, cumin_1.Err)();
+        const lines = ['# ChRIS compute resources'];
+        if (result.value.length === 0) {
+            lines.push('# (none)');
+        }
+        else {
+            for (const r of result.value) {
+                lines.push(`- id: ${r.id}`);
+                lines.push(`  name: ${r.name}`);
+                lines.push(`  compute_url: ${r.compute_url ?? ''}`);
+                if (r.description)
+                    lines.push(`  description: ${r.description}`);
+            }
+        }
+        return (0, cumin_1.Ok)(lines.join('\n') + '\n');
+    }
+    async group_render() {
+        const result = await (0, cumin_2.groups_getAll)();
+        if (!result.ok)
+            return (0, cumin_1.Err)();
+        const lines = result.value.map((g) => `${g.name}:x:${g.id}:`);
+        return (0, cumin_1.Ok)(lines.join('\n') + '\n');
+    }
+    async passwd_render() {
+        const result = await (0, cumin_2.currentUser_get)();
+        if (!result.ok)
+            return (0, cumin_1.Err)();
+        const u = result.value;
+        const uid = u.id ?? 0;
+        const home = `/home/${u.username}`;
+        const gecos = u.email ?? '';
+        const line = `${u.username}:x:${uid}:${uid}:${gecos}:${home}:chell`;
+        return (0, cumin_1.Ok)(line + '\n');
+    }
+    async cube_render() {
+        const url = await cumin_2.chrisContext.ChRISURL_get();
+        const user = await cumin_2.chrisContext.ChRISuser_get();
+        const lines = [
+            '# ChRIS CUBE connection',
+            `url: ${url ?? '(not connected)'}`,
+            `user: ${user ?? '(not connected)'}`,
+        ];
+        return (0, cumin_1.Ok)(lines.join('\n') + '\n');
+    }
+}
+exports.EtcVfsProvider = EtcVfsProvider;
+//# sourceMappingURL=etc.js.map

package/dist/vfs/providers/etc.js.map

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