@milaboratories/pl-model-common 1.31.0 → 1.31.2

package/dist/drivers/blob.cjs.map

@@ -1 +1 @@
-{"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"}
+{"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,IAAAA,EAAE,OAAO;CAEjC,MAAMA,IAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE;CAEvB,IAAIA,IAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE;CACtB,CAAC;AAIF,SAAgB,iBAAiB,MAAe,IAAqC;AACnF,KAAI,QAAQ,KAAA,KAAa,MAAM,KAAA,EAC7B;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.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob.d.ts","names":[],"sources":["../../src/drivers/blob.ts"],"mappings":";;;;;;KAKY,eAAA,GAAkB,OAAA;;;KAIlB,gBAAA,GAAmB,OAAA;;AAA/B;UAIiB,iBAAA,WACL,eAAA,GAAkB,gBAAA,GAAmB,eAAA,GAAkB,gBAAA;;WAGxD,MAAA,EAAQ,CAAA;EARmB;EAAA,SAW3B,IAAA;AAAA;;cAIE,UAAA,EAAU,CAAA,CAAA,SAAA;EAVO,+CAAqC;;;;;;;;;KAiBvD,UAAA,GAAa,CAAA,CAAE,KAAA,QAAa,UAAA;AAAA,iBAExB,gBAAA,CAAiB,IAAA,WAAe,EAAA,YAAc,UAAA;AAAA,iBAW9C,kBAAA,CAAmB,KAAA,EAAO,UAAA,EAAY,MAAA;;;AApBtD;;KA8BY,sBAAA,GAAyB,iBAAA,CAAkB,eAAA;;;;KAK3C,uBAAA,GAA0B,iBAAA,CAAkB,gBAAA;AAAA,KAE5C,iBAAA;EArCW,uCAuCrB,KAAA,GAAQ,UAAA,EAvCa;EAyCrB,MAAA,GAAS,WAAA;AAAA;AAAA,KAGC,cAAA,OAAqB,OAAA,EAAS,cAAA,EAAgB,IAAA,aAAiB,OAAA,CAAQ,CAAA;;UAGlE,UAAA;;;;;;EAMf,UAAA,CAAW,MAAA,EAAQ,eAAA,GAAkB,gBAAA,EAAkB,KAAA,GAAQ,UAAA,GAAa,OAAA,CAAQ,UAAA;AAAA"}

package/dist/drivers/blob.js

@@ -1,5 +1,4 @@
 import { z } from "zod";
-
 //#region src/drivers/blob.ts
 /** Range in bytes, from should be less than to. */
 const RangeBytes = z.object({
@@ -18,7 +17,7 @@ function newRangeBytesOpt(from, to) {
 function validateRangeBytes(range, errMsg) {
 	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

package/dist/drivers/blob.js.map

@@ -1 +1 @@
-{"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"}
+{"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,KAAA,KAAa,MAAM,KAAA,EAC7B;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

@@ -1,18 +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');
+require("./urls.cjs");
+require("./blob.cjs");
+require("./log.cjs");
+require("./ls.cjs");
+require("./pframe/data_info.cjs");
+require("./pframe/spec/spec.cjs");
+require("./pframe/data_types.cjs");
+require("./pframe/query/utils.cjs");
+require("./pframe/table_calculate.cjs");
+require("./pframe/table_common.cjs");
+require("./pframe/spec/ids.cjs");
+require("./pframe/spec/anchored.cjs");
+require("./pframe/spec/filtered_column.cjs");
+require("./pframe/spec/selectors.cjs");
+require("./pframe/spec/native_id.cjs");
+require("./pframe/linker_columns.cjs");
+require("./pframe/index.cjs");
+require("./ChunkedStreamReader.cjs");

package/dist/drivers/index.d.ts

@@ -2,7 +2,7 @@ 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 { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isAnyLogHandle, 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, resolveAnnotationParents } 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";
@@ -23,7 +23,6 @@ import { DataExprAxisRef, DataExprColumnRef, DataQuery, DataQueryBooleanExpressi
 import { collectSpecQueryColumns, isBooleanExpression, mapSpecQueryColumns, sortSpecQuery, traverseQuerySpec } from "./pframe/query/utils.js";
 import { CompositeLinkerMap, LinkerMap } from "./pframe/linker_columns.js";
 import { AxisQualification, ColumnAxesWithQualifications, DeleteColumnRequest, DeleteColumnResponse, DiscoverColumnsConstraints, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, EvaluateQueryResponse, MatcherMap, MultiAxisSelector, MultiColumnSelector, PFrameSpecDriver, SpecFrameHandle, StringMatcher } from "./pframe/spec_driver.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";
 import { PFrame, PFrameDef } from "./pframe/pframe.js";

package/dist/drivers/index.js

@@ -1,18 +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, resolveAnnotationParents } from "./pframe/spec/spec.js";
-import { PTableNA, isPTableNA, 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, legacyColumnSelectorsToPredicate, matchAxis, matchPColumn } from "./pframe/spec/selectors.js";
-import { deriveNativeId } from "./pframe/spec/native_id.js";
-import { LinkerMap } from "./pframe/linker_columns.js";
+import "./urls.js";
+import "./blob.js";
+import "./log.js";
+import "./ls.js";
+import "./pframe/data_info.js";
+import "./pframe/spec/spec.js";
+import "./pframe/data_types.js";
+import "./pframe/query/utils.js";
+import "./pframe/table_calculate.js";
+import "./pframe/table_common.js";
+import "./pframe/spec/ids.js";
+import "./pframe/spec/anchored.js";
+import "./pframe/spec/filtered_column.js";
+import "./pframe/spec/selectors.js";
+import "./pframe/spec/native_id.js";
+import "./pframe/linker_columns.js";
 import "./pframe/index.js";
-import { ChunkedStreamReader } from "./ChunkedStreamReader.js";
+import "./ChunkedStreamReader.js";

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","names":[],"sources":["../../src/drivers/interfaces.ts"],"mappings":";;AAGA;;UAAiB,QAAA;EAQ8B;EAAA,SANpC,IAAA;EAEA;EAAA,SAAA,IAAA;EAED;EAAR,IAAA,IAAQ,OAAA;EAEF;EAAN,KAAA,CAAM,KAAA,WAAgB,GAAA,YAAe,QAAA;AAAA;;;AAOvC;UAAiB,QAAA,SAAiB,QAAA;;WAEvB,YAAA;EAFuB;EAAA,SAIvB,IAAA;AAAA"}

package/dist/drivers/log.cjs

@@ -1,10 +1,17 @@
-
 //#region src/drivers/log.ts
-/** Type guard to check if log is live, and corresponding porcess is not finished. */
+/** Prefix constants — single source of truth for handle format. */
+const LIVE_LOG_PREFIX = "log+live://log/";
+const READY_LOG_PREFIX = "log+ready://log/";
+/** Type guard to check if a value is any kind of log handle. */
+function isAnyLogHandle(value) {
+	return typeof value === "string" && (value.startsWith(LIVE_LOG_PREFIX) || value.startsWith(READY_LOG_PREFIX));
+}
+/** Type guard to check if log is live, and corresponding process is not finished. */
 function isLiveLog(handle) {
-	return handle !== void 0 && handle.startsWith("log+live://log/");
+	return handle !== void 0 && handle.startsWith(LIVE_LOG_PREFIX);
 }
-
 //#endregion
+exports.isAnyLogHandle = isAnyLogHandle;
 exports.isLiveLog = isLiveLog;
+
 //# sourceMappingURL=log.cjs.map

package/dist/drivers/log.cjs.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"log.cjs","names":[],"sources":["../../src/drivers/log.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\n\n/** Prefix constants — single source of truth for handle format. */\nconst LIVE_LOG_PREFIX = \"log+live://log/\";\nconst READY_LOG_PREFIX = \"log+ready://log/\";\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 = Branded<`${typeof LIVE_LOG_PREFIX}${string}`, \"LiveLogHandle\">;\n\n/** Handle of the ready logs of a program. */\nexport type ReadyLogHandle = Branded<`${typeof READY_LOG_PREFIX}${string}`, \"ReadyLogHandle\">;\n\n/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\nexport type AnyLogHandle = LiveLogHandle | ReadyLogHandle;\n\n/** Type guard to check if a value is any kind of log handle. */\nexport function isAnyLogHandle(value: unknown): value is AnyLogHandle {\n  return (\n    typeof value === \"string\" &&\n    (value.startsWith(LIVE_LOG_PREFIX) || value.startsWith(READY_LOG_PREFIX))\n  );\n}\n\n/** Type guard to check if log is live, and corresponding process is not finished. */\nexport function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle {\n  return handle !== undefined && handle.startsWith(LIVE_LOG_PREFIX);\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":";;AAGA,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;;AAezB,SAAgB,eAAe,OAAuC;AACpE,QACE,OAAO,UAAU,aAChB,MAAM,WAAW,gBAAgB,IAAI,MAAM,WAAW,iBAAiB;;;AAK5E,SAAgB,UAAU,QAA2D;AACnF,QAAO,WAAW,KAAA,KAAa,OAAO,WAAW,gBAAgB"}

package/dist/drivers/log.d.ts

@@ -1,14 +1,21 @@
+import { Branded } from "../branding.js";
+
 //#region src/drivers/log.d.ts
-/** Handle of logs. This handle should be passed
- * to the driver for retrieving logs. */
-type AnyLogHandle = LiveLogHandle | ReadyLogHandle;
+/** Prefix constants — single source of truth for handle format. */
+declare const LIVE_LOG_PREFIX = "log+live://log/";
+declare const READY_LOG_PREFIX = "log+ready://log/";
 /** 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. */
-type LiveLogHandle = `log+live://log/${string}`;
+type LiveLogHandle = Branded<`${typeof LIVE_LOG_PREFIX}${string}`, "LiveLogHandle">;
 /** Handle of the ready logs of a program. */
-type ReadyLogHandle = `log+ready://log/${string}`;
-/** Type guard to check if log is live, and corresponding porcess is not finished. */
+type ReadyLogHandle = Branded<`${typeof READY_LOG_PREFIX}${string}`, "ReadyLogHandle">;
+/** Handle of logs. This handle should be passed
+ * to the driver for retrieving logs. */
+type AnyLogHandle = LiveLogHandle | ReadyLogHandle;
+/** Type guard to check if a value is any kind of log handle. */
+declare function isAnyLogHandle(value: unknown): value is AnyLogHandle;
+/** Type guard to check if log is live, and corresponding process is not finished. */
 declare function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle;
 /** Driver to retrieve logs given log handle */
 interface LogsDriver {
@@ -66,5 +73,5 @@ type ProgressLogWithInfo = {
   live: boolean;
 };
 //#endregion
-export { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isLiveLog };
+export { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isAnyLogHandle, isLiveLog };
 //# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","names":[],"sources":["../../src/drivers/log.ts"],"mappings":";;;;cAGM,eAAA;AAAA,cACA,gBAAA;;;;KAKM,aAAA,GAAgB,OAAA,WAAkB,eAAA;AANzB;AAAA,KAST,cAAA,GAAiB,OAAA,WAAkB,gBAAA;;;KAInC,YAAA,GAAe,aAAA,GAAgB,cAAA;AAP3C;AAAA,iBAUgB,cAAA,CAAe,KAAA,YAAiB,KAAA,IAAS,YAAA;;iBAQzC,SAAA,CAAU,MAAA,EAAQ,YAAA,eAA2B,MAAA,IAAU,aAAA;;UAKtD,UAAA;EACf,SAAA;;EAEE,MAAA,EAAQ,YAAA,EAvBmD;;EA0B3D,SAAA;EAtBoB;;;;EA2BpB,WAAA;EAxBY;;;;EA6BZ,SAAA,YACC,OAAA,CAAQ,oBAAA;EAEX,QAAA,CAhC8C;;EAkC5C,MAAA,EAAQ,YAAA,EAlCyD;;EAqCjE,SAAA;EA7BY;;;;EAkCZ,WAAA;EAlC8B;;;;EAuC9B,SAAA,YACC,OAAA,CAAQ,oBAAA;AAAA;;AAnCb;;;KA0CY,oBAAA,GAAuB,sBAAA,GAAyB,kCAAA;AAAA,KAEhD,sBAAA;EA3BP;;EA8BH,kBAAA,SAZG;EAeH,IAAA,WAfU;EAkBV,IAAA,EAAM,UAAA,EAlDI;EAoDV,IAAA,UAjDE;EAmDF,SAAA;AAAA;;KAIU,kCAAA;EACV,kBAAA;AAAA;AAAA,KAGU,mBAAA;EACV,YAAA;EACA,IAAA;AAAA"}

package/dist/drivers/log.js

@@ -1,9 +1,16 @@
 //#region src/drivers/log.ts
-/** Type guard to check if log is live, and corresponding porcess is not finished. */
+/** Prefix constants — single source of truth for handle format. */
+const LIVE_LOG_PREFIX = "log+live://log/";
+const READY_LOG_PREFIX = "log+ready://log/";
+/** Type guard to check if a value is any kind of log handle. */
+function isAnyLogHandle(value) {
+	return typeof value === "string" && (value.startsWith(LIVE_LOG_PREFIX) || value.startsWith(READY_LOG_PREFIX));
+}
+/** Type guard to check if log is live, and corresponding process is not finished. */
 function isLiveLog(handle) {
-	return handle !== void 0 && handle.startsWith("log+live://log/");
+	return handle !== void 0 && handle.startsWith(LIVE_LOG_PREFIX);
 }
-
 //#endregion
-export { isLiveLog };
+export { isAnyLogHandle, isLiveLog };
+
 //# sourceMappingURL=log.js.map

package/dist/drivers/log.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"log.js","names":[],"sources":["../../src/drivers/log.ts"],"sourcesContent":["import type { Branded } from \"../branding\";\n\n/** Prefix constants — single source of truth for handle format. */\nconst LIVE_LOG_PREFIX = \"log+live://log/\";\nconst READY_LOG_PREFIX = \"log+ready://log/\";\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 = Branded<`${typeof LIVE_LOG_PREFIX}${string}`, \"LiveLogHandle\">;\n\n/** Handle of the ready logs of a program. */\nexport type ReadyLogHandle = Branded<`${typeof READY_LOG_PREFIX}${string}`, \"ReadyLogHandle\">;\n\n/** Handle of logs. This handle should be passed\n * to the driver for retrieving logs. */\nexport type AnyLogHandle = LiveLogHandle | ReadyLogHandle;\n\n/** Type guard to check if a value is any kind of log handle. */\nexport function isAnyLogHandle(value: unknown): value is AnyLogHandle {\n  return (\n    typeof value === \"string\" &&\n    (value.startsWith(LIVE_LOG_PREFIX) || value.startsWith(READY_LOG_PREFIX))\n  );\n}\n\n/** Type guard to check if log is live, and corresponding process is not finished. */\nexport function isLiveLog(handle: AnyLogHandle | undefined): handle is LiveLogHandle {\n  return handle !== undefined && handle.startsWith(LIVE_LOG_PREFIX);\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":";;AAGA,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;;AAezB,SAAgB,eAAe,OAAuC;AACpE,QACE,OAAO,UAAU,aAChB,MAAM,WAAW,gBAAgB,IAAI,MAAM,WAAW,iBAAiB;;;AAK5E,SAAgB,UAAU,QAA2D;AACnF,QAAO,WAAW,KAAA,KAAa,OAAO,WAAW,gBAAgB"}

package/dist/drivers/ls.cjs

@@ -1,5 +1,4 @@
-const require_util = require('../util.cjs');
-
+const require_util = require("../util.cjs");
 //#region src/drivers/ls.ts
 const uploadPrefix = "upload://upload/";
 const indexPrefix = "index://index/";
@@ -27,10 +26,10 @@ function extractFileName(filePath) {
 function getFileNameFromHandle(handle) {
 	return extractFileName(getFilePathFromHandle(handle));
 }
-
 //#endregion
 exports.getFileNameFromHandle = getFileNameFromHandle;
 exports.getFilePathFromHandle = getFilePathFromHandle;
 exports.isImportFileHandleIndex = isImportFileHandleIndex;
 exports.isImportFileHandleUpload = isImportFileHandleUpload;
+
 //# sourceMappingURL=ls.cjs.map

package/dist/drivers/ls.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ls.cjs","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n\n  // TODO\n  // pathStartsWithDisk\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,0BAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}
+{"version":3,"file":"ls.cjs","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n\n  // TODO\n  // pathStartsWithDisk\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,cAAA,YAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}

package/dist/drivers/ls.d.ts

@@ -1,8 +1,6 @@
 import { Branded } from "../branding.js";
 import { FileLike } from "./interfaces.js";
 import { TableRange } from "./pframe/data_types.js";
-import "./pframe/index.js";
-
 //#region src/drivers/ls.d.ts
 type ImportFileHandleUpload = `upload://upload/${string}`;
 type ImportFileHandleIndex = `index://index/${string}`;

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

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","names":[],"sources":["../../src/drivers/ls.ts"],"mappings":";;;;KAQY,sBAAA;AAAA,KACA,qBAAA;AAAA,KAEA,gBAAA,GAAmB,sBAAA,GAAyB,qBAAA;AAAA,KAE5C,qBAAA,GAAwB,OAAA,CAAQ,gBAAA;AAAA,iBAE5B,wBAAA,CACd,MAAA,EAAQ,gBAAA,GACP,MAAA,IAAU,sBAAA;AAAA,iBAIG,uBAAA,CAAwB,MAAA,EAAQ,gBAAA,GAAmB,MAAA,IAAU,qBAAA;;KAKjE,kBAAA;AAjBZ;AAAA,KAoBY,mBAAA;AAAA,KAEA,aAAA,GAAgB,kBAAA,GAAqB,mBAAA;AAAA,KAErC,YAAA;EACV,IAAA;EACA,MAAA,EAAQ,aAAA;EACR,eAAA;AAAA;AAAA,KAMU,eAAA;EACV,MAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,KAGC,OAAA;EAEN,IAAA;EACA,IAAA;EACA,QAAA;AAAA;EAGA,IAAA;EACA,IAAA;EACA,QAAA,UAxCJ;EA2CI,MAAA,EAAQ,gBAAA;AAAA;AAAA,KAGF,gBAAA;EA7CuB,6CA+CxB,IAAA,UA3C4B;EAAA,SA6C5B,UAAA;AAAA;AAAA,KAGC,aAAA;EAhD4B,wCAkD7B,KAAA,WAlDkE;EAAA,SAoDlE,WAAA,WApDuF;EAAA,SAsDvF,OAAA,GAAU,gBAAA;AAAA;AAAA,KAGT,sBAAA;EApDkB;;EAAA,SAuDnB,IAAA,GAAO,qBAAA;AAAA;AAAA,KAGN,yBAAA;EAvDmB;;EAAA,SA0DpB,KAAA,GAAQ,qBAAA;AAAA;;KAIP,SAAA;EA5DwD,2CA8DzD,IAAA,UA5Da;EAAA,SA8Db,EAAA;AAAA;AAAA,UAGM,QAAA;EA/Df;EAiEA,cAAA,IAAkB,OAAA,CAAQ,YAAA;EAE1B,SAAA,CAAU,OAAA,EAAS,aAAA,EAAe,QAAA,WAAmB,OAAA,CAAQ,eAAA;EAlE9C;EAqEf,wBAAA,CAAyB,GAAA,EAAK,aAAA,GAAgB,OAAA,CAAQ,sBAAA;EA/D5C;EAkEV,2BAAA,CAA4B,GAAA,EAAK,aAAA,GAAgB,OAAA,CAAQ,yBAAA;;EAGzD,gBAAA,CAAiB,IAAA,EAAM,qBAAA,GAAwB,OAAA;EApE/C;EAuEA,mBAAA,CAAoB,IAAA,EAAM,qBAAA,EAAuB,KAAA,GAAQ,UAAA,GAAa,OAAA,CAAQ,UAAA;EAtErE;;;AAGX;;;EA2EE,kBAAA,CAAmB,IAAA,EAAM,QAAA,GAAW,OAAA,CAAQ,gBAAA;EAzExC;EA4EJ,WAAA,KAAgB,OAAA;AAAA;;iBAIF,qBAAA,CAAsB,MAAA,EAAQ,gBAAA;;iBAmB9B,qBAAA,CAAsB,MAAA,EAAQ,gBAAA"}

package/dist/drivers/ls.js

@@ -1,5 +1,4 @@
 import { assertNever } from "../util.js";
-
 //#region src/drivers/ls.ts
 const uploadPrefix = "upload://upload/";
 const indexPrefix = "index://index/";
@@ -27,7 +26,7 @@ function extractFileName(filePath) {
 function getFileNameFromHandle(handle) {
 	return extractFileName(getFilePathFromHandle(handle));
 }
-
 //#endregion
 export { getFileNameFromHandle, getFilePathFromHandle, isImportFileHandleIndex, isImportFileHandleUpload };
+
 //# sourceMappingURL=ls.js.map

package/dist/drivers/ls.js.map

@@ -1 +1 @@
-{"version":3,"file":"ls.js","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n\n  // TODO\n  // pathStartsWithDisk\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,aAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}
+{"version":3,"file":"ls.js","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n\n  // TODO\n  // pathStartsWithDisk\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,aAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}

package/dist/drivers/pframe/column_filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_filter.d.ts","names":[],"sources":["../../../src/drivers/pframe/column_filter.ts"],"mappings":";;;;UAGiB,YAAA;EAAA;;EAAA,SAGN,IAAA,GAAO,SAAA;EAAA;;EAAA,SAIP,IAAA;EAUoB;EAAA,SAPpB,WAAA,GAAc,MAAA;EAOY;EAAA,SAJ1B,eAAA,GAAkB,MAAA;EAVX;;EAAA,SAcP,iBAAA,GAAoB,MAAA;AAAA"}

package/dist/drivers/pframe/data_info.cjs

@@ -1,5 +1,4 @@
-const require_util = require('../../util.cjs');
-
+const require_util = require("../../util.cjs");
 //#region src/drivers/pframe/data_info.ts
 /**
 * Type guard function that checks if the given value is a valid DataInfo.
@@ -220,7 +219,6 @@ function mapDataInfoEntries(dataInfoEntries, mapFn) {
 		};
 	}
 }
-
 //#endregion
 exports.dataInfoToEntries = dataInfoToEntries;
 exports.entriesToDataInfo = entriesToDataInfo;
@@ -230,4 +228,5 @@ exports.isPartitionedDataInfoEntries = isPartitionedDataInfoEntries;
 exports.mapDataInfo = mapDataInfo;
 exports.mapDataInfoEntries = mapDataInfoEntries;
 exports.visitDataInfo = visitDataInfo;
+
 //# sourceMappingURL=data_info.cjs.map

package/dist/drivers/pframe/data_info.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data_info.cjs","names":[],"sources":["../../../src/drivers/pframe/data_info.ts"],"sourcesContent":["import { assertNever } from \"../../util\";\n\n/**\n * Represents a JavaScript representation of a value in a PColumn. Can be null, a number, or a string.\n * These are the primitive types that can be stored directly in PColumns.\n *\n * Note: Actual columns can hold more value types, which are converted to these JavaScript types\n * once they enter the JavaScript runtime.\n */\nexport type PColumnValue = null | number | string;\n\n/**\n * Represents a key for a PColumn value.\n * Can be an array of strings or numbers.\n */\nexport type PColumnKey = (number | string)[];\n\n/**\n * Represents a single entry in a PColumn's data structure.\n * Contains a key and a value.\n */\nexport type PColumnDataEntry<T> = {\n  /** Key for the value */\n  key: PColumnKey;\n\n  /** Value / blob at the given key */\n  value: T;\n};\n\n/**\n * Represents column data stored as a simple JSON structure.\n * Used for small datasets that can be efficiently stored directly in memory.\n */\nexport type JsonDataInfo = {\n  /** Identifier for this data format ('Json') */\n  type: \"Json\";\n\n  /** Number of axes that make up the complete key (tuple length) */\n  keyLength: number;\n\n  /**\n   * Key-value pairs where keys are stringified tuples of axis values\n   * and values are the column values for those coordinates\n   */\n  data: Record<string, PColumnValue>;\n};\n\n/**\n * Represents column data partitioned across multiple JSON blobs.\n * Used for larger datasets that need to be split into manageable chunks.\n */\nexport type JsonPartitionedDataInfo<Blob> = {\n  /** Identifier for this data format ('JsonPartitioned') */\n  type: \"JsonPartitioned\";\n\n  /** Number of leading axes used for partitioning */\n  partitionKeyLength: number;\n\n  /** Map of stringified partition keys to blob references */\n  parts: Record<string, Blob>;\n};\n\n/**\n * Represents a binary format chunk containing index and values as separate blobs.\n * Used for efficient storage and retrieval of column data in binary format.\n */\nexport type BinaryChunk<Blob> = {\n  /** Binary blob containing structured index information */\n  index: Blob;\n\n  /** Binary blob containing the actual values */\n  values: Blob;\n};\n\n/**\n * Represents column data partitioned across multiple binary chunks.\n * Optimized for efficient storage and retrieval of large datasets.\n */\nexport type BinaryPartitionedDataInfo<Blob> = {\n  /** Identifier for this data format ('BinaryPartitioned') */\n  type: \"BinaryPartitioned\";\n\n  /** Number of leading axes used for partitioning */\n  partitionKeyLength: number;\n\n  /** Map of stringified partition keys to binary chunks */\n  parts: Record<string, BinaryChunk<Blob>>;\n};\n\nexport type ParquetChunkMappingAxis = {\n  /** Data type (matches PColumn axis types) */\n  type: \"Int\" | \"Long\" | \"String\";\n\n  /** Field name in the Parquet file */\n  id: string;\n};\n\nexport type ParquetChunkMappingColumn = {\n  /** Data type (matches PColumn value type) */\n  type: \"Int\" | \"Long\" | \"Float\" | \"Double\" | \"String\";\n\n  /** Field name in the Parquet file */\n  id: string;\n};\n\nexport type ParquetChunkMapping = {\n  /** Axes mappings - Parquet file is sorted by these fields in this order */\n  axes: ParquetChunkMappingAxis[];\n\n  /** Column mapping */\n  column: ParquetChunkMappingColumn;\n};\n\nexport type ParquetChunkStats = {\n  /** Number of rows in the chunk */\n  numberOfRows: number;\n  /** Byte size information for storage optimization and query planning */\n  size: {\n    /** Byte sizes for each axis column in the same order as axes mapping */\n    axes: number[];\n    /** Byte size for the data column */\n    column: number;\n  };\n};\n\nexport type ParquetChunkMetadata = {\n  /** Content hash calculated for the specific axes and data this chunk represents */\n  dataDigest: string;\n\n  /** Pre-computed statistics for optimization without blob download */\n  stats: Partial<ParquetChunkStats>;\n};\n\nexport type ParquetChunk<Blob> = {\n  /** Parquet file (PTable) containing column data */\n  data: Blob;\n} & ParquetChunkMapping &\n  Partial<ParquetChunkMetadata>;\n\nexport type ParquetPartitionedDataInfo<Blob> = {\n  /** Identifier for this data format ('ParquetPartitioned') */\n  type: \"ParquetPartitioned\";\n\n  /** Number of leading axes used for partitioning */\n  partitionKeyLength: number;\n\n  /** Map of stringified partition keys to parquet files */\n  parts: Record<string, Blob>;\n};\n\n/**\n * Union type representing all possible data storage formats for PColumn data.\n * The specific format used depends on data size, access patterns, and performance requirements.\n *\n * @template Blob - Type parameter representing the storage reference type (could be ResourceInfo, PFrameBlobId, etc.)\n */\nexport type DataInfo<Blob> =\n  | JsonDataInfo\n  | JsonPartitionedDataInfo<Blob>\n  | BinaryPartitionedDataInfo<Blob>\n  | ParquetPartitionedDataInfo<Blob>;\n\n/**\n * Type guard function that checks if the given value is a valid DataInfo.\n *\n * @param value - The value to check\n * @returns True if the value is a valid DataInfo, false otherwise\n */\nexport function isDataInfo<Blob>(value: unknown): value is DataInfo<Blob> {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const data = value as Record<string, unknown>;\n  if (!(\"type\" in data)) {\n    return false;\n  }\n\n  switch (data.type) {\n    case \"Json\":\n      return (\n        typeof data.keyLength === \"number\" &&\n        data.data !== undefined &&\n        typeof data.data === \"object\"\n      );\n    case \"JsonPartitioned\":\n    case \"BinaryPartitioned\":\n    case \"ParquetPartitioned\":\n      return (\n        typeof data.partitionKeyLength === \"number\" &&\n        data.parts !== undefined &&\n        typeof data.parts === \"object\"\n      );\n    default:\n      return false;\n  }\n}\n\n/**\n * Maps blob references in a DataInfo object from one type to another using a mapping function.\n *\n * @template B1 - Source blob type\n * @template B2 - Target blob type\n * @param dataInfo - The source DataInfo object\n * @param mapFn - Function to transform blobs from type B1 to type B2\n * @returns A new DataInfo object with transformed blob references\n */\nexport function mapDataInfo<B1, B2>(\n  dataInfo: ParquetPartitionedDataInfo<B1>,\n  mapFn: (blob: B1) => B2,\n): ParquetPartitionedDataInfo<B2>;\nexport function mapDataInfo<B1, B2>(\n  dataInfo: Exclude<DataInfo<B1>, ParquetPartitionedDataInfo<B1>>,\n  mapFn: (blob: B1) => B2,\n): Exclude<DataInfo<B2>, ParquetPartitionedDataInfo<B2>>;\nexport function mapDataInfo<B1, B2>(dataInfo: DataInfo<B1>, mapFn: (blob: B1) => B2): DataInfo<B2>;\nexport function mapDataInfo<B1, B2>(\n  dataInfo: DataInfo<B1> | undefined,\n  mapFn: (blob: B1) => B2,\n): DataInfo<B2> | undefined {\n  if (dataInfo === undefined) {\n    return undefined;\n  }\n\n  switch (dataInfo.type) {\n    case \"Json\":\n      // Json type doesn't contain blobs, so return as is\n      return dataInfo;\n    case \"JsonPartitioned\": {\n      // Map each blob in parts\n      const newParts: Record<string, B2> = {};\n      for (const [key, blob] of Object.entries(dataInfo.parts)) {\n        newParts[key] = mapFn(blob);\n      }\n      return {\n        ...dataInfo,\n        parts: newParts,\n      };\n    }\n    case \"BinaryPartitioned\": {\n      // Map each index and values blob in parts\n      const newParts: Record<string, BinaryChunk<B2>> = {};\n      for (const [key, chunk] of Object.entries(dataInfo.parts)) {\n        newParts[key] = {\n          index: mapFn(chunk.index),\n          values: mapFn(chunk.values),\n        };\n      }\n      return {\n        ...dataInfo,\n        parts: newParts,\n      };\n    }\n    case \"ParquetPartitioned\": {\n      // Map each blob in parts\n      const newParts: Record<string, B2> = {};\n      for (const [key, blob] of Object.entries(dataInfo.parts)) {\n        newParts[key] = mapFn(blob);\n      }\n      return {\n        ...dataInfo,\n        parts: newParts,\n      };\n    }\n  }\n}\n\n/**\n * @param dataInfo - The source DataInfo object\n * @param cb - Callback, function that have access to every blob to visit them all\n * @returns Nothing\n */\nexport function visitDataInfo<B>(dataInfo: DataInfo<B>, cb: (blob: B) => void): void {\n  switch (dataInfo.type) {\n    case \"Json\":\n      // Json type doesn't contain blobs, so return as is\n      break;\n    case \"JsonPartitioned\": {\n      // Visit each blob in parts\n      Object.values(dataInfo.parts).forEach(cb);\n      break;\n    }\n    case \"BinaryPartitioned\": {\n      // Visit each index and values blob in parts\n      Object.values(dataInfo.parts).forEach((chunk) => {\n        cb(chunk.index);\n        cb(chunk.values);\n      });\n      break;\n    }\n    case \"ParquetPartitioned\": {\n      // Visit each blob in parts\n      Object.values(dataInfo.parts).forEach(cb);\n      break;\n    }\n  }\n}\n\n//\n// Lightway representation for ExplicitJsonData\n//\n\n/**\n * Represents a single key-value entry in a column's explicit data structure.\n * Used when directly instantiating PColumns with explicit data.\n */\nexport type PColumnValuesEntry = {\n  key: PColumnKey;\n  val: PColumnValue;\n};\n\n/**\n * Array of key-value entries representing explicit column data.\n * Used for lightweight explicit instantiation of PColumns.\n */\nexport type PColumnValues = PColumnValuesEntry[];\n\n/**\n * Entry-based representation of JsonDataInfo\n */\nexport interface JsonDataInfoEntries {\n  type: \"Json\";\n  keyLength: number;\n  data: PColumnDataEntry<PColumnValue>[];\n}\n\n/**\n * Entry-based representation of JsonPartitionedDataInfo\n */\nexport interface JsonPartitionedDataInfoEntries<Blob> {\n  type: \"JsonPartitioned\";\n  partitionKeyLength: number;\n  parts: PColumnDataEntry<Blob>[];\n}\n\n/**\n * Entry-based representation of BinaryPartitionedDataInfo\n */\nexport interface BinaryPartitionedDataInfoEntries<Blob> {\n  type: \"BinaryPartitioned\";\n  partitionKeyLength: number;\n  parts: PColumnDataEntry<BinaryChunk<Blob>>[];\n}\n\n/**\n * Entry-based representation of ParquetPartitionedDataInfo\n */\nexport interface ParquetPartitionedDataInfoEntries<Blob> {\n  type: \"ParquetPartitioned\";\n  partitionKeyLength: number;\n  parts: PColumnDataEntry<Blob>[];\n}\n/**\n * Union type representing all possible entry-based partitioned data storage formats\n */\nexport type PartitionedDataInfoEntries<Blob> =\n  | JsonPartitionedDataInfoEntries<Blob>\n  | BinaryPartitionedDataInfoEntries<Blob>\n  | ParquetPartitionedDataInfoEntries<Blob>;\n\n/**\n * Union type representing all possible entry-based data storage formats\n */\nexport type DataInfoEntries<Blob> = JsonDataInfoEntries | PartitionedDataInfoEntries<Blob>;\n\n/**\n * Type guard function that checks if the given value is a valid DataInfoEntries.\n *\n * @param value - The value to check\n * @returns True if the value is a valid DataInfoEntries, false otherwise\n */\nexport function isDataInfoEntries<Blob>(value: unknown): value is DataInfoEntries<Blob> {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const data = value as Record<string, unknown>;\n  if (!(\"type\" in data)) {\n    return false;\n  }\n\n  switch (data.type) {\n    case \"Json\":\n      return typeof data.keyLength === \"number\" && Array.isArray(data.data);\n    case \"JsonPartitioned\":\n    case \"BinaryPartitioned\":\n    case \"ParquetPartitioned\":\n      return typeof data.partitionKeyLength === \"number\" && Array.isArray(data.parts);\n    default:\n      return false;\n  }\n}\n\n/**\n * Type guard function that checks if the given value is a valid PartitionedDataInfoEntries.\n *\n * @template Blob - Type parameter representing the storage reference type\n * @param value - The value to check\n * @returns True if the value is a valid PartitionedDataInfoEntries, false otherwise\n */\nexport function isPartitionedDataInfoEntries<Blob>(\n  value: unknown,\n): value is PartitionedDataInfoEntries<Blob> {\n  if (!isDataInfoEntries(value)) return false;\n  switch (value.type) {\n    case \"JsonPartitioned\":\n    case \"BinaryPartitioned\":\n    case \"ParquetPartitioned\":\n      return true;\n    default:\n      return false;\n  }\n}\n\n/**\n * Converts DataInfo to DataInfoEntries\n *\n * @param dataInfo - The record-based DataInfo object\n * @returns The equivalent entry-based DataInfoEntries object\n */\nexport function dataInfoToEntries<Blob>(dataInfo: DataInfo<Blob>): DataInfoEntries<Blob> {\n  switch (dataInfo.type) {\n    case \"Json\":\n      return {\n        type: \"Json\",\n        keyLength: dataInfo.keyLength,\n        data: Object.entries(dataInfo.data).map(([keyStr, value]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value } as PColumnDataEntry<PColumnValue>;\n        }),\n      };\n    case \"JsonPartitioned\":\n      return {\n        type: \"JsonPartitioned\",\n        partitionKeyLength: dataInfo.partitionKeyLength,\n        parts: Object.entries(dataInfo.parts).map(([keyStr, blob]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value: blob } as PColumnDataEntry<Blob>;\n        }),\n      };\n    case \"BinaryPartitioned\":\n      return {\n        type: \"BinaryPartitioned\",\n        partitionKeyLength: dataInfo.partitionKeyLength,\n        parts: Object.entries(dataInfo.parts).map(([keyStr, chunk]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value: chunk } as PColumnDataEntry<BinaryChunk<Blob>>;\n        }),\n      };\n    case \"ParquetPartitioned\":\n      return {\n        type: \"ParquetPartitioned\",\n        partitionKeyLength: dataInfo.partitionKeyLength,\n        parts: Object.entries(dataInfo.parts).map(([keyStr, blob]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value: blob } as PColumnDataEntry<Blob>;\n        }),\n      };\n    default:\n      assertNever(dataInfo);\n  }\n}\n\n/**\n * Converts DataInfoEntries to DataInfo\n *\n * @param dataInfoEntries - The entry-based DataInfoEntries object\n * @returns The equivalent record-based DataInfo object\n */\nexport function entriesToDataInfo<Blob>(dataInfoEntries: DataInfoEntries<Blob>): DataInfo<Blob> {\n  switch (dataInfoEntries.type) {\n    case \"Json\":\n      return {\n        type: \"Json\",\n        keyLength: dataInfoEntries.keyLength,\n        data: Object.fromEntries(\n          dataInfoEntries.data.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    case \"JsonPartitioned\":\n      return {\n        type: \"JsonPartitioned\",\n        partitionKeyLength: dataInfoEntries.partitionKeyLength,\n        parts: Object.fromEntries(\n          dataInfoEntries.parts.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    case \"BinaryPartitioned\":\n      return {\n        type: \"BinaryPartitioned\",\n        partitionKeyLength: dataInfoEntries.partitionKeyLength,\n        parts: Object.fromEntries(\n          dataInfoEntries.parts.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    case \"ParquetPartitioned\":\n      return {\n        type: \"ParquetPartitioned\",\n        partitionKeyLength: dataInfoEntries.partitionKeyLength,\n        parts: Object.fromEntries(\n          dataInfoEntries.parts.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    default:\n      assertNever(dataInfoEntries);\n  }\n}\n\n/**\n * Maps blob references in a DataInfoEntries object from one type to another using a mapping function.\n *\n * @template B1 - Source blob type\n * @template B2 - Target blob type\n * @param dataInfoEntries - The source DataInfoEntries object\n * @param mapFn - Function to transform blobs from type B1 to type B2\n * @returns A new DataInfoEntries object with transformed blob references\n */\nexport function mapDataInfoEntries<B1, B2>(\n  dataInfoEntries: DataInfoEntries<B1>,\n  mapFn: (blob: B1) => B2,\n): DataInfoEntries<B2>;\nexport function mapDataInfoEntries<B1, B2>(\n  dataInfoEntries: DataInfoEntries<B1> | undefined,\n  mapFn: (blob: B1) => B2,\n): DataInfoEntries<B2> | undefined {\n  if (dataInfoEntries === undefined) {\n    return undefined;\n  }\n\n  switch (dataInfoEntries.type) {\n    case \"Json\":\n      // Json type doesn't contain blobs, so return as is\n      return dataInfoEntries;\n    case \"JsonPartitioned\":\n      return {\n        ...dataInfoEntries,\n        parts: dataInfoEntries.parts.map((entry) => ({\n          key: entry.key,\n          value: mapFn(entry.value),\n        })),\n      };\n    case \"BinaryPartitioned\":\n      return {\n        ...dataInfoEntries,\n        parts: dataInfoEntries.parts.map((entry) => ({\n          key: entry.key,\n          value: {\n            index: mapFn(entry.value.index),\n            values: mapFn(entry.value.values),\n          },\n        })),\n      };\n    case \"ParquetPartitioned\":\n      return {\n        ...dataInfoEntries,\n        parts: dataInfoEntries.parts.map((entry) => ({\n          key: entry.key,\n          value: mapFn(entry.value),\n        })),\n      };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"data_info.cjs","names":[],"sources":["../../../src/drivers/pframe/data_info.ts"],"sourcesContent":["import { assertNever } from \"../../util\";\n\n/**\n * Represents a JavaScript representation of a value in a PColumn. Can be null, a number, or a string.\n * These are the primitive types that can be stored directly in PColumns.\n *\n * Note: Actual columns can hold more value types, which are converted to these JavaScript types\n * once they enter the JavaScript runtime.\n */\nexport type PColumnValue = null | number | string;\n\n/**\n * Represents a key for a PColumn value.\n * Can be an array of strings or numbers.\n */\nexport type PColumnKey = (number | string)[];\n\n/**\n * Represents a single entry in a PColumn's data structure.\n * Contains a key and a value.\n */\nexport type PColumnDataEntry<T> = {\n  /** Key for the value */\n  key: PColumnKey;\n\n  /** Value / blob at the given key */\n  value: T;\n};\n\n/**\n * Represents column data stored as a simple JSON structure.\n * Used for small datasets that can be efficiently stored directly in memory.\n */\nexport type JsonDataInfo = {\n  /** Identifier for this data format ('Json') */\n  type: \"Json\";\n\n  /** Number of axes that make up the complete key (tuple length) */\n  keyLength: number;\n\n  /**\n   * Key-value pairs where keys are stringified tuples of axis values\n   * and values are the column values for those coordinates\n   */\n  data: Record<string, PColumnValue>;\n};\n\n/**\n * Represents column data partitioned across multiple JSON blobs.\n * Used for larger datasets that need to be split into manageable chunks.\n */\nexport type JsonPartitionedDataInfo<Blob> = {\n  /** Identifier for this data format ('JsonPartitioned') */\n  type: \"JsonPartitioned\";\n\n  /** Number of leading axes used for partitioning */\n  partitionKeyLength: number;\n\n  /** Map of stringified partition keys to blob references */\n  parts: Record<string, Blob>;\n};\n\n/**\n * Represents a binary format chunk containing index and values as separate blobs.\n * Used for efficient storage and retrieval of column data in binary format.\n */\nexport type BinaryChunk<Blob> = {\n  /** Binary blob containing structured index information */\n  index: Blob;\n\n  /** Binary blob containing the actual values */\n  values: Blob;\n};\n\n/**\n * Represents column data partitioned across multiple binary chunks.\n * Optimized for efficient storage and retrieval of large datasets.\n */\nexport type BinaryPartitionedDataInfo<Blob> = {\n  /** Identifier for this data format ('BinaryPartitioned') */\n  type: \"BinaryPartitioned\";\n\n  /** Number of leading axes used for partitioning */\n  partitionKeyLength: number;\n\n  /** Map of stringified partition keys to binary chunks */\n  parts: Record<string, BinaryChunk<Blob>>;\n};\n\nexport type ParquetChunkMappingAxis = {\n  /** Data type (matches PColumn axis types) */\n  type: \"Int\" | \"Long\" | \"String\";\n\n  /** Field name in the Parquet file */\n  id: string;\n};\n\nexport type ParquetChunkMappingColumn = {\n  /** Data type (matches PColumn value type) */\n  type: \"Int\" | \"Long\" | \"Float\" | \"Double\" | \"String\";\n\n  /** Field name in the Parquet file */\n  id: string;\n};\n\nexport type ParquetChunkMapping = {\n  /** Axes mappings - Parquet file is sorted by these fields in this order */\n  axes: ParquetChunkMappingAxis[];\n\n  /** Column mapping */\n  column: ParquetChunkMappingColumn;\n};\n\nexport type ParquetChunkStats = {\n  /** Number of rows in the chunk */\n  numberOfRows: number;\n  /** Byte size information for storage optimization and query planning */\n  size: {\n    /** Byte sizes for each axis column in the same order as axes mapping */\n    axes: number[];\n    /** Byte size for the data column */\n    column: number;\n  };\n};\n\nexport type ParquetChunkMetadata = {\n  /** Content hash calculated for the specific axes and data this chunk represents */\n  dataDigest: string;\n\n  /** Pre-computed statistics for optimization without blob download */\n  stats: Partial<ParquetChunkStats>;\n};\n\nexport type ParquetChunk<Blob> = {\n  /** Parquet file (PTable) containing column data */\n  data: Blob;\n} & ParquetChunkMapping &\n  Partial<ParquetChunkMetadata>;\n\nexport type ParquetPartitionedDataInfo<Blob> = {\n  /** Identifier for this data format ('ParquetPartitioned') */\n  type: \"ParquetPartitioned\";\n\n  /** Number of leading axes used for partitioning */\n  partitionKeyLength: number;\n\n  /** Map of stringified partition keys to parquet files */\n  parts: Record<string, Blob>;\n};\n\n/**\n * Union type representing all possible data storage formats for PColumn data.\n * The specific format used depends on data size, access patterns, and performance requirements.\n *\n * @template Blob - Type parameter representing the storage reference type (could be ResourceInfo, PFrameBlobId, etc.)\n */\nexport type DataInfo<Blob> =\n  | JsonDataInfo\n  | JsonPartitionedDataInfo<Blob>\n  | BinaryPartitionedDataInfo<Blob>\n  | ParquetPartitionedDataInfo<Blob>;\n\n/**\n * Type guard function that checks if the given value is a valid DataInfo.\n *\n * @param value - The value to check\n * @returns True if the value is a valid DataInfo, false otherwise\n */\nexport function isDataInfo<Blob>(value: unknown): value is DataInfo<Blob> {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const data = value as Record<string, unknown>;\n  if (!(\"type\" in data)) {\n    return false;\n  }\n\n  switch (data.type) {\n    case \"Json\":\n      return (\n        typeof data.keyLength === \"number\" &&\n        data.data !== undefined &&\n        typeof data.data === \"object\"\n      );\n    case \"JsonPartitioned\":\n    case \"BinaryPartitioned\":\n    case \"ParquetPartitioned\":\n      return (\n        typeof data.partitionKeyLength === \"number\" &&\n        data.parts !== undefined &&\n        typeof data.parts === \"object\"\n      );\n    default:\n      return false;\n  }\n}\n\n/**\n * Maps blob references in a DataInfo object from one type to another using a mapping function.\n *\n * @template B1 - Source blob type\n * @template B2 - Target blob type\n * @param dataInfo - The source DataInfo object\n * @param mapFn - Function to transform blobs from type B1 to type B2\n * @returns A new DataInfo object with transformed blob references\n */\nexport function mapDataInfo<B1, B2>(\n  dataInfo: ParquetPartitionedDataInfo<B1>,\n  mapFn: (blob: B1) => B2,\n): ParquetPartitionedDataInfo<B2>;\nexport function mapDataInfo<B1, B2>(\n  dataInfo: Exclude<DataInfo<B1>, ParquetPartitionedDataInfo<B1>>,\n  mapFn: (blob: B1) => B2,\n): Exclude<DataInfo<B2>, ParquetPartitionedDataInfo<B2>>;\nexport function mapDataInfo<B1, B2>(dataInfo: DataInfo<B1>, mapFn: (blob: B1) => B2): DataInfo<B2>;\nexport function mapDataInfo<B1, B2>(\n  dataInfo: DataInfo<B1> | undefined,\n  mapFn: (blob: B1) => B2,\n): DataInfo<B2> | undefined {\n  if (dataInfo === undefined) {\n    return undefined;\n  }\n\n  switch (dataInfo.type) {\n    case \"Json\":\n      // Json type doesn't contain blobs, so return as is\n      return dataInfo;\n    case \"JsonPartitioned\": {\n      // Map each blob in parts\n      const newParts: Record<string, B2> = {};\n      for (const [key, blob] of Object.entries(dataInfo.parts)) {\n        newParts[key] = mapFn(blob);\n      }\n      return {\n        ...dataInfo,\n        parts: newParts,\n      };\n    }\n    case \"BinaryPartitioned\": {\n      // Map each index and values blob in parts\n      const newParts: Record<string, BinaryChunk<B2>> = {};\n      for (const [key, chunk] of Object.entries(dataInfo.parts)) {\n        newParts[key] = {\n          index: mapFn(chunk.index),\n          values: mapFn(chunk.values),\n        };\n      }\n      return {\n        ...dataInfo,\n        parts: newParts,\n      };\n    }\n    case \"ParquetPartitioned\": {\n      // Map each blob in parts\n      const newParts: Record<string, B2> = {};\n      for (const [key, blob] of Object.entries(dataInfo.parts)) {\n        newParts[key] = mapFn(blob);\n      }\n      return {\n        ...dataInfo,\n        parts: newParts,\n      };\n    }\n  }\n}\n\n/**\n * @param dataInfo - The source DataInfo object\n * @param cb - Callback, function that have access to every blob to visit them all\n * @returns Nothing\n */\nexport function visitDataInfo<B>(dataInfo: DataInfo<B>, cb: (blob: B) => void): void {\n  switch (dataInfo.type) {\n    case \"Json\":\n      // Json type doesn't contain blobs, so return as is\n      break;\n    case \"JsonPartitioned\": {\n      // Visit each blob in parts\n      Object.values(dataInfo.parts).forEach(cb);\n      break;\n    }\n    case \"BinaryPartitioned\": {\n      // Visit each index and values blob in parts\n      Object.values(dataInfo.parts).forEach((chunk) => {\n        cb(chunk.index);\n        cb(chunk.values);\n      });\n      break;\n    }\n    case \"ParquetPartitioned\": {\n      // Visit each blob in parts\n      Object.values(dataInfo.parts).forEach(cb);\n      break;\n    }\n  }\n}\n\n//\n// Lightway representation for ExplicitJsonData\n//\n\n/**\n * Represents a single key-value entry in a column's explicit data structure.\n * Used when directly instantiating PColumns with explicit data.\n */\nexport type PColumnValuesEntry = {\n  key: PColumnKey;\n  val: PColumnValue;\n};\n\n/**\n * Array of key-value entries representing explicit column data.\n * Used for lightweight explicit instantiation of PColumns.\n */\nexport type PColumnValues = PColumnValuesEntry[];\n\n/**\n * Entry-based representation of JsonDataInfo\n */\nexport interface JsonDataInfoEntries {\n  type: \"Json\";\n  keyLength: number;\n  data: PColumnDataEntry<PColumnValue>[];\n}\n\n/**\n * Entry-based representation of JsonPartitionedDataInfo\n */\nexport interface JsonPartitionedDataInfoEntries<Blob> {\n  type: \"JsonPartitioned\";\n  partitionKeyLength: number;\n  parts: PColumnDataEntry<Blob>[];\n}\n\n/**\n * Entry-based representation of BinaryPartitionedDataInfo\n */\nexport interface BinaryPartitionedDataInfoEntries<Blob> {\n  type: \"BinaryPartitioned\";\n  partitionKeyLength: number;\n  parts: PColumnDataEntry<BinaryChunk<Blob>>[];\n}\n\n/**\n * Entry-based representation of ParquetPartitionedDataInfo\n */\nexport interface ParquetPartitionedDataInfoEntries<Blob> {\n  type: \"ParquetPartitioned\";\n  partitionKeyLength: number;\n  parts: PColumnDataEntry<Blob>[];\n}\n/**\n * Union type representing all possible entry-based partitioned data storage formats\n */\nexport type PartitionedDataInfoEntries<Blob> =\n  | JsonPartitionedDataInfoEntries<Blob>\n  | BinaryPartitionedDataInfoEntries<Blob>\n  | ParquetPartitionedDataInfoEntries<Blob>;\n\n/**\n * Union type representing all possible entry-based data storage formats\n */\nexport type DataInfoEntries<Blob> = JsonDataInfoEntries | PartitionedDataInfoEntries<Blob>;\n\n/**\n * Type guard function that checks if the given value is a valid DataInfoEntries.\n *\n * @param value - The value to check\n * @returns True if the value is a valid DataInfoEntries, false otherwise\n */\nexport function isDataInfoEntries<Blob>(value: unknown): value is DataInfoEntries<Blob> {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const data = value as Record<string, unknown>;\n  if (!(\"type\" in data)) {\n    return false;\n  }\n\n  switch (data.type) {\n    case \"Json\":\n      return typeof data.keyLength === \"number\" && Array.isArray(data.data);\n    case \"JsonPartitioned\":\n    case \"BinaryPartitioned\":\n    case \"ParquetPartitioned\":\n      return typeof data.partitionKeyLength === \"number\" && Array.isArray(data.parts);\n    default:\n      return false;\n  }\n}\n\n/**\n * Type guard function that checks if the given value is a valid PartitionedDataInfoEntries.\n *\n * @template Blob - Type parameter representing the storage reference type\n * @param value - The value to check\n * @returns True if the value is a valid PartitionedDataInfoEntries, false otherwise\n */\nexport function isPartitionedDataInfoEntries<Blob>(\n  value: unknown,\n): value is PartitionedDataInfoEntries<Blob> {\n  if (!isDataInfoEntries(value)) return false;\n  switch (value.type) {\n    case \"JsonPartitioned\":\n    case \"BinaryPartitioned\":\n    case \"ParquetPartitioned\":\n      return true;\n    default:\n      return false;\n  }\n}\n\n/**\n * Converts DataInfo to DataInfoEntries\n *\n * @param dataInfo - The record-based DataInfo object\n * @returns The equivalent entry-based DataInfoEntries object\n */\nexport function dataInfoToEntries<Blob>(dataInfo: DataInfo<Blob>): DataInfoEntries<Blob> {\n  switch (dataInfo.type) {\n    case \"Json\":\n      return {\n        type: \"Json\",\n        keyLength: dataInfo.keyLength,\n        data: Object.entries(dataInfo.data).map(([keyStr, value]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value } as PColumnDataEntry<PColumnValue>;\n        }),\n      };\n    case \"JsonPartitioned\":\n      return {\n        type: \"JsonPartitioned\",\n        partitionKeyLength: dataInfo.partitionKeyLength,\n        parts: Object.entries(dataInfo.parts).map(([keyStr, blob]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value: blob } as PColumnDataEntry<Blob>;\n        }),\n      };\n    case \"BinaryPartitioned\":\n      return {\n        type: \"BinaryPartitioned\",\n        partitionKeyLength: dataInfo.partitionKeyLength,\n        parts: Object.entries(dataInfo.parts).map(([keyStr, chunk]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value: chunk } as PColumnDataEntry<BinaryChunk<Blob>>;\n        }),\n      };\n    case \"ParquetPartitioned\":\n      return {\n        type: \"ParquetPartitioned\",\n        partitionKeyLength: dataInfo.partitionKeyLength,\n        parts: Object.entries(dataInfo.parts).map(([keyStr, blob]) => {\n          const key = JSON.parse(keyStr) as PColumnKey;\n          return { key, value: blob } as PColumnDataEntry<Blob>;\n        }),\n      };\n    default:\n      assertNever(dataInfo);\n  }\n}\n\n/**\n * Converts DataInfoEntries to DataInfo\n *\n * @param dataInfoEntries - The entry-based DataInfoEntries object\n * @returns The equivalent record-based DataInfo object\n */\nexport function entriesToDataInfo<Blob>(dataInfoEntries: DataInfoEntries<Blob>): DataInfo<Blob> {\n  switch (dataInfoEntries.type) {\n    case \"Json\":\n      return {\n        type: \"Json\",\n        keyLength: dataInfoEntries.keyLength,\n        data: Object.fromEntries(\n          dataInfoEntries.data.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    case \"JsonPartitioned\":\n      return {\n        type: \"JsonPartitioned\",\n        partitionKeyLength: dataInfoEntries.partitionKeyLength,\n        parts: Object.fromEntries(\n          dataInfoEntries.parts.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    case \"BinaryPartitioned\":\n      return {\n        type: \"BinaryPartitioned\",\n        partitionKeyLength: dataInfoEntries.partitionKeyLength,\n        parts: Object.fromEntries(\n          dataInfoEntries.parts.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    case \"ParquetPartitioned\":\n      return {\n        type: \"ParquetPartitioned\",\n        partitionKeyLength: dataInfoEntries.partitionKeyLength,\n        parts: Object.fromEntries(\n          dataInfoEntries.parts.map(({ key, value }) => [JSON.stringify(key), value]),\n        ),\n      };\n    default:\n      assertNever(dataInfoEntries);\n  }\n}\n\n/**\n * Maps blob references in a DataInfoEntries object from one type to another using a mapping function.\n *\n * @template B1 - Source blob type\n * @template B2 - Target blob type\n * @param dataInfoEntries - The source DataInfoEntries object\n * @param mapFn - Function to transform blobs from type B1 to type B2\n * @returns A new DataInfoEntries object with transformed blob references\n */\nexport function mapDataInfoEntries<B1, B2>(\n  dataInfoEntries: DataInfoEntries<B1>,\n  mapFn: (blob: B1) => B2,\n): DataInfoEntries<B2>;\nexport function mapDataInfoEntries<B1, B2>(\n  dataInfoEntries: DataInfoEntries<B1> | undefined,\n  mapFn: (blob: B1) => B2,\n): DataInfoEntries<B2> | undefined {\n  if (dataInfoEntries === undefined) {\n    return undefined;\n  }\n\n  switch (dataInfoEntries.type) {\n    case \"Json\":\n      // Json type doesn't contain blobs, so return as is\n      return dataInfoEntries;\n    case \"JsonPartitioned\":\n      return {\n        ...dataInfoEntries,\n        parts: dataInfoEntries.parts.map((entry) => ({\n          key: entry.key,\n          value: mapFn(entry.value),\n        })),\n      };\n    case \"BinaryPartitioned\":\n      return {\n        ...dataInfoEntries,\n        parts: dataInfoEntries.parts.map((entry) => ({\n          key: entry.key,\n          value: {\n            index: mapFn(entry.value.index),\n            values: mapFn(entry.value.values),\n          },\n        })),\n      };\n    case \"ParquetPartitioned\":\n      return {\n        ...dataInfoEntries,\n        parts: dataInfoEntries.parts.map((entry) => ({\n          key: entry.key,\n          value: mapFn(entry.value),\n        })),\n      };\n  }\n}\n"],"mappings":"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"}

package/dist/drivers/pframe/data_info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_info.d.ts","names":[],"sources":["../../../src/drivers/pframe/data_info.ts"],"mappings":"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"}

package/dist/drivers/pframe/data_info.js

@@ -1,5 +1,4 @@
 import { assertNever } from "../../util.js";
-
 //#region src/drivers/pframe/data_info.ts
 /**
 * Type guard function that checks if the given value is a valid DataInfo.
@@ -220,7 +219,7 @@ function mapDataInfoEntries(dataInfoEntries, mapFn) {
 		};
 	}
 }
-
 //#endregion
 export { dataInfoToEntries, entriesToDataInfo, isDataInfo, isDataInfoEntries, isPartitionedDataInfoEntries, mapDataInfo, mapDataInfoEntries, visitDataInfo };
+
 //# sourceMappingURL=data_info.js.map