@brillout/json-serializer 0.5.20 → 0.5.22

package/dist/parse.d.ts

@@ -1,10 +1,12 @@
 export { parse };
 export { parseTransform };
+export type { Reviver };
+type Reviver = (key: undefined | string, value: string, parser: (str: string) => unknown) => {
+    replacement: unknown;
+    resolved?: boolean;
+} | undefined;
 type Options = {
-    reviver?: (key: undefined | string, value: string, parser: (str: string) => unknown) => {
-        replacement: unknown;
-        resolved?: boolean;
-    } | undefined;
+    reviver?: Reviver;
 };
 declare function parse(str: string, options?: Options): unknown;
 declare function parseTransform(value: unknown, options?: Options): unknown;

package/dist/stringify.d.ts

@@ -1,15 +1,17 @@
 export { stringify };
 export { isJsonSerializerError };
-import { type Iterable, type Path } from './utils/replacerWithPath.js';
+export type { Replacer };
+import { type Iterable, type Path } from './utils/addPathToReplacer.js';
+type Replacer = (this: Iterable, key: string, value: unknown, serializer: (value: unknown) => string) => {
+    replacement: unknown;
+    resolved?: boolean;
+} | undefined;
 declare function stringify(value: unknown, { forbidReactElements, space, valueName, sortObjectKeys, replacer: replacerUserProvided, }?: {
     forbidReactElements?: boolean;
     space?: number;
     valueName?: string;
     sortObjectKeys?: boolean;
-    replacer?: (this: Iterable, key: string, value: unknown, serializer: (value: unknown) => string) => {
-        replacement: unknown;
-        resolved?: boolean;
-    } | undefined;
+    replacer?: Replacer;
 }): string;
 type ErrAddendum = {
     messageCore: `cannot serialize ${string} because it's a function` | `cannot serialize ${string} because it's a React element`;

package/dist/stringify.js

@@ -4,7 +4,7 @@ import { types } from './types.js';
 import { isReactElement } from './utils/isReactElement.js';
 import { isCallable } from './utils/isCallable.js';
 import { isObject } from './utils/isObject.js';
-import { replacerWithPath } from './utils/replacerWithPath.js';
+import { addPathToReplacer } from './utils/addPathToReplacer.js';
 function stringify(value, { forbidReactElements, space, valueName, sortObjectKeys, replacer: replacerUserProvided, } = {}) {
     // The only error `JSON.stringify()` can throw is `TypeError "cyclic object value"`.
     // - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#exceptions
@@ -12,13 +12,13 @@ function stringify(value, { forbidReactElements, space, valueName, sortObjectKey
     //    - Cyclic references
     //    - Functions
     //    - React elements
-    const serializer = (val) => JSON.stringify(val, replacerWithPath(replacer), space);
+    const serializer = (val) => JSON.stringify(val, addPathToReplacer(replacer), space);
     return serializer(value);
-    function replacer(key, valueAfterJSON, path) {
+    function replacer(key, _valueAfterNativeJsonStringify, path) {
         const valueOriginal = this[key];
         let value = valueOriginal;
         {
-            const ret = replacerUserProvided?.call(this, key, valueAfterJSON, serializer);
+            const ret = replacerUserProvided?.call(this, key, valueOriginal, serializer);
             if (ret) {
                 value = ret.replacement;
                 if (ret.resolved !== false)

package/dist/utils/addPathToReplacer.d.ts

@@ -0,0 +1,12 @@
+export { addPathToReplacer };
+export type { Iterable };
+export type { Path };
+type Path = (string | number)[];
+type Iterable = Record<string, unknown>;
+type Replacer = (this: Iterable, key: string, valueAfterNativeJsonStringify: unknown, path: Path) => unknown;
+/**
+ * The `replacer()` callback of `JSON.stringify()` doesn't provide the path of the object property that is being stringified.
+ *
+ * `addPathToReplacer(replacer)` adds the property path to the `replacer()` callback as last parameter.
+ */
+declare function addPathToReplacer(replacer: Replacer): (this: Iterable, key: string, valueAfterNativeJsonStringify: unknown) => unknown;

package/dist/utils/addPathToReplacer.js

@@ -0,0 +1,24 @@
+export { addPathToReplacer };
+/**
+ * The `replacer()` callback of `JSON.stringify()` doesn't provide the path of the object property that is being stringified.
+ *
+ * `addPathToReplacer(replacer)` adds the property path to the `replacer()` callback as last parameter.
+ */
+function addPathToReplacer(replacer) {
+    const pathMap = new WeakMap();
+    return replacerForJsonStringify;
+    function replacerForJsonStringify(key, valueAfterNativeJsonStringify) {
+        const pathPrevious = pathMap.get(this) ?? [];
+        const path = [...pathPrevious];
+        if (key !== '') {
+            const pathEntry = !Array.isArray(this) ? key : parseInt(key, 10);
+            path.push(pathEntry);
+        }
+        if (isIterable(valueAfterNativeJsonStringify))
+            pathMap.set(valueAfterNativeJsonStringify, path);
+        return replacer.call(this, key, valueAfterNativeJsonStringify, path);
+    }
+}
+function isIterable(value) {
+    return value === Object(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brillout/json-serializer",
-  "version": "0.5.20",
+  "version": "0.5.22",
   "description": "Same as JSON but with added support for `Date`, `undefined`, `Map`, `Set`, and more.",
   "main": "./index.mjs",
   "type": "module",
@@ -47,7 +47,7 @@
     "========= Build": "",
     "build": "rm -rf dist/ && tsc",
     "========= Test": "",
-    "test": "vitest",
+    "test": "node ./examples && vitest run",
     "========= Build readme.md": "",
     "docs": "mdocs",
     "========= Formatting": "",

package/dist/utils/replacerWithPath.d.ts

@@ -1,7 +0,0 @@
-export { replacerWithPath };
-export type { Iterable };
-export type { Path };
-type Path = (string | number)[];
-type Iterable = Record<string, unknown>;
-type Replacer = (this: Iterable, key: string, value: unknown, path: Path) => unknown;
-declare function replacerWithPath(replacer: Replacer): (this: Iterable, key: string, value: unknown) => unknown;

package/dist/utils/replacerWithPath.js

@@ -1,18 +0,0 @@
-export { replacerWithPath };
-function replacerWithPath(replacer) {
-    const pathMap = new WeakMap();
-    return function (key, value) {
-        const pathPrevious = pathMap.get(this) ?? [];
-        const path = [...pathPrevious];
-        if (key !== '') {
-            const pathEntry = !Array.isArray(this) ? key : parseInt(key, 10);
-            path.push(pathEntry);
-        }
-        if (isIterable(value))
-            pathMap.set(value, path);
-        return replacer.call(this, key, value, path);
-    };
-}
-function isIterable(value) {
-    return value === Object(value);
-}