json-with-bigint 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Ivan Korolenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# JSON with BigInt
+
+JS library that allows you to easily serialize and deserialize data with BigInt values
+
+## Why would I need JSON-with-BigInt?
+
+3 reasons:
+
+1. You need to convert some data to/from JSON and it includes BigInt values
+2. Native JSON.stringify() and JSON.parse() methods in JS can't work with BigInt
+3. Other libraries and pieces of code that you'll find can't solve this problem while supporting consistent round-trip operations (meaning, you will not get the same BigInt values if you serialize and then deserialize them)
+
+## Good things about JSON-with-BigInt
+
+✔️ Supports consistent round-trip operations with JSON.
+
+```
+JSONParse(JSONStringify(9007199254740991n)) === 9007199254740991n // true
+```
+
+✔️ Can be used in a TypeScript project (.d.ts file included)
+
+✔️ Size: 164 bytes (minified and gzipped)
+
+✔️ No dependencies

package/json-with-bigint.d.ts

@@ -0,0 +1,3 @@
+export function JSONStringify(data: any): string | undefined;
+
+export function JSONParse(serializedData: string): any;

package/json-with-bigint.js

@@ -0,0 +1,11 @@
+export const JSONStringify = (data) =>
+  JSON.stringify(data, (_, value) =>
+    typeof value === "bigint" ? value.toString() + "n" : value
+  );
+
+export const JSONParse = (serializedData) =>
+  JSON.parse(serializedData, (_, value) =>
+    typeof value === "string" && value.match(/^\d+n$/)
+      ? BigInt(value.substring(0, value.length - 1))
+      : value
+  );

package/json-with-bigint.min.js

@@ -0,0 +1 @@
+export const JSONStringify=t=>JSON.stringify(t,(t,n)=>"bigint"==typeof n?n.toString()+"n":n);export const JSONParse=t=>JSON.parse(t,(t,n)=>"string"==typeof n&&n.match(/^\d+n$/)?BigInt(n.substring(0,n.length-1)):n);

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "json-with-bigint",
+  "version": "1.0.0",
+  "description": "JS library that allows you to easily serialize and deserialize data with BigInt values",
+  "main": "json-with-bigint.js",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "keywords": [],
+  "author": "Ivan Korolenko <iam@ivankorolenko.com>",
+  "license": "MIT"
+}