@milaboratories/pl-model-common 1.19.14 → 1.19.16

package/dist/drivers/blob.cjs

@@ -2,21 +2,23 @@
 
 var zod = require('zod');
 
-/** Range in bytes, from should be less or equal than to. */
+/** Range in bytes, from should be less than to. */
 const RangeBytes = zod.z.object({
     /** Included left border. */
-    from: zod.z.number(),
+    from: zod.z.number().min(0),
     /** Excluded right border. */
-    to: zod.z.number(),
+    to: zod.z.number().min(1),
 });
 function newRangeBytesOpt(from, to) {
     if (from == undefined || to == undefined) {
         return undefined;
     }
-    return { from, to };
+    const range = { from, to };
+    validateRangeBytes(range, 'newRangeBytesOpt');
+    return range;
 }
 function validateRangeBytes(range, errMsg) {
-    if (range.from < 0 || range.to < 0 || range.from >= range.to) {
+    if (range.from < 0 || range.from >= range.to) {
         throw new Error(`${errMsg}: invalid bytes range: ${range}`);
     }
 }

package/dist/drivers/blob.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"blob.cjs","sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from '../branding';\nimport { z } from 'zod';\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, 'LocalBlobHandle'>;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, 'RemoteBlobHandle'>;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = | LocalBlobHandle\n  | 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 or equal than to. */\nexport const RangeBytes = z.object({\n  /** Included left border. */\n  from: z.number(),\n  /** Excluded right border. */\n  to: z.number(),\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  return { from, to };\n}\n\nexport function validateRangeBytes(range: RangeBytes, errMsg: string) {\n  if (range.from < 0 || range.to < 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\n/** Defines API of blob driver as it is seen from the block UI code. */\nexport interface BlobDriver {\n  /** Given the blob handle returns its content. Depending on the handle type,\n   * content will be served from locally downloaded file, or directly from\n   * remote platforma storage. */\n  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;\n}\n"],"names":["z"],"mappings":";;;;AAwBA;AACO,MAAM,UAAU,GAAGA,KAAC,CAAC,MAAM,CAAC;;AAEjC,IAAA,IAAI,EAAEA,KAAC,CAAC,MAAM,EAAE;;AAEhB,IAAA,EAAE,EAAEA,KAAC,CAAC,MAAM,EAAE;AACf,CAAA;AAIK,SAAU,gBAAgB,CAAC,IAAa,EAAE,EAAW,EAAA;IACzD,IAAI,IAAI,IAAI,SAAS,IAAI,EAAE,IAAI,SAAS,EAAE;AACxC,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;AACrB;AAEM,SAAU,kBAAkB,CAAC,KAAiB,EAAE,MAAc,EAAA;IAClE,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE;QAC5D,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,uBAAA,EAA0B,KAAK,CAAA,CAAE,CAAC;IAC7D;AACF;;;;;;"}
+{"version":3,"file":"blob.cjs","sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from '../branding';\nimport { z } from 'zod';\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, 'LocalBlobHandle'>;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, 'RemoteBlobHandle'>;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = | LocalBlobHandle\n  | 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(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n  ): Promise<Uint8Array>;\n  getContent(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n    options?: GetContentOptions,\n  ): Promise<Uint8Array>;\n  /** @deprecated Use {@link getContent} with {@link GetContentOptions} instead */\n  getContent(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n    range?: RangeBytes,\n  ): Promise<Uint8Array>;\n  getContent(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n    optionsOrRange?: GetContentOptions | RangeBytes,\n  ): Promise<Uint8Array>;\n}\n"],"names":["z"],"mappings":";;;;AAwBA;AACO,MAAM,UAAU,GAAGA,KAAC,CAAC,MAAM,CAAC;;IAEjC,IAAI,EAAEA,KAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;;IAEvB,EAAE,EAAEA,KAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACtB,CAAA;AAIK,SAAU,gBAAgB,CAAC,IAAa,EAAE,EAAW,EAAA;IACzD,IAAI,IAAI,IAAI,SAAS,IAAI,EAAE,IAAI,SAAS,EAAE;AACxC,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;AAC1B,IAAA,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,CAAC;AAE7C,IAAA,OAAO,KAAK;AACd;AAEM,SAAU,kBAAkB,CAAC,KAAiB,EAAE,MAAc,EAAA;AAClE,IAAA,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE;QAC5C,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,uBAAA,EAA0B,KAAK,CAAA,CAAE,CAAC;IAC7D;AACF;;;;;;"}

package/dist/drivers/blob.d.ts

@@ -14,7 +14,7 @@ export interface BlobHandleAndSize<H extends LocalBlobHandle | RemoteBlobHandle
     /** Blob size in bytes. */
     readonly size: number;
 }
-/** Range in bytes, from should be less or equal than to. */
+/** Range in bytes, from should be less than to. */
 export declare const RangeBytes: z.ZodObject<{
     /** Included left border. */
     from: z.ZodNumber;
@@ -39,11 +39,24 @@ export type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;
  * remote blob and means to retrieve it's content when needed. This structure
  * is created as soon as remote blob becomes available. */
 export type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;
+export type GetContentOptions = {
+    /** Byte range in [from, to) format. */
+    range?: RangeBytes;
+    /** Signal to abort the operation early. */
+    signal?: AbortSignal;
+};
+export type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;
 /** Defines API of blob driver as it is seen from the block UI code. */
 export interface BlobDriver {
-    /** Given the blob handle returns its content. Depending on the handle type,
-     * content will be served from locally downloaded file, or directly from
-     * remote platforma storage. */
+    /**
+     * 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, options?: GetContentOptions): Promise<Uint8Array>;
+    /** @deprecated Use {@link getContent} with {@link GetContentOptions} instead */
     getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
+    getContent(handle: LocalBlobHandle | RemoteBlobHandle, optionsOrRange?: GetContentOptions | RangeBytes): Promise<Uint8Array>;
 }
 //# sourceMappingURL=blob.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../src/drivers/blob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;uEACuE;AACvE,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEjE;qCACqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;0DAC0D;AAC1D,MAAM,WAAW,iBAAiB,CAChC,CAAC,SAAS,eAAe,GAAG,gBAAgB,GAAK,eAAe,GAC9D,gBAAgB;IAElB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,4DAA4D;AAC5D,eAAO,MAAM,UAAU;IACrB,4BAA4B;;IAE5B,6BAA6B;;;;;;;;EAE7B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAMnF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,QAInE;AAED;;;6BAG6B;AAC7B,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;AAExE;;0DAE0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;AAE1E,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB;;mCAE+B;IAC/B,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACjG"}
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../src/drivers/blob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;uEACuE;AACvE,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEjE;qCACqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;0DAC0D;AAC1D,MAAM,WAAW,iBAAiB,CAChC,CAAC,SAAS,eAAe,GAAG,gBAAgB,GAAK,eAAe,GAC9D,gBAAgB;IAElB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,mDAAmD;AACnD,eAAO,MAAM,UAAU;IACrB,4BAA4B;;IAE5B,6BAA6B;;;;;;;;EAE7B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CASnF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,QAInE;AAED;;;6BAG6B;AAC7B,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;AAExE;;0DAE0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;AAE1E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtF,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,UAAU,CACR,MAAM,EAAE,eAAe,GAAG,gBAAgB,GACzC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,UAAU,CACR,MAAM,EAAE,eAAe,GAAG,gBAAgB,EAC1C,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,gFAAgF;IAChF,UAAU,CACR,MAAM,EAAE,eAAe,GAAG,gBAAgB,EAC1C,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,UAAU,CACR,MAAM,EAAE,eAAe,GAAG,gBAAgB,EAC1C,cAAc,CAAC,EAAE,iBAAiB,GAAG,UAAU,GAC9C,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

package/dist/drivers/blob.js

@@ -1,20 +1,22 @@
 import { z } from 'zod';
 
-/** Range in bytes, from should be less or equal than to. */
+/** Range in bytes, from should be less than to. */
 const RangeBytes = z.object({
     /** Included left border. */
-    from: z.number(),
+    from: z.number().min(0),
     /** Excluded right border. */
-    to: z.number(),
+    to: z.number().min(1),
 });
 function newRangeBytesOpt(from, to) {
     if (from == undefined || to == undefined) {
         return undefined;
     }
-    return { from, to };
+    const range = { from, to };
+    validateRangeBytes(range, 'newRangeBytesOpt');
+    return range;
 }
 function validateRangeBytes(range, errMsg) {
-    if (range.from < 0 || range.to < 0 || range.from >= range.to) {
+    if (range.from < 0 || range.from >= range.to) {
         throw new Error(`${errMsg}: invalid bytes range: ${range}`);
     }
 }

package/dist/drivers/blob.js.map

@@ -1 +1 @@
-{"version":3,"file":"blob.js","sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from '../branding';\nimport { z } from 'zod';\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, 'LocalBlobHandle'>;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, 'RemoteBlobHandle'>;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = | LocalBlobHandle\n  | 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 or equal than to. */\nexport const RangeBytes = z.object({\n  /** Included left border. */\n  from: z.number(),\n  /** Excluded right border. */\n  to: z.number(),\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  return { from, to };\n}\n\nexport function validateRangeBytes(range: RangeBytes, errMsg: string) {\n  if (range.from < 0 || range.to < 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\n/** Defines API of blob driver as it is seen from the block UI code. */\nexport interface BlobDriver {\n  /** Given the blob handle returns its content. Depending on the handle type,\n   * content will be served from locally downloaded file, or directly from\n   * remote platforma storage. */\n  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;\n}\n"],"names":[],"mappings":";;AAwBA;AACO,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;;AAEjC,IAAA,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;;AAEhB,IAAA,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;AACf,CAAA;AAIK,SAAU,gBAAgB,CAAC,IAAa,EAAE,EAAW,EAAA;IACzD,IAAI,IAAI,IAAI,SAAS,IAAI,EAAE,IAAI,SAAS,EAAE;AACxC,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;AACrB;AAEM,SAAU,kBAAkB,CAAC,KAAiB,EAAE,MAAc,EAAA;IAClE,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE;QAC5D,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,uBAAA,EAA0B,KAAK,CAAA,CAAE,CAAC;IAC7D;AACF;;;;"}
+{"version":3,"file":"blob.js","sources":["../../src/drivers/blob.ts"],"sourcesContent":["import type { Branded } from '../branding';\nimport { z } from 'zod';\n\n/** Handle of locally downloaded blob. This handle is issued only after the\n * blob's content is downloaded locally, and ready for quick access. */\nexport type LocalBlobHandle = Branded<string, 'LocalBlobHandle'>;\n\n/** Handle of remote blob. This handle is issued as soon as the data becomes\n * available on the remote server. */\nexport type RemoteBlobHandle = Branded<string, 'RemoteBlobHandle'>;\n\n/** Being configured inside the output structure provides information about\n * blob's content and means to retrieve it when needed. */\nexport interface BlobHandleAndSize<\n  H extends LocalBlobHandle | RemoteBlobHandle = | LocalBlobHandle\n  | 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(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n  ): Promise<Uint8Array>;\n  getContent(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n    options?: GetContentOptions,\n  ): Promise<Uint8Array>;\n  /** @deprecated Use {@link getContent} with {@link GetContentOptions} instead */\n  getContent(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n    range?: RangeBytes,\n  ): Promise<Uint8Array>;\n  getContent(\n    handle: LocalBlobHandle | RemoteBlobHandle,\n    optionsOrRange?: GetContentOptions | RangeBytes,\n  ): Promise<Uint8Array>;\n}\n"],"names":[],"mappings":";;AAwBA;AACO,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;;IAEjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;;IAEvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACtB,CAAA;AAIK,SAAU,gBAAgB,CAAC,IAAa,EAAE,EAAW,EAAA;IACzD,IAAI,IAAI,IAAI,SAAS,IAAI,EAAE,IAAI,SAAS,EAAE;AACxC,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;AAC1B,IAAA,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,CAAC;AAE7C,IAAA,OAAO,KAAK;AACd;AAEM,SAAU,kBAAkB,CAAC,KAAiB,EAAE,MAAc,EAAA;AAClE,IAAA,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE;QAC5C,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,uBAAA,EAA0B,KAAK,CAAA,CAAE,CAAC;IAC7D;AACF;;;;"}

package/dist/index.cjs

@@ -28,6 +28,7 @@ var query = require('./pool/query.cjs');
 var ref = require('./ref.cjs');
 var value_or_error = require('./value_or_error.cjs');
 var base64 = require('./base64.cjs');
+var util = require('./util.cjs');
 
 
 
@@ -150,4 +151,6 @@ exports.withEnrichments = ref.withEnrichments;
 exports.mapValueInVOE = value_or_error.mapValueInVOE;
 exports.base64Decode = base64.base64Decode;
 exports.base64Encode = base64.base64Encode;
+exports.assertNever = util.assertNever;
+exports.uniqueBy = util.uniqueBy;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -15,4 +15,5 @@ export * from './ref';
 export * from './utag';
 export * from './value_or_error';
 export * from './base64';
+export * from './util';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -26,4 +26,5 @@ export { executePSpecPredicate } from './pool/query.js';
 export { PlRef, createPlRef, isPlRef, plRefsEqual, withEnrichments } from './ref.js';
 export { mapValueInVOE } from './value_or_error.js';
 export { base64Decode, base64Encode } from './base64.js';
+export { assertNever, uniqueBy } from './util.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/util.cjs

@@ -3,6 +3,14 @@
 function assertNever(x) {
     throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error
 }
+/**
+ * Return unique entries of the array by the provided id
+ * For each id, the last entry is kept
+ */
+function uniqueBy(array, makeId) {
+    return [...new Map(array.map((e) => [makeId(e), e])).values()];
+}
 
 exports.assertNever = assertNever;
+exports.uniqueBy = uniqueBy;
 //# sourceMappingURL=util.cjs.map

package/dist/util.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"util.cjs","sources":["../src/util.ts"],"sourcesContent":["export function assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n"],"names":[],"mappings":";;AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;;;;"}
+{"version":3,"file":"util.cjs","sources":["../src/util.ts"],"sourcesContent":["export function assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n\n/**\n * Return unique entries of the array by the provided id\n * For each id, the last entry is kept\n */\nexport function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[] {\n  return [...new Map(array.map((e) => [makeId(e), e])).values()];\n}\n"],"names":[],"mappings":";;AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;AAEA;;;AAGG;AACG,SAAU,QAAQ,CAAI,KAAU,EAAE,MAA4B,EAAA;AAClE,IAAA,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAChE;;;;;"}

package/dist/util.d.ts

@@ -1,2 +1,7 @@
 export declare function assertNever(x: never): never;
+/**
+ * Return unique entries of the array by the provided id
+ * For each id, the last entry is kept
+ */
+export declare function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[];
 //# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAE3C"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAE3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,EAAE,CAEzE"}

package/dist/util.js

@@ -1,6 +1,13 @@
 function assertNever(x) {
     throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error
 }
+/**
+ * Return unique entries of the array by the provided id
+ * For each id, the last entry is kept
+ */
+function uniqueBy(array, makeId) {
+    return [...new Map(array.map((e) => [makeId(e), e])).values()];
+}
 
-export { assertNever };
+export { assertNever, uniqueBy };
 //# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sources":["../src/util.ts"],"sourcesContent":["export function assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n"],"names":[],"mappings":"AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;;;;"}
+{"version":3,"file":"util.js","sources":["../src/util.ts"],"sourcesContent":["export function assertNever(x: never): never {\n  throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error\n}\n\n/**\n * Return unique entries of the array by the provided id\n * For each id, the last entry is kept\n */\nexport function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[] {\n  return [...new Map(array.map((e) => [makeId(e), e])).values()];\n}\n"],"names":[],"mappings":"AAAM,SAAU,WAAW,CAAC,CAAQ,EAAA;IAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;AAC7C;AAEA;;;AAGG;AACG,SAAU,QAAQ,CAAI,KAAU,EAAE,MAA4B,EAAA;AAClE,IAAA,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAChE;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.19.14",
+  "version": "1.19.16",
   "description": "Platforma SDK Model",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -19,16 +19,16 @@
   "dependencies": {
     "zod": "~3.23.8",
     "canonicalize": "~2.1.0",
-    "@milaboratories/pl-error-like": "1.12.4"
+    "@milaboratories/pl-error-like": "1.12.5"
   },
   "devDependencies": {
     "eslint": "^9.25.1",
     "typescript": "~5.6.3",
     "vitest": "^2.1.9",
-    "@milaboratories/build-configs": "1.0.8",
-    "@milaboratories/ts-builder": "1.0.5",
     "@platforma-sdk/eslint-config": "1.0.3",
-    "@milaboratories/ts-configs": "1.0.6"
+    "@milaboratories/build-configs": "1.0.8",
+    "@milaboratories/ts-configs": "1.0.6",
+    "@milaboratories/ts-builder": "1.0.5"
   },
   "scripts": {
     "type-check": "ts-builder types --target node",

package/src/drivers/blob.ts

@@ -22,12 +22,12 @@ export interface BlobHandleAndSize<
   readonly size: number;
 }
 
-/** Range in bytes, from should be less or equal than to. */
+/** Range in bytes, from should be less than to. */
 export const RangeBytes = z.object({
   /** Included left border. */
-  from: z.number(),
+  from: z.number().min(0),
   /** Excluded right border. */
-  to: z.number(),
+  to: z.number().min(1),
 });
 
 export type RangeBytes = z.infer<typeof RangeBytes>;
@@ -37,11 +37,14 @@ export function newRangeBytesOpt(from?: number, to?: number): RangeBytes | undef
     return undefined;
   }
 
-  return { from, to };
+  const range = { from, to };
+  validateRangeBytes(range, 'newRangeBytesOpt');
+
+  return range;
 }
 
 export function validateRangeBytes(range: RangeBytes, errMsg: string) {
-  if (range.from < 0 || range.to < 0 || range.from >= range.to) {
+  if (range.from < 0 || range.from >= range.to) {
     throw new Error(`${errMsg}: invalid bytes range: ${range}`);
   }
 }
@@ -57,10 +60,36 @@ export type LocalBlobHandleAndSize = BlobHandleAndSize<LocalBlobHandle>;
  * is created as soon as remote blob becomes available. */
 export type RemoteBlobHandleAndSize = BlobHandleAndSize<RemoteBlobHandle>;
 
+export type GetContentOptions = {
+  /** Byte range in [from, to) format. */
+  range?: RangeBytes;
+  /** Signal to abort the operation early. */
+  signal?: AbortSignal;
+};
+
+export type ContentHandler<T> = (content: ReadableStream, size: number) => Promise<T>;
+
 /** Defines API of blob driver as it is seen from the block UI code. */
 export interface BlobDriver {
-  /** Given the blob handle returns its content. Depending on the handle type,
-   * content will be served from locally downloaded file, or directly from
-   * remote platforma storage. */
-  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
+  /**
+   * 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,
+    options?: GetContentOptions,
+  ): Promise<Uint8Array>;
+  /** @deprecated Use {@link getContent} with {@link GetContentOptions} instead */
+  getContent(
+    handle: LocalBlobHandle | RemoteBlobHandle,
+    range?: RangeBytes,
+  ): Promise<Uint8Array>;
+  getContent(
+    handle: LocalBlobHandle | RemoteBlobHandle,
+    optionsOrRange?: GetContentOptions | RangeBytes,
+  ): Promise<Uint8Array>;
 }

package/src/index.ts

@@ -15,3 +15,4 @@ export * from './ref';
 export * from './utag';
 export * from './value_or_error';
 export * from './base64';
+export * from './util';

package/src/util.ts

@@ -1,3 +1,11 @@
 export function assertNever(x: never): never {
   throw new Error('Unexpected object: ' + x); // This is ok, because this is a possible runtime error
 }
+
+/**
+ * Return unique entries of the array by the provided id
+ * For each id, the last entry is kept
+ */
+export function uniqueBy<T>(array: T[], makeId: (entry: T) => string): T[] {
+  return [...new Map(array.map((e) => [makeId(e), e])).values()];
+}