@milaboratories/pl-drivers 1.9.0 → 1.10.0

package/dist/clients/constructors.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var download = require('./download.cjs');
+var logs = require('./logs.cjs');
+var progress = require('./progress.cjs');
+var upload = require('./upload.cjs');
+var ls_api = require('./ls_api.cjs');
+
+function createDownloadClient(logger, client, localProjections) {
+    return client.getDriver({
+        name: 'DownloadBlob',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new download.ClientDownload(grpcClientProviderFactory, httpDispatcher, logger, localProjections),
+    });
+}
+function createLogsClient(client, logger) {
+    return client.getDriver({
+        name: 'StreamLogs',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new logs.ClientLogs(grpcClientProviderFactory, httpDispatcher, logger),
+    });
+}
+function createUploadProgressClient(client, logger) {
+    return client.getDriver({
+        name: 'UploadProgress',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new progress.ClientProgress(grpcClientProviderFactory, httpDispatcher, client, logger),
+    });
+}
+function createUploadBlobClient(client, logger) {
+    return client.getDriver({
+        name: 'UploadBlob',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new upload.ClientUpload(grpcClientProviderFactory, httpDispatcher, client, logger),
+    });
+}
+function createLsFilesClient(client, logger) {
+    return client.getDriver({
+        name: 'LsFiles',
+        init: (_client, grpcClientProviderFactory, _httpDispatcher) => new ls_api.ClientLs(grpcClientProviderFactory, logger),
+    });
+}
+
+exports.createDownloadClient = createDownloadClient;
+exports.createLogsClient = createLogsClient;
+exports.createLsFilesClient = createLsFilesClient;
+exports.createUploadBlobClient = createUploadBlobClient;
+exports.createUploadProgressClient = createUploadProgressClient;
+//# sourceMappingURL=constructors.cjs.map

package/dist/clients/constructors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.cjs","sources":["../../src/clients/constructors.ts"],"sourcesContent":["import type { GrpcClientProviderFactory, PlClient } from '@milaboratories/pl-client';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport type { Dispatcher } from 'undici';\nimport { ClientDownload } from './download';\nimport { ClientLogs } from './logs';\nimport { ClientProgress } from './progress';\nimport { ClientUpload } from './upload';\nimport { ClientLs } from './ls_api';\nimport type { LocalStorageProjection } from '../drivers/types';\n\nexport function createDownloadClient(\n  logger: MiLogger,\n  client: PlClient,\n  localProjections: LocalStorageProjection[],\n) {\n  return client.getDriver({\n    name: 'DownloadBlob',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientDownload(grpcClientProviderFactory, httpDispatcher, logger, localProjections),\n  });\n}\n\nexport function createLogsClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'StreamLogs',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientLogs(grpcClientProviderFactory, httpDispatcher, logger),\n  });\n}\n\nexport function createUploadProgressClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'UploadProgress',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientProgress(grpcClientProviderFactory, httpDispatcher, client, logger),\n  });\n}\n\nexport function createUploadBlobClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'UploadBlob',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientUpload(grpcClientProviderFactory, httpDispatcher, client, logger),\n  });\n}\n\nexport function createLsFilesClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'LsFiles',\n    init: (_client: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, _httpDispatcher: Dispatcher) =>\n      new ClientLs(grpcClientProviderFactory, logger),\n  });\n}\n"],"names":["ClientDownload","ClientLogs","ClientProgress","ClientUpload","ClientLs"],"mappings":";;;;;;;;SAUgB,oBAAoB,CAClC,MAAgB,EAChB,MAAgB,EAChB,gBAA0C,EAAA;IAE1C,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAIA,uBAAc,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC;AAC1F,KAAA,CAAC;AACJ;AAEM,SAAU,gBAAgB,CAAC,MAAgB,EAAE,MAAgB,EAAA;IACjE,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,YAAY;AAClB,QAAA,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAIC,eAAU,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,CAAC;AACpE,KAAA,CAAC;AACJ;AAEM,SAAU,0BAA0B,CAAC,MAAgB,EAAE,MAAgB,EAAA;IAC3E,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAIC,uBAAc,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC;AAChF,KAAA,CAAC;AACJ;AAEM,SAAU,sBAAsB,CAAC,MAAgB,EAAE,MAAgB,EAAA;IACvE,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAIC,mBAAY,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC;AAC9E,KAAA,CAAC;AACJ;AAEM,SAAU,mBAAmB,CAAC,MAAgB,EAAE,MAAgB,EAAA;IACpE,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,SAAS;AACf,QAAA,IAAI,EAAE,CAAC,OAAiB,EAAE,yBAAoD,EAAE,eAA2B,KACzG,IAAIC,eAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;AAClD,KAAA,CAAC;AACJ;;;;;;;;"}

package/dist/clients/constructors.d.ts

@@ -11,4 +11,3 @@ export declare function createLogsClient(client: PlClient, logger: MiLogger): Cl
 export declare function createUploadProgressClient(client: PlClient, logger: MiLogger): ClientProgress;
 export declare function createUploadBlobClient(client: PlClient, logger: MiLogger): ClientUpload;
 export declare function createLsFilesClient(client: PlClient, logger: MiLogger): ClientLs;
-//# sourceMappingURL=constructors.d.ts.map

package/dist/clients/constructors.js

@@ -0,0 +1,39 @@
+import { ClientDownload } from './download.js';
+import { ClientLogs } from './logs.js';
+import { ClientProgress } from './progress.js';
+import { ClientUpload } from './upload.js';
+import { ClientLs } from './ls_api.js';
+
+function createDownloadClient(logger, client, localProjections) {
+    return client.getDriver({
+        name: 'DownloadBlob',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new ClientDownload(grpcClientProviderFactory, httpDispatcher, logger, localProjections),
+    });
+}
+function createLogsClient(client, logger) {
+    return client.getDriver({
+        name: 'StreamLogs',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new ClientLogs(grpcClientProviderFactory, httpDispatcher, logger),
+    });
+}
+function createUploadProgressClient(client, logger) {
+    return client.getDriver({
+        name: 'UploadProgress',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new ClientProgress(grpcClientProviderFactory, httpDispatcher, client, logger),
+    });
+}
+function createUploadBlobClient(client, logger) {
+    return client.getDriver({
+        name: 'UploadBlob',
+        init: (_, grpcClientProviderFactory, httpDispatcher) => new ClientUpload(grpcClientProviderFactory, httpDispatcher, client, logger),
+    });
+}
+function createLsFilesClient(client, logger) {
+    return client.getDriver({
+        name: 'LsFiles',
+        init: (_client, grpcClientProviderFactory, _httpDispatcher) => new ClientLs(grpcClientProviderFactory, logger),
+    });
+}
+
+export { createDownloadClient, createLogsClient, createLsFilesClient, createUploadBlobClient, createUploadProgressClient };
+//# sourceMappingURL=constructors.js.map

package/dist/clients/constructors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.js","sources":["../../src/clients/constructors.ts"],"sourcesContent":["import type { GrpcClientProviderFactory, PlClient } from '@milaboratories/pl-client';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport type { Dispatcher } from 'undici';\nimport { ClientDownload } from './download';\nimport { ClientLogs } from './logs';\nimport { ClientProgress } from './progress';\nimport { ClientUpload } from './upload';\nimport { ClientLs } from './ls_api';\nimport type { LocalStorageProjection } from '../drivers/types';\n\nexport function createDownloadClient(\n  logger: MiLogger,\n  client: PlClient,\n  localProjections: LocalStorageProjection[],\n) {\n  return client.getDriver({\n    name: 'DownloadBlob',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientDownload(grpcClientProviderFactory, httpDispatcher, logger, localProjections),\n  });\n}\n\nexport function createLogsClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'StreamLogs',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientLogs(grpcClientProviderFactory, httpDispatcher, logger),\n  });\n}\n\nexport function createUploadProgressClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'UploadProgress',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientProgress(grpcClientProviderFactory, httpDispatcher, client, logger),\n  });\n}\n\nexport function createUploadBlobClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'UploadBlob',\n    init: (_: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, httpDispatcher: Dispatcher) =>\n      new ClientUpload(grpcClientProviderFactory, httpDispatcher, client, logger),\n  });\n}\n\nexport function createLsFilesClient(client: PlClient, logger: MiLogger) {\n  return client.getDriver({\n    name: 'LsFiles',\n    init: (_client: PlClient, grpcClientProviderFactory: GrpcClientProviderFactory, _httpDispatcher: Dispatcher) =>\n      new ClientLs(grpcClientProviderFactory, logger),\n  });\n}\n"],"names":[],"mappings":";;;;;;SAUgB,oBAAoB,CAClC,MAAgB,EAChB,MAAgB,EAChB,gBAA0C,EAAA;IAE1C,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAI,cAAc,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC;AAC1F,KAAA,CAAC;AACJ;AAEM,SAAU,gBAAgB,CAAC,MAAgB,EAAE,MAAgB,EAAA;IACjE,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,YAAY;AAClB,QAAA,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAI,UAAU,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,CAAC;AACpE,KAAA,CAAC;AACJ;AAEM,SAAU,0BAA0B,CAAC,MAAgB,EAAE,MAAgB,EAAA;IAC3E,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAI,cAAc,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC;AAChF,KAAA,CAAC;AACJ;AAEM,SAAU,sBAAsB,CAAC,MAAgB,EAAE,MAAgB,EAAA;IACvE,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,CAAC,CAAW,EAAE,yBAAoD,EAAE,cAA0B,KAClG,IAAI,YAAY,CAAC,yBAAyB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC;AAC9E,KAAA,CAAC;AACJ;AAEM,SAAU,mBAAmB,CAAC,MAAgB,EAAE,MAAgB,EAAA;IACpE,OAAO,MAAM,CAAC,SAAS,CAAC;AACtB,QAAA,IAAI,EAAE,SAAS;AACf,QAAA,IAAI,EAAE,CAAC,OAAiB,EAAE,yBAAoD,EAAE,eAA2B,KACzG,IAAI,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;AAClD,KAAA,CAAC;AACJ;;;;"}

package/dist/clients/download.cjs

@@ -0,0 +1,149 @@
+'use strict';
+
+var plClient = require('@milaboratories/pl-client');
+var tsHelpers = require('@milaboratories/ts-helpers');
+var fs = require('node:fs');
+var fsp = require('node:fs/promises');
+var path = require('node:path');
+var node_stream = require('node:stream');
+var download = require('../helpers/download.cjs');
+var validate = require('../helpers/validate.cjs');
+var protocol_client = require('../proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.client.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 fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var fsp__namespace = /*#__PURE__*/_interopNamespaceDefault(fsp);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
+/** Gets URLs for downloading from pl-core, parses them and reads or downloads
+ * files locally and from the web. */
+class ClientDownload {
+    httpClient;
+    logger;
+    grpcClient;
+    remoteFileDownloader;
+    /** Helps to find a storage root directory by a storage id from URL scheme. */
+    localStorageIdsToRoot;
+    /** Concurrency limiter for local file reads - limit to 32 parallel reads */
+    localFileReadLimiter = new tsHelpers.ConcurrencyLimitingExecutor(32);
+    constructor(grpcClientProviderFactory, httpClient, logger, 
+    /** Pl storages available locally */
+    localProjections) {
+        this.httpClient = httpClient;
+        this.logger = logger;
+        this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new protocol_client.DownloadClient(transport));
+        this.remoteFileDownloader = new download.RemoteFileDownloader(httpClient);
+        this.localStorageIdsToRoot = newLocalStorageIdsToRoot(localProjections);
+    }
+    close() { }
+    /**
+     * Gets a presign URL and downloads the file.
+     * An optional range with 2 numbers from what byte and to what byte to download can be provided.
+     * @param fromBytes - from byte including this byte
+     * @param toBytes - to byte excluding this byte
+     */
+    async withBlobContent(info, options, ops, handler) {
+        const { downloadUrl, headers } = await this.grpcGetDownloadUrl(info, options, ops.signal);
+        const remoteHeaders = Object.fromEntries(headers.map(({ name, value }) => [name, value]));
+        this.logger.info(`download blob ${plClient.stringifyWithResourceId(info)} from url ${downloadUrl}, ops: ${JSON.stringify(ops)}`);
+        return isLocal(downloadUrl)
+            ? await this.withLocalFileContent(downloadUrl, ops, handler)
+            : await this.remoteFileDownloader.withContent(downloadUrl, remoteHeaders, ops, handler);
+    }
+    async withLocalFileContent(url, ops, handler) {
+        const { storageId, relativePath } = parseLocalUrl(url);
+        const fullPath = getFullPath(storageId, this.localStorageIdsToRoot, relativePath);
+        return await this.localFileReadLimiter.run(async () => {
+            const readOps = {
+                start: ops.range?.from,
+                end: ops.range?.to !== undefined ? ops.range.to - 1 : undefined,
+            };
+            let stream;
+            let handlerSuccess = false;
+            try {
+                const stat = await fsp__namespace.stat(fullPath);
+                stream = fs__namespace.createReadStream(fullPath, readOps);
+                const webStream = node_stream.Readable.toWeb(stream);
+                const result = await handler(webStream, stat.size);
+                handlerSuccess = true;
+                return result;
+            }
+            catch (error) {
+                // Cleanup on error (including handler errors)
+                if (!handlerSuccess && stream && !stream.destroyed) {
+                    stream.destroy();
+                }
+                throw error;
+            }
+        });
+    }
+    async grpcGetDownloadUrl({ id, type }, options, signal) {
+        const withAbort = options ?? {};
+        withAbort.abort = signal;
+        return await this.grpcClient.get().getDownloadURL({ resourceId: id, isInternalUse: false }, plClient.addRTypeToMetadata(type, withAbort)).response;
+    }
+}
+function parseLocalUrl(url) {
+    const parsed = new URL(url);
+    if (parsed.pathname == '')
+        throw new WrongLocalFileUrl(`url for local filepath ${url} does not match url scheme`);
+    return {
+        storageId: parsed.host,
+        relativePath: decodeURIComponent(parsed.pathname.slice(1)),
+    };
+}
+function getFullPath(storageId, localStorageIdsToRoot, relativePath) {
+    const root = localStorageIdsToRoot.get(storageId);
+    if (root === undefined)
+        throw new UnknownStorageError(`Unknown storage location: ${storageId}`);
+    if (root === '')
+        return relativePath;
+    return path__namespace.join(root, relativePath);
+}
+const storageProtocol = 'storage://';
+function isLocal(url) {
+    return url.startsWith(storageProtocol);
+}
+/** Throws when a local URL have invalid scheme. */
+class WrongLocalFileUrl extends Error {
+    name = 'WrongLocalFileUrl';
+}
+/** Happens when a storage for a local file can't be found.  */
+class UnknownStorageError extends Error {
+    name = 'UnknownStorageError';
+}
+function newLocalStorageIdsToRoot(projections) {
+    const idToRoot = new Map();
+    for (const lp of projections) {
+        // Empty string means no prefix, i.e. any file on this machine can be got from the storage.
+        if (lp.localPath !== '') {
+            validate.validateAbsolute(lp.localPath);
+        }
+        idToRoot.set(lp.storageId, lp.localPath);
+    }
+    return idToRoot;
+}
+
+exports.ClientDownload = ClientDownload;
+exports.UnknownStorageError = UnknownStorageError;
+exports.WrongLocalFileUrl = WrongLocalFileUrl;
+exports.getFullPath = getFullPath;
+exports.newLocalStorageIdsToRoot = newLocalStorageIdsToRoot;
+exports.parseLocalUrl = parseLocalUrl;
+//# sourceMappingURL=download.cjs.map

package/dist/clients/download.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.cjs","sources":["../../src/clients/download.ts"],"sourcesContent":["/* eslint-disable n/no-unsupported-features/node-builtins */\nimport type { GrpcClientProvider, GrpcClientProviderFactory } from '@milaboratories/pl-client';\nimport { addRTypeToMetadata, stringifyWithResourceId } from '@milaboratories/pl-client';\nimport type { ResourceInfo } from '@milaboratories/pl-tree';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { ConcurrencyLimitingExecutor } from '@milaboratories/ts-helpers';\nimport type { RpcOptions } from '@protobuf-ts/runtime-rpc';\nimport * as fs from 'node:fs';\nimport * as fsp from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { Readable } from 'node:stream';\nimport type { Dispatcher } from 'undici';\nimport type { LocalStorageProjection } from '../drivers/types';\nimport type { DownloadOps, ContentHandler } from '../helpers/download';\nimport { RemoteFileDownloader } from '../helpers/download';\nimport { validateAbsolute } from '../helpers/validate';\nimport type { DownloadAPI_GetDownloadURL_Response } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol';\nimport { DownloadClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.client';\n\n/** Gets URLs for downloading from pl-core, parses them and reads or downloads\n * files locally and from the web. */\nexport class ClientDownload {\n  public readonly grpcClient: GrpcClientProvider<DownloadClient>;\n  private readonly remoteFileDownloader: RemoteFileDownloader;\n\n  /** Helps to find a storage root directory by a storage id from URL scheme. */\n  private readonly localStorageIdsToRoot: Map<string, string>;\n\n  /** Concurrency limiter for local file reads - limit to 32 parallel reads */\n  private readonly localFileReadLimiter = new ConcurrencyLimitingExecutor(32);\n\n  constructor(\n    grpcClientProviderFactory: GrpcClientProviderFactory,\n    public readonly httpClient: Dispatcher,\n    public readonly logger: MiLogger,\n    /** Pl storages available locally */\n    localProjections: LocalStorageProjection[],\n  ) {\n    this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new DownloadClient(transport));\n    this.remoteFileDownloader = new RemoteFileDownloader(httpClient);\n    this.localStorageIdsToRoot = newLocalStorageIdsToRoot(localProjections);\n  }\n\n  close() {}\n\n  /**\n   * Gets a presign URL and downloads the file.\n   * An optional range with 2 numbers from what byte and to what byte to download can be provided.\n   * @param fromBytes - from byte including this byte\n   * @param toBytes - to byte excluding this byte\n   */\n  async withBlobContent<T>(\n    info: ResourceInfo,\n    options: RpcOptions | undefined,\n    ops: DownloadOps,\n    handler: ContentHandler<T>,\n  ): Promise<T> {\n    const { downloadUrl, headers } = await this.grpcGetDownloadUrl(info, options, ops.signal);\n\n    const remoteHeaders = Object.fromEntries(headers.map(({ name, value }) => [name, value]));\n    this.logger.info(`download blob ${stringifyWithResourceId(info)} from url ${downloadUrl}, ops: ${JSON.stringify(ops)}`);\n\n    return isLocal(downloadUrl)\n      ? await this.withLocalFileContent(downloadUrl, ops, handler)\n      : await this.remoteFileDownloader.withContent(downloadUrl, remoteHeaders, ops, handler);\n  }\n\n  async withLocalFileContent<T>(\n    url: string,\n    ops: DownloadOps,\n    handler: ContentHandler<T>,\n  ): Promise<T> {\n    const { storageId, relativePath } = parseLocalUrl(url);\n    const fullPath = getFullPath(storageId, this.localStorageIdsToRoot, relativePath);\n\n    return await this.localFileReadLimiter.run(async () => {\n      const readOps = {\n        start: ops.range?.from,\n        end: ops.range?.to !== undefined ? ops.range.to - 1 : undefined,\n      };\n      let stream: fs.ReadStream | undefined;\n      let handlerSuccess = false;\n\n      try {\n        const stat = await fsp.stat(fullPath);\n        stream = fs.createReadStream(fullPath, readOps);\n        const webStream = Readable.toWeb(stream);\n\n        const result = await handler(webStream, stat.size);\n        handlerSuccess = true;\n        return result;\n      } catch (error) {\n        // Cleanup on error (including handler errors)\n        if (!handlerSuccess && stream && !stream.destroyed) {\n          stream.destroy();\n        }\n        throw error;\n      }\n    });\n  }\n\n  private async grpcGetDownloadUrl(\n    { id, type }: ResourceInfo,\n    options?: RpcOptions,\n    signal?: AbortSignal,\n  ): Promise<DownloadAPI_GetDownloadURL_Response> {\n    const withAbort = options ?? {};\n    withAbort.abort = signal;\n\n    return await this.grpcClient.get().getDownloadURL(\n      { resourceId: id, isInternalUse: false },\n      addRTypeToMetadata(type, withAbort),\n    ).response;\n  }\n}\n\nexport function parseLocalUrl(url: string) {\n  const parsed = new URL(url);\n  if (parsed.pathname == '')\n    throw new WrongLocalFileUrl(`url for local filepath ${url} does not match url scheme`);\n\n  return {\n    storageId: parsed.host,\n    relativePath: decodeURIComponent(parsed.pathname.slice(1)),\n  };\n}\n\nexport function getFullPath(\n  storageId: string,\n  localStorageIdsToRoot: Map<string, string>,\n  relativePath: string,\n) {\n  const root = localStorageIdsToRoot.get(storageId);\n  if (root === undefined) throw new UnknownStorageError(`Unknown storage location: ${storageId}`);\n\n  if (root === '') return relativePath;\n\n  return path.join(root, relativePath);\n}\n\nconst storageProtocol = 'storage://';\nfunction isLocal(url: string) {\n  return url.startsWith(storageProtocol);\n}\n\n/** Throws when a local URL have invalid scheme. */\nexport class WrongLocalFileUrl extends Error {\n  name = 'WrongLocalFileUrl';\n}\n\n/** Happens when a storage for a local file can't be found.  */\nexport class UnknownStorageError extends Error {\n  name = 'UnknownStorageError';\n}\n\nexport function newLocalStorageIdsToRoot(projections: LocalStorageProjection[]) {\n  const idToRoot: Map<string, string> = new Map();\n  for (const lp of projections) {\n    // Empty string means no prefix, i.e. any file on this machine can be got from the storage.\n    if (lp.localPath !== '') {\n      validateAbsolute(lp.localPath);\n    }\n    idToRoot.set(lp.storageId, lp.localPath);\n  }\n\n  return idToRoot;\n}\n"],"names":["ConcurrencyLimitingExecutor","DownloadClient","RemoteFileDownloader","stringifyWithResourceId","fsp","fs","Readable","addRTypeToMetadata","path","validateAbsolute"],"mappings":"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"}

package/dist/clients/download.d.ts

@@ -45,4 +45,3 @@ export declare class UnknownStorageError extends Error {
     name: string;
 }
 export declare function newLocalStorageIdsToRoot(projections: LocalStorageProjection[]): Map<string, string>;
-//# sourceMappingURL=download.d.ts.map

package/dist/clients/download.js

@@ -0,0 +1,121 @@
+import { stringifyWithResourceId, addRTypeToMetadata } from '@milaboratories/pl-client';
+import { ConcurrencyLimitingExecutor } from '@milaboratories/ts-helpers';
+import * as fs from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { Readable } from 'node:stream';
+import { RemoteFileDownloader } from '../helpers/download.js';
+import { validateAbsolute } from '../helpers/validate.js';
+import { DownloadClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.client.js';
+
+/** Gets URLs for downloading from pl-core, parses them and reads or downloads
+ * files locally and from the web. */
+class ClientDownload {
+    httpClient;
+    logger;
+    grpcClient;
+    remoteFileDownloader;
+    /** Helps to find a storage root directory by a storage id from URL scheme. */
+    localStorageIdsToRoot;
+    /** Concurrency limiter for local file reads - limit to 32 parallel reads */
+    localFileReadLimiter = new ConcurrencyLimitingExecutor(32);
+    constructor(grpcClientProviderFactory, httpClient, logger, 
+    /** Pl storages available locally */
+    localProjections) {
+        this.httpClient = httpClient;
+        this.logger = logger;
+        this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new DownloadClient(transport));
+        this.remoteFileDownloader = new RemoteFileDownloader(httpClient);
+        this.localStorageIdsToRoot = newLocalStorageIdsToRoot(localProjections);
+    }
+    close() { }
+    /**
+     * Gets a presign URL and downloads the file.
+     * An optional range with 2 numbers from what byte and to what byte to download can be provided.
+     * @param fromBytes - from byte including this byte
+     * @param toBytes - to byte excluding this byte
+     */
+    async withBlobContent(info, options, ops, handler) {
+        const { downloadUrl, headers } = await this.grpcGetDownloadUrl(info, options, ops.signal);
+        const remoteHeaders = Object.fromEntries(headers.map(({ name, value }) => [name, value]));
+        this.logger.info(`download blob ${stringifyWithResourceId(info)} from url ${downloadUrl}, ops: ${JSON.stringify(ops)}`);
+        return isLocal(downloadUrl)
+            ? await this.withLocalFileContent(downloadUrl, ops, handler)
+            : await this.remoteFileDownloader.withContent(downloadUrl, remoteHeaders, ops, handler);
+    }
+    async withLocalFileContent(url, ops, handler) {
+        const { storageId, relativePath } = parseLocalUrl(url);
+        const fullPath = getFullPath(storageId, this.localStorageIdsToRoot, relativePath);
+        return await this.localFileReadLimiter.run(async () => {
+            const readOps = {
+                start: ops.range?.from,
+                end: ops.range?.to !== undefined ? ops.range.to - 1 : undefined,
+            };
+            let stream;
+            let handlerSuccess = false;
+            try {
+                const stat = await fsp.stat(fullPath);
+                stream = fs.createReadStream(fullPath, readOps);
+                const webStream = Readable.toWeb(stream);
+                const result = await handler(webStream, stat.size);
+                handlerSuccess = true;
+                return result;
+            }
+            catch (error) {
+                // Cleanup on error (including handler errors)
+                if (!handlerSuccess && stream && !stream.destroyed) {
+                    stream.destroy();
+                }
+                throw error;
+            }
+        });
+    }
+    async grpcGetDownloadUrl({ id, type }, options, signal) {
+        const withAbort = options ?? {};
+        withAbort.abort = signal;
+        return await this.grpcClient.get().getDownloadURL({ resourceId: id, isInternalUse: false }, addRTypeToMetadata(type, withAbort)).response;
+    }
+}
+function parseLocalUrl(url) {
+    const parsed = new URL(url);
+    if (parsed.pathname == '')
+        throw new WrongLocalFileUrl(`url for local filepath ${url} does not match url scheme`);
+    return {
+        storageId: parsed.host,
+        relativePath: decodeURIComponent(parsed.pathname.slice(1)),
+    };
+}
+function getFullPath(storageId, localStorageIdsToRoot, relativePath) {
+    const root = localStorageIdsToRoot.get(storageId);
+    if (root === undefined)
+        throw new UnknownStorageError(`Unknown storage location: ${storageId}`);
+    if (root === '')
+        return relativePath;
+    return path.join(root, relativePath);
+}
+const storageProtocol = 'storage://';
+function isLocal(url) {
+    return url.startsWith(storageProtocol);
+}
+/** Throws when a local URL have invalid scheme. */
+class WrongLocalFileUrl extends Error {
+    name = 'WrongLocalFileUrl';
+}
+/** Happens when a storage for a local file can't be found.  */
+class UnknownStorageError extends Error {
+    name = 'UnknownStorageError';
+}
+function newLocalStorageIdsToRoot(projections) {
+    const idToRoot = new Map();
+    for (const lp of projections) {
+        // Empty string means no prefix, i.e. any file on this machine can be got from the storage.
+        if (lp.localPath !== '') {
+            validateAbsolute(lp.localPath);
+        }
+        idToRoot.set(lp.storageId, lp.localPath);
+    }
+    return idToRoot;
+}
+
+export { ClientDownload, UnknownStorageError, WrongLocalFileUrl, getFullPath, newLocalStorageIdsToRoot, parseLocalUrl };
+//# sourceMappingURL=download.js.map

package/dist/clients/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sources":["../../src/clients/download.ts"],"sourcesContent":["/* eslint-disable n/no-unsupported-features/node-builtins */\nimport type { GrpcClientProvider, GrpcClientProviderFactory } from '@milaboratories/pl-client';\nimport { addRTypeToMetadata, stringifyWithResourceId } from '@milaboratories/pl-client';\nimport type { ResourceInfo } from '@milaboratories/pl-tree';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { ConcurrencyLimitingExecutor } from '@milaboratories/ts-helpers';\nimport type { RpcOptions } from '@protobuf-ts/runtime-rpc';\nimport * as fs from 'node:fs';\nimport * as fsp from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { Readable } from 'node:stream';\nimport type { Dispatcher } from 'undici';\nimport type { LocalStorageProjection } from '../drivers/types';\nimport type { DownloadOps, ContentHandler } from '../helpers/download';\nimport { RemoteFileDownloader } from '../helpers/download';\nimport { validateAbsolute } from '../helpers/validate';\nimport type { DownloadAPI_GetDownloadURL_Response } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol';\nimport { DownloadClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/downloadapi/protocol.client';\n\n/** Gets URLs for downloading from pl-core, parses them and reads or downloads\n * files locally and from the web. */\nexport class ClientDownload {\n  public readonly grpcClient: GrpcClientProvider<DownloadClient>;\n  private readonly remoteFileDownloader: RemoteFileDownloader;\n\n  /** Helps to find a storage root directory by a storage id from URL scheme. */\n  private readonly localStorageIdsToRoot: Map<string, string>;\n\n  /** Concurrency limiter for local file reads - limit to 32 parallel reads */\n  private readonly localFileReadLimiter = new ConcurrencyLimitingExecutor(32);\n\n  constructor(\n    grpcClientProviderFactory: GrpcClientProviderFactory,\n    public readonly httpClient: Dispatcher,\n    public readonly logger: MiLogger,\n    /** Pl storages available locally */\n    localProjections: LocalStorageProjection[],\n  ) {\n    this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new DownloadClient(transport));\n    this.remoteFileDownloader = new RemoteFileDownloader(httpClient);\n    this.localStorageIdsToRoot = newLocalStorageIdsToRoot(localProjections);\n  }\n\n  close() {}\n\n  /**\n   * Gets a presign URL and downloads the file.\n   * An optional range with 2 numbers from what byte and to what byte to download can be provided.\n   * @param fromBytes - from byte including this byte\n   * @param toBytes - to byte excluding this byte\n   */\n  async withBlobContent<T>(\n    info: ResourceInfo,\n    options: RpcOptions | undefined,\n    ops: DownloadOps,\n    handler: ContentHandler<T>,\n  ): Promise<T> {\n    const { downloadUrl, headers } = await this.grpcGetDownloadUrl(info, options, ops.signal);\n\n    const remoteHeaders = Object.fromEntries(headers.map(({ name, value }) => [name, value]));\n    this.logger.info(`download blob ${stringifyWithResourceId(info)} from url ${downloadUrl}, ops: ${JSON.stringify(ops)}`);\n\n    return isLocal(downloadUrl)\n      ? await this.withLocalFileContent(downloadUrl, ops, handler)\n      : await this.remoteFileDownloader.withContent(downloadUrl, remoteHeaders, ops, handler);\n  }\n\n  async withLocalFileContent<T>(\n    url: string,\n    ops: DownloadOps,\n    handler: ContentHandler<T>,\n  ): Promise<T> {\n    const { storageId, relativePath } = parseLocalUrl(url);\n    const fullPath = getFullPath(storageId, this.localStorageIdsToRoot, relativePath);\n\n    return await this.localFileReadLimiter.run(async () => {\n      const readOps = {\n        start: ops.range?.from,\n        end: ops.range?.to !== undefined ? ops.range.to - 1 : undefined,\n      };\n      let stream: fs.ReadStream | undefined;\n      let handlerSuccess = false;\n\n      try {\n        const stat = await fsp.stat(fullPath);\n        stream = fs.createReadStream(fullPath, readOps);\n        const webStream = Readable.toWeb(stream);\n\n        const result = await handler(webStream, stat.size);\n        handlerSuccess = true;\n        return result;\n      } catch (error) {\n        // Cleanup on error (including handler errors)\n        if (!handlerSuccess && stream && !stream.destroyed) {\n          stream.destroy();\n        }\n        throw error;\n      }\n    });\n  }\n\n  private async grpcGetDownloadUrl(\n    { id, type }: ResourceInfo,\n    options?: RpcOptions,\n    signal?: AbortSignal,\n  ): Promise<DownloadAPI_GetDownloadURL_Response> {\n    const withAbort = options ?? {};\n    withAbort.abort = signal;\n\n    return await this.grpcClient.get().getDownloadURL(\n      { resourceId: id, isInternalUse: false },\n      addRTypeToMetadata(type, withAbort),\n    ).response;\n  }\n}\n\nexport function parseLocalUrl(url: string) {\n  const parsed = new URL(url);\n  if (parsed.pathname == '')\n    throw new WrongLocalFileUrl(`url for local filepath ${url} does not match url scheme`);\n\n  return {\n    storageId: parsed.host,\n    relativePath: decodeURIComponent(parsed.pathname.slice(1)),\n  };\n}\n\nexport function getFullPath(\n  storageId: string,\n  localStorageIdsToRoot: Map<string, string>,\n  relativePath: string,\n) {\n  const root = localStorageIdsToRoot.get(storageId);\n  if (root === undefined) throw new UnknownStorageError(`Unknown storage location: ${storageId}`);\n\n  if (root === '') return relativePath;\n\n  return path.join(root, relativePath);\n}\n\nconst storageProtocol = 'storage://';\nfunction isLocal(url: string) {\n  return url.startsWith(storageProtocol);\n}\n\n/** Throws when a local URL have invalid scheme. */\nexport class WrongLocalFileUrl extends Error {\n  name = 'WrongLocalFileUrl';\n}\n\n/** Happens when a storage for a local file can't be found.  */\nexport class UnknownStorageError extends Error {\n  name = 'UnknownStorageError';\n}\n\nexport function newLocalStorageIdsToRoot(projections: LocalStorageProjection[]) {\n  const idToRoot: Map<string, string> = new Map();\n  for (const lp of projections) {\n    // Empty string means no prefix, i.e. any file on this machine can be got from the storage.\n    if (lp.localPath !== '') {\n      validateAbsolute(lp.localPath);\n    }\n    idToRoot.set(lp.storageId, lp.localPath);\n  }\n\n  return idToRoot;\n}\n"],"names":[],"mappings":"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"}

package/dist/clients/logs.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+var protocol_client = require('../proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.client.cjs');
+var tsHelpers = require('@milaboratories/ts-helpers');
+var plClient = require('@milaboratories/pl-client');
+
+class ClientLogs {
+    httpClient;
+    logger;
+    grpcClient;
+    constructor(grpcClientProviderFactory, httpClient, logger) {
+        this.httpClient = httpClient;
+        this.logger = logger;
+        this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new protocol_client.StreamingClient(transport));
+    }
+    close() { }
+    /** Reads text back and returns the text,
+     * the new offset
+     * and the total size of the (currently existing) file. */
+    async lastLines({ id: rId, type: rType }, lineCount, offsetBytes = 0n, // if 0n, then start from the end.
+    searchStr, options) {
+        return (await this.grpcClient.get().lastLines({
+            resourceId: rId,
+            lineCount: lineCount,
+            offset: offsetBytes,
+            search: searchStr,
+        }, plClient.addRTypeToMetadata(rType, options))).response;
+    }
+    /** Reads the file forward and returns the text,
+     * the new offset
+     * and the total size of the (currently existing) file. */
+    async readText({ id: rId, type: rType }, lineCount, offsetBytes = 0n, // if 0n, then start from the beginning.
+    searchStr, options) {
+        return (await this.grpcClient.get().readText({
+            resourceId: tsHelpers.notEmpty(rId),
+            readLimit: BigInt(lineCount),
+            offset: offsetBytes,
+            search: searchStr,
+        }, plClient.addRTypeToMetadata(rType, options))).response;
+    }
+}
+
+exports.ClientLogs = ClientLogs;
+//# sourceMappingURL=logs.cjs.map

package/dist/clients/logs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.cjs","sources":["../../src/clients/logs.ts"],"sourcesContent":["import { StreamingClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.client';\nimport type { RpcOptions } from '@protobuf-ts/runtime-rpc';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { notEmpty } from '@milaboratories/ts-helpers';\nimport type { Dispatcher } from 'undici';\nimport type { GrpcClientProvider, GrpcClientProviderFactory } from '@milaboratories/pl-client';\nimport { addRTypeToMetadata } from '@milaboratories/pl-client';\nimport type { StreamingAPI_Response } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol';\nimport type { ResourceInfo } from '@milaboratories/pl-tree';\n\nexport class ClientLogs {\n  public readonly grpcClient: GrpcClientProvider<StreamingClient>;\n\n  constructor(\n    grpcClientProviderFactory: GrpcClientProviderFactory,\n    public readonly httpClient: Dispatcher,\n    public readonly logger: MiLogger,\n  ) {\n    this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new StreamingClient(transport));\n  }\n\n  close() {}\n\n  /** Reads text back and returns the text,\n   * the new offset\n   * and the total size of the (currently existing) file. */\n  public async lastLines(\n    { id: rId, type: rType }: ResourceInfo,\n    lineCount: number,\n    offsetBytes: bigint = 0n, // if 0n, then start from the end.\n    searchStr?: string,\n    options?: RpcOptions,\n  ): Promise<StreamingAPI_Response> {\n    return (\n      await this.grpcClient.get().lastLines(\n        {\n          resourceId: rId,\n          lineCount: lineCount,\n          offset: offsetBytes,\n          search: searchStr,\n        },\n        addRTypeToMetadata(rType, options),\n      )\n    ).response;\n  }\n\n  /** Reads the file forward and returns the text,\n   * the new offset\n   * and the total size of the (currently existing) file. */\n  public async readText(\n    { id: rId, type: rType }: ResourceInfo,\n    lineCount: number,\n    offsetBytes: bigint = 0n, // if 0n, then start from the beginning.\n    searchStr?: string,\n    options?: RpcOptions,\n  ): Promise<StreamingAPI_Response> {\n    return (\n      await this.grpcClient.get().readText(\n        {\n          resourceId: notEmpty(rId),\n          readLimit: BigInt(lineCount),\n          offset: offsetBytes,\n          search: searchStr,\n        },\n        addRTypeToMetadata(rType, options),\n      )\n    ).response;\n  }\n}\n"],"names":["StreamingClient","addRTypeToMetadata","notEmpty"],"mappings":";;;;;;MAUa,UAAU,CAAA;AAKH,IAAA,UAAA;AACA,IAAA,MAAA;AALF,IAAA,UAAU;AAE1B,IAAA,WAAA,CACE,yBAAoD,EACpC,UAAsB,EACtB,MAAgB,EAAA;QADhB,IAAA,CAAA,UAAU,GAAV,UAAU;QACV,IAAA,CAAA,MAAM,GAAN,MAAM;AAEtB,QAAA,IAAI,CAAC,UAAU,GAAG,yBAAyB,CAAC,wBAAwB,CAAC,CAAC,SAAS,KAAK,IAAIA,+BAAe,CAAC,SAAS,CAAC,CAAC;IACrH;AAEA,IAAA,KAAK,KAAI;AAET;;AAE0D;AACnD,IAAA,MAAM,SAAS,CACpB,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAgB,EACtC,SAAiB,EACjB,WAAA,GAAsB,EAAE;AACxB,IAAA,SAAkB,EAClB,OAAoB,EAAA;QAEpB,OAAO,CACL,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CACnC;AACE,YAAA,UAAU,EAAE,GAAG;AACf,YAAA,SAAS,EAAE,SAAS;AACpB,YAAA,MAAM,EAAE,WAAW;AACnB,YAAA,MAAM,EAAE,SAAS;SAClB,EACDC,2BAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CACnC,EACD,QAAQ;IACZ;AAEA;;AAE0D;AACnD,IAAA,MAAM,QAAQ,CACnB,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAgB,EACtC,SAAiB,EACjB,WAAA,GAAsB,EAAE;AACxB,IAAA,SAAkB,EAClB,OAAoB,EAAA;QAEpB,OAAO,CACL,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAClC;AACE,YAAA,UAAU,EAAEC,kBAAQ,CAAC,GAAG,CAAC;AACzB,YAAA,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;AAC5B,YAAA,MAAM,EAAE,WAAW;AACnB,YAAA,MAAM,EAAE,SAAS;SAClB,EACDD,2BAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CACnC,EACD,QAAQ;IACZ;AACD;;;;"}

package/dist/clients/logs.d.ts

@@ -22,4 +22,3 @@ export declare class ClientLogs {
     readText({ id: rId, type: rType }: ResourceInfo, lineCount: number, offsetBytes?: bigint, // if 0n, then start from the beginning.
     searchStr?: string, options?: RpcOptions): Promise<StreamingAPI_Response>;
 }
-//# sourceMappingURL=logs.d.ts.map

package/dist/clients/logs.js

@@ -0,0 +1,42 @@
+import { StreamingClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.client.js';
+import { notEmpty } from '@milaboratories/ts-helpers';
+import { addRTypeToMetadata } from '@milaboratories/pl-client';
+
+class ClientLogs {
+    httpClient;
+    logger;
+    grpcClient;
+    constructor(grpcClientProviderFactory, httpClient, logger) {
+        this.httpClient = httpClient;
+        this.logger = logger;
+        this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new StreamingClient(transport));
+    }
+    close() { }
+    /** Reads text back and returns the text,
+     * the new offset
+     * and the total size of the (currently existing) file. */
+    async lastLines({ id: rId, type: rType }, lineCount, offsetBytes = 0n, // if 0n, then start from the end.
+    searchStr, options) {
+        return (await this.grpcClient.get().lastLines({
+            resourceId: rId,
+            lineCount: lineCount,
+            offset: offsetBytes,
+            search: searchStr,
+        }, addRTypeToMetadata(rType, options))).response;
+    }
+    /** Reads the file forward and returns the text,
+     * the new offset
+     * and the total size of the (currently existing) file. */
+    async readText({ id: rId, type: rType }, lineCount, offsetBytes = 0n, // if 0n, then start from the beginning.
+    searchStr, options) {
+        return (await this.grpcClient.get().readText({
+            resourceId: notEmpty(rId),
+            readLimit: BigInt(lineCount),
+            offset: offsetBytes,
+            search: searchStr,
+        }, addRTypeToMetadata(rType, options))).response;
+    }
+}
+
+export { ClientLogs };
+//# sourceMappingURL=logs.js.map

package/dist/clients/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sources":["../../src/clients/logs.ts"],"sourcesContent":["import { StreamingClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol.client';\nimport type { RpcOptions } from '@protobuf-ts/runtime-rpc';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\nimport { notEmpty } from '@milaboratories/ts-helpers';\nimport type { Dispatcher } from 'undici';\nimport type { GrpcClientProvider, GrpcClientProviderFactory } from '@milaboratories/pl-client';\nimport { addRTypeToMetadata } from '@milaboratories/pl-client';\nimport type { StreamingAPI_Response } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/streamingapi/protocol';\nimport type { ResourceInfo } from '@milaboratories/pl-tree';\n\nexport class ClientLogs {\n  public readonly grpcClient: GrpcClientProvider<StreamingClient>;\n\n  constructor(\n    grpcClientProviderFactory: GrpcClientProviderFactory,\n    public readonly httpClient: Dispatcher,\n    public readonly logger: MiLogger,\n  ) {\n    this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new StreamingClient(transport));\n  }\n\n  close() {}\n\n  /** Reads text back and returns the text,\n   * the new offset\n   * and the total size of the (currently existing) file. */\n  public async lastLines(\n    { id: rId, type: rType }: ResourceInfo,\n    lineCount: number,\n    offsetBytes: bigint = 0n, // if 0n, then start from the end.\n    searchStr?: string,\n    options?: RpcOptions,\n  ): Promise<StreamingAPI_Response> {\n    return (\n      await this.grpcClient.get().lastLines(\n        {\n          resourceId: rId,\n          lineCount: lineCount,\n          offset: offsetBytes,\n          search: searchStr,\n        },\n        addRTypeToMetadata(rType, options),\n      )\n    ).response;\n  }\n\n  /** Reads the file forward and returns the text,\n   * the new offset\n   * and the total size of the (currently existing) file. */\n  public async readText(\n    { id: rId, type: rType }: ResourceInfo,\n    lineCount: number,\n    offsetBytes: bigint = 0n, // if 0n, then start from the beginning.\n    searchStr?: string,\n    options?: RpcOptions,\n  ): Promise<StreamingAPI_Response> {\n    return (\n      await this.grpcClient.get().readText(\n        {\n          resourceId: notEmpty(rId),\n          readLimit: BigInt(lineCount),\n          offset: offsetBytes,\n          search: searchStr,\n        },\n        addRTypeToMetadata(rType, options),\n      )\n    ).response;\n  }\n}\n"],"names":[],"mappings":";;;;MAUa,UAAU,CAAA;AAKH,IAAA,UAAA;AACA,IAAA,MAAA;AALF,IAAA,UAAU;AAE1B,IAAA,WAAA,CACE,yBAAoD,EACpC,UAAsB,EACtB,MAAgB,EAAA;QADhB,IAAA,CAAA,UAAU,GAAV,UAAU;QACV,IAAA,CAAA,MAAM,GAAN,MAAM;AAEtB,QAAA,IAAI,CAAC,UAAU,GAAG,yBAAyB,CAAC,wBAAwB,CAAC,CAAC,SAAS,KAAK,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IACrH;AAEA,IAAA,KAAK,KAAI;AAET;;AAE0D;AACnD,IAAA,MAAM,SAAS,CACpB,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAgB,EACtC,SAAiB,EACjB,WAAA,GAAsB,EAAE;AACxB,IAAA,SAAkB,EAClB,OAAoB,EAAA;QAEpB,OAAO,CACL,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CACnC;AACE,YAAA,UAAU,EAAE,GAAG;AACf,YAAA,SAAS,EAAE,SAAS;AACpB,YAAA,MAAM,EAAE,WAAW;AACnB,YAAA,MAAM,EAAE,SAAS;SAClB,EACD,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CACnC,EACD,QAAQ;IACZ;AAEA;;AAE0D;AACnD,IAAA,MAAM,QAAQ,CACnB,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAgB,EACtC,SAAiB,EACjB,WAAA,GAAsB,EAAE;AACxB,IAAA,SAAkB,EAClB,OAAoB,EAAA;QAEpB,OAAO,CACL,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAClC;AACE,YAAA,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC;AACzB,YAAA,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;AAC5B,YAAA,MAAM,EAAE,WAAW;AACnB,YAAA,MAAM,EAAE,SAAS;SAClB,EACD,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CACnC,EACD,QAAQ;IACZ;AACD;;;;"}

package/dist/clients/ls_api.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+var protocol_client = require('../proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.client.cjs');
+var plClient = require('@milaboratories/pl-client');
+
+class ClientLs {
+    logger;
+    grpcClient;
+    constructor(grpcClientProviderFactory, logger) {
+        this.logger = logger;
+        this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new protocol_client.LSClient(transport));
+    }
+    close() { }
+    async list(rInfo, path, options) {
+        return await this.grpcClient.get().list({
+            resourceId: rInfo.id,
+            location: path,
+        }, plClient.addRTypeToMetadata(rInfo.type, options)).response;
+    }
+}
+
+exports.ClientLs = ClientLs;
+//# sourceMappingURL=ls_api.cjs.map

package/dist/clients/ls_api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls_api.cjs","sources":["../../src/clients/ls_api.ts"],"sourcesContent":["import type { MiLogger } from '@milaboratories/ts-helpers';\nimport type { LsAPI_List_Response } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol';\nimport { LSClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.client';\nimport type { RpcOptions } from '@protobuf-ts/runtime-rpc';\nimport type { GrpcClientProvider, GrpcClientProviderFactory } from '@milaboratories/pl-client';\nimport { addRTypeToMetadata } from '@milaboratories/pl-client';\nimport type { ResourceInfo } from '@milaboratories/pl-tree';\n\nexport class ClientLs {\n  private readonly grpcClient: GrpcClientProvider<LSClient>;\n\n  constructor(\n    grpcClientProviderFactory: GrpcClientProviderFactory,\n    private readonly logger: MiLogger,\n  ) {\n    this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new LSClient(transport));\n  }\n\n  close() {}\n\n  public async list(\n    rInfo: ResourceInfo,\n    path: string,\n    options?: RpcOptions,\n  ): Promise<LsAPI_List_Response> {\n    return await this.grpcClient.get().list(\n      {\n        resourceId: rInfo.id,\n        location: path,\n      },\n      addRTypeToMetadata(rInfo.type, options),\n    ).response;\n  }\n}\n"],"names":["LSClient","addRTypeToMetadata"],"mappings":";;;;;MAQa,QAAQ,CAAA;AAKA,IAAA,MAAA;AAJF,IAAA,UAAU;IAE3B,WAAA,CACE,yBAAoD,EACnC,MAAgB,EAAA;QAAhB,IAAA,CAAA,MAAM,GAAN,MAAM;AAEvB,QAAA,IAAI,CAAC,UAAU,GAAG,yBAAyB,CAAC,wBAAwB,CAAC,CAAC,SAAS,KAAK,IAAIA,wBAAQ,CAAC,SAAS,CAAC,CAAC;IAC9G;AAEA,IAAA,KAAK,KAAI;AAEF,IAAA,MAAM,IAAI,CACf,KAAmB,EACnB,IAAY,EACZ,OAAoB,EAAA;QAEpB,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CACrC;YACE,UAAU,EAAE,KAAK,CAAC,EAAE;AACpB,YAAA,QAAQ,EAAE,IAAI;SACf,EACDC,2BAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CACxC,CAAC,QAAQ;IACZ;AACD;;;;"}

package/dist/clients/ls_api.d.ts

@@ -10,4 +10,3 @@ export declare class ClientLs {
     close(): void;
     list(rInfo: ResourceInfo, path: string, options?: RpcOptions): Promise<LsAPI_List_Response>;
 }
-//# sourceMappingURL=ls_api.d.ts.map

package/dist/clients/ls_api.js

@@ -0,0 +1,21 @@
+import { LSClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.client.js';
+import { addRTypeToMetadata } from '@milaboratories/pl-client';
+
+class ClientLs {
+    logger;
+    grpcClient;
+    constructor(grpcClientProviderFactory, logger) {
+        this.logger = logger;
+        this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new LSClient(transport));
+    }
+    close() { }
+    async list(rInfo, path, options) {
+        return await this.grpcClient.get().list({
+            resourceId: rInfo.id,
+            location: path,
+        }, addRTypeToMetadata(rInfo.type, options)).response;
+    }
+}
+
+export { ClientLs };
+//# sourceMappingURL=ls_api.js.map

package/dist/clients/ls_api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls_api.js","sources":["../../src/clients/ls_api.ts"],"sourcesContent":["import type { MiLogger } from '@milaboratories/ts-helpers';\nimport type { LsAPI_List_Response } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol';\nimport { LSClient } from '../proto/github.com/milaboratory/pl/controllers/shared/grpc/lsapi/protocol.client';\nimport type { RpcOptions } from '@protobuf-ts/runtime-rpc';\nimport type { GrpcClientProvider, GrpcClientProviderFactory } from '@milaboratories/pl-client';\nimport { addRTypeToMetadata } from '@milaboratories/pl-client';\nimport type { ResourceInfo } from '@milaboratories/pl-tree';\n\nexport class ClientLs {\n  private readonly grpcClient: GrpcClientProvider<LSClient>;\n\n  constructor(\n    grpcClientProviderFactory: GrpcClientProviderFactory,\n    private readonly logger: MiLogger,\n  ) {\n    this.grpcClient = grpcClientProviderFactory.createGrpcClientProvider((transport) => new LSClient(transport));\n  }\n\n  close() {}\n\n  public async list(\n    rInfo: ResourceInfo,\n    path: string,\n    options?: RpcOptions,\n  ): Promise<LsAPI_List_Response> {\n    return await this.grpcClient.get().list(\n      {\n        resourceId: rInfo.id,\n        location: path,\n      },\n      addRTypeToMetadata(rInfo.type, options),\n    ).response;\n  }\n}\n"],"names":[],"mappings":";;;MAQa,QAAQ,CAAA;AAKA,IAAA,MAAA;AAJF,IAAA,UAAU;IAE3B,WAAA,CACE,yBAAoD,EACnC,MAAgB,EAAA;QAAhB,IAAA,CAAA,MAAM,GAAN,MAAM;AAEvB,QAAA,IAAI,CAAC,UAAU,GAAG,yBAAyB,CAAC,wBAAwB,CAAC,CAAC,SAAS,KAAK,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9G;AAEA,IAAA,KAAK,KAAI;AAEF,IAAA,MAAM,IAAI,CACf,KAAmB,EACnB,IAAY,EACZ,OAAoB,EAAA;QAEpB,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CACrC;YACE,UAAU,EAAE,KAAK,CAAC,EAAE;AACpB,YAAA,QAAQ,EAAE,IAAI;SACf,EACD,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CACxC,CAAC,QAAQ;IACZ;AACD;;;;"}