@milaboratories/pl-model-common 1.25.1 → 1.25.3

package/dist/drivers/ChunkedStreamReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChunkedStreamReader.js","sources":["../../src/drivers/ChunkedStreamReader.ts"],"sourcesContent":["import type { RangeBytes } from \"./blob\";\n\n/**\n * Status returned by onError handler to indicate what action to take\n * - 'continue': Retry the failed operation\n * - 'error': Error the stream (calls controller.error, aborts ongoing fetches)\n * - 'cancel': Cancel the stream gracefully (calls controller.close, aborts ongoing fetches)\n */\nexport type ErrorHandlerStatus = \"continue\" | \"error\" | \"cancel\";\n\n/**\n * Options for creating a ChunkedStreamReader\n */\nexport interface ChunkedStreamReaderOptions {\n  /**\n   * Function to fetch a chunk of data. Optionally accepts an AbortSignal to cancel the fetch.\n   */\n  fetchChunk: (range: RangeBytes, signal?: AbortSignal) => Promise<Uint8Array>;\n\n  /**\n   * Total size of the blob in bytes\n   */\n  totalSize: number;\n\n  /**\n   * Size of each chunk to read in bytes (default: 16MB)\n   */\n  chunkSize?: number;\n\n  /**\n   * Error handler callback. Called when an error occurs during chunk fetching.\n   * Should return:\n   * - 'continue' to retry the operation\n   * - 'error' to error the stream (will call controller.error and abort ongoing fetches)\n   * - 'cancel' to cancel gracefully (will call controller.close and abort ongoing fetches)\n   * Default behavior: returns 'error'.\n   */\n  onError?: (error: unknown) => Promise<ErrorHandlerStatus>;\n}\n\n/**\n * ChunkedStreamReader creates a ReadableStream that reads data from a blob driver\n * in fixed-size chunks. This is useful for streaming large files without loading\n * them entirely into memory.\n */\nexport class ChunkedStreamReader {\n  private currentPosition: number = 0;\n  private _read = true;\n  private _canceled = false;\n  private _errored = false;\n  private abortController: AbortController | null = null;\n  private readonly options: Required<ChunkedStreamReaderOptions>;\n\n  /**\n   * Creates a new ChunkedStreamReader instance.\n   * Use the static `create` method instead.\n   */\n  private constructor(options: ChunkedStreamReaderOptions) {\n    // Normalize options with defaults\n    this.options = {\n      ...options,\n      chunkSize: options.chunkSize ?? 16 * 1024 * 1024,\n      onError:\n        options.onError ??\n        (async () => {\n          // Default behavior: error (will automatically call controller.error)\n          return \"error\";\n        }),\n    };\n\n    if (this.totalSize < 0) {\n      throw new Error(\"Total size must be non-negative\");\n    }\n    if (this.chunkSize <= 0) {\n      throw new Error(\"Chunk size must be positive\");\n    }\n  }\n\n  /**\n   * Gets the fetchChunk function from options\n   */\n  private get fetchChunk() {\n    return this.options.fetchChunk;\n  }\n\n  /**\n   * Gets the total size from options\n   */\n  private get totalSize() {\n    return this.options.totalSize;\n  }\n\n  /**\n   * Gets the chunk size from options\n   */\n  private get chunkSize() {\n    return this.options.chunkSize;\n  }\n\n  /**\n   * Gets the onError callback from options\n   */\n  private get onError() {\n    return this.options.onError;\n  }\n\n  /**\n   * Creates and returns a ReadableStream that reads data in chunks.\n   *\n   * @param options - Configuration options for the chunked stream reader\n   * @returns ReadableStream that can be consumed by zip.add or other stream consumers\n   *\n   * @example\n   * ```typescript\n   * const stream = ChunkedStreamReader.create({\n   *   fetchChunk: async (range, signal) => {\n   *     const response = await fetch(`/api/data?from=${range.from}&to=${range.to}`, { signal });\n   *     return new Uint8Array(await response.arrayBuffer());\n   *   },\n   *   totalSize: 1024 * 1024, // 1MB\n   *   chunkSize: 64 * 1024,   // 64KB chunks\n   * });\n   * ```\n   */\n  static create(options: ChunkedStreamReaderOptions): ReadableStream<Uint8Array> {\n    const reader = new ChunkedStreamReader(options);\n    return reader.createStream();\n  }\n\n  private readStart() {\n    this._read = true;\n  }\n\n  private readStop() {\n    this._read = false;\n  }\n\n  private async tryRead(controller: ReadableStreamDefaultController<Uint8Array>): Promise<boolean> {\n    if (this._canceled) {\n      return true;\n    }\n\n    // Check if we've read all data\n    if (this.isComplete()) {\n      controller.close();\n      return true;\n    }\n\n    try {\n      // Calculate the end position for this chunk\n      // Ensure we don't read beyond the total size\n      const endPosition = Math.min(this.currentPosition + this.chunkSize, this.totalSize);\n\n      // Fetch the chunk from the blob driver, passing the abort signal if available\n      const data = await this.fetchChunk(\n        { from: this.currentPosition, to: endPosition },\n        this.abortController?.signal,\n      );\n\n      // Check if stream was cancelled during the fetch\n      if (this._canceled) {\n        return true;\n      }\n\n      // Enqueue the data into the stream\n      controller.enqueue(data);\n\n      // Update the current position for the next chunk\n      this.currentPosition = endPosition;\n\n      if (!controller.desiredSize || controller.desiredSize <= 0) {\n        // The internal queue is full, so propagate\n        // the backpressure signal to the underlying source.\n        this.readStop();\n      }\n    } catch (error) {\n      // If any error occurs during chunk reading, call the error handler\n      const status = await this.onError(error);\n\n      if (status === \"error\") {\n        this._errored = true;\n        // Error the stream and abort any ongoing fetch operations\n        controller.error(error);\n        this.abortController?.abort(\"Stream errored\");\n        return true; // Stop reading\n      }\n\n      if (status === \"cancel\") {\n        this._canceled = true;\n        // Close the stream gracefully and abort any ongoing fetch operations\n        controller.close();\n        this.abortController?.abort(\"Stream cancelled\");\n        console.debug(\"ChunkedStreamReader cancelled due to error\");\n        return true; // Stop reading\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Creates and returns a ReadableStream that reads data in chunks.\n   * The stream will automatically close when all data has been read.\n   *\n   * @private - Use the static `create` method instead\n   * @returns ReadableStream that can be consumed by zip.add or other stream consumers\n   */\n  private createStream(): ReadableStream<Uint8Array> {\n    // Create an AbortController for this stream\n    this.abortController = new AbortController();\n\n    return new ReadableStream({\n      start: async (controller) => {\n        while (true) {\n          if (this._canceled || this._errored) {\n            return;\n          }\n\n          if (!this._read) {\n            await new Promise((r) => setTimeout(r, 0));\n            if (controller.desiredSize) {\n              this.readStart();\n            }\n          } else {\n            const isDone = await this.tryRead(controller);\n            if (isDone) {\n              return;\n            }\n          }\n        }\n      },\n\n      pull: () => {\n        this.readStart();\n      },\n\n      cancel: (reason) => {\n        this._canceled = true;\n        // Abort any ongoing fetch operations\n        this.abortController?.abort(reason);\n        console.debug(\"ChunkedStreamReader cancelled:\", reason);\n      },\n    });\n  }\n\n  /**\n   * Gets the current reading position in bytes.\n   *\n   * @returns Current position as number of bytes read\n   */\n  getCurrentPosition(): number {\n    return this.currentPosition;\n  }\n\n  /**\n   * Gets the remaining bytes to be read.\n   *\n   * @returns Number of bytes remaining\n   */\n  getRemainingBytes(): number {\n    return Math.max(0, this.totalSize - this.currentPosition);\n  }\n\n  /**\n   * Checks if the entire blob has been read.\n   *\n   * @returns True if all data has been read\n   */\n  isComplete(): boolean {\n    return this.currentPosition >= this.totalSize;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChunkedStreamReader.js","names":[],"sources":["../../src/drivers/ChunkedStreamReader.ts"],"sourcesContent":["import type { RangeBytes } from \"./blob\";\n\n/**\n * Status returned by onError handler to indicate what action to take\n * - 'continue': Retry the failed operation\n * - 'error': Error the stream (calls controller.error, aborts ongoing fetches)\n * - 'cancel': Cancel the stream gracefully (calls controller.close, aborts ongoing fetches)\n */\nexport type ErrorHandlerStatus = \"continue\" | \"error\" | \"cancel\";\n\n/**\n * Options for creating a ChunkedStreamReader\n */\nexport interface ChunkedStreamReaderOptions {\n  /**\n   * Function to fetch a chunk of data. Optionally accepts an AbortSignal to cancel the fetch.\n   */\n  fetchChunk: (range: RangeBytes, signal?: AbortSignal) => Promise<Uint8Array>;\n\n  /**\n   * Total size of the blob in bytes\n   */\n  totalSize: number;\n\n  /**\n   * Size of each chunk to read in bytes (default: 16MB)\n   */\n  chunkSize?: number;\n\n  /**\n   * Error handler callback. Called when an error occurs during chunk fetching.\n   * Should return:\n   * - 'continue' to retry the operation\n   * - 'error' to error the stream (will call controller.error and abort ongoing fetches)\n   * - 'cancel' to cancel gracefully (will call controller.close and abort ongoing fetches)\n   * Default behavior: returns 'error'.\n   */\n  onError?: (error: unknown) => Promise<ErrorHandlerStatus>;\n}\n\n/**\n * ChunkedStreamReader creates a ReadableStream that reads data from a blob driver\n * in fixed-size chunks. This is useful for streaming large files without loading\n * them entirely into memory.\n */\nexport class ChunkedStreamReader {\n  private currentPosition: number = 0;\n  private _read = true;\n  private _canceled = false;\n  private _errored = false;\n  private abortController: AbortController | null = null;\n  private readonly options: Required<ChunkedStreamReaderOptions>;\n\n  /**\n   * Creates a new ChunkedStreamReader instance.\n   * Use the static `create` method instead.\n   */\n  private constructor(options: ChunkedStreamReaderOptions) {\n    // Normalize options with defaults\n    this.options = {\n      ...options,\n      chunkSize: options.chunkSize ?? 16 * 1024 * 1024,\n      onError:\n        options.onError ??\n        (async () => {\n          // Default behavior: error (will automatically call controller.error)\n          return \"error\";\n        }),\n    };\n\n    if (this.totalSize < 0) {\n      throw new Error(\"Total size must be non-negative\");\n    }\n    if (this.chunkSize <= 0) {\n      throw new Error(\"Chunk size must be positive\");\n    }\n  }\n\n  /**\n   * Gets the fetchChunk function from options\n   */\n  private get fetchChunk() {\n    return this.options.fetchChunk;\n  }\n\n  /**\n   * Gets the total size from options\n   */\n  private get totalSize() {\n    return this.options.totalSize;\n  }\n\n  /**\n   * Gets the chunk size from options\n   */\n  private get chunkSize() {\n    return this.options.chunkSize;\n  }\n\n  /**\n   * Gets the onError callback from options\n   */\n  private get onError() {\n    return this.options.onError;\n  }\n\n  /**\n   * Creates and returns a ReadableStream that reads data in chunks.\n   *\n   * @param options - Configuration options for the chunked stream reader\n   * @returns ReadableStream that can be consumed by zip.add or other stream consumers\n   *\n   * @example\n   * ```typescript\n   * const stream = ChunkedStreamReader.create({\n   *   fetchChunk: async (range, signal) => {\n   *     const response = await fetch(`/api/data?from=${range.from}&to=${range.to}`, { signal });\n   *     return new Uint8Array(await response.arrayBuffer());\n   *   },\n   *   totalSize: 1024 * 1024, // 1MB\n   *   chunkSize: 64 * 1024,   // 64KB chunks\n   * });\n   * ```\n   */\n  static create(options: ChunkedStreamReaderOptions): ReadableStream<Uint8Array> {\n    const reader = new ChunkedStreamReader(options);\n    return reader.createStream();\n  }\n\n  private readStart() {\n    this._read = true;\n  }\n\n  private readStop() {\n    this._read = false;\n  }\n\n  private async tryRead(controller: ReadableStreamDefaultController<Uint8Array>): Promise<boolean> {\n    if (this._canceled) {\n      return true;\n    }\n\n    // Check if we've read all data\n    if (this.isComplete()) {\n      controller.close();\n      return true;\n    }\n\n    try {\n      // Calculate the end position for this chunk\n      // Ensure we don't read beyond the total size\n      const endPosition = Math.min(this.currentPosition + this.chunkSize, this.totalSize);\n\n      // Fetch the chunk from the blob driver, passing the abort signal if available\n      const data = await this.fetchChunk(\n        { from: this.currentPosition, to: endPosition },\n        this.abortController?.signal,\n      );\n\n      // Check if stream was cancelled during the fetch\n      if (this._canceled) {\n        return true;\n      }\n\n      // Enqueue the data into the stream\n      controller.enqueue(data);\n\n      // Update the current position for the next chunk\n      this.currentPosition = endPosition;\n\n      if (!controller.desiredSize || controller.desiredSize <= 0) {\n        // The internal queue is full, so propagate\n        // the backpressure signal to the underlying source.\n        this.readStop();\n      }\n    } catch (error) {\n      // If any error occurs during chunk reading, call the error handler\n      const status = await this.onError(error);\n\n      if (status === \"error\") {\n        this._errored = true;\n        // Error the stream and abort any ongoing fetch operations\n        controller.error(error);\n        this.abortController?.abort(\"Stream errored\");\n        return true; // Stop reading\n      }\n\n      if (status === \"cancel\") {\n        this._canceled = true;\n        // Close the stream gracefully and abort any ongoing fetch operations\n        controller.close();\n        this.abortController?.abort(\"Stream cancelled\");\n        console.debug(\"ChunkedStreamReader cancelled due to error\");\n        return true; // Stop reading\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Creates and returns a ReadableStream that reads data in chunks.\n   * The stream will automatically close when all data has been read.\n   *\n   * @private - Use the static `create` method instead\n   * @returns ReadableStream that can be consumed by zip.add or other stream consumers\n   */\n  private createStream(): ReadableStream<Uint8Array> {\n    // Create an AbortController for this stream\n    this.abortController = new AbortController();\n\n    return new ReadableStream({\n      start: async (controller) => {\n        while (true) {\n          if (this._canceled || this._errored) {\n            return;\n          }\n\n          if (!this._read) {\n            await new Promise((r) => setTimeout(r, 0));\n            if (controller.desiredSize) {\n              this.readStart();\n            }\n          } else {\n            const isDone = await this.tryRead(controller);\n            if (isDone) {\n              return;\n            }\n          }\n        }\n      },\n\n      pull: () => {\n        this.readStart();\n      },\n\n      cancel: (reason) => {\n        this._canceled = true;\n        // Abort any ongoing fetch operations\n        this.abortController?.abort(reason);\n        console.debug(\"ChunkedStreamReader cancelled:\", reason);\n      },\n    });\n  }\n\n  /**\n   * Gets the current reading position in bytes.\n   *\n   * @returns Current position as number of bytes read\n   */\n  getCurrentPosition(): number {\n    return this.currentPosition;\n  }\n\n  /**\n   * Gets the remaining bytes to be read.\n   *\n   * @returns Number of bytes remaining\n   */\n  getRemainingBytes(): number {\n    return Math.max(0, this.totalSize - this.currentPosition);\n  }\n\n  /**\n   * Checks if the entire blob has been read.\n   *\n   * @returns True if all data has been read\n   */\n  isComplete(): boolean {\n    return this.currentPosition >= this.totalSize;\n  }\n}\n"],"mappings":";;;;;;AA6CA,IAAa,sBAAb,MAAa,oBAAoB;CAC/B,AAAQ,kBAA0B;CAClC,AAAQ,QAAQ;CAChB,AAAQ,YAAY;CACpB,AAAQ,WAAW;CACnB,AAAQ,kBAA0C;CAClD,AAAiB;;;;;CAMjB,AAAQ,YAAY,SAAqC;AAEvD,OAAK,UAAU;GACb,GAAG;GACH,WAAW,QAAQ,aAAa,KAAK,OAAO;GAC5C,SACE,QAAQ,YACP,YAAY;AAEX,WAAO;;GAEZ;AAED,MAAI,KAAK,YAAY,EACnB,OAAM,IAAI,MAAM,kCAAkC;AAEpD,MAAI,KAAK,aAAa,EACpB,OAAM,IAAI,MAAM,8BAA8B;;;;;CAOlD,IAAY,aAAa;AACvB,SAAO,KAAK,QAAQ;;;;;CAMtB,IAAY,YAAY;AACtB,SAAO,KAAK,QAAQ;;;;;CAMtB,IAAY,YAAY;AACtB,SAAO,KAAK,QAAQ;;;;;CAMtB,IAAY,UAAU;AACpB,SAAO,KAAK,QAAQ;;;;;;;;;;;;;;;;;;;;CAqBtB,OAAO,OAAO,SAAiE;AAE7E,SADe,IAAI,oBAAoB,QAAQ,CACjC,cAAc;;CAG9B,AAAQ,YAAY;AAClB,OAAK,QAAQ;;CAGf,AAAQ,WAAW;AACjB,OAAK,QAAQ;;CAGf,MAAc,QAAQ,YAA2E;AAC/F,MAAI,KAAK,UACP,QAAO;AAIT,MAAI,KAAK,YAAY,EAAE;AACrB,cAAW,OAAO;AAClB,UAAO;;AAGT,MAAI;GAGF,MAAM,cAAc,KAAK,IAAI,KAAK,kBAAkB,KAAK,WAAW,KAAK,UAAU;GAGnF,MAAM,OAAO,MAAM,KAAK,WACtB;IAAE,MAAM,KAAK;IAAiB,IAAI;IAAa,EAC/C,KAAK,iBAAiB,OACvB;AAGD,OAAI,KAAK,UACP,QAAO;AAIT,cAAW,QAAQ,KAAK;AAGxB,QAAK,kBAAkB;AAEvB,OAAI,CAAC,WAAW,eAAe,WAAW,eAAe,EAGvD,MAAK,UAAU;WAEV,OAAO;GAEd,MAAM,SAAS,MAAM,KAAK,QAAQ,MAAM;AAExC,OAAI,WAAW,SAAS;AACtB,SAAK,WAAW;AAEhB,eAAW,MAAM,MAAM;AACvB,SAAK,iBAAiB,MAAM,iBAAiB;AAC7C,WAAO;;AAGT,OAAI,WAAW,UAAU;AACvB,SAAK,YAAY;AAEjB,eAAW,OAAO;AAClB,SAAK,iBAAiB,MAAM,mBAAmB;AAC/C,YAAQ,MAAM,6CAA6C;AAC3D,WAAO;;;AAIX,SAAO;;;;;;;;;CAUT,AAAQ,eAA2C;AAEjD,OAAK,kBAAkB,IAAI,iBAAiB;AAE5C,SAAO,IAAI,eAAe;GACxB,OAAO,OAAO,eAAe;AAC3B,WAAO,MAAM;AACX,SAAI,KAAK,aAAa,KAAK,SACzB;AAGF,SAAI,CAAC,KAAK,OAAO;AACf,YAAM,IAAI,SAAS,MAAM,WAAW,GAAG,EAAE,CAAC;AAC1C,UAAI,WAAW,YACb,MAAK,WAAW;gBAGH,MAAM,KAAK,QAAQ,WAAW,CAE3C;;;GAMR,YAAY;AACV,SAAK,WAAW;;GAGlB,SAAS,WAAW;AAClB,SAAK,YAAY;AAEjB,SAAK,iBAAiB,MAAM,OAAO;AACnC,YAAQ,MAAM,kCAAkC,OAAO;;GAE1D,CAAC;;;;;;;CAQJ,qBAA6B;AAC3B,SAAO,KAAK;;;;;;;CAQd,oBAA4B;AAC1B,SAAO,KAAK,IAAI,GAAG,KAAK,YAAY,KAAK,gBAAgB;;;;;;;CAQ3D,aAAsB;AACpB,SAAO,KAAK,mBAAmB,KAAK"}

package/dist/drivers/blob.cjs

@@ -1,29 +1,27 @@
-'use strict';
-
-var zod = require('zod');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let zod = require("zod");
 
+//#region src/drivers/blob.ts
 /** Range in bytes, from should be less than to. */
 const RangeBytes = zod.z.object({
-    /** Included left border. */
-    from: zod.z.number().min(0),
-    /** Excluded right border. */
-    to: zod.z.number().min(1),
+	from: zod.z.number().min(0),
+	to: zod.z.number().min(1)
 });
 function newRangeBytesOpt(from, to) {
-    if (from == undefined || to == undefined) {
-        return undefined;
-    }
-    const range = { from, to };
-    validateRangeBytes(range, "newRangeBytesOpt");
-    return range;
+	if (from == void 0 || to == void 0) return;
+	const range = {
+		from,
+		to
+	};
+	validateRangeBytes(range, "newRangeBytesOpt");
+	return range;
 }
 function validateRangeBytes(range, errMsg) {
-    if (range.from < 0 || range.from >= range.to) {
-        throw new Error(`${errMsg}: invalid bytes range: ${range}`);
-    }
+	if (range.from < 0 || range.from >= range.to) throw new Error(`${errMsg}: invalid bytes range: ${range}`);
 }
 
+//#endregion
 exports.RangeBytes = RangeBytes;
 exports.newRangeBytesOpt = newRangeBytesOpt;
 exports.validateRangeBytes = validateRangeBytes;
-//# sourceMappingURL=blob.cjs.map
+//# sourceMappingURL=blob.cjs.map

package/dist/drivers/blob.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"blob.cjs","sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport { z } from \"zod\";\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, \"LocalBlobHandle\">;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, \"RemoteBlobHandle\">;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = LocalBlobHandle | RemoteBlobHandle,\n> {\n  /** Handle to retrieve block content using {@link BlobDriver.getContent()} */\n  readonly handle: H;\n\n  /** Blob size in bytes. */\n  readonly size: number;\n}\n\n/** Range in bytes, from should be less than to. */\nexport const RangeBytes = z.object({\n  /** Included left border. */\n  from: z.number().min(0),\n  /** Excluded right border. */\n  to: z.number().min(1),\n});\n\nexport type RangeBytes = z.infer<typeof RangeBytes>;\n\nexport function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undefined {\n  if (from == undefined || to == undefined) {\n    return undefined;\n  }\n\n  const range = { from, to };\n  validateRangeBytes(range, \"newRangeBytesOpt\");\n\n  return range;\n}\n\nexport function validateRangeBytes(range: RangeBytes, errMsg: string) {\n  if (range.from < 0 || range.from >= range.to) {\n    throw new Error(`${errMsg}: invalid bytes range: ${range}`);\n  }\n}\n\n/** Being configured inside the output structure provides information about\n * locally downloaded blob and means to retrieve it's content when needed. This\n * structure is created only after the blob's content is downloaded locally, and\n * ready for quick access. */\nexport type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;\n\n/** Being configured inside the output structure provides information about\n * remote blob and means to retrieve it's content when needed. This structure\n * is created as soon as remote blob becomes available. */\nexport type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;\n\nexport type GetContentOptions = {\n  /** Byte range in [from, to) format. */\n  range?: RangeBytes;\n  /** Signal to abort the operation early. */\n  signal?: AbortSignal;\n};\n\nexport type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;\n\n/** Defines API of blob driver as it is seen from the block UI code. */\nexport interface BlobDriver {\n  /**\n   * Given the blob handle returns its content.\n   * Depending on the handle type, content will be served from locally downloaded file,\n   * or directly from remote platforma storage.\n   */\n  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;\n}\n"],"names":["z"],"mappings":";;;;AAuBA;AACO,MAAM,UAAU,GAAGA,KAAC,CAAC,MAAM,CAAC;;IAEjC,IAAI,EAAEA,KAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;;IAEvB,EAAE,EAAEA,KAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACtB,CAAA;AAIK,SAAU,gBAAgB,CAAC,IAAa,EAAE,EAAW,EAAA;IACzD,IAAI,IAAI,IAAI,SAAS,IAAI,EAAE,IAAI,SAAS,EAAE;AACxC,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;AAC1B,IAAA,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,CAAC;AAE7C,IAAA,OAAO,KAAK;AACd;AAEM,SAAU,kBAAkB,CAAC,KAAiB,EAAE,MAAc,EAAA;AAClE,IAAA,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE;QAC5C,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,uBAAA,EAA0B,KAAK,CAAA,CAAE,CAAC;IAC7D;AACF;;;;;;"}
+{"version":3,"file":"blob.cjs","names":["z"],"sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport { z } from \"zod\";\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, \"LocalBlobHandle\">;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, \"RemoteBlobHandle\">;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = LocalBlobHandle | RemoteBlobHandle,\n> {\n  /** Handle to retrieve block content using {@link BlobDriver.getContent()} */\n  readonly handle: H;\n\n  /** Blob size in bytes. */\n  readonly size: number;\n}\n\n/** Range in bytes, from should be less than to. */\nexport const RangeBytes = z.object({\n  /** Included left border. */\n  from: z.number().min(0),\n  /** Excluded right border. */\n  to: z.number().min(1),\n});\n\nexport type RangeBytes = z.infer<typeof RangeBytes>;\n\nexport function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undefined {\n  if (from == undefined || to == undefined) {\n    return undefined;\n  }\n\n  const range = { from, to };\n  validateRangeBytes(range, \"newRangeBytesOpt\");\n\n  return range;\n}\n\nexport function validateRangeBytes(range: RangeBytes, errMsg: string) {\n  if (range.from < 0 || range.from >= range.to) {\n    throw new Error(`${errMsg}: invalid bytes range: ${range}`);\n  }\n}\n\n/** Being configured inside the output structure provides information about\n * locally downloaded blob and means to retrieve it's content when needed. This\n * structure is created only after the blob's content is downloaded locally, and\n * ready for quick access. */\nexport type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;\n\n/** Being configured inside the output structure provides information about\n * remote blob and means to retrieve it's content when needed. This structure\n * is created as soon as remote blob becomes available. */\nexport type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;\n\nexport type GetContentOptions = {\n  /** Byte range in [from, to) format. */\n  range?: RangeBytes;\n  /** Signal to abort the operation early. */\n  signal?: AbortSignal;\n};\n\nexport type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;\n\n/** Defines API of blob driver as it is seen from the block UI code. */\nexport interface BlobDriver {\n  /**\n   * Given the blob handle returns its content.\n   * Depending on the handle type, content will be served from locally downloaded file,\n   * or directly from remote platforma storage.\n   */\n  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;\n}\n"],"mappings":";;;;;AAwBA,MAAa,aAAaA,MAAE,OAAO;CAEjC,MAAMA,MAAE,QAAQ,CAAC,IAAI,EAAE;CAEvB,IAAIA,MAAE,QAAQ,CAAC,IAAI,EAAE;CACtB,CAAC;AAIF,SAAgB,iBAAiB,MAAe,IAAqC;AACnF,KAAI,QAAQ,UAAa,MAAM,OAC7B;CAGF,MAAM,QAAQ;EAAE;EAAM;EAAI;AAC1B,oBAAmB,OAAO,mBAAmB;AAE7C,QAAO;;AAGT,SAAgB,mBAAmB,OAAmB,QAAgB;AACpE,KAAI,MAAM,OAAO,KAAK,MAAM,QAAQ,MAAM,GACxC,OAAM,IAAI,MAAM,GAAG,OAAO,yBAAyB,QAAQ"}

package/dist/drivers/blob.d.ts

@@ -1,58 +1,58 @@
-import type { Branded } from "../branding";
+import { Branded } from "../branding.js";
 import { z } from "zod";
+
+//#region src/drivers/blob.d.ts
 /** Handle of locally downloaded blob. This handle is issued only after the
  * blob's content is downloaded locally, and ready for quick access. */
-export type LocalBlobHandle = Branded<string, "LocalBlobHandle">;
+type LocalBlobHandle = Branded<string, "LocalBlobHandle">;
 /** Handle of remote blob. This handle is issued as soon as the data becomes
  * available on the remote server. */
-export type RemoteBlobHandle = Branded<string, "RemoteBlobHandle">;
+type RemoteBlobHandle = Branded<string, "RemoteBlobHandle">;
 /** Being configured inside the output structure provides information about
  * blob's content and means to retrieve it when needed. */
-export interface BlobHandleAndSize<H extends LocalBlobHandle | RemoteBlobHandle = LocalBlobHandle | RemoteBlobHandle> {
-    /** Handle to retrieve block content using {@link BlobDriver.getContent()} */
-    readonly handle: H;
-    /** Blob size in bytes. */
-    readonly size: number;
+interface BlobHandleAndSize<H extends LocalBlobHandle | RemoteBlobHandle = LocalBlobHandle | RemoteBlobHandle> {
+  /** Handle to retrieve block content using {@link BlobDriver.getContent()} */
+  readonly handle: H;
+  /** Blob size in bytes. */
+  readonly size: number;
 }
 /** Range in bytes, from should be less than to. */
-export declare const RangeBytes: z.ZodObject<{
-    /** Included left border. */
-    from: z.ZodNumber;
-    /** Excluded right border. */
-    to: z.ZodNumber;
+declare const RangeBytes: z.ZodObject<{
+  /** Included left border. */from: z.ZodNumber; /** Excluded right border. */
+  to: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    from: number;
-    to: number;
+  from: number;
+  to: number;
 }, {
-    from: number;
-    to: number;
+  from: number;
+  to: number;
 }>;
-export type RangeBytes = z.infer<typeof RangeBytes>;
-export declare function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undefined;
-export declare function validateRangeBytes(range: RangeBytes, errMsg: string): void;
+type RangeBytes = z.infer<typeof RangeBytes>;
+declare function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undefined;
+declare function validateRangeBytes(range: RangeBytes, errMsg: string): void;
 /** Being configured inside the output structure provides information about
  * locally downloaded blob and means to retrieve it's content when needed. This
  * structure is created only after the blob's content is downloaded locally, and
  * ready for quick access. */
-export type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;
+type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;
 /** Being configured inside the output structure provides information about
  * remote blob and means to retrieve it's content when needed. This structure
  * is created as soon as remote blob becomes available. */
-export type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;
-export type GetContentOptions = {
-    /** Byte range in [from, to) format. */
-    range?: RangeBytes;
-    /** Signal to abort the operation early. */
-    signal?: AbortSignal;
+type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;
+type GetContentOptions = {
+  /** Byte range in [from, to) format. */range?: RangeBytes; /** Signal to abort the operation early. */
+  signal?: AbortSignal;
 };
-export type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;
+type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;
 /** Defines API of blob driver as it is seen from the block UI code. */
-export interface BlobDriver {
-    /**
-     * Given the blob handle returns its content.
-     * Depending on the handle type, content will be served from locally downloaded file,
-     * or directly from remote platforma storage.
-     */
-    getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
+interface BlobDriver {
+  /**
+   * Given the blob handle returns its content.
+   * Depending on the handle type, content will be served from locally downloaded file,
+   * or directly from remote platforma storage.
+   */
+  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
 }
+//#endregion
+export { BlobDriver, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes };
 //# sourceMappingURL=blob.d.ts.map

package/dist/drivers/blob.js

@@ -1,25 +1,24 @@
-import { z } from 'zod';
+import { z } from "zod";
 
+//#region src/drivers/blob.ts
 /** Range in bytes, from should be less than to. */
 const RangeBytes = z.object({
-    /** Included left border. */
-    from: z.number().min(0),
-    /** Excluded right border. */
-    to: z.number().min(1),
+	from: z.number().min(0),
+	to: z.number().min(1)
 });
 function newRangeBytesOpt(from, to) {
-    if (from == undefined || to == undefined) {
-        return undefined;
-    }
-    const range = { from, to };
-    validateRangeBytes(range, "newRangeBytesOpt");
-    return range;
+	if (from == void 0 || to == void 0) return;
+	const range = {
+		from,
+		to
+	};
+	validateRangeBytes(range, "newRangeBytesOpt");
+	return range;
 }
 function validateRangeBytes(range, errMsg) {
-    if (range.from < 0 || range.from >= range.to) {
-        throw new Error(`${errMsg}: invalid bytes range: ${range}`);
-    }
+	if (range.from < 0 || range.from >= range.to) throw new Error(`${errMsg}: invalid bytes range: ${range}`);
 }
 
+//#endregion
 export { RangeBytes, newRangeBytesOpt, validateRangeBytes };
-//# sourceMappingURL=blob.js.map
+//# sourceMappingURL=blob.js.map

package/dist/drivers/blob.js.map

@@ -1 +1 @@
-{"version":3,"file":"blob.js","sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport { z } from \"zod\";\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, \"LocalBlobHandle\">;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, \"RemoteBlobHandle\">;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = LocalBlobHandle | RemoteBlobHandle,\n> {\n  /** Handle to retrieve block content using {@link BlobDriver.getContent()} */\n  readonly handle: H;\n\n  /** Blob size in bytes. */\n  readonly size: number;\n}\n\n/** Range in bytes, from should be less than to. */\nexport const RangeBytes = z.object({\n  /** Included left border. */\n  from: z.number().min(0),\n  /** Excluded right border. */\n  to: z.number().min(1),\n});\n\nexport type RangeBytes = z.infer<typeof RangeBytes>;\n\nexport function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undefined {\n  if (from == undefined || to == undefined) {\n    return undefined;\n  }\n\n  const range = { from, to };\n  validateRangeBytes(range, \"newRangeBytesOpt\");\n\n  return range;\n}\n\nexport function validateRangeBytes(range: RangeBytes, errMsg: string) {\n  if (range.from < 0 || range.from >= range.to) {\n    throw new Error(`${errMsg}: invalid bytes range: ${range}`);\n  }\n}\n\n/** Being configured inside the output structure provides information about\n * locally downloaded blob and means to retrieve it's content when needed. This\n * structure is created only after the blob's content is downloaded locally, and\n * ready for quick access. */\nexport type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;\n\n/** Being configured inside the output structure provides information about\n * remote blob and means to retrieve it's content when needed. This structure\n * is created as soon as remote blob becomes available. */\nexport type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;\n\nexport type GetContentOptions = {\n  /** Byte range in [from, to) format. */\n  range?: RangeBytes;\n  /** Signal to abort the operation early. */\n  signal?: AbortSignal;\n};\n\nexport type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;\n\n/** Defines API of blob driver as it is seen from the block UI code. */\nexport interface BlobDriver {\n  /**\n   * Given the blob handle returns its content.\n   * Depending on the handle type, content will be served from locally downloaded file,\n   * or directly from remote platforma storage.\n   */\n  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;\n}\n"],"names":[],"mappings":";;AAuBA;AACO,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;;IAEjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;;IAEvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACtB,CAAA;AAIK,SAAU,gBAAgB,CAAC,IAAa,EAAE,EAAW,EAAA;IACzD,IAAI,IAAI,IAAI,SAAS,IAAI,EAAE,IAAI,SAAS,EAAE;AACxC,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;AAC1B,IAAA,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,CAAC;AAE7C,IAAA,OAAO,KAAK;AACd;AAEM,SAAU,kBAAkB,CAAC,KAAiB,EAAE,MAAc,EAAA;AAClE,IAAA,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE;QAC5C,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,uBAAA,EAA0B,KAAK,CAAA,CAAE,CAAC;IAC7D;AACF;;;;"}
+{"version":3,"file":"blob.js","names":[],"sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\nimport { z } from \"zod\";\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, \"LocalBlobHandle\">;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, \"RemoteBlobHandle\">;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = LocalBlobHandle | RemoteBlobHandle,\n> {\n  /** Handle to retrieve block content using {@link BlobDriver.getContent()} */\n  readonly handle: H;\n\n  /** Blob size in bytes. */\n  readonly size: number;\n}\n\n/** Range in bytes, from should be less than to. */\nexport const RangeBytes = z.object({\n  /** Included left border. */\n  from: z.number().min(0),\n  /** Excluded right border. */\n  to: z.number().min(1),\n});\n\nexport type RangeBytes = z.infer<typeof RangeBytes>;\n\nexport function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undefined {\n  if (from == undefined || to == undefined) {\n    return undefined;\n  }\n\n  const range = { from, to };\n  validateRangeBytes(range, \"newRangeBytesOpt\");\n\n  return range;\n}\n\nexport function validateRangeBytes(range: RangeBytes, errMsg: string) {\n  if (range.from < 0 || range.from >= range.to) {\n    throw new Error(`${errMsg}: invalid bytes range: ${range}`);\n  }\n}\n\n/** Being configured inside the output structure provides information about\n * locally downloaded blob and means to retrieve it's content when needed. This\n * structure is created only after the blob's content is downloaded locally, and\n * ready for quick access. */\nexport type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;\n\n/** Being configured inside the output structure provides information about\n * remote blob and means to retrieve it's content when needed. This structure\n * is created as soon as remote blob becomes available. */\nexport type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;\n\nexport type GetContentOptions = {\n  /** Byte range in [from, to) format. */\n  range?: RangeBytes;\n  /** Signal to abort the operation early. */\n  signal?: AbortSignal;\n};\n\nexport type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;\n\n/** Defines API of blob driver as it is seen from the block UI code. */\nexport interface BlobDriver {\n  /**\n   * Given the blob handle returns its content.\n   * Depending on the handle type, content will be served from locally downloaded file,\n   * or directly from remote platforma storage.\n   */\n  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;\n}\n"],"mappings":";;;;AAwBA,MAAa,aAAa,EAAE,OAAO;CAEjC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CAEvB,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;CACtB,CAAC;AAIF,SAAgB,iBAAiB,MAAe,IAAqC;AACnF,KAAI,QAAQ,UAAa,MAAM,OAC7B;CAGF,MAAM,QAAQ;EAAE;EAAM;EAAI;AAC1B,oBAAmB,OAAO,mBAAmB;AAE7C,QAAO;;AAGT,SAAgB,mBAAmB,OAAmB,QAAgB;AACpE,KAAI,MAAM,OAAO,KAAK,MAAM,QAAQ,MAAM,GACxC,OAAM,IAAI,MAAM,GAAG,OAAO,yBAAyB,QAAQ"}

package/dist/drivers/index.cjs

@@ -0,0 +1,18 @@
+const require_urls = require('./urls.cjs');
+const require_blob = require('./blob.cjs');
+const require_log = require('./log.cjs');
+const require_ls = require('./ls.cjs');
+const require_data_info = require('./pframe/data_info.cjs');
+const require_spec = require('./pframe/spec/spec.cjs');
+const require_data_types = require('./pframe/data_types.cjs');
+const require_utils = require('./pframe/query/utils.cjs');
+const require_table_calculate = require('./pframe/table_calculate.cjs');
+const require_table_common = require('./pframe/table_common.cjs');
+const require_ids = require('./pframe/spec/ids.cjs');
+const require_anchored = require('./pframe/spec/anchored.cjs');
+const require_filtered_column = require('./pframe/spec/filtered_column.cjs');
+const require_selectors = require('./pframe/spec/selectors.cjs');
+const require_native_id = require('./pframe/spec/native_id.cjs');
+const require_linker_columns = require('./pframe/linker_columns.cjs');
+require('./pframe/index.cjs');
+const require_ChunkedStreamReader = require('./ChunkedStreamReader.cjs');

package/dist/drivers/index.d.ts

@@ -1,9 +1,29 @@
-export * from "./interfaces";
-export * from "./urls";
-export * from "./blob";
-export * from "./upload";
-export * from "./log";
-export * from "./ls";
-export * from "./pframe";
-export * from "./ChunkedStreamReader";
-//# sourceMappingURL=index.d.ts.map
+import { BlobLike, FileLike } from "./interfaces.js";
+import { ArchiveFormat, BlobToURLDriver, BlockUIURL, FolderURL, FrontendDriver, isBlockUIURL, isFolderURL } from "./urls.js";
+import { BlobDriver, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes } from "./blob.js";
+import { ImportProgress, ImportStatus } from "./upload.js";
+import { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isLiveLog } from "./log.js";
+import { Annotation, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnInfo, PColumnLazy, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow } from "./pframe/spec/spec.js";
+import { ColumnFilter } from "./pframe/column_filter.js";
+import { BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, DataInfo, DataInfoEntries, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, PColumnDataEntry, PColumnKey, PColumnValue, PColumnValues, PColumnValuesEntry, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, dataInfoToEntries, entriesToDataInfo, isDataInfo, isDataInfoEntries, isPartitionedDataInfoEntries, mapDataInfo, mapDataInfoEntries, visitDataInfo } from "./pframe/data_info.js";
+import { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredPColumnId, AnchoredPColumnSelector, AxisSelector, PColumnSelector, SingleAxisSelector, isAnchoredPColumnId, matchAxis, matchPColumn, selectorsToPredicate } from "./pframe/spec/selectors.js";
+import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, FilteredPColumn, FilteredPColumnId, isFilteredPColumn } from "./pframe/spec/filtered_column.js";
+import { SUniversalPColumnId, UniversalPColumnId, parseColumnId, stringifyColumnId } from "./pframe/spec/ids.js";
+import { FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, RootFilterSpec } from "./pframe/filter_spec.js";
+import { PTableAbsent, PTableNA, PTableShape, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, TableRange, ValueTypeSupported, isPTableAbsent, isPTableNA, isPTableValueAxis, pTableValue, pTableValueBranded } from "./pframe/data_types.js";
+import { FindColumnsRequest, FindColumnsResponse } from "./pframe/find_columns.js";
+import { PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, getPTableColumnId } from "./pframe/table_common.js";
+import { AnchoredIdDeriver, ResolveAnchorsOptions, resolveAnchors } from "./pframe/spec/anchored.js";
+import { NativePObjectId, deriveNativeId } from "./pframe/spec/native_id.js";
+import { SpecExprAxisRef, SpecExprColumnRef, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin } from "./pframe/query/query_spec.js";
+import { ArtificialColumnJoinEntry, CalculateTableDataRequest, CalculateTableDataResponse, ColumnJoinEntry, ConstantAxisFilter, FullJoin, FullPTableColumnData, InlineColumnJoinEntry, InnerJoin, JoinEntry, OuterJoin, PTableDef, PTableDefV2, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableSorting, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, mapJoinEntry, mapPTableDef, mapPTableDefV2, sortJoinEntry, sortPTableDef } from "./pframe/table_calculate.js";
+import { UniqueValuesRequest, UniqueValuesResponse } from "./pframe/unique_values.js";
+import { PFrame, PFrameDef } from "./pframe/pframe.js";
+import { PTable } from "./pframe/table.js";
+import { DataExprAxisRef, DataExprColumnRef, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin } from "./pframe/query/query_data.js";
+import { collectSpecQueryColumns, isBooleanExpression, mapSpecQueryColumns, sortSpecQuery, traverseQuerySpec } from "./pframe/query/utils.js";
+import { PFrameDriver, PFrameHandle, PTableHandle } from "./pframe/driver.js";
+import { CompositeLinkerMap, LinkerMap } from "./pframe/linker_columns.js";
+import "./pframe/index.js";
+import { FileRange, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ListFilesResult, LocalImportFileHandle, LsDriver, LsEntry, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, getFileNameFromHandle, getFilePathFromHandle, isImportFileHandleIndex, isImportFileHandleUpload } from "./ls.js";
+import { ChunkedStreamReader, ChunkedStreamReaderOptions, ErrorHandlerStatus } from "./ChunkedStreamReader.js";

package/dist/drivers/index.js

@@ -0,0 +1,18 @@
+import { isBlockUIURL, isFolderURL } from "./urls.js";
+import { RangeBytes, newRangeBytesOpt, validateRangeBytes } from "./blob.js";
+import { isLiveLog } from "./log.js";
+import { getFileNameFromHandle, getFilePathFromHandle, isImportFileHandleIndex, isImportFileHandleUpload } from "./ls.js";
+import { dataInfoToEntries, entriesToDataInfo, isDataInfo, isDataInfoEntries, isPartitionedDataInfoEntries, mapDataInfo, mapDataInfoEntries, visitDataInfo } from "./pframe/data_info.js";
+import { Annotation, AnnotationJson, Domain, DomainJson, PAxisName, PColumnName, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow } from "./pframe/spec/spec.js";
+import { PTableAbsent, PTableNA, isPTableAbsent, isPTableNA, isPTableValueAxis, pTableValue, pTableValueBranded } from "./pframe/data_types.js";
+import { collectSpecQueryColumns, isBooleanExpression, mapSpecQueryColumns, sortSpecQuery, traverseQuerySpec } from "./pframe/query/utils.js";
+import { mapJoinEntry, mapPTableDef, mapPTableDefV2, sortJoinEntry, sortPTableDef } from "./pframe/table_calculate.js";
+import { getPTableColumnId } from "./pframe/table_common.js";
+import { parseColumnId, stringifyColumnId } from "./pframe/spec/ids.js";
+import { AnchoredIdDeriver, resolveAnchors } from "./pframe/spec/anchored.js";
+import { isFilteredPColumn } from "./pframe/spec/filtered_column.js";
+import { isAnchoredPColumnId, matchAxis, matchPColumn, selectorsToPredicate } from "./pframe/spec/selectors.js";
+import { deriveNativeId } from "./pframe/spec/native_id.js";
+import { LinkerMap } from "./pframe/linker_columns.js";
+import "./pframe/index.js";
+import { ChunkedStreamReader } from "./ChunkedStreamReader.js";

package/dist/drivers/interfaces.d.ts

@@ -1,23 +1,26 @@
+//#region src/drivers/interfaces.d.ts
 /**
  * Intended to match web.Blob, node.Blob, node-fetch.Blob, etc.
  */
-export interface BlobLike {
-    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size) */
-    readonly size: number;
-    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type) */
-    readonly type: string;
-    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text) */
-    text(): Promise<string>;
-    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice) */
-    slice(start?: number, end?: number): BlobLike;
+interface BlobLike {
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size) */
+  readonly size: number;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type) */
+  readonly type: string;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text) */
+  text(): Promise<string>;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice) */
+  slice(start?: number, end?: number): BlobLike;
 }
 /**
  * Intended to match web.File, node.File, node-fetch.File, etc.
  */
-export interface FileLike extends BlobLike {
-    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified) */
-    readonly lastModified: number;
-    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name) */
-    readonly name: string;
+interface FileLike extends BlobLike {
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified) */
+  readonly lastModified: number;
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name) */
+  readonly name: string;
 }
+//#endregion
+export { BlobLike, FileLike };
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/drivers/log.cjs

@@ -1,9 +1,10 @@
-'use strict';
 
+//#region src/drivers/log.ts
 /** Type guard to check if log is live, and corresponding porcess is not finished. */
 function isLiveLog(handle) {
-    return handle !== undefined && handle.startsWith("log+live://log/");
+	return handle !== void 0 && handle.startsWith("log+live://log/");
 }
 
+//#endregion
 exports.isLiveLog = isLiveLog;
-//# sourceMappingURL=log.cjs.map
+//# sourceMappingURL=log.cjs.map

package/dist/drivers/log.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"log.cjs","sources":["../../src/drivers/log.ts"],"sourcesContent":["/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\nexport type AnyLogHandle = LiveLogHandle | ReadyLogHandle;\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. */\nexport type LiveLogHandle = `log+live://log/${string}`;\n\n/** Handle of the ready logs of a program. */\nexport type ReadyLogHandle = `log+ready://log/${string}`;\n\n/** Type guard to check if log is live, and corresponding porcess is not finished. */\nexport function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle {\n  return handle !== undefined && handle.startsWith(\"log+live://log/\");\n}\n\n/** Driver to retrieve logs given log handle */\nexport interface LogsDriver {\n  lastLines(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined, then starts from the end. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n\n  readText(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined of 0, then starts from the beginning. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n}\n\n/** Response of the driver.\n * The caller should give a handle to retrieve it.\n * It can be OK or outdated, in which case the handle\n * should be issued again. */\nexport type StreamingApiResponse = StreamingApiResponseOk | StreamingApiResponseHandleOutdated;\n\nexport type StreamingApiResponseOk = {\n  /** The handle don't have to be updated,\n   * the response is OK. */\n  shouldUpdateHandle: false;\n\n  /** Whether the log can still grow or it's in a final state. */\n  live: boolean;\n\n  /** Data of the response, in bytes. */\n  data: Uint8Array;\n  /** Current size of the file. It can grow if it's still live. */\n  size: number;\n  /** Offset in bytes from the beginning of a file. */\n  newOffset: number;\n};\n\n/** The handle should be issued again, this one is done. */\nexport type StreamingApiResponseHandleOutdated = {\n  shouldUpdateHandle: true;\n};\n\nexport type ProgressLogWithInfo = {\n  progressLine?: string;\n  live: boolean;\n};\n"],"names":[],"mappings":";;AAYA;AACM,SAAU,SAAS,CAAC,MAAgC,EAAA;IACxD,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC;AACrE;;;;"}
+{"version":3,"file":"log.cjs","names":[],"sources":["../../src/drivers/log.ts"],"sourcesContent":["/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\nexport type AnyLogHandle = LiveLogHandle | ReadyLogHandle;\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. */\nexport type LiveLogHandle = `log+live://log/${string}`;\n\n/** Handle of the ready logs of a program. */\nexport type ReadyLogHandle = `log+ready://log/${string}`;\n\n/** Type guard to check if log is live, and corresponding porcess is not finished. */\nexport function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle {\n  return handle !== undefined && handle.startsWith(\"log+live://log/\");\n}\n\n/** Driver to retrieve logs given log handle */\nexport interface LogsDriver {\n  lastLines(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined, then starts from the end. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n\n  readText(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined of 0, then starts from the beginning. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n}\n\n/** Response of the driver.\n * The caller should give a handle to retrieve it.\n * It can be OK or outdated, in which case the handle\n * should be issued again. */\nexport type StreamingApiResponse = StreamingApiResponseOk | StreamingApiResponseHandleOutdated;\n\nexport type StreamingApiResponseOk = {\n  /** The handle don't have to be updated,\n   * the response is OK. */\n  shouldUpdateHandle: false;\n\n  /** Whether the log can still grow or it's in a final state. */\n  live: boolean;\n\n  /** Data of the response, in bytes. */\n  data: Uint8Array;\n  /** Current size of the file. It can grow if it's still live. */\n  size: number;\n  /** Offset in bytes from the beginning of a file. */\n  newOffset: number;\n};\n\n/** The handle should be issued again, this one is done. */\nexport type StreamingApiResponseHandleOutdated = {\n  shouldUpdateHandle: true;\n};\n\nexport type ProgressLogWithInfo = {\n  progressLine?: string;\n  live: boolean;\n};\n"],"mappings":";;;AAaA,SAAgB,UAAU,QAA2D;AACnF,QAAO,WAAW,UAAa,OAAO,WAAW,kBAAkB"}

package/dist/drivers/log.d.ts

@@ -1,67 +1,70 @@
+//#region src/drivers/log.d.ts
 /** Handle of logs. This handle should be passed
  * to the driver for retrieving logs. */
-export type AnyLogHandle = LiveLogHandle | ReadyLogHandle;
+type AnyLogHandle = LiveLogHandle | ReadyLogHandle;
 /** Handle of the live logs of a program.
  * The resource that represents a log can be deleted,
  * in this case the handle should be refreshed. */
-export type LiveLogHandle = `log+live://log/${string}`;
+type LiveLogHandle = `log+live://log/${string}`;
 /** Handle of the ready logs of a program. */
-export type ReadyLogHandle = `log+ready://log/${string}`;
+type ReadyLogHandle = `log+ready://log/${string}`;
 /** Type guard to check if log is live, and corresponding porcess is not finished. */
-export declare function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle;
+declare function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle;
 /** Driver to retrieve logs given log handle */
-export interface LogsDriver {
-    lastLines(
-    /** A handle that was issued previously. */
-    handle: AnyLogHandle, 
-    /** Allows client to limit total data sent from server. */
-    lineCount: number, 
-    /** Makes streamer to perform seek operation to given offset before sending the contents.
-     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.
-     * If undefined, then starts from the end. */
-    offsetBytes?: number, 
-    /** Is substring for line search pattern.
-     * This option makes controller to send to the client only lines, that
-     * have given substring. */
-    searchStr?: string): Promise<StreamingApiResponse>;
-    readText(
-    /** A handle that was issued previously. */
-    handle: AnyLogHandle, 
-    /** Allows client to limit total data sent from server. */
-    lineCount: number, 
-    /** Makes streamer to perform seek operation to given offset before sending the contents.
-     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.
-     * If undefined of 0, then starts from the beginning. */
-    offsetBytes?: number, 
-    /** Is substring for line search pattern.
-     * This option makes controller to send to the client only lines, that
-     * have given substring. */
-    searchStr?: string): Promise<StreamingApiResponse>;
+interface LogsDriver {
+  lastLines(/** A handle that was issued previously. */
+
+  handle: AnyLogHandle, /** Allows client to limit total data sent from server. */
+
+  lineCount: number,
+  /** Makes streamer to perform seek operation to given offset before sending the contents.
+   * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.
+   * If undefined, then starts from the end. */
+
+  offsetBytes?: number,
+  /** Is substring for line search pattern.
+   * This option makes controller to send to the client only lines, that
+   * have given substring. */
+
+  searchStr?: string): Promise<StreamingApiResponse>;
+  readText(/** A handle that was issued previously. */
+
+  handle: AnyLogHandle, /** Allows client to limit total data sent from server. */
+
+  lineCount: number,
+  /** Makes streamer to perform seek operation to given offset before sending the contents.
+   * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.
+   * If undefined of 0, then starts from the beginning. */
+
+  offsetBytes?: number,
+  /** Is substring for line search pattern.
+   * This option makes controller to send to the client only lines, that
+   * have given substring. */
+
+  searchStr?: string): Promise<StreamingApiResponse>;
 }
 /** Response of the driver.
  * The caller should give a handle to retrieve it.
  * It can be OK or outdated, in which case the handle
  * should be issued again. */
-export type StreamingApiResponse = StreamingApiResponseOk | StreamingApiResponseHandleOutdated;
-export type StreamingApiResponseOk = {
-    /** The handle don't have to be updated,
-     * the response is OK. */
-    shouldUpdateHandle: false;
-    /** Whether the log can still grow or it's in a final state. */
-    live: boolean;
-    /** Data of the response, in bytes. */
-    data: Uint8Array;
-    /** Current size of the file. It can grow if it's still live. */
-    size: number;
-    /** Offset in bytes from the beginning of a file. */
-    newOffset: number;
+type StreamingApiResponse = StreamingApiResponseOk | StreamingApiResponseHandleOutdated;
+type StreamingApiResponseOk = {
+  /** The handle don't have to be updated,
+   * the response is OK. */
+  shouldUpdateHandle: false; /** Whether the log can still grow or it's in a final state. */
+  live: boolean; /** Data of the response, in bytes. */
+  data: Uint8Array; /** Current size of the file. It can grow if it's still live. */
+  size: number; /** Offset in bytes from the beginning of a file. */
+  newOffset: number;
 };
 /** The handle should be issued again, this one is done. */
-export type StreamingApiResponseHandleOutdated = {
-    shouldUpdateHandle: true;
+type StreamingApiResponseHandleOutdated = {
+  shouldUpdateHandle: true;
 };
-export type ProgressLogWithInfo = {
-    progressLine?: string;
-    live: boolean;
+type ProgressLogWithInfo = {
+  progressLine?: string;
+  live: boolean;
 };
+//#endregion
+export { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isLiveLog };
 //# sourceMappingURL=log.d.ts.map

package/dist/drivers/log.js

@@ -1,7 +1,9 @@
+//#region src/drivers/log.ts
 /** Type guard to check if log is live, and corresponding porcess is not finished. */
 function isLiveLog(handle) {
-    return handle !== undefined && handle.startsWith("log+live://log/");
+	return handle !== void 0 && handle.startsWith("log+live://log/");
 }
 
+//#endregion
 export { isLiveLog };
-//# sourceMappingURL=log.js.map
+//# sourceMappingURL=log.js.map

package/dist/drivers/log.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.js","sources":["../../src/drivers/log.ts"],"sourcesContent":["/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\nexport type AnyLogHandle = LiveLogHandle | ReadyLogHandle;\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. */\nexport type LiveLogHandle = `log+live://log/${string}`;\n\n/** Handle of the ready logs of a program. */\nexport type ReadyLogHandle = `log+ready://log/${string}`;\n\n/** Type guard to check if log is live, and corresponding porcess is not finished. */\nexport function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle {\n  return handle !== undefined && handle.startsWith(\"log+live://log/\");\n}\n\n/** Driver to retrieve logs given log handle */\nexport interface LogsDriver {\n  lastLines(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined, then starts from the end. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n\n  readText(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined of 0, then starts from the beginning. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n}\n\n/** Response of the driver.\n * The caller should give a handle to retrieve it.\n * It can be OK or outdated, in which case the handle\n * should be issued again. */\nexport type StreamingApiResponse = StreamingApiResponseOk | StreamingApiResponseHandleOutdated;\n\nexport type StreamingApiResponseOk = {\n  /** The handle don't have to be updated,\n   * the response is OK. */\n  shouldUpdateHandle: false;\n\n  /** Whether the log can still grow or it's in a final state. */\n  live: boolean;\n\n  /** Data of the response, in bytes. */\n  data: Uint8Array;\n  /** Current size of the file. It can grow if it's still live. */\n  size: number;\n  /** Offset in bytes from the beginning of a file. */\n  newOffset: number;\n};\n\n/** The handle should be issued again, this one is done. */\nexport type StreamingApiResponseHandleOutdated = {\n  shouldUpdateHandle: true;\n};\n\nexport type ProgressLogWithInfo = {\n  progressLine?: string;\n  live: boolean;\n};\n"],"names":[],"mappings":"AAYA;AACM,SAAU,SAAS,CAAC,MAAgC,EAAA;IACxD,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC;AACrE;;;;"}
+{"version":3,"file":"log.js","names":[],"sources":["../../src/drivers/log.ts"],"sourcesContent":["/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\nexport type AnyLogHandle = LiveLogHandle | ReadyLogHandle;\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. */\nexport type LiveLogHandle = `log+live://log/${string}`;\n\n/** Handle of the ready logs of a program. */\nexport type ReadyLogHandle = `log+ready://log/${string}`;\n\n/** Type guard to check if log is live, and corresponding porcess is not finished. */\nexport function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle {\n  return handle !== undefined && handle.startsWith(\"log+live://log/\");\n}\n\n/** Driver to retrieve logs given log handle */\nexport interface LogsDriver {\n  lastLines(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined, then starts from the end. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n\n  readText(\n    /** A handle that was issued previously. */\n    handle: AnyLogHandle,\n\n    /** Allows client to limit total data sent from server. */\n    lineCount: number,\n\n    /** Makes streamer to perform seek operation to given offset before sending the contents.\n     * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.\n     * If undefined of 0, then starts from the beginning. */\n    offsetBytes?: number,\n\n    /** Is substring for line search pattern.\n     * This option makes controller to send to the client only lines, that\n     * have given substring. */\n    searchStr?: string,\n  ): Promise<StreamingApiResponse>;\n}\n\n/** Response of the driver.\n * The caller should give a handle to retrieve it.\n * It can be OK or outdated, in which case the handle\n * should be issued again. */\nexport type StreamingApiResponse = StreamingApiResponseOk | StreamingApiResponseHandleOutdated;\n\nexport type StreamingApiResponseOk = {\n  /** The handle don't have to be updated,\n   * the response is OK. */\n  shouldUpdateHandle: false;\n\n  /** Whether the log can still grow or it's in a final state. */\n  live: boolean;\n\n  /** Data of the response, in bytes. */\n  data: Uint8Array;\n  /** Current size of the file. It can grow if it's still live. */\n  size: number;\n  /** Offset in bytes from the beginning of a file. */\n  newOffset: number;\n};\n\n/** The handle should be issued again, this one is done. */\nexport type StreamingApiResponseHandleOutdated = {\n  shouldUpdateHandle: true;\n};\n\nexport type ProgressLogWithInfo = {\n  progressLine?: string;\n  live: boolean;\n};\n"],"mappings":";;AAaA,SAAgB,UAAU,QAA2D;AACnF,QAAO,WAAW,UAAa,OAAO,WAAW,kBAAkB"}