@awsless/json 0.0.1 → 0.0.3

package/README.MD

@@ -5,8 +5,15 @@ The `@awsless/json` package adds support for more JavaScript native types to JSO
 
 ## The Problem
 
-JSON doesn't have support for types like Date, BigInt, or BigFloat.
-Having to decode & encode these type of values can get quite annoying.
+JSON doesn't have support for types like:
+- `undefined`
+- `Set`
+- `Map`
+- `Date`
+- `BigInt`
+- `BigFloat` - npm package @awsless/bit-float
+
+Having to decode & encode these type of values can get quite annoying. We try to solve this problem by encoding these types using valid JSON syntax.
 
 ## Basic Usage
 
@@ -14,13 +21,29 @@ Having to decode & encode these type of values can get quite annoying.
 import { parse, stringify } from '@awsless/json';
 
 // Stringify a bigint.
-// The output will be {"$bigint": "1"}
+// The output will be {"$bigint":"1"}
 const json = stringify(1n)
 
 // Parse the json with a bigint inside.
 const value = parse(json)
 ```
 
+## Patching incorrectly parsed JSON that was parsed with a different JSON parser
+
+In some cases you might not have control over the JSON parser that is being used. In these cases your JSON will still be able to parse, but the output will be incorrect. We can patch the incorrect output by using the `patch` function.
+
+```ts
+import { stringify, patch } from '@awsless/json';
+
+const json = stringify(1n)
+
+// The native JSON.parse function will not parse our bigint correctly.
+const broken = JSON.parse(json)
+
+// Will fix the broken output.
+const fixed = patch(broken)
+```
+
 ## Extending Supported Types
 
 We let you extend JSON to support your own custom types.
@@ -36,7 +59,7 @@ class Custom {
 	}
 }
 
-const $custom: Serializable<Custom> = {
+const $custom: Serializable<Custom, string> = {
 	is: v => v instanceof Custom,
 	parse: v => new Custom(v),
 	stringify: v => v.value,
@@ -48,3 +71,18 @@ const json = stringify(new Custom('example'), { $custom })
 // Parse the json with your custom type
 const value = parse(json, { $custom })
 ```
+
+## Known Issue's
+
+Object properties with `undefined` as value type will be stripped away.
+
+```ts
+// Will result in an empty object
+const result = parse(stringify({ key: undefined }))
+
+// Will log false
+console.log('key' in result)
+
+// Will log true
+console.log(result.key === undefined)
+```

package/dist/index.cjs

@@ -23,30 +23,65 @@ __export(src_exports, {
   createReplacer: () => createReplacer,
   createReviver: () => createReviver,
   parse: () => parse,
+  patch: () => patch,
   stringify: () => stringify
 });
 module.exports = __toCommonJS(src_exports);
+
+// src/type/bigfloat.ts
 var import_big_float = require("@awsless/big-float");
 var $bigfloat = {
   is: (v) => v instanceof import_big_float.BigFloat,
   parse: (v) => new import_big_float.BigFloat(v),
   stringify: (v) => v.toString()
 };
+
+// src/type/bigint.ts
 var $bigint = {
   is: (v) => typeof v === "bigint",
   parse: (v) => BigInt(v),
   stringify: (v) => v.toString()
 };
+
+// src/type/date.ts
 var $date = {
   is: (v) => v instanceof Date,
   parse: (v) => new Date(v),
   stringify: (v) => v.toISOString()
 };
+
+// src/type/map.ts
+var $map = {
+  is: (v) => v instanceof Map,
+  parse: (v) => new Map(v),
+  stringify: (v) => Array.from(v)
+};
+
+// src/type/set.ts
+var $set = {
+  is: (v) => v instanceof Set,
+  parse: (v) => new Set(v),
+  stringify: (v) => Array.from(v)
+};
+
+// src/type/undefined.ts
+var $undefined = {
+  is: (v) => typeof v === "undefined",
+  parse: (_) => void 0,
+  stringify: (_) => 0
+};
+
+// src/type/index.ts
 var baseTypes = {
+  $undefined,
   $bigfloat,
   $bigint,
-  $date
+  $date,
+  $set,
+  $map
 };
+
+// src/parse.ts
 var parse = (json, types = {}) => {
   return JSON.parse(json, createReviver(types));
 };
@@ -70,6 +105,8 @@ var createReviver = (types = {}) => {
     return value;
   };
 };
+
+// src/stringify.ts
 var stringify = (value, types = {}) => {
   return JSON.stringify(value, createReplacer(types));
 };
@@ -90,10 +127,16 @@ var createReplacer = (types = {}) => {
     return value;
   };
 };
+
+// src/patch.ts
+var patch = (value, types = {}) => {
+  return parse(stringify(value, types), types);
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createReplacer,
   createReviver,
   parse,
+  patch,
   stringify
 });

package/dist/index.d.cts

@@ -1,14 +1,18 @@
-type Serializable<T> = {
-    is: (value: unknown) => boolean;
-    parse: (value: string) => T;
-    stringify: (value: T) => string;
+type Serializable<I, O> = {
+    is: (value: unknown) => value is I;
+    parse: (value: O) => I;
+    stringify: (value: I) => O;
 };
-type SerializableTypes = Record<string, Serializable<any>>;
+type SerializableTypes = Record<string, Serializable<any, any>>;
+
+declare const patch: <T>(value: T, types?: SerializableTypes) => T;
+
 declare const parse: (json: string, types?: SerializableTypes) => any;
 type Reviver = (this: any, key: string, value: any) => any;
-type Replacer = (this: any, key: string, value: any) => any;
 declare const createReviver: (types?: SerializableTypes) => Reviver;
+
 declare const stringify: (value: unknown, types?: SerializableTypes) => string;
+type Replacer = (this: any, key: string, value: any) => any;
 declare const createReplacer: (types?: SerializableTypes) => Replacer;
 
-export { type Serializable, createReplacer, createReviver, parse, stringify };
+export { type Serializable, createReplacer, createReviver, parse, patch, stringify };

package/dist/index.d.ts

@@ -1,14 +1,18 @@
-type Serializable<T> = {
-    is: (value: unknown) => boolean;
-    parse: (value: string) => T;
-    stringify: (value: T) => string;
+type Serializable<I, O> = {
+    is: (value: unknown) => value is I;
+    parse: (value: O) => I;
+    stringify: (value: I) => O;
 };
-type SerializableTypes = Record<string, Serializable<any>>;
+type SerializableTypes = Record<string, Serializable<any, any>>;
+
+declare const patch: <T>(value: T, types?: SerializableTypes) => T;
+
 declare const parse: (json: string, types?: SerializableTypes) => any;
 type Reviver = (this: any, key: string, value: any) => any;
-type Replacer = (this: any, key: string, value: any) => any;
 declare const createReviver: (types?: SerializableTypes) => Reviver;
+
 declare const stringify: (value: unknown, types?: SerializableTypes) => string;
+type Replacer = (this: any, key: string, value: any) => any;
 declare const createReplacer: (types?: SerializableTypes) => Replacer;
 
-export { type Serializable, createReplacer, createReviver, parse, stringify };
+export { type Serializable, createReplacer, createReviver, parse, patch, stringify };

package/dist/index.js

@@ -1,25 +1,57 @@
-// src/index.ts
+// src/type/bigfloat.ts
 import { BigFloat } from "@awsless/big-float";
 var $bigfloat = {
   is: (v) => v instanceof BigFloat,
   parse: (v) => new BigFloat(v),
   stringify: (v) => v.toString()
 };
+
+// src/type/bigint.ts
 var $bigint = {
   is: (v) => typeof v === "bigint",
   parse: (v) => BigInt(v),
   stringify: (v) => v.toString()
 };
+
+// src/type/date.ts
 var $date = {
   is: (v) => v instanceof Date,
   parse: (v) => new Date(v),
   stringify: (v) => v.toISOString()
 };
+
+// src/type/map.ts
+var $map = {
+  is: (v) => v instanceof Map,
+  parse: (v) => new Map(v),
+  stringify: (v) => Array.from(v)
+};
+
+// src/type/set.ts
+var $set = {
+  is: (v) => v instanceof Set,
+  parse: (v) => new Set(v),
+  stringify: (v) => Array.from(v)
+};
+
+// src/type/undefined.ts
+var $undefined = {
+  is: (v) => typeof v === "undefined",
+  parse: (_) => void 0,
+  stringify: (_) => 0
+};
+
+// src/type/index.ts
 var baseTypes = {
+  $undefined,
   $bigfloat,
   $bigint,
-  $date
+  $date,
+  $set,
+  $map
 };
+
+// src/parse.ts
 var parse = (json, types = {}) => {
   return JSON.parse(json, createReviver(types));
 };
@@ -43,6 +75,8 @@ var createReviver = (types = {}) => {
     return value;
   };
 };
+
+// src/stringify.ts
 var stringify = (value, types = {}) => {
   return JSON.stringify(value, createReplacer(types));
 };
@@ -63,9 +97,15 @@ var createReplacer = (types = {}) => {
     return value;
   };
 };
+
+// src/patch.ts
+var patch = (value, types = {}) => {
+  return parse(stringify(value, types), types);
+};
 export {
   createReplacer,
   createReviver,
   parse,
+  patch,
   stringify
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awsless/json",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "license": "MIT",
   "type": "module",
   "repository": {