json-web3 0.1.0 → 1.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025
+Copyright (c) 2025 github/haozi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -20,16 +20,18 @@ import jsonWeb3 from 'json-web3'
 const payload = {
   balance: 1234567890123456789n,
   decimals: 18n,
+  data: new Uint8Array([1, 2, 3, 255]),
 }
 
 const text = jsonWeb3.stringify(payload)
-// => {"balance":{"__@json.bigint__":"1234567890123456789"},"decimals":18n}
+// => {"balance":{"__@json.bigint__":"1234567890123456789"},"decimals":{"__@json.bigint__":"18"},"data":{"__@json.bytes__":"0x010203ff"}}
 
 const restored = jsonWeb3.parse(text)
 /* => 
   {
     "balance": 1234567890123456789n,
-    "decimals": 18n
+    "decimals": 18n,
+    "data": Uint8Array(4) [1, 2, 3, 255]
   }
 */
 ```
@@ -37,8 +39,8 @@ const restored = jsonWeb3.parse(text)
 ## API (Fully compatible with native globalThis.JSON)
 
 - `stringify(value, replacer?, space?)`
-- `parse(text)`
+- `parse(text, reviver?)`
 
 ## Notes
 
-`bigint` values are encoded as objects: `{"__@json.bigint__":"<value>"}`. More types can be added later.
+`bigint` values are encoded as objects: `{"__@json.bigint__":"<value>"}`. `Uint8Array`/`ArrayBuffer` (and Node `Buffer` JSON shapes) are encoded as `{"__@json.bytes__":"0x..."}` and decoded back to `Uint8Array`.

package/dist/index.cjs

@@ -25,32 +25,97 @@ __export(index_exports, {
   stringify: () => stringify
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/utils.ts
 var BIGINT_TAG = "__@json.bigint__";
+var BYTES_TAG = "__@json.bytes__";
+var undefined = void 0;
+var isUndefined = (value) => value === undefined;
+var hasOwnProperty = (obj, prop) => Object.prototype.hasOwnProperty.call(obj, prop);
+var isArray = (value) => Array.isArray(value);
+var isObject = (value) => value !== null && typeof value === "object" && !isArray(value);
+var isFunction = (value) => typeof value === "function";
+var isBigInt = (value) => typeof value === "bigint";
+var isUint8Array = (value) => !isUndefined(Uint8Array) && value instanceof Uint8Array;
+var isArrayBuffer = (value) => !isUndefined(ArrayBuffer) && value instanceof ArrayBuffer;
+var toHex = (value) => {
+  let out = "0x";
+  for (const byte of value) {
+    out += byte.toString(16).padStart(2, "0");
+  }
+  return out;
+};
+var fromHex = (hex) => {
+  const normalized = hex.startsWith("0x") ? hex.slice(2) : hex;
+  if (normalized.length % 2 !== 0) {
+    throw new Error("Invalid hex string for bytes");
+  }
+  if (!isUndefined(Buffer)) {
+    return Uint8Array.from(Buffer.from(normalized, "hex"));
+  }
+  const out = new Uint8Array(normalized.length / 2);
+  for (let i = 0; i < normalized.length; i += 2) {
+    out[i / 2] = Number.parseInt(normalized.slice(i, i + 2), 16);
+  }
+  return out;
+};
+var toSerializable = (value) => {
+  if (isBigInt(value)) {
+    return { [BIGINT_TAG]: value.toString() };
+  }
+  if (isUint8Array(value)) {
+    return { [BYTES_TAG]: toHex(value) };
+  }
+  if (isArrayBuffer(value)) {
+    return { [BYTES_TAG]: toHex(new Uint8Array(value)) };
+  }
+  if (value && isObject(value) && value.type === "Buffer" && isArray(value.data) && Object.keys(value).length === 2 && value.data.every((entry) => Number.isInteger(entry) && entry >= 0 && entry <= 255)) {
+    return { [BYTES_TAG]: toHex(Uint8Array.from(value.data)) };
+  }
+  return value;
+};
+var fromSerializable = (value) => {
+  if (value && isObject(value)) {
+    if (hasOwnProperty(value, BIGINT_TAG)) {
+      return BigInt(value[BIGINT_TAG]);
+    }
+    if (hasOwnProperty(value, BYTES_TAG)) {
+      return fromHex(value[BYTES_TAG]);
+    }
+    if (value.type === "Buffer" && isArray(value.data) && Object.keys(value).length === 2 && value.data.every((entry) => Number.isInteger(entry) && entry >= 0 && entry <= 255)) {
+      return Uint8Array.from(value.data);
+    }
+  }
+  return value;
+};
+
+// src/index.ts
 var RAW_JSON = JSON;
-var applyReplacer = (key, value, replacer) => {
-  if (typeof replacer === "function") {
+var applyReplacer = (holder, key, value, replacer) => {
+  if (isFunction(replacer)) {
     return replacer(key, value);
   }
-  if (Array.isArray(replacer)) {
+  if (isArray(replacer)) {
     if (key === "") return value;
     if (key === BIGINT_TAG) return value;
-    return replacer.includes(key) ? value : void 0;
+    if (key === BYTES_TAG) return value;
+    if (isArray(holder)) return value;
+    return replacer.includes(key) ? value : undefined;
   }
   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);
+  function replacerFn(key, v) {
+    const replaced = applyReplacer(this, 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 parse = (text, reviver = null) => RAW_JSON.parse(text, (key, v) => {
+  const decoded = fromSerializable(v);
+  return typeof reviver === "function" ? reviver(key, decoded) : decoded;
+});
 var index_default = {
   stringify,
   parse

package/dist/index.cjs.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/index.ts","../src/utils.ts"],"sourcesContent":["import {\n  BIGINT_TAG,\n  BYTES_TAG,\n  fromSerializable,\n  isArray,\n  isFunction,\n  toSerializable,\n  undefined,\n} from './utils'\n\nconst RAW_JSON = JSON\ntype Replacer = ((this: any, key: string, value: any) => any) | Array<string | number> | null\ntype Reviver = ((this: any, key: string, value: any) => any) | null\n\nconst applyReplacer = (holder: any, key: string, value: any, replacer: Replacer): any => {\n  if (isFunction(replacer)) {\n    return replacer(key, value)\n  }\n  if (isArray(replacer)) {\n    if (key === '') return value\n    if (key === BIGINT_TAG) return value\n    if (key === BYTES_TAG) return value\n    if (isArray(holder)) return value\n    return replacer.includes(key) ? value : undefined\n  }\n  return value\n}\n\nexport const stringify = (value: any, replacer: Replacer = null, space?: string | number): string =>\n  RAW_JSON.stringify(\n    value,\n    function replacerFn(key, v) {\n      const replaced = applyReplacer(this, key, v, replacer)\n      return toSerializable(replaced)\n    },\n    space,\n  )\n\nexport const parse = (text: string, reviver: Reviver = null): any =>\n  RAW_JSON.parse(text, (key, v) => {\n    const decoded = fromSerializable(v)\n    return typeof reviver === 'function' ? reviver(key, decoded) : decoded\n  })\n\nexport default {\n  stringify,\n  parse,\n}\n","export const BIGINT_TAG = '__@json.bigint__'\nexport const BYTES_TAG = '__@json.bytes__'\n\nexport const undefined = void 0\nexport const isUndefined = (value: any): value is undefined => value === undefined\nexport const hasOwnProperty = (obj: any, prop: string): boolean =>\n  Object.prototype.hasOwnProperty.call(obj, prop)\nexport const isArray = (value: any): value is Array<any> => Array.isArray(value)\nexport const isObject = (value: any): value is Record<string, any> =>\n  value !== null && typeof value === 'object' && !isArray(value)\nexport const isFunction = (value: any): value is Function => typeof value === 'function'\nexport const isBigInt = (value: any): value is bigint => typeof value === 'bigint'\nexport const isBuffer = (value: any): value is Buffer =>\n  !isUndefined(Buffer) && isFunction(Buffer.isBuffer) && Buffer.isBuffer(value)\nexport const isUint8Array = (value: any): value is Uint8Array =>\n  !isUndefined(Uint8Array) && value instanceof Uint8Array\nexport const isArrayBuffer = (value: any): value is ArrayBuffer =>\n  !isUndefined(ArrayBuffer) && value instanceof ArrayBuffer\n\nexport const toHex = (value: Uint8Array): string => {\n  let out = '0x'\n  for (const byte of value) {\n    out += byte.toString(16).padStart(2, '0')\n  }\n  return out\n}\n\nexport const fromHex = (hex: string): Uint8Array => {\n  const normalized = hex.startsWith('0x') ? hex.slice(2) : hex\n  if (normalized.length % 2 !== 0) {\n    throw new Error('Invalid hex string for bytes')\n  }\n\n  if (!isUndefined(Buffer)) {\n    return Uint8Array.from(Buffer.from(normalized, 'hex'))\n  }\n\n  const out = new Uint8Array(normalized.length / 2)\n  for (let i = 0; i < normalized.length; i += 2) {\n    out[i / 2] = Number.parseInt(normalized.slice(i, i + 2), 16)\n  }\n  return out\n}\n\nexport const toSerializable = (value: any): any => {\n  if (isBigInt(value)) {\n    return { [BIGINT_TAG]: value.toString() }\n  }\n\n  if (isUint8Array(value)) {\n    return { [BYTES_TAG]: toHex(value) }\n  }\n\n  if (isArrayBuffer(value)) {\n    return { [BYTES_TAG]: toHex(new Uint8Array(value)) }\n  }\n\n  if (\n    value &&\n    isObject(value) &&\n    value.type === 'Buffer' &&\n    isArray(value.data) &&\n    Object.keys(value).length === 2 &&\n    value.data.every((entry: any) => Number.isInteger(entry) && entry >= 0 && entry <= 255)\n  ) {\n    return { [BYTES_TAG]: toHex(Uint8Array.from(value.data)) }\n  }\n\n  return value\n}\n\nexport const fromSerializable = (value: any): any => {\n  if (value && isObject(value)) {\n    if (hasOwnProperty(value, BIGINT_TAG)) {\n      return BigInt(value[BIGINT_TAG])\n    }\n    if (hasOwnProperty(value, BYTES_TAG)) {\n      return fromHex(value[BYTES_TAG])\n    }\n    if (\n      value.type === 'Buffer' &&\n      isArray(value.data) &&\n      Object.keys(value).length === 2 &&\n      value.data.every((entry: any) => Number.isInteger(entry) && entry >= 0 && entry <= 255)\n    ) {\n      return Uint8Array.from(value.data)\n    }\n  }\n  return value\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,30 +1,93 @@
-// src/index.ts
+// src/utils.ts
 var BIGINT_TAG = "__@json.bigint__";
+var BYTES_TAG = "__@json.bytes__";
+var undefined = void 0;
+var isUndefined = (value) => value === undefined;
+var hasOwnProperty = (obj, prop) => Object.prototype.hasOwnProperty.call(obj, prop);
+var isArray = (value) => Array.isArray(value);
+var isObject = (value) => value !== null && typeof value === "object" && !isArray(value);
+var isFunction = (value) => typeof value === "function";
+var isBigInt = (value) => typeof value === "bigint";
+var isUint8Array = (value) => !isUndefined(Uint8Array) && value instanceof Uint8Array;
+var isArrayBuffer = (value) => !isUndefined(ArrayBuffer) && value instanceof ArrayBuffer;
+var toHex = (value) => {
+  let out = "0x";
+  for (const byte of value) {
+    out += byte.toString(16).padStart(2, "0");
+  }
+  return out;
+};
+var fromHex = (hex) => {
+  const normalized = hex.startsWith("0x") ? hex.slice(2) : hex;
+  if (normalized.length % 2 !== 0) {
+    throw new Error("Invalid hex string for bytes");
+  }
+  if (!isUndefined(Buffer)) {
+    return Uint8Array.from(Buffer.from(normalized, "hex"));
+  }
+  const out = new Uint8Array(normalized.length / 2);
+  for (let i = 0; i < normalized.length; i += 2) {
+    out[i / 2] = Number.parseInt(normalized.slice(i, i + 2), 16);
+  }
+  return out;
+};
+var toSerializable = (value) => {
+  if (isBigInt(value)) {
+    return { [BIGINT_TAG]: value.toString() };
+  }
+  if (isUint8Array(value)) {
+    return { [BYTES_TAG]: toHex(value) };
+  }
+  if (isArrayBuffer(value)) {
+    return { [BYTES_TAG]: toHex(new Uint8Array(value)) };
+  }
+  if (value && isObject(value) && value.type === "Buffer" && isArray(value.data) && Object.keys(value).length === 2 && value.data.every((entry) => Number.isInteger(entry) && entry >= 0 && entry <= 255)) {
+    return { [BYTES_TAG]: toHex(Uint8Array.from(value.data)) };
+  }
+  return value;
+};
+var fromSerializable = (value) => {
+  if (value && isObject(value)) {
+    if (hasOwnProperty(value, BIGINT_TAG)) {
+      return BigInt(value[BIGINT_TAG]);
+    }
+    if (hasOwnProperty(value, BYTES_TAG)) {
+      return fromHex(value[BYTES_TAG]);
+    }
+    if (value.type === "Buffer" && isArray(value.data) && Object.keys(value).length === 2 && value.data.every((entry) => Number.isInteger(entry) && entry >= 0 && entry <= 255)) {
+      return Uint8Array.from(value.data);
+    }
+  }
+  return value;
+};
+
+// src/index.ts
 var RAW_JSON = JSON;
-var applyReplacer = (key, value, replacer) => {
-  if (typeof replacer === "function") {
+var applyReplacer = (holder, key, value, replacer) => {
+  if (isFunction(replacer)) {
     return replacer(key, value);
   }
-  if (Array.isArray(replacer)) {
+  if (isArray(replacer)) {
     if (key === "") return value;
     if (key === BIGINT_TAG) return value;
-    return replacer.includes(key) ? value : void 0;
+    if (key === BYTES_TAG) return value;
+    if (isArray(holder)) return value;
+    return replacer.includes(key) ? value : undefined;
   }
   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);
+  function replacerFn(key, v) {
+    const replaced = applyReplacer(this, 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 parse = (text, reviver = null) => RAW_JSON.parse(text, (key, v) => {
+  const decoded = fromSerializable(v);
+  return typeof reviver === "function" ? reviver(key, decoded) : decoded;
+});
 var index_default = {
   stringify,
   parse

package/dist/index.js.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/utils.ts","../src/index.ts"],"sourcesContent":["export const BIGINT_TAG = '__@json.bigint__'\nexport const BYTES_TAG = '__@json.bytes__'\n\nexport const undefined = void 0\nexport const isUndefined = (value: any): value is undefined => value === undefined\nexport const hasOwnProperty = (obj: any, prop: string): boolean =>\n  Object.prototype.hasOwnProperty.call(obj, prop)\nexport const isArray = (value: any): value is Array<any> => Array.isArray(value)\nexport const isObject = (value: any): value is Record<string, any> =>\n  value !== null && typeof value === 'object' && !isArray(value)\nexport const isFunction = (value: any): value is Function => typeof value === 'function'\nexport const isBigInt = (value: any): value is bigint => typeof value === 'bigint'\nexport const isBuffer = (value: any): value is Buffer =>\n  !isUndefined(Buffer) && isFunction(Buffer.isBuffer) && Buffer.isBuffer(value)\nexport const isUint8Array = (value: any): value is Uint8Array =>\n  !isUndefined(Uint8Array) && value instanceof Uint8Array\nexport const isArrayBuffer = (value: any): value is ArrayBuffer =>\n  !isUndefined(ArrayBuffer) && value instanceof ArrayBuffer\n\nexport const toHex = (value: Uint8Array): string => {\n  let out = '0x'\n  for (const byte of value) {\n    out += byte.toString(16).padStart(2, '0')\n  }\n  return out\n}\n\nexport const fromHex = (hex: string): Uint8Array => {\n  const normalized = hex.startsWith('0x') ? hex.slice(2) : hex\n  if (normalized.length % 2 !== 0) {\n    throw new Error('Invalid hex string for bytes')\n  }\n\n  if (!isUndefined(Buffer)) {\n    return Uint8Array.from(Buffer.from(normalized, 'hex'))\n  }\n\n  const out = new Uint8Array(normalized.length / 2)\n  for (let i = 0; i < normalized.length; i += 2) {\n    out[i / 2] = Number.parseInt(normalized.slice(i, i + 2), 16)\n  }\n  return out\n}\n\nexport const toSerializable = (value: any): any => {\n  if (isBigInt(value)) {\n    return { [BIGINT_TAG]: value.toString() }\n  }\n\n  if (isUint8Array(value)) {\n    return { [BYTES_TAG]: toHex(value) }\n  }\n\n  if (isArrayBuffer(value)) {\n    return { [BYTES_TAG]: toHex(new Uint8Array(value)) }\n  }\n\n  if (\n    value &&\n    isObject(value) &&\n    value.type === 'Buffer' &&\n    isArray(value.data) &&\n    Object.keys(value).length === 2 &&\n    value.data.every((entry: any) => Number.isInteger(entry) && entry >= 0 && entry <= 255)\n  ) {\n    return { [BYTES_TAG]: toHex(Uint8Array.from(value.data)) }\n  }\n\n  return value\n}\n\nexport const fromSerializable = (value: any): any => {\n  if (value && isObject(value)) {\n    if (hasOwnProperty(value, BIGINT_TAG)) {\n      return BigInt(value[BIGINT_TAG])\n    }\n    if (hasOwnProperty(value, BYTES_TAG)) {\n      return fromHex(value[BYTES_TAG])\n    }\n    if (\n      value.type === 'Buffer' &&\n      isArray(value.data) &&\n      Object.keys(value).length === 2 &&\n      value.data.every((entry: any) => Number.isInteger(entry) && entry >= 0 && entry <= 255)\n    ) {\n      return Uint8Array.from(value.data)\n    }\n  }\n  return value\n}\n","import {\n  BIGINT_TAG,\n  BYTES_TAG,\n  fromSerializable,\n  isArray,\n  isFunction,\n  toSerializable,\n  undefined,\n} from './utils'\n\nconst RAW_JSON = JSON\ntype Replacer = ((this: any, key: string, value: any) => any) | Array<string | number> | null\ntype Reviver = ((this: any, key: string, value: any) => any) | null\n\nconst applyReplacer = (holder: any, key: string, value: any, replacer: Replacer): any => {\n  if (isFunction(replacer)) {\n    return replacer(key, value)\n  }\n  if (isArray(replacer)) {\n    if (key === '') return value\n    if (key === BIGINT_TAG) return value\n    if (key === BYTES_TAG) return value\n    if (isArray(holder)) return value\n    return replacer.includes(key) ? value : undefined\n  }\n  return value\n}\n\nexport const stringify = (value: any, replacer: Replacer = null, space?: string | number): string =>\n  RAW_JSON.stringify(\n    value,\n    function replacerFn(key, v) {\n      const replaced = applyReplacer(this, key, v, replacer)\n      return toSerializable(replaced)\n    },\n    space,\n  )\n\nexport const parse = (text: string, reviver: Reviver = null): any =>\n  RAW_JSON.parse(text, (key, v) => {\n    const decoded = fromSerializable(v)\n    return typeof reviver === 'function' ? reviver(key, decoded) : decoded\n  })\n\nexport default {\n  stringify,\n  parse,\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "json-web3",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "BigInt-safe JSON serialization and deserialization for Web3 use cases.",
   "keywords": [
     "json",
     "bigint",
+    "arraybuffer",
     "serialization",
     "deserialization",
     "web3"
   ],
+  "homepage": "https://github.com/haozi/json-web3#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/haozi/json-web3.git"
+  },
   "license": "MIT",
+  "author": "haozi",
   "sideEffects": false,
   "type": "module",
   "exports": {
@@ -29,7 +36,12 @@
   ],
   "devDependencies": {
     "@types/node": "^25.0.9",
+    "@vitest/coverage-v8": "^4.0.17",
     "prettier": "^3.8.0",
+    "prettier-plugin-lint-md": "^1.0.1",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "prettier-plugin-sort-json": "^4.2.0",
+    "prettier-plugin-tailwindcss": "^0.7.2",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.17"
@@ -39,8 +51,10 @@
   },
   "scripts": {
     "build": "tsup",
+    "coverage": "vitest run --coverage",
     "lint": "prettier . --write",
     "test": "vitest run",
+    "test:coverage": "pnpm run coverage",
     "test:watch": "vitest"
   }
 }