@milaboratories/pl-drivers 1.9.0 → 1.10.0

package/dist/drivers/download_url/task.cjs

@@ -0,0 +1,150 @@
+'use strict';
+
+var computable = require('@milaboratories/computable');
+var tsHelpers = require('@milaboratories/ts-helpers');
+var fsp = require('node:fs/promises');
+var path = require('node:path');
+var node_stream = require('node:stream');
+var zlib = require('node:zlib');
+var tar = require('tar-fs');
+var download = require('../../helpers/download.cjs');
+var url = require('../urls/url.cjs');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fsp__namespace = /*#__PURE__*/_interopNamespaceDefault(fsp);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+var zlib__namespace = /*#__PURE__*/_interopNamespaceDefault(zlib);
+var tar__namespace = /*#__PURE__*/_interopNamespaceDefault(tar);
+
+/** Downloads and extracts an archive to a directory. */
+class DownloadByUrlTask {
+    logger;
+    path;
+    url;
+    signer;
+    saveDir;
+    counter = new tsHelpers.CallersCounter();
+    change = new computable.ChangeSource();
+    signalCtl = new AbortController();
+    error;
+    done = false;
+    size = 0;
+    constructor(logger, path, url, signer, saveDir) {
+        this.logger = logger;
+        this.path = path;
+        this.url = url;
+        this.signer = signer;
+        this.saveDir = saveDir;
+    }
+    info() {
+        return {
+            url: this.url.toString(),
+            path: this.path,
+            done: this.done,
+            size: this.size,
+            error: this.error,
+        };
+    }
+    attach(w, callerId) {
+        this.counter.inc(callerId);
+        if (!this.done)
+            this.change.attachWatcher(w);
+    }
+    async download(clientDownload, withGunzip) {
+        try {
+            const size = await this.downloadAndUntar(clientDownload, withGunzip, this.signalCtl.signal);
+            this.setDone(size);
+            this.change.markChanged(`download of ${this.url} finished`);
+        }
+        catch (e) {
+            if (e instanceof URLAborted || e instanceof download.NetworkError400) {
+                this.setError(e);
+                this.change.markChanged(`download of ${this.url} failed`);
+                // Just in case we were half-way extracting an archive.
+                await rmRFDir(this.path);
+                return;
+            }
+            throw e;
+        }
+    }
+    async downloadAndUntar(clientDownload, withGunzip, signal) {
+        await tsHelpers.ensureDirExists(path__namespace.dirname(this.path));
+        if (await tsHelpers.fileExists(this.path)) {
+            return await dirSize(this.path);
+        }
+        const size = await clientDownload.withContent(this.url.toString(), {}, { signal }, async (content, size) => {
+            let processedContent = content;
+            if (withGunzip) {
+                const gunzip = node_stream.Transform.toWeb(zlib__namespace.createGunzip());
+                processedContent = content.pipeThrough(gunzip, { signal });
+            }
+            await tsHelpers.createPathAtomically(this.logger, this.path, async (fPath) => {
+                await fsp__namespace.mkdir(fPath); // throws if a directory already exists.
+                const untar = node_stream.Writable.toWeb(tar__namespace.extract(fPath));
+                await processedContent.pipeTo(untar, { signal });
+            });
+            return size;
+        });
+        return size;
+    }
+    getUrl() {
+        if (this.done)
+            return {
+                url: url.newBlockUIURL(this.signer, this.saveDir, tsHelpers.notEmpty(this.path))
+            };
+        if (this.error)
+            return { error: this.error };
+        return undefined;
+    }
+    setDone(size) {
+        this.done = true;
+        this.size = size;
+    }
+    setError(e) {
+        this.error = String(e);
+    }
+    abort(reason) {
+        this.signalCtl.abort(new URLAborted(reason));
+    }
+}
+/** Throws when a downloading aborts. */
+class URLAborted extends Error {
+    name = 'URLAborted';
+}
+/** Gets a directory size by calculating sizes recursively. */
+async function dirSize(dir) {
+    const files = await fsp__namespace.readdir(dir, { withFileTypes: true });
+    const sizes = await Promise.all(files.map(async (file) => {
+        const fPath = path__namespace.join(dir, file.name);
+        if (file.isDirectory())
+            return await dirSize(fPath);
+        const stat = await fsp__namespace.stat(fPath);
+        return stat.size;
+    }));
+    return sizes.reduce((sum, size) => sum + size, 0);
+}
+/** Do rm -rf on dir. */
+async function rmRFDir(path) {
+    await fsp__namespace.rm(path, { recursive: true, force: true });
+}
+
+exports.DownloadByUrlTask = DownloadByUrlTask;
+exports.URLAborted = URLAborted;
+exports.rmRFDir = rmRFDir;
+//# sourceMappingURL=task.cjs.map

package/dist/drivers/download_url/task.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.cjs","sources":["../../../src/drivers/download_url/task.ts"],"sourcesContent":["import type { Watcher } from '@milaboratories/computable';\nimport { ChangeSource } from '@milaboratories/computable';\nimport type {\n  MiLogger,\n  Signer,\n} from '@milaboratories/ts-helpers';\nimport {\n  CallersCounter,\n  createPathAtomically,\n  ensureDirExists,\n  fileExists,\n  notEmpty,\n} from '@milaboratories/ts-helpers';\nimport * as fsp from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { Transform, Writable } from 'node:stream';\nimport * as zlib from 'node:zlib';\nimport * as tar from 'tar-fs';\nimport type { RemoteFileDownloader } from '../../helpers/download';\nimport { NetworkError400 } from '../../helpers/download';\nimport type { UrlResult } from './driver';\nimport { newBlockUIURL } from '../urls/url';\n\n/** Downloads and extracts an archive to a directory. */\nexport class DownloadByUrlTask {\n  readonly counter = new CallersCounter();\n  readonly change = new ChangeSource();\n  private readonly signalCtl = new AbortController();\n  error: string | undefined;\n  done = false;\n  size = 0;\n\n  constructor(\n    private readonly logger: MiLogger,\n    readonly path: string,\n    readonly url: URL,\n    readonly signer: Signer,\n    readonly saveDir: string,\n  ) { }\n\n  public info() {\n    return {\n      url: this.url.toString(),\n      path: this.path,\n      done: this.done,\n      size: this.size,\n      error: this.error,\n    };\n  }\n\n  attach(w: Watcher, callerId: string) {\n    this.counter.inc(callerId);\n    if (!this.done) this.change.attachWatcher(w);\n  }\n\n  async download(clientDownload: RemoteFileDownloader, withGunzip: boolean) {\n    try {\n      const size = await this.downloadAndUntar(clientDownload, withGunzip, this.signalCtl.signal);\n      this.setDone(size);\n      this.change.markChanged(`download of ${this.url} finished`);\n    } catch (e: unknown) {\n      if (e instanceof URLAborted || e instanceof NetworkError400) {\n        this.setError(e);\n        this.change.markChanged(`download of ${this.url} failed`);\n        // Just in case we were half-way extracting an archive.\n        await rmRFDir(this.path);\n        return;\n      }\n\n      throw e;\n    }\n  }\n\n  private async downloadAndUntar(\n    clientDownload: RemoteFileDownloader,\n    withGunzip: boolean,\n    signal: AbortSignal,\n  ): Promise<number> {\n    await ensureDirExists(path.dirname(this.path));\n\n    if (await fileExists(this.path)) {\n      return await dirSize(this.path);\n    }\n\n    const size = await clientDownload.withContent(\n      this.url.toString(), \n      {}, \n      { signal },\n      async (content, size) => {\n        let processedContent = content;\n        if (withGunzip) {\n          const gunzip = Transform.toWeb(zlib.createGunzip());\n          processedContent = content.pipeThrough(gunzip, { signal });\n        }\n\n        await createPathAtomically(this.logger, this.path, async (fPath: string) => {\n          await fsp.mkdir(fPath); // throws if a directory already exists.\n          const untar = Writable.toWeb(tar.extract(fPath));\n          await processedContent.pipeTo(untar, { signal });\n        });\n\n        return size;\n      }\n    );\n\n    return size;\n  }\n\n  getUrl(): UrlResult | undefined {\n    if (this.done) return {\n      url: newBlockUIURL(this.signer, this.saveDir, notEmpty(this.path))\n     };\n\n    if (this.error) return { error: this.error };\n\n    return undefined;\n  }\n\n  private setDone(size: number) {\n    this.done = true;\n    this.size = size;\n  }\n\n  private setError(e: any) {\n    this.error = String(e);\n  }\n\n  abort(reason: string) {\n    this.signalCtl.abort(new URLAborted(reason));\n  }\n}\n\n/** Throws when a downloading aborts. */\nexport class URLAborted extends Error {\n  name = 'URLAborted';\n}\n\n/** Gets a directory size by calculating sizes recursively. */\nasync function dirSize(dir: string): Promise<number> {\n  const files = await fsp.readdir(dir, { withFileTypes: true });\n  const sizes = await Promise.all(\n    files.map(async (file: any) => {\n      const fPath = path.join(dir, file.name);\n\n      if (file.isDirectory()) return await dirSize(fPath);\n\n      const stat = await fsp.stat(fPath);\n      return stat.size;\n    }),\n  );\n\n  return sizes.reduce((sum: any, size: any) => sum + size, 0);\n}\n\n/** Do rm -rf on dir. */\nexport async function rmRFDir(path: string) {\n  await fsp.rm(path, { recursive: true, force: true });\n}\n"],"names":["CallersCounter","ChangeSource","NetworkError400","ensureDirExists","path","fileExists","Transform","zlib","createPathAtomically","fsp","Writable","tar","newBlockUIURL","notEmpty"],"mappings":"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"}

package/dist/drivers/download_url/task.d.ts

@@ -37,4 +37,3 @@ export declare class URLAborted extends Error {
 }
 /** Do rm -rf on dir. */
 export declare function rmRFDir(path: string): Promise<void>;
-//# sourceMappingURL=task.d.ts.map

package/dist/drivers/download_url/task.js

@@ -0,0 +1,124 @@
+import { ChangeSource } from '@milaboratories/computable';
+import { CallersCounter, ensureDirExists, fileExists, createPathAtomically, notEmpty } from '@milaboratories/ts-helpers';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { Transform, Writable } from 'node:stream';
+import * as zlib from 'node:zlib';
+import * as tar from 'tar-fs';
+import { NetworkError400 } from '../../helpers/download.js';
+import { newBlockUIURL } from '../urls/url.js';
+
+/** Downloads and extracts an archive to a directory. */
+class DownloadByUrlTask {
+    logger;
+    path;
+    url;
+    signer;
+    saveDir;
+    counter = new CallersCounter();
+    change = new ChangeSource();
+    signalCtl = new AbortController();
+    error;
+    done = false;
+    size = 0;
+    constructor(logger, path, url, signer, saveDir) {
+        this.logger = logger;
+        this.path = path;
+        this.url = url;
+        this.signer = signer;
+        this.saveDir = saveDir;
+    }
+    info() {
+        return {
+            url: this.url.toString(),
+            path: this.path,
+            done: this.done,
+            size: this.size,
+            error: this.error,
+        };
+    }
+    attach(w, callerId) {
+        this.counter.inc(callerId);
+        if (!this.done)
+            this.change.attachWatcher(w);
+    }
+    async download(clientDownload, withGunzip) {
+        try {
+            const size = await this.downloadAndUntar(clientDownload, withGunzip, this.signalCtl.signal);
+            this.setDone(size);
+            this.change.markChanged(`download of ${this.url} finished`);
+        }
+        catch (e) {
+            if (e instanceof URLAborted || e instanceof NetworkError400) {
+                this.setError(e);
+                this.change.markChanged(`download of ${this.url} failed`);
+                // Just in case we were half-way extracting an archive.
+                await rmRFDir(this.path);
+                return;
+            }
+            throw e;
+        }
+    }
+    async downloadAndUntar(clientDownload, withGunzip, signal) {
+        await ensureDirExists(path.dirname(this.path));
+        if (await fileExists(this.path)) {
+            return await dirSize(this.path);
+        }
+        const size = await clientDownload.withContent(this.url.toString(), {}, { signal }, async (content, size) => {
+            let processedContent = content;
+            if (withGunzip) {
+                const gunzip = Transform.toWeb(zlib.createGunzip());
+                processedContent = content.pipeThrough(gunzip, { signal });
+            }
+            await createPathAtomically(this.logger, this.path, async (fPath) => {
+                await fsp.mkdir(fPath); // throws if a directory already exists.
+                const untar = Writable.toWeb(tar.extract(fPath));
+                await processedContent.pipeTo(untar, { signal });
+            });
+            return size;
+        });
+        return size;
+    }
+    getUrl() {
+        if (this.done)
+            return {
+                url: newBlockUIURL(this.signer, this.saveDir, notEmpty(this.path))
+            };
+        if (this.error)
+            return { error: this.error };
+        return undefined;
+    }
+    setDone(size) {
+        this.done = true;
+        this.size = size;
+    }
+    setError(e) {
+        this.error = String(e);
+    }
+    abort(reason) {
+        this.signalCtl.abort(new URLAborted(reason));
+    }
+}
+/** Throws when a downloading aborts. */
+class URLAborted extends Error {
+    name = 'URLAborted';
+}
+/** Gets a directory size by calculating sizes recursively. */
+async function dirSize(dir) {
+    const files = await fsp.readdir(dir, { withFileTypes: true });
+    const sizes = await Promise.all(files.map(async (file) => {
+        const fPath = path.join(dir, file.name);
+        if (file.isDirectory())
+            return await dirSize(fPath);
+        const stat = await fsp.stat(fPath);
+        return stat.size;
+    }));
+    return sizes.reduce((sum, size) => sum + size, 0);
+}
+/** Do rm -rf on dir. */
+async function rmRFDir(path) {
+    await fsp.rm(path, { recursive: true, force: true });
+}
+
+export { DownloadByUrlTask, URLAborted, rmRFDir };
+//# sourceMappingURL=task.js.map

package/dist/drivers/download_url/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sources":["../../../src/drivers/download_url/task.ts"],"sourcesContent":["import type { Watcher } from '@milaboratories/computable';\nimport { ChangeSource } from '@milaboratories/computable';\nimport type {\n  MiLogger,\n  Signer,\n} from '@milaboratories/ts-helpers';\nimport {\n  CallersCounter,\n  createPathAtomically,\n  ensureDirExists,\n  fileExists,\n  notEmpty,\n} from '@milaboratories/ts-helpers';\nimport * as fsp from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { Transform, Writable } from 'node:stream';\nimport * as zlib from 'node:zlib';\nimport * as tar from 'tar-fs';\nimport type { RemoteFileDownloader } from '../../helpers/download';\nimport { NetworkError400 } from '../../helpers/download';\nimport type { UrlResult } from './driver';\nimport { newBlockUIURL } from '../urls/url';\n\n/** Downloads and extracts an archive to a directory. */\nexport class DownloadByUrlTask {\n  readonly counter = new CallersCounter();\n  readonly change = new ChangeSource();\n  private readonly signalCtl = new AbortController();\n  error: string | undefined;\n  done = false;\n  size = 0;\n\n  constructor(\n    private readonly logger: MiLogger,\n    readonly path: string,\n    readonly url: URL,\n    readonly signer: Signer,\n    readonly saveDir: string,\n  ) { }\n\n  public info() {\n    return {\n      url: this.url.toString(),\n      path: this.path,\n      done: this.done,\n      size: this.size,\n      error: this.error,\n    };\n  }\n\n  attach(w: Watcher, callerId: string) {\n    this.counter.inc(callerId);\n    if (!this.done) this.change.attachWatcher(w);\n  }\n\n  async download(clientDownload: RemoteFileDownloader, withGunzip: boolean) {\n    try {\n      const size = await this.downloadAndUntar(clientDownload, withGunzip, this.signalCtl.signal);\n      this.setDone(size);\n      this.change.markChanged(`download of ${this.url} finished`);\n    } catch (e: unknown) {\n      if (e instanceof URLAborted || e instanceof NetworkError400) {\n        this.setError(e);\n        this.change.markChanged(`download of ${this.url} failed`);\n        // Just in case we were half-way extracting an archive.\n        await rmRFDir(this.path);\n        return;\n      }\n\n      throw e;\n    }\n  }\n\n  private async downloadAndUntar(\n    clientDownload: RemoteFileDownloader,\n    withGunzip: boolean,\n    signal: AbortSignal,\n  ): Promise<number> {\n    await ensureDirExists(path.dirname(this.path));\n\n    if (await fileExists(this.path)) {\n      return await dirSize(this.path);\n    }\n\n    const size = await clientDownload.withContent(\n      this.url.toString(), \n      {}, \n      { signal },\n      async (content, size) => {\n        let processedContent = content;\n        if (withGunzip) {\n          const gunzip = Transform.toWeb(zlib.createGunzip());\n          processedContent = content.pipeThrough(gunzip, { signal });\n        }\n\n        await createPathAtomically(this.logger, this.path, async (fPath: string) => {\n          await fsp.mkdir(fPath); // throws if a directory already exists.\n          const untar = Writable.toWeb(tar.extract(fPath));\n          await processedContent.pipeTo(untar, { signal });\n        });\n\n        return size;\n      }\n    );\n\n    return size;\n  }\n\n  getUrl(): UrlResult | undefined {\n    if (this.done) return {\n      url: newBlockUIURL(this.signer, this.saveDir, notEmpty(this.path))\n     };\n\n    if (this.error) return { error: this.error };\n\n    return undefined;\n  }\n\n  private setDone(size: number) {\n    this.done = true;\n    this.size = size;\n  }\n\n  private setError(e: any) {\n    this.error = String(e);\n  }\n\n  abort(reason: string) {\n    this.signalCtl.abort(new URLAborted(reason));\n  }\n}\n\n/** Throws when a downloading aborts. */\nexport class URLAborted extends Error {\n  name = 'URLAborted';\n}\n\n/** Gets a directory size by calculating sizes recursively. */\nasync function dirSize(dir: string): Promise<number> {\n  const files = await fsp.readdir(dir, { withFileTypes: true });\n  const sizes = await Promise.all(\n    files.map(async (file: any) => {\n      const fPath = path.join(dir, file.name);\n\n      if (file.isDirectory()) return await dirSize(fPath);\n\n      const stat = await fsp.stat(fPath);\n      return stat.size;\n    }),\n  );\n\n  return sizes.reduce((sum: any, size: any) => sum + size, 0);\n}\n\n/** Do rm -rf on dir. */\nexport async function rmRFDir(path: string) {\n  await fsp.rm(path, { recursive: true, force: true });\n}\n"],"names":[],"mappings":"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"}

package/dist/drivers/helpers/download_local_handle.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+/** Handle of locally downloaded blob. This handle is issued only after the
+ * blob's content is downloaded locally, and ready for quick access. */
+// https://regex101.com/r/kfnBVX/1
+const localHandleRegex = /^blob\+local:\/\/download\/(?<path>.*)#(?<signature>.*)$/;
+function newLocalHandle(path, signer) {
+    return `blob+local://download/${path}#${signer.sign(path)}`;
+}
+function isLocalBlobHandle(handle) {
+    return Boolean(handle.match(localHandleRegex));
+}
+function parseLocalHandle(handle, signer) {
+    const parsed = handle.match(localHandleRegex);
+    if (parsed === null) {
+        throw new Error(`Local handle is malformed: ${handle}, matches: ${parsed}`);
+    }
+    const { path, signature } = parsed.groups;
+    signer.verify(path, signature, `Signature verification failed for: ${handle}`);
+    return { path, signature };
+}
+
+exports.isLocalBlobHandle = isLocalBlobHandle;
+exports.newLocalHandle = newLocalHandle;
+exports.parseLocalHandle = parseLocalHandle;
+//# sourceMappingURL=download_local_handle.cjs.map

package/dist/drivers/helpers/download_local_handle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"download_local_handle.cjs","sources":["../../../src/drivers/helpers/download_local_handle.ts"],"sourcesContent":["/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\n\nimport type { LocalBlobHandle } from '@milaboratories/pl-model-common';\nimport type { Signer } from '@milaboratories/ts-helpers';\n\n// https://regex101.com/r/kfnBVX/1\nconst localHandleRegex = /^blob\\+local:\\/\\/download\\/(?<path>.*)#(?<signature>.*)$/;\n\nexport function newLocalHandle(path: string, signer: Signer): LocalBlobHandle {\n  return `blob+local://download/${path}#${signer.sign(path)}` as LocalBlobHandle;\n}\n\nexport function isLocalBlobHandle(handle: string): handle is LocalBlobHandle {\n  return Boolean(handle.match(localHandleRegex));\n}\n\nexport function parseLocalHandle(handle: LocalBlobHandle, signer: Signer) {\n  const parsed = handle.match(localHandleRegex);\n\n  if (parsed === null) {\n    throw new Error(`Local handle is malformed: ${handle}, matches: ${parsed}`);\n  }\n\n  const { path, signature } = parsed.groups!;\n  signer.verify(path, signature, `Signature verification failed for: ${handle}`);\n\n  return { path, signature };\n}\n"],"names":[],"mappings":";;AAAA;AACuE;AAKvE;AACA,MAAM,gBAAgB,GAAG,0DAA0D;AAE7E,SAAU,cAAc,CAAC,IAAY,EAAE,MAAc,EAAA;IACzD,OAAO,CAAA,sBAAA,EAAyB,IAAI,CAAA,CAAA,EAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAqB;AAChF;AAEM,SAAU,iBAAiB,CAAC,MAAc,EAAA;IAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAChD;AAEM,SAAU,gBAAgB,CAAC,MAAuB,EAAE,MAAc,EAAA;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC;AAE7C,IAAA,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,CAAA,2BAAA,EAA8B,MAAM,CAAA,WAAA,EAAc,MAAM,CAAA,CAAE,CAAC;IAC7E;IAEA,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAO;IAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,CAAA,mCAAA,EAAsC,MAAM,CAAA,CAAE,CAAC;AAE9E,IAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;AAC5B;;;;;;"}

package/dist/drivers/helpers/download_local_handle.d.ts

@@ -6,4 +6,3 @@ export declare function parseLocalHandle(handle: LocalBlobHandle, signer: Signer
     path: string;
     signature: string;
 };
-//# sourceMappingURL=download_local_handle.d.ts.map

package/dist/drivers/helpers/download_local_handle.js

@@ -0,0 +1,22 @@
+/** Handle of locally downloaded blob. This handle is issued only after the
+ * blob's content is downloaded locally, and ready for quick access. */
+// https://regex101.com/r/kfnBVX/1
+const localHandleRegex = /^blob\+local:\/\/download\/(?<path>.*)#(?<signature>.*)$/;
+function newLocalHandle(path, signer) {
+    return `blob+local://download/${path}#${signer.sign(path)}`;
+}
+function isLocalBlobHandle(handle) {
+    return Boolean(handle.match(localHandleRegex));
+}
+function parseLocalHandle(handle, signer) {
+    const parsed = handle.match(localHandleRegex);
+    if (parsed === null) {
+        throw new Error(`Local handle is malformed: ${handle}, matches: ${parsed}`);
+    }
+    const { path, signature } = parsed.groups;
+    signer.verify(path, signature, `Signature verification failed for: ${handle}`);
+    return { path, signature };
+}
+
+export { isLocalBlobHandle, newLocalHandle, parseLocalHandle };
+//# sourceMappingURL=download_local_handle.js.map

package/dist/drivers/helpers/download_local_handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download_local_handle.js","sources":["../../../src/drivers/helpers/download_local_handle.ts"],"sourcesContent":["/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\n\nimport type { LocalBlobHandle } from '@milaboratories/pl-model-common';\nimport type { Signer } from '@milaboratories/ts-helpers';\n\n// https://regex101.com/r/kfnBVX/1\nconst localHandleRegex = /^blob\\+local:\\/\\/download\\/(?<path>.*)#(?<signature>.*)$/;\n\nexport function newLocalHandle(path: string, signer: Signer): LocalBlobHandle {\n  return `blob+local://download/${path}#${signer.sign(path)}` as LocalBlobHandle;\n}\n\nexport function isLocalBlobHandle(handle: string): handle is LocalBlobHandle {\n  return Boolean(handle.match(localHandleRegex));\n}\n\nexport function parseLocalHandle(handle: LocalBlobHandle, signer: Signer) {\n  const parsed = handle.match(localHandleRegex);\n\n  if (parsed === null) {\n    throw new Error(`Local handle is malformed: ${handle}, matches: ${parsed}`);\n  }\n\n  const { path, signature } = parsed.groups!;\n  signer.verify(path, signature, `Signature verification failed for: ${handle}`);\n\n  return { path, signature };\n}\n"],"names":[],"mappings":"AAAA;AACuE;AAKvE;AACA,MAAM,gBAAgB,GAAG,0DAA0D;AAE7E,SAAU,cAAc,CAAC,IAAY,EAAE,MAAc,EAAA;IACzD,OAAO,CAAA,sBAAA,EAAyB,IAAI,CAAA,CAAA,EAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAqB;AAChF;AAEM,SAAU,iBAAiB,CAAC,MAAc,EAAA;IAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAChD;AAEM,SAAU,gBAAgB,CAAC,MAAuB,EAAE,MAAc,EAAA;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC;AAE7C,IAAA,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,CAAA,2BAAA,EAA8B,MAAM,CAAA,WAAA,EAAc,MAAM,CAAA,CAAE,CAAC;IAC7E;IAEA,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAO;IAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,CAAA,mCAAA,EAAsC,MAAM,CAAA,CAAE,CAAC;AAE9E,IAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;AAC5B;;;;"}

package/dist/drivers/helpers/download_remote_handle.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+var plClient = require('@milaboratories/pl-client');
+var types = require('../types.cjs');
+
+/** Handle of remote blob. This handle is issued as soon as the data becomes
+ * available on the remote server. */
+// https://regex101.com/r/Q4YdTa/5
+const remoteHandleRegex = /^blob\+remote:\/\/download\/(?<content>(?<resourceType>.+)\/(?<resourceVersion>.+?)\/(?<resourceId>\d+?)\/(?<size>\d+?))#(?<signature>.*)$/;
+function newRemoteHandle(rInfo, signer) {
+    let content = `${rInfo.type.name}/${rInfo.type.version}/${BigInt(rInfo.id)}/${types.getSize(rInfo)}`;
+    return `blob+remote://download/${content}#${signer.sign(content)}`;
+}
+function isRemoteBlobHandle(handle) {
+    return Boolean(handle.match(remoteHandleRegex));
+}
+function parseRemoteHandle(handle, signer) {
+    const parsed = handle.match(remoteHandleRegex);
+    if (parsed === null) {
+        throw new Error(`Remote handle is malformed: ${handle}, matches: ${parsed}`);
+    }
+    const { content, resourceType, resourceVersion, resourceId, size, signature } = parsed.groups;
+    signer.verify(content, signature, `Signature verification failed for ${handle}`);
+    return {
+        info: {
+            id: plClient.bigintToResourceId(BigInt(resourceId)),
+            type: { name: resourceType, version: resourceVersion },
+        },
+        size: Number(size),
+    };
+}
+
+exports.isRemoteBlobHandle = isRemoteBlobHandle;
+exports.newRemoteHandle = newRemoteHandle;
+exports.parseRemoteHandle = parseRemoteHandle;
+//# sourceMappingURL=download_remote_handle.cjs.map

package/dist/drivers/helpers/download_remote_handle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"download_remote_handle.cjs","sources":["../../../src/drivers/helpers/download_remote_handle.ts"],"sourcesContent":["/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\n\nimport type { Signer } from '@milaboratories/ts-helpers';\nimport type { OnDemandBlobResourceSnapshot } from '../types';\nimport type { RemoteBlobHandle } from '@milaboratories/pl-model-common';\nimport { bigintToResourceId } from '@milaboratories/pl-client';\nimport { ResourceInfo } from '@milaboratories/pl-tree';\nimport { getSize } from '../types';\n\n// https://regex101.com/r/Q4YdTa/5\nconst remoteHandleRegex\n  = /^blob\\+remote:\\/\\/download\\/(?<content>(?<resourceType>.+)\\/(?<resourceVersion>.+?)\\/(?<resourceId>\\d+?)\\/(?<size>\\d+?))#(?<signature>.*)$/;\n\nexport function newRemoteHandle(\n  rInfo: OnDemandBlobResourceSnapshot,\n  signer: Signer,\n): RemoteBlobHandle {\n  let content = `${rInfo.type.name}/${rInfo.type.version}/${BigInt(rInfo.id)}/${getSize(rInfo)}`;\n\n  return `blob+remote://download/${content}#${signer.sign(content)}` as RemoteBlobHandle;\n}\n\nexport function isRemoteBlobHandle(handle: string): handle is RemoteBlobHandle {\n  return Boolean(handle.match(remoteHandleRegex));\n}\n\nexport function parseRemoteHandle(handle: RemoteBlobHandle, signer: Signer): {\n  info: ResourceInfo;\n  size: number;\n } {\n  const parsed = handle.match(remoteHandleRegex);\n  if (parsed === null) {\n    throw new Error(`Remote handle is malformed: ${handle}, matches: ${parsed}`);\n  }\n\n  const { content, resourceType, resourceVersion, resourceId, size, signature } = parsed.groups!;\n\n  signer.verify(content, signature, `Signature verification failed for ${handle}`);\n\n  return {\n    info:{\n      id: bigintToResourceId(BigInt(resourceId)),\n      type: { name: resourceType, version: resourceVersion },\n    },\n    size: Number(size),\n  };\n}\n"],"names":["getSize","bigintToResourceId"],"mappings":";;;;;AAAA;AACqC;AASrC;AACA,MAAM,iBAAiB,GACnB,4IAA4I;AAE1I,SAAU,eAAe,CAC7B,KAAmC,EACnC,MAAc,EAAA;IAEd,IAAI,OAAO,GAAG,CAAA,EAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA,CAAA,EAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAA,CAAA,EAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA,CAAA,EAAIA,aAAO,CAAC,KAAK,CAAC,CAAA,CAAE;IAE9F,OAAO,CAAA,uBAAA,EAA0B,OAAO,CAAA,CAAA,EAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA,CAAsB;AACxF;AAEM,SAAU,kBAAkB,CAAC,MAAc,EAAA;IAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACjD;AAEM,SAAU,iBAAiB,CAAC,MAAwB,EAAE,MAAc,EAAA;IAIxE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC;AAC9C,IAAA,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,CAAA,4BAAA,EAA+B,MAAM,CAAA,WAAA,EAAc,MAAM,CAAA,CAAE,CAAC;IAC9E;AAEA,IAAA,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAO;IAE9F,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,CAAA,kCAAA,EAAqC,MAAM,CAAA,CAAE,CAAC;IAEhF,OAAO;AACL,QAAA,IAAI,EAAC;AACH,YAAA,EAAE,EAAEC,2BAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE;AACvD,SAAA;AACD,QAAA,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;KACnB;AACH;;;;;;"}

package/dist/drivers/helpers/download_remote_handle.d.ts

@@ -8,4 +8,3 @@ export declare function parseRemoteHandle(handle: RemoteBlobHandle, signer: Sign
     info: ResourceInfo;
     size: number;
 };
-//# sourceMappingURL=download_remote_handle.d.ts.map

package/dist/drivers/helpers/download_remote_handle.js

@@ -0,0 +1,32 @@
+import { bigintToResourceId } from '@milaboratories/pl-client';
+import { getSize } from '../types.js';
+
+/** Handle of remote blob. This handle is issued as soon as the data becomes
+ * available on the remote server. */
+// https://regex101.com/r/Q4YdTa/5
+const remoteHandleRegex = /^blob\+remote:\/\/download\/(?<content>(?<resourceType>.+)\/(?<resourceVersion>.+?)\/(?<resourceId>\d+?)\/(?<size>\d+?))#(?<signature>.*)$/;
+function newRemoteHandle(rInfo, signer) {
+    let content = `${rInfo.type.name}/${rInfo.type.version}/${BigInt(rInfo.id)}/${getSize(rInfo)}`;
+    return `blob+remote://download/${content}#${signer.sign(content)}`;
+}
+function isRemoteBlobHandle(handle) {
+    return Boolean(handle.match(remoteHandleRegex));
+}
+function parseRemoteHandle(handle, signer) {
+    const parsed = handle.match(remoteHandleRegex);
+    if (parsed === null) {
+        throw new Error(`Remote handle is malformed: ${handle}, matches: ${parsed}`);
+    }
+    const { content, resourceType, resourceVersion, resourceId, size, signature } = parsed.groups;
+    signer.verify(content, signature, `Signature verification failed for ${handle}`);
+    return {
+        info: {
+            id: bigintToResourceId(BigInt(resourceId)),
+            type: { name: resourceType, version: resourceVersion },
+        },
+        size: Number(size),
+    };
+}
+
+export { isRemoteBlobHandle, newRemoteHandle, parseRemoteHandle };
+//# sourceMappingURL=download_remote_handle.js.map

package/dist/drivers/helpers/download_remote_handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download_remote_handle.js","sources":["../../../src/drivers/helpers/download_remote_handle.ts"],"sourcesContent":["/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\n\nimport type { Signer } from '@milaboratories/ts-helpers';\nimport type { OnDemandBlobResourceSnapshot } from '../types';\nimport type { RemoteBlobHandle } from '@milaboratories/pl-model-common';\nimport { bigintToResourceId } from '@milaboratories/pl-client';\nimport { ResourceInfo } from '@milaboratories/pl-tree';\nimport { getSize } from '../types';\n\n// https://regex101.com/r/Q4YdTa/5\nconst remoteHandleRegex\n  = /^blob\\+remote:\\/\\/download\\/(?<content>(?<resourceType>.+)\\/(?<resourceVersion>.+?)\\/(?<resourceId>\\d+?)\\/(?<size>\\d+?))#(?<signature>.*)$/;\n\nexport function newRemoteHandle(\n  rInfo: OnDemandBlobResourceSnapshot,\n  signer: Signer,\n): RemoteBlobHandle {\n  let content = `${rInfo.type.name}/${rInfo.type.version}/${BigInt(rInfo.id)}/${getSize(rInfo)}`;\n\n  return `blob+remote://download/${content}#${signer.sign(content)}` as RemoteBlobHandle;\n}\n\nexport function isRemoteBlobHandle(handle: string): handle is RemoteBlobHandle {\n  return Boolean(handle.match(remoteHandleRegex));\n}\n\nexport function parseRemoteHandle(handle: RemoteBlobHandle, signer: Signer): {\n  info: ResourceInfo;\n  size: number;\n } {\n  const parsed = handle.match(remoteHandleRegex);\n  if (parsed === null) {\n    throw new Error(`Remote handle is malformed: ${handle}, matches: ${parsed}`);\n  }\n\n  const { content, resourceType, resourceVersion, resourceId, size, signature } = parsed.groups!;\n\n  signer.verify(content, signature, `Signature verification failed for ${handle}`);\n\n  return {\n    info:{\n      id: bigintToResourceId(BigInt(resourceId)),\n      type: { name: resourceType, version: resourceVersion },\n    },\n    size: Number(size),\n  };\n}\n"],"names":[],"mappings":";;;AAAA;AACqC;AASrC;AACA,MAAM,iBAAiB,GACnB,4IAA4I;AAE1I,SAAU,eAAe,CAC7B,KAAmC,EACnC,MAAc,EAAA;IAEd,IAAI,OAAO,GAAG,CAAA,EAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA,CAAA,EAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAA,CAAA,EAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA,CAAA,EAAI,OAAO,CAAC,KAAK,CAAC,CAAA,CAAE;IAE9F,OAAO,CAAA,uBAAA,EAA0B,OAAO,CAAA,CAAA,EAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA,CAAsB;AACxF;AAEM,SAAU,kBAAkB,CAAC,MAAc,EAAA;IAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACjD;AAEM,SAAU,iBAAiB,CAAC,MAAwB,EAAE,MAAc,EAAA;IAIxE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC;AAC9C,IAAA,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,CAAA,4BAAA,EAA+B,MAAM,CAAA,WAAA,EAAc,MAAM,CAAA,CAAE,CAAC;IAC9E;AAEA,IAAA,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAO;IAE9F,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,CAAA,kCAAA,EAAqC,MAAM,CAAA,CAAE,CAAC;IAEhF,OAAO;AACL,QAAA,IAAI,EAAC;AACH,YAAA,EAAE,EAAE,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE;AACvD,SAAA;AACD,QAAA,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;KACnB;AACH;;;;"}

package/dist/drivers/helpers/files_cache.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+var tsHelpers = require('@milaboratories/ts-helpers');
+
+/** Holds counters of how many callers need the file.
+ * If some counters become zero and a cache size exceeds a soft limit,
+ * remove not needed blobs one by one.
+ * If all the files are needed, do nothing. */
+class FilesCache {
+    softSizeBytes;
+    cache = new Map();
+    totalSizeBytes = 0;
+    constructor(softSizeBytes) {
+        this.softSizeBytes = softSizeBytes;
+    }
+    existsFile(path) {
+        return this.cache.get(path) != undefined;
+    }
+    getFile(path, callerId) {
+        const file = this.cache.get(path);
+        if (file != undefined) {
+            file.counter.inc(callerId);
+        }
+        return file;
+    }
+    /** Decrements a counter in a cache and if we exceeds
+     * a soft limit, removes files with zero counters. */
+    removeFile(path, callerId) {
+        tsHelpers.mapGet(this.cache, path).counter.dec(callerId);
+        return this.toDelete();
+    }
+    /** Returns what results should be deleted to comply with the soft limit. */
+    toDelete() {
+        if (this.totalSizeBytes <= this.softSizeBytes)
+            return [];
+        const result = [];
+        let freedBytes = 0;
+        tsHelpers.mapEntries(this.cache)
+            .filter(([_, file]) => file.counter.isZero())
+            .forEach(([path, _]) => {
+            if (this.totalSizeBytes - freedBytes <= this.softSizeBytes) {
+                return;
+            }
+            const file = tsHelpers.mapGet(this.cache, path);
+            freedBytes += file.size;
+            result.push(file);
+        });
+        return result;
+    }
+    addCache(file, callerId) {
+        const created = this.cache.get(file.path) == undefined;
+        this.cache.set(file.path, file);
+        file.counter.inc(callerId);
+        if (file.size < 0) {
+            throw new Error(`empty sizeBytes: ${file}`);
+        }
+        if (created) {
+            this.totalSizeBytes += file.size;
+        }
+    }
+    removeCache(file) {
+        this.cache.delete(file.path);
+        this.totalSizeBytes -= file.size;
+    }
+}
+
+exports.FilesCache = FilesCache;
+//# sourceMappingURL=files_cache.cjs.map

package/dist/drivers/helpers/files_cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files_cache.cjs","sources":["../../../src/drivers/helpers/files_cache.ts"],"sourcesContent":["import type { CallersCounter } from '@milaboratories/ts-helpers';\nimport { mapEntries, mapGet } from '@milaboratories/ts-helpers';\n\ntype PathLike = string;\n\nexport interface CachedFile {\n  /** Size in bytes. */\n  size: number;\n  path: PathLike;\n  counter: CallersCounter;\n}\n\n/** Holds counters of how many callers need the file.\n * If some counters become zero and a cache size exceeds a soft limit,\n * remove not needed blobs one by one.\n * If all the files are needed, do nothing. */\nexport class FilesCache<T extends CachedFile> {\n  private cache: Map<PathLike, T> = new Map();\n  private totalSizeBytes: number = 0;\n\n  constructor(private readonly softSizeBytes: number) {}\n\n  existsFile(path: PathLike): boolean {\n    return this.cache.get(path) != undefined;\n  }\n\n  getFile(path: PathLike, callerId: string): T | undefined {\n    const file = this.cache.get(path);\n    if (file != undefined) {\n      file.counter.inc(callerId);\n    }\n\n    return file;\n  }\n\n  /** Decrements a counter in a cache and if we exceeds\n   * a soft limit, removes files with zero counters. */\n  removeFile(path: PathLike, callerId: string): T[] {\n    mapGet(this.cache, path).counter.dec(callerId);\n    return this.toDelete();\n  }\n\n  /** Returns what results should be deleted to comply with the soft limit. */\n  toDelete(): T[] {\n    if (this.totalSizeBytes <= this.softSizeBytes) return [];\n\n    const result: T[] = [];\n    let freedBytes = 0;\n\n    mapEntries(this.cache)\n      .filter(([_, file]: [string, T]) => file.counter.isZero())\n      .forEach(([path, _]) => {\n        if (this.totalSizeBytes - freedBytes <= this.softSizeBytes) {\n          return;\n        }\n\n        const file = mapGet(this.cache, path);\n        freedBytes += file.size;\n        result.push(file);\n      });\n\n    return result;\n  }\n\n  addCache(file: T, callerId: string) {\n    const created = this.cache.get(file.path) == undefined;\n    this.cache.set(file.path, file);\n    file.counter.inc(callerId);\n\n    if (file.size < 0) {\n      throw new Error(`empty sizeBytes: ${file}`);\n    }\n\n    if (created) {\n      this.totalSizeBytes += file.size;\n    }\n  }\n\n  removeCache(file: T) {\n    this.cache.delete(file.path);\n    this.totalSizeBytes -= file.size;\n  }\n}\n"],"names":["mapGet","mapEntries"],"mappings":";;;;AAYA;;;AAG8C;MACjC,UAAU,CAAA;AAIQ,IAAA,aAAA;AAHrB,IAAA,KAAK,GAAqB,IAAI,GAAG,EAAE;IACnC,cAAc,GAAW,CAAC;AAElC,IAAA,WAAA,CAA6B,aAAqB,EAAA;QAArB,IAAA,CAAA,aAAa,GAAb,aAAa;IAAW;AAErD,IAAA,UAAU,CAAC,IAAc,EAAA;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS;IAC1C;IAEA,OAAO,CAAC,IAAc,EAAE,QAAgB,EAAA;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AACjC,QAAA,IAAI,IAAI,IAAI,SAAS,EAAE;AACrB,YAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC5B;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;AACqD;IACrD,UAAU,CAAC,IAAc,EAAE,QAAgB,EAAA;AACzC,QAAAA,gBAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC9C,QAAA,OAAO,IAAI,CAAC,QAAQ,EAAE;IACxB;;IAGA,QAAQ,GAAA;AACN,QAAA,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,aAAa;AAAE,YAAA,OAAO,EAAE;QAExD,MAAM,MAAM,GAAQ,EAAE;QACtB,IAAI,UAAU,GAAG,CAAC;AAElB,QAAAC,oBAAU,CAAC,IAAI,CAAC,KAAK;AAClB,aAAA,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAc,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;aACxD,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAI;YACrB,IAAI,IAAI,CAAC,cAAc,GAAG,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE;gBAC1D;YACF;YAEA,MAAM,IAAI,GAAGD,gBAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;AACrC,YAAA,UAAU,IAAI,IAAI,CAAC,IAAI;AACvB,YAAA,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;AACnB,QAAA,CAAC,CAAC;AAEJ,QAAA,OAAO,MAAM;IACf;IAEA,QAAQ,CAAC,IAAO,EAAE,QAAgB,EAAA;AAChC,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;AAC/B,QAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAE1B,QAAA,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE;AACjB,YAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAA,CAAE,CAAC;QAC7C;QAEA,IAAI,OAAO,EAAE;AACX,YAAA,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI;QAClC;IACF;AAEA,IAAA,WAAW,CAAC,IAAO,EAAA;QACjB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;AAC5B,QAAA,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI;IAClC;AACD;;;;"}

package/dist/drivers/helpers/files_cache.d.ts

@@ -26,4 +26,3 @@ export declare class FilesCache<T extends CachedFile> {
     removeCache(file: T): void;
 }
 export {};
-//# sourceMappingURL=files_cache.d.ts.map

package/dist/drivers/helpers/files_cache.js

@@ -0,0 +1,66 @@
+import { mapGet, mapEntries } from '@milaboratories/ts-helpers';
+
+/** Holds counters of how many callers need the file.
+ * If some counters become zero and a cache size exceeds a soft limit,
+ * remove not needed blobs one by one.
+ * If all the files are needed, do nothing. */
+class FilesCache {
+    softSizeBytes;
+    cache = new Map();
+    totalSizeBytes = 0;
+    constructor(softSizeBytes) {
+        this.softSizeBytes = softSizeBytes;
+    }
+    existsFile(path) {
+        return this.cache.get(path) != undefined;
+    }
+    getFile(path, callerId) {
+        const file = this.cache.get(path);
+        if (file != undefined) {
+            file.counter.inc(callerId);
+        }
+        return file;
+    }
+    /** Decrements a counter in a cache and if we exceeds
+     * a soft limit, removes files with zero counters. */
+    removeFile(path, callerId) {
+        mapGet(this.cache, path).counter.dec(callerId);
+        return this.toDelete();
+    }
+    /** Returns what results should be deleted to comply with the soft limit. */
+    toDelete() {
+        if (this.totalSizeBytes <= this.softSizeBytes)
+            return [];
+        const result = [];
+        let freedBytes = 0;
+        mapEntries(this.cache)
+            .filter(([_, file]) => file.counter.isZero())
+            .forEach(([path, _]) => {
+            if (this.totalSizeBytes - freedBytes <= this.softSizeBytes) {
+                return;
+            }
+            const file = mapGet(this.cache, path);
+            freedBytes += file.size;
+            result.push(file);
+        });
+        return result;
+    }
+    addCache(file, callerId) {
+        const created = this.cache.get(file.path) == undefined;
+        this.cache.set(file.path, file);
+        file.counter.inc(callerId);
+        if (file.size < 0) {
+            throw new Error(`empty sizeBytes: ${file}`);
+        }
+        if (created) {
+            this.totalSizeBytes += file.size;
+        }
+    }
+    removeCache(file) {
+        this.cache.delete(file.path);
+        this.totalSizeBytes -= file.size;
+    }
+}
+
+export { FilesCache };
+//# sourceMappingURL=files_cache.js.map

package/dist/drivers/helpers/files_cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files_cache.js","sources":["../../../src/drivers/helpers/files_cache.ts"],"sourcesContent":["import type { CallersCounter } from '@milaboratories/ts-helpers';\nimport { mapEntries, mapGet } from '@milaboratories/ts-helpers';\n\ntype PathLike = string;\n\nexport interface CachedFile {\n  /** Size in bytes. */\n  size: number;\n  path: PathLike;\n  counter: CallersCounter;\n}\n\n/** Holds counters of how many callers need the file.\n * If some counters become zero and a cache size exceeds a soft limit,\n * remove not needed blobs one by one.\n * If all the files are needed, do nothing. */\nexport class FilesCache<T extends CachedFile> {\n  private cache: Map<PathLike, T> = new Map();\n  private totalSizeBytes: number = 0;\n\n  constructor(private readonly softSizeBytes: number) {}\n\n  existsFile(path: PathLike): boolean {\n    return this.cache.get(path) != undefined;\n  }\n\n  getFile(path: PathLike, callerId: string): T | undefined {\n    const file = this.cache.get(path);\n    if (file != undefined) {\n      file.counter.inc(callerId);\n    }\n\n    return file;\n  }\n\n  /** Decrements a counter in a cache and if we exceeds\n   * a soft limit, removes files with zero counters. */\n  removeFile(path: PathLike, callerId: string): T[] {\n    mapGet(this.cache, path).counter.dec(callerId);\n    return this.toDelete();\n  }\n\n  /** Returns what results should be deleted to comply with the soft limit. */\n  toDelete(): T[] {\n    if (this.totalSizeBytes <= this.softSizeBytes) return [];\n\n    const result: T[] = [];\n    let freedBytes = 0;\n\n    mapEntries(this.cache)\n      .filter(([_, file]: [string, T]) => file.counter.isZero())\n      .forEach(([path, _]) => {\n        if (this.totalSizeBytes - freedBytes <= this.softSizeBytes) {\n          return;\n        }\n\n        const file = mapGet(this.cache, path);\n        freedBytes += file.size;\n        result.push(file);\n      });\n\n    return result;\n  }\n\n  addCache(file: T, callerId: string) {\n    const created = this.cache.get(file.path) == undefined;\n    this.cache.set(file.path, file);\n    file.counter.inc(callerId);\n\n    if (file.size < 0) {\n      throw new Error(`empty sizeBytes: ${file}`);\n    }\n\n    if (created) {\n      this.totalSizeBytes += file.size;\n    }\n  }\n\n  removeCache(file: T) {\n    this.cache.delete(file.path);\n    this.totalSizeBytes -= file.size;\n  }\n}\n"],"names":[],"mappings":";;AAYA;;;AAG8C;MACjC,UAAU,CAAA;AAIQ,IAAA,aAAA;AAHrB,IAAA,KAAK,GAAqB,IAAI,GAAG,EAAE;IACnC,cAAc,GAAW,CAAC;AAElC,IAAA,WAAA,CAA6B,aAAqB,EAAA;QAArB,IAAA,CAAA,aAAa,GAAb,aAAa;IAAW;AAErD,IAAA,UAAU,CAAC,IAAc,EAAA;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS;IAC1C;IAEA,OAAO,CAAC,IAAc,EAAE,QAAgB,EAAA;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AACjC,QAAA,IAAI,IAAI,IAAI,SAAS,EAAE;AACrB,YAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC5B;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;AACqD;IACrD,UAAU,CAAC,IAAc,EAAE,QAAgB,EAAA;AACzC,QAAA,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC9C,QAAA,OAAO,IAAI,CAAC,QAAQ,EAAE;IACxB;;IAGA,QAAQ,GAAA;AACN,QAAA,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,aAAa;AAAE,YAAA,OAAO,EAAE;QAExD,MAAM,MAAM,GAAQ,EAAE;QACtB,IAAI,UAAU,GAAG,CAAC;AAElB,QAAA,UAAU,CAAC,IAAI,CAAC,KAAK;AAClB,aAAA,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAc,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;aACxD,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAI;YACrB,IAAI,IAAI,CAAC,cAAc,GAAG,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE;gBAC1D;YACF;YAEA,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;AACrC,YAAA,UAAU,IAAI,IAAI,CAAC,IAAI;AACvB,YAAA,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;AACnB,QAAA,CAAC,CAAC;AAEJ,QAAA,OAAO,MAAM;IACf;IAEA,QAAQ,CAAC,IAAO,EAAE,QAAgB,EAAA;AAChC,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;AAC/B,QAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAE1B,QAAA,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE;AACjB,YAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAA,CAAE,CAAC;QAC7C;QAEA,IAAI,OAAO,EAAE;AACX,YAAA,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI;QAClC;IACF;AAEA,IAAA,WAAW,CAAC,IAAO,EAAA;QACjB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;AAC5B,QAAA,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI;IAClC;AACD;;;;"}