neozipkit 0.7.2 → 1.0.2

package/dist/core/ZstdManager.js

@@ -1,144 +0,0 @@
-"use strict";
-/**
- * ZstdManager - Global Zstd Codec Manager
- *
- * This manager ensures safe usage of the Zstd WASM module across multiple instances.
- *
- * ## Why This Is Necessary
- *
- * The `@oneidentity/zstd-js` library uses a shared WASM module internally.
- * While `ZstdInit()` returns different object references, they all share the same
- * `ZstdSimple` implementation and WASM memory/heap.
- *
- * This means concurrent or improperly managed sequential operations can cause
- * memory corruption because they're all operating on the same underlying WASM state.
- *
- * ## How It Works
- *
- * 1. Single initialization: WASM module is initialized once globally
- * 2. Operation queuing: All compress/decompress operations are queued
- * 3. Sequential execution: JavaScript's single-threaded nature ensures safe execution
- * 4. Automatic initialization: Lazy initialization on first use
- *
- * ## Usage
- *
- * ```typescript
- * import { ZstdManager } from './ZstdManager';
- *
- * // Compress
- * const compressed = await ZstdManager.compress(data, level);
- *
- * // Decompress
- * const decompressed = await ZstdManager.decompress(compressedData);
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZstdManager = void 0;
-const zstd_js_1 = require("@oneidentity/zstd-js");
-class ZstdCodecManager {
-    constructor() {
-        this.codec = null;
-        this.initPromise = null;
-        this.operationQueue = Promise.resolve();
-    }
-    /**
-     * Get the singleton instance of ZstdCodecManager
-     */
-    static getInstance() {
-        if (!ZstdCodecManager.instance) {
-            ZstdCodecManager.instance = new ZstdCodecManager();
-        }
-        return ZstdCodecManager.instance;
-    }
-    /**
-     * Ensure the Zstd codec is initialized
-     * This is called automatically before any compress/decompress operation
-     */
-    async ensureInitialized() {
-        if (this.codec) {
-            return;
-        }
-        if (this.initPromise) {
-            return this.initPromise;
-        }
-        this.initPromise = (async () => {
-            this.codec = await (0, zstd_js_1.ZstdInit)();
-        })();
-        return this.initPromise;
-    }
-    /**
-     * Queue an operation to ensure sequential execution
-     * This prevents concurrent operations from interfering with each other
-     */
-    async queueOperation(operation) {
-        // Chain this operation after the previous one
-        const promise = this.operationQueue.then(operation, operation);
-        // Update the queue to point to this operation
-        this.operationQueue = promise.catch(() => { }); // Catch to prevent unhandled rejections in queue
-        return promise;
-    }
-    /**
-     * Compress data using Zstd
-     * @param data - Data to compress (Uint8Array)
-     * @param level - Compression level (1-22, default 6)
-     * @returns Compressed data as Uint8Array
-     */
-    async compress(data, level = 6) {
-        return this.queueOperation(async () => {
-            await this.ensureInitialized();
-            if (!this.codec) {
-                throw new Error('Zstd codec not initialized');
-            }
-            return this.codec.ZstdSimple.compress(data, level);
-        });
-    }
-    /**
-     * Decompress data using Zstd
-     * @param data - Compressed data (Uint8Array or Buffer)
-     * @returns Decompressed data as Uint8Array
-     */
-    async decompress(data) {
-        return this.queueOperation(async () => {
-            await this.ensureInitialized();
-            if (!this.codec) {
-                throw new Error('Zstd codec not initialized');
-            }
-            // Convert Buffer to Uint8Array if needed
-            const inputData = data instanceof Buffer
-                ? new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
-                : data;
-            return this.codec.ZstdSimple.decompress(inputData);
-        });
-    }
-    /**
-     * Reset the manager (for testing purposes)
-     * @internal
-     */
-    static reset() {
-        ZstdCodecManager.instance = null;
-    }
-}
-ZstdCodecManager.instance = null;
-/**
- * Global Zstd Manager
- * Use this for all Zstd compression/decompression operations
- */
-exports.ZstdManager = {
-    /**
-     * Compress data using Zstd
-     * Operations are automatically queued to prevent interference
-     */
-    compress: (data, level) => ZstdCodecManager.getInstance().compress(data, level),
-    /**
-     * Decompress data using Zstd
-     * Operations are automatically queued to prevent interference
-     */
-    decompress: (data) => ZstdCodecManager.getInstance().decompress(data),
-    /**
-     * Reset the manager (for testing)
-     * @internal
-     */
-    reset: () => ZstdCodecManager.reset(),
-};
-exports.default = exports.ZstdManager;
-//# sourceMappingURL=ZstdManager.js.map

package/dist/core/ZstdManager.js.map

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

package/src/core/ZstdManager.ts

@@ -1,165 +0,0 @@
-/**
- * ZstdManager - Global Zstd Codec Manager
- * 
- * This manager ensures safe usage of the Zstd WASM module across multiple instances.
- * 
- * ## Why This Is Necessary
- * 
- * The `@oneidentity/zstd-js` library uses a shared WASM module internally.
- * While `ZstdInit()` returns different object references, they all share the same
- * `ZstdSimple` implementation and WASM memory/heap.
- * 
- * This means concurrent or improperly managed sequential operations can cause
- * memory corruption because they're all operating on the same underlying WASM state.
- * 
- * ## How It Works
- * 
- * 1. Single initialization: WASM module is initialized once globally
- * 2. Operation queuing: All compress/decompress operations are queued
- * 3. Sequential execution: JavaScript's single-threaded nature ensures safe execution
- * 4. Automatic initialization: Lazy initialization on first use
- * 
- * ## Usage
- * 
- * ```typescript
- * import { ZstdManager } from './ZstdManager';
- * 
- * // Compress
- * const compressed = await ZstdManager.compress(data, level);
- * 
- * // Decompress
- * const decompressed = await ZstdManager.decompress(compressedData);
- * ```
- */
-
-import { ZstdInit, ZstdSimple } from '@oneidentity/zstd-js';
-
-class ZstdCodecManager {
-  private static instance: ZstdCodecManager | null = null;
-  private codec: { ZstdSimple: typeof ZstdSimple } | null = null;
-  private initPromise: Promise<void> | null = null;
-  private operationQueue: Promise<any> = Promise.resolve();
-
-  private constructor() {}
-
-  /**
-   * Get the singleton instance of ZstdCodecManager
-   */
-  public static getInstance(): ZstdCodecManager {
-    if (!ZstdCodecManager.instance) {
-      ZstdCodecManager.instance = new ZstdCodecManager();
-    }
-    return ZstdCodecManager.instance;
-  }
-
-  /**
-   * Ensure the Zstd codec is initialized
-   * This is called automatically before any compress/decompress operation
-   */
-  private async ensureInitialized(): Promise<void> {
-    if (this.codec) {
-      return;
-    }
-
-    if (this.initPromise) {
-      return this.initPromise;
-    }
-
-    this.initPromise = (async () => {
-      this.codec = await ZstdInit();
-    })();
-
-    return this.initPromise;
-  }
-
-  /**
-   * Queue an operation to ensure sequential execution
-   * This prevents concurrent operations from interfering with each other
-   */
-  private async queueOperation<T>(operation: () => Promise<T> | T): Promise<T> {
-    // Chain this operation after the previous one
-    const promise = this.operationQueue.then(operation, operation);
-    
-    // Update the queue to point to this operation
-    this.operationQueue = promise.catch(() => {}); // Catch to prevent unhandled rejections in queue
-    
-    return promise;
-  }
-
-  /**
-   * Compress data using Zstd
-   * @param data - Data to compress (Uint8Array)
-   * @param level - Compression level (1-22, default 6)
-   * @returns Compressed data as Uint8Array
-   */
-  public async compress(data: Uint8Array, level: number = 6): Promise<Uint8Array> {
-    return this.queueOperation(async () => {
-      await this.ensureInitialized();
-      
-      if (!this.codec) {
-        throw new Error('Zstd codec not initialized');
-      }
-
-      return this.codec.ZstdSimple.compress(data, level);
-    });
-  }
-
-  /**
-   * Decompress data using Zstd
-   * @param data - Compressed data (Uint8Array or Buffer)
-   * @returns Decompressed data as Uint8Array
-   */
-  public async decompress(data: Uint8Array | Buffer): Promise<Uint8Array> {
-    return this.queueOperation(async () => {
-      await this.ensureInitialized();
-      
-      if (!this.codec) {
-        throw new Error('Zstd codec not initialized');
-      }
-
-      // Convert Buffer to Uint8Array if needed
-      const inputData = data instanceof Buffer 
-        ? new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
-        : data;
-
-      return this.codec.ZstdSimple.decompress(inputData);
-    });
-  }
-
-  /**
-   * Reset the manager (for testing purposes)
-   * @internal
-   */
-  public static reset(): void {
-    ZstdCodecManager.instance = null;
-  }
-}
-
-/**
- * Global Zstd Manager
- * Use this for all Zstd compression/decompression operations
- */
-export const ZstdManager = {
-  /**
-   * Compress data using Zstd
-   * Operations are automatically queued to prevent interference
-   */
-  compress: (data: Uint8Array, level?: number) => 
-    ZstdCodecManager.getInstance().compress(data, level),
-
-  /**
-   * Decompress data using Zstd
-   * Operations are automatically queued to prevent interference
-   */
-  decompress: (data: Uint8Array | Buffer) => 
-    ZstdCodecManager.getInstance().decompress(data),
-
-  /**
-   * Reset the manager (for testing)
-   * @internal
-   */
-  reset: () => ZstdCodecManager.reset(),
-};
-
-export default ZstdManager;
-