npm - @navios/di - Versions diffs - 0.9.2 → 1.0.0 - Mend

@navios/di 0.9.2 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (174) hide show

package/CHANGELOG.md +9 -0
package/README.md +28 -0
package/coverage/block-navigation.js +1 -1
package/coverage/clover.xml +1463 -3174
package/coverage/coverage-final.json +56 -54
package/coverage/index.html +179 -104
package/coverage/sorter.js +21 -7
package/coverage/src/{request-context-manager.mts.html → __tests__/gc/gc-test-utils.mts.html} +192 -231
package/coverage/{lib → src/__tests__/gc}/index.html +25 -40
package/coverage/src/container/abstract-container.mts.html +1066 -0
package/coverage/src/container/container.mts.html +958 -0
package/coverage/src/container/index.html +161 -0
package/coverage/src/{testing → container}/index.mts.html +12 -9
package/coverage/src/container/scoped-container.mts.html +907 -0
package/coverage/src/decorators/factory.decorator.mts.html +68 -53
package/coverage/src/decorators/index.html +34 -34
package/coverage/src/decorators/index.mts.html +10 -10
package/coverage/src/decorators/injectable.decorator.mts.html +144 -60
package/coverage/src/enums/index.html +21 -21
package/coverage/src/enums/index.mts.html +12 -12
package/coverage/src/enums/injectable-scope.enum.mts.html +11 -8
package/coverage/src/enums/injectable-type.enum.mts.html +10 -7
package/coverage/src/errors/di-error.mts.html +380 -71
package/coverage/src/errors/index.html +22 -127
package/coverage/src/errors/index.mts.html +9 -33
package/coverage/src/event-emitter.mts.html +35 -107
package/coverage/src/index.html +14 -254
package/coverage/src/index.mts.html +23 -50
package/coverage/src/interfaces/container.interface.mts.html +370 -0
package/coverage/src/interfaces/factory.interface.mts.html +12 -12
package/coverage/src/interfaces/index.html +45 -30
package/coverage/src/interfaces/index.mts.html +16 -13
package/coverage/src/interfaces/on-service-destroy.interface.mts.html +1 -1
package/coverage/src/interfaces/on-service-init.interface.mts.html +1 -1
package/coverage/src/internal/context/async-local-storage.browser.mts.html +142 -0
package/coverage/src/internal/context/async-local-storage.mts.html +292 -0
package/coverage/src/{factory-context.mts.html → internal/context/async-local-storage.types.mts.html} +17 -17
package/coverage/src/internal/context/factory-context.mts.html +142 -0
package/coverage/src/internal/context/index.html +221 -0
package/coverage/src/internal/context/index.mts.html +100 -0
package/coverage/src/{service-locator-instance-holder.mts.html → internal/context/resolution-context.mts.html} +114 -78
package/coverage/src/internal/context/service-initialization-context.mts.html +214 -0
package/coverage/src/internal/context/sync-local-storage.mts.html +244 -0
package/coverage/src/internal/core/index.html +206 -0
package/coverage/src/internal/core/index.mts.html +103 -0
package/coverage/src/internal/core/instance-resolver.mts.html +2533 -0
package/coverage/src/{request-context-holder.mts.html → internal/core/name-resolver.mts.html} +245 -260
package/coverage/src/{container.mts.html → internal/core/scope-tracker.mts.html} +352 -310
package/coverage/src/{service-instantiator.mts.html → internal/core/service-initializer.mts.html} +254 -176
package/coverage/src/internal/core/service-invalidator.mts.html +955 -0
package/coverage/src/internal/core/token-resolver.mts.html +451 -0
package/coverage/src/internal/holder/holder-storage.interface.mts.html +451 -0
package/coverage/src/internal/holder/index.html +161 -0
package/coverage/src/internal/holder/index.mts.html +94 -0
package/coverage/src/internal/holder/instance-holder.mts.html +406 -0
package/coverage/src/{service-locator.mts.html → internal/holder/unified-storage.mts.html} +376 -379
package/coverage/{lib/testing → src/internal}/index.html +26 -11
package/coverage/src/internal/index.mts.html +100 -0
package/coverage/src/internal/lifecycle/circular-detector.mts.html +364 -0
package/coverage/src/internal/lifecycle/index.html +146 -0
package/coverage/src/internal/lifecycle/index.mts.html +91 -0
package/coverage/src/{service-locator-event-bus.mts.html → internal/lifecycle/lifecycle-event-bus.mts.html} +104 -80
package/coverage/src/internal/stub-factory-class.mts.html +133 -0
package/coverage/src/symbols/index.html +14 -14
package/coverage/src/symbols/index.mts.html +9 -9
package/coverage/src/symbols/injectable-token.mts.html +9 -3
package/coverage/src/testing/index.html +32 -32
package/coverage/src/testing/test-container.mts.html +1576 -139
package/coverage/src/testing/unit-test-container.mts.html +1888 -0
package/coverage/src/token/index.html +146 -0
package/coverage/{lib/testing/index.d.mts.html → src/token/index.mts.html} +11 -11
package/coverage/src/{injection-token.mts.html → token/injection-token.mts.html} +225 -111
package/coverage/src/{base-instance-holder-manager.mts.html → token/registry.mts.html} +188 -269
package/coverage/src/{injector.mts.html → utils/default-injectors.mts.html} +31 -31
package/coverage/src/utils/get-injectable-token.mts.html +19 -22
package/coverage/src/utils/get-injectors.mts.html +684 -177
package/coverage/src/utils/index.html +36 -36
package/coverage/src/utils/index.mts.html +18 -12
package/coverage/src/utils/types.mts.html +26 -11
package/docs/examples/basic-usage.mts +1 -1
package/docs/examples/factory-pattern.mts +3 -3
package/docs/examples/request-scope-example.mts +1 -1
package/docs/examples/service-lifecycle.mts +1 -1
package/lib/browser/internal/core/instance-resolver.d.mts.map +1 -1
package/lib/browser/internal/core/instance-resolver.mjs.map +1 -1
package/lib/{container-D-0Ho3qL.d.cts → container-D3j3KuD9.d.mts} +5 -289
package/lib/container-D3j3KuD9.d.mts.map +1 -0
package/lib/{container-Bi0huFQX.mjs → container-qgHMgGNG.mjs} +3 -227
package/lib/container-qgHMgGNG.mjs.map +1 -0
package/lib/{container-CNiqesCL.d.mts → container-r1KP4F-n.d.cts} +5 -289
package/lib/container-r1KP4F-n.d.cts.map +1 -0
package/lib/{container-pmGNCZL_.cjs → container-ycYJgTq7.cjs} +41 -319
package/lib/container-ycYJgTq7.cjs.map +1 -0
package/lib/factory.decorator-D4mem6YQ.cjs +21 -0
package/lib/factory.decorator-D4mem6YQ.cjs.map +1 -0
package/lib/factory.decorator-_IPWcwQn.mjs +16 -0
package/lib/factory.decorator-_IPWcwQn.mjs.map +1 -0
package/lib/index.cjs +14 -24
package/lib/index.cjs.map +1 -1
package/lib/index.d.cts +3 -52
package/lib/index.d.cts.map +1 -1
package/lib/index.d.mts +3 -52
package/lib/index.d.mts.map +1 -1
package/lib/index.mjs +3 -13
package/lib/index.mjs.map +1 -1
package/lib/injectable.decorator-BNfWpjr_.d.cts +56 -0
package/lib/injectable.decorator-BNfWpjr_.d.cts.map +1 -0
package/lib/injectable.decorator-Bc05hRQU.d.mts +56 -0
package/lib/injectable.decorator-Bc05hRQU.d.mts.map +1 -0
package/lib/injectable.decorator-CyPrBzBN.mjs +227 -0
package/lib/injectable.decorator-CyPrBzBN.mjs.map +1 -0
package/lib/injectable.decorator-DbpiDrg-.cjs +281 -0
package/lib/injectable.decorator-DbpiDrg-.cjs.map +1 -0
package/lib/legacy-compat/index.cjs +114 -0
package/lib/legacy-compat/index.cjs.map +1 -0
package/lib/legacy-compat/index.d.cts +63 -0
package/lib/legacy-compat/index.d.cts.map +1 -0
package/lib/legacy-compat/index.d.mts +63 -0
package/lib/legacy-compat/index.d.mts.map +1 -0
package/lib/legacy-compat/index.mjs +111 -0
package/lib/legacy-compat/index.mjs.map +1 -0
package/lib/registry-DKbKWFvJ.d.cts +290 -0
package/lib/registry-DKbKWFvJ.d.cts.map +1 -0
package/lib/registry-n8JhJoxm.d.mts +290 -0
package/lib/registry-n8JhJoxm.d.mts.map +1 -0
package/lib/testing/index.cjs +23 -22
package/lib/testing/index.cjs.map +1 -1
package/lib/testing/index.d.cts +2 -1
package/lib/testing/index.d.cts.map +1 -1
package/lib/testing/index.d.mts +2 -1
package/lib/testing/index.d.mts.map +1 -1
package/lib/testing/index.mjs +2 -1
package/lib/testing/index.mjs.map +1 -1
package/package.json +11 -1
package/project.json +8 -0
package/src/__tests__/gc/basic-container.spec.mts +358 -0
package/src/__tests__/gc/circular-dependencies.spec.mts +501 -0
package/src/__tests__/gc/gc-test-utils.mts +136 -0
package/src/__tests__/gc/memory-pressure.spec.mts +542 -0
package/src/__tests__/gc/scoped-container.spec.mts +444 -0
package/src/__tests__/gc/transient-services.spec.mts +326 -0
package/src/__tests__/scope-upgrade.spec.mts +0 -18
package/src/internal/core/instance-resolver.mts +0 -1
package/src/legacy-compat/context-compat.mts +95 -0
package/src/legacy-compat/factory.decorator.mts +37 -0
package/src/legacy-compat/index.mts +16 -0
package/src/legacy-compat/injectable.decorator.mts +41 -0
package/tsdown.config.mts +1 -1
package/vitest.config.mts +3 -7
package/coverage/docs/examples/basic-usage.mts.html +0 -376
package/coverage/docs/examples/factory-pattern.mts.html +0 -1039
package/coverage/docs/examples/index.html +0 -176
package/coverage/docs/examples/injection-tokens.mts.html +0 -760
package/coverage/docs/examples/request-scope-example.mts.html +0 -847
package/coverage/docs/examples/service-lifecycle.mts.html +0 -1162
package/coverage/lib/_tsup-dts-rollup.d.mts.html +0 -3445
package/coverage/lib/index.d.mts.html +0 -313
package/coverage/src/errors/errors.enum.mts.html +0 -118
package/coverage/src/errors/factory-not-found.mts.html +0 -118
package/coverage/src/errors/factory-token-not-resolved.mts.html +0 -118
package/coverage/src/errors/instance-destroying.mts.html +0 -118
package/coverage/src/errors/instance-expired.mts.html +0 -118
package/coverage/src/errors/instance-not-found.mts.html +0 -118
package/coverage/src/errors/unknown-error.mts.html +0 -118
package/coverage/src/instance-resolver.mts.html +0 -1762
package/coverage/src/registry.mts.html +0 -247
package/coverage/src/service-invalidator.mts.html +0 -1372
package/coverage/src/service-locator-manager.mts.html +0 -340
package/coverage/src/token-processor.mts.html +0 -607
package/coverage/src/utils/defer.mts.html +0 -118
package/lib/container-Bi0huFQX.mjs.map +0 -1
package/lib/container-CNiqesCL.d.mts.map +0 -1
package/lib/container-D-0Ho3qL.d.cts.map +0 -1
package/lib/container-pmGNCZL_.cjs.map +0 -1

package/coverage/{lib/testing → src/internal}/index.html RENAMED Viewed

@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
-    <title>Code coverage report for lib/testing</title>
+    <title>Code coverage report for src/internal</title>
     <meta charset="utf-8" />
     <link rel="stylesheet" href="../../prettify.css" />
     <link rel="stylesheet" href="../../base.css" />
@@ -19,20 +19,20 @@
 <body>
 <div class='wrapper'>
     <div class='pad1'>
-        <h1><a href="../../index.html">All files</a> lib/testing</h1>
+        <h1><a href="../../index.html">All files</a> src/internal</h1>
         <div class='clearfix'>
             <div class='fl pad1y space-right2'>
                 <span class="strong">0% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>0/2</span>
+                <span class='fraction'>0/1</span>
             </div>
             <div class='fl pad1y space-right2'>
-                <span class="strong">0% </span>
+                <span class="strong">100% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>0/1</span>
+                <span class='fraction'>0/0</span>
             </div>
@@ -46,7 +46,7 @@
             <div class='fl pad1y space-right2'>
                 <span class="strong">0% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>0/2</span>
+                <span class='fraction'>0/1</span>
             </div>
@@ -79,18 +79,33 @@
 </tr>
 </thead>
 <tbody><tr>
-	<td class="file low" data-value="index.d.mts"><a href="index.d.mts.html">index.d.mts</a></td>
+	<td class="file empty" data-value="index.mts"><a href="index.mts.html">index.mts</a></td>
+	<td data-value="0" class="pic empty">
+	<div class="chart"><div class="cover-fill" style="width: 0%"></div><div class="cover-empty" style="width: 100%"></div></div>
+	</td>
+	<td data-value="0" class="pct empty">0%</td>
+	<td data-value="0" class="abs empty">0/0</td>
+	<td data-value="0" class="pct empty">0%</td>
+	<td data-value="0" class="abs empty">0/0</td>
+	<td data-value="0" class="pct empty">0%</td>
+	<td data-value="0" class="abs empty">0/0</td>
+	<td data-value="0" class="pct empty">0%</td>
+	<td data-value="0" class="abs empty">0/0</td>
+	</tr>
+<tr>
+	<td class="file low" data-value="stub-factory-class.mts"><a href="stub-factory-class.mts.html">stub-factory-class.mts</a></td>
 	<td data-value="0" class="pic low">
 	<div class="chart"><div class="cover-fill" style="width: 0%"></div><div class="cover-empty" style="width: 100%"></div></div>
 	</td>
 	<td data-value="0" class="pct low">0%</td>
-	<td data-value="2" class="abs low">0/2</td>
-	<td data-value="0" class="pct low">0%</td>
 	<td data-value="1" class="abs low">0/1</td>
+	<td data-value="100" class="pct high">100%</td>
+	<td data-value="0" class="abs high">0/0</td>
 	<td data-value="0" class="pct low">0%</td>
 	<td data-value="1" class="abs low">0/1</td>
 	<td data-value="0" class="pct low">0%</td>
-	<td data-value="2" class="abs low">0/2</td>
+	<td data-value="1" class="abs low">0/1</td>
 	</tr>
 </tbody>
@@ -101,7 +116,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-21T17:47:07.632Z
+                at 2026-01-08T12:15:46.476Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/src/internal/index.mts.html ADDED Viewed

@@ -0,0 +1,100 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/internal/index.mts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../prettify.css" />
+    <link rel="stylesheet" href="../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../index.html">All files</a> / <a href="index.html">src/internal</a> index.mts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>0/0</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/0</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>0/0</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>0/0</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line low'></div>
+    <pre><table class="coverage">
+<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>
+<a name='L6'></a><a href='#L6'>6</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">export * from './context/index.mjs'
+export * from './core/index.mjs'
+export * from './holder/index.mjs'
+export * from './lifecycle/index.mjs'
+export * from './stub-factory-class.mjs'
+&nbsp;</pre></td></tr></table></pre>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <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 2026-01-08T12:15:46.476Z
+            </div>
+        <script src="../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../sorter.js"></script>
+        <script src="../../block-navigation.js"></script>
+    </body>
+</html>

package/coverage/src/internal/lifecycle/circular-detector.mts.html ADDED Viewed

@@ -0,0 +1,364 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/internal/lifecycle/circular-detector.mts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../../prettify.css" />
+    <link rel="stylesheet" href="../../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../../index.html">All files</a> / <a href="index.html">src/internal/lifecycle</a> circular-detector.mts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">90% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>18/20</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">80% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>8/10</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>2/2</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">90% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>18/20</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<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>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a>
+<a name='L33'></a><a href='#L33'>33</a>
+<a name='L34'></a><a href='#L34'>34</a>
+<a name='L35'></a><a href='#L35'>35</a>
+<a name='L36'></a><a href='#L36'>36</a>
+<a name='L37'></a><a href='#L37'>37</a>
+<a name='L38'></a><a href='#L38'>38</a>
+<a name='L39'></a><a href='#L39'>39</a>
+<a name='L40'></a><a href='#L40'>40</a>
+<a name='L41'></a><a href='#L41'>41</a>
+<a name='L42'></a><a href='#L42'>42</a>
+<a name='L43'></a><a href='#L43'>43</a>
+<a name='L44'></a><a href='#L44'>44</a>
+<a name='L45'></a><a href='#L45'>45</a>
+<a name='L46'></a><a href='#L46'>46</a>
+<a name='L47'></a><a href='#L47'>47</a>
+<a name='L48'></a><a href='#L48'>48</a>
+<a name='L49'></a><a href='#L49'>49</a>
+<a name='L50'></a><a href='#L50'>50</a>
+<a name='L51'></a><a href='#L51'>51</a>
+<a name='L52'></a><a href='#L52'>52</a>
+<a name='L53'></a><a href='#L53'>53</a>
+<a name='L54'></a><a href='#L54'>54</a>
+<a name='L55'></a><a href='#L55'>55</a>
+<a name='L56'></a><a href='#L56'>56</a>
+<a name='L57'></a><a href='#L57'>57</a>
+<a name='L58'></a><a href='#L58'>58</a>
+<a name='L59'></a><a href='#L59'>59</a>
+<a name='L60'></a><a href='#L60'>60</a>
+<a name='L61'></a><a href='#L61'>61</a>
+<a name='L62'></a><a href='#L62'>62</a>
+<a name='L63'></a><a href='#L63'>63</a>
+<a name='L64'></a><a href='#L64'>64</a>
+<a name='L65'></a><a href='#L65'>65</a>
+<a name='L66'></a><a href='#L66'>66</a>
+<a name='L67'></a><a href='#L67'>67</a>
+<a name='L68'></a><a href='#L68'>68</a>
+<a name='L69'></a><a href='#L69'>69</a>
+<a name='L70'></a><a href='#L70'>70</a>
+<a name='L71'></a><a href='#L71'>71</a>
+<a name='L72'></a><a href='#L72'>72</a>
+<a name='L73'></a><a href='#L73'>73</a>
+<a name='L74'></a><a href='#L74'>74</a>
+<a name='L75'></a><a href='#L75'>75</a>
+<a name='L76'></a><a href='#L76'>76</a>
+<a name='L77'></a><a href='#L77'>77</a>
+<a name='L78'></a><a href='#L78'>78</a>
+<a name='L79'></a><a href='#L79'>79</a>
+<a name='L80'></a><a href='#L80'>80</a>
+<a name='L81'></a><a href='#L81'>81</a>
+<a name='L82'></a><a href='#L82'>82</a>
+<a name='L83'></a><a href='#L83'>83</a>
+<a name='L84'></a><a href='#L84'>84</a>
+<a name='L85'></a><a href='#L85'>85</a>
+<a name='L86'></a><a href='#L86'>86</a>
+<a name='L87'></a><a href='#L87'>87</a>
+<a name='L88'></a><a href='#L88'>88</a>
+<a name='L89'></a><a href='#L89'>89</a>
+<a name='L90'></a><a href='#L90'>90</a>
+<a name='L91'></a><a href='#L91'>91</a>
+<a name='L92'></a><a href='#L92'>92</a>
+<a name='L93'></a><a href='#L93'>93</a>
+<a name='L94'></a><a href='#L94'>94</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">17x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">117x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">117x</span>
+<span class="cline-any cline-yes">117x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">117x</span>
+<span class="cline-any cline-yes">132x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">132x</span>
+<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">124x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">124x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">124x</span>
+<span class="cline-any cline-yes">124x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">123x</span>
+<span class="cline-any cline-yes">16x</span>
+<span class="cline-any cline-yes">15x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">109x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type { InstanceHolder } from '../holder/instance-holder.mjs'
+&nbsp;
+/**
+ * Whether we're running in production mode.
+ * In production, circular dependency detection is skipped for performance.
+ */
+const isProduction = process.env.NODE_ENV === 'production'
+&nbsp;
+/**
+ * Detects circular dependencies by analyzing the waitingFor relationships
+ * between service holders.
+ *
+ * Uses BFS to traverse the waitingFor graph starting from a target holder
+ * and checks if following the chain leads back to the waiter, indicating a circular dependency.
+ *
+ * Note: In production (NODE_ENV === 'production'), detection is skipped for performance.
+ */
+export class CircularDetector {
+  /**
+   * Detects if waiting for `targetName` from `waiterName` would create a cycle.
+   *
+   * This works by checking if `targetName` (or any holder in its waitingFor chain)
+   * is currently waiting for `waiterName`. If so, waiting would create a deadlock.
+   *
+   * In production mode, this always returns null to skip the BFS traversal overhead.
+   *
+   * @param waiterName The name of the holder that wants to wait
+   * @param targetName The name of the holder being waited on
+   * @param getHolder Function to retrieve a holder by name
+   * @returns The cycle path if a cycle is detected, null otherwise
+   */
+  static detectCycle(
+    waiterName: string,
+    targetName: string,
+    getHolder: (name: string) =&gt; InstanceHolder | undefined,
+  ): string[] | null {
+    // Skip circular dependency detection in production for performance
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (isProduction) {
+<span class="cstat-no" title="statement not covered" >      return null</span>
+    }
+&nbsp;
+    // Use BFS to find if there's a path from targetName back to waiterName
+    const visited = new Set&lt;string&gt;()
+    const queue: Array&lt;{ name: string; path: string[] }&gt; = [
+      { name: targetName, path: [waiterName, targetName] },
+    ]
+&nbsp;
+    while (queue.length &gt; 0) {
+      const { name: currentName, path } = queue.shift()!
+&nbsp;
+      // If we've reached back to the waiter, we have a cycle
+      if (currentName === waiterName) {
+        return path
+      }
+&nbsp;
+      // Skip if already visited
+      <span class="missing-if-branch" title="if path not taken" >I</span>if (visited.has(currentName)) {
+<span class="cstat-no" title="statement not covered" >        continue</span>
+      }
+      visited.add(currentName)
+&nbsp;
+      // Get the holder and check what it's waiting for
+      const holder = getHolder(currentName)
+      if (!holder) {
+        continue
+      }
+&nbsp;
+      // Add all services this holder is waiting for to the queue
+      for (const waitingForName of holder.waitingFor) {
+        if (!visited.has(waitingForName)) {
+          queue.push({
+            name: waitingForName,
+            path: [...path, waitingForName],
+          })
+        }
+      }
+    }
+&nbsp;
+    // No path found from target back to waiter, no cycle
+    return null
+  }
+&nbsp;
+  /**
+   * Formats a cycle path into a human-readable string.
+   *
+   * @param cycle The cycle path (array of service names)
+   * @returns Formatted string like "ServiceA -&gt; ServiceB -&gt; ServiceA"
+   */
+  static formatCycle(cycle: string[]): string {
+    return cycle.join(' -&gt; ')
+  }
+}
+&nbsp;
+&nbsp;</pre></td></tr></table></pre>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <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 2026-01-08T12:15:46.476Z
+            </div>
+        <script src="../../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../../sorter.js"></script>
+        <script src="../../../block-navigation.js"></script>
+    </body>
+</html>