@loaders.gl/i3s 4.0.0-alpha.1 → 4.0.0-alpha.11

package/dist/lib/parsers/parse-i3s.d.ts

@@ -0,0 +1,6 @@
+import { I3STilesetHeader, I3STileHeader, I3SMinimalNodeData, Node3DIndexDocument } from '../../types';
+import type { LoaderOptions, LoaderContext } from '@loaders.gl/loader-utils';
+export declare function normalizeTileData(tile: Node3DIndexDocument, context: LoaderContext): I3STileHeader;
+export declare function normalizeTileNonUrlData(tile: I3SMinimalNodeData): I3STileHeader;
+export declare function normalizeTilesetData(tileset: I3STilesetHeader, options: LoaderOptions, context: LoaderContext): Promise<void>;
+//# sourceMappingURL=parse-i3s.d.ts.map

package/dist/lib/parsers/parse-i3s.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-i3s.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/parse-i3s.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,gBAAgB,EAChB,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAE3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAG,mBAAmB,EAAE,OAAO,EAAE,aAAa,GAAG,aAAa,CAyBnG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAG,kBAAkB,GAAG,aAAa,CAmChF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAG,gBAAgB,EAAE,OAAO,EAAG,aAAa,EAAE,OAAO,EAAE,aAAa,iBA0BrH"}

package/dist/lib/parsers/parse-i3s.js

@@ -1,76 +1,95 @@
-import { OrientedBoundingBox } from '@math.gl/culling';
-import { Ellipsoid } from '@math.gl/geospatial';
-import { load } from '@loaders.gl/core';
-import { TILE_TYPE, TILE_REFINEMENT, TILESET_TYPE } from '@loaders.gl/tiles';
-import I3SNodePagesTiles from '../helpers/i3s-nodepages-tiles';
-import { generateTileAttributeUrls, getUrlWithToken } from '../utils/url-utils';
-export function normalizeTileData(tile, options, context) {
-  tile.url = context.url;
-
-  if (tile.featureData) {
-    tile.featureUrl = "".concat(tile.url, "/").concat(tile.featureData[0].href);
-  }
-
-  if (tile.geometryData) {
-    tile.contentUrl = "".concat(tile.url, "/").concat(tile.geometryData[0].href);
-  }
-
-  if (tile.textureData) {
-    tile.textureUrl = "".concat(tile.url, "/").concat(tile.textureData[0].href);
-  }
-
-  if (tile.attributeData) {
-    tile.attributeUrls = generateTileAttributeUrls(tile);
-  }
-
-  return normalizeTileNonUrlData(tile);
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTilesetData = exports.normalizeTileNonUrlData = exports.normalizeTileData = void 0;
+const culling_1 = require("@math.gl/culling");
+const geospatial_1 = require("@math.gl/geospatial");
+const core_1 = require("@loaders.gl/core");
+const tiles_1 = require("@loaders.gl/tiles");
+const i3s_nodepages_tiles_1 = __importDefault(require("../helpers/i3s-nodepages-tiles"));
+const url_utils_1 = require("../utils/url-utils");
+function normalizeTileData(tile, context) {
+    const url = context.url || '';
+    let contentUrl;
+    if (tile.geometryData) {
+        contentUrl = `${url}/${tile.geometryData[0].href}`;
+    }
+    let textureUrl;
+    if (tile.textureData) {
+        textureUrl = `${url}/${tile.textureData[0].href}`;
+    }
+    let attributeUrls;
+    if (tile.attributeData) {
+        attributeUrls = (0, url_utils_1.generateTileAttributeUrls)(url, tile);
+    }
+    return normalizeTileNonUrlData({
+        ...tile,
+        url,
+        contentUrl,
+        textureUrl,
+        attributeUrls,
+        isDracoGeometry: false
+    });
 }
-export function normalizeTileNonUrlData(tile) {
-  const box = tile.obb ? [...Ellipsoid.WGS84.cartographicToCartesian(tile.obb.center), ...tile.obb.halfSize, ...tile.obb.quaternion] : undefined;
-  let sphere;
-
-  if (tile.mbs) {
-    sphere = [...Ellipsoid.WGS84.cartographicToCartesian(tile.mbs.slice(0, 3)), tile.mbs[3]];
-  } else if (box) {
-    const obb = new OrientedBoundingBox().fromCenterHalfSizeQuaternion(box.slice(0, 3), tile.obb.halfSize, tile.obb.quaternion);
-    const boundingSphere = obb.getBoundingSphere();
-    sphere = [...boundingSphere.center, boundingSphere.radius];
-    tile.mbs = [...tile.obb.center, boundingSphere.radius];
-  }
-
-  tile.boundingVolume = {
-    sphere,
-    box
-  };
-  tile.lodMetricType = tile.lodSelection[0].metricType;
-  tile.lodMetricValue = tile.lodSelection[0].maxError;
-  tile.transformMatrix = tile.transform;
-  tile.type = TILE_TYPE.MESH;
-  tile.refine = TILE_REFINEMENT.REPLACE;
-  return tile;
+exports.normalizeTileData = normalizeTileData;
+function normalizeTileNonUrlData(tile) {
+    const boundingVolume = {};
+    let mbs = [0, 0, 0, 1];
+    if (tile.mbs) {
+        mbs = tile.mbs;
+        boundingVolume.sphere = [
+            ...geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(tile.mbs.slice(0, 3)),
+            tile.mbs[3] // radius of sphere
+        ];
+    }
+    else if (tile.obb) {
+        boundingVolume.box = [
+            ...geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(tile.obb.center),
+            ...tile.obb.halfSize,
+            ...tile.obb.quaternion // quaternion
+        ];
+        const obb = new culling_1.OrientedBoundingBox().fromCenterHalfSizeQuaternion(boundingVolume.box.slice(0, 3), tile.obb.halfSize, tile.obb.quaternion);
+        const boundingSphere = obb.getBoundingSphere();
+        boundingVolume.sphere = [...boundingSphere.center, boundingSphere.radius];
+        mbs = [...tile.obb.center, boundingSphere.radius];
+    }
+    const lodMetricType = tile.lodSelection?.[0].metricType;
+    const lodMetricValue = tile.lodSelection?.[0].maxError;
+    const transformMatrix = tile.transform;
+    const type = tiles_1.TILE_TYPE.MESH;
+    /**
+     * I3S specification supports only REPLACE
+     */
+    const refine = tiles_1.TILE_REFINEMENT.REPLACE;
+    return { ...tile, mbs, boundingVolume, lodMetricType, lodMetricValue, transformMatrix, type, refine };
 }
-export async function normalizeTilesetData(tileset, options, context) {
-  tileset.url = context.url;
-
-  if (tileset.nodePages) {
-    tileset.nodePagesTile = new I3SNodePagesTiles(tileset, options);
-    tileset.root = await tileset.nodePagesTile.formTileFromNodePages(0);
-  } else {
-    var _options$i3s;
-
-    const rootNodeUrl = getUrlWithToken("".concat(tileset.url, "/nodes/root"), (_options$i3s = options.i3s) === null || _options$i3s === void 0 ? void 0 : _options$i3s.token);
-    tileset.root = await load(rootNodeUrl, tileset.loader, {
-      i3s: {
-        loadContent: false,
-        isTileHeader: true,
-        isTileset: false
-      }
-    });
-  }
-
-  tileset.basePath = tileset.url;
-  tileset.type = TILESET_TYPE.I3S;
-  tileset.lodMetricType = tileset.root.lodMetricType;
-  tileset.lodMetricValue = tileset.root.lodMetricValue;
+exports.normalizeTileNonUrlData = normalizeTileNonUrlData;
+async function normalizeTilesetData(tileset, options, context) {
+    tileset.url = context.url;
+    if (tileset.nodePages) {
+        tileset.nodePagesTile = new i3s_nodepages_tiles_1.default(tileset, options);
+        tileset.root = tileset.nodePagesTile.formTileFromNodePages(0);
+    }
+    else {
+        // @ts-expect-error options is not properly typed
+        const rootNodeUrl = (0, url_utils_1.getUrlWithToken)(`${tileset.url}/nodes/root`, options.i3s?.token);
+        // eslint-disable-next-line no-use-before-define
+        tileset.root = await (0, core_1.load)(rootNodeUrl, tileset.loader, {
+            ...options,
+            i3s: {
+                // @ts-expect-error options is not properly typed
+                ...options.i3s,
+                loadContent: false, isTileHeader: true, isTileset: false
+            }
+        });
+    }
+    // base path that non-absolute paths in tileset are relative to.
+    tileset.basePath = tileset.url;
+    tileset.type = tiles_1.TILESET_TYPE.I3S;
+    // populate from root node
+    tileset.lodMetricType = tileset.root.lodMetricType;
+    tileset.lodMetricValue = tileset.root.lodMetricValue;
 }
-//# sourceMappingURL=parse-i3s.js.map
+exports.normalizeTilesetData = normalizeTilesetData;

package/dist/lib/parsers/parse-slpk/parse-slpk.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+import type { SLPKLoaderOptions } from '../../../i3s-slpk-loader';
+export declare function parseSLPK(data: ArrayBuffer, options?: SLPKLoaderOptions): Promise<Buffer>;
+//# sourceMappingURL=parse-slpk.d.ts.map

package/dist/lib/parsers/parse-slpk/parse-slpk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-slpk.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/parse-slpk/parse-slpk.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAgBhE,wBAAsB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,mBAuDjF"}

package/dist/lib/parsers/parse-slpk/parse-slpk.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSLPK = void 0;
+const buffer_file_provider_1 = require("../parse-zip/buffer-file-provider");
+const cd_file_header_1 = require("../parse-zip/cd-file-header");
+const local_file_header_1 = require("../parse-zip/local-file-header");
+const slpk_archieve_1 = require("./slpk-archieve");
+/**
+ * Returns one byte from the provided buffer at the provided position
+ * @param offset - position where to read
+ * @param buffer - buffer to read
+ * @returns one byte from the provided buffer at the provided position
+ */
+const getByteAt = (offset, buffer) => {
+    return buffer.getUint8(buffer.byteOffset + offset);
+};
+async function parseSLPK(data, options = {}) {
+    const archive = new DataView(data);
+    const cdFileHeaderSignature = [80, 75, 1, 2];
+    const searchWindow = [
+        getByteAt(archive.byteLength - 1, archive),
+        getByteAt(archive.byteLength - 2, archive),
+        getByteAt(archive.byteLength - 3, archive),
+        undefined
+    ];
+    let hashCDOffset = 0;
+    // looking for the last record in the central directory
+    for (let i = archive.byteLength - 4; i > -1; i--) {
+        searchWindow[3] = searchWindow[2];
+        searchWindow[2] = searchWindow[1];
+        searchWindow[1] = searchWindow[0];
+        searchWindow[0] = getByteAt(i, archive);
+        if (searchWindow.every((val, index) => val === cdFileHeaderSignature[index])) {
+            hashCDOffset = i;
+            break;
+        }
+    }
+    const fileProvider = new buffer_file_provider_1.DataViewFileProvider(archive);
+    const cdFileHeader = await (0, cd_file_header_1.parseZipCDFileHeader)(hashCDOffset, fileProvider);
+    if (cdFileHeader.fileName !== '@specialIndexFileHASH128@') {
+        throw new Error('No hash file in slpk');
+    }
+    const localFileHeader = await (0, local_file_header_1.parseZipLocalFileHeader)(cdFileHeader.localHeaderOffset, fileProvider);
+    if (!localFileHeader) {
+        throw new Error('No hash file in slpk');
+    }
+    const fileDataOffset = localFileHeader.fileDataOffset;
+    const hashFile = archive.buffer.slice(fileDataOffset, fileDataOffset + localFileHeader.compressedSize);
+    if (!hashFile) {
+        throw new Error('No hash file in slpk');
+    }
+    return await new slpk_archieve_1.SLPKArchive(data, hashFile).getFile(options.slpk?.path ?? '', options.slpk?.pathMode);
+}
+exports.parseSLPK = parseSLPK;

package/dist/lib/parsers/parse-slpk/slpk-archieve.d.ts

@@ -0,0 +1,38 @@
+/// <reference types="node" />
+/**
+ * Class for handling information about slpk file
+ */
+export declare class SLPKArchive {
+    slpkArchive: DataView;
+    hashArray: {
+        hash: Buffer;
+        offset: number;
+    }[];
+    constructor(slpkArchiveBuffer: ArrayBuffer, hashFile: ArrayBuffer);
+    /**
+     * Reads hash file from buffer and returns it in ready-to-use form
+     * @param hashFile - bufer containing hash file
+     * @returns Array containing file info
+     */
+    private parseHashFile;
+    /**
+     * Returns file with the given path from slpk archive
+     * @param path - path inside the slpk
+     * @param mode - currently only raw mode supported
+     * @returns buffer with ready to use file
+     */
+    getFile(path: string, mode?: 'http' | 'raw'): Promise<Buffer>;
+    /**
+     * returning uncompressed data for paths that ends with .gz and raw data for all other paths
+     * @param path - path inside the archive
+     * @returns buffer with the file data
+     */
+    private getDataByPath;
+    /**
+     * Trying to get raw file data by adress
+     * @param path - path inside the archive
+     * @returns buffer with the raw file data
+     */
+    private getFileBytes;
+}
+//# sourceMappingURL=slpk-archieve.d.ts.map

package/dist/lib/parsers/parse-slpk/slpk-archieve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slpk-archieve.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/parse-slpk/slpk-archieve.ts"],"names":[],"mappings":";AAqDA;;GAEG;AACH,qBAAa,WAAW;IACtB,WAAW,EAAE,QAAQ,CAAC;IACtB,SAAS,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,EAAE,CAAC;gBAChC,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW;IAKjE;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAqBrB;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B1E;;;;OAIG;YACW,aAAa;IAc3B;;;;OAIG;YACW,YAAY;CAsB3B"}

package/dist/lib/parsers/parse-slpk/slpk-archieve.js

@@ -0,0 +1,142 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLPKArchive = void 0;
+const md5_1 = __importDefault(require("md5"));
+const local_file_header_1 = require("../parse-zip/local-file-header");
+const buffer_file_provider_1 = require("../parse-zip/buffer-file-provider");
+const compression_1 = require("@loaders.gl/compression");
+/** Description of real paths for different file types */
+const PATH_DESCRIPTIONS = [
+    {
+        test: /^$/,
+        extensions: ['3dSceneLayer.json.gz']
+    },
+    {
+        test: /^nodepages\/\d+$/,
+        extensions: ['.json.gz']
+    },
+    {
+        test: /^nodes\/\d+$/,
+        extensions: ['/3dNodeIndexDocument.json.gz']
+    },
+    {
+        test: /^nodes\/\d+\/textures\/.+$/,
+        extensions: ['.jpg', '.png', '.bin.dds.gz', '.ktx']
+    },
+    {
+        test: /^nodes\/\d+\/geometries\/\d+$/,
+        extensions: ['.bin.gz', '.draco.gz']
+    },
+    {
+        test: /^nodes\/\d+\/attributes\/f_\d+\/\d+$/,
+        extensions: ['.bin.gz']
+    },
+    {
+        test: /^statistics\/f_\d+\/\d+$/,
+        extensions: ['.json.gz']
+    },
+    {
+        test: /^nodes\/\d+\/shared$/,
+        extensions: ['/sharedResource.json.gz']
+    }
+];
+/**
+ * Class for handling information about slpk file
+ */
+class SLPKArchive {
+    constructor(slpkArchiveBuffer, hashFile) {
+        this.slpkArchive = new DataView(slpkArchiveBuffer);
+        this.hashArray = this.parseHashFile(hashFile);
+    }
+    /**
+     * Reads hash file from buffer and returns it in ready-to-use form
+     * @param hashFile - bufer containing hash file
+     * @returns Array containing file info
+     */
+    parseHashFile(hashFile) {
+        const hashFileBuffer = Buffer.from(hashFile);
+        const hashArray = [];
+        for (let i = 0; i < hashFileBuffer.buffer.byteLength; i = i + 24) {
+            const offsetBuffer = new DataView(hashFileBuffer.buffer.slice(hashFileBuffer.byteOffset + i + 16, hashFileBuffer.byteOffset + i + 24));
+            const offset = offsetBuffer.getUint32(offsetBuffer.byteOffset, true);
+            hashArray.push({
+                hash: Buffer.from(hashFileBuffer.subarray(hashFileBuffer.byteOffset + i, hashFileBuffer.byteOffset + i + 16)),
+                offset
+            });
+        }
+        return hashArray;
+    }
+    /**
+     * Returns file with the given path from slpk archive
+     * @param path - path inside the slpk
+     * @param mode - currently only raw mode supported
+     * @returns buffer with ready to use file
+     */
+    async getFile(path, mode = 'raw') {
+        if (mode === 'http') {
+            const extensions = PATH_DESCRIPTIONS.find((val) => val.test.test(path))?.extensions;
+            if (extensions) {
+                let data;
+                for (const ext of extensions) {
+                    data = await this.getDataByPath(`${path}${ext}`);
+                    if (data) {
+                        break;
+                    }
+                }
+                if (data) {
+                    return Buffer.from(data);
+                }
+            }
+        }
+        if (mode === 'raw') {
+            const decompressedFile = await this.getDataByPath(`${path}.gz`);
+            if (decompressedFile) {
+                return Buffer.from(decompressedFile);
+            }
+            const fileWithoutCompression = await this.getFileBytes(path);
+            if (fileWithoutCompression) {
+                return Buffer.from(fileWithoutCompression);
+            }
+        }
+        throw new Error('No such file in the archieve');
+    }
+    /**
+     * returning uncompressed data for paths that ends with .gz and raw data for all other paths
+     * @param path - path inside the archive
+     * @returns buffer with the file data
+     */
+    async getDataByPath(path) {
+        const data = await this.getFileBytes(path);
+        if (!data) {
+            return undefined;
+        }
+        if (/\.gz$/.test(path)) {
+            const compression = new compression_1.GZipCompression();
+            const decompressedData = await compression.decompress(data);
+            return decompressedData;
+        }
+        return Buffer.from(data);
+    }
+    /**
+     * Trying to get raw file data by adress
+     * @param path - path inside the archive
+     * @returns buffer with the raw file data
+     */
+    async getFileBytes(path) {
+        const nameHash = Buffer.from((0, md5_1.default)(path), 'hex');
+        const fileInfo = this.hashArray.find((val) => Buffer.compare(val.hash, nameHash) === 0);
+        if (!fileInfo) {
+            return undefined;
+        }
+        const localFileHeader = await (0, local_file_header_1.parseZipLocalFileHeader)(this.slpkArchive.byteOffset + fileInfo?.offset, new buffer_file_provider_1.DataViewFileProvider(this.slpkArchive));
+        if (!localFileHeader) {
+            return undefined;
+        }
+        const compressedFile = this.slpkArchive.buffer.slice(localFileHeader.fileDataOffset, localFileHeader.fileDataOffset + localFileHeader.compressedSize);
+        return compressedFile;
+    }
+}
+exports.SLPKArchive = SLPKArchive;

package/dist/lib/parsers/parse-zip/buffer-file-provider.d.ts

@@ -0,0 +1,37 @@
+import { FileProvider } from './file-provider';
+/**
+ * Provides file data using DataView
+ */
+export declare class DataViewFileProvider implements FileProvider {
+    /**
+     * The DataView from which data is provided
+     */
+    private file;
+    constructor(file: DataView);
+    /**
+     * 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.
+     */
+    getUint8(offset: number): Promise<number>;
+    /**
+     * 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.
+     */
+    getUint16(offset: number): Promise<number>;
+    /**
+     * 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.
+     */
+    getUint32(offset: number): Promise<number>;
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in bytes, 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.
+     */
+    slice(startOffset: number, endOffset: number): Promise<ArrayBuffer>;
+    /**
+     * the length (in bytes) of the data.
+     */
+    get length(): number;
+}
+//# sourceMappingURL=buffer-file-provider.d.ts.map

package/dist/lib/parsers/parse-zip/buffer-file-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-file-provider.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/parse-zip/buffer-file-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAE7C;;GAEG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD;;OAEG;IACH,OAAO,CAAC,IAAI,CAAW;gBAEX,IAAI,EAAE,QAAQ;IAI1B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1C;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAInE;;OAEG;IACH,IAAI,MAAM,WAET;CACF"}

package/dist/lib/parsers/parse-zip/buffer-file-provider.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataViewFileProvider = void 0;
+/**
+ * Provides file data using DataView
+ */
+class DataViewFileProvider {
+    constructor(file) {
+        this.file = file;
+    }
+    /**
+     * 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.
+     */
+    getUint8(offset) {
+        return Promise.resolve(this.file.getUint8(offset));
+    }
+    /**
+     * 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.
+     */
+    getUint16(offset) {
+        return Promise.resolve(this.file.getUint16(offset, true));
+    }
+    /**
+     * 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.
+     */
+    getUint32(offset) {
+        return Promise.resolve(this.file.getUint32(offset, true));
+    }
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in bytes, 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.
+     */
+    slice(startOffset, endOffset) {
+        return Promise.resolve(this.file.buffer.slice(startOffset, endOffset));
+    }
+    /**
+     * the length (in bytes) of the data.
+     */
+    get length() {
+        return this.file.byteLength;
+    }
+}
+exports.DataViewFileProvider = DataViewFileProvider;

package/dist/lib/parsers/parse-zip/cd-file-header.d.ts

@@ -0,0 +1,27 @@
+import { FileProvider } from './file-provider';
+/**
+ * zip central directory file header info
+ * according to https://en.wikipedia.org/wiki/ZIP_(file_format)
+ */
+export type ZipCDFileHeader = {
+    /** Compressed size */
+    compressedSize: number;
+    /** Uncompressed size */
+    uncompressedSize: number;
+    /** File name length */
+    fileNameLength: number;
+    /** File name */
+    fileName: string;
+    /** Extra field offset */
+    extraOffset: number;
+    /** Relative offset of local file header */
+    localHeaderOffset: number;
+};
+/**
+ * Parses central directory file header of zip file
+ * @param headerOffset - offset in the archive where header starts
+ * @param buffer - buffer containing whole array
+ * @returns Info from the header
+ */
+export declare const parseZipCDFileHeader: (headerOffset: number, buffer: FileProvider) => Promise<ZipCDFileHeader>;
+//# sourceMappingURL=cd-file-header.d.ts.map

package/dist/lib/parsers/parse-zip/cd-file-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cd-file-header.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/parse-zip/cd-file-header.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,iBACjB,MAAM,UACZ,YAAY,KACnB,QAAQ,eAAe,CAuDzB,CAAC"}

package/dist/lib/parsers/parse-zip/cd-file-header.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseZipCDFileHeader = void 0;
+/**
+ * Parses central directory file header of zip file
+ * @param headerOffset - offset in the archive where header starts
+ * @param buffer - buffer containing whole array
+ * @returns Info from the header
+ */
+const parseZipCDFileHeader = async (headerOffset, buffer) => {
+    const offsets = {
+        CD_COMPRESSED_SIZE_OFFSET: 20,
+        CD_UNCOMPRESSED_SIZE_OFFSET: 24,
+        CD_FILE_NAME_LENGTH_OFFSET: 28,
+        CD_EXTRA_FIELD_LENGTH_OFFSET: 30,
+        CD_LOCAL_HEADER_OFFSET_OFFSET: 42,
+        CD_FILE_NAME_OFFSET: 46
+    };
+    const compressedSize = await buffer.getUint32(headerOffset + offsets.CD_COMPRESSED_SIZE_OFFSET);
+    const uncompressedSize = await buffer.getUint32(headerOffset + offsets.CD_UNCOMPRESSED_SIZE_OFFSET);
+    const fileNameLength = await buffer.getUint16(headerOffset + offsets.CD_FILE_NAME_LENGTH_OFFSET);
+    const fileName = new TextDecoder().decode(await buffer.slice(headerOffset + offsets.CD_FILE_NAME_OFFSET, headerOffset + offsets.CD_FILE_NAME_OFFSET + fileNameLength));
+    const extraOffset = headerOffset + offsets.CD_FILE_NAME_OFFSET + fileNameLength;
+    const oldFormatOffset = await buffer.getUint32(headerOffset + offsets.CD_LOCAL_HEADER_OFFSET_OFFSET);
+    let fileDataOffset = oldFormatOffset;
+    if (fileDataOffset === 0xffffffff) {
+        let offsetInZip64Data = 4;
+        // looking for info that might be also be in zip64 extra field
+        if (compressedSize === 0xffffffff) {
+            offsetInZip64Data += 8;
+        }
+        if (uncompressedSize === 0xffffffff) {
+            offsetInZip64Data += 8;
+        }
+        // getUint32 needs to be replaced with getBigUint64 for archieves bigger than 2gb
+        fileDataOffset = await buffer.getUint32(extraOffset + offsetInZip64Data); // setting it to the one from zip64
+    }
+    const localHeaderOffset = fileDataOffset;
+    return {
+        compressedSize,
+        uncompressedSize,
+        fileNameLength,
+        fileName,
+        extraOffset,
+        localHeaderOffset
+    };
+};
+exports.parseZipCDFileHeader = parseZipCDFileHeader;

package/dist/lib/parsers/parse-zip/file-provider.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Interface for providing file data
+ */
+export interface FileProvider {
+    /**
+     * 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.
+     */
+    getUint8(offset: number): Promise<number>;
+    /**
+     * 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.
+     */
+    getUint16(offset: number): Promise<number>;
+    /**
+     * 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 file of the view where to read the data.
+     */
+    getUint32(offset: number): Promise<number>;
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in bytes, 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.
+     */
+    slice(startOffset: number, endOffset: number): Promise<ArrayBuffer>;
+    /**
+     * the length (in bytes) of the data.
+     */
+    length: number;
+}
+//# sourceMappingURL=file-provider.d.ts.map

package/dist/lib/parsers/parse-zip/file-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-provider.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/parse-zip/file-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpE;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/lib/parsers/parse-zip/file-provider.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });