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

package/dist/lib/file-provider/file-handle-file.js

@@ -1,61 +1,99 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import { NodeFileFacade as NodeFile } from "../files/node-file-facade.js";
+/**
+ * Provides file data using node fs library
+ * @deprecated - will be replaced with ReadableFile
+ */
 export class FileHandleFile {
-  constructor(path) {
-    let append = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
-    this.file = void 0;
-    this.file = new NodeFile(path, append ? 'a+' : 'r');
-  }
-  async truncate(length) {
-    await this.file.truncate(length);
-  }
-  async append(buffer) {
-    await this.file.append(buffer);
-  }
-  async destroy() {
-    await this.file.close();
-  }
-  async getUint8(offset) {
-    const arrayBuffer = await this.file.read(offset, 1);
-    const val = new Uint8Array(arrayBuffer).at(0);
-    if (val === undefined) {
-      throw new Error('something went wrong');
-    }
-    return val;
-  }
-  async getUint16(offset) {
-    const arrayBuffer = await this.file.read(offset, 2);
-    const val = new Uint16Array(arrayBuffer).at(0);
-    if (val === undefined) {
-      throw new Error('something went wrong');
-    }
-    return val;
-  }
-  async getUint32(offset) {
-    const arrayBuffer = await this.file.read(offset, 4);
-    const val = new Uint32Array(arrayBuffer).at(0);
-    if (val === undefined) {
-      throw new Error('something went wrong');
-    }
-    return val;
-  }
-  async getBigUint64(offset) {
-    const arrayBuffer = await this.file.read(offset, 8);
-    const val = new BigInt64Array(arrayBuffer).at(0);
-    if (val === undefined) {
-      throw new Error('something went wrong');
-    }
-    return val;
-  }
-  async slice(startOffset, endOffset) {
-    const bigLength = endOffset - startOffset;
-    if (bigLength > Number.MAX_SAFE_INTEGER) {
-      throw new Error('too big slice');
-    }
-    const length = Number(bigLength);
-    return await this.file.read(startOffset, length);
-  }
-  get length() {
-    return this.file.bigsize;
-  }
+    /** Create a new FileHandleFile */
+    constructor(path, append = false) {
+        this.file = new NodeFile(path, append ? 'a+' : 'r');
+    }
+    /**
+     * Truncates the file descriptor.
+     * @param length desired file lenght
+     */
+    async truncate(length) {
+        await this.file.truncate(length);
+    }
+    /**
+     * Append data to a file.
+     * @param buffer data to append
+     */
+    async append(buffer) {
+        await this.file.append(buffer);
+    }
+    /** Close file */
+    async destroy() {
+        await this.file.close();
+    }
+    /**
+     * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint8(offset) {
+        const arrayBuffer = await this.file.read(offset, 1);
+        const val = new Uint8Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * Gets an unsigned 16-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint16(offset) {
+        const arrayBuffer = await this.file.read(offset, 2);
+        const val = new Uint16Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint32(offset) {
+        const arrayBuffer = await this.file.read(offset, 4);
+        const val = new Uint32Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getBigUint64(offset) {
+        const arrayBuffer = await this.file.read(offset, 8);
+        const val = new BigInt64Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in byte, from the start of the file where to start reading the data.
+     * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
+     */
+    async slice(startOffset, endOffset) {
+        const bigLength = endOffset - startOffset;
+        if (bigLength > Number.MAX_SAFE_INTEGER) {
+            throw new Error('too big slice');
+        }
+        const length = Number(bigLength);
+        return await this.file.read(startOffset, length);
+    }
+    /**
+     * the length (in bytes) of the data.
+     */
+    get length() {
+        return this.file.bigsize;
+    }
 }
-//# sourceMappingURL=file-handle-file.js.map

package/dist/lib/file-provider/file-provider.js

@@ -1,4 +1,9 @@
-export const isFileProvider = fileProvider => {
-  return (fileProvider === null || fileProvider === void 0 ? void 0 : fileProvider.getUint8) && (fileProvider === null || fileProvider === void 0 ? void 0 : fileProvider.slice) && (fileProvider === null || fileProvider === void 0 ? void 0 : fileProvider.length);
+/**
+ * Check is the object has FileProvider members
+ * @param fileProvider - tested object
+ */
+export const isFileProvider = (fileProvider) => {
+    return (fileProvider?.getUint8 &&
+        fileProvider?.slice &&
+        fileProvider?.length);
 };
-//# sourceMappingURL=file-provider.js.map

package/dist/lib/files/blob-file.d.ts

@@ -1,4 +1,4 @@
-import { ReadableFile } from './file';
+import { ReadableFile } from "./file.js";
 /**
  * BlobFile provides a "file like interface" to the data in a Blob or File object
  */

package/dist/lib/files/blob-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob-file.d.ts","sourceRoot":"","sources":["../../../src/lib/files/blob-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AAEpC;;GAEG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,WAAW;IAOrC,KAAK;IAEL,IAAI;;;;;IAQJ,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAIhE"}
+{"version":3,"file":"blob-file.d.ts","sourceRoot":"","sources":["../../../src/lib/files/blob-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,kBAAe;AAEpC;;GAEG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,WAAW;IAOrC,KAAK;IAEL,IAAI;;;;;IAQJ,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAIhE"}

package/dist/lib/files/blob-file.js

@@ -1,25 +1,26 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * BlobFile provides a "file like interface" to the data in a Blob or File object
+ */
 export class BlobFile {
-  constructor(blob) {
-    this.handle = void 0;
-    this.size = void 0;
-    this.bigsize = void 0;
-    this.url = void 0;
-    this.handle = blob instanceof ArrayBuffer ? new Blob([blob]) : blob;
-    this.size = blob instanceof ArrayBuffer ? blob.byteLength : blob.size;
-    this.bigsize = BigInt(this.size);
-    this.url = blob instanceof File ? blob.name : '';
-  }
-  async close() {}
-  async stat() {
-    return {
-      size: this.handle.size,
-      bigsize: BigInt(this.handle.size),
-      isDirectory: false
-    };
-  }
-  async read(start, length) {
-    const arrayBuffer = await this.handle.slice(start, start + length).arrayBuffer();
-    return arrayBuffer;
-  }
+    constructor(blob) {
+        this.handle = blob instanceof ArrayBuffer ? new Blob([blob]) : blob;
+        this.size = blob instanceof ArrayBuffer ? blob.byteLength : blob.size;
+        this.bigsize = BigInt(this.size);
+        this.url = blob instanceof File ? blob.name : '';
+    }
+    async close() { }
+    async stat() {
+        return {
+            size: this.handle.size,
+            bigsize: BigInt(this.handle.size),
+            isDirectory: false
+        };
+    }
+    async read(start, length) {
+        const arrayBuffer = await this.handle.slice(start, start + length).arrayBuffer();
+        return arrayBuffer;
+    }
 }
-//# sourceMappingURL=blob-file.js.map

package/dist/lib/files/file.js

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

package/dist/lib/files/http-file.d.ts

@@ -1,4 +1,4 @@
-import { ReadableFile, Stat } from './file';
+import { ReadableFile, Stat } from "./file.js";
 export declare class HttpFile implements ReadableFile {
     readonly handle: string;
     readonly size: number;

package/dist/lib/files/http-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-file.d.ts","sourceRoot":"","sources":["../../../src/lib/files/http-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAE,IAAI,EAAC,MAAM,QAAQ,CAAC;AAE1C,qBAAa,QAAS,YAAW,YAAY;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAK;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAM;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;IAKjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMzE;;;;;;;OAOG;IAEG,UAAU,CACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC;CAsErB"}
+{"version":3,"file":"http-file.d.ts","sourceRoot":"","sources":["../../../src/lib/files/http-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAE,IAAI,EAAC,kBAAe;AAE1C,qBAAa,QAAS,YAAW,YAAY;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAK;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAM;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;IAKjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMzE;;;;;;;OAOG;IAEG,UAAU,CACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC;CAsErB"}

package/dist/lib/files/http-file.js

@@ -1,79 +1,99 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 export class HttpFile {
-  constructor(url) {
-    this.handle = void 0;
-    this.size = 0;
-    this.bigsize = 0n;
-    this.url = void 0;
-    this.handle = url;
-    this.url = url;
-  }
-  async close() {}
-  async stat() {
-    const response = await fetch(this.handle, {
-      method: 'HEAD'
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to fetch HEAD ${this.handle}`);
+    constructor(url) {
+        this.size = 0;
+        this.bigsize = 0n;
+        this.handle = url;
+        this.url = url;
     }
-    const size = parseInt(response.headers.get('Content-Length') || '0');
-    return {
-      size,
-      bigsize: BigInt(size),
-      isDirectory: false
-    };
-  }
-  async read(offset, length) {
-    const response = await this.fetchRange(offset, length);
-    const arrayBuffer = await response.arrayBuffer();
-    return arrayBuffer;
-  }
-  async fetchRange(offset, length, signal) {
-    const nOffset = Number(offset);
-    const nLength = Number(length);
-    let controller;
-    if (!signal) {
-      controller = new AbortController();
-      signal = controller.signal;
+    async close() { }
+    async stat() {
+        const response = await fetch(this.handle, { method: 'HEAD' });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch HEAD ${this.handle}`);
+        }
+        const size = parseInt(response.headers.get('Content-Length') || '0');
+        return {
+            size,
+            bigsize: BigInt(size),
+            isDirectory: false
+        };
+    }
+    async read(offset, length) {
+        const response = await this.fetchRange(offset, length);
+        const arrayBuffer = await response.arrayBuffer();
+        return arrayBuffer;
     }
-    const url = this.handle;
-    let response = await fetch(url, {
-      signal,
-      headers: {
-        Range: `bytes=${nOffset}-${nOffset + nLength - 1}`
-      }
-    });
-    switch (response.status) {
-      case 206:
-        break;
-      case 200:
-        const contentLength = response.headers.get('Content-Length');
-        if (!contentLength || Number(contentLength) > length) {
-          if (controller) {
-            controller.abort();
-          }
-          throw Error('content-length header missing or exceeding request. Server must support HTTP Byte Serving.');
+    /**
+     *
+     * @param offset
+     * @param length
+     * @param signal
+     * @returns
+     * @see https://github.com/protomaps/PMTiles
+     */
+    // eslint-disable-next-line complexity
+    async fetchRange(offset, length, signal) {
+        const nOffset = Number(offset);
+        const nLength = Number(length);
+        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;
         }
-      case 416:
-        if (offset === 0) {
-          const contentRange = response.headers.get('Content-Range');
-          if (!contentRange || !contentRange.startsWith('bytes *')) {
-            throw Error('Missing content-length on 416 response');
-          }
-          const actualLength = Number(contentRange.substr(8));
-          response = await fetch(this.url, {
+        const url = this.handle;
+        let response = await fetch(url, {
             signal,
-            headers: {
-              Range: `bytes=0-${actualLength - 1}`
-            }
-          });
-        }
-        break;
-      default:
-        if (response.status >= 300) {
-          throw Error(`Bad response code: ${response.status}`);
+            headers: { Range: `bytes=${nOffset}-${nOffset + nLength - 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 contentLength = response.headers.get('Content-Length');
+                if (!contentLength || Number(contentLength) > length) {
+                    if (controller) {
+                        controller.abort();
+                    }
+                    throw Error('content-length header missing or exceeding request. Server must support HTTP Byte Serving.');
+                }
+            // @eslint-disable-next-line no-fallthrough
+            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 contentRange = response.headers.get('Content-Range');
+                    if (!contentRange || !contentRange.startsWith('bytes *')) {
+                        throw Error('Missing content-length on 416 response');
+                    }
+                    const actualLength = Number(contentRange.substr(8));
+                    response = await fetch(this.url, {
+                        signal,
+                        headers: { Range: `bytes=0-${actualLength - 1}` }
+                    });
+                }
+                break;
+            default:
+                if (response.status >= 300) {
+                    throw Error(`Bad response code: ${response.status}`);
+                }
         }
+        return response;
+        // 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
+        // };
     }
-    return response;
-  }
 }
-//# sourceMappingURL=http-file.js.map

package/dist/lib/files/node-file-facade.d.ts

@@ -1,4 +1,4 @@
-import { ReadableFile, WritableFile, Stat } from './file';
+import { ReadableFile, WritableFile, Stat } from "./file.js";
 /** This class is a facade that gets replaced with an actual NodeFile instance  */
 export declare class NodeFileFacade implements ReadableFile, WritableFile {
     handle: unknown;

package/dist/lib/files/node-file-facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-file-facade.d.ts","sourceRoot":"","sources":["../../../src/lib/files/node-file-facade.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAC,MAAM,QAAQ,CAAC;AAIxD,kFAAkF;AAClF,qBAAa,cAAe,YAAW,YAAY,EAAE,YAAY;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAK;IACjB,OAAO,EAAE,MAAM,CAAM;IACrB,GAAG,EAAE,MAAM,CAAM;gBAEL,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM;IAUvE,gBAAgB;IACV,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAGhF,kEAAkE;IAC5D,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAG1G,iCAAiC;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,iEAAiE;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,yDAAyD;IACnD,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAG7C,qBAAqB;IACf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B"}
+{"version":3,"file":"node-file-facade.d.ts","sourceRoot":"","sources":["../../../src/lib/files/node-file-facade.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAC,kBAAe;AAIxD,kFAAkF;AAClF,qBAAa,cAAe,YAAW,YAAY,EAAE,YAAY;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAK;IACjB,OAAO,EAAE,MAAM,CAAM;IACrB,GAAG,EAAE,MAAM,CAAM;gBAEL,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM;IAUvE,gBAAgB;IACV,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAGhF,kEAAkE;IAC5D,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAG1G,iCAAiC;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,iEAAiE;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,yDAAyD;IACnD,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAG7C,qBAAqB;IACf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B"}

package/dist/lib/files/node-file-facade.js

@@ -1,35 +1,43 @@
+// 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');
+/** This class is a facade that gets replaced with an actual NodeFile instance  */
 export class NodeFileFacade {
-  constructor(url, flags, mode) {
-    var _globalThis$loaders;
-    this.handle = void 0;
-    this.size = 0;
-    this.bigsize = 0n;
-    this.url = '';
-    if ((_globalThis$loaders = globalThis.loaders) !== null && _globalThis$loaders !== void 0 && _globalThis$loaders.NodeFile) {
-      return new globalThis.loaders.NodeFile(url, flags, mode);
+    constructor(url, flags, mode) {
+        this.size = 0;
+        this.bigsize = 0n;
+        this.url = '';
+        // Return the actual implementation instance
+        if (globalThis.loaders?.NodeFile) {
+            return new globalThis.loaders.NodeFile(url, flags, mode);
+        }
+        if (isBrowser) {
+            throw new Error('Can\'t instantiate NodeFile in browser.');
+        }
+        throw new Error('Can\'t instantiate NodeFile. Make sure to import @loaders.gl/polyfills first.');
     }
-    if (isBrowser) {
-      throw new Error('Can\'t instantiate NodeFile in browser.');
+    /** Read data */
+    async read(start, end) {
+        throw NOT_IMPLEMENTED;
     }
-    throw new Error('Can\'t instantiate NodeFile. Make sure to import @loaders.gl/polyfills first.');
-  }
-  async read(start, end) {
-    throw NOT_IMPLEMENTED;
-  }
-  async write(arrayBuffer, offset, length) {
-    throw NOT_IMPLEMENTED;
-  }
-  async stat() {
-    throw NOT_IMPLEMENTED;
-  }
-  async truncate(length) {
-    throw NOT_IMPLEMENTED;
-  }
-  async append(data) {
-    throw NOT_IMPLEMENTED;
-  }
-  async close() {}
+    /** Write to file. The number of bytes written will be returned */
+    async write(arrayBuffer, offset, length) {
+        throw NOT_IMPLEMENTED;
+    }
+    /** Get information about file */
+    async stat() {
+        throw NOT_IMPLEMENTED;
+    }
+    /** Truncates the file descriptor. Only available on NodeFile. */
+    async truncate(length) {
+        throw NOT_IMPLEMENTED;
+    }
+    /** Append data to a file. Only available on NodeFile. */
+    async append(data) {
+        throw NOT_IMPLEMENTED;
+    }
+    /** Close the file */
+    async close() { }
 }
-//# sourceMappingURL=node-file-facade.js.map