dependencies.js 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aleksei Bespalov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# dependencies.js
+
+[![CI](https://github.com/nulldef/dependencies.js/actions/workflows/ci.yml/badge.svg)](https://github.com/nulldef/dependencies.js/actions/workflows/ci.yml)
+
+A lightweight dependency injection container for TypeScript/JavaScript.
+
+## Features
+
+- Simple decorator-based API (`@Injectable`, `@Inject`)
+- Automatic dependency resolution with singleton caching
+- Circular dependency detection with clear error messages
+- Zero configuration — just decorate and resolve
+
+## Installation
+
+```bash
+npm install dependencies.js
+```
+
+## Quick Start
+
+```typescript
+import { Inject, Injectable, container } from "dependencies.js"
+
+@Injectable()
+class Logger {
+  log(msg: string) {
+    console.log(msg)
+  }
+}
+
+@Injectable()
+@Inject(Logger)
+class UserService {
+  constructor(public logger: Logger) {}
+
+  greet(name: string) {
+    this.logger.log(`Hello, ${name}!`)
+  }
+}
+
+const userService = container.get(UserService)
+userService.greet("World")
+```
+
+## API
+
+### `@Injectable()`
+
+Registers a class in the default container.
+
+```typescript
+@Injectable()
+class MyService {}
+```
+
+### `@Inject(...deps)`
+
+Declares constructor dependencies for a class.
+
+```typescript
+@Injectable()
+@Inject(Database, Logger)
+class UserRepo {
+  constructor(
+    public db: Database,
+    public logger: Logger,
+  ) {}
+}
+```
+
+### `container`
+
+The default `Container` instance. Use it to resolve registered classes.
+
+```typescript
+const service = container.get(UserService)
+```
+
+### `Container`
+
+Create isolated containers when needed.
+
+```typescript
+import { Container } from "dependencies.js"
+
+const c = new Container()
+c.register(MyService)
+const instance = c.get(MyService)
+c.reset() // clears all registrations and cached instances
+```
+
+#### Methods
+
+| Method             | Description                                                  |
+| ------------------ | ------------------------------------------------------------ |
+| `get<T>(token)`    | Resolves and returns a singleton instance of the given class |
+| `register(target)` | Registers a class in the container                           |
+| `reset()`          | Clears all instances and registrations                       |
+
+## Requirements
+
+- TypeScript with decorators enabled
+- `reflect-metadata` (included as a dependency)
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,14 @@
+import "reflect-metadata";
+type Constructor<T = any> = new (...args: any[]) => T;
+export declare class Container {
+    private registry;
+    private instances;
+    get<T>(token: Constructor<T>, resolving?: Set<Constructor<any>>): T;
+    register(target: Constructor): void;
+    reset(): void;
+}
+export declare const container: Container;
+export declare const Injectable: () => <T extends Constructor>(target: T) => T;
+export declare const Inject: (...deps: Constructor[]) => <T extends Constructor>(target: T) => T;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAEzB,KAAK,WAAW,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAIrD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,SAAS,CAA8B;IAE/C,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,wBAAyB,GAAG,CAAC;IA2BpE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAInC,KAAK,IAAI,IAAI;CAId;AAED,eAAO,MAAM,SAAS,WAAkB,CAAA;AAExC,eAAO,MAAM,UAAU,SAEpB,CAAC,SAAS,WAAW,EAAE,QAAQ,CAAC,KAAG,CAGnC,CAAA;AAEH,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,WAAW,EAAE,MACnC,CAAC,SAAS,WAAW,EAAE,QAAQ,CAAC,KAAG,CAI5C,CAAA"}

package/index.js

@@ -0,0 +1,43 @@
+import "reflect-metadata";
+const DEPS_KEY = Symbol.for("di:dependencies");
+export class Container {
+    registry = new Set();
+    instances = new Map();
+    get(token, resolving = new Set()) {
+        if (this.instances.has(token)) {
+            return this.instances.get(token);
+        }
+        if (!this.registry.has(token)) {
+            throw new Error(`"${token.name}" is not registered. Did you forget @Injectable?`);
+        }
+        if (resolving.has(token)) {
+            const chain = [...resolving, token].map(t => t.name).join(" -> ");
+            throw new Error(`Circular dependency detected: ${chain}`);
+        }
+        resolving.add(token);
+        const deps = Reflect.getMetadata(DEPS_KEY, token) ?? [];
+        const resolvedDeps = deps.map(dep => this.get(dep, resolving));
+        resolving.delete(token);
+        const instance = new token(...resolvedDeps);
+        this.instances.set(token, instance);
+        return instance;
+    }
+    register(target) {
+        this.registry.add(target);
+    }
+    reset() {
+        this.instances.clear();
+        this.registry.clear();
+    }
+}
+export const container = new Container();
+export const Injectable = () => (target) => {
+    container.register(target);
+    return target;
+};
+export const Inject = (...deps) => {
+    return (target) => {
+        Reflect.defineMetadata(DEPS_KEY, deps, target);
+        return target;
+    };
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "dependencies.js",
+  "version": "1.0.0",
+  "description": "Dependencies.js is a JavaScript library that provides a simple and efficient way to manage dependencies in your projects. It allows you to define and resolve dependencies between modules, making it easier to organize and maintain your codebase.",
+  "repository": {
+    "url": "https://github.com/nulldef/dependencies.js",
+    "type": "git"
+  },
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "keywords": [],
+  "author": "Aleksei Bespalov <nulldefiner@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+    "@types/jest": "^30.0.0",
+    "@types/mocha": "^10.0.10",
+    "jest": "^30.3.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.9",
+    "typescript": "^6.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "cleanup": "rm -rf *.js *.d.ts *.map"
+  }
+}