@philiprehberger/safe-json 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 philiprehberger
+
+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,83 @@
+# @philiprehberger/safe-json
+
+[![CI](https://github.com/philiprehberger/ts-safe-json/actions/workflows/ci.yml/badge.svg)](https://github.com/philiprehberger/ts-safe-json/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@philiprehberger/safe-json.svg)](https://www.npmjs.com/package/@philiprehberger/safe-json)
+[![License](https://img.shields.io/github/license/philiprehberger/ts-safe-json)](LICENSE)
+
+Safe JSON parsing and serialization with circular detection and depth limiting
+
+## Installation
+
+```bash
+npm install @philiprehberger/safe-json
+```
+
+## Usage
+
+### Safe Parse
+
+```ts
+import { safeParse } from '@philiprehberger/safe-json';
+
+const { ok, data, error } = safeParse<User>(jsonString);
+if (ok) {
+  console.log(data.name); // typed as User
+} else {
+  console.error(error.message);
+}
+```
+
+### Safe Stringify
+
+```ts
+import { safeStringify } from '@philiprehberger/safe-json';
+
+// Handles circular references
+const obj: any = { name: 'test' };
+obj.self = obj;
+safeStringify(obj);
+// {"name":"test","self":"[Circular]"}
+
+// Depth limiting
+safeStringify(deeplyNested, { maxDepth: 3 });
+// Objects beyond depth 3 become "[MaxDepth]"
+
+// Pretty print
+safeStringify(data, { space: 2 });
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `safeParse<T>(input)` | Parse JSON string, returns `{ ok, data?, error? }` |
+| `safeStringify(value, options?)` | Stringify with circular/depth protection |
+
+### `SafeParseResult<T>`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `ok` | `boolean` | Whether parsing succeeded |
+| `data` | `T` | Parsed value (if ok) |
+| `error` | `Error` | Parse error (if not ok) |
+
+### `StringifyOptions`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `maxDepth` | `number` | — | Max nesting depth before `"[MaxDepth]"` |
+| `replacer` | `(key, value) => unknown` | — | Custom replacer function |
+| `space` | `number` | — | Indentation spaces |
+
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+// src/parse.ts
+function safeParse(input) {
+  try {
+    const data = JSON.parse(input);
+    return { ok: true, data };
+  } catch (error) {
+    return {
+      ok: false,
+      error: error instanceof Error ? error : new Error(String(error))
+    };
+  }
+}
+function safeStringify(value, options = {}) {
+  const { maxDepth, replacer, space } = options;
+  const seen = /* @__PURE__ */ new WeakSet();
+  function serialize(val, depth) {
+    if (val === null || typeof val !== "object") return val;
+    if (seen.has(val)) return "[Circular]";
+    seen.add(val);
+    if (maxDepth !== void 0 && depth >= maxDepth) return "[MaxDepth]";
+    if (Array.isArray(val)) {
+      const arr = [];
+      for (const item of val) {
+        arr.push(serialize(item, depth + 1));
+      }
+      seen.delete(val);
+      return arr;
+    }
+    const obj = {};
+    for (const [key, v] of Object.entries(val)) {
+      obj[key] = serialize(v, depth + 1);
+    }
+    seen.delete(val);
+    return obj;
+  }
+  try {
+    const safe = serialize(value, 0);
+    return JSON.stringify(safe, replacer, space);
+  } catch (error) {
+    return JSON.stringify({ error: "Failed to stringify value" });
+  }
+}
+
+exports.safeParse = safeParse;
+exports.safeStringify = safeStringify;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse.ts"],"names":[],"mappings":";;;AAEO,SAAS,UAAuB,KAAA,EAAmC;AACxE,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC7B,IAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,IAAA,EAAK;AAAA,EAC1B,SAAS,KAAA,EAAO;AACd,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,KAAA,EAAO,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC;AAAA,KACjE;AAAA,EACF;AACF;AAEO,SAAS,aAAA,CACd,KAAA,EACA,OAAA,GAA4B,EAAC,EACrB;AACR,EAAA,MAAM,EAAE,QAAA,EAAU,QAAA,EAAU,KAAA,EAAM,GAAI,OAAA;AACtC,EAAA,MAAM,IAAA,uBAAW,OAAA,EAAgB;AAEjC,EAAA,SAAS,SAAA,CAAU,KAAc,KAAA,EAAwB;AACvD,IAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,OAAO,GAAA,KAAQ,UAAU,OAAO,GAAA;AAEpD,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,GAAa,CAAA,EAAG,OAAO,YAAA;AACpC,IAAA,IAAA,CAAK,IAAI,GAAa,CAAA;AAEtB,IAAA,IAAI,QAAA,KAAa,MAAA,IAAa,KAAA,IAAS,QAAA,EAAU,OAAO,YAAA;AAExD,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACtB,MAAA,MAAM,MAAiB,EAAC;AACxB,MAAA,KAAA,MAAW,QAAQ,GAAA,EAAK;AACtB,QAAA,GAAA,CAAI,IAAA,CAAK,SAAA,CAAU,IAAA,EAAM,KAAA,GAAQ,CAAC,CAAC,CAAA;AAAA,MACrC;AACA,MAAA,IAAA,CAAK,OAAO,GAAa,CAAA;AACzB,MAAA,OAAO,GAAA;AAAA,IACT;AAEA,IAAA,MAAM,MAA+B,EAAC;AACtC,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,GAA8B,CAAA,EAAG;AACrE,MAAA,GAAA,CAAI,GAAG,CAAA,GAAI,SAAA,CAAU,CAAA,EAAG,QAAQ,CAAC,CAAA;AAAA,IACnC;AACA,IAAA,IAAA,CAAK,OAAO,GAAa,CAAA;AACzB,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,GAAO,SAAA,CAAU,KAAA,EAAO,CAAC,CAAA;AAC/B,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,IAAA,EAAM,QAAA,EAAsD,KAAK,CAAA;AAAA,EACzF,SAAS,KAAA,EAAO;AACd,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,EAAE,KAAA,EAAO,6BAA6B,CAAA;AAAA,EAC9D;AACF","file":"index.cjs","sourcesContent":["import type { SafeParseResult, StringifyOptions } from './types.js';\n\nexport function safeParse<T = unknown>(input: string): SafeParseResult<T> {\n  try {\n    const data = JSON.parse(input) as T;\n    return { ok: true, data };\n  } catch (error) {\n    return {\n      ok: false,\n      error: error instanceof Error ? error : new Error(String(error)),\n    };\n  }\n}\n\nexport function safeStringify(\n  value: unknown,\n  options: StringifyOptions = {},\n): string {\n  const { maxDepth, replacer, space } = options;\n  const seen = new WeakSet<object>();\n\n  function serialize(val: unknown, depth: number): unknown {\n    if (val === null || typeof val !== 'object') return val;\n\n    if (seen.has(val as object)) return '[Circular]';\n    seen.add(val as object);\n\n    if (maxDepth !== undefined && depth >= maxDepth) return '[MaxDepth]';\n\n    if (Array.isArray(val)) {\n      const arr: unknown[] = [];\n      for (const item of val) {\n        arr.push(serialize(item, depth + 1));\n      }\n      seen.delete(val as object);\n      return arr;\n    }\n\n    const obj: Record<string, unknown> = {};\n    for (const [key, v] of Object.entries(val as Record<string, unknown>)) {\n      obj[key] = serialize(v, depth + 1);\n    }\n    seen.delete(val as object);\n    return obj;\n  }\n\n  try {\n    const safe = serialize(value, 0);\n    return JSON.stringify(safe, replacer as (key: string, value: unknown) => unknown, space);\n  } catch (error) {\n    return JSON.stringify({ error: 'Failed to stringify value' });\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+interface SafeParseResult<T> {
+    ok: boolean;
+    data?: T;
+    error?: Error;
+}
+interface StringifyOptions {
+    maxDepth?: number;
+    replacer?: (key: string, value: unknown) => unknown;
+    space?: number;
+}
+
+declare function safeParse<T = unknown>(input: string): SafeParseResult<T>;
+declare function safeStringify(value: unknown, options?: StringifyOptions): string;
+
+export { type SafeParseResult, type StringifyOptions, safeParse, safeStringify };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+interface SafeParseResult<T> {
+    ok: boolean;
+    data?: T;
+    error?: Error;
+}
+interface StringifyOptions {
+    maxDepth?: number;
+    replacer?: (key: string, value: unknown) => unknown;
+    space?: number;
+}
+
+declare function safeParse<T = unknown>(input: string): SafeParseResult<T>;
+declare function safeStringify(value: unknown, options?: StringifyOptions): string;
+
+export { type SafeParseResult, type StringifyOptions, safeParse, safeStringify };

package/dist/index.js

@@ -0,0 +1,46 @@
+// src/parse.ts
+function safeParse(input) {
+  try {
+    const data = JSON.parse(input);
+    return { ok: true, data };
+  } catch (error) {
+    return {
+      ok: false,
+      error: error instanceof Error ? error : new Error(String(error))
+    };
+  }
+}
+function safeStringify(value, options = {}) {
+  const { maxDepth, replacer, space } = options;
+  const seen = /* @__PURE__ */ new WeakSet();
+  function serialize(val, depth) {
+    if (val === null || typeof val !== "object") return val;
+    if (seen.has(val)) return "[Circular]";
+    seen.add(val);
+    if (maxDepth !== void 0 && depth >= maxDepth) return "[MaxDepth]";
+    if (Array.isArray(val)) {
+      const arr = [];
+      for (const item of val) {
+        arr.push(serialize(item, depth + 1));
+      }
+      seen.delete(val);
+      return arr;
+    }
+    const obj = {};
+    for (const [key, v] of Object.entries(val)) {
+      obj[key] = serialize(v, depth + 1);
+    }
+    seen.delete(val);
+    return obj;
+  }
+  try {
+    const safe = serialize(value, 0);
+    return JSON.stringify(safe, replacer, space);
+  } catch (error) {
+    return JSON.stringify({ error: "Failed to stringify value" });
+  }
+}
+
+export { safeParse, safeStringify };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse.ts"],"names":[],"mappings":";AAEO,SAAS,UAAuB,KAAA,EAAmC;AACxE,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC7B,IAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,IAAA,EAAK;AAAA,EAC1B,SAAS,KAAA,EAAO;AACd,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,KAAA,EAAO,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC;AAAA,KACjE;AAAA,EACF;AACF;AAEO,SAAS,aAAA,CACd,KAAA,EACA,OAAA,GAA4B,EAAC,EACrB;AACR,EAAA,MAAM,EAAE,QAAA,EAAU,QAAA,EAAU,KAAA,EAAM,GAAI,OAAA;AACtC,EAAA,MAAM,IAAA,uBAAW,OAAA,EAAgB;AAEjC,EAAA,SAAS,SAAA,CAAU,KAAc,KAAA,EAAwB;AACvD,IAAA,IAAI,GAAA,KAAQ,IAAA,IAAQ,OAAO,GAAA,KAAQ,UAAU,OAAO,GAAA;AAEpD,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,GAAa,CAAA,EAAG,OAAO,YAAA;AACpC,IAAA,IAAA,CAAK,IAAI,GAAa,CAAA;AAEtB,IAAA,IAAI,QAAA,KAAa,MAAA,IAAa,KAAA,IAAS,QAAA,EAAU,OAAO,YAAA;AAExD,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACtB,MAAA,MAAM,MAAiB,EAAC;AACxB,MAAA,KAAA,MAAW,QAAQ,GAAA,EAAK;AACtB,QAAA,GAAA,CAAI,IAAA,CAAK,SAAA,CAAU,IAAA,EAAM,KAAA,GAAQ,CAAC,CAAC,CAAA;AAAA,MACrC;AACA,MAAA,IAAA,CAAK,OAAO,GAAa,CAAA;AACzB,MAAA,OAAO,GAAA;AAAA,IACT;AAEA,IAAA,MAAM,MAA+B,EAAC;AACtC,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,GAA8B,CAAA,EAAG;AACrE,MAAA,GAAA,CAAI,GAAG,CAAA,GAAI,SAAA,CAAU,CAAA,EAAG,QAAQ,CAAC,CAAA;AAAA,IACnC;AACA,IAAA,IAAA,CAAK,OAAO,GAAa,CAAA;AACzB,IAAA,OAAO,GAAA;AAAA,EACT;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,GAAO,SAAA,CAAU,KAAA,EAAO,CAAC,CAAA;AAC/B,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,IAAA,EAAM,QAAA,EAAsD,KAAK,CAAA;AAAA,EACzF,SAAS,KAAA,EAAO;AACd,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,EAAE,KAAA,EAAO,6BAA6B,CAAA;AAAA,EAC9D;AACF","file":"index.js","sourcesContent":["import type { SafeParseResult, StringifyOptions } from './types.js';\n\nexport function safeParse<T = unknown>(input: string): SafeParseResult<T> {\n  try {\n    const data = JSON.parse(input) as T;\n    return { ok: true, data };\n  } catch (error) {\n    return {\n      ok: false,\n      error: error instanceof Error ? error : new Error(String(error)),\n    };\n  }\n}\n\nexport function safeStringify(\n  value: unknown,\n  options: StringifyOptions = {},\n): string {\n  const { maxDepth, replacer, space } = options;\n  const seen = new WeakSet<object>();\n\n  function serialize(val: unknown, depth: number): unknown {\n    if (val === null || typeof val !== 'object') return val;\n\n    if (seen.has(val as object)) return '[Circular]';\n    seen.add(val as object);\n\n    if (maxDepth !== undefined && depth >= maxDepth) return '[MaxDepth]';\n\n    if (Array.isArray(val)) {\n      const arr: unknown[] = [];\n      for (const item of val) {\n        arr.push(serialize(item, depth + 1));\n      }\n      seen.delete(val as object);\n      return arr;\n    }\n\n    const obj: Record<string, unknown> = {};\n    for (const [key, v] of Object.entries(val as Record<string, unknown>)) {\n      obj[key] = serialize(v, depth + 1);\n    }\n    seen.delete(val as object);\n    return obj;\n  }\n\n  try {\n    const safe = serialize(value, 0);\n    return JSON.stringify(safe, replacer as (key: string, value: unknown) => unknown, space);\n  } catch (error) {\n    return JSON.stringify({ error: 'Failed to stringify value' });\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@philiprehberger/safe-json",
+  "version": "0.1.5",
+  "description": "Safe JSON parsing and serialization with circular detection and depth limiting",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "node --test"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "json",
+    "parse",
+    "safe",
+    "circular",
+    "stringify",
+    "validation"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/philiprehberger/ts-safe-json.git"
+  },
+  "homepage": "https://github.com/philiprehberger/ts-safe-json#readme",
+  "bugs": {
+    "url": "https://github.com/philiprehberger/ts-safe-json/issues"
+  },
+  "author": "Philip Rehberger",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false
+}