@loaders.gl/loader-utils 3.4.0-alpha.1 → 3.4.0-alpha.2

package/dist/lib/binary-utils/array-buffer-utils.js

@@ -1,42 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sliceArrayBuffer = exports.concatenateTypedArrays = exports.concatenateArrayBuffers = exports.compareArrayBuffers = exports.toArrayBuffer = void 0;
-const buffer_utils_1 = require("./buffer-utils");
-/**
- * Convert an object to an array buffer
- */
-function toArrayBuffer(data) {
-    // Note: Should be called first, Buffers can trigger other detections below
-    if ((0, buffer_utils_1.isBuffer)(data)) {
-        return (0, buffer_utils_1.bufferToArrayBuffer)(data);
-    }
-    if (data instanceof ArrayBuffer) {
-        return data;
-    }
-    // Careful - Node Buffers look like Uint8Arrays (keep after isBuffer)
-    if (ArrayBuffer.isView(data)) {
-        if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {
-            return data.buffer;
-        }
-        return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
-    }
-    if (typeof data === 'string') {
-        const text = data;
-        const uint8Array = new TextEncoder().encode(text);
-        return uint8Array.buffer;
-    }
-    // HACK to support Blob polyfill
-    if (data && typeof data === 'object' && data._toArrayBuffer) {
-        return data._toArrayBuffer();
-    }
-    throw new Error('toArrayBuffer');
-}
-exports.toArrayBuffer = toArrayBuffer;
+exports.sliceArrayBuffer = exports.concatenateTypedArrays = exports.concatenateArrayBuffers = exports.compareArrayBuffers = void 0;
 /**
  * compare two binary arrays for equality
- * @param {ArrayBuffer} a
- * @param {ArrayBuffer} b
- * @param {number} byteLength
+ * @param a
+ * @param b
+ * @param byteLength
  */
 function compareArrayBuffers(arrayBuffer1, arrayBuffer2, byteLength) {
     byteLength = byteLength || arrayBuffer1.byteLength;
@@ -77,7 +46,7 @@ exports.concatenateArrayBuffers = concatenateArrayBuffers;
 /**
  * Concatenate arbitrary count of typed arrays
  * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays
- * @param {...*} arrays - list of arrays. All arrays should be the same type
+ * @param - list of arrays. All arrays should be the same type
  * @return A concatenated TypedArray
  */
 function concatenateTypedArrays(...typedArrays) {

package/dist/lib/binary-utils/dataview-copy-utils.d.ts

@@ -0,0 +1,43 @@
+import { TypedArray } from '../../types';
+/**
+ * Helper function that pads a string with spaces to fit a certain byte alignment
+ * @param string
+ * @param byteAlignment
+ * @returns
+ *
+ * @todo PERFORMANCE IDEA: No need to copy string twice...
+ */
+export declare function padStringToByteAlignment(string: string, byteAlignment: number): string;
+/**
+ *
+ * @param dataView
+ * @param byteOffset
+ * @param string
+ * @param byteLength
+ * @returns
+ */
+export declare function copyStringToDataView(dataView: DataView, byteOffset: number, string: string, byteLength: number): number;
+export declare function copyBinaryToDataView(dataView: any, byteOffset: any, binary: any, byteLength: any): any;
+/**
+ * Copy sourceBuffer to dataView with some padding
+ *
+ * @param dataView - destination data container. If null - only new offset is calculated
+ * @param byteOffset - destination byte offset to copy to
+ * @param sourceBuffer - source data buffer
+ * @param padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
+ *
+ * @return new byteOffset of resulting dataView
+ */
+export declare function copyPaddedArrayBufferToDataView(dataView: DataView | null, byteOffset: number, sourceBuffer: TypedArray, padding: number): number;
+/**
+ * Copy string to dataView with some padding
+ *
+ * @param {DataView | null} dataView - destination data container. If null - only new offset is calculated
+ * @param {number} byteOffset - destination byte offset to copy to
+ * @param {string} string - source string
+ * @param {number} padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
+ *
+ * @return new byteOffset of resulting dataView
+ */
+export declare function copyPaddedStringToDataView(dataView: DataView | null, byteOffset: number, string: string, padding: number): number;
+//# sourceMappingURL=dataview-copy-utils.d.ts.map

package/dist/lib/binary-utils/dataview-copy-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataview-copy-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/dataview-copy-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAGvC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAStF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAOR;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,KAAA,EAAE,UAAU,KAAA,EAAE,MAAM,KAAA,EAAE,UAAU,KAAA,OAO5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,CAsBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,MAAM,CASR"}

package/dist/lib/binary-utils/{binary-copy-utils.js → dataview-copy-utils.js}

@@ -1,14 +1,60 @@
 "use strict";
+// loaders./gl, MIT license
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.copyPaddedStringToDataView = exports.copyPaddedArrayBufferToDataView = void 0;
+exports.copyPaddedStringToDataView = exports.copyPaddedArrayBufferToDataView = exports.copyBinaryToDataView = exports.copyStringToDataView = exports.padStringToByteAlignment = void 0;
 const memory_copy_utils_1 = require("./memory-copy-utils");
+/**
+ * Helper function that pads a string with spaces to fit a certain byte alignment
+ * @param string
+ * @param byteAlignment
+ * @returns
+ *
+ * @todo PERFORMANCE IDEA: No need to copy string twice...
+ */
+function padStringToByteAlignment(string, byteAlignment) {
+    const length = string.length;
+    const paddedLength = Math.ceil(length / byteAlignment) * byteAlignment; // Round up to the required alignment
+    const padding = paddedLength - length;
+    let whitespace = '';
+    for (let i = 0; i < padding; ++i) {
+        whitespace += ' ';
+    }
+    return string + whitespace;
+}
+exports.padStringToByteAlignment = padStringToByteAlignment;
+/**
+ *
+ * @param dataView
+ * @param byteOffset
+ * @param string
+ * @param byteLength
+ * @returns
+ */
+function copyStringToDataView(dataView, byteOffset, string, byteLength) {
+    if (dataView) {
+        for (let i = 0; i < byteLength; i++) {
+            dataView.setUint8(byteOffset + i, string.charCodeAt(i));
+        }
+    }
+    return byteOffset + byteLength;
+}
+exports.copyStringToDataView = copyStringToDataView;
+function copyBinaryToDataView(dataView, byteOffset, binary, byteLength) {
+    if (dataView) {
+        for (let i = 0; i < byteLength; i++) {
+            dataView.setUint8(byteOffset + i, binary[i]);
+        }
+    }
+    return byteOffset + byteLength;
+}
+exports.copyBinaryToDataView = copyBinaryToDataView;
 /**
  * Copy sourceBuffer to dataView with some padding
  *
- * @param {DataView | null} dataView - destination data container. If null - only new offset is calculated
- * @param {number} byteOffset - destination byte offset to copy to
- * @param {Array | TypedArray} sourceBuffer - source data buffer
- * @param {number} padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
+ * @param dataView - destination data container. If null - only new offset is calculated
+ * @param byteOffset - destination byte offset to copy to
+ * @param sourceBuffer - source data buffer
+ * @param padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
  *
  * @return new byteOffset of resulting dataView
  */

package/dist/lib/binary-utils/get-first-characters.d.ts

@@ -1,3 +1,17 @@
-export declare function getFirstCharacters(data: any, length?: number): string;
+/**
+ * Get the first characters from a binary file (interpret the first bytes as an ASCII string)
+ * @param data
+ * @param length
+ * @returns
+ */
+export declare function getFirstCharacters(data: string | ArrayBuffer, length?: number): string;
+/**
+ * Gets a magic string from a "file"
+ * Typically used to check or detect file format
+ * @param arrayBuffer
+ * @param byteOffset
+ * @param length
+ * @returns
+ */
 export declare function getMagicString(arrayBuffer: ArrayBuffer, byteOffset: number, length: number): string;
 //# sourceMappingURL=get-first-characters.d.ts.map

package/dist/lib/binary-utils/get-first-characters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-first-characters.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/get-first-characters.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,IAAI,KAAA,EAAE,MAAM,SAAI,GAAG,MAAM,CAW3D;AAED,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAUR"}
+{"version":3,"file":"get-first-characters.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/get-first-characters.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAWzF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAUR"}

package/dist/lib/binary-utils/get-first-characters.js

@@ -1,6 +1,13 @@
 "use strict";
+// loaders.gl, MIT license
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMagicString = exports.getFirstCharacters = void 0;
+/**
+ * Get the first characters from a binary file (interpret the first bytes as an ASCII string)
+ * @param data
+ * @param length
+ * @returns
+ */
 function getFirstCharacters(data, length = 5) {
     if (typeof data === 'string') {
         return data.slice(0, length);
@@ -16,6 +23,14 @@ function getFirstCharacters(data, length = 5) {
     return '';
 }
 exports.getFirstCharacters = getFirstCharacters;
+/**
+ * Gets a magic string from a "file"
+ * Typically used to check or detect file format
+ * @param arrayBuffer
+ * @param byteOffset
+ * @param length
+ * @returns
+ */
 function getMagicString(arrayBuffer, byteOffset, length) {
     if (arrayBuffer.byteLength <= byteOffset + length) {
         return '';

package/dist/lib/binary-utils/{buffer-utils.d.ts → memory-conversion-utils.d.ts}

@@ -9,8 +9,7 @@ export declare function isBuffer(value: any): boolean;
  */
 export declare function toBuffer(data: any): Buffer;
 /**
- * Converts Node.js `Buffer` to `ArrayBuffer` (without triggering bundler to include Buffer polyfill on browser)
- * @todo better data type
+ * Convert an object to an array buffer
  */
-export declare function bufferToArrayBuffer(buffer: any): ArrayBuffer;
-//# sourceMappingURL=buffer-utils.d.ts.map
+export declare function toArrayBuffer(data: unknown): ArrayBuffer;
+//# sourceMappingURL=memory-conversion-utils.d.ts.map

package/dist/lib/binary-utils/memory-conversion-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversion-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/memory-conversion-utils.ts"],"names":[],"mappings":";AAIA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE5C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CA8BxD"}

package/dist/lib/binary-utils/{buffer-utils.js → memory-conversion-utils.js}

@@ -1,4 +1,5 @@
 "use strict";
+// loaders.gl, MIT license
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -23,7 +24,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bufferToArrayBuffer = exports.toBuffer = exports.isBuffer = void 0;
+exports.toArrayBuffer = exports.toBuffer = exports.isBuffer = void 0;
 const node = __importStar(require("../node/buffer"));
 /**
  * Check for Node.js `Buffer` (without triggering bundler to include Buffer polyfill on browser)
@@ -41,14 +42,32 @@ function toBuffer(data) {
 }
 exports.toBuffer = toBuffer;
 /**
- * Converts Node.js `Buffer` to `ArrayBuffer` (without triggering bundler to include Buffer polyfill on browser)
- * @todo better data type
+ * Convert an object to an array buffer
  */
-function bufferToArrayBuffer(buffer) {
-    if (isBuffer(buffer)) {
-        const typedArray = new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.length);
-        return typedArray.slice().buffer;
+function toArrayBuffer(data) {
+    // Note: Should be called first, Buffers can trigger other detections below
+    if (isBuffer(data)) {
+        return node.toArrayBuffer(data);
+    }
+    if (data instanceof ArrayBuffer) {
+        return data;
+    }
+    // Careful - Node Buffers look like Uint8Arrays (keep after isBuffer)
+    if (ArrayBuffer.isView(data)) {
+        if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {
+            return data.buffer;
+        }
+        return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+    }
+    if (typeof data === 'string') {
+        const text = data;
+        const uint8Array = new TextEncoder().encode(text);
+        return uint8Array.buffer;
+    }
+    // HACK to support Blob polyfill
+    if (data && typeof data === 'object' && data._toArrayBuffer) {
+        return data._toArrayBuffer();
     }
-    return buffer;
+    throw new Error('toArrayBuffer');
 }
-exports.bufferToArrayBuffer = bufferToArrayBuffer;
+exports.toArrayBuffer = toArrayBuffer;

package/dist/lib/filesystems/readable-file.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="node" />
+export type ReadableFile = {
+    read: (position: number, length: number) => Promise<Buffer>;
+    close: () => Promise<void>;
+    /** Length of file in bytes */
+    size: number;
+};
+/** Helper function to create an envelope reader for a binary memory input */
+export declare function makeReadableFile(data: Blob | ArrayBuffer): ReadableFile;
+//# sourceMappingURL=readable-file.d.ts.map

package/dist/lib/filesystems/readable-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readable-file.d.ts","sourceRoot":"","sources":["../../../src/lib/filesystems/readable-file.ts"],"names":[],"mappings":";AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,YAAY,CAmBvE"}

package/dist/lib/filesystems/readable-file.js

@@ -0,0 +1,25 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeReadableFile = void 0;
+/** Helper function to create an envelope reader for a binary memory input */
+function makeReadableFile(data) {
+    if (data instanceof ArrayBuffer) {
+        const arrayBuffer = data;
+        return {
+            read: async (start, length) => Buffer.from(data, start, length),
+            close: async () => { },
+            size: arrayBuffer.byteLength
+        };
+    }
+    const blob = data;
+    return {
+        read: async (start, length) => {
+            const arrayBuffer = await blob.slice(start, start + length).arrayBuffer();
+            return Buffer.from(arrayBuffer);
+        },
+        close: async () => { },
+        size: blob.size
+    };
+}
+exports.makeReadableFile = makeReadableFile;

package/dist/lib/filesystems/writable-file.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { Writable } from 'stream';
+export type WritableFile = {
+    write: (buf: Buffer) => Promise<void>;
+    close: () => Promise<void>;
+};
+export interface WriteStreamOptions {
+    flags?: string;
+    encoding?: 'utf8';
+    fd?: number;
+    mode?: number;
+    autoClose?: boolean;
+    start?: number;
+}
+/** Helper function to create an envelope reader for a binary memory input */
+export declare function makeWritableFile(pathOrStream: string | Writable, options?: WriteStreamOptions): WritableFile;
+//# sourceMappingURL=writable-file.d.ts.map

package/dist/lib/filesystems/writable-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writable-file.d.ts","sourceRoot":"","sources":["../../../src/lib/filesystems/writable-file.ts"],"names":[],"mappings":";;AAGA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAErC,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,GAAG,QAAQ,EAC/B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,YAAY,CAoBd"}

package/dist/lib/{node/util.js → filesystems/writable-file.js}

@@ -23,7 +23,26 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.promisify = void 0;
-const util = __importStar(require("util"));
-/** Wrapper for Node.js promisify */
-exports.promisify = util.promisify;
+exports.makeWritableFile = void 0;
+// Forked from https://github.com/kbajalc/parquets under MIT license (Copyright (c) 2017 ironSource Ltd.)
+const globals_1 = require("../env-utils/globals");
+const fs = __importStar(require("../node/fs"));
+/** Helper function to create an envelope reader for a binary memory input */
+function makeWritableFile(pathOrStream, options) {
+    if (globals_1.isBrowser) {
+        return {
+            write: async () => { },
+            close: async () => { }
+        };
+    }
+    const outputStream = typeof pathOrStream === 'string' ? fs.createWriteStream(pathOrStream, options) : pathOrStream;
+    return {
+        write: async (buffer) => new Promise((resolve, reject) => {
+            outputStream.write(buffer, (err) => (err ? reject(err) : resolve()));
+        }),
+        close: () => new Promise((resolve, reject) => {
+            outputStream.close((err) => (err ? reject(err) : resolve()));
+        })
+    };
+}
+exports.makeWritableFile = makeWritableFile;

package/dist/lib/node/buffer.browser.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+/**
+ * Convert Buffer to ArrayBuffer
+ * Converts Node.js `Buffer` to `ArrayBuffer` (without triggering bundler to include Buffer polyfill on browser)
+ * @todo better data type
+ */
+export declare function toArrayBuffer(buffer: any): any;
+/**
+ * Convert (copy) ArrayBuffer to Buffer
+ */
+export declare function toBuffer(binaryData: ArrayBuffer | ArrayBuffer | Buffer): Buffer;
+//# sourceMappingURL=buffer.browser.d.ts.map

package/dist/lib/node/buffer.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.browser.d.ts","sourceRoot":"","sources":["../../../src/lib/node/buffer.browser.ts"],"names":[],"mappings":";AAKA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,KAAA,OAEnC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAE/E"}

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

@@ -0,0 +1,22 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBuffer = exports.toArrayBuffer = void 0;
+// 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
+ */
+function toArrayBuffer(buffer) {
+    return buffer;
+}
+exports.toArrayBuffer = toArrayBuffer;
+/**
+ * Convert (copy) ArrayBuffer to Buffer
+ */
+function toBuffer(binaryData) {
+    throw new Error('Buffer not supported in browser');
+}
+exports.toBuffer = toBuffer;

package/dist/lib/node/buffer.d.ts

@@ -1,10 +1,12 @@
 /// <reference types="node" />
 /**
  * Convert Buffer to ArrayBuffer
+ * Converts Node.js `Buffer` to `ArrayBuffer` (without triggering bundler to include Buffer polyfill on browser)
+ * @todo better data type
  */
 export declare function toArrayBuffer(buffer: any): any;
 /**
  * Convert (copy) ArrayBuffer to Buffer
  */
-export declare function toBuffer(binaryData: any): void | Buffer;
+export declare function toBuffer(binaryData: ArrayBuffer | ArrayBuffer | Buffer): Buffer;
 //# sourceMappingURL=buffer.d.ts.map

package/dist/lib/node/buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../src/lib/node/buffer.ts"],"names":[],"mappings":";AAKA;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,KAAA,OAOnC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,UAAU,KAAA,iBAelC"}
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../src/lib/node/buffer.ts"],"names":[],"mappings":";AAKA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,KAAA,OAOnC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAc/E"}

package/dist/lib/node/buffer.js

@@ -1,11 +1,13 @@
 "use strict";
-// Isolates Buffer references to ensure they are only bundled under Node.js (avoids big webpack polyfill)
-// this file is not visible to webpack (it is excluded in the package.json "browser" field).
+// loaders.gl, MIT license
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toBuffer = exports.toArrayBuffer = void 0;
-const assert_1 = require("../env-utils/assert");
+// 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
  */
 function toArrayBuffer(buffer) {
     // TODO - per docs we should just be able to call buffer.buffer, but there are issues
@@ -20,17 +22,15 @@ exports.toArrayBuffer = toArrayBuffer;
  * Convert (copy) ArrayBuffer to Buffer
  */
 function toBuffer(binaryData) {
+    if (Buffer.isBuffer(binaryData)) {
+        return binaryData;
+    }
     if (ArrayBuffer.isView(binaryData)) {
         binaryData = binaryData.buffer;
     }
     if (typeof Buffer !== 'undefined' && binaryData instanceof ArrayBuffer) {
-        const buffer = new Buffer(binaryData.byteLength);
-        const view = new Uint8Array(binaryData);
-        for (let i = 0; i < buffer.length; ++i) {
-            buffer[i] = view[i];
-        }
-        return buffer;
+        return Buffer.from(binaryData);
     }
-    return (0, assert_1.assert)(false);
+    throw new Error('toBuffer');
 }
 exports.toBuffer = toBuffer;

package/dist/lib/node/fs.d.ts

@@ -1,4 +1,5 @@
-export type { Stats } from 'fs';
+import fs from 'fs';
+export type { Stats, WriteStream } from 'fs';
 export declare let readdir: any;
 /** Wrapper for Node.js fs method */
 export declare let stat: any;
@@ -13,11 +14,12 @@ export declare let writeFileSync: any;
 /** Wrapper for Node.js fs method */
 export declare let open: any;
 /** Wrapper for Node.js fs method */
-export declare let close: any;
+export declare let close: (fd: number) => Promise<void>;
 /** Wrapper for Node.js fs method */
 export declare let read: any;
 /** Wrapper for Node.js fs method */
 export declare let fstat: any;
+export declare let createWriteStream: typeof fs.createWriteStream;
 export declare let isSupported: boolean;
 export declare function _readToArrayBuffer(fd: number, start: number, length: number): Promise<any>;
 //# sourceMappingURL=fs.d.ts.map

package/dist/lib/node/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/lib/node/fs.ts"],"names":[],"mappings":"AAKA,YAAY,EAAC,KAAK,EAAC,MAAM,IAAI,CAAC;AAE9B,eAAO,IAAI,OAAO,KAAA,CAAC;AACnB,oCAAoC;AACpC,eAAO,IAAI,IAAI,KAAA,CAAC;AAEhB,oCAAoC;AACpC,eAAO,IAAI,QAAQ,KAAA,CAAC;AACpB,oCAAoC;AACpC,eAAO,IAAI,YAAY,KAAA,CAAC;AACxB,oCAAoC;AACpC,eAAO,IAAI,SAAS,KAAA,CAAC;AACrB,oCAAoC;AACpC,eAAO,IAAI,aAAa,KAAA,CAAC;AAIzB,oCAAoC;AACpC,eAAO,IAAI,IAAI,KAAA,CAAC;AAChB,oCAAoC;AACpC,eAAO,IAAI,KAAK,KAAA,CAAC;AACjB,oCAAoC;AACpC,eAAO,IAAI,IAAI,KAAA,CAAC;AAChB,oCAAoC;AACpC,eAAO,IAAI,KAAK,KAAA,CAAC;AAEjB,eAAO,IAAI,WAAW,SAAc,CAAC;AAmCrC,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAOjF"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/lib/node/fs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,CAAC;AAIpB,YAAY,EAAC,KAAK,EAAE,WAAW,EAAC,MAAM,IAAI,CAAC;AAE3C,eAAO,IAAI,OAAO,KAAA,CAAC;AACnB,oCAAoC;AACpC,eAAO,IAAI,IAAI,KAAA,CAAC;AAEhB,oCAAoC;AACpC,eAAO,IAAI,QAAQ,KAAA,CAAC;AACpB,oCAAoC;AACpC,eAAO,IAAI,YAAY,KAAA,CAAC;AACxB,oCAAoC;AACpC,eAAO,IAAI,SAAS,KAAA,CAAC;AACrB,oCAAoC;AACpC,eAAO,IAAI,aAAa,KAAA,CAAC;AAIzB,oCAAoC;AACpC,eAAO,IAAI,IAAI,KAAA,CAAC;AAChB,oCAAoC;AACpC,eAAO,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,oCAAoC;AACpC,eAAO,IAAI,IAAI,KAAA,CAAC;AAChB,oCAAoC;AACpC,eAAO,IAAI,KAAK,KAAA,CAAC;AAEjB,eAAO,IAAI,iBAAiB,EAAE,OAAO,EAAE,CAAC,iBAAiB,CAAC;AAE1D,eAAO,IAAI,WAAW,SAAc,CAAC;AAsCrC,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAOjF"}

package/dist/lib/node/fs.js

@@ -3,35 +3,36 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._readToArrayBuffer = exports.isSupported = exports.fstat = exports.read = exports.close = exports.open = exports.writeFileSync = exports.writeFile = exports.readFileSync = exports.readFile = exports.stat = exports.readdir = void 0;
+exports._readToArrayBuffer = exports.isSupported = exports.createWriteStream = exports.fstat = exports.read = exports.close = exports.open = exports.writeFileSync = exports.writeFile = exports.readFileSync = exports.readFile = exports.stat = exports.readdir = void 0;
 // fs wrapper (promisified fs + avoids bundling fs in browsers)
 const fs_1 = __importDefault(require("fs"));
 const buffer_1 = require("./buffer");
-const util_1 = require("./util");
+const promisify_1 = require("./promisify");
 exports.isSupported = Boolean(fs_1.default);
 // paths
 try {
     /** Wrapper for Node.js fs method */
-    exports.readdir = (0, util_1.promisify)(fs_1.default.readdir);
+    exports.readdir = (0, promisify_1.promisify2)(fs_1.default.readdir);
     /** Wrapper for Node.js fs method */
-    exports.stat = (0, util_1.promisify)(fs_1.default.stat);
+    exports.stat = (0, promisify_1.promisify2)(fs_1.default.stat);
     /** Wrapper for Node.js fs method */
-    exports.readFile = (0, util_1.promisify)(fs_1.default.readFile);
+    exports.readFile = fs_1.default.readFile;
     /** Wrapper for Node.js fs method */
     exports.readFileSync = fs_1.default.readFileSync;
     /** Wrapper for Node.js fs method */
-    exports.writeFile = (0, util_1.promisify)(fs_1.default.writeFile);
+    exports.writeFile = (0, promisify_1.promisify3)(fs_1.default.writeFile);
     /** Wrapper for Node.js fs method */
     exports.writeFileSync = fs_1.default.writeFileSync;
     // file descriptors
     /** Wrapper for Node.js fs method */
-    exports.open = (0, util_1.promisify)(fs_1.default.open);
+    exports.open = fs_1.default.open;
     /** Wrapper for Node.js fs method */
-    exports.close = (0, util_1.promisify)(fs_1.default.close);
+    exports.close = (fd) => new Promise((resolve, reject) => fs_1.default.close(fd, (err) => (err ? reject(err) : resolve())));
     /** Wrapper for Node.js fs method */
-    exports.read = (0, util_1.promisify)(fs_1.default.read);
+    exports.read = fs_1.default.read;
     /** Wrapper for Node.js fs method */
-    exports.fstat = (0, util_1.promisify)(fs_1.default.fstat);
+    exports.fstat = fs_1.default.fstat;
+    exports.createWriteStream = fs_1.default.createWriteStream;
     exports.isSupported = Boolean(fs_1.default);
 }
 catch {

package/dist/lib/node/promisify.d.ts

@@ -0,0 +1,13 @@
+/** Wrapper for Node.js promisify */
+type Callback<A> = (error: unknown, args: A) => void;
+/**
+ * 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 declare function promisify1<T, A>(fn: (args: T, cb: Callback<A>) => void): (args: T) => Promise<A>;
+export declare function promisify2<T1, T2, A>(fn: (arg1: T1, arg2: T2, cb: Callback<A>) => void): (arg1: T1, arg2: T2) => Promise<A>;
+export declare function promisify3<T1, T2, T3, A>(fn: (arg1: T1, arg2: T2, arg3: T3, cb: Callback<A>) => void): (arg1: T1, arg2: T2, arg3: T3) => Promise<A>;
+export {};
+//# sourceMappingURL=promisify.d.ts.map

package/dist/lib/node/promisify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promisify.d.ts","sourceRoot":"","sources":["../../../src/lib/node/promisify.ts"],"names":[],"mappings":"AAqCA,oCAAoC;AACpC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAKhG;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAClC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAChD,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAKpC;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EACtC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAC1D,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAK9C"}

package/dist/lib/node/promisify.js

@@ -0,0 +1,22 @@
+"use strict";
+// @loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promisify3 = exports.promisify2 = exports.promisify1 = void 0;
+/**
+ * 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
+ */
+function promisify1(fn) {
+    return (args) => new Promise((resolve, reject) => fn(args, (error, callbackArgs) => (error ? reject(error) : resolve(callbackArgs))));
+}
+exports.promisify1 = promisify1;
+function promisify2(fn) {
+    return (arg1, arg2) => new Promise((resolve, reject) => fn(arg1, arg2, (error, callbackArgs) => (error ? reject(error) : resolve(callbackArgs))));
+}
+exports.promisify2 = promisify2;
+function promisify3(fn) {
+    return (arg1, arg2, arg3) => new Promise((resolve, reject) => fn(arg1, arg2, arg3, (error, callbackArgs) => (error ? reject(error) : resolve(callbackArgs))));
+}
+exports.promisify3 = promisify3;

package/dist/lib/node/stream.d.ts

@@ -0,0 +1,4 @@
+export type { Writable } from 'stream';
+export declare let Transform: any;
+export declare const isSupported: boolean;
+//# sourceMappingURL=stream.d.ts.map

package/dist/lib/node/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/lib/node/stream.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAErC,eAAO,IAAI,SAAS,KAAA,CAAC;AAErB,eAAO,MAAM,WAAW,SAAkB,CAAC"}