@praxisjs/di 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @praxisjs/di
 
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [fe39901]
+  - @praxisjs/core@0.4.1
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [f52354d]
+  - @praxisjs/core@0.4.0
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/__tests__/container.test.d.ts

@@ -0,0 +1,2 @@
+import "reflect-metadata";
+//# sourceMappingURL=container.test.d.ts.map

package/dist/__tests__/container.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/container.test.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC"}

package/dist/__tests__/container.test.js

@@ -0,0 +1,88 @@
+import "reflect-metadata";
+import { describe, it, expect } from "vitest";
+import { Container, Token, token } from "../container";
+describe("Token", () => {
+    it("stores description", () => {
+        const t = new Token("MY_SERVICE");
+        expect(t.description).toBe("MY_SERVICE");
+    });
+    it("toString includes description", () => {
+        const t = new Token("FOO");
+        expect(t.toString()).toBe("Token(FOO)");
+    });
+    it("token() factory creates a Token", () => {
+        const t = token("DB_URL");
+        expect(t).toBeInstanceOf(Token);
+        expect(t.description).toBe("DB_URL");
+    });
+});
+describe("Container", () => {
+    it("registers and resolves a singleton service", () => {
+        class MyService {
+        }
+        const c = new Container();
+        c.register(MyService);
+        const a = c.resolve(MyService);
+        const b = c.resolve(MyService);
+        expect(a).toBeInstanceOf(MyService);
+        expect(a).toBe(b); // singleton
+    });
+    it("creates new instance for transient scope", () => {
+        class Counter {
+            value = Math.random();
+        }
+        const c = new Container();
+        c.register(Counter, { scope: "transient" });
+        const a = c.resolve(Counter);
+        const b = c.resolve(Counter);
+        expect(a).not.toBe(b);
+    });
+    it("throws when resolving unregistered service", () => {
+        class Unknown {
+        }
+        const c = new Container();
+        expect(() => c.resolve(Unknown)).toThrow("[DI] Service not registered");
+    });
+    it("registerValue stores a value by token", () => {
+        const DB_URL = token("DB_URL");
+        const c = new Container();
+        c.registerValue(DB_URL, "postgres://localhost/db");
+        expect(c.resolve(DB_URL)).toBe("postgres://localhost/db");
+    });
+    it("registerFactory computes value via factory", () => {
+        const MAX = token("MAX");
+        const c = new Container();
+        c.registerFactory(MAX, () => 100);
+        expect(c.resolve(MAX)).toBe(100);
+    });
+    it("throws for unregistered token", () => {
+        const t = token("MISSING");
+        const c = new Container();
+        expect(() => c.resolve(t)).toThrow("[DI] Token not registered");
+    });
+    it("child container resolves from parent", () => {
+        const URL_TOKEN = token("URL");
+        const parent = new Container();
+        parent.registerValue(URL_TOKEN, "https://example.com");
+        const child = parent.createChild();
+        expect(child.resolve(URL_TOKEN)).toBe("https://example.com");
+    });
+    it("child container can override parent registration", () => {
+        const URL_TOKEN = token("URL");
+        const parent = new Container();
+        parent.registerValue(URL_TOKEN, "https://parent.com");
+        const child = parent.createChild();
+        child.registerValue(URL_TOKEN, "https://child.com");
+        expect(child.resolve(URL_TOKEN)).toBe("https://child.com");
+        expect(parent.resolve(URL_TOKEN)).toBe("https://parent.com");
+    });
+    it("register() is chainable", () => {
+        class A {
+        }
+        class B {
+        }
+        const c = new Container();
+        expect(c.register(A).register(B)).toBe(c);
+    });
+});
+//# sourceMappingURL=container.test.js.map

package/dist/__tests__/container.test.js.map

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

package/dist/__tests__/decorators.test.d.ts

@@ -0,0 +1,2 @@
+import "reflect-metadata";
+//# sourceMappingURL=decorators.test.d.ts.map

package/dist/__tests__/decorators.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/decorators.test.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC"}

package/dist/__tests__/decorators.test.js

@@ -0,0 +1,140 @@
+import "reflect-metadata";
+import { describe, it, expect, vi } from "vitest";
+import { Container, token } from "../container";
+import { Injectable, Inject, InjectContainer, useService, createScope, } from "../decorators";
+// Each test group uses a fresh container to avoid state pollution
+function makeScope() {
+    return new Container();
+}
+// ── Injectable ────────────────────────────────────────────────────────────────
+describe("Injectable", () => {
+    it("registers the class in the global container", () => {
+        // We test via useService resolving without throwing
+        class MyService {
+            greet() {
+                return "hello";
+            }
+        }
+        Injectable()(MyService, {});
+        const instance = useService(MyService);
+        expect(instance).toBeInstanceOf(MyService);
+        expect(instance.greet()).toBe("hello");
+    });
+    it("registers with transient scope", () => {
+        class TmpService {
+        }
+        Injectable({ scope: "transient" })(TmpService, {});
+        const a = useService(TmpService);
+        const b = useService(TmpService);
+        expect(a).not.toBe(b);
+    });
+});
+// ── Inject ────────────────────────────────────────────────────────────────────
+describe("Inject", () => {
+    it("injects a registered service via property", () => {
+        class Logger {
+            log(msg) {
+                return msg;
+            }
+        }
+        Injectable()(Logger, {});
+        const initializers = [];
+        const ctx = {
+            name: "logger",
+            kind: "field",
+            addInitializer(fn) {
+                initializers.push(fn);
+            },
+        };
+        Inject(Logger)(undefined, ctx);
+        const instance = {};
+        initializers.forEach((fn) => {
+            fn.call(instance);
+        });
+        expect(instance.logger).toBeInstanceOf(Logger);
+    });
+    it("throws a descriptive error when dep is not registered", () => {
+        class UnknownDep {
+        }
+        const initializers = [];
+        const ctx = {
+            name: "dep",
+            kind: "field",
+            addInitializer(fn) {
+                initializers.push(fn);
+            },
+        };
+        Inject(UnknownDep)(undefined, ctx);
+        class MyClass {
+            constructor() { }
+        }
+        const instance = new MyClass();
+        initializers.forEach((fn) => {
+            fn.call(instance);
+        });
+        expect(() => instance.dep).toThrow("[Inject]");
+    });
+    it("warns on direct assignment in non-production", () => {
+        class Dep2 {
+        }
+        Injectable()(Dep2, {});
+        const initializers = [];
+        const ctx = {
+            name: "dep2",
+            kind: "field",
+            addInitializer(fn) {
+                initializers.push(fn);
+            },
+        };
+        Inject(Dep2)(undefined, ctx);
+        const instance = {};
+        initializers.forEach((fn) => {
+            fn.call(instance);
+        });
+        const spy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        instance.dep2 = "override";
+        expect(spy).toHaveBeenCalledWith(expect.stringContaining("[Inject]"));
+        spy.mockRestore();
+    });
+});
+// ── InjectContainer ───────────────────────────────────────────────────────────
+describe("InjectContainer", () => {
+    it("injects the global container instance", () => {
+        const initializers = [];
+        const ctx = {
+            name: "container",
+            kind: "field",
+            addInitializer(fn) {
+                initializers.push(fn);
+            },
+        };
+        InjectContainer()(undefined, ctx);
+        const instance = {};
+        initializers.forEach((fn) => {
+            fn.call(instance);
+        });
+        expect(instance.container).toBeInstanceOf(Container);
+    });
+});
+// ── useService ────────────────────────────────────────────────────────────────
+describe("useService", () => {
+    it("resolves by Token", () => {
+        const VERSION = token("VERSION");
+        const c = createScope((sc) => sc.registerValue(VERSION, "1.0.0"));
+        // useService uses global container — test via token on a fresh child
+        expect(c.resolve(VERSION)).toBe("1.0.0");
+    });
+});
+// ── createScope ───────────────────────────────────────────────────────────────
+describe("createScope", () => {
+    it("creates a child container without configure fn", () => {
+        const child = createScope();
+        expect(child).toBeInstanceOf(Container);
+    });
+    it("applies the configure callback", () => {
+        const DB = token("DB");
+        const child = createScope((c) => c.registerValue(DB, "postgres://localhost"));
+        expect(child.resolve(DB)).toBe("postgres://localhost");
+    });
+});
+//# sourceMappingURL=decorators.test.js.map

package/dist/__tests__/decorators.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/di",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@praxisjs/core": "0.3.0"
+    "@praxisjs/core": "0.4.1"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",

package/src/__tests__/container.test.ts

@@ -0,0 +1,96 @@
+import "reflect-metadata";
+import { describe, it, expect } from "vitest";
+
+import { Container, Token, token } from "../container";
+
+describe("Token", () => {
+  it("stores description", () => {
+    const t = new Token("MY_SERVICE");
+    expect(t.description).toBe("MY_SERVICE");
+  });
+
+  it("toString includes description", () => {
+    const t = new Token("FOO");
+    expect(t.toString()).toBe("Token(FOO)");
+  });
+
+  it("token() factory creates a Token", () => {
+    const t = token<string>("DB_URL");
+    expect(t).toBeInstanceOf(Token);
+    expect(t.description).toBe("DB_URL");
+  });
+});
+
+describe("Container", () => {
+  it("registers and resolves a singleton service", () => {
+    class MyService {}
+    const c = new Container();
+    c.register(MyService);
+    const a = c.resolve(MyService);
+    const b = c.resolve(MyService);
+    expect(a).toBeInstanceOf(MyService);
+    expect(a).toBe(b); // singleton
+  });
+
+  it("creates new instance for transient scope", () => {
+    class Counter {
+      value = Math.random();
+    }
+    const c = new Container();
+    c.register(Counter, { scope: "transient" });
+    const a = c.resolve(Counter);
+    const b = c.resolve(Counter);
+    expect(a).not.toBe(b);
+  });
+
+  it("throws when resolving unregistered service", () => {
+    class Unknown {}
+    const c = new Container();
+    expect(() => c.resolve(Unknown)).toThrow("[DI] Service not registered");
+  });
+
+  it("registerValue stores a value by token", () => {
+    const DB_URL = token<string>("DB_URL");
+    const c = new Container();
+    c.registerValue(DB_URL, "postgres://localhost/db");
+    expect(c.resolve(DB_URL)).toBe("postgres://localhost/db");
+  });
+
+  it("registerFactory computes value via factory", () => {
+    const MAX = token<number>("MAX");
+    const c = new Container();
+    c.registerFactory(MAX, () => 100);
+    expect(c.resolve(MAX)).toBe(100);
+  });
+
+  it("throws for unregistered token", () => {
+    const t = token<string>("MISSING");
+    const c = new Container();
+    expect(() => c.resolve(t)).toThrow("[DI] Token not registered");
+  });
+
+  it("child container resolves from parent", () => {
+    const URL_TOKEN = token<string>("URL");
+    const parent = new Container();
+    parent.registerValue(URL_TOKEN, "https://example.com");
+    const child = parent.createChild();
+    expect(child.resolve(URL_TOKEN)).toBe("https://example.com");
+  });
+
+  it("child container can override parent registration", () => {
+    const URL_TOKEN = token<string>("URL");
+    const parent = new Container();
+    parent.registerValue(URL_TOKEN, "https://parent.com");
+    const child = parent.createChild();
+    child.registerValue(URL_TOKEN, "https://child.com");
+    expect(child.resolve(URL_TOKEN)).toBe("https://child.com");
+    expect(parent.resolve(URL_TOKEN)).toBe("https://parent.com");
+  });
+
+  it("register() is chainable", () => {
+    class A {}
+    class B {}
+    const c = new Container();
+    expect(c.register(A).register(B)).toBe(c);
+  });
+});

package/src/__tests__/decorators.test.ts

@@ -0,0 +1,173 @@
+import "reflect-metadata";
+import { describe, it, expect, vi } from "vitest";
+
+import { Container, token } from "../container";
+import {
+  Injectable,
+  Inject,
+  InjectContainer,
+  useService,
+  createScope,
+} from "../decorators";
+
+// Each test group uses a fresh container to avoid state pollution
+function makeScope() {
+  return new Container();
+}
+
+// ── Injectable ────────────────────────────────────────────────────────────────
+
+describe("Injectable", () => {
+  it("registers the class in the global container", () => {
+    // We test via useService resolving without throwing
+    class MyService {
+      greet() {
+        return "hello";
+      }
+    }
+    Injectable()(MyService, {} as ClassDecoratorContext);
+    const instance = useService(MyService);
+    expect(instance).toBeInstanceOf(MyService);
+    expect(instance.greet()).toBe("hello");
+  });
+
+  it("registers with transient scope", () => {
+    class TmpService {}
+    Injectable({ scope: "transient" })(TmpService, {} as ClassDecoratorContext);
+    const a = useService(TmpService);
+    const b = useService(TmpService);
+    expect(a).not.toBe(b);
+  });
+});
+
+// ── Inject ────────────────────────────────────────────────────────────────────
+
+describe("Inject", () => {
+  it("injects a registered service via property", () => {
+    class Logger {
+      log(msg: string) {
+        return msg;
+      }
+    }
+    Injectable()(Logger, {} as ClassDecoratorContext);
+
+    const initializers: Array<(this: unknown) => void> = [];
+    const ctx = {
+      name: "logger",
+      kind: "field" as const,
+      addInitializer(fn: (this: unknown) => void) {
+        initializers.push(fn);
+      },
+    } as ClassFieldDecoratorContext;
+
+    Inject(Logger)(undefined, ctx);
+
+    const instance: Record<string, unknown> = {};
+    initializers.forEach((fn) => {
+      fn.call(instance);
+    });
+
+    expect(instance.logger).toBeInstanceOf(Logger);
+  });
+
+  it("throws a descriptive error when dep is not registered", () => {
+    class UnknownDep {}
+
+    const initializers: Array<(this: unknown) => void> = [];
+    const ctx = {
+      name: "dep",
+      kind: "field" as const,
+      addInitializer(fn: (this: unknown) => void) {
+        initializers.push(fn);
+      },
+    } as ClassFieldDecoratorContext;
+
+    Inject(UnknownDep)(undefined, ctx);
+
+    class MyClass {
+      constructor() {}
+    }
+    const instance = new MyClass() as Record<string, unknown>;
+    initializers.forEach((fn) => {
+      fn.call(instance);
+    });
+
+    expect(() => instance.dep).toThrow("[Inject]");
+  });
+
+  it("warns on direct assignment in non-production", () => {
+    class Dep2 {}
+    Injectable()(Dep2, {} as ClassDecoratorContext);
+
+    const initializers: Array<(this: unknown) => void> = [];
+    const ctx = {
+      name: "dep2",
+      kind: "field" as const,
+      addInitializer(fn: (this: unknown) => void) {
+        initializers.push(fn);
+      },
+    } as ClassFieldDecoratorContext;
+
+    Inject(Dep2)(undefined, ctx);
+    const instance: Record<string, unknown> = {};
+    initializers.forEach((fn) => {
+      fn.call(instance);
+    });
+
+    const spy = vi.spyOn(console, "warn").mockImplementation(() => {});
+    instance.dep2 = "override";
+    expect(spy).toHaveBeenCalledWith(expect.stringContaining("[Inject]"));
+    spy.mockRestore();
+  });
+});
+
+// ── InjectContainer ───────────────────────────────────────────────────────────
+
+describe("InjectContainer", () => {
+  it("injects the global container instance", () => {
+    const initializers: Array<(this: unknown) => void> = [];
+    const ctx = {
+      name: "container",
+      kind: "field" as const,
+      addInitializer(fn: (this: unknown) => void) {
+        initializers.push(fn);
+      },
+    } as ClassFieldDecoratorContext;
+
+    InjectContainer()(undefined, ctx);
+    const instance: Record<string, unknown> = {};
+    initializers.forEach((fn) => {
+      fn.call(instance);
+    });
+
+    expect(instance.container).toBeInstanceOf(Container);
+  });
+});
+
+// ── useService ────────────────────────────────────────────────────────────────
+
+describe("useService", () => {
+  it("resolves by Token", () => {
+    const VERSION = token<string>("VERSION");
+    const c = createScope((sc) => sc.registerValue(VERSION, "1.0.0"));
+    // useService uses global container — test via token on a fresh child
+    expect(c.resolve(VERSION)).toBe("1.0.0");
+  });
+});
+
+// ── createScope ───────────────────────────────────────────────────────────────
+
+describe("createScope", () => {
+  it("creates a child container without configure fn", () => {
+    const child = createScope();
+    expect(child).toBeInstanceOf(Container);
+  });
+
+  it("applies the configure callback", () => {
+    const DB = token<string>("DB");
+    const child = createScope((c) =>
+      c.registerValue(DB, "postgres://localhost"),
+    );
+    expect(child.resolve(DB)).toBe("postgres://localhost");
+  });
+});