beforeConstruct -> beforeCreate, README

zheksoon · Apr 12, 2024 · 07000f0 · 07000f0
1 parent 070b9e1
commit 07000f0
Show file tree

Hide file tree

Showing 4 changed files with 23 additions and 7 deletions.
diff --git a/README.md b/README.md
@@ -419,6 +419,22 @@ const parentInstance = child.inject(ParentClass);
 const childInstance = child.inject(ChildClass);
 ```
 
+## Injection hooks
+
+When registering a class, you can provide hooks that will be called before the instance is created or injected:
+
+```typescript
+container.register({
+  class: MyClass,
+  beforeInject: (container, descriptor, args) => {
+    console.log("Before inject");
+  },
+  beforeCreate: (container, descriptor, args) => {
+    console.log("Before create");
+  },
+});
+```
+
 ## Async injection and circular dependencies
 
 When you have a circular dependency, there will be an error `Circular dependency detected`. To solve this problem, you can use async injection.

diff --git a/src/container.ts b/src/container.ts
@@ -60,8 +60,8 @@ export class Container {
     }
 
     if (!instance) {
-      if (descriptor.beforeConstruct) {
-        descriptor.beforeConstruct(this, descriptor, args);
+      if (descriptor.beforeCreate) {
+        descriptor.beforeCreate(this, descriptor, args);
       }
 
       instance = new cls(...args);

diff --git a/src/types.ts b/src/types.ts
@@ -29,7 +29,7 @@ type TokenType<T, R = any> = T extends Token<infer U> ? U : R;
 
 type BaseDescriptor = {
   beforeInject?: (container: Container, descriptor: AnyDescriptor, args: any[]) => any;
-  beforeConstruct?: (container: Container, descriptor: AnyDescriptor, args: any[]) => any;
+  beforeCreate?: (container: Container, descriptor: AnyDescriptor, args: any[]) => any;
 };
 
 export type TokenValueDescriptor<T extends Token<any>> = BaseDescriptor & {

diff --git a/test/dioma.test.ts b/test/dioma.test.ts
@@ -1676,7 +1676,7 @@ describe("Dioma", () => {
 
           container.register({
             class: TokenClass,
-            beforeConstruct: (container, descriptor, args) => {
+            beforeCreate: (container, descriptor, args) => {
               called = true;
               containerArg = container;
               descriptorArg = descriptor;
@@ -1711,7 +1711,7 @@ describe("Dioma", () => {
 
           container.register({
             class: TokenClass,
-            beforeConstruct: (container, descriptor, args) => {
+            beforeCreate: (container, descriptor, args) => {
               called += 1;
               containerArg = container;
               descriptorArg = descriptor;
@@ -1746,7 +1746,7 @@ describe("Dioma", () => {
 
           container.register({
             class: TokenClass,
-            beforeConstruct: (container, descriptor, args) => {
+            beforeCreate: (container, descriptor, args) => {
               called += 1;
               containerArg = container;
               descriptorArg = descriptor;
@@ -1781,7 +1781,7 @@ describe("Dioma", () => {
 
           container.register({
             class: TokenClass,
-            beforeConstruct: (container, descriptor, args) => {
+            beforeCreate: (container, descriptor, args) => {
               called += 1;
               containerArg = container;
               descriptorArg = descriptor;