Changelog

All notable changes to OqronKit are documented here. The format follows Keep a Changelog and Semantic Versioning.

---

v1.0.0 (Enterprise Release) — 2026-07-10

OqronKit v1 Enterprise Release — The industry-grade, framework-agnostic background processing and orchestration engine for Node.js. This release stabilizes the API surface around a class-based runtime and consolidates the core module offering into 6 production-ready background processing systems.

Major Changes & Architectural Evolution

• Class-Based Runtime (new Oqron): Shifted from global static state (OqronKit.init) to isolated, instance-driven runtimes. This enables cleaner testing, multi-instance setups, and explicit dependency injection.
• Discriminated Storage Modes: Replaced manual adapter boilerplate with three compile-time and runtime checked modes: 'memory', 'redis', and 'redis-postgres'.
• Uppercase Factories: Standardized on capital letters for all user-facing definitions (Queue, Worker, Cron, Schedule, Webhook, RateLimit, Cache) for better visual distinction from regular functions.
• Manual Import Registration: Removed filesystem trigger auto-discovery to prevent filesystem scanning overhead (vital for serverless/cold-start environments). Definition files are now evaluated on direct manual import prior to starting the engine.
• Embedded Batch Processing: Merged the standalone Batch module directly into the core Queue module. You can now define a high-performance processBatch handler on any queue using the DataLoader pattern.

Production-Ready Module Suite

1. Queue — Unified task queue with support for priority, delays, custom retries, and batch processing (processBatch).
2. Worker — Decoupled processor worker for high-performance job polling in distributed microservice architectures.
3. Cron — Schedule jobs using unix cron expressions, intervals, and missed fire recovery policies.
4. Schedule — Schedule one-shot or repeating calendar events (using RRule/iCal strings), with support for template .trigger() calls.
5. Webhook — Fan-out webhook dispatcher with dynamic endpoint resolution, HMAC cryptographic signing, and per-endpoint circuit breakers.
6. RateLimit — Enforce cluster-wide rate limits with sliding-window algorithms and multi-tier keys.
7. Cache — Two-tier (L1 RAM + L2 Storage) cache with single-flight deduping and cluster-wide stampede protection locks.

Core Hardening & Reliability

• Heartbeat Locks (guaranteedWorker: true): Out-of-the-box crash safety with automatic stall detection (~15s recovery).
• Graceful Shutdown: Captures termination signals, pauses consumers, drains active handlers, and cleanly shuts down connections.
• AbortController Integration: Context objects pass an AbortSignal to handlers allowing graceful execution abort on shutdown or cancellation.
• Environment Isolation: Partitions all persistence namespaces using ${project}:${environment} prefix to prevent collision.

---

v0.1.0 — 2026-04-12

Beta Preview

Initial beta preview introducing the adapter-driven execution engine, the unified broker interfaces, and the core scheduler tick loops.