json-web3 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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,44 @@
+# json-web3
+
+BigInt-safe JSON serialization and deserialization for Web3 data.
+
+## Install
+
+```bash
+pnpm add json-web3
+# or
+npm i json-web3
+# or
+yarn add json-web3
+```
+
+## Usage
+
+```ts
+import jsonWeb3 from 'json-web3'
+
+const payload = {
+  balance: 1234567890123456789n,
+  decimals: 18n,
+}
+
+const text = jsonWeb3.stringify(payload)
+// => {"balance":{"__@json.bigint__":"1234567890123456789"},"decimals":18n}
+
+const restored = jsonWeb3.parse(text)
+/* => 
+  {
+    "balance": 1234567890123456789n,
+    "decimals": 18n
+  }
+*/
+```
+
+## API (Fully compatible with native globalThis.JSON)
+
+- `stringify(value, replacer?, space?)`
+- `parse(text)`
+
+## Notes
+
+`bigint` values are encoded as objects: `{"__@json.bigint__":"<value>"}`. More types can be added later.

package/dist/index.cjs

@@ -0,0 +1,63 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default,
+  parse: () => parse,
+  stringify: () => stringify
+});
+module.exports = __toCommonJS(index_exports);
+var BIGINT_TAG = "__@json.bigint__";
+var RAW_JSON = JSON;
+var applyReplacer = (key, value, replacer) => {
+  if (typeof replacer === "function") {
+    return replacer(key, value);
+  }
+  if (Array.isArray(replacer)) {
+    if (key === "") return value;
+    if (key === BIGINT_TAG) return value;
+    return replacer.includes(key) ? value : void 0;
+  }
+  return value;
+};
+var toSerializable = (value) => typeof value === "bigint" ? { [BIGINT_TAG]: value.toString() } : value;
+var stringify = (value, replacer = null, space) => RAW_JSON.stringify(
+  value,
+  (key, v) => {
+    const replaced = applyReplacer(key, v, replacer);
+    return toSerializable(replaced);
+  },
+  space
+);
+var parse = (text) => RAW_JSON.parse(
+  text,
+  (_, v) => v && typeof v === "object" && BIGINT_TAG in v ? BigInt(v[BIGINT_TAG]) : v
+);
+var index_default = {
+  stringify,
+  parse
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  parse,
+  stringify
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["const BIGINT_TAG = '__@json.bigint__'\nconst RAW_JSON = JSON\ntype Replacer = ((this: any, key: string, value: any) => any) | Array<string | number> | null\n\nconst applyReplacer = (key: string, value: any, replacer: Replacer): any => {\n  if (typeof replacer === 'function') {\n    return replacer(key, value)\n  }\n  if (Array.isArray(replacer)) {\n    if (key === '') return value\n    if (key === BIGINT_TAG) return value\n    return replacer.includes(key) ? value : undefined\n  }\n  return value\n}\n\nconst toSerializable = (value: any): any =>\n  typeof value === 'bigint' ? { [BIGINT_TAG]: value.toString() } : value\n\nexport const stringify = (value: any, replacer: Replacer = null, space?: string | number): string =>\n  RAW_JSON.stringify(\n    value,\n    (key, v) => {\n      const replaced = applyReplacer(key, v, replacer)\n      return toSerializable(replaced)\n    },\n    space,\n  )\n\nexport const parse = (text: string): any =>\n  RAW_JSON.parse(text, (_, v) =>\n    v && typeof v === 'object' && BIGINT_TAG in v ? BigInt(v[BIGINT_TAG]) : v,\n  )\n\nexport default {\n  stringify,\n  parse,\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAM,aAAa;AACnB,IAAM,WAAW;AAGjB,IAAM,gBAAgB,CAAC,KAAa,OAAY,aAA4B;AAC1E,MAAI,OAAO,aAAa,YAAY;AAClC,WAAO,SAAS,KAAK,KAAK;AAAA,EAC5B;AACA,MAAI,MAAM,QAAQ,QAAQ,GAAG;AAC3B,QAAI,QAAQ,GAAI,QAAO;AACvB,QAAI,QAAQ,WAAY,QAAO;AAC/B,WAAO,SAAS,SAAS,GAAG,IAAI,QAAQ;AAAA,EAC1C;AACA,SAAO;AACT;AAEA,IAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,WAAW,EAAE,CAAC,UAAU,GAAG,MAAM,SAAS,EAAE,IAAI;AAE5D,IAAM,YAAY,CAAC,OAAY,WAAqB,MAAM,UAC/D,SAAS;AAAA,EACP;AAAA,EACA,CAAC,KAAK,MAAM;AACV,UAAM,WAAW,cAAc,KAAK,GAAG,QAAQ;AAC/C,WAAO,eAAe,QAAQ;AAAA,EAChC;AAAA,EACA;AACF;AAEK,IAAM,QAAQ,CAAC,SACpB,SAAS;AAAA,EAAM;AAAA,EAAM,CAAC,GAAG,MACvB,KAAK,OAAO,MAAM,YAAY,cAAc,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI;AAC1E;AAEF,IAAO,gBAAQ;AAAA,EACb;AAAA,EACA;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,9 @@
+type Replacer = ((this: any, key: string, value: any) => any) | Array<string | number> | null;
+declare const stringify: (value: any, replacer?: Replacer, space?: string | number) => string;
+declare const parse: (text: string) => any;
+declare const _default: {
+    stringify: (value: any, replacer?: Replacer, space?: string | number) => string;
+    parse: (text: string) => any;
+};
+
+export { _default as default, parse, stringify };

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+type Replacer = ((this: any, key: string, value: any) => any) | Array<string | number> | null;
+declare const stringify: (value: any, replacer?: Replacer, space?: string | number) => string;
+declare const parse: (text: string) => any;
+declare const _default: {
+    stringify: (value: any, replacer?: Replacer, space?: string | number) => string;
+    parse: (text: string) => any;
+};
+
+export { _default as default, parse, stringify };

package/dist/index.js

@@ -0,0 +1,37 @@
+// src/index.ts
+var BIGINT_TAG = "__@json.bigint__";
+var RAW_JSON = JSON;
+var applyReplacer = (key, value, replacer) => {
+  if (typeof replacer === "function") {
+    return replacer(key, value);
+  }
+  if (Array.isArray(replacer)) {
+    if (key === "") return value;
+    if (key === BIGINT_TAG) return value;
+    return replacer.includes(key) ? value : void 0;
+  }
+  return value;
+};
+var toSerializable = (value) => typeof value === "bigint" ? { [BIGINT_TAG]: value.toString() } : value;
+var stringify = (value, replacer = null, space) => RAW_JSON.stringify(
+  value,
+  (key, v) => {
+    const replaced = applyReplacer(key, v, replacer);
+    return toSerializable(replaced);
+  },
+  space
+);
+var parse = (text) => RAW_JSON.parse(
+  text,
+  (_, v) => v && typeof v === "object" && BIGINT_TAG in v ? BigInt(v[BIGINT_TAG]) : v
+);
+var index_default = {
+  stringify,
+  parse
+};
+export {
+  index_default as default,
+  parse,
+  stringify
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["const BIGINT_TAG = '__@json.bigint__'\nconst RAW_JSON = JSON\ntype Replacer = ((this: any, key: string, value: any) => any) | Array<string | number> | null\n\nconst applyReplacer = (key: string, value: any, replacer: Replacer): any => {\n  if (typeof replacer === 'function') {\n    return replacer(key, value)\n  }\n  if (Array.isArray(replacer)) {\n    if (key === '') return value\n    if (key === BIGINT_TAG) return value\n    return replacer.includes(key) ? value : undefined\n  }\n  return value\n}\n\nconst toSerializable = (value: any): any =>\n  typeof value === 'bigint' ? { [BIGINT_TAG]: value.toString() } : value\n\nexport const stringify = (value: any, replacer: Replacer = null, space?: string | number): string =>\n  RAW_JSON.stringify(\n    value,\n    (key, v) => {\n      const replaced = applyReplacer(key, v, replacer)\n      return toSerializable(replaced)\n    },\n    space,\n  )\n\nexport const parse = (text: string): any =>\n  RAW_JSON.parse(text, (_, v) =>\n    v && typeof v === 'object' && BIGINT_TAG in v ? BigInt(v[BIGINT_TAG]) : v,\n  )\n\nexport default {\n  stringify,\n  parse,\n}\n"],"mappings":";AAAA,IAAM,aAAa;AACnB,IAAM,WAAW;AAGjB,IAAM,gBAAgB,CAAC,KAAa,OAAY,aAA4B;AAC1E,MAAI,OAAO,aAAa,YAAY;AAClC,WAAO,SAAS,KAAK,KAAK;AAAA,EAC5B;AACA,MAAI,MAAM,QAAQ,QAAQ,GAAG;AAC3B,QAAI,QAAQ,GAAI,QAAO;AACvB,QAAI,QAAQ,WAAY,QAAO;AAC/B,WAAO,SAAS,SAAS,GAAG,IAAI,QAAQ;AAAA,EAC1C;AACA,SAAO;AACT;AAEA,IAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,WAAW,EAAE,CAAC,UAAU,GAAG,MAAM,SAAS,EAAE,IAAI;AAE5D,IAAM,YAAY,CAAC,OAAY,WAAqB,MAAM,UAC/D,SAAS;AAAA,EACP;AAAA,EACA,CAAC,KAAK,MAAM;AACV,UAAM,WAAW,cAAc,KAAK,GAAG,QAAQ;AAC/C,WAAO,eAAe,QAAQ;AAAA,EAChC;AAAA,EACA;AACF;AAEK,IAAM,QAAQ,CAAC,SACpB,SAAS;AAAA,EAAM;AAAA,EAAM,CAAC,GAAG,MACvB,KAAK,OAAO,MAAM,YAAY,cAAc,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI;AAC1E;AAEF,IAAO,gBAAQ;AAAA,EACb;AAAA,EACA;AACF;","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "json-web3",
+  "version": "0.1.0",
+  "description": "BigInt-safe JSON serialization and deserialization for Web3 use cases.",
+  "keywords": [
+    "json",
+    "bigint",
+    "serialization",
+    "deserialization",
+    "web3"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "prettier": "^3.8.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "prettier . --write",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}