@fnndsc/cumin 3.24.0 → 3.26.0

package/dist/filebrowser/folderMemo.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.folderLookup_memoize = folderLookup_memoize;
+const listCache_1 = require("../cache/listCache");
+/** How a memoised client is marked, so it is wrapped once. */
+const MEMOISED = Symbol('folderLookup_memoised');
+/**
+ * Wraps a client's folder lookup with the session's memo. Idempotent.
+ *
+ * @param client - A connected chrisapi Client.
+ * @returns The same client, its `getFileBrowserFolderByPath` memoised.
+ */
+function folderLookup_memoize(client) {
+    const wrapped = client;
+    if (wrapped[MEMOISED] === true)
+        return client;
+    // A client without the lookup (a stub, an older chrisapi) is left as it is.
+    if (typeof wrapped.getFileBrowserFolderByPath !== 'function')
+        return client;
+    wrapped[MEMOISED] = true;
+    const lookup = wrapped.getFileBrowserFolderByPath.bind(wrapped);
+    wrapped.getFileBrowserFolderByPath = (path, timeout) => {
+        const kept = (0, listCache_1.listCache_get)().folder_get(path);
+        if (kept !== null)
+            return kept;
+        const fresh = lookup(path, timeout);
+        (0, listCache_1.listCache_get)().folder_set(path, fresh);
+        return fresh;
+    };
+    return client;
+}
+//# sourceMappingURL=folderMemo.js.map

package/dist/filebrowser/folderMemo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folderMemo.js","sourceRoot":"","sources":["../../src/filebrowser/folderMemo.ts"],"names":[],"mappings":";;AA8BA,oDAeC;AAhCD,kDAAmD;AAEnD,8DAA8D;AAC9D,MAAM,QAAQ,GAAkB,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAQhE;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,MAAc;IACjD,MAAM,OAAO,GAAuB,MAA4B,CAAC;IACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9C,4EAA4E;IAC5E,IAAI,OAAO,OAAO,CAAC,0BAA0B,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACzB,MAAM,MAAM,GAAyD,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtH,OAAO,CAAC,0BAA0B,GAAG,CAAC,IAAY,EAAE,OAAgB,EAAoB,EAAE;QACxF,MAAM,IAAI,GAA4B,IAAA,yBAAa,GAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvE,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,KAAK,GAAqB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,IAAA,yBAAa,GAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/groups/chrisGroups.js

@@ -14,6 +14,34 @@ const contract_js_1 = require("../chrisapi/contract.js");
 const errorStack_js_1 = require("../error/errorStack.js");
 const chrisResourceGroup_js_1 = require("../resources/chrisResourceGroup.js");
 const result_js_1 = require("../utils/result.js");
+/** The group items a session's groups listing served, by id, per client. */
+const groupItems = new WeakMap();
+/**
+ * The listed group items of one client, made on first use.
+ *
+ * @param client - The connection's chrisapi client.
+ * @returns That client's items by group id.
+ */
+function groupItems_for(client) {
+    const kept = groupItems.get(client);
+    if (kept !== undefined)
+        return kept;
+    const made = new Map();
+    groupItems.set(client, made);
+    return made;
+}
+/**
+ * Reads the member a membership row names, without a request.
+ *
+ * @param membership - The membership row resource.
+ * @returns The member, or null when the row carries no user id and name.
+ */
+function membershipMember_read(membership) {
+    const row = (0, adapter_js_1.itemData_get)(membership);
+    if (!row || typeof row.user_id !== 'number' || typeof row.user_username !== 'string')
+        return null;
+    return { id: row.user_id, username: row.user_username };
+}
 /**
  * Group handler for ChRIS user groups.
  */
@@ -33,6 +61,12 @@ class ChRISGroupGroup extends chrisResourceGroup_js_1.ChRISResourceGroup {
             errorStack_js_1.errorStack.stack_push('error', 'Not connected to ChRIS. Please log in.');
             return null;
         }
+        // The item the groups listing served answers first: chrisapi's getGroup
+        // is a list-by-id, and the boot's warm listed every group that way
+        // right after listing them all (73 searches on a 73-group CUBE).
+        const listed = groupItems_for(client).get(groupID);
+        if (listed !== undefined)
+            return listed;
         const group = await client.getGroup(groupID);
         if (!group)
             errorStack_js_1.errorStack.stack_push('error', `Group ${groupID} was not found.`);
@@ -50,8 +84,16 @@ class ChRISGroupGroup extends chrisResourceGroup_js_1.ChRISResourceGroup {
                 errorStack_js_1.errorStack.stack_push('error', 'Not connected to ChRIS. Please log in.');
                 return (0, result_js_1.Err)();
             }
+            const items = groupItems_for(client);
             const groups = await (0, contract_js_1.listPages_drain)(async (offset, limit) => {
                 const page = await client.getGroups({ limit, offset });
+                // The items are kept by id: a group's members are read off its item.
+                const served = typeof page.getItems === 'function' ? (0, adapter_js_1.items_get)(page) : [];
+                for (const item of served) {
+                    const data = (0, adapter_js_1.itemData_get)(item);
+                    if (data && typeof data.id === 'number')
+                        items.set(data.id, item);
+                }
                 return (0, contract_js_1.collectionPage_wrap)(page, (0, adapter_js_1.listData_get)(page));
             });
             return (0, result_js_1.Ok)(groups);
@@ -78,9 +120,14 @@ class ChRISGroupGroup extends chrisResourceGroup_js_1.ChRISResourceGroup {
                 const page = await group.getUsers({ limit, offset });
                 return (0, contract_js_1.collectionPage_wrap)(page, (0, adapter_js_1.items_get)(page));
             })) {
-                // Membership rows carry only a link to the user; one detail request
-                // per row (parallel within the page) is what the API offers.
+                // A membership row names its user (user_id, user_username): the
+                // page is the answer. The linked user is fetched only for a row
+                // that does not — the boot's group warm once asked CUBE for every
+                // member one by one (51 requests on the dev CUBE).
                 const pageMembers = await Promise.all(step.items.map(async (membershipResource) => {
+                    const named = membershipMember_read(membershipResource);
+                    if (named)
+                        return named;
                     const userResource = await membershipResource.getUser();
                     const member = (0, adapter_js_1.itemData_get)(userResource);
                     if (!member)
@@ -110,8 +157,8 @@ class ChRISGroupGroup extends chrisResourceGroup_js_1.ChRISResourceGroup {
             if (!group)
                 return (0, result_js_1.Err)();
             const membershipResource = await group.adminAddUser(username);
-            const userResource = await membershipResource.getUser();
-            const membership = (0, adapter_js_1.itemData_get)(userResource);
+            const membership = membershipMember_read(membershipResource)
+                ?? (0, adapter_js_1.itemData_get)(await membershipResource.getUser());
             if (!membership) {
                 errorStack_js_1.errorStack.stack_push('error', `CUBE returned no membership for ${username}.`);
                 return (0, result_js_1.Err)();

package/dist/groups/chrisGroups.js.map

@@ -1 +1 @@
-{"version":3,"file":"chrisGroups.js","sourceRoot":"","sources":["../../src/groups/chrisGroups.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2KH,sCAEC;AAMD,kDAEC;AAOD,sCAKC;AAOD,4CAEC;AAxMD,uDAUgC;AAChC,yDAA8G;AAC9G,0DAAoD;AACpD,8EAAwE;AACxE,kDAA0D;AAc1D;;GAEG;AACH,MAAa,eAAgB,SAAQ,0CAAkB;IACrD;QACE,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,SAAS,CAAC,OAAe;QACrC,MAAM,MAAM,GAAkB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAiB,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,OAAO,iBAAiB,CAAC,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAkB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACtD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;gBACzE,OAAO,IAAA,eAAG,GAAE,CAAC;YACf,CAAC;YACD,MAAM,MAAM,GAAiB,MAAM,IAAA,6BAAe,EAChD,KAAK,EAAE,MAAc,EAAE,KAAa,EAAiC,EAAE;gBACrE,MAAM,IAAI,GAAc,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBAClE,OAAO,IAAA,iCAAmB,EAAC,IAAI,EAAE,IAAA,yBAAY,EAAa,IAAI,CAAC,CAAC,CAAC;YACnE,CAAC,CACF,CAAC;YACF,OAAO,IAAA,cAAE,EAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,2BAA2B,OAAO,EAAE,CAAC,CAAC;YACrE,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,IAAI,CAAC;YACH,MAAM,KAAK,GAAiB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAA,eAAG,GAAE,CAAC;YACzB,MAAM,OAAO,GAAuB,EAAE,CAAC;YACvC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAA,4BAAc,EACrC,KAAK,EAAE,MAAc,EAAE,KAAa,EAAgC,EAAE;gBACpE,MAAM,IAAI,GAAkB,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACpE,OAAO,IAAA,iCAAmB,EAAC,IAAI,EAAE,IAAA,sBAAS,EAAY,IAAI,CAAC,CAAC,CAAC;YAC/D,CAAC,CACF,EAAE,CAAC;gBACF,oEAAoE;gBACpE,6DAA6D;gBAC7D,MAAM,WAAW,GAAuB,MAAM,OAAO,CAAC,GAAG,CACvD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,kBAA6B,EAA6B,EAAE;oBAChF,MAAM,YAAY,GAAS,MAAM,kBAAkB,CAAC,OAAO,EAAE,CAAC;oBAC9D,MAAM,MAAM,GAA4B,IAAA,yBAAY,EAAmB,YAAY,CAAC,CAAC;oBACrF,IAAI,CAAC,MAAM;wBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;oBAC7E,OAAO,MAAM,CAAC;gBAChB,CAAC,CAAC,CACH,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,IAAA,cAAE,EAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,mCAAmC,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;YACzF,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,QAAgB;QAC9C,IAAI,CAAC;YACH,MAAM,KAAK,GAAiB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAA,eAAG,GAAE,CAAC;YACzB,MAAM,kBAAkB,GAAc,MAAM,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACzE,MAAM,YAAY,GAAS,MAAM,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAC9D,MAAM,UAAU,GAA4B,IAAA,yBAAY,EAAmB,YAAY,CAAC,CAAC;YACzF,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,mCAAmC,QAAQ,GAAG,CAAC,CAAC;gBAC/E,OAAO,IAAA,eAAG,GAAE,CAAC;YACf,CAAC;YACD,OAAO,IAAA,cAAE,EAAC,UAAU,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAiB,QAAQ,aAAa,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;YAC5F,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,QAAgB;QACjD,IAAI,CAAC;YACH,MAAM,KAAK,GAAiB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAA,eAAG,GAAE,CAAC;YACzB,MAAM,UAAU,GAAqB,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,QAAQ,6BAA6B,OAAO,GAAG,CAAC,CAAC;gBACnF,OAAO,IAAA,eAAG,GAAE,CAAC;YACf,CAAC;YACD,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,IAAA,cAAE,EAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,oBAAoB,QAAQ,eAAe,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;YACjG,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAvID,0CAuIC;AAED,4DAA4D;AACrD,KAAK,UAAU,aAAa;IACjC,OAAO,IAAI,eAAe,EAAE,CAAC,aAAa,EAAE,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACvD,OAAO,IAAI,eAAe,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,QAAgB;IAEhB,OAAO,IAAI,eAAe,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,QAAgB;IACtE,OAAO,IAAI,eAAe,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"chrisGroups.js","sourceRoot":"","sources":["../../src/groups/chrisGroups.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA8NH,sCAEC;AAMD,kDAEC;AAOD,sCAKC;AAOD,4CAEC;AA3PD,uDAUgC;AAChC,yDAA8G;AAC9G,0DAAoD;AACpD,8EAAwE;AACxE,kDAA0D;AAc1D,4EAA4E;AAC5E,MAAM,UAAU,GAAwC,IAAI,OAAO,EAAE,CAAC;AAEtE;;;;;GAKG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,IAAI,GAAmC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAuB,IAAI,GAAG,EAAE,CAAC;IAC3C,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAQD;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,UAA8B;IAC3D,MAAM,GAAG,GAAyB,IAAA,yBAAY,EAAgB,UAAU,CAAC,CAAC;IAC1E,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAClG,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,0CAAkB;IACrD;QACE,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,SAAS,CAAC,OAAe;QACrC,MAAM,MAAM,GAAkB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,wEAAwE;QACxE,mEAAmE;QACnE,iEAAiE;QACjE,MAAM,MAAM,GAAsB,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,KAAK,GAAiB,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,OAAO,iBAAiB,CAAC,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAkB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACtD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;gBACzE,OAAO,IAAA,eAAG,GAAE,CAAC;YACf,CAAC;YACD,MAAM,KAAK,GAAuB,cAAc,CAAC,MAAM,CAAC,CAAC;YACzD,MAAM,MAAM,GAAiB,MAAM,IAAA,6BAAe,EAChD,KAAK,EAAE,MAAc,EAAE,KAAa,EAAiC,EAAE;gBACrE,MAAM,IAAI,GAAc,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBAClE,qEAAqE;gBACrE,MAAM,MAAM,GAAY,OAAQ,IAA+B,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,IAAA,sBAAS,EAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtH,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAC1B,MAAM,IAAI,GAAsB,IAAA,yBAAY,EAAa,IAAI,CAAC,CAAC;oBAC/D,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;wBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO,IAAA,iCAAmB,EAAC,IAAI,EAAE,IAAA,yBAAY,EAAa,IAAI,CAAC,CAAC,CAAC;YACnE,CAAC,CACF,CAAC;YACF,OAAO,IAAA,cAAE,EAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,2BAA2B,OAAO,EAAE,CAAC,CAAC;YACrE,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,IAAI,CAAC;YACH,MAAM,KAAK,GAAiB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAA,eAAG,GAAE,CAAC;YACzB,MAAM,OAAO,GAAuB,EAAE,CAAC;YACvC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAA,4BAAc,EACrC,KAAK,EAAE,MAAc,EAAE,KAAa,EAAgC,EAAE;gBACpE,MAAM,IAAI,GAAkB,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACpE,OAAO,IAAA,iCAAmB,EAAC,IAAI,EAAE,IAAA,sBAAS,EAAY,IAAI,CAAC,CAAC,CAAC;YAC/D,CAAC,CACF,EAAE,CAAC;gBACF,gEAAgE;gBAChE,gEAAgE;gBAChE,kEAAkE;gBAClE,mDAAmD;gBACnD,MAAM,WAAW,GAAuB,MAAM,OAAO,CAAC,GAAG,CACvD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,kBAA6B,EAA6B,EAAE;oBAChF,MAAM,KAAK,GAA4B,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;oBACjF,IAAI,KAAK;wBAAE,OAAO,KAAK,CAAC;oBACxB,MAAM,YAAY,GAAS,MAAM,kBAAkB,CAAC,OAAO,EAAE,CAAC;oBAC9D,MAAM,MAAM,GAA4B,IAAA,yBAAY,EAAmB,YAAY,CAAC,CAAC;oBACrF,IAAI,CAAC,MAAM;wBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;oBAC7E,OAAO,MAAM,CAAC;gBAChB,CAAC,CAAC,CACH,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,IAAA,cAAE,EAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,mCAAmC,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;YACzF,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,QAAgB;QAC9C,IAAI,CAAC;YACH,MAAM,KAAK,GAAiB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAA,eAAG,GAAE,CAAC;YACzB,MAAM,kBAAkB,GAAc,MAAM,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACzE,MAAM,UAAU,GAA4B,qBAAqB,CAAC,kBAAkB,CAAC;mBAChF,IAAA,yBAAY,EAAmB,MAAM,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,mCAAmC,QAAQ,GAAG,CAAC,CAAC;gBAC/E,OAAO,IAAA,eAAG,GAAE,CAAC;YACf,CAAC;YACD,OAAO,IAAA,cAAE,EAAC,UAAU,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAiB,QAAQ,aAAa,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;YAC5F,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,QAAgB;QACjD,IAAI,CAAC;YACH,MAAM,KAAK,GAAiB,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAA,eAAG,GAAE,CAAC;YACzB,MAAM,UAAU,GAAqB,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,QAAQ,6BAA6B,OAAO,GAAG,CAAC,CAAC;gBACnF,OAAO,IAAA,eAAG,GAAE,CAAC;YACf,CAAC;YACD,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1B,OAAO,IAAA,cAAE,EAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/E,0BAAU,CAAC,UAAU,CAAC,OAAO,EAAE,oBAAoB,QAAQ,eAAe,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;YACjG,OAAO,IAAA,eAAG,GAAE,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAvJD,0CAuJC;AAED,4DAA4D;AACrD,KAAK,UAAU,aAAa;IACjC,OAAO,IAAI,eAAe,EAAE,CAAC,aAAa,EAAE,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACvD,OAAO,IAAI,eAAe,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,QAAgB;IAEhB,OAAO,IAAI,eAAe,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,QAAgB;IACtE,OAAO,IAAI,eAAe,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -25,10 +25,12 @@ export * from "./resources/chrisResourceGroup";
 export * from "./resources/chrisObjContext";
 export * from "./resources/chrisEmbeddedResourceGroup";
 export * from "./filebrowser/chrisFileBrowser";
+export * from "./filebrowser/folderMemo";
 export * from "./filebrowser/chrisFiles";
 export * from "./filebrowser/chrisPACS";
 export * from "./filebrowser/chrisPipeline";
 export * from "./io/chrisIO";
+export * from "./net/requestLedger";
 export * from "./io/io";
 export * from "./io/node_io";
 export * from "./utils/keypair";
@@ -39,6 +41,7 @@ export * from "./utils/envelope";
 export * from "./cache";
 export * from "./path/chrisPath";
 export * from "./pipelines/chrisPipeline";
+export * from "./pipelines/pipelineMemo";
 export * from "./users/chrisUsers";
 export * from "./tags/chrisTags";
 export * from "./groups/chrisGroups";

package/dist/index.js

@@ -43,10 +43,12 @@ __exportStar(require("./resources/chrisResourceGroup"), exports);
 __exportStar(require("./resources/chrisObjContext"), exports);
 __exportStar(require("./resources/chrisEmbeddedResourceGroup"), exports);
 __exportStar(require("./filebrowser/chrisFileBrowser"), exports);
+__exportStar(require("./filebrowser/folderMemo"), exports);
 __exportStar(require("./filebrowser/chrisFiles"), exports);
 __exportStar(require("./filebrowser/chrisPACS"), exports);
 __exportStar(require("./filebrowser/chrisPipeline"), exports);
 __exportStar(require("./io/chrisIO"), exports);
+__exportStar(require("./net/requestLedger"), exports);
 __exportStar(require("./io/io"), exports);
 __exportStar(require("./io/node_io"), exports);
 __exportStar(require("./utils/keypair"), exports);
@@ -57,6 +59,7 @@ __exportStar(require("./utils/envelope"), exports);
 __exportStar(require("./cache"), exports);
 __exportStar(require("./path/chrisPath"), exports);
 __exportStar(require("./pipelines/chrisPipeline"), exports);
+__exportStar(require("./pipelines/pipelineMemo"), exports);
 __exportStar(require("./users/chrisUsers"), exports);
 __exportStar(require("./tags/chrisTags"), exports);
 __exportStar(require("./groups/chrisGroups"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;AAuHH,4CAKC;AA1HD,qCAAmB;AACnB,qDAAmC;AACnC,kDAAgC;AAChC,oDAAkC;AAClC,4DAA0C;AAC1C,yDAAuC;AACvC,yDAAuC;AACvC,mEAAiD;AACjD,6DAA2C;AAC3C,mDAAiC;AACjC,yDAAuC;AACvC,sDAAoC;AACpC,6DAA2C;AAC3C,iEAA+C;AAC/C,8DAA4C;AAC5C,yEAAuD;AACvD,iEAA+C;AAC/C,2DAAyC;AACzC,0DAAwC;AACxC,8DAA4C;AAC5C,+CAA6B;AAC7B,0CAAwB;AACxB,+CAA6B;AAC7B,kDAAgC;AAChC,qDAAmC;AACnC,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,0CAAwB;AACxB,mDAAiC;AACjC,4DAA0C;AAC1C,qDAAmC;AACnC,mDAAiC;AACjC,uDAAqC;AACrC,iEAA+C;AAC/C,6DAA2C;AAC3C,yDAAuC;AAEvC,iFAAiF;AACjF,8CAA2E;AAAlE,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,oGAAA,SAAS,OAAA;AAC9C,wCAAiH;AAAxG,gGAAA,QAAQ,OAAA;AAAE,iGAAA,SAAS,OAAA;AAAE,kGAAA,UAAU,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAAE,mGAAA,WAAW,OAAA;AAExE,yEAAyE;AACzE,0EAA0E;AAC1E,gDAc6B;AAb3B,yGAAA,aAAa,OAAA;AACb,+GAAA,mBAAmB,OAAA;AACnB,mHAAA,uBAAuB,OAAA;AACvB,8GAAA,kBAAkB,OAAA;AAClB,uGAAA,WAAW,OAAA;AACX,kHAAA,sBAAsB,OAAA;AACtB,wGAAA,YAAY,OAAA;AACZ,uHAAA,2BAA2B,OAAA;AAC3B,qHAAA,yBAAyB,OAAA;AACzB,gHAAA,oBAAoB,OAAA;AACpB,0GAAA,cAAc,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AACtC,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AAsDrB;;;;;GAKG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,OAAO,GAAW,OAAO,CAAC;IAChC,wCAAwC;IACxC,6CAA6C;IAC7C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC5B,CAAC;AAED,gEAAgE;AAChE,qCAAqC;AACrC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;AA0HH,4CAKC;AA7HD,qCAAmB;AACnB,qDAAmC;AACnC,kDAAgC;AAChC,oDAAkC;AAClC,4DAA0C;AAC1C,yDAAuC;AACvC,yDAAuC;AACvC,mEAAiD;AACjD,6DAA2C;AAC3C,mDAAiC;AACjC,yDAAuC;AACvC,sDAAoC;AACpC,6DAA2C;AAC3C,iEAA+C;AAC/C,8DAA4C;AAC5C,yEAAuD;AACvD,iEAA+C;AAC/C,2DAAyC;AACzC,2DAAyC;AACzC,0DAAwC;AACxC,8DAA4C;AAC5C,+CAA6B;AAC7B,sDAAoC;AACpC,0CAAwB;AACxB,+CAA6B;AAC7B,kDAAgC;AAChC,qDAAmC;AACnC,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,0CAAwB;AACxB,mDAAiC;AACjC,4DAA0C;AAC1C,2DAAyC;AACzC,qDAAmC;AACnC,mDAAiC;AACjC,uDAAqC;AACrC,iEAA+C;AAC/C,6DAA2C;AAC3C,yDAAuC;AAEvC,iFAAiF;AACjF,8CAA2E;AAAlE,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,oGAAA,SAAS,OAAA;AAC9C,wCAAiH;AAAxG,gGAAA,QAAQ,OAAA;AAAE,iGAAA,SAAS,OAAA;AAAE,kGAAA,UAAU,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAAE,mGAAA,WAAW,OAAA;AAExE,yEAAyE;AACzE,0EAA0E;AAC1E,gDAc6B;AAb3B,yGAAA,aAAa,OAAA;AACb,+GAAA,mBAAmB,OAAA;AACnB,mHAAA,uBAAuB,OAAA;AACvB,8GAAA,kBAAkB,OAAA;AAClB,uGAAA,WAAW,OAAA;AACX,kHAAA,sBAAsB,OAAA;AACtB,wGAAA,YAAY,OAAA;AACZ,uHAAA,2BAA2B,OAAA;AAC3B,qHAAA,yBAAyB,OAAA;AACzB,gHAAA,oBAAoB,OAAA;AACpB,0GAAA,cAAc,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AACtC,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AAsDrB;;;;;GAKG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,OAAO,GAAW,OAAO,CAAC;IAChC,wCAAwC;IACxC,6CAA6C;IAC7C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAC5B,CAAC;AAED,gEAAgE;AAChE,qCAAqC;AACrC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/net/requestLedger.d.ts

@@ -0,0 +1,78 @@
+/** One request as the ledger saw it. */
+export interface LedgerEntry {
+    /** Milliseconds since the ledger started. */
+    at: number;
+    method: string;
+    /** The endpoint family: `filebrowser/search`, `filebrowser/:id/children`, `plugins`, … */
+    family: string;
+    /** The path with its query, as sent (capped). */
+    path: string;
+    /** The response status; 0 when the request failed before one. */
+    status: number;
+    /** How long it took, request to response headers. */
+    ms: number;
+}
+/** A family's tally. */
+export interface LedgerFamily {
+    family: string;
+    count: number;
+    /** Milliseconds spent, summed. */
+    ms: number;
+}
+/** What `netstat` reads out. */
+export interface LedgerSnapshot {
+    /** When the count began: the session, or the last reset (ISO 8601). */
+    since: string;
+    /** Requests since then. */
+    total: number;
+    /** Milliseconds spent on them, summed. */
+    ms: number;
+    /** By family, most requests first. */
+    families: LedgerFamily[];
+    /** The last requests, oldest first. */
+    last: LedgerEntry[];
+}
+/** How many entries the ledger keeps. */
+export declare const LEDGER_KEPT: number;
+/**
+ * Names a request's endpoint family: the path below `/api/v1/`, ids
+ * replaced by `:id`, the query dropped, trailing slash dropped.
+ *
+ * @param path - The request path, query and all.
+ * @returns The family, or `root` for the API root.
+ */
+export declare function requestFamily_of(path: string): string;
+/**
+ * Notes a request as it starts.
+ *
+ * @param request - The request object the channel carried (the key).
+ * @param method - Its method.
+ * @param path - Its path.
+ */
+export declare function ledger_requestStart(request: object, method: string, path: string): void;
+/**
+ * Notes a request as it ends, however it ended.
+ *
+ * @param request - The request object the channel carried.
+ * @param status - The response status, or 0 for a failure.
+ */
+export declare function ledger_requestEnd(request: object, status: number): void;
+/**
+ * Starts listening. Idempotent: the connection calls it as it is made,
+ * and a second call changes nothing.
+ */
+export declare function requestLedger_start(): void;
+/**
+ * Forgets the count: the next snapshot counts from now. The last entries
+ * are kept so a reset mid-navigation still shows what just happened.
+ */
+export declare function requestLedger_reset(): void;
+/**
+ * Reads the ledger.
+ *
+ * @param options - `last`: how many recent entries to carry (default 20).
+ * @returns The snapshot, families most-requested first.
+ */
+export declare function requestLedger_snapshot(options?: {
+    last?: number;
+}): LedgerSnapshot;

package/dist/net/requestLedger.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEDGER_KEPT = void 0;
+exports.requestFamily_of = requestFamily_of;
+exports.ledger_requestStart = ledger_requestStart;
+exports.ledger_requestEnd = ledger_requestEnd;
+exports.requestLedger_start = requestLedger_start;
+exports.requestLedger_reset = requestLedger_reset;
+exports.requestLedger_snapshot = requestLedger_snapshot;
+/**
+ * @file The request ledger: every call the kernel makes to CUBE, counted.
+ *
+ * A navigation that felt slow turned out to be fourteen requests where
+ * four would do, and nothing in the session could say so — the count was
+ * found with a preload hack on a private daemon. The ledger makes the
+ * wire a readout: how many requests since the session (or the last
+ * reset), by endpoint family, with the last ones timed. `netstat` reads
+ * it; smoke asserts budgets against it; an operator on a slow day asks
+ * it before guessing.
+ *
+ * It listens on Node's own diagnostics channels — the http client (what
+ * axios rides) and undici (what fetch rides) — so nothing is patched and
+ * every caller is seen.
+ */
+const node_diagnostics_channel_1 = require("node:diagnostics_channel");
+/** How many entries the ledger keeps. */
+exports.LEDGER_KEPT = 200;
+/** A path longer than this is cut, with an ellipsis. */
+const PATH_KEPT = 160;
+let started = false;
+let origin = Date.now();
+let since = new Date(origin).toISOString();
+let total = 0;
+let msTotal = 0;
+const families = new Map();
+const entries = [];
+const open = new WeakMap();
+/**
+ * Names a request's endpoint family: the path below `/api/v1/`, ids
+ * replaced by `:id`, the query dropped, trailing slash dropped.
+ *
+ * @param path - The request path, query and all.
+ * @returns The family, or `root` for the API root.
+ */
+function requestFamily_of(path) {
+    const bare = path.split('?')[0] ?? '';
+    const below = bare.replace(/^.*?\/api\/v1\/?/, '').replace(/\/+$/, '');
+    if (below === '')
+        return 'root';
+    return below.split('/').map((segment) => (/^\d+$/.test(segment) ? ':id' : segment)).join('/');
+}
+const path_cap = (path) => (path.length > PATH_KEPT ? `${path.slice(0, PATH_KEPT - 1)}…` : path);
+function entry_record(method, path, status, t0) {
+    const ms = Math.round(performance.now() - t0);
+    const family = requestFamily_of(path);
+    total += 1;
+    msTotal += ms;
+    const tally = families.get(family) ?? { family, count: 0, ms: 0 };
+    tally.count += 1;
+    tally.ms += ms;
+    families.set(family, tally);
+    entries.push({ at: Date.now() - origin, method, family, path: path_cap(path), status, ms });
+    if (entries.length > exports.LEDGER_KEPT)
+        entries.splice(0, entries.length - exports.LEDGER_KEPT);
+}
+/**
+ * Notes a request as it starts.
+ *
+ * @param request - The request object the channel carried (the key).
+ * @param method - Its method.
+ * @param path - Its path.
+ */
+function ledger_requestStart(request, method, path) {
+    open.set(request, { t0: performance.now(), method, path });
+}
+/**
+ * Notes a request as it ends, however it ended.
+ *
+ * @param request - The request object the channel carried.
+ * @param status - The response status, or 0 for a failure.
+ */
+function ledger_requestEnd(request, status) {
+    const begun = open.get(request);
+    if (begun === undefined)
+        return;
+    open.delete(request);
+    entry_record(begun.method, begun.path, status, begun.t0);
+}
+/**
+ * Starts listening. Idempotent: the connection calls it as it is made,
+ * and a second call changes nothing.
+ */
+function requestLedger_start() {
+    if (started)
+        return;
+    started = true;
+    const method_of = (request) => (typeof request.method === 'string' ? request.method : 'GET');
+    const path_of = (request) => (typeof request.path === 'string' ? request.path : '');
+    (0, node_diagnostics_channel_1.subscribe)('http.client.request.start', (message) => {
+        const { request } = message;
+        if (request !== undefined && request !== null)
+            ledger_requestStart(request, method_of(request), path_of(request));
+    });
+    (0, node_diagnostics_channel_1.subscribe)('http.client.response.finish', (message) => {
+        const { request, response } = message;
+        if (request !== undefined && request !== null)
+            ledger_requestEnd(request, typeof response?.statusCode === 'number' ? response.statusCode : 0);
+    });
+    (0, node_diagnostics_channel_1.subscribe)('http.client.request.error', (message) => {
+        const { request } = message;
+        if (request !== undefined && request !== null)
+            ledger_requestEnd(request, 0);
+    });
+    (0, node_diagnostics_channel_1.subscribe)('undici:request:create', (message) => {
+        const { request } = message;
+        if (request !== undefined && request !== null)
+            ledger_requestStart(request, method_of(request), path_of(request));
+    });
+    (0, node_diagnostics_channel_1.subscribe)('undici:request:headers', (message) => {
+        const { request, response } = message;
+        if (request !== undefined && request !== null)
+            ledger_requestEnd(request, typeof response?.statusCode === 'number' ? response.statusCode : 0);
+    });
+    (0, node_diagnostics_channel_1.subscribe)('undici:request:error', (message) => {
+        const { request } = message;
+        if (request !== undefined && request !== null)
+            ledger_requestEnd(request, 0);
+    });
+}
+/**
+ * Forgets the count: the next snapshot counts from now. The last entries
+ * are kept so a reset mid-navigation still shows what just happened.
+ */
+function requestLedger_reset() {
+    origin = Date.now();
+    since = new Date(origin).toISOString();
+    total = 0;
+    msTotal = 0;
+    families.clear();
+    entries.length = 0;
+}
+/**
+ * Reads the ledger.
+ *
+ * @param options - `last`: how many recent entries to carry (default 20).
+ * @returns The snapshot, families most-requested first.
+ */
+function requestLedger_snapshot(options = {}) {
+    const last = Math.max(0, Math.min(exports.LEDGER_KEPT, options.last ?? 20));
+    return {
+        since,
+        total,
+        ms: msTotal,
+        families: [...families.values()].sort((a, b) => b.count - a.count || a.family.localeCompare(b.family)),
+        last: entries.slice(-last),
+    };
+}
+//# sourceMappingURL=requestLedger.js.map

package/dist/net/requestLedger.js.map

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

package/dist/pacs/chrisPACS.d.ts

@@ -208,6 +208,42 @@ export interface SeriesStorageState {
     /** Display folder path (leading slash), or null when nothing arrived. */
     folderPath: string | null;
 }
+/**
+ * What CUBE's own series record says of a series stored in its PACS folder:
+ * its modality and description, no file read.
+ *
+ * @property modality - The series' modality, when recorded.
+ * @property seriesDescription - The series' description, when recorded.
+ */
+export interface PACSSeriesFacts {
+    modality?: string;
+    seriesDescription?: string;
+}
+/**
+ * The series folder a path lies in, when it lies in CUBE's PACS store
+ * (`SERVICES/PACS/<pacs>/<patient>/<study>/<series>/...`).
+ *
+ * @param path - A CFS path, with or without its leading slash.
+ * @returns The series folder (no leading slash), its PACS and its patient folder; null elsewhere.
+ */
+export declare function pacsSeriesFolder_of(path: string): {
+    folder: string;
+    pacs: string;
+    patient: string;
+} | null;
+/**
+ * What CUBE's series record says of the series a PACS path lies in. CUBE
+ * cannot be asked by folder, but a patient folder begins with the patient's
+ * ID, and the series list answers by patient: the patient's series are
+ * asked for once, and the folder matched exactly among them. A path outside
+ * the PACS store, a folder not found, or a failed ask is none.
+ *
+ * @param path - A CFS path in the PACS store.
+ * @returns The series' facts, or null.
+ */
+export declare function pacsSeriesFacts_ofPath(path: string): Promise<PACSSeriesFacts | null>;
+/** Forgets the series records fetched: a test, or a new identity. */
+export declare function pacsSeriesFacts_clear(): void;
 /**
  * Resolves a series' CUBE storage state: its registered file count and the
  * folder it landed in.

package/dist/pacs/chrisPACS.js

@@ -20,6 +20,9 @@ exports.pacsQuery_get = pacsQuery_get;
 exports.pacsRetrieve_create = pacsRetrieve_create;
 exports.pacsRetrieves_list = pacsRetrieves_list;
 exports.pacsRetrieve_delete = pacsRetrieve_delete;
+exports.pacsSeriesFolder_of = pacsSeriesFolder_of;
+exports.pacsSeriesFacts_ofPath = pacsSeriesFacts_ofPath;
+exports.pacsSeriesFacts_clear = pacsSeriesFacts_clear;
 exports.seriesStorage_resolve = seriesStorage_resolve;
 exports.seriesStorage_resolveMany = seriesStorage_resolveMany;
 exports.pacsRetrieve_statusForQuery = pacsRetrieve_statusForQuery;
@@ -380,6 +383,87 @@ async function pacsRetrieve_delete(retrieveId) {
         return (0, result_js_1.Err)();
     }
 }
+/** Series records already fetched, by PACS and patient folder: one ask serves every series of a patient. */
+const seriesByPatient = new Map();
+/**
+ * The series folder a path lies in, when it lies in CUBE's PACS store
+ * (`SERVICES/PACS/<pacs>/<patient>/<study>/<series>/...`).
+ *
+ * @param path - A CFS path, with or without its leading slash.
+ * @returns The series folder (no leading slash), its PACS and its patient folder; null elsewhere.
+ */
+function pacsSeriesFolder_of(path) {
+    const parts = path.replace(/^\/+/, '').split('/');
+    if (parts.length < 6 || parts[0] !== 'SERVICES' || parts[1] !== 'PACS')
+        return null;
+    const [, , pacs, patient] = parts;
+    if (pacs.length === 0 || patient.length === 0)
+        return null;
+    return { folder: parts.slice(0, 6).join('/'), pacs, patient };
+}
+/**
+ * What CUBE's series record says of the series a PACS path lies in. CUBE
+ * cannot be asked by folder, but a patient folder begins with the patient's
+ * ID, and the series list answers by patient: the patient's series are
+ * asked for once, and the folder matched exactly among them. A path outside
+ * the PACS store, a folder not found, or a failed ask is none.
+ *
+ * @param path - A CFS path in the PACS store.
+ * @returns The series' facts, or null.
+ */
+async function pacsSeriesFacts_ofPath(path) {
+    const at = pacsSeriesFolder_of(path);
+    if (at === null)
+        return null;
+    const patientID = at.patient.split('-')[0] ?? '';
+    if (patientID.length === 0)
+        return null;
+    const key = `${at.pacs}/${at.patient}`;
+    let asked = seriesByPatient.get(key);
+    if (asked === undefined) {
+        asked = patientSeries_fetch(at.pacs, patientID).catch(() => {
+            // A failed ask is forgotten, so the next feed of this patient asks again.
+            seriesByPatient.delete(key);
+            return new Map();
+        });
+        seriesByPatient.set(key, asked);
+    }
+    return (await asked).get(at.folder) ?? null;
+}
+/** Every series CUBE records for one patient in one PACS, by folder: only modality and description kept. */
+async function patientSeries_fetch(pacs, patientID) {
+    const found = new Map();
+    const client = await chrisConnection_js_1.chrisConnection.client_get();
+    if (!client)
+        return found;
+    for (let offset = 0;; offset += SERIES_PAGE) {
+        const page = await client.getPACSSeriesList({ PatientID: patientID, pacs_identifier: pacs, limit: SERIES_PAGE, offset });
+        const items = page.getItems();
+        if (!items || items.length === 0)
+            break;
+        for (const item of items) {
+            const data = (0, adapter_js_1.itemData_get)(item);
+            const folder = data?.folder_path?.replace(/^\/+/, '');
+            if (!folder)
+                continue;
+            const facts = {};
+            const modality = (data?.Modality ?? '').trim();
+            const description = (data?.SeriesDescription ?? '').trim();
+            if (modality.length > 0)
+                facts.modality = modality;
+            if (description.length > 0)
+                facts.seriesDescription = description;
+            found.set(folder, facts);
+        }
+        if (items.length < SERIES_PAGE)
+            break;
+    }
+    return found;
+}
+/** Forgets the series records fetched: a test, or a new identity. */
+function pacsSeriesFacts_clear() {
+    seriesByPatient.clear();
+}
 /**
  * Resolves a series' CUBE storage state: its registered file count and the
  * folder it landed in.