jeffijoe/awilix
Awilix
Awilix is a JavaScript dependency injection framework and inversion of control container. It provides a centralized system for registering and resolving services, decoupling application components by automating how dependencies are created and passed to the functions or classes that require them.
The framework features an automatic module loader that scans the filesystem using glob patterns to register dependencies based on filenames and exports. It supports parameter-name-based injection and proxy-based resolution to manage how dependencies are delivered to constructors and functions.
The system manages object lifecycles through singleton and transient patterns, including hierarchical container scoping for request-specific state. It includes capabilities for resource disposal, dependency lifetime validation, and registration verification to ensure resolution correctness.
Features
- Dependency Injection Containers - Provides a centralized inversion of control container to decouple components and automate service resolution.
- Dependency Injection - Decouples application components by automating how services are created and passed to the classes or functions that need them.
- Dependency Lifecycle Management - Manages whether services are created as singletons or recreated on every request.
- Dependency Scoping - Generates child containers with private caches to allow for request-specific state scoping.
- Automatic Dependency Discovery - Implements an automatic module loader that scans the filesystem using glob patterns to register dependencies based on filenames and exports.
- Constructor Injection - Injects required dependencies into constructors and functions using parameter parsing or proxy objects.
- Dependency Injection - Maps identifiers to values, functions, or classes to be managed and injected across the application.
- Dependency Injection Frameworks - Implements a framework for decoupling components by registering and resolving services through a central registry.
- Dependency Resolution - Retrieves registered dependencies by name while utilizing type inference to ensure correct object shapes.
- Automatic Dependency Loaders - Ships a utility that scans the filesystem using glob patterns to automatically register classes and functions.
- Filesystem Scanning - Provides an automatic module loader that scans the filesystem using glob patterns to register dependencies.
- Inversion-of-Control Containers - Manages object lifecycles and dependencies via constructor injection and hierarchical scoped containers.
- Object Lifetime Management - Controls whether objects are recreated on every request, cached within a scope, or maintained as a singleton.
- Parameter-Name Injection - Resolves dependencies by parsing constructor or function parameter names and matching them to registered keys.
- Automatic Dependency Registrations - Automates the discovery and registration of services within the dependency injection container via filesystem scanning.
- Service Lifetime Scopes - Manages object instantiation cycles through singleton, scoped, and transient lifetimes.
- Scoped State Containers - Supports hierarchical container scoping to maintain private instance caches for request-specific state.
- Dependency Resource Disposal - Provides mechanisms to execute registered cleanup functions and clear resolver caches to close connection pools and other system resources.
- Lifetime Consistency Validation - Validates that dependencies do not have shorter lifetimes than the modules they are injected into to prevent stale data.
- Modular Architecture - Organizes large codebases by separating service definitions from their instantiation and wiring logic.
- Resolution Integrity Enforcement - Throws runtime errors when dependencies have shorter lifetimes than their ancestors or when singletons are registered in child scopes.
- Proxy-Based Resolution - Provides a proxy object to modules that dynamically resolves requested dependencies on demand.
- Recursive Dependency Resolution - Implements recursive resolution to construct complex dependency graphs for service instantiation.
- Resource Lifecycle Managers - Tracks instantiated dependencies and executes cleanup functions when a scope is destroyed.
