@jetio/validator 1.0.1 → 1.0.3

package/README.md

@@ -363,28 +363,14 @@ For transparency, here are the keywords jet-validator intentionally does not sup
 
 ### Summary
 
-- **Compilation:** 10-27x faster than AJV (1.33ms vs 13.20ms average)
-- **Valid data validation:** 7% faster overall (2.44M vs 2.28M ops/sec)
-- **Invalid data validation:** 24% faster overall (4.15M vs 3.36M ops/sec)
-- **Win rate:** 49.2% on valid data, 66.2% on invalid data
-- **Overall winner:** 71.8% of all benchmarks
+🚀 **Compilation:** 19x faster (1.47ms vs 28.29ms)
+✅ **Valid Data:** 58% win rate (36/62)
+🛡️ **Invalid Data:** 73% win rate (45/62)
+🏆 **Overall:** 72% win rate (89/124)
 
-**Key Wins:**
+[📊 Full Benchmark Report](https://github.com/official-jetio/validator/blob/main/benchmarks/results/COMPARISON.md) | [📈 Detailed Results](https://github.com/official-jetio/validator/tree/main/benchmarks/results/)
 
-- Composition operations: 240-284% faster
-- Pattern matching: Up to 88% faster
-- Integer validation: 48-120% faster
-- Object validation at scale: 28-51% faster
-
-**Where AJV leads:**
-
-- Deeply chained $refs: 88% faster
-- Deep allOf chains: 68% faster
-- Complex conditionals: 36% faster
-
-[📊 Full Benchmark Report](https://github.com/official-jetio/validator/blob/main/benchmark/results/COMPARISON.md) | [📈 Detailed Results](https://github.com/official-jetio/validator/tree/main/benchmark/results/)
-
-_Tested against AJV v8.17.1 using official benchmarks with 65 schemas, 1000 warmups, 10000 iterations, 5 runs per test_
+_Tested against AJV v8.17.1 using official benchmarks with 65 schemas, 1000 warmups, 10000 iterations, 30 runs per test_
 
 ---
 
@@ -888,7 +874,6 @@ len_of("café"); // 4
 
 **Use case:** Validating `minLength`/`maxLength` for strings with emoji or special Unicode characters.
 
-**→ [See Full Utilities API Reference](https://github.com/official-jetio/validator/blob/main/DOCUMENTATION.md#utilities-api)**
 
 ---
 
@@ -910,18 +895,16 @@ const validate = jetValidator.compile(schema);
 
 **Benefits of switching:**
 
-- ⚡ 10-27x faster compilation
+- ⚡ 19x faster compilation
 - 📦 Smaller bundle size
-- 🎯 Built-in formats (no separate packages)
+- 🎯 Built-in formats and error messages (no separate packages)
 - ✨ Enhanced features (`elseIf`, better `$data`)
 
 **What's different:**
 
-- Error object structure (but more detailed)
-- Custom keywords use different API (more powerful)
-- Meta-schema setup is easier
-
-**→ [See Migration Guide](https://github.com/official-jetio/validator/blob/main/DOCUMENTATION.md#migration-from-ajv)**
+- Error object structure
+- Custom keywords use different API
+- Meta-schema setup with cli
 
 ---
 
@@ -939,7 +922,7 @@ const validate = jetValidator.compile(schema);
 ### Consider Alternatives If:
 
 ⚠️ You need 100% JSON Schema spec compliance (we're at 99.5%)  
-⚠️ You're already heavily invested in AJV ecosystem with custom plugins (we offer the same custom keywords but contexts are simpler and different, although much more easy to use and better)
+⚠️ You're already heavily invested in AJV ecosystem with custom plugins (we offer the same custom keywords but contexts are simpler and different, although much more easy to use)
 ⚠️ You need streaming validation for extremely large documents
 
 ---
@@ -951,7 +934,7 @@ const validate = jetValidator.compile(schema);
 jet-validator eliminates infinite recursion through a unique resolution approach. Unlike other validators that resolve references during traversal (causing stack overflow), jet-validator:
 
 1. **Collects** all references and identifiers
-2. **Assigns** unique function names to each location
+2. **Assigns** unique function names to each location when inlining is impossible
 3. **Resolves** references by replacing them with function calls
 
 This architecture enables both lightning-fast compilation and bulletproof circular reference handling.
@@ -965,14 +948,14 @@ This architecture enables both lightning-fast compilation and bulletproof circul
 Traditional validators:
 
 ```typescript
-// Slow: 20ms per compilation
+// Slow: 10-20ms per compilation
 const validate = ajv.compile(schema); // Must cache!
 ```
 
 jet-validator:
 
 ```typescript
-// Fast: 1-2ms per compilation
+// Fast: 0.7ms per compilation
 const validate = jetValidator.compile(schema); // Can recompile!
 ```
 
@@ -1141,7 +1124,7 @@ We welcome contributions! jet-validator is a community project and we appreciate
 ```bash
 # Clone the repo
 git clone https://github.com/official-jetio/validator
-cd jet-validator
+cd validator
 
 # Install dependencies
 npm install
@@ -1159,8 +1142,7 @@ npm run test:draft6
 npm run test
 
 # Run benchmarks
-npm run benchmark
-npm run benchmark:compare
+node --expose-gc --max-old-space-size=4096 --max-semi-space-size=64 benchmarks/jet-validator-benchmark.js
 ```
 
 ### Testing Philosophy
@@ -1174,7 +1156,7 @@ jet-validator uses the official [JSON Schema Test Suite](https://github.com/json
 3. Run the official test suite: `npm run test:draft2020-12` (or appropriate draft)
 4. Check compliance rate - aim to maintain or improve current 99.5%+ compliance
 
-**The test runner** (`tests/test-runner.ts`) validates against:
+**The test runner** (`tests/test.ts`) validates against:
 
 - 1,261+ tests for Draft 2020-12
 - 1,227+ tests for Draft 2019-09
@@ -1294,23 +1276,10 @@ We track bugs and feature requests using GitHub Issues.
 ---
 
 ## ⚠️ Benchmark Methodology & Hardware Notes
-
-The benchmarks took hours to run due to laptop hardware and the billions of operations performed. The `array100KItems` benchmark alone—validating 100K array items with 1,000 warmups, 10,000 iterations, and 5 runs—was particularly intensive.
-
 **Performance on Better Hardware:**
 
 Results will vary significantly on better hardware. While absolute numbers will improve across the board, jet-validator is expected to maintain its performance advantages, especially in compilation speed.
 
-**Implementation Differences:**
-
-Unlike AJV, jet-validator doesn't inline `$ref`s by default. This design choice:
-
-- Reduces code bloat
-- Enables proper tracing for `unevaluatedItems`/`unevaluatedProperties`
-- Maintains cleaner stack traces for debugging
-
-Optional inlining is a feature we plan to add in the future for users who prefer maximum runtime performance over bundle size.
-
 ---
 
 ## 🏆 Conclusion
@@ -1318,11 +1287,10 @@ Optional inlining is a feature we plan to add in the future for users who prefer
 jet-validator has proven itself as a strong contender for JSON Schema validation in the Node.js ecosystem, offering:
 
 ✅ **99.5% JSON Schema compliance** - More spec-compliant than AJV in many areas  
-✅ **10-27x faster compilation** - Game-changer for serverless  
-✅ **7% faster valid data** - Better average throughput  
-✅ **24% faster invalid data** - Better security posture  
-✅ **49% valid win rate** - More common-case wins  
-✅ **66% invalid win rate** - Dominant error detection
+🚀 **Compilation:** 19x faster (1.47ms vs 28.29ms) on average - Game-changer for serverless
+✅ **Valid Data:** 58% win rate (36/62)
+🛡️ **Invalid Data:** 73% win rate (45/62)
+🏆 **Overall:** 72% win rate (89/124)
 
 **jet-validator is the clear choice for:**
 
@@ -1331,12 +1299,10 @@ jet-validator has proven itself as a strong contender for JSON Schema validation
 - Real-world schema validation
 - Applications requiring fast compilation
 - Security-focused applications (invalid data detection)
-
-**Consider AJV for:**
-
-- Extremely deep composition chains (>10 levels)
 - Heavy reliance on complex $ref graphs
 - Schemas with complex conditional logic
+- Extremely deep composition chains (>10 levels)
+
 
 ---
 
@@ -1355,7 +1321,7 @@ MIT © [Great Venerable](https://github.com/greatvenerable)
 - **[npm Package](https://www.npmjs.com/package/@jetio/validator)**
 - **[GitHub Repository](https://github.com/@jetio/validator)**
 - **[Complete Documentation (20k+ lines)](https://github.com/official-jetio/validator/blob/main/DOCUMENTATION.md)**
-- **[Benchmark Results](https://github.com/official-jetio/validator/blob/main/benchmark/results/COMPARISON.md)**
+- **[Benchmark Results](https://github.com/official-jetio/validator/blob/main/benchmarks/results/COMPARISON.md)**
 - **[Issue Tracker](https://github.com/official-jetio/validator/issues)**
 - **[GitHub Discussions](https://github.com/official-jetio/validator/discussions)**
 

package/dist/compileSchema.d.ts

@@ -66,7 +66,6 @@ export declare class Compiler {
     private jetValidator;
     private notLogic;
     private noreturn;
-    private neutralError;
     private compileContext;
     private standAlone;
     private hasCompileKeyword;