DEV Community

Cover image for HazelJS Release Candidate 1: API Stability and Production Readiness
Muhammad Arslan
Muhammad Arslan

Posted on

HazelJS Release Candidate 1: API Stability and Production Readiness

We're releasing HazelJS Release Candidate 1 (RC1). From first beta to alpha to now: 38+ packages, a full AI-native stack, and API stability—we're one step away from 1.0. Here's everything we've achieved and what RC1 means for you.


Packages & Links


The Journey: Beta → Alpha → RC1

February 12, 2025 — First Beta

We shipped the first public beta on npm. Not a preview—real, installable packages. Core, AI, RAG, and agents. The idea: a Node.js framework where AI is built in, not bolted on. Early adopters tried it and gave us feedback we couldn't get from internal testing alone.

March 8, 2026 — First Alpha

Less than a month later: 38 packages in one ecosystem. From Beta to Alpha. We invited the community to try the full stack—run it, break it, tell us what to fix. Alpha was "here's the stack we're betting on."

March 13, 2026 — Release Candidate 1

RC1 means API stability. No breaking changes planned before 1.0. We've hardened the core, fixed issues from alpha feedback, improved docs and examples, and validated the stack under production-like conditions. You can deploy to production with confidence.


Achievements: What We've Built

AI & Intelligence (12 packages)

Package Achievement
@hazeljs/agent Production Agent Runtime. Stateful execution, tools, human-in-the-loop, memory, RAG. Think → Act → Persist loop with full event bus.
@hazeljs/ai Multi-provider LLM: OpenAI, Anthropic, Gemini, Cohere, Ollama. Streaming, function calling, embeddings. One API, no lock-in.
@hazeljs/rag End-to-end RAG: 11 loaders (PDF, Markdown, web, GitHub, YouTube), 5 vector stores (Pinecone, Qdrant, Weaviate, ChromaDB), GraphRAG, Agentic RAG decorators.
@hazeljs/memory Unified user memory. Profile, preference, behavioral, episodic, semantic. Postgres, Redis, vector backends. Shared by RAG and agents.
@hazeljs/guardrails PII redaction, prompt injection detection, toxicity checks, output validation. HTTP, AI, and agent integration. GDPR/CCPA ready.
@hazeljs/prompts Typed, versioned prompt templates.
@hazeljs/ops-agent AI DevOps: Jira, Slack, incident triage.
@hazeljs/pdf-to-audio PDF → audiobook with OpenAI TTS. Async queue, summaries.
@hazeljs/connectors RAG-ready: Google Drive, Slack, Notion, Confluence.
@hazeljs/crawler Web crawler for RAG. Sitemap, link following.
@hazeljs/mcp Model Context Protocol support.
@hazeljs/ml Model registry, training, inference.

Core & Infrastructure (10 packages)

Package Achievement
@hazeljs/core DI, routing, controllers, guards, interceptors, pipes, middleware. Graceful shutdown, health checks.
@hazeljs/config Environment-driven config with validation.
@hazeljs/gateway API gateway. Version routing, canary, traffic mirroring.
@hazeljs/resilience Circuit breakers, retries, bulkheads, rate limiters.
@hazeljs/discovery Service discovery, health checks, 6 load balancing strategies.
@hazeljs/serverless AWS Lambda, Vercel deployment.
@hazeljs/flow Durable workflows. Wait/resume, retries, audit trail.
@hazeljs/flow-runtime HTTP service for flow runs.
@hazeljs/event-emitter Event bus.
@hazeljs/queue Job queue (BullMQ).

Data & Auth (8 packages)

Package Achievement
@hazeljs/auth JWT, guards, role hierarchy.
@hazeljs/oauth OAuth 2.0 flows.
@hazeljs/casl CASL authorization. @Ability, @CheckPolicies.
@hazeljs/prisma Prisma integration, repositories.
@hazeljs/typeorm TypeORM integration.
@hazeljs/cache Multi-tier cache. In-memory, Redis.
@hazeljs/data Data pipelines, PII handling. @Pipeline, @Mask, @Encrypt.
@hazeljs/audit Audit logging. @Audit decorator.

APIs & Communication (5 packages)

Package Achievement
@hazeljs/swagger OpenAPI docs, interactive explorer.
@hazeljs/graphql GraphQL support.
@hazeljs/grpc gRPC servers. Decorator-based RPC.
@hazeljs/websocket WebSocket support.
@hazeljs/kafka Kafka consumers and producers.

Product & Operations (5 packages)

Package Achievement
@hazeljs/payment Multi-provider payments. Stripe first, extensible.
@hazeljs/feature-toggle Feature flags. @FeatureToggle, env seeding.
@hazeljs/cron Cron jobs.
@hazeljs/i18n Internationalization.
@hazeljs/cli 21+ generators. Controllers, modules, auth, RAG, agents.
@hazeljs/messaging Messaging abstractions.

Documentation & Guides


What RC1 Means

  1. API stability — No breaking changes planned before 1.0. Upgrade paths will be documented.
  2. Production ready — Deploy to production. The stack has been validated under real usage.
  3. One step to 1.0 — RC1 is the final testing phase. Report issues; we'll address them before 1.0.
  4. Full stack — AI, agents, RAG, memory, guardrails, auth, payment, microservices—all in one ecosystem.

Install RC1

npm install @hazeljs/core @hazeljs/ai @hazeljs/agent @hazeljs/rag
Enter fullscreen mode Exit fullscreen mode

Or with the CLI:

npx @hazeljs/cli new my-app
Enter fullscreen mode Exit fullscreen mode

Packages are published under the beta tag on npm (RC1 uses 0.2.x versioning). Stable 1.0 will use the latest tag.


What's Next

  • 1.0 — After RC1 feedback, we'll ship 1.0 with full stability guarantees and clear semantic versioning.
  • Migration guides — Documented upgrade paths from alpha/beta/RC1 to 1.0.
  • CommunityGitHub for issues and contributions. Discord for discussion.

Thank you for being part of the journey. From beta to alpha to RC1—and 1.0 is in sight.

— The HazelJS Team

Top comments (0)