@fnndsc/salsa 4.5.3 → 4.5.5

package/dist/files/fileLookup.d.ts

@@ -1,9 +1,23 @@
 import { Result } from '@fnndsc/cumin';
+/**
+ * Runs work in which each folder's file ids are listed once: a transfer of
+ * many files. A scope inside a scope shares the outer one.
+ *
+ * @param operation - The work.
+ * @returns What the work returns.
+ *
+ * @example
+ * ```ts
+ * const ids: number[] = await fileIds_memoRun(async () => resolveAll(paths));
+ * ```
+ */
+export declare function fileIds_memoRun<T>(operation: () => Promise<T>): Promise<T>;
 /**
  * Resolves an absolute ChRIS file path to its numeric file id.
  *
  * Lists the parent directory and matches on basename, tolerating the `? <name>`
- * placeholder form the API sometimes returns.
+ * placeholder form the API sometimes returns. Inside {@link fileIds_memoRun}
+ * the listing is the transfer's, made once per folder.
  *
  * @param filePath - Absolute ChRIS file path.
  * @returns Ok(fileId), or Err (with a message pushed to errorStack) on failure.

package/dist/files/fileLookup.js

@@ -33,20 +33,106 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileIds_memoRun = fileIds_memoRun;
 exports.pathFileId_resolve = pathFileId_resolve;
 /**
  * @file Resolve an absolute ChRIS file path to its numeric file id.
  *
+ * CUBE reads a file by id, and the id comes from listing the file's folder.
+ * One file read lists its folder once; a transfer of a whole folder would
+ * list that folder again for every file in it (223 files, 223 listings of
+ * 223 rows). A transfer runs inside {@link fileIds_memoRun}, where each
+ * folder is listed once and every file in it, in flight together or one
+ * after another, takes its id from that listing. Outside a transfer nothing
+ * is kept, so a read after an edit always lists afresh.
+ *
+ * Key components:
+ * - pathFileId_resolve: a file path's id.
+ * - fileIds_memoRun: runs work in which each folder's ids are listed once.
+ *
+ * Typical usage:
+ * ```ts
+ * await fileIds_memoRun(async () => {
+ *   for (const path of paths) await pathFileId_resolve(path);
+ * });
+ * ```
+ *
+ * Dependencies: cumin's file browser groups.
+ *
  * @module
  */
+const node_async_hooks_1 = require("node:async_hooks");
 const path = __importStar(require("path"));
 const cumin_1 = require("@fnndsc/cumin");
 const index_js_1 = require("./index.js");
+/** The memo of the transfer running on this async path, when one is. */
+const memoScope = new node_async_hooks_1.AsyncLocalStorage();
+/**
+ * Runs work in which each folder's file ids are listed once: a transfer of
+ * many files. A scope inside a scope shares the outer one.
+ *
+ * @param operation - The work.
+ * @returns What the work returns.
+ *
+ * @example
+ * ```ts
+ * const ids: number[] = await fileIds_memoRun(async () => resolveAll(paths));
+ * ```
+ */
+async function fileIds_memoRun(operation) {
+    if (memoScope.getStore() !== undefined)
+        return operation();
+    return memoScope.run(new Map(), operation);
+}
+/**
+ * Lists one folder's files by basename.
+ *
+ * @param dir - The folder.
+ * @returns The ids by basename (null for a row with no id), or why it could not be listed.
+ */
+async function folderIds_list(dir) {
+    const group = await (0, index_js_1.files_getGroup)('files', dir);
+    if (!group)
+        return { refused: '' };
+    const results = await group.asset.resources_getAll();
+    if (!results || !results.tableData)
+        return { refused: `No files found in directory: ${dir}` };
+    const ids = new Map();
+    for (const row of results.tableData) {
+        const basename = path.posix.basename(row.fname || '');
+        const name = basename.startsWith('? ') ? basename.slice(2) : basename;
+        if (!ids.has(name))
+            ids.set(name, typeof row.id === 'number' ? row.id : null);
+    }
+    return { ids };
+}
+/**
+ * One folder's ids: from the transfer's memo when one runs, else listed now.
+ * A folder that could not be listed is not kept, so a retry lists again.
+ *
+ * @param dir - The folder.
+ * @returns Its ids, or why it could not be listed.
+ */
+async function folderIds_get(dir) {
+    const memo = memoScope.getStore();
+    if (memo === undefined)
+        return folderIds_list(dir);
+    const kept = memo.get(dir);
+    if (kept !== undefined)
+        return kept;
+    const listing = folderIds_list(dir);
+    memo.set(dir, listing);
+    const answer = await listing;
+    if ('refused' in answer)
+        memo.delete(dir);
+    return answer;
+}
 /**
  * Resolves an absolute ChRIS file path to its numeric file id.
  *
  * Lists the parent directory and matches on basename, tolerating the `? <name>`
- * placeholder form the API sometimes returns.
+ * placeholder form the API sometimes returns. Inside {@link fileIds_memoRun}
+ * the listing is the transfer's, made once per folder.
  *
  * @param filePath - Absolute ChRIS file path.
  * @returns Ok(fileId), or Err (with a message pushed to errorStack) on failure.
@@ -54,27 +140,21 @@ const index_js_1 = require("./index.js");
 async function pathFileId_resolve(filePath) {
     const dir = path.posix.dirname(filePath);
     const name = path.posix.basename(filePath);
-    const group = await (0, index_js_1.files_getGroup)('files', dir);
-    if (!group) {
-        return (0, cumin_1.Err)();
-    }
-    const results = await group.asset.resources_getAll();
-    if (!results || !results.tableData) {
-        cumin_1.errorStack.stack_push('error', `No files found in directory: ${dir}`);
+    const folder = await folderIds_get(dir);
+    if ('refused' in folder) {
+        if (folder.refused !== '')
+            cumin_1.errorStack.stack_push('error', folder.refused);
         return (0, cumin_1.Err)();
     }
-    const file = results.tableData.find((f) => {
-        const basename = path.posix.basename(f.fname || '');
-        return basename === name || basename === `? ${name}`;
-    });
-    if (!file) {
+    if (!folder.ids.has(name)) {
         cumin_1.errorStack.stack_push('error', `File not found: ${name} in ${dir}`);
         return (0, cumin_1.Err)();
     }
-    if (typeof file.id !== 'number') {
+    const id = folder.ids.get(name);
+    if (typeof id !== 'number') {
         cumin_1.errorStack.stack_push('error', `File has no valid ID: ${name}`);
         return (0, cumin_1.Err)();
     }
-    return (0, cumin_1.Ok)(file.id);
+    return (0, cumin_1.Ok)(id);
 }
 //# sourceMappingURL=fileLookup.js.map

package/dist/files/fileLookup.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileLookup.js","sourceRoot":"","sources":["../../src/files/fileLookup.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,gDA+BC;AA/DD;;;;GAIG;AACH,2CAA6B;AAC7B,yCAQuB;AACvB,yCAA4C;AAQ5C;;;;;;;;GAQG;AACI,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,GAAG,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,IAAI,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAqD,MAAM,IAAA,yBAAc,EAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnG,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAA,WAAG,GAAE,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAgC,MAAM,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;IAClF,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACnC,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,gCAAgC,GAAG,EAAE,CAAC,CAAC;QACtE,OAAO,IAAA,WAAG,GAAE,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAyB,OAAO,CAAC,SAAuB,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE;QACrF,MAAM,QAAQ,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,KAAK,IAAI,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,IAAI,OAAO,GAAG,EAAE,CAAC,CAAC;QACpE,OAAO,IAAA,WAAG,GAAE,CAAC;IACf,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAChC,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,yBAAyB,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,IAAA,WAAG,GAAE,CAAC;IACf,CAAC;IAED,OAAO,IAAA,UAAE,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"fileLookup.js","sourceRoot":"","sources":["../../src/files/fileLookup.ts"],"names":[],"mappings":"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"}

package/dist/files/pathMapper.d.ts

@@ -0,0 +1,237 @@
+/**
+ * @file Singleton path mapper for logical-to-physical ChRIS path resolution.
+ *
+ * Maintains a cached mapping of logical paths to physical locations,
+ * enabling incremental resolution by reusing cached path prefixes.
+ *
+ * Example:
+ *   - First call: '/home/user/public/feed_4' → Full resolution, cache prefix
+ *   - Second call: '/home/user/public/feed_5' → Reuse '/home/user/public', resolve only 'feed_5'
+ *
+ * This eliminates redundant tree walking and API calls for paths with common prefixes.
+ *
+ * It is CUBE's own mechanics (a `.chrislink` is a file CUBE lists among a
+ * folder's links), so it lives with the file reads. The kernel asks it
+ * through one door: the ChRIS backend's link walk, which brasa's
+ * `storePath_resolve` calls for every file command.
+ *
+ * @module
+ */
+import { Result } from '@fnndsc/cumin';
+/**
+ * Statistics for cache performance monitoring.
+ */
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    hitRate: number;
+}
+/**
+ * Singleton PathMapper class for logical-to-physical path resolution.
+ *
+ * Maintains hierarchical cache of path mappings to minimize repeated
+ * link resolution operations.
+ *
+ * @example
+ * ```typescript
+ * const mapper = PathMapper.instance_get();
+ *
+ * // First resolution
+ * const result1 = await mapper.logicalPath_resolve('/home/user/public/feed_4');
+ * // → Resolves /home/user/public → /SHARED, then feed_4
+ * // → Caches intermediate mappings
+ *
+ * // Second resolution - prefix reuse
+ * const result2 = await mapper.logicalPath_resolve('/home/user/public/feed_5');
+ * // → Reuses cached '/home/user/public' → '/SHARED'
+ * // → Resolves only 'feed_5'
+ * ```
+ */
+export declare class PathMapper {
+    private static instance;
+    private cache;
+    private readonly defaultTTL;
+    private stats;
+    /** Walked paths whose parent could not be asked for links, by the parent. */
+    private blind;
+    /** Parents found blind by resolutions since the last {@link blindParents_take}. */
+    private blindSeen;
+    /**
+     * Private constructor enforces singleton pattern.
+     */
+    private constructor();
+    /**
+     * Gets the singleton PathMapper instance.
+     *
+     * @returns The singleton PathMapper instance.
+     */
+    static instance_get(): PathMapper;
+    /**
+     * Resets the singleton instance (for testing).
+     *
+     * @internal
+     */
+    static instance_reset(): void;
+    /**
+     * Resolves a logical path to its physical location.
+     *
+     * Uses cached path prefixes when available, resolving only the
+     * uncached suffix to minimize API calls.
+     *
+     * @param logicalPath - The logical path to resolve.
+     * @returns Result containing the physical path, or Err on failure.
+     *
+     * @example
+     * ```typescript
+     * const mapper = PathMapper.instance_get();
+     *
+     * // First call: full resolution
+     * const result1 = await mapper.logicalPath_resolve('/home/user/public/feed_4');
+     * // → Resolves /home/user/public → /SHARED, then feed_4
+     * // → Caches: '/home/user/public' → '/SHARED'
+     * // → Caches: '/home/user/public/feed_4' → '/SHARED/feed_4'
+     *
+     * // Second call: prefix reuse
+     * const result2 = await mapper.logicalPath_resolve('/home/user/public/feed_5');
+     * // → Reuses cached '/home/user/public' → '/SHARED'
+     * // → Resolves only 'feed_5'
+     * ```
+     */
+    logicalPath_resolve(logicalPath: string): Promise<Result<string>>;
+    /**
+     * Finds the longest cached prefix of a logical path.
+     *
+     * Walks up the path hierarchy to find the deepest cached mapping,
+     * returning the cached physical prefix and remaining suffix.
+     *
+     * @param logicalPath - The full logical path.
+     * @returns Object with cached prefix and remaining suffix.
+     *
+     * @example
+     * ```typescript
+     * // Cache contains: '/home/user/public' → '/SHARED'
+     * const result = mapper.longestCachedPrefix_find('/home/user/public/feed_4/files');
+     * // Returns:
+     * // {
+     * //   prefixLogical: '/home/user/public',
+     * //   prefixPhysical: '/SHARED',
+     * //   suffix: 'feed_4/files'
+     * // }
+     * ```
+     */
+    private longestCachedPrefix_find;
+    /**
+     * Resolves a path suffix by checking each component for links.
+     *
+     * Walks the suffix path, checking each component to see if it's a link.
+     * Caches intermediate mappings along the way for future prefix reuse.
+     *
+     * @param suffix - The path suffix to resolve (e.g., 'feed_4/files').
+     * @param physicalBase - The physical base path to build upon.
+     * @param logicalBase - The logical base path (for caching intermediate results).
+     * @returns Result containing the resolved physical path.
+     */
+    private suffix_resolve;
+    /**
+     * Checks if a path is a link and returns its target.
+     *
+     * Optimizes resolution by checking ListCache first. If the parent directory
+     * is cached, we can determine if the candidate is a link without an API call.
+     * Falls back to API (fetching all links in parent) if not cached.
+     *
+     * @param candidatePhysical - The physical path to check.
+     * @param candidateLogical - The logical path (used for cache lookup).
+     * @returns The link target if it's a link, null otherwise.
+     */
+    private link_checkAndResolve;
+    /**
+     * Records the parents a resolution of this path walked past without
+     * seeing their links.
+     *
+     * @param logicalPath - The path just resolved.
+     */
+    private blind_note;
+    /**
+     * The parents whose links could not be read by the resolutions since the
+     * last call, emptied by the call. A command whose answer failed reports
+     * them: a link in one of them, had it been seen, would have led elsewhere.
+     *
+     * @returns The parents, in the order first met.
+     */
+    blindParents_take(): string[];
+    /**
+     * Gets a cached mapping if it exists and hasn't expired.
+     *
+     * @param logicalPath - The logical path to look up.
+     * @returns The cached physical path, or null if not cached or expired.
+     */
+    private cache_get;
+    /**
+     * Caches a logical-to-physical path mapping.
+     *
+     * @param logicalPath - The logical path.
+     * @param physicalPath - The corresponding physical path.
+     * @param ttl - Optional TTL in milliseconds (defaults to 30s).
+     */
+    private cache_set;
+    /**
+     * Invalidates all cached mappings with a given logical path prefix.
+     *
+     * Call this when links are created/deleted/modified.
+     *
+     * @param logicalPathPrefix - The logical path prefix to invalidate.
+     *
+     * @example
+     * ```typescript
+     * // Link changed: /home/user/public → /SHARED becomes → /PUBLIC
+     * mapper.cache_invalidate('/home/user/public');
+     * // Invalidates:
+     * //   - /home/user/public
+     * //   - /home/user/public/feed_4
+     * //   - /home/user/public/feed_5
+     * //   - ... etc
+     * ```
+     */
+    cache_invalidate(logicalPathPrefix: string): void;
+    /**
+     * Clears all cached mappings.
+     */
+    cache_clear(): void;
+    /**
+     * Gets cache statistics.
+     *
+     * @returns Cache statistics including hit rate and size.
+     */
+    stats_get(): CacheStats;
+}
+/**
+ * Convenience function to get the singleton PathMapper instance.
+ *
+ * @returns The singleton PathMapper instance.
+ */
+export declare function pathMapper_get(): PathMapper;
+/**
+ * Resolves a logical path to its physical path by following links.
+ *
+ * Delegates to the PathMapper singleton, which uses hierarchical caching to
+ * optimize repeated resolutions with common prefixes.
+ *
+ * @param logicalPath - The logical (apparent) path the user sees/navigates.
+ * @returns A Result containing the physical path, or Err if path is invalid.
+ *
+ * @example
+ * ```ts
+ * await logicalPath_resolve('/home/user/public/data'); // Ok('/PUBLIC/data') where public -> /PUBLIC
+ * ```
+ */
+export declare function logicalPath_resolve(logicalPath: string): Promise<Result<string>>;
+/**
+ * Clears the path mapping cache. Useful when links are created/deleted.
+ *
+ * @example
+ * ```ts
+ * linkCache_clear();
+ * ```
+ */
+export declare function linkCache_clear(): void;

package/dist/files/pathMapper.js

@@ -0,0 +1,503 @@
+"use strict";
+/**
+ * @file Singleton path mapper for logical-to-physical ChRIS path resolution.
+ *
+ * Maintains a cached mapping of logical paths to physical locations,
+ * enabling incremental resolution by reusing cached path prefixes.
+ *
+ * Example:
+ *   - First call: '/home/user/public/feed_4' → Full resolution, cache prefix
+ *   - Second call: '/home/user/public/feed_5' → Reuse '/home/user/public', resolve only 'feed_5'
+ *
+ * This eliminates redundant tree walking and API calls for paths with common prefixes.
+ *
+ * It is CUBE's own mechanics (a `.chrislink` is a file CUBE lists among a
+ * folder's links), so it lives with the file reads. The kernel asks it
+ * through one door: the ChRIS backend's link walk, which brasa's
+ * `storePath_resolve` calls for every file command.
+ *
+ * @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.PathMapper = void 0;
+exports.pathMapper_get = pathMapper_get;
+exports.logicalPath_resolve = logicalPath_resolve;
+exports.linkCache_clear = linkCache_clear;
+const cumin_1 = require("@fnndsc/cumin");
+const index_js_1 = require("./index.js");
+const path = __importStar(require("path"));
+const cumin_2 = require("@fnndsc/cumin");
+/**
+ * Singleton PathMapper class for logical-to-physical path resolution.
+ *
+ * Maintains hierarchical cache of path mappings to minimize repeated
+ * link resolution operations.
+ *
+ * @example
+ * ```typescript
+ * const mapper = PathMapper.instance_get();
+ *
+ * // First resolution
+ * const result1 = await mapper.logicalPath_resolve('/home/user/public/feed_4');
+ * // → Resolves /home/user/public → /SHARED, then feed_4
+ * // → Caches intermediate mappings
+ *
+ * // Second resolution - prefix reuse
+ * const result2 = await mapper.logicalPath_resolve('/home/user/public/feed_5');
+ * // → Reuses cached '/home/user/public' → '/SHARED'
+ * // → Resolves only 'feed_5'
+ * ```
+ */
+class PathMapper {
+    static instance = null;
+    cache = new Map();
+    defaultTTL = 30000; // 30 seconds
+    stats = { hits: 0, misses: 0 };
+    /** Walked paths whose parent could not be asked for links, by the parent. */
+    blind = new Map();
+    /** Parents found blind by resolutions since the last {@link blindParents_take}. */
+    blindSeen = new Set();
+    /**
+     * Private constructor enforces singleton pattern.
+     */
+    constructor() { }
+    /**
+     * Gets the singleton PathMapper instance.
+     *
+     * @returns The singleton PathMapper instance.
+     */
+    static instance_get() {
+        if (!PathMapper.instance) {
+            PathMapper.instance = new PathMapper();
+        }
+        return PathMapper.instance;
+    }
+    /**
+     * Resets the singleton instance (for testing).
+     *
+     * @internal
+     */
+    static instance_reset() {
+        PathMapper.instance = null;
+    }
+    /**
+     * Resolves a logical path to its physical location.
+     *
+     * Uses cached path prefixes when available, resolving only the
+     * uncached suffix to minimize API calls.
+     *
+     * @param logicalPath - The logical path to resolve.
+     * @returns Result containing the physical path, or Err on failure.
+     *
+     * @example
+     * ```typescript
+     * const mapper = PathMapper.instance_get();
+     *
+     * // First call: full resolution
+     * const result1 = await mapper.logicalPath_resolve('/home/user/public/feed_4');
+     * // → Resolves /home/user/public → /SHARED, then feed_4
+     * // → Caches: '/home/user/public' → '/SHARED'
+     * // → Caches: '/home/user/public/feed_4' → '/SHARED/feed_4'
+     *
+     * // Second call: prefix reuse
+     * const result2 = await mapper.logicalPath_resolve('/home/user/public/feed_5');
+     * // → Reuses cached '/home/user/public' → '/SHARED'
+     * // → Resolves only 'feed_5'
+     * ```
+     */
+    async logicalPath_resolve(logicalPath) {
+        // 1. Validate input
+        if (!logicalPath || typeof logicalPath !== 'string') {
+            cumin_1.errorStack.stack_push('error', 'Invalid path: path must be a non-empty string');
+            return (0, cumin_1.Err)();
+        }
+        // 2. Normalize path
+        const normalizedPath = logicalPath.startsWith('/')
+            ? logicalPath
+            : `/${logicalPath}`;
+        // 3. Check exact cache hit
+        const exactMatch = this.cache_get(normalizedPath);
+        if (exactMatch !== null) {
+            this.stats.hits++;
+            this.blind_note(normalizedPath);
+            return (0, cumin_1.Ok)(exactMatch);
+        }
+        // 4. Find longest cached prefix
+        const prefixMatch = this.longestCachedPrefix_find(normalizedPath);
+        // 5. Resolve suffix incrementally
+        const resolvedPhysical = await this.suffix_resolve(prefixMatch.suffix, prefixMatch.prefixPhysical, prefixMatch.prefixLogical);
+        this.blind_note(normalizedPath);
+        if (!resolvedPhysical.ok) {
+            this.stats.misses++;
+            return (0, cumin_1.Err)();
+        }
+        // 6. Cache the full resolution
+        this.cache_set(normalizedPath, resolvedPhysical.value);
+        this.stats.misses++;
+        return (0, cumin_1.Ok)(resolvedPhysical.value);
+    }
+    /**
+     * Finds the longest cached prefix of a logical path.
+     *
+     * Walks up the path hierarchy to find the deepest cached mapping,
+     * returning the cached physical prefix and remaining suffix.
+     *
+     * @param logicalPath - The full logical path.
+     * @returns Object with cached prefix and remaining suffix.
+     *
+     * @example
+     * ```typescript
+     * // Cache contains: '/home/user/public' → '/SHARED'
+     * const result = mapper.longestCachedPrefix_find('/home/user/public/feed_4/files');
+     * // Returns:
+     * // {
+     * //   prefixLogical: '/home/user/public',
+     * //   prefixPhysical: '/SHARED',
+     * //   suffix: 'feed_4/files'
+     * // }
+     * ```
+     */
+    longestCachedPrefix_find(logicalPath) {
+        const parts = logicalPath.split('/').filter((p) => p.length > 0);
+        // Walk down from full path to root
+        for (let i = parts.length; i >= 0; i--) {
+            const candidatePrefix = i === 0
+                ? '/'
+                : '/' + parts.slice(0, i).join('/');
+            const cached = this.cache_get(candidatePrefix);
+            if (cached !== null) {
+                const suffixParts = parts.slice(i);
+                const suffix = suffixParts.join('/');
+                return {
+                    prefixLogical: candidatePrefix,
+                    prefixPhysical: cached,
+                    suffix: suffix
+                };
+            }
+        }
+        // No cached prefix found, start from root
+        return {
+            prefixLogical: '/',
+            prefixPhysical: '/',
+            suffix: parts.join('/')
+        };
+    }
+    /**
+     * Resolves a path suffix by checking each component for links.
+     *
+     * Walks the suffix path, checking each component to see if it's a link.
+     * Caches intermediate mappings along the way for future prefix reuse.
+     *
+     * @param suffix - The path suffix to resolve (e.g., 'feed_4/files').
+     * @param physicalBase - The physical base path to build upon.
+     * @param logicalBase - The logical base path (for caching intermediate results).
+     * @returns Result containing the resolved physical path.
+     */
+    async suffix_resolve(suffix, physicalBase, logicalBase) {
+        if (!suffix || suffix.length === 0) {
+            return (0, cumin_1.Ok)(physicalBase);
+        }
+        const parts = suffix.split('/').filter((p) => p.length > 0);
+        let physicalCurrent = physicalBase;
+        let logicalCurrent = logicalBase;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const candidatePhysical = physicalCurrent === '/'
+                ? `/${part}`
+                : `${physicalCurrent}/${part}`;
+            const candidateLogical = logicalCurrent === '/'
+                ? `/${part}`
+                : `${logicalCurrent}/${part}`;
+            try {
+                const linkTarget = await this.link_checkAndResolve(candidatePhysical, candidateLogical);
+                if (linkTarget) {
+                    // It's a link! Jump to target
+                    physicalCurrent = linkTarget;
+                    logicalCurrent = candidateLogical;
+                    // Cache this intermediate mapping
+                    this.cache_set(candidateLogical, linkTarget);
+                }
+                else {
+                    // Not a link, continue building path
+                    physicalCurrent = candidatePhysical;
+                    logicalCurrent = candidateLogical;
+                    // Cache this intermediate mapping
+                    this.cache_set(candidateLogical, candidatePhysical);
+                }
+            }
+            catch (error) {
+                // Link resolution failed - log warning but continue
+                const msg = error instanceof Error ? error.message : String(error);
+                cumin_1.errorStack.stack_push('warning', `Failed to check if '${candidatePhysical}' is a link: ${msg}. Treating as regular path.`);
+                // Assume it's not a link and continue
+                physicalCurrent = candidatePhysical;
+                logicalCurrent = candidateLogical;
+                this.cache_set(candidateLogical, candidatePhysical);
+            }
+        }
+        return (0, cumin_1.Ok)(physicalCurrent);
+    }
+    /**
+     * Checks if a path is a link and returns its target.
+     *
+     * Optimizes resolution by checking ListCache first. If the parent directory
+     * is cached, we can determine if the candidate is a link without an API call.
+     * Falls back to API (fetching all links in parent) if not cached.
+     *
+     * @param candidatePhysical - The physical path to check.
+     * @param candidateLogical - The logical path (used for cache lookup).
+     * @returns The link target if it's a link, null otherwise.
+     */
+    async link_checkAndResolve(candidatePhysical, candidateLogical) {
+        // 1. Fast Path: Check ListCache using logical path
+        // If we have the parent directory cached, we can check if the item is a link there.
+        const logicalParent = path.dirname(candidateLogical);
+        const itemName = path.basename(candidateLogical);
+        const listCache = (0, cumin_2.listCache_get)();
+        const cached = listCache.cache_get(logicalParent);
+        if (cached && cached.data && Array.isArray(cached.data)) {
+            // Look for the item in the cached listing
+            const item = cached.data.find((i) => i.name === itemName);
+            if (item) {
+                // Item found in cache!
+                if (item.type === 'link' && item.target) {
+                    return item.target;
+                }
+                // Found but not a link (or has no target) -> return null
+                return null;
+            }
+            // Item not found in cache. 
+            // It might be hidden or newly created. Fall back to API.
+        }
+        // 2. Slow Path: Check API using physical path
+        const parts = candidatePhysical.split('/');
+        parts.pop(); // Remove filename
+        const parentDir = parts.join('/') || '/';
+        const normalizedCandidate = candidatePhysical.startsWith('/')
+            ? candidatePhysical
+            : `/${candidatePhysical}`;
+        // The probe is a side question: a parent this identity may not read (a
+        // shared feed's owner's home, walked on the way to the feed) says so on
+        // the error stack, and that refusal would mark the command it serves an
+        // error though its answer came. The refusal is kept here instead: the
+        // walk goes on as written, and a command whose answer then fails can say
+        // which parent's links went unchecked (blindParents_take).
+        const probeMark = cumin_1.errorStack.checkpoint_mark();
+        const fetchOpts = { limit: 1000, offset: 0 };
+        let linksResult = null;
+        let refused = false;
+        try {
+            linksResult = await (0, index_js_1.files_listAll)(fetchOpts, 'links', parentDir);
+        }
+        catch {
+            refused = true;
+        }
+        const said = cumin_1.errorStack.checkpoint_drain(probeMark);
+        if (refused || (linksResult === null && said.some((message) => message.type === 'error'))) {
+            this.blind.set(candidateLogical, parentDir);
+            return null;
+        }
+        this.blind.delete(candidateLogical);
+        if (linksResult && linksResult.tableData) {
+            for (const linkRaw of linksResult.tableData) {
+                const linkFname = linkRaw.fname || '';
+                const linkPath = linkRaw.path || '';
+                const normalizedLinkFname = linkFname.startsWith('/')
+                    ? linkFname
+                    : `/${linkFname}`;
+                if (normalizedLinkFname.endsWith('.chrislink')) {
+                    const logicalPath = normalizedLinkFname.slice(0, -10);
+                    if (logicalPath === normalizedCandidate) {
+                        const target = linkPath.startsWith('/') ? linkPath : `/${linkPath}`;
+                        return target;
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Records the parents a resolution of this path walked past without
+     * seeing their links.
+     *
+     * @param logicalPath - The path just resolved.
+     */
+    blind_note(logicalPath) {
+        for (const [walked, parent] of this.blind) {
+            if (logicalPath === walked || logicalPath.startsWith(walked + '/')) {
+                this.blindSeen.add(parent);
+            }
+        }
+    }
+    /**
+     * The parents whose links could not be read by the resolutions since the
+     * last call, emptied by the call. A command whose answer failed reports
+     * them: a link in one of them, had it been seen, would have led elsewhere.
+     *
+     * @returns The parents, in the order first met.
+     */
+    blindParents_take() {
+        const parents = [...this.blindSeen];
+        this.blindSeen.clear();
+        return parents;
+    }
+    /**
+     * Gets a cached mapping if it exists and hasn't expired.
+     *
+     * @param logicalPath - The logical path to look up.
+     * @returns The cached physical path, or null if not cached or expired.
+     */
+    cache_get(logicalPath) {
+        const cached = this.cache.get(logicalPath);
+        if (!cached) {
+            return null;
+        }
+        const now = Date.now();
+        const age = now - cached.timestamp;
+        if (age > cached.ttl) {
+            // Expired, remove from cache
+            this.cache.delete(logicalPath);
+            return null;
+        }
+        return cached.physicalPath;
+    }
+    /**
+     * Caches a logical-to-physical path mapping.
+     *
+     * @param logicalPath - The logical path.
+     * @param physicalPath - The corresponding physical path.
+     * @param ttl - Optional TTL in milliseconds (defaults to 30s).
+     */
+    cache_set(logicalPath, physicalPath, ttl = this.defaultTTL) {
+        this.cache.set(logicalPath, {
+            physicalPath,
+            timestamp: Date.now(),
+            ttl
+        });
+    }
+    /**
+     * Invalidates all cached mappings with a given logical path prefix.
+     *
+     * Call this when links are created/deleted/modified.
+     *
+     * @param logicalPathPrefix - The logical path prefix to invalidate.
+     *
+     * @example
+     * ```typescript
+     * // Link changed: /home/user/public → /SHARED becomes → /PUBLIC
+     * mapper.cache_invalidate('/home/user/public');
+     * // Invalidates:
+     * //   - /home/user/public
+     * //   - /home/user/public/feed_4
+     * //   - /home/user/public/feed_5
+     * //   - ... etc
+     * ```
+     */
+    cache_invalidate(logicalPathPrefix) {
+        const keysToDelete = [];
+        for (const [key] of this.cache) {
+            if (key === logicalPathPrefix || key.startsWith(logicalPathPrefix + '/')) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.cache.delete(key);
+            this.blind.delete(key);
+        }
+    }
+    /**
+     * Clears all cached mappings.
+     */
+    cache_clear() {
+        this.cache.clear();
+        this.blind.clear();
+        this.blindSeen.clear();
+        this.stats = { hits: 0, misses: 0 };
+    }
+    /**
+     * Gets cache statistics.
+     *
+     * @returns Cache statistics including hit rate and size.
+     */
+    stats_get() {
+        const total = this.stats.hits + this.stats.misses;
+        const hitRate = total === 0 ? 0 : this.stats.hits / total;
+        return {
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            size: this.cache.size,
+            hitRate
+        };
+    }
+}
+exports.PathMapper = PathMapper;
+/**
+ * Convenience function to get the singleton PathMapper instance.
+ *
+ * @returns The singleton PathMapper instance.
+ */
+function pathMapper_get() {
+    return PathMapper.instance_get();
+}
+/**
+ * Resolves a logical path to its physical path by following links.
+ *
+ * Delegates to the PathMapper singleton, which uses hierarchical caching to
+ * optimize repeated resolutions with common prefixes.
+ *
+ * @param logicalPath - The logical (apparent) path the user sees/navigates.
+ * @returns A Result containing the physical path, or Err if path is invalid.
+ *
+ * @example
+ * ```ts
+ * await logicalPath_resolve('/home/user/public/data'); // Ok('/PUBLIC/data') where public -> /PUBLIC
+ * ```
+ */
+async function logicalPath_resolve(logicalPath) {
+    return pathMapper_get().logicalPath_resolve(logicalPath);
+}
+/**
+ * Clears the path mapping cache. Useful when links are created/deleted.
+ *
+ * @example
+ * ```ts
+ * linkCache_clear();
+ * ```
+ */
+function linkCache_clear() {
+    pathMapper_get().cache_clear();
+}
+//# sourceMappingURL=pathMapper.js.map

package/dist/files/pathMapper.js.map

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

package/dist/index.d.ts

@@ -5,6 +5,8 @@
 export * from './feeds/index.js';
 export * from './plugins/index.js';
 export * from './files/index.js';
+export { fileIds_memoRun } from './files/fileLookup.js';
+export { PathMapper, pathMapper_get, logicalPath_resolve, linkCache_clear, type CacheStats } from './files/pathMapper.js';
 export * from './connect/index.js';
 export * from './context/index.js';
 export * from './store/index.js';

package/dist/index.js

@@ -18,10 +18,17 @@ 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 });
-exports.DATA_FACTS_READER = exports.dataFormat_deriveFromName = exports.dataFactsIO_build = exports.sourceFeed_parse = exports.procDataFacts_settled = exports.procDataFacts_feed = exports.procDataFacts_sweep = exports.feedDataFacts_read = exports.feedGraphData_ensure = exports.nodeJoins_resolve = exports.feedJoins_ensure = exports.signature_compute = exports.feedGraph_build = exports.PROC_TAGS_PREFIX = exports.FEED_VISIT_COALESCE_MS = exports.ROSTER_DELTA_PAGE = exports.ROSTER_FULL_WALK_MS = exports.FEED_RECHECK_MS = exports.procDataFacts_start = exports.procVisitState_reset = exports.procRoster_bootSync = exports.procRoster_syncStart = exports.procRoster_sync = exports.feedCached_isSettled = exports.feedVisit_sync = exports.feedStatus_refresh = exports.procTarget_parse = exports.procTarget_locate = exports.procFeed_probe = exports.feedMeta_ensure = exports.procFeed_refreshStart = exports.feedInstances_ensureStarted = exports.feedInstances_ensureLoaded = exports.procFeed_ensureLoaded = exports.procPipelineBackfill_status = exports.procTopologyCatchup_await = exports.procTopologyCatchup_status = exports.procTopologyCatchup_enqueue = exports.procTopology_await = exports.procTopology_status = exports.procTopology_retry = exports.procTopology_reconcileFeeds = exports.procTopology_warmup = exports.procCache_refresh = void 0;
+exports.DATA_FACTS_READER = exports.dataFormat_deriveFromName = exports.dataFactsIO_build = exports.sourceFeed_parse = exports.procDataFacts_settled = exports.procDataFacts_feed = exports.procDataFacts_sweep = exports.feedDataFacts_read = exports.feedGraphData_ensure = exports.nodeJoins_resolve = exports.feedJoins_ensure = exports.signature_compute = exports.feedGraph_build = exports.PROC_TAGS_PREFIX = exports.FEED_VISIT_COALESCE_MS = exports.ROSTER_DELTA_PAGE = exports.ROSTER_FULL_WALK_MS = exports.FEED_RECHECK_MS = exports.procDataFacts_start = exports.procVisitState_reset = exports.procRoster_bootSync = exports.procRoster_syncStart = exports.procRoster_sync = exports.feedCached_isSettled = exports.feedVisit_sync = exports.feedStatus_refresh = exports.procTarget_parse = exports.procTarget_locate = exports.procFeed_probe = exports.feedMeta_ensure = exports.procFeed_refreshStart = exports.feedInstances_ensureStarted = exports.feedInstances_ensureLoaded = exports.procFeed_ensureLoaded = exports.procPipelineBackfill_status = exports.procTopologyCatchup_await = exports.procTopologyCatchup_status = exports.procTopologyCatchup_enqueue = exports.procTopology_await = exports.procTopology_status = exports.procTopology_retry = exports.procTopology_reconcileFeeds = exports.procTopology_warmup = exports.procCache_refresh = exports.linkCache_clear = exports.logicalPath_resolve = exports.pathMapper_get = exports.PathMapper = exports.fileIds_memoRun = void 0;
 __exportStar(require("./feeds/index.js"), exports);
 __exportStar(require("./plugins/index.js"), exports);
 __exportStar(require("./files/index.js"), exports);
+var fileLookup_js_1 = require("./files/fileLookup.js");
+Object.defineProperty(exports, "fileIds_memoRun", { enumerable: true, get: function () { return fileLookup_js_1.fileIds_memoRun; } });
+var pathMapper_js_1 = require("./files/pathMapper.js");
+Object.defineProperty(exports, "PathMapper", { enumerable: true, get: function () { return pathMapper_js_1.PathMapper; } });
+Object.defineProperty(exports, "pathMapper_get", { enumerable: true, get: function () { return pathMapper_js_1.pathMapper_get; } });
+Object.defineProperty(exports, "logicalPath_resolve", { enumerable: true, get: function () { return pathMapper_js_1.logicalPath_resolve; } });
+Object.defineProperty(exports, "linkCache_clear", { enumerable: true, get: function () { return pathMapper_js_1.linkCache_clear; } });
 __exportStar(require("./connect/index.js"), exports);
 __exportStar(require("./context/index.js"), exports);
 __exportStar(require("./store/index.js"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,mDAAiC;AACjC,qDAAmC;AACnC,mDAAiC;AACjC,qDAAmC;AACnC,qDAAmC;AACnC,mDAAiC;AACjC,uDAAqC;AACrC,kDAAgC;AAChC,mDAAiC;AACjC,sDAAoC;AACpC,iDAA+B;AAC/B,kDAAgC;AAChC,oDAAkC;AAClC,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,qDAAmC;AACnC,kDAAgC;AAChC,mDAAiC;AACjC,mDAA0uB;AAAjuB,4GAAA,iBAAiB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,qHAAA,0BAA0B,OAAA;AAAE,oHAAA,yBAAyB,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AAAE,qHAAA,0BAA0B,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AAA8B,0GAAA,eAAe,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAqB,6GAAA,kBAAkB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAExsB,2DAA+D;AAAtD,+GAAA,gBAAgB,OAAA;AACzB,mDAAwE;AAA/D,+GAAA,eAAe,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAE3C,mDAAyE;AAAhE,gHAAA,gBAAgB,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAC5C,iDAAyD;AAAhD,mHAAA,oBAAoB,OAAA;AAC7B,iDAA4N;AAAnN,iHAAA,kBAAkB,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAAE,wHAAA,yBAAyB,OAAA;AAAE,gHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,mDAAiC;AACjC,qDAAmC;AACnC,mDAAiC;AACjC,uDAAwD;AAA/C,gHAAA,eAAe,OAAA;AACxB,uDAA0H;AAAjH,2GAAA,UAAU,OAAA;AAAE,+GAAA,cAAc,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAAE,gHAAA,eAAe,OAAA;AACzE,qDAAmC;AACnC,qDAAmC;AACnC,mDAAiC;AACjC,uDAAqC;AACrC,kDAAgC;AAChC,mDAAiC;AACjC,sDAAoC;AACpC,iDAA+B;AAC/B,kDAAgC;AAChC,oDAAkC;AAClC,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,qDAAmC;AACnC,kDAAgC;AAChC,mDAAiC;AACjC,mDAA0uB;AAAjuB,4GAAA,iBAAiB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,qHAAA,0BAA0B,OAAA;AAAE,oHAAA,yBAAyB,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AAAE,qHAAA,0BAA0B,OAAA;AAAE,sHAAA,2BAA2B,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AAA8B,0GAAA,eAAe,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAqB,6GAAA,kBAAkB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAExsB,2DAA+D;AAAtD,+GAAA,gBAAgB,OAAA;AACzB,mDAAwE;AAA/D,+GAAA,eAAe,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAE3C,mDAAyE;AAAhE,gHAAA,gBAAgB,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAC5C,iDAAyD;AAAhD,mHAAA,oBAAoB,OAAA;AAC7B,iDAA4N;AAAnN,iHAAA,kBAAkB,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAAE,wHAAA,yBAAyB,OAAA;AAAE,gHAAA,iBAAiB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fnndsc/salsa",
-  "version": "4.5.3",
+  "version": "4.5.5",
   "description": "Shared Application Logic and Service Assets for ChRIS",
   "repository": {
     "type": "git",
@@ -60,8 +60,8 @@
     "adm-zip": "npm:empty-npm-package@1.0.0"
   },
   "dependencies": {
-    "@fnndsc/cumin": "^3.30.0",
-    "@fnndsc/fond": "^0.6.1",
+    "@fnndsc/cumin": "^3.30.6",
+    "@fnndsc/fond": "^0.6.2",
     "ajv": "^8.17.1",
     "axios": "^1.6.8",
     "dcmjs": "^0.52.0",