@loaders.gl/zip 4.2.0-alpha.1 → 4.2.0-alpha.2

package/dist/dist.dev.js

@@ -6952,7 +6952,9 @@ var __exports__ = (() => {
   var src_exports = {};
   __export(src_exports, {
     CD_HEADER_SIGNATURE: () => signature2,
+    IndexedArchive: () => IndexedArchive,
     TarBuilder: () => TarBuilder,
+    ZIP_COMPRESSION_HANDLERS: () => ZIP_COMPRESSION_HANDLERS,
     ZipFileSystem: () => ZipFileSystem,
     ZipLoader: () => ZipLoader,
     ZipWriter: () => ZipWriter,
@@ -6973,7 +6975,7 @@ var __exports__ = (() => {
 
   // src/zip-loader.ts
   var import_jszip = __toESM(require_jszip_min(), 1);
-  var VERSION = true ? "4.2.0-alpha.1" : "latest";
+  var VERSION = true ? "4.2.0-alpha.2" : "latest";
   var ZipLoader = {
     id: "zip",
     module: "zip",
@@ -7018,7 +7020,7 @@ var __exports__ = (() => {
 
   // src/zip-writer.ts
   var import_jszip2 = __toESM(require_jszip_min(), 1);
-  var VERSION2 = true ? "4.2.0-alpha.1" : "latest";
+  var VERSION2 = true ? "4.2.0-alpha.2" : "latest";
   var ZipWriter = {
     name: "Zip Archive",
     id: "zip",
@@ -9059,62 +9061,6 @@ var __exports__ = (() => {
     return path_exports.join(...resPaths);
   }
 
-  // src/hash-file-utility.ts
-  function parseHashTable(arrayBuffer) {
-    const dataView = new DataView(arrayBuffer);
-    const hashMap = {};
-    for (let i = 0; i < arrayBuffer.byteLength; i = i + 24) {
-      const offset = dataView.getBigUint64(i + 16, true);
-      const hash = bufferToHex(arrayBuffer, i, 16);
-      hashMap[hash] = offset;
-    }
-    return hashMap;
-  }
-  function bufferToHex(buffer, start, length) {
-    return [...new Uint8Array(buffer, start, length)].map((x) => x.toString(16).padStart(2, "0")).join("");
-  }
-  async function makeHashTableFromZipHeaders(fileProvider) {
-    const zipCDIterator = makeZipCDHeaderIterator(fileProvider);
-    return getHashTable(zipCDIterator);
-  }
-  async function getHashTable(zipCDIterator) {
-    const md5Hash = new MD5Hash();
-    const textEncoder = new TextEncoder();
-    const hashTable = {};
-    for await (const cdHeader of zipCDIterator) {
-      const filename2 = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
-      const arrayBuffer = textEncoder.encode(filename2).buffer;
-      const md5 = await md5Hash.hash(arrayBuffer, "hex");
-      hashTable[md5] = cdHeader.localHeaderOffset;
-    }
-    return hashTable;
-  }
-  async function composeHashFile(zipCDIterator) {
-    const md5Hash = new MD5Hash();
-    const textEncoder = new TextEncoder();
-    const hashArray = [];
-    for await (const cdHeader of zipCDIterator) {
-      const filename2 = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
-      const arrayBuffer = textEncoder.encode(filename2).buffer;
-      const md5 = await md5Hash.hash(arrayBuffer, "hex");
-      hashArray.push(concatenateArrayBuffers(hexStringToBuffer(md5), bigintToBuffer(cdHeader.localHeaderOffset)));
-    }
-    const bufferArray = hashArray.sort(compareHashes);
-    return concatenateArrayBuffersFromArray(bufferArray);
-  }
-  function compareHashes(arrA, arrB) {
-    const a = new BigUint64Array(arrA);
-    const b = new BigUint64Array(arrB);
-    return Number(a[0] === b[0] ? a[1] - b[1] : a[0] - b[0]);
-  }
-  function hexStringToBuffer(str) {
-    const byteArray = str.match(/../g)?.map((h) => parseInt(h, 16));
-    return new Uint8Array(byteArray ?? new Array(16)).buffer;
-  }
-  function bigintToBuffer(n) {
-    return new BigUint64Array([n]).buffer;
-  }
-
   // ../compression/src/lib/compression.ts
   var Compression = class {
     constructor(options) {
@@ -9263,7 +9209,7 @@ var __exports__ = (() => {
   };
 
   // src/filesystems/zip-filesystem.ts
-  var COMPRESSION_METHODS = {
+  var ZIP_COMPRESSION_HANDLERS = {
     0: async (compressedFile) => compressedFile,
     8: async (compressedFile) => {
       const compression = new DeflateCompression({
@@ -9275,6 +9221,7 @@ var __exports__ = (() => {
   };
   var ZipFileSystem = class {
     fileProvider = null;
+    archive = null;
     constructor(file) {
       if (typeof file === "string") {
         this.fileName = file;
@@ -9283,6 +9230,10 @@ var __exports__ = (() => {
         } else {
           throw new Error("Cannot open file for random access in a WEB browser");
         }
+      } else if (file instanceof IndexedArchive) {
+        this.fileProvider = file.fileProvider;
+        this.archive = file;
+        this.fileName = file.fileName;
       } else if (isFileProvider(file)) {
         this.fileProvider = file;
       }
@@ -9311,23 +9262,28 @@ var __exports__ = (() => {
       };
     }
     async fetch(filename2) {
-      if (!this.fileProvider) {
-        throw new Error("No data detected in the zip archive");
-      }
-      const cdFileHeader = await this.getCDFileHeader(filename2);
-      const localFileHeader = await parseZipLocalFileHeader(cdFileHeader.localHeaderOffset, this.fileProvider);
-      if (!localFileHeader) {
-        throw new Error("Local file header has not been found in the zip archive`");
-      }
-      const compressionHandler = COMPRESSION_METHODS[localFileHeader.compressionMethod.toString()];
-      if (!compressionHandler) {
-        throw Error("Only Deflation compression is supported");
+      let uncompressedFile;
+      if (this.archive) {
+        uncompressedFile = await this.archive.getFile(filename2, "http");
+      } else {
+        if (!this.fileProvider) {
+          throw new Error("No data detected in the zip archive");
+        }
+        const cdFileHeader = await this.getCDFileHeader(filename2);
+        const localFileHeader = await parseZipLocalFileHeader(cdFileHeader.localHeaderOffset, this.fileProvider);
+        if (!localFileHeader) {
+          throw new Error("Local file header has not been found in the zip archive`");
+        }
+        const compressionHandler = ZIP_COMPRESSION_HANDLERS[localFileHeader.compressionMethod.toString()];
+        if (!compressionHandler) {
+          throw Error("Only Deflation compression is supported");
+        }
+        const compressedFile = await this.fileProvider.slice(localFileHeader.fileDataOffset, localFileHeader.fileDataOffset + localFileHeader.compressedSize);
+        uncompressedFile = await compressionHandler(compressedFile);
       }
-      const compressedFile = await this.fileProvider.slice(localFileHeader.fileDataOffset, localFileHeader.fileDataOffset + localFileHeader.compressedSize);
-      const uncompressedFile = await compressionHandler(compressedFile);
       const response = new Response(uncompressedFile);
       Object.defineProperty(response, "url", {
-        value: `${this.fileName || ""}/${filename2}`
+        value: filename2 ? `${this.fileName || ""}/${filename2}` : this.fileName || ""
       });
       return response;
     }
@@ -9349,6 +9305,75 @@ var __exports__ = (() => {
       return result;
     }
   };
+
+  // src/filesystems/IndexedArchive.ts
+  var IndexedArchive = class {
+    constructor(fileProvider, hashTable, fileName) {
+      this.fileProvider = fileProvider;
+      this.fileName = fileName;
+    }
+    async getFileWithoutHash(filename2) {
+      const zipFS = new ZipFileSystem(this.fileProvider);
+      const response = await zipFS.fetch(filename2);
+      return await response.arrayBuffer();
+    }
+  };
+
+  // src/hash-file-utility.ts
+  function parseHashTable(arrayBuffer) {
+    const dataView = new DataView(arrayBuffer);
+    const hashMap = {};
+    for (let i = 0; i < arrayBuffer.byteLength; i = i + 24) {
+      const offset = dataView.getBigUint64(i + 16, true);
+      const hash = bufferToHex(arrayBuffer, i, 16);
+      hashMap[hash] = offset;
+    }
+    return hashMap;
+  }
+  function bufferToHex(buffer, start, length) {
+    return [...new Uint8Array(buffer, start, length)].map((x) => x.toString(16).padStart(2, "0")).join("");
+  }
+  async function makeHashTableFromZipHeaders(fileProvider) {
+    const zipCDIterator = makeZipCDHeaderIterator(fileProvider);
+    return getHashTable(zipCDIterator);
+  }
+  async function getHashTable(zipCDIterator) {
+    const md5Hash = new MD5Hash();
+    const textEncoder = new TextEncoder();
+    const hashTable = {};
+    for await (const cdHeader of zipCDIterator) {
+      const filename2 = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
+      const arrayBuffer = textEncoder.encode(filename2).buffer;
+      const md5 = await md5Hash.hash(arrayBuffer, "hex");
+      hashTable[md5] = cdHeader.localHeaderOffset;
+    }
+    return hashTable;
+  }
+  async function composeHashFile(zipCDIterator) {
+    const md5Hash = new MD5Hash();
+    const textEncoder = new TextEncoder();
+    const hashArray = [];
+    for await (const cdHeader of zipCDIterator) {
+      const filename2 = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
+      const arrayBuffer = textEncoder.encode(filename2).buffer;
+      const md5 = await md5Hash.hash(arrayBuffer, "hex");
+      hashArray.push(concatenateArrayBuffers(hexStringToBuffer(md5), bigintToBuffer(cdHeader.localHeaderOffset)));
+    }
+    const bufferArray = hashArray.sort(compareHashes);
+    return concatenateArrayBuffersFromArray(bufferArray);
+  }
+  function compareHashes(arrA, arrB) {
+    const a = new BigUint64Array(arrA);
+    const b = new BigUint64Array(arrB);
+    return Number(a[0] === b[0] ? a[1] - b[1] : a[0] - b[0]);
+  }
+  function hexStringToBuffer(str) {
+    const byteArray = str.match(/../g)?.map((h) => parseInt(h, 16));
+    return new Uint8Array(byteArray ?? new Array(16)).buffer;
+  }
+  function bigintToBuffer(n) {
+    return new BigUint64Array([n]).buffer;
+  }
   return __toCommonJS(src_exports);
 })();
 /*! Bundled license information:

package/dist/filesystems/IndexedArchive.d.ts

@@ -0,0 +1,29 @@
+import { FileProvider } from '@loaders.gl/loader-utils';
+/**
+ * Abstract class for fetching indexed archive formats (SLPK, 3TZ). Those types of zip archive has
+ * a hash file inside that allows to increase reading speed
+ */
+export declare abstract class IndexedArchive {
+    fileProvider: FileProvider;
+    fileName?: string;
+    /**
+     * Constructor
+     * @param fileProvider - instance of a binary data reader
+     * @param hashTable - pre-loaded hashTable. If presented, getFile will skip reading the hash file
+     * @param fileName - name of the archive. It is used to add to an URL of a loader context
+     */
+    constructor(fileProvider: FileProvider, hashTable?: Record<string, bigint>, fileName?: string);
+    /**
+     * Get internal file from the archive
+     * @param path - path to the file
+     * @param mode - path mode - the logic is implemented in subclasses
+     */
+    abstract getFile(path: string, mode?: string): Promise<ArrayBuffer>;
+    /**
+     * Get file as from order ZIP arhive without using the hash file
+     * @param filename - path to the internal file
+     * @returns
+     */
+    protected getFileWithoutHash(filename: string): Promise<ArrayBuffer>;
+}
+//# sourceMappingURL=IndexedArchive.d.ts.map

package/dist/filesystems/IndexedArchive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedArchive.d.ts","sourceRoot":"","sources":["../../src/filesystems/IndexedArchive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAGtD;;;GAGG;AACH,8BAAsB,cAAc;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;gBACS,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK7F;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAEnE;;;;OAIG;cACa,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAK3E"}

package/dist/filesystems/IndexedArchive.js

@@ -0,0 +1,15 @@
+import { ZipFileSystem } from "./zip-filesystem.js";
+export class IndexedArchive {
+  constructor(fileProvider, hashTable, fileName) {
+    this.fileProvider = void 0;
+    this.fileName = void 0;
+    this.fileProvider = fileProvider;
+    this.fileName = fileName;
+  }
+  async getFileWithoutHash(filename) {
+    const zipFS = new ZipFileSystem(this.fileProvider);
+    const response = await zipFS.fetch(filename);
+    return await response.arrayBuffer();
+  }
+}
+//# sourceMappingURL=IndexedArchive.js.map

package/dist/filesystems/IndexedArchive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedArchive.js","names":["ZipFileSystem","IndexedArchive","constructor","fileProvider","hashTable","fileName","getFileWithoutHash","filename","zipFS","response","fetch","arrayBuffer"],"sources":["../../src/filesystems/IndexedArchive.ts"],"sourcesContent":["import {FileProvider} from '@loaders.gl/loader-utils';\nimport {ZipFileSystem} from './zip-filesystem';\n\n/**\n * Abstract class for fetching indexed archive formats (SLPK, 3TZ). Those types of zip archive has\n * a hash file inside that allows to increase reading speed\n */\nexport abstract class IndexedArchive {\n  public fileProvider: FileProvider;\n  public fileName?: string;\n\n  /**\n   * Constructor\n   * @param fileProvider - instance of a binary data reader\n   * @param hashTable - pre-loaded hashTable. If presented, getFile will skip reading the hash file\n   * @param fileName - name of the archive. It is used to add to an URL of a loader context\n   */\n  constructor(fileProvider: FileProvider, hashTable?: Record<string, bigint>, fileName?: string) {\n    this.fileProvider = fileProvider;\n    this.fileName = fileName;\n  }\n\n  /**\n   * Get internal file from the archive\n   * @param path - path to the file\n   * @param mode - path mode - the logic is implemented in subclasses\n   */\n  abstract getFile(path: string, mode?: string): Promise<ArrayBuffer>;\n\n  /**\n   * Get file as from order ZIP arhive without using the hash file\n   * @param filename - path to the internal file\n   * @returns\n   */\n  protected async getFileWithoutHash(filename: string): Promise<ArrayBuffer> {\n    const zipFS = new ZipFileSystem(this.fileProvider);\n    const response = await zipFS.fetch(filename);\n    return await response.arrayBuffer();\n  }\n}\n"],"mappings":"SACQA,aAAa;AAMrB,OAAO,MAAeC,cAAc,CAAC;EAUnCC,WAAWA,CAACC,YAA0B,EAAEC,SAAkC,EAAEC,QAAiB,EAAE;IAAA,KATxFF,YAAY;IAAA,KACZE,QAAQ;IASb,IAAI,CAACF,YAAY,GAAGA,YAAY;IAChC,IAAI,CAACE,QAAQ,GAAGA,QAAQ;EAC1B;EAcA,MAAgBC,kBAAkBA,CAACC,QAAgB,EAAwB;IACzE,MAAMC,KAAK,GAAG,IAAIR,aAAa,CAAC,IAAI,CAACG,YAAY,CAAC;IAClD,MAAMM,QAAQ,GAAG,MAAMD,KAAK,CAACE,KAAK,CAACH,QAAQ,CAAC;IAC5C,OAAO,MAAME,QAAQ,CAACE,WAAW,CAAC,CAAC;EACrC;AACF"}

package/dist/filesystems/zip-filesystem.d.ts

@@ -1,6 +1,12 @@
 import { FileSystem } from '@loaders.gl/loader-utils';
 import { FileProvider } from '@loaders.gl/loader-utils';
 import { ZipCDFileHeader } from '../parse-zip/cd-file-header';
+import { IndexedArchive } from './IndexedArchive';
+export type CompressionHandler = (compressedFile: ArrayBuffer) => Promise<ArrayBuffer>;
+/** Handling different compression types in zip */
+export declare const ZIP_COMPRESSION_HANDLERS: {
+    [key: number]: CompressionHandler;
+};
 /**
  * FileSystem adapter for a ZIP file
  * Holds FileProvider object that provides random access to archived files
@@ -9,11 +15,12 @@ export declare class ZipFileSystem implements FileSystem {
     /** FileProvider instance promise */
     protected fileProvider: FileProvider | null;
     fileName?: string;
+    archive: IndexedArchive | null;
     /**
      * Constructor
      * @param file - instance of FileProvider or file path string
      */
-    constructor(file: FileProvider | string);
+    constructor(file: FileProvider | IndexedArchive | string);
     /** Clean up resources */
     destroy(): Promise<void>;
     /**

package/dist/filesystems/zip-filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zip-filesystem.d.ts","sourceRoot":"","sources":["../../src/filesystems/zip-filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,UAAU,EAAY,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAC,YAAY,EAAiB,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAC,eAAe,EAA0B,MAAM,6BAA6B,CAAC;AAiBrF;;;GAGG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,oCAAoC;IACpC,SAAS,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;gBACS,IAAI,EAAE,YAAY,GAAG,MAAM;IAcvC,yBAAyB;IACnB,OAAO;IAMb;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYlC;;;;OAIG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC;IAKvE;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8BhD;;;;OAIG;YACW,eAAe;CAiB9B"}
+{"version":3,"file":"zip-filesystem.d.ts","sourceRoot":"","sources":["../../src/filesystems/zip-filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,UAAU,EAAY,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAC,YAAY,EAAiB,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAC,eAAe,EAA0B,MAAM,6BAA6B,CAAC;AAGrF,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AACvF,kDAAkD;AAClD,eAAO,MAAM,wBAAwB,EAAE;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CASxE,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,oCAAoC;IACpC,SAAS,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAQ;IAE7C;;;OAGG;gBACS,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,MAAM;IAkBxD,yBAAyB;IACnB,OAAO;IAMb;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYlC;;;;OAIG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC;IAKvE;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsChD;;;;OAIG;YACW,eAAe;CAiB9B"}

package/dist/filesystems/zip-filesystem.js

@@ -4,7 +4,8 @@ import { FileHandleFile } from '@loaders.gl/loader-utils';
 import { makeZipCDHeaderIterator } from "../parse-zip/cd-file-header.js";
 import { parseZipLocalFileHeader } from "../parse-zip/local-file-header.js";
 import { DeflateCompression } from '@loaders.gl/compression';
-const COMPRESSION_METHODS = {
+import { IndexedArchive } from "./IndexedArchive.js";
+export const ZIP_COMPRESSION_HANDLERS = {
   0: async compressedFile => compressedFile,
   8: async compressedFile => {
     const compression = new DeflateCompression({
@@ -18,6 +19,7 @@ export class ZipFileSystem {
   constructor(file) {
     this.fileProvider = null;
     this.fileName = void 0;
+    this.archive = null;
     if (typeof file === 'string') {
       this.fileName = file;
       if (!isBrowser) {
@@ -25,6 +27,10 @@ export class ZipFileSystem {
       } else {
         throw new Error('Cannot open file for random access in a WEB browser');
       }
+    } else if (file instanceof IndexedArchive) {
+      this.fileProvider = file.fileProvider;
+      this.archive = file;
+      this.fileName = file.fileName;
     } else if (isFileProvider(file)) {
       this.fileProvider = file;
     }
@@ -53,23 +59,28 @@ export class ZipFileSystem {
     };
   }
   async fetch(filename) {
-    if (!this.fileProvider) {
-      throw new Error('No data detected in the zip archive');
-    }
-    const cdFileHeader = await this.getCDFileHeader(filename);
-    const localFileHeader = await parseZipLocalFileHeader(cdFileHeader.localHeaderOffset, this.fileProvider);
-    if (!localFileHeader) {
-      throw new Error('Local file header has not been found in the zip archive`');
-    }
-    const compressionHandler = COMPRESSION_METHODS[localFileHeader.compressionMethod.toString()];
-    if (!compressionHandler) {
-      throw Error('Only Deflation compression is supported');
+    let uncompressedFile;
+    if (this.archive) {
+      uncompressedFile = await this.archive.getFile(filename, 'http');
+    } else {
+      if (!this.fileProvider) {
+        throw new Error('No data detected in the zip archive');
+      }
+      const cdFileHeader = await this.getCDFileHeader(filename);
+      const localFileHeader = await parseZipLocalFileHeader(cdFileHeader.localHeaderOffset, this.fileProvider);
+      if (!localFileHeader) {
+        throw new Error('Local file header has not been found in the zip archive`');
+      }
+      const compressionHandler = ZIP_COMPRESSION_HANDLERS[localFileHeader.compressionMethod.toString()];
+      if (!compressionHandler) {
+        throw Error('Only Deflation compression is supported');
+      }
+      const compressedFile = await this.fileProvider.slice(localFileHeader.fileDataOffset, localFileHeader.fileDataOffset + localFileHeader.compressedSize);
+      uncompressedFile = await compressionHandler(compressedFile);
     }
-    const compressedFile = await this.fileProvider.slice(localFileHeader.fileDataOffset, localFileHeader.fileDataOffset + localFileHeader.compressedSize);
-    const uncompressedFile = await compressionHandler(compressedFile);
     const response = new Response(uncompressedFile);
     Object.defineProperty(response, 'url', {
-      value: `${this.fileName || ''}/${filename}`
+      value: filename ? `${this.fileName || ''}/${filename}` : this.fileName || ''
     });
     return response;
   }

package/dist/filesystems/zip-filesystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"zip-filesystem.js","names":["isBrowser","isFileProvider","FileHandleFile","makeZipCDHeaderIterator","parseZipLocalFileHeader","DeflateCompression","COMPRESSION_METHODS","compressedFile","compression","raw","decompressedData","decompress","ZipFileSystem","constructor","file","fileProvider","fileName","Error","destroy","readdir","fileNames","zipCDIterator","cdHeader","push","stat","filename","cdFileHeader","getCDFileHeader","size","Number","uncompressedSize","fetch","localFileHeader","localHeaderOffset","compressionHandler","compressionMethod","toString","slice","fileDataOffset","compressedSize","uncompressedFile","response","Response","Object","defineProperty","value","result"],"sources":["../../src/filesystems/zip-filesystem.ts"],"sourcesContent":["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {FileSystem, isBrowser} from '@loaders.gl/loader-utils';\nimport {FileProvider, isFileProvider} from '@loaders.gl/loader-utils';\nimport {FileHandleFile} from '@loaders.gl/loader-utils';\nimport {ZipCDFileHeader, makeZipCDHeaderIterator} from '../parse-zip/cd-file-header';\nimport {parseZipLocalFileHeader} from '../parse-zip/local-file-header';\nimport {DeflateCompression} from '@loaders.gl/compression';\n\ntype CompressionHandler = (compressedFile: ArrayBuffer) => Promise<ArrayBuffer>;\n/** Handling different compression types in zip */\nconst COMPRESSION_METHODS: {[key: number]: CompressionHandler} = {\n  /** No compression */\n  0: async (compressedFile) => compressedFile,\n  /** Deflation */\n  8: async (compressedFile) => {\n    const compression = new DeflateCompression({raw: true});\n    const decompressedData = await compression.decompress(compressedFile);\n    return decompressedData;\n  }\n};\n\n/**\n * FileSystem adapter for a ZIP file\n * Holds FileProvider object that provides random access to archived files\n */\nexport class ZipFileSystem implements FileSystem {\n  /** FileProvider instance promise */\n  protected fileProvider: FileProvider | null = null;\n  public fileName?: string;\n\n  /**\n   * Constructor\n   * @param file - instance of FileProvider or file path string\n   */\n  constructor(file: FileProvider | string) {\n    // Try to open file in NodeJS\n    if (typeof file === 'string') {\n      this.fileName = file;\n      if (!isBrowser) {\n        this.fileProvider = new FileHandleFile(file);\n      } else {\n        throw new Error('Cannot open file for random access in a WEB browser');\n      }\n    } else if (isFileProvider(file)) {\n      this.fileProvider = file;\n    }\n  }\n\n  /** Clean up resources */\n  async destroy() {\n    if (this.fileProvider) {\n      await this.fileProvider.destroy();\n    }\n  }\n\n  /**\n   * Get file names list from zip archive\n   * @returns array of file names\n   */\n  async readdir(): Promise<string[]> {\n    if (!this.fileProvider) {\n      throw new Error('No data detected in the zip archive');\n    }\n    const fileNames: string[] = [];\n    const zipCDIterator = makeZipCDHeaderIterator(this.fileProvider);\n    for await (const cdHeader of zipCDIterator) {\n      fileNames.push(cdHeader.fileName);\n    }\n    return fileNames;\n  }\n\n  /**\n   * Get file metadata\n   * @param filename - name of a file\n   * @returns central directory data\n   */\n  async stat(filename: string): Promise<ZipCDFileHeader & {size: number}> {\n    const cdFileHeader = await this.getCDFileHeader(filename);\n    return {...cdFileHeader, size: Number(cdFileHeader.uncompressedSize)};\n  }\n\n  /**\n   * Implementation of fetch against this file system\n   * @param filename - name of a file\n   * @returns - Response with file data\n   */\n  async fetch(filename: string): Promise<Response> {\n    if (!this.fileProvider) {\n      throw new Error('No data detected in the zip archive');\n    }\n    const cdFileHeader = await this.getCDFileHeader(filename);\n    const localFileHeader = await parseZipLocalFileHeader(\n      cdFileHeader.localHeaderOffset,\n      this.fileProvider\n    );\n    if (!localFileHeader) {\n      throw new Error('Local file header has not been found in the zip archive`');\n    }\n\n    const compressionHandler = COMPRESSION_METHODS[localFileHeader.compressionMethod.toString()];\n    if (!compressionHandler) {\n      throw Error('Only Deflation compression is supported');\n    }\n\n    const compressedFile = await this.fileProvider.slice(\n      localFileHeader.fileDataOffset,\n      localFileHeader.fileDataOffset + localFileHeader.compressedSize\n    );\n\n    const uncompressedFile = await compressionHandler(compressedFile);\n\n    const response = new Response(uncompressedFile);\n    Object.defineProperty(response, 'url', {value: `${this.fileName || ''}/${filename}`});\n    return response;\n  }\n\n  /**\n   * Get central directory file header\n   * @param filename - name of a file\n   * @returns central directory file header\n   */\n  private async getCDFileHeader(filename: string): Promise<ZipCDFileHeader> {\n    if (!this.fileProvider) {\n      throw new Error('No data detected in the zip archive');\n    }\n    const zipCDIterator = makeZipCDHeaderIterator(this.fileProvider);\n    let result: ZipCDFileHeader | null = null;\n    for await (const cdHeader of zipCDIterator) {\n      if (cdHeader.fileName === filename) {\n        result = cdHeader;\n        break;\n      }\n    }\n    if (!result) {\n      throw new Error('File has not been found in the zip archive');\n    }\n    return result;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"zip-filesystem.js","names":["isBrowser","isFileProvider","FileHandleFile","makeZipCDHeaderIterator","parseZipLocalFileHeader","DeflateCompression","IndexedArchive","ZIP_COMPRESSION_HANDLERS","compressedFile","compression","raw","decompressedData","decompress","ZipFileSystem","constructor","file","fileProvider","fileName","archive","Error","destroy","readdir","fileNames","zipCDIterator","cdHeader","push","stat","filename","cdFileHeader","getCDFileHeader","size","Number","uncompressedSize","fetch","uncompressedFile","getFile","localFileHeader","localHeaderOffset","compressionHandler","compressionMethod","toString","slice","fileDataOffset","compressedSize","response","Response","Object","defineProperty","value","result"],"sources":["../../src/filesystems/zip-filesystem.ts"],"sourcesContent":["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {FileSystem, isBrowser} from '@loaders.gl/loader-utils';\nimport {FileProvider, isFileProvider} from '@loaders.gl/loader-utils';\nimport {FileHandleFile} from '@loaders.gl/loader-utils';\nimport {ZipCDFileHeader, makeZipCDHeaderIterator} from '../parse-zip/cd-file-header';\nimport {parseZipLocalFileHeader} from '../parse-zip/local-file-header';\nimport {DeflateCompression} from '@loaders.gl/compression';\nimport {IndexedArchive} from './IndexedArchive';\n\nexport type CompressionHandler = (compressedFile: ArrayBuffer) => Promise<ArrayBuffer>;\n/** Handling different compression types in zip */\nexport const ZIP_COMPRESSION_HANDLERS: {[key: number]: CompressionHandler} = {\n  /** No compression */\n  0: async (compressedFile) => compressedFile,\n  /** Deflation */\n  8: async (compressedFile) => {\n    const compression = new DeflateCompression({raw: true});\n    const decompressedData = await compression.decompress(compressedFile);\n    return decompressedData;\n  }\n};\n\n/**\n * FileSystem adapter for a ZIP file\n * Holds FileProvider object that provides random access to archived files\n */\nexport class ZipFileSystem implements FileSystem {\n  /** FileProvider instance promise */\n  protected fileProvider: FileProvider | null = null;\n  public fileName?: string;\n  public archive: IndexedArchive | null = null;\n\n  /**\n   * Constructor\n   * @param file - instance of FileProvider or file path string\n   */\n  constructor(file: FileProvider | IndexedArchive | string) {\n    // Try to open file in NodeJS\n    if (typeof file === 'string') {\n      this.fileName = file;\n      if (!isBrowser) {\n        this.fileProvider = new FileHandleFile(file);\n      } else {\n        throw new Error('Cannot open file for random access in a WEB browser');\n      }\n    } else if (file instanceof IndexedArchive) {\n      this.fileProvider = file.fileProvider;\n      this.archive = file;\n      this.fileName = file.fileName;\n    } else if (isFileProvider(file)) {\n      this.fileProvider = file;\n    }\n  }\n\n  /** Clean up resources */\n  async destroy() {\n    if (this.fileProvider) {\n      await this.fileProvider.destroy();\n    }\n  }\n\n  /**\n   * Get file names list from zip archive\n   * @returns array of file names\n   */\n  async readdir(): Promise<string[]> {\n    if (!this.fileProvider) {\n      throw new Error('No data detected in the zip archive');\n    }\n    const fileNames: string[] = [];\n    const zipCDIterator = makeZipCDHeaderIterator(this.fileProvider);\n    for await (const cdHeader of zipCDIterator) {\n      fileNames.push(cdHeader.fileName);\n    }\n    return fileNames;\n  }\n\n  /**\n   * Get file metadata\n   * @param filename - name of a file\n   * @returns central directory data\n   */\n  async stat(filename: string): Promise<ZipCDFileHeader & {size: number}> {\n    const cdFileHeader = await this.getCDFileHeader(filename);\n    return {...cdFileHeader, size: Number(cdFileHeader.uncompressedSize)};\n  }\n\n  /**\n   * Implementation of fetch against this file system\n   * @param filename - name of a file\n   * @returns - Response with file data\n   */\n  async fetch(filename: string): Promise<Response> {\n    let uncompressedFile: ArrayBuffer;\n    if (this.archive) {\n      uncompressedFile = await this.archive.getFile(filename, 'http');\n    } else {\n      if (!this.fileProvider) {\n        throw new Error('No data detected in the zip archive');\n      }\n      const cdFileHeader = await this.getCDFileHeader(filename);\n      const localFileHeader = await parseZipLocalFileHeader(\n        cdFileHeader.localHeaderOffset,\n        this.fileProvider\n      );\n      if (!localFileHeader) {\n        throw new Error('Local file header has not been found in the zip archive`');\n      }\n\n      const compressionHandler =\n        ZIP_COMPRESSION_HANDLERS[localFileHeader.compressionMethod.toString()];\n      if (!compressionHandler) {\n        throw Error('Only Deflation compression is supported');\n      }\n\n      const compressedFile = await this.fileProvider.slice(\n        localFileHeader.fileDataOffset,\n        localFileHeader.fileDataOffset + localFileHeader.compressedSize\n      );\n\n      uncompressedFile = await compressionHandler(compressedFile);\n    }\n\n    const response = new Response(uncompressedFile);\n    Object.defineProperty(response, 'url', {\n      value: filename ? `${this.fileName || ''}/${filename}` : this.fileName || ''\n    });\n    return response;\n  }\n\n  /**\n   * Get central directory file header\n   * @param filename - name of a file\n   * @returns central directory file header\n   */\n  private async getCDFileHeader(filename: string): Promise<ZipCDFileHeader> {\n    if (!this.fileProvider) {\n      throw new Error('No data detected in the zip archive');\n    }\n    const zipCDIterator = makeZipCDHeaderIterator(this.fileProvider);\n    let result: ZipCDFileHeader | null = null;\n    for await (const cdHeader of zipCDIterator) {\n      if (cdHeader.fileName === filename) {\n        result = cdHeader;\n        break;\n      }\n    }\n    if (!result) {\n      throw new Error('File has not been found in the zip archive');\n    }\n    return result;\n  }\n}\n"],"mappings":"AAIA,SAAoBA,SAAS,QAAO,0BAA0B;AAC9D,SAAsBC,cAAc,QAAO,0BAA0B;AACrE,SAAQC,cAAc,QAAO,0BAA0B;AAAC,SAC/BC,uBAAuB;AAAA,SACxCC,uBAAuB;AAC/B,SAAQC,kBAAkB,QAAO,yBAAyB;AAAC,SACnDC,cAAc;AAItB,OAAO,MAAMC,wBAA6D,GAAG;EAE3E,CAAC,EAAE,MAAOC,cAAc,IAAKA,cAAc;EAE3C,CAAC,EAAE,MAAOA,cAAc,IAAK;IAC3B,MAAMC,WAAW,GAAG,IAAIJ,kBAAkB,CAAC;MAACK,GAAG,EAAE;IAAI,CAAC,CAAC;IACvD,MAAMC,gBAAgB,GAAG,MAAMF,WAAW,CAACG,UAAU,CAACJ,cAAc,CAAC;IACrE,OAAOG,gBAAgB;EACzB;AACF,CAAC;AAMD,OAAO,MAAME,aAAa,CAAuB;EAU/CC,WAAWA,CAACC,IAA4C,EAAE;IAAA,KARhDC,YAAY,GAAwB,IAAI;IAAA,KAC3CC,QAAQ;IAAA,KACRC,OAAO,GAA0B,IAAI;IAQ1C,IAAI,OAAOH,IAAI,KAAK,QAAQ,EAAE;MAC5B,IAAI,CAACE,QAAQ,GAAGF,IAAI;MACpB,IAAI,CAACf,SAAS,EAAE;QACd,IAAI,CAACgB,YAAY,GAAG,IAAId,cAAc,CAACa,IAAI,CAAC;MAC9C,CAAC,MAAM;QACL,MAAM,IAAII,KAAK,CAAC,qDAAqD,CAAC;MACxE;IACF,CAAC,MAAM,IAAIJ,IAAI,YAAYT,cAAc,EAAE;MACzC,IAAI,CAACU,YAAY,GAAGD,IAAI,CAACC,YAAY;MACrC,IAAI,CAACE,OAAO,GAAGH,IAAI;MACnB,IAAI,CAACE,QAAQ,GAAGF,IAAI,CAACE,QAAQ;IAC/B,CAAC,MAAM,IAAIhB,cAAc,CAACc,IAAI,CAAC,EAAE;MAC/B,IAAI,CAACC,YAAY,GAAGD,IAAI;IAC1B;EACF;EAGA,MAAMK,OAAOA,CAAA,EAAG;IACd,IAAI,IAAI,CAACJ,YAAY,EAAE;MACrB,MAAM,IAAI,CAACA,YAAY,CAACI,OAAO,CAAC,CAAC;IACnC;EACF;EAMA,MAAMC,OAAOA,CAAA,EAAsB;IACjC,IAAI,CAAC,IAAI,CAACL,YAAY,EAAE;MACtB,MAAM,IAAIG,KAAK,CAAC,qCAAqC,CAAC;IACxD;IACA,MAAMG,SAAmB,GAAG,EAAE;IAC9B,MAAMC,aAAa,GAAGpB,uBAAuB,CAAC,IAAI,CAACa,YAAY,CAAC;IAChE,WAAW,MAAMQ,QAAQ,IAAID,aAAa,EAAE;MAC1CD,SAAS,CAACG,IAAI,CAACD,QAAQ,CAACP,QAAQ,CAAC;IACnC;IACA,OAAOK,SAAS;EAClB;EAOA,MAAMI,IAAIA,CAACC,QAAgB,EAA6C;IACtE,MAAMC,YAAY,GAAG,MAAM,IAAI,CAACC,eAAe,CAACF,QAAQ,CAAC;IACzD,OAAO;MAAC,GAAGC,YAAY;MAAEE,IAAI,EAAEC,MAAM,CAACH,YAAY,CAACI,gBAAgB;IAAC,CAAC;EACvE;EAOA,MAAMC,KAAKA,CAACN,QAAgB,EAAqB;IAC/C,IAAIO,gBAA6B;IACjC,IAAI,IAAI,CAAChB,OAAO,EAAE;MAChBgB,gBAAgB,GAAG,MAAM,IAAI,CAAChB,OAAO,CAACiB,OAAO,CAACR,QAAQ,EAAE,MAAM,CAAC;IACjE,CAAC,MAAM;MACL,IAAI,CAAC,IAAI,CAACX,YAAY,EAAE;QACtB,MAAM,IAAIG,KAAK,CAAC,qCAAqC,CAAC;MACxD;MACA,MAAMS,YAAY,GAAG,MAAM,IAAI,CAACC,eAAe,CAACF,QAAQ,CAAC;MACzD,MAAMS,eAAe,GAAG,MAAMhC,uBAAuB,CACnDwB,YAAY,CAACS,iBAAiB,EAC9B,IAAI,CAACrB,YACP,CAAC;MACD,IAAI,CAACoB,eAAe,EAAE;QACpB,MAAM,IAAIjB,KAAK,CAAC,0DAA0D,CAAC;MAC7E;MAEA,MAAMmB,kBAAkB,GACtB/B,wBAAwB,CAAC6B,eAAe,CAACG,iBAAiB,CAACC,QAAQ,CAAC,CAAC,CAAC;MACxE,IAAI,CAACF,kBAAkB,EAAE;QACvB,MAAMnB,KAAK,CAAC,yCAAyC,CAAC;MACxD;MAEA,MAAMX,cAAc,GAAG,MAAM,IAAI,CAACQ,YAAY,CAACyB,KAAK,CAClDL,eAAe,CAACM,cAAc,EAC9BN,eAAe,CAACM,cAAc,GAAGN,eAAe,CAACO,cACnD,CAAC;MAEDT,gBAAgB,GAAG,MAAMI,kBAAkB,CAAC9B,cAAc,CAAC;IAC7D;IAEA,MAAMoC,QAAQ,GAAG,IAAIC,QAAQ,CAACX,gBAAgB,CAAC;IAC/CY,MAAM,CAACC,cAAc,CAACH,QAAQ,EAAE,KAAK,EAAE;MACrCI,KAAK,EAAErB,QAAQ,GAAI,GAAE,IAAI,CAACV,QAAQ,IAAI,EAAG,IAAGU,QAAS,EAAC,GAAG,IAAI,CAACV,QAAQ,IAAI;IAC5E,CAAC,CAAC;IACF,OAAO2B,QAAQ;EACjB;EAOA,MAAcf,eAAeA,CAACF,QAAgB,EAA4B;IACxE,IAAI,CAAC,IAAI,CAACX,YAAY,EAAE;MACtB,MAAM,IAAIG,KAAK,CAAC,qCAAqC,CAAC;IACxD;IACA,MAAMI,aAAa,GAAGpB,uBAAuB,CAAC,IAAI,CAACa,YAAY,CAAC;IAChE,IAAIiC,MAA8B,GAAG,IAAI;IACzC,WAAW,MAAMzB,QAAQ,IAAID,aAAa,EAAE;MAC1C,IAAIC,QAAQ,CAACP,QAAQ,KAAKU,QAAQ,EAAE;QAClCsB,MAAM,GAAGzB,QAAQ;QACjB;MACF;IACF;IACA,IAAI,CAACyB,MAAM,EAAE;MACX,MAAM,IAAI9B,KAAK,CAAC,4CAA4C,CAAC;IAC/D;IACA,OAAO8B,MAAM;EACf;AACF"}

package/dist/index.cjs

@@ -31,7 +31,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   CD_HEADER_SIGNATURE: () => signature2,
+  IndexedArchive: () => IndexedArchive,
   TarBuilder: () => TarBuilder,
+  ZIP_COMPRESSION_HANDLERS: () => ZIP_COMPRESSION_HANDLERS,
   ZipFileSystem: () => ZipFileSystem,
   ZipLoader: () => ZipLoader,
   ZipWriter: () => ZipWriter,
@@ -1188,73 +1190,12 @@ function pathJoin(...paths) {
   return import_loader_utils5.path.join(...resPaths);
 }
 
-// src/hash-file-utility.ts
-var import_crypto2 = require("@loaders.gl/crypto");
-var import_loader_utils6 = require("@loaders.gl/loader-utils");
-function parseHashTable(arrayBuffer) {
-  const dataView = new DataView(arrayBuffer);
-  const hashMap = {};
-  for (let i = 0; i < arrayBuffer.byteLength; i = i + 24) {
-    const offset = dataView.getBigUint64(i + 16, true);
-    const hash = bufferToHex(arrayBuffer, i, 16);
-    hashMap[hash] = offset;
-  }
-  return hashMap;
-}
-function bufferToHex(buffer, start, length) {
-  return [...new Uint8Array(buffer, start, length)].map((x) => x.toString(16).padStart(2, "0")).join("");
-}
-async function makeHashTableFromZipHeaders(fileProvider) {
-  const zipCDIterator = makeZipCDHeaderIterator(fileProvider);
-  return getHashTable(zipCDIterator);
-}
-async function getHashTable(zipCDIterator) {
-  const md5Hash = new import_crypto2.MD5Hash();
-  const textEncoder = new TextEncoder();
-  const hashTable = {};
-  for await (const cdHeader of zipCDIterator) {
-    const filename = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
-    const arrayBuffer = textEncoder.encode(filename).buffer;
-    const md5 = await md5Hash.hash(arrayBuffer, "hex");
-    hashTable[md5] = cdHeader.localHeaderOffset;
-  }
-  return hashTable;
-}
-async function composeHashFile(zipCDIterator) {
-  const md5Hash = new import_crypto2.MD5Hash();
-  const textEncoder = new TextEncoder();
-  const hashArray = [];
-  for await (const cdHeader of zipCDIterator) {
-    const filename = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
-    const arrayBuffer = textEncoder.encode(filename).buffer;
-    const md5 = await md5Hash.hash(arrayBuffer, "hex");
-    hashArray.push(
-      (0, import_loader_utils6.concatenateArrayBuffers)(hexStringToBuffer(md5), bigintToBuffer(cdHeader.localHeaderOffset))
-    );
-  }
-  const bufferArray = hashArray.sort(compareHashes);
-  return (0, import_loader_utils6.concatenateArrayBuffersFromArray)(bufferArray);
-}
-function compareHashes(arrA, arrB) {
-  const a = new BigUint64Array(arrA);
-  const b = new BigUint64Array(arrB);
-  return Number(a[0] === b[0] ? a[1] - b[1] : a[0] - b[0]);
-}
-function hexStringToBuffer(str) {
-  var _a;
-  const byteArray = (_a = str.match(/../g)) == null ? void 0 : _a.map((h) => parseInt(h, 16));
-  return new Uint8Array(byteArray ?? new Array(16)).buffer;
-}
-function bigintToBuffer(n) {
-  return new BigUint64Array([n]).buffer;
-}
-
 // src/filesystems/zip-filesystem.ts
+var import_loader_utils6 = require("@loaders.gl/loader-utils");
 var import_loader_utils7 = require("@loaders.gl/loader-utils");
 var import_loader_utils8 = require("@loaders.gl/loader-utils");
-var import_loader_utils9 = require("@loaders.gl/loader-utils");
 var import_compression = require("@loaders.gl/compression");
-var COMPRESSION_METHODS = {
+var ZIP_COMPRESSION_HANDLERS = {
   /** No compression */
   0: async (compressedFile) => compressedFile,
   /** Deflation */
@@ -1272,14 +1213,19 @@ var ZipFileSystem = class {
   constructor(file) {
     /** FileProvider instance promise */
     this.fileProvider = null;
+    this.archive = null;
     if (typeof file === "string") {
       this.fileName = file;
-      if (!import_loader_utils7.isBrowser) {
-        this.fileProvider = new import_loader_utils9.FileHandleFile(file);
+      if (!import_loader_utils6.isBrowser) {
+        this.fileProvider = new import_loader_utils8.FileHandleFile(file);
       } else {
         throw new Error("Cannot open file for random access in a WEB browser");
       }
-    } else if ((0, import_loader_utils8.isFileProvider)(file)) {
+    } else if (file instanceof IndexedArchive) {
+      this.fileProvider = file.fileProvider;
+      this.archive = file;
+      this.fileName = file.fileName;
+    } else if ((0, import_loader_utils7.isFileProvider)(file)) {
       this.fileProvider = file;
     }
   }
@@ -1319,28 +1265,35 @@ var ZipFileSystem = class {
    * @returns - Response with file data
    */
   async fetch(filename) {
-    if (!this.fileProvider) {
-      throw new Error("No data detected in the zip archive");
-    }
-    const cdFileHeader = await this.getCDFileHeader(filename);
-    const localFileHeader = await parseZipLocalFileHeader(
-      cdFileHeader.localHeaderOffset,
-      this.fileProvider
-    );
-    if (!localFileHeader) {
-      throw new Error("Local file header has not been found in the zip archive`");
-    }
-    const compressionHandler = COMPRESSION_METHODS[localFileHeader.compressionMethod.toString()];
-    if (!compressionHandler) {
-      throw Error("Only Deflation compression is supported");
+    let uncompressedFile;
+    if (this.archive) {
+      uncompressedFile = await this.archive.getFile(filename, "http");
+    } else {
+      if (!this.fileProvider) {
+        throw new Error("No data detected in the zip archive");
+      }
+      const cdFileHeader = await this.getCDFileHeader(filename);
+      const localFileHeader = await parseZipLocalFileHeader(
+        cdFileHeader.localHeaderOffset,
+        this.fileProvider
+      );
+      if (!localFileHeader) {
+        throw new Error("Local file header has not been found in the zip archive`");
+      }
+      const compressionHandler = ZIP_COMPRESSION_HANDLERS[localFileHeader.compressionMethod.toString()];
+      if (!compressionHandler) {
+        throw Error("Only Deflation compression is supported");
+      }
+      const compressedFile = await this.fileProvider.slice(
+        localFileHeader.fileDataOffset,
+        localFileHeader.fileDataOffset + localFileHeader.compressedSize
+      );
+      uncompressedFile = await compressionHandler(compressedFile);
     }
-    const compressedFile = await this.fileProvider.slice(
-      localFileHeader.fileDataOffset,
-      localFileHeader.fileDataOffset + localFileHeader.compressedSize
-    );
-    const uncompressedFile = await compressionHandler(compressedFile);
     const response = new Response(uncompressedFile);
-    Object.defineProperty(response, "url", { value: `${this.fileName || ""}/${filename}` });
+    Object.defineProperty(response, "url", {
+      value: filename ? `${this.fileName || ""}/${filename}` : this.fileName || ""
+    });
     return response;
   }
   /**
@@ -1366,3 +1319,88 @@ var ZipFileSystem = class {
     return result;
   }
 };
+
+// src/filesystems/IndexedArchive.ts
+var IndexedArchive = class {
+  /**
+   * Constructor
+   * @param fileProvider - instance of a binary data reader
+   * @param hashTable - pre-loaded hashTable. If presented, getFile will skip reading the hash file
+   * @param fileName - name of the archive. It is used to add to an URL of a loader context
+   */
+  constructor(fileProvider, hashTable, fileName) {
+    this.fileProvider = fileProvider;
+    this.fileName = fileName;
+  }
+  /**
+   * Get file as from order ZIP arhive without using the hash file
+   * @param filename - path to the internal file
+   * @returns
+   */
+  async getFileWithoutHash(filename) {
+    const zipFS = new ZipFileSystem(this.fileProvider);
+    const response = await zipFS.fetch(filename);
+    return await response.arrayBuffer();
+  }
+};
+
+// src/hash-file-utility.ts
+var import_crypto2 = require("@loaders.gl/crypto");
+var import_loader_utils9 = require("@loaders.gl/loader-utils");
+function parseHashTable(arrayBuffer) {
+  const dataView = new DataView(arrayBuffer);
+  const hashMap = {};
+  for (let i = 0; i < arrayBuffer.byteLength; i = i + 24) {
+    const offset = dataView.getBigUint64(i + 16, true);
+    const hash = bufferToHex(arrayBuffer, i, 16);
+    hashMap[hash] = offset;
+  }
+  return hashMap;
+}
+function bufferToHex(buffer, start, length) {
+  return [...new Uint8Array(buffer, start, length)].map((x) => x.toString(16).padStart(2, "0")).join("");
+}
+async function makeHashTableFromZipHeaders(fileProvider) {
+  const zipCDIterator = makeZipCDHeaderIterator(fileProvider);
+  return getHashTable(zipCDIterator);
+}
+async function getHashTable(zipCDIterator) {
+  const md5Hash = new import_crypto2.MD5Hash();
+  const textEncoder = new TextEncoder();
+  const hashTable = {};
+  for await (const cdHeader of zipCDIterator) {
+    const filename = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
+    const arrayBuffer = textEncoder.encode(filename).buffer;
+    const md5 = await md5Hash.hash(arrayBuffer, "hex");
+    hashTable[md5] = cdHeader.localHeaderOffset;
+  }
+  return hashTable;
+}
+async function composeHashFile(zipCDIterator) {
+  const md5Hash = new import_crypto2.MD5Hash();
+  const textEncoder = new TextEncoder();
+  const hashArray = [];
+  for await (const cdHeader of zipCDIterator) {
+    const filename = cdHeader.fileName.split("\\").join("/").toLocaleLowerCase();
+    const arrayBuffer = textEncoder.encode(filename).buffer;
+    const md5 = await md5Hash.hash(arrayBuffer, "hex");
+    hashArray.push(
+      (0, import_loader_utils9.concatenateArrayBuffers)(hexStringToBuffer(md5), bigintToBuffer(cdHeader.localHeaderOffset))
+    );
+  }
+  const bufferArray = hashArray.sort(compareHashes);
+  return (0, import_loader_utils9.concatenateArrayBuffersFromArray)(bufferArray);
+}
+function compareHashes(arrA, arrB) {
+  const a = new BigUint64Array(arrA);
+  const b = new BigUint64Array(arrB);
+  return Number(a[0] === b[0] ? a[1] - b[1] : a[0] - b[0]);
+}
+function hexStringToBuffer(str) {
+  var _a;
+  const byteArray = (_a = str.match(/../g)) == null ? void 0 : _a.map((h) => parseInt(h, 16));
+  return new Uint8Array(byteArray ?? new Array(16)).buffer;
+}
+function bigintToBuffer(n) {
+  return new BigUint64Array([n]).buffer;
+}

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export { parseZipLocalFileHeader, signature as localHeaderSignature, generateLoc
 export { parseEoCDRecord } from './parse-zip/end-of-central-directory';
 export { searchFromTheEnd } from './parse-zip/search-from-the-end';
 export { addOneFile, createZip } from './parse-zip/zip-composition';
+export { IndexedArchive } from './filesystems/IndexedArchive';
 export { parseHashTable, makeHashTableFromZipHeaders, composeHashFile } from './hash-file-utility';
-export { ZipFileSystem } from './filesystems/zip-filesystem';
+export { ZipFileSystem, ZIP_COMPRESSION_HANDLERS } from './filesystems/zip-filesystem';
+export type { CompressionHandler } from './filesystems/zip-filesystem';
 //# 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":"AAIA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAEzC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,SAAS,IAAI,mBAAmB,EAChC,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,SAAS,IAAI,oBAAoB,EACjC,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAC,eAAe,EAAC,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAC,gBAAgB,EAAC,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAC,UAAU,EAAE,SAAS,EAAC,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EAAC,cAAc,EAAE,2BAA2B,EAAE,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAEzC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,SAAS,IAAI,mBAAmB,EAChC,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,SAAS,IAAI,oBAAoB,EACjC,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAC,eAAe,EAAC,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAC,gBAAgB,EAAC,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAC,UAAU,EAAE,SAAS,EAAC,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAC,cAAc,EAAE,2BAA2B,EAAE,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAAC,aAAa,EAAE,wBAAwB,EAAC,MAAM,8BAA8B,CAAC;AACrF,YAAY,EAAC,kBAAkB,EAAC,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export { parseZipLocalFileHeader, signature as localHeaderSignature, generateLoc
 export { parseEoCDRecord } from "./parse-zip/end-of-central-directory.js";
 export { searchFromTheEnd } from "./parse-zip/search-from-the-end.js";
 export { addOneFile, createZip } from "./parse-zip/zip-composition.js";
+export { IndexedArchive } from "./filesystems/IndexedArchive.js";
 export { parseHashTable, makeHashTableFromZipHeaders, composeHashFile } from "./hash-file-utility.js";
-export { ZipFileSystem } from "./filesystems/zip-filesystem.js";
+export { ZipFileSystem, ZIP_COMPRESSION_HANDLERS } from "./filesystems/zip-filesystem.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["ZipLoader","ZipWriter","TarBuilder","parseZipCDFileHeader","makeZipCDHeaderIterator","signature","CD_HEADER_SIGNATURE","generateCDHeader","parseZipLocalFileHeader","localHeaderSignature","generateLocalHeader","parseEoCDRecord","searchFromTheEnd","addOneFile","createZip","parseHashTable","makeHashTableFromZipHeaders","composeHashFile","ZipFileSystem"],"sources":["../src/index.ts"],"sourcesContent":["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nexport {ZipLoader} from './zip-loader';\nexport {ZipWriter} from './zip-writer';\nexport {TarBuilder} from './tar-builder';\n\nexport {\n  parseZipCDFileHeader,\n  makeZipCDHeaderIterator,\n  signature as CD_HEADER_SIGNATURE,\n  generateCDHeader\n} from './parse-zip/cd-file-header';\nexport {\n  parseZipLocalFileHeader,\n  signature as localHeaderSignature,\n  generateLocalHeader\n} from './parse-zip/local-file-header';\nexport {parseEoCDRecord} from './parse-zip/end-of-central-directory';\nexport {searchFromTheEnd} from './parse-zip/search-from-the-end';\nexport {addOneFile, createZip} from './parse-zip/zip-composition';\n\n// export type {HashElement} from './hash-file-utility';\nexport {parseHashTable, makeHashTableFromZipHeaders, composeHashFile} from './hash-file-utility';\n\nexport {ZipFileSystem} from './filesystems/zip-filesystem';\n"],"mappings":"SAIQA,SAAS;AAAA,SACTC,SAAS;AAAA,SACTC,UAAU;AAAA,SAGhBC,oBAAoB,EACpBC,uBAAuB,EACvBC,SAAS,IAAIC,mBAAmB,EAChCC,gBAAgB;AAAA,SAGhBC,uBAAuB,EACvBH,SAAS,IAAII,oBAAoB,EACjCC,mBAAmB;AAAA,SAEbC,eAAe;AAAA,SACfC,gBAAgB;AAAA,SAChBC,UAAU,EAAEC,SAAS;AAAA,SAGrBC,cAAc,EAAEC,2BAA2B,EAAEC,eAAe;AAAA,SAE5DC,aAAa"}
+{"version":3,"file":"index.js","names":["ZipLoader","ZipWriter","TarBuilder","parseZipCDFileHeader","makeZipCDHeaderIterator","signature","CD_HEADER_SIGNATURE","generateCDHeader","parseZipLocalFileHeader","localHeaderSignature","generateLocalHeader","parseEoCDRecord","searchFromTheEnd","addOneFile","createZip","IndexedArchive","parseHashTable","makeHashTableFromZipHeaders","composeHashFile","ZipFileSystem","ZIP_COMPRESSION_HANDLERS"],"sources":["../src/index.ts"],"sourcesContent":["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nexport {ZipLoader} from './zip-loader';\nexport {ZipWriter} from './zip-writer';\nexport {TarBuilder} from './tar-builder';\n\nexport {\n  parseZipCDFileHeader,\n  makeZipCDHeaderIterator,\n  signature as CD_HEADER_SIGNATURE,\n  generateCDHeader\n} from './parse-zip/cd-file-header';\nexport {\n  parseZipLocalFileHeader,\n  signature as localHeaderSignature,\n  generateLocalHeader\n} from './parse-zip/local-file-header';\nexport {parseEoCDRecord} from './parse-zip/end-of-central-directory';\nexport {searchFromTheEnd} from './parse-zip/search-from-the-end';\nexport {addOneFile, createZip} from './parse-zip/zip-composition';\n\n// export type {HashElement} from './hash-file-utility';\nexport {IndexedArchive} from './filesystems/IndexedArchive';\nexport {parseHashTable, makeHashTableFromZipHeaders, composeHashFile} from './hash-file-utility';\n\nexport {ZipFileSystem, ZIP_COMPRESSION_HANDLERS} from './filesystems/zip-filesystem';\nexport type {CompressionHandler} from './filesystems/zip-filesystem';\n"],"mappings":"SAIQA,SAAS;AAAA,SACTC,SAAS;AAAA,SACTC,UAAU;AAAA,SAGhBC,oBAAoB,EACpBC,uBAAuB,EACvBC,SAAS,IAAIC,mBAAmB,EAChCC,gBAAgB;AAAA,SAGhBC,uBAAuB,EACvBH,SAAS,IAAII,oBAAoB,EACjCC,mBAAmB;AAAA,SAEbC,eAAe;AAAA,SACfC,gBAAgB;AAAA,SAChBC,UAAU,EAAEC,SAAS;AAAA,SAGrBC,cAAc;AAAA,SACdC,cAAc,EAAEC,2BAA2B,EAAEC,eAAe;AAAA,SAE5DC,aAAa,EAAEC,wBAAwB"}

package/dist/zip-loader.js

@@ -1,5 +1,5 @@
 import JSZip from 'jszip';
-const VERSION = typeof "4.2.0-alpha.1" !== 'undefined' ? "4.2.0-alpha.1" : 'latest';
+const VERSION = typeof "4.2.0-alpha.2" !== 'undefined' ? "4.2.0-alpha.2" : 'latest';
 export const ZipLoader = {
   id: 'zip',
   module: 'zip',

package/dist/zip-writer.js

@@ -1,5 +1,5 @@
 import JSZip from 'jszip';
-const VERSION = typeof "4.2.0-alpha.1" !== 'undefined' ? "4.2.0-alpha.1" : 'latest';
+const VERSION = typeof "4.2.0-alpha.2" !== 'undefined' ? "4.2.0-alpha.2" : 'latest';
 export const ZipWriter = {
   name: 'Zip Archive',
   id: 'zip',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/zip",
-  "version": "4.2.0-alpha.1",
+  "version": "4.2.0-alpha.2",
   "description": "Zip Archive Loader",
   "license": "MIT",
   "type": "module",
@@ -38,11 +38,11 @@
     "build-bundle": "ocular-bundle ./src/index.ts"
   },
   "dependencies": {
-    "@loaders.gl/compression": "4.2.0-alpha.1",
-    "@loaders.gl/crypto": "4.2.0-alpha.1",
-    "@loaders.gl/loader-utils": "4.2.0-alpha.1",
+    "@loaders.gl/compression": "4.2.0-alpha.2",
+    "@loaders.gl/crypto": "4.2.0-alpha.2",
+    "@loaders.gl/loader-utils": "4.2.0-alpha.2",
     "jszip": "^3.1.5",
     "md5": "^2.3.0"
   },
-  "gitHead": "d4da81f4d8fb2a3b43b0e025109cf7ccfb317d4c"
+  "gitHead": "d66a6a4626ea84c5f2cad5fa5cf7ebb6943c57c8"
 }

package/src/filesystems/IndexedArchive.ts

@@ -0,0 +1,40 @@
+import {FileProvider} from '@loaders.gl/loader-utils';
+import {ZipFileSystem} from './zip-filesystem';
+
+/**
+ * Abstract class for fetching indexed archive formats (SLPK, 3TZ). Those types of zip archive has
+ * a hash file inside that allows to increase reading speed
+ */
+export abstract class IndexedArchive {
+  public fileProvider: FileProvider;
+  public fileName?: string;
+
+  /**
+   * Constructor
+   * @param fileProvider - instance of a binary data reader
+   * @param hashTable - pre-loaded hashTable. If presented, getFile will skip reading the hash file
+   * @param fileName - name of the archive. It is used to add to an URL of a loader context
+   */
+  constructor(fileProvider: FileProvider, hashTable?: Record<string, bigint>, fileName?: string) {
+    this.fileProvider = fileProvider;
+    this.fileName = fileName;
+  }
+
+  /**
+   * Get internal file from the archive
+   * @param path - path to the file
+   * @param mode - path mode - the logic is implemented in subclasses
+   */
+  abstract getFile(path: string, mode?: string): Promise<ArrayBuffer>;
+
+  /**
+   * Get file as from order ZIP arhive without using the hash file
+   * @param filename - path to the internal file
+   * @returns
+   */
+  protected async getFileWithoutHash(filename: string): Promise<ArrayBuffer> {
+    const zipFS = new ZipFileSystem(this.fileProvider);
+    const response = await zipFS.fetch(filename);
+    return await response.arrayBuffer();
+  }
+}

package/src/filesystems/zip-filesystem.ts

@@ -8,10 +8,11 @@ import {FileHandleFile} from '@loaders.gl/loader-utils';
 import {ZipCDFileHeader, makeZipCDHeaderIterator} from '../parse-zip/cd-file-header';
 import {parseZipLocalFileHeader} from '../parse-zip/local-file-header';
 import {DeflateCompression} from '@loaders.gl/compression';
+import {IndexedArchive} from './IndexedArchive';
 
-type CompressionHandler = (compressedFile: ArrayBuffer) => Promise<ArrayBuffer>;
+export type CompressionHandler = (compressedFile: ArrayBuffer) => Promise<ArrayBuffer>;
 /** Handling different compression types in zip */
-const COMPRESSION_METHODS: {[key: number]: CompressionHandler} = {
+export const ZIP_COMPRESSION_HANDLERS: {[key: number]: CompressionHandler} = {
   /** No compression */
   0: async (compressedFile) => compressedFile,
   /** Deflation */
@@ -30,12 +31,13 @@ export class ZipFileSystem implements FileSystem {
   /** FileProvider instance promise */
   protected fileProvider: FileProvider | null = null;
   public fileName?: string;
+  public archive: IndexedArchive | null = null;
 
   /**
    * Constructor
    * @param file - instance of FileProvider or file path string
    */
-  constructor(file: FileProvider | string) {
+  constructor(file: FileProvider | IndexedArchive | string) {
     // Try to open file in NodeJS
     if (typeof file === 'string') {
       this.fileName = file;
@@ -44,6 +46,10 @@ export class ZipFileSystem implements FileSystem {
       } else {
         throw new Error('Cannot open file for random access in a WEB browser');
       }
+    } else if (file instanceof IndexedArchive) {
+      this.fileProvider = file.fileProvider;
+      this.archive = file;
+      this.fileName = file.fileName;
     } else if (isFileProvider(file)) {
       this.fileProvider = file;
     }
@@ -88,32 +94,40 @@ export class ZipFileSystem implements FileSystem {
    * @returns - Response with file data
    */
   async fetch(filename: string): Promise<Response> {
-    if (!this.fileProvider) {
-      throw new Error('No data detected in the zip archive');
-    }
-    const cdFileHeader = await this.getCDFileHeader(filename);
-    const localFileHeader = await parseZipLocalFileHeader(
-      cdFileHeader.localHeaderOffset,
-      this.fileProvider
-    );
-    if (!localFileHeader) {
-      throw new Error('Local file header has not been found in the zip archive`');
-    }
+    let uncompressedFile: ArrayBuffer;
+    if (this.archive) {
+      uncompressedFile = await this.archive.getFile(filename, 'http');
+    } else {
+      if (!this.fileProvider) {
+        throw new Error('No data detected in the zip archive');
+      }
+      const cdFileHeader = await this.getCDFileHeader(filename);
+      const localFileHeader = await parseZipLocalFileHeader(
+        cdFileHeader.localHeaderOffset,
+        this.fileProvider
+      );
+      if (!localFileHeader) {
+        throw new Error('Local file header has not been found in the zip archive`');
+      }
 
-    const compressionHandler = COMPRESSION_METHODS[localFileHeader.compressionMethod.toString()];
-    if (!compressionHandler) {
-      throw Error('Only Deflation compression is supported');
-    }
+      const compressionHandler =
+        ZIP_COMPRESSION_HANDLERS[localFileHeader.compressionMethod.toString()];
+      if (!compressionHandler) {
+        throw Error('Only Deflation compression is supported');
+      }
 
-    const compressedFile = await this.fileProvider.slice(
-      localFileHeader.fileDataOffset,
-      localFileHeader.fileDataOffset + localFileHeader.compressedSize
-    );
+      const compressedFile = await this.fileProvider.slice(
+        localFileHeader.fileDataOffset,
+        localFileHeader.fileDataOffset + localFileHeader.compressedSize
+      );
 
-    const uncompressedFile = await compressionHandler(compressedFile);
+      uncompressedFile = await compressionHandler(compressedFile);
+    }
 
     const response = new Response(uncompressedFile);
-    Object.defineProperty(response, 'url', {value: `${this.fileName || ''}/${filename}`});
+    Object.defineProperty(response, 'url', {
+      value: filename ? `${this.fileName || ''}/${filename}` : this.fileName || ''
+    });
     return response;
   }
 

package/src/index.ts

@@ -22,6 +22,8 @@ export {searchFromTheEnd} from './parse-zip/search-from-the-end';
 export {addOneFile, createZip} from './parse-zip/zip-composition';
 
 // export type {HashElement} from './hash-file-utility';
+export {IndexedArchive} from './filesystems/IndexedArchive';
 export {parseHashTable, makeHashTableFromZipHeaders, composeHashFile} from './hash-file-utility';
 
-export {ZipFileSystem} from './filesystems/zip-filesystem';
+export {ZipFileSystem, ZIP_COMPRESSION_HANDLERS} from './filesystems/zip-filesystem';
+export type {CompressionHandler} from './filesystems/zip-filesystem';