README.md

---

Install

yarn add @digital-alchemy/core

Introduction

@digital-alchemy/core is a dependency-injection framework for TypeScript — no decorators, no reflection, no class hierarchy. Services are plain functions that receive their dependencies through a single typed parameter. The framework wires everything at boot time, with full type safety across your entire service graph.

Targets the latest ESModule syntax and runs on Bun, Deno, and modern Node.

At a glance

import { CreateApplication, TServiceParams } from "@digital-alchemy/core";

function HelloService({ logger, lifecycle }: TServiceParams) {
  lifecycle.onReady(() => logger.info("hello world"));
}

const app = CreateApplication({
  name: "hello",
  services: { hello: HelloService },
});

await app.bootstrap();

What it does

• Service wiring - Automatic dependency injection with full type safety
• Configuration - Load config from files, environment variables, CLI args
• Logging - Structured logging with customizable outputs
• Lifecycle hooks - Run code during app startup/shutdown
• Task scheduling - Cron jobs and timers
• Testing utilities - Mock and test your services easily

Questions / Issues?