bytekit 1.0.0 → 1.0.2

package/dist/utils/helpers/PollingHelper.d.ts

@@ -12,6 +12,14 @@ export interface PollingOptions<T = unknown> {
     onAttempt?: (attempt: number, result?: T, error?: Error) => void;
     onSuccess?: (result: T, attempts: number) => void;
     onError?: (error: Error, attempts: number) => void;
+    /** Add random jitter to intervals (true = 10%, number = custom percentage 0-100) */
+    jitter?: boolean | number;
+    /** Timeout for each individual attempt in milliseconds */
+    attemptTimeout?: number;
+    /** Whether to retry on error (default: true) */
+    retryOnError?: boolean;
+    /** Base for exponential backoff (default: 2) */
+    exponentialBase?: number;
 }
 export interface PollingResult<T = unknown> {
     success: boolean;
@@ -19,6 +27,12 @@ export interface PollingResult<T = unknown> {
     error?: Error;
     attempts: number;
     duration: number;
+    /** Performance metrics for successful attempts */
+    metrics?: {
+        minResponseTime: number;
+        maxResponseTime: number;
+        avgResponseTime: number;
+    };
 }
 /**
  * Polling helper for repeated operations with backoff
@@ -44,6 +58,22 @@ export declare class PollingHelper<T = unknown> {
      * Delay helper
      */
     private delay;
+    /**
+     * Validate polling options
+     */
+    private validateOptions;
+    /**
+     * Apply jitter to interval
+     */
+    private applyJitter;
+    /**
+     * Execute promise with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Calculate performance metrics
+     */
+    private calculateMetrics;
     /**
      * Poll until condition is met
      */

package/dist/utils/helpers/PollingHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PollingHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/PollingHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACjE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,eAAe,CAAgC;gBAE3C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM;IAejE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA4DxC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAKjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;WACU,IAAI,CAAC,CAAC,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAK5B;;OAEG;WACU,eAAe,CAAC,CAAC,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAS5B;;OAEG;WACU,qBAAqB,CAAC,CAAC,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAO/B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACpC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,CAAC,CAAC,CAElB"}
+{"version":3,"file":"PollingHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/PollingHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACjE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE;QACN,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KAC3B,CAAC;CACL;AAED;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,OAAO,CAAoF;IACnG,OAAO,CAAC,eAAe,CAAgC;gBAE3C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM;IAoBjE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAkGxC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAKjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;YACW,kBAAkB;IAehC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;WACU,IAAI,CAAC,CAAC,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAK5B;;OAEG;WACU,eAAe,CAAC,CAAC,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAS5B;;OAEG;WACU,qBAAqB,CAAC,CAAC,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAO/B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACpC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC5B,aAAa,CAAC,CAAC,CAAC,CAElB"}

package/dist/utils/helpers/PollingHelper.js

@@ -6,10 +6,25 @@
  * Polling helper for repeated operations with backoff
  */
 export class PollingHelper {
-    fn;
-    options;
-    abortController = null;
     constructor(fn, options = {}) {
+        Object.defineProperty(this, "fn", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "abortController", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
         this.fn = fn;
         this.options = {
             interval: options.interval ?? 1000,
@@ -21,7 +36,12 @@ export class PollingHelper {
             onAttempt: options.onAttempt ?? (() => { }),
             onSuccess: options.onSuccess ?? (() => { }),
             onError: options.onError ?? (() => { }),
+            jitter: options.jitter ?? false,
+            attemptTimeout: options.attemptTimeout,
+            retryOnError: options.retryOnError ?? true,
+            exponentialBase: options.exponentialBase ?? 2,
         };
+        this.validateOptions();
     }
     /**
      * Start polling
@@ -32,7 +52,17 @@ export class PollingHelper {
         let currentInterval = this.options.interval;
         let lastError;
         let lastResult;
+        const responseTimes = [];
         while (attempt < this.options.maxAttempts) {
+            // Check if aborted
+            if (this.abortController?.signal.aborted) {
+                return {
+                    success: false,
+                    error: new Error("Polling aborted"),
+                    attempts: attempt,
+                    duration: Date.now() - startTime,
+                };
+            }
             const elapsed = Date.now() - startTime;
             if (elapsed > this.options.maxDuration) {
                 return {
@@ -44,7 +74,13 @@ export class PollingHelper {
             }
             attempt++;
             try {
-                lastResult = await this.fn();
+                const attemptStartTime = Date.now();
+                // Execute with optional timeout
+                lastResult = this.options.attemptTimeout
+                    ? await this.executeWithTimeout(this.fn(), this.options.attemptTimeout)
+                    : await this.fn();
+                const responseTime = Date.now() - attemptStartTime;
+                responseTimes.push(responseTime);
                 this.options.onAttempt(attempt, lastResult);
                 if (this.options.stopCondition(lastResult)) {
                     this.options.onSuccess(lastResult, attempt);
@@ -53,6 +89,7 @@ export class PollingHelper {
                         result: lastResult,
                         attempts: attempt,
                         duration: Date.now() - startTime,
+                        metrics: this.calculateMetrics(responseTimes),
                     };
                 }
             }
@@ -60,9 +97,21 @@ export class PollingHelper {
                 lastError =
                     error instanceof Error ? error : new Error(String(error));
                 this.options.onAttempt(attempt, undefined, lastError);
+                // If retryOnError is false, stop immediately
+                if (!this.options.retryOnError) {
+                    this.options.onError(lastError, attempt);
+                    return {
+                        success: false,
+                        error: lastError,
+                        attempts: attempt,
+                        duration: Date.now() - startTime,
+                        metrics: this.calculateMetrics(responseTimes),
+                    };
+                }
             }
             if (attempt < this.options.maxAttempts) {
-                await this.delay(currentInterval);
+                const delayTime = this.applyJitter(currentInterval);
+                await this.delay(delayTime);
                 currentInterval = Math.min(currentInterval * this.options.backoffMultiplier, this.options.maxBackoffInterval);
             }
         }
@@ -72,6 +121,7 @@ export class PollingHelper {
             error: lastError || new Error("Max attempts exceeded"),
             attempts: attempt,
             duration: Date.now() - startTime,
+            metrics: this.calculateMetrics(responseTimes),
         };
     }
     /**
@@ -93,6 +143,74 @@ export class PollingHelper {
     delay(ms) {
         return new Promise((resolve) => setTimeout(resolve, ms));
     }
+    /**
+     * Validate polling options
+     */
+    validateOptions() {
+        if (this.options.interval <= 0) {
+            throw new Error("interval must be greater than 0");
+        }
+        if (this.options.maxAttempts <= 0) {
+            throw new Error("maxAttempts must be greater than 0");
+        }
+        if (this.options.maxDuration <= 0) {
+            throw new Error("maxDuration must be greater than 0");
+        }
+        if (this.options.backoffMultiplier < 1) {
+            throw new Error("backoffMultiplier must be >= 1");
+        }
+        if (this.options.maxBackoffInterval < this.options.interval) {
+            throw new Error("maxBackoffInterval must be >= interval");
+        }
+        if (typeof this.options.jitter === "number") {
+            if (this.options.jitter < 0 || this.options.jitter > 100) {
+                throw new Error("jitter percentage must be between 0 and 100");
+            }
+        }
+        if (this.options.attemptTimeout !== undefined &&
+            this.options.attemptTimeout <= 0) {
+            throw new Error("attemptTimeout must be greater than 0");
+        }
+        if (this.options.exponentialBase < 1) {
+            throw new Error("exponentialBase must be >= 1");
+        }
+    }
+    /**
+     * Apply jitter to interval
+     */
+    applyJitter(interval) {
+        if (!this.options.jitter)
+            return interval;
+        const jitterPercent = typeof this.options.jitter === "number" ? this.options.jitter : 10;
+        const jitterAmount = interval * (jitterPercent / 100);
+        // Add random jitter: -jitterAmount to +jitterAmount
+        return interval + (Math.random() * jitterAmount * 2 - jitterAmount);
+    }
+    /**
+     * Execute promise with timeout
+     */
+    async executeWithTimeout(promise, timeout) {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error("Attempt timeout exceeded")), timeout)),
+        ]);
+    }
+    /**
+     * Calculate performance metrics
+     */
+    calculateMetrics(responseTimes) {
+        if (responseTimes.length === 0)
+            return undefined;
+        const min = Math.min(...responseTimes);
+        const max = Math.max(...responseTimes);
+        const avg = responseTimes.reduce((sum, time) => sum + time, 0) /
+            responseTimes.length;
+        return {
+            minResponseTime: min,
+            maxResponseTime: max,
+            avgResponseTime: Math.round(avg * 100) / 100, // Round to 2 decimals
+        };
+    }
     /**
      * Poll until condition is met
      */

package/dist/utils/helpers/PollingHelper.js.map

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

package/dist/utils/helpers/Signal.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Signal-based reactive state management
+ * Provides fine-grained reactivity without full component re-renders
+ * Similar to Preact Signals
+ */
+/**
+ * Core Signal class
+ * Holds a reactive value that notifies subscribers on changes
+ */
+export declare class Signal<T> {
+    protected _value: T;
+    protected subscribers: Set<() => void>;
+    constructor(initialValue: T);
+    /**
+     * Get the current value
+     * Automatically subscribes the current computation if any
+     */
+    get value(): T;
+    /**
+     * Set a new value
+     * Notifies all subscribers if the value changed
+     */
+    set value(newValue: T);
+    /**
+     * Get value without subscribing
+     */
+    peek(): T;
+    /**
+     * Subscribe to changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: () => void): () => void;
+    /**
+     * Notify all subscribers
+     */
+    protected notify(): void;
+    /**
+     * Get number of subscribers (for debugging)
+     */
+    get subscriberCount(): number;
+}
+/**
+ * Computed signal (derived state)
+ * Automatically updates when dependencies change
+ */
+export declare class Computed<T> extends Signal<T> {
+    private compute;
+    private dirty;
+    private dependencies;
+    constructor(compute: () => T);
+    /**
+     * Get computed value
+     * Re-computes if dirty, otherwise returns cached value
+     */
+    get value(): T;
+    /**
+     * Computed signals are read-only
+     */
+    set value(_: T);
+    /**
+     * Recompute the value
+     */
+    private recompute;
+    /**
+     * Force recomputation
+     */
+    refresh(): void;
+}
+/**
+ * Effect - runs side effects when dependencies change
+ * @param callback Effect callback, can return cleanup function
+ * @returns Cleanup function
+ */
+export declare function effect(callback: () => void | (() => void)): () => void;
+/**
+ * Batch multiple signal updates
+ * Defers notifications until batch completes
+ */
+export declare function batch(callback: () => void): void;
+/**
+ * Create a signal
+ */
+export declare function signal<T>(initialValue: T): Signal<T>;
+/**
+ * Create a computed signal
+ */
+export declare function computed<T>(compute: () => T): Computed<T>;
+/**
+ * Untracked - access signals without subscribing
+ */
+export declare function untracked<T>(callback: () => T): T;
+//# sourceMappingURL=Signal.d.ts.map

package/dist/utils/helpers/Signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/Signal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;GAGG;AACH,qBAAa,MAAM,CAAC,CAAC;IACjB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACpB,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAa;gBAEvC,YAAY,EAAE,CAAC;IAI3B;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,CAMb;IAED;;;OAGG;IACH,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,EAKpB;IAED;;OAEG;IACH,IAAI,IAAI,CAAC;IAIT;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C;;OAEG;IACH,SAAS,CAAC,MAAM,IAAI,IAAI;IAUxB;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;CACJ;AAED;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAA8B;gBAEtC,OAAO,EAAE,MAAM,CAAC;IAK5B;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,CAWb;IAED;;OAEG;IACH,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAEb;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIlB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAClB,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GACpC,MAAM,IAAI,CAiCZ;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAahD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAQjD"}

package/dist/utils/helpers/Signal.js

@@ -0,0 +1,243 @@
+/**
+ * Signal-based reactive state management
+ * Provides fine-grained reactivity without full component re-renders
+ * Similar to Preact Signals
+ */
+// Global context for dependency tracking
+let currentComputation = null;
+let batchDepth = 0;
+const batchedUpdates = new Set();
+/**
+ * Core Signal class
+ * Holds a reactive value that notifies subscribers on changes
+ */
+export class Signal {
+    constructor(initialValue) {
+        Object.defineProperty(this, "_value", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "subscribers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        this._value = initialValue;
+    }
+    /**
+     * Get the current value
+     * Automatically subscribes the current computation if any
+     */
+    get value() {
+        // Auto-subscribe if there's an active computation
+        if (currentComputation) {
+            this.subscribers.add(currentComputation);
+        }
+        return this._value;
+    }
+    /**
+     * Set a new value
+     * Notifies all subscribers if the value changed
+     */
+    set value(newValue) {
+        if (!Object.is(this._value, newValue)) {
+            this._value = newValue;
+            this.notify();
+        }
+    }
+    /**
+     * Get value without subscribing
+     */
+    peek() {
+        return this._value;
+    }
+    /**
+     * Subscribe to changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback) {
+        this.subscribers.add(callback);
+        return () => {
+            this.subscribers.delete(callback);
+        };
+    }
+    /**
+     * Notify all subscribers
+     */
+    notify() {
+        if (batchDepth > 0) {
+            // Defer notifications during batch
+            this.subscribers.forEach((sub) => batchedUpdates.add(sub));
+        }
+        else {
+            // Immediate notification
+            this.subscribers.forEach((sub) => sub());
+        }
+    }
+    /**
+     * Get number of subscribers (for debugging)
+     */
+    get subscriberCount() {
+        return this.subscribers.size;
+    }
+}
+/**
+ * Computed signal (derived state)
+ * Automatically updates when dependencies change
+ */
+export class Computed extends Signal {
+    constructor(compute) {
+        super(undefined);
+        Object.defineProperty(this, "compute", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "dirty", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        Object.defineProperty(this, "dependencies", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        this.compute = compute;
+    }
+    /**
+     * Get computed value
+     * Re-computes if dirty, otherwise returns cached value
+     */
+    get value() {
+        if (this.dirty) {
+            this.recompute();
+        }
+        // Subscribe caller to this computed
+        if (currentComputation) {
+            this.subscribers.add(currentComputation);
+        }
+        return this._value;
+    }
+    /**
+     * Computed signals are read-only
+     */
+    set value(_) {
+        throw new Error("Cannot set value of computed signal");
+    }
+    /**
+     * Recompute the value
+     */
+    recompute() {
+        // Clear old dependencies
+        this.dependencies.clear();
+        // Track new dependencies
+        const prevComputation = currentComputation;
+        currentComputation = () => {
+            this.dirty = true;
+            this.notify();
+        };
+        // Store cleanup for dependencies
+        this.dependencies.add(currentComputation);
+        try {
+            this._value = this.compute();
+            this.dirty = false;
+        }
+        finally {
+            currentComputation = prevComputation;
+        }
+    }
+    /**
+     * Force recomputation
+     */
+    refresh() {
+        this.dirty = true;
+        this.recompute();
+    }
+}
+/**
+ * Effect - runs side effects when dependencies change
+ * @param callback Effect callback, can return cleanup function
+ * @returns Cleanup function
+ */
+export function effect(callback) {
+    let cleanup;
+    let isDisposed = false;
+    const execute = () => {
+        if (isDisposed)
+            return;
+        // Run cleanup from previous execution
+        if (cleanup) {
+            cleanup();
+        }
+        // Execute effect
+        const prevComputation = currentComputation;
+        currentComputation = execute;
+        try {
+            cleanup = callback();
+        }
+        finally {
+            currentComputation = prevComputation;
+        }
+    };
+    // Initial execution
+    execute();
+    // Return dispose function
+    return () => {
+        isDisposed = true;
+        if (cleanup) {
+            cleanup();
+        }
+    };
+}
+/**
+ * Batch multiple signal updates
+ * Defers notifications until batch completes
+ */
+export function batch(callback) {
+    batchDepth++;
+    try {
+        callback();
+    }
+    finally {
+        batchDepth--;
+        if (batchDepth === 0) {
+            // Execute all batched updates
+            const updates = Array.from(batchedUpdates);
+            batchedUpdates.clear();
+            updates.forEach((update) => update());
+        }
+    }
+}
+/**
+ * Create a signal
+ */
+export function signal(initialValue) {
+    return new Signal(initialValue);
+}
+/**
+ * Create a computed signal
+ */
+export function computed(compute) {
+    return new Computed(compute);
+}
+/**
+ * Untracked - access signals without subscribing
+ */
+export function untracked(callback) {
+    const prevComputation = currentComputation;
+    currentComputation = null;
+    try {
+        return callback();
+    }
+    finally {
+        currentComputation = prevComputation;
+    }
+}
+//# sourceMappingURL=Signal.js.map

package/dist/utils/helpers/Signal.js.map

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

package/dist/utils/helpers/StorageUtils.js

@@ -1,7 +1,11 @@
 export class StorageManager {
-    storage;
     constructor(storage = localStorage) {
-        this.storage = storage;
+        Object.defineProperty(this, "storage", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: storage
+        });
     }
     set(key, value, ttlMs) {
         const data = { value, expires: ttlMs ? Date.now() + ttlMs : null };

package/dist/utils/helpers/StorageUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageUtils.js","sourceRoot":"","sources":["../../../src/utils/helpers/StorageUtils.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAc;IACH;IAApB,YAAoB,UAAmB,YAAY;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEvD,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QACxC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,GAAG,CAAI,GAAW;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBAC7B,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,OAAO,IAAI,CAAC,KAAU,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ"}
+{"version":3,"file":"StorageUtils.js","sourceRoot":"","sources":["../../../src/utils/helpers/StorageUtils.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAc;IACvB,YAAoB,UAAmB,YAAY;QAAvC;;;;mBAAQ,OAAO;WAAwB;IAAG,CAAC;IAEvD,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QACxC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,GAAG,CAAI,GAAW;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBAC7B,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,OAAO,IAAI,CAAC,KAAU,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ"}

package/dist/utils/helpers/StreamingHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StreamingHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/StreamingHelper.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,qBAAa,eAAe;IACxB;;;OAGG;WACU,eAAe,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAwF7B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAa,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD;QACC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;QACvD,KAAK,EAAE,MAAM,IAAI,CAAC;KACrB;IAuDD;;OAEG;WACU,cAAc,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAa,GAAG;QAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;KAAO,GAC1E,OAAO,CAAC,IAAI,CAAC;CAyDnB"}
+{"version":3,"file":"StreamingHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/StreamingHelper.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,qBAAa,eAAe;IACxB;;;OAGG;WACU,eAAe,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAwF7B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAa,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD;QACC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;QACvD,KAAK,EAAE,MAAM,IAAI,CAAC;KACrB;IAqDD;;OAEG;WACU,cAAc,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAa,GAAG;QAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;KAAO,GAC1E,OAAO,CAAC,IAAI,CAAC;CAyDnB"}