@affectively/aeon 1.0.0 → 1.2.0

package/dist/compression/index.d.cts

@@ -0,0 +1,189 @@
+import { Operation } from '../core/index.cjs';
+
+/**
+ * Compression Engine (Phase 12)
+ *
+ * Provides compression for delta operations using native CompressionStream API.
+ * Falls back gracefully when native compression is unavailable.
+ */
+interface CompressedBatch {
+    id: string;
+    compressed: Uint8Array;
+    originalSize: number;
+    compressedSize: number;
+    compressionRatio: number;
+    algorithm: 'gzip' | 'deflate' | 'none';
+    timestamp: number;
+}
+interface CompressedChunk {
+    chunkId: string;
+    batchId: string;
+    data: Uint8Array;
+    index: number;
+    total: number;
+    checksum: string;
+}
+interface CompressionStats {
+    totalCompressed: number;
+    totalDecompressed: number;
+    totalOriginalBytes: number;
+    totalCompressedBytes: number;
+    averageCompressionRatio: number;
+    compressionTimeMs: number;
+    decompressionTimeMs: number;
+}
+declare class CompressionEngine {
+    private stats;
+    private preferredAlgorithm;
+    constructor(preferredAlgorithm?: 'gzip' | 'deflate');
+    /**
+     * Check if native compression is available
+     */
+    supportsNativeCompression(): boolean;
+    /**
+     * Compress data
+     */
+    compress(data: Uint8Array | string): Promise<CompressedBatch>;
+    /**
+     * Decompress data
+     */
+    decompress(batch: CompressedBatch): Promise<Uint8Array>;
+    /**
+     * Compress using native CompressionStream
+     */
+    private compressNative;
+    /**
+     * Decompress using native DecompressionStream
+     */
+    private decompressNative;
+    /**
+     * Split compressed batch into chunks for transmission
+     */
+    splitIntoChunks(batch: CompressedBatch, chunkSize?: number): CompressedChunk[];
+    /**
+     * Reassemble chunks into compressed batch
+     */
+    reassembleChunks(chunks: CompressedChunk[]): Uint8Array;
+    /**
+     * Simple checksum for chunk verification
+     */
+    private simpleChecksum;
+    /**
+     * Update average compression ratio
+     */
+    private updateAverageRatio;
+    /**
+     * Get statistics
+     */
+    getStats(): CompressionStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+}
+declare function getCompressionEngine(): CompressionEngine;
+declare function resetCompressionEngine(): void;
+
+/**
+ * Delta Sync Optimizer (Phase 12)
+ *
+ * Implements field-level change detection to reduce payload size.
+ * Computes delta between current and previous operation state.
+ *
+ * Performance Impact:
+ * - Delta sync alone: 70-80% payload reduction
+ * - Combined with compression: 80-90% total reduction
+ */
+
+/**
+ * Delta operation - represents only changed fields
+ */
+interface DeltaOperation {
+    id: string;
+    type: 'full' | 'delta';
+    operationId: string;
+    operationType: Operation['type'];
+    sessionId: string;
+    timestamp: number;
+    changes?: Record<string, unknown>;
+    changeMask?: string[];
+    fullData?: Record<string, unknown>;
+    priority?: 'high' | 'normal' | 'low';
+}
+/**
+ * Batch of delta operations
+ */
+interface DeltaBatch {
+    batchId: string;
+    operations: DeltaOperation[];
+    timestamp: number;
+    totalOriginalSize: number;
+    totalDeltaSize: number;
+    reductionPercent: number;
+}
+/**
+ * Statistics about delta sync performance
+ */
+interface DeltaStats {
+    totalOperations: number;
+    totalFull: number;
+    totalDelta: number;
+    totalOriginalSize: number;
+    totalDeltaSize: number;
+    averageReductionPercent: number;
+    lastSyncTime: number;
+    fullOperationThreshold: number;
+}
+declare class DeltaSyncOptimizer {
+    private operationHistory;
+    private stats;
+    constructor(fullOperationThreshold?: number);
+    /**
+     * Compute delta for single operation
+     */
+    computeDelta(operation: Operation): DeltaOperation;
+    /**
+     * Compute deltas for batch of operations
+     */
+    computeBatchDeltas(operations: Operation[]): DeltaBatch;
+    /**
+     * Decompress delta operation back to full operation
+     */
+    decompressDelta(delta: DeltaOperation): Operation;
+    /**
+     * Update history after successful sync
+     */
+    updateHistory(operations: Operation[]): void;
+    /**
+     * Clear history for specific operations
+     */
+    clearHistory(operationIds: string[]): void;
+    /**
+     * Get current performance statistics
+     */
+    getStats(): DeltaStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Set the full operation threshold
+     */
+    setFullOperationThreshold(bytes: number): void;
+    /**
+     * Get history size for memory monitoring
+     */
+    getHistorySize(): number;
+    /**
+     * Get memory footprint estimate
+     */
+    getMemoryEstimate(): number;
+    /**
+     * Deep equality check for nested objects
+     */
+    private deepEqual;
+}
+declare function getDeltaSyncOptimizer(threshold?: number): DeltaSyncOptimizer;
+declare function resetDeltaSyncOptimizer(): void;
+
+export { type CompressedBatch, type CompressedChunk, CompressionEngine, type CompressionStats, type DeltaBatch, type DeltaOperation, type DeltaStats, DeltaSyncOptimizer, getCompressionEngine, getDeltaSyncOptimizer, resetCompressionEngine, resetDeltaSyncOptimizer };

package/dist/compression/index.d.ts

@@ -0,0 +1,189 @@
+import { Operation } from '../core/index.js';
+
+/**
+ * Compression Engine (Phase 12)
+ *
+ * Provides compression for delta operations using native CompressionStream API.
+ * Falls back gracefully when native compression is unavailable.
+ */
+interface CompressedBatch {
+    id: string;
+    compressed: Uint8Array;
+    originalSize: number;
+    compressedSize: number;
+    compressionRatio: number;
+    algorithm: 'gzip' | 'deflate' | 'none';
+    timestamp: number;
+}
+interface CompressedChunk {
+    chunkId: string;
+    batchId: string;
+    data: Uint8Array;
+    index: number;
+    total: number;
+    checksum: string;
+}
+interface CompressionStats {
+    totalCompressed: number;
+    totalDecompressed: number;
+    totalOriginalBytes: number;
+    totalCompressedBytes: number;
+    averageCompressionRatio: number;
+    compressionTimeMs: number;
+    decompressionTimeMs: number;
+}
+declare class CompressionEngine {
+    private stats;
+    private preferredAlgorithm;
+    constructor(preferredAlgorithm?: 'gzip' | 'deflate');
+    /**
+     * Check if native compression is available
+     */
+    supportsNativeCompression(): boolean;
+    /**
+     * Compress data
+     */
+    compress(data: Uint8Array | string): Promise<CompressedBatch>;
+    /**
+     * Decompress data
+     */
+    decompress(batch: CompressedBatch): Promise<Uint8Array>;
+    /**
+     * Compress using native CompressionStream
+     */
+    private compressNative;
+    /**
+     * Decompress using native DecompressionStream
+     */
+    private decompressNative;
+    /**
+     * Split compressed batch into chunks for transmission
+     */
+    splitIntoChunks(batch: CompressedBatch, chunkSize?: number): CompressedChunk[];
+    /**
+     * Reassemble chunks into compressed batch
+     */
+    reassembleChunks(chunks: CompressedChunk[]): Uint8Array;
+    /**
+     * Simple checksum for chunk verification
+     */
+    private simpleChecksum;
+    /**
+     * Update average compression ratio
+     */
+    private updateAverageRatio;
+    /**
+     * Get statistics
+     */
+    getStats(): CompressionStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+}
+declare function getCompressionEngine(): CompressionEngine;
+declare function resetCompressionEngine(): void;
+
+/**
+ * Delta Sync Optimizer (Phase 12)
+ *
+ * Implements field-level change detection to reduce payload size.
+ * Computes delta between current and previous operation state.
+ *
+ * Performance Impact:
+ * - Delta sync alone: 70-80% payload reduction
+ * - Combined with compression: 80-90% total reduction
+ */
+
+/**
+ * Delta operation - represents only changed fields
+ */
+interface DeltaOperation {
+    id: string;
+    type: 'full' | 'delta';
+    operationId: string;
+    operationType: Operation['type'];
+    sessionId: string;
+    timestamp: number;
+    changes?: Record<string, unknown>;
+    changeMask?: string[];
+    fullData?: Record<string, unknown>;
+    priority?: 'high' | 'normal' | 'low';
+}
+/**
+ * Batch of delta operations
+ */
+interface DeltaBatch {
+    batchId: string;
+    operations: DeltaOperation[];
+    timestamp: number;
+    totalOriginalSize: number;
+    totalDeltaSize: number;
+    reductionPercent: number;
+}
+/**
+ * Statistics about delta sync performance
+ */
+interface DeltaStats {
+    totalOperations: number;
+    totalFull: number;
+    totalDelta: number;
+    totalOriginalSize: number;
+    totalDeltaSize: number;
+    averageReductionPercent: number;
+    lastSyncTime: number;
+    fullOperationThreshold: number;
+}
+declare class DeltaSyncOptimizer {
+    private operationHistory;
+    private stats;
+    constructor(fullOperationThreshold?: number);
+    /**
+     * Compute delta for single operation
+     */
+    computeDelta(operation: Operation): DeltaOperation;
+    /**
+     * Compute deltas for batch of operations
+     */
+    computeBatchDeltas(operations: Operation[]): DeltaBatch;
+    /**
+     * Decompress delta operation back to full operation
+     */
+    decompressDelta(delta: DeltaOperation): Operation;
+    /**
+     * Update history after successful sync
+     */
+    updateHistory(operations: Operation[]): void;
+    /**
+     * Clear history for specific operations
+     */
+    clearHistory(operationIds: string[]): void;
+    /**
+     * Get current performance statistics
+     */
+    getStats(): DeltaStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Set the full operation threshold
+     */
+    setFullOperationThreshold(bytes: number): void;
+    /**
+     * Get history size for memory monitoring
+     */
+    getHistorySize(): number;
+    /**
+     * Get memory footprint estimate
+     */
+    getMemoryEstimate(): number;
+    /**
+     * Deep equality check for nested objects
+     */
+    private deepEqual;
+}
+declare function getDeltaSyncOptimizer(threshold?: number): DeltaSyncOptimizer;
+declare function resetDeltaSyncOptimizer(): void;
+
+export { type CompressedBatch, type CompressedChunk, CompressionEngine, type CompressionStats, type DeltaBatch, type DeltaOperation, type DeltaStats, DeltaSyncOptimizer, getCompressionEngine, getDeltaSyncOptimizer, resetCompressionEngine, resetDeltaSyncOptimizer };