@milaboratories/pl-model-common 1.15.0 → 1.15.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.15.0",
+  "version": "1.15.2",
   "description": "Platforma SDK Model",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -25,9 +25,9 @@
     "eslint": "^9.25.1",
     "typescript": "~5.5.4",
     "vite": "^5.4.11",
-    "vitest": "^2.1.8",
-    "@platforma-sdk/eslint-config": "1.0.3",
-    "@milaboratories/platforma-build-configs": "1.0.3"
+    "vitest": "^2.1.9",
+    "@milaboratories/platforma-build-configs": "1.0.3",
+    "@platforma-sdk/eslint-config": "1.0.3"
   },
   "scripts": {
     "type-check": "tsc --noEmit --composite false",

package/src/drivers/blob.ts

@@ -21,6 +21,29 @@ export interface BlobHandleAndSize<
   readonly size: number;
 }
 
+/** Range in bytes, from should be less or equal than to. */
+export type RangeBytes = {
+  /** Included left border. */
+  from: number;
+
+  /** Excluded right border. */
+  to: number;
+};
+
+export function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undefined {
+  if (from == undefined || to == undefined) {
+    return undefined;
+  }
+
+  return { from, to };
+}
+
+export function validateRangeBytes(range: RangeBytes, errMsg: string) {
+  if (range.from < 0 || range.to < 0 || range.from >= range.to) {
+    throw new Error(`${errMsg}: invalid bytes range: ${range}`);
+  }
+}
+
 /** Being configured inside the output structure provides information about
  * locally downloaded blob and means to retrieve it's content when needed. This
  * structure is created only after the blob's content is downloaded locally, and
@@ -37,5 +60,5 @@ export interface BlobDriver {
   /** Given the blob handle returns its content. Depending on the handle type,
    * content will be served from locally downloaded file, or directly from
    * remote platforma storage. */
-  getContent(handle: LocalBlobHandle | RemoteBlobHandle): Promise<Uint8Array>;
+  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
 }

package/src/drivers/pframe/data_types.ts

@@ -241,7 +241,7 @@ export function isValueAbsent(absent: Uint8Array, index: number): boolean {
   return (absent[chunkIndex] & mask) > 0;
 }
 
-export const PTableAbsent = { type: 'absent' };
+export const PTableAbsent = { type: 'absent' } as const;
 export type PTableAbsent = typeof PTableAbsent;
 export const PTableNA = null;
 export type PTableNA = typeof PTableNA;

package/src/drivers/pframe/driver.ts

@@ -46,7 +46,8 @@ export interface PFrameDriver {
   /** Calculates data for the table and returns complete data representation of it */
   calculateTableData(
     handle: PFrameHandle,
-    request: CalculateTableDataRequest<PObjectId>
+    request: CalculateTableDataRequest<PObjectId>,
+    range?: TableRange,
   ): Promise<CalculateTableDataResponse>;
 
   /** Calculate set of unique values for a specific axis for the filtered set of records */

package/src/drivers/pframe/pframe.ts

@@ -1,4 +1,5 @@
 import type { PObjectId } from '../../pool';
+import type { TableRange } from './data_types';
 import type { FindColumnsRequest, FindColumnsResponse } from './find_columns';
 import type { PColumn, PColumnIdAndSpec, PColumnSpec } from './spec/spec';
 import type {
@@ -23,7 +24,8 @@ export interface PFrame {
 
   /** Calculates data for the table and returns complete data representation of it */
   calculateTableData(
-    request: CalculateTableDataRequest<PObjectId>
+    request: CalculateTableDataRequest<PObjectId>,
+    range?: TableRange,
   ): Promise<CalculateTableDataResponse>;
 
   /** Calculate set of unique values for a specific axis for the filtered set of records */