@milaboratories/pl-model-common 1.46.1 → 1.46.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,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"}
+{"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\n/**\n * Operational metrics of the blob download driver.\n */\nexport type BlobDriverMetrics = {\n  /** Downloads that bypassed the ranges (sparse) cache. Counted when issued, so failed downloads still count. */\n  uncachedRequests: number;\n  /** Bytes actually streamed off the wire on the uncached path. */\n  uncachedRequestBytes: number;\n  /** Currently active remote downloads. */\n  downloadsInFlight: number;\n  /** Sum of known sizes of active downloads — progress-bar denominator. */\n  inFlightBytesTotal: number;\n  /** Sum of bytes received so far across active downloads — progress-bar numerator. */\n  inFlightBytesReceived: number;\n  /** Cached presigned URL was used and the download started successfully (one gRPC sign call avoided). */\n  presignedUrlCacheHits: number;\n  /** No cached presigned URL; a fresh one was fetched. */\n  presignedUrlCacheMisses: number;\n  /** Cached presigned URL was rejected (HTTP 400) and re-fetched — signals the TTL safety margin is too loose. */\n  presignedUrlStaleHits: number;\n  /** Total latency of presigned-URL fetch calls (misses + stale hits); divide by their count for the mean cost a hit avoids. */\n  presignedUrlRequestSumLatencyMs: number;\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

@@ -53,6 +53,20 @@ interface BlobDriver {
    */
   getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
 }
+/**
+ * Operational metrics of the blob download driver.
+ */
+type BlobDriverMetrics = {
+  /** Downloads that bypassed the ranges (sparse) cache. Counted when issued, so failed downloads still count. */uncachedRequests: number; /** Bytes actually streamed off the wire on the uncached path. */
+  uncachedRequestBytes: number; /** Currently active remote downloads. */
+  downloadsInFlight: number; /** Sum of known sizes of active downloads — progress-bar denominator. */
+  inFlightBytesTotal: number; /** Sum of bytes received so far across active downloads — progress-bar numerator. */
+  inFlightBytesReceived: number; /** Cached presigned URL was used and the download started successfully (one gRPC sign call avoided). */
+  presignedUrlCacheHits: number; /** No cached presigned URL; a fresh one was fetched. */
+  presignedUrlCacheMisses: number; /** Cached presigned URL was rejected (HTTP 400) and re-fetched — signals the TTL safety margin is too loose. */
+  presignedUrlStaleHits: number; /** Total latency of presigned-URL fetch calls (misses + stale hits); divide by their count for the mean cost a hit avoids. */
+  presignedUrlRequestSumLatencyMs: number;
+};
 //#endregion
-export { BlobDriver, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes };
+export { BlobDriver, BlobDriverMetrics, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes };
 //# sourceMappingURL=blob.d.ts.map

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

@@ -1 +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"}
+{"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;;;AA9CtF;KAoDY,iBAAA;iHAEV,gBAAA,UAtDuB;EAwDvB,oBAAA,UAxDsC;EA0DtC,iBAAA,UA1DgD;EA4DhD,kBAAA,UA1D8B;EA4D9B,qBAAA,UA5DsE;EA8DtE,qBAAA,UA9D8C;EAgE9C,uBAAA,UAhEsE;EAkEtE,qBAAA,UAvDc;EAyDd,+BAAA;AAAA"}

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,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"}
+{"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\n/**\n * Operational metrics of the blob download driver.\n */\nexport type BlobDriverMetrics = {\n  /** Downloads that bypassed the ranges (sparse) cache. Counted when issued, so failed downloads still count. */\n  uncachedRequests: number;\n  /** Bytes actually streamed off the wire on the uncached path. */\n  uncachedRequestBytes: number;\n  /** Currently active remote downloads. */\n  downloadsInFlight: number;\n  /** Sum of known sizes of active downloads — progress-bar denominator. */\n  inFlightBytesTotal: number;\n  /** Sum of bytes received so far across active downloads — progress-bar numerator. */\n  inFlightBytesReceived: number;\n  /** Cached presigned URL was used and the download started successfully (one gRPC sign call avoided). */\n  presignedUrlCacheHits: number;\n  /** No cached presigned URL; a fresh one was fetched. */\n  presignedUrlCacheMisses: number;\n  /** Cached presigned URL was rejected (HTTP 400) and re-fetched — signals the TTL safety margin is too loose. */\n  presignedUrlStaleHits: number;\n  /** Total latency of presigned-URL fetch calls (misses + stale hits); divide by their count for the mean cost a hit avoids. */\n  presignedUrlRequestSumLatencyMs: number;\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.d.ts

@@ -15,7 +15,7 @@ import { BuildQueryInput, ColumnAxesWithQualifications, DeleteColumnRequest, Del
 import { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredPColumnId, AnchoredPColumnSelector, AxisQualification, LegacyAxisSelector, PColumnSelector, SingleAxisSelector, isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./pframe/spec/selectors.js";
 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 { BlobDriver, BlobDriverMetrics, 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, isAnyLogHandle, isLiveLog } from "./log.js";
 import { ColumnFilter } from "./pframe/column_filter.js";

package/dist/index.d.ts

@@ -23,7 +23,7 @@ import { BuildQueryInput, ColumnAxesWithQualifications, DeleteColumnRequest, Del
 import { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredPColumnId, AnchoredPColumnSelector, AxisQualification, LegacyAxisSelector, PColumnSelector, SingleAxisSelector, isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./drivers/pframe/spec/selectors.js";
 import { BlobLike, FileLike } from "./drivers/interfaces.js";
 import { ArchiveFormat, BlobToURLDriver, BlockUIURL, FolderURL, FrontendDriver, isBlockUIURL, isFolderURL } from "./drivers/urls.js";
-import { BlobDriver, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes } from "./drivers/blob.js";
+import { BlobDriver, BlobDriverMetrics, BlobHandleAndSize, ContentHandler, GetContentOptions, LocalBlobHandle, LocalBlobHandleAndSize, RangeBytes, RemoteBlobHandle, RemoteBlobHandleAndSize, newRangeBytesOpt, validateRangeBytes } from "./drivers/blob.js";
 import { ImportProgress, ImportStatus } from "./drivers/upload.js";
 import { AnyLogHandle, LiveLogHandle, LogsDriver, ProgressLogWithInfo, ReadyLogHandle, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, isAnyLogHandle, isLiveLog } from "./drivers/log.js";
 import { ColumnFilter } from "./drivers/pframe/column_filter.js";
@@ -64,4 +64,4 @@ import { assertNever, uniqueBy } from "./util.js";
 import { BasicHttpAuth, HttpAuth, parseHttpAuth, serializeHttpAuth } from "./httpAuth.js";
 import { ResourceTypeName, ResourceTypePrefix } from "./resource_types.js";
 import { ProjectId } from "./project_id.js";
-export { AAxisSelector, ADomain, AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyFunction, AnyLogHandle, ArchiveFormat, ArrayTypeUnion, ArtificialColumnJoinEntry, Assert, AssertKeysEqual, AuthorMarker, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, Base64Compatible, Base64Encoded, BasicHttpAuth, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags, BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockOutputsBase, BlockRenderingMode, BlockSection, BlockSectionDelimiter, BlockSectionLink, BlockSectionLinkAppearance, BlockState, BlockStateV3, BlockUIURL, Branded, BuildQueryInput, CalculateTableDataRequest, CalculateTableDataResponse, CanonicalizedJson, ChunkedStreamReader, ChunkedStreamReaderOptions, Code, ColumnAxesWithQualifications, ColumnFilter, ColumnJoinEntry, ColumnValueType, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, CreateEnrichmentRefOptions, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DataQueryTransformColumns, DatasetInput, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, DriverKit, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, ErrorHandlerStatus, EvaluateQueryResponse, ExportPTableOptions, FileFilter, FileLike, FileRange, FilterKeysByPrefix, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, HttpAuth, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, IncompatibleFlagsError, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InferServiceKind, InferServiceModel, InferServiceUi, InlineColumnJoinEntry, InnerJoin, Is, IsSubtypeOf, JoinEntry, JsonCompatible, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, JsonSerializable, KnownServiceName, LabeledEnrichmentRef, LabeledEnrichmentRefs, LegacyAxisSelector, LinkerMap, ListFilesResult, ListOptionBase, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LogsDriver, LsDriver, LsEntry, MODEL_SERVICE_METHOD_MAP, MatcherMap, Metadata, MetadataJson, ModelServiceFactoryMap, ModelServiceRegistry, ModelServices, MultiAxisSelector, MultiColumnSelector, NativePObjectId, NavigationState, NodeServiceHandlerMap, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, Option, OuterJoin, OutputWithStatus, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnKey, PColumnLazy, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameDriverError, PFrameError, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PFrameSpecDriverError, PObject, PObjectId, PObjectSpec, PSpecPredicate, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntry, PoolEntryGuard, PrimaryRef, ProgressLogWithInfo, ProjectId, REQUIRES_PFRAMES_VERSION, RangeBytes, ReadyLogHandle, Ref, RemoteBlobHandle, RemoteBlobHandleAndSize, RequireServices, ResolveAnchorsOptions, ResourceTypeName, ResourceTypePrefix, ResultCollection, ResultOrError, ResultPoolEntry, RootFilterSpec, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, SUniversalPColumnId, SerializedError, ServiceAlreadyRegisteredError, ServiceBrand, ServiceDispatch, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceName, ServiceNameLiterals, ServiceNotRegisteredError, ServiceRequireFlags, ServiceType, ServiceTypesLike, Services, ShowSaveDialogOptions, ShowSaveDialogResult, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, SpecQueryTransformColumns, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, StringifiedJson, SupportedRequirement, TableRange, Trace, TraceEntry, UiError, UiServiceFactoryMap, UiServiceRegistry, UiServices, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, ValueOrError, ValueType, ValueTypeSupported, ValueWithUTag, ValueWithUTagAndAuthor, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, assertNever, base64Decode, base64Encode, bigintReplacer, buildServiceInfo, canonicalizeAxisId, canonicalizeAxisWithParents, canonicalizeJson, checkBlockFlag, collectSpecQueryColumns, createDiscoveredPColumnId, createEnrichmentRef, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, distillDiscoveredPColumn, ensureError, ensurePColumn, entriesToDataInfo, executePSpecPredicate, extractAllColumns, extractAllRequirements, extractAllSupports, extractCodeWithInfo, extractConfigGeneric, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getMethodNames, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getServiceKind, getServiceModelMethods, getServiceUiMethods, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, hasAbortError, isAbortError, isAggregateError, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isDataInfo, isDataInfoEntries, isDiscoveredPColumn, isEnrichmentRef, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isKnownServiceName, isLabelColumn, isLinkerColumn, isLiveLog, isMainService, isNodeService, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, isPFrameDriverError, isPFrameError, isPFrameSpecDriverError, isPTableNA, isPartitionedDataInfoEntries, isPlRef, isPrimaryRef, isServiceAlreadyRegisteredError, isServiceError, isServiceInjectionError, isServiceInvalidIdError, isServiceMethodNotFoundError, isServiceNotRegisteredError, isValueNA, isWasmService, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPObjectData, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, mapValueInVOE, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnId, parseDiscoveredPColumnId, parseHttpAuth, parseJson, parseJsonSafely, plId, plRefsEqual, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, registerServiceCapabilities, resolveAnchors, resolveAnnotationParents, resolveNodeServiceHandler, resolveRequiredServices, serializeError, serializeHttpAuth, serializeResult, service, serviceFnKey, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnId, stringifyDiscoveredPColumnId, stringifyJson, traverseQuerySpec, uniqueBy, uniquePlId, unwrapResult, validateRangeBytes, visitDataInfo, withEnrichments, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback };
+export { AAxisSelector, ADomain, AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyFunction, AnyLogHandle, ArchiveFormat, ArrayTypeUnion, ArtificialColumnJoinEntry, Assert, AssertKeysEqual, AuthorMarker, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, Base64Compatible, Base64Encoded, BasicHttpAuth, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobDriverMetrics, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags, BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockOutputsBase, BlockRenderingMode, BlockSection, BlockSectionDelimiter, BlockSectionLink, BlockSectionLinkAppearance, BlockState, BlockStateV3, BlockUIURL, Branded, BuildQueryInput, CalculateTableDataRequest, CalculateTableDataResponse, CanonicalizedJson, ChunkedStreamReader, ChunkedStreamReaderOptions, Code, ColumnAxesWithQualifications, ColumnFilter, ColumnJoinEntry, ColumnValueType, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, CreateEnrichmentRefOptions, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DataQueryTransformColumns, DatasetInput, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, DriverKit, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, ErrorHandlerStatus, EvaluateQueryResponse, ExportPTableOptions, FileFilter, FileLike, FileRange, FilterKeysByPrefix, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, HttpAuth, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, IncompatibleFlagsError, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InferServiceKind, InferServiceModel, InferServiceUi, InlineColumnJoinEntry, InnerJoin, Is, IsSubtypeOf, JoinEntry, JsonCompatible, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, JsonSerializable, KnownServiceName, LabeledEnrichmentRef, LabeledEnrichmentRefs, LegacyAxisSelector, LinkerMap, ListFilesResult, ListOptionBase, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LogsDriver, LsDriver, LsEntry, MODEL_SERVICE_METHOD_MAP, MatcherMap, Metadata, MetadataJson, ModelServiceFactoryMap, ModelServiceRegistry, ModelServices, MultiAxisSelector, MultiColumnSelector, NativePObjectId, NavigationState, NodeServiceHandlerMap, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, Option, OuterJoin, OutputWithStatus, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnKey, PColumnLazy, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameDriverError, PFrameError, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PFrameSpecDriverError, PObject, PObjectId, PObjectSpec, PSpecPredicate, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntry, PoolEntryGuard, PrimaryRef, ProgressLogWithInfo, ProjectId, REQUIRES_PFRAMES_VERSION, RangeBytes, ReadyLogHandle, Ref, RemoteBlobHandle, RemoteBlobHandleAndSize, RequireServices, ResolveAnchorsOptions, ResourceTypeName, ResourceTypePrefix, ResultCollection, ResultOrError, ResultPoolEntry, RootFilterSpec, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, SUniversalPColumnId, SerializedError, ServiceAlreadyRegisteredError, ServiceBrand, ServiceDispatch, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceName, ServiceNameLiterals, ServiceNotRegisteredError, ServiceRequireFlags, ServiceType, ServiceTypesLike, Services, ShowSaveDialogOptions, ShowSaveDialogResult, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, SpecQueryTransformColumns, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, StringifiedJson, SupportedRequirement, TableRange, Trace, TraceEntry, UiError, UiServiceFactoryMap, UiServiceRegistry, UiServices, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, ValueOrError, ValueType, ValueTypeSupported, ValueWithUTag, ValueWithUTagAndAuthor, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, assertNever, base64Decode, base64Encode, bigintReplacer, buildServiceInfo, canonicalizeAxisId, canonicalizeAxisWithParents, canonicalizeJson, checkBlockFlag, collectSpecQueryColumns, createDiscoveredPColumnId, createEnrichmentRef, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, distillDiscoveredPColumn, ensureError, ensurePColumn, entriesToDataInfo, executePSpecPredicate, extractAllColumns, extractAllRequirements, extractAllSupports, extractCodeWithInfo, extractConfigGeneric, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getMethodNames, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getServiceKind, getServiceModelMethods, getServiceUiMethods, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, hasAbortError, isAbortError, isAggregateError, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isDataInfo, isDataInfoEntries, isDiscoveredPColumn, isEnrichmentRef, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isKnownServiceName, isLabelColumn, isLinkerColumn, isLiveLog, isMainService, isNodeService, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, isPFrameDriverError, isPFrameError, isPFrameSpecDriverError, isPTableNA, isPartitionedDataInfoEntries, isPlRef, isPrimaryRef, isServiceAlreadyRegisteredError, isServiceError, isServiceInjectionError, isServiceInvalidIdError, isServiceMethodNotFoundError, isServiceNotRegisteredError, isValueNA, isWasmService, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPObjectData, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, mapValueInVOE, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnId, parseDiscoveredPColumnId, parseHttpAuth, parseJson, parseJsonSafely, plId, plRefsEqual, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, registerServiceCapabilities, resolveAnchors, resolveAnnotationParents, resolveNodeServiceHandler, resolveRequiredServices, serializeError, serializeHttpAuth, serializeResult, service, serviceFnKey, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnId, stringifyDiscoveredPColumnId, stringifyJson, traverseQuerySpec, uniqueBy, uniquePlId, unwrapResult, validateRangeBytes, visitDataInfo, withEnrichments, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.46.1",
+  "version": "1.46.2",
   "description": "Platforma SDK Model",
   "files": [
     "./dist/**/*",
@@ -19,16 +19,16 @@
   "dependencies": {
     "canonicalize": "~2.1.0",
     "zod": "~3.25.76",
-    "@milaboratories/helpers": "1.14.2",
-    "@milaboratories/pl-error-like": "1.12.10"
+    "@milaboratories/pl-error-like": "1.12.10",
+    "@milaboratories/helpers": "1.14.2"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.1.3",
     "typescript": "~5.9.3",
     "vitest": "^4.1.3",
-    "@milaboratories/build-configs": "2.0.0",
     "@milaboratories/ts-configs": "1.2.3",
-    "@milaboratories/ts-builder": "1.5.0"
+    "@milaboratories/build-configs": "2.0.0",
+    "@milaboratories/ts-builder": "1.5.2"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/drivers/blob.ts

@@ -77,3 +77,27 @@ export interface BlobDriver {
    */
   getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
 }
+
+/**
+ * Operational metrics of the blob download driver.
+ */
+export type BlobDriverMetrics = {
+  /** Downloads that bypassed the ranges (sparse) cache. Counted when issued, so failed downloads still count. */
+  uncachedRequests: number;
+  /** Bytes actually streamed off the wire on the uncached path. */
+  uncachedRequestBytes: number;
+  /** Currently active remote downloads. */
+  downloadsInFlight: number;
+  /** Sum of known sizes of active downloads — progress-bar denominator. */
+  inFlightBytesTotal: number;
+  /** Sum of bytes received so far across active downloads — progress-bar numerator. */
+  inFlightBytesReceived: number;
+  /** Cached presigned URL was used and the download started successfully (one gRPC sign call avoided). */
+  presignedUrlCacheHits: number;
+  /** No cached presigned URL; a fresh one was fetched. */
+  presignedUrlCacheMisses: number;
+  /** Cached presigned URL was rejected (HTTP 400) and re-fetched — signals the TTL safety margin is too loose. */
+  presignedUrlStaleHits: number;
+  /** Total latency of presigned-URL fetch calls (misses + stale hits); divide by their count for the mean cost a hit avoids. */
+  presignedUrlRequestSumLatencyMs: number;
+};