json-storage-formatter 2.0.9 → 3.0.1

package/README.md

@@ -1,131 +1,260 @@
-# json-storage-formatter
+const README = `
 
-Package for json stringify objects without losing data types. The transformation of the data includes extra metadata into the resulted string which later on is used to restored all the data structures to the their origninal forms.
+# json-storage-formatter 🌟
 
-The library suppors Sets, Maps, Objects, Arrays, and Primitive data like Dates
+![Image John Avatar](https://raw.githubusercontent.com/johnny-quesada-developer/global-hooks-example/main/public/avatar2.jpeg)
 
-# API
+A **lightweight solution** to store complex JavaScript values as JSON — **without losing their types**. 🚀
 
-The main methods of the library are **formatToStore** and **formatFromStore**
+---
 
-## formatToStore
+## 🤔 The Problem
 
-Format an object to be stored as JSON
+When working with tools like **localStorage**, **sessionStorage**, **AsyncStorage**, or even databases like **Redis** or **PostgreSQL (JSON columns)**,  
+we often need to store application state or configuration objects as strings using `JSON.stringify`.
 
-```TS
-const objectWithMetadata = formatToStore(object);
+But there’s a catch:  
+`JSON.stringify` has no idea what to do with values like `Date`, `Map`, or `Set`... It just flattens them into empty objects or strings, and when you parse them back with `JSON.parse`, it’s too late.
+
+Let’s see an example.
+
+---
+
+### 🔍 Example: Losing Real Data
+
+```ts
+const userProfile = {
+  id: 42,
+  createdAt: new Date('2024-10-01T10:30:00Z'),
+  preferences: new Map([
+    ['theme', 'dark'],
+    ['languages', new Set(['en', 'es'])],
+  ]),
+};
+
+console.log(JSON.stringify(userProfile, null, 2));
+```
 
-// The result can be JSON.stringify
-console.log(objectWithMetadata);
-/*
+**Console Output:**
+
+```json
 {
-    $t: 'map',
-    $v: [
-        [
-        'key1',
-        {
-            $t: 'date',
-            $v: '2021-05-08T13:30:00.000Z',
-        },
-        ],
-        [
-        'key2',
-        {
-            $t: 'set',
-            $v: [
-            {
-                $t: 'map',
-                $v: [
-                [
-                    'key1',
-                    {
-                    $t: 'date',
-                    $v: '2021-05-08T13:30:00.000Z',
-                    },
-                ],
-                ],
-            },
-            ],
-        },
-        ],
-    ],
+  "id": 42,
+  "createdAt": "2024-10-01T10:30:00.000Z",
+  "preferences": {}
 }
-*/
+```
+
+What happened?
 
-// you can also stringify directly the result by specifying it on the configuration parameter
-const objectString = formatToStore(object, { stringify: true });
+- The **Date** turned into a string.
+- The **Map** disappeared.
+- The **Set** vanished inside the Map.
 
-console.log(objectString); // {"$t":"map","$v":[["key1",{"$t":"date","$v":"2021-05-08T13:30:00.000Z"}],["key2",{"$t":"set","$v":[{"$t":"map","$v":[["key1",{"$t":"date","$v":"2021-05-08T13:30:00.000Z"}]]}]}]]}
+If we try to restore it:
 
+```ts
+const parsed = JSON.parse(JSON.stringify(userProfile));
+console.log(parsed.createdAt instanceof Date); // ❌ false
+console.log(parsed.preferences instanceof Map); // ❌ false
 ```
 
-## formatFromStore<T>
+When serializing JavaScript objects, we lose important value types —  
+Dates, Sets, Maps, RegExps, and even nested structures.  
+This forces us to write endless **custom parsers and validators** to recover data  
+that could have been automatically restored.
 
-Format a value with possible metadata to his original form, it also supports Map, Set, Arrays
+---
 
-```TS
-const object = formatFromStore<Map<string, unknown>>(objectWithMetadata);
+## 💡 What json-storage-formatter Does
 
-// Original types of the object with metadata
-console.log(object);
+Exposes **two simple functions**:
 
-/*
-// the result will be the same than executing the following code
-const formatFromStoreResultExample = new Map([
-    ['key1', new Date('2021-05-08T13:30:00.000Z')],
-    [
-        'key2',
-        new Set([new Map([['key1', new Date('2021-05-08T13:30:00.000Z')]])]),
-    ],
-]);
-    */
-```
+1. `formatToStore(value)` → safely prepares your data for storage returning the JSON string representation.
+2. `formatFromStore(value)` → restores it to the **exact original shape and types**.
+
+As simple as that.
 
-## clone
+# Let’s see it a couple of examples
 
-Deep clone an object, it also suppors Map, Set, Arrays.
-The formatters clones the objects to avoid modify the parameter reference
+---
+
+## ⚙️ Example: useDashboardConfig hook
+
+Let’s create a hook that sync localStorage with react state:
 
 ```ts
-const clone: <T>(obj: T) => T;
+import { formatToStore, formatFromStore } from 'json-storage-formatter';
+
+type DashboardConfig = {
+  theme: 'light' | 'dark' | 'system';
+  widgets: Map<string, WidgetConfig>;
+  hiddenWidgets: Set<string>;
+  lastCustomizedAt: Date;
+};
+
+const useDashboardConfig = () => {
+  const [config, setConfig] = useState<DashboardConfig>(() => {
+    const json = localStorage.getItem('dashboard-config');
+
+    if (json) return formatFromStore<DashboardConfig>(json);
+
+    return getDefaultDashboardConfig();
+  });
+
+  const saveConfig = (newConfig: DashboardConfig) => {
+    localStorage.setItem('dashboard-config', formatToStore(newConfig));
+
+    setConfig(newConfig);
+  };
+
+  return { config, saveConfig };
+};
+
+// Even if the config contains Maps, Sets, or Dates, they will be preserved.
+const example: DashboardConfig = {
+  theme: 'dark',
+  widgets: new Map([
+    ['weather', { location: 'New York', units: 'metric' }],
+    ['stocks', { symbols: ['AAPL', 'GOOGL'] }],
+  ]),
+  hiddenWidgets: new Set(['news']),
+  lastCustomizedAt: new Date(),
+};
 ```
 
-## isNil
+---
 
-Check if a value is null or undefined
+## 🌐 Example: Sync dashboard queries through URL (Dashboards / Reports)
 
-```ts
-const isNil: (value: unknown) => boolean;
+This pattern is common in dashboards, where filters are shared via URL.  
+You can safely serialize complex filters (with Dates, Sets, Maps, etc.) and encode them for sharing.
+
+```tsx
+import { formatToStore, formatFromStore } from 'json-storage-formatter';
+
+type DashboardQuery = {
+  dateRange: { from: Date; to: Date };
+  selectedCategories: Set<string>;
+  additionalSettings: Map<string, unknown>;
+};
+
+const useUrlQuery = () => {
+  const [query, setQuery] = useState<DashboardQuery>(() => {
+    const params = new URLSearchParams(location.search);
+    const storedQuery = params.get('query');
+
+    if (storedQuery) {
+      // decode from base64 and restore types
+      return formatFromStore<DashboardQuery>(atob(storedQuery));
+    }
+
+    return getDefaultDashboardQuery();
+  });
+
+  const updateQuery = (newQuery: DashboardQuery) => {
+    const encoded = btoa(formatToStore(newQuery));
+
+    // encode the json as base64 to make it URL-safe
+    window.history.replaceState(null, '', `${location.pathname}?query=${encoded}`);
+
+    setQuery(newQuery);
+  };
+
+  return { query, updateQuery };
+};
 ```
 
-## isNumber
+The examples above are in react but the library is framework-agnostic and can be used anywhere in JavaScript or TypeScript projects.
 
-Check if a value is a number
+## 🧩 Why It’s Useful
 
-```ts
-const isNumber: (value: unknown) => boolean;
+This becomes incredibly powerful when your app needs to **sync complex state**
+to a string-based storage layer — like when syncing to **localStorage**, **Redis**, or **a shared dashboard URL**.
+
+Instead of being limited by what JSON can handle,
+you can now serialize **any structure** — Maps, Sets, nested objects, or Dates —
+and restore it back without losing context or meaning.
+
+---
+
+## 🧠 How It Works
+
+Under the hood, `formatToStore` adds small metadata markers to every special value.  
+Each piece of data gets a structure like this:
+
+```json
+{
+  "$t": "map",
+  "$v": [["key", { "$t": "date", "$v": "2024-10-01T10:30:00.000Z" }]]
+}
 ```
 
-## isBoolean
+The `$t` field stores the **type**, and `$v` holds the actual value.  
+When using `formatFromStore`, it reads that metadata and recreates your data structure  
+exactly as it was before — even if it’s deeply nested.
 
-Check if a value is a boolean
+Resulting on:
 
 ```ts
-const isBoolean: (value: unknown) => boolean;
+new Map([['key', new Date('2024-10-01T10:30:00.000Z')]]);
 ```
 
-## isString
+---
+
+## ⚙️ API Reference
 
-Check if a value is a string
+### 🟣 formatToStore
+
+Converts any value into a JSON-safe structure with internal type metadata.
 
 ```ts
-const isString: (value: unknown) => boolean;
+const objectWithMetadata = formatToStore(object);
 ```
 
-## isDate
+### 🔵 formatFromStore<T>
 
-Check if a value is a Date
+Restores the serialized object back to its original types.
 
 ```ts
-const isDate: (value: unknown) => boolean;
+const result = formatFromStore<Map<string, unknown>>(objectWithMetadata);
+```
+
+---
+
+## 🧰 Utility Functions
+
+| Function      | Description                              | Example                       |
+| ------------- | ---------------------------------------- | ----------------------------- |
+| **isNil**     | Checks if value is `null` or `undefined` | `isNil(null); // true`        |
+| **isNumber**  | Checks if value is a number              | `isNumber(42); // true`       |
+| **isBoolean** | Checks if value is a boolean             | `isBoolean(false); // true`   |
+| **isString**  | Checks if value is a string              | `isString('hi'); // true`     |
+| **isDate**    | Checks if value is a Date                | `isDate(new Date()); // true` |
+
+---
+
+## ⚖️ Comparison
+
+| Behavior         | JSON.stringify  | json-storage-formatter |
+| ---------------- | --------------- | ---------------------- |
+| **Date**         | Becomes string  | ✅ Restored as Date    |
+| **Set**          | Lost completely | ✅ Restored as Set     |
+| **Map**          | Lost completely | ✅ Restored as Map     |
+| **Nested types** | Broken          | ✅ Preserved           |
+| **Performance**  | Fast            | ⚡ Nearly identical    |
+
+---
+
+## 📦 Installation
+
+```bash
+npm install json-storage-formatter
 ```
+
+---
+
+## 🎯 Ready to Try It?
+
+📘 **NPM:** [json-storage-formatter](https://www.npmjs.com/package/json-storage-formatter)  
+Serialize, store, and restore **any JavaScript data type** without losing its identity — lightweight, fast, and fully type-safe. ✨

package/bundle.js

@@ -1 +1 @@
-!function(e,r){"object"==typeof exports&&"object"==typeof module?module.exports=r():"function"==typeof define&&define.amd?define([],r):"object"==typeof exports?exports["json-storage-formatter"]=r():e["json-storage-formatter"]=r()}(this,(()=>(()=>{"use strict";var e={333:(e,r,t)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}function o(e,r,t){return(r=function(e){var r=function(e,r){if("object"!=n(e)||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var o=t.call(e,r||"default");if("object"!=n(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(e)}(e,"string");return"symbol"==n(r)?r:r+""}(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function i(e){return function(e){if(Array.isArray(e))return u(e)}(e)||function(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}(e)||function(e,r){if(e){if("string"==typeof e)return u(e,r);var t={}.toString.call(e).slice(8,-1);return"Object"===t&&e.constructor&&(t=e.constructor.name),"Map"===t||"Set"===t?Array.from(e):"Arguments"===t||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t)?u(e,r):void 0}}(e)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function u(e,r){(null==r||r>e.length)&&(r=e.length);for(var t=0,n=Array(r);t<r;t++)n[t]=e[t];return n}Object.defineProperty(r,"__esModule",{value:!0}),r.clone=void 0;var a=t(646),f=t(346),c=t(473);r.clone=function(e){var t=(arguments.length>1&&void 0!==arguments[1]?arguments[1]:{}).shallow;if((0,c.isPrimitive)(e)||(0,a.isDate)(e))return e;if(Array.isArray(e))return t?i(e):e.map((function(e){return(0,r.clone)(e)}));if(e instanceof Map){var n=Array.from(e.entries());return t?new Map(n):new Map(n.map((function(e){return(0,r.clone)(e)})))}if(e instanceof Set){var u=Array.from(e.values());return t?new Set(u):new Set(u.map((function(e){return(0,r.clone)(e)})))}return e instanceof RegExp?new RegExp(e.toString()):(0,f.isFunction)(e)?t?e:Object.create(e):t?Object.assign({},e):e instanceof Error?new Error(e.message):Object.keys(e).reduce((function(t,n){var i=e[n];return Object.assign(Object.assign({},t),o({},n,(0,r.clone)(i)))}),{})}},944:(e,r,t)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}function o(e,r,t){return(r=function(e){var r=function(e,r){if("object"!=n(e)||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var o=t.call(e,r||"default");if("object"!=n(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(e)}(e,"string");return"symbol"==n(r)?r:r+""}(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function i(e,r){return function(e){if(Array.isArray(e))return e}(e)||function(e,r){var t=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=t){var n,o,i,u,a=[],f=!0,c=!1;try{if(i=(t=t.call(e)).next,0===r){if(Object(t)!==t)return;f=!1}else for(;!(f=(n=i.call(t)).done)&&(a.push(n.value),a.length!==r);f=!0);}catch(e){c=!0,o=e}finally{try{if(!f&&null!=t.return&&(u=t.return(),Object(u)!==u))return}finally{if(c)throw o}}return a}}(e,r)||function(e,r){if(e){if("string"==typeof e)return u(e,r);var t={}.toString.call(e).slice(8,-1);return"Object"===t&&e.constructor&&(t=e.constructor.name),"Map"===t||"Set"===t?Array.from(e):"Arguments"===t||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t)?u(e,r):void 0}}(e,r)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function u(e,r){(null==r||r>e.length)&&(r=e.length);for(var t=0,n=Array(r);t<r;t++)n[t]=e[t];return n}Object.defineProperty(r,"__esModule",{value:!0}),r.formatFromStore=void 0;var a=t(333),f=t(346),c=t(473);r.formatFromStore=function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=t.jsonParse,u=t.sortKeys;return function(e){var t,n,a;if((0,c.isPrimitive)(e))return e;if("date"===(null==e?void 0:e.$t))return new Date(e.$v);if("map"===(null==e?void 0:e.$t)){var l=(null!==(t=e.$v)&&void 0!==t?t:[]).map((function(e){var t=i(e,2),n=t[0],o=t[1];return[n,(0,r.formatFromStore)(o)]}));return new Map(l)}if("set"===(null==e?void 0:e.$t)){var s=null!==(n=e.$v)&&void 0!==n?n:[].map((function(e){return(0,r.formatFromStore)(e)}));return new Set(s)}return"regex"===(null==e?void 0:e.$t)?new RegExp(e.$v):"error"===(null==e?void 0:e.$t)?new Error(e.$v):Array.isArray(e)?e.map((function(e){return(0,r.formatFromStore)(e)})):"function"===(null==e?void 0:e.$t)?Function("(".concat(e.$v,")(...arguments)")):(a=Object.keys(e),u?(0,f.isFunction)(u)?a.sort(u):a.sort((function(e,r){return(null!=e?e:"").localeCompare(r)})):a).reduce((function(t,n){var i=e[n];return Object.assign(Object.assign({},t),o({},n,(0,r.formatFromStore)(i)))}),{})}(n?JSON.parse(e):(0,a.clone)(e))}},915:(e,r,t)=>{function n(e,r,t){return(r=function(e){var r=function(e,r){if("object"!=o(e)||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var n=t.call(e,r||"default");if("object"!=o(n))return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(e)}(e,"string");return"symbol"==o(r)?r:r+""}(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function o(e){return o="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},o(e)}Object.defineProperty(r,"__esModule",{value:!0}),r.formatToStore=void 0;var i=t(333),u=t(646),a=t(346),f=t(473),c=t(43);r.formatToStore=function(e){var r=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{stringify:!1},t=r.stringify,l=r.validator,s=r.excludeTypes,m=r.excludeKeys,y=r.sortKeys,v=new Set(null!=s?s:[]),b=new Set(null!=m?m:[]),p=v.size||b.size,d=null!=l?l:function(e){var r=e.key,t=e.value;if(!p)return!0;var n=b.has(r),i=v.has(o(t));return!n&&!i},g=function(e){if((0,f.isPrimitive)(e))return e;var r;if(Array.isArray(e))return e.map((function(e){return g(e)}));if(e instanceof Map)return{$t:"map",$v:Array.from(e.entries()).map((function(e){return g(e)}))};if(e instanceof Set)return{$t:"set",$v:Array.from(e.values()).map((function(e){return g(e)}))};if((0,u.isDate)(e))return{$t:"date",$v:e.toISOString()};if((0,c.isRegex)(e))return{$t:"regex",$v:e.toString()};if((0,a.isFunction)(e)){var t;try{t={$t:"function",$v:e.toString()}}catch(e){t={$t:"error",$v:"Error: Could not serialize function"}}return t}return e instanceof Error?{$t:"error",$v:e.message}:(r=Object.keys(e),y?(0,a.isFunction)(y)?r.sort(y):r.sort((function(e,r){return(null!=e?e:"").localeCompare(r)})):r).reduce((function(r,t){var o=e[t],i=g(o);return d({obj:e,key:t,value:i})?Object.assign(Object.assign({},r),n({},t,g(o))):r}),{})},S=g((0,i.clone)(e));return t?JSON.stringify(S):S}},112:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isBoolean=void 0;r.isBoolean=function(e){return"boolean"==typeof e}},646:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isDate=void 0;r.isDate=function(e){return e instanceof Date}},346:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isFunction=void 0;r.isFunction=function(e){return"function"==typeof e||e instanceof Function}},243:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isNil=void 0;r.isNil=function(e){return null==e}},11:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isNumber=void 0;r.isNumber=function(e){return"number"==typeof e}},473:(e,r,t)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}Object.defineProperty(r,"__esModule",{value:!0}),r.isPrimitive=void 0;var o=t(112),i=t(243),u=t(11),a=t(671);r.isPrimitive=function(e){return(0,i.isNil)(e)||(0,u.isNumber)(e)||(0,o.isBoolean)(e)||(0,a.isString)(e)||"symbol"===n(e)}},43:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isRegex=void 0;r.isRegex=function(e){return e instanceof RegExp}},671:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isString=void 0;r.isString=function(e){return"string"==typeof e}}},r={};function t(n){var o=r[n];if(void 0!==o)return o.exports;var i=r[n]={exports:{}};return e[n](i,i.exports,t),i.exports}var n={};return(()=>{var e=n;Object.defineProperty(e,"__esModule",{value:!0}),e.formatToStore=e.formatFromStore=e.isPrimitive=e.isFunction=e.isRegex=e.isDate=e.isString=e.isBoolean=e.isNumber=e.isNil=e.clone=void 0;var r=t(333);Object.defineProperty(e,"clone",{enumerable:!0,get:function(){return r.clone}});var o=t(243);Object.defineProperty(e,"isNil",{enumerable:!0,get:function(){return o.isNil}});var i=t(11);Object.defineProperty(e,"isNumber",{enumerable:!0,get:function(){return i.isNumber}});var u=t(112);Object.defineProperty(e,"isBoolean",{enumerable:!0,get:function(){return u.isBoolean}});var a=t(671);Object.defineProperty(e,"isString",{enumerable:!0,get:function(){return a.isString}});var f=t(646);Object.defineProperty(e,"isDate",{enumerable:!0,get:function(){return f.isDate}});var c=t(43);Object.defineProperty(e,"isRegex",{enumerable:!0,get:function(){return c.isRegex}});var l=t(346);Object.defineProperty(e,"isFunction",{enumerable:!0,get:function(){return l.isFunction}});var s=t(473);Object.defineProperty(e,"isPrimitive",{enumerable:!0,get:function(){return s.isPrimitive}});var m=t(944);Object.defineProperty(e,"formatFromStore",{enumerable:!0,get:function(){return m.formatFromStore}});var y=t(915);Object.defineProperty(e,"formatToStore",{enumerable:!0,get:function(){return y.formatToStore}})})(),n})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={944:(e,t,r)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}function o(e,t,r){return(t=function(e){var t=function(e,t){if("object"!=n(e)||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var o=r.call(e,t||"default");if("object"!=n(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==n(t)?t:t+""}(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function u(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var r=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=r){var n,o,u,i,f=[],a=!0,l=!1;try{if(u=(r=r.call(e)).next,0===t){if(Object(r)!==r)return;a=!1}else for(;!(a=(n=u.call(r)).done)&&(f.push(n.value),f.length!==t);a=!0);}catch(e){l=!0,o=e}finally{try{if(!a&&null!=r.return&&(i=r.return(),Object(i)!==i))return}finally{if(l)throw o}}return f}}(e,t)||function(e,t){if(e){if("string"==typeof e)return i(e,t);var r={}.toString.call(e).slice(8,-1);return"Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r?Array.from(e):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?i(e,t):void 0}}(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var r=0,n=Array(t);r<t;r++)n[r]=e[r];return n}var f=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var a=f(r(671)),l=f(r(473)),c=function(e){return!(0,l.default)(e)};t.default=function(e){if(!(0,a.default)(e))return e;var t=function(e){var r,n;if(!c(e))return e;if(!("undefined"===(null==e?void 0:e.$t))){if("date"===(null==e?void 0:e.$t))return new Date(e.$v);if("map"===(null==e?void 0:e.$t)){var i=(null!==(r=e.$v)&&void 0!==r?r:[]).map((function(e){var r=u(e,2),n=r[0],o=r[1];return[n,t(o)]}));return new Map(i)}if("set"===(null==e?void 0:e.$t)){var f=(null!==(n=e.$v)&&void 0!==n?n:[]).map((function(e){return t(e)}));return new Set(f)}if("regex"===(null==e?void 0:e.$t)){var a=e.$v;return new RegExp(a.s,a.f)}return"error"===(null==e?void 0:e.$t)?new Error(e.$v):Array.isArray(e)?e.map((function(e){return t(e)})):"function"===(null==e?void 0:e.$t)?Function("(".concat(e.$v,")(...arguments)")):Object.keys(e).reduce((function(r,n){var u=e[n];return Object.assign(Object.assign({},r),o({},n,t(u)))}),{})}};return t(JSON.parse(e))}},915:(e,t,r)=>{function n(e,t,r){return(t=function(e){var t=function(e,t){if("object"!=o(e)||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t||"default");if("object"!=o(n))return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==o(t)?t:t+""}(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e){return o="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},o(e)}var u=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var i=u(r(646)),f=u(r(346)),a=u(r(473)),l=u(r(43));t.default=function(e){var t,r,u,c=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},s=new Set(null!==(t=c.excludeTypes)&&void 0!==t?t:[]),d=new Set(null!==(r=c.excludeKeys)&&void 0!==r?r:[]),y=s.size||d.size,v=null!==(u=c.validator)&&void 0!==u?u:function(e){var t=e.key,r=e.value;if(!y)return!0;var n=d.has(t),u=s.has(o(r));return!n&&!u},b=function(e){if(void 0===e)return{$t:"undefined"};if((0,a.default)(e))return e;var t;if(Array.isArray(e))return e.map((function(e){return b(e)}));if(e instanceof Map)return{$t:"map",$v:Array.from(e.entries()).map((function(e){return b(e)}))};if(e instanceof Set)return{$t:"set",$v:Array.from(e.values()).map((function(e){return b(e)}))};if((0,i.default)(e))return{$t:"date",$v:e.toISOString()};if((0,l.default)(e))return{$t:"regex",$v:{s:e.source,f:e.flags}};if((0,f.default)(e)){var r;try{r={$t:"function",$v:e.toString()}}catch(e){r={$t:"error",$v:"Could not serialize function: ".concat(null==e?void 0:e.message)}}return r}return e instanceof Error?{$t:"error",$v:e.message}:(t=Object.keys(e),c.sortKeys?(0,f.default)(c.sortKeys)?t.sort(c.sortKeys):t.sort((function(e,t){return e.localeCompare(t)})):t).reduce((function(t,r){var o=e[r],u=b(o);return v({obj:e,key:r,value:u})?Object.assign(Object.assign({},t),n({},r,b(o))):t}),{})},m=b(e);return JSON.stringify(m)}},112:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"boolean"==typeof e}},646:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return e instanceof Date}},346:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"function"==typeof e||e instanceof Function}},243:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return null==e}},11:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"number"==typeof e}},473:(e,t,r)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}var o=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var u=o(r(112)),i=o(r(243)),f=o(r(11)),a=o(r(671));t.default=function(e){return(0,i.default)(e)||(0,f.default)(e)||(0,u.default)(e)||(0,a.default)(e)||"symbol"===n(e)}},43:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return e instanceof RegExp}},671:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"string"==typeof e}}},t={};function r(n){var o=t[n];if(void 0!==o)return o.exports;var u=t[n]={exports:{}};return e[n](u,u.exports,r),u.exports}var n={};return(()=>{var e=n,t=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(e,"__esModule",{value:!0}),e.formatToStore=e.formatFromStore=e.isPrimitive=e.isFunction=e.isRegex=e.isDate=e.isString=e.isBoolean=e.isNumber=e.isNil=void 0;var o=r(243);Object.defineProperty(e,"isNil",{enumerable:!0,get:function(){return t(o).default}});var u=r(11);Object.defineProperty(e,"isNumber",{enumerable:!0,get:function(){return t(u).default}});var i=r(112);Object.defineProperty(e,"isBoolean",{enumerable:!0,get:function(){return t(i).default}});var f=r(671);Object.defineProperty(e,"isString",{enumerable:!0,get:function(){return t(f).default}});var a=r(646);Object.defineProperty(e,"isDate",{enumerable:!0,get:function(){return t(a).default}});var l=r(43);Object.defineProperty(e,"isRegex",{enumerable:!0,get:function(){return t(l).default}});var c=r(346);Object.defineProperty(e,"isFunction",{enumerable:!0,get:function(){return t(c).default}});var s=r(473);Object.defineProperty(e,"isPrimitive",{enumerable:!0,get:function(){return t(s).default}});var d=r(944);Object.defineProperty(e,"formatFromStore",{enumerable:!0,get:function(){return t(d).default}});var y=r(915);Object.defineProperty(e,"formatToStore",{enumerable:!0,get:function(){return t(y).default}})})(),n})()));

package/formatFromStore.d.ts

@@ -4,8 +4,5 @@
  * @returns
  * Original form of the value
  */
-export declare const formatFromStore: <T = unknown>(value: unknown, { jsonParse, sortKeys, }?: {
-    /** If the value should be parsed from json before formatting */
-    jsonParse?: boolean;
-    sortKeys?: boolean | ((a: string, b: string) => number);
-}) => T;
+declare const formatFromStore: <T = unknown>(value: string) => T;
+export default formatFromStore;

package/formatFromStore.js

@@ -1 +1 @@
-!function(r,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():r["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var r={333:(r,t,e)=>{function n(r){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(r){return typeof r}:function(r){return r&&"function"==typeof Symbol&&r.constructor===Symbol&&r!==Symbol.prototype?"symbol":typeof r},n(r)}function o(r,t,e){return(t=function(r){var t=function(r,t){if("object"!=n(r)||!r)return r;var e=r[Symbol.toPrimitive];if(void 0!==e){var o=e.call(r,t||"default");if("object"!=n(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(r)}(r,"string");return"symbol"==n(t)?t:t+""}(t))in r?Object.defineProperty(r,t,{value:e,enumerable:!0,configurable:!0,writable:!0}):r[t]=e,r}function i(r){return function(r){if(Array.isArray(r))return u(r)}(r)||function(r){if("undefined"!=typeof Symbol&&null!=r[Symbol.iterator]||null!=r["@@iterator"])return Array.from(r)}(r)||function(r,t){if(r){if("string"==typeof r)return u(r,t);var e={}.toString.call(r).slice(8,-1);return"Object"===e&&r.constructor&&(e=r.constructor.name),"Map"===e||"Set"===e?Array.from(r):"Arguments"===e||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(e)?u(r,t):void 0}}(r)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function u(r,t){(null==t||t>r.length)&&(t=r.length);for(var e=0,n=Array(t);e<t;e++)n[e]=r[e];return n}Object.defineProperty(t,"__esModule",{value:!0}),t.clone=void 0;var a=e(646),f=e(346),l=e(473);t.clone=function(r){var e=(arguments.length>1&&void 0!==arguments[1]?arguments[1]:{}).shallow;if((0,l.isPrimitive)(r)||(0,a.isDate)(r))return r;if(Array.isArray(r))return e?i(r):r.map((function(r){return(0,t.clone)(r)}));if(r instanceof Map){var n=Array.from(r.entries());return e?new Map(n):new Map(n.map((function(r){return(0,t.clone)(r)})))}if(r instanceof Set){var u=Array.from(r.values());return e?new Set(u):new Set(u.map((function(r){return(0,t.clone)(r)})))}return r instanceof RegExp?new RegExp(r.toString()):(0,f.isFunction)(r)?e?r:Object.create(r):e?Object.assign({},r):r instanceof Error?new Error(r.message):Object.keys(r).reduce((function(e,n){var i=r[n];return Object.assign(Object.assign({},e),o({},n,(0,t.clone)(i)))}),{})}},944:(r,t,e)=>{function n(r){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(r){return typeof r}:function(r){return r&&"function"==typeof Symbol&&r.constructor===Symbol&&r!==Symbol.prototype?"symbol":typeof r},n(r)}function o(r,t,e){return(t=function(r){var t=function(r,t){if("object"!=n(r)||!r)return r;var e=r[Symbol.toPrimitive];if(void 0!==e){var o=e.call(r,t||"default");if("object"!=n(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(r)}(r,"string");return"symbol"==n(t)?t:t+""}(t))in r?Object.defineProperty(r,t,{value:e,enumerable:!0,configurable:!0,writable:!0}):r[t]=e,r}function i(r,t){return function(r){if(Array.isArray(r))return r}(r)||function(r,t){var e=null==r?null:"undefined"!=typeof Symbol&&r[Symbol.iterator]||r["@@iterator"];if(null!=e){var n,o,i,u,a=[],f=!0,l=!1;try{if(i=(e=e.call(r)).next,0===t){if(Object(e)!==e)return;f=!1}else for(;!(f=(n=i.call(e)).done)&&(a.push(n.value),a.length!==t);f=!0);}catch(r){l=!0,o=r}finally{try{if(!f&&null!=e.return&&(u=e.return(),Object(u)!==u))return}finally{if(l)throw o}}return a}}(r,t)||function(r,t){if(r){if("string"==typeof r)return u(r,t);var e={}.toString.call(r).slice(8,-1);return"Object"===e&&r.constructor&&(e=r.constructor.name),"Map"===e||"Set"===e?Array.from(r):"Arguments"===e||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(e)?u(r,t):void 0}}(r,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function u(r,t){(null==t||t>r.length)&&(t=r.length);for(var e=0,n=Array(t);e<t;e++)n[e]=r[e];return n}Object.defineProperty(t,"__esModule",{value:!0}),t.formatFromStore=void 0;var a=e(333),f=e(346),l=e(473);t.formatFromStore=function(r){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=e.jsonParse,u=e.sortKeys;return function(r){var e,n,a;if((0,l.isPrimitive)(r))return r;if("date"===(null==r?void 0:r.$t))return new Date(r.$v);if("map"===(null==r?void 0:r.$t)){var c=(null!==(e=r.$v)&&void 0!==e?e:[]).map((function(r){var e=i(r,2),n=e[0],o=e[1];return[n,(0,t.formatFromStore)(o)]}));return new Map(c)}if("set"===(null==r?void 0:r.$t)){var s=null!==(n=r.$v)&&void 0!==n?n:[].map((function(r){return(0,t.formatFromStore)(r)}));return new Set(s)}return"regex"===(null==r?void 0:r.$t)?new RegExp(r.$v):"error"===(null==r?void 0:r.$t)?new Error(r.$v):Array.isArray(r)?r.map((function(r){return(0,t.formatFromStore)(r)})):"function"===(null==r?void 0:r.$t)?Function("(".concat(r.$v,")(...arguments)")):(a=Object.keys(r),u?(0,f.isFunction)(u)?a.sort(u):a.sort((function(r,t){return(null!=r?r:"").localeCompare(t)})):a).reduce((function(e,n){var i=r[n];return Object.assign(Object.assign({},e),o({},n,(0,t.formatFromStore)(i)))}),{})}(n?JSON.parse(r):(0,a.clone)(r))}},112:(r,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isBoolean=void 0;t.isBoolean=function(r){return"boolean"==typeof r}},646:(r,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isDate=void 0;t.isDate=function(r){return r instanceof Date}},346:(r,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isFunction=void 0;t.isFunction=function(r){return"function"==typeof r||r instanceof Function}},243:(r,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isNil=void 0;t.isNil=function(r){return null==r}},11:(r,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isNumber=void 0;t.isNumber=function(r){return"number"==typeof r}},473:(r,t,e)=>{function n(r){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(r){return typeof r}:function(r){return r&&"function"==typeof Symbol&&r.constructor===Symbol&&r!==Symbol.prototype?"symbol":typeof r},n(r)}Object.defineProperty(t,"__esModule",{value:!0}),t.isPrimitive=void 0;var o=e(112),i=e(243),u=e(11),a=e(671);t.isPrimitive=function(r){return(0,i.isNil)(r)||(0,u.isNumber)(r)||(0,o.isBoolean)(r)||(0,a.isString)(r)||"symbol"===n(r)}},671:(r,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isString=void 0;t.isString=function(r){return"string"==typeof r}}},t={};var e=function e(n){var o=t[n];if(void 0!==o)return o.exports;var i=t[n]={exports:{}};return r[n](i,i.exports,e),i.exports}(944);return e})()));
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports["json-storage-formatter"]=e():t["json-storage-formatter"]=e()}(this,(()=>(()=>{"use strict";var t={112:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0});e.default=function(t){return"boolean"==typeof t}},243:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0});e.default=function(t){return null==t}},11:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0});e.default=function(t){return"number"==typeof t}},473:(t,e,r)=>{function n(t){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},n(t)}var o=function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(e,"__esModule",{value:!0});var u=o(r(112)),i=o(r(243)),f=o(r(11)),l=o(r(671));e.default=function(t){return(0,i.default)(t)||(0,f.default)(t)||(0,u.default)(t)||(0,l.default)(t)||"symbol"===n(t)}},671:(t,e)=>{Object.defineProperty(e,"__esModule",{value:!0});e.default=function(t){return"string"==typeof t}}},e={};function r(n){var o=e[n];if(void 0!==o)return o.exports;var u=e[n]={exports:{}};return t[n](u,u.exports,r),u.exports}var n={};return(()=>{var t=n;function e(t){return e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},e(t)}function o(t,r,n){return(r=function(t){var r=function(t,r){if("object"!=e(t)||!t)return t;var n=t[Symbol.toPrimitive];if(void 0!==n){var o=n.call(t,r||"default");if("object"!=e(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}(t,"string");return"symbol"==e(r)?r:r+""}(r))in t?Object.defineProperty(t,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[r]=n,t}function u(t,e){return function(t){if(Array.isArray(t))return t}(t)||function(t,e){var r=null==t?null:"undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(null!=r){var n,o,u,i,f=[],l=!0,a=!1;try{if(u=(r=r.call(t)).next,0===e){if(Object(r)!==r)return;l=!1}else for(;!(l=(n=u.call(r)).done)&&(f.push(n.value),f.length!==e);l=!0);}catch(t){a=!0,o=t}finally{try{if(!l&&null!=r.return&&(i=r.return(),Object(i)!==i))return}finally{if(a)throw o}}return f}}(t,e)||function(t,e){if(t){if("string"==typeof t)return i(t,e);var r={}.toString.call(t).slice(8,-1);return"Object"===r&&t.constructor&&(r=t.constructor.name),"Map"===r||"Set"===r?Array.from(t):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?i(t,e):void 0}}(t,e)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function i(t,e){(null==e||e>t.length)&&(e=t.length);for(var r=0,n=Array(e);r<e;r++)n[r]=t[r];return n}var f=function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(t,"__esModule",{value:!0});var l=f(r(671)),a=f(r(473)),c=function(t){return!(0,a.default)(t)};t.default=function(t){if(!(0,l.default)(t))return t;var e=function(t){var r,n;if(!c(t))return t;if(!("undefined"===(null==t?void 0:t.$t))){if("date"===(null==t?void 0:t.$t))return new Date(t.$v);if("map"===(null==t?void 0:t.$t)){var i=(null!==(r=t.$v)&&void 0!==r?r:[]).map((function(t){var r=u(t,2),n=r[0],o=r[1];return[n,e(o)]}));return new Map(i)}if("set"===(null==t?void 0:t.$t)){var f=(null!==(n=t.$v)&&void 0!==n?n:[]).map((function(t){return e(t)}));return new Set(f)}if("regex"===(null==t?void 0:t.$t)){var l=t.$v;return new RegExp(l.s,l.f)}return"error"===(null==t?void 0:t.$t)?new Error(t.$v):Array.isArray(t)?t.map((function(t){return e(t)})):"function"===(null==t?void 0:t.$t)?Function("(".concat(t.$v,")(...arguments)")):Object.keys(t).reduce((function(r,n){var u=t[n];return Object.assign(Object.assign({},r),o({},n,e(u)))}),{})}};return e(JSON.parse(t))}})(),n})()));

package/formatToStore.d.ts

@@ -1,24 +1,39 @@
-import { TPrimitives } from "./types";
+import type { Primitives } from './types';
 /**
- * Add metadata to a value to store it as json, it also supports Map, Set, Arrays,
- * Returns a new object which is a clone of the original object with metadata
- * @template {TValue} The type of the value to format
- * @template {TStringify} If the value should be stringified
- * @param {TValue} value The value to format
- * @param {{ stringify: TStringify }} { stringify: boolean } If the value should be stringified
+ * Formats an object to be stored, it adds metadata to preserve data types
+ * Compatible with Map, Set, Date, RegExp, Function, Error
+ * * @param value The value to format
+ * @param options Formatting options
+ * @param options.excludeTypes An array or set of primitive types to exclude from the stringified version
+ * @param options.excludeKeys An array or set of keys to exclude from the stringified version
+ * @param options.sortKeys If true, it will sort the keys of the object alphabetically, or a function to sort the keys,
+ * This helps to guarantee a consistent order of the keys in the stringified version
+ * @param options.validator Returns true if the value should be included in the stringified version,
+ * if provided it will override the default validator and the excludesTypes and excludeKeys
+ * @returns A stringified version of the object with metadata
  */
-export declare const formatToStore: <TValue, TStringify extends boolean = false>(value: TValue, { stringify, validator, excludeTypes, excludeKeys, sortKeys, }?: {
-    stringify?: TStringify;
-    excludeTypes?: TPrimitives[] | Set<TPrimitives>;
+declare const formatToStore: <T>(value: T, options?: {
+    /**
+     * If true, it will return a stringified version of the object
+     */
+    excludeTypes?: Primitives[] | Set<Primitives>;
+    /**
+     * An array or set of keys to exclude from the stringified version
+     */
     excludeKeys?: string[] | Set<string>;
+    /**
+     * If true, it will sort the keys of the object alphabetically, or a function to sort the keys,
+     * This helps to guarantee a consistent order of the keys in the stringified version
+     */
     sortKeys?: boolean | ((a: string, b: string) => number);
     /**
      * Returns true if the value should be included in the stringified version,
      * if provided it will override the default validator and the excludesTypes and excludeKeys
      */
-    validator?: ({ obj, key, value, }: {
+    validator?: ({ obj, key, value }: {
         obj: unknown;
         key: string;
         value: unknown;
     }) => boolean | undefined;
-}) => TStringify extends true ? string : unknown;
+}) => string;
+export default formatToStore;

package/formatToStore.js

@@ -1 +1 @@
-!function(e,r){"object"==typeof exports&&"object"==typeof module?module.exports=r():"function"==typeof define&&define.amd?define([],r):"object"==typeof exports?exports["json-storage-formatter"]=r():e["json-storage-formatter"]=r()}(this,(()=>(()=>{"use strict";var e={333:(e,r,t)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}function o(e,r,t){return(r=function(e){var r=function(e,r){if("object"!=n(e)||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var o=t.call(e,r||"default");if("object"!=n(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(e)}(e,"string");return"symbol"==n(r)?r:r+""}(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function i(e){return function(e){if(Array.isArray(e))return u(e)}(e)||function(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}(e)||function(e,r){if(e){if("string"==typeof e)return u(e,r);var t={}.toString.call(e).slice(8,-1);return"Object"===t&&e.constructor&&(t=e.constructor.name),"Map"===t||"Set"===t?Array.from(e):"Arguments"===t||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t)?u(e,r):void 0}}(e)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function u(e,r){(null==r||r>e.length)&&(r=e.length);for(var t=0,n=Array(r);t<r;t++)n[t]=e[t];return n}Object.defineProperty(r,"__esModule",{value:!0}),r.clone=void 0;var f=t(646),a=t(346),c=t(473);r.clone=function(e){var t=(arguments.length>1&&void 0!==arguments[1]?arguments[1]:{}).shallow;if((0,c.isPrimitive)(e)||(0,f.isDate)(e))return e;if(Array.isArray(e))return t?i(e):e.map((function(e){return(0,r.clone)(e)}));if(e instanceof Map){var n=Array.from(e.entries());return t?new Map(n):new Map(n.map((function(e){return(0,r.clone)(e)})))}if(e instanceof Set){var u=Array.from(e.values());return t?new Set(u):new Set(u.map((function(e){return(0,r.clone)(e)})))}return e instanceof RegExp?new RegExp(e.toString()):(0,a.isFunction)(e)?t?e:Object.create(e):t?Object.assign({},e):e instanceof Error?new Error(e.message):Object.keys(e).reduce((function(t,n){var i=e[n];return Object.assign(Object.assign({},t),o({},n,(0,r.clone)(i)))}),{})}},112:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isBoolean=void 0;r.isBoolean=function(e){return"boolean"==typeof e}},646:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isDate=void 0;r.isDate=function(e){return e instanceof Date}},346:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isFunction=void 0;r.isFunction=function(e){return"function"==typeof e||e instanceof Function}},243:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isNil=void 0;r.isNil=function(e){return null==e}},11:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isNumber=void 0;r.isNumber=function(e){return"number"==typeof e}},473:(e,r,t)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}Object.defineProperty(r,"__esModule",{value:!0}),r.isPrimitive=void 0;var o=t(112),i=t(243),u=t(11),f=t(671);r.isPrimitive=function(e){return(0,i.isNil)(e)||(0,u.isNumber)(e)||(0,o.isBoolean)(e)||(0,f.isString)(e)||"symbol"===n(e)}},43:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isRegex=void 0;r.isRegex=function(e){return e instanceof RegExp}},671:(e,r)=>{Object.defineProperty(r,"__esModule",{value:!0}),r.isString=void 0;r.isString=function(e){return"string"==typeof e}}},r={};function t(n){var o=r[n];if(void 0!==o)return o.exports;var i=r[n]={exports:{}};return e[n](i,i.exports,t),i.exports}var n={};return(()=>{var e=n;function r(e,r,t){return(r=function(e){var r=function(e,r){if("object"!=o(e)||!e)return e;var t=e[Symbol.toPrimitive];if(void 0!==t){var n=t.call(e,r||"default");if("object"!=o(n))return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(e)}(e,"string");return"symbol"==o(r)?r:r+""}(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function o(e){return o="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},o(e)}Object.defineProperty(e,"__esModule",{value:!0}),e.formatToStore=void 0;var i=t(333),u=t(646),f=t(346),a=t(473),c=t(43);e.formatToStore=function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{stringify:!1},n=t.stringify,s=t.validator,l=t.excludeTypes,y=t.excludeKeys,v=t.sortKeys,m=new Set(null!=l?l:[]),p=new Set(null!=y?y:[]),b=m.size||p.size,d=null!=s?s:function(e){var r=e.key,t=e.value;if(!b)return!0;var n=p.has(r),i=m.has(o(t));return!n&&!i},g=function(e){if((0,a.isPrimitive)(e))return e;var t;if(Array.isArray(e))return e.map((function(e){return g(e)}));if(e instanceof Map)return{$t:"map",$v:Array.from(e.entries()).map((function(e){return g(e)}))};if(e instanceof Set)return{$t:"set",$v:Array.from(e.values()).map((function(e){return g(e)}))};if((0,u.isDate)(e))return{$t:"date",$v:e.toISOString()};if((0,c.isRegex)(e))return{$t:"regex",$v:e.toString()};if((0,f.isFunction)(e)){var n;try{n={$t:"function",$v:e.toString()}}catch(e){n={$t:"error",$v:"Error: Could not serialize function"}}return n}return e instanceof Error?{$t:"error",$v:e.message}:(t=Object.keys(e),v?(0,f.isFunction)(v)?t.sort(v):t.sort((function(e,r){return(null!=e?e:"").localeCompare(r)})):t).reduce((function(t,n){var o=e[n],i=g(o);return d({obj:e,key:n,value:i})?Object.assign(Object.assign({},t),r({},n,g(o))):t}),{})},S=g((0,i.clone)(e));return n?JSON.stringify(S):S}})(),n})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={112:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"boolean"==typeof e}},646:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return e instanceof Date}},346:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"function"==typeof e||e instanceof Function}},243:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return null==e}},11:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"number"==typeof e}},473:(e,t,r)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}var o=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var u=o(r(112)),f=o(r(243)),i=o(r(11)),a=o(r(671));t.default=function(e){return(0,f.default)(e)||(0,i.default)(e)||(0,u.default)(e)||(0,a.default)(e)||"symbol"===n(e)}},43:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return e instanceof RegExp}},671:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"string"==typeof e}}},t={};function r(n){var o=t[n];if(void 0!==o)return o.exports;var u=t[n]={exports:{}};return e[n](u,u.exports,r),u.exports}var n={};return(()=>{var e=n;function t(e,t,r){return(t=function(e){var t=function(e,t){if("object"!=o(e)||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t||"default");if("object"!=o(n))return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==o(t)?t:t+""}(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e){return o="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},o(e)}var u=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(e,"__esModule",{value:!0});var f=u(r(646)),i=u(r(346)),a=u(r(473)),l=u(r(43));e.default=function(e){var r,n,u,c=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},s=new Set(null!==(r=c.excludeTypes)&&void 0!==r?r:[]),d=new Set(null!==(n=c.excludeKeys)&&void 0!==n?n:[]),y=s.size||d.size,v=null!==(u=c.validator)&&void 0!==u?u:function(e){var t=e.key,r=e.value;if(!y)return!0;var n=d.has(t),u=s.has(o(r));return!n&&!u},p=function(e){if(void 0===e)return{$t:"undefined"};if((0,a.default)(e))return e;var r;if(Array.isArray(e))return e.map((function(e){return p(e)}));if(e instanceof Map)return{$t:"map",$v:Array.from(e.entries()).map((function(e){return p(e)}))};if(e instanceof Set)return{$t:"set",$v:Array.from(e.values()).map((function(e){return p(e)}))};if((0,f.default)(e))return{$t:"date",$v:e.toISOString()};if((0,l.default)(e))return{$t:"regex",$v:{s:e.source,f:e.flags}};if((0,i.default)(e)){var n;try{n={$t:"function",$v:e.toString()}}catch(e){n={$t:"error",$v:"Could not serialize function: ".concat(null==e?void 0:e.message)}}return n}return e instanceof Error?{$t:"error",$v:e.message}:(r=Object.keys(e),c.sortKeys?(0,i.default)(c.sortKeys)?r.sort(c.sortKeys):r.sort((function(e,t){return e.localeCompare(t)})):r).reduce((function(r,n){var o=e[n],u=p(o);return v({obj:e,key:n,value:u})?Object.assign(Object.assign({},r),t({},n,p(o))):r}),{})},b=p(e);return JSON.stringify(b)}})(),n})()));

package/index.d.ts

@@ -1,12 +1,11 @@
-export { clone } from "./clone";
-export { isNil } from "./isNil";
-export { isNumber } from "./isNumber";
-export { isBoolean } from "./isBoolean";
-export { isString } from "./isString";
-export { isDate } from "./isDate";
-export { isRegex } from "./isRegex";
-export { isFunction } from "./isFunction";
-export { isPrimitive } from "./isPrimitive";
-export { TPrimitives, IValueWithMetaData } from "./types";
-export { formatFromStore } from "./formatFromStore";
-export { formatToStore } from "./formatToStore";
+export { default as isNil } from './isNil';
+export { default as isNumber } from './isNumber';
+export { default as isBoolean } from './isBoolean';
+export { default as isString } from './isString';
+export { default as isDate } from './isDate';
+export { default as isRegex } from './isRegex';
+export { default as isFunction } from './isFunction';
+export { default as isPrimitive } from './isPrimitive';
+export { default as formatFromStore } from './formatFromStore';
+export { default as formatToStore } from './formatToStore';
+export type { Primitives, EnvelopData } from './types';

package/isBoolean.d.ts

@@ -5,4 +5,5 @@
  * true if the value is a boolean
  * false otherwise
  * */
-export declare const isBoolean: (value: unknown) => value is boolean;
+declare const isBoolean: (value: unknown) => value is boolean;
+export default isBoolean;

package/isBoolean.js

@@ -1 +1 @@
-!function(e,o){"object"==typeof exports&&"object"==typeof module?module.exports=o():"function"==typeof define&&define.amd?define([],o):"object"==typeof exports?exports["json-storage-formatter"]=o():e["json-storage-formatter"]=o()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var o=e;Object.defineProperty(o,"__esModule",{value:!0}),o.isBoolean=void 0;o.isBoolean=function(e){return"boolean"==typeof e}})(),e})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"boolean"==typeof e}})(),e})()));

package/isDate.d.ts

@@ -4,4 +4,5 @@
  * true if the value is a Date
  * false otherwise
  */
-export declare const isDate: (value: unknown) => value is Date;
+declare const isDate: (value: unknown) => value is Date;
+export default isDate;

package/isDate.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0}),t.isDate=void 0;t.isDate=function(e){return e instanceof Date}})(),e})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return e instanceof Date}})(),e})()));

package/isFunction.d.ts

@@ -3,4 +3,5 @@
  * @param value The value to check
  * @returns true if the value is a function, false otherwise
  * */
-export declare const isFunction: <T extends (...args: any[]) => any>(value: unknown) => value is NonNullable<T>;
+declare const isFunction: <T extends (...args: any[]) => any>(value: unknown) => value is NonNullable<T>;
+export default isFunction;

package/isFunction.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0}),t.isFunction=void 0;t.isFunction=function(e){return"function"==typeof e||e instanceof Function}})(),e})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"function"==typeof e||e instanceof Function}})(),e})()));

package/isNil.d.ts

@@ -5,4 +5,5 @@
  * true if the value is null or undefined
  * false otherwise
  * */
-export declare const isNil: (value: unknown) => value is null | undefined;
+declare const isNil: (value: unknown) => value is null | undefined;
+export default isNil;

package/isNil.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0}),t.isNil=void 0;t.isNil=function(e){return null==e}})(),e})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return null==e}})(),e})()));

package/isNumber.d.ts

@@ -5,4 +5,5 @@
  *  true if the value is a number
  * false otherwise
  *  */
-export declare const isNumber: (value: unknown) => value is number;
+declare const isNumber: (value: unknown) => value is number;
+export default isNumber;

package/isNumber.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0}),t.isNumber=void 0;t.isNumber=function(e){return"number"==typeof e}})(),e})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"number"==typeof e}})(),e})()));

package/isPrimitive.d.ts

@@ -6,4 +6,5 @@
  * false otherwise
  * null, number, boolean, string, symbol
  */
-export declare const isPrimitive: (value: unknown) => value is string | number | boolean | symbol;
+declare const isPrimitive: (value: unknown) => value is string | number | boolean | symbol;
+export default isPrimitive;

package/isPrimitive.js

@@ -1 +1 @@
-!function(e,o){"object"==typeof exports&&"object"==typeof module?module.exports=o():"function"==typeof define&&define.amd?define([],o):"object"==typeof exports?exports["json-storage-formatter"]=o():e["json-storage-formatter"]=o()}(this,(()=>(()=>{"use strict";var e={112:(e,o)=>{Object.defineProperty(o,"__esModule",{value:!0}),o.isBoolean=void 0;o.isBoolean=function(e){return"boolean"==typeof e}},243:(e,o)=>{Object.defineProperty(o,"__esModule",{value:!0}),o.isNil=void 0;o.isNil=function(e){return null==e}},11:(e,o)=>{Object.defineProperty(o,"__esModule",{value:!0}),o.isNumber=void 0;o.isNumber=function(e){return"number"==typeof e}},671:(e,o)=>{Object.defineProperty(o,"__esModule",{value:!0}),o.isString=void 0;o.isString=function(e){return"string"==typeof e}}},o={};function t(r){var i=o[r];if(void 0!==i)return i.exports;var n=o[r]={exports:{}};return e[r](n,n.exports,t),n.exports}var r={};return(()=>{var e=r;function o(e){return o="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},o(e)}Object.defineProperty(e,"__esModule",{value:!0}),e.isPrimitive=void 0;var i=t(112),n=t(243),u=t(11),s=t(671);e.isPrimitive=function(e){return(0,n.isNil)(e)||(0,u.isNumber)(e)||(0,i.isBoolean)(e)||(0,s.isString)(e)||"symbol"===o(e)}})(),r})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={112:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"boolean"==typeof e}},243:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return null==e}},11:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"number"==typeof e}},671:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"string"==typeof e}}},t={};function o(r){var n=t[r];if(void 0!==n)return n.exports;var u=t[r]={exports:{}};return e[r](u,u.exports,o),u.exports}var r={};return(()=>{var e=r;function t(e){return t="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},t(e)}var n=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(e,"__esModule",{value:!0});var u=n(o(112)),f=n(o(243)),l=n(o(11)),a=n(o(671));e.default=function(e){return(0,f.default)(e)||(0,l.default)(e)||(0,u.default)(e)||(0,a.default)(e)||"symbol"===t(e)}})(),r})()));

package/isRegex.d.ts

@@ -3,4 +3,5 @@
  * @param value The value to check
  * @returns true if the value is a RegExp, false otherwise
  * */
-export declare const isRegex: (value: unknown) => value is RegExp;
+declare const isRegex: (value: unknown) => value is RegExp;
+export default isRegex;

package/isRegex.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0}),t.isRegex=void 0;t.isRegex=function(e){return e instanceof RegExp}})(),e})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return e instanceof RegExp}})(),e})()));

package/isString.d.ts

@@ -5,4 +5,5 @@
  * true if the value is a string
  * false otherwise
  * */
-export declare const isString: (value: unknown) => value is string;
+declare const isString: (value: unknown) => value is string;
+export default isString;

package/isString.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0}),t.isString=void 0;t.isString=function(e){return"string"==typeof e}})(),e})()));
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={};return(()=>{var t=e;Object.defineProperty(t,"__esModule",{value:!0});t.default=function(e){return"string"==typeof e}})(),e})()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-storage-formatter",
-  "version": "2.0.9",
+  "version": "3.0.1",
   "description": "Package for json stringify objects without losing data types",
   "main": "./bundle.js",
   "types": "./index.d.ts",
@@ -11,11 +11,6 @@
       "require": "./bundle.js",
       "types": "./index.d.ts"
     },
-    "./clone": {
-      "import": "./clone.js",
-      "require": "./clone.js",
-      "types": "./clone.d.ts"
-    },
     "./isNil": {
       "import": "./isNil.js",
       "require": "./isNil.js",
@@ -72,14 +67,20 @@
     "./*.d.ts"
   ],
   "scripts": {
+    "format": "prettier --write .  --log-level silent && yarn lint:fix",
+    "test": "yarn build && yarn jest",
+    "test:debug:no-watch": "node --inspect-brk node_modules/.bin/jest --no-watchman --runInBand",
     "test:debug": "node --inspect-brk node_modules/.bin/jest --watch --runInBand",
-    "test:quick": "jest --maxWorkers=4 -c --no-watchman -u",
-    "test:coverage": "jest --maxWorkers=4 -c --colors --no-watchman --verbose --coverage",
-    "build": "webpack --config webpack.config.js",
-    "prepare": "npm run build",
-    "version": "npm run format && git add -A src",
+    "test:quick": "yarn test --no-coverage --maxWorkers=4 -c --no-watchman -u",
+    "test:coverage": "yarn test --maxWorkers=4 -c --colors --no-watchman --verbose --coverage",
+    "build": "yarn ts-check && yarn clean && webpack --config webpack.config.js",
+    "prepare": "yarn format && npm run build && yarn test:quick",
+    "version": "npm run format && yarn build && yarn jest && git add -A",
     "postversion": "git push && git push --tags",
-    "clean": "find . -maxdepth 1 -type f \\( -name '*.js' -o -name '*.d.ts' \\) ! -name 'webpack.config.js' -exec rm {} +"
+    "lint": "eslint . --max-warnings=0",
+    "lint:fix": "eslint . --fix --max-warnings=0",
+    "clean": "find . -maxdepth 1 -type f \\( -name '*.js' -o -name '*.d.ts' \\) ! -name 'webpack.config.js' ! -name 'eslint.config.mts' -exec rm {} +",
+    "ts-check": "tsc -p tsconfig.json --noEmit"
   },
   "repository": {
     "type": "git",
@@ -106,13 +107,25 @@
     "@babel/plugin-transform-modules-commonjs": "^7.21.2",
     "@babel/preset-env": "^7.20.2",
     "@babel/preset-typescript": "^7.21.0",
+    "@eslint/js": "^9.39.1",
     "@types/jest": "^26.0.17",
     "@types/lodash": "^4.14.165",
+    "@typescript-eslint/eslint-plugin": "^4.9.1",
+    "@typescript-eslint/parser": "^4.9.1",
     "babel-loader": "^9.1.2",
+    "eslint": "^9.39.1",
+    "eslint-config-airbnb": "^18.2.1",
+    "eslint-plugin-import": "^2.22.1",
+    "eslint-plugin-jsx-a11y": "^6.4.1",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^4.2.0",
     "jest": "^29.3.1",
+    "jiti": "^2.6.1",
+    "prettier": "^3.6.2",
     "ts-jest": "^29.0.3",
     "ts-loader": "^9.4.2",
     "typescript": "^4.1.2",
+    "typescript-eslint": "^8.46.3",
     "webpack": "^5.76.3",
     "webpack-cli": "^5.0.1"
   }

package/types.d.ts

@@ -1,5 +1,5 @@
-export type IValueWithMetaData = {
-    $t?: 'map' | 'set' | 'date' | 'regex' | 'error' | 'function';
-    $v?: unknown;
+export type EnvelopData = {
+    $t: 'map' | 'set' | 'date' | 'regex' | 'error' | 'function' | 'undefined';
+    $v: unknown;
 };
-export type TPrimitives = 'string' | 'number' | 'bigint' | 'boolean' | 'symbol' | 'undefined' | 'function' | 'object';
+export type Primitives = 'string' | 'number' | 'bigint' | 'boolean' | 'symbol' | 'undefined' | 'function' | 'object';

package/webpack.config.js

@@ -4,22 +4,21 @@ const TerserPlugin = require('terser-webpack-plugin');
 module.exports = {
   mode: 'production',
   entry: {
-    bundle: "./src/index.ts",
-    clone: "./src/clone.ts",
-    isNil: "./src/isNil.ts",
-    isNumber: "./src/isNumber.ts",
-    isBoolean: "./src/isBoolean.ts",
-    isString: "./src/isString.ts",
-    isDate: "./src/isDate.ts",
-    isRegex: "./src/isRegex.ts",
-    isFunction: "./src/isFunction.ts",
-    isPrimitive: "./src/isPrimitive.ts",
-    types: "./src/types.ts",
-    formatFromStore: "./src/formatFromStore.ts",
-    formatToStore: "./src/formatToStore.ts",
+    bundle: './src/index.ts',
+    isNil: './src/isNil.ts',
+    isNumber: './src/isNumber.ts',
+    isBoolean: './src/isBoolean.ts',
+    isString: './src/isString.ts',
+    isDate: './src/isDate.ts',
+    isRegex: './src/isRegex.ts',
+    isFunction: './src/isFunction.ts',
+    isPrimitive: './src/isPrimitive.ts',
+    types: './src/types.ts',
+    formatFromStore: './src/formatFromStore.ts',
+    formatToStore: './src/formatToStore.ts',
   },
   output: {
-    path: path.resolve(__dirname),//'lib'
+    path: path.resolve(__dirname), //'lib'
     filename: ({ chunk: { name } }) => {
       if (name.includes('worker')) {
         return `${name}.worker.js`;
@@ -34,10 +33,7 @@ module.exports = {
   resolve: {
     extensions: ['.ts', '.js'],
     alias: {
-      'json-storage-formatter': path.resolve(
-        __dirname,
-        'node_modules/json-storage-formatter/package.json'
-      ),
+      'json-storage-formatter': path.resolve(__dirname, 'node_modules/json-storage-formatter/package.json'),
     },
   },
   module: {
@@ -76,5 +72,5 @@ module.exports = {
         },
       }),
     ],
-  }
+  },
 };

package/clone.d.ts

@@ -1,12 +0,0 @@
-/**
- * Deep clone an object, it also support Map, Set, Arrays
- * @param value
- * @returns
- * A deep clone of the object
- * */
-export declare const clone: <T>(value: T, { shallow, }?: {
-    /**
-     * If true, it will only clone the first level of the object
-     */
-    shallow?: boolean;
-}) => T;

package/clone.js

@@ -1 +0,0 @@
-!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["json-storage-formatter"]=t():e["json-storage-formatter"]=t()}(this,(()=>(()=>{"use strict";var e={333:(e,t,r)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}function o(e,t,r){return(t=function(e){var t=function(e,t){if("object"!=n(e)||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var o=r.call(e,t||"default");if("object"!=n(o))return o;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==n(t)?t:t+""}(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e){return function(e){if(Array.isArray(e))return u(e)}(e)||function(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}(e)||function(e,t){if(e){if("string"==typeof e)return u(e,t);var r={}.toString.call(e).slice(8,-1);return"Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r?Array.from(e):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?u(e,t):void 0}}(e)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function u(e,t){(null==t||t>e.length)&&(t=e.length);for(var r=0,n=Array(t);r<t;r++)n[r]=e[r];return n}Object.defineProperty(t,"__esModule",{value:!0}),t.clone=void 0;var f=r(646),a=r(346),c=r(473);t.clone=function(e){var r=(arguments.length>1&&void 0!==arguments[1]?arguments[1]:{}).shallow;if((0,c.isPrimitive)(e)||(0,f.isDate)(e))return e;if(Array.isArray(e))return r?i(e):e.map((function(e){return(0,t.clone)(e)}));if(e instanceof Map){var n=Array.from(e.entries());return r?new Map(n):new Map(n.map((function(e){return(0,t.clone)(e)})))}if(e instanceof Set){var u=Array.from(e.values());return r?new Set(u):new Set(u.map((function(e){return(0,t.clone)(e)})))}return e instanceof RegExp?new RegExp(e.toString()):(0,a.isFunction)(e)?r?e:Object.create(e):r?Object.assign({},e):e instanceof Error?new Error(e.message):Object.keys(e).reduce((function(r,n){var i=e[n];return Object.assign(Object.assign({},r),o({},n,(0,t.clone)(i)))}),{})}},112:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isBoolean=void 0;t.isBoolean=function(e){return"boolean"==typeof e}},646:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isDate=void 0;t.isDate=function(e){return e instanceof Date}},346:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isFunction=void 0;t.isFunction=function(e){return"function"==typeof e||e instanceof Function}},243:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isNil=void 0;t.isNil=function(e){return null==e}},11:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isNumber=void 0;t.isNumber=function(e){return"number"==typeof e}},473:(e,t,r)=>{function n(e){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},n(e)}Object.defineProperty(t,"__esModule",{value:!0}),t.isPrimitive=void 0;var o=r(112),i=r(243),u=r(11),f=r(671);t.isPrimitive=function(e){return(0,i.isNil)(e)||(0,u.isNumber)(e)||(0,o.isBoolean)(e)||(0,f.isString)(e)||"symbol"===n(e)}},671:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isString=void 0;t.isString=function(e){return"string"==typeof e}}},t={};var r=function r(n){var o=t[n];if(void 0!==o)return o.exports;var i=t[n]={exports:{}};return e[n](i,i.exports,r),i.exports}(333);return r})()));