@goodie-ts/core

Runtime dependency injection container for goodie-ts.

Install

pnpm add @goodie-ts/core

Overview

This package provides the runtime container that resolves pre-built ComponentDefinition[] arrays generated by @goodie-ts/transformer. No reflection, no scanning — just a fast topological sort and lazy instantiation.

Key Exports

• ApplicationContext — DI container with create(), get(), getAsync(), getAll(), close()
• Goodie / GoodieBuilder — Bootstrap builder: Goodie.build(definitions).start()
• InjectionToken<T> — Typed token for interfaces, primitives, and generics
• ComponentDefinition<T> — Component descriptor with token, scope, factory, dependencies, and metadata
• buildInterceptorChain — AOP runtime: chains MethodInterceptor instances around a method
• wrapBeforeAdvice / wrapAfterAdvice — Adapt BeforeAdvice / AfterAdvice into MethodInterceptor
• MethodInterceptor, InvocationContext — AOP type contracts for interceptors

Usage

import { Goodie } from '@goodie-ts/core';
import { definitions } from './AppContext.generated.js';

const app = await Goodie.build(definitions).start();
const userService = app.context.get(UserService);

// When done:
await app.context.close();

API

• ApplicationContext.create(defs, options?) — async factory, evaluates conditional rules (@ConditionalOnProperty, @ConditionalOnEnv, @ConditionalOnMissingComponent) at runtime, then topo-sorts and validates the dependency graph
• ctx.get(token) — synchronous lookup (throws for unresolved async components)
• ctx.getAsync(token) — always safe for async factories
• ctx.getAll(token) — returns all components registered under a token
• ctx.close() — tears down the context

All missing dependency errors include fuzzy matching suggestions ("Did you mean: UserService?"), requiredBy context, and hints when a component was excluded by a conditional rule.

License

MIT