@fnndsc/cumin 3.25.0 → 3.27.0

package/dist/pipelines/pipelineMemo.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pipelineRecord_recall = pipelineRecord_recall;
+exports.pipelineRecord_keep = pipelineRecord_keep;
+exports.pipelineResource_recall = pipelineResource_recall;
+exports.pipelineResource_keep = pipelineResource_keep;
+exports.pipeline_forget = pipeline_forget;
+exports.pipelineMemo_count = pipelineMemo_count;
+/** Memos by client: a new connection starts empty. */
+const memos = new WeakMap();
+/**
+ * The memo of one client, made on first use.
+ *
+ * @param client - The connection's chrisapi client.
+ * @returns That client's memo.
+ */
+function memo_for(client) {
+    const kept = memos.get(client);
+    if (kept !== undefined)
+        return kept;
+    const made = { records: new Map(), resources: new Map() };
+    memos.set(client, made);
+    return made;
+}
+/**
+ * Recalls a resolution.
+ *
+ * @param client - The connection's chrisapi client.
+ * @param specifier - The name or id string that was asked.
+ * @returns The record, or null when this session never resolved it.
+ */
+function pipelineRecord_recall(client, specifier) {
+    return memo_for(client).records.get(specifier) ?? null;
+}
+/**
+ * Keeps a resolution under the specifier asked and under the record's own
+ * name and id, so any of the three answers next time.
+ *
+ * @param client - The connection's chrisapi client.
+ * @param specifier - The name or id string that was asked.
+ * @param record - The record it resolved to.
+ */
+function pipelineRecord_keep(client, specifier, record) {
+    const memo = memo_for(client);
+    memo.records.set(specifier, record);
+    memo.records.set(record.name, record);
+    memo.records.set(String(record.id), record);
+}
+/**
+ * Recalls the chrisapi item of a pipeline.
+ *
+ * @param client - The connection's chrisapi client.
+ * @param pipelineID - The pipeline's id.
+ * @returns The item, or null when none was served this session.
+ */
+function pipelineResource_recall(client, pipelineID) {
+    return memo_for(client).resources.get(pipelineID) ?? null;
+}
+/**
+ * Keeps the chrisapi item a search or a get served.
+ *
+ * @param client - The connection's chrisapi client.
+ * @param pipelineID - The pipeline's id.
+ * @param resource - The chrisapi pipeline item.
+ */
+function pipelineResource_keep(client, pipelineID, resource) {
+    memo_for(client).resources.set(pipelineID, resource);
+}
+/**
+ * Forgets one pipeline: its item and every specifier that resolved to it.
+ * Called when an item kept turns out not to answer (the pipeline was
+ * removed under the session), so the next ask resolves afresh.
+ *
+ * @param client - The connection's chrisapi client.
+ * @param pipelineID - The pipeline's id.
+ */
+function pipeline_forget(client, pipelineID) {
+    const memo = memo_for(client);
+    memo.resources.delete(pipelineID);
+    for (const [specifier, record] of memo.records) {
+        if (record.id === pipelineID)
+            memo.records.delete(specifier);
+    }
+}
+/**
+ * How many resolutions a client's memo holds (for tests and readouts).
+ *
+ * @param client - The connection's chrisapi client.
+ * @returns The count of specifiers kept.
+ */
+function pipelineMemo_count(client) {
+    return memos.get(client)?.records.size ?? 0;
+}
+//# sourceMappingURL=pipelineMemo.js.map

package/dist/pipelines/pipelineMemo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineMemo.js","sourceRoot":"","sources":["../../src/pipelines/pipelineMemo.ts"],"names":[],"mappings":";;AA+CA,sDAEC;AAUD,kDAKC;AASD,0DAEC;AASD,sDAEC;AAUD,0CAMC;AAQD,gDAEC;AAzFD,sDAAsD;AACtD,MAAM,KAAK,GAAkC,IAAI,OAAO,EAAE,CAAC;AAE3D;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,MAAc;IAC9B,MAAM,IAAI,GAA6B,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAiB,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IACxE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,MAAc,EAAE,SAAiB;IACrE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,MAAc,EAAE,SAAiB,EAAE,MAAsB;IAC3F,MAAM,IAAI,GAAiB,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,uBAAuB,CAAC,MAAc,EAAE,UAAkB;IACxE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,MAAc,EAAE,UAAkB,EAAE,QAAgB;IACxF,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,MAAc,EAAE,UAAkB;IAChE,MAAM,IAAI,GAAiB,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/C,IAAI,MAAM,CAAC,EAAE,KAAK,UAAU;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,MAAc;IAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fnndsc/cumin",
-  "version": "3.25.0",
+  "version": "3.27.0",
   "description": "Utility library for ChILI and other ChRIS-related JavaScript applications",
   "repository": {
     "type": "git",
@@ -23,6 +23,11 @@
       "types": "./dist/index.d.ts",
       "require": "./dist/index.js"
     },
+    "./request-ledger": {
+      "import": "./dist/net/requestLedger.js",
+      "types": "./dist/net/requestLedger.d.ts",
+      "require": "./dist/net/requestLedger.js"
+    },
     "./dicom-payload": {
       "import": "./dist/pacs/dicomPayload.js",
       "types": "./dist/pacs/dicomPayload.d.ts",
@@ -63,6 +68,6 @@
     "@fnndsc/chrisapi": "^1.25.0",
     "chalk": "^4.1.2",
     "figlet": "^1.7.0",
-    "@fnndsc/menu": "^0.13.0"
+    "@fnndsc/menu": "^0.15.0"
   }
 }