@zyno-io/dk-server-foundationServer Foundation Library

Quick Start ​

npm install @zyno-io/dk-server-foundation
# or
yarn add @zyno-io/dk-server-foundation

import { createApp, BaseAppConfig, createMySQLDatabase } from '@zyno-io/dk-server-foundation';

class AppConfig extends BaseAppConfig {
    MY_SETTING!: string;
}

class MyDB extends createMySQLDatabase({}, [UserEntity]) {}

const app = createApp({
    config: AppConfig,
    db: MyDB,
    cors: config => ({ hosts: ['https://example.com'], credentials: true }),
    controllers: [UserController],
    providers: [UserService]
});

app.run();

DevConsole Screenshots ​

The built-in DevConsole provides a comprehensive development dashboard:

Dashboard ​

Routes ​

OpenAPI Schema ​

HTTP Requests ​

SRPC ​

Database ​

Health Checks ​

Mutex Monitor ​

Interactive REPL ​

Workers ​

Features at a Glance ​

• Application Factory: createApp() sets up Deepkit with opinionated defaults
• Configuration: Environment-based config with @zyno-io/config integration
• Database: Extends Deepkit ORM with MySQL/PostgreSQL support, transaction hooks, and session locks
• HTTP: Custom kernel with middleware, CORS, uploads, and error handling
• Workers: BullMQ background job processing with @WorkerJob() decorator
• SRPC: Bidirectional WebSocket RPC with HMAC authentication
• Leader Election: Redis-based distributed leader election for single-instance tasks
• Mesh Networking: Typed RPC between distributed application instances
• Mail: Email via Postmark or SMTP with template system
• Telemetry: OpenTelemetry and Sentry integration
• Testing: Comprehensive test utilities and fixtures
• CLI Tools: REPL, provider invoke, migration commands, and more

License ​

MIT License - see LICENSE for details.