dspx 1.3.6 → 1.4.0

package/README.md

@@ -5,11 +5,11 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](./LICENSE)
 
-> **A high-performance DSP library with native C++ acceleration, Redis state persistence, and comprehensive time-series processing. Built for Node.js backends processing real-time biosignals, audio, and sensor data.**
+> **A high-performance DSP library with native C++ acceleration, state persistence, and comprehensive time-series processing. Built for Node.js backends processing real-time biosignals, audio, and sensor data.**
 
 ** v1.0.0 Release** Fully tested (500+ tests passing), battle-tested architecture, comprehensive documentation. Ready for production workloads.
 
-A modern DSP library built for Node.js backends processing real-time biosignals, audio streams, and sensor data. Features native C++ filters with full state serialization to Redis, enabling seamless processing across service restarts and distributed workers.
+A modern DSP library built for Node.js backends processing real-time biosignals, audio streams, and sensor data. Features native C++ filters with full state serialization (to Redis, S3, or any storage backend), enabling seamless processing across service restarts and distributed workers.
 
 ---
 
@@ -39,7 +39,7 @@ graph TB
         TS_API["TypeScript API<br/>bindings.ts"]
         TS_TYPES["Type Definitions<br/>types.ts"]
         TS_UTILS["Utilities<br/>CircularLogBuffer, TopicRouter"]
-        TS_REDIS["Redis Backend<br/>backends.ts"]
+        TS_PERSIST["Persistence Backends<br/>backends.ts (Redis, S3, etc.)"]
     end
 
     subgraph "N-API Bridge Layer"
@@ -69,12 +69,12 @@ graph TB
     end
 
     subgraph "External Services"
-        REDIS_DB[("Redis<br/>(State Persistence)")]
+        PERSIST_DB[("Storage<br/>(Redis, S3, etc.)")]
     end
 
     %% Connections
     TS_API --> NAPI
-    TS_REDIS --> REDIS_DB
+    TS_PERSIST --> PERSIST_DB
     NAPI --> PIPELINE
     PIPELINE --> ADAPTER_EXAMPLE
     PIPELINE --> ADAPTER_STATELESS
@@ -97,13 +97,13 @@ graph TB
     classDef cppUtils fill:#a8c5e2,stroke:#7a9fbe,color:#000
     classDef external fill:#dc382d,stroke:#a82820,color:#fff
 
-    class TS_API,TS_TYPES,TS_UTILS,TS_REDIS tsLayer
+    class TS_API,TS_TYPES,TS_UTILS,TS_PERSIST tsLayer
     class CORE_MA,CORE_RMS,CORE_MAV,CORE_VAR,CORE_ZSCORE cppCore
     class CORE_ENGINE cppEngine
     class POLICY_MEAN,POLICY_RMS,POLICY_MAV,POLICY_VAR,POLICY_ZSCORE cppPolicy
     class ADAPTER_MA,ADAPTER_RMS,ADAPTER_RECT,ADAPTER_VAR,ADAPTER_ZSCORE cppAdapter
     class CIRCULAR cppUtils
-    class REDIS_DB external
+    class PERSIST_DB external
 ```
 
 ### Key Architectural Principles
@@ -178,7 +178,7 @@ class MovingAverageFilter {
 
 **3. Layered Design**
 
-- **TypeScript Layer**: User-facing API, type safety, Redis integration
+- **TypeScript Layer**: User-facing API, type safety, state persistence integration
 - **N-API Bridge**: Zero-copy data marshaling between JS and C++
 - **C++ Core**: High-performance DSP algorithms with optimized memory management
 
@@ -192,7 +192,7 @@ State serialization uses a **layered delegation pattern** (see section 2.1):
 
 Full state serialization to JSON enables:
 
-- ✅ Redis persistence for distributed processing
+- ✅ State persistence for distributed processing
 - ✅ Process continuity across restarts
 - ✅ State migration between workers
 - ✅ Data integrity validation on deserialization
@@ -210,7 +210,7 @@ This separation enables:
 - ✅ Reuse of core DSP code in other projects
 - ✅ Type-safe TypeScript API with IntelliSense
 - ✅ Zero-copy performance through N-API
-- ✅ Distributed processing with Redis state sharing
+- ✅ Distributed processing with state sharing (Redis, S3, etc.)
 
 **6. Native C++ Backend**
 
@@ -219,7 +219,7 @@ This separation enables:
 - **Optimized Data Structures**: Circular buffers with O(1) operations
 - **Template-Based**: Generic implementation supports int, float, double
 
-**7. Redis State Persistence**
+**7. State Persistence**
 
 The state serialization includes:
 
@@ -303,14 +303,14 @@ const output = await pipeline.process(input, {
 
 ## 📊 Comparison with Alternatives
 
-| Feature            | dspx              | scipy/numpy         | dsp.js     | Web Audio API   |
-| ------------------ | ----------------- | ------------------- | ---------- | --------------- |
-| TypeScript Support | ✅ Native         | ❌ Python-only      | ⚠️ Partial | ✅ Browser-only |
-| Performance        | ⚡⚡⚡ Native C++ | ⚡⚡⚡⚡            | ⚡ Pure JS | ⚡⚡⚡          |
-| State Persistence  | ✅ Redis          | ❌ Manual           | ❌ None    | ❌ None         |
-| Multi-Channel      | ✅ Built-in       | ✅ NumPy arrays     | ⚠️ Limited | ✅ AudioBuffer  |
-| Node.js Backend    | ✅ Designed for   | ❌ Context switch   | ✅ Yes     | ❌ Browser      |
-| Observability      | ✅ Callbacks      | ❌ Print statements | ❌ None    | ⚠️ Limited      |
+| Feature            | dspx                   | scipy/numpy         | dsp.js     | Web Audio API   |
+| ------------------ | ---------------------- | ------------------- | ---------- | --------------- |
+| TypeScript Support | ✅ Native              | ❌ Python-only      | ⚠️ Partial | ✅ Browser-only |
+| Performance        | ⚡⚡⚡ Native C++      | ⚡⚡⚡⚡            | ⚡ Pure JS | ⚡⚡⚡          |
+| State Persistence  | ✅ Yes (Redis/S3/etc.) | ❌ Manual           | ❌ None    | ❌ None         |
+| Multi-Channel      | ✅ Built-in            | ✅ NumPy arrays     | ⚠️ Limited | ✅ AudioBuffer  |
+| Node.js Backend    | ✅ Designed for        | ❌ Context switch   | ✅ Yes     | ❌ Browser      |
+| Observability      | ✅ Callbacks           | ❌ Print statements | ❌ None    | ⚠️ Limited      |
 
 ---
 
@@ -329,7 +329,7 @@ const output = await pipeline.process(input, {
 - Browser-only applications (use Web Audio API)
 - Python-based ML pipelines (use SciPy/NumPy)
 - Hard real-time embedded systems (use bare C/C++)
-- Ultra-low latency (<1ms) requirements (Redis adds ~1-5ms)
+- Ultra-low latency (<1ms) requirements (state persistence adds ~1-5ms)
 
 ---
 
@@ -355,7 +355,7 @@ The DSP pipeline adds ~0.3-0.4ms overhead per operation for:
 - N-API boundary crossings
 - Output buffer allocation
 
-For **maximum FFT performance** (when you don't need multi-stage processing or Redis persistence), use the direct `FftProcessor`:
+For **maximum FFT performance** (when you don't need multi-stage processing or state persistence), use the direct `FftProcessor`:
 
 ```javascript
 // ⚡ FASTER: Direct FFT (no pipeline overhead)
@@ -372,7 +372,7 @@ const result = pipeline.process(signal); // Still faster than pure JS, but ~0.3m
 **When to use each:**
 
 - **FftProcessor**: Single FFT operations, maximum speed, batch processing
-- **Pipeline**: Multi-stage processing (filter→FFT→analysis), Redis state, complex workflows
+- **Pipeline**: Multi-stage processing (filter→FFT→analysis), stateful processing, complex workflows
 
 With recent optimizations (loop unrolling, memcpy, single-channel fast paths), dspx FFT is now **4-14x faster than fft.js** across all sizes when measured correctly. See [FFT_BENCHMARK_FIX.md](docs/FFT_BENCHMARK_FIX.md) for benchmark methodology.
 
@@ -766,7 +766,7 @@ Implements a simple moving average (SMA) filter with two modes:
 - **Batch mode**: O(n) computation, no state between calls
 - **Moving mode**: O(1) per sample with circular buffer and running sum
 - Per-channel state for multi-channel processing
-- Full state serialization to Redis
+- Full state serialization support
 
 **Example:**
 
@@ -948,7 +948,7 @@ Implements an efficient RMS filter with two modes:
 - **Batch mode**: O(n) computation, no state between calls
 - **Moving mode**: O(1) per sample with circular buffer and running sum of squares
 - Per-channel state for multi-channel processing
-- Full state serialization to Redis
+- Full state serialization support
 - Always positive output (magnitude-based)
 
 **Example:**
@@ -999,7 +999,7 @@ Implements an efficient Mean Absolute Value filter with two modes - commonly use
 - **Batch mode**: O(n) computation, no state between calls
 - **Moving mode**: O(1) per sample with circular buffer and running sum of absolute values
 - Per-channel state for multi-channel EMG processing
-- Full state serialization to Redis
+- Full state serialization support
 - Always non-negative output
 - Scale-invariant: MAV(k·x) = k·MAV(x)
 
@@ -1115,7 +1115,7 @@ Implements variance calculation to measure data spread and variability. Supports
 - **Moving mode**: O(1) per-sample computation using circular buffer with running sums
 - Maintains running sum and running sum of squares for efficient calculation
 - Per-channel state for multi-channel processing
-- Full state serialization to Redis including buffer contents and running values
+- Full state serialization support including buffer contents and running values
 - Variance is always non-negative (uses max(0, calculated) to handle floating-point errors)
 
 **Mathematical Note:**

package/binding.gyp

@@ -29,7 +29,8 @@
         "src/native/utils/TimeSeriesBuffer.cc",
         "src/native/adapters/FilterStage.cc",
         "src/native/adapters/FilterBankStage.cc",
-        "src/native/adapters/FftStage.cc"
+        "src/native/adapters/FftStage.cc",
+        "src/native/adapters/TimeAlignmentStage.cc"
       ],
       "include_dirs": [
         "<!@(node -p \"require('node-addon-api').include\")",

package/dist/bindings.d.ts

@@ -1082,6 +1082,80 @@ declare class DspProcessor {
      * });
      */
     KalmanFilter(params?: KalmanFilterParams): this;
+    /**
+     * Resample irregular timestamp data to uniform time grid (production-grade).
+     *
+     * This stage solves the problems of irregular sampling:
+     * - Time-based coordinate system (not index-based)
+     * - Gap detection and configurable handling policies
+     * - Clock drift compensation (regression or PLL)
+     * - Multiple interpolation methods (linear, cubic, sinc)
+     * - Proper extrapolation policies
+     *
+     * **Use Cases:**
+     * - IoT sensors with network jitter
+     * - GPS data with dropped packets
+     * - Medical vitals with irregular sampling
+     * - Audio streams with clock drift
+     * - High-frequency trading data with gaps
+     *
+     * @param params - Time alignment parameters
+     * @param params.targetSampleRate - Target uniform sample rate in Hz (required)
+     * @param params.interpolationMethod - Interpolation method: "linear" (default), "cubic", or "sinc"
+     * @param params.gapPolicy - Gap handling: "interpolate" (default), "zero-fill", "hold", "extrapolate", or "error"
+     * @param params.gapThreshold - Gap detection threshold (multiplier of expected interval, default: 2.0)
+     * @param params.driftCompensation - Clock drift compensation: "none" (default), "regression", or "pll"
+     * @returns this instance for method chaining
+     *
+     * @throws {TypeError} If targetSampleRate is not positive
+     * @throws {Error} If gapPolicy="error" and gap is detected during processing
+     *
+     * @example
+     * // IoT sensor with network jitter → uniform 100Hz grid
+     * const pipeline = createDspPipeline();
+     * pipeline
+     *   .TimeAlignment({
+     *     targetSampleRate: 100,           // 100 Hz output
+     *     interpolationMethod: "linear",   // Fast interpolation
+     *     gapPolicy: "interpolate",        // Fill gaps with interpolation
+     *     gapThreshold: 2.0,               // Detect gaps > 2x expected interval
+     *     driftCompensation: "regression"  // Compensate for clock drift
+     *   })
+     *   .MovingAverage({ windowDuration: 100 })
+     *   .process(irregularSamples, irregularTimestamps, { channels: 1 });
+     *
+     * @example
+     * // GPS tracking with dropped packets → cubic interpolation
+     * const gpsResampler = createDspPipeline();
+     * gpsResampler
+     *   .TimeAlignment({
+     *     targetSampleRate: 10,            // 10 Hz output
+     *     interpolationMethod: "cubic",    // Smooth interpolation
+     *     gapPolicy: "hold",               // Hold last value during gaps
+     *     gapThreshold: 3.0,               // Detect gaps > 300ms
+     *     driftCompensation: "pll"         // Phase-locked loop compensation
+     *   })
+     *   .KalmanFilter({ dimensions: 2, processNoise: 1e-5, measurementNoise: 0.01 });
+     *
+     * @example
+     * // High-frequency trading → error on gap detection
+     * const strictResampler = createDspPipeline();
+     * strictResampler
+     *   .TimeAlignment({
+     *     targetSampleRate: 1000,          // 1kHz output
+     *     interpolationMethod: "sinc",     // Band-limited interpolation
+     *     gapPolicy: "error",              // Fail if gaps detected
+     *     gapThreshold: 1.5,               // Strict gap detection
+     *     driftCompensation: "none"        // Assume perfect clock
+     *   });
+     */
+    TimeAlignment(params: {
+        targetSampleRate: number;
+        interpolationMethod?: "linear" | "cubic" | "sinc";
+        gapPolicy?: "interpolate" | "zero-fill" | "zeroFill" | "hold" | "extrapolate" | "error";
+        gapThreshold?: number;
+        driftCompensation?: "none" | "regression" | "pll";
+    }): this;
     /**
      * Apply leaky integration (accumulation) using IIR filter.
      *

package/dist/bindings.d.ts.map

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

package/dist/bindings.js

@@ -1706,6 +1706,96 @@ class DspProcessor {
         this.stages.push(`kalmanFilter:${dimensions}D`);
         return this;
     }
+    /**
+     * Resample irregular timestamp data to uniform time grid (production-grade).
+     *
+     * This stage solves the problems of irregular sampling:
+     * - Time-based coordinate system (not index-based)
+     * - Gap detection and configurable handling policies
+     * - Clock drift compensation (regression or PLL)
+     * - Multiple interpolation methods (linear, cubic, sinc)
+     * - Proper extrapolation policies
+     *
+     * **Use Cases:**
+     * - IoT sensors with network jitter
+     * - GPS data with dropped packets
+     * - Medical vitals with irregular sampling
+     * - Audio streams with clock drift
+     * - High-frequency trading data with gaps
+     *
+     * @param params - Time alignment parameters
+     * @param params.targetSampleRate - Target uniform sample rate in Hz (required)
+     * @param params.interpolationMethod - Interpolation method: "linear" (default), "cubic", or "sinc"
+     * @param params.gapPolicy - Gap handling: "interpolate" (default), "zero-fill", "hold", "extrapolate", or "error"
+     * @param params.gapThreshold - Gap detection threshold (multiplier of expected interval, default: 2.0)
+     * @param params.driftCompensation - Clock drift compensation: "none" (default), "regression", or "pll"
+     * @returns this instance for method chaining
+     *
+     * @throws {TypeError} If targetSampleRate is not positive
+     * @throws {Error} If gapPolicy="error" and gap is detected during processing
+     *
+     * @example
+     * // IoT sensor with network jitter → uniform 100Hz grid
+     * const pipeline = createDspPipeline();
+     * pipeline
+     *   .TimeAlignment({
+     *     targetSampleRate: 100,           // 100 Hz output
+     *     interpolationMethod: "linear",   // Fast interpolation
+     *     gapPolicy: "interpolate",        // Fill gaps with interpolation
+     *     gapThreshold: 2.0,               // Detect gaps > 2x expected interval
+     *     driftCompensation: "regression"  // Compensate for clock drift
+     *   })
+     *   .MovingAverage({ windowDuration: 100 })
+     *   .process(irregularSamples, irregularTimestamps, { channels: 1 });
+     *
+     * @example
+     * // GPS tracking with dropped packets → cubic interpolation
+     * const gpsResampler = createDspPipeline();
+     * gpsResampler
+     *   .TimeAlignment({
+     *     targetSampleRate: 10,            // 10 Hz output
+     *     interpolationMethod: "cubic",    // Smooth interpolation
+     *     gapPolicy: "hold",               // Hold last value during gaps
+     *     gapThreshold: 3.0,               // Detect gaps > 300ms
+     *     driftCompensation: "pll"         // Phase-locked loop compensation
+     *   })
+     *   .KalmanFilter({ dimensions: 2, processNoise: 1e-5, measurementNoise: 0.01 });
+     *
+     * @example
+     * // High-frequency trading → error on gap detection
+     * const strictResampler = createDspPipeline();
+     * strictResampler
+     *   .TimeAlignment({
+     *     targetSampleRate: 1000,          // 1kHz output
+     *     interpolationMethod: "sinc",     // Band-limited interpolation
+     *     gapPolicy: "error",              // Fail if gaps detected
+     *     gapThreshold: 1.5,               // Strict gap detection
+     *     driftCompensation: "none"        // Assume perfect clock
+     *   });
+     */
+    TimeAlignment(params) {
+        const targetSampleRate = params.targetSampleRate;
+        if (targetSampleRate <= 0) {
+            throw new TypeError("TimeAlignment: targetSampleRate must be positive, got " +
+                targetSampleRate);
+        }
+        const interpolationMethod = params.interpolationMethod ?? "linear";
+        const gapPolicy = params.gapPolicy ?? "interpolate";
+        const gapThreshold = params.gapThreshold ?? 2.0;
+        const driftCompensation = params.driftCompensation ?? "none";
+        if (gapThreshold < 1.0) {
+            throw new TypeError("TimeAlignment: gapThreshold must be >= 1.0, got " + gapThreshold);
+        }
+        this.nativeInstance.addStage("timeAlignment", {
+            targetSampleRate,
+            interpolationMethod,
+            gapPolicy,
+            gapThreshold,
+            driftCompensation,
+        });
+        this.stages.push(`timeAlignment:${targetSampleRate}Hz:${interpolationMethod}:${gapPolicy}`);
+        return this;
+    }
     /**
      * Apply leaky integration (accumulation) using IIR filter.
      *
@@ -2966,6 +3056,10 @@ class DspProcessor {
             // Sample-based mode: process(samples, options)
             // Fix: ensure options is correctly formed even if arg is undefined/null
             options = { channels: 1, ...(timestampsOrOptions || {}) };
+            // Check if TimeAlignment stage requires timestamps
+            if (this.stages.some((stage) => stage.startsWith("timeAlignment:"))) {
+                throw new TypeError("TimeAlignment stage requires timestamps. Call process(samples, timestamps, options) instead.");
+            }
             // Optimization: Pass undefined timestamps, let C++ generate them
         }
         // If using planar input, ensure channels option is set correctly