zip-writer 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,427 @@
+# zip-writable
+
+A modern streaming ZIP archive writer for JavaScript that uses the
+[Web Streams API](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API)
+and
+[Compression Streams API](https://developer.mozilla.org/en-US/docs/Web/API/Compression_Streams_API).
+
+## Features
+
+- **Streaming API** - Write ZIP archives using Web Streams
+- **Memory efficient** - Process large files without loading them entirely into
+  memory
+- **ZIP64 support** - Automatic handling of large files and archives
+- **Modern JavaScript** - Built with TypeScript, uses native Web Streams API
+- **Flexible** - Reorder, rename, or remove entries before finalizing
+
+## Installation
+
+```bash
+npm install zip-writable
+```
+
+## Basic Usage
+
+```ts
+import { ZipWriter } from "zip-writable";
+
+const zipWriter = new ZipWriter();
+
+// Pipe the ZIP output somewhere
+zipWriter.readable.pipeTo(writableStream);
+
+// Add entries to the ZIP
+const entryWriter = zipWriter.createEntryStream({ name: "hello.txt" });
+const writer = entryWriter.writable.getWriter();
+await writer.write(new TextEncoder().encode("Hello, World!"));
+await writer.close();
+
+// Get entry info after writing
+const info = await entryWriter.getEntryInfo();
+console.log(info);
+
+// Finalize the ZIP archive
+await zipWriter.finalize();
+```
+
+## API Reference
+
+### `ZipWriter`
+
+The main class for creating ZIP archives.
+
+#### Constructor
+
+##### `new ZipWriter(options?)`
+
+**Parameters:**
+
+- `options.crc32?: (data: Uint8Array, value?: number) => number` - Optional
+  CRC32 function to use. Defaults to `zlib.crc32` on Node.js and a pure
+  JavaScript implementation in browsers.
+
+#### Properties
+
+##### `readable: ReadableStream<Uint8Array>`
+
+The readable stream containing the ZIP archive data. Pipe this to a file, HTTP
+response, or any other writable destination.
+
+```ts
+// Save to file (Node.js with fs/promises)
+import { createWriteStream } from "fs";
+import { Writable } from "stream";
+
+zipWriter.readable.pipeTo(Writable.toWeb(createWriteStream("archive.zip")));
+
+// Send as HTTP response (in a web server)
+return new Response(zipWriter.readable, {
+  headers: {
+    "Content-Type": "application/zip",
+    "Content-Disposition": 'attachment; filename="archive.zip"',
+  },
+});
+```
+
+##### `entries: ReadonlyArray<Readonly<EntryInfo>>`
+
+Array of all entries that have been written to the archive. Each entry contains
+metadata like size, CRC32, compression info, etc.
+
+#### Methods
+
+##### `createEntry(data: Uint8Array, options: EntryOptions): Promise<EntryInfo>`
+
+Convenience method to add a buffer as an entry to the zip archive. Returns a
+promise that resolves to the entry info once written. For more efficient
+streaming writes, use `createEntryStream()`.
+
+**Parameters:**
+
+- `data: Uint8Array` - Entry data to write
+- `options.name: string` - Entry name including internal path (required)
+- `options.comment?: string` - Entry comment
+- `options.date?: Date` - Entry date (defaults to current date)
+- `options.mode?: number` - Entry permissions (Unix-style mode)
+- `options.store?: boolean` - Set to `true` to disable compression (defaults to
+  `false`, using DEFLATE compression)
+
+**Example:**
+
+```ts
+const data = new TextEncoder().encode("Hello, World!");
+const entryInfo = await zipWriter.createEntry(data, { name: "hello.txt" });
+console.log(entryInfo);
+```
+
+##### `createEntryStream(options: EntryOptions): EntryWriter`
+
+Create a new entry in the ZIP archive. Returns an `EntryWriter` that you can
+write data to via streams.
+
+**Parameters:**
+
+- `options.name: string` - Entry name including internal path (required)
+- `options.comment?: string` - Entry comment
+- `options.date?: Date` - Entry date (defaults to current date)
+- `options.mode?: number` - Entry permissions (Unix-style mode)
+- `options.store?: boolean` - Set to `true` to disable compression (defaults to
+  `false`, using DEFLATE compression)
+
+**Examples:**
+
+```ts
+// Simple text file
+const entry = zipWriter.createEntryStream({ name: "readme.txt" });
+const writer = entry.writable.getWriter();
+await writer.write(new TextEncoder().encode("Hello!"));
+await writer.close();
+
+// Stream a fetch response
+const response = await fetch(imageUrl);
+response.body.pipeTo(
+  zipWriter.createEntryStream({ name: "images/photo.jpg" }).writable,
+);
+
+// With custom date and permissions
+zipWriter.createEntryStream({
+  name: "script.sh",
+  date: new Date("2024-01-01"),
+  mode: 0o755, // executable
+}).writable;
+
+// Disable compression for already-compressed files
+zipWriter.createEntryStream({
+  name: "video.mp4",
+  store: true, // no compression
+}).writable;
+```
+
+##### `onceQueueEmpty(): Promise<void>`
+
+Wait until all currently queued entries have been written. Useful when you need
+to ensure entries are complete before continuing.
+
+```ts
+// Add multiple entries
+zipWriter.createEntryStream({ name: "file1.txt" }).writable;
+zipWriter.createEntryStream({ name: "file2.txt" }).writable;
+
+// Wait for all to complete
+await zipWriter.onceQueueEmpty();
+console.log(`Wrote ${zipWriter.entries.length} entries`);
+```
+
+##### `finalize(options?): Promise<{ zip64: boolean, uncompressedEntriesSize: bigint, compressedEntriesSize: bigint, fileSize: bigint }>`
+
+Finalize the ZIP archive by writing the central directory and end of central
+directory records. This must be called after all entries have been added. This
+will await any pending entries to finish writing before finalizing.
+
+**Parameters:**
+
+- `options.entries?: ReadonlyArray<Readonly<EntryInfo>>` - (Advanced) Override
+  the entries to write in the central directory. This can be used to reorder,
+  remove, or rename entries before finalizing the archive. You cannot change the
+  offset, CRC32, compressed size, or uncompressed size of entries - only the
+  name, comment, date, and order.
+
+**Returns:**
+
+- `zip64: boolean` - Whether the archive uses ZIP64 format
+- `uncompressedEntriesSize: bigint` - Total uncompressed size of all entries
+- `compressedEntriesSize: bigint` - Total compressed size of all entries
+- `fileSize: bigint` - Total size of the ZIP file
+
+```ts
+const result = await zipWriter.finalize();
+console.log(`Created ${result.zip64 ? "ZIP64" : "standard"} archive`);
+console.log(`File size: ${result.fileSize} bytes`);
+console.log(
+  `Compression ratio: ${Number(result.compressedEntriesSize) / Number(result.uncompressedEntriesSize)}`,
+);
+```
+
+**Example with entries option:**
+
+```ts
+// Wait for all entries to be written
+await zipWriter.onceQueueEmpty();
+
+// Get current entries and modify them
+const entries = [...zipWriter.entries];
+
+// Remove an entry
+const filtered = entries.filter((e) => e.name !== "temp.txt");
+
+// Rename entries
+const renamed = entries.map((e) => ({
+  ...e,
+  name: e.name.replace(/^old\//, "new/"),
+}));
+
+// Sort entries alphabetically
+const sorted = [...entries].sort((a, b) => a.name.localeCompare(b.name));
+
+// Finalize with modified entries
+await zipWriter.finalize({ entries: sorted });
+```
+
+### `EntryWriter`
+
+Returned by `ZipWriter.createEntryStream()`. Provides a writable stream to write
+entry data.
+
+#### Properties
+
+##### `writable: WritableStream<Uint8Array>`
+
+The writable stream to write entry data to. Close this stream when done writing.
+
+```ts
+const entryWriter = zipWriter.createEntryStream({ name: "data.txt" });
+
+// Using a writer
+const writer = entryWriter.writable.getWriter();
+await writer.write(new TextEncoder().encode("chunk 1"));
+await writer.write(new TextEncoder().encode("chunk 2"));
+await writer.close();
+
+// Using pipeTo
+someReadableStream.pipeTo(entryWriter.writable);
+```
+
+#### Methods
+
+##### `getEntryInfo(): Promise<EntryInfo>`
+
+Get entry info. Resolves once all data has been written to the ZIP stream.
+
+**Returns `EntryInfo`:**
+
+- `name: string` - Entry name
+- `comment?: string` - Entry comment
+- `date?: Date` - Entry date
+- `mode?: number` - Entry permissions
+- `store?: boolean` - Whether compression was disabled
+- `startOffset: bigint | number` - Byte offset in the archive
+- `crc32: number` - CRC32 checksum
+- `uncompressedSize: bigint | number` - Uncompressed size in bytes
+- `compressedSize: bigint | number` - Compressed size in bytes
+- `zip64: boolean` - Whether this entry uses ZIP64 format
+
+```ts
+const entryWriter = zipWriter.createEntryStream({ name: "test.txt" });
+await someStream.pipeTo(entryWriter.writable);
+
+const info = await entryWriter.getEntryInfo();
+console.log(
+  `Wrote ${info.name}: ${info.uncompressedSize} bytes (compressed to ${info.compressedSize})`,
+);
+```
+
+## Complete Example
+
+```ts
+import { ZipWriter } from "zip-writable";
+import { createWriteStream } from "fs";
+import { Writable } from "stream";
+
+async function createZip() {
+  const zipWriter = new ZipWriter();
+
+  // Pipe output to file
+  const fileStream = Writable.toWeb(createWriteStream("output.zip"));
+  zipWriter.readable.pipeTo(fileStream);
+
+  // Add a text file using createEntry
+  const data1 = new TextEncoder().encode("This is a readme");
+  await zipWriter.createEntry(data1, { name: "readme.txt" });
+
+  // Add files from URLs using createEntryStream
+  const imageResponse = await fetch("https://example.com/image.png");
+  await imageResponse.body.pipeTo(
+    zipWriter.createEntryStream({ name: "images/photo.png" }).writable,
+  );
+
+  // Add a JSON file using createEntry
+  const data = { hello: "world" };
+  const jsonData = new TextEncoder().encode(JSON.stringify(data, null, 2));
+  await zipWriter.createEntry(jsonData, { name: "data.json" });
+
+  // Wait for all entries and check results
+  await zipWriter.onceQueueEmpty();
+  console.log(`Added ${zipWriter.entries.length} entries`);
+
+  // Finalize the archive
+  const result = await zipWriter.finalize();
+  console.log(`Created archive: ${result.fileSize} bytes`);
+}
+
+createZip().catch(console.error);
+```
+
+## Browser Usage
+
+```ts
+// Create a ZIP and trigger download
+const zipWriter = new ZipWriter();
+
+// Add entries...
+const data = new TextEncoder().encode("Hello");
+zipWriter
+  .createEntry(data, { name: "file.txt" })
+  .then(() => zipWriter.finalize());
+
+// Create download link
+const blob = await new Response(zipWriter.readable).blob();
+const url = URL.createObjectURL(blob);
+const a = document.createElement("a");
+a.href = url;
+a.download = "archive.zip";
+a.click();
+URL.revokeObjectURL(url);
+```
+
+## Benchmarks
+
+Run using `npm run bench`. On a MacBook Pro (M2 Pro, 2023), Node.js 20.19.0:
+
+### Small files (10 × 10KB)
+
+| Library                       | ops/sec | Relative Speed |
+| ----------------------------- | ------- | -------------- |
+| zip-writable (@node-rs/crc32) | 721.94  | **fastest**    |
+| zip-writable                  | 674.57  | 1.07x slower   |
+| zip-writable (js crc32)       | 659.90  | 1.09x slower   |
+| fflate                        | 553.00  | 1.31x slower   |
+| archiver                      | 338.14  | 2.14x slower   |
+| @zip.js/zip.js                | 279.19  | 2.59x slower   |
+
+### Medium files (100 × 100KB)
+
+| Library                       | ops/sec | Relative Speed |
+| ----------------------------- | ------- | -------------- |
+| zip-writable                  | 23.91   | **fastest**    |
+| zip-writable (@node-rs/crc32) | 22.91   | 1.04x slower   |
+| zip-writable (js crc32)       | 18.93   | 1.26x slower   |
+| archiver                      | 18.10   | 1.32x slower   |
+| @zip.js/zip.js                | 11.65   | 2.05x slower   |
+| fflate                        | 10.27   | 2.33x slower   |
+
+### Large files (5 × 10MB)
+
+| Library                       | ops/sec | Relative Speed |
+| ----------------------------- | ------- | -------------- |
+| zip-writable                  | 7.22    | **fastest**    |
+| zip-writable (@node-rs/crc32) | 6.78    | 1.06x slower   |
+| archiver                      | 5.65    | 1.28x slower   |
+| zip-writable (js crc32)       | 4.82    | 1.50x slower   |
+| fflate                        | 4.20    | 1.72x slower   |
+| @zip.js/zip.js                | 4.00    | 1.81x slower   |
+
+### Many files (1000 × 1KB)
+
+| Library                       | ops/sec | Relative Speed |
+| ----------------------------- | ------- | -------------- |
+| fflate                        | 10.08   | **fastest**    |
+| zip-writable                  | 6.89    | 1.46x slower   |
+| zip-writable (@node-rs/crc32) | 5.94    | 1.70x slower   |
+| zip-writable (js crc32)       | 5.63    | 1.79x slower   |
+| archiver                      | 4.98    | 2.02x slower   |
+| @zip.js/zip.js                | 2.93    | 3.44x slower   |
+
+Note: These benchmarks vary quite a bit, and they aren't an indication that any
+library is "better" than any other. For ZipWriter, these exist as a check to
+ensure that performance isn't significantly worse than other libraries.
+
+## ZIP64 Support
+
+The library automatically uses ZIP64 format when needed:
+
+- Archives with more than 65,535 entries
+- Files larger than 4GB
+- Central directory larger than 4GB
+- Central directory offset greater than 4GB
+
+No special configuration is needed - it's handled automatically.
+
+## Error Handling
+
+```ts
+try {
+  const entryWriter = zipWriter.entry({ name: "test.txt" });
+  await someStream.pipeTo(entryWriter.writable);
+  await entryWriter.getEntryInfo();
+} catch (error) {
+  console.error("Failed to write entry:", error);
+  // The ZIP stream is aborted on error - cannot add more entries
+}
+```
+
+Once an error occurs during entry writing, the ZIP stream is corrupted and
+cannot be recovered. You must create a new `ZipWriter` instance.
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,21 @@
+export declare const LOCAL_FILE_HEADER_SIGNATURE = 1347093252;
+export declare const DATA_DESCRIPTOR_SIGNATURE = 1347094280;
+export declare const CENTRAL_DIRECTORY_SIGNATURE = 1347092738;
+export declare const END_OF_CENTRAL_DIR_SIGNATURE = 1347093766;
+export declare const ZIP64_END_OF_CENTRAL_DIR_SIGNATURE = 1347094022;
+export declare const ZIP64_END_OF_CENTRAL_DIR_LOCATOR_SIGNATURE = 1347094023;
+export declare const VERSION_MADE_BY = 45;
+export declare const VERSION_NEEDED_STANDARD = 20;
+export declare const VERSION_NEEDED_ZIP64 = 45;
+export declare const GENERAL_PURPOSE_FLAGS = 2056;
+export declare const COMPRESSION_METHOD_STORE = 0;
+export declare const COMPRESSION_METHOD_DEFLATE = 8;
+export declare const LOCAL_FILE_HEADER_SIZE = 30;
+export declare const CENTRAL_DIRECTORY_HEADER_SIZE = 46;
+export declare const DATA_DESCRIPTOR_SIZE = 16;
+export declare const DATA_DESCRIPTOR_SIZE_ZIP64 = 24;
+export declare const EOCD_SIZE = 22;
+export declare const EOCD64_SIZE = 56;
+export declare const EOCD64_LOCATOR_SIZE = 20;
+export declare const ZIP64_LIMIT: bigint;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,2BAA2B,aAAa,CAAC;AACtD,eAAO,MAAM,yBAAyB,aAAa,CAAC;AACpD,eAAO,MAAM,2BAA2B,aAAa,CAAC;AACtD,eAAO,MAAM,4BAA4B,aAAa,CAAC;AACvD,eAAO,MAAM,kCAAkC,aAAa,CAAC;AAC7D,eAAO,MAAM,0CAA0C,aAAa,CAAC;AAGrE,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,eAAO,MAAM,qBAAqB,OAAwB,CAAC;AAG3D,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAG5C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAGtC,eAAO,MAAM,WAAW,QAAqB,CAAC"}

package/{src/constants.ts → dist/constants.js}

@@ -5,19 +5,15 @@ export const CENTRAL_DIRECTORY_SIGNATURE = 0x504b0102; // "PK\x01\x02"
 export const END_OF_CENTRAL_DIR_SIGNATURE = 0x504b0506; // "PK\x05\x06"
 export const ZIP64_END_OF_CENTRAL_DIR_SIGNATURE = 0x504b0606; // "PK\x06\x06"
 export const ZIP64_END_OF_CENTRAL_DIR_LOCATOR_SIGNATURE = 0x504b0607; // "PK\x06\x07"
-
 // Version constants
 export const VERSION_MADE_BY = 45; // Version 4.5 (ZIP64 support)
 export const VERSION_NEEDED_STANDARD = 20; // Version 2.0
 export const VERSION_NEEDED_ZIP64 = 45; // Version 4.5 for ZIP64
-
 // Flags
 export const GENERAL_PURPOSE_FLAGS = 0b0000_1000_0000_1000; // Bit 3: data descriptor, Bit 11: UTF-8
-
 // Compression methods
 export const COMPRESSION_METHOD_STORE = 0;
 export const COMPRESSION_METHOD_DEFLATE = 8;
-
 // Size constants
 export const LOCAL_FILE_HEADER_SIZE = 30;
 export const CENTRAL_DIRECTORY_HEADER_SIZE = 46;
@@ -26,6 +22,6 @@ export const DATA_DESCRIPTOR_SIZE_ZIP64 = 24;
 export const EOCD_SIZE = 22;
 export const EOCD64_SIZE = 56;
 export const EOCD64_LOCATOR_SIZE = 20;
-
 // Limits
 export const ZIP64_LIMIT = BigInt(0xffffffff);
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC,CAAC,eAAe;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC,CAAC,eAAe;AACpE,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC,CAAC,eAAe;AACtE,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC,CAAC,eAAe;AACvE,MAAM,CAAC,MAAM,kCAAkC,GAAG,UAAU,CAAC,CAAC,eAAe;AAC7E,MAAM,CAAC,MAAM,0CAA0C,GAAG,UAAU,CAAC,CAAC,eAAe;AAErF,oBAAoB;AACpB,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC,CAAC,8BAA8B;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC,CAAC,cAAc;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,CAAC,wBAAwB;AAEhE,QAAQ;AACR,MAAM,CAAC,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,CAAC,wCAAwC;AAEpG,sBAAsB;AACtB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C,iBAAiB;AACjB,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,SAAS;AACT,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC"}

package/{src/crc.ts → dist/crc-browser.d.ts}

@@ -20,9 +20,6 @@
  *    misrepresented as being the original software.
  * 3. This notice may not be removed or altered from any source distribution.
  */
-
-import { lookup } from "./crc-lookup.js";
-
 /**
  * Computes a 32-bit Cyclic Redundancy Check checksum of data. If value is
  * specified, it is used as the starting value of the checksum, otherwise, 0 is
@@ -32,39 +29,5 @@ import { lookup } from "./crc-lookup.js";
  * @param value -  An optional starting value. It must be a 32-bit unsigned integer. Default: 0
  * @returns The computed CRC32 checksum.
  */
-export function crc32(
-  data: Uint8Array<ArrayBuffer>,
-  value: number = 0
-): number {
-  let crc = ~value;
-  let i = 0;
-  let length = data.byteLength;
-
-  while (length >= 16) {
-    crc =
-      lookup[15][data[i++] ^ (crc & 0xff)] ^
-      lookup[14][data[i++] ^ ((crc >>> 8) & 0xff)] ^
-      lookup[13][data[i++] ^ ((crc >>> 16) & 0xff)] ^
-      lookup[12][data[i++] ^ (crc >>> 24)] ^
-      lookup[11][data[i++]] ^
-      lookup[10][data[i++]] ^
-      lookup[9][data[i++]] ^
-      lookup[8][data[i++]] ^
-      lookup[7][data[i++]] ^
-      lookup[6][data[i++]] ^
-      lookup[5][data[i++]] ^
-      lookup[4][data[i++]] ^
-      lookup[3][data[i++]] ^
-      lookup[2][data[i++]] ^
-      lookup[1][data[i++]] ^
-      lookup[0][data[i++]];
-
-    length -= 16;
-  }
-
-  while (length-- > 0) {
-    crc = (crc >>> 8) ^ lookup[0][(crc & 0xff) ^ data[i++]];
-  }
-
-  return ~crc >>> 0;
-}
+export declare function crc32(data: Uint8Array<ArrayBuffer>, value?: number): number;
+//# sourceMappingURL=crc-browser.d.ts.map

package/dist/crc-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc-browser.d.ts","sourceRoot":"","sources":["../src/crc-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA8BH;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,EAC7B,KAAK,GAAE,MAAU,GAChB,MAAM,CAgCR"}

package/dist/crc-browser.js

@@ -0,0 +1,82 @@
+/**
+ * The JavaScript implementation of CRC32 is a version of the slice-by-16 algorithm
+ * as implemented by Stephan Brumme, see https://github.com/stbrumme/crc32.
+ *
+ * Copyright (c) 2011-2016 Stephan Brumme
+ *
+ * This software is provided 'as-is', without any express or implied warranty.
+ * In no event will the authors be held liable for any damages arising from the
+ * use of this software.
+ *
+ * Permission is granted to anyone to use this software for any purpose,
+ * including commercial applications, and to alter it and redistribute it freely,
+ * subject to the following restrictions:
+ *
+ * 1. The origin of this software must not be misrepresented; you must not claim
+ *    that you wrote the original software.
+ *    If you use this software in a product, an acknowledgment in the product
+ *    documentation would be appreciated but is not required.
+ * 2. Altered source versions must be plainly marked as such, and must not be
+ *    misrepresented as being the original software.
+ * 3. This notice may not be removed or altered from any source distribution.
+ */
+/**
+ * From https://github.com/holepunchto/crc-universal/blob/main/lookup.js
+ * Licensed under Apache-2.0
+ */
+const lookup = new Array(16);
+for (let i = 0; i < 16; i++) {
+    lookup[i] = new Uint32Array(0x100);
+}
+for (let i = 0; i <= 0xff; i++) {
+    let crc = i;
+    for (let j = 0; j < 8; j++) {
+        crc = (crc >>> 1) ^ ((crc & 1) * 0xedb88320);
+    }
+    lookup[0][i] = crc;
+}
+for (let i = 0; i <= 0xff; i++) {
+    for (let j = 1; j < 16; j++) {
+        lookup[j][i] =
+            (lookup[j - 1][i] >>> 8) ^ lookup[0][lookup[j - 1][i] & 0xff];
+    }
+}
+/**
+ * Computes a 32-bit Cyclic Redundancy Check checksum of data. If value is
+ * specified, it is used as the starting value of the checksum, otherwise, 0 is
+ * used as the starting value.
+ *
+ * @param data - The input data to compute the checksum for.
+ * @param value -  An optional starting value. It must be a 32-bit unsigned integer. Default: 0
+ * @returns The computed CRC32 checksum.
+ */
+export function crc32(data, value = 0) {
+    let crc = ~value;
+    let i = 0;
+    let length = data.byteLength;
+    while (length >= 16) {
+        crc =
+            lookup[15][data[i++] ^ (crc & 0xff)] ^
+                lookup[14][data[i++] ^ ((crc >>> 8) & 0xff)] ^
+                lookup[13][data[i++] ^ ((crc >>> 16) & 0xff)] ^
+                lookup[12][data[i++] ^ (crc >>> 24)] ^
+                lookup[11][data[i++]] ^
+                lookup[10][data[i++]] ^
+                lookup[9][data[i++]] ^
+                lookup[8][data[i++]] ^
+                lookup[7][data[i++]] ^
+                lookup[6][data[i++]] ^
+                lookup[5][data[i++]] ^
+                lookup[4][data[i++]] ^
+                lookup[3][data[i++]] ^
+                lookup[2][data[i++]] ^
+                lookup[1][data[i++]] ^
+                lookup[0][data[i++]];
+        length -= 16;
+    }
+    while (length-- > 0) {
+        crc = (crc >>> 8) ^ lookup[0][(crc & 0xff) ^ data[i++]];
+    }
+    return ~crc >>> 0;
+}
+//# sourceMappingURL=crc-browser.js.map

package/dist/crc-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc-browser.js","sourceRoot":"","sources":["../src/crc-browser.ts"],"names":[],"mappings":"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"}

package/dist/crc-node.d.ts

@@ -0,0 +1,2 @@
+export { crc32 } from "node:zlib";
+//# sourceMappingURL=crc-node.d.ts.map

package/dist/crc-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc-node.d.ts","sourceRoot":"","sources":["../src/crc-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/crc-node.js

@@ -0,0 +1,3 @@
+// @ts-nocheck
+export { crc32 } from "node:zlib";
+//# sourceMappingURL=crc-node.js.map

package/dist/crc-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc-node.js","sourceRoot":"","sources":["../src/crc-node.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}