@loaders.gl/loader-utils 4.2.0-alpha.3 → 4.2.0-alpha.5

package/dist/lib/files/sources.js

@@ -1,2 +1,151 @@
+"use strict";
+/*
+import {fetchFile} from '@loaders.gl/core';
 
-//# sourceMappingURL=sources.js.map
+import {Source as PMTilesSource, RangeResponse} from 'pmtiles';
+
+/** @note "source" here is a PMTiles library type, referring to  *
+export function makeSource(data: string | Blob, fetch?) {
+  if (typeof data === 'string') {
+    return new FetchSource(data, fetch);
+  }
+  if (data instanceof Blob) {
+    const url = '';
+    return new BlobSource(data, url);
+  }
+}
+
+export class BlobSource implements PMTilesSource {
+  blob: Blob;
+  key: string;
+
+  constructor(blob: Blob, key: string) {
+    this.blob = blob;
+    this.key = key;
+  }
+
+  // TODO - how is this used?
+  getKey() {
+    return this.blob.url || '';
+  }
+
+  async getBytes(offset: number, length: number, signal?: AbortSignal): Promise<RangeResponse> {
+    const data = await this.blob.arrayBuffer();
+    return {
+      data
+      // etag: response.headers.get('ETag') || undefined,
+      // cacheControl: response.headers.get('Cache-Control') || undefined,
+      // expires: response.headers.get('Expires') || undefined
+    };
+  }
+}
+
+export class FetchSource implements PMTilesSource {
+  url: string;
+  fetch;
+
+  constructor(url: string, fetch = fetchFile) {
+    this.url = url;
+    this.fetch = fetch;
+  }
+
+  // TODO - how is this used?
+  getKey() {
+    return this.url;
+  }
+
+  async getBytes(offset: number, length: number, signal?: AbortSignal): Promise<RangeResponse> {
+    let controller;
+    if (!signal) {
+      // ToDO why is it so important to abort in case 200?
+      // TODO check this works or assert 206
+      controller = new AbortController();
+      signal = controller.signal;
+    }
+
+    let response = await fetch(this.url, {
+      signal,
+      headers: {Range: `bytes=${offset}-${offset + length - 1}`}
+    });
+
+    switch (response.status) {
+      case 206: // Partial Content success
+        // This is the expected success code for a range request
+        break;
+
+      case 200:
+        // some well-behaved backends, e.g. DigitalOcean CDN, respond with 200 instead of 206
+        // but we also need to detect no support for Byte Serving which is returning the whole file
+        const content_length = response.headers.get('Content-Length');
+        if (!content_length || Number(content_length) > length) {
+          if (controller) {
+            controller.abort();
+          }
+          throw Error(
+            'content-length header missing or exceeding request. Server must support HTTP Byte Serving.'
+          );
+        }
+
+      case 416: // "Range Not Satisfiable"
+        // some HTTP servers don't accept ranges beyond the end of the resource.
+        // Retry with the exact length
+        // TODO: can return 416 with offset > 0 if content changed, which will have a blank etag.
+        // See https://github.com/protomaps/PMTiles/issues/90
+        if (offset === 0) {
+          const content_range = response.headers.get('Content-Range');
+          if (!content_range || !content_range.startsWith('bytes *')) {
+            throw Error('Missing content-length on 416 response');
+          }
+          const actual_length = Number(content_range.substr(8));
+          response = await fetch(this.url, {
+            signal,
+            headers: {Range: `bytes=0-${actual_length - 1}`}
+          });
+        }
+        break;
+
+      default:
+        if (response.status >= 300) {
+          throw Error(`Bad response code: ${response.status}`);
+        }
+    }
+
+    const data = await response.arrayBuffer();
+    return {
+      data,
+      etag: response.headers.get('ETag') || undefined,
+      cacheControl: response.headers.get('Cache-Control') || undefined,
+      expires: response.headers.get('Expires') || undefined
+    };
+  }
+}
+
+/*
+class TestNodeFileSource implements Source {
+  buffer: ArrayBuffer;
+  path: string;
+  key: string;
+  etag?: string;
+
+  constructor(path: string, key: string) {
+    this.path = path;
+    this.buffer = fs.readFileSync(path);
+    this.key = key;
+  }
+
+  getKey() {
+    return this.key;
+  }
+
+  replaceData(path: string) {
+    this.path = path;
+    this.buffer = fs.readFileSync(path);
+  }
+
+  async getBytes(offset: number, length: number): Promise<RangeResponse> {
+    const slice = new Uint8Array(this.buffer.slice(offset, offset + length))
+      .buffer;
+    return { data: slice, etag: this.etag };
+  }
+}
+*/

package/dist/lib/filesystems/filesystem.d.ts

@@ -1,4 +1,4 @@
-import { ReadableFile, WritableFile } from '../files/file';
+import { ReadableFile, WritableFile } from "../files/file.js";
 /**
  * A FileSystem interface can encapsulate various file sources,
  * a FileList, a Node.js filesystem, a ZipFile, a GoogleDrive etc.

package/dist/lib/filesystems/filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/lib/filesystems/filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E,6DAA6D;IAC7D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAElE,0CAA0C;IAC1C,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,yEAAyE;IACzE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,2BAA2B;IAC3B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnE,2BAA2B;IAC3B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1F"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/lib/filesystems/filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,yBAAsB;AAEzD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E,6DAA6D;IAC7D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAElE,0CAA0C;IAC1C,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,yEAAyE;IACzE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,2BAA2B;IAC3B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnE,2BAA2B;IAC3B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1F"}

package/dist/lib/filesystems/filesystem.js

@@ -1,2 +1,4 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 export {};
-//# sourceMappingURL=filesystem.js.map

package/dist/lib/filesystems/node-filesystem-facade.d.ts

@@ -1,6 +1,6 @@
-import { Stat } from '../files/file';
-import { NodeFileFacade as NodeFile } from '../files/node-file-facade';
-import { RandomAccessFileSystem } from './filesystem';
+import { Stat } from "../files/file.js";
+import { NodeFileFacade as NodeFile } from "../files/node-file-facade.js";
+import { RandomAccessFileSystem } from "./filesystem.js";
 /**
  * FileSystem pass-through for Node.js
  * Compatible with BrowserFileSystem.

package/dist/lib/filesystems/node-filesystem-facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-filesystem-facade.d.ts","sourceRoot":"","sources":["../../../src/lib/filesystems/node-filesystem-facade.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACnC,OAAO,EAAC,cAAc,IAAI,QAAQ,EAAC,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AAIpD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;gBAErD,OAAO,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC;IAgBzC,QAAQ,CAAC,QAAQ,QAAQ;IACzB,QAAQ,CAAC,QAAQ,QAAQ;IAEnB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,KAAA,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA,GAAG,OAAO,CAAC,QAAQ,CAAC;IAM9D,OAAO,CAAC,OAAO,SAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGzE"}
+{"version":3,"file":"node-filesystem-facade.d.ts","sourceRoot":"","sources":["../../../src/lib/filesystems/node-filesystem-facade.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,IAAI,EAAC,yBAAsB;AACnC,OAAO,EAAC,cAAc,IAAI,QAAQ,EAAC,qCAAkC;AACrE,OAAO,EAAC,sBAAsB,EAAC,wBAAqB;AAIpD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;gBAErD,OAAO,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC;IAgBzC,QAAQ,CAAC,QAAQ,QAAQ;IACzB,QAAQ,CAAC,QAAQ,QAAQ;IAEnB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,KAAA,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA,GAAG,OAAO,CAAC,QAAQ,CAAC;IAM9D,OAAO,CAAC,OAAO,SAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGzE"}

package/dist/lib/filesystems/node-filesystem-facade.js

@@ -1,37 +1,47 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import { isBrowser } from "../env-utils/globals.js";
 const NOT_IMPLEMENTED = new Error('Not implemented');
+/**
+ * FileSystem pass-through for Node.js
+ * Compatible with BrowserFileSystem.
+ * @note Dummy implementation, not used (constructor returns a real NodeFileSystem instance)
+ * @param options
+ */
 export class NodeFileSystemFacade {
-  constructor(options) {
-    var _globalThis$loaders;
-    this.readable = true;
-    this.writable = true;
-    if ((_globalThis$loaders = globalThis.loaders) !== null && _globalThis$loaders !== void 0 && _globalThis$loaders.NodeFileSystem) {
-      return new globalThis.loaders.NodeFileSystem(options);
+    // implements FileSystem
+    constructor(options) {
+        // DUMMY IMPLEMENTATION, not used (constructor returns a real NodeFileSystem instance)
+        // implements RandomAccessReadFileSystem
+        this.readable = true;
+        this.writable = true;
+        if (globalThis.loaders?.NodeFileSystem) {
+            return new globalThis.loaders.NodeFileSystem(options);
+        }
+        if (isBrowser) {
+            throw new Error('Can\'t instantiate NodeFileSystem in browser.');
+        }
+        throw new Error('Can\'t instantiate NodeFileSystem. Make sure to import @loaders.gl/polyfills first.');
     }
-    if (isBrowser) {
-      throw new Error('Can\'t instantiate NodeFileSystem in browser.');
+    async openReadableFile(path, flags) {
+        throw NOT_IMPLEMENTED;
+    }
+    // implements RandomAccessWriteFileSystem
+    async openWritableFile(path, flags, mode) {
+        throw NOT_IMPLEMENTED;
+    }
+    // Implements file system
+    async readdir(dirname = '.', options) {
+        throw NOT_IMPLEMENTED;
+    }
+    async stat(path, options) {
+        throw NOT_IMPLEMENTED;
+    }
+    async unlink(path) {
+        throw NOT_IMPLEMENTED;
+    }
+    async fetch(path, options) {
+        throw NOT_IMPLEMENTED;
     }
-    throw new Error('Can\'t instantiate NodeFileSystem. Make sure to import @loaders.gl/polyfills first.');
-  }
-  async openReadableFile(path, flags) {
-    throw NOT_IMPLEMENTED;
-  }
-  async openWritableFile(path, flags, mode) {
-    throw NOT_IMPLEMENTED;
-  }
-  async readdir() {
-    let dirname = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '.';
-    let options = arguments.length > 1 ? arguments[1] : undefined;
-    throw NOT_IMPLEMENTED;
-  }
-  async stat(path, options) {
-    throw NOT_IMPLEMENTED;
-  }
-  async unlink(path) {
-    throw NOT_IMPLEMENTED;
-  }
-  async fetch(path, options) {
-    throw NOT_IMPLEMENTED;
-  }
 }
-//# sourceMappingURL=node-filesystem-facade.js.map

package/dist/lib/iterators/async-iteration.js

@@ -1,32 +1,47 @@
 import { concatenateArrayBuffers } from "../binary-utils/array-buffer-utils.js";
+// GENERAL UTILITIES
+/**
+ * Iterate over async iterator, without resetting iterator if end is not reached
+ * - forEach intentionally does not reset iterator if exiting loop prematurely
+ *   so that iteration can continue in a second loop
+ * - It is recommended to use a standard for-await as last loop to ensure
+ *   iterator gets properly reset
+ *
+ * TODO - optimize using sync iteration if argument is an Iterable?
+ *
+ * @param iterator
+ * @param visitor
+ */
 export async function forEach(iterator, visitor) {
-  while (true) {
-    const {
-      done,
-      value
-    } = await iterator.next();
-    if (done) {
-      iterator.return();
-      return;
+    // eslint-disable-next-line
+    while (true) {
+        const { done, value } = await iterator.next();
+        if (done) {
+            iterator.return();
+            return;
+        }
+        const cancel = visitor(value);
+        if (cancel) {
+            return;
+        }
     }
-    const cancel = visitor(value);
-    if (cancel) {
-      return;
-    }
-  }
 }
+// Breaking big data into iterable chunks, concatenating iterable chunks into big data objects
+/**
+ * Concatenates all data chunks yielded by an (async) iterator
+ * This function can e.g. be used to enable atomic parsers to work on (async) iterator inputs
+ */
 export async function concatenateArrayBuffersAsync(asyncIterator) {
-  const arrayBuffers = [];
-  for await (const chunk of asyncIterator) {
-    arrayBuffers.push(chunk);
-  }
-  return concatenateArrayBuffers(...arrayBuffers);
+    const arrayBuffers = [];
+    for await (const chunk of asyncIterator) {
+        arrayBuffers.push(chunk);
+    }
+    return concatenateArrayBuffers(...arrayBuffers);
 }
 export async function concatenateStringsAsync(asyncIterator) {
-  const strings = [];
-  for await (const chunk of asyncIterator) {
-    strings.push(chunk);
-  }
-  return strings.join('');
+    const strings = [];
+    for await (const chunk of asyncIterator) {
+        strings.push(chunk);
+    }
+    return strings.join('');
 }
-//# sourceMappingURL=async-iteration.js.map

package/dist/lib/iterators/text-iterators.js

@@ -1,47 +1,54 @@
-export function makeTextDecoderIterator(arrayBufferIterator) {
-  try {
-    let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-    return async function* () {
-      const textDecoder = new TextDecoder(undefined, options);
-      for await (const arrayBuffer of arrayBufferIterator) {
-        yield typeof arrayBuffer === 'string' ? arrayBuffer : textDecoder.decode(arrayBuffer, {
-          stream: true
-        });
-      }
-    }();
-  } catch (e) {
-    return Promise.reject(e);
-  }
+// TextDecoder iterators
+// TextDecoder will keep any partial undecoded bytes between calls to `decode`
+export async function* makeTextDecoderIterator(arrayBufferIterator, options = {}) {
+    const textDecoder = new TextDecoder(undefined, options);
+    for await (const arrayBuffer of arrayBufferIterator) {
+        yield typeof arrayBuffer === 'string'
+            ? arrayBuffer
+            : textDecoder.decode(arrayBuffer, { stream: true });
+    }
 }
+// TextEncoder iterator
+// TODO - this is not useful unless min chunk size is given
+// TextEncoder will keep any partial undecoded bytes between calls to `encode`
+// If iterator does not yield strings, assume arrayBuffer and return unencoded
 export async function* makeTextEncoderIterator(textIterator) {
-  const textEncoder = new TextEncoder();
-  for await (const text of textIterator) {
-    yield typeof text === 'string' ? textEncoder.encode(text) : text;
-  }
+    const textEncoder = new TextEncoder();
+    for await (const text of textIterator) {
+        yield typeof text === 'string' ? textEncoder.encode(text) : text;
+    }
 }
+/**
+ * @param textIterator async iterable yielding strings
+ * @returns an async iterable over lines
+ * See http://2ality.com/2018/04/async-iter-nodejs.html
+ */
 export async function* makeLineIterator(textIterator) {
-  let previous = '';
-  for await (const textChunk of textIterator) {
-    previous += textChunk;
-    let eolIndex;
-    while ((eolIndex = previous.indexOf('\n')) >= 0) {
-      const line = previous.slice(0, eolIndex + 1);
-      previous = previous.slice(eolIndex + 1);
-      yield line;
+    let previous = '';
+    for await (const textChunk of textIterator) {
+        previous += textChunk;
+        let eolIndex;
+        while ((eolIndex = previous.indexOf('\n')) >= 0) {
+            // line includes the EOL
+            const line = previous.slice(0, eolIndex + 1);
+            previous = previous.slice(eolIndex + 1);
+            yield line;
+        }
+    }
+    if (previous.length > 0) {
+        yield previous;
     }
-  }
-  if (previous.length > 0) {
-    yield previous;
-  }
 }
+/**
+ * @param lineIterator async iterable yielding lines
+ * @returns async iterable yielding numbered lines
+ *
+ * See http://2ality.com/2018/04/async-iter-nodejs.html
+ */
 export async function* makeNumberedLineIterator(lineIterator) {
-  let counter = 1;
-  for await (const line of lineIterator) {
-    yield {
-      counter,
-      line
-    };
-    counter++;
-  }
+    let counter = 1;
+    for await (const line of lineIterator) {
+        yield { counter, line };
+        counter++;
+    }
 }
-//# sourceMappingURL=text-iterators.js.map

package/dist/lib/node/buffer.browser.js

@@ -1,7 +1,19 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// Isolates Buffer references to ensure they are only bundled under Node.js (avoids big webpack polyfill)
+// this file is selected by the package.json "browser" field).
+/**
+ * Convert Buffer to ArrayBuffer
+ * Converts Node.js `Buffer` to `ArrayBuffer` (without triggering bundler to include Buffer polyfill on browser)
+ * @todo better data type
+ */
 export function toArrayBuffer(buffer) {
-  return buffer;
+    return buffer;
 }
+/**
+ * Convert (copy) ArrayBuffer to Buffer
+ */
 export function toBuffer(binaryData) {
-  throw new Error('Buffer not supported in browser');
+    throw new Error('Buffer not supported in browser');
 }
-//# sourceMappingURL=buffer.browser.js.map

package/dist/lib/node/buffer.js

@@ -1,20 +1,34 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// Isolates Buffer references to ensure they are only bundled under Node.js (avoids big webpack polyfill)
+// this file is selected by the package.json "browser" field).
+/**
+ * Convert Buffer to ArrayBuffer
+ * Converts Node.js `Buffer` to `ArrayBuffer` (without triggering bundler to include Buffer polyfill on browser)
+ * @todo better data type
+ */
 export function toArrayBuffer(buffer) {
-  if (Buffer.isBuffer(buffer)) {
-    const typedArray = new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.length);
-    return typedArray.slice().buffer;
-  }
-  return buffer;
+    // TODO - per docs we should just be able to call buffer.buffer, but there are issues
+    if (Buffer.isBuffer(buffer)) {
+        const typedArray = new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.length);
+        return typedArray.slice().buffer;
+    }
+    return buffer;
 }
+/**
+ * Convert (copy) ArrayBuffer to Buffer
+ */
 export function toBuffer(binaryData) {
-  if (Buffer.isBuffer(binaryData)) {
-    return binaryData;
-  }
-  if (ArrayBuffer.isView(binaryData)) {
-    binaryData = binaryData.buffer;
-  }
-  if (typeof Buffer !== 'undefined' && binaryData instanceof ArrayBuffer) {
-    return Buffer.from(binaryData);
-  }
-  throw new Error('toBuffer');
+    if (Buffer.isBuffer(binaryData)) {
+        return binaryData;
+    }
+    if (ArrayBuffer.isView(binaryData)) {
+        binaryData = binaryData.buffer;
+    }
+    // TODO - move to loaders.gl/polyfills
+    if (typeof Buffer !== 'undefined' && binaryData instanceof ArrayBuffer) {
+        return Buffer.from(binaryData);
+    }
+    throw new Error('toBuffer');
 }
-//# sourceMappingURL=buffer.js.map

package/dist/lib/node/fs.browser.js

@@ -1,2 +1 @@
 export const isSupported = false;
-//# sourceMappingURL=fs.browser.js.map

package/dist/lib/node/promisify.js

@@ -1,10 +1,16 @@
+// @loaders.gl, MIT license
+/**
+ * Typesafe promisify implementation
+ * @link https://dev.to/_gdelgado/implement-a-type-safe-version-of-node-s-promisify-in-7-lines-of-code-in-typescript-2j34
+ * @param fn
+ * @returns
+ */
 export function promisify1(fn) {
-  return args => new Promise((resolve, reject) => fn(args, (error, callbackArgs) => error ? reject(error) : resolve(callbackArgs)));
+    return (args) => new Promise((resolve, reject) => fn(args, (error, callbackArgs) => (error ? reject(error) : resolve(callbackArgs))));
 }
 export function promisify2(fn) {
-  return (arg1, arg2) => new Promise((resolve, reject) => fn(arg1, arg2, (error, callbackArgs) => error ? reject(error) : resolve(callbackArgs)));
+    return (arg1, arg2) => new Promise((resolve, reject) => fn(arg1, arg2, (error, callbackArgs) => (error ? reject(error) : resolve(callbackArgs))));
 }
 export function promisify3(fn) {
-  return (arg1, arg2, arg3) => new Promise((resolve, reject) => fn(arg1, arg2, arg3, (error, callbackArgs) => error ? reject(error) : resolve(callbackArgs)));
+    return (arg1, arg2, arg3) => new Promise((resolve, reject) => fn(arg1, arg2, arg3, (error, callbackArgs) => (error ? reject(error) : resolve(callbackArgs))));
 }
-//# sourceMappingURL=promisify.js.map

package/dist/lib/node/stream.browser.js

@@ -1,2 +1 @@
 export const isSupported = false;
-//# sourceMappingURL=stream.browser.js.map

package/dist/lib/node/stream.js

@@ -1,4 +1,7 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import * as stream from 'stream';
+/** Wrapper for Node.js stream method */
 export const Transform = stream.Transform;
 export const isSupported = Boolean(stream);
-//# sourceMappingURL=stream.js.map

package/dist/lib/option-utils/merge-loader-options.d.ts

@@ -1,4 +1,4 @@
-import { LoaderOptions } from '../../loader-types';
+import { LoaderOptions } from "../../loader-types.js";
 /**
  *
  * @param baseOptions Can be undefined, in which case a fresh options object will be minted

package/dist/lib/option-utils/merge-loader-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-loader-options.d.ts","sourceRoot":"","sources":["../../../src/lib/option-utils/merge-loader-options.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,aAAa,EAC9D,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,UAAU,EAAE,OAAO,GAClB,OAAO,CAET"}
+{"version":3,"file":"merge-loader-options.d.ts","sourceRoot":"","sources":["../../../src/lib/option-utils/merge-loader-options.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,aAAa,EAAC,8BAA2B;AAEjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,aAAa,EAC9D,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,UAAU,EAAE,OAAO,GAClB,OAAO,CAET"}

package/dist/lib/option-utils/merge-loader-options.js

@@ -1,21 +1,29 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ *
+ * @param baseOptions Can be undefined, in which case a fresh options object will be minted
+ * @param newOptions
+ * @returns
+ */
 export function mergeLoaderOptions(baseOptions, newOptions) {
-  return mergeOptionsRecursively(baseOptions || {}, newOptions);
+    return mergeOptionsRecursively(baseOptions || {}, newOptions);
 }
-function mergeOptionsRecursively(baseOptions, newOptions) {
-  let level = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
-  if (level > 3) {
-    return newOptions;
-  }
-  const options = {
-    ...baseOptions
-  };
-  for (const [key, newValue] of Object.entries(newOptions)) {
-    if (newValue && typeof newValue === 'object' && !Array.isArray(newValue)) {
-      options[key] = mergeOptionsRecursively(options[key] || {}, newOptions[key], level + 1);
-    } else {
-      options[key] = newOptions[key];
+function mergeOptionsRecursively(baseOptions, newOptions, level = 0) {
+    // Sanity check (jest test runner overwrites the console object which can lead to infinite recursion)
+    if (level > 3) {
+        return newOptions;
     }
-  }
-  return options;
+    const options = { ...baseOptions };
+    for (const [key, newValue] of Object.entries(newOptions)) {
+        if (newValue && typeof newValue === 'object' && !Array.isArray(newValue)) {
+            options[key] = mergeOptionsRecursively(options[key] || {}, newOptions[key], level + 1);
+            // Object.assign(options[key] as object, newOptions[key]);
+        }
+        else {
+            options[key] = newOptions[key];
+        }
+    }
+    return options;
 }
-//# sourceMappingURL=merge-loader-options.js.map

package/dist/lib/parser-utils/parse-json.js

@@ -1,9 +1,12 @@
 import { getFirstCharacters } from "../binary-utils/get-first-characters.js";
+/**
+ * Minimal JSON parser that throws more meaningful error messages
+ */
 export function parseJSON(string) {
-  try {
-    return JSON.parse(string);
-  } catch (_) {
-    throw new Error(`Failed to parse JSON from data starting with "${getFirstCharacters(string)}"`);
-  }
+    try {
+        return JSON.parse(string);
+    }
+    catch (_) {
+        throw new Error(`Failed to parse JSON from data starting with "${getFirstCharacters(string)}"`);
+    }
 }
-//# sourceMappingURL=parse-json.js.map