@rahul_dadhich15/archive-kit 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,424 @@
1
+ import { gzip, gzipSync, gunzip, gunzipSync } from 'fflate';
2
+
3
+ // src/shared/errors.ts
4
+ var ArchiveKitError = class _ArchiveKitError extends Error {
5
+ code;
6
+ details;
7
+ constructor(code, message, details) {
8
+ super(message);
9
+ this.name = "ArchiveKitError";
10
+ this.code = code;
11
+ this.details = details;
12
+ Object.setPrototypeOf(this, _ArchiveKitError.prototype);
13
+ }
14
+ };
15
+
16
+ // src/shared/binary.ts
17
+ async function toUint8Array(input) {
18
+ if (input instanceof Uint8Array) {
19
+ return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
20
+ }
21
+ if (input instanceof ArrayBuffer) {
22
+ return new Uint8Array(input);
23
+ }
24
+ if (typeof Blob !== "undefined" && input instanceof Blob) {
25
+ const arrayBuffer = await input.arrayBuffer();
26
+ return new Uint8Array(arrayBuffer);
27
+ }
28
+ throw new ArchiveKitError(
29
+ "INVALID_INPUT",
30
+ "Expected Uint8Array, ArrayBuffer, Blob, or File input"
31
+ );
32
+ }
33
+ function toUint8ArraySync(input) {
34
+ if (input instanceof Uint8Array) {
35
+ return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
36
+ }
37
+ if (input instanceof ArrayBuffer) {
38
+ return new Uint8Array(input);
39
+ }
40
+ throw new ArchiveKitError(
41
+ "INVALID_INPUT",
42
+ "Synchronous API requires Uint8Array or ArrayBuffer"
43
+ );
44
+ }
45
+ var textEncoder = new TextEncoder();
46
+ var textDecoder = new TextDecoder("utf-8", { fatal: true });
47
+ function encodeUtf8(text) {
48
+ if (typeof text !== "string") {
49
+ throw new ArchiveKitError("INVALID_INPUT", "Expected string input");
50
+ }
51
+ return textEncoder.encode(text);
52
+ }
53
+ function decodeUtf8(bytes) {
54
+ try {
55
+ return textDecoder.decode(bytes);
56
+ } catch (err) {
57
+ throw new ArchiveKitError(
58
+ "INVALID_INPUT",
59
+ "Data is not valid UTF-8 text",
60
+ err
61
+ );
62
+ }
63
+ }
64
+ var CRC_TABLE = new Uint32Array(256);
65
+ for (let i = 0; i < 256; i++) {
66
+ let c = i;
67
+ for (let k = 0; k < 8; k++) {
68
+ c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
69
+ }
70
+ CRC_TABLE[i] = c >>> 0;
71
+ }
72
+ function computeCrc32(data) {
73
+ let crc = 4294967295;
74
+ for (let i = 0; i < data.length; i++) {
75
+ const byte = data[i] ?? 0;
76
+ crc = (CRC_TABLE[(crc ^ byte) & 255] ?? 0) ^ crc >>> 8;
77
+ }
78
+ return (crc ^ 4294967295) >>> 0;
79
+ }
80
+
81
+ // src/shared/blob.ts
82
+ function createBlob(data, mimeType = "application/octet-stream") {
83
+ if (typeof Blob === "undefined") {
84
+ throw new ArchiveKitError(
85
+ "INVALID_INPUT",
86
+ "Blob API is not available in the current environment"
87
+ );
88
+ }
89
+ const parts = Array.isArray(data) ? data : [data];
90
+ return new Blob(parts, { type: mimeType });
91
+ }
92
+ function validateCompressionLevel(level) {
93
+ if (level === void 0) return 6;
94
+ if (!Number.isInteger(level) || level < 0 || level > 9) {
95
+ throw new ArchiveKitError(
96
+ "INVALID_INPUT",
97
+ `Compression level must be an integer between 0 and 9, received: ${level}`
98
+ );
99
+ }
100
+ return level;
101
+ }
102
+ function calculateRatio(compressed, original) {
103
+ if (original <= 0) return 1;
104
+ return Number((compressed / original).toFixed(4));
105
+ }
106
+ function calculatePercentageSaved(compressed, original) {
107
+ if (original <= 0) return 0;
108
+ const saved = (1 - compressed / original) * 100;
109
+ return Math.max(0, Number(saved.toFixed(2)));
110
+ }
111
+
112
+ // src/gzip/metadata.ts
113
+ var GZIP_MAGIC_0 = 31;
114
+ var GZIP_MAGIC_1 = 139;
115
+ var GZIP_METHOD_DEFLATE = 8;
116
+ var FLG_FHCRC = 2;
117
+ var FLG_FEXTRA = 4;
118
+ var FLG_FNAME = 8;
119
+ var FLG_FCOMMENT = 16;
120
+ function isGzipDataSync(data) {
121
+ try {
122
+ const bytes = toUint8ArraySync(data);
123
+ return bytes.length >= 10 && bytes[0] === GZIP_MAGIC_0 && bytes[1] === GZIP_MAGIC_1 && bytes[2] === GZIP_METHOD_DEFLATE;
124
+ } catch {
125
+ return false;
126
+ }
127
+ }
128
+ async function isGzipData(data) {
129
+ try {
130
+ const bytes = await toUint8Array(data);
131
+ return isGzipDataSync(bytes);
132
+ } catch {
133
+ return false;
134
+ }
135
+ }
136
+ function getGzipMetadataSync(data) {
137
+ const bytes = toUint8ArraySync(data);
138
+ if (bytes.length < 10) {
139
+ throw new ArchiveKitError(
140
+ "INVALID_GZIP_DATA",
141
+ "Input data is too small to be a valid GZIP stream (minimum 10 bytes required)"
142
+ );
143
+ }
144
+ if (bytes[0] !== GZIP_MAGIC_0 || bytes[1] !== GZIP_MAGIC_1) {
145
+ throw new ArchiveKitError(
146
+ "INVALID_GZIP_DATA",
147
+ `Invalid GZIP magic bytes: expected 0x1F8B, found 0x${(bytes[0] ?? 0).toString(16).padStart(2, "0")}${(bytes[1] ?? 0).toString(16).padStart(2, "0")}`
148
+ );
149
+ }
150
+ const method = bytes[2];
151
+ if (method !== GZIP_METHOD_DEFLATE) {
152
+ throw new ArchiveKitError(
153
+ "UNSUPPORTED_COMPRESSION",
154
+ `Unsupported GZIP compression method: ${method} (only DEFLATE 8 is standard)`
155
+ );
156
+ }
157
+ const flg = bytes[3] ?? 0;
158
+ const mtimeSeconds = (bytes[4] ?? 0) | (bytes[5] ?? 0) << 8 | (bytes[6] ?? 0) << 16 | (bytes[7] ?? 0) * 16777216;
159
+ const mtime = mtimeSeconds > 0 ? new Date(mtimeSeconds * 1e3) : void 0;
160
+ const os = bytes[9];
161
+ let offset = 10;
162
+ if ((flg & FLG_FEXTRA) !== 0) {
163
+ if (offset + 2 > bytes.length) {
164
+ throw new ArchiveKitError("INVALID_GZIP_DATA", "Truncated GZIP extra field");
165
+ }
166
+ const xlen = (bytes[offset] ?? 0) | (bytes[offset + 1] ?? 0) << 8;
167
+ offset += 2 + xlen;
168
+ if (offset > bytes.length) {
169
+ throw new ArchiveKitError("INVALID_GZIP_DATA", "Truncated GZIP extra field payload");
170
+ }
171
+ }
172
+ let filename;
173
+ if ((flg & FLG_FNAME) !== 0) {
174
+ const fnStart = offset;
175
+ while (offset < bytes.length && bytes[offset] !== 0) {
176
+ offset++;
177
+ }
178
+ if (offset >= bytes.length) {
179
+ throw new ArchiveKitError("INVALID_GZIP_DATA", "Truncated GZIP filename");
180
+ }
181
+ const fnBytes = bytes.subarray(fnStart, offset);
182
+ try {
183
+ filename = new TextDecoder("utf-8", { fatal: false }).decode(fnBytes);
184
+ } catch {
185
+ filename = String.fromCharCode(...fnBytes);
186
+ }
187
+ offset++;
188
+ }
189
+ let comment;
190
+ if ((flg & FLG_FCOMMENT) !== 0) {
191
+ const cmStart = offset;
192
+ while (offset < bytes.length && bytes[offset] !== 0) {
193
+ offset++;
194
+ }
195
+ if (offset >= bytes.length) {
196
+ throw new ArchiveKitError("INVALID_GZIP_DATA", "Truncated GZIP comment");
197
+ }
198
+ const cmBytes = bytes.subarray(cmStart, offset);
199
+ try {
200
+ comment = new TextDecoder("utf-8", { fatal: false }).decode(cmBytes);
201
+ } catch {
202
+ comment = String.fromCharCode(...cmBytes);
203
+ }
204
+ offset++;
205
+ }
206
+ if ((flg & FLG_FHCRC) !== 0) {
207
+ offset += 2;
208
+ if (offset > bytes.length) {
209
+ throw new ArchiveKitError("INVALID_GZIP_DATA", "Truncated GZIP header CRC");
210
+ }
211
+ }
212
+ let originalSize;
213
+ if (bytes.length >= 18) {
214
+ const trailerOffset = bytes.length - 4;
215
+ originalSize = ((bytes[trailerOffset] ?? 0) | (bytes[trailerOffset + 1] ?? 0) << 8 | (bytes[trailerOffset + 2] ?? 0) << 16 | (bytes[trailerOffset + 3] ?? 0) * 16777216) >>> 0;
216
+ }
217
+ const compressedSize = bytes.length;
218
+ const ratio = originalSize !== void 0 ? calculateRatio(compressedSize, originalSize) : 1;
219
+ const saved = originalSize !== void 0 ? calculatePercentageSaved(compressedSize, originalSize) : 0;
220
+ let outputFilename = filename;
221
+ if (!outputFilename) {
222
+ outputFilename = "extracted";
223
+ }
224
+ return {
225
+ originalSize,
226
+ compressedSize,
227
+ compressionRatio: ratio,
228
+ compressionPercentageSaved: saved,
229
+ filename,
230
+ comment,
231
+ mtime,
232
+ os,
233
+ mimeType: "application/gzip",
234
+ outputFilename
235
+ };
236
+ }
237
+ async function getGzipMetadata(data) {
238
+ const bytes = await toUint8Array(data);
239
+ return getGzipMetadataSync(bytes);
240
+ }
241
+ async function gzipCompress(data, options) {
242
+ if (options?.signal?.aborted) {
243
+ throw new ArchiveKitError("OPERATION_CANCELLED", "Compression was aborted");
244
+ }
245
+ const bytes = await toUint8Array(data);
246
+ const level = validateCompressionLevel(options?.level);
247
+ return new Promise((resolve, reject) => {
248
+ let completed = false;
249
+ if (options?.signal) {
250
+ options.signal.addEventListener("abort", () => {
251
+ if (!completed) {
252
+ completed = true;
253
+ reject(new ArchiveKitError("OPERATION_CANCELLED", "Compression was aborted"));
254
+ }
255
+ });
256
+ }
257
+ gzip(
258
+ bytes,
259
+ {
260
+ level,
261
+ filename: options?.filename,
262
+ mtime: options?.mtime
263
+ },
264
+ (err, result) => {
265
+ if (completed) return;
266
+ completed = true;
267
+ if (err) {
268
+ reject(
269
+ new ArchiveKitError("INVALID_INPUT", `GZIP compression failed: ${err.message}`, err)
270
+ );
271
+ } else {
272
+ resolve(result);
273
+ }
274
+ }
275
+ );
276
+ });
277
+ }
278
+ function gzipCompressSync(data, options) {
279
+ const bytes = typeof data === "string" ? encodeUtf8(data) : toUint8ArraySync(data);
280
+ const level = validateCompressionLevel(options?.level);
281
+ try {
282
+ return gzipSync(bytes, {
283
+ level,
284
+ filename: options?.filename,
285
+ mtime: options?.mtime
286
+ });
287
+ } catch (err) {
288
+ const message = err instanceof Error ? err.message : String(err);
289
+ throw new ArchiveKitError("INVALID_INPUT", `GZIP compression failed: ${message}`, err);
290
+ }
291
+ }
292
+ async function gzipCompressText(text, options) {
293
+ const bytes = encodeUtf8(text);
294
+ return gzipCompress(bytes, options);
295
+ }
296
+ function gzipCompressTextSync(text, options) {
297
+ const bytes = encodeUtf8(text);
298
+ return gzipCompressSync(bytes, options);
299
+ }
300
+ async function gzipCompressBlob(data, options) {
301
+ const compressed = await gzipCompress(data, options);
302
+ return createBlob(compressed, options?.mimeType ?? "application/gzip");
303
+ }
304
+ var GZIP_MAGIC_02 = 31;
305
+ var GZIP_MAGIC_12 = 139;
306
+ var GZIP_METHOD_DEFLATE2 = 8;
307
+ function validateGzipHeader(bytes) {
308
+ if (bytes.length === 0) {
309
+ throw new ArchiveKitError(
310
+ "INVALID_GZIP_DATA",
311
+ "Input data is empty or too small to be valid GZIP"
312
+ );
313
+ }
314
+ if (bytes.length < 2 || bytes[0] !== GZIP_MAGIC_02 || bytes[1] !== GZIP_MAGIC_12) {
315
+ throw new ArchiveKitError(
316
+ "INVALID_GZIP_DATA",
317
+ `Invalid GZIP magic bytes: expected 0x1F8B, found 0x${(bytes[0] ?? 0).toString(16).padStart(2, "0")}${(bytes[1] ?? 0).toString(16).padStart(2, "0")}`
318
+ );
319
+ }
320
+ if (bytes.length < 18) {
321
+ throw new ArchiveKitError(
322
+ "INVALID_GZIP_DATA",
323
+ "Input data is too small to be valid GZIP (minimum 18 bytes required for header and trailer)"
324
+ );
325
+ }
326
+ if (bytes[2] !== GZIP_METHOD_DEFLATE2) {
327
+ throw new ArchiveKitError(
328
+ "UNSUPPORTED_COMPRESSION",
329
+ `Unsupported GZIP compression method: ${bytes[2]}`
330
+ );
331
+ }
332
+ }
333
+ function verifyGzipTrailer(compressedBytes, decompressed) {
334
+ const trailerOffset = compressedBytes.length - 8;
335
+ const expectedCrc = ((compressedBytes[trailerOffset] ?? 0) | (compressedBytes[trailerOffset + 1] ?? 0) << 8 | (compressedBytes[trailerOffset + 2] ?? 0) << 16 | (compressedBytes[trailerOffset + 3] ?? 0) * 16777216) >>> 0;
336
+ const expectedIsize = ((compressedBytes[trailerOffset + 4] ?? 0) | (compressedBytes[trailerOffset + 5] ?? 0) << 8 | (compressedBytes[trailerOffset + 6] ?? 0) << 16 | (compressedBytes[trailerOffset + 7] ?? 0) * 16777216) >>> 0;
337
+ const actualCrc = computeCrc32(decompressed);
338
+ if (actualCrc !== expectedCrc) {
339
+ throw new ArchiveKitError(
340
+ "DECOMPRESSION_FAILED",
341
+ `GZIP CRC-32 checksum mismatch: expected 0x${expectedCrc.toString(16)}, got 0x${actualCrc.toString(16)} (archive corrupted)`
342
+ );
343
+ }
344
+ const actualIsize = decompressed.length >>> 0;
345
+ if (actualIsize !== expectedIsize) {
346
+ throw new ArchiveKitError(
347
+ "DECOMPRESSION_FAILED",
348
+ `GZIP ISIZE mismatch: expected ${expectedIsize} bytes, got ${actualIsize} bytes (archive truncated or corrupted)`
349
+ );
350
+ }
351
+ }
352
+ async function gzipDecompress(data, options) {
353
+ if (options?.signal?.aborted) {
354
+ throw new ArchiveKitError("OPERATION_CANCELLED", "Decompression was aborted");
355
+ }
356
+ const bytes = await toUint8Array(data);
357
+ validateGzipHeader(bytes);
358
+ return new Promise((resolve, reject) => {
359
+ let completed = false;
360
+ if (options?.signal) {
361
+ options.signal.addEventListener("abort", () => {
362
+ if (!completed) {
363
+ completed = true;
364
+ reject(new ArchiveKitError("OPERATION_CANCELLED", "Decompression was aborted"));
365
+ }
366
+ });
367
+ }
368
+ gunzip(bytes, (err, result) => {
369
+ if (completed) return;
370
+ completed = true;
371
+ if (err) {
372
+ reject(
373
+ new ArchiveKitError(
374
+ "DECOMPRESSION_FAILED",
375
+ `GZIP decompression failed (corrupted or truncated archive): ${err.message}`,
376
+ err
377
+ )
378
+ );
379
+ } else {
380
+ try {
381
+ verifyGzipTrailer(bytes, result);
382
+ resolve(result);
383
+ } catch (verifyErr) {
384
+ reject(verifyErr);
385
+ }
386
+ }
387
+ });
388
+ });
389
+ }
390
+ function gzipDecompressSync(data, _options) {
391
+ const bytes = toUint8ArraySync(data);
392
+ validateGzipHeader(bytes);
393
+ try {
394
+ const result = gunzipSync(bytes);
395
+ verifyGzipTrailer(bytes, result);
396
+ return result;
397
+ } catch (err) {
398
+ if (err instanceof ArchiveKitError) {
399
+ throw err;
400
+ }
401
+ const message = err instanceof Error ? err.message : String(err);
402
+ throw new ArchiveKitError(
403
+ "DECOMPRESSION_FAILED",
404
+ `GZIP decompression failed (corrupted or truncated archive): ${message}`,
405
+ err
406
+ );
407
+ }
408
+ }
409
+ async function gzipDecompressText(data, options) {
410
+ const decompressed = await gzipDecompress(data, options);
411
+ return decodeUtf8(decompressed);
412
+ }
413
+ function gzipDecompressTextSync(data, options) {
414
+ const decompressed = gzipDecompressSync(data);
415
+ return decodeUtf8(decompressed);
416
+ }
417
+ async function gzipDecompressBlob(data, options) {
418
+ const decompressed = await gzipDecompress(data, options);
419
+ return createBlob(decompressed, options?.mimeType ?? "application/octet-stream");
420
+ }
421
+
422
+ export { getGzipMetadata, getGzipMetadataSync, gzipCompress, gzipCompressBlob, gzipCompressSync, gzipCompressText, gzipCompressTextSync, gzipDecompress, gzipDecompressBlob, gzipDecompressSync, gzipDecompressText, gzipDecompressTextSync, isGzipData, isGzipDataSync };
423
+ //# sourceMappingURL=index.js.map
424
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/shared/errors.ts","../../src/shared/binary.ts","../../src/shared/blob.ts","../../src/shared/validation.ts","../../src/gzip/metadata.ts","../../src/gzip/compress.ts","../../src/gzip/decompress.ts"],"names":["GZIP_MAGIC_0","GZIP_MAGIC_1","GZIP_METHOD_DEFLATE"],"mappings":"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","file":"index.js","sourcesContent":["import type { ArchiveKitErrorCode } from './types.js';\n\n/**\n * Custom error class for all archive-kit errors with typed codes and details.\n */\nexport class ArchiveKitError extends Error {\n readonly code: ArchiveKitErrorCode;\n readonly details?: unknown;\n\n constructor(code: ArchiveKitErrorCode, message: string, details?: unknown) {\n super(message);\n this.name = 'ArchiveKitError';\n this.code = code;\n this.details = details;\n Object.setPrototypeOf(this, ArchiveKitError.prototype);\n }\n}\n","import { ArchiveKitError } from './errors.js';\nimport type { BinaryInput } from './types.js';\n\n/**\n * Converts any supported binary input into a Uint8Array.\n * Does not mutate caller-owned buffers.\n */\nexport async function toUint8Array(input: BinaryInput): Promise<Uint8Array> {\n if (input instanceof Uint8Array) {\n return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n }\n if (input instanceof ArrayBuffer) {\n return new Uint8Array(input);\n }\n if (typeof Blob !== 'undefined' && input instanceof Blob) {\n const arrayBuffer = await input.arrayBuffer();\n return new Uint8Array(arrayBuffer);\n }\n throw new ArchiveKitError(\n 'INVALID_INPUT',\n 'Expected Uint8Array, ArrayBuffer, Blob, or File input'\n );\n}\n\n/**\n * Synchronous variant for Uint8Array or ArrayBuffer input.\n */\nexport function toUint8ArraySync(input: Uint8Array | ArrayBuffer): Uint8Array {\n if (input instanceof Uint8Array) {\n return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n }\n if (input instanceof ArrayBuffer) {\n return new Uint8Array(input);\n }\n throw new ArchiveKitError(\n 'INVALID_INPUT',\n 'Synchronous API requires Uint8Array or ArrayBuffer'\n );\n}\n\n/**\n * Converts Uint8Array or ArrayBuffer to ArrayBuffer.\n */\nexport function toArrayBuffer(input: Uint8Array | ArrayBuffer): ArrayBuffer {\n if (input instanceof ArrayBuffer) {\n return input;\n }\n if (input instanceof Uint8Array) {\n if (input.byteOffset === 0 && input.byteLength === input.buffer.byteLength) {\n return input.buffer as ArrayBuffer;\n }\n return input.buffer.slice(\n input.byteOffset,\n input.byteOffset + input.byteLength\n ) as ArrayBuffer;\n }\n throw new ArchiveKitError(\n 'INVALID_INPUT',\n 'Expected Uint8Array or ArrayBuffer'\n );\n}\n\nconst textEncoder = new TextEncoder();\nconst textDecoder = new TextDecoder('utf-8', { fatal: true });\n\n/**\n * Encodes text to UTF-8 bytes using browser-native TextEncoder.\n */\nexport function encodeUtf8(text: string): Uint8Array {\n if (typeof text !== 'string') {\n throw new ArchiveKitError('INVALID_INPUT', 'Expected string input');\n }\n return textEncoder.encode(text);\n}\n\n/**\n * Decodes UTF-8 bytes to text with strict verification (fatal: true).\n * Throws INVALID_INPUT if bytes are not valid UTF-8.\n */\nexport function decodeUtf8(bytes: Uint8Array): string {\n try {\n return textDecoder.decode(bytes);\n } catch (err) {\n throw new ArchiveKitError(\n 'INVALID_INPUT',\n 'Data is not valid UTF-8 text',\n err\n );\n }\n}\n\n/**\n * Concatenates multiple Uint8Arrays efficiently into one buffer.\n */\nexport function concatUint8Arrays(arrays: Uint8Array[]): Uint8Array {\n let totalLength = 0;\n for (let i = 0; i < arrays.length; i++) {\n const arr = arrays[i];\n if (arr) {\n totalLength += arr.length;\n }\n }\n const result = new Uint8Array(totalLength);\n let offset = 0;\n for (let i = 0; i < arrays.length; i++) {\n const arr = arrays[i];\n if (arr) {\n result.set(arr, offset);\n offset += arr.length;\n }\n }\n return result;\n}\n\n/**\n * Compares two Uint8Arrays for byte-for-byte equality.\n */\nexport function compareUint8Arrays(a: Uint8Array, b: Uint8Array): boolean {\n if (a.length !== b.length) return false;\n for (let i = 0; i < a.length; i++) {\n if (a[i] !== b[i]) return false;\n }\n return true;\n}\n\n// Precomputed table for IEEE 802.3 CRC-32\nconst CRC_TABLE = new Uint32Array(256);\nfor (let i = 0; i < 256; i++) {\n let c = i;\n for (let k = 0; k < 8; k++) {\n c = (c & 1) ? (0xedb88320 ^ (c >>> 1)) : (c >>> 1);\n }\n CRC_TABLE[i] = c >>> 0;\n}\n\n/**\n * Computes standard 32-bit CRC checksum for verifying ZIP entry integrity.\n */\nexport function computeCrc32(data: Uint8Array): number {\n let crc = 0xffffffff;\n for (let i = 0; i < data.length; i++) {\n const byte = data[i] ?? 0;\n crc = (CRC_TABLE[(crc ^ byte) & 0xff] ?? 0) ^ (crc >>> 8);\n }\n return (crc ^ 0xffffffff) >>> 0;\n}\n","import { ArchiveKitError } from './errors.js';\n\n/**\n * Creates a browser-compatible Blob from Uint8Array or array of chunks.\n */\nexport function createBlob(\n data: Uint8Array | Uint8Array[],\n mimeType = 'application/octet-stream'\n): Blob {\n if (typeof Blob === 'undefined') {\n throw new ArchiveKitError(\n 'INVALID_INPUT',\n 'Blob API is not available in the current environment'\n );\n }\n const parts = Array.isArray(data) ? data : [data];\n return new Blob(parts as BlobPart[], { type: mimeType });\n}\n\n/**\n * Reads a Blob as Uint8Array.\n */\nexport async function readBlobAsUint8Array(blob: Blob): Promise<Uint8Array> {\n const buffer = await blob.arrayBuffer();\n return new Uint8Array(buffer);\n}\n","import { ArchiveKitError } from './errors.js';\n\nexport const DEFAULT_SECURITY_LIMITS = {\n maxEntries: 10_000,\n maxEntrySize: 250 * 1024 * 1024, // 250 MB\n maxTotalSize: 1024 * 1024 * 1024, // 1 GB\n maxCompressionRatio: 100, // 100:1 ratio protection against ZIP bombs\n maxInputSize: 1024 * 1024 * 1024 // 1 GB\n} as const;\n\n/**\n * Validates compression level (0-9).\n */\nexport function validateCompressionLevel(level?: number): number {\n if (level === undefined) return 6;\n if (!Number.isInteger(level) || level < 0 || level > 9) {\n throw new ArchiveKitError(\n 'INVALID_INPUT',\n `Compression level must be an integer between 0 and 9, received: ${level}`\n );\n }\n return level;\n}\n\n/**\n * Validates maximum entry count.\n */\nexport function validateEntryCount(count: number, limit: number = DEFAULT_SECURITY_LIMITS.maxEntries): void {\n if (count > limit) {\n throw new ArchiveKitError(\n 'ENTRY_LIMIT_EXCEEDED',\n `Archive entry count (${count}) exceeds the maximum limit of ${limit}`\n );\n }\n}\n\n/**\n * Validates per-entry decompressed size.\n */\nexport function validateDecompressedSize(\n size: number,\n limit: number = DEFAULT_SECURITY_LIMITS.maxEntrySize,\n path?: string\n): void {\n if (size > limit) {\n throw new ArchiveKitError(\n 'FILE_SIZE_LIMIT_EXCEEDED',\n `Entry ${path ? `\"${path}\" ` : ''}decompressed size (${size} bytes) exceeds limit of ${limit} bytes`\n );\n }\n}\n\n/**\n * Validates aggregate decompressed size.\n */\nexport function validateTotalDecompressedSize(\n size: number,\n limit: number = DEFAULT_SECURITY_LIMITS.maxTotalSize\n): void {\n if (size > limit) {\n throw new ArchiveKitError(\n 'TOTAL_SIZE_LIMIT_EXCEEDED',\n `Total uncompressed size (${size} bytes) exceeds maximum limit of ${limit} bytes`\n );\n }\n}\n\n/**\n * Validates compression ratio to prevent ZIP bombs.\n * Only enforced when uncompressed size is greater than 1MB to avoid false alarms on tiny files.\n */\nexport function validateCompressionRatio(\n uncompressed: number,\n compressed: number,\n maxRatio: number = DEFAULT_SECURITY_LIMITS.maxCompressionRatio,\n path?: string\n): void {\n if (uncompressed > 1024 * 1024) {\n const ratio = uncompressed / Math.max(1, compressed);\n if (ratio > maxRatio) {\n throw new ArchiveKitError(\n 'COMPRESSION_RATIO_LIMIT_EXCEEDED',\n `Compression ratio (${ratio.toFixed(1)}:1) for ${path ? `\"${path}\" ` : ''}exceeds safe threshold of ${maxRatio}:1`\n );\n }\n }\n}\n\n/**\n * Calculates compression ratio (compressed / original).\n */\nexport function calculateRatio(compressed: number, original: number): number {\n if (original <= 0) return 1;\n return Number((compressed / original).toFixed(4));\n}\n\n/**\n * Calculates percentage saved: (1 - compressed / original) * 100.\n */\nexport function calculatePercentageSaved(compressed: number, original: number): number {\n if (original <= 0) return 0;\n const saved = (1 - compressed / original) * 100;\n return Math.max(0, Number(saved.toFixed(2)));\n}\n","import {\n ArchiveKitError,\n calculatePercentageSaved,\n calculateRatio,\n toUint8Array,\n toUint8ArraySync,\n type BinaryInput\n} from '../shared/index.js';\nimport type { GzipMetadata } from './types.js';\n\nconst GZIP_MAGIC_0 = 0x1f;\nconst GZIP_MAGIC_1 = 0x8b;\nconst GZIP_METHOD_DEFLATE = 0x08;\n\nconst FLG_FHCRC = 0x02;\nconst FLG_FEXTRA = 0x04;\nconst FLG_FNAME = 0x08;\nconst FLG_FCOMMENT = 0x10;\n\n/**\n * Checks synchronously whether the given data has a valid GZIP header signature.\n */\nexport function isGzipDataSync(data: Uint8Array | ArrayBuffer): boolean {\n try {\n const bytes = toUint8ArraySync(data);\n return (\n bytes.length >= 10 &&\n bytes[0] === GZIP_MAGIC_0 &&\n bytes[1] === GZIP_MAGIC_1 &&\n bytes[2] === GZIP_METHOD_DEFLATE\n );\n } catch {\n return false;\n }\n}\n\n/**\n * Checks asynchronously whether the given data (Uint8Array, ArrayBuffer, Blob, File) has a valid GZIP signature.\n */\nexport async function isGzipData(data: BinaryInput): Promise<boolean> {\n try {\n const bytes = await toUint8Array(data);\n return isGzipDataSync(bytes);\n } catch {\n return false;\n }\n}\n\n/**\n * Synchronously parses GZIP header and trailer metadata.\n */\nexport function getGzipMetadataSync(data: Uint8Array | ArrayBuffer): GzipMetadata {\n const bytes = toUint8ArraySync(data);\n\n if (bytes.length < 10) {\n throw new ArchiveKitError(\n 'INVALID_GZIP_DATA',\n 'Input data is too small to be a valid GZIP stream (minimum 10 bytes required)'\n );\n }\n\n if (bytes[0] !== GZIP_MAGIC_0 || bytes[1] !== GZIP_MAGIC_1) {\n throw new ArchiveKitError(\n 'INVALID_GZIP_DATA',\n `Invalid GZIP magic bytes: expected 0x1F8B, found 0x${(bytes[0] ?? 0).toString(16).padStart(2, '0')}${(bytes[1] ?? 0).toString(16).padStart(2, '0')}`\n );\n }\n\n const method = bytes[2];\n if (method !== GZIP_METHOD_DEFLATE) {\n throw new ArchiveKitError(\n 'UNSUPPORTED_COMPRESSION',\n `Unsupported GZIP compression method: ${method} (only DEFLATE 8 is standard)`\n );\n }\n\n const flg = bytes[3] ?? 0;\n const mtimeSeconds =\n (bytes[4] ?? 0) |\n ((bytes[5] ?? 0) << 8) |\n ((bytes[6] ?? 0) << 16) |\n ((bytes[7] ?? 0) * 0x1000000);\n const mtime = mtimeSeconds > 0 ? new Date(mtimeSeconds * 1000) : undefined;\n const os = bytes[9];\n\n let offset = 10;\n\n // Extra field\n if ((flg & FLG_FEXTRA) !== 0) {\n if (offset + 2 > bytes.length) {\n throw new ArchiveKitError('INVALID_GZIP_DATA', 'Truncated GZIP extra field');\n }\n const xlen = (bytes[offset] ?? 0) | ((bytes[offset + 1] ?? 0) << 8);\n offset += 2 + xlen;\n if (offset > bytes.length) {\n throw new ArchiveKitError('INVALID_GZIP_DATA', 'Truncated GZIP extra field payload');\n }\n }\n\n // Original file name (null-terminated string)\n let filename: string | undefined;\n if ((flg & FLG_FNAME) !== 0) {\n const fnStart = offset;\n while (offset < bytes.length && bytes[offset] !== 0) {\n offset++;\n }\n if (offset >= bytes.length) {\n throw new ArchiveKitError('INVALID_GZIP_DATA', 'Truncated GZIP filename');\n }\n const fnBytes = bytes.subarray(fnStart, offset);\n try {\n filename = new TextDecoder('utf-8', { fatal: false }).decode(fnBytes);\n } catch {\n filename = String.fromCharCode(...fnBytes);\n }\n offset++; // skip null terminator\n }\n\n // Comment (null-terminated string)\n let comment: string | undefined;\n if ((flg & FLG_FCOMMENT) !== 0) {\n const cmStart = offset;\n while (offset < bytes.length && bytes[offset] !== 0) {\n offset++;\n }\n if (offset >= bytes.length) {\n throw new ArchiveKitError('INVALID_GZIP_DATA', 'Truncated GZIP comment');\n }\n const cmBytes = bytes.subarray(cmStart, offset);\n try {\n comment = new TextDecoder('utf-8', { fatal: false }).decode(cmBytes);\n } catch {\n comment = String.fromCharCode(...cmBytes);\n }\n offset++; // skip null terminator\n }\n\n // Header CRC16\n if ((flg & FLG_FHCRC) !== 0) {\n offset += 2;\n if (offset > bytes.length) {\n throw new ArchiveKitError('INVALID_GZIP_DATA', 'Truncated GZIP header CRC');\n }\n }\n\n // Read ISIZE from the last 4 bytes of the trailer if stream length permits\n let originalSize: number | undefined;\n if (bytes.length >= 18) {\n const trailerOffset = bytes.length - 4;\n originalSize =\n ((bytes[trailerOffset] ?? 0) |\n ((bytes[trailerOffset + 1] ?? 0) << 8) |\n ((bytes[trailerOffset + 2] ?? 0) << 16) |\n ((bytes[trailerOffset + 3] ?? 0) * 0x1000000)) >>>\n 0;\n }\n\n const compressedSize = bytes.length;\n const ratio = originalSize !== undefined ? calculateRatio(compressedSize, originalSize) : 1;\n const saved = originalSize !== undefined ? calculatePercentageSaved(compressedSize, originalSize) : 0;\n\n // Deriving output filename suggestion\n let outputFilename: string | undefined = filename;\n if (!outputFilename) {\n outputFilename = 'extracted';\n }\n\n return {\n originalSize,\n compressedSize,\n compressionRatio: ratio,\n compressionPercentageSaved: saved,\n filename,\n comment,\n mtime,\n os,\n mimeType: 'application/gzip',\n outputFilename\n };\n}\n\n/**\n * Asynchronously parses GZIP metadata from any supported BinaryInput.\n */\nexport async function getGzipMetadata(data: BinaryInput): Promise<GzipMetadata> {\n const bytes = await toUint8Array(data);\n return getGzipMetadataSync(bytes);\n}\n","import { gzip, gzipSync } from 'fflate';\nimport {\n ArchiveKitError,\n createBlob,\n encodeUtf8,\n toUint8Array,\n toUint8ArraySync,\n validateCompressionLevel,\n type BinaryInput\n} from '../shared/index.js';\nimport type { GzipCompressBlobOptions, GzipCompressOptions } from './types.js';\n\n/**\n * Compresses binary data with GZIP asynchronously.\n * Suitable for browser applications to prevent blocking the UI.\n *\n * @param data - Input data as Uint8Array, ArrayBuffer, Blob, or File.\n * @param options - Compression options including level (0-9) and metadata.\n * @returns Compressed Uint8Array.\n */\nexport async function gzipCompress(\n data: BinaryInput,\n options?: GzipCompressOptions\n): Promise<Uint8Array> {\n if (options?.signal?.aborted) {\n throw new ArchiveKitError('OPERATION_CANCELLED', 'Compression was aborted');\n }\n\n const bytes = await toUint8Array(data);\n const level = validateCompressionLevel(options?.level);\n\n return new Promise<Uint8Array>((resolve, reject) => {\n let completed = false;\n\n if (options?.signal) {\n options.signal.addEventListener('abort', () => {\n if (!completed) {\n completed = true;\n reject(new ArchiveKitError('OPERATION_CANCELLED', 'Compression was aborted'));\n }\n });\n }\n\n gzip(\n bytes,\n {\n level: level as 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9,\n filename: options?.filename,\n mtime: options?.mtime\n },\n (err, result) => {\n if (completed) return;\n completed = true;\n if (err) {\n reject(\n new ArchiveKitError('INVALID_INPUT', `GZIP compression failed: ${err.message}`, err)\n );\n } else {\n resolve(result);\n }\n }\n );\n });\n}\n\n/**\n * Synchronous GZIP compression for small in-memory buffers.\n *\n * @warning Calling this on large buffers will block the JavaScript main thread.\n */\nexport function gzipCompressSync(\n data: Uint8Array | ArrayBuffer | string,\n options?: GzipCompressOptions\n): Uint8Array {\n const bytes = typeof data === 'string' ? encodeUtf8(data) : toUint8ArraySync(data);\n const level = validateCompressionLevel(options?.level);\n\n try {\n return gzipSync(bytes, {\n level: level as 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9,\n filename: options?.filename,\n mtime: options?.mtime\n });\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n throw new ArchiveKitError('INVALID_INPUT', `GZIP compression failed: ${message}`, err);\n }\n}\n\n/**\n * Compresses a UTF-8 text string into GZIP bytes asynchronously.\n */\nexport async function gzipCompressText(\n text: string,\n options?: GzipCompressOptions\n): Promise<Uint8Array> {\n const bytes = encodeUtf8(text);\n return gzipCompress(bytes, options);\n}\n\n/**\n * Synchronous text GZIP compression for small strings.\n *\n * @warning Blocks main thread on large strings.\n */\nexport function gzipCompressTextSync(\n text: string,\n options?: GzipCompressOptions\n): Uint8Array {\n const bytes = encodeUtf8(text);\n return gzipCompressSync(bytes, options);\n}\n\n/**\n * Compresses data and returns a browser-ready Blob.\n */\nexport async function gzipCompressBlob(\n data: BinaryInput,\n options?: GzipCompressBlobOptions\n): Promise<Blob> {\n const compressed = await gzipCompress(data, options);\n return createBlob(compressed, options?.mimeType ?? 'application/gzip');\n}\n","import { gunzip, gunzipSync } from 'fflate';\nimport {\n ArchiveKitError,\n computeCrc32,\n createBlob,\n decodeUtf8,\n toUint8Array,\n toUint8ArraySync,\n type BinaryInput\n} from '../shared/index.js';\nimport type { GzipDecompressBlobOptions, GzipDecompressOptions } from './types.js';\n\nconst GZIP_MAGIC_0 = 0x1f;\nconst GZIP_MAGIC_1 = 0x8b;\nconst GZIP_METHOD_DEFLATE = 0x08;\n\nfunction validateGzipHeader(bytes: Uint8Array): void {\n if (bytes.length === 0) {\n throw new ArchiveKitError(\n 'INVALID_GZIP_DATA',\n 'Input data is empty or too small to be valid GZIP'\n );\n }\n if (bytes.length < 2 || bytes[0] !== GZIP_MAGIC_0 || bytes[1] !== GZIP_MAGIC_1) {\n throw new ArchiveKitError(\n 'INVALID_GZIP_DATA',\n `Invalid GZIP magic bytes: expected 0x1F8B, found 0x${(bytes[0] ?? 0).toString(16).padStart(2, '0')}${(bytes[1] ?? 0).toString(16).padStart(2, '0')}`\n );\n }\n if (bytes.length < 18) {\n throw new ArchiveKitError(\n 'INVALID_GZIP_DATA',\n 'Input data is too small to be valid GZIP (minimum 18 bytes required for header and trailer)'\n );\n }\n if (bytes[2] !== GZIP_METHOD_DEFLATE) {\n throw new ArchiveKitError(\n 'UNSUPPORTED_COMPRESSION',\n `Unsupported GZIP compression method: ${bytes[2]}`\n );\n }\n}\n\nfunction verifyGzipTrailer(compressedBytes: Uint8Array, decompressed: Uint8Array): void {\n const trailerOffset = compressedBytes.length - 8;\n const expectedCrc =\n ((compressedBytes[trailerOffset] ?? 0) |\n ((compressedBytes[trailerOffset + 1] ?? 0) << 8) |\n ((compressedBytes[trailerOffset + 2] ?? 0) << 16) |\n ((compressedBytes[trailerOffset + 3] ?? 0) * 0x1000000)) >>>\n 0;\n\n const expectedIsize =\n ((compressedBytes[trailerOffset + 4] ?? 0) |\n ((compressedBytes[trailerOffset + 5] ?? 0) << 8) |\n ((compressedBytes[trailerOffset + 6] ?? 0) << 16) |\n ((compressedBytes[trailerOffset + 7] ?? 0) * 0x1000000)) >>>\n 0;\n\n const actualCrc = computeCrc32(decompressed);\n if (actualCrc !== expectedCrc) {\n throw new ArchiveKitError(\n 'DECOMPRESSION_FAILED',\n `GZIP CRC-32 checksum mismatch: expected 0x${expectedCrc.toString(16)}, got 0x${actualCrc.toString(16)} (archive corrupted)`\n );\n }\n\n const actualIsize = (decompressed.length >>> 0);\n if (actualIsize !== expectedIsize) {\n throw new ArchiveKitError(\n 'DECOMPRESSION_FAILED',\n `GZIP ISIZE mismatch: expected ${expectedIsize} bytes, got ${actualIsize} bytes (archive truncated or corrupted)`\n );\n }\n}\n\n/**\n * Decompresses GZIP binary data asynchronously.\n *\n * @param data - GZIP data as Uint8Array, ArrayBuffer, Blob, or File.\n * @param options - Decompression options including cancellation signal.\n * @returns Decompressed Uint8Array.\n */\nexport async function gzipDecompress(\n data: BinaryInput,\n options?: GzipDecompressOptions\n): Promise<Uint8Array> {\n if (options?.signal?.aborted) {\n throw new ArchiveKitError('OPERATION_CANCELLED', 'Decompression was aborted');\n }\n\n const bytes = await toUint8Array(data);\n validateGzipHeader(bytes);\n\n return new Promise<Uint8Array>((resolve, reject) => {\n let completed = false;\n\n if (options?.signal) {\n options.signal.addEventListener('abort', () => {\n if (!completed) {\n completed = true;\n reject(new ArchiveKitError('OPERATION_CANCELLED', 'Decompression was aborted'));\n }\n });\n }\n\n gunzip(bytes, (err, result) => {\n if (completed) return;\n completed = true;\n if (err) {\n reject(\n new ArchiveKitError(\n 'DECOMPRESSION_FAILED',\n `GZIP decompression failed (corrupted or truncated archive): ${err.message}`,\n err\n )\n );\n } else {\n try {\n verifyGzipTrailer(bytes, result);\n resolve(result);\n } catch (verifyErr) {\n reject(verifyErr);\n }\n }\n });\n });\n}\n\n/**\n * Synchronous GZIP decompression for small in-memory buffers.\n *\n * @warning Blocks main thread on large buffers.\n */\nexport function gzipDecompressSync(\n data: Uint8Array | ArrayBuffer,\n _options?: GzipDecompressOptions\n): Uint8Array {\n const bytes = toUint8ArraySync(data);\n validateGzipHeader(bytes);\n\n try {\n const result = gunzipSync(bytes);\n verifyGzipTrailer(bytes, result);\n return result;\n } catch (err) {\n if (err instanceof ArchiveKitError) {\n throw err;\n }\n const message = err instanceof Error ? err.message : String(err);\n throw new ArchiveKitError(\n 'DECOMPRESSION_FAILED',\n `GZIP decompression failed (corrupted or truncated archive): ${message}`,\n err\n );\n }\n}\n\n/**\n * Decompresses GZIP data directly into a UTF-8 string asynchronously.\n */\nexport async function gzipDecompressText(\n data: BinaryInput,\n options?: GzipDecompressOptions\n): Promise<string> {\n const decompressed = await gzipDecompress(data, options);\n return decodeUtf8(decompressed);\n}\n\n/**\n * Synchronous GZIP decompression to string for small in-memory data.\n */\nexport function gzipDecompressTextSync(\n data: Uint8Array | ArrayBuffer,\n options?: GzipDecompressOptions\n): string {\n const decompressed = gzipDecompressSync(data, options);\n return decodeUtf8(decompressed);\n}\n\n/**\n * Decompresses GZIP data directly into a browser-ready Blob.\n */\nexport async function gzipDecompressBlob(\n data: BinaryInput,\n options?: GzipDecompressBlobOptions\n): Promise<Blob> {\n const decompressed = await gzipDecompress(data, options);\n return createBlob(decompressed, options?.mimeType ?? 'application/octet-stream');\n}\n"]}