@jarenjs/validate 0.43.1 → 0.43.3

package/dist/types/index.d.ts

@@ -330,6 +330,7 @@ export type JSONSchemaKeywords = {
     data?: DataKeywordSchema;
 };
 export type JSONSchema = JSONSchemaKeywords & Record<string, unknown>;
+export type JSONSchemaLike = JSONSchema | Record<string, unknown>;
 export type FormatCompiler = (schemaObj: ValidationObject, jsonSchema: JSONSchema & {
     format?: string;
 }) => ((data: unknown, dataPath?: string) => boolean) | undefined;
@@ -447,6 +448,18 @@ export type FormatCompiler = (schemaObj: ValidationObject, jsonSchema: JSONSchem
  * forms accept everything (`true`) or nothing (`false`).
  * @typedef {JSONSchemaKeywords & Record<string, unknown>} JSONSchema
  */
+/**
+ * A schema as a validator boundary ACCEPTS it. {@link JSONSchema}
+ * documents what a schema IS — typed keywords, open for extensions —
+ * but a schema held as a plain `Record<string, unknown>` map (the
+ * natural type for a document that crossed a wire or a package
+ * boundary) does not assign to that keyword intersection under strict
+ * TypeScript, and forcing the consumer to cast at every `compile` and
+ * `addSchema` call site teaches them to cast, which is worse than the
+ * looser parameter. The boundary methods accept this union; both arms
+ * are treated identically at runtime, which was always true.
+ * @typedef {JSONSchema | Record<string, unknown>} JSONSchemaLike
+ */
 /**
  * A format compiler function.
  * Called once per schema location at compile time with the compiling
@@ -893,7 +906,7 @@ export declare class JarenValidator<TCollect extends boolean = false> {
      * Adds schema(s) to the validator instance.
      * This method does not compile schemas - it only registers them for reference.
      * Dependencies can be added in any order, and circular dependencies are supported.
-     * @param {JSONSchema | boolean | (JSONSchema | boolean)[]} schema - The schema(s) to add
+     * @param {JSONSchemaLike | boolean | (JSONSchemaLike | boolean)[]} schema - The schema(s) to add
      * @param {string} [key] - Optional key/URI to register the schema under
      * @returns {this} This validator instance for chaining (the polymorphic `this` keeps the collectErrors type parameter across a chain)
      * @example
@@ -906,18 +919,18 @@ export declare class JarenValidator<TCollect extends boolean = false> {
      * // Add with explicit key
      * validator.addSchema({ type: 'string' }, 'http://example.com/name');
      */
-    addSchema(schema: JSONSchema | boolean | (JSONSchema | boolean)[], key?: string): this;
+    addSchema(schema: JSONSchemaLike | boolean | (JSONSchemaLike | boolean)[], key?: string): this;
     static normalizeUriKey(key: any): any;
     /**
      * Adds meta-schema(s) that can be used to validate schemas.
      * Meta-schemas are schemas that describe the structure of valid JSON schemas.
-     * @param {JSONSchema | boolean | (JSONSchema | boolean)[]} schema - The meta-schema(s) to add
+     * @param {JSONSchemaLike | boolean | (JSONSchemaLike | boolean)[]} schema - The meta-schema(s) to add
      * @param {string} [key] - Optional key/URI for the meta-schema
      * @returns {this} This validator instance for chaining (the polymorphic `this` keeps the collectErrors type parameter across a chain)
      * @example
      * validator.addMetaSchema(draft7MetaSchema, 'http://json-schema.org/draft-07/schema');
      */
-    addMetaSchema(schema: JSONSchema | boolean | (JSONSchema | boolean)[], key?: string): this;
+    addMetaSchema(schema: JSONSchemaLike | boolean | (JSONSchemaLike | boolean)[], key?: string): this;
     /**
      * Retrieves a registered schema by its key/URI.
      * @param {string} key - The schema URI/key
@@ -927,13 +940,13 @@ export declare class JarenValidator<TCollect extends boolean = false> {
     /**
      * Validates a schema against a registered meta-schema.
      * This is used to ensure schemas are valid according to the JSON Schema specification.
-     * @param {JSONSchema | boolean} schema - The schema to validate
+     * @param {JSONSchemaLike | boolean} schema - The schema to validate
      * @returns {boolean} True if the schema is valid
      * @example
      * validator.addMetaSchema(draft7MetaSchema);
      * const isValid = validator.validateSchema({ type: 'string' }); // true
      */
-    validateSchema(schema: JSONSchema | boolean): boolean;
+    validateSchema(schema: JSONSchemaLike | boolean): boolean;
     /**
      * Compiles a schema into a validation function.
      * This is the main method for creating validators. It resolves all $ref references,
@@ -945,8 +958,8 @@ export declare class JarenValidator<TCollect extends boolean = false> {
      * what a checked contract wrapper wants; pair it with a schema-to-type
      * generator if you need the shape derived mechanically.
      * @template [T=unknown]
-     * @param {JSONSchema | boolean} schema - The schema to compile
-     * @param {(JSONSchema | boolean)[]} [schemas] - Additional schemas to reference during compilation
+     * @param {JSONSchemaLike | boolean} schema - The schema to compile
+     * @param {(JSONSchemaLike | boolean)[]} [schemas] - Additional schemas to reference during compilation
      * @returns {TCollect extends true ? CompiledCollector : CompiledPredicate<T>} A validation function
      * @example
      * const validate = validator.compile({
@@ -968,5 +981,5 @@ export declare class JarenValidator<TCollect extends boolean = false> {
      * const result = collecting.compile(schema)({ name: 123 });
      * // result = { valid: false, errors: [...] }
      */
-    compile<T = unknown>(schema: JSONSchema | boolean, schemas?: (JSONSchema | boolean)[]): TCollect extends true ? CompiledCollector : CompiledPredicate<T>;
+    compile<T = unknown>(schema: JSONSchemaLike | boolean, schemas?: (JSONSchemaLike | boolean)[]): TCollect extends true ? CompiledCollector : CompiledPredicate<T>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jarenjs/validate",
   "private": false,
-  "version": "0.43.1",
+  "version": "0.43.3",
   "type": "module",
   "main": "./src/index.js",
   "types": "./dist/types/index.d.ts",
@@ -55,7 +55,7 @@
     "prepack": "npm run build:types"
   },
   "dependencies": {
-    "@jarenjs/core": "^0.43.1",
-    "@jarenjs/json": "^0.43.1"
+    "@jarenjs/core": "^0.43.3",
+    "@jarenjs/json": "^0.43.3"
   }
 }

package/src/index.js

@@ -168,6 +168,19 @@ export { TraverseOptions };
  * @typedef {JSONSchemaKeywords & Record<string, unknown>} JSONSchema
  */
 
+/**
+ * A schema as a validator boundary ACCEPTS it. {@link JSONSchema}
+ * documents what a schema IS — typed keywords, open for extensions —
+ * but a schema held as a plain `Record<string, unknown>` map (the
+ * natural type for a document that crossed a wire or a package
+ * boundary) does not assign to that keyword intersection under strict
+ * TypeScript, and forcing the consumer to cast at every `compile` and
+ * `addSchema` call site teaches them to cast, which is worse than the
+ * looser parameter. The boundary methods accept this union; both arms
+ * are treated identically at runtime, which was always true.
+ * @typedef {JSONSchema | Record<string, unknown>} JSONSchemaLike
+ */
+
 /**
  * A format compiler function.
  * Called once per schema location at compile time with the compiling
@@ -1420,7 +1433,7 @@ export class JarenValidator {
    * Adds schema(s) to the validator instance.
    * This method does not compile schemas - it only registers them for reference.
    * Dependencies can be added in any order, and circular dependencies are supported.
-   * @param {JSONSchema | boolean | (JSONSchema | boolean)[]} schema - The schema(s) to add
+   * @param {JSONSchemaLike | boolean | (JSONSchemaLike | boolean)[]} schema - The schema(s) to add
    * @param {string} [key] - Optional key/URI to register the schema under
    * @returns {this} This validator instance for chaining (the polymorphic `this` keeps the collectErrors type parameter across a chain)
    * @example
@@ -1569,7 +1582,7 @@ export class JarenValidator {
   /**
    * Adds meta-schema(s) that can be used to validate schemas.
    * Meta-schemas are schemas that describe the structure of valid JSON schemas.
-   * @param {JSONSchema | boolean | (JSONSchema | boolean)[]} schema - The meta-schema(s) to add
+   * @param {JSONSchemaLike | boolean | (JSONSchemaLike | boolean)[]} schema - The meta-schema(s) to add
    * @param {string} [key] - Optional key/URI for the meta-schema
    * @returns {this} This validator instance for chaining (the polymorphic `this` keeps the collectErrors type parameter across a chain)
    * @example
@@ -1623,7 +1636,7 @@ export class JarenValidator {
   /**
    * Validates a schema against a registered meta-schema.
    * This is used to ensure schemas are valid according to the JSON Schema specification.
-   * @param {JSONSchema | boolean} schema - The schema to validate
+   * @param {JSONSchemaLike | boolean} schema - The schema to validate
    * @returns {boolean} True if the schema is valid
    * @example
    * validator.addMetaSchema(draft7MetaSchema);
@@ -1806,8 +1819,8 @@ export class JarenValidator {
    * what a checked contract wrapper wants; pair it with a schema-to-type
    * generator if you need the shape derived mechanically.
    * @template [T=unknown]
-   * @param {JSONSchema | boolean} schema - The schema to compile
-   * @param {(JSONSchema | boolean)[]} [schemas] - Additional schemas to reference during compilation
+   * @param {JSONSchemaLike | boolean} schema - The schema to compile
+   * @param {(JSONSchemaLike | boolean)[]} [schemas] - Additional schemas to reference during compilation
    * @returns {TCollect extends true ? CompiledCollector : CompiledPredicate<T>} A validation function
    * @example
    * const validate = validator.compile({