@myrialabs/zipkit 0.0.6

package/dist/zip/crypto/zipcrypto.js

@@ -0,0 +1,65 @@
+/**
+ * Legacy PKWARE "ZipCrypto" — decryption only, for reading old encrypted
+ * archives. The cipher is weak and long deprecated, so ZipKit never *writes* it
+ * (new encrypted archives use WinZip AES, {@link import('./winzip.js')}); this
+ * exists purely for read compatibility with historical files.
+ */
+import { ZipKitError } from '../../types.js';
+/** CRC-32 byte-update table (IEEE 802.3), built once. */
+const CRC_TABLE = (() => {
+    const t = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        t[n] = c >>> 0;
+    }
+    return t;
+})();
+function crc32Update(crc, byte) {
+    return (CRC_TABLE[(crc ^ byte) & 0xff] ^ (crc >>> 8)) >>> 0;
+}
+function initKeys(password) {
+    const keys = { k0: 0x12345678, k1: 0x23456789, k2: 0x34567890 };
+    for (const byte of new TextEncoder().encode(password))
+        updateKeys(keys, byte);
+    return keys;
+}
+function updateKeys(keys, byte) {
+    keys.k0 = crc32Update(keys.k0, byte);
+    keys.k1 = (keys.k1 + (keys.k0 & 0xff)) >>> 0;
+    keys.k1 = (Math.imul(keys.k1, 134775813) + 1) >>> 0;
+    keys.k2 = crc32Update(keys.k2, keys.k1 >>> 24);
+}
+function decryptByte(keys) {
+    const temp = (keys.k2 | 2) & 0xffff;
+    return (Math.imul(temp, temp ^ 1) >> 8) & 0xff;
+}
+/**
+ * Decrypt a ZipCrypto entry: the raw bytes are a 12-byte encryption header
+ * followed by the (still-compressed) ciphertext. `checkByte` is the expected
+ * high byte of the verification value — the CRC-32's top byte, or the DOS time's
+ * high byte when the entry used a data descriptor. Throws on a wrong password.
+ */
+export function zipCryptoDecrypt(data, password, checkByte) {
+    if (data.length < 12)
+        throw new ZipKitError('ZipCrypto entry is too short (missing encryption header)');
+    const keys = initKeys(password);
+    const header = new Uint8Array(12);
+    for (let i = 0; i < 12; i++) {
+        const c = (data[i] ^ decryptByte(keys)) & 0xff;
+        updateKeys(keys, c);
+        header[i] = c;
+    }
+    if (header[11] !== (checkByte & 0xff)) {
+        throw new ZipKitError('Wrong password for ZipCrypto entry (verification byte mismatch)');
+    }
+    const out = new Uint8Array(data.length - 12);
+    for (let i = 12; i < data.length; i++) {
+        const c = (data[i] ^ decryptByte(keys)) & 0xff;
+        updateKeys(keys, c);
+        out[i - 12] = c;
+    }
+    return out;
+}
+//# sourceMappingURL=zipcrypto.js.map

package/dist/zip/crypto/zipcrypto.js.map

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

package/dist/zip/datetime.d.ts

@@ -0,0 +1,9 @@
+/** MS-DOS date/time <-> JS Date, as stored in ZIP local/central headers. */
+/** Encode a Date to a packed DOS date and time pair (`{ date, time }`). */
+export declare function toDosDateTime(d: Date): {
+    date: number;
+    time: number;
+};
+/** Decode a packed DOS date/time pair back to a Date. */
+export declare function fromDosDateTime(date: number, time: number): Date;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/zip/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/zip/datetime.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKrE;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAShE"}

package/dist/zip/datetime.js

@@ -0,0 +1,13 @@
+/** MS-DOS date/time <-> JS Date, as stored in ZIP local/central headers. */
+/** Encode a Date to a packed DOS date and time pair (`{ date, time }`). */
+export function toDosDateTime(d) {
+    const year = Math.max(1980, d.getFullYear());
+    const date = (((year - 1980) & 0x7f) << 9) | ((d.getMonth() + 1) << 5) | d.getDate();
+    const time = (d.getHours() << 11) | (d.getMinutes() << 5) | (d.getSeconds() >> 1);
+    return { date, time };
+}
+/** Decode a packed DOS date/time pair back to a Date. */
+export function fromDosDateTime(date, time) {
+    return new Date(((date >> 9) & 0x7f) + 1980, ((date >> 5) & 0x0f) - 1, date & 0x1f, (time >> 11) & 0x1f, (time >> 5) & 0x3f, (time & 0x1f) << 1);
+}
+//# sourceMappingURL=datetime.js.map

package/dist/zip/datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../src/zip/datetime.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,CAAO;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACrF,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAClF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACzD,OAAO,IAAI,IAAI,CACd,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,EAC3B,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EACxB,IAAI,GAAG,IAAI,EACX,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,IAAI,EACnB,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,EAClB,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAClB,CAAC;AACH,CAAC"}

package/dist/zip/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * ZIP container — create and read multi-file archives.
+ *
+ * Interoperates with standard tools (`unzip`, Explorer, fflate): `store` and
+ * `deflate` entries round-trip everywhere. ZipKit additionally supports `zstd`
+ * (method 93) inside the container for much denser archives between ZipKit-aware
+ * peers. Entry metadata (modification time, Unix permissions, comment) is
+ * preserved both ways, and archives over 4 GB / 65 535 entries transparently
+ * use ZIP64.
+ *
+ * Everything is in-memory and async (the codecs are Wasm). Reading supports a
+ * `filter` so you only pay to decompress the entries you want.
+ *
+ * @example
+ * ```ts
+ * import { zip, unzip } from '@myrialabs/zipkit/zip';
+ * const archive = await zip([
+ *   { name: 'hello.txt', data: strToU8('hi') },
+ *   { name: 'data.json', data: bytes, method: 'zstd' }
+ * ]);
+ * const files = await unzip(archive, { filter: (e) => e.name.endsWith('.json') });
+ * ```
+ */
+/** Built-in ZIP compression methods, by friendly name. */
+export type ZipMethod = 'store' | 'deflate' | 'zstd';
+/** An entry to add to an archive. */
+export interface ZipEntryInput {
+    /** Path within the archive, using `/` separators. */
+    name: string;
+    /** Uncompressed contents. */
+    data: Uint8Array;
+    /** Compression method (default `'deflate'`). */
+    method?: ZipMethod;
+    /** DEFLATE/zstd level. */
+    level?: number;
+    /** Last-modified time (default: now). */
+    mtime?: Date | number;
+    /** Unix permission bits, e.g. `0o644`. Stored in the external attributes. */
+    unixPermissions?: number;
+    /** Optional per-entry comment. */
+    comment?: string;
+}
+/** A decoded archive entry. */
+export interface ZipEntry {
+    /** Path within the archive. */
+    name: string;
+    /** Decompressed contents (omitted when a `filter` rejected the entry). */
+    data: Uint8Array;
+    /** Numeric compression method as stored (0 = store, 8 = deflate, 93 = zstd). */
+    method: number;
+    /** Last-modified time. */
+    mtime: Date;
+    /** Uncompressed size in bytes. */
+    size: number;
+    /** Compressed size in bytes. */
+    compressedSize: number;
+    /** Stored CRC-32 of the uncompressed data. */
+    crc32: number;
+    /** Unix permission bits, if the archive recorded any. */
+    unixPermissions?: number;
+    /** Per-entry comment, if present. */
+    comment?: string;
+}
+/** Metadata for an entry, passed to a read `filter` before decompression. */
+export interface ZipEntryInfo {
+    name: string;
+    method: number;
+    size: number;
+    compressedSize: number;
+    mtime: Date;
+    unixPermissions?: number;
+}
+/** Options for {@link unzip}. */
+export interface UnzipOptions {
+    /** Decompress only the entries for which this returns `true`. */
+    filter?: (entry: ZipEntryInfo) => boolean;
+    /**
+     * Recompute each decompressed entry's CRC-32 and compare it to the value
+     * stored in the archive, throwing {@link ZipKitError} on a mismatch. Off by
+     * default — turn it on to detect silent corruption explicitly rather than
+     * trusting the codec's own (format-dependent) integrity checks.
+     */
+    verify?: boolean;
+    /**
+     * Password for encrypted entries. Decrypts WinZip AES (AE-1/AE-2) and legacy
+     * ZipCrypto entries. Required if the archive is encrypted; a wrong password
+     * throws {@link ZipKitError}.
+     */
+    password?: string;
+}
+/** Options for {@link zip}. */
+export interface ZipOptions {
+    /**
+     * Compress entries concurrently across the worker pool. Independent entries
+     * fan out over every core while the container is assembled in order, so the
+     * output is byte-identical to the single-threaded path.
+     *
+     * Defaults to automatic: on when there are at least two entries and the
+     * archive totals at least 256 KB, off otherwise (the worker hand-off would
+     * cost more than it saves on tiny archives). Set explicitly to override.
+     */
+    parallel?: boolean;
+    /**
+     * Reports archive-build progress as each entry finishes compressing:
+     * `(entriesDone, totalEntries)`. Fires up to once per entry; the final call
+     * has `entriesDone === totalEntries`.
+     */
+    onProgress?: (entriesDone: number, totalEntries: number) => void;
+    /**
+     * Encrypt every entry with WinZip AES (AE-2). Reads back with the same
+     * `password` via {@link unzip}, and interoperates with 7-Zip / WinZip. AES-256
+     * by default; the per-entry CRC is omitted as the AE-2 spec requires.
+     */
+    password?: string;
+}
+/**
+ * Build a ZIP archive from a list of entries. Returns the complete archive
+ * bytes. Uses ZIP64 automatically when any size/offset exceeds 4 GB or there
+ * are more than 65 535 entries.
+ */
+export declare function zip(entries: ZipEntryInput[], opts?: ZipOptions): Promise<Uint8Array>;
+/**
+ * Read a ZIP archive. Returns one {@link ZipEntry} per file. Pass
+ * `opts.filter` to skip decompressing entries you don't need — rejected
+ * entries are omitted from the result.
+ */
+export declare function unzip(data: Uint8Array, opts?: UnzipOptions): Promise<ZipEntry[]>;
+/**
+ * List the entries in an archive without decompressing them. Cheaper than
+ * {@link unzip} when you only need names, sizes, and metadata.
+ */
+export declare function listEntries(data: Uint8Array): Promise<ZipEntryInfo[]>;
+export { zipStream, type ZipStreamOptions } from './stream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/zip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/zip/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAoBH,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAIrD,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC7B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+BAA+B;AAC/B,MAAM,WAAW,QAAQ;IACxB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,UAAU,CAAC;IACjB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,EAAE,IAAI,CAAC;IACZ,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,IAAI,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC5B,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAC1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAkFD;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA4L9F;AA4DD;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2H1F;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAS3E;AAGD,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}