biorate

Biorate core

A monorepo of 56 reusable TypeScript packages published under the @biorate/* scope for backend services: IoC and inversion, layered configuration (files, env, Vault), transport and messaging connectors (Kafka, AMQP, HTTP proxy, schema registry), storage adapters (PostgreSQL, MongoDB, Redis, ClickHouse, MSSQL, MinIO, OpenSearch), observability (Prometheus, OpenTelemetry), NestJS integration, and testing/code-generation tooling (Vitest, Mocha, Playwright, unimock, hygen). Every package ships CJS and ESM builds with type declarations and is covered by the generated API reference.

Donate on Boosty

Donations are voluntary and do not constitute consideration for any goods or services; they grant no rights to the code or priority in decision-making, and the project is provided AS IS under its license.

Requirements

  • Node.js >= 20.20.0
  • npm, pnpm, or yarn — any workspace-aware package manager

Install

Packages are published independently — install only the ones you need:

pnpm add @biorate/config
# or
npm install @biorate/config
# or
yarn add @biorate/config

Repository layout

Path Purpose
packages/@biorate/<name>/ Published @biorate/* packages
.tools/* Internal workspaces (not published)
.scripts/ Shared build scripts
docs/ Generated API reference and documentation sites
openspec/ Spec-driven change artifacts

Development

npm install           # install workspace dependencies
npm run build # build every package (CJS, ESM, types)
npm run test # run the test suites
npm run lint # lint every package
npm run format # check formatting
npm run doc # regenerate the TypeDoc API reference in docs/
npm run docs # build per-package documentation sites (e.g. hygen)

pnpm and yarn work as well — the scripts are plain npm scripts.

A single package can be targeted with a workspace filter, for example npm run test --workspace @biorate/config.

Modules

Every package is published independently; the links below point to the generated documentation.

Core and DI

Configuration

Transport and messaging

Storage

  • mongodb — MongoDB connector based on mongoose and typegoose
  • pg — PostgreSQL raw connector
  • mssql — MSSQL raw connector
  • redis — Redis connector
  • ioredis — IORedis connector
  • clickhouse — ClickHouse connector
  • minio — MinIO connector
  • opensearch — OpenSearch OOP interface
  • sequelize — Sequelize ORM connector
  • migrations — migrations tools

Observability

Testing and code generation

  • vitest — OOP test decorators for Vitest with Allure support
  • vitest-spec — Vitest spec helper
  • mocha — OOP tests based on @testdeck/core
  • mocha-spec — Mocha spec helper
  • playwright — OOP test decorators for Playwright
  • unimock — snapshot-based proxy mocking
  • hygen — scalable code generator (fork of jondot/hygen)

UI

Learn

Contributing

Repository conventions, the build and release flow, and the agent instructions live in AGENTS.md. Commits follow Conventional Commits; run pnpm run build and pnpm run test before opening a pull request.

Release History

See the CHANGELOG

License

MIT

Copyright (c) 2021-present Leonid Levkin (llevkin)