neozipkit 1.0.5 → 1.5.0

package/dist/core/origin/OriginExtra.js

@@ -0,0 +1,187 @@
+"use strict";
+// ======================================
+//	OriginExtra.ts — NeoZip Extra Field 0x014F (original locator)
+//  Copyright (c) 2026 NeoWare, Inc. All rights reserved.
+// ======================================
+// APPNOTE §7.1.1 / ZipWiki §6.7 — v1 TLV (URI, CRC-32, size, mtime, SHA-256).
+// The kit stores opaque caller extras on ZipEntry.additionalExtra; these helpers
+// build and parse the 0x014F wire form.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORIGIN_TAG = exports.ORIGIN_URI_MAX_BYTES = exports.ORIGIN_EXTRA_VERSION = void 0;
+exports.originLocatorPresent = originLocatorPresent;
+exports.originCrc32Of = originCrc32Of;
+exports.originSha256Of = originSha256Of;
+exports.unixTimeSeconds = unixTimeSeconds;
+exports.makeOriginExtra = makeOriginExtra;
+exports.parseOriginFromExtra = parseOriginFromExtra;
+exports.parseOriginFromEntry = parseOriginFromEntry;
+const Headers_1 = require("../constants/Headers");
+const ZipCrypto_1 = require("../encryption/ZipCrypto");
+/** Payload version byte. Stays 0x01 until first release. */
+exports.ORIGIN_EXTRA_VERSION = 0x01;
+/** Soft cap on URI byte length (well under uint16 extra size). */
+exports.ORIGIN_URI_MAX_BYTES = 2048;
+/** Registered v1 TLV tags. Unknown tags are skipped (forward compatible). */
+exports.ORIGIN_TAG = {
+    URI: 0x01,
+    CRC32: 0x02,
+    SIZE: 0x03,
+    MTIME: 0x04,
+    SHA256: 0x05,
+};
+function originSha256Bytes(value) {
+    const buf = typeof value === 'string' ? Buffer.from(value, 'hex') : value;
+    if (buf.length !== 32) {
+        throw new Error('0x014F sha256 must be 32 bytes');
+    }
+    return buf;
+}
+function tlv(tag, value) {
+    const rec = Buffer.alloc(3 + value.length);
+    rec.writeUInt8(tag, 0);
+    rec.writeUInt16LE(value.length, 1);
+    value.copy(rec, 3);
+    return rec;
+}
+function assertInteger(name, value) {
+    if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error(`0x014F ${name} must be an integer`);
+    }
+}
+function originLocatorPresent(loc) {
+    if (!loc)
+        return false;
+    return ((typeof loc.uri === 'string' && loc.uri.length > 0) ||
+        loc.crc32 !== undefined ||
+        loc.size !== undefined ||
+        loc.mtime !== undefined ||
+        loc.sha256 !== undefined);
+}
+/** ZIP/IEEE CRC-32 of uncompressed original bytes. */
+function originCrc32Of(buf) {
+    return (0, ZipCrypto_1.crc32)(buf) >>> 0;
+}
+/** SHA-256 of uncompressed original bytes (32-byte Buffer). */
+function originSha256Of(buf) {
+    return Buffer.from((0, ZipCrypto_1.sha256)(buf), 'hex');
+}
+/** Truncate a Date to Unix seconds (UTC). */
+function unixTimeSeconds(date) {
+    return Math.floor(date.getTime() / 1000);
+}
+/**
+ * Build Extra Field 0x014F (v1 TLV). Throws if no attribute is present,
+ * if URI is empty when provided, or if URI exceeds max bytes.
+ */
+function makeOriginExtra(loc) {
+    const records = [];
+    const uri = loc.uri?.trim();
+    if (uri !== undefined && uri.length === 0) {
+        throw new Error('0x014F URI must be non-empty when present');
+    }
+    if (uri) {
+        const uriBuf = Buffer.from(uri, 'utf8');
+        if (uriBuf.length > exports.ORIGIN_URI_MAX_BYTES) {
+            throw new Error(`0x014F URI exceeds ${exports.ORIGIN_URI_MAX_BYTES} bytes (${uriBuf.length})`);
+        }
+        records.push(tlv(exports.ORIGIN_TAG.URI, uriBuf));
+    }
+    if (loc.crc32 !== undefined) {
+        assertInteger('crc32', loc.crc32);
+        const b = Buffer.alloc(4);
+        b.writeUInt32LE(loc.crc32 >>> 0, 0);
+        records.push(tlv(exports.ORIGIN_TAG.CRC32, b));
+    }
+    if (loc.size !== undefined) {
+        assertInteger('size', loc.size);
+        if (loc.size < 0) {
+            throw new Error('0x014F size must be >= 0');
+        }
+        const b = Buffer.alloc(8);
+        b.writeBigUInt64LE(BigInt(loc.size), 0);
+        records.push(tlv(exports.ORIGIN_TAG.SIZE, b));
+    }
+    if (loc.mtime !== undefined) {
+        assertInteger('mtime', loc.mtime);
+        const b = Buffer.alloc(8);
+        b.writeBigInt64LE(BigInt(loc.mtime), 0);
+        records.push(tlv(exports.ORIGIN_TAG.MTIME, b));
+    }
+    if (loc.sha256 !== undefined) {
+        records.push(tlv(exports.ORIGIN_TAG.SHA256, originSha256Bytes(loc.sha256)));
+    }
+    if (records.length === 0) {
+        throw new Error('0x014F requires at least one attribute');
+    }
+    const dataSize = 1 + records.reduce((n, r) => n + r.length, 0);
+    const extra = Buffer.alloc(4 + dataSize);
+    extra.writeUInt16LE(Headers_1.HDR_ID.ORIGIN, 0);
+    extra.writeUInt16LE(dataSize, 2);
+    extra.writeUInt8(exports.ORIGIN_EXTRA_VERSION, 4);
+    let off = 5;
+    for (const rec of records) {
+        rec.copy(extra, off);
+        off += rec.length;
+    }
+    return extra;
+}
+function parseOriginTlv(data) {
+    const loc = {};
+    let i = 0;
+    while (i + 3 <= data.length) {
+        const tag = data.readUInt8(i);
+        const len = data.readUInt16LE(i + 1);
+        i += 3;
+        if (i + len > data.length)
+            break;
+        const value = data.subarray(i, i + len);
+        i += len;
+        if (tag === exports.ORIGIN_TAG.URI && len > 0) {
+            const u = value.toString('utf8');
+            if (u.length > 0)
+                loc.uri = u;
+        }
+        else if (tag === exports.ORIGIN_TAG.CRC32 && len === 4) {
+            loc.crc32 = value.readUInt32LE(0) >>> 0;
+        }
+        else if (tag === exports.ORIGIN_TAG.SIZE && len === 8) {
+            loc.size = Number(value.readBigUInt64LE(0));
+        }
+        else if (tag === exports.ORIGIN_TAG.MTIME && len === 8) {
+            loc.mtime = Number(value.readBigInt64LE(0));
+        }
+        else if (tag === exports.ORIGIN_TAG.SHA256 && len === 32) {
+            loc.sha256 = Buffer.from(value);
+        }
+    }
+    return originLocatorPresent(loc) ? loc : null;
+}
+/** Walk a ZIP Extra Field blob for NeoZip 0x014F (v1 TLV). */
+function parseOriginFromExtra(extra) {
+    if (!extra || extra.length < 4)
+        return null;
+    let i = 0;
+    while (i + 4 <= extra.length) {
+        const id = extra.readUInt16LE(i);
+        const size = extra.readUInt16LE(i + 2);
+        i += 4;
+        if (i + size > extra.length)
+            break;
+        if (id === Headers_1.HDR_ID.ORIGIN && size >= 1) {
+            const version = extra.readUInt8(i);
+            const payload = extra.subarray(i + 1, i + size);
+            if (version === exports.ORIGIN_EXTRA_VERSION) {
+                const loc = parseOriginTlv(payload);
+                if (loc)
+                    return loc;
+            }
+        }
+        i += size;
+    }
+    return null;
+}
+/** Read origin locator from a ZipEntry's preserved caller extras. */
+function parseOriginFromEntry(entry) {
+    return parseOriginFromExtra(entry.additionalExtra ?? null);
+}
+//# sourceMappingURL=OriginExtra.js.map

package/dist/core/origin/OriginExtra.js.map

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

package/dist/core/version.js

@@ -25,7 +25,7 @@ exports.VERSION = void 0;
 const currentDate = new Date();
 const releaseDate = `${String(currentDate.getMonth() + 1).padStart(2, '0')}-${String(currentDate.getDate()).padStart(2, '0')}-${currentDate.getFullYear()}`;
 exports.VERSION = {
-    number: '1.0.5', // packageJson.version
+    number: '1.5.0', // packageJson.version
     date: releaseDate
 };
 //# sourceMappingURL=version.js.map

package/dist/core/zip64/Zip64.d.ts

@@ -0,0 +1,138 @@
+/** Classic u32 overflow sentinel */
+export declare const ZIP64_U32 = 4294967295;
+/** Classic u16 overflow sentinel */
+export declare const ZIP64_U16 = 65535;
+/** Version needed to extract when Zip64 extensions are used (4.5) */
+export declare const ZIP64_VERSION_NEEDED = 45;
+/**
+ * Value stored in Zip64 EOCD "size of Zip64 EOCD record" for Version 1 with
+ * an empty extensible data sector: fixed body (56) − leading 12 = 44.
+ */
+export declare const ZIP64_EOCD_SIZE_FIELD = 44;
+/** Fixed Zip64 EOCD record length with empty extensible sector */
+export declare const ZIP64_EOCD_RECORD_SIZE = 56;
+/** Zip64 EOCD locator length */
+export declare const ZIP64_LOCATOR_SIZE = 20;
+/** Classic EOCD fixed length (without comment) */
+export declare const CLASSIC_EOCD_SIZE = 22;
+/**
+ * Buffer/browser APIs must not materialize multi-GiB Zip64 archives in memory.
+ * Use Node file/streaming APIs for size/offset Zip64.
+ */
+export declare const ZIP64_BUFFER_SIZE_OFFSET_ERROR: string;
+export interface Zip64ExtraFields {
+    uncompressedSize?: number;
+    compressedSize?: number;
+    localHdrOffset?: number;
+    diskStart?: number;
+}
+export interface ClassicSizeFields {
+    uncompressedSize: number;
+    compressedSize: number;
+    localHdrOffset: number;
+    diskStart: number;
+}
+export interface Zip64EocdFields {
+    totalEntries: number;
+    centralDirSize: number;
+    centralDirOffset: number;
+    versionMadeBy?: number;
+    versionNeeded?: number;
+    diskNumber?: number;
+    diskWithCdStart?: number;
+}
+export interface BuildEndRecordsOptions {
+    totalEntries: number;
+    centralDirSize: number;
+    centralDirOffset: number;
+    /** Absolute file offset where the Zip64 EOCD will be written (CD end). */
+    zip64EocdOffset: number;
+    archiveComment?: string;
+    /**
+     * When false (buffer/browser), refuse Zip64 triggered by size/offset overflow.
+     * Entry-count Zip64 is still allowed. Default true (Node streaming).
+     */
+    allowSizeOffsetZip64?: boolean;
+    /**
+     * Emit Zip64 EOCD + locator even when classic widths suffice (APPNOTE MAY).
+     * Classic EOCD then uses a CD-offset sentinel so readers consult Zip64 EOCD
+     * (Info-ZIP `-fz` style).
+     */
+    forceZip64?: boolean;
+    versionMadeBy?: number;
+}
+export declare function exceedsU32(value: number): boolean;
+export declare function exceedsU16(value: number): boolean;
+export declare function assertSafeInteger(value: number | bigint, label: string): number;
+export declare function readU64AsNumber(buf: Buffer, offset: number): number;
+export declare function writeU64(buf: Buffer, offset: number, value: number): void;
+export declare function needsZip64Entry(uncompressedSize: number, compressedSize: number, localHdrOffset: number, diskStart?: number): boolean;
+/** True when Zip64 is required for member size or local/CD offset (not entry count alone). */
+export declare function needsZip64SizeOrOffset(uncompressedSize: number, compressedSize: number, localHdrOffset: number, centralDirSize?: number, centralDirOffset?: number): boolean;
+export declare function needsZip64Archive(totalEntries: number, centralDirSize: number, centralDirOffset: number): boolean;
+/**
+ * Classic EOCD fields that indicate a Zip64 EOCD/locator must be consulted.
+ */
+export declare function classicEocdNeedsZip64(eocd: {
+    volEntries: number;
+    totalEntries: number;
+    centralDirSize: number;
+    centralDirOffset: number;
+}): boolean;
+/**
+ * Build Zip64 Extended Information Extra Field (0x0001).
+ * Field order is fixed; only include fields whose classic header uses a sentinel.
+ * For local headers, APPNOTE requires both sizes when the Zip64 block is present —
+ * pass `forLocal: true` to always emit both size fields.
+ */
+export declare function buildZip64Extra(fields: Zip64ExtraFields, opts?: {
+    forLocal?: boolean;
+}): Buffer;
+/**
+ * Parse Zip64 extra payload (data after HeaderID + size).
+ * Only fields whose classic values are sentinels are consumed, in APPNOTE order.
+ */
+export declare function parseZip64Extra(data: Buffer, classic: ClassicSizeFields): Zip64ExtraFields;
+/** True if a complete extra-field blob contains a Zip64 (0x0001) record. */
+export declare function extraFieldHasZip64(extra: Buffer | null | undefined): boolean;
+/** Strip Zip64 records from a concatenated extra-field blob (avoid double-emit on rewrite). */
+export declare function stripZip64FromExtra(extra: Buffer | null | undefined): Buffer | null;
+/**
+ * Data descriptor length including optional signature.
+ * Zip64: signature(4) + crc(4) + cmp(8) + uncmp(8) = 24
+ * Classic: signature(4) + crc(4) + cmp(4) + uncmp(4) = 16
+ */
+export declare function dataDescriptorByteLength(useZip64Sizes: boolean): number;
+export declare function buildZip64Eocd(fields: Zip64EocdFields): Buffer;
+export declare function buildZip64Locator(zip64EocdOffset: number): Buffer;
+export declare function buildClassicEocd(opts: {
+    totalEntries: number;
+    centralDirSize: number;
+    centralDirOffset: number;
+    archiveComment?: string;
+    /** When true, write 0xFFFF / 0xFFFFFFFF for any field that overflows classic width. */
+    useZip64Sentinels: boolean;
+    /**
+     * Force classic CD offset to 0xFFFFFFFF so readers consult Zip64 EOCD
+     * even when the real offset fits in u32 (Info-ZIP `-fz`).
+     */
+    forceCdOffsetSentinel?: boolean;
+}): Buffer;
+/**
+ * Build Zip64 EOCD + Locator + classic EOCD (or classic EOCD alone).
+ * Callers write the returned buffer at `zip64EocdOffset` (or CD end when no Zip64).
+ */
+export declare function buildEndRecords(opts: BuildEndRecordsOptions): Buffer;
+/** Parse Zip64 EOCD fixed fields into CD size/offset/entry count. */
+export declare function parseZip64Eocd(buf: Buffer): {
+    totalEntries: number;
+    centralDirSize: number;
+    centralDirOffset: number;
+};
+export declare function parseZip64Locator(buf: Buffer): number;
+/**
+ * Assert buffer/browser writers may proceed for the given entry sizes/offsets.
+ * Throws {@link ZIP64_BUFFER_SIZE_OFFSET_ERROR} when size/offset Zip64 would be required.
+ */
+export declare function assertBufferAllowsEntryZip64(uncompressedSize: number, compressedSize: number, localHdrOffset: number): void;
+//# sourceMappingURL=Zip64.d.ts.map

package/dist/core/zip64/Zip64.d.ts.map

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