toolcraft-schema 0.0.307 → 0.0.309

package/README.md

@@ -94,6 +94,13 @@ validate the complete object to enforce branch-dependent and combined constraint
 Both functions accept a `registry` for external schema documents without network
 fetching.
 
+`isJsonValue(value, options)` checks JSON data without invoking getters or
+serialization hooks. It rejects cycles, sparse arrays, non-finite numbers and
+non-JSON prototypes. Defaults bound the tree to 10,000 nodes and depth 64.
+Use `maxNodes` for larger bounded documents, or `maxDepth` (0–256) to choose a
+depth budget. Shared objects count once for each occurrence in the JSON tree;
+options never change other calls' budgets.
+
 ## Environment Variables
 
 This package exposes no environment variables.

package/dist/index.d.ts

@@ -182,6 +182,7 @@ export declare function toJsonSchema(schema: AnySchema): JsonSchema;
 export declare function toJsonSchemaDocument(schema: AnySchema, options?: JsonSchemaDocumentOptions): JsonSchemaDocument;
 export { Json, OneOf, RecordBuilder as Record, Union, isPlainRecord, validate };
 export { isJsonValue } from "./json.js";
+export type { JsonValueValidationOptions } from "./json.js";
 export { cloneDefaultValue } from "./clone-default.js";
 export { unicodeLength } from "./json-schema/utils.js";
 export { compileJsonSchema, formatIssues } from "./json-schema/index.js";

package/dist/json.d.ts

@@ -9,5 +9,9 @@ export interface JsonValueSchema extends SchemaBase<"json", JsonValue> {
     readonly enum?: readonly JsonValue[];
 }
 export declare function Json(options?: Omit<JsonValueSchema, "kind">): JsonValueSchema;
-export declare function isJsonValue(value: unknown): boolean;
+export interface JsonValueValidationOptions {
+    readonly maxNodes?: number;
+    readonly maxDepth?: number;
+}
+export declare function isJsonValue(value: unknown, options?: JsonValueValidationOptions): boolean;
 export {};

package/dist/json.js

@@ -4,11 +4,17 @@ export function Json(options = {}) {
         ...options,
     };
 }
-export function isJsonValue(value) {
+export function isJsonValue(value, options = {}) {
+    const maxNodes = options.maxNodes ?? 10_000;
+    const maxDepth = options.maxDepth ?? 64;
+    if (!Number.isSafeInteger(maxNodes) || maxNodes < 1)
+        throw new Error("maxNodes must be a positive safe integer");
+    if (!Number.isSafeInteger(maxDepth) || maxDepth < 0 || maxDepth > 256)
+        throw new Error("maxDepth must be an integer between 0 and 256");
     const ancestors = new Set();
     let nodes = 0;
     const visit = (item, depth) => {
-        if (++nodes > 10_000 || depth > 64)
+        if (++nodes > maxNodes || depth > maxDepth)
             return false;
         if (item === null || typeof item === "string" || typeof item === "boolean")
             return true;
@@ -35,7 +41,7 @@ export function isJsonValue(value) {
         ancestors.add(item);
         let valid = true;
         if (Array.isArray(item)) {
-            if (item.length > 10_000)
+            if (item.length > maxNodes)
                 valid = false;
             else
                 for (let index = 0; index < item.length; index++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-schema",
-  "version": "0.0.307",
+  "version": "0.0.309",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",