Nyxj

Nyxj is a JSON engine and micro-services framework built in C. Version 2.0.0 turns it into a complete, production-oriented platform: a thread-safe core, a dozen data modules, a web framework with operations tooling, and a WebAssembly build.

Highlights

• Thread-safe RFC 8259 parser — no global state, strict UTF-8, JSON DoS limits
• Rich data modules — schema validation, JSONPath, JSON Patch/Merge, MessagePack, streaming SAX, lenient repair
• Web framework — Express-style router, middleware, TLS, OpenAPI/Swagger at /docs
• Operations tooling — Prometheus metrics, /health and /ready probes, heartbeat webhook, Eco-Throttle
• Runtime features — worker pool, embedded KV store with TTL, plugin system, gossip clustering
• WebAssembly build — run Nyxj in the browser or from Node.js
• SIMD acceleration — SSE2 on x86-64, NEON on AArch64, with scalar fallback

What’s new in v2.0.0

Nyxj 2.0.0 is a full rewrite. It changes the parser, adds a dozen data modules, a web framework with operations tooling, and a WebAssembly build — over 18,000 lines added since 1.0.0.

Core engine

• Thread-safe RFC 8259 parser with detailed error model (code, byte offset, line, column, message)
• JSON Denial-of-Service protection: max depth (512 by default), input size, string length, elements per container
• Relaxed mode accepting comments and trailing commas
• SIMD-accelerated whitespace and string scanning
• Arena allocator for O(1) tree release
• Builder API, dot-path getters, typed accessors, linear serializer with shortest round-trip numbers

Data modules

• JSON-to-struct mapping with a C code generator (nyxj gen-struct)
• JSON Schema validation (types, enums, $ref, combinators, constraints, formats)
• NyxQuery — JSONPath with recursive descent, wildcards, slices, filters
• Differential state — JSON Pointer, JSON Patch, JSON Merge Patch
• MessagePack encoder and decoder
• Streaming SAX parser with NDJSON support
• Heuristic repair of almost-JSON (comments, missing commas, Markdown fences)

Runtime and networking

• Worker thread pool with backpressure and adjustable concurrency
• Embedded key-value store with TTL, counters, snapshots
• Prometheus metrics and resource monitoring
• Express-style router with :params, wildcards, middleware chain, 405 handling, CORS
• HTTPS/TLS server and native HTTP/HTTPS client
• OpenAPI 3 document auto-generated and served with Swagger UI
• /health and /ready probes with X-NyxJ-Scale-Hint
• Eco-Throttle: worker concurrency reduced when CPU temperature or load crosses a threshold
• Safe-Gate reverse proxy for request sanitization
• Plugin system loading .so / .dll modules

Tooling

• nyxj CLI: validate, format, minify, get, query, repair, schema, diff, patch, msgpack, gen-struct, stream, tokens, gate, bench
• nyxj-server with every feature and JSON configuration
• WebAssembly build (make wasm) with browser demo
• 500+ test checks, CI on Linux x64/ARM64, macOS, Windows, sanitizers and WebAssembly

Recent releases

v1.0.0 (Apr 2026) — First stable release. Thread-safe tree-based parser, serialization, HTTP server via Mongoose, cross-platform builds.

Documentation

DOCUMENTATION.md is a complete, beginner-friendly guide — 36 chapters and appendices — that teaches Nyxj from JSON basics to production services. API and server quick references are in docs/.

For source-based installation, refer to the README.md in the repository.