@fjell/registry 4.4.9 → 4.4.11

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.
package/docs/memory.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Registry Memory Consumption Analysis
2
2
 
3
- > **Generated:** 2025-07-21T04:04:11.643Z
4
- > **Version:** 4.4.7
3
+ > **Generated:** 2025-07-21T06:44:48.336Z
4
+ > **Version:** 4.4.10
5
5
  > **Node.js:** v22.0.0
6
6
  > **Test Environment:** darwin arm64
7
7
 
@@ -15,14 +15,14 @@
15
15
 
16
16
  | Operation | Description | Memory Delta | Per Instance | Avg Time (ms) | Threshold | Status |
17
17
  |-----------|-------------|--------------|--------------|---------------|-----------|--------|
18
- | registryCreation | Memory overhead of creating a Registry instance | 72.50 kB | N/A | 0.000 | 83.01 kB | ✅ PASS |
19
- | registryHubCreation | Memory overhead of creating a RegistryHub instance | 79.55 kB | N/A | 0.001 | 83.01 kB | ✅ PASS |
20
- | coordinateCreation | Memory overhead of creating Coordinate instances | 112.55 kB | 1.13 kB | 0.001 | 488.28 kB | ✅ PASS |
21
- | instanceCreation | Memory overhead of creating Instance objects | 158.22 kB | 1.58 kB | 0.001 | 244.14 kB | ✅ PASS |
22
- | registryStorage | Memory growth when registering instances in registry | 310.70 kB | 3.11 kB | 0.004 | 390.63 kB | ✅ PASS |
23
- | multiLevelTree | Memory overhead of multi-level instance tree structures | 215.16 kB | 4.30 kB | 0.005 | 585.94 kB | ✅ PASS |
24
- | scopedInstances | Memory overhead of instances with multiple scopes | 304.58 kB | 3.05 kB | 0.003 | 610.35 kB | ✅ PASS |
25
- | registryHubIntegration | Memory overhead of RegistryHub managing multiple registries | 276.75 kB | 2.77 kB | 0.008 | 2.29 MB | ✅ PASS |
18
+ | registryCreation | Memory overhead of creating a Registry instance | 107.76 kB | N/A | 0.002 | 195.31 kB | ✅ PASS |
19
+ | registryHubCreation | Memory overhead of creating a RegistryHub instance | 79.55 kB | N/A | 0.010 | 195.31 kB | ✅ PASS |
20
+ | coordinateCreation | Memory overhead of creating Coordinate instances | 112.55 kB | 1.13 kB | 0.002 | 585.94 kB | ✅ PASS |
21
+ | instanceCreation | Memory overhead of creating Instance objects | 158.21 kB | 1.58 kB | 0.003 | 390.63 kB | ✅ PASS |
22
+ | registryStorage | Memory growth when registering instances in registry | 305.50 kB | 3.06 kB | 0.010 | 390.63 kB | ✅ PASS |
23
+ | multiLevelTree | Memory overhead of multi-level instance tree structures | 215.14 kB | 4.30 kB | 0.072 | 585.94 kB | ✅ PASS |
24
+ | scopedInstances | Memory overhead of instances with multiple scopes | 315.16 kB | 3.15 kB | 0.007 | 976.56 kB | ✅ PASS |
25
+ | registryHubIntegration | Memory overhead of RegistryHub managing multiple registries | 284.06 kB | 2.84 kB | 0.009 | 2.29 MB | ✅ PASS |
26
26
 
27
27
  ## Memory Efficiency Scaling Analysis (Statistical)
28
28
 
@@ -30,138 +30,138 @@
30
30
 
31
31
  | Instance Count | Iterations | Memory Per Instance (Avg ± StdDev) | Time (Avg ± StdDev) | Status |
32
32
  |----------------|------------|-------------------------------------|---------------------|--------|
33
- | 10 | 50 | 3.10 kB ± 4.00 kB | 0.06 ± 0.16 ms | ✅ PASS |
34
- | 20 | 50 | 2.76 kB ± 2.08 kB | 0.11 ± 0.46 ms | ✅ PASS |
35
- | 50 | 50 | 2.43 kB ± 2.83 kB | 0.10 ± 0.35 ms | ✅ PASS |
36
- | 100 | 50 | 2.14 kB ± 1.76 kB | 0.17 ± 0.36 ms | ✅ PASS |
37
- | 200 | 50 | 2.27 kB ± 2.26 kB | 0.63 ± 1.35 ms | ✅ PASS |
38
- | 500 | 25 | 2.01 kB ± 1.43 kB | 2.73 ± 3.86 ms | ✅ PASS |
39
- | 1,000 | 25 | 1.99 kB ± 1.75 kB | 5.18 ± 6.83 ms | ✅ PASS |
40
- | 2,000 | 25 | 1.86 kB ± 1.59 kB | 4.94 ± 3.50 ms | ✅ PASS |
41
- | 5,000 | 10 | 1.90 kB ± 1.11 kB | 16.26 ± 4.33 ms | ✅ PASS |
42
- | 10,000 | 10 | 1.46 kB ± 816 B | 21.16 ± 5.97 ms | ✅ PASS |
33
+ | 10 | 50 | 2.73 kB ± 2.23 kB | 0.07 ± 0.28 ms | ✅ PASS |
34
+ | 20 | 50 | 2.71 kB ± 2.02 kB | 0.11 ± 0.26 ms | ✅ PASS |
35
+ | 50 | 50 | 2.37 kB ± 1.99 kB | 0.23 ± 0.54 ms | ✅ PASS |
36
+ | 100 | 50 | 2.17 kB ± 1.71 kB | 0.28 ± 0.50 ms | ✅ PASS |
37
+ | 200 | 50 | 2.28 kB ± 2.25 kB | 1.67 ± 4.01 ms | ✅ PASS |
38
+ | 500 | 25 | 2.00 kB ± 1.43 kB | 1.95 ± 3.56 ms | ✅ PASS |
39
+ | 1,000 | 25 | 2.03 kB ± 1.73 kB | 2.81 ± 3.29 ms | ✅ PASS |
40
+ | 2,000 | 25 | 1.86 kB ± 1.39 kB | 9.25 ± 6.91 ms | ✅ PASS |
41
+ | 5,000 | 10 | 1.80 kB ± 1.41 kB | 14.91 ± 14.12 ms | ✅ PASS |
42
+ | 10,000 | 10 | 1.76 kB ± 897 B | 18.79 ± 2.66 ms | ✅ PASS |
43
43
 
44
44
  ### Detailed Statistical Analysis
45
45
 
46
46
  #### 10 Instances (50 iterations)
47
47
 
48
48
  **Memory Per Instance:**
49
- - Average: 3.10 kB
50
- - Range: 200 B - 28.18 kB
51
- - Standard Deviation: 4.00 kB
49
+ - Average: 2.73 kB
50
+ - Range: 200 B - 14.25 kB
51
+ - Standard Deviation: 2.23 kB
52
52
 
53
53
  **Creation Time:**
54
- - Average: 0.06 ms
55
- - Range: 0.01 - 1.14 ms
56
- - Standard Deviation: 0.16 ms
54
+ - Average: 0.07 ms
55
+ - Range: 0.01 - 2.00 ms
56
+ - Standard Deviation: 0.28 ms
57
57
 
58
58
  #### 20 Instances (50 iterations)
59
59
 
60
60
  **Memory Per Instance:**
61
- - Average: 2.76 kB
62
- - Range: 200 B - 12.40 kB
63
- - Standard Deviation: 2.08 kB
61
+ - Average: 2.71 kB
62
+ - Range: 200 B - 11.49 kB
63
+ - Standard Deviation: 2.02 kB
64
64
 
65
65
  **Creation Time:**
66
66
  - Average: 0.11 ms
67
- - Range: 0.02 - 3.28 ms
68
- - Standard Deviation: 0.46 ms
67
+ - Range: 0.05 - 1.90 ms
68
+ - Standard Deviation: 0.26 ms
69
69
 
70
70
  #### 50 Instances (50 iterations)
71
71
 
72
72
  **Memory Per Instance:**
73
- - Average: 2.43 kB
74
- - Range: 200 B - 18.86 kB
75
- - Standard Deviation: 2.83 kB
73
+ - Average: 2.37 kB
74
+ - Range: 200 B - 10.96 kB
75
+ - Standard Deviation: 1.99 kB
76
76
 
77
77
  **Creation Time:**
78
- - Average: 0.10 ms
79
- - Range: 0.04 - 2.56 ms
80
- - Standard Deviation: 0.35 ms
78
+ - Average: 0.23 ms
79
+ - Range: 0.05 - 3.83 ms
80
+ - Standard Deviation: 0.54 ms
81
81
 
82
82
  #### 100 Instances (50 iterations)
83
83
 
84
84
  **Memory Per Instance:**
85
- - Average: 2.14 kB
85
+ - Average: 2.17 kB
86
86
  - Range: 200 B - 10.54 kB
87
- - Standard Deviation: 1.76 kB
87
+ - Standard Deviation: 1.71 kB
88
88
 
89
89
  **Creation Time:**
90
- - Average: 0.17 ms
91
- - Range: 0.08 - 2.65 ms
92
- - Standard Deviation: 0.36 ms
90
+ - Average: 0.28 ms
91
+ - Range: 0.08 - 2.96 ms
92
+ - Standard Deviation: 0.50 ms
93
93
 
94
94
  #### 200 Instances (50 iterations)
95
95
 
96
96
  **Memory Per Instance:**
97
- - Average: 2.27 kB
98
- - Range: 200 B - 11.64 kB
99
- - Standard Deviation: 2.26 kB
97
+ - Average: 2.28 kB
98
+ - Range: 200 B - 11.65 kB
99
+ - Standard Deviation: 2.25 kB
100
100
 
101
101
  **Creation Time:**
102
- - Average: 0.63 ms
103
- - Range: 0.17 - 7.49 ms
104
- - Standard Deviation: 1.35 ms
102
+ - Average: 1.67 ms
103
+ - Range: 0.17 - 25.45 ms
104
+ - Standard Deviation: 4.01 ms
105
105
 
106
106
  #### 500 Instances (25 iterations)
107
107
 
108
108
  **Memory Per Instance:**
109
- - Average: 2.01 kB
109
+ - Average: 2.00 kB
110
110
  - Range: 200 B - 7.61 kB
111
111
  - Standard Deviation: 1.43 kB
112
112
 
113
113
  **Creation Time:**
114
- - Average: 2.73 ms
115
- - Range: 0.43 - 14.56 ms
116
- - Standard Deviation: 3.86 ms
114
+ - Average: 1.95 ms
115
+ - Range: 0.40 - 15.64 ms
116
+ - Standard Deviation: 3.56 ms
117
117
 
118
118
  #### 1,000 Instances (25 iterations)
119
119
 
120
120
  **Memory Per Instance:**
121
- - Average: 1.99 kB
121
+ - Average: 2.03 kB
122
122
  - Range: 200 B - 7.61 kB
123
- - Standard Deviation: 1.75 kB
123
+ - Standard Deviation: 1.73 kB
124
124
 
125
125
  **Creation Time:**
126
- - Average: 5.18 ms
127
- - Range: 0.81 - 31.10 ms
128
- - Standard Deviation: 6.83 ms
126
+ - Average: 2.81 ms
127
+ - Range: 0.88 - 15.17 ms
128
+ - Standard Deviation: 3.29 ms
129
129
 
130
130
  #### 2,000 Instances (25 iterations)
131
131
 
132
132
  **Memory Per Instance:**
133
133
  - Average: 1.86 kB
134
- - Range: 607 B - 6.69 kB
135
- - Standard Deviation: 1.59 kB
134
+ - Range: 492 B - 5.84 kB
135
+ - Standard Deviation: 1.39 kB
136
136
 
137
137
  **Creation Time:**
138
- - Average: 4.94 ms
139
- - Range: 1.82 - 11.65 ms
140
- - Standard Deviation: 3.50 ms
138
+ - Average: 9.25 ms
139
+ - Range: 1.92 - 36.19 ms
140
+ - Standard Deviation: 6.91 ms
141
141
 
142
142
  #### 5,000 Instances (10 iterations)
143
143
 
144
144
  **Memory Per Instance:**
145
- - Average: 1.90 kB
146
- - Range: 1.26 kB - 4.30 kB
147
- - Standard Deviation: 1.11 kB
145
+ - Average: 1.80 kB
146
+ - Range: 200 B - 4.66 kB
147
+ - Standard Deviation: 1.41 kB
148
148
 
149
149
  **Creation Time:**
150
- - Average: 16.26 ms
151
- - Range: 11.01 - 21.74 ms
152
- - Standard Deviation: 4.33 ms
150
+ - Average: 14.91 ms
151
+ - Range: 4.73 - 55.96 ms
152
+ - Standard Deviation: 14.12 ms
153
153
 
154
154
  #### 10,000 Instances (10 iterations)
155
155
 
156
156
  **Memory Per Instance:**
157
- - Average: 1.46 kB
158
- - Range: 200 B - 3.61 kB
159
- - Standard Deviation: 816 B
157
+ - Average: 1.76 kB
158
+ - Range: 1.28 kB - 3.61 kB
159
+ - Standard Deviation: 897 B
160
160
 
161
161
  **Creation Time:**
162
- - Average: 21.16 ms
163
- - Range: 14.28 - 32.53 ms
164
- - Standard Deviation: 5.97 ms
162
+ - Average: 18.79 ms
163
+ - Range: 14.24 - 23.46 ms
164
+ - Standard Deviation: 2.66 ms
165
165
 
166
166
 
167
167
  ### Memory Efficiency Pattern (Statistical Summary)
@@ -170,16 +170,16 @@ The following data shows per-instance memory efficiency with confidence interval
170
170
 
171
171
  ```
172
172
  Instance Count | Avg Per Instance | StdDev %
173
- 10 | 3.10 kB | 129.1%
174
- 20 | 2.76 kB | 75.4%
175
- 50 | 2.43 kB | 116.5%
176
- 100 | 2.14 kB | 82.3%
177
- 200 | 2.27 kB | 99.4%
178
- 500 | 2.01 kB | 71.3%
179
- 1000 | 1.99 kB | 88.0%
180
- 2000 | 1.86 kB | 85.3%
181
- 5000 | 1.90 kB | 58.6%
182
- 10000 | 1.46 kB | 54.7%
173
+ 10 | 2.73 kB | 81.7%
174
+ 20 | 2.71 kB | 74.5%
175
+ 50 | 2.37 kB | 83.9%
176
+ 100 | 2.17 kB | 79.0%
177
+ 200 | 2.28 kB | 98.4%
178
+ 500 | 2.00 kB | 71.4%
179
+ 1000 | 2.03 kB | 85.6%
180
+ 2000 | 1.86 kB | 74.9%
181
+ 5000 | 1.80 kB | 78.3%
182
+ 10000 | 1.76 kB | 49.8%
183
183
  ```
184
184
 
185
185
  ### Statistical Reliability
@@ -191,7 +191,7 @@ Instance Count | Avg Per Instance | StdDev %
191
191
 
192
192
  ### Scaling Characteristics (Statistical)
193
193
 
194
- - **Per-Instance Memory Change**: -11.3% (2.14 kB → 1.90 kB)
194
+ - **Per-Instance Memory Change**: -16.9% (2.17 kB → 1.80 kB)
195
195
  - **Memory Efficiency**: Good
196
196
  - **Per-Instance Consistency**: Excellent (< 1KB variation)
197
197
  - **Statistical Confidence**: High (multiple iterations with standard deviation analysis)
@@ -202,17 +202,17 @@ Instance Count | Avg Per Instance | StdDev %
202
202
 
203
203
  **Description:** Memory overhead of creating a Registry instance
204
204
  **Iterations:** 100
205
- **Total Memory Delta:** 72.50 kB
205
+ **Total Memory Delta:** 107.76 kB
206
206
  **Memory Per Instance:** N/A
207
- **Average Time:** 0.000 ms
207
+ **Average Time:** 0.002 ms
208
208
 
209
209
  **Memory Breakdown:**
210
- - Heap Used: 72.50 kB
210
+ - Heap Used: 107.76 kB
211
211
  - Heap Total: 0 B
212
212
  - External: 40 B
213
213
  - RSS: 0 B
214
214
 
215
- **Memory Threshold:** 83.01 kB
215
+ **Memory Threshold:** 195.31 kB
216
216
  **Time Threshold:** 1 ms
217
217
  **Status:** ✅ PASS
218
218
 
@@ -222,7 +222,7 @@ Instance Count | Avg Per Instance | StdDev %
222
222
  **Iterations:** 100
223
223
  **Total Memory Delta:** 79.55 kB
224
224
  **Memory Per Instance:** N/A
225
- **Average Time:** 0.001 ms
225
+ **Average Time:** 0.010 ms
226
226
 
227
227
  **Memory Breakdown:**
228
228
  - Heap Used: 79.55 kB
@@ -230,7 +230,7 @@ Instance Count | Avg Per Instance | StdDev %
230
230
  - External: 0 B
231
231
  - RSS: 0 B
232
232
 
233
- **Memory Threshold:** 83.01 kB
233
+ **Memory Threshold:** 195.31 kB
234
234
  **Time Threshold:** 1.5 ms
235
235
  **Status:** ✅ PASS
236
236
 
@@ -240,7 +240,7 @@ Instance Count | Avg Per Instance | StdDev %
240
240
  **Iterations:** 100
241
241
  **Total Memory Delta:** 112.55 kB
242
242
  **Memory Per Instance:** 1.13 kB
243
- **Average Time:** 0.001 ms
243
+ **Average Time:** 0.002 ms
244
244
 
245
245
  **Memory Breakdown:**
246
246
  - Heap Used: 112.55 kB
@@ -248,7 +248,7 @@ Instance Count | Avg Per Instance | StdDev %
248
248
  - External: 0 B
249
249
  - RSS: 0 B
250
250
 
251
- **Memory Threshold:** 488.28 kB
251
+ **Memory Threshold:** 585.94 kB
252
252
  **Time Threshold:** 0.5 ms
253
253
  **Status:** ✅ PASS
254
254
 
@@ -256,17 +256,17 @@ Instance Count | Avg Per Instance | StdDev %
256
256
 
257
257
  **Description:** Memory overhead of creating Instance objects
258
258
  **Iterations:** 100
259
- **Total Memory Delta:** 158.22 kB
259
+ **Total Memory Delta:** 158.21 kB
260
260
  **Memory Per Instance:** 1.58 kB
261
- **Average Time:** 0.001 ms
261
+ **Average Time:** 0.003 ms
262
262
 
263
263
  **Memory Breakdown:**
264
- - Heap Used: 158.22 kB
264
+ - Heap Used: 158.21 kB
265
265
  - Heap Total: 0 B
266
266
  - External: 0 B
267
267
  - RSS: 0 B
268
268
 
269
- **Memory Threshold:** 244.14 kB
269
+ **Memory Threshold:** 390.63 kB
270
270
  **Time Threshold:** 1 ms
271
271
  **Status:** ✅ PASS
272
272
 
@@ -274,12 +274,12 @@ Instance Count | Avg Per Instance | StdDev %
274
274
 
275
275
  **Description:** Memory growth when registering instances in registry
276
276
  **Iterations:** 100
277
- **Total Memory Delta:** 310.70 kB
278
- **Memory Per Instance:** 3.11 kB
279
- **Average Time:** 0.004 ms
277
+ **Total Memory Delta:** 305.50 kB
278
+ **Memory Per Instance:** 3.06 kB
279
+ **Average Time:** 0.010 ms
280
280
 
281
281
  **Memory Breakdown:**
282
- - Heap Used: 310.70 kB
282
+ - Heap Used: 305.50 kB
283
283
  - Heap Total: 0 B
284
284
  - External: 0 B
285
285
  - RSS: 0 B
@@ -292,12 +292,12 @@ Instance Count | Avg Per Instance | StdDev %
292
292
 
293
293
  **Description:** Memory overhead of multi-level instance tree structures
294
294
  **Iterations:** 50
295
- **Total Memory Delta:** 215.16 kB
295
+ **Total Memory Delta:** 215.14 kB
296
296
  **Memory Per Instance:** 4.30 kB
297
- **Average Time:** 0.005 ms
297
+ **Average Time:** 0.072 ms
298
298
 
299
299
  **Memory Breakdown:**
300
- - Heap Used: 215.16 kB
300
+ - Heap Used: 215.14 kB
301
301
  - Heap Total: 0 B
302
302
  - External: 0 B
303
303
  - RSS: 0 B
@@ -310,17 +310,17 @@ Instance Count | Avg Per Instance | StdDev %
310
310
 
311
311
  **Description:** Memory overhead of instances with multiple scopes
312
312
  **Iterations:** 100
313
- **Total Memory Delta:** 304.58 kB
314
- **Memory Per Instance:** 3.05 kB
315
- **Average Time:** 0.003 ms
313
+ **Total Memory Delta:** 315.16 kB
314
+ **Memory Per Instance:** 3.15 kB
315
+ **Average Time:** 0.007 ms
316
316
 
317
317
  **Memory Breakdown:**
318
- - Heap Used: 304.58 kB
319
- - Heap Total: 0 B
318
+ - Heap Used: 315.16 kB
319
+ - Heap Total: 256.00 kB
320
320
  - External: 0 B
321
- - RSS: 0 B
321
+ - RSS: 80.00 kB
322
322
 
323
- **Memory Threshold:** 610.35 kB
323
+ **Memory Threshold:** 976.56 kB
324
324
  **Time Threshold:** 2 ms
325
325
  **Status:** ✅ PASS
326
326
 
@@ -328,12 +328,12 @@ Instance Count | Avg Per Instance | StdDev %
328
328
 
329
329
  **Description:** Memory overhead of RegistryHub managing multiple registries
330
330
  **Iterations:** 20
331
- **Total Memory Delta:** 276.75 kB
332
- **Memory Per Instance:** 2.77 kB
333
- **Average Time:** 0.008 ms
331
+ **Total Memory Delta:** 284.06 kB
332
+ **Memory Per Instance:** 2.84 kB
333
+ **Average Time:** 0.009 ms
334
334
 
335
335
  **Memory Breakdown:**
336
- - Heap Used: 276.75 kB
336
+ - Heap Used: 284.06 kB
337
337
  - Heap Total: 0 B
338
338
  - External: 0 B
339
339
  - RSS: 0 B
@@ -347,22 +347,22 @@ Instance Count | Avg Per Instance | StdDev %
347
347
  The following memory constraints are enforced to ensure optimal memory usage:
348
348
 
349
349
  ### Infrastructure Overhead
350
- - **Registry Creation**: ≤ 83.01 kB
351
- - **Registry Hub Creation**: ≤ 83.01 kB
350
+ - **Registry Creation**: ≤ 195.31 kB
351
+ - **Registry Hub Creation**: ≤ 195.31 kB
352
352
  - **Maximum Registry Overhead**: ≤ 117.19 kB
353
353
 
354
354
  ### Per-Instance Overhead
355
- - **Instance Creation**: ≤ 2.44 kB per instance
356
- - **Coordinate Creation**: ≤ 4.88 kB per coordinate
355
+ - **Instance Creation**: ≤ 3.91 kB per instance
356
+ - **Coordinate Creation**: ≤ 5.86 kB per coordinate
357
357
  - **Instance Tree Node**: ≤ 3.91 kB per tree node
358
- - **Maximum Memory Per Instance**: ≤ 4.88 kB
358
+ - **Maximum Memory Per Instance**: ≤ 7.81 kB
359
359
 
360
360
  ### Memory Efficiency Analysis
361
361
 
362
362
  The memory efficiency analysis focuses on per-instance memory overhead and how it scales with the number of instances.
363
363
 
364
- - **Registry Overhead Efficiency**: 12.7% under constraint limit
365
- - **Per-Instance Efficiency**: 67.6% under constraint limit
364
+ - **Registry Overhead Efficiency**: 44.8% under constraint limit
365
+ - **Per-Instance Efficiency**: 79.7% under constraint limit
366
366
 
367
367
  ## Performance Characteristics
368
368