@push.rocks/smartarchive 5.2.3 → 5.3.0

package/ts_shared/errors.ts

@@ -45,6 +45,37 @@ export class StreamError extends SmartArchiveError {
   }
 }
 
+/**
+ * Stable ZIP error codes for bounded selective extraction
+ */
+export const ZIP_ERROR_CODES = {
+  INVALID_LIMIT: 'ZIP_INVALID_LIMIT',
+  INVALID_ARCHIVE: 'ZIP_INVALID_ARCHIVE',
+  UNSUPPORTED_FEATURE: 'ZIP_UNSUPPORTED_FEATURE',
+  ARCHIVE_SIZE_LIMIT: 'ZIP_ARCHIVE_SIZE_LIMIT',
+  ENTRY_COUNT_LIMIT: 'ZIP_ENTRY_COUNT_LIMIT',
+  SELECTED_ENTRY_COUNT_LIMIT: 'ZIP_SELECTED_ENTRY_COUNT_LIMIT',
+  COMPRESSED_SIZE_LIMIT: 'ZIP_COMPRESSED_SIZE_LIMIT',
+  UNCOMPRESSED_SIZE_LIMIT: 'ZIP_UNCOMPRESSED_SIZE_LIMIT',
+  TOTAL_UNCOMPRESSED_SIZE_LIMIT: 'ZIP_TOTAL_UNCOMPRESSED_SIZE_LIMIT',
+  DUPLICATE_SELECTED_PATH: 'ZIP_DUPLICATE_SELECTED_PATH',
+  COMPRESSED_SIZE_MISMATCH: 'ZIP_COMPRESSED_SIZE_MISMATCH',
+  UNCOMPRESSED_SIZE_MISMATCH: 'ZIP_UNCOMPRESSED_SIZE_MISMATCH',
+  CRC_MISMATCH: 'ZIP_CRC_MISMATCH',
+} as const;
+
+export type TZipErrorCode = typeof ZIP_ERROR_CODES[keyof typeof ZIP_ERROR_CODES];
+
+/**
+ * ZIP-specific extraction error
+ */
+export class ZipError extends SmartArchiveError {
+  constructor(message: string, code: TZipErrorCode) {
+    super(message, code);
+    this.name = 'ZipError';
+  }
+}
+
 /**
  * BZIP2 error codes for programmatic error handling
  */

package/ts_shared/index.ts

@@ -7,7 +7,7 @@ export * from './interfaces.js';
 export * from './errors.js';
 
 // Tool classes
-export { ZipTools, ZipDecompressionTransform } from './classes.ziptools.js';
+export { ZipTools } from './classes.ziptools.js';
 export { GzipTools } from './classes.gziptools.js';
 export { TarTools } from './classes.tartools.js';
 export { Bzip2Tools } from './classes.bzip2tools.js';

package/ts_shared/interfaces.ts

@@ -82,6 +82,44 @@ export interface IArchiveEntryInfo {
   mode?: number;
 }
 
+/**
+ * ZIP entry metadata available before selective decompression
+ */
+export interface IZipEntryInfo extends IArchiveEntryInfo {
+  /** Compressed size in bytes */
+  compressedSize: number;
+  /** ZIP compression method from the central directory */
+  compressionMethod: number;
+}
+
+/**
+ * Required limits for security-sensitive selective ZIP extraction
+ */
+export interface ISelectiveZipExtractionOptions {
+  /** Select entries using metadata parsed before decompression */
+  filter: (entry: IZipEntryInfo) => boolean;
+  /** Maximum bytes accepted for the complete ZIP archive */
+  maxArchiveBytes: number;
+  /** Maximum number of entries in the complete ZIP archive */
+  maxEntries: number;
+  /** Maximum number of selected entries */
+  maxSelectedEntries: number;
+  /** Maximum compressed bytes for each selected entry */
+  maxCompressedEntryBytes: number;
+  /** Maximum uncompressed bytes for each selected entry */
+  maxUncompressedEntryBytes: number;
+  /** Maximum total uncompressed bytes across selected entries */
+  maxTotalUncompressedBytes: number;
+}
+
+/**
+ * One entry returned by selective ZIP extraction
+ */
+export interface IExtractedZipEntry {
+  path: string;
+  content: Uint8Array;
+}
+
 /**
  * Result of archive analysis
  */

package/ts_shared/plugins.ziptools.ts

@@ -0,0 +1,4 @@
+import * as fflate from 'fflate';
+import * as pako from 'pako';
+
+export { fflate, pako };

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartarchive',
-  version: '5.2.3',
+  version: '5.3.0',
   description: 'A library for working with archive files, providing utilities for compressing and decompressing data.'
 }

package/ts_web/zip.ts

@@ -0,0 +1,7 @@
+export { ZipTools } from '../ts_shared/classes.ziptools.js';
+export { ZIP_ERROR_CODES, ZipError, type TZipErrorCode } from '../ts_shared/errors.js';
+export type {
+  IExtractedZipEntry,
+  ISelectiveZipExtractionOptions,
+  IZipEntryInfo,
+} from '../ts_shared/interfaces.js';