@praxisjs/di 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @praxisjs/di
+
+## 0.1.0
+
+### Minor Changes
+
+- aaf7dab: Initial beta release
+
+### Patch Changes
+
+- Updated dependencies [aaf7dab]
+  - @praxisjs/core@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+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/dist/container.d.ts

@@ -0,0 +1,29 @@
+export type Scope = "singleton" | "transient";
+export interface InjectableOptions {
+    scope?: Scope;
+}
+export interface ServiceDescriptor {
+    target: Constructor;
+    scope: Scope;
+    instance?: unknown;
+}
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+export declare class Token<_T> {
+    readonly description: string;
+    constructor(description: string);
+    toString(): string;
+}
+export declare function token<T>(description: string): Token<T>;
+export declare class Container {
+    private readonly services;
+    private readonly parent?;
+    constructor(parent?: Container);
+    register<T>(target: Constructor<T>, options?: InjectableOptions): this;
+    registerValue<T>(token: Token<T>, value: T): this;
+    registerFactory<T>(token: Token<T>, factory: (container: Container) => T): this;
+    resolve<T>(target: Constructor<T> | Token<T>): T;
+    private instantiate;
+    createChild(): Container;
+}
+export declare const container: Container;
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAErE,qBAAa,KAAK,CAAC,EAAE;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBACjB,WAAW,EAAE,MAAM;IAG/B,QAAQ;CAGT;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAEtD;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGrB;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY;gBAExB,MAAM,CAAC,EAAE,SAAS;IAI9B,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI;IAQ1E,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAKjD,eAAe,CAAC,CAAC,EACf,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,GACnC,IAAI;IAKP,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IA0BhD,OAAO,CAAC,WAAW;IAoBnB,WAAW,IAAI,SAAS;CAGzB;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/container.js

@@ -0,0 +1,69 @@
+export class Token {
+    constructor(description) {
+        this.description = description;
+    }
+    toString() {
+        return `Token(${this.description})`;
+    }
+}
+export function token(description) {
+    return new Token(description);
+}
+export class Container {
+    constructor(parent) {
+        this.services = new Map();
+        this.parent = parent;
+    }
+    register(target, options = {}) {
+        this.services.set(target, {
+            target,
+            scope: options.scope ?? "singleton",
+        });
+        return this;
+    }
+    registerValue(token, value) {
+        this.services.set(token, value);
+        return this;
+    }
+    registerFactory(token, factory) {
+        this.services.set(token, factory(this));
+        return this;
+    }
+    resolve(target) {
+        const entry = this.services.get(target);
+        if (target instanceof Token) {
+            if (entry !== undefined)
+                return entry;
+            if (this.parent)
+                return this.parent.resolve(target);
+            throw new Error(`[DI] Token not registered: ${target.toString()}`);
+        }
+        if (!entry) {
+            if (this.parent)
+                return this.parent.resolve(target);
+            throw new Error(`[DI] Service not registered: ${target.name}`);
+        }
+        const descriptor = entry;
+        if (descriptor.scope === "singleton") {
+            descriptor.instance ??= this.instantiate(descriptor.target);
+            return descriptor.instance;
+        }
+        return this.instantiate(descriptor.target);
+    }
+    instantiate(target) {
+        const deps = Reflect.getMetadata("di:inject", target) ?? [];
+        const resolvedDeps = deps.map((dep) => this.resolve(dep));
+        const instance = new target(...resolvedDeps);
+        const rawPropInjections = Reflect.getMetadata("di:props", target.prototype);
+        const propInjections = rawPropInjections ?? new Map();
+        for (const [prop, dep] of propInjections) {
+            instance[prop] = this.resolve(dep);
+        }
+        return instance;
+    }
+    createChild() {
+        return new Container(this);
+    }
+}
+export const container = new Container();
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"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"}

package/dist/decorators.d.ts

@@ -0,0 +1,7 @@
+import { type Container, Token, type Constructor, type InjectableOptions } from "./container";
+export declare function Injectable(options?: InjectableOptions): <T extends Constructor>(target: T) => T;
+export declare function Inject<T>(dep: Constructor<T> | Token<T>): (target: object, propertyKey: string) => void;
+export declare function InjectContainer(): (target: object, propertyKey: string) => void;
+export declare function useService<T>(dep: Constructor<T> | Token<T>): T;
+export declare function createScope(configure?: (c: Container) => void): Container;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAG,MAAM,aAAa,CAAC;AAE1G,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,IACvC,CAAC,SAAS,WAAW,EAAE,QAAQ,CAAC,KAAG,CAAC,CAItD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAGrC,QAAQ,MAAM,EAAE,aAAa,MAAM,KAAG,IAAI,CAiC5D;AAED,wBAAgB,eAAe,KACZ,QAAQ,MAAM,EAAE,aAAa,MAAM,KAAG,IAAI,CAS5D;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAE/D;AAED,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,GAAG,SAAS,CAIzE"}

package/dist/decorators.js

@@ -0,0 +1,56 @@
+import { container, Token } from "./container";
+export function Injectable(options = {}) {
+    return function (target) {
+        container.register(target, options);
+        return target;
+    };
+}
+export function Inject(dep) {
+    const cache = new WeakMap();
+    return function (target, propertyKey) {
+        Object.defineProperty(target, propertyKey, {
+            get() {
+                if (!cache.has(this)) {
+                    let resolved;
+                    try {
+                        resolved = container.resolve(dep);
+                    }
+                    catch (err) {
+                        throw new Error(`[Inject] Failed to resolve "${dep instanceof Token
+                            ? dep.toString()
+                            : dep.name}" in "${this.constructor.name}.${propertyKey}": ${err.message}`);
+                    }
+                    cache.set(this, resolved);
+                }
+                return cache.get(this);
+            },
+            set(_value) {
+                if (process.env.NODE_ENV !== "production") {
+                    console.warn(`[Inject] "${propertyKey}" is managed by the DI container and cannot be assigned directly.`);
+                }
+            },
+            enumerable: true,
+            configurable: true,
+        });
+    };
+}
+export function InjectContainer() {
+    return function (target, propertyKey) {
+        Object.defineProperty(target, propertyKey, {
+            get() {
+                return container;
+            },
+            enumerable: true,
+            configurable: true,
+        });
+    };
+}
+export function useService(dep) {
+    return container.resolve(dep);
+}
+export function createScope(configure) {
+    const child = container.createChild();
+    configure?.(child);
+    return child;
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,KAAK,EAA6C,MAAM,aAAa,CAAC;AAE1G,MAAM,UAAU,UAAU,CAAC,UAA6B,EAAE;IACxD,OAAO,UAAiC,MAAS;QAC/C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAI,GAA8B;IACtD,MAAM,KAAK,GAAG,IAAI,OAAO,EAAa,CAAC;IAEvC,OAAO,UAAU,MAAc,EAAE,WAAmB;QAClD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACzC,GAAG;gBACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrB,IAAI,QAAW,CAAC;oBAChB,IAAI,CAAC;wBACH,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAqB,CAAC,CAAC;oBACtD,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,IAAI,KAAK,CACb,+BACE,GAAG,YAAY,KAAK;4BAClB,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;4BAChB,CAAC,CAAE,GAAmB,CAAC,IAC3B,SAAU,IAA0C,CAAC,WAAW,CAAC,IAAI,IAAI,WAAW,MAAO,GAAa,CAAC,OAAO,EAAE,CACnH,CAAC;oBACJ,CAAC;oBACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC5B,CAAC;gBACD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAM,CAAC;YAC9B,CAAC;YAED,GAAG,CAAC,MAAe;gBACjB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;oBAC1C,OAAO,CAAC,IAAI,CACV,aAAa,WAAW,mEAAmE,CAC5F,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,MAAc,EAAE,WAAmB;QAClD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACzC,GAAG;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,GAA8B;IAC1D,OAAO,SAAS,CAAC,OAAO,CAAC,GAAqB,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAkC;IAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IACtC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import "reflect-metadata";
+export { Injectable, Inject, InjectContainer, useService, createScope, } from "./decorators";
+export { Container, container, Token, token } from "./container";
+export type { Scope, InjectableOptions, Constructor, ServiceDescriptor, } from "./container";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,UAAU,EACV,MAAM,EACN,eAAe,EACf,UAAU,EACV,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EACV,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+import "reflect-metadata";
+export { Injectable, Inject, InjectContainer, useService, createScope, } from "./decorators";
+export { Container, container, Token, token } from "./container";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,UAAU,EACV,MAAM,EACN,eAAe,EACf,UAAU,EACV,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@praxisjs/di",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "reflect-metadata": "^0.2.2",
+    "@praxisjs/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/src/container.ts

@@ -0,0 +1,112 @@
+export type Scope = "singleton" | "transient";
+
+export interface InjectableOptions {
+  scope?: Scope;
+}
+
+export interface ServiceDescriptor {
+  target: Constructor;
+  scope: Scope;
+  instance?: unknown;
+}
+
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+
+export class Token<_T> {
+  readonly description: string;
+  constructor(description: string) {
+    this.description = description;
+  }
+  toString() {
+    return `Token(${this.description})`;
+  }
+}
+
+export function token<T>(description: string): Token<T> {
+  return new Token<T>(description);
+}
+
+export class Container {
+  private readonly services = new Map<
+    Constructor | Token<unknown>,
+    unknown
+  >();
+  private readonly parent?: Container;
+
+  constructor(parent?: Container) {
+    this.parent = parent;
+  }
+
+  register<T>(target: Constructor<T>, options: InjectableOptions = {}): this {
+    this.services.set(target, {
+      target,
+      scope: options.scope ?? "singleton",
+    } satisfies ServiceDescriptor);
+    return this;
+  }
+
+  registerValue<T>(token: Token<T>, value: T): this {
+    this.services.set(token, value);
+    return this;
+  }
+
+  registerFactory<T>(
+    token: Token<T>,
+    factory: (container: Container) => T,
+  ): this {
+    this.services.set(token, factory(this));
+    return this;
+  }
+
+  resolve<T>(target: Constructor<T> | Token<T>): T {
+    const entry = this.services.get(target as Constructor | Token<unknown>);
+
+    if (target instanceof Token) {
+      if (entry !== undefined) return entry as T;
+      if (this.parent) return this.parent.resolve(target);
+      throw new Error(`[DI] Token not registered: ${target.toString()}`);
+    }
+
+    if (!entry) {
+      if (this.parent) return this.parent.resolve(target);
+      throw new Error(
+        `[DI] Service not registered: ${(target as Constructor).name}`,
+      );
+    }
+
+    const descriptor = entry as ServiceDescriptor;
+
+    if (descriptor.scope === "singleton") {
+      descriptor.instance ??= this.instantiate(descriptor.target);
+      return descriptor.instance as T;
+    }
+
+    return this.instantiate(descriptor.target) as T;
+  }
+
+  private instantiate<T>(target: Constructor<T>): T {
+    const deps: Array<Constructor | Token<unknown>> =
+      (Reflect.getMetadata("di:inject", target) as Array<Constructor | Token<unknown>> | undefined) ?? [];
+
+    const resolvedDeps = deps.map((dep) => this.resolve(dep as Constructor));
+    const instance = new target(...resolvedDeps);
+
+    const rawPropInjections: unknown = Reflect.getMetadata("di:props", target.prototype as object);
+    const propInjections =
+      (rawPropInjections as Map<string, Constructor | Token<unknown>> | undefined) ?? new Map<string, Constructor | Token<unknown>>();
+
+    for (const [prop, dep] of propInjections) {
+      (instance as Record<string, unknown>)[prop] = this.resolve(
+        dep as Constructor,
+      );
+    }
+
+    return instance;
+  }
+
+  createChild(): Container {
+    return new Container(this);
+  }
+}
+
+export const container = new Container();

package/src/decorators.ts

@@ -0,0 +1,68 @@
+import { container, type Container, Token, type Constructor, type InjectableOptions  } from "./container";
+
+export function Injectable(options: InjectableOptions = {}) {
+  return function <T extends Constructor>(target: T): T {
+    container.register(target, options);
+    return target;
+  };
+}
+
+export function Inject<T>(dep: Constructor<T> | Token<T>) {
+  const cache = new WeakMap<object, T>();
+
+  return function (target: object, propertyKey: string): void {
+    Object.defineProperty(target, propertyKey, {
+      get(this: object): T {
+        if (!cache.has(this)) {
+          let resolved: T;
+          try {
+            resolved = container.resolve(dep as Constructor<T>);
+          } catch (err) {
+            throw new Error(
+              `[Inject] Failed to resolve "${
+                dep instanceof Token
+                  ? dep.toString()
+                  : (dep as Constructor).name
+              }" in "${(this as { constructor: { name: string } }).constructor.name}.${propertyKey}": ${(err as Error).message}`,
+            );
+          }
+          cache.set(this, resolved);
+        }
+        return cache.get(this) as T;
+      },
+
+      set(_value: unknown): void {
+        if (process.env.NODE_ENV !== "production") {
+          console.warn(
+            `[Inject] "${propertyKey}" is managed by the DI container and cannot be assigned directly.`,
+          );
+        }
+      },
+
+      enumerable: true,
+      configurable: true,
+    });
+  };
+}
+
+export function InjectContainer() {
+  return function (target: object, propertyKey: string): void {
+    Object.defineProperty(target, propertyKey, {
+      get() {
+        return container;
+      },
+      enumerable: true,
+      configurable: true,
+    });
+  };
+}
+
+export function useService<T>(dep: Constructor<T> | Token<T>): T {
+  return container.resolve(dep as Constructor<T>);
+}
+
+export function createScope(configure?: (c: Container) => void): Container {
+  const child = container.createChild();
+  configure?.(child);
+  return child;
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+import "reflect-metadata";
+
+export {
+  Injectable,
+  Inject,
+  InjectContainer,
+  useService,
+  createScope,
+} from "./decorators";
+export { Container, container, Token, token } from "./container";
+export type {
+  Scope,
+  InjectableOptions,
+  Constructor,
+  ServiceDescriptor,
+} from "./container";

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}