bytekit 2.2.0 → 2.4.3

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

@@ -1 +1 @@
-{"version":3,"file":"StorageUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/StorageUtils.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAc;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,OAAsB;IAEnD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM;IAK5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAe7B,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,KAAK;CAGR"}
+{"version":3,"file":"StorageUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/StorageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IAOX,OAAO,CAAC,OAAO;IAN3B;;;;;OAKG;gBACiB,OAAO,GAAE,OAAsB;IAEnD;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM;IAK5C;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAe7B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB;;;;;;;OAOG;IACH,KAAK;CAGR"}

package/dist/utils/helpers/StorageUtils.js

@@ -1,4 +1,24 @@
+/**
+ * JSON-serialising wrapper around the browser `Storage` API with optional
+ * time-to-live (TTL) support.
+ *
+ * Works with any `Storage`-compatible object (`localStorage`,
+ * `sessionStorage`, or a custom in-memory implementation).
+ *
+ * @example
+ * ```typescript
+ * const store = new StorageManager();
+ * store.set('user', { id: 1, name: 'Alice' }, 3_600_000); // expires in 1 h
+ * const user = store.get<{ id: number; name: string }>('user');
+ * ```
+ */
 export class StorageManager {
+    /**
+     * Creates a new `StorageManager` instance.
+     *
+     * @param storage - The `Storage` backend to use. Defaults to
+     *   `localStorage`.
+     */
     constructor(storage = localStorage) {
         Object.defineProperty(this, "storage", {
             enumerable: true,
@@ -7,10 +27,39 @@ export class StorageManager {
             value: storage
         });
     }
+    /**
+     * Serialises a value to JSON and stores it under the given key.
+     *
+     * @template T - Type of the value to store.
+     * @param key - Storage key.
+     * @param value - Value to serialise and store.
+     * @param ttlMs - Optional time-to-live in milliseconds. When set, the
+     *   entry is automatically invalidated after this duration.
+     *
+     * @example
+     * ```typescript
+     * store.set('token', 'abc123', 60_000); // expires in 60 s
+     * ```
+     */
     set(key, value, ttlMs) {
         const data = { value, expires: ttlMs ? Date.now() + ttlMs : null };
         this.storage.setItem(key, JSON.stringify(data));
     }
+    /**
+     * Retrieves and deserialises a stored value.
+     *
+     * Returns `null` when the key does not exist, the stored JSON is malformed,
+     * or the entry's TTL has expired (expired entries are removed automatically).
+     *
+     * @template T - Expected type of the stored value.
+     * @param key - Storage key to retrieve.
+     * @returns The deserialised value, or `null` on miss or expiry.
+     *
+     * @example
+     * ```typescript
+     * const token = store.get<string>('token');
+     * ```
+     */
     get(key) {
         const raw = this.storage.getItem(key);
         if (!raw)
@@ -27,9 +76,22 @@ export class StorageManager {
             return null;
         }
     }
+    /**
+     * Removes a single entry from storage.
+     *
+     * @param key - Storage key to remove.
+     */
     remove(key) {
         this.storage.removeItem(key);
     }
+    /**
+     * Removes all entries from the underlying storage backend.
+     *
+     * @example
+     * ```typescript
+     * store.clear(); // clears all localStorage entries
+     * ```
+     */
     clear() {
         this.storage.clear();
     }

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;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"}
+{"version":3,"file":"StorageUtils.js","sourceRoot":"","sources":["../../../src/utils/helpers/StorageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,cAAc;IACvB;;;;;OAKG;IACH,YAAoB,UAAmB,YAAY;QAAvC;;;;mBAAQ,OAAO;WAAwB;IAAG,CAAC;IAEvD;;;;;;;;;;;;;OAaG;IACH,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;;;;;;;;;;;;;;OAcG;IACH,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;;;;OAIG;IACH,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,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;AAID;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACjC,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACjB,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACpD,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAe;IACxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAgBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAmB3B;;;;;;;;;;;;;;OAcG;WACU,eAAe,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAqE7B;;;;;;;;;;;;;;;;;OAiBG;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;IAoDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACW,QAAQ,CAAC,CAAC,GAAG,OAAO,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC9B,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IAyJ/C;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAqC5B;;OAEG;WACU,cAAc,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAa,GAAG;QACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;KACtC,GACP,OAAO,CAAC,IAAI,CAAC;CA4DnB"}
+{"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;AAID;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACjC,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACjB,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACpD,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAe;IACxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAiBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAmB3B;;;;;;;;;;;;;;OAcG;WACU,eAAe,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAsE7B;;;;;;;;;;;;;;;;;OAiBG;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;IAoDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACW,QAAQ,CAAC,CAAC,GAAG,OAAO,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC9B,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IA6J/C;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAyC5B;;OAEG;WACU,cAAc,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAa,GAAG;QACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;KACtC,GACP,OAAO,CAAC,IAAI,CAAC;CA6DnB"}

package/dist/utils/helpers/StreamingHelper.js

@@ -7,6 +7,7 @@ export class StreamingHelper {
             try {
                 const item = JSON.parse(buffer);
                 data.push(item);
+                /* v8 ignore next */
                 onChunk?.(buffer);
             }
             catch {
@@ -91,6 +92,7 @@ export class StreamingHelper {
             onComplete?.();
         }
         catch (err) {
+            /* v8 ignore next */
             error = err instanceof Error ? err : new Error(String(err));
             onError?.(error);
         }
@@ -198,7 +200,8 @@ export class StreamingHelper {
                 body instanceof FormData ||
                 body instanceof URLSearchParams ||
                 body instanceof Blob ||
-                (typeof ReadableStream !== "undefined" && body instanceof ReadableStream)) {
+                (typeof ReadableStream !== "undefined" &&
+                    body instanceof ReadableStream)) {
                 requestBody = body;
             }
             else {
@@ -238,6 +241,7 @@ export class StreamingHelper {
                 if (done) {
                     // Flush any partial event left in the buffer
                     const flushed = this.flushSSEEvent(currentEvent, currentData, currentId, currentRetry, eventTypes, raw);
+                    /* v8 ignore next */
                     if (flushed)
                         yield flushed;
                     break;
@@ -246,6 +250,7 @@ export class StreamingHelper {
                 // SSE spec: events are separated by one or more blank lines (\n\n)
                 const segments = buffer.split("\n");
                 // Keep the last segment (may be incomplete)
+                /* v8 ignore next */
                 buffer = segments.pop();
                 for (const line of segments) {
                     if (line === "" || line === "\r") {
@@ -276,9 +281,10 @@ export class StreamingHelper {
                     else {
                         field = cleaned.slice(0, colonIdx);
                         // The spec says: if the first character after ':' is a space, strip it
-                        val = cleaned[colonIdx + 1] === " "
-                            ? cleaned.slice(colonIdx + 2)
-                            : cleaned.slice(colonIdx + 1);
+                        val =
+                            cleaned[colonIdx + 1] === " "
+                                ? cleaned.slice(colonIdx + 2)
+                                : cleaned.slice(colonIdx + 1);
                     }
                     switch (field) {
                         case "event":
@@ -315,7 +321,9 @@ export class StreamingHelper {
             return null;
         const type = eventType || "message";
         // Filter by allowed event types
-        if (allowedTypes && allowedTypes.length > 0 && !allowedTypes.includes(type)) {
+        if (allowedTypes &&
+            allowedTypes.length > 0 &&
+            !allowedTypes.includes(type)) {
             return null;
         }
         // Per spec, multiple `data:` lines are joined with \n
@@ -380,7 +388,9 @@ export class StreamingHelper {
             return new Blob(chunks);
         }
         catch (error) {
-            const err = error instanceof Error ? error : new Error(String(error));
+            const err = 
+            /* v8 ignore next */
+            error instanceof Error ? error : new Error(String(error));
             onError?.(err);
             throw err;
         }

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

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

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

@@ -1,8 +1,19 @@
+/** Options for {@link UrlHelper.stringify}. */
 export interface QueryStringOptions {
+    /**
+     * How arrays are serialised in the query string.
+     * - `"repeat"` (default): `a=1&a=2`
+     * - `"bracket"`: `a[]=1&a[]=2`
+     * - `"comma"`: `a=1,2`
+     */
     arrayFormat?: "repeat" | "bracket" | "comma";
+    /** When `true`, keys whose value is `null` are omitted. Defaults to `true`. */
     skipNull?: boolean;
+    /** When `true`, keys with an empty-string value are omitted. Defaults to `false`. */
     skipEmptyString?: boolean;
+    /** When `true`, keys and values are percent-encoded. Defaults to `true`. */
     encode?: boolean;
+    /** When `true`, query parameters are sorted alphabetically by key. Defaults to `true`. */
     sortKeys?: boolean;
 }
 export interface SlugifyOptions {
@@ -12,6 +23,25 @@ export interface SlugifyOptions {
     lowercase?: boolean;
 }
 export declare class UrlHelper {
+    /**
+     * Serialises a plain object into a URL query string.
+     *
+     * Supports nested objects, arrays, `Date` values, and booleans. Returns
+     * an empty string when `params` is `null` or `undefined`.
+     *
+     * @param params - Object whose own enumerable properties are serialised.
+     * @param customOptions - Optional overrides for serialisation behaviour.
+     * @returns A percent-encoded query string without a leading `?`.
+     *
+     * @example
+     * ```typescript
+     * UrlHelper.stringify({ page: 1, tags: ['a', 'b'] });
+     * // "page=1&tags=a&tags=b"
+     *
+     * UrlHelper.stringify({ ids: [1, 2] }, { arrayFormat: 'bracket' });
+     * // "ids%5B%5D=1&ids%5B%5D=2"
+     * ```
+     */
     static stringify(params: Record<string, unknown> | null | undefined, customOptions?: QueryStringOptions): string;
     /**
      * Converts an object representation or a raw string into an SEO friendly slug URL string.

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

@@ -1 +1 @@
-{"version":3,"file":"UrlHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/UrlHelper.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAsFD,MAAM,WAAW,cAAc;IAC3B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAQD,qBAAa,SAAS;IAClB,MAAM,CAAC,SAAS,CACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,aAAa,GAAE,kBAAuB,GACvC,MAAM;IAoBT;;;;OAIG;IACH,MAAM,CAAC,OAAO,CACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3D,OAAO,GAAE,MAAM,GAAG,cAAmB,GACtC,MAAM;CAyCZ"}
+{"version":3,"file":"UrlHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/UrlHelper.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAwFD,MAAM,WAAW,cAAc;IAC3B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAQD,qBAAa,SAAS;IAClB;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,SAAS,CACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,aAAa,GAAE,kBAAuB,GACvC,MAAM;IAoBT;;;;OAIG;IACH,MAAM,CAAC,OAAO,CACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3D,OAAO,GAAE,MAAM,GAAG,cAAmB,GACtC,MAAM;CAgDZ"}

package/dist/utils/helpers/UrlHelper.js

@@ -1,4 +1,7 @@
-const safeString = (value) => value === null || value === undefined ? "" : String(value);
+const safeString = (value) => 
+/* v8 ignore next */
+value === null || value === undefined ? "" : String(value);
+/* v8 ignore next */
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const serializeValue = (value) => {
     if (value instanceof Date)
@@ -65,6 +68,25 @@ const NON_ALPHANUMERIC_REGEX = /[^a-z0-9]+/gi;
 const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 const removeDiacritics = (value) => value.normalize("NFD").replace(DIACRITICS_REGEX, "");
 export class UrlHelper {
+    /**
+     * Serialises a plain object into a URL query string.
+     *
+     * Supports nested objects, arrays, `Date` values, and booleans. Returns
+     * an empty string when `params` is `null` or `undefined`.
+     *
+     * @param params - Object whose own enumerable properties are serialised.
+     * @param customOptions - Optional overrides for serialisation behaviour.
+     * @returns A percent-encoded query string without a leading `?`.
+     *
+     * @example
+     * ```typescript
+     * UrlHelper.stringify({ page: 1, tags: ['a', 'b'] });
+     * // "page=1&tags=a&tags=b"
+     *
+     * UrlHelper.stringify({ ids: [1, 2] }, { arrayFormat: 'bracket' });
+     * // "ids%5B%5D=1&ids%5B%5D=2"
+     * ```
+     */
     static stringify(params, customOptions = {}) {
         if (!params)
             return "";

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

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

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

@@ -1,3 +1,8 @@
+import type { SchemaAdapter } from "../core/SchemaAdapter.js";
+export type BackoffStrategy = "linear" | "exponential" | ((attempt: number) => number);
+export type WebSocketReconnectHandler = (attempt: number, delay: number) => void;
+export type WebSocketMaxRetriesHandler = () => void;
+export type WebSocketValidationErrorHandler = (error: Error, message: WebSocketMessage) => void;
 export interface WebSocketMessage<T = unknown> {
     type: string;
     data: T;
@@ -9,6 +14,11 @@ export interface WebSocketOptions {
     reconnectDelayMs?: number;
     heartbeatIntervalMs?: number;
     messageTimeout?: number;
+    backoffStrategy?: BackoffStrategy;
+    maxReconnectDelayMs?: number;
+    jitter?: boolean;
+    heartbeatTimeoutMs?: number;
+    schemas?: Record<string, SchemaAdapter>;
 }
 export type WebSocketEventHandler<T = unknown> = (data: T) => void;
 export type WebSocketErrorHandler = (error: Error) => void;
@@ -21,6 +31,10 @@ export declare class WebSocketHelper {
     private reconnectAttempts;
     private heartbeatTimer?;
     private isIntentionallyClosed;
+    private reconnectHandlers;
+    private maxRetriesHandlers;
+    private validationErrorHandlers;
+    private pongTimeoutTimer;
     constructor(url: string, options?: WebSocketOptions);
     /**
      * Connect to WebSocket
@@ -38,6 +52,20 @@ export declare class WebSocketHelper {
      * Subscribe to errors
      */
     onError(handler: WebSocketErrorHandler): () => void;
+    /**
+     * Subscribe to reconnect attempts.
+     * Fires just before each reconnect delay begins.
+     */
+    onReconnect(handler: WebSocketReconnectHandler): () => void;
+    /**
+     * Subscribe to terminal failure when all reconnect attempts are exhausted.
+     */
+    onMaxRetriesReached(handler: WebSocketMaxRetriesHandler): () => void;
+    /**
+     * Subscribe to incoming message validation errors.
+     * The offending message is dropped (on() handlers are NOT called).
+     */
+    onValidationError(handler: WebSocketValidationErrorHandler): () => void;
     /**
      * Send a message and wait for response
      */
@@ -58,6 +86,8 @@ export declare class WebSocketHelper {
     private startHeartbeat;
     private stopHeartbeat;
     private attemptReconnect;
+    private computeDelay;
     private notifyError;
+    private notifyValidationError;
 }
 //# sourceMappingURL=WebSocketHelper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"WebSocketHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/WebSocketHelper.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AACnE,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAE3D,qBAAa,eAAe;IACxB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,eAAe,CACT;IACd,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAWvD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC9B;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAc9C;;OAEG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAClC,MAAM,IAAI;IAgBb;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAKnD;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,CAAC;IA0BrB;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,WAAW;CAStB"}
+{"version":3,"file":"WebSocketHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/WebSocketHelper.ts"],"names":[],"mappings":"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"}

package/dist/utils/helpers/WebSocketHelper.js

@@ -48,6 +48,30 @@ export class WebSocketHelper {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "reconnectHandlers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "maxRetriesHandlers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "validationErrorHandlers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "pongTimeoutTimer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.url = url;
         this.options = {
             reconnect: options.reconnect ?? true,
@@ -55,6 +79,11 @@ export class WebSocketHelper {
             reconnectDelayMs: options.reconnectDelayMs ?? 3000,
             heartbeatIntervalMs: options.heartbeatIntervalMs ?? 30000,
             messageTimeout: options.messageTimeout ?? 5000,
+            backoffStrategy: options.backoffStrategy ?? "linear",
+            maxReconnectDelayMs: options.maxReconnectDelayMs ?? 30000,
+            jitter: options.jitter ?? false,
+            heartbeatTimeoutMs: options.heartbeatTimeoutMs ?? 5000,
+            schemas: options.schemas ?? {},
         };
     }
     /**
@@ -85,7 +114,9 @@ export class WebSocketHelper {
                 };
             }
             catch (error) {
-                reject(error instanceof Error ? error : new Error(String(error)));
+                reject(
+                /* v8 ignore next */
+                error instanceof Error ? error : new Error(String(error)));
             }
         });
     }
@@ -126,6 +157,29 @@ export class WebSocketHelper {
         this.errorHandlers.add(handler);
         return () => this.errorHandlers.delete(handler);
     }
+    /**
+     * Subscribe to reconnect attempts.
+     * Fires just before each reconnect delay begins.
+     */
+    onReconnect(handler) {
+        this.reconnectHandlers.add(handler);
+        return () => this.reconnectHandlers.delete(handler);
+    }
+    /**
+     * Subscribe to terminal failure when all reconnect attempts are exhausted.
+     */
+    onMaxRetriesReached(handler) {
+        this.maxRetriesHandlers.add(handler);
+        return () => this.maxRetriesHandlers.delete(handler);
+    }
+    /**
+     * Subscribe to incoming message validation errors.
+     * The offending message is dropped (on() handlers are NOT called).
+     */
+    onValidationError(handler) {
+        this.validationErrorHandlers.add(handler);
+        return () => this.validationErrorHandlers.delete(handler);
+    }
     /**
      * Send a message and wait for response
      */
@@ -174,8 +228,23 @@ export class WebSocketHelper {
         return this.ws?.readyState ?? WebSocket.CLOSED;
     }
     handleMessage(rawData) {
+        clearTimeout(this.pongTimeoutTimer);
+        this.pongTimeoutTimer = undefined;
         try {
             const message = JSON.parse(rawData);
+            // Schema validation — US2
+            const schema = this.options.schemas[message.type];
+            if (schema) {
+                try {
+                    message.data = schema.parse(message.data);
+                }
+                catch (error) {
+                    this.notifyValidationError(error instanceof Error
+                        ? error
+                        : new Error(String(error)), message);
+                    return; // drop message
+                }
+            }
             const handlers = this.messageHandlers.get(message.type);
             if (handlers) {
                 handlers.forEach((handler) => {
@@ -191,7 +260,9 @@ export class WebSocketHelper {
             }
         }
         catch (error) {
-            this.notifyError(error instanceof Error ? error : new Error(String(error)));
+            this.notifyError(
+            /* v8 ignore next */
+            error instanceof Error ? error : new Error(String(error)));
         }
     }
     startHeartbeat() {
@@ -199,6 +270,9 @@ export class WebSocketHelper {
             if (this.isConnected()) {
                 try {
                     this.send("ping", {});
+                    this.pongTimeoutTimer = setTimeout(() => {
+                        this.ws?.close();
+                    }, this.options.heartbeatTimeoutMs);
                 }
                 catch {
                     // Heartbeat failed, connection will be handled by onclose
@@ -207,6 +281,8 @@ export class WebSocketHelper {
         }, this.options.heartbeatIntervalMs);
     }
     stopHeartbeat() {
+        clearTimeout(this.pongTimeoutTimer);
+        this.pongTimeoutTimer = undefined;
         if (this.heartbeatTimer) {
             clearInterval(this.heartbeatTimer);
             this.heartbeatTimer = undefined;
@@ -214,18 +290,44 @@ export class WebSocketHelper {
     }
     attemptReconnect() {
         if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {
-            const error = new Error("Max reconnection attempts reached");
-            this.notifyError(error);
+            this.maxRetriesHandlers.forEach((handler) => {
+                try {
+                    handler();
+                }
+                catch (e) {
+                    console.error("Error in maxRetriesReached handler:", e);
+                }
+            });
             return;
         }
         this.reconnectAttempts++;
-        const delay = this.options.reconnectDelayMs * this.reconnectAttempts;
+        const delay = this.computeDelay(this.reconnectAttempts);
+        this.reconnectHandlers.forEach((handler) => {
+            try {
+                handler(this.reconnectAttempts, delay);
+            }
+            catch (e) {
+                console.error("Error in reconnect handler:", e);
+            }
+        });
         setTimeout(() => {
             this.connect().catch((error) => {
                 this.notifyError(error);
             });
         }, delay);
     }
+    computeDelay(attempt) {
+        const strategy = this.options.backoffStrategy;
+        if (typeof strategy === "function") {
+            return strategy(attempt);
+        }
+        if (strategy === "exponential") {
+            const cap = Math.min(this.options.maxReconnectDelayMs, this.options.reconnectDelayMs * Math.pow(2, attempt - 1));
+            return this.options.jitter ? Math.random() * cap : cap;
+        }
+        // "linear" (default)
+        return this.options.reconnectDelayMs * attempt;
+    }
     notifyError(error) {
         this.errorHandlers.forEach((handler) => {
             try {
@@ -236,5 +338,15 @@ export class WebSocketHelper {
             }
         });
     }
+    notifyValidationError(error, message) {
+        this.validationErrorHandlers.forEach((handler) => {
+            try {
+                handler(error, message);
+            }
+            catch (e) {
+                console.error("Error in validation error handler:", e);
+            }
+        });
+    }
 }
 //# sourceMappingURL=WebSocketHelper.js.map