DWS Standard Library

The shared TypeScript toolkit behind Dominus Web Services. Everything lives in this monorepo, is built with Bun, and published on npm under the @dws-std/ scope.

Packages

Package	What it does
@dws-std/common	Common utilities and types library for building robust applications.
@dws-std/elysia-ratelimit	Elysia plugin for flexible, type-safe rate limiting with support for custom key generators and various backends.
@dws-std/error	Structured TypeScript exceptions with UUID v7 tracking, HTTP status codes, and automatic timestamps.
@dws-std/i18n	Type-safe i18n for TypeScript — define localized exception and message catalogs with compile-time validated parameters.
@dws-std/jwt	JWT utilities and helpers for secure token management.
@dws-std/kv-store	Type-safe key-value store abstraction with support for multiple backends.
@dws-std/registry	Centralized, type-safe registry for managing named instances.
@dws-std/totp	Time-based One-Time Password (TOTP) implementation in TypeScript.

Getting Started

bun install

Scripts

Command	What it does
bun run build	Build all packages
bun run test	Run every test suite
bun run lint	Lint all packages
bun run lint:fix	Lint and auto-fix
bun run docs	Generate TypeDoc documentation
bun run clean	Wipe node_modules, dist, and lock files

Project Structure

packages/
├── common/              # @dws-std/common
├── elysia-ratelimit/    # @dws-std/elysia-ratelimit
├── error/               # @dws-std/error
├── i18n/                # @dws-std/i18n
├── jwt/                 # @dws-std/jwt
├── kv-store/            # @dws-std/kv-store
├── registry/            # @dws-std/registry
└── totp/                # @dws-std/totp

Documentation

Dominus-Web-Service.github.io/packages

License

MIT - Dominus Web Services (DWS)