@trackunit/react-components 2.1.28 → 2.1.30

package/index.cjs.js

@@ -10533,6 +10533,58 @@ const b64urlDecode = (s) => {
     }
     return out;
 };
+/**
+ * Encode a value with the same gzip + base64url format used by useCustomEncoding.
+ *
+ * @param input - The value to encode.
+ * @returns {string} The compressed URL-safe encoded value, or an empty string on failure.
+ */
+const encodeCustomValue = (input) => {
+    try {
+        const json = typeof input === "string" ? input : JSON.stringify(input);
+        const textInput = new TextEncoder().encode(json);
+        const compressed = fflate.gzipSync(textInput, { mtime: 0 });
+        return b64urlEncode(compressed);
+    }
+    catch (_) {
+        return "";
+    }
+};
+/**
+ * Decode a value produced by encodeCustomValue.
+ *
+ * @param str - The compressed URL-safe encoded value.
+ * @returns {object | Array<object> | string} The decoded object/string value, or an empty string on failure.
+ */
+const decodeCustomValue = (str) => {
+    try {
+        try {
+            const bytes = b64urlDecode(str);
+            const decompressed = fflate.gunzipSync(bytes);
+            const json = new TextDecoder().decode(decompressed);
+            try {
+                return JSON.parse(json);
+            }
+            catch (_) {
+                return json;
+            }
+        }
+        catch (_) {
+            // If compression decoding fails, fall back to regular decoding.
+        }
+        const decoded = decodeURIComponent(escape(atob(str)));
+        try {
+            return JSON.parse(decoded);
+        }
+        catch (_) {
+            return decoded;
+        }
+    }
+    catch (_) {
+        return "";
+    }
+};
+
 /**
  * React hook for safe base64 encoding/decoding with UTF-8 support and compression
  *
@@ -10552,22 +10604,7 @@ const useCustomEncoding = () => {
      * @param input - The object or string to encode
      * @returns The compressed and encoded string
      */
-    const encode = react.useCallback((input) => {
-        try {
-            // If it's already a string, use it directly; otherwise stringify the object
-            const json = typeof input === "string" ? input : JSON.stringify(input);
-            const textInput = new TextEncoder().encode(json);
-            // Use fflate for synchronous gzip compression.
-            // mtime: 0 ensures deterministic output — without it the gzip header
-            // includes the current timestamp, making the same input produce a
-            // different encoded string on every call.
-            const compressed = fflate.gzipSync(textInput, { mtime: 0 });
-            return b64urlEncode(compressed);
-        }
-        catch (_) {
-            return "";
-        }
-    }, []);
+    const encode = react.useCallback((input) => encodeCustomValue(input), []);
     /**
      * Safely decode a compressed and encoded string back to its original form
      *
@@ -10575,41 +10612,9 @@ const useCustomEncoding = () => {
      * and returning the original object or string.
      *
      * @param str - The compressed and encoded string to decode
-     * @returns The decoded object or string, or null if decoding fails
+     * @returns The decoded object or string, or an empty string if decoding fails
      */
-    const decode = react.useCallback((str) => {
-        try {
-            // Try to decode as compressed data first
-            try {
-                const bytes = b64urlDecode(str);
-                const decompressed = fflate.gunzipSync(bytes);
-                const json = new TextDecoder().decode(decompressed);
-                // Try to parse as JSON first (for objects)
-                try {
-                    return JSON.parse(json);
-                }
-                catch (_) {
-                    // If JSON parsing fails, return the string as-is
-                    return json;
-                }
-            }
-            catch (_) {
-                // If compression decoding fails, fall back to regular decoding
-            }
-            // Fallback: use regular base64 decoding
-            const decoded = decodeURIComponent(escape(atob(str)));
-            try {
-                return JSON.parse(decoded);
-            }
-            catch (_) {
-                // If JSON parsing fails, return the string as-is
-                return decoded;
-            }
-        }
-        catch (_) {
-            return "";
-        }
-    }, []);
+    const decode = react.useCallback((str) => decodeCustomValue(str), []);
     return react.useMemo(() => ({ encode, decode }), [encode, decode]);
 };
 

package/index.esm.js

@@ -10531,6 +10531,58 @@ const b64urlDecode = (s) => {
     }
     return out;
 };
+/**
+ * Encode a value with the same gzip + base64url format used by useCustomEncoding.
+ *
+ * @param input - The value to encode.
+ * @returns {string} The compressed URL-safe encoded value, or an empty string on failure.
+ */
+const encodeCustomValue = (input) => {
+    try {
+        const json = typeof input === "string" ? input : JSON.stringify(input);
+        const textInput = new TextEncoder().encode(json);
+        const compressed = gzipSync(textInput, { mtime: 0 });
+        return b64urlEncode(compressed);
+    }
+    catch (_) {
+        return "";
+    }
+};
+/**
+ * Decode a value produced by encodeCustomValue.
+ *
+ * @param str - The compressed URL-safe encoded value.
+ * @returns {object | Array<object> | string} The decoded object/string value, or an empty string on failure.
+ */
+const decodeCustomValue = (str) => {
+    try {
+        try {
+            const bytes = b64urlDecode(str);
+            const decompressed = gunzipSync(bytes);
+            const json = new TextDecoder().decode(decompressed);
+            try {
+                return JSON.parse(json);
+            }
+            catch (_) {
+                return json;
+            }
+        }
+        catch (_) {
+            // If compression decoding fails, fall back to regular decoding.
+        }
+        const decoded = decodeURIComponent(escape(atob(str)));
+        try {
+            return JSON.parse(decoded);
+        }
+        catch (_) {
+            return decoded;
+        }
+    }
+    catch (_) {
+        return "";
+    }
+};
+
 /**
  * React hook for safe base64 encoding/decoding with UTF-8 support and compression
  *
@@ -10550,22 +10602,7 @@ const useCustomEncoding = () => {
      * @param input - The object or string to encode
      * @returns The compressed and encoded string
      */
-    const encode = useCallback((input) => {
-        try {
-            // If it's already a string, use it directly; otherwise stringify the object
-            const json = typeof input === "string" ? input : JSON.stringify(input);
-            const textInput = new TextEncoder().encode(json);
-            // Use fflate for synchronous gzip compression.
-            // mtime: 0 ensures deterministic output — without it the gzip header
-            // includes the current timestamp, making the same input produce a
-            // different encoded string on every call.
-            const compressed = gzipSync(textInput, { mtime: 0 });
-            return b64urlEncode(compressed);
-        }
-        catch (_) {
-            return "";
-        }
-    }, []);
+    const encode = useCallback((input) => encodeCustomValue(input), []);
     /**
      * Safely decode a compressed and encoded string back to its original form
      *
@@ -10573,41 +10610,9 @@ const useCustomEncoding = () => {
      * and returning the original object or string.
      *
      * @param str - The compressed and encoded string to decode
-     * @returns The decoded object or string, or null if decoding fails
+     * @returns The decoded object or string, or an empty string if decoding fails
      */
-    const decode = useCallback((str) => {
-        try {
-            // Try to decode as compressed data first
-            try {
-                const bytes = b64urlDecode(str);
-                const decompressed = gunzipSync(bytes);
-                const json = new TextDecoder().decode(decompressed);
-                // Try to parse as JSON first (for objects)
-                try {
-                    return JSON.parse(json);
-                }
-                catch (_) {
-                    // If JSON parsing fails, return the string as-is
-                    return json;
-                }
-            }
-            catch (_) {
-                // If compression decoding fails, fall back to regular decoding
-            }
-            // Fallback: use regular base64 decoding
-            const decoded = decodeURIComponent(escape(atob(str)));
-            try {
-                return JSON.parse(decoded);
-            }
-            catch (_) {
-                // If JSON parsing fails, return the string as-is
-                return decoded;
-            }
-        }
-        catch (_) {
-            return "";
-        }
-    }, []);
+    const decode = useCallback((str) => decodeCustomValue(str), []);
     return useMemo(() => ({ encode, decode }), [encode, decode]);
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-components",
-  "version": "2.1.28",
+  "version": "2.1.30",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "migrations": "./migrations.json",
@@ -14,17 +14,17 @@
     "@floating-ui/react": "^0.26.25",
     "string-ts": "^2.0.0",
     "tailwind-merge": "^2.0.0",
-    "@trackunit/ui-design-tokens": "1.13.32",
-    "@trackunit/css-class-variance-utilities": "1.13.32",
-    "@trackunit/shared-utils": "1.15.32",
-    "@trackunit/ui-icons": "1.13.34",
+    "@trackunit/ui-design-tokens": "1.13.34",
+    "@trackunit/css-class-variance-utilities": "1.13.34",
+    "@trackunit/shared-utils": "1.15.34",
+    "@trackunit/ui-icons": "1.13.36",
     "es-toolkit": "^1.39.10",
     "@tanstack/react-virtual": "3.13.12",
     "dequal": "^2.0.3",
     "fflate": "^0.8.2",
     "superjson": "^2.2.6",
     "zod": "^3.25.76",
-    "@trackunit/i18n-library-translation": "2.0.29"
+    "@trackunit/i18n-library-translation": "2.0.31"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/hooks/encoding/utils/customEncoding.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Encode a value with the same gzip + base64url format used by useCustomEncoding.
+ *
+ * @param input - The value to encode.
+ * @returns {string} The compressed URL-safe encoded value, or an empty string on failure.
+ */
+export declare const encodeCustomValue: (input: string | object | Array<object>) => string;
+/**
+ * Decode a value produced by encodeCustomValue.
+ *
+ * @param str - The compressed URL-safe encoded value.
+ * @returns {object | Array<object> | string} The decoded object/string value, or an empty string on failure.
+ */
+export declare const decodeCustomValue: (str: string) => object | Array<object> | string;