ata-validator 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to ata-validator are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/), and this project adheres to semantic versioning.
 
+## 0.22.0 - 2026-07-14
+
+### Deprecated
+
+- `Validator.prototype.toStandalone()` and `Validator.prototype.toStandaloneModule()` now emit a one-time DeprecationWarning. Both will be removed in 1.0. The replacements have been stable since 0.19: `toStandaloneModule()`/`bundleStandalone()`/`bundleCompact()` from `ata-validator/build`, and the `Validator.bundle*()` statics.
+
+## 0.21.0 - 2026-06-01
+
+### Added
+
+- `errorMessage` keyword for custom error messages. A string on a subschema replaces the message for any failing keyword there; an object overrides per keyword, with `required` keyed by missing property name and `_` as fallback. `code`, `keyword`, and `path` fields are untouched. Schemas without `errorMessage` pay nothing; the override pass is only installed when one is present.
+- Async refinement: `t.refine(schema, fn, { message, path })` attaches an async (or sync) check that runs through `validateAsync`/`parseAsync` after structural validation passes. `new Validator(schema)` ignores the refinement marker, so plain structural validation is unchanged. Failing refinements surface as errors with `keyword: 'refine'`.
+
 ## 0.20.1 - 2026-05-27
 
 ### Fixed

package/build.d.ts

@@ -75,7 +75,7 @@ export function watch(opts: BuildOptions, onReport?: (r: BuildReport) => void):
 
 export interface BundleStandaloneOptions {
   format?: 'cjs' | 'esm';
-  formats?: Record<string, (value: unknown) => boolean>;
+  formats?: Record<string, (value: string) => boolean>;
   verbose?: boolean;
 }
 

package/index.d.ts

@@ -411,12 +411,16 @@ export interface Validator<T = unknown> {
   /** Single-thread NDJSON batch validation. Requires native addon. */
   isValidNDJSON(ndjsonBuffer: Buffer): boolean[];
 
-  /** Generate a standalone JS module string for zero-compile loading. Returns null if schema can't be standalone-compiled. */
+  /**
+   * Generate a standalone JS module string for zero-compile loading. Returns null if schema can't be standalone-compiled.
+   * @deprecated Removed in 1.0. Use `toStandaloneModule()` from `ata-validator/build` instead.
+   */
   toStandalone(): string | null;
 
   /**
    * Generate a self-contained module string with `validate`/`isValid` exports.
    * The output has zero runtime dependency on ata-validator.
+   * @deprecated Removed in 1.0. Use `toStandaloneModule()` from `ata-validator/build` instead.
    */
   toStandaloneModule(options?: { format?: 'esm' | 'cjs'; abortEarly?: boolean }): string | null;
 

package/index.js

@@ -446,6 +446,21 @@ function resolveSchemaForPreprocess(schema, schemaMap) {
   return cloned || s
 }
 
+// Deprecated-method warning: once per method name per process. Guarded so the
+// browser entry (no `process`) never touches it.
+const deprecationWarned = new Set();
+function warnDeprecated(method) {
+  if (deprecationWarned.has(method)) return;
+  deprecationWarned.add(method);
+  if (typeof process !== 'undefined' && typeof process.emitWarning === 'function') {
+    process.emitWarning(
+      `Validator.prototype.${method}() is deprecated and will be removed in ata-validator 1.0. ` +
+      `Use toStandaloneModule()/bundleStandalone() from 'ata-validator/build' instead.`,
+      'DeprecationWarning',
+    );
+  }
+}
+
 class Validator {
   constructor(schema, opts) {
     const options = opts || {};
@@ -1172,10 +1187,12 @@ class Validator {
   // bundlers swap `lib/aot.js` with `lib/aot.browser.js`, which throws a
   // pointed error instead of attempting to read source from disk.
   toStandalone() {
+    warnDeprecated('toStandalone');
     return require('./lib/aot').toStandalone(this);
   }
 
   toStandaloneModule(opts) {
+    warnDeprecated('toStandaloneModule');
     return require('./lib/aot').toStandaloneModule(this, opts);
   }
 

package/lib/aot-build.js

@@ -138,7 +138,7 @@ async function build(opts) {
         }
       }
       const schemaFile = path.relative(process.cwd(), input) || input;
-      const src = v.toStandaloneModule({
+      const src = aot.toStandaloneModule(v, {
         format,
         abortEarly: !!opts.abortEarly,
         source,

package/lib/version.js

@@ -7,4 +7,4 @@
 //
 // Kept in lockstep with package.json by `tests/test_version_sync.js`.
 
-module.exports = '0.21.0';
+module.exports = '0.22.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ata-validator",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "JSON Schema validation with first-class TypeScript and zero runtime cost. AOT compile to per-schema ESM modules with zero validator dependency. Generic Validator<T> for TypeBox/Zod/Valibot composition. Optional runtime API. Standard Schema V1 compatible.",
   "main": "index.js",
   "module": "index.mjs",
@@ -48,7 +48,7 @@
     "rebuild": "cmake-js rebuild --target ata",
     "prebuild": "pkg-prebuilds-copy --baseDir build/Release --source ata.node --name=ata --strip --napi_version=10",
     "prebuild-all": "npm run prebuild -- --arch x64 && npm run prebuild -- --arch arm64",
-    "test": "node test.js && node tests/test_no_native.js && node tests/test_browser_nofs.js && node tests/test_browser_imports_guard.js && node tests/test_version_sync.js && node tests/test_safe_regex_source_sync.js && node tests/test_t_builder.js && node tests/test_async_refine.js && node tests/test_safe_regex.js && node tests/test_safe_regex_integration.js && node tests/test_aot_build.js && node tests/test_aot_differential.js && node tests/test_aot_cli_build.js && node tests/test_aot_cli_smoke.js && node tests/test_bundle_standalone.js && node tests/test_standalone_anyof.js && node tests/test_standalone_formats.js && node tests/test_aot_additional_props_errors.js && node tests/test_id_anchor_refs.js && node tests/test_typed_validator_runner.js && node tests/test_define_schema.js && node tests/test_error_codes_lock.js && node tests/test_nullable.js && node tests/test_validate_and_parse.js && node tests/test_validate_data.js && node tests/test_enrich_error.js && node tests/test_rich_errors_optout.js && node tests/test_error_messages.js && node tests/test_source_positions.js && node tests/fuzz_positions.js && node tests/test_data_positions.js && node tests/test_render_shared.js && node tests/test_renderers.js && node tests/test_runtime_error_dx.js && node tests/test_aot_error_dx.js && node tests/test_abort_early.js && node tests/test_branch_collapse.js && node tests/test_suggestions.js && node tests/test_cli_validate.js && node tests/test_cli_version.js && node benchmark/bench_aot_size.mjs",
+    "test": "node test.js && node tests/test_deprecation_warnings.js && node tests/test_no_native.js && node tests/test_browser_nofs.js && node tests/test_browser_imports_guard.js && node tests/test_version_sync.js && node tests/test_safe_regex_source_sync.js && node tests/test_t_builder.js && node tests/test_async_refine.js && node tests/test_safe_regex.js && node tests/test_safe_regex_integration.js && node tests/test_aot_build.js && node tests/test_aot_differential.js && node tests/test_aot_cli_build.js && node tests/test_aot_cli_smoke.js && node tests/test_bundle_standalone.js && node tests/test_standalone_anyof.js && node tests/test_standalone_formats.js && node tests/test_aot_additional_props_errors.js && node tests/test_id_anchor_refs.js && node tests/test_typed_validator_runner.js && node tests/test_define_schema.js && node tests/test_error_codes_lock.js && node tests/test_nullable.js && node tests/test_validate_and_parse.js && node tests/test_validate_data.js && node tests/test_enrich_error.js && node tests/test_rich_errors_optout.js && node tests/test_error_messages.js && node tests/test_source_positions.js && node tests/fuzz_positions.js && node tests/test_data_positions.js && node tests/test_render_shared.js && node tests/test_renderers.js && node tests/test_runtime_error_dx.js && node tests/test_aot_error_dx.js && node tests/test_abort_early.js && node tests/test_branch_collapse.js && node tests/test_suggestions.js && node tests/test_cli_validate.js && node tests/test_cli_version.js && node benchmark/bench_aot_size.mjs",
     "bench:size": "node benchmark/bench_aot_size.mjs",
     "test:suite": "node tests/run_suite.js",
     "test:compat": "node tests/test_compat.js",
@@ -86,10 +86,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mertcanaltin/ata-validator.git"
+    "url": "git+https://github.com/ata-core/ata-validator.git"
   },
   "bugs": {
-    "url": "https://github.com/mertcanaltin/ata-validator/issues"
+    "url": "https://github.com/ata-core/ata-validator/issues"
   },
   "homepage": "https://ata-validator.com",
   "engines": {