@navios/di 0.4.2 → 0.5.0

package/coverage/src/utils/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">93.93% </span>
+                <span class="strong">94.94% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>155/165</span>
+                <span class='fraction'>188/198</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">95.12% </span>
+                <span class="strong">92% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>39/41</span>
+                <span class='fraction'>23/25</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">94.11% </span>
+                <span class="strong">88.88% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>16/17</span>
+                <span class='fraction'>8/9</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">93.93% </span>
+                <span class="strong">94.94% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>155/165</span>
+                <span class='fraction'>188/198</span>
             </div>
         
             
@@ -84,13 +84,13 @@
 	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
 	</td>
 	<td data-value="100" class="pct high">100%</td>
-	<td data-value="39" class="abs high">39/39</td>
+	<td data-value="73" class="abs high">73/73</td>
 	<td data-value="100" class="pct high">100%</td>
-	<td data-value="16" class="abs high">16/16</td>
+	<td data-value="0" class="abs high">0/0</td>
 	<td data-value="100" class="pct high">100%</td>
-	<td data-value="8" class="abs high">8/8</td>
+	<td data-value="0" class="abs high">0/0</td>
 	<td data-value="100" class="pct high">100%</td>
-	<td data-value="39" class="abs high">39/39</td>
+	<td data-value="73" class="abs high">73/73</td>
 	</tr>
 
 <tr>
@@ -129,13 +129,13 @@
 	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
 	</td>
 	<td data-value="100" class="pct high">100%</td>
-	<td data-value="4" class="abs high">4/4</td>
+	<td data-value="3" class="abs high">3/3</td>
 	<td data-value="100" class="pct high">100%</td>
 	<td data-value="0" class="abs high">0/0</td>
 	<td data-value="100" class="pct high">100%</td>
 	<td data-value="0" class="abs high">0/0</td>
 	<td data-value="100" class="pct high">100%</td>
-	<td data-value="4" class="abs high">4/4</td>
+	<td data-value="3" class="abs high">3/3</td>
 	</tr>
 
 <tr>
@@ -161,7 +161,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-19T12:38:51.382Z
+                at 2025-09-21T17:47:07.632Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/src/utils/index.mts.html

@@ -25,7 +25,7 @@
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>4/4</span>
+                <span class='fraction'>3/3</span>
             </div>
         
             
@@ -46,7 +46,7 @@
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>4/4</span>
+                <span class='fraction'>3/3</span>
             </div>
         
             
@@ -66,14 +66,11 @@
 <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
 <a name='L2'></a><a href='#L2'>2</a>
 <a name='L3'></a><a href='#L3'>3</a>
-<a name='L4'></a><a href='#L4'>4</a>
-<a name='L5'></a><a href='#L5'>5</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
-<span class="cline-any cline-yes">1x</span>
+<a name='L4'></a><a href='#L4'>4</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">export * from './get-injectors.mjs'
 export * from './get-injectable-token.mjs'
-export * from './defer.mjs'
 export * from './types.mjs'
 &nbsp;</pre></td></tr></table></pre>
 
@@ -82,7 +79,7 @@ export * from './types.mjs'
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-19T12:38:51.382Z
+                at 2025-09-21T17:47:07.632Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/src/utils/types.mts.html

@@ -226,7 +226,7 @@ export interface InjectState {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-19T12:38:51.382Z
+                at 2025-09-21T17:47:07.632Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/docs/injectable.md

@@ -112,14 +112,14 @@ class NotificationService {
 }
 ```
 
-**Important:** `inject` only works with singleton services. For transient services, use `asyncInject` instead.
+**Important:** The `inject` helper now supports all service scopes including Transient. When using `inject` with Transient services, the dependency is tracked for async initialization and will be available in your service methods after initialization completes.
 
-### Asynchronous Injection with `inject`
+### Asynchronous Injection with `asyncInject`
 
-Use `inject` for services that might not be immediately available:
+Use `asyncInject` when you need explicit async control over dependency resolution:
 
 ```typescript
-import { inject, Injectable } from '@navios/di'
+import { asyncInject, Injectable, InjectableScope } from '@navios/di'
 
 @Injectable({ scope: InjectableScope.Transient })
 class TransientService {
@@ -143,6 +143,31 @@ class ConsumerService {
 }
 ```
 
+### Using `inject` with Transient Services
+
+You can now use `inject` with Transient services. The dependency will be tracked for async initialization:
+
+```typescript
+import { inject, Injectable, InjectableScope } from '@navios/di'
+
+@Injectable({ scope: InjectableScope.Transient })
+class TransientService {
+  getValue() {
+    return Math.random()
+  }
+}
+
+@Injectable()
+class ConsumerService {
+  private readonly transientService = inject(TransientService)
+
+  async getRandomValue() {
+    // Service is available in async methods after initialization
+    return this.transientService.getValue()
+  }
+}
+```
+
 ## Advanced Patterns
 
 ### Service with Configuration Schema
@@ -319,15 +344,19 @@ class TransientService {
 
 @Injectable()
 class ConsumerService {
-  // Only asyncInject() works with transient services
-  private readonly transientService = asyncInject(TransientService)
+  // Both inject() and asyncInject() now work with transient services
+  private readonly transientService = inject(TransientService)
+  private readonly asyncTransientService = asyncInject(TransientService)
 
   async demonstrate() {
-    const instance1 = await this.transientService
-    const instance2 = await this.transientService
+    // Using inject with transient services (available after initialization)
+    console.log(this.transientService.getId())
 
-    console.log(instance1.getId()) // Different ID
-    console.log(instance2.getId()) // Different ID
+    // Using asyncInject for explicit async access
+    const instance1 = await this.asyncTransientService
+    const instance2 = await this.asyncTransientService
+    console.log(instance1.getId()) // Same as first call
+    console.log(instance2.getId()) // Same as first call
   }
 }
 ```
@@ -397,7 +426,18 @@ class UserService {
   }
 }
 
-// ✅ Good: Use asyncInject for transient dependencies
+// ✅ Good: Use inject or asyncInject for transient dependencies
+@Injectable()
+class RequestService {
+  // inject now works with transient services
+  private readonly transientService = inject(TransientService)
+
+  async handleRequest() {
+    return this.transientService.process()
+  }
+}
+
+// ✅ Also good: Use asyncInject for explicit async control
 @Injectable()
 class RequestService {
   private readonly transientService = asyncInject(TransientService)

package/docs/scopes.md

@@ -184,8 +184,8 @@ class RequestHandler {
   private readonly requestId = Math.random().toString(36)
 
   async handleRequest() {
-    const logger = await this.logger
-    logger.log(`Handling request ${this.requestId}`)
+    // Logger is available in async methods
+    this.logger.log(`Handling request ${this.requestId}`)
     return { requestId: this.requestId, status: 'processed' }
   }
 }
@@ -336,37 +336,52 @@ await container.endRequest('req-2')
 
 ### Injection Method Compatibility
 
-| Scope     | inject           | asyncInject  |
-| --------- | ---------------- | ------------ |
-| Singleton | ✅ Supported     | ✅ Supported |
-| Transient | ❌ Not Supported | ✅ Supported |
-| Request   | ✅ Supported     | ✅ Supported |
+| Scope     | inject                              | asyncInject  |
+| --------- | ----------------------------------- | ------------ |
+| Singleton | ✅ Supported                        | ✅ Supported |
+| Transient | ✅ Supported (async initialization) | ✅ Supported |
+| Request   | ✅ Supported                        | ✅ Supported |
+
+### Using inject with Transient Services
 
-### Why inject Doesn't Work with Transient
+The `inject` helper now supports Transient services through automatic async initialization tracking. When you use `inject` with a Transient service, the DI system tracks the async dependencies and ensures they're resolved before the service is fully initialized.
 
 ```typescript
-// ❌ This will cause an error
 @Injectable({ scope: InjectableScope.Transient })
-class TransientService {}
+class TransientService {
+  async onServiceInit() {
+    console.log('Transient service initialized')
+  }
+}
 
 @Injectable()
 class ConsumerService {
+  // ✅ This now works! The inject helper tracks async initialization
   private readonly service = inject(TransientService)
-  // Error: Cannot use inject with transient services
+
+  async doSomething() {
+    // The service will be available after initialization completes
+    this.service.someMethod()
+  }
 }
 
-// ✅ Use inject instead
+// ✅ You can still use asyncInject for explicit async access
 @Injectable()
 class ConsumerService {
   private readonly service = asyncInject(TransientService)
 
   async doSomething() {
     const service = await this.service
-    // Use the service
+    service.someMethod()
   }
 }
 ```
 
+**Important Notes:**
+- When using `inject` with Transient services, the dependency won't be immediately available during constructor execution
+- Access the service only in async methods or after the service initialization completes
+- For synchronous access during construction, use `asyncInject` and await it explicitly
+
 ## Real-World Examples
 
 ### Singleton: Database Connection Pool
@@ -414,7 +429,7 @@ class DatabasePool implements OnServiceInit, OnServiceDestroy {
 ### Transient: Request Context
 
 ```typescript
-import { Injectable, InjectableScope } from '@navios/di'
+import { inject, Injectable, InjectableScope } from '@navios/di'
 
 @Injectable({ scope: InjectableScope.Transient })
 class RequestContext {
@@ -447,16 +462,17 @@ class RequestContext {
 
 @Injectable()
 class RequestHandler {
-  private readonly context = asyncInject(RequestContext)
+  private readonly context = inject(RequestContext)
 
   async handleRequest() {
-    const ctx = await this.context
-    console.log(`Handling request ${ctx.getRequestId()} from ${ctx.getIp()}`)
+    console.log(
+      `Handling request ${this.context.getRequestId()} from ${this.context.getIp()}`,
+    )
 
     // Process request...
 
     console.log(
-      `Request ${ctx.getRequestId()} completed in ${ctx.getDuration()}ms`,
+      `Request ${this.context.getRequestId()} completed in ${this.context.getDuration()}ms`,
     )
   }
 }
@@ -465,7 +481,7 @@ class RequestHandler {
 ### Mixed Scopes
 
 ```typescript
-import { asyncInject, inject, Injectable, InjectableScope } from '@navios/di'
+import { inject, Injectable, InjectableScope } from '@navios/di'
 
 // Singleton services
 @Injectable()
@@ -506,19 +522,18 @@ class UserSession {
 class UserService {
   private readonly config = inject(ConfigService) // Singleton
   private readonly logger = inject(LoggerService) // Singleton
-  private readonly session = asyncInject(UserSession) // Transient
+  private readonly session = inject(UserSession) // Transient (with async initialization)
 
   async authenticateUser(userId: string) {
     this.logger.log(`Authenticating user ${userId}`)
 
-    const session = await this.session
     this.logger.log(
-      `Created session ${session.getSessionId()} for user ${userId}`,
+      `Created session ${this.session.getSessionId()} for user ${userId}`,
     )
 
     return {
       userId,
-      sessionId: session.getSessionId(),
+      sessionId: this.session.getSessionId(),
       apiUrl: this.config.getConfig().apiUrl,
     }
   }
@@ -668,27 +683,46 @@ class RequestCache {
 }
 ```
 
-### 2. Incorrect Injection Method
+### 2. Accessing Transient Services Too Early
 
 ```typescript
-// ❌ Problem: Using inject with transient
+// ❌ Problem: Accessing transient service during construction
 @Injectable({ scope: InjectableScope.Transient })
-class TransientService {}
+class TransientService {
+  getData() {
+    return 'data'
+  }
+}
 
 @Injectable()
 class ConsumerService {
   private readonly service = inject(TransientService)
-  // Error: Cannot use inject with transient services
+
+  constructor() {
+    // Error: Service not initialized yet during construction!
+    console.log(this.service.getData())
+  }
+}
+
+// ✅ Solution 1: Access in async methods after initialization
+@Injectable()
+class ConsumerService {
+  private readonly service = inject(TransientService)
+
+  async doSomething() {
+    // Service is available in methods
+    console.log(this.service.getData())
+  }
 }
 
-// ✅ Solution: Use asyncInject with transient
+// ✅ Solution 2: Use asyncInject for explicit control
 @Injectable()
 class ConsumerService {
   private readonly service = asyncInject(TransientService)
 
   async doSomething() {
     const service = await this.service
-    // Use the service
+    console.log(service.getData())
   }
 }
 ```