@milaboratories/pl-drivers 1.16.1 → 1.16.3

package/dist/drivers/download_url/task.cjs

@@ -2,35 +2,44 @@ const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
 const require_download_errors = require("../../helpers/download_errors.cjs");
 const require_url = require("../urls/url.cjs");
 let node_fs_promises = require("node:fs/promises");
-node_fs_promises = require_runtime.__toESM(node_fs_promises);
+node_fs_promises = require_runtime.__toESM(node_fs_promises, 1);
 let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
+let node_fs = require("node:fs");
 let node_path = require("node:path");
-node_path = require_runtime.__toESM(node_path);
+node_path = require_runtime.__toESM(node_path, 1);
 let node_stream = require("node:stream");
 let _milaboratories_computable = require("@milaboratories/computable");
 let node_zlib = require("node:zlib");
-node_zlib = require_runtime.__toESM(node_zlib);
+node_zlib = require_runtime.__toESM(node_zlib, 1);
 let tar_fs = require("tar-fs");
-tar_fs = require_runtime.__toESM(tar_fs);
+tar_fs = require_runtime.__toESM(tar_fs, 1);
 //#region src/drivers/download_url/task.ts
-/** Downloads and extracts an archive to a directory. */
+/** Fetches (over HTTP or from a local file) and extracts an archive to a
+* directory. `key` is the task's identity in the driver's task map and cache. */
 var DownloadByUrlTask = class {
+	logger;
+	path;
+	source;
+	key;
+	signer;
+	saveDir;
 	counter = new _milaboratories_ts_helpers.CallersCounter();
 	change = new _milaboratories_computable.ChangeSource();
 	signalCtl = new AbortController();
 	error;
 	done = false;
 	size = 0;
-	constructor(logger, path, url, signer, saveDir) {
+	constructor(logger, path, source, key, signer, saveDir) {
 		this.logger = logger;
 		this.path = path;
-		this.url = url;
+		this.source = source;
+		this.key = key;
 		this.signer = signer;
 		this.saveDir = saveDir;
 	}
 	info() {
 		return {
-			url: this.url.toString(),
+			key: this.key,
 			path: this.path,
 			done: this.done,
 			size: this.size,
@@ -43,35 +52,42 @@ var DownloadByUrlTask = class {
 	}
 	async download(clientDownload, withGunzip) {
 		try {
-			const size = await this.downloadAndUntar(clientDownload, withGunzip, this.signalCtl.signal);
+			const size = await this.fetchAndUntar(clientDownload, withGunzip, this.signalCtl.signal);
 			this.setDone(size);
-			this.change.markChanged(`download of ${this.url} finished`);
+			this.change.markChanged(`download of ${this.key} finished`);
 		} catch (e) {
 			if (e instanceof URLAborted || require_download_errors.isDownloadNetworkError400(e) || this.signalCtl.signal.aborted) {
 				this.setError(e);
-				this.change.markChanged(`download of ${this.url} failed`);
+				this.change.markChanged(`download of ${this.key} failed`);
 				await rmRFDir(this.path);
 				return;
 			}
 			throw e;
 		}
 	}
-	async downloadAndUntar(clientDownload, withGunzip, signal) {
+	async fetchAndUntar(clientDownload, withGunzip, signal) {
 		await (0, _milaboratories_ts_helpers.ensureDirExists)(node_path.dirname(this.path));
 		if (await (0, _milaboratories_ts_helpers.fileExists)(this.path)) return await dirSize(this.path);
-		return await clientDownload.withContent(this.url.toString(), {}, { signal }, async (content, size) => {
-			let processedContent = content;
-			if (withGunzip) {
-				const gunzip = node_stream.Transform.toWeb(node_zlib.createGunzip());
-				processedContent = content.pipeThrough(gunzip, { signal });
-			}
-			await (0, _milaboratories_ts_helpers.createPathAtomically)(this.logger, this.path, async (fPath) => {
-				await node_fs_promises.mkdir(fPath);
-				const untar = node_stream.Writable.toWeb(tar_fs.extract(fPath));
-				await processedContent.pipeTo(untar, { signal });
-			});
+		if (this.source.type === "url") return await clientDownload.withContent(this.source.url.toString(), {}, { signal }, async (content, size) => {
+			await this.untarStream(content, withGunzip, signal);
 			return size;
 		});
+		const content = node_stream.Readable.toWeb((0, node_fs.createReadStream)(this.source.path));
+		await this.untarStream(content, withGunzip, signal);
+		return await dirSize(this.path);
+	}
+	/** Optionally gunzips, then untars the content stream into `this.path`. */
+	async untarStream(content, withGunzip, signal) {
+		let processedContent = content;
+		if (withGunzip) {
+			const gunzip = node_stream.Transform.toWeb(node_zlib.createGunzip());
+			processedContent = content.pipeThrough(gunzip, { signal });
+		}
+		await (0, _milaboratories_ts_helpers.createPathAtomically)(this.logger, this.path, async (fPath) => {
+			await node_fs_promises.mkdir(fPath);
+			const untar = node_stream.Writable.toWeb(tar_fs.extract(fPath));
+			await processedContent.pipeTo(untar, { signal });
+		});
 	}
 	getUrl() {
 		if (this.done) return { url: require_url.newBlockUIURL(this.signer, this.saveDir, (0, _milaboratories_ts_helpers.notEmpty)(this.path)) };

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

@@ -1 +1 @@
-{"version":3,"file":"task.cjs","names":["CallersCounter","ChangeSource","isDownloadNetworkError400","path","Transform","zlib","fsp","Writable","tar","newBlockUIURL"],"sources":["../../../src/drivers/download_url/task.ts"],"sourcesContent":["import type { Watcher } from \"@milaboratories/computable\";\nimport { ChangeSource } from \"@milaboratories/computable\";\nimport type { MiLogger, Signer } 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 { isDownloadNetworkError400 } from \"../../helpers/download_errors\";\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 (\n        e instanceof URLAborted ||\n        isDownloadNetworkError400(e) ||\n        this.signalCtl.signal.aborted\n      ) {\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)\n      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"],"mappings":"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"}
+{"version":3,"file":"task.cjs","names":["CallersCounter","ChangeSource","isDownloadNetworkError400","path","Readable","Transform","zlib","fsp","Writable","tar","newBlockUIURL"],"sources":["../../../src/drivers/download_url/task.ts"],"sourcesContent":["import type { Watcher } from \"@milaboratories/computable\";\nimport { ChangeSource } from \"@milaboratories/computable\";\nimport type { MiLogger, Signer } from \"@milaboratories/ts-helpers\";\nimport {\n  CallersCounter,\n  createPathAtomically,\n  ensureDirExists,\n  fileExists,\n  notEmpty,\n} from \"@milaboratories/ts-helpers\";\nimport { createReadStream } from \"node:fs\";\nimport * as fsp from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { Readable, Transform, Writable } from \"node:stream\";\nimport type { ReadableStream } from \"node:stream/web\";\nimport * as zlib from \"node:zlib\";\nimport * as tar from \"tar-fs\";\nimport type { RemoteFileDownloader } from \"../../helpers/download\";\nimport { isDownloadNetworkError400 } from \"../../helpers/download_errors\";\nimport type { UrlResult } from \"./driver\";\nimport { newBlockUIURL } from \"../urls/url\";\n\n/** Source an archive is fetched from before extraction: a remote URL or a\n * local `.tgz` file on disk. Both flow through the same untar machinery. */\nexport type DownloadSource =\n  | { type: \"url\"; url: URL }\n  | { type: \"local-tgz\"; path: string; mtime: string };\n\n/** Fetches (over HTTP or from a local file) and extracts an archive to a\n * directory. `key` is the task's identity in the driver's task map and cache. */\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 source: DownloadSource,\n    readonly key: string,\n    readonly signer: Signer,\n    readonly saveDir: string,\n  ) {}\n\n  public info() {\n    return {\n      key: this.key,\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.fetchAndUntar(clientDownload, withGunzip, this.signalCtl.signal);\n      this.setDone(size);\n      this.change.markChanged(`download of ${this.key} finished`);\n    } catch (e: unknown) {\n      if (\n        e instanceof URLAborted ||\n        isDownloadNetworkError400(e) ||\n        this.signalCtl.signal.aborted\n      ) {\n        this.setError(e);\n        this.change.markChanged(`download of ${this.key} 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 fetchAndUntar(\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    if (this.source.type === \"url\") {\n      return await clientDownload.withContent(\n        this.source.url.toString(),\n        {},\n        { signal },\n        async (content, size) => {\n          await this.untarStream(content, withGunzip, signal);\n          return size;\n        },\n      );\n    }\n\n    // local-tgz: read the archive from disk and untar through the same path.\n    const content = Readable.toWeb(createReadStream(this.source.path)) as ReadableStream;\n    await this.untarStream(content, withGunzip, signal);\n    return await dirSize(this.path);\n  }\n\n  /** Optionally gunzips, then untars the content stream into `this.path`. */\n  private async untarStream(\n    content: ReadableStream,\n    withGunzip: boolean,\n    signal: AbortSignal,\n  ): Promise<void> {\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\n  getUrl(): UrlResult | undefined {\n    if (this.done)\n      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"],"mappings":"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"}

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

@@ -4,11 +4,23 @@ import { CallersCounter, MiLogger, Signer } from "@milaboratories/ts-helpers";
 import { ChangeSource, Watcher } from "@milaboratories/computable";
 
 //#region src/drivers/download_url/task.d.ts
-/** Downloads and extracts an archive to a directory. */
+/** Source an archive is fetched from before extraction: a remote URL or a
+ * local `.tgz` file on disk. Both flow through the same untar machinery. */
+type DownloadSource = {
+  type: "url";
+  url: URL;
+} | {
+  type: "local-tgz";
+  path: string;
+  mtime: string;
+};
+/** Fetches (over HTTP or from a local file) and extracts an archive to a
+ * directory. `key` is the task's identity in the driver's task map and cache. */
 declare class DownloadByUrlTask {
   private readonly logger;
   readonly path: string;
-  readonly url: URL;
+  readonly source: DownloadSource;
+  readonly key: string;
   readonly signer: Signer;
   readonly saveDir: string;
   readonly counter: CallersCounter;
@@ -17,9 +29,9 @@ declare class DownloadByUrlTask {
   error: string | undefined;
   done: boolean;
   size: number;
-  constructor(logger: MiLogger, path: string, url: URL, signer: Signer, saveDir: string);
+  constructor(logger: MiLogger, path: string, source: DownloadSource, key: string, signer: Signer, saveDir: string);
   info(): {
-    url: string;
+    key: string;
     path: string;
     done: boolean;
     size: number;
@@ -27,12 +39,14 @@ declare class DownloadByUrlTask {
   };
   attach(w: Watcher, callerId: string): void;
   download(clientDownload: RemoteFileDownloader, withGunzip: boolean): Promise<void>;
-  private downloadAndUntar;
+  private fetchAndUntar;
+  /** Optionally gunzips, then untars the content stream into `this.path`. */
+  private untarStream;
   getUrl(): UrlResult | undefined;
   private setDone;
   private setError;
   abort(reason: string): void;
 }
 //#endregion
-export { DownloadByUrlTask };
+export { DownloadByUrlTask, DownloadSource };
 //# sourceMappingURL=task.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","names":[],"sources":["../../../src/drivers/download_url/task.ts"],"mappings":";;;;;;AAqBA;AAAA,cAAa,iBAAA;EAAA,iBASQ,MAAA;EAAA,SACR,IAAA;EAAA,SACA,GAAA,EAAK,GAAA;EAAA,SACL,MAAA,EAAQ,MAAA;EAAA,SACR,OAAA;EAAA,SAZF,OAAA,EAAO,cAAA;EAAA,SACP,MAAA,EAAM,YAAA;EAAA,iBACE,SAAA;EACjB,KAAA;EACA,IAAA;EACA,IAAA;cAGmB,MAAA,EAAQ,QAAA,EAChB,IAAA,UACA,GAAA,EAAK,GAAA,EACL,MAAA,EAAQ,MAAA,EACR,OAAA;EAGJ,IAAA,CAAA;;;;;;;EAUP,MAAA,CAAO,CAAA,EAAG,OAAA,EAAS,QAAA;EAKb,QAAA,CAAS,cAAA,EAAgB,oBAAA,EAAsB,UAAA,YAAmB,OAAA;EAAA,QAsB1D,gBAAA;EAmCd,MAAA,CAAA,GAAU,SAAA;EAAA,QAWF,OAAA;EAAA,QAKA,QAAA;EAIR,KAAA,CAAM,MAAA;AAAA"}
+{"version":3,"file":"task.d.ts","names":[],"sources":["../../../src/drivers/download_url/task.ts"],"mappings":";;;;;;AAwBA;;AAAA,KAAY,cAAA;EACN,IAAA;EAAa,GAAA,EAAK,GAAG;AAAA;EACrB,IAAA;EAAmB,IAAA;EAAc,KAAA;AAAA;;AAAK;cAI/B,iBAAA;EAAA,iBASQ,MAAA;EAAA,SACR,IAAA;EAAA,SACA,MAAA,EAAQ,cAAA;EAAA,SACR,GAAA;EAAA,SACA,MAAA,EAAQ,MAAA;EAAA,SACR,OAAA;EAAA,SAbF,OAAA,EAAO,cAAA;EAAA,SACP,MAAA,EAAM,YAAA;EAAA,iBACE,SAAA;EACjB,KAAA;EACA,IAAA;EACA,IAAA;cAGmB,MAAA,EAAQ,QAAA,EAChB,IAAA,UACA,MAAA,EAAQ,cAAA,EACR,GAAA,UACA,MAAA,EAAQ,MAAA,EACR,OAAA;EAGJ,IAAA;;;;;;;EAUP,MAAA,CAAO,CAAA,EAAG,OAAA,EAAS,QAAA;EAKb,QAAA,CAAS,cAAA,EAAgB,oBAAA,EAAsB,UAAA,YAAmB,OAAA;EAAA,QAsB1D,aAAA;EArDL;EAAA,QAmFK,WAAA;EAkBd,MAAA,IAAU,SAAA;EAAA,QAWF,OAAA;EAAA,QAKA,QAAA;EAIR,KAAA,CAAM,MAAA;AAAA"}

package/dist/drivers/download_url/task.js

@@ -2,30 +2,39 @@ import { isDownloadNetworkError400 } from "../../helpers/download_errors.js";
 import { newBlockUIURL } from "../urls/url.js";
 import * as fsp from "node:fs/promises";
 import { CallersCounter, createPathAtomically, ensureDirExists, fileExists, notEmpty } from "@milaboratories/ts-helpers";
+import { createReadStream } from "node:fs";
 import * as path$1 from "node:path";
-import { Transform, Writable } from "node:stream";
+import { Readable, Transform, Writable } from "node:stream";
 import { ChangeSource } from "@milaboratories/computable";
 import * as zlib from "node:zlib";
 import * as tar from "tar-fs";
 //#region src/drivers/download_url/task.ts
-/** Downloads and extracts an archive to a directory. */
+/** Fetches (over HTTP or from a local file) and extracts an archive to a
+* directory. `key` is the task's identity in the driver's task map and cache. */
 var DownloadByUrlTask = class {
+	logger;
+	path;
+	source;
+	key;
+	signer;
+	saveDir;
 	counter = new CallersCounter();
 	change = new ChangeSource();
 	signalCtl = new AbortController();
 	error;
 	done = false;
 	size = 0;
-	constructor(logger, path, url, signer, saveDir) {
+	constructor(logger, path, source, key, signer, saveDir) {
 		this.logger = logger;
 		this.path = path;
-		this.url = url;
+		this.source = source;
+		this.key = key;
 		this.signer = signer;
 		this.saveDir = saveDir;
 	}
 	info() {
 		return {
-			url: this.url.toString(),
+			key: this.key,
 			path: this.path,
 			done: this.done,
 			size: this.size,
@@ -38,35 +47,42 @@ var DownloadByUrlTask = class {
 	}
 	async download(clientDownload, withGunzip) {
 		try {
-			const size = await this.downloadAndUntar(clientDownload, withGunzip, this.signalCtl.signal);
+			const size = await this.fetchAndUntar(clientDownload, withGunzip, this.signalCtl.signal);
 			this.setDone(size);
-			this.change.markChanged(`download of ${this.url} finished`);
+			this.change.markChanged(`download of ${this.key} finished`);
 		} catch (e) {
 			if (e instanceof URLAborted || isDownloadNetworkError400(e) || this.signalCtl.signal.aborted) {
 				this.setError(e);
-				this.change.markChanged(`download of ${this.url} failed`);
+				this.change.markChanged(`download of ${this.key} failed`);
 				await rmRFDir(this.path);
 				return;
 			}
 			throw e;
 		}
 	}
-	async downloadAndUntar(clientDownload, withGunzip, signal) {
+	async fetchAndUntar(clientDownload, withGunzip, signal) {
 		await ensureDirExists(path$1.dirname(this.path));
 		if (await fileExists(this.path)) return await dirSize(this.path);
-		return 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);
-				const untar = Writable.toWeb(tar.extract(fPath));
-				await processedContent.pipeTo(untar, { signal });
-			});
+		if (this.source.type === "url") return await clientDownload.withContent(this.source.url.toString(), {}, { signal }, async (content, size) => {
+			await this.untarStream(content, withGunzip, signal);
 			return size;
 		});
+		const content = Readable.toWeb(createReadStream(this.source.path));
+		await this.untarStream(content, withGunzip, signal);
+		return await dirSize(this.path);
+	}
+	/** Optionally gunzips, then untars the content stream into `this.path`. */
+	async untarStream(content, withGunzip, signal) {
+		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);
+			const untar = Writable.toWeb(tar.extract(fPath));
+			await processedContent.pipeTo(untar, { signal });
+		});
 	}
 	getUrl() {
 		if (this.done) return { url: newBlockUIURL(this.signer, this.saveDir, notEmpty(this.path)) };

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

@@ -1 +1 @@
-{"version":3,"file":"task.js","names":["path"],"sources":["../../../src/drivers/download_url/task.ts"],"sourcesContent":["import type { Watcher } from \"@milaboratories/computable\";\nimport { ChangeSource } from \"@milaboratories/computable\";\nimport type { MiLogger, Signer } 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 { isDownloadNetworkError400 } from \"../../helpers/download_errors\";\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 (\n        e instanceof URLAborted ||\n        isDownloadNetworkError400(e) ||\n        this.signalCtl.signal.aborted\n      ) {\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)\n      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"],"mappings":"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"}
+{"version":3,"file":"task.js","names":["path"],"sources":["../../../src/drivers/download_url/task.ts"],"sourcesContent":["import type { Watcher } from \"@milaboratories/computable\";\nimport { ChangeSource } from \"@milaboratories/computable\";\nimport type { MiLogger, Signer } from \"@milaboratories/ts-helpers\";\nimport {\n  CallersCounter,\n  createPathAtomically,\n  ensureDirExists,\n  fileExists,\n  notEmpty,\n} from \"@milaboratories/ts-helpers\";\nimport { createReadStream } from \"node:fs\";\nimport * as fsp from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { Readable, Transform, Writable } from \"node:stream\";\nimport type { ReadableStream } from \"node:stream/web\";\nimport * as zlib from \"node:zlib\";\nimport * as tar from \"tar-fs\";\nimport type { RemoteFileDownloader } from \"../../helpers/download\";\nimport { isDownloadNetworkError400 } from \"../../helpers/download_errors\";\nimport type { UrlResult } from \"./driver\";\nimport { newBlockUIURL } from \"../urls/url\";\n\n/** Source an archive is fetched from before extraction: a remote URL or a\n * local `.tgz` file on disk. Both flow through the same untar machinery. */\nexport type DownloadSource =\n  | { type: \"url\"; url: URL }\n  | { type: \"local-tgz\"; path: string; mtime: string };\n\n/** Fetches (over HTTP or from a local file) and extracts an archive to a\n * directory. `key` is the task's identity in the driver's task map and cache. */\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 source: DownloadSource,\n    readonly key: string,\n    readonly signer: Signer,\n    readonly saveDir: string,\n  ) {}\n\n  public info() {\n    return {\n      key: this.key,\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.fetchAndUntar(clientDownload, withGunzip, this.signalCtl.signal);\n      this.setDone(size);\n      this.change.markChanged(`download of ${this.key} finished`);\n    } catch (e: unknown) {\n      if (\n        e instanceof URLAborted ||\n        isDownloadNetworkError400(e) ||\n        this.signalCtl.signal.aborted\n      ) {\n        this.setError(e);\n        this.change.markChanged(`download of ${this.key} 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 fetchAndUntar(\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    if (this.source.type === \"url\") {\n      return await clientDownload.withContent(\n        this.source.url.toString(),\n        {},\n        { signal },\n        async (content, size) => {\n          await this.untarStream(content, withGunzip, signal);\n          return size;\n        },\n      );\n    }\n\n    // local-tgz: read the archive from disk and untar through the same path.\n    const content = Readable.toWeb(createReadStream(this.source.path)) as ReadableStream;\n    await this.untarStream(content, withGunzip, signal);\n    return await dirSize(this.path);\n  }\n\n  /** Optionally gunzips, then untars the content stream into `this.path`. */\n  private async untarStream(\n    content: ReadableStream,\n    withGunzip: boolean,\n    signal: AbortSignal,\n  ): Promise<void> {\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\n  getUrl(): UrlResult | undefined {\n    if (this.done)\n      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"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"download_local_handle.cjs","names":[],"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"],"mappings":";AAOA,MAAM,mBAAmB;AAEzB,SAAgB,eAAe,MAAc,QAAiC;AAC5E,QAAO,yBAAyB,KAAK,GAAG,OAAO,KAAK,KAAK;;AAG3D,SAAgB,kBAAkB,QAA2C;AAC3E,QAAO,QAAQ,OAAO,MAAM,iBAAiB,CAAC;;AAGhD,SAAgB,iBAAiB,QAAyB,QAAgB;CACxE,MAAM,SAAS,OAAO,MAAM,iBAAiB;AAE7C,KAAI,WAAW,KACb,OAAM,IAAI,MAAM,8BAA8B,OAAO,aAAa,SAAS;CAG7E,MAAM,EAAE,MAAM,cAAc,OAAO;AACnC,QAAO,OAAO,MAAM,WAAW,sCAAsC,SAAS;AAE9E,QAAO;EAAE;EAAM;EAAW"}
+{"version":3,"file":"download_local_handle.cjs","names":[],"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"],"mappings":";AAOA,MAAM,mBAAmB;AAEzB,SAAgB,eAAe,MAAc,QAAiC;CAC5E,OAAO,yBAAyB,KAAK,GAAG,OAAO,KAAK,IAAI;AAC1D;AAEA,SAAgB,kBAAkB,QAA2C;CAC3E,OAAO,QAAQ,OAAO,MAAM,gBAAgB,CAAC;AAC/C;AAEA,SAAgB,iBAAiB,QAAyB,QAAgB;CACxE,MAAM,SAAS,OAAO,MAAM,gBAAgB;CAE5C,IAAI,WAAW,MACb,MAAM,IAAI,MAAM,8BAA8B,OAAO,aAAa,QAAQ;CAG5E,MAAM,EAAE,MAAM,cAAc,OAAO;CACnC,OAAO,OAAO,MAAM,WAAW,sCAAsC,QAAQ;CAE7E,OAAO;EAAE;EAAM;CAAU;AAC3B"}

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

@@ -1 +1 @@
-{"version":3,"file":"download_local_handle.js","names":[],"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"],"mappings":";AAOA,MAAM,mBAAmB;AAEzB,SAAgB,eAAe,MAAc,QAAiC;AAC5E,QAAO,yBAAyB,KAAK,GAAG,OAAO,KAAK,KAAK;;AAG3D,SAAgB,kBAAkB,QAA2C;AAC3E,QAAO,QAAQ,OAAO,MAAM,iBAAiB,CAAC;;AAGhD,SAAgB,iBAAiB,QAAyB,QAAgB;CACxE,MAAM,SAAS,OAAO,MAAM,iBAAiB;AAE7C,KAAI,WAAW,KACb,OAAM,IAAI,MAAM,8BAA8B,OAAO,aAAa,SAAS;CAG7E,MAAM,EAAE,MAAM,cAAc,OAAO;AACnC,QAAO,OAAO,MAAM,WAAW,sCAAsC,SAAS;AAE9E,QAAO;EAAE;EAAM;EAAW"}
+{"version":3,"file":"download_local_handle.js","names":[],"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"],"mappings":";AAOA,MAAM,mBAAmB;AAEzB,SAAgB,eAAe,MAAc,QAAiC;CAC5E,OAAO,yBAAyB,KAAK,GAAG,OAAO,KAAK,IAAI;AAC1D;AAEA,SAAgB,kBAAkB,QAA2C;CAC3E,OAAO,QAAQ,OAAO,MAAM,gBAAgB,CAAC;AAC/C;AAEA,SAAgB,iBAAiB,QAAyB,QAAgB;CACxE,MAAM,SAAS,OAAO,MAAM,gBAAgB;CAE5C,IAAI,WAAW,MACb,MAAM,IAAI,MAAM,8BAA8B,OAAO,aAAa,QAAQ;CAG5E,MAAM,EAAE,MAAM,cAAc,OAAO;CACnC,OAAO,OAAO,MAAM,WAAW,sCAAsC,QAAQ;CAE7E,OAAO;EAAE;EAAM;CAAU;AAC3B"}

package/dist/drivers/helpers/download_remote_handle.cjs

@@ -1,4 +1,3 @@
-require("../../_virtual/_rolldown/runtime.cjs");
 const require_types = require("../types.cjs");
 let _milaboratories_pl_client = require("@milaboratories/pl-client");
 //#region src/drivers/helpers/download_remote_handle.ts

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

@@ -1 +1 @@
-{"version":3,"file":"download_remote_handle.cjs","names":["getSize"],"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 {\n  createSignedResourceId,\n  parseSignedResourceId,\n  signatureToBase64Url,\n  base64UrlToSignature,\n} from \"@milaboratories/pl-client\";\nimport { ResourceInfo } from \"@milaboratories/pl-tree\";\nimport { getSize } from \"../types\";\n\n// https://regex101.com/r/Q4YdTa/5\n// resourceSig segment is base64url-encoded signature (may be empty)\nconst remoteHandleRegex =\n  /^blob\\+remote:\\/\\/download\\/(?<content>(?<resourceType>.+)\\/(?<resourceVersion>.+?)\\/(?<resourceId>\\d+?)\\/(?<resourceSig>[A-Za-z0-9_-]*)\\/(?<size>\\d+?))#(?<signature>.*)$/;\n\nexport function newRemoteHandle(\n  rInfo: OnDemandBlobResourceSnapshot,\n  signer: Signer,\n): RemoteBlobHandle {\n  const { globalId, signature: resourceSig } = parseSignedResourceId(rInfo.id);\n  const sigSegment = signatureToBase64Url(resourceSig);\n  let content = `${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}/${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(\n  handle: RemoteBlobHandle,\n  signer: Signer,\n): {\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, resourceSig, size, signature } =\n    parsed.groups!;\n\n  signer.verify(content, signature, `Signature verification failed for ${handle}`);\n\n  const sig = resourceSig ? base64UrlToSignature(resourceSig) : undefined;\n\n  return {\n    info: {\n      id: createSignedResourceId(BigInt(resourceId), sig),\n      type: { name: resourceType, version: resourceVersion },\n    },\n    size: Number(size),\n  };\n}\n"],"mappings":";;;;AAiBA,MAAM,oBACJ;AAEF,SAAgB,gBACd,OACA,QACkB;CAClB,MAAM,EAAE,UAAU,WAAW,iBAAA,GAAA,0BAAA,uBAAsC,MAAM,GAAG;CAC5E,MAAM,cAAA,GAAA,0BAAA,sBAAkC,YAAY;CACpD,IAAI,UAAU,GAAG,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAGA,cAAAA,QAAQ,MAAM;AAElG,QAAO,0BAA0B,QAAQ,GAAG,OAAO,KAAK,QAAQ;;AAGlE,SAAgB,mBAAmB,QAA4C;AAC7E,QAAO,QAAQ,OAAO,MAAM,kBAAkB,CAAC;;AAGjD,SAAgB,kBACd,QACA,QAIA;CACA,MAAM,SAAS,OAAO,MAAM,kBAAkB;AAC9C,KAAI,WAAW,KACb,OAAM,IAAI,MAAM,+BAA+B,OAAO,aAAa,SAAS;CAG9E,MAAM,EAAE,SAAS,cAAc,iBAAiB,YAAY,aAAa,MAAM,cAC7E,OAAO;AAET,QAAO,OAAO,SAAS,WAAW,qCAAqC,SAAS;CAEhF,MAAM,MAAM,eAAA,GAAA,0BAAA,sBAAmC,YAAY,GAAG,KAAA;AAE9D,QAAO;EACL,MAAM;GACJ,KAAA,GAAA,0BAAA,wBAA2B,OAAO,WAAW,EAAE,IAAI;GACnD,MAAM;IAAE,MAAM;IAAc,SAAS;IAAiB;GACvD;EACD,MAAM,OAAO,KAAK;EACnB"}
+{"version":3,"file":"download_remote_handle.cjs","names":["getSize"],"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 {\n  createSignedResourceId,\n  parseSignedResourceId,\n  signatureToBase64Url,\n  base64UrlToSignature,\n} from \"@milaboratories/pl-client\";\nimport { ResourceInfo } from \"@milaboratories/pl-tree\";\nimport { getSize } from \"../types\";\n\n// https://regex101.com/r/Q4YdTa/5\n// resourceSig segment is base64url-encoded signature (may be empty)\nconst remoteHandleRegex =\n  /^blob\\+remote:\\/\\/download\\/(?<content>(?<resourceType>.+)\\/(?<resourceVersion>.+?)\\/(?<resourceId>\\d+?)\\/(?<resourceSig>[A-Za-z0-9_-]*)\\/(?<size>\\d+?))#(?<signature>.*)$/;\n\nexport function newRemoteHandle(\n  rInfo: OnDemandBlobResourceSnapshot,\n  signer: Signer,\n): RemoteBlobHandle {\n  const { globalId, signature: resourceSig } = parseSignedResourceId(rInfo.id);\n  const sigSegment = signatureToBase64Url(resourceSig);\n  let content = `${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}/${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(\n  handle: RemoteBlobHandle,\n  signer: Signer,\n): {\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, resourceSig, size, signature } =\n    parsed.groups!;\n\n  signer.verify(content, signature, `Signature verification failed for ${handle}`);\n\n  const sig = resourceSig ? base64UrlToSignature(resourceSig) : undefined;\n\n  return {\n    info: {\n      id: createSignedResourceId(BigInt(resourceId), sig),\n      type: { name: resourceType, version: resourceVersion },\n    },\n    size: Number(size),\n  };\n}\n"],"mappings":";;;AAiBA,MAAM,oBACJ;AAEF,SAAgB,gBACd,OACA,QACkB;CAClB,MAAM,EAAE,UAAU,WAAW,iBAAA,GAAA,0BAAA,sBAAA,CAAsC,MAAM,EAAE;CAC3E,MAAM,cAAA,GAAA,0BAAA,qBAAA,CAAkC,WAAW;CACnD,IAAI,UAAU,GAAG,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAGA,cAAAA,QAAQ,KAAK;CAEjG,OAAO,0BAA0B,QAAQ,GAAG,OAAO,KAAK,OAAO;AACjE;AAEA,SAAgB,mBAAmB,QAA4C;CAC7E,OAAO,QAAQ,OAAO,MAAM,iBAAiB,CAAC;AAChD;AAEA,SAAgB,kBACd,QACA,QAIA;CACA,MAAM,SAAS,OAAO,MAAM,iBAAiB;CAC7C,IAAI,WAAW,MACb,MAAM,IAAI,MAAM,+BAA+B,OAAO,aAAa,QAAQ;CAG7E,MAAM,EAAE,SAAS,cAAc,iBAAiB,YAAY,aAAa,MAAM,cAC7E,OAAO;CAET,OAAO,OAAO,SAAS,WAAW,qCAAqC,QAAQ;CAE/E,MAAM,MAAM,eAAA,GAAA,0BAAA,qBAAA,CAAmC,WAAW,IAAI,KAAA;CAE9D,OAAO;EACL,MAAM;GACJ,KAAA,GAAA,0BAAA,uBAAA,CAA2B,OAAO,UAAU,GAAG,GAAG;GAClD,MAAM;IAAE,MAAM;IAAc,SAAS;GAAgB;EACvD;EACA,MAAM,OAAO,IAAI;CACnB;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"download_remote_handle.js","names":[],"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 {\n  createSignedResourceId,\n  parseSignedResourceId,\n  signatureToBase64Url,\n  base64UrlToSignature,\n} from \"@milaboratories/pl-client\";\nimport { ResourceInfo } from \"@milaboratories/pl-tree\";\nimport { getSize } from \"../types\";\n\n// https://regex101.com/r/Q4YdTa/5\n// resourceSig segment is base64url-encoded signature (may be empty)\nconst remoteHandleRegex =\n  /^blob\\+remote:\\/\\/download\\/(?<content>(?<resourceType>.+)\\/(?<resourceVersion>.+?)\\/(?<resourceId>\\d+?)\\/(?<resourceSig>[A-Za-z0-9_-]*)\\/(?<size>\\d+?))#(?<signature>.*)$/;\n\nexport function newRemoteHandle(\n  rInfo: OnDemandBlobResourceSnapshot,\n  signer: Signer,\n): RemoteBlobHandle {\n  const { globalId, signature: resourceSig } = parseSignedResourceId(rInfo.id);\n  const sigSegment = signatureToBase64Url(resourceSig);\n  let content = `${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}/${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(\n  handle: RemoteBlobHandle,\n  signer: Signer,\n): {\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, resourceSig, size, signature } =\n    parsed.groups!;\n\n  signer.verify(content, signature, `Signature verification failed for ${handle}`);\n\n  const sig = resourceSig ? base64UrlToSignature(resourceSig) : undefined;\n\n  return {\n    info: {\n      id: createSignedResourceId(BigInt(resourceId), sig),\n      type: { name: resourceType, version: resourceVersion },\n    },\n    size: Number(size),\n  };\n}\n"],"mappings":";;;AAiBA,MAAM,oBACJ;AAEF,SAAgB,gBACd,OACA,QACkB;CAClB,MAAM,EAAE,UAAU,WAAW,gBAAgB,sBAAsB,MAAM,GAAG;CAC5E,MAAM,aAAa,qBAAqB,YAAY;CACpD,IAAI,UAAU,GAAG,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,MAAM;AAElG,QAAO,0BAA0B,QAAQ,GAAG,OAAO,KAAK,QAAQ;;AAGlE,SAAgB,mBAAmB,QAA4C;AAC7E,QAAO,QAAQ,OAAO,MAAM,kBAAkB,CAAC;;AAGjD,SAAgB,kBACd,QACA,QAIA;CACA,MAAM,SAAS,OAAO,MAAM,kBAAkB;AAC9C,KAAI,WAAW,KACb,OAAM,IAAI,MAAM,+BAA+B,OAAO,aAAa,SAAS;CAG9E,MAAM,EAAE,SAAS,cAAc,iBAAiB,YAAY,aAAa,MAAM,cAC7E,OAAO;AAET,QAAO,OAAO,SAAS,WAAW,qCAAqC,SAAS;CAEhF,MAAM,MAAM,cAAc,qBAAqB,YAAY,GAAG,KAAA;AAE9D,QAAO;EACL,MAAM;GACJ,IAAI,uBAAuB,OAAO,WAAW,EAAE,IAAI;GACnD,MAAM;IAAE,MAAM;IAAc,SAAS;IAAiB;GACvD;EACD,MAAM,OAAO,KAAK;EACnB"}
+{"version":3,"file":"download_remote_handle.js","names":[],"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 {\n  createSignedResourceId,\n  parseSignedResourceId,\n  signatureToBase64Url,\n  base64UrlToSignature,\n} from \"@milaboratories/pl-client\";\nimport { ResourceInfo } from \"@milaboratories/pl-tree\";\nimport { getSize } from \"../types\";\n\n// https://regex101.com/r/Q4YdTa/5\n// resourceSig segment is base64url-encoded signature (may be empty)\nconst remoteHandleRegex =\n  /^blob\\+remote:\\/\\/download\\/(?<content>(?<resourceType>.+)\\/(?<resourceVersion>.+?)\\/(?<resourceId>\\d+?)\\/(?<resourceSig>[A-Za-z0-9_-]*)\\/(?<size>\\d+?))#(?<signature>.*)$/;\n\nexport function newRemoteHandle(\n  rInfo: OnDemandBlobResourceSnapshot,\n  signer: Signer,\n): RemoteBlobHandle {\n  const { globalId, signature: resourceSig } = parseSignedResourceId(rInfo.id);\n  const sigSegment = signatureToBase64Url(resourceSig);\n  let content = `${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}/${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(\n  handle: RemoteBlobHandle,\n  signer: Signer,\n): {\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, resourceSig, size, signature } =\n    parsed.groups!;\n\n  signer.verify(content, signature, `Signature verification failed for ${handle}`);\n\n  const sig = resourceSig ? base64UrlToSignature(resourceSig) : undefined;\n\n  return {\n    info: {\n      id: createSignedResourceId(BigInt(resourceId), sig),\n      type: { name: resourceType, version: resourceVersion },\n    },\n    size: Number(size),\n  };\n}\n"],"mappings":";;;AAiBA,MAAM,oBACJ;AAEF,SAAgB,gBACd,OACA,QACkB;CAClB,MAAM,EAAE,UAAU,WAAW,gBAAgB,sBAAsB,MAAM,EAAE;CAC3E,MAAM,aAAa,qBAAqB,WAAW;CACnD,IAAI,UAAU,GAAG,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,KAAK;CAEjG,OAAO,0BAA0B,QAAQ,GAAG,OAAO,KAAK,OAAO;AACjE;AAEA,SAAgB,mBAAmB,QAA4C;CAC7E,OAAO,QAAQ,OAAO,MAAM,iBAAiB,CAAC;AAChD;AAEA,SAAgB,kBACd,QACA,QAIA;CACA,MAAM,SAAS,OAAO,MAAM,iBAAiB;CAC7C,IAAI,WAAW,MACb,MAAM,IAAI,MAAM,+BAA+B,OAAO,aAAa,QAAQ;CAG7E,MAAM,EAAE,SAAS,cAAc,iBAAiB,YAAY,aAAa,MAAM,cAC7E,OAAO;CAET,OAAO,OAAO,SAAS,WAAW,qCAAqC,QAAQ;CAE/E,MAAM,MAAM,cAAc,qBAAqB,WAAW,IAAI,KAAA;CAE9D,OAAO;EACL,MAAM;GACJ,IAAI,uBAAuB,OAAO,UAAU,GAAG,GAAG;GAClD,MAAM;IAAE,MAAM;IAAc,SAAS;GAAgB;EACvD;EACA,MAAM,OAAO,IAAI;CACnB;AACF"}

package/dist/drivers/helpers/files_cache.cjs

@@ -1,4 +1,3 @@
-require("../../_virtual/_rolldown/runtime.cjs");
 let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
 //#region src/drivers/helpers/files_cache.ts
 /** Holds counters of how many callers need the file.
@@ -6,6 +5,7 @@ let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
 * remove not needed blobs one by one.
 * If all the files are needed, do nothing. */
 var FilesCache = class {
+	softSizeBytes;
 	cache = /* @__PURE__ */ new Map();
 	totalSizeBytes = 0;
 	constructor(softSizeBytes) {

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

@@ -1 +1 @@
-{"version":3,"file":"files_cache.cjs","names":[],"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"],"mappings":";;;;;;;AAgBA,IAAa,aAAb,MAA8C;CAC5C,wBAAkC,IAAI,KAAK;CAC3C,iBAAiC;CAEjC,YAAY,eAAwC;AAAvB,OAAA,gBAAA;;CAE7B,WAAW,MAAyB;AAClC,SAAO,KAAK,MAAM,IAAI,KAAK,IAAI,KAAA;;CAGjC,QAAQ,MAAgB,UAAiC;EACvD,MAAM,OAAO,KAAK,MAAM,IAAI,KAAK;AACjC,MAAI,QAAQ,KAAA,EACV,MAAK,QAAQ,IAAI,SAAS;AAG5B,SAAO;;;;CAKT,WAAW,MAAgB,UAAuB;AAChD,GAAA,GAAA,2BAAA,QAAO,KAAK,OAAO,KAAK,CAAC,QAAQ,IAAI,SAAS;AAC9C,SAAO,KAAK,UAAU;;;CAIxB,WAAgB;AACd,MAAI,KAAK,kBAAkB,KAAK,cAAe,QAAO,EAAE;EAExD,MAAM,SAAc,EAAE;EACtB,IAAI,aAAa;AAEjB,GAAA,GAAA,2BAAA,YAAW,KAAK,MAAM,CACnB,QAAQ,CAAC,GAAG,UAAuB,KAAK,QAAQ,QAAQ,CAAC,CACzD,SAAS,CAAC,MAAM,OAAO;AACtB,OAAI,KAAK,iBAAiB,cAAc,KAAK,cAC3C;GAGF,MAAM,QAAA,GAAA,2BAAA,QAAc,KAAK,OAAO,KAAK;AACrC,iBAAc,KAAK;AACnB,UAAO,KAAK,KAAK;IACjB;AAEJ,SAAO;;CAGT,SAAS,MAAS,UAAkB;EAClC,MAAM,UAAU,KAAK,MAAM,IAAI,KAAK,KAAK,IAAI,KAAA;AAC7C,OAAK,MAAM,IAAI,KAAK,MAAM,KAAK;AAC/B,OAAK,QAAQ,IAAI,SAAS;AAE1B,MAAI,KAAK,OAAO,EACd,OAAM,IAAI,MAAM,oBAAoB,OAAO;AAG7C,MAAI,QACF,MAAK,kBAAkB,KAAK;;CAIhC,YAAY,MAAS;AACnB,OAAK,MAAM,OAAO,KAAK,KAAK;AAC5B,OAAK,kBAAkB,KAAK"}
+{"version":3,"file":"files_cache.cjs","names":[],"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"],"mappings":";;;;;;AAgBA,IAAa,aAAb,MAA8C;CAIf;CAH7B,wBAAkC,IAAI,IAAI;CAC1C,iBAAiC;CAEjC,YAAY,eAAwC;EAAvB,KAAA,gBAAA;CAAwB;CAErD,WAAW,MAAyB;EAClC,OAAO,KAAK,MAAM,IAAI,IAAI,KAAK,KAAA;CACjC;CAEA,QAAQ,MAAgB,UAAiC;EACvD,MAAM,OAAO,KAAK,MAAM,IAAI,IAAI;EAChC,IAAI,QAAQ,KAAA,GACV,KAAK,QAAQ,IAAI,QAAQ;EAG3B,OAAO;CACT;;;CAIA,WAAW,MAAgB,UAAuB;EAChD,CAAA,GAAA,2BAAA,OAAA,CAAO,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ;EAC7C,OAAO,KAAK,SAAS;CACvB;;CAGA,WAAgB;EACd,IAAI,KAAK,kBAAkB,KAAK,eAAe,OAAO,CAAC;EAEvD,MAAM,SAAc,CAAC;EACrB,IAAI,aAAa;EAEjB,CAAA,GAAA,2BAAA,WAAA,CAAW,KAAK,KAAK,CAAC,CACnB,QAAQ,CAAC,GAAG,UAAuB,KAAK,QAAQ,OAAO,CAAC,CAAC,CACzD,SAAS,CAAC,MAAM,OAAO;GACtB,IAAI,KAAK,iBAAiB,cAAc,KAAK,eAC3C;GAGF,MAAM,QAAA,GAAA,2BAAA,OAAA,CAAc,KAAK,OAAO,IAAI;GACpC,cAAc,KAAK;GACnB,OAAO,KAAK,IAAI;EAClB,CAAC;EAEH,OAAO;CACT;CAEA,SAAS,MAAS,UAAkB;EAClC,MAAM,UAAU,KAAK,MAAM,IAAI,KAAK,IAAI,KAAK,KAAA;EAC7C,KAAK,MAAM,IAAI,KAAK,MAAM,IAAI;EAC9B,KAAK,QAAQ,IAAI,QAAQ;EAEzB,IAAI,KAAK,OAAO,GACd,MAAM,IAAI,MAAM,oBAAoB,MAAM;EAG5C,IAAI,SACF,KAAK,kBAAkB,KAAK;CAEhC;CAEA,YAAY,MAAS;EACnB,KAAK,MAAM,OAAO,KAAK,IAAI;EAC3B,KAAK,kBAAkB,KAAK;CAC9B;AACF"}

package/dist/drivers/helpers/files_cache.js

@@ -5,6 +5,7 @@ import { mapEntries, mapGet } from "@milaboratories/ts-helpers";
 * remove not needed blobs one by one.
 * If all the files are needed, do nothing. */
 var FilesCache = class {
+	softSizeBytes;
 	cache = /* @__PURE__ */ new Map();
 	totalSizeBytes = 0;
 	constructor(softSizeBytes) {

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

@@ -1 +1 @@
-{"version":3,"file":"files_cache.js","names":[],"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"],"mappings":";;;;;;AAgBA,IAAa,aAAb,MAA8C;CAC5C,wBAAkC,IAAI,KAAK;CAC3C,iBAAiC;CAEjC,YAAY,eAAwC;AAAvB,OAAA,gBAAA;;CAE7B,WAAW,MAAyB;AAClC,SAAO,KAAK,MAAM,IAAI,KAAK,IAAI,KAAA;;CAGjC,QAAQ,MAAgB,UAAiC;EACvD,MAAM,OAAO,KAAK,MAAM,IAAI,KAAK;AACjC,MAAI,QAAQ,KAAA,EACV,MAAK,QAAQ,IAAI,SAAS;AAG5B,SAAO;;;;CAKT,WAAW,MAAgB,UAAuB;AAChD,SAAO,KAAK,OAAO,KAAK,CAAC,QAAQ,IAAI,SAAS;AAC9C,SAAO,KAAK,UAAU;;;CAIxB,WAAgB;AACd,MAAI,KAAK,kBAAkB,KAAK,cAAe,QAAO,EAAE;EAExD,MAAM,SAAc,EAAE;EACtB,IAAI,aAAa;AAEjB,aAAW,KAAK,MAAM,CACnB,QAAQ,CAAC,GAAG,UAAuB,KAAK,QAAQ,QAAQ,CAAC,CACzD,SAAS,CAAC,MAAM,OAAO;AACtB,OAAI,KAAK,iBAAiB,cAAc,KAAK,cAC3C;GAGF,MAAM,OAAO,OAAO,KAAK,OAAO,KAAK;AACrC,iBAAc,KAAK;AACnB,UAAO,KAAK,KAAK;IACjB;AAEJ,SAAO;;CAGT,SAAS,MAAS,UAAkB;EAClC,MAAM,UAAU,KAAK,MAAM,IAAI,KAAK,KAAK,IAAI,KAAA;AAC7C,OAAK,MAAM,IAAI,KAAK,MAAM,KAAK;AAC/B,OAAK,QAAQ,IAAI,SAAS;AAE1B,MAAI,KAAK,OAAO,EACd,OAAM,IAAI,MAAM,oBAAoB,OAAO;AAG7C,MAAI,QACF,MAAK,kBAAkB,KAAK;;CAIhC,YAAY,MAAS;AACnB,OAAK,MAAM,OAAO,KAAK,KAAK;AAC5B,OAAK,kBAAkB,KAAK"}
+{"version":3,"file":"files_cache.js","names":[],"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"],"mappings":";;;;;;AAgBA,IAAa,aAAb,MAA8C;CAIf;CAH7B,wBAAkC,IAAI,IAAI;CAC1C,iBAAiC;CAEjC,YAAY,eAAwC;EAAvB,KAAA,gBAAA;CAAwB;CAErD,WAAW,MAAyB;EAClC,OAAO,KAAK,MAAM,IAAI,IAAI,KAAK,KAAA;CACjC;CAEA,QAAQ,MAAgB,UAAiC;EACvD,MAAM,OAAO,KAAK,MAAM,IAAI,IAAI;EAChC,IAAI,QAAQ,KAAA,GACV,KAAK,QAAQ,IAAI,QAAQ;EAG3B,OAAO;CACT;;;CAIA,WAAW,MAAgB,UAAuB;EAChD,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ;EAC7C,OAAO,KAAK,SAAS;CACvB;;CAGA,WAAgB;EACd,IAAI,KAAK,kBAAkB,KAAK,eAAe,OAAO,CAAC;EAEvD,MAAM,SAAc,CAAC;EACrB,IAAI,aAAa;EAEjB,WAAW,KAAK,KAAK,CAAC,CACnB,QAAQ,CAAC,GAAG,UAAuB,KAAK,QAAQ,OAAO,CAAC,CAAC,CACzD,SAAS,CAAC,MAAM,OAAO;GACtB,IAAI,KAAK,iBAAiB,cAAc,KAAK,eAC3C;GAGF,MAAM,OAAO,OAAO,KAAK,OAAO,IAAI;GACpC,cAAc,KAAK;GACnB,OAAO,KAAK,IAAI;EAClB,CAAC;EAEH,OAAO;CACT;CAEA,SAAS,MAAS,UAAkB;EAClC,MAAM,UAAU,KAAK,MAAM,IAAI,KAAK,IAAI,KAAK,KAAA;EAC7C,KAAK,MAAM,IAAI,KAAK,MAAM,IAAI;EAC9B,KAAK,QAAQ,IAAI,QAAQ;EAEzB,IAAI,KAAK,OAAO,GACd,MAAM,IAAI,MAAM,oBAAoB,MAAM;EAG5C,IAAI,SACF,KAAK,kBAAkB,KAAK;CAEhC;CAEA,YAAY,MAAS;EACnB,KAAK,MAAM,OAAO,KAAK,IAAI;EAC3B,KAAK,kBAAkB,KAAK;CAC9B;AACF"}

package/dist/drivers/helpers/helpers.cjs

@@ -6,6 +6,7 @@ var WrongResourceTypeError = class extends Error {
 /** Updater incorporates a pattern when someone wants to run a callback
 * that updates something only when it's not already running. */
 var Updater = class {
+	onUpdate;
 	updating;
 	constructor(onUpdate) {
 		this.onUpdate = onUpdate;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.cjs","names":[],"sources":["../../../src/drivers/helpers/helpers.ts"],"sourcesContent":["/** Throws when a driver gets a resource with a wrong resource type. */\nexport class WrongResourceTypeError extends Error {\n  name = \"WrongResourceTypeError\";\n}\n\n/** Updater incorporates a pattern when someone wants to run a callback\n * that updates something only when it's not already running. */\nexport class Updater {\n  private updating: Promise<void> | undefined;\n\n  constructor(private readonly onUpdate: () => Promise<void>) {}\n\n  schedule() {\n    if (this.updating == undefined) {\n      this.updating = (async () => {\n        try {\n          await this.onUpdate();\n        } catch (e) {\n          console.log(`error while updating in Updater: ${e}`);\n        } finally {\n          this.updating = undefined;\n        }\n      })();\n    }\n  }\n}\n"],"mappings":";;AACA,IAAa,yBAAb,cAA4C,MAAM;CAChD,OAAO;;;;AAKT,IAAa,UAAb,MAAqB;CACnB;CAEA,YAAY,UAAgD;AAA/B,OAAA,WAAA;;CAE7B,WAAW;AACT,MAAI,KAAK,YAAY,KAAA,EACnB,MAAK,YAAY,YAAY;AAC3B,OAAI;AACF,UAAM,KAAK,UAAU;YACd,GAAG;AACV,YAAQ,IAAI,oCAAoC,IAAI;aAC5C;AACR,SAAK,WAAW,KAAA;;MAEhB"}
+{"version":3,"file":"helpers.cjs","names":[],"sources":["../../../src/drivers/helpers/helpers.ts"],"sourcesContent":["/** Throws when a driver gets a resource with a wrong resource type. */\nexport class WrongResourceTypeError extends Error {\n  name = \"WrongResourceTypeError\";\n}\n\n/** Updater incorporates a pattern when someone wants to run a callback\n * that updates something only when it's not already running. */\nexport class Updater {\n  private updating: Promise<void> | undefined;\n\n  constructor(private readonly onUpdate: () => Promise<void>) {}\n\n  schedule() {\n    if (this.updating == undefined) {\n      this.updating = (async () => {\n        try {\n          await this.onUpdate();\n        } catch (e) {\n          console.log(`error while updating in Updater: ${e}`);\n        } finally {\n          this.updating = undefined;\n        }\n      })();\n    }\n  }\n}\n"],"mappings":";;AACA,IAAa,yBAAb,cAA4C,MAAM;CAChD,OAAO;AACT;;;AAIA,IAAa,UAAb,MAAqB;CAGU;CAF7B;CAEA,YAAY,UAAgD;EAA/B,KAAA,WAAA;CAAgC;CAE7D,WAAW;EACT,IAAI,KAAK,YAAY,KAAA,GACnB,KAAK,YAAY,YAAY;GAC3B,IAAI;IACF,MAAM,KAAK,SAAS;GACtB,SAAS,GAAG;IACV,QAAQ,IAAI,oCAAoC,GAAG;GACrD,UAAU;IACR,KAAK,WAAW,KAAA;GAClB;EACF,EAAA,CAAG;CAEP;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","names":[],"sources":["../../../src/drivers/helpers/helpers.ts"],"mappings":";;cACa,sBAAA,SAA+B,KAAA;EAC1C,IAAA;AAAA;;;cAKW,OAAA;EAAA,iBAGkB,QAAA;EAAA,QAFrB,QAAA;cAEqB,QAAA,QAAgB,OAAA;EAE7C,QAAA,CAAA;AAAA"}
+{"version":3,"file":"helpers.d.ts","names":[],"sources":["../../../src/drivers/helpers/helpers.ts"],"mappings":";;cACa,sBAAA,SAA+B,KAAK;EAC/C,IAAI;AAAA;;AAAA;cAKO,OAAA;EAAA,iBAGkB,QAAA;EAAA,QAFrB,QAAA;cAEqB,QAAA,QAAgB,OAAO;EAEpD,QAAA;AAAA"}

package/dist/drivers/helpers/helpers.js

@@ -6,6 +6,7 @@ var WrongResourceTypeError = class extends Error {
 /** Updater incorporates a pattern when someone wants to run a callback
 * that updates something only when it's not already running. */
 var Updater = class {
+	onUpdate;
 	updating;
 	constructor(onUpdate) {
 		this.onUpdate = onUpdate;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","names":[],"sources":["../../../src/drivers/helpers/helpers.ts"],"sourcesContent":["/** Throws when a driver gets a resource with a wrong resource type. */\nexport class WrongResourceTypeError extends Error {\n  name = \"WrongResourceTypeError\";\n}\n\n/** Updater incorporates a pattern when someone wants to run a callback\n * that updates something only when it's not already running. */\nexport class Updater {\n  private updating: Promise<void> | undefined;\n\n  constructor(private readonly onUpdate: () => Promise<void>) {}\n\n  schedule() {\n    if (this.updating == undefined) {\n      this.updating = (async () => {\n        try {\n          await this.onUpdate();\n        } catch (e) {\n          console.log(`error while updating in Updater: ${e}`);\n        } finally {\n          this.updating = undefined;\n        }\n      })();\n    }\n  }\n}\n"],"mappings":";;AACA,IAAa,yBAAb,cAA4C,MAAM;CAChD,OAAO;;;;AAKT,IAAa,UAAb,MAAqB;CACnB;CAEA,YAAY,UAAgD;AAA/B,OAAA,WAAA;;CAE7B,WAAW;AACT,MAAI,KAAK,YAAY,KAAA,EACnB,MAAK,YAAY,YAAY;AAC3B,OAAI;AACF,UAAM,KAAK,UAAU;YACd,GAAG;AACV,YAAQ,IAAI,oCAAoC,IAAI;aAC5C;AACR,SAAK,WAAW,KAAA;;MAEhB"}
+{"version":3,"file":"helpers.js","names":[],"sources":["../../../src/drivers/helpers/helpers.ts"],"sourcesContent":["/** Throws when a driver gets a resource with a wrong resource type. */\nexport class WrongResourceTypeError extends Error {\n  name = \"WrongResourceTypeError\";\n}\n\n/** Updater incorporates a pattern when someone wants to run a callback\n * that updates something only when it's not already running. */\nexport class Updater {\n  private updating: Promise<void> | undefined;\n\n  constructor(private readonly onUpdate: () => Promise<void>) {}\n\n  schedule() {\n    if (this.updating == undefined) {\n      this.updating = (async () => {\n        try {\n          await this.onUpdate();\n        } catch (e) {\n          console.log(`error while updating in Updater: ${e}`);\n        } finally {\n          this.updating = undefined;\n        }\n      })();\n    }\n  }\n}\n"],"mappings":";;AACA,IAAa,yBAAb,cAA4C,MAAM;CAChD,OAAO;AACT;;;AAIA,IAAa,UAAb,MAAqB;CAGU;CAF7B;CAEA,YAAY,UAAgD;EAA/B,KAAA,WAAA;CAAgC;CAE7D,WAAW;EACT,IAAI,KAAK,YAAY,KAAA,GACnB,KAAK,YAAY,YAAY;GAC3B,IAAI;IACF,MAAM,KAAK,SAAS;GACtB,SAAS,GAAG;IACV,QAAQ,IAAI,oCAAoC,GAAG;GACrD,UAAU;IACR,KAAK,WAAW,KAAA;GAClB;EACF,EAAA,CAAG;CAEP;AACF"}

package/dist/drivers/helpers/logs_handle.cjs

@@ -1,4 +1,3 @@
-require("../../_virtual/_rolldown/runtime.cjs");
 let _milaboratories_pl_client = require("@milaboratories/pl-client");
 //#region src/drivers/helpers/logs_handle.ts
 function newLogHandle(live, rInfo) {
@@ -38,6 +37,9 @@ function getResourceInfoFromLogHandle(handle) {
 //#endregion
 exports.getResourceInfoFromLogHandle = getResourceInfoFromLogHandle;
 exports.isLiveLogHandle = isLiveLogHandle;
+exports.isReadyLogHandle = isReadyLogHandle;
+exports.liveHandleRegex = liveHandleRegex;
 exports.newLogHandle = newLogHandle;
+exports.readyHandleRegex = readyHandleRegex;
 
 //# sourceMappingURL=logs_handle.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"logs_handle.cjs","names":[],"sources":["../../../src/drivers/helpers/logs_handle.ts"],"sourcesContent":["/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\n\nimport type { ResourceInfo } from \"@milaboratories/pl-tree\";\nimport type * as sdk from \"@milaboratories/pl-model-common\";\nimport {\n  createSignedResourceId,\n  parseSignedResourceId,\n  signatureToBase64Url,\n  base64UrlToSignature,\n} from \"@milaboratories/pl-client\";\n\nexport function newLogHandle(live: boolean, rInfo: ResourceInfo): sdk.AnyLogHandle {\n  const { globalId, signature } = parseSignedResourceId(rInfo.id);\n  const sigSegment = signatureToBase64Url(signature);\n  if (live) {\n    return `log+live://log/${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}` as sdk.LiveLogHandle;\n  }\n\n  return `log+ready://log/${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}` as sdk.ReadyLogHandle;\n}\n\n/** Handle of the live logs of a program.\n * The resource that represents a log can be deleted,\n * in this case the handle should be refreshed. */\n\nexport const liveHandleRegex =\n  /^log\\+live:\\/\\/log\\/(?<resourceType>.+)\\/(?<resourceVersion>[^/]+)\\/(?<resourceId>\\d+)\\/(?<resourceSig>[A-Za-z0-9_\\-=]*)$/;\n\nexport function isLiveLogHandle(handle: string): handle is sdk.LiveLogHandle {\n  return liveHandleRegex.test(handle);\n}\n\n/** Handle of the ready logs of a program. */\n\nexport const readyHandleRegex =\n  /^log\\+ready:\\/\\/log\\/(?<resourceType>.+)\\/(?<resourceVersion>.+)\\/(?<resourceId>\\d+)\\/(?<resourceSig>[A-Za-z0-9_\\-=]*)$/;\n\nexport function isReadyLogHandle(handle: string): handle is sdk.ReadyLogHandle {\n  return readyHandleRegex.test(handle);\n}\n\nexport function getResourceInfoFromLogHandle(handle: sdk.AnyLogHandle): ResourceInfo {\n  let parsed: RegExpMatchArray | null;\n\n  if (isLiveLogHandle(handle)) {\n    parsed = handle.match(liveHandleRegex);\n  } else if (isReadyLogHandle(handle)) {\n    parsed = handle.match(readyHandleRegex);\n  } else throw new Error(`Log handle is malformed: ${handle}`);\n  if (parsed == null) throw new Error(`Log handle wasn't parsed: ${handle}`);\n\n  const { resourceType, resourceVersion, resourceId, resourceSig } = parsed.groups!;\n\n  const sig = resourceSig ? base64UrlToSignature(resourceSig) : undefined;\n\n  return {\n    id: createSignedResourceId(BigInt(resourceId), sig),\n    type: { name: resourceType, version: resourceVersion },\n  };\n}\n"],"mappings":";;;AAYA,SAAgB,aAAa,MAAe,OAAuC;CACjF,MAAM,EAAE,UAAU,eAAA,GAAA,0BAAA,uBAAoC,MAAM,GAAG;CAC/D,MAAM,cAAA,GAAA,0BAAA,sBAAkC,UAAU;AAClD,KAAI,KACF,QAAO,kBAAkB,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG;AAGhF,QAAO,mBAAmB,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG;;;;;AAOjF,MAAa,kBACX;AAEF,SAAgB,gBAAgB,QAA6C;AAC3E,QAAO,gBAAgB,KAAK,OAAO;;;AAKrC,MAAa,mBACX;AAEF,SAAgB,iBAAiB,QAA8C;AAC7E,QAAO,iBAAiB,KAAK,OAAO;;AAGtC,SAAgB,6BAA6B,QAAwC;CACnF,IAAI;AAEJ,KAAI,gBAAgB,OAAO,CACzB,UAAS,OAAO,MAAM,gBAAgB;UAC7B,iBAAiB,OAAO,CACjC,UAAS,OAAO,MAAM,iBAAiB;KAClC,OAAM,IAAI,MAAM,4BAA4B,SAAS;AAC5D,KAAI,UAAU,KAAM,OAAM,IAAI,MAAM,6BAA6B,SAAS;CAE1E,MAAM,EAAE,cAAc,iBAAiB,YAAY,gBAAgB,OAAO;CAE1E,MAAM,MAAM,eAAA,GAAA,0BAAA,sBAAmC,YAAY,GAAG,KAAA;AAE9D,QAAO;EACL,KAAA,GAAA,0BAAA,wBAA2B,OAAO,WAAW,EAAE,IAAI;EACnD,MAAM;GAAE,MAAM;GAAc,SAAS;GAAiB;EACvD"}
+{"version":3,"file":"logs_handle.cjs","names":[],"sources":["../../../src/drivers/helpers/logs_handle.ts"],"sourcesContent":["/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\n\nimport type { ResourceInfo } from \"@milaboratories/pl-tree\";\nimport type * as sdk from \"@milaboratories/pl-model-common\";\nimport {\n  createSignedResourceId,\n  parseSignedResourceId,\n  signatureToBase64Url,\n  base64UrlToSignature,\n} from \"@milaboratories/pl-client\";\n\nexport function newLogHandle(live: boolean, rInfo: ResourceInfo): sdk.AnyLogHandle {\n  const { globalId, signature } = parseSignedResourceId(rInfo.id);\n  const sigSegment = signatureToBase64Url(signature);\n  if (live) {\n    return `log+live://log/${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}` as sdk.LiveLogHandle;\n  }\n\n  return `log+ready://log/${rInfo.type.name}/${rInfo.type.version}/${globalId}/${sigSegment}` as sdk.ReadyLogHandle;\n}\n\n/** Handle of the live logs of a program.\n * The resource that represents a log can be deleted,\n * in this case the handle should be refreshed. */\n\nexport const liveHandleRegex =\n  /^log\\+live:\\/\\/log\\/(?<resourceType>.+)\\/(?<resourceVersion>[^/]+)\\/(?<resourceId>\\d+)\\/(?<resourceSig>[A-Za-z0-9_\\-=]*)$/;\n\nexport function isLiveLogHandle(handle: string): handle is sdk.LiveLogHandle {\n  return liveHandleRegex.test(handle);\n}\n\n/** Handle of the ready logs of a program. */\n\nexport const readyHandleRegex =\n  /^log\\+ready:\\/\\/log\\/(?<resourceType>.+)\\/(?<resourceVersion>.+)\\/(?<resourceId>\\d+)\\/(?<resourceSig>[A-Za-z0-9_\\-=]*)$/;\n\nexport function isReadyLogHandle(handle: string): handle is sdk.ReadyLogHandle {\n  return readyHandleRegex.test(handle);\n}\n\nexport function getResourceInfoFromLogHandle(handle: sdk.AnyLogHandle): ResourceInfo {\n  let parsed: RegExpMatchArray | null;\n\n  if (isLiveLogHandle(handle)) {\n    parsed = handle.match(liveHandleRegex);\n  } else if (isReadyLogHandle(handle)) {\n    parsed = handle.match(readyHandleRegex);\n  } else throw new Error(`Log handle is malformed: ${handle}`);\n  if (parsed == null) throw new Error(`Log handle wasn't parsed: ${handle}`);\n\n  const { resourceType, resourceVersion, resourceId, resourceSig } = parsed.groups!;\n\n  const sig = resourceSig ? base64UrlToSignature(resourceSig) : undefined;\n\n  return {\n    id: createSignedResourceId(BigInt(resourceId), sig),\n    type: { name: resourceType, version: resourceVersion },\n  };\n}\n"],"mappings":";;AAYA,SAAgB,aAAa,MAAe,OAAuC;CACjF,MAAM,EAAE,UAAU,eAAA,GAAA,0BAAA,sBAAA,CAAoC,MAAM,EAAE;CAC9D,MAAM,cAAA,GAAA,0BAAA,qBAAA,CAAkC,SAAS;CACjD,IAAI,MACF,OAAO,kBAAkB,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG;CAGhF,OAAO,mBAAmB,MAAM,KAAK,KAAK,GAAG,MAAM,KAAK,QAAQ,GAAG,SAAS,GAAG;AACjF;;;;AAMA,MAAa,kBACX;AAEF,SAAgB,gBAAgB,QAA6C;CAC3E,OAAO,gBAAgB,KAAK,MAAM;AACpC;;AAIA,MAAa,mBACX;AAEF,SAAgB,iBAAiB,QAA8C;CAC7E,OAAO,iBAAiB,KAAK,MAAM;AACrC;AAEA,SAAgB,6BAA6B,QAAwC;CACnF,IAAI;CAEJ,IAAI,gBAAgB,MAAM,GACxB,SAAS,OAAO,MAAM,eAAe;MAChC,IAAI,iBAAiB,MAAM,GAChC,SAAS,OAAO,MAAM,gBAAgB;MACjC,MAAM,IAAI,MAAM,4BAA4B,QAAQ;CAC3D,IAAI,UAAU,MAAM,MAAM,IAAI,MAAM,6BAA6B,QAAQ;CAEzE,MAAM,EAAE,cAAc,iBAAiB,YAAY,gBAAgB,OAAO;CAE1E,MAAM,MAAM,eAAA,GAAA,0BAAA,qBAAA,CAAmC,WAAW,IAAI,KAAA;CAE9D,OAAO;EACL,KAAA,GAAA,0BAAA,uBAAA,CAA2B,OAAO,UAAU,GAAG,GAAG;EAClD,MAAM;GAAE,MAAM;GAAc,SAAS;EAAgB;CACvD;AACF"}

package/dist/drivers/helpers/logs_handle.js

@@ -35,6 +35,6 @@ function getResourceInfoFromLogHandle(handle) {
 	};
 }
 //#endregion
-export { getResourceInfoFromLogHandle, isLiveLogHandle, newLogHandle };
+export { getResourceInfoFromLogHandle, isLiveLogHandle, isReadyLogHandle, liveHandleRegex, newLogHandle, readyHandleRegex };
 
 //# sourceMappingURL=logs_handle.js.map