@loaders.gl/zip 4.1.0-alpha.9 → 4.1.1

package/src/index.ts

@@ -19,7 +19,7 @@ export {
 } from './parse-zip/local-file-header';
 export {parseEoCDRecord} from './parse-zip/end-of-central-directory';
 export {searchFromTheEnd} from './parse-zip/search-from-the-end';
-export {addOneFile} from './parse-zip/zip-compozition';
+export {addOneFile, createZip} from './parse-zip/zip-composition';
 
 // export type {HashElement} from './hash-file-utility';
 export {parseHashTable, makeHashTableFromZipHeaders, composeHashFile} from './hash-file-utility';

package/src/parse-zip/end-of-central-directory.ts

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import {FileProvider, compareArrayBuffers} from '@loaders.gl/loader-utils';
+import {FileProvider, compareArrayBuffers, concatenateArrayBuffers} from '@loaders.gl/loader-utils';
 import {ZipSignature, searchFromTheEnd} from './search-from-the-end';
 import {setFieldToNumber} from './zip64-info-generation';
 
@@ -29,6 +29,17 @@ export type ZipEoCDRecordOffsets = {
   zip64EoCDLocatorOffset?: bigint;
 };
 
+/**
+ * Data to generate End of central directory record
+ * according to https://en.wikipedia.org/wiki/ZIP_(file_format)
+ */
+export type ZipEoCDGenerationOptions = {
+  recordsNumber: number;
+  cdSize: number;
+  cdOffset: bigint;
+  eoCDStart: bigint;
+};
+
 const eoCDSignature: ZipSignature = new Uint8Array([0x50, 0x4b, 0x05, 0x06]);
 const zip64EoCDLocatorSignature = new Uint8Array([0x50, 0x4b, 0x06, 0x07]);
 const zip64EoCDSignature = new Uint8Array([0x50, 0x4b, 0x06, 0x06]);
@@ -38,11 +49,13 @@ const CD_RECORDS_NUMBER_OFFSET = 8n;
 const CD_RECORDS_NUMBER_ON_DISC_OFFSET = 10n;
 const CD_CD_BYTE_SIZE_OFFSET = 12n;
 const CD_START_OFFSET_OFFSET = 16n;
+const CD_COMMENT_OFFSET = 22n;
 const ZIP64_EOCD_START_OFFSET_OFFSET = 8n;
 const ZIP64_CD_RECORDS_NUMBER_OFFSET = 24n;
 const ZIP64_CD_RECORDS_NUMBER_ON_DISC_OFFSET = 32n;
 const ZIP64_CD_CD_BYTE_SIZE_OFFSET = 40n;
 const ZIP64_CD_START_OFFSET_OFFSET = 48n;
+const ZIP64_COMMENT_OFFSET = 56n;
 
 /**
  * Parses end of central directory record of zip file
@@ -94,13 +107,13 @@ export const parseEoCDRecord = async (file: FileProvider): Promise<ZipEoCDRecord
  * @param eocdStartOffset EoCD start offset to be updated
  * @returns new EoCD header
  */
-export async function updateEoCD(
+export function updateEoCD(
   eocdBody: ArrayBuffer,
   oldEoCDOffsets: ZipEoCDRecordOffsets,
   newCDStartOffset: bigint,
   eocdStartOffset: bigint,
   newCDRecordsNumber: bigint
-): Promise<Uint8Array> {
+): Uint8Array {
   const eocd = new DataView(eocdBody);
 
   const classicEoCDOffset = oldEoCDOffsets.zip64EoCDOffset
@@ -152,3 +165,228 @@ export async function updateEoCD(
 
   return new Uint8Array(eocd.buffer);
 }
+
+/**
+ * generates EoCD record
+ * @param options data to generate EoCD record
+ * @returns ArrayBuffer with EoCD record
+ */
+export function generateEoCD(options: ZipEoCDGenerationOptions): ArrayBuffer {
+  const header = new DataView(new ArrayBuffer(Number(CD_COMMENT_OFFSET)));
+
+  for (const field of EOCD_FIELDS) {
+    setFieldToNumber(
+      header,
+      field.size,
+      field.offset,
+      options[field.name ?? ''] ?? field.default ?? 0
+    );
+  }
+  const locator = generateZip64InfoLocator(options);
+
+  const zip64Record = generateZip64Info(options);
+
+  return concatenateArrayBuffers(zip64Record, locator, header.buffer);
+}
+
+/** standart EoCD fields */
+const EOCD_FIELDS = [
+  // End of central directory signature = 0x06054b50
+  {
+    offset: 0,
+    size: 4,
+    default: new DataView(eoCDSignature.buffer).getUint32(0, true)
+  },
+
+  // Number of this disk (or 0xffff for ZIP64)
+  {
+    offset: 4,
+    size: 2,
+    default: 0
+  },
+
+  // Disk where central directory starts (or 0xffff for ZIP64)
+  {
+    offset: 6,
+    size: 2,
+    default: 0
+  },
+
+  // Number of central directory records on this disk (or 0xffff for ZIP64)
+  {
+    offset: 8,
+    size: 2,
+    name: 'recordsNumber'
+  },
+
+  // Total number of central directory records (or 0xffff for ZIP64)
+  {
+    offset: 10,
+    size: 2,
+    name: 'recordsNumber'
+  },
+
+  // Size of central directory (bytes) (or 0xffffffff for ZIP64)
+  {
+    offset: 12,
+    size: 4,
+    name: 'cdSize'
+  },
+
+  // Offset of start of central directory, relative to start of archive (or 0xffffffff for ZIP64)
+  {
+    offset: 16,
+    size: 4,
+    name: 'cdOffset'
+  },
+
+  // Comment length (n)
+  {
+    offset: 20,
+    size: 2,
+    default: 0
+  }
+];
+
+/**
+ * generates eocd zip64 record
+ * @param options data to generate eocd zip64 record
+ * @returns buffer with eocd zip64 record
+ */
+function generateZip64Info(options: ZipEoCDGenerationOptions): ArrayBuffer {
+  const record = new DataView(new ArrayBuffer(Number(ZIP64_COMMENT_OFFSET)));
+  for (const field of ZIP64_EOCD_FIELDS) {
+    setFieldToNumber(
+      record,
+      field.size,
+      field.offset,
+      options[field.name ?? ''] ?? field.default ?? 0
+    );
+  }
+
+  return record.buffer;
+}
+
+/**
+ * generates eocd zip64 record locator
+ * @param options data to generate eocd zip64 record
+ * @returns buffer with eocd zip64 record
+ */
+function generateZip64InfoLocator(options: ZipEoCDGenerationOptions): ArrayBuffer {
+  const locator = new DataView(new ArrayBuffer(Number(20)));
+
+  for (const field of ZIP64_EOCD_LOCATOR_FIELDS) {
+    setFieldToNumber(
+      locator,
+      field.size,
+      field.offset,
+      options[field.name ?? ''] ?? field.default ?? 0
+    );
+  }
+
+  return locator.buffer;
+}
+
+/** zip64 EoCD record locater fields */
+const ZIP64_EOCD_LOCATOR_FIELDS = [
+  // zip64 end of central dir locator signature
+  {
+    offset: 0,
+    size: 4,
+    default: new DataView(zip64EoCDLocatorSignature.buffer).getUint32(0, true)
+  },
+
+  // number of the disk with the start of the zip64 end of
+  {
+    offset: 4,
+    size: 4,
+    default: 0
+  },
+
+  // start of the zip64 end of central directory
+  {
+    offset: 8,
+    size: 8,
+    name: 'eoCDStart'
+  },
+
+  // total number of disks
+  {
+    offset: 16,
+    size: 4,
+    default: 1
+  }
+];
+
+/** zip64 EoCD recodrd fields */
+const ZIP64_EOCD_FIELDS = [
+  // End of central directory signature = 0x06064b50
+  {
+    offset: 0,
+    size: 4,
+    default: new DataView(zip64EoCDSignature.buffer).getUint32(0, true)
+  },
+
+  // Size of the EOCD64 minus 12
+  {
+    offset: 4,
+    size: 8,
+    default: 44
+  },
+
+  // Version made by
+  {
+    offset: 12,
+    size: 2,
+    default: 45
+  },
+
+  // Version needed to extract (minimum)
+  {
+    offset: 14,
+    size: 2,
+    default: 45
+  },
+
+  // Number of this disk
+  {
+    offset: 16,
+    size: 4,
+    default: 0
+  },
+
+  // Disk where central directory starts
+  {
+    offset: 20,
+    size: 4,
+    default: 0
+  },
+
+  // Number of central directory records on this disk
+  {
+    offset: 24,
+    size: 8,
+    name: 'recordsNumber'
+  },
+
+  // Total number of central directory records
+  {
+    offset: 32,
+    size: 8,
+    name: 'recordsNumber'
+  },
+
+  // Size of central directory (bytes)
+  {
+    offset: 40,
+    size: 8,
+    name: 'cdSize'
+  },
+
+  // Offset of start of central directory, relative to start of archive
+  {
+    offset: 48,
+    size: 8,
+    name: 'cdOffset'
+  }
+];

package/src/parse-zip/zip-composition.ts

@@ -0,0 +1,234 @@
+import {
+  FileHandleFile,
+  concatenateArrayBuffers,
+  path,
+  NodeFilesystem,
+  NodeFile
+} from '@loaders.gl/loader-utils';
+import {ZipEoCDRecord, generateEoCD, parseEoCDRecord, updateEoCD} from './end-of-central-directory';
+import {CRC32Hash} from '@loaders.gl/crypto';
+import {generateLocalHeader} from './local-file-header';
+import {generateCDHeader} from './cd-file-header';
+import {fetchFile} from '@loaders.gl/core';
+
+/**
+ * cut off CD and EoCD records from zip file
+ * @param provider zip file
+ * @returns tuple with three values: CD, EoCD record, EoCD information
+ */
+async function cutTheTailOff(
+  provider: FileHandleFile
+): Promise<[ArrayBuffer, ArrayBuffer, ZipEoCDRecord]> {
+  // define where the body ends
+  const oldEoCDinfo = await parseEoCDRecord(provider);
+  const oldCDStartOffset = oldEoCDinfo.cdStartOffset;
+
+  // define cd length
+  const oldCDLength = Number(
+    oldEoCDinfo.offsets.zip64EoCDOffset
+      ? oldEoCDinfo.offsets.zip64EoCDOffset - oldCDStartOffset
+      : oldEoCDinfo.offsets.zipEoCDOffset - oldCDStartOffset
+  );
+
+  // cut off everything except of archieve body
+  const zipEnding = await provider.slice(oldCDStartOffset, provider.length);
+  await provider.truncate(Number(oldCDStartOffset));
+
+  // divide cd body and eocd record
+  const oldCDBody = zipEnding.slice(0, oldCDLength);
+  const eocdBody = zipEnding.slice(oldCDLength, zipEnding.byteLength);
+
+  return [oldCDBody, eocdBody, oldEoCDinfo];
+}
+
+/**
+ * generates CD and local headers for the file
+ * @param fileName name of the file
+ * @param fileToAdd buffer with the file
+ * @param localFileHeaderOffset offset of the file local header
+ * @returns tuple with two values: local header and file body, cd header
+ */
+async function generateFileHeaders(
+  fileName: string,
+  fileToAdd: ArrayBuffer,
+  localFileHeaderOffset: bigint
+): Promise<[Uint8Array, Uint8Array]> {
+  // generating CRC32 of the content
+  const newFileCRC322 = parseInt(await new CRC32Hash().hash(fileToAdd, 'hex'), 16);
+
+  // generate local header for the file
+  const newFileLocalHeader = generateLocalHeader({
+    crc32: newFileCRC322,
+    fileName,
+    length: fileToAdd.byteLength
+  });
+
+  // generate hash file cd header
+  const newFileCDHeader = generateCDHeader({
+    crc32: newFileCRC322,
+    fileName,
+    offset: localFileHeaderOffset,
+    length: fileToAdd.byteLength
+  });
+  return [
+    new Uint8Array(concatenateArrayBuffers(newFileLocalHeader, fileToAdd)),
+    new Uint8Array(newFileCDHeader)
+  ];
+}
+
+/**
+ * adds one file in the end of the archieve
+ * @param zipUrl path to the file
+ * @param fileToAdd new file body
+ * @param fileName new file name
+ */
+export async function addOneFile(zipUrl: string, fileToAdd: ArrayBuffer, fileName: string) {
+  // init file handler
+  const provider = new FileHandleFile(zipUrl, true);
+
+  const [oldCDBody, eocdBody, oldEoCDinfo] = await cutTheTailOff(provider);
+
+  // remember the new file local header start offset
+  const newFileOffset = provider.length;
+
+  const [localPart, cdHeaderPart] = await generateFileHeaders(fileName, fileToAdd, newFileOffset);
+
+  // write down the file local header
+  await provider.append(localPart);
+
+  // add the file CD header to the CD
+  const newCDBody = concatenateArrayBuffers(oldCDBody, cdHeaderPart);
+
+  // remember the CD start offset
+  const newCDStartOffset = provider.length;
+
+  // write down new CD
+  await provider.append(new Uint8Array(newCDBody));
+
+  // remember where eocd starts
+  const eocdOffset = provider.length;
+
+  await provider.append(
+    updateEoCD(
+      eocdBody,
+      oldEoCDinfo.offsets,
+      newCDStartOffset,
+      eocdOffset,
+      oldEoCDinfo.cdRecordsNumber + 1n
+    )
+  );
+}
+
+/**
+ * creates zip archive with no compression
+ * @note This is a node specific function that works on files
+ * @param inputPath path where files for the achive are stored
+ * @param outputPath path where zip archive will be placed
+ */
+export async function createZip(
+  inputPath: string,
+  outputPath: string,
+  createAdditionalData?: (
+    fileList: {fileName: string; localHeaderOffset: bigint}[]
+  ) => Promise<{path: string; file: ArrayBuffer}>
+) {
+  const fileIterator = getFileIterator(inputPath);
+
+  const resFile = new NodeFile(outputPath, 'w');
+  const fileList: {fileName: string; localHeaderOffset: bigint}[] = [];
+
+  const cdArray: ArrayBuffer[] = [];
+  for await (const file of fileIterator) {
+    await addFile(file, resFile, cdArray, fileList);
+  }
+  if (createAdditionalData) {
+    const additionaldata = await createAdditionalData(fileList);
+    await addFile(additionaldata, resFile, cdArray);
+  }
+  const cdOffset = (await resFile.stat()).bigsize;
+  const cd = concatenateArrayBuffers(...cdArray);
+  await resFile.append(new Uint8Array(cd));
+  const eoCDStart = (await resFile.stat()).bigsize;
+  await resFile.append(
+    new Uint8Array(
+      generateEoCD({recordsNumber: cdArray.length, cdSize: cd.byteLength, cdOffset, eoCDStart})
+    )
+  );
+}
+
+/**
+ * Adds file to zip parts
+ * @param file file to add
+ * @param resFile zip file body
+ * @param cdArray zip file central directory
+ * @param fileList list of file offsets
+ */
+async function addFile(
+  file: {path: string; file: ArrayBuffer},
+  resFile: NodeFile,
+  cdArray: ArrayBuffer[],
+  fileList?: {fileName: string; localHeaderOffset: bigint}[]
+) {
+  const size = (await resFile.stat()).bigsize;
+  fileList?.push({fileName: file.path, localHeaderOffset: size});
+  const [localPart, cdHeaderPart] = await generateFileHeaders(file.path, file.file, size);
+  await resFile.append(localPart);
+  cdArray.push(cdHeaderPart);
+}
+
+/**
+ * creates iterator providing buffer with file content and path to every file in the input folder
+ * @param inputPath path to the input folder
+ * @returns iterator
+ */
+export function getFileIterator(
+  inputPath: string
+): AsyncIterable<{path: string; file: ArrayBuffer}> {
+  async function* iterable() {
+    const fileList = await getAllFiles(inputPath);
+    for (const filePath of fileList) {
+      const file = await (await fetchFile(path.join(inputPath, filePath))).arrayBuffer();
+      yield {path: filePath, file};
+    }
+  }
+  return iterable();
+}
+
+/**
+ * creates a list of relative paths to all files in the provided folder
+ * @param basePath path of the root folder
+ * @param subfolder relative path from the root folder.
+ * @returns list of paths
+ */
+export async function getAllFiles(
+  basePath: string,
+  subfolder: string = '',
+  fsPassed?: NodeFilesystem
+): Promise<string[]> {
+  const fs = fsPassed ? fsPassed : new NodeFilesystem({});
+  const files = await fs.readdir(pathJoin(basePath, subfolder));
+
+  const arrayOfFiles: string[] = [];
+
+  for (const file of files) {
+    const fullPath = pathJoin(basePath, subfolder, file);
+    if ((await fs.stat(fullPath)).isDirectory) {
+      const files = await getAllFiles(basePath, pathJoin(subfolder, file));
+      arrayOfFiles.push(...files);
+    } else {
+      arrayOfFiles.push(pathJoin(subfolder, file));
+    }
+  }
+
+  return arrayOfFiles;
+}
+
+/**
+ * removes empty parts from path array and joins it
+ * @param paths paths to join
+ * @returns joined path
+ */
+function pathJoin(...paths: string[]): string {
+  const resPaths: string[] = paths.filter((val) => val.length);
+  return path.join(...resPaths);
+}

package/src/parse-zip/zip64-info-generation.ts

@@ -25,7 +25,7 @@ export function createZip64Info(options: Zip64Options): ArrayBuffer {
 
   for (const field of ZIP64_FIELDS) {
     if (!optionsToUse[field.name ?? ''] && !field.default) {
-      continue;
+      continue; // eslint-disable-line no-continue
     }
     const newValue = new DataView(new ArrayBuffer(field.size));
     NUMBER_SETTERS[field.size](newValue, 0, optionsToUse[field.name ?? ''] ?? field.default);
@@ -62,10 +62,10 @@ export function setFieldToNumber(
 /** functions to write values into buffer according to the bytes amount */
 const NUMBER_SETTERS: {[key: number]: NumberSetter} = {
   2: (header, offset, value) => {
-    header.setUint16(offset, Number(value), true);
+    header.setUint16(offset, Number(value > 0xffff ? 0xffff : value), true);
   },
   4: (header, offset, value) => {
-    header.setUint32(offset, Number(value), true);
+    header.setUint32(offset, Number(value > 0xffffffff ? 0xffffffff : value), true);
   },
   8: (header, offset, value) => {
     header.setBigUint64(offset, BigInt(value), true);

package/dist/parse-zip/zip-compozition.d.ts

@@ -1,8 +0,0 @@
-/**
- * adds one file in the end of the archieve
- * @param zipUrl path to the file
- * @param fileToAdd new file body
- * @param fileName new file name
- */
-export declare function addOneFile(zipUrl: string, fileToAdd: ArrayBuffer, fileName: string): Promise<void>;
-//# sourceMappingURL=zip-compozition.d.ts.map

package/dist/parse-zip/zip-compozition.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zip-compozition.d.ts","sourceRoot":"","sources":["../../src/parse-zip/zip-compozition.ts"],"names":[],"mappings":"AAuEA;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAmCxF"}

package/dist/parse-zip/zip-compozition.js

@@ -1,43 +0,0 @@
-import { FileHandleFile, concatenateArrayBuffers } from '@loaders.gl/loader-utils';
-import { parseEoCDRecord, updateEoCD } from "./end-of-central-directory.js";
-import { CRC32Hash } from '@loaders.gl/crypto';
-import { generateLocalHeader } from "./local-file-header.js";
-import { generateCDHeader } from "./cd-file-header.js";
-async function cutTheTailOff(provider) {
-  const oldEoCDinfo = await parseEoCDRecord(provider);
-  const oldCDStartOffset = oldEoCDinfo.cdStartOffset;
-  const oldCDLength = Number(oldEoCDinfo.offsets.zip64EoCDOffset ? oldEoCDinfo.offsets.zip64EoCDOffset - oldCDStartOffset : oldEoCDinfo.offsets.zipEoCDOffset - oldCDStartOffset);
-  const zipEnding = await provider.slice(oldCDStartOffset, provider.length);
-  await provider.truncate(Number(oldCDStartOffset));
-  const oldCDBody = zipEnding.slice(0, oldCDLength);
-  const eocdBody = zipEnding.slice(oldCDLength, zipEnding.byteLength);
-  return [oldCDBody, eocdBody, oldEoCDinfo];
-}
-async function generateFileHeaders(fileName, fileToAdd, localFileHeaderOffset) {
-  const newFileCRC322 = parseInt(await new CRC32Hash().hash(fileToAdd, 'hex'), 16);
-  const newFileLocalHeader = generateLocalHeader({
-    crc32: newFileCRC322,
-    fileName,
-    length: fileToAdd.byteLength
-  });
-  const newFileCDHeader = generateCDHeader({
-    crc32: newFileCRC322,
-    fileName,
-    offset: localFileHeaderOffset,
-    length: fileToAdd.byteLength
-  });
-  return [new Uint8Array(concatenateArrayBuffers(newFileLocalHeader, fileToAdd)), new Uint8Array(newFileCDHeader)];
-}
-export async function addOneFile(zipUrl, fileToAdd, fileName) {
-  const provider = new FileHandleFile(zipUrl, true);
-  const [oldCDBody, eocdBody, oldEoCDinfo] = await cutTheTailOff(provider);
-  const newFileOffset = provider.length;
-  const [localPart, cdHeaderPart] = await generateFileHeaders(fileName, fileToAdd, newFileOffset);
-  await provider.append(localPart);
-  const newCDBody = concatenateArrayBuffers(oldCDBody, cdHeaderPart);
-  const newCDStartOffset = provider.length;
-  await provider.append(new Uint8Array(newCDBody));
-  const eocdOffset = provider.length;
-  await provider.append(await updateEoCD(eocdBody, oldEoCDinfo.offsets, newCDStartOffset, eocdOffset, oldEoCDinfo.cdRecordsNumber + 1n));
-}
-//# sourceMappingURL=zip-compozition.js.map

package/dist/parse-zip/zip-compozition.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zip-compozition.js","names":["FileHandleFile","concatenateArrayBuffers","parseEoCDRecord","updateEoCD","CRC32Hash","generateLocalHeader","generateCDHeader","cutTheTailOff","provider","oldEoCDinfo","oldCDStartOffset","cdStartOffset","oldCDLength","Number","offsets","zip64EoCDOffset","zipEoCDOffset","zipEnding","slice","length","truncate","oldCDBody","eocdBody","byteLength","generateFileHeaders","fileName","fileToAdd","localFileHeaderOffset","newFileCRC322","parseInt","hash","newFileLocalHeader","crc32","newFileCDHeader","offset","Uint8Array","addOneFile","zipUrl","newFileOffset","localPart","cdHeaderPart","append","newCDBody","newCDStartOffset","eocdOffset","cdRecordsNumber"],"sources":["../../src/parse-zip/zip-compozition.ts"],"sourcesContent":["import {FileHandleFile, concatenateArrayBuffers} from '@loaders.gl/loader-utils';\nimport {ZipEoCDRecord, parseEoCDRecord, updateEoCD} from './end-of-central-directory';\nimport {CRC32Hash} from '@loaders.gl/crypto';\nimport {generateLocalHeader} from './local-file-header';\nimport {generateCDHeader} from './cd-file-header';\n\n/**\n * cut off CD and EoCD records from zip file\n * @param provider zip file\n * @returns tuple with three values: CD, EoCD record, EoCD information\n */\nasync function cutTheTailOff(\n  provider: FileHandleFile\n): Promise<[ArrayBuffer, ArrayBuffer, ZipEoCDRecord]> {\n  // define where the body ends\n  const oldEoCDinfo = await parseEoCDRecord(provider);\n  const oldCDStartOffset = oldEoCDinfo.cdStartOffset;\n\n  // define cd length\n  const oldCDLength = Number(\n    oldEoCDinfo.offsets.zip64EoCDOffset\n      ? oldEoCDinfo.offsets.zip64EoCDOffset - oldCDStartOffset\n      : oldEoCDinfo.offsets.zipEoCDOffset - oldCDStartOffset\n  );\n\n  // cut off everything except of archieve body\n  const zipEnding = await provider.slice(oldCDStartOffset, provider.length);\n  await provider.truncate(Number(oldCDStartOffset));\n\n  // divide cd body and eocd record\n  const oldCDBody = zipEnding.slice(0, oldCDLength);\n  const eocdBody = zipEnding.slice(oldCDLength, zipEnding.byteLength);\n\n  return [oldCDBody, eocdBody, oldEoCDinfo];\n}\n\n/**\n * generates CD and local headers for the file\n * @param fileName name of the file\n * @param fileToAdd buffer with the file\n * @param localFileHeaderOffset offset of the file local header\n * @returns tuple with two values: local header and file body, cd header\n */\nasync function generateFileHeaders(\n  fileName: string,\n  fileToAdd: ArrayBuffer,\n  localFileHeaderOffset: bigint\n): Promise<[Uint8Array, Uint8Array]> {\n  // generating CRC32 of the content\n  const newFileCRC322 = parseInt(await new CRC32Hash().hash(fileToAdd, 'hex'), 16);\n\n  // generate local header for the file\n  const newFileLocalHeader = generateLocalHeader({\n    crc32: newFileCRC322,\n    fileName,\n    length: fileToAdd.byteLength\n  });\n\n  // generate hash file cd header\n  const newFileCDHeader = generateCDHeader({\n    crc32: newFileCRC322,\n    fileName,\n    offset: localFileHeaderOffset,\n    length: fileToAdd.byteLength\n  });\n  return [\n    new Uint8Array(concatenateArrayBuffers(newFileLocalHeader, fileToAdd)),\n    new Uint8Array(newFileCDHeader)\n  ];\n}\n\n/**\n * adds one file in the end of the archieve\n * @param zipUrl path to the file\n * @param fileToAdd new file body\n * @param fileName new file name\n */\nexport async function addOneFile(zipUrl: string, fileToAdd: ArrayBuffer, fileName: string) {\n  // init file handler\n  const provider = new FileHandleFile(zipUrl, true);\n\n  const [oldCDBody, eocdBody, oldEoCDinfo] = await cutTheTailOff(provider);\n\n  // remember the new file local header start offset\n  const newFileOffset = provider.length;\n\n  const [localPart, cdHeaderPart] = await generateFileHeaders(fileName, fileToAdd, newFileOffset);\n\n  // write down the file local header\n  await provider.append(localPart);\n\n  // add the file CD header to the CD\n  const newCDBody = concatenateArrayBuffers(oldCDBody, cdHeaderPart);\n\n  // remember the CD start offset\n  const newCDStartOffset = provider.length;\n\n  // write down new CD\n  await provider.append(new Uint8Array(newCDBody));\n\n  // remember where eocd starts\n  const eocdOffset = provider.length;\n\n  await provider.append(\n    await updateEoCD(\n      eocdBody,\n      oldEoCDinfo.offsets,\n      newCDStartOffset,\n      eocdOffset,\n      oldEoCDinfo.cdRecordsNumber + 1n\n    )\n  );\n}\n"],"mappings":"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"}