@c9up/ream

Rust-powered Node.js application framework. Convention over configuration with native performance.

@c9up/ream ships as a single package containing both the TypeScript framework and prebuilt Rust (NAPI) binaries — consumers never compile anything.

Features

• IoC Container — @Service(), @Inject(), auto-resolution, scopes
• Lifecycle — register → boot → start → ready → shutdown
• Router — fluent chaining, groups, params, guards, versioning
• Middleware pipeline — onion pattern, global + named, guard enforcement
• HTTP server — Rust Hyper via NAPI
• Event bus — in-process emitter with optional Redis store (@c9up/ream/events)
• Scheduler — cron/interval tasks via the @Schedule() decorator (Rust-backed)
• GraphQL & RPC — built-in GraphQL engine and typed RPC router
• Security primitives — signed cookies, HMAC, signed URLs, trusted-proxy config (request-filter security — XSS / CSRF / rate-limiting — lives in @c9up/blackhole)
• Error DX — structured errors, fuzzy matching, pipeline stage context
• Health check — Kubernetes-compatible /health endpoint
• Graceful shutdown — SIGTERM/SIGINT with drain timeout

Quick Start

import { Ignitor } from '@c9up/ream'

const app = new Ignitor({ port: 3000 })
  .httpServer()
  .routes((router) => {
    router.get('/hello/:name', async ({ params, response }) => {
      response.status(200).send(`Hello, ${params.name}!`)
    })
  })

await app.start()

Ecosystem

Every package is standalone and publishable on its own; they consume the Ream universe through the container, never via a static import.

| Package | Description | |---------|-------------| | @c9up/atlas | Data Mapper ORM | | @c9up/rune | Validation engine | | @c9up/warden | Authentication | | @c9up/sigil | Password hashing (argon2, bcrypt, scrypt) | | @c9up/blackhole | Security filter — XSS, CSRF, rate-limiting (Rust-native) | | @c9up/spectrum | Structured logging | | @c9up/rosetta | Internationalization (i18n) | | @c9up/chronos | Date/time & recurrence engine | | @c9up/atom | Exact decimal arithmetic | | @c9up/bay | Job queue (memory + Redis drivers) | | @c9up/echo | Cache (memory + Redis drivers) | | @c9up/archive | File storage (Local + S3-compatible) | | @c9up/rover | Mail transport (SMTP, log, pluggable) | | @c9up/nova | Web Push notifications (VAPID) | | @c9up/relay | Realtime transport (SSE + WebSocket) | | @c9up/aurora | Reactive UI runtime (SSR + hydration) | | @c9up/photon | Frontend rendering engine | | @c9up/inker | Server-side templating | | @c9up/station | Admin scaffolding | | @c9up/helix | Framework-agnostic test runtime | | @c9up/ream-cli | CLI & code generators (Rust binary, ream command) | | @c9up/ream-mcp | MCP server — agent-ready framework assistant |

License

MIT